Jak przetestować pobieranie dokumentu przez API (Postman)

Zanim uruchomisz integrację produkcyjną, warto ręcznie sprawdzić działanie API Z24.
Najprostszym sposobem jest użycie narzędzia Postman, które pozwala wykonać zapytanie HTTP i zobaczyć pełną odpowiedź API.

Krok 1 — Przygotuj dane testowe

Do testu potrzebujesz:

• GUID dokumentu (np. z webhooka lub z listy dokumentów w Z24),

• klucz API z włączonym zakresem Odczyt zamówień.

Krok 2 — Utwórz nowe zapytanie w Postman

1. Otwórz Postman.

2. Kliknij New → HTTP Request.

3. Ustaw:

   • Method: GET

   • URL:

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

   • Zamień {DOCUMENT_GUID} na rzeczywisty GUID dokumentu.

Przykład:

https://api.z24.io/functions/v1/document_get/e0e71675-c8de-4e67-bb19-bc4544496629

Krok 3 — Dodaj nagłówek autoryzacji

Przejdź do zakładki Headers i dodaj:

Krok 4 — Wyślij zapytanie

Kliknij Send.

Jeśli wszystko jest poprawnie skonfigurowane, Postman zwróci:

• Status: 200 OK

• odpowiedź w formacie JSON zawierającą:

  • order – dane zamówienia,

  • items – listę pozycji.

Krok 5 — Sprawdź strukturę odpowiedzi

W odpowiedzi zobaczysz m.in.:

• numer zamówienia,

• dane kontrahenta i dystrybutora,

• wartości netto, VAT i brutto,

• listę pozycji z ilościami, cenami i stawkami VAT.

To dokładnie ten sam format, który otrzyma system integrujący (Make, BaseLinker, ERP).

Najczęstsze problemy i ich rozwiązania

401 – Unauthorized

• brak nagłówka x-api-key,

• nieprawidłowy klucz API,

• klucz jest nieaktywny.

403 – Forbidden

• klucz API nie ma uprawnienia do odczytu zamówień.

404 – Not Found

• nieprawidłowy GUID dokumentu,

• dokument nie należy do zespołu przypisanego do klucza API.

500 – Server Error

• chwilowy problem po stronie Z24 – spróbuj ponownie po kilku sekundach.

Co dalej

Jeśli test w Postman zakończył się sukcesem:

• możesz użyć tego samego endpointu w Make, BaseLinker lub innym systemie,

• masz pewność, że webhook + API działa poprawnie,

• możesz bezpiecznie przejść do automatyzacji produkcyjnej.