Sådan fungerer Zonos + Japan Post API-modellen
Japan Post Verified Account-forhandlere kalder Zonos direkte. Zonos bruger sine egne credentials hos Japan Post og inkluderer dit Later Pay Number på hver etiket, så porto faktureres din konto.
I en enkelt GraphQL-request:
- Validerer Zonos din Verified Account og Later Pay Numbers.
- Kalder Japan Post Label API (code 52) på dine vegne for at generere etiketten og trackingnummeret.
- Opretter et Declaration ID til forudbetaling af amerikansk told.
- Knytter Declaration ID til trackingnummeret via
declarationShipmentCreate. - Returnerer etiketten, trackingnummeret og forsendelsesposten tilbage til dig.
Du behøver ikke dine egne Japan Post API-credentials (CTID / CT password). Du skal have dine Japan Post Later Pay Numbers (後納お客様番号) tilknyttet din Zonos Verified Account.
Hvilken opsætning har du?
Alle kalder Zonos for at oprette både etiketten og manifestet, så du leverer aldrig dine egne Japan Post-credentials (CTID / CT password). Det, der ændrer sig efter opsætning, er hvilke Zonos API-headers du sender — find din række nedenfor, og brug derefter det matchende faneblad i hvert flows afsnit Endpoint and authentication.
| ↕ | E-handelsforhandler↕ | Forsendelsesplatform (BYOA)↕ | 3PL / logistikpartner / forhandler↕ |
|---|---|---|---|
| Hvem du er | Et brand, der sender egne ordrer | En platform, mange forhandlere opretter etiketter gennem | En partner, der sender på vegne af mange klienter |
| Verified Account du opsætter | Én Verified Account (din egen) | Hver forhandler opsætter sin egen; du sender på deres vegne | Én Verified Account brugt til alle dine afsendere |
| Zonos API-headers du sender | Kun credentialToken (din) | credentialToken (din) + accountKey (hver forhandlers) | Kun credentialToken (din) |
| Hvis Later Pay Number porto faktureres | Dit | Hver forhandlers | Dit |
| Hvem Zonos fakturerer for told | Dig | Hver forhandler | Dig |
BYOA (Bring Your Own Account): hver forhandler har sin egen Japan Post Verified Account, og platformen opretter etiketter på forhandlerens vegne ved at sende forhandlerens account key i stedet for at sende under platformens egen konto.
To API-flows
Der er to integrationsmønstre afhængigt af, hvordan du afsender pakker.
Opret en enkelt forsendelse
Den grundlæggende kæde. Én GraphQL-request tager en forsendelse fra rå input (parter, varer, emballage) hele vejen til en udskrivbar Japan Post-etiket. Brug dette, hvis du sender pakker individuelt, når ordrer kommer ind.
Batch dispatch (consolidation)
Det deferred-payment batch-flow. Åbn en konsolidering om morgenen, tilknyt forsendelser på tværs af dagen ved hjælp af single-shipment-kæden, og luk derefter konsolideringen ved dagens slutning for at få én Japan Post-afsendelsesseddel, der dækker hele batchen. Brug dette, hvis du afregner Japan Post-porto i én transaktion ved dagens slutning i stedet for pakke for pakke.
Bruger du allerede Japan Post My Page API?
Hvis du i øjeblikket opretter etiketter med Japan Post My Page API (ctCode=52), kan du beholde den integration og tilføje Zonos til etiketter til USA med forudbetalt told. Se Using Zonos with the My Page API for en felt-for-felt mapping og en verifikationscheckliste.
Opret etiketter via API
Integrer dit fulfillment-system med Zonos GraphQL API for at oprette Japan Post-etiketter med forudbetalt told.
Dette afsnit er til ingeniørteams, der bygger et programmatisk Japan Post-etiketflow, der vil bruge Verified Accounts. Hvis du er en lille eller mellemstor afsender uden udviklingsressourcer, se Opret etiketter i Dashboard i stedet.