Integracja WooCommerce z Subiektem
Zamówienie wpada do WooCommerce, a ktoś w biurze przepisuje je do Subiekta, wystawia paragon albo fakturę i ręcznie poprawia stany w sklepie. Po integracji dokument powstaje sam, a sklep zna prawdziwy stan magazynu.
Co będzie działać samo
- zamówienie opłacone
- zwrot w sklepie
- NIP z zamówienia
- znajduje klienta w Subiekcie
- dopasowuje towary
- pilnuje, żeby nic nie zginęło
- zamówienie od klienta
- faktura lub paragon
- stany i ceny
Zamówienie opłacone
W Subiekcie powstaje zamówienie od klienta albo od razu faktura lub paragon, zależnie od tego, jak dziś pracujesz. Zamówienia za pobraniem lub przelewem tradycyjnym mogą iść od razu albo dopiero po zaksięgowaniu wpłaty. Numer dokumentu widać w zamówieniu w panelu WooCommerce.
Zmiana stanu lub ceny w Subiekcie
Przyjęcie dostawy, sprzedaż w sklepie stacjonarnym czy nowy cennik trafiają do WooCommerce regularnie, bez Twojego udziału. Sklep nie sprzedaje towaru, którego już nie ma na półce, także przy wariantach produktu.
Komputer z Subiektem wyłączony
Zamówienia czekają i wpadają do Subiekta, gdy komputer wróci do sieci. Kolejność zostaje zachowana, żadne zamówienie się nie dubluje, a gdy coś utknie, dostajesz e-mail.
Jak wygląda wdrożenie
- 1Rozmowa, 30 minut. Którą wersję Subiekta masz, jakie dokumenty wystawiasz ze sklepu, jakich wtyczek używasz w WooCommerce i na którym komputerze lub serwerze stoi baza Subiekta.
- 2Kopia bazy i test. Pierwsze zamówienia idą do kopii Twojej bazy Subiekta, nie do tej, na której pracujesz. Sprawdzasz dokumenty na spokojnie.
- 3Odbiór z osobą od magazynu. Razem przechodzimy łączenie produktów i wariantów ze sklepu z kartoteką Subiekta, zestawy, wysyłkę, kupony, zwroty i klientów z NIP-em.
- 4Produkcja i opieka. Przełączenie na docelową bazę, alert e-mail, gdy zamówienie utknie, poprawki w cenie przez 30 dni.
Gotowa aplikacja czy integracja?
Do WooCommerce i Subiekta są gotowe integratory, np. wtyczki GeeShop dla Subiekta GT i nexo PRO albo SellIntegro w abonamencie. Jeśli sprzedajesz przez BaseLinkera (Base.com), darmowy Base Bridge połączy go z Subiektem GT, potrzebujesz tylko dodatku Sfera (licencja InsERT). W typowym sklepie to zwykle wystarczy. Integracja szyta na miarę ma sens, gdy
- nie chcesz BaseLinkera ani abonamentu integratora jako pośrednika
- masz kilka sklepów WooCommerce lub walut na jednej bazie Subiekta
- potrzebujesz własnych zasad dla dokumentów, np. inny typ dla B2B i B2C
- gotowy integrator nie obsługuje Twoich zestawów, wariantów lub magazynów
- sklep ma własne statusy zamówień lub wtyczki, których integrator nie rozumie
Dla 5 pierwszych firm 30% taniej. W zamian zgadzasz się, żebym pokazał to wdrożenie jako przykład na swojej stronie (bez poufnych danych), i wystawiasz opinię w Google.
Zajmij miejsce →Pytania
Brakuje Twojego? Napisz je w formularzu, odpowiem konkretnie.
Czy integracja działa z Subiektem GT i z Subiektem nexo?
Tak, ale inaczej. Do Subiekta GT potrzebny jest dodatek Sfera dla Subiekta GT, osobna licencja InsERT. Subiekt nexo musi być w wersji PRO, bo tylko ona pozwala podłączyć zewnętrzny program. Podstawowa wersja nexo na to nie pozwala. Na rozmowie sprawdzamy też, czy masz wolne stanowisko dla programu łączącego.
Czy muszę instalować wtyczkę w WordPressie?
Nie. Integracja łączy się ze sklepem kluczem dostępu, który generujesz w ustawieniach WooCommerce, i działa poza WordPressem. Nie obciąża hostingu i nie spowalnia składania zamówień. Klucz możesz w każdej chwili unieważnić.
Czy potrzebuję komputera, który jest cały czas włączony?
Tak. Subiekt to program stacjonarny na Windows, więc na komputerze lub serwerze, na którym jest jego baza, instaluję mały program łączący go ze sklepem. Gdy komputer jest wyłączony, zamówienia czekają i nic nie ginie.
Czy Subiekt wyśle fakturę do KSeF?
Subiekt GT i Subiekt nexo mają obsługę KSeF, więc faktura utworzona przez integrację może pójść do KSeF z poziomu programu, tak jak faktura wystawiona ręcznie. Integracja tworzy dokument, wysyłkę zostawiamy Subiektowi.
Mam już BaseLinkera. Czy potrzebuję czegoś więcej?
Często nie. Jeśli WooCommerce jest podłączony do BaseLinkera, a Ty masz Subiekta GT, Base Bridge jest darmowy i robi dokumenty oraz stany. Warto zacząć od niego, a pisać własną integrację dopiero wtedy, gdy czegoś konkretnego brakuje.
Co z produktami, które są w WooCommerce, a nie ma ich w Subiekcie?
Produkty i warianty łączymy z towarami po kodzie SKU lub EAN. Zamówienie z pozycją bez odpowiednika nie tworzy dokumentu po cichu, tylko trafia do wyjaśnienia z alertem e-mail.
Dla działu IT
Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Jak zamówienie z WooCommerce trafia do Subiekta
WooCommerce wysyła webhook order.created i order.updated przy każdej zmianie zamówienia. Integracja reaguje na wybrany status (zwykle „W trakcie realizacji” po opłaceniu), pobiera pełne zamówienie przez REST API WooCommerce (/wp-json/wc/v3/orders) i odkłada je do kolejki poza WordPressem. Podpis webhooka (X-WC-Webhook-Signature, HMAC-SHA256) jest sprawdzany, zanim cokolwiek trafi dalej. Po stronie Subiekta agent zabiera zamówienia z kolejki i tworzy dokument przez Sferę, czyli oficjalny interfejs programistyczny InsERT. To ten sam mechanizm, którego używa sam program, więc dokument wygląda tak, jakby wystawił go pracownik.
Kontrahenta szukamy po NIP-ie, a jeśli go nie ma, po e-mailu. Nowy klient zakłada się automatycznie. Jeśli checkout nie ma jeszcze pola na NIP, dodajemy je. Pozycje łączymy z towarami po SKU lub EAN (również dla wariantów), a koszt wysyłki wchodzi jako usługa.
Webhooki WooCommerce i zapasowe odpytywanie
WooCommerce sam wyłącza webhook po pięciu kolejnych nieudanych dostarczeniach, a wolny hosting potrafi zgubić pojedyncze wywołanie. Dlatego integracja nie polega wyłącznie na webhookach: co kilka minut pyta REST API o zamówienia zmienione od ostatniego sprawdzenia i uzupełnia te, których nie dostała. Stan webhooków jest monitorowany, a wyłączony webhook wraca automatycznie lub z alertem. Działa to zarówno w klasycznym zapisie zamówień, jak i w HPOS.
Subiekt GT i Subiekt nexo to dwie różne technologie
Sfera dla Subiekta GT opiera się na COM i OLE Automation, działa na Windows i wymaga osobnej licencji. Subiekt nexo PRO udostępnia Sferę w .NET, opisaną w SDK od InsERT. Podstawowa wersja nexo (bez PRO) nie daje dostępu do Sfery ani SDK, więc nie da się jej zintegrować programistycznie. Program korzystający ze Sfery loguje się jak użytkownik, więc przy małej liczbie stanowisk ustalamy, kiedy agent pracuje. W obu przypadkach kod musi działać na maszynie, która widzi bazę Subiekta, dlatego instaluję agenta na Twoim komputerze lub serwerze. Agent sam łączy się na zewnątrz, więc nie trzeba otwierać portów w firmowej sieci.
Co wraca do WooCommerce
Stany magazynowe i ceny z Subiekta trafiają do WooCommerce cyklicznie, przez REST API i zbiorcze aktualizacje produktów (products/batch, variations/batch), żeby nie przeciążać hostingu. Jeśli masz kilka magazynów w Subiekcie, ustalamy, które z nich zasilają sklep. Numer dokumentu sprzedaży zapisuje się w meta zamówienia i w notatce, więc obsługa widzi go bez otwierania Subiekta.
Zwroty i przypadki brzegowe
Zwrot zapisany w WooCommerce (refund) może tworzyć korektę w Subiekcie albo tylko zadanie dla magazynu, jeśli korekty robisz ręcznie po sprawdzeniu towaru. Osobno ustawiamy zestawy, kupony, zamówienia w walucie obcej, zamówienia dodane ręcznie w panelu, statusy dodane przez inne wtyczki i zamówienia anulowane przed wystawieniem dokumentu. Każda operacja jest zapisana w logu, więc wiadomo, co i kiedy poszło do Subiekta.