KSeF w sklepie – wtyczka czy integracja przez API?

Wtyczka to gotowy most między sklepem a KSeF, napisany raz dla wszystkich. Ma stały zakres: bierze zamówienie, buduje z niego fakturę i wysyła ją w formacie wymaganym przez system. Integracja przez interfejs programistyczny to ten sam most, ale zbudowany pod Twój proces.

Różnica ujawnia się dopiero przy odstępstwach od standardu. Wtyczka obsługuje przypadek, który przewidział jej autor. Jeśli Twoja faktura ma inny zestaw pól, wystawiasz korekty albo dokument powstaje w programie księgowym zamiast w sklepie, gotowe rozwiązanie zaczyna przeszkadzać zamiast pomagać.

Co to znaczy dla odpowiedzialności

Przy wtyczce odpowiada jej producent, ale tylko za to, co obiecał. Przy własnej integracji odpowiadasz Ty albo Twoja agencja – za to masz pewność, że zmiana w API nie zatrzyma wystawiania faktur do czasu, aż ktoś wyda aktualizację.

W większości sklepów wystarczy i odradzanie jej byłoby naciąganiem klienta na koszt. Gotowe rozwiązanie ma sens wszędzie tam, gdzie faktura jest prostym odbiciem zamówienia.

Jeśli wszystkie Twoje odpowiedzi mieszczą się w pierwszej kolumnie, budowanie własnej integracji jest wydawaniem pieniędzy na możliwości, których nie użyjesz.

Najczęstszy problem nie polega na tym, że faktura się nie wyśle. Polega na tym, że wyśle się i zostanie odrzucona, a nikt tego nie zauważy.

KSeF potwierdza przyjęcie dokumentu osobnym komunikatem. Część wtyczek pokazuje status w panelu zamówienia i na tym kończy swoją rolę – jeśli nikt tam nie zagląda, odrzucone faktury cicho się gromadzą. Przy własnej integracji ten sam stan da się wyprowadzić na alert albo raport dzienny.

Druga rzecz to numeracja. Sklep i program księgowy potrafią prowadzić własne serie dokumentów i przy dwóch źródłach faktur łatwo o dublet, którego system nie przyjmie. To problem organizacyjny, nie techniczny, ale ujawnia się dopiero w produkcji.

Kolejność jest ta sama niezależnie od tego, którą drogę wybierzesz, i warto ją znać, bo większość opóźnień bierze się z pominięcia pierwszego kroku.

Zaczyna się od ustalenia, gdzie powstaje faktura. To brzmi banalnie, ale w wielu firmach odpowiedź brzmi w dwóch miejscach naraz – część dokumentów wychodzi ze sklepu, część z programu księgowego. Dopóki to nie zostanie rozstrzygnięte, integracja nie ma sensu, bo numeracja i tak się rozjedzie.

Drugi krok to uzyskanie dostępu do systemu i przypisanie uprawnień. Trzeci to mapowanie pól – sprawdzenie, czy wszystkie dane wymagane przez fakturę ustrukturyzowaną w ogóle są w sklepie zapisywane. Najczęściej brakuje kompletnego adresu nabywcy albo numeru NIP przy zamówieniach od firm.

Dopiero czwarty krok to właściwe spięcie i testy na dokumentach próbnych. Piąty, najczęściej pomijany, to ustalenie, kto i jak często sprawdza odrzucone faktury.

Najwięcej opóźnień bierze się z pierwszego wiersza, bo to jedyna decyzja, której wykonawca nie podejmie za klienta.

Wtyczka kosztuje tyle, ile życzy sobie jej producent, zwykle w modelu rocznej licencji. Do tego dochodzi konfiguracja, jeśli sklep ma nietypowe ustawienia podatkowe.

Wdrożenie KSeF u nas zaczyna się od 2 999 zł netto i obejmuje spięcie sklepu z systemem, mapowanie pól faktury oraz obsługę statusów. Gdy dokumenty powstają w systemie ERP, praca przenosi się na jego stronę – integracje z ERP wyceniamy od 8 000 zł netto.

Rachunek jest prosty: jeśli wtyczka pokrywa Twój przypadek, jest tańsza i tak powinieneś zrobić. Jeśli nie pokrywa, koszt obejścia jej ograniczeń zwykle przekracza koszt zrobienia tego porządnie od razu.