Erstellen Sie bereits Etiketten mit der Japan Post My Page API? Behalten Sie Ihre Integration — fügen Sie Zonos für US-Etiketten mit vorausbezahlten Zöllen hinzu.
Dieser Leitfaden richtet sich an Teams, die bereits die Japan Post My Page Web API zur Etikettenerstellung integriert haben (Operation ctCode=52). Für US-gebundene Pakete, bei denen Zölle jetzt im Voraus bezahlt werden müssen, erstellen Sie das Etikett über Zonos. Zonos ist eine Erweiterung des My Page-Workflows: Es ruft die My Page Label API (ctCode=52) in Ihrem Namen auf, fügt die US-Zoll Declaration ID und DDP-Kennzeichnung hinzu und gibt Ihnen das My Page Etikett und die Sendungsnummer zurück. Japan Post erstellt weiterhin das Etikett und berechnet Ihre Portokosten über Ihre Later Pay Number.
Kurz gesagt: Sie bauen weiter auf My Page auf, und Zonos übernimmt die US-Zollebene für Sendungen in die Vereinigten Staaten.
Für ein US-gebundenes Paket senden Sie die Sendung an den Zonos CreateDeclarationShipment GraphQL-Workflow, anstatt My Page direkt aufzurufen. In dieser einzelnen Anfrage:
Ruft Zonos die Japan Post Label API (ctCode=52) in Ihrem Namen auf und nutzt die Later Pay Numbers Ihres Verified Account, sodass Portokosten weiterhin Ihrem Japan Post Konto berechnet werden.
Erstellt die US-Zoll Declaration ID und verknüpft sie mit der Sendungsnummer.
Fügt die DDP-Kennzeichnung zum Etikett hinzu.
Gibt Ihnen das Japan Post Etikett und die Sendungsnummer zurück.
CreateDeclarationShipment verkettet sieben Schritte. Dieselben Daten, die Sie bereits für eine ctCode=52-Anfrage zusammenstellen, werden darauf verteilt:
Absender / Empfänger → die partyCreateWorkflowORIGIN- und DESTINATION-Parteien.
Artikel → itemCreateWorkflow (die Positionen innerhalb von shipmentCartons).
Verpackung und Gewicht → cartonsCreateWorkflow.
Service, Handhabung und Zollkennzeichnungen → shipmentCreateWorkflow.
Zonos übernimmt diese für Sie
Sie senden keine Japan Post Anmeldedaten oder den Operationscode (ctCode, ctId, ctPw), das Versanddatum (sendDate) oder die DDP-Erklärungsbemerkungen. Zonos setzt diese automatisch, wenn es My Page aufruft.
Jede Tabelle zeigt, wohin ein Japan Post My Page ctCode=52-Parameter im Zonos-Workflow gehört. Für vollständige Felddetails, Typen und welche Felder erforderlich sind, siehe Einzelne Sendung erstellen.
Ein Zonos Servicelevel kodiert sowohl den Postdienst als auch den Transportmodus — z. B. japan_post.air.parcel. Muss ein japan_post.* Servicelevel sein.
Diese Transformationen erfordern am häufigsten Aufmerksamkeit:
Servicelevel ersetzt sendType + transType. Wählen Sie das einzelne Zonos japan_post.* Servicelevel, das dem Postdienst und Transport entspricht, den Sie heute als zwei separate Parameter senden.
Versicherungswert (declaredValue) muss in JPY, ganze Yen sein. Andere Währungen oder gebrochene Yen werden abgelehnt.
Gewicht wird an Japan Post in Gramm gesendet. Geben Sie weight + weightUnit auf dem Karton an; Zonos rechnet um.
Zollbeschreibungen der Artikel sind auf 85 halbbreite Zeichen begrenzt.
Alle Adressfelder müssen in englischen (römischen) Zeichen sein.
Wenn Sie ein US-Etikett über Zonos erstellen, bestätigen Sie, dass alles End-to-End funktioniert hat:
Der Workflow gibt eine Sendungsnummer und ein Etikett zurück. Prüfen Sie shipmentCreateWorkflow.trackingDetails.number und shipmentCartons[].label.url in der Antwort.
Eine Declaration ID wurde erstellt und verknüpft. Die Sendung ist nur zollbezahlt, wenn die Declaration ID mit der Sendungsnummer verknüpft ist — Zonos erledigt dies in derselben Anfrage.
DDP ist auf dem Etikett gedruckt. Öffnen Sie das zurückgegebene Etikett und bestätigen Sie, dass die DDP-Kennzeichnung vorhanden ist.
Die Sendung erscheint in Ihrem Zonos Dashboard unter Ihrem Verified Account.
Für Batch Dispatch bestätigen Sie, dass die Konsolidierung geschlossen wird und den Japan Post Dispatch-Beleg (Code 61) zurückgibt. Siehe Batch Dispatch (Konsolidierung).
Vergleich mit einem My Page Etikett. Erstellen Sie dieselbe Sendung auf beiden Wegen und bestätigen Sie, dass Servicelevel, Gewicht, Versicherungswert und Artikeldetails auf dem gedruckten Etikett übereinstimmen.
Vor dem Livegang testen
Validieren Sie den vollständigen Ablauf mit einer Testsendung, bevor Sie Produktions-US-Volumen über Zonos senden. Ihre My Page-Integration bleibt für alles andere bestehen.
Zonos mit der My Page API nutzen
Zonos mit der Japan Post My Page API nutzen
Erstellen Sie bereits Etiketten mit der Japan Post My Page API? Behalten Sie Ihre Integration — fügen Sie Zonos für US-Etiketten mit vorausbezahlten Zöllen hinzu.
Dieser Leitfaden richtet sich an Teams, die bereits die Japan Post My Page Web API zur Etikettenerstellung integriert haben (Operation
ctCode=52). Für US-gebundene Pakete, bei denen Zölle jetzt im Voraus bezahlt werden müssen, erstellen Sie das Etikett über Zonos. Zonos ist eine Erweiterung des My Page-Workflows: Es ruft die My Page Label API (ctCode=52) in Ihrem Namen auf, fügt die US-Zoll Declaration ID und DDP-Kennzeichnung hinzu und gibt Ihnen das My Page Etikett und die Sendungsnummer zurück. Japan Post erstellt weiterhin das Etikett und berechnet Ihre Portokosten über Ihre Later Pay Number.Kurz gesagt: Sie bauen weiter auf My Page auf, und Zonos übernimmt die US-Zollebene für Sendungen in die Vereinigten Staaten.
Wenn Sie zum ersten Mal integrieren, beginnen Sie mit Einzelne Sendung erstellen.
Wie Zonos eingebunden ist
Für ein US-gebundenes Paket senden Sie die Sendung an den Zonos
CreateDeclarationShipmentGraphQL-Workflow, anstatt My Page direkt aufzurufen. In dieser einzelnen Anfrage:ctCode=52) in Ihrem Namen auf und nutzt die Later Pay Numbers Ihres Verified Account, sodass Portokosten weiterhin Ihrem Japan Post Konto berechnet werden.CreateDeclarationShipmentverkettet sieben Schritte. Dieselben Daten, die Sie bereits für einectCode=52-Anfrage zusammenstellen, werden darauf verteilt:partyCreateWorkflowORIGIN- undDESTINATION-Parteien.itemCreateWorkflow(die Positionen innerhalb vonshipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.Sie senden keine Japan Post Anmeldedaten oder den Operationscode (
ctCode,ctId,ctPw), das Versanddatum (sendDate) oder die DDP-Erklärungsbemerkungen. Zonos setzt diese automatisch, wenn es My Page aufruft.Wie Ihre My Page-Felder auf Zonos abgebildet werden
Jede Tabelle zeigt, wohin ein Japan Post My Page
ctCode=52-Parameter im Zonos-Workflow gehört. Für vollständige Felddetails, Typen und welche Felder erforderlich sind, siehe Einzelne Sendung erstellen.Service und Handhabung →
shipmentCreateWorkflowsendType+transTypeserviceLevel(andshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Muss einjapan_post.*Servicelevel sein.pkgTypecontentsTypeSALE_OF_GOODS,GIFT,DOCUMENTS,SAMPLEusw.senderInstructionnonDelivery.optionRETURN,ABANDONoderFORWARD.fw_TransTypenonDelivery.transportMethodAIRoderMOST_ECONOMICAL.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitAbsender →
partyCreateWorkflow(ORIGINparty)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneEmpfänger →
partyCreateWorkflow(DESTINATIONparty)Die Empfänger-
to_*-Parameter werden auf dieDESTINATION-Partei abgebildet, analog zu den Absenderfeldern.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSoderPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneArtikel →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(per-unit weight)item_costamountitem_curUnitcurrencyCodeWichtige Umrechnungen
Diese Transformationen erfordern am häufigsten Aufmerksamkeit:
sendType+transType. Wählen Sie das einzelne Zonosjapan_post.*Servicelevel, das dem Postdienst und Transport entspricht, den Sie heute als zwei separate Parameter senden.declaredValue) muss in JPY, ganze Yen sein. Andere Währungen oder gebrochene Yen werden abgelehnt.weight+weightUnitauf dem Karton an; Zonos rechnet um.US-Etiketten verifizieren
Wenn Sie ein US-Etikett über Zonos erstellen, bestätigen Sie, dass alles End-to-End funktioniert hat:
shipmentCreateWorkflow.trackingDetails.numberundshipmentCartons[].label.urlin der Antwort.Validieren Sie den vollständigen Ablauf mit einer Testsendung, bevor Sie Produktions-US-Volumen über Zonos senden. Ihre My Page-Integration bleibt für alles andere bestehen.
Verwandte Themen
CreateDeclarationShipment-Workflow.War diese Seite hilfreich?