Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Jak zamówienie z Shopify trafia do Subiekta
Shopify wysyła zdarzenie orders/paid w chwili, gdy płatność jest potwierdzona. Integracja pobiera pełne zamówienie przez Admin API i odkłada je do kolejki. 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. Pozycje łączymy z towarami po SKU lub EAN, a koszt wysyłki wchodzi jako usługa, tak jak księgowa jest przyzwyczajona.
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. 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 Shopify
Stany magazynowe i ceny z Subiekta trafiają do Shopify cyklicznie, przez Admin API i poziomy zapasów w lokalizacji sklepu. Jeśli masz kilka magazynów w Subiekcie, ustalamy, które z nich zasilają sklep. Numer dokumentu sprzedaży zapisuje się w metapolu zamówienia, więc obsługa widzi go bez otwierania Subiekta.
Zwroty i przypadki brzegowe
Zwrot w Shopify (refunds/create) może tworzyć korektę w Subiekcie albo tylko zadanie dla magazynu, jeśli korekty robisz ręcznie po sprawdzeniu towaru. Osobno ustawiamy zestawy, karty podarunkowe, zamówienia w walucie obcej i zamówienia anulowane przed wystawieniem dokumentu. Każda operacja jest zapisana w logu, więc wiadomo, co i kiedy poszło do Subiekta.