Hoe het Zonos + Japan Post API-model werkt
Japan Post Verified Account-handelaren roepen Zonos rechtstreeks aan. Zonos gebruikt eigen credentials bij Japan Post en neemt uw Later Pay Number op op elk label zodat portokosten aan uw account worden gefactureerd.
In één GraphQL-verzoek:
- Valideert Zonos uw Verified Account en Later Pay Numbers.
- Roept de Japan Post Label API (code 52) aan om het label en trackingnummer te genereren.
- Maakt een Declaration ID aan voor vooraf betalen van Amerikaanse invoerrechten.
- Koppelt de Declaration ID aan het trackingnummer via
declarationShipmentCreate. - Retourneert het label, trackingnummer en shipment record.
U heeft geen eigen Japan Post API-credentials (CTID / CT-wachtwoord) nodig. U heeft wel uw Japan Post Later Pay Numbers (後納お客様番号) gekoppeld aan uw Zonos Verified Account nodig.
Welke configuratie heeft u?
| ↕ | Ecommerce merchant↕ | Shipping platform (BYOA)↕ | 3PL / Logistic Partner / Reseller↕ |
|---|---|---|---|
| Who you are | A brand shipping your own orders | A platform many merchants create labels through | A partner shipping on behalf of many merchant clients |
| Verified Account you set up | One Verified Account (your own) | Each merchant sets up their own; you ship on their behalf | One Verified Account used for all your shippers |
| Zonos API headers to pass | credentialToken (yours) only | credentialToken (yours) + accountKey (each merchant's) | credentialToken (yours) only |
| Whose Later Pay Number is billed postage | Yours | Each merchant's | Yours |
| Who Zonos invoices for duties | You | Each merchant | You |
BYOA (Bring Your Own Account): elke handelaar heeft een eigen Japan Post Verified Account; het platform maakt labels aan namens die handelaar met de account key van de handelaar.
Labels aanmaken via API
Integreer uw fulfillment-systeem met de Zonos GraphQL API om Japan Post-labels met vooraf betaalde invoerrechten aan te maken.Deze sectie is voor engineeringteams die een programmatische Japan Post-labelworkflow bouwen met Verified Accounts. Zonder ontwikkelingsresources, zie Labels aanmaken in Dashboard.