Wie Zonos eingebunden ist
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- undDESTINATION-Parteien. - Artikel →
itemCreateWorkflow(die Positionen innerhalb vonshipmentCartons). - Verpackung und Gewicht →
cartonsCreateWorkflow. - Service, Handhabung und Zollkennzeichnungen →
shipmentCreateWorkflow.
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 → shipmentCreateWorkflow
| My Page param↕ | Zonos field↕ | Notes↕ |
|---|---|---|
sendType + transType | serviceLevel (and shipmentRatingCreateWorkflow.serviceLevelCode) | Ein Zonos Servicelevel kodiert sowohl den Postdienst als auch den Transportmodus — z. B. japan_post.air.parcel. Muss ein japan_post.* Servicelevel sein. |
pkgType | contentsType | SALE_OF_GOODS, GIFT, DOCUMENTS, SAMPLE usw. |
senderInstruction | nonDelivery.option | RETURN, ABANDON oder FORWARD. |
fw_TransType | nonDelivery.transportMethod | AIR oder MOST_ECONOMICAL. |
noCm | isNonCommercial | true / false. |
damges | declaredValue | Versicherungswert. Muss in JPY, ganze Yen. |
totalWeight | cartonsCreateWorkflow.weight + weightUnit | Wird an Japan Post in Gramm gesendet. |
Absender → partyCreateWorkflow (ORIGIN party)
| My Page param↕ | Zonos field↕ | Notes↕ |
|---|---|---|
from_nam | person.firstName + person.lastName | |
from_companyName | person.companyName | |
from_postal | location.postalCode | |
from_add1 / from_add2 / from_add3 | location.line1 / location.line2 / location.locality | |
from_pref | location.administrativeAreaCode | Präfektur. |
from_tel | person.phone |
Empfänger → partyCreateWorkflow (DESTINATION party)
Die Empfänger-to_*-Parameter werden auf die DESTINATION-Partei abgebildet, analog zu den Absenderfeldern.
| My Page param↕ | Zonos field↕ | Notes↕ |
|---|---|---|
to_nam | person.firstName + person.lastName | |
to_companyName | person.companyName | |
to_couCd | location.countryCode | US oder PR. |
to_add1 / to_add2 / to_add3 | location.line1 / location.line2 / location.locality | |
| Postal code / state / phone | location.postalCode / location.administrativeAreaCode / person.phone |
Artikel → itemCreateWorkflow
| My Page param↕ | Zonos field↕ | Notes↕ |
|---|---|---|
item_pkg | customsDescription | Zollbeschreibung des Artikels. Halbbreite Zeichen, maximal 85 Zeichen. |
item_hsCode | hsCode | |
item_num | quantity | |
item_weight | measurements (per-unit weight) | |
item_cost | amount | Stückpreis. |
item_curUnit | currencyCode |
Wichtige Umrechnungen
Diese Transformationen erfordern am häufigsten Aufmerksamkeit:
- Servicelevel ersetzt
sendType+transType. Wählen Sie das einzelne Zonosjapan_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+weightUnitauf 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.
US-Etiketten verifizieren
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.numberundshipmentCartons[].label.urlin 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.
Verwandte Themen
- Einzelne Sendung erstellen — vollständige Feldreferenz für den
CreateDeclarationShipment-Workflow. - Batch Dispatch (Konsolidierung) — bündeln Sie die Pakete des Tages in einen Japan Post Dispatch-Beleg.
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 Etiketterstellung 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.