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.
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.
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
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.
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.
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.
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 Brug Zonos med My Page API for en felt-for-felt mapping og en verifikationscheckliste.
Opret etiketter via API
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.
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:
declarationShipmentCreate.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.
credentialToken(din)credentialToken(din) +accountKey(hver forhandlers)credentialToken(din)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.
Opret en enkelt forsendelse →
Batch-afsendelse (konsolidering)
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.
Batch-afsendelse (konsolidering) →
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 Brug Zonos med My Page API for en felt-for-felt mapping og en verifikationscheckliste.Var denne side nyttig?