Usando Zonos con Japan Post My Page API

Questa guida è rivolta ai team che già si integrano con Japan Post My Page Web API per creare etichette (operazione ctCode=52). Per i pacchi diretti negli Stati Uniti, che ora richiedono il pagamento anticipato dei dazi, puoi creare l'etichetta tramite Zonos. Zonos è un'estensione del flusso di lavoro My Page: chiama l'etichetta My Page API (ctCode=52) per tuo conto, aggiunge l'ID della dichiarazione dei dazi statunitensi e il contrassegno DDP e ti restituisce l'etichetta My Page e il numero di tracciamento. Japan Post produce comunque l'etichetta e fattura le spese di spedizione tramite il tuo numero di pagamento successivo.

In breve: continui a basarti su My Page e Zonos gestisce il livello di dazio statunitense per le spedizioni destinate agli Stati Uniti.

Se stai effettuando l'integrazione per la prima volta, inizia con Crea un'unica spedizione.

Come si inserisce Zonos 

Per un pacco destinato agli Stati Uniti, invii la spedizione al Zonos CreateDeclarationShipment Flusso di lavoro GraphQL invece di chiamare direttamente My Page. In quell'unica richiesta, Zonos:

1. Richiama l'etichetta Japan Post API (ctCode=52) per tuo conto, utilizzando i numeri di pagamento successivi del tuo account verificato in modo che la spedizione venga comunque fatturata sul tuo account Japan Post.
2. Crea l'ID della dichiarazione dei dazi statunitensi e lo collega al numero di tracciabilità.
3. Aggiunge il contrassegno DDP all'etichetta.
4. Ti restituisce l'etichetta Japan Post e il numero di tracciamento.

CreateDeclarationShipment catene sette gradini. Gli stessi dati che hai già assemblato per a ctCode=52 la richiesta è distribuita su di essi:

• Mittente/destinatario → il partyCreateWorkflow ORIGIN E DESTINATION partiti.
• Articoli → itemCreateWorkflow (gli elementi pubblicitari all'interno shipmentCartons).
• Imballo e peso → cartonsCreateWorkflow.
• Servizio, movimentazione e bandiere doganali → shipmentCreateWorkflow.

Come i tuoi campi My Page vengono mappati su Zonos 

Ogni tabella mostra dove si trova un Japan Post My Page ctCode=52 il parametro va nel flusso di lavoro Zonos. Per i dettagli completi sui campi, i tipi e i campi obbligatori, vedere Crea un'unica spedizione.

Assistenza e gestione → shipmentCreateWorkflow

Sender → partyCreateWorkflow (ORIGIN party)

Receiver → partyCreateWorkflow (DESTINATION festa)

Il ricevitore to_* i parametri vengono mappati su DESTINATION party the same way the sender fields do.

Items → itemCreateWorkflow

Conversioni da sapere 

Queste sono le trasformazioni che più spesso richiedono attenzione:

• Il livello di servizio sostituisce sendType + transType. Scegli il singolo Zonos japan_post.* livello di servizio che corrisponde al servizio di posta e al trasporto che invii oggi come due parametri separati.
• Valore assicurato (declaredValue) deve essere JPY, yen intero. Altre valute o yen frazionari verranno rifiutati.
• Il peso viene inviato a Japan Post in grammi. Fornire weight + weightUnit sul cartone; Zonos converte.
• Le descrizioni doganali degli articoli sono limitate a 85 caratteri a metà larghezza.
• Tutti i campi dell'indirizzo devono essere in caratteri inglesi (romani).

Verifica le tue etichette statunitensi 

Quando crei un'etichetta statunitense tramite Zonos, verifica che abbia funzionato dall'inizio alla fine:

1. Il flusso di lavoro restituisce un numero di tracciabilità e un'etichetta. Controlla shipmentCreateWorkflow.trackingDetails.number E shipmentCartons[].label.url nella risposta.
2. Un ID dichiarazione è stato creato e collegato. La spedizione è prepagata solo quando l'ID dichiarazione è collegato al numero di tracciamento: Zonos lo fa all'interno della stessa richiesta.
3. DDP è stampato sull'etichetta. Aprire l'etichetta restituita e verificare che sia presente il contrassegno DDP.
4. La spedizione appare nel tuo Zonos Dashboard sotto il tuo Account verificato.
5. Per la spedizione batch, conferma la chiusura del consolidamento e restituisce la distinta di spedizione Japan Post (codice 61). Vedere Invio batch (consolidamento).
6. Confronta con un'etichetta My Page. Crea la stessa spedizione in entrambe le direzioni e verifica che il livello di servizio, il peso, il valore dichiarato e i dettagli dell'articolo corrispondano sull'etichetta stampata.

Imparentato 

• Crea un'unica spedizione — riferimento completo del campo per il CreateDeclarationShipment flusso di lavoro.
• Invio batch (consolidamento) — raggruppare i pacchi giornalieri in un'unica bolla di spedizione Japan Post.