Integracja Z24 z Comarch ERP XL – możliwe warianty

Z24 może być integrowany z Comarch ERP XL na kilka sposobów, w zależności od infrastruktury klienta, sposobu pracy z XL oraz poziomu automatyzacji, jaki ma zostać osiągnięty.

W każdym wariancie integracja opiera się na tym samym mechanizmie:

• Z24 wysyła webhook informujący o zdarzeniu,

• system integrujący pobiera pełne dane dokumentu przez API Z24,

• dane trafiają do Comarch ERP XL w uzgodnionym formacie.

Wspólny punkt dla wszystkich wariantów

Niezależnie od wybranego rozwiązania:

• webhook z Z24 przekazuje GUID dokumentu,

• API Z24 (document_get) zwraca komplet danych zamówienia i pozycji,

• dane są mapowane do struktury dokumentów w ERP XL.

Z24 nie narzuca technologii — sposób połączenia zależy od środowiska klienta.

Wariant 1 — Platforma integracyjna (Make / n8n)

Najczęściej wybierany wariant przy szybkich wdrożeniach.

Schemat:
Z24 → webhook → Make / n8n → API Z24 → przekazanie do XL

Zalety:

• szybkie uruchomienie,

• brak potrzeby pisania własnego serwisu,

• łatwa modyfikacja przepływu danych.

Ograniczenia:

• wymaga, aby po stronie XL istniał punkt integracyjny (API, usługa, import),

• nie zawsze sprawdza się przy bardzo dużej liczbie dokumentów.

Wariant 2 — Dedykowany konektor po stronie klienta

Najbardziej elastyczne i stabilne rozwiązanie, często stosowane w większych wdrożeniach XL.

Schemat:
Z24 → webhook → konektor (np. aplikacja .NET) → API Z24 → zapis do ERP XL

Zalety:

• pełna kontrola nad logiką integracji,

• możliwość kolejkowania, retry i logowania,

• dopasowanie do lokalnej instalacji XL.

Ograniczenia:

• wymaga wdrożenia dodatkowej usługi po stronie klienta.

Wariant 3 — Import plikowy do Comarch ERP XL

Często stosowany w firmach, które już korzystają z importów.

Schemat:
Z24 → webhook → API Z24 → generowanie pliku (CSV / XML) → import do XL

Zalety:

• prostota,

• brak bezpośredniego połączenia z bazą lub API XL,

• zgodność z istniejącymi procedurami klienta.

Ograniczenia:

• mniejsza elastyczność,

• przetwarzanie zwykle asynchroniczne.

Wariant 4 — Integracja przez firmę zewnętrzną

Jeśli klient współpracuje z integratorem ERP.

Schemat:
Z24 → webhook → system integratora → API Z24 → ERP XL

Zalety:

• brak konieczności budowania integracji samodzielnie,

• wykorzystanie doświadczenia integratora XL.

Ograniczenia:

• zależność od harmonogramu i kosztów firmy trzeciej.

Dane dostępne w API Z24

API Z24 udostępnia m.in.:

• nagłówek zamówienia,

• dane kontrahenta (NIP, adres),

• dane dystrybutora,

• pozycje dokumentu,

• ilości, jednostki i przeliczniki,

• ceny netto, VAT i brutto.

Dzięki temu możliwe jest poprawne odwzorowanie dokumentu w ERP XL.

Na co zwrócić uwagę przy integracji z ERP XL

• Identyfikacja kontrahenta – najczęściej po NIP,

• Mapowanie towarów – po kodzie, EAN (GTIN) lub identyfikatorze wewnętrznym,

• Jednostki i przeliczniki – zgodność z kartoteką XL,

• Statusy dokumentów – uzgodnienie, gdzie są zarządzane.

Podsumowanie

Z24 może być skutecznie zintegrowany z Comarch ERP XL niezależnie od:

• wielkości firmy,

• sposobu wdrożenia XL,

• używanej technologii integracyjnej.

Webhooki i API Z24 zapewniają uniwersalny punkt wejścia, który można dopasować do każdego scenariusza integracyjnego.