So funktioniert das Zonos + Japan Post API-Modell
Japan Post Verified Account-Händler rufen Zonos direkt auf. Zonos nutzt eigene Zugangsdaten bei Japan Post und fügt Ihre Later Pay Number auf jedem Etikett hinzu, damit die Portogebühr Ihrem Konto belastet wird.
In einer einzigen GraphQL-Anfrage:
- Validiert Zonos Ihren Verified Account und Ihre Later Pay Numbers.
- Ruft die Japan Post Label API (Code 52) in Ihrem Namen auf, um das Etikett und die Sendungsnummer zu generieren.
- Erstellt eine Declaration ID für die vorausbezahlten US-Zölle.
- Verknüpft die Declaration ID mit der Sendungsnummer über
declarationShipmentCreate. - Gibt Etikett, Sendungsnummer und Sendungsdatensatz an Sie zurück.
Sie benötigen keine eigenen Japan Post API-Zugangsdaten (CTID / CT-Passwort). Sie benötigen jedoch Ihre Japan Post Later Pay Numbers (後納お客様番号), die mit Ihrem Zonos Verified Account verbunden sind.
Welches Setup haben Sie?
Alle rufen Zonos auf, um sowohl das Etikett als auch das Manifest zu erstellen — Sie stellen also keine eigenen Japan Post-Zugangsdaten (CTID / CT-Passwort) bereit. Was sich je nach Setup ändert, sind die Zonos API-Header, die Sie übergeben — finden Sie Ihre Zeile unten und nutzen Sie dann den passenden Tab im Abschnitt Endpoint and authentication jedes Flows.
| ↕ | E-Commerce-Händler↕ | Versandplattform (BYOA)↕ | 3PL / Logistikpartner / Reseller↕ |
|---|---|---|---|
| Wer Sie sind | Eine Marke, die eigene Bestellungen versendet | Eine Plattform, über die viele Händler Etiketten erstellen | Ein Partner, der im Namen vieler Händlerkunden versendet |
| Verified Account, den Sie einrichten | Ein Verified Account (eigener) | Jeder Händler richtet seinen eigenen ein; Sie versenden in seinem Namen | Ein Verified Account für alle Ihre Versender |
| Zonos API-Header | Nur credentialToken (eigener) | credentialToken (eigener) + accountKey (je Händler) | Nur credentialToken (eigener) |
| Wessen Later Pay Number für Portogebühren | Ihre | Die jeweilige des Händlers | Ihre |
| Wer Zonos für Zölle in Rechnung stellt | Sie | Jeder Händler | Sie |
BYOA (Bring Your Own Account): Jeder Händler hat seinen eigenen Japan Post Verified Account, und die Plattform erstellt Etiketten in seinem Namen, indem sie den Account Key des Händlers übergibt — statt unter dem eigenen Konto der Plattform zu versenden.
Zwei API-Flows
Es gibt zwei Integrationsmuster, je nachdem, wie Sie Pakete aufgeben.
Einzelne Sendung erstellen
Die grundlegende Kette. Eine GraphQL-Anfrage führt eine Sendung von den Rohdaten (Parteien, Artikel, Verpackung) bis zum druckbaren Japan Post-Etikett. Nutzen Sie dies, wenn Sie Pakete einzeln versenden, sobald Bestellungen eingehen.
Batch-Versand (Konsolidierung)
Der Nachzahlungs-Batch-Flow. Öffnen Sie morgens eine Konsolidierung, fügen Sie im Laufe des Tages Sendungen mit der Einzel-Sendungs-Kette hinzu und schließen Sie die Konsolidierung am Tagesende, um einen Japan Post-Versandschein für den gesamten Batch zu erhalten. Nutzen Sie dies, wenn Sie Japan Post-Portogebühren in einer Transaktion am Tagesende abrechnen, statt paketweise.
Nutzen Sie bereits die Japan Post My Page API?
Wenn Sie derzeit Etiketten mit der Japan Post My Page API (ctCode=52) erstellen, können Sie diese Integration beibehalten und Zonos für US-Etiketten mit vorausbezahlten Zöllen hinzufügen. Siehe Zonos mit der My Page API nutzen für eine Feld-für-Feld-Zuordnung und eine Prüfliste.
Etiketten per API erstellen
Integrieren Sie Ihr Fulfillment-System mit der Zonos GraphQL API, um Japan Post-Etiketten mit vorausbezahlten Zöllen zu erstellen.
Dieser Abschnitt richtet sich an Entwicklungsteams, die einen programmatischen Japan Post-Etiketten-Workflow mit Verified Accounts aufbauen. Wenn Sie ein kleines oder mittelständisches Versandunternehmen ohne Entwicklungsressourcen sind, siehe stattdessen Etiketten im Dashboard erstellen.