Sklepy internetowe Problem i rozwiązanie
Integracja WooCommerce z programem księgowym - Subiekt, Optima, enova, wFirma, Fakturownia
W skrócie
- Objaw: zamówienia z WooCommerce trafiają do programu księgowego ręcznie albo niepełne, sumy różnią się o grosze, rabaty i dostawa giną, a na koniec miesiąca ktoś szuka różnic między sklepem a ewidencją.
- Przyczyna: brak integracji albo integracja, która przekazuje tylko część danych, łączy produkty po nazwie, nie ma zmapowanych stawek VAT i metod płatności, a dokumenty powstają w złym momencie.
- Rozwiązanie: wybierz sposób połączenia pasujący do programu (API, system wielokanałowy, moduł producenta lub własny łącznik), ustal źródło danych dla produktów, stanów i cen oraz przetestuj integrację na zamówieniach z rabatem, dostawą, zwrotem i korektą.
Nie masz czasu? Zrobimy to za Ciebie - Sklepy internetowe od 3 500 zł netto
WooCommerce łączy się z programem księgowym na trzy sposoby: bezpośrednio przez API programu (najczęściej przy programach w chmurze, takich jak wFirma czy Fakturownia), przez system do sprzedaży wielokanałowej, który ma integracje z wieloma programami, albo przez moduł integracyjny producenta lub własny łącznik (częste przy programach instalowanych w firmie, takich jak Subiekt, Comarch ERP Optima czy enova365). Niezależnie od sposobu integracja musi przekazywać pełne zamówienie: dane nabywcy z NIP, pozycje z SKU, stawki VAT, rabaty, dostawę, płatność i korekty.
Jak wygląda problem?
- ktoś codziennie przepisuje zamówienia ze sklepu do programu,
- dokument sprzedaży różni się od zamówienia o kilka groszy,
- rabat z kuponu jest na fakturze osobną pozycją albo znika,
- koszt dostawy nie trafia do dokumentu,
- produkt w programie nazywa się inaczej niż w sklepie i integracja go nie rozpoznaje,
- zwrot w sklepie nie kończy się korektą w księgowości.
Jakie są sposoby połączenia sklepu z programem księgowym?
Wybór zależy od tego, czy program działa w chmurze, czy jest zainstalowany w firmie, i od tego, czy oprócz dokumentów sprzedaży chcesz wymieniać też produkty, stany i ceny.
| Sposób | Kiedy pasuje | Na co uważać |
|---|---|---|
| Integracja przez API programu w chmurze (np. wFirma, Fakturownia) | Sklep wystawia dokumenty sprzedaży z zamówień, a program jest dostępny przez internet | Zakres danych, które przekazuje wtyczka lub integracja, i obsługa korekt |
| System do sprzedaży wielokanałowej (np. Base) | Sprzedajesz w kilku kanałach i i tak obsługujesz w nim zamówienia | Kolejny abonament, powiązanie produktów po SKU, kierunek synchronizacji |
| Moduł producenta albo własny łącznik (np. Subiekt, Comarch ERP Optima, enova365) | Program działa w firmie, jest źródłem produktów, stanów i cen | Czy Twoja wersja ma interfejs do integracji i czy jest płatny, gdzie działa łącznik i co się dzieje, gdy serwer jest wyłączony |
Dostępność integracji i interfejsów zmienia się razem z wersjami programów, dlatego przed wyborem sprawdź u producenta lub dostawcy programu, co obsługuje Twoja wersja. Nie zakładaj, że wtyczka działająca u innego sklepu obsłuży Twoje rabaty, zestawy czy korekty.
Co musi przejść ze sklepu do księgowości?
Wszystko, czego księgowość potrzebuje do dokumentu bez ręcznych poprawek. Brak jednego elementu oznacza ręczną pracę przy każdym zamówieniu, którego dotyczy.
- dane nabywcy: nazwa firmy, NIP, adres, a dla osoby prywatnej imię, nazwisko i adres,
- pozycje z SKU lub EAN, ilością, ceną i stawką VAT,
- rabaty przypisane do pozycji, a nie jedna kwota na koniec,
- dostawa jako osobna pozycja z właściwą stawką,
- sposób płatności i informacja, czy zamówienie jest opłacone,
- numer zamówienia ze sklepu, po którym obsługa znajdzie dokument,
- zwroty i zmiany po wystawieniu dokumentu, które wymagają korekty.
Najczęstsze błędy integracji sklepu z księgowością
Różnice groszowe
WooCommerce może zaokrąglać podatek na poziomie każdego wiersza albo na poziomie sumy częściowej (ustawienie w WooCommerce, Ustawienia, Podatek), a program księgowy liczy VAT od netto lub od brutto według własnych zasad. Jeśli te metody się różnią, dokument różni się od zamówienia o grosze. Ustal jedną zasadę i sprawdź ją na zamówieniu z kilkoma pozycjami i rabatem procentowym.
Niezmapowane stawki VAT i metody płatności
Klasy podatkowe WooCommerce (standardowa, obniżona, zerowa) muszą odpowiadać konkretnym stawkom w programie, a metody płatności ze sklepu formom płatności w dokumencie. Bez tego integracja wstawia stawkę domyślną albo zatrzymuje się na błędzie.
Produkty łączone po nazwie
Nazwy w sklepie zmieniają się ze względów marketingowych, a w programie zostają stare. Wspólnym kluczem powinien być SKU lub EAN, unikalny dla każdego produktu i wariantu, wpisany identycznie w obu systemach.
Dwa źródła stanów i cen
Jeśli program księgowy lub magazynowy wysyła do sklepu stany i ceny, a ktoś zmienia je też w sklepie, kolejna synchronizacja nadpisze zmiany. Ustal, który system jest źródłem dla każdego rodzaju danych. Szerzej opisujemy to we wpisie o tym, dlaczego stany w sklepie i na Allegro się nie zgadzają.
Dokument powstaje w złym momencie
Dokument tworzony przy każdym złożonym zamówieniu oznacza korekty dla zamówień nieopłaconych i anulowanych. Dokument tworzony ręcznie po wysyłce opóźnia rozliczenie. Ustal z księgowością, przy którym statusie zamówienia powstaje dokument.
Brak obsługi KSeF
Faktury dla firm trafiają dziś do KSeF, więc program, z którym łączysz sklep, musi tę wysyłkę obsługiwać, a integracja przekazywać dane w pełnym zakresie. Szczegóły opisujemy we wpisie KSeF w sklepie WooCommerce.
Łącznik działający na komputerze w biurze przestaje wysyłać dane, gdy komputer jest wyłączony albo traci połączenie. Jeśli program księgowy jest zainstalowany lokalnie, sprawdź, gdzie działa integracja i kto dostanie powiadomienie, gdy przestanie działać.
Połączenie WooCommerce z programem księgowym, magazynem i KSeF, z mapowaniem stawek, płatności i korekt, robimy w ramach integracji sklepu internetowego. Jeśli zamówienia obsługujesz przez Base i one same nie docierają, zobacz wpis BaseLinker nie pobiera zamówień z WooCommerce. Ten problem jest jednym z naszej listy 30 problemów z integracjami sklepu internetowego.
Darmowy skan sklepu
Sprawdź swój sklep za darmo
Wpisz adres, a przeniesiemy Cię do bezpłatnego skanu na stronie CodeScriptum.
Jak to rozwiązać krok po kroku
Integracja WooCommerce z programem księgowym - Subiekt, Optima, enova, wFirma, Fakturownia - https://codescriptum.pl/blog/integracja-woocommerce-z-programem-ksiegowym/
- Spisz z księgowością, jakie dokumenty powstają do zamówień (faktura, paragon, korekta), przy jakim statusie zamówienia i jakie dane muszą się w nich znaleźć.
- Sprawdź, czy Twój program księgowy działa w chmurze z API, czy jest zainstalowany w firmie, i jaki sposób integracji obsługuje jego wersja.
- Ujednolić SKU lub EAN w sklepie i w programie, tak aby każdy produkt i wariant miał ten sam unikalny kod w obu systemach.
- Zmapuj klasy podatkowe WooCommerce na stawki VAT w programie, metody płatności na formy płatności, a dostawę na osobną pozycję.
- Ustal, który system jest źródłem produktów, stanów i cen, i ustaw kierunek synchronizacji tylko w tę stronę.
- Przetestuj integrację na zamówieniach: firma i osoba prywatna, z rabatem procentowym, z dostawą, opłacone i anulowane, ze zwrotem. Porównaj sumy dokumentów z zamówieniami.
- Włącz powiadomienie o błędach integracji i raz w miesiącu porównuj sumę zamówień w sklepie z sumą dokumentów w programie.
Jak sprawdzić, że zadziałało
Dokumenty z kilkunastu testowych i prawdziwych zamówień zgadzają się z zamówieniami co do grosza, zawierają NIP, rabaty i dostawę, a zwrot w sklepie kończy się korektą. Przy zamknięciu miesiąca suma sprzedaży w sklepie i w programie różni się tylko o zamówienia, których status jeszcze nie pozwala na wystawienie dokumentu.
Usługa CodeScriptum
Sklepy internetowe
od 3 500 zł netto
- WooCommerce, Shopify, PrestaShop, Shoper i sklepy dedykowane
- Migracja bez utraty pozycji w Google
- Integracje: płatności, InPost, BaseLinker, KSeF
Najczęściej zadawane pytania
Czy da się połączyć WooCommerce z Subiektem albo Optimą?
Zwykle tak, przez moduł integracyjny producenta, system do sprzedaży wielokanałowej albo własny łącznik. Zakres i koszt zależą od wersji programu, dlatego sprawdź u producenta lub dostawcy, jaki interfejs obsługuje Twoja wersja.
Skąd biorą się różnice groszowe między sklepem a fakturą?
Najczęściej z innego sposobu zaokrąglania podatku: po wierszu albo od sumy, od netto albo od brutto. Ustal jedną zasadę w sklepie i w programie i sprawdź ją na zamówieniu z rabatem procentowym.
Czy integracja z programem księgowym obsłuży KSeF?
Wysyłkę do KSeF obsługuje program do faktur lub system księgowy. Integracja ze sklepem musi przekazać mu pełne dane zamówienia, żeby faktura przeszła walidację.
Czy lepiej łączyć sklep z księgowością bezpośrednio, czy przez BaseLinkera?
Jeśli sprzedajesz w kilku kanałach i obsługujesz zamówienia w systemie wielokanałowym, wygodniej połączyć z nim księgowość. Przy jednym sklepie bezpośrednia integracja jest prostsza i nie wymaga kolejnego abonamentu.
Pojęcia w tym artykule
Źródła
- WooCommerce: konfiguracja podatków (zaokrąglanie, wyświetlanie cen) (otwiera się w nowej karcie) woocommerce.com
- Dokumentacja REST API WooCommerce (otwiera się w nowej karcie) woocommerce.github.io
- Fakturownia: dokumentacja API (otwiera się w nowej karcie) github.com
- KSeF: etapy wdrożenia KSeF 2.0 (Ministerstwo Finansów) (otwiera się w nowej karcie) ksef.podatki.gov.pl
Podobne problemy
Sklepy internetowe
Problemy z integracjami sklepu internetowego: 30 błędów z BaseLinkerem, Allegro, ERP, KSeF i kurierami (2026)
Przy każdym z 30 problemów podajemy przyczynę i rozwiązanie, a przy najczęstszych link do szczegółowej naprawy; jeśli wolisz oddać połączenie sklepu z innymi systemami zespołowi…
Sklepy internetowe
KSeF w sklepie WooCommerce - jak wystawiać e-faktury do zamówień i czego pilnować
Rozwiązanie Program do faktur z obsługą KSeF, integracja przekazująca pełne zamówienie, pole NIP z walidacją, ustalone zasady dla konsumentów, korekt i trybu offline oraz test na…
Sklepy internetowe
BaseLinker nie pobiera zamówień z WooCommerce - przyczyny i naprawa krok po kroku
Rozwiązanie Sprawdź połączenie w ustawieniach integracji, klucze REST API z uprawnieniami do odczytu i zapisu, wtyczkę Base, odnośniki i reguły zapory, a po naprawie dociągnij…
Sklepy internetowe
Klient zapłacił, a zamówienie WooCommerce dalej „Oczekuje na płatność”
Rozwiązanie Popraw adres powiadomień w panelu operatora, odblokuj go w zaporze i cache, zaktualizuj wtyczkę bramki i sprawdź logi.