Slik fungerer Zonos + Japan Post API-modellen
Japan Post Verified Account-kjøpmenn ringer 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.
- Ringer Japan Post Label API (kode 52) på dine vegne for å generere etiketten og sporingsnummeret.
- Opprettet en Declaration ID for USA tollforbindelse.
- 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.
Hvilken oppsett har du?
Alle ringer Zonos for å opprett 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 opprett 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 |
| Zonos API-headere som skal sendes | credentialToken (din) bare | credentialToken (din) + accountKey (hver kjøpmanns) | credentialToken (din) bare |
| Hvis Later Pay Number porto faktureres | Din | Hver kjøpmanns | Din |
| Hvem Zonos fakturerer for toll | Du | Hver kjøpmann | Du |
BYOA (Bring Your Own Account): hver kjøpmann holder sin egen Japan Post Verified Account, og plattformen opprett 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åe innganger (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)
Flytprogrammets 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-forsendelsesbillett 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.
Bruker du allerede Japan Post My Page API?
Hvis du for tiden opprett etiketter med Japan Post My Page API (ctCode=52), kan du beholde den integrasjonen og legge til Zonos for forhåndsbetalte tollavgifter USA-etiketter. Se Bruke Zonos med My Page API for feltmapping og en verifiseringsliste.
Opprett etiketter via API
Integrer oppfyllelsessystemet ditt med Zonos GraphQL API for å opprett forhåndsbetalte Japan Post-etiketter.
Denne delen er for ingeniørteam som bygger en programmatisk Japan Post-arbeidsflyt for etikett som vil bruke Verified Accounts. Hvis du er en liten eller mellomstore forsendelsesoperatør uten utviklingsressurser, se Opprett etiketter i Dashboard i stedet.