Podziel proces na cztery odpowiedzialności

Sklep zbiera dane, integracja je przekazuje, program fakturujący wystawia dokument, a zespół księgowy zatwierdza zasady rozliczenia. KSeF nie zmienia tego w jedną automatycznie poprawną czynność. Ustal właściciela każdego etapu i źródło informacji o błędzie. Potwierdzenie zamówienia wysłane przez Shopify nie powinno być bez sprawdzenia traktowane jako ten sam dokument co faktura w systemie księgowym.

Narysuj przepływ na jednym przykładzie B2C oraz jednym B2B. Zaznacz moment pobrania NIP, wystawienia dokumentu, przekazania do KSeF i poinformowania kupującego. Dodaj anulowanie oraz zwrot. Już taki prosty diagram często ujawnia, że dwa narzędzia wystawiają dokument równolegle albo żadne nie obsługuje korekty. Wybór aplikacji powinien nastąpić po uporządkowaniu procesu, nie przed ustaleniem odpowiedzialności.

NIP: pole, etykieta i walidacja

Pole musi być zrozumiałe dla klienta i odczytywane przez integrację. Sama zmiana etykiety na „NIP do faktury” nie wystarczy, jeśli konektor pobiera dane z innego miejsca. Sprawdź zakup jako gość, konto klienta, B2B i ścieżki ekspresowe. Test powinien obejmować pustą wartość, omyłkę oraz numer firmy zagranicznej, jeżeli taki klient jest obsługiwany.

Co oznacza poprawny numer?

Walidacja formatu nie potwierdza wszystkich danych nabywcy ani warunków podatkowych transakcji. Ustal z księgowym, kiedy numer ma być wymagany, jakie dane firmy są niezbędne i co robić po zakupie bez identyfikatora. Nie dopisuj go dowolnie do zakończonego dokumentu. Zespół powinien mieć instrukcję zgłoszenia korekty oraz kontaktu z klientem. Logika formularza musi odzwierciedlać tę procedurę, a nie ją zastępować.

Program fakturujący i źródło prawdy

Fakturownia, inFakt, ERP lub inne narzędzie mogą uczestniczyć w procesie, ale ich obecność nie potwierdza zgodności konkretnego konektora. Zapisz nazwę aplikacji, obsługiwane zasoby i sposób aktualizacji. Sprawdź kwoty, walutę, rabat, dostawę i identyfikatory produktu. Szczególnie uważnie potraktuj nazwy metod dostawy, które mogą zawierać adres lub nazwę punktu odbioru.

Ustal, gdzie przechowujesz numer faktury i jej powiązanie z zamówieniem Shopify. Ponowna synchronizacja nie powinna tworzyć drugiego dokumentu. Przy błędzie integracja powinna umożliwiać rozpoznanie niepowodzenia i kontrolowane ponowienie. Nie wybieraj programu tylko na podstawie hasła „integracja Shopify”. Potrzebny jest test Twoich stawek, walut, korekt oraz ścieżki B2B. Własne API jest opcją, gdy gotowe narzędzie nie obsługuje uzgodnionego procesu, ale wymaga osobnego utrzymania.

KSeF: aktualne terminy i granica instrukcji

Według materiałów Ministerstwa Finansów sprawdzonych 25.10.2026 obowiązek wystawiania faktur w KSeF wprowadzono etapami: od 1 lutego 2026 dla firm ze sprzedażą w 2024 roku przekraczającą 200 mln zł z VAT, a od 1 kwietnia 2026 dla pozostałych. Materiały MF opisują również przejściową możliwość wystawiania poza KSeF określonych faktur przy miesięcznej sprzedaży na takich dokumentach do 10 tys. zł z VAT do końca 2026 roku.

To skrót terminów, nie kwalifikacja Twojej firmy. Zakres dokumentów, wyłączenia i warunki stosowania przepisów potwierdź z księgowym na podstawie aktualnych źródeł MF. W projekcie technicznym zapisujemy zatwierdzony scenariusz, odpowiedzialność programu fakturującego oraz sposób obserwowania statusu. Nie włączamy jednej opcji dla całego sklepu bez sprawdzenia rodzaju transakcji i dokumentów. Daty oraz zasady mogą wymagać aktualizacji po zmianie prawa.

