Nasze api daje możliwość wysłania KSEF zarówno pojedynczej faktury, jak i wysyłki wielu faktur na raz. Na każdym etapie można również sprawdzać status przetwarzania w KSEF przy użyciu dedykowanego endpointu.
Szczegółowe informacje są zawarte w dokumentacji API:
https://www.infakt.pl/developers/
Do KSeFu faktury można wysłać nie tylko przez stronę internetową inFaktu, ale też przez inFaktowe API: fakturę vat, korygującą, marże, zaliczkę, końcową. Dodatkowo każdy typ faktury w kolekcji "Przychody" posiada swoją końcówkę wysyłki faktury do KSeF, która działa identycznie jak podstawowy węzeł wysyłki faktury. Wybór zależy od preferencji integratora.
Jeśli Twoje konto jest już zintegrowane z KSEF oraz został wygenerowany klucz API dla konta inFakt, to wysyłka faktur do KSEF przez api jest bardzo prosta.
Przykładowo, wysyłka faktury przychodowej może zostać osiągnięta przy użyciu takiego CURLa
curl --location --request POST 'https://api.infakt.pl/v3/ksef/documents/document_uuid/send.json'
document_uuid
to uuid wybranego dokumentu przychodowego (faktura vat, korygująca, marża, zaliczkowa i końcowa).
Można go pozyskać odpytując końcówkę danego zasobu z listą dokumentów.
Wysyłka odbywa się w sposób asynchroniczny. Status wysyłki można zweryfikować na kilka sposobów:
- skorzystać z dedykowanej końcówki do weryfikacji statusu wysyłki
api/v3/ksef/documents/{document_uuid}/status.json,
- sprawdzać węzeł
ksef_data
na końcówce z podglądem dokumentu wybranego typu,
- skonfigurować webhooka, który będzie powiadamiał o finalnym statusie przetwarzania faktury w KSeF (sukces / błąd)
Możliwe statusy przetwarzania:
"status": "sent"
- faktura została wysłana do przetworzenia w KSEF, jest to status początkowy,
"status": "success"
- faktura została poprawnie przetworzenia w KSEF i nadano jejksef_number
,
"status": "error"
- faktura nie została przetworzona w KSEF, szczegóły błędu podano wstatus_description
Użytkownik musi być zintegrowany z KSeF, w innym wypadku zwracany będzie kod 422.
Dodatkowe informacje są dostępne w naszej dokumentacji API
https://www.infakt.pl/developers/
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.