Log in op uw Zonos Dashboard en ga naar Account →
Integrations. De tabel toont twee keys:
Naam in Dashboard↕
Doel↕
Gebruiken voor de API?↕
Account key
ID voor koppeling met de postoperator
❌ NEE
API key
Authenticatiesleutel voor het aanroepen van de Zonos API
✅ JA — gebruik deze
Kopieer het token in de rij API key. Het begint met credential_live_. U heeft deze
key nodig voor beide integratiemethoden.
Houd uw API key veilig. Commit deze niet naar source control en deel deze niet publiek. Als u
denkt dat deze is gecompromitteerd, genereer deze opnieuw via dezelfde pagina Account → Integrations.
De Item Quoter-tool in uw
Zonos Dashboard laat u geschatte invoerrechtkosten voor uw producten opzoeken vóór verzending — handig
om tarieven te controleren en vooruit te plannen zonder een Declaration ID te genereren.
Kies de methode die past bij uw technische configuratie. Beide methoden produceren Declaration ID's die u
vervolgens uploadt naar het verzendsysteem van Česká pošta.
Voor technische klanten en ontwikkelaars die Zonos rechtstreeks aanroepen vanuit hun eigen systeem.
Endpoint
URL: https://api.zonos.com/graphql
Method: POST
Content-Type: application/json
Authenticatie
Stuur uw API key mee in de header credentialToken:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
API-voorbeeld
Log in op uw Česká pošta-account voor het volledige API-voorbeeld, inclusief het volledige request en
response.
Na het genereren van Declaration ID's
Dien de Declaration ID in bij Česká pošta samen met uw zendingdetails. Česká pošta koppelt
de Declaration ID aan de zending en retourneert een trackingnummer. Zonos geeft geen trackingnummers uit.
Foutafhandeling
Fout/symptoom↕
Waarschijnlijke oorzaak en oplossing↕
Security requirement failed
Uw API key is ongeldig of in de verkeerde header meegegeven. Gebruik de API Key (niet de Account Key) en zorg dat de headernaam exact credentialToken is.
HTTP 401 Unauthorized
De API key ontbreekt in de request headers. Controleer of credentialToken is opgenomen.
errors array in response
De mutation retourneerde een GraphQL-fout. Controleer het veld message in de errors array voor details.
Unexpected response shape
Het response bevatte geen data.declarationCreate.id. Log het volledige response body en controleer of de mutationtekst exact overeenkomt met het voorbeeld.
Accountconfiguratie
Accountconfiguratie
Maak uw Verified Account aan, voeg een betaalmethode toe en koppel uw integratie.Stap 1 — Maak uw Verified Account aan
Registreer voor een Zonos Verified Account via de Česká pošta-registratielink. Voltooi uw zakelijk adres en factureringsconfiguratie.
Stap 2 — Voeg een betaalmethode toe
Voeg een betaalmethode toe aan uw Zonos-account om invoerrechtafdracht voor zendingen naar de VS te financieren.
Stap 3 — Haal uw API key op
Log in op uw Zonos Dashboard en ga naar Account → Integrations. De tabel toont twee keys:
Kopieer het token in de rij API key. Het begint met
credential_live_. U heeft deze key nodig voor beide integratiemethoden.Houd uw API key veilig. Commit deze niet naar source control en deel deze niet publiek. Als u denkt dat deze is gecompromitteerd, genereer deze opnieuw via dezelfde pagina Account → Integrations.
Stap 4 (optioneel) — Schat invoerrechtkosten met Item Quoter
De Item Quoter-tool in uw Zonos Dashboard laat u geschatte invoerrechtkosten voor uw producten opzoeken vóór verzending — handig om tarieven te controleren en vooruit te plannen zonder een Declaration ID te genereren.
Integratiemethoden
Kies de methode die past bij uw technische configuratie. Beide methoden produceren Declaration ID's die u vervolgens uploadt naar het verzendsysteem van Česká pošta.
Voor technische klanten en ontwikkelaars die Zonos rechtstreeks aanroepen vanuit hun eigen systeem.
Endpoint
https://api.zonos.com/graphqlapplication/jsonAuthenticatie
Stuur uw API key mee in de header
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxAPI-voorbeeld
Log in op uw Česká pošta-account voor het volledige API-voorbeeld, inclusief het volledige request en response.
Na het genereren van Declaration ID's
Dien de Declaration ID in bij Česká pošta samen met uw zendingdetails. Česká pošta koppelt de Declaration ID aan de zending en retourneert een trackingnummer. Zonos geeft geen trackingnummers uit.
Foutafhandeling
credentialTokenis.credentialTokenis opgenomen.errorsarray in responsemessagein de errors array voor details.data.declarationCreate.id. Log het volledige response body en controleer of de mutationtekst exact overeenkomt met het voorbeeld.Was deze pagina nuttig?