Integrieren Sie Ihr Fulfillment-System in die 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 kleiner oder mittelgroßer Versender ohne Entwicklungsressourcen sind, lesen Sie stattdessen Etiketten im Dashboard erstellen.
Händler mit einem Japan Post Verified Account rufen Zonos direkt auf. Zonos verwendet eigene Zugangsdaten bei Japan Post und gibt auf jedem Etikett Ihre Later Pay Number an, damit das Porto Ihrem Konto belastet wird.
In einer einzigen GraphQL-Anfrage führt Zonos folgende Schritte aus:
Ihren Verified Account und Ihre Later Pay Numbers validieren.
Die Japan Post Label API (Code 52) in Ihrem Namen aufrufen, um das Etikett und die Sendungsnummer zu generieren.
Eine Declaration ID für die Vorauszahlung der Zölle erstellen.
Die Declaration ID über declarationShipmentCreate mit der Sendungsnummer verknüpfen.
Etikett, Sendungsnummer und Sendungsdatensatz an Sie zurückgeben.
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.
Alle rufen Zonos auf, um sowohl das Etikett als auch das Manifest zu erstellen. Sie stellen also nie eigene Japan Post-Zugangsdaten (CTID / CT-Passwort) bereit. Je nach Setup unterscheiden sich nur die Zonos API-Header, die Sie übergeben: Suchen Sie unten Ihre Spalte und verwenden Sie dann den passenden Tab im Abschnitt Endpoint und Authentifizierung des jeweiligen 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 (Ihr eigener)
Jeder Händler richtet seinen eigenen ein; Sie versenden in seinem Namen
Wessen Later Pay Number mit dem Porto belastet wird
Ihre
Die des jeweiligen Händlers
Ihre
Wem Zonos die Zölle in Rechnung stellt
Ihnen
Jedem Händler
Ihnen
BYOA (Bring Your Own Account): Jeder Händler hat seinen eigenen Japan Post Verified Account, und die Plattform erstellt Etiketten in dessen Namen, indem sie den Account Key des Händlers übergibt, anstatt über das eigene Konto der Plattform zu versenden.
Je nachdem, wie Sie Pakete aufgeben, gibt es zwei Integrationsmuster.
Einzelne Sendung erstellen
Die grundlegende Kette. Eine einzige GraphQL-Anfrage führt eine Sendung von den Rohdaten (Parteien, Artikel, Verpackung) bis zum druckfertigen Japan Post-Etikett. Verwenden Sie diesen Flow, wenn Sie Pakete einzeln versenden, sobald Bestellungen eingehen.
Der Batch-Flow mit nachträglicher Zahlung. Eröffnen Sie morgens eine Konsolidierung, fügen Sie ihr im Laufe des Tages Sendungen über die Einzelsendungs-Kette hinzu und schließen Sie die Konsolidierung am Tagesende, um einen einzigen Japan Post-Einlieferungsschein für den gesamten Batch zu erhalten. Verwenden Sie diesen Flow, wenn Sie das Japan Post-Porto am Tagesende in einer einzigen Transaktion statt pro Paket abrechnen.
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 ergänzen. Unter Zonos mit der My Page API nutzen finden Sie eine Feld-für-Feld-Zuordnung und eine Checkliste zur Überprüfung.
Etiketten per API erstellen
Etiketten per API erstellen
Integrieren Sie Ihr Fulfillment-System in die 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 kleiner oder mittelgroßer Versender ohne Entwicklungsressourcen sind, lesen Sie stattdessen Etiketten im Dashboard erstellen.
So funktioniert das API-Modell von Zonos + Japan Post
Händler mit einem Japan Post Verified Account rufen Zonos direkt auf. Zonos verwendet eigene Zugangsdaten bei Japan Post und gibt auf jedem Etikett Ihre Later Pay Number an, damit das Porto Ihrem Konto belastet wird.
In einer einzigen GraphQL-Anfrage führt Zonos folgende Schritte aus:
declarationShipmentCreatemit der Sendungsnummer verknüpfen.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 nutzen Sie?
Alle rufen Zonos auf, um sowohl das Etikett als auch das Manifest zu erstellen. Sie stellen also nie eigene Japan Post-Zugangsdaten (CTID / CT-Passwort) bereit. Je nach Setup unterscheiden sich nur die Zonos API-Header, die Sie übergeben: Suchen Sie unten Ihre Spalte und verwenden Sie dann den passenden Tab im Abschnitt Endpoint und Authentifizierung des jeweiligen Flows.
credentialToken(Ihrer)credentialToken(Ihrer) +accountKey(des jeweiligen Händlers)credentialToken(Ihrer)BYOA (Bring Your Own Account): Jeder Händler hat seinen eigenen Japan Post Verified Account, und die Plattform erstellt Etiketten in dessen Namen, indem sie den Account Key des Händlers übergibt, anstatt über das eigene Konto der Plattform zu versenden.
Zwei API-Flows
Je nachdem, wie Sie Pakete aufgeben, gibt es zwei Integrationsmuster.
Einzelne Sendung erstellen
Die grundlegende Kette. Eine einzige GraphQL-Anfrage führt eine Sendung von den Rohdaten (Parteien, Artikel, Verpackung) bis zum druckfertigen Japan Post-Etikett. Verwenden Sie diesen Flow, wenn Sie Pakete einzeln versenden, sobald Bestellungen eingehen.
Einzelne Sendung erstellen →
Batch-Versand (Konsolidierung)
Der Batch-Flow mit nachträglicher Zahlung. Eröffnen Sie morgens eine Konsolidierung, fügen Sie ihr im Laufe des Tages Sendungen über die Einzelsendungs-Kette hinzu und schließen Sie die Konsolidierung am Tagesende, um einen einzigen Japan Post-Einlieferungsschein für den gesamten Batch zu erhalten. Verwenden Sie diesen Flow, wenn Sie das Japan Post-Porto am Tagesende in einer einzigen Transaktion statt pro Paket abrechnen.
Batch-Versand (Konsolidierung) →
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 ergänzen. Unter Zonos mit der My Page API nutzen finden Sie eine Feld-für-Feld-Zuordnung und eine Checkliste zur Überprüfung.War diese Seite hilfreich?