Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Jak zamówienie z WooCommerce trafia do Optimy
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), sprawdza podpis webhooka (X-WC-Webhook-Signature), pobiera pełne zamówienie przez REST API WooCommerce (/wp-json/wc/v3/orders) i odkłada je do kolejki poza WordPressem. 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, kupony 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. Jeśli checkout nie ma jeszcze pola na NIP, dodaję je. Towary łączymy po kodzie, SKU lub EAN, również dla wariantów, a pozycja bez odpowiednika nie tworzy dokumentu po cichu, tylko trafia do wyjaśnienia.
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 co kilka minut pyta REST API o zamówienia zmienione od ostatniego sprawdzenia i uzupełnia brakujące, a stan webhooków jest monitorowany. Działa to zarówno w klasycznym zapisie zamówień, jak i w HPOS.
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. Przy Optimie w chmurze Comarch dostęp ustalamy przed wyceną.
Co wraca do WooCommerce
Stany magazynowe i ceny z Optimy trafiają do WooCommerce cyklicznie, przez REST API i zbiorcze aktualizacje produktów i wariantów (products/batch, variations/batch), żeby nie przeciążać hostingu. Jeśli masz kilka magazynów, ustalamy, które zasilają sklep. Numer dokumentu zapisuje się w meta zamówienia, więc obsługa widzi go bez logowania do Optimy.
Zwroty i przypadki brzegowe
Zwrot zapisany w WooCommerce (refund) 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, 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.