Brug Zonos med Japan Post My Page API

Denne guide er til teams, der allerede integrerer med Japan Post My Page Web API til at oprette labels (operation ctCode=52). For pakker til USA, som nu kræver forudbetalt told, opretter du labelen gennem Zonos. Zonos er en udvidelse af My Page-workflowet: det kalder My Page Label API (ctCode=52) på dine vegne, tilføjer det amerikanske told Declaration ID og DDP-markering og returnerer My Page-labelen og trackingnummeret til dig. Japan Post producerer stadig labelen og fakturerer porto via dit Later Pay Number.

Kort sagt: du bygger videre på My Page, og Zonos håndterer det amerikanske toldlag for forsendelser med destination USA.

Hvis du integrerer for første gang, start med Opret en enkelt forsendelse.

Sådan passer Zonos ind 

For en pakke til USA sender du forsendelsen til Zonos CreateDeclarationShipment GraphQL-workflow i stedet for at kalde My Page direkte. I den ene anmodning gør Zonos:

1. Kalder Japan Post Label API (ctCode=52) på dine vegne med din Verified Accounts Later Pay Numbers, så porto stadig faktureres til din Japan Post-konto.
2. Opretter det amerikanske told Declaration ID og kæder det til trackingnummeret.
3. Tilføjer DDP-markeringen på labelen.
4. Returnerer Japan Post-labelen og trackingnummeret til dig.

CreateDeclarationShipment kæder syv trin sammen. De samme data, du allerede samler til en ctCode=52-anmodning, fordeles på dem:

• Afsender / modtager → partyCreateWorkflow-parterne ORIGIN og DESTINATION.
• Varer → itemCreateWorkflow (linjeposterne i shipmentCartons).
• Emballage og vægt → cartonsCreateWorkflow.
• Service, håndtering og toldflag → shipmentCreateWorkflow.

Sådan kortlægges dine My Page-felter til Zonos 

Hver tabel viser, hvor en Japan Post My Page ctCode=52-parameter hører til i Zonos-workflowet. For fulde feltdetaljer, typer og hvilke felter der er påkrævede, se Opret en enkelt forsendelse.

Service og håndtering → shipmentCreateWorkflow

Afsender → partyCreateWorkflow (ORIGIN-part)

Modtager → partyCreateWorkflow (DESTINATION-part)

Modtagerens to_*-parametre kortlægges til DESTINATION-parten på samme måde som afsenderfelterne.

Varer → itemCreateWorkflow

Konverteringer du skal kende 

Dette er de transformationer, der oftest kræver opmærksomhed:

• Serviceniveau erstatter sendType + transType. Vælg det enkelte Zonos japan_post.*-serviceniveau, der matcher den postservice og transport, du i dag sender som to separate parametre.
• Forsikringsværdi (declaredValue) skal være JPY, hele yen. Andre valutaer eller brøkdele yen afvises.
• Vægt sendes til Japan Post i gram. Angiv weight + weightUnit på kartonen; Zonos konverterer.
• Toldbeskrivelser for varer er begrænset til 85 halvbredde tegn.
• Alle adressefelter skal være på engelsk (latinske tegn).

Verificér dine USA-labels 

Når du opretter en USA-label gennem Zonos, bekræft at det virkede end-to-end:

1. Workflowet returnerer et trackingnummer og en label. Tjek shipmentCreateWorkflow.trackingDetails.number og shipmentCartons[].label.url i svaret.
2. Et Declaration ID blev oprettet og kædet. Forsendelsen er kun duty-prepaid, når Declaration ID er kædet til trackingnummeret — Zonos gør dette i samme anmodning.
3. DDP er printet på labelen. Åbn den returnerede label og bekræft, at DDP-markeringen er til stede.
4. Forsendelsen vises i dit Zonos Dashboard under din Verified Account.
5. For batch-afsendelse, bekræft at konsolideringen lukker og returnerer Japan Post-afsendelseskvitteringen (kode 61). Se Batch-afsendelse (konsolidering).
6. Sammenlign med en My Page-label. Opret den samme forsendelse begge veje og bekræft, at serviceniveau, vægt, deklareret værdi og varedetaljer matcher på den printede label.

Relateret 

• Opret en enkelt forsendelse — fuld feltreference for CreateDeclarationShipment-workflowet.
• Batch-afsendelse (konsolidering) — pak dagens pakker i én Japan Post-afsendelseskvittering.