Inscrivez-vous à un Verified Account Zonos en utilisant le
lien d'inscription Česká pošta.
Complétez l'adresse professionnelle et la configuration de facturation.
Connectez-vous à votre Zonos Dashboard et accédez à Account →
Integrations. Le tableau affiche deux clés :
Nom dans le Dashboard↕
Objectif↕
À utiliser pour l'API ?↕
Account key
Identifiant pour la liaison avec l'opérateur postal
❌ NON
API key
Clé d'authentification pour appeler l'API Zonos
✅ OUI — utilisez celle-ci
Copiez le token dans la ligne API key. Il commence par credential_live_. Vous aurez besoin de
cette clé pour les deux méthodes d'intégration.
Conservez votre API key en sécurité. Ne la commitez pas dans le contrôle de source et ne la partagez
pas publiquement. Si vous pensez qu'elle a été compromise, régénérez-la depuis la même page Account
→ Integrations.
L'outil Item Quoter de votre Zonos
Dashboard vous permet de consulter les coûts de droits estimés pour vos produits avant l'expédition
— utile pour vérifier les taux et planifier à l'avance sans générer de Declaration ID.
Choisissez la méthode adaptée à votre configuration technique. Les deux méthodes produisent des
Declaration ID que vous importez ensuite dans le système d'expédition de Česká pošta.
Pour les clients techniques et les développeurs qui appellent Zonos directement depuis leur propre
système.
Point de terminaison
URL: https://api.zonos.com/graphql
Method: POST
Content-Type: application/json
Authentification
Passez votre API key dans l'en-tête credentialToken :
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
Exemple API
Connectez-vous à votre compte Česká pošta pour l'exemple API complet, y compris la requête et la
réponse complètes.
Après la génération des Declaration ID
Soumettez le Declaration ID à Česká pošta avec les détails de votre envoi. Česká pošta associe le
Declaration ID à l'envoi et retourne un numéro de suivi. Zonos n'émet pas de numéros de suivi.
Gestion des erreurs
Erreur / Symptôme↕
Cause probable et correction↕
Échec de l'exigence de sécurité
Votre API key est invalide ou passée dans le mauvais en-tête. Utilisez l'API Key (et non l'Account Key) et vérifiez que le nom de l'en-tête est exactement credentialToken.
HTTP 401 Unauthorized
L'API key est absente des en-têtes de la requête. Confirmez que credentialToken est inclus.
Tableau errors dans la réponse
La mutation a renvoyé une erreur GraphQL. Consultez le champ message du tableau errors pour plus de détails.
Forme de réponse inattendue
La réponse n'incluait pas data.declarationCreate.id. Enregistrez le corps complet de la réponse et vérifiez que le texte de la mutation correspond exactement à l'exemple.
Configuration du compte
Configuration du compte
Créez votre Verified Account, ajoutez un moyen de paiement et connectez votre intégration.
Étape 1 — Créer votre Verified Account
Inscrivez-vous à un Verified Account Zonos en utilisant le lien d'inscription Česká pošta. Complétez l'adresse professionnelle et la configuration de facturation.
Étape 2 — Ajouter un moyen de paiement
Ajoutez un moyen de paiement à votre compte Zonos pour financer la remise des droits sur les envois vers les États-Unis.
Étape 3 — Obtenir votre API key
Connectez-vous à votre Zonos Dashboard et accédez à Account → Integrations. Le tableau affiche deux clés :
Copiez le token dans la ligne API key. Il commence par
credential_live_. Vous aurez besoin de cette clé pour les deux méthodes d'intégration.Conservez votre API key en sécurité. Ne la commitez pas dans le contrôle de source et ne la partagez pas publiquement. Si vous pensez qu'elle a été compromise, régénérez-la depuis la même page Account → Integrations.
Étape 4 (optionnelle) — Estimer les coûts de droits avec Item Quoter
L'outil Item Quoter de votre Zonos Dashboard vous permet de consulter les coûts de droits estimés pour vos produits avant l'expédition — utile pour vérifier les taux et planifier à l'avance sans générer de Declaration ID.
Méthodes d'intégration
Choisissez la méthode adaptée à votre configuration technique. Les deux méthodes produisent des Declaration ID que vous importez ensuite dans le système d'expédition de Česká pošta.
Pour les clients techniques et les développeurs qui appellent Zonos directement depuis leur propre système.
Point de terminaison
https://api.zonos.com/graphqlapplication/jsonAuthentification
Passez votre API key dans l'en-tête
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxExemple API
Connectez-vous à votre compte Česká pošta pour l'exemple API complet, y compris la requête et la réponse complètes.
Après la génération des Declaration ID
Soumettez le Declaration ID à Česká pošta avec les détails de votre envoi. Česká pošta associe le Declaration ID à l'envoi et retourne un numéro de suivi. Zonos n'émet pas de numéros de suivi.
Gestion des erreurs
credentialToken.credentialTokenest inclus.errorsdans la réponsemessagedu tableau errors pour plus de détails.data.declarationCreate.id. Enregistrez le corps complet de la réponse et vérifiez que le texte de la mutation correspond exactement à l'exemple.Cette page a-t-elle été utile?