Maakt u al labels met de Japan Post My Page API? Behoud uw integratie — voeg Zonos toe voor labels met vooraf betaalde invoerrechten voor de VS.
Deze gids is voor teams die al integreren met de Japan Post My Page Web API om labels aan te maken (operatie ctCode=52). Voor pakketten naar de VS, waarvoor nu vooraf betaalde invoerrechten vereist zijn, maakt u het label via Zonos. Zonos is een uitbreiding van de My Page-workflow: het roept namens u de My Page Label API (ctCode=52) aan, voegt de Amerikaanse duty Declaration ID en DDP-markering toe, en retourneert het My Page-label en trackingnummer aan u. Japan Post produceert nog steeds het label en factureert uw portokosten via uw Later Pay Number.
Kortom: u blijft bouwen op My Page, en Zonos handelt de Amerikaanse duty-laag af voor zendingen naar de Verenigde Staten.
Voor een pakket naar de VS stuurt u de zending naar de Zonos CreateDeclarationShipment GraphQL-workflow in plaats van My Page rechtstreeks aan te roepen. In dat ene verzoek doet Zonos het volgende:
Roept namens u de Japan Post Label API (ctCode=52) aan, met gebruik van de Later Pay Numbers van uw Verified Account, zodat de portokosten nog steeds op uw Japan Post-account worden gefactureerd.
Maakt de Amerikaanse duty Declaration ID aan en koppelt deze aan het trackingnummer.
Voegt de DDP-markering toe aan het label.
Retourneert het Japan Post-label en trackingnummer aan u.
CreateDeclarationShipment koppelt zeven stappen aaneen. Dezelfde gegevens die u al verzamelt voor een ctCode=52-verzoek worden daarover verdeeld:
Verzender/ontvanger → de partyCreateWorkflowORIGIN- en DESTINATION-parties.
Items → itemCreateWorkflow (de regelitems binnen shipmentCartons).
Verpakking en gewicht → cartonsCreateWorkflow.
Service, behandeling en douanevlaggen → shipmentCreateWorkflow.
Zonos handelt dit voor u af
U stuurt geen Japan Post-credentials of operatiecode (ctCode, ctId, ctPw), verzenddatum (sendDate) of DDP-declaratie-opmerkingen. Zonos stelt deze automatisch in bij aanroep van My Page.
Elke tabel laat zien waar een Japan Post My Page ctCode=52-parameter terechtkomt in de Zonos-workflow. Voor volledige velddetails, typen en welke velden verplicht zijn, zie Eén zending aanmaken.
Dit zijn de transformaties die het vaakst aandacht nodig hebben:
Service level vervangt sendType + transType. Kies het ene Zonos japan_post.*-servicelevel dat overeenkomt met de postdienst en het transport die u vandaag als twee afzonderlijke parameters verstuurt.
Verzekerde waarde (declaredValue) moet in JPY zijn, in hele yen. Andere valuta's of gedeeltelijke yen worden geweigerd.
Gewicht wordt in grammen naar Japan Post verzonden. Geef weight + weightUnit op bij de carton; Zonos zet dit om.
Douanebeschrijvingen van items zijn beperkt tot 85 half-width tekens.
Alle adresvelden moeten in Engelse (Romeinse) tekens zijn.
Wanneer u een VS-label via Zonos aanmaakt, controleert u of dit end-to-end is gelukt:
De workflow retourneert een trackingnummer en label. Controleer shipmentCreateWorkflow.trackingDetails.number en shipmentCartons[].label.url in de respons.
Er is een Declaration ID aangemaakt en gekoppeld. De zending is alleen duty-prepaid wanneer de Declaration ID is gekoppeld aan het trackingnummer — Zonos doet dit binnen hetzelfde verzoek.
DDP staat afgedrukt op het label. Open het geretourneerde label en controleer of de DDP-markering aanwezig is.
De zending verschijnt in uw Zonos Dashboard onder uw Verified Account.
Voor batch dispatch controleert u of de consolidatie wordt afgesloten en de Japan Post-verzendbon (Code 61) retourneert. Zie Batch dispatch (consolidatie).
Vergelijk met een My Page-label. Maak dezelfde zending op beide manieren aan en controleer of het servicelevel, het gewicht, de verzekerde waarde en de itemgegevens overeenkomen op het afgedrukte label.
Test voordat u live gaat
Valideer de volledige flow op een testzending voordat u productievolume naar de VS via Zonos stuurt. Uw My Page-integratie blijft voor al het overige ongewijzigd.
Zonos gebruiken met de My Page API
Zonos gebruiken met de Japan Post My Page API
Maakt u al labels met de Japan Post My Page API? Behoud uw integratie — voeg Zonos toe voor labels met vooraf betaalde invoerrechten voor de VS.
Deze gids is voor teams die al integreren met de Japan Post My Page Web API om labels aan te maken (operatie
ctCode=52). Voor pakketten naar de VS, waarvoor nu vooraf betaalde invoerrechten vereist zijn, maakt u het label via Zonos. Zonos is een uitbreiding van de My Page-workflow: het roept namens u de My Page Label API (ctCode=52) aan, voegt de Amerikaanse duty Declaration ID en DDP-markering toe, en retourneert het My Page-label en trackingnummer aan u. Japan Post produceert nog steeds het label en factureert uw portokosten via uw Later Pay Number.Kortom: u blijft bouwen op My Page, en Zonos handelt de Amerikaanse duty-laag af voor zendingen naar de Verenigde Staten.
Als u voor het eerst integreert, begin dan met Eén zending aanmaken.
Hoe Zonos hierin past
Voor een pakket naar de VS stuurt u de zending naar de Zonos
CreateDeclarationShipmentGraphQL-workflow in plaats van My Page rechtstreeks aan te roepen. In dat ene verzoek doet Zonos het volgende:ctCode=52) aan, met gebruik van de Later Pay Numbers van uw Verified Account, zodat de portokosten nog steeds op uw Japan Post-account worden gefactureerd.CreateDeclarationShipmentkoppelt zeven stappen aaneen. Dezelfde gegevens die u al verzamelt voor eenctCode=52-verzoek worden daarover verdeeld:partyCreateWorkflowORIGIN- enDESTINATION-parties.itemCreateWorkflow(de regelitems binnenshipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.U stuurt geen Japan Post-credentials of operatiecode (
ctCode,ctId,ctPw), verzenddatum (sendDate) of DDP-declaratie-opmerkingen. Zonos stelt deze automatisch in bij aanroep van My Page.Hoe uw My Page-velden naar Zonos mappen
Elke tabel laat zien waar een Japan Post My Page
ctCode=52-parameter terechtkomt in de Zonos-workflow. Voor volledige velddetails, typen en welke velden verplicht zijn, zie Eén zending aanmaken.Service en behandeling →
shipmentCreateWorkflowsendType+transTypeserviceLevel(andshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Moet eenjapan_post.*-servicelevel zijn.pkgTypecontentsTypeSALE_OF_GOODS,ECOMMERCE_GOODS,COMMERCIAL_GOODS,COMMERCIAL_SAMPLE,RETURNED_GOODS,GIFT,DOCUMENTS, ofOTHER.senderInstructionnonDelivery.optionRETURN_AFTER_RETENTION,RETURN_IMMEDIATELY,FORWARD, ofABANDON. Zonos splitst de enkele „return”-instructie van My Page op in twee waarden.fw_TransTypenonDelivery.transportMethodAIRofMOST_ECONOMICAL. Van toepassing op de tweeRETURN_*-opties.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitVerzender →
partyCreateWorkflow(ORIGIN-party)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneOntvanger →
partyCreateWorkflow(DESTINATION-party)De
to_*-parameters van de ontvanger worden op dezelfde manier gekoppeld aan deDESTINATION-party als de velden van de verzender.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSofPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneItems →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(gewicht per eenheid)item_costamountitem_curUnitcurrencyCodeConversies om te kennen
Dit zijn de transformaties die het vaakst aandacht nodig hebben:
sendType+transType. Kies het ene Zonosjapan_post.*-servicelevel dat overeenkomt met de postdienst en het transport die u vandaag als twee afzonderlijke parameters verstuurt.declaredValue) moet in JPY zijn, in hele yen. Andere valuta's of gedeeltelijke yen worden geweigerd.weight+weightUnitop bij de carton; Zonos zet dit om.Verifieer uw VS-labels
Wanneer u een VS-label via Zonos aanmaakt, controleert u of dit end-to-end is gelukt:
shipmentCreateWorkflow.trackingDetails.numberenshipmentCartons[].label.urlin de respons.Valideer de volledige flow op een testzending voordat u productievolume naar de VS via Zonos stuurt. Uw My Page-integratie blijft voor al het overige ongewijzigd.
Gerelateerd
CreateDeclarationShipment-workflow.Was deze pagina nuttig?