Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Jak deal z HubSpota zamienia się w dokument w Optimie
HubSpot powiadamia integrację o zmianie etapu deala przez webhook aplikacji albo przez workflow. Gdy deal przechodzi na wygrany, integracja pobiera przez CRM API powiązaną firmę, kontakt i pozycje deala, a potem odkłada zadanie do kolejki. Firmy, dealy, produkty i pozycje deala (line items) są dostępne przez CRM API także w darmowym planie, a od planu HubSpot zależą automatyzacje (workflow). Agent po stronie Optimy zakłada lub aktualizuje kontrahenta i tworzy dokument w module Handel: fakturę pro forma, zamówienie albo fakturę sprzedaży.
Kontrahenta dopasowuję po NIP-ie, a jeśli go nie ma, po identyfikatorze zapisanym przy firmie w HubSpot po pierwszej synchronizacji. Produkty łączymy po kodzie towaru, więc cena i stawka VAT pochodzą z Optimy albo z deala, zależnie od ustaleń.
Dlaczego po stronie Optimy działa agent
Comarch ERP Optima nie udostępnia publicznego REST API. W wersji stacjonarnej integracja korzysta z mechanizmów COM, które działają tylko na Windows z zainstalowaną Optimą, albo z płatnego Web API (SOAP), jeśli masz je wykupione. Agent stoi na Twoim serwerze i sam łączy się na zewnątrz, bez otwierania portów w sieci firmowej. 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 HubSpota
Numer dokumentu, kwota, termin płatności i status zapisują się we właściwościach deala i firmy. Z tych pól można budować listy, raporty i workflowy, np. zadanie dla handlowca, gdy faktura jest przeterminowana o 14 dni. Status płatności pochodzi z rozrachunków w Optimie, więc zgadza się z tym, co widzi księgowa.
Przypadki brzegowe
Osobno ustawiamy dealy w walucie obcej, rabaty na poziomie deala, zmiany po wystawieniu dokumentu (korekta w Optimie zamiast nowego dokumentu) i firmy bez NIP-u, np. zagraniczne. Każda operacja jest zapisana w logu, a ponowienie nigdy nie tworzy drugiej faktury do tego samego deala.