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.
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.
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 Point de terminaison et authentification 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 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.
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.
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
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.
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 :
declarationShipmentCreate.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 Point de terminaison et authentification de chaque flux.
credentialToken(le vôtre) uniquementcredentialToken(le vôtre) +accountKey(de chaque marchand)credentialToken(le vôtre) uniquementBYOA (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.
Créer un envoi unique →
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.
Expédition par lot (consolidation) →
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.Cette page a-t-elle été utile?