Använda Zonos med Japan Post My Page API

Den här guiden är för team som redan integrerar med Japan Post My Page Web API för att skapa etiketter (operation ctCode=52). För paket till USA, som nu kräver förbetald tull, skapar ni etiketten via Zonos. Zonos är en utökning av My Page-flödet: det anropar My Page Label API (ctCode=52) å era vägnar, lägger till amerikanskt tull-Declaration ID och DDP-märkning, och returnerar My Page-etiketten och spårningsnumret till er. Japan Post producerar fortfarande etiketten och fakturerar ert porto via ert Later Pay Number.

Kort sagt: ni fortsätter bygga på My Page, och Zonos hanterar det amerikanska tullagret för sändningar till USA.

Om ni integrerar för första gången, börja med Skapa en enskild sändning.

Hur Zonos passar in 

För ett paket till USA skickar ni sändningen till Zonos GraphQL-flöde CreateDeclarationShipment i stället för att anropa My Page direkt. I den enda begäran:

1. Anropar Zonos Japan Post Label API (ctCode=52) å era vägnar, med Later Pay Numbers från ert verifierade konto så att porto fortfarande faktureras till ert Japan Post-konto.
2. Skapar det amerikanska tull-Declaration ID och kopplar det till spårningsnumret.
3. Lägger till DDP-märkning på etiketten.
4. Returnerar Japan Post-etiketten och spårningsnumret till er.

CreateDeclarationShipment kedjar sju steg. Samma data ni redan samlar för en ctCode=52-begäran fördelas över dem:

• Avsändare / mottagare → partyCreateWorkflow-parterna ORIGIN och DESTINATION.
• Artiklar → itemCreateWorkflow (radartiklarna inuti shipmentCartons).
• Förpackning och vikt → cartonsCreateWorkflow.
• Service, hantering och tullflaggor → shipmentCreateWorkflow.

Så mappar era My Page-fält till Zonos 

Varje tabell visar var en Japan Post My Page ctCode=52-parameter hamnar i Zonos-flödet. För fullständiga fältdetaljer, typer och vilka fält som krävs, se Skapa en enskild sändning.

Service och hantering → shipmentCreateWorkflow

Avsändare → partyCreateWorkflow (ORIGIN-part)

Mottagare → partyCreateWorkflow (DESTINATION-part)

Mottagarens to_*-parametrar mappar till DESTINATION-parten på samma sätt som avsändarfälten.

Artiklar → itemCreateWorkflow

Konverteringar att ha i åtanke 

Dessa är de transformationer som oftast kräver uppmärksamhet:

• Servicenivån ersätter sendType + transType. Välj den enda Zonos-servicenivån japan_post.* som matchar den posttjänst och transport ni idag skickar som två separata parametrar.
• Det försäkrade värdet (declaredValue) måste vara i JPY, hela yen. Andra valutor eller bråkdelar av yen avvisas.
• Vikten skickas till Japan Post i gram. Ange weight + weightUnit på kartongen; Zonos konverterar.
• Tullbeskrivningar för artiklar är begränsade till 85 halvbreddstecken.
• Alla adressfält måste vara i engelska (romerska) tecken.

Verifiera era etiketter till USA 

När ni skapar en etikett till USA via Zonos, bekräfta att det fungerade från ände till ände:

1. Flödet returnerar ett spårningsnummer och en etikett. Kontrollera shipmentCreateWorkflow.trackingDetails.number och shipmentCartons[].label.url i svaret.
2. Ett Declaration ID skapades och kopplades. Sändningen har förbetald tull endast när Declaration ID är kopplat till spårningsnumret; Zonos gör detta inom samma begäran.
3. DDP är utskrivet på etiketten. Öppna den returnerade etiketten och bekräfta att DDP-märkningen finns.
4. Sändningen visas i er Zonos Dashboard under ert verifierade konto.
5. För batch-avsändning, bekräfta att consolidation stängs och returnerar Japan Posts avsändningsblankett (Code 61). Se Batch-avsändning (consolidation).
6. Jämför med en My Page-etikett. Skapa samma sändning på båda sätten och bekräfta att servicenivå, vikt, deklarerat värde och artikeldetaljer matchar på den utskrivna etiketten.

Relaterat 

• Skapa en enskild sändning — fullständig fältreferens för flödet CreateDeclarationShipment.
• Batch-avsändning (consolidation) — gruppera dagens paket i en Japan Post-avsändningsblankett.