Hoe Zonos past
Voor een pakket naar de VS stuurt u de zending naar de Zonos CreateDeclarationShipment GraphQL-workflow in plaats van My Page rechtstreeks aan te roepen. In dat ene verzoek:
- Roept Zonos de Japan Post Label API (
ctCode=52) aan met uw Later Pay Numbers. - Maakt de Amerikaanse duty Declaration ID aan en koppelt deze aan het trackingnummer.
- Voegt de DDP-markering toe aan het label.
- Retourneert het Japan Post-label en trackingnummer.
CreateDeclarationShipment koppelt zeven stappen. Dezelfde gegevens die u al verzamelt voor een ctCode=52-verzoek worden verdeeld over:
- Sender / receiver →
partyCreateWorkflowORIGIN- enDESTINATION-parties. - Items →
itemCreateWorkflow. - Packaging and weight →
cartonsCreateWorkflow. - Service, handling, and customs flags →
shipmentCreateWorkflow.
Hoe uw My Page-velden naar Zonos mappen
Zie Eén zending aanmaken voor volledige velddetails.
Service and handling → shipmentCreateWorkflow
| My Page param↕ | Zonos field↕ | Notes↕ |
|---|---|---|
sendType + transType | serviceLevel (and shipmentRatingCreateWorkflow.serviceLevelCode) | One Zonos service level encodes both the mail service and the transport mode — e.g. japan_post.air.parcel. Must be a japan_post.* service level. |
pkgType | contentsType | SALE_OF_GOODS, GIFT, DOCUMENTS, SAMPLE, etc. |
senderInstruction | nonDelivery.option | RETURN, ABANDON, or FORWARD. |
fw_TransType | nonDelivery.transportMethod | AIR or MOST_ECONOMICAL. |
noCm | isNonCommercial | true / false. |
damges | declaredValue | Insured value. Must be in JPY, whole yen. |
totalWeight | cartonsCreateWorkflow.weight + weightUnit | Sent to Japan Post in grams. |
Sender → 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 | Prefecture. |
from_tel | person.phone |
Receiver → partyCreateWorkflow (DESTINATION party)
| My Page param↕ | Zonos field↕ | Notes↕ |
|---|---|---|
to_nam | person.firstName + person.lastName | |
to_companyName | person.companyName | |
to_couCd | location.countryCode | US or PR. |
to_add1 / to_add2 / to_add3 | location.line1 / location.line2 / location.locality | |
| Postal code / state / phone | location.postalCode / location.administrativeAreaCode / person.phone |
Items → itemCreateWorkflow
| My Page param↕ | Zonos field↕ | Notes↕ |
|---|---|---|
item_pkg | customsDescription | Item customs description. Half-width characters, 85 characters max. |
item_hsCode | hsCode | |
item_num | quantity | |
item_weight | measurements (per-unit weight) | |
item_cost | amount | Unit price. |
item_curUnit | currencyCode |
Conversies om te kennen
- Service level vervangt
sendType+transType. - Verzekerde waarde (
declaredValue) moet JPY zijn, hele yen. - Gewicht wordt in gram naar Japan Post gestuurd.
- Item-douanebeschrijvingen zijn beperkt tot 85 half-width tekens.
- Alle adresvelden moeten in het Engels (Romeins) zijn.
Verifieer uw VS-labels
- De workflow retourneert een trackingnummer en label.
- Een Declaration ID is aangemaakt en gekoppeld.
- DDP staat op het label afgedrukt.
- De zending verschijnt in Zonos Dashboard.
- Voor batch dispatch, bevestig dat de consolidatie sluit. Zie Batch dispatch (consolidatie).
- Vergelijk met een My Page-label.
Zonos gebruiken met de Japan Post My Page API
Maakt u al labels met de Japan Post My Page API? Behoud uw integratie — voeg Zonos toe voor labels met vooraf betaalde invoerrechten voor de VS.Deze gids is voor teams die al integreren met de Japan Post My Page Web API om labels aan te maken (operatie
ctCode=52). Voor pakketten naar de VS maakt u het label via Zonos. Zonos roept de My Page Label API (ctCode=52) namens u aan, voegt de Amerikaanse duty Declaration ID en DDP-markering toe, en retourneert het My Page-label en trackingnummer. Japan Post produceert nog steeds het label en factureert portokosten via uw Later Pay Number.Kortom: u blijft bouwen op My Page, en Zonos handelt de Amerikaanse duty-laag af voor zendingen naar de Verenigde Staten.
Integreert u voor het eerst, begin dan met Eén zending aanmaken.