Bruke Zonos med Japan Post My Page API

Denne guiden er for team som allerede integrerer med Japan Post My Page Web API for å opprette etiketter (operasjon ctCode=52). For pakker som går til USA, som nå krever forhåndsoppgjøring av tollgebyrer, oppretter du etiketten gjennom Zonos. Zonos er en utvidelse av My Page-arbeidsflyten: den kaller My Page Label API (ctCode=52) på dine vegne, legger til USA-erklæring-ID-en og DDP-merking, og returnerer My Page-etiketten og sporingsnummeret til deg. Japan Post produserer fortsatt etiketten og fakturerer porto gjennom ditt Later Pay-nummer.

I korthet: du fortsetter å bygge på My Page, og Zonos håndterer USA-tolllaget for forsendelser bestemt for USA.

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

Hvordan Zonos passer inn 

For en pakke som går til USA, sender du forsendelsen til Zonos CreateDeclarationShipment GraphQL-arbeidsflyten i stedet for å kalle My Page direkte. I den samme forespørselen gjør Zonos følgende:

1. Kaller Japan Post Label API (ctCode=52) på dine vegne, ved å bruke ditt Verified Accounts Later Pay-numre slik at porto fortsatt faktureres til din Japan Post-konto.
2. Oppretter USA-tull-erklæring-ID-en og knytter den til sporingsnummeret.
3. Legger til DDP-merking på etiketten.
4. Returnerer Japan Post-etiketten og sporingsnummeret til deg.

CreateDeclarationShipment kjeder syv trinn. De samme dataene du allerede samler for en ctCode=52-forespørsel distribueres på tvers av dem:

• Avsender/mottaker → partyCreateWorkflow ORIGIN og DESTINATION parter.
• Varer → itemCreateWorkflow (linjeelementene inne i shipmentCartons).
• Emballasje og vekt → cartonsCreateWorkflow.
• Service, håndtering og tollmerker → shipmentCreateWorkflow.

Hvordan My Page-feltene dine kartlegges til Zonos 

Hver tabell viser hvor en Japan Post My Page ctCode=52-parameter går i Zonos-arbeidsflyten. For fullstendige feltdetaljer, typer og hvilke felt som er påkrevd, se Opprett en enkelt forsendelse.

Service og håndtering → shipmentCreateWorkflow

Avsender → partyCreateWorkflow (ORIGIN-part)

Mottaker → partyCreateWorkflow (DESTINATION-part)

Mottaker to_*-parametere kartlegges til DESTINATION-parten på samme måte som avsenderen gjør.

Varer → itemCreateWorkflow

Konverteringer å vite om 

Dette er transformasjonene som oftest trenger oppmerksomhet:

• Servicenivå erstatter sendType + transType. Velg det ene Zonos japan_post.*-servicenivået som samsvarer med posttjenesten og transporten du i dag sender som to separate parametere.
• Forsikret verdi (declaredValue) må være JPY, hele yen. Andre valutaer eller brøkdeler yen vil bli avvist.
• Vekten sendes til Japan Post i gram. Oppgi weight + weightUnit på kassen; Zonos konverterer.
• Tolldeskrivelser for varer er begrenset til 85 tegn med halv bredde.
• Alle adressefelter må være på engelsk (romersk) tegn.

Bekreft USA-etikettene dine 

Når du oppretter en USA-etikett gjennom Zonos, bekreft at det fungerte end-to-end:

1. Arbeidsflyten returnerer et sporingsnummer og etikett. Sjekk shipmentCreateWorkflow.trackingDetails.number og shipmentCartons[].label.url i responsen.
2. En erklæring-ID ble opprettet og knyttet. Forsendelsen er kun fortollingsfritt når erklæring-ID-en er knyttet til sporingsnummeret — Zonos gjør dette i samme forespørsel.
3. DDP er skrevet ut på etiketten. Åpne den returnerte etiketten og bekreft at DDP-merking er til stede.
4. Forsendelsen vises i Zonos Dashboard under din Verified Account.
5. For satsvis utsendelse, bekreft at konsolideringen lukkes og returnerer Japan Post-utsendelsesslippen (kode 61). Se Satsvis utsendelse (konsolidering).
6. Sammenlign med en My Page-etikett. Opprett samme forsendelse begge veier og bekreft at servicenivået, vekten, erklært verdi og varedetaljer samsvarer på den utskrevne etiketten.

Relatert 

• Opprett en enkelt forsendelse — fullstendig feltreferanse for CreateDeclarationShipment-arbeidsflyten.
• Satsvis utsendelse (konsolidering) — pakk dagens pakker inn i en Japan Post-utsendelsesslipp.