Podłączanie KSeF do Twojego systemu: API, webhooki, ERP i narzędzia do fakturowania, z działającymi przykładami.
Samodzielna integracja z KSeF to sporo roboty technicznej: po Twojej stronie leży XML w formacie FA(3), uwierzytelnianie, szyfrowana wysyłka i pilnowanie statusów. Gotowe API przyjmuje zwykły JSON i zdejmuje z Ciebie całą resztę. Dla sklepu internetowego czy zespołu SaaS to zwykle szybsza i tańsza droga, a własna budowa opłaca się dopiero wtedy, gdy fakturowanie elektroniczne jest sercem Twojego produktu.
Bezmyślne ponowienie żądania KSeF po timeoutcie może utworzyć duplikat faktury, bo żądanie mogło dotrzeć do KSeF, choć Ty nigdy nie zobaczyłeś odpowiedzi. Bezpieczny wzorzec to stały klucz idempotencji po Twojej stronie przy każdym zgłoszeniu, sprawdzenie statusu faktury w KSeF przed ponowną wysyłką i ponowne wysłanie tylko wtedy, gdy masz pewność, że wcześniejsza próba się nie powiodła.
Token KSeF to poświadczenie uwierzytelniające z okresem ważności — gdy wygaśnie, integracja przestaje otwierać sesje i wysyłać faktury. Rutyna, która trzyma Cię w ruchu, jest prosta: sprawdź datę ważności, wygeneruj nowy token zanim stary umrze i podmień go w jednym miejscu — w Connect KSeF w Notaly.
Sklep WooCommerce lub Shopify może wystawiać faktury KSeF przez wtyczkę albo przez API KSeF, takie jak Notaly, które zamienia każde zamówienie w fakturę FA(3) i wysyła ją automatycznie. Nie musisz pisać XML-a FA(3) ani prowadzić własnej integracji z KSeF. Dla większości sklepów API to najszybsza droga do e-fakturowania bez projektu inżynierskiego zorientowanego na Polskę.
Załóż konto sandbox: klucz API w kilka sekund, 3 darmowe faktury testowe w KSeF TEST, bez karty płatniczej.
