Fonctionnement du modèle API Zonos + Japan Post
Les marchands avec un compte vérifié Japan Post appellent Zonos directement. Zonos utilise ses propres identifiants auprès de Japan Post et inclut votre Later Pay Number sur chaque étiquette afin que l'affranchissement soit facturé sur votre compte.
En une seule requête GraphQL, Zonos :
- Valide votre compte vérifié et vos Later Pay Numbers.
- Appelle l'API Label Japan Post (code 52) en votre nom pour générer l'étiquette et le numéro de suivi.
- Crée un Declaration ID pour le prépaiement des droits américains.
- Associe le Declaration ID au numéro de suivi via
declarationShipmentCreate. - Vous renvoie l'étiquette, le numéro de suivi et l'enregistrement d'envoi.
Vous n'avez pas besoin de vos propres identifiants API Japan Post (CTID / mot de passe CT). En revanche, vous devez connecter vos Later Pay Numbers Japan Post (後納お客様番号) à votre compte vérifié Zonos.
Quelle configuration vous correspond ?
Tout le monde appelle Zonos pour créer à la fois l'étiquette et le manifeste — vous ne fournissez jamais vos propres identifiants Japan Post (CTID / mot de passe CT). Ce qui change selon la configuration, ce sont les en-têtes API Zonos que vous transmettez — trouvez votre ligne ci-dessous, puis utilisez l'onglet correspondant dans la section Endpoint and authentication de chaque flux.
| ↕ | Marchand e-commerce↕ | Plateforme d'expédition (BYOA)↕ | 3PL / partenaire logistique / revendeur↕ |
|---|---|---|---|
| Qui vous êtes | Une marque expédiant ses propres commandes | Une plateforme par laquelle de nombreux marchands créent des étiquettes | Un partenaire expédiant pour de nombreux clients marchands |
| Compte vérifié configuré | Un compte vérifié (le vôtre) | Chaque marchand configure le sien ; vous expédiez en son nom | Un compte vérifié utilisé pour tous vos expéditeurs |
| En-têtes API Zonos à transmettre | credentialToken (le vôtre) uniquement | credentialToken (le vôtre) + accountKey (de chaque marchand) | credentialToken (le vôtre) uniquement |
| Later Pay Number facturé pour l'affranchissement | Le vôtre | Celui de chaque marchand | Le vôtre |
| Qui Zonos facture pour les droits | Vous | Chaque marchand | Vous |
BYOA (Bring Your Own Account) : chaque marchand détient son propre compte vérifié Japan Post, et la plateforme crée des étiquettes au nom de ce marchand en transmettant la clé de compte du marchand, plutôt que d'expédier sous le compte propre de la plateforme.
Deux flux API
Deux modèles d'intégration selon la façon dont vous expédiez les colis.
Créer un envoi unique
La chaîne fondamentale. Une requête GraphQL fait passer un envoi des données brutes (parties, articles, emballage) jusqu'à une étiquette Japan Post imprimable. Utilisez ce flux si vous expédiez les colis individuellement au fil des commandes.
Expédition par lot (consolidation)
Le flux de lot à paiement différé. Ouvrez une consolidation le matin, y associez des envois au cours de la journée via la chaîne d'envoi unique, puis clôturez la consolidation en fin de journée pour obtenir un bordereau d'expédition Japan Post couvrant l'ensemble du lot. Utilisez ce flux si vous réglez l'affranchissement Japan Post en une seule transaction en fin de journée plutôt que colis par colis.
Vous utilisez déjà l'API My Page de Japan Post ?
Si vous créez actuellement des étiquettes avec l'API My Page de Japan Post (ctCode=52), vous pouvez conserver cette intégration et ajouter Zonos pour des étiquettes américaines avec droits prépayés. Consultez Utiliser Zonos avec l'API My Page pour une correspondance champ par champ et une liste de vérification.
Créer des étiquettes via l'API
Intégrez votre système de fulfillment à l'API GraphQL Zonos pour créer des étiquettes Japan Post avec droits prépayés.
Cette section s'adresse aux équipes d'ingénierie qui construisent un flux d'étiquettes Japan Post programmatique utilisant des comptes vérifiés. Si vous êtes un expéditeur de petite ou moyenne taille sans ressources de développement, consultez plutôt Créer des étiquettes dans Dashboard.