Przejdź do treści

Integracja WooCommerce z ERP: VAT, zaokrąglenia i zgodność koszyka z fakturą

Faktura w ERP różni się od koszyka o grosze, a zespół ręcznie przepisuje i poprawia zamówienia? Ustalamy tryb cen (netto lub brutto), miejsce zaokrąglania VAT i moment eksportu, a potem wdrażamy przekazanie zamówień do ERP i powrót numeru faktury do sklepu.

Wymiana zamówieńzamówienia partnerów trafiają do BaseLinkera automatycznie, bez przepisywania przez zespółSportina B2B · Magento + BaseLinker

Ta sama pozycja w koszyku i na dokumencie: skąd bierze się grosz różnicy

koszyk i dokumentprzykład obliczeniowy
WartośćKoszyk WooCommerce
ceny wprowadzane brutto, VAT 23% wyliczany z pozycji
Dokument w ERP
ERP liczy od ceny netto z kartoteki, VAT od sumy netto
Pozycja3 × 9,99 zł = 29,97 zł3 × 8,12 zł netto = 24,36 zł
Netto
inne miejsce zaokrąglania
24,37 zł24,36 zł
VAT5,60 zł5,60 zł
Razemzapłacone 29,97 złrazem 29,96 zł
różnica 0,01 zł
Gdzie sprawdzić sposób liczenia: jedno miejsce zaokrąglania – VAT liczony na pozycji albo na sumie dokumentu, z tym samym zaokrągleniem — ta sama zasada w sklepie i w ERP (faktura = koszyk). Tryb cen porównujemy przy decyzji netto/brutto. Przykład obliczeniowy dla jednej pozycji i stawki 23%, nie dane klienta. Różnica pojawia się wtedy, gdy systemy zaokrąglają w różnych miejscach; rabat na pozycji dokłada kolejne zaokrąglenie, dlatego jego formę też ustalamy.

Od zamówienia do faktury bez przepisywania

Kolejność kroków, a przy każdym pola zamówienia, które przechodzą do ERP, i to, skąd każde z nich pochodzi. Cztery objawy, po których poznajemy tę konkretną integrację, stoją przy kroku, na którym powstają.

Od kliknięcia „kupuję” do dokumentu w ERP

  1. 01 · zdarzenieStatus „w realizacji”webhook order.updated filtrowany po statusie (albo własny hook akcji) — nie moment złożenia zamówienia
  2. 02 · kompletowanieDane zamówieniapozycje z SKU wariantu, ceny netto i brutto, klasa podatkowa, rabaty, dostawa, adresy, płatność
  3. 03 · kontrolaWalidacja przed wysyłkąkontrahent, NIP, adres i odpowiednik każdej pozycji w kartotece ERP
  4. 04 · przekazanieZ kluczem idempotencjisklep zapisuje w metadanych, że eksport się powiódł
  5. 05 · powrótNumer faktury lub WZwraca do zamówienia w WooCommerce
Szczegóły każdego kroku – pola zamówienia i objaw, gdy krok zawiedzie – niżej.
  1. 01

    Zdarzenie

    Webhook order.updated filtrowany po statusie „w realizacji” (albo własny hook akcji) — nie moment złożenia zamówienia.

    Objaw: eksport zatrzymuje się przy małym ruchu. WP-Cron odpala się dopiero przy odwiedzinach; potrzebny harmonogram systemowy.

  2. 02

    Kompletowanie danych

    Pozycje z SKU wariantu, ceny netto i brutto, klasa podatkowa, rabaty, koszt dostawy, adresy, forma płatności.

    PoleŹródłoUwaga
    SKU pozycjiwariant, nie rodzicmusi być unikalne
    cena nettoWooCommercewg wybranego trybu
    stawka VATklasa podatkowamapa do ERP
    rabatkupon lub regułaosobna pozycja lub korekta
    dostawametoda wysyłkiwłasna stawka VAT

    Objaw: grosz różnicy na fakturze. Dwa różne miejsca zaokrąglania VAT — zasada z porównania netto/brutto niżej i przykład z otwarcia.

  3. 03

    Walidacja przed wysyłką

    Sprawdzamy kontrahenta, NIP, kompletność adresu i to, czy każda pozycja ma odpowiednik w kartotece ERP.

    PoleŹródłoUwaga
    NIPpole checkoutu (dodane wtyczką lub własnym kodem)walidacja przed eksportem

    Objaw: pozycja bez dopasowania. Wariant bez unikalnego SKU albo SKU zmienione przez wtyczkę.

  4. 04

    Przekazanie z kluczem

    Zamówienie idzie z kluczem idempotencji. Sklep zapisuje w metadanych, że eksport się powiódł, i nie wysyła go ponownie.

    Gdy ERP przyjął zamówienie, a odpowiedź nie dotarła, przed ponowieniem sprawdzamy w ERP, czy dokument z tym kluczem już istnieje.

    Objaw: zamówienie w ERP dwa razy. Brak klucza idempotencji przy ponowieniu.

  5. 05

    Powrót dokumentu

    Numer faktury lub WZ wraca do zamówienia w WooCommerce, żeby obsługa klienta nie musiała szukać w ERP.

Netto czy brutto — konsekwencje obu wyborów

Najczęstsza reklamacja księgowości przy tej integracji to różnica jednego grosza między koszykiem a fakturą. Bierze się z tego, że sklep trzyma ceny brutto i zaokrągla na pozycji, a ERP liczy od netto na całym dokumencie.

Ceny wprowadzane bruttosprzedaż detaliczna
  • Cena na listingu: równa, bez końcówek
  • Zgodność z ERP liczącym od netto: wymaga wspólnej reguły zaokrągleń
  • Zmiana stawki VAT: zmienia netto, brutto zostaje
  • Sprzedaż zagraniczna: trudniejsza — inna stawka zmienia marżę
  • Ryzyko różnic groszowych: wyższe
Ceny wprowadzane nettosprzedaż B2B i mieszana
  • Cena na listingu: wyliczana, bywa z groszówką
  • Zgodność z ERP liczącym od netto: naturalna
  • Zmiana stawki VAT: zmienia brutto, netto zostaje
  • Sprzedaż zagraniczna: łatwiejsza — netto stałe
  • Ryzyko różnic groszowych: niższe
Typowe zastosowanie: ceny brutto – sprzedaż detaliczna; ceny netto – sprzedaż B2B i mieszana.

WooCommerce i ERP — pytania

Nie ma tu Twojego pytania? Napisz

To decyzja, którą trzeba podjąć przed integracją, bo zmiana później oznacza inną interpretację każdej ceny w katalogu: trzeba ją przeliczyć importem, stare zamówienia zachowują poprzedni tryb, a raporty mieszają oba. Przy sprzedaży B2C zwykle wygodniej trzymać ceny brutto, przy B2B netto. Kluczowe jest, żeby ERP i sklep liczyły VAT w tym samym kierunku, inaczej pojawią się różnice groszowe na dokumentach.
Stawki i klasy podatkowe muszą mieć jedno źródło. Zwykle prowadzi je ERP, a sklep dostaje gotową klasę podatkową dla każdego produktu. Reguły dla wysyłek zagranicznych spisujemy osobno, bo to najczęstsze miejsce rozjazdu między koszykiem a fakturą.
Tak, REST API udostępnia operacje batch dla produktów i wariantów. Przy większych katalogach to podstawa, bo aktualizacja rekord po rekordzie generuje setki zapytań i mocno obciąża hosting. Rozmiar paczki dobieramy do limitów serwera.
Zamówienie dostaje własny klucz idempotencji, a sklep zapisuje w metadanych, że eksport się powiódł i jaki numer dokumentu wrócił z ERP; z tym znacznikiem zamówienie nie jest wysyłane drugi raz. Po timeoucie znacznika nie ma, bo odpowiedź nie dotarła – wtedy przed ponowieniem sprawdzamy w ERP, czy dokument z tym kluczem już istnieje.
Najpierw ustalamy, która wtyczka zapisuje to samo pole, i wyłączamy jej automatyczne działanie albo zawężamy zakres. Jeżeli funkcja jest potrzebna, przenosimy ją do kontrolowanego kodu motywu lub małego modułu, zamiast godzić się na dwa systemy piszące do jednego pola.

Napisz, czy sprzedajesz B2C, B2B czy jedno i drugie, i jaki masz ERP

Od tego zaczynamy: tryb cen, klasy podatkowe i moment, w którym zamówienie ma trafiać do ERP — tak, żeby faktura zgadzała się z koszykiem, a zespół przestał przepisywać zamówienia.

przesyłasz

B2C, B2B czy jedno i drugie

model sprzedaży

przesyłasz

Jaki masz ERP

system, który wystawia dokumenty

od tego zaczynamy

Tryb cen i klasy podatkowe

i moment, w którym zamówienie ma trafiać do ERP