Integreer uw fulfillmentsysteem met de Zonos GraphQL API om Japan Post-labels met vooraf betaalde invoerrechten aan te maken.
Deze sectie is bedoeld voor engineeringteams die een programmatische Japan Post-labelworkflow bouwen waarin Verified Accounts worden gebruikt. Bent u een kleine of middelgrote verzender zonder ontwikkelingsresources, raadpleeg dan in plaats daarvan Labels aanmaken in Dashboard.
Japan Post Verified Account-handelaren roepen Zonos rechtstreeks aan. Zonos gebruikt eigen credentials bij Japan Post en vermeldt uw Later Pay Number op elk label, zodat de portokosten aan uw account worden gefactureerd.
In één GraphQL-verzoek:
Valideert Zonos uw Verified Account en Later Pay Numbers.
Roept Zonos namens u de Japan Post Label API (code 52) aan om het label en trackingnummer te genereren.
Maakt Zonos een Declaration ID aan voor de vooruitbetaling van Amerikaanse invoerrechten.
Koppelt Zonos de Declaration ID via declarationShipmentCreate aan het trackingnummer.
Stuurt Zonos het label, het trackingnummer en het shipment record naar u terug.
U heeft geen eigen Japan Post API-credentials (CTID / CT-wachtwoord) nodig. U heeft wel uw Japan Post Later Pay Numbers (後納お客様番号) nodig, gekoppeld aan uw Zonos Verified Account.
Iedereen roept Zonos aan om zowel het label als het manifest aan te maken, zodat u nooit uw eigen Japan Post-credentials (CTID / CT-wachtwoord) opgeeft. Wat per configuratie verschilt, is welke Zonos API-headers u meegeeft — zoek uw rij hieronder op en gebruik vervolgens het bijbehorende tabblad in de sectie Endpoint and authentication van elke flow.
↕
E-commerce-handelaar↕
Verzendplatform (BYOA)↕
3PL / logistiekpartner / reseller↕
Wie u bent
Een merk dat eigen bestellingen verzendt
Een platform waarmee veel handelaren labels aanmaken
Een partner die namens veel handelaarsklanten verzendt
Verified Account die u instelt
Eén Verified Account (van uzelf)
Elke handelaar stelt zijn eigen account in; u verzendt namens hen
Eén Verified Account die wordt gebruikt voor al uw verzenders
Door te geven Zonos API-headers
alleen credentialToken (de uwe)
credentialToken (de uwe) + accountKey (van elke handelaar)
alleen credentialToken (de uwe)
Van wie het Later Pay Number wordt gefactureerd voor porto
De uwe
Die van elke handelaar
De uwe
Wie Zonos factureert voor invoerrechten
U
Elke handelaar
U
BYOA (Bring Your Own Account): elke handelaar heeft zijn eigen Japan Post Verified Account, en het platform maakt labels aan namens die handelaar door de accountsleutel van de handelaar door te geven, in plaats van te verzenden onder het eigen account van het platform.
Er zijn twee integratiepatronen, afhankelijk van hoe u pakketten verzendt.
Eén zending aanmaken
De basisketen. Met één GraphQL-verzoek doorloopt een zending het volledige traject van ruwe invoer (partijen, artikelen, verpakking) tot een afdrukbaar Japan Post-label. Gebruik dit als u pakketten afzonderlijk verzendt zodra bestellingen binnenkomen.
De flow voor uitgestelde betaling per batch. Open 's ochtends een consolidatie, koppel er gedurende de dag zendingen aan via de keten voor één zending, en sluit de consolidatie aan het einde van de dag af om één Japan Post-verzendbon te krijgen die de hele batch dekt. Gebruik dit als u de porto voor Japan Post in één transactie aan het einde van de dag afrekent in plaats van per pakket.
Als u momenteel labels aanmaakt met de Japan Post My Page API (ctCode=52), kunt u die integratie behouden en Zonos toevoegen voor Amerikaanse labels met vooraf betaalde invoerrechten. Zie Zonos gebruiken met de My Page API voor een veld-voor-veld-mapping en een verificatiechecklist.
Labels aanmaken via API
Labels aanmaken via API
Integreer uw fulfillmentsysteem met de Zonos GraphQL API om Japan Post-labels met vooraf betaalde invoerrechten aan te maken.
Deze sectie is bedoeld voor engineeringteams die een programmatische Japan Post-labelworkflow bouwen waarin Verified Accounts worden gebruikt. Bent u een kleine of middelgrote verzender zonder ontwikkelingsresources, raadpleeg dan in plaats daarvan Labels aanmaken in Dashboard.
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 vermeldt uw Later Pay Number op elk label, zodat de portokosten aan uw account worden gefactureerd.
In één GraphQL-verzoek:
declarationShipmentCreateaan het trackingnummer.U heeft geen eigen Japan Post API-credentials (CTID / CT-wachtwoord) nodig. U heeft wel uw Japan Post Later Pay Numbers (後納お客様番号) nodig, gekoppeld aan uw Zonos Verified Account.
Welke configuratie heeft u?
Iedereen roept Zonos aan om zowel het label als het manifest aan te maken, zodat u nooit uw eigen Japan Post-credentials (CTID / CT-wachtwoord) opgeeft. Wat per configuratie verschilt, is welke Zonos API-headers u meegeeft — zoek uw rij hieronder op en gebruik vervolgens het bijbehorende tabblad in de sectie Endpoint and authentication van elke flow.
credentialToken(de uwe)credentialToken(de uwe) +accountKey(van elke handelaar)credentialToken(de uwe)BYOA (Bring Your Own Account): elke handelaar heeft zijn eigen Japan Post Verified Account, en het platform maakt labels aan namens die handelaar door de accountsleutel van de handelaar door te geven, in plaats van te verzenden onder het eigen account van het platform.
Twee API-flows
Er zijn twee integratiepatronen, afhankelijk van hoe u pakketten verzendt.
Eén zending aanmaken
De basisketen. Met één GraphQL-verzoek doorloopt een zending het volledige traject van ruwe invoer (partijen, artikelen, verpakking) tot een afdrukbaar Japan Post-label. Gebruik dit als u pakketten afzonderlijk verzendt zodra bestellingen binnenkomen.
Eén zending aanmaken →
Batch dispatch (consolidatie)
De flow voor uitgestelde betaling per batch. Open 's ochtends een consolidatie, koppel er gedurende de dag zendingen aan via de keten voor één zending, en sluit de consolidatie aan het einde van de dag af om één Japan Post-verzendbon te krijgen die de hele batch dekt. Gebruik dit als u de porto voor Japan Post in één transactie aan het einde van de dag afrekent in plaats van per pakket.
Batch dispatch (consolidatie) →
Gebruikt u al de Japan Post My Page API?
Als u momenteel labels aanmaakt met de Japan Post My Page API (
ctCode=52), kunt u die integratie behouden en Zonos toevoegen voor Amerikaanse labels met vooraf betaalde invoerrechten. Zie Zonos gebruiken met de My Page API voor een veld-voor-veld-mapping en een verificatiechecklist.Was this page helpful?