Integracja z Make umożliwia automatyczne przekazywanie danych z Z24 do zewnętrznych systemów bez konieczności pisania własnego kodu.

Najczęstszy scenariusz polega na połączeniu webhooków Z24 z API, dzięki czemu Make najpierw odbiera informację o zdarzeniu (np. nowym zamówieniu), a następnie pobiera pełne dane dokumentu i przekazuje je dalej — do ERP, arkuszy, systemów księgowych lub innych automatyzacji.  

Co zrobimy

1. Make odbierze webhook z Z24 (np. „Nowe zamówienie / zmiana statusu”).

2. Z webhooka weźmie document_guid.

3. Make wykona HTTP GET do API document_get/{document_guid} z kluczem API.

4. Otrzyma komplet danych: order + items.

5. Dalej możesz: zapisać do Google Sheets, wysłać do ERP, Slacka, e-maila, n8n, itp.

Krok 1 — Utwórz scenariusz i webhook w Make

1. W Make kliknij Create a new scenario.

2. Dodaj moduł Webhooks → Custom webhook.

3. Kliknij Add i nazwij np. Z24 - order event.

4. Make pokaże URL webhooka — skopiuj go.

Krok 2 — Wklej URL webhooka w Zamawiaj24

W Z24:

1. Ustawienia → Integracje → Webhooki

2. Dodaj webhook

3. Wklej URL z Make

4. Wybierz zdarzenia (np. „Nowe zamówienie”, „Zmiana statusu”)

5. Zapisz

Teraz przejdź do Make i kliknij Run once, żeby Make czekał na pierwsze zdarzenie.

Krok 3 — Wyślij test webhooka

Wykonaj zmianę, która wywoła webhook (np. utwórz testowe zamówienie).

Po odebraniu webhooka Make pokaże w module Webhook payload.
Szukamy pola z GUID dokumentu, np. document_guid.

Jeśli w Twoim webhooku nazwa pola jest inna (np. guid, documentId, documentGuid) – w kolejnych krokach wybierasz je z listy pól dynamicznych.

Krok 4 — Dodaj moduł pobrania danych zamówienia z API

Dodaj kolejny moduł:

HTTP → Make a request

Ustawienia:

Method: GET
URL:

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

W polu {{document_guid}} wstaw dynamicznie wartość z poprzedniego modułu Webhook (kliknij w pole URL i wybierz z listy zmiennych).

Headers:

• x-api-key : TWÓJ_KLUCZ_API

Parse response: włączone (domyślnie Make i tak parsuje JSON, ale upewnij się, że response będzie JSON).

Zapisz.

Krok 5 — Co dostaniesz w odpowiedzi (ważne dla mapowania)

Ten moduł HTTP zwróci JSON:

• order (nagłówek zamówienia)

• items[] (lista pozycji)

Przykładowe pola w order

• document_guid, number, status, workflow_status

• created_at, updated_at, activated_at

• net_total, vat_total, gross_total, currency

• dane kontrahenta: contractor_name, contractor_nip, adres…

• dane dystrybutora: distributor_name, distributor_nip, adres…

Przykładowe pola w items[]

• line_no, product_name, product_gtin, quantity

• document_unit_name, document_unit_quantity, unit_conversion_factor

• unit_net_price, vat_rate, net_total, vat_total, gross_total

Krok 6 — Przetwarzanie pozycji (items) w Make

Jeśli chcesz coś zrobić “dla każdej pozycji”, dodaj:

Tools → Iterator

• Input array: wybierz items z odpowiedzi HTTP.

Od tego momentu każdy kolejny moduł wykona się osobno dla każdej pozycji (np. zapis do arkusza jako osobny wiersz).

Krok 7 — Przykładowe dalsze akcje (najczęstsze)

A) Zapis nagłówka zamówienia do Google Sheets

• Google Sheets → Add a row

• Mapujesz pola z order.*

B) Zapis pozycji do Google Sheets (po iteratorze)

• Google Sheets → Add a row

• Mapujesz pola z bieżącego elementu iteratora (np. product_name, quantity, net_total itd.)

• Dodatkowo możesz mapować order.number jako “nr zamówienia”, żeby łączyć wiersze.

C) Wysłanie JSON dalej do systemu ERP

• HTTP → Make a request (POST)

• Body = całe order + items (lub tylko co potrzebujesz)

D) Slack / Teams / e-mail

• wysyłasz podsumowanie: numer, kontrahent, wartość brutto, liczba pozycji.

Obsługa błędów (polecane)

1) Jeśli API zwróci 401/403

To znaczy:

• brak klucza,

• zły klucz,

• albo klucz nie ma scope “Odczyt zamówień”.

W Make możesz:

• dodać Error handler do modułu HTTP

• wysłać alert na e-mail/Slack “Integracja Z24: błąd autoryzacji API”.

2) Jeśli API zwróci 404

Zwykle oznacza:

• GUID jest błędny,

• albo dokument nie jest dostępny dla tego klucza (inny zespół).

Gotowy wzorzec scenariusza (podsumowanie)

1. Webhooks → Custom webhook (odbiera zdarzenie z Z24)

2. HTTP → Make a request (GET) (pobiera pełne dane po document_guid)

3. (opcjonalnie) Tools → Iterator (pozycje)

4. Twoje akcje: Sheets / ERP / e-mail / Slack / inne