Så fungerar Zonos + Japan Post API-modellen
Handlare med verifierat Japan Post-konto anropar Zonos direkt. Zonos använder sina egna uppgifter hos Japan Post och inkluderar ert Later Pay Number på varje etikett så att porto faktureras till ert konto.
I en enda GraphQL-begäran:
- Validerar Zonos ert verifierade konto och Later Pay Numbers.
- Anropar Japan Post Label API (kod 52) å era vägnar för att generera etiketten och spårningsnumret.
- Skapar ett Declaration ID för förbetalning av amerikansk tull.
- Kopplar Declaration ID till spårningsnumret via
declarationShipmentCreate. - Returnerar etiketten, spårningsnumret och sändningsposten till er.
Ni behöver inte egna Japan Post API-uppgifter (CTID / CT-lösenord). Ni behöver era Japan Post Later Pay Numbers (後納お客様番号) kopplade till ert verifierade Zonos-konto.
Vilken uppsättning har ni?
Alla anropar Zonos för att skapa både etiketten och manifestet, så ni lämnar aldrig egna Japan Post-uppgifter (CTID / CT-lösenord). Det som ändras per uppsättning är vilka Zonos API-headers ni skickar — hitta er rad nedan och använd sedan matchande flik i varje flödes avsnitt Endpoint and authentication.
| ↕ | E-handelshandlare↕ | Fraktplattform (BYOA)↕ | 3PL / logistikpartner / återförsäljare↕ |
|---|---|---|---|
| Vem ni är | Ett varumärke som skickar egna ordrar | En plattform där många handlare skapar etiketter | En partner som skickar åt många handlarkunder |
| Verifierat konto ni konfigurerar | Ett verifierat konto (ert eget) | Varje handlare konfigurerar sitt eget; ni skickar å deras vägnar | Ett verifierat konto som används för alla era avsändare |
| Zonos API-headers att skicka | Endast credentialToken (ert) | credentialToken (ert) + accountKey (varje handlares) | Endast credentialToken (ert) |
| Vems Later Pay Number debiteras porto | Ert | Varje handlares | Ert |
| Vem Zonos fakturerar för tull | Er | Varje handlare | Er |
BYOA (Bring Your Own Account): varje handlare har sitt eget verifierade Japan Post-konto, och plattformen skapar etiketter å den handlarens vägnar genom att skicka handlarens account key, i stället för att skicka under plattformens eget konto.
Två API-flöden
Det finns två integrationsmönster beroende på hur ni avsänder paket.
Skapa en enskild sändning
Den grundläggande kedjan. En GraphQL-begäran tar en sändning från råa indata (parter, artiklar, förpackning) hela vägen till en utskrivbar Japan Post-etikett. Använd detta om ni skickar paket individuellt när ordrar kommer in.
Batch-avsändning (consolidation)
Batchflödet för uppskjuten betalning. Öppna en consolidation på morgonen, koppla sändningar till den under dagen med kedjan för enskild sändning, och stäng sedan consolidation i slutet av dagen för att få en Japan Post-avsändningsblankett som täcker hela batchen. Använd detta om ni reglerar Japan Post-porto i en transaktion i slutet av dagen i stället för paket för paket.
Använder ni redan Japan Post My Page API?
Om ni för närvarande skapar etiketter med Japan Post My Page API (ctCode=52) kan ni behålla den integrationen och lägga till Zonos för etiketter till USA med förbetald tull. Se Använda Zonos med My Page API för en fält-för-fält-mappning och en verifieringschecklista.
Skapa etiketter via API
Integrera ert fulfillment-system med Zonos GraphQL API för att skapa Japan Post-etiketter med förbetald tull.
Det här avsnittet är för teknikteam som bygger ett programmatiskt Japan Post-etikettflöde som använder verifierade konton. Om ni är en liten eller medelstor avsändare utan utvecklingsresurser, se i stället Skapa etiketter i Dashboard.