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.
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.
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
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.
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.
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.
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
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.
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:
declarationShipmentCreate.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.
credentialToken(ert)credentialToken(ert) +accountKey(varje handlares)credentialToken(ert)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.
Skapa en enskild sändning →
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.
Batch-avsändning (consolidation) →
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.Var den här sidan till hjälp?