Wysłanie dokumentu i potwierdzenie jego przyjęcia

Utworzenie dokumentu, próba przesłania i przyjęcie przez odbiorcę to różne stany. Zespół powinien wiedzieć, który z nich widzi w panelu i jak rozpoznać niepowodzenie. Ustal, gdzie znajduje się odpowiedź oraz identyfikator uzgodniony z systemem księgowym. Jeżeli status jest niejasny, ponowienie powinno być kontrolowane, aby nie tworzyć kolejnej faktury zamiast dokończyć obsługę istniejącej.

Dostępy i awarie

Certyfikaty, tokeny oraz uprawnienia konfiguruje uprawniona osoba zgodnie z procedurą firmy. Nie przekazuj ich w zwykłym zgłoszeniu do wykonawcy. Ustal monitorowanie ważności, zmianę osoby odpowiedzialnej i obsługę niedostępności. Scenariusze awaryjne oraz termin wykonania czynności muszą odpowiadać aktualnym zasadom i możliwościom programu. Nie wymyślamy własnej procedury podatkowej na podstawie wygodnego działania integracji.

VAT UE i VIES nie zastępują analizy transakcji

Przy sprzedaży firmom z innych krajów potrzebna jest decyzja księgowa dotycząca rodzaju transakcji i dokumentacji. Sprawdzenie numeru w VIES może być jednym z elementów procesu. Nie należy traktować pozytywnego wyniku jako jedynego warunku zastosowania określonej stawki. Konieczne jest także poprawne powiązanie danych firmy, zamówienia oraz miejsca dostawy według uzgodnionych reguł.

Zapisz, co ma się wydarzyć przy braku odpowiedzi z usługi weryfikacyjnej i kto może zaakceptować wyjątek. Automatyczne ustawienie podatku bez takiej procedury tworzy ryzyko trudnych do wykrycia błędów. Przy wdrożeniu Shopify B2B testujemy konta, lokalizacje i dokumenty na przykładach wskazanych przez księgowego. Wycena techniczna powinna odróżniać konfigurację od indywidualnej konsultacji podatkowej. Żadna etykieta „VAT 0%” w aplikacji nie zastępuje ustalenia, kiedy można jej użyć.

Zwroty, korekty i daty w raportach

Data zamówienia, zwrotu płatności i wystawienia korekty nie muszą być identyczne. Zespół powinien wiedzieć, w jakim raporcie widzi każdą operację. Eksport zamówień nie musi być gotowym zestawieniem do księgowania zwrotów. Ustal z księgowym definicję raportu i wymagane pola, zanim uznasz różnicę między miesiącami za błąd systemu.

Sprawdź częściowy zwrot, zwrot kosztu dostawy i anulowanie bez przyjętej płatności. Każdy scenariusz może mieć inny skutek dokumentowy. W integracji potrzebne jest trwałe powiązanie korekty z dokumentem źródłowym oraz informacją o zamówieniu. Nie nadpisuj historycznych kwot w arkuszu, aby dwie sumy pozornie się zgadzały. Właściwy raport powinien pozwalać prześledzić operacje i wyjaśnić różnicę, a nie usuwać jej ślad.

Wypłaty Shopify Payments i prowizje

Wypłata zbiorcza na rachunek nie jest tym samym co suma nowych zamówień jednego dnia. Rozliczenie może obejmować różne operacje finansowe. Zestawienie należy porównywać według identyfikatorów oraz rodzaju operacji, z uwzględnieniem zasad konta i dokumentów dostawcy. Podobnie faktura za usługę platformy nie jest dokumentem sprzedaży towaru Twojemu kupującemu.

Ustal, jakie eksporty otrzymuje księgowość i jak kontroluje prowizje, zwroty oraz różnice walutowe. Można przygotować proces raportowania, ale definicje powinny zatwierdzić osoby odpowiedzialne za rozliczenie. Zautomatyzowanie niewłaściwego raportu tylko przyspiesza powielanie błędu. W ramach integracji opisujemy pochodzenie kolumn i sposób uzgodnienia. Nie obiecujemy uniwersalnego raportu podatkowego poprawnego dla każdej formy działalności, kraju i operatora.

Testy end-to-end przed uruchomieniem

Przygotuj próbkę zwykłej sprzedaży, zakupu firmowego, innej waluty i korekty. Dla każdego przypadku zapisz dane wejściowe, oczekiwany dokument, status przekazania i sposób odnalezienia go później. Osoba techniczna oraz księgowy powinni zaakceptować odpowiednie części wyniku. Sam brak błędu API nie potwierdza poprawności faktury.

  1. Sprawdź dane nabywcy oraz źródło NIP.
  2. Porównaj pozycje, rabaty, dostawę i kwoty.
  3. Potwierdź walutę oraz reguły podatkowe.
  4. Sprawdź powiązanie dokumentu z zamówieniem.
  5. Zweryfikuj uzgodniony status wysyłki do KSeF.
  6. Ponów nieudaną operację bez tworzenia duplikatu.
  7. Przetestuj częściowy zwrot i korektę.
  8. Odtwórz raport dla księgowości.

Zapisz również procedurę po aktualizacji programu. Nowa wersja konektora może zmienić mapowanie albo obsługę statusów, dlatego krytyczne scenariusze powinny być łatwe do powtórzenia.

Jak przygotować brief integracji?

Podaj program księgowy, sposób wystawiania dokumentów, rynki, waluty i system magazynowy. Opisz obecny problem oraz to, kto zatwierdza reguły podatkowe. Do wstępnej rozmowy wystarczy zanonimizowany przykład danych i lista wymaganych operacji. Nie wysyłaj tokenów KSeF, pełnych faktur klientów ani hasła do konta właściciela.

W usłudze integracji ERP i fakturowania przygotujemy mapę pól, kierunki wymiany, testy i instrukcję reagowania na błędy. Jeśli obecny proces korzysta z Base, nie zakładamy konieczności jego usunięcia; najpierw porównujemy rozwiązania. Koszt konfiguracji, licencji i późniejszego utrzymania powinien być widoczny oddzielnie. Celem jest proces możliwy do sprawdzenia przez zespół, z jasnym podziałem odpowiedzialności między sklep, program dokumentów i księgowość.

Akceptacja mapy pól

Przygotuj tabelę zawierającą źródło danych, pole docelowe, regułę przekształcenia i osobę zatwierdzającą. Dla NIP oraz firmy pokaż przykład poprawny i niekompletny. Dla dokumentu dodaj walutę, rabat i koszt dostawy. To techniczny opis integracji; znaczenie podatkowe wartości zatwierdza księgowy.

Tabelę warto zachować razem z wynikami próby. Po zmianie konektora można wtedy sprawdzić, czy nadal korzysta z tych samych pól. Jeśli program wymaga innej nazwy lub struktury, aktualizacja powinna otrzymać świadomą akceptację zamiast cichego domyślnego mapowania. Właściciel procesu powinien także znać kolejkę błędów i sposób skierowania dokumentu do ponownego sprawdzenia. Taki podział odpowiedzialności ułatwia utrzymanie integracji, nawet gdy część pracy wykonuje zewnętrzny dostawca lub zmienia się osoba prowadząca rozliczenia firmy. Uzgodniony zapis powinien pozostać dostępny dla następnej osoby odpowiedzialnej za kontrolę.

Potrzebujesz wdrożenia? Zobacz zakres usługi: ERP i faktury.

Źródła i aktualność informacji

Sprawdzono: . Dostępność funkcji i warunki dostawców mogą się zmieniać.

Ministerstwo Finansów: KSeF dla JDG i MŚPMinisterstwo Finansów: podstawy prawne i terminy KSeFKomisja Europejska: VIESShopify: wymagania B2B