Vous créez déjà des étiquettes avec l'API Japan Post My Page ? Conservez votre intégration — ajoutez Zonos pour des étiquettes américaines à droits prépayés.
Ce guide s'adresse aux équipes qui intègrent déjà l'API Web Japan Post My Page pour créer des étiquettes (opération ctCode=52). Pour les colis à destination des États-Unis, qui exigent désormais le prépaiement des droits, vous créez l'étiquette via Zonos. Zonos prolonge le flux My Page : il appelle l'API d'étiquette My Page (ctCode=52) en votre nom, ajoute l'ID de déclaration de droits américains et le marquage DDP, puis vous renvoie l'étiquette My Page et le numéro de suivi. Japan Post continue de produire l'étiquette et de facturer votre affranchissement via votre numéro Later Pay.
En résumé : vous continuez de développer sur My Page, et Zonos prend en charge la couche de droits américains pour les envois à destination des États-Unis.
Pour un colis à destination des États-Unis, vous envoyez l'expédition au workflow GraphQL Zonos CreateDeclarationShipment au lieu d'appeler My Page directement. Dans cette requête unique, Zonos :
Appelle l'API d'étiquette Japan Post (ctCode=52) en votre nom, en utilisant les numéros Later Pay de votre compte vérifié afin que l'affranchissement reste facturé à votre compte Japan Post.
Crée l'ID de déclaration de droits américains et l'associe au numéro de suivi.
Ajoute le marquage DDP à l'étiquette.
Vous renvoie l'étiquette Japan Post et le numéro de suivi.
CreateDeclarationShipment enchaîne sept étapes. Les données que vous assemblez déjà pour une requête ctCode=52 sont réparties entre elles :
Expéditeur / destinataire → les parties ORIGIN et DESTINATION de partyCreateWorkflow.
Articles → itemCreateWorkflow (les lignes d'articles à l'intérieur de shipmentCartons).
Emballage et poids → cartonsCreateWorkflow.
Service, manutention et indicateurs de douane → shipmentCreateWorkflow.
Zonos s'en occupe pour vous
Vous n'envoyez pas les identifiants Japan Post ni le code d'opération (ctCode, ctId, ctPw), la date d'expédition (sendDate), ni les remarques de déclaration DDP. Zonos les définit automatiquement lorsqu'il appelle My Page.
Chaque tableau indique où va un paramètre ctCode=52 de Japan Post My Page dans le workflow Zonos. Pour le détail complet des champs, leurs types et ceux qui sont obligatoires, consultez Créer un envoi unique.
Un seul niveau de service Zonos encode à la fois le service postal et le mode de transport — p. ex. japan_post.air.parcel. Doit être un niveau de service japan_post.*.
pkgType
contentsType
SALE_OF_GOODS, GIFT, DOCUMENTS, SAMPLE, etc.
senderInstruction
nonDelivery.option
RETURN, ABANDON ou FORWARD.
fw_TransType
nonDelivery.transportMethod
AIR ou MOST_ECONOMICAL.
noCm
isNonCommercial
true / false.
damges
declaredValue
Valeur assurée. Doit être en JPY, en yens entiers.
Voici les transformations qui nécessitent le plus souvent une attention particulière :
Le niveau de service remplace sendType + transType. Choisissez le niveau de service Zonos japan_post.* unique qui correspond au service postal et au transport que vous envoyez aujourd'hui sous forme de deux paramètres distincts.
La valeur assurée (declaredValue) doit être en JPY, en yens entiers. Toute autre devise ou tout yen fractionnaire sera rejeté.
Le poids est envoyé à Japan Post en grammes. Fournissez weight + weightUnit sur le carton ; Zonos effectue la conversion.
Les descriptions douanières des articles sont limitées à 85 caractères demi-chasse.
Tous les champs d'adresse doivent être en caractères anglais (romains).
Lorsque vous créez une étiquette américaine via Zonos, confirmez que tout a fonctionné de bout en bout :
Le workflow renvoie un numéro de suivi et une étiquette. Vérifiez shipmentCreateWorkflow.trackingDetails.number et shipmentCartons[].label.url dans la réponse.
Un ID de déclaration a été créé et associé. L'envoi est à droits prépayés uniquement lorsque l'ID de déclaration est associé au numéro de suivi — Zonos le fait dans la même requête.
DDP est imprimé sur l'étiquette. Ouvrez l'étiquette renvoyée et confirmez la présence du marquage DDP.
L'envoi apparaît dans votre tableau de bord Zonos (Dashboard) sous votre compte vérifié.
Pour l'expédition groupée, confirmez que la consolidation se clôture et renvoie le bordereau d'expédition Japan Post (code 61). Consultez Expédition groupée (consolidation).
Comparez avec une étiquette My Page. Créez le même envoi des deux façons et vérifiez que le niveau de service, le poids, la valeur déclarée et les détails des articles correspondent sur l'étiquette imprimée.
Testez avant la mise en production
Validez le flux complet sur un envoi de test avant d'envoyer un volume de production américain via Zonos. Votre intégration My Page reste en place pour tout le reste.
Utiliser Zonos avec l'API My Page
Utiliser Zonos avec l'API Japan Post My Page
Vous créez déjà des étiquettes avec l'API Japan Post My Page ? Conservez votre intégration — ajoutez Zonos pour des étiquettes américaines à droits prépayés.
Ce guide s'adresse aux équipes qui intègrent déjà l'API Web Japan Post My Page pour créer des étiquettes (opération
ctCode=52). Pour les colis à destination des États-Unis, qui exigent désormais le prépaiement des droits, vous créez l'étiquette via Zonos. Zonos prolonge le flux My Page : il appelle l'API d'étiquette My Page (ctCode=52) en votre nom, ajoute l'ID de déclaration de droits américains et le marquage DDP, puis vous renvoie l'étiquette My Page et le numéro de suivi. Japan Post continue de produire l'étiquette et de facturer votre affranchissement via votre numéro Later Pay.En résumé : vous continuez de développer sur My Page, et Zonos prend en charge la couche de droits américains pour les envois à destination des États-Unis.
Si vous intégrez pour la première fois, commencez par Créer un envoi unique.
Où Zonos intervient
Pour un colis à destination des États-Unis, vous envoyez l'expédition au workflow GraphQL Zonos
CreateDeclarationShipmentau lieu d'appeler My Page directement. Dans cette requête unique, Zonos :ctCode=52) en votre nom, en utilisant les numéros Later Pay de votre compte vérifié afin que l'affranchissement reste facturé à votre compte Japan Post.CreateDeclarationShipmentenchaîne sept étapes. Les données que vous assemblez déjà pour une requêtectCode=52sont réparties entre elles :ORIGINetDESTINATIONdepartyCreateWorkflow.itemCreateWorkflow(les lignes d'articles à l'intérieur deshipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.Vous n'envoyez pas les identifiants Japan Post ni le code d'opération (
ctCode,ctId,ctPw), la date d'expédition (sendDate), ni les remarques de déclaration DDP. Zonos les définit automatiquement lorsqu'il appelle My Page.Comment vos champs My Page correspondent à Zonos
Chaque tableau indique où va un paramètre
ctCode=52de Japan Post My Page dans le workflow Zonos. Pour le détail complet des champs, leurs types et ceux qui sont obligatoires, consultez Créer un envoi unique.Service et manutention →
shipmentCreateWorkflowsendType+transTypeserviceLevel(andshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Doit être un niveau de servicejapan_post.*.pkgTypecontentsTypeSALE_OF_GOODS,GIFT,DOCUMENTS,SAMPLE, etc.senderInstructionnonDelivery.optionRETURN,ABANDONouFORWARD.fw_TransTypenonDelivery.transportMethodAIRouMOST_ECONOMICAL.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitExpéditeur →
partyCreateWorkflow(partieORIGIN)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneDestinataire →
partyCreateWorkflow(partieDESTINATION)Les paramètres
to_*du destinataire correspondent à la partieDESTINATIONde la même manière que les champs de l'expéditeur.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSouPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneArticles →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(poids unitaire)item_costamountitem_curUnitcurrencyCodeConversions à connaître
Voici les transformations qui nécessitent le plus souvent une attention particulière :
sendType+transType. Choisissez le niveau de service Zonosjapan_post.*unique qui correspond au service postal et au transport que vous envoyez aujourd'hui sous forme de deux paramètres distincts.declaredValue) doit être en JPY, en yens entiers. Toute autre devise ou tout yen fractionnaire sera rejeté.weight+weightUnitsur le carton ; Zonos effectue la conversion.Vérifiez vos étiquettes américaines
Lorsque vous créez une étiquette américaine via Zonos, confirmez que tout a fonctionné de bout en bout :
shipmentCreateWorkflow.trackingDetails.numberetshipmentCartons[].label.urldans la réponse.Validez le flux complet sur un envoi de test avant d'envoyer un volume de production américain via Zonos. Votre intégration My Page reste en place pour tout le reste.
Voir aussi
CreateDeclarationShipment.Cette page a-t-elle été utile?