Integrer oppfyllelsessystemet ditt med Zonos GraphQL API for å opprette forhåndsbetalte Japan Post-etiketter.
Denne delen er for ingeniørteam som bygger en programmatisk arbeidsflyt for Japan Post-etiketter som vil bruke Verified Accounts. Hvis du er en liten eller mellomstor forsendelsesoperatør uten utviklingsressurser, se Opprett etiketter i Dashboard i stedet.
Japan Post Verified Account-kjøpmenn kaller Zonos direkte. Zonos bruker sine egne legitimasjoner med Japan Post og inkluderer Later Pay Number-en din på hver etikett slik at porto faktureres til kontoen din.
I en enkelt GraphQL-forespørsel gjør Zonos:
Validerer Verified Account-en din og Later Pay Numbers-ene dine.
Kaller Japan Post Label API (kode 52) på dine vegne for å generere etiketten og sporingsnummeret.
Oppretter en Declaration ID for forhåndsbetaling av toll til USA.
Linker Declaration ID-en til sporingsnummeret via declarationShipmentCreate.
Returnerer etiketten, sporingsnummeret og forsendelsesposten tilbake til deg.
Du trenger ikke dine egne Japan Post API-legitimasjoner (CTID / CT-passord). Du trenger Japan Post Later Pay Numbers-ene dine (後納お客様番号) koblet til Zonos Verified Account-en din.
Alle kaller Zonos for å opprette både etiketten og manifestet, så du leverer aldri dine egne Japan Post-legitimasjoner (CTID / CT-passord). Det som endres etter oppsett er hvilke Zonos API-headere du sender — finn raden din nedenfor, og bruk deretter den samsvarende fanen i hver flyts Endpoint and authentication seksjon.
↕
E-handelskjøpmann↕
Forsendelsesplattform (BYOA)↕
3PL / Logistikkpartner / Forhandler↕
Hvem er du
Et merke som sender dine egne ordrer
En plattform mange kjøpmenn oppretter etiketter gjennom
En partner som sender på vegne av mange kjøpmannsklienter
Verified Account du setter opp
En Verified Account (din egen)
Hver kjøpmann setter sin egen opp; du sender på deres vegne
En Verified Account brukt for alle forsendelsesoperatørene dine
BYOA (Bring Your Own Account): hver kjøpmann holder sin egen Japan Post Verified Account, og plattformen oppretter etiketter på den kjøpmannens vegne ved å sende kjøpmannens kontonøkkel, i stedet for å sende under plattformens egen konto.
Det er to integrasjonsmønstre avhengig av hvordan du dispatcher pakker.
Opprett en enkelt forsendelse
Den grunnleggende kjeden. En enkelt GraphQL-forespørsel tar en forsendelse fra rådata (parter, varer, emballasje) helt gjennom til en trykkbar Japan Post-etikett. Bruk dette hvis du sender pakker individuelt når ordrer kommer inn.
Batchflyten med utsatt betaling. Åpne en konsolidering om morgenen, tilknytt forsendelser til den gjennom dagen ved hjelp av kjeden for enkelt forsendelse, og lukk deretter konsolideringen på slutten av dagen for å få en Japan Post-forsendelsesseddel som dekker hele batchen. Bruk dette hvis du gjør Japan Post porto-oppgjør i en transaksjon på slutten av dagen i stedet for forsendelse-for-forsendelse.
Hvis du for tiden oppretter etiketter med Japan Post My Page API (ctCode=52), kan du beholde den integrasjonen og legge til Zonos for forhåndsbetalte USA-etiketter. Se Bruke Zonos med My Page API for feltmapping og en verifiseringsliste.
Opprett etiketter via API
Opprett etiketter via API
Integrer oppfyllelsessystemet ditt med Zonos GraphQL API for å opprette forhåndsbetalte Japan Post-etiketter.
Denne delen er for ingeniørteam som bygger en programmatisk arbeidsflyt for Japan Post-etiketter som vil bruke Verified Accounts. Hvis du er en liten eller mellomstor forsendelsesoperatør uten utviklingsressurser, se Opprett etiketter i Dashboard i stedet.
Slik fungerer Zonos + Japan Post API-modellen
Japan Post Verified Account-kjøpmenn kaller Zonos direkte. Zonos bruker sine egne legitimasjoner med Japan Post og inkluderer Later Pay Number-en din på hver etikett slik at porto faktureres til kontoen din.
I en enkelt GraphQL-forespørsel gjør Zonos:
declarationShipmentCreate.Du trenger ikke dine egne Japan Post API-legitimasjoner (CTID / CT-passord). Du trenger Japan Post Later Pay Numbers-ene dine (後納お客様番号) koblet til Zonos Verified Account-en din.
Hvilken oppsett har du?
Alle kaller Zonos for å opprette både etiketten og manifestet, så du leverer aldri dine egne Japan Post-legitimasjoner (CTID / CT-passord). Det som endres etter oppsett er hvilke Zonos API-headere du sender — finn raden din nedenfor, og bruk deretter den samsvarende fanen i hver flyts Endpoint and authentication seksjon.
credentialToken(din) barecredentialToken(din) +accountKey(hver kjøpmanns)credentialToken(din) bareBYOA (Bring Your Own Account): hver kjøpmann holder sin egen Japan Post Verified Account, og plattformen oppretter etiketter på den kjøpmannens vegne ved å sende kjøpmannens kontonøkkel, i stedet for å sende under plattformens egen konto.
To API-flyter
Det er to integrasjonsmønstre avhengig av hvordan du dispatcher pakker.
Opprett en enkelt forsendelse
Den grunnleggende kjeden. En enkelt GraphQL-forespørsel tar en forsendelse fra rådata (parter, varer, emballasje) helt gjennom til en trykkbar Japan Post-etikett. Bruk dette hvis du sender pakker individuelt når ordrer kommer inn.
Opprett en enkelt forsendelse →
Batchdispatch (konsolidering)
Batchflyten med utsatt betaling. Åpne en konsolidering om morgenen, tilknytt forsendelser til den gjennom dagen ved hjelp av kjeden for enkelt forsendelse, og lukk deretter konsolideringen på slutten av dagen for å få en Japan Post-forsendelsesseddel som dekker hele batchen. Bruk dette hvis du gjør Japan Post porto-oppgjør i en transaksjon på slutten av dagen i stedet for forsendelse-for-forsendelse.
Batchdispatch (konsolidering) →
Bruker du allerede Japan Post My Page API?
Hvis du for tiden oppretter etiketter med Japan Post My Page API (
ctCode=52), kan du beholde den integrasjonen og legge til Zonos for forhåndsbetalte USA-etiketter. Se Bruke Zonos med My Page API for feltmapping og en verifiseringsliste.Var denne siden nyttig?