Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Jak zamówienie z Shopify trafia do Optimy
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 Optimy agent zabiera zamówienia z kolejki i tworzy dokument w module Handel: rezerwację odbiorcy, fakturę sprzedaży albo paragon. Pozycje, stawki VAT, rabaty i koszt wysyłki przechodzą jako osobne wiersze, tak jak widzi je księgowa.
Kontrahenta szukam po NIP-ie, a jeśli go nie ma, po e-mailu. Nowego klienta zakładam w kartotece automatycznie. Towary łączymy po kodzie, SKU lub EAN, a pozycja bez odpowiednika nie tworzy dokumentu po cichu, tylko trafia do wyjaśnienia.
Optima stacjonarna, Web API i chmura
Comarch ERP Optima nie ma publicznego REST API. W wersji stacjonarnej najpewniejszą drogą są mechanizmy COM, które działają tylko na Windows, na maszynie z zainstalowaną Optimą. Dlatego agent stoi na Twoim serwerze lub komputerze i sam łączy się na zewnątrz, bez otwierania portów w sieci firmowej. Jeśli masz już Web API do Optimy (usługa SOAP, osobna licencja), można z niego skorzystać. Trzecią możliwością jest import plików XML do Optimy. Optima w Chmurze Comarch w wariancie Standard nie daje dostępu programistycznego ani możliwości instalowania dodatków. Dostęp do API Optimy i instalację agenta daje wydzielone środowisko (Chmura Enterprise), więc wariant sprawdzamy przed wyceną.
Co wraca do Shopify
Stany magazynowe i ceny z Optimy trafiają do Shopify cyklicznie, przez Admin API i poziomy zapasów w lokalizacji sklepu. Jeśli masz kilka magazynów, ustalamy, które zasilają sklep. Numer dokumentu zapisuje się w metapolu zamówienia, więc obsługa widzi go bez logowania do Optimy.
Zwroty i przypadki brzegowe
Zwrot w Shopify (refunds/create) może tworzyć korektę w Optimie albo tylko zadanie dla magazynu, jeśli korekty wystawiasz po sprawdzeniu towaru. Osobno ustawiamy zamówienia w walucie obcej (kurs średni NBP z ostatniego dnia roboczego przed właściwą datą), zestawy, karty podarunkowe i zamówienia anulowane przed wystawieniem dokumentu. Każda operacja jest zapisana w logu.