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 szukam 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, dodaję 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.