Registrieren Sie sich für ein Zonos Verified Account über den
Česká pošta-Registrierungslink.
Vervollständigen Sie Ihre Geschäftsadresse und die Abrechnungseinrichtung.
Melden Sie sich in Ihrem Zonos Dashboard an und navigieren Sie zu Account →
Integrations. Die Tabelle zeigt zwei Schlüssel:
Name im Dashboard↕
Zweck↕
Für die API verwenden?↕
Account key
Kennung für die Verknüpfung mit dem Postbetreiber
❌ NEIN
API key
Authentifizierungsschlüssel für den Aufruf der Zonos API
✅ JA — diesen verwenden
Kopieren Sie das Token in der Zeile API key. Es beginnt mit credential_live_. Sie benötigen diesen
Schlüssel für beide Integrationsmethoden.
Bewahren Sie Ihren API-Schlüssel sicher auf. Committen Sie ihn nicht in die Versionskontrolle und teilen Sie ihn nicht öffentlich. Wenn Sie glauben, dass er kompromittiert wurde, generieren Sie ihn auf derselben Seite Account → Integrations neu.
Das Item Quoter-Tool in Ihrem
Zonos Dashboard ermöglicht es Ihnen, geschätzte Zollkosten für Ihre Produkte vor dem Versand nachzuschlagen — nützlich
zur Überprüfung von Tarifen und zur Planung, ohne eine Declaration ID zu generieren.
Wählen Sie die Methode, die zu Ihrer technischen Einrichtung passt. Beide Methoden erzeugen Declaration IDs, die Sie
anschließend in das Versandsystem von Česká pošta hochladen.
Für technische Kunden und Entwickler, die Zonos direkt aus ihrem eigenen System aufrufen.
Endpunkt
URL: https://api.zonos.com/graphql
Methode: POST
Content-Type: application/json
Authentifizierung
Übergeben Sie Ihren API-Schlüssel im Header credentialToken:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
API-Beispiel
Melden Sie sich in Ihrem Česká pošta-Konto an, um das vollständige API-Beispiel einschließlich der vollständigen Anfrage und
Antwort zu erhalten.
Nach dem Generieren von Declaration IDs
Übermitteln Sie die Declaration ID zusammen mit Ihren Sendungsdetails an Česká pošta. Česká pošta verknüpft
die Declaration ID mit der Sendung und gibt eine Sendungsverfolgungsnummer zurück. Zonos stellt keine Sendungsverfolgungsnummern aus.
Fehlerbehandlung
Fehler / Symptom↕
Wahrscheinliche Ursache und Behebung↕
Security requirement failed
Ihr API-Schlüssel ist ungültig oder im falschen Header übergeben. Stellen Sie sicher, dass Sie den API Key (nicht den Account Key) verwenden und der Headername exakt credentialToken lautet.
HTTP 401 Unauthorized
Der API-Schlüssel fehlt in den Anfrage-Headern. Bestätigen Sie, dass credentialToken enthalten ist.
errors-Array in der Antwort
Die Mutation hat einen GraphQL-Fehler zurückgegeben. Prüfen Sie das Feld message im errors-Array für Details.
Unerwartete Antwortstruktur
Die Antwort enthielt nicht data.declarationCreate.id. Protokollieren Sie den vollständigen Antworttext und überprüfen Sie, ob der Mutationstext exakt mit dem Beispiel übereinstimmt.
Kontoeinrichtung
Kontoeinrichtung
Erstellen Sie Ihr Verified Account, fügen Sie eine Zahlungsmethode hinzu und verbinden Sie Ihre Integration.
Schritt 1 — Verified Account erstellen
Registrieren Sie sich für ein Zonos Verified Account über den Česká pošta-Registrierungslink. Vervollständigen Sie Ihre Geschäftsadresse und die Abrechnungseinrichtung.
Schritt 2 — Zahlungsmethode hinzufügen
Fügen Sie eine Zahlungsmethode zu Ihrem Zonos-Konto hinzu, um die Zollabführung für Sendungen in die USA zu finanzieren.
Schritt 3 — API-Schlüssel abrufen
Melden Sie sich in Ihrem Zonos Dashboard an und navigieren Sie zu Account → Integrations. Die Tabelle zeigt zwei Schlüssel:
Kopieren Sie das Token in der Zeile API key. Es beginnt mit
credential_live_. Sie benötigen diesen Schlüssel für beide Integrationsmethoden.Bewahren Sie Ihren API-Schlüssel sicher auf. Committen Sie ihn nicht in die Versionskontrolle und teilen Sie ihn nicht öffentlich. Wenn Sie glauben, dass er kompromittiert wurde, generieren Sie ihn auf derselben Seite Account → Integrations neu.
Schritt 4 (optional) — Zollkosten mit Item Quoter schätzen
Das Item Quoter-Tool in Ihrem Zonos Dashboard ermöglicht es Ihnen, geschätzte Zollkosten für Ihre Produkte vor dem Versand nachzuschlagen — nützlich zur Überprüfung von Tarifen und zur Planung, ohne eine Declaration ID zu generieren.
Integrationsmethoden
Wählen Sie die Methode, die zu Ihrer technischen Einrichtung passt. Beide Methoden erzeugen Declaration IDs, die Sie anschließend in das Versandsystem von Česká pošta hochladen.
Für technische Kunden und Entwickler, die Zonos direkt aus ihrem eigenen System aufrufen.
Endpunkt
https://api.zonos.com/graphqlapplication/jsonAuthentifizierung
Übergeben Sie Ihren API-Schlüssel im Header
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxAPI-Beispiel
Melden Sie sich in Ihrem Česká pošta-Konto an, um das vollständige API-Beispiel einschließlich der vollständigen Anfrage und Antwort zu erhalten.
Nach dem Generieren von Declaration IDs
Übermitteln Sie die Declaration ID zusammen mit Ihren Sendungsdetails an Česká pošta. Česká pošta verknüpft die Declaration ID mit der Sendung und gibt eine Sendungsverfolgungsnummer zurück. Zonos stellt keine Sendungsverfolgungsnummern aus.
Fehlerbehandlung
credentialTokenlautet.credentialTokenenthalten ist.errors-Array in der Antwortmessageim errors-Array für Details.data.declarationCreate.id. Protokollieren Sie den vollständigen Antworttext und überprüfen Sie, ob der Mutationstext exakt mit dem Beispiel übereinstimmt.War diese Seite hilfreich?