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 + BaseLinkerTa sama pozycja w koszyku i na dokumencie: skąd bierze się grosz różnicy
| 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 |
|---|---|---|
| Pozycja | 3 × 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ł |
| VAT | 5,60 zł | 5,60 zł |
| Razem | zapłacone 29,97 zł | razem 29,96 zł różnica 0,01 zł |
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
- Status „w realizacji”webhook order.updated filtrowany po statusie (albo własny hook akcji) — nie moment złożenia zamówienia
- Dane zamówieniapozycje z SKU wariantu, ceny netto i brutto, klasa podatkowa, rabaty, dostawa, adresy, płatność
- Walidacja przed wysyłkąkontrahent, NIP, adres i odpowiednik każdej pozycji w kartotece ERP
- Z kluczem idempotencjisklep zapisuje w metadanych, że eksport się powiódł
- Numer faktury lub WZwraca do zamówienia w WooCommerce
-
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.
-
02
Kompletowanie danych
Pozycje z SKU wariantu, ceny netto i brutto, klasa podatkowa, rabaty, koszt dostawy, adresy, forma płatności.
PoleŹródłoUwagaSKU pozycjiwariant, nie rodzicmusi być unikalnecena nettoWooCommercewg wybranego trybustawka VATklasa podatkowamapa do ERPrabatkupon lub regułaosobna pozycja lub korektadostawametoda wysyłkiwłasna stawka VATObjaw: 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.
-
03
Walidacja przed wysyłką
Sprawdzamy kontrahenta, NIP, kompletność adresu i to, czy każda pozycja ma odpowiednik w kartotece ERP.
PoleŹródłoUwagaNIPpole checkoutu (dodane wtyczką lub własnym kodem)walidacja przed eksportemObjaw: pozycja bez dopasowania. Wariant bez unikalnego SKU albo SKU zmienione przez wtyczkę.
-
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.
-
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.
- 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
- 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
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.
B2C, B2B czy jedno i drugie
model sprzedaży
Jaki masz ERP
system, który wystawia dokumenty
Tryb cen i klasy podatkowe
i moment, w którym zamówienie ma trafiać do ERP