Integracje z Z24 – jak działa przepływ danych

Z24 udostępnia uniwersalny mechanizm integracji, który pozwala przekazywać dane do dowolnych systemów zewnętrznych — takich jak ERP, WMS, systemy księgowe, automatyzacje czy platformy integracyjne.

Podstawą integracji jest połączenie webhooków z API, co zapewnia jednocześnie szybkość, bezpieczeństwo i pełną kontrolę nad danymi.

Ogólna koncepcja integracji

Integracja z Z24 opiera się na prostym i sprawdzonym schemacie:

1. Webhook z Z24 informuje o zdarzeniu
   (np. nowe zamówienie, zmiana statusu dokumentu).

2. Webhook przekazuje identyfikator dokumentu (GUID)
   Jest to globalny identyfikator, który jednoznacznie wskazuje konkretny dokument.

3. System integrujący pobiera pełne dane dokumentu przez API
   Na podstawie GUID wykonywane jest zapytanie do API Z24.

4. Dane są przetwarzane i przekazywane dalej
   Do ERP, systemu magazynowego, księgowości lub innej automatyzacji.

Webhook pełni rolę sygnału, a API jest źródłem danych.

Dlaczego webhook + API, a nie wszystko w webhooku?

Takie podejście ma kilka kluczowych zalet:

• webhooki są lekkie i szybkie,

• dane pobierane są tylko wtedy, gdy są potrzebne,

• zawsze pobierana jest aktualna wersja dokumentu,

• łatwiej obsłużyć ponowne pobranie danych (retry),

• ten sam mechanizm działa dla różnych systemów integrujących.

Dzięki temu integracja jest stabilna i skalowalna.

Pobieranie danych dokumentu przez API

Po odebraniu webhooka, system integrujący wykonuje zapytanie:

GET https://api.z24.io/functions/v1/document_get/{DOCUMENT_GUID}

API zwraca komplet informacji o dokumencie:

• dane nagłówka zamówienia,

• dane kontrahenta,

• dane dystrybutora (jeśli występuje),

• listę pozycji wraz z cenami, stawkami VAT i jednostkami.

Dane są zwracane w jednym, spójnym formacie JSON, gotowym do dalszego mapowania.

Uniwersalność integracji

Ten sam schemat integracyjny może być użyty w:

• platformach automatyzacji (Make, n8n, Zapier),

• systemach klasy ERP i WMS,

• dedykowanych integracjach API,

• rozwiązaniach middleware i ETL.

Z24 nie narzuca technologii — integracja działa wszędzie tam, gdzie możliwe jest:

• odebranie webhooka,

• wykonanie zapytania HTTP do API,

• przetworzenie danych JSON.

Bezpieczeństwo i kontrola dostępu

Dostęp do API Z24 jest zabezpieczony kluczami API:

• każdy klucz przypisany jest do konkretnego zespołu,

• klucz posiada zakresy dostępu (np. odczyt zamówień),

• możliwe jest wyłączenie lub rotacja klucza w dowolnym momencie.

Dzięki temu integracje są bezpieczne i w pełni kontrolowane.

Co można zintegrować

Najczęstsze scenariusze integracyjne:

• przekazywanie zamówień do ERP,

• automatyczne tworzenie dokumentów magazynowych,

• synchronizacja danych do systemów księgowych,

• raportowanie i analizy,

• automatyzacje operacyjne i powiadomienia.

Mechanizm webhook + API jest punktem wyjścia do wszystkich tych integracji.

Kolejne kroki

W kolejnych artykułach w tej sekcji znajdziesz:

• instrukcje integracji z Make,

• przykłady integracji z BaseLinker (Base),

• szczegółowy opis endpointów API,

• praktyczne scenariusze mapowania danych.

Ten artykuł pokazuje ogólną ścieżkę integracji — kolejne prowadzą już krok po kroku przez konkretne narzędzia.