Integracje

KSeF dla WooCommerce i Shopify: jak podłączyć sklep

Jak sklep WooCommerce lub Shopify może wystawiać faktury KSeF: wtyczka czy API i co daje automatyzacja zamówienie → faktura przez API KSeF.

Opublikowano 2 min czytaniaAutor: Tomek

Wprowadzenie

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ę.

Co sklep musi zrobić

KSeF to krajowa platforma e-fakturowania Ministerstwa Finansów. Żeby wystawić fakturę KSeF ze sklepu, każde zamówienie trzeba odwzorować na schemat FA(3) — dane sprzedawcy i nabywcy, pozycje z ilościami i cenami oraz sumy — a potem uwierzytelnić się, zaszyfrować i wysłać dokument do KSeF, odczytać status i UPO oraz zapisać je przy zamówieniu.

Wtyczka robi to wewnątrz platformy sklepowej. API wyprowadza tę pracę poza sklep: checkout albo webhook zamówienia przekazuje zamówienie do API, a API zwraca status KSeF. Dzięki temu kod sklepu się nie zmienia, a logika e-fakturowania jest w jednym, łatwym do obserwowania miejscu.

Wtyczka czy API

Wtyczka jest wygodna, gdy istnieje dla Twojej dokładnej platformy i akceptujesz jej tempo aktualizacji, bo schemat FA(3) Ministerstwa i API KSeF zmieniają się z czasem. API, takie jak Notaly, bierze te zmiany na siebie: wysyłasz zamówienie w JSON do POST /invoices, a Notaly generuje i waliduje XML FA(3), wysyła go do KSeF i zwraca status oraz UPO przez webhook. Ceną jest abonament zamiast jednorazowej wtyczki.

Minimalny przepływ zamówienie → faktura

Przechwyć zamówienie z poprawnym NIP nabywcy i pozycjami, wyślij je do API, zapisz zwrócony numer KSeF i UPO przy zamówieniu i pokaż klientowi status. Zacznij w środowisku testowym KSeF z tokenem testowym, żeby potwierdzić przepływ, a dopiero potem przełącz się na produkcję. Dbaj o czyste dane identyfikacyjne i adres nabywcy — to najczęstsze źródło odrzuconej faktury.

Zastrzeżenie

Notaly nie jest doradcą podatkowym, księgowym ani prawnym. Ten artykuł ma charakter informacyjny, nie stanowi porady podatkowej i może być nieaktualny. Ponosisz odpowiedzialność za własne rozliczenia VAT; w razie potrzeby skonsultuj się z wykwalifikowanym księgowym.

Źródła

Źródło: www.podatki.gov.pl

Najczęstsze pytania

Czy w WooCommerce muszę sam pisać XML FA(3)?

Nie, jeśli używasz API KSeF. Sklep wysyła dane zamówienia jako JSON, a API generuje i wysyła fakturę FA(3).

Czy Shopify natywnie obsługuje KSeF?

Nie od razu dla polskiego e-fakturowania. Zwykle podłączasz się przez wtyczkę albo integrację przez API, taką jak Notaly.

Czy mogę najpierw przetestować?

Tak. Zacznij w środowisku testowym KSeF (albo w sandboxie Notaly), żeby zweryfikować przepływ zamówienie → faktura przed produkcją.

Wystaw pierwszą fakturę testową w KSeF jeszcze dziś

Załóż konto sandbox: klucz API w kilka sekund, 3 darmowe faktury testowe w KSeF TEST, bez karty płatniczej.