Crei già etichette con Japan Post My Page API? Mantieni la tua integrazione: aggiungi Zonos per le etichette statunitensi duty-prepaid.
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.
Per un pacco destinato agli Stati Uniti, invii la spedizione al flusso di lavoro GraphQL Zonos CreateDeclarationShipment invece di chiamare direttamente My Page. In quell'unica richiesta, Zonos:
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.
Crea l'ID della dichiarazione dei dazi statunitensi e lo collega al numero di tracciabilità.
Aggiunge il contrassegno DDP all'etichetta.
Ti restituisce l'etichetta Japan Post e il numero di tracciamento.
CreateDeclarationShipment incatena sette passaggi. Gli stessi dati che già assembli per una richiesta ctCode=52 sono distribuiti su di essi:
Mittente/destinatario → le parti ORIGIN e DESTINATION di partyCreateWorkflow.
Articoli → itemCreateWorkflow (le voci di riga all'interno di shipmentCartons).
Imballo e peso → cartonsCreateWorkflow.
Servizio, movimentazione e contrassegni doganali → shipmentCreateWorkflow.
Zonos li gestisce per te
Non invii le credenziali Japan Post o il codice operazione (ctCode, ctId, ctPw), la data di spedizione (sendDate), o le osservazioni della dichiarazione DDP. Zonos li imposta automaticamente quando chiama My Page.
Ogni tabella mostra dove va un parametro Japan Post My Page ctCode=52 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
My Page param↕
campo Zonos↕
Note↕
sendType + transType
serviceLevel (e shipmentRatingCreateWorkflow.serviceLevelCode)
Un livello di servizio Zonos codifica sia il servizio di posta che la modalità di trasporto - ad es. japan_post.air.parcel. Deve essere un livello di servizio japan_post.*.
pkgType
contentsType
SALE_OF_GOODS, ECOMMERCE_GOODS, COMMERCIAL_GOODS, COMMERCIAL_SAMPLE, RETURNED_GOODS, GIFT, DOCUMENTS, o OTHER.
senderInstruction
nonDelivery.option
RETURN_AFTER_RETENTION, RETURN_IMMEDIATELY, FORWARD, o ABANDON. Zonos suddivide la singola istruzione di "ritorno" di My Page in due valori.
fw_TransType
nonDelivery.transportMethod
AIR o MOST_ECONOMICAL. Si applica alle due opzioni RETURN_*.
noCm
isNonCommercial
true / false.
damges
declaredValue
Valore assicurato. Deve essere in JPY, yen intero.
Queste sono le trasformazioni che più spesso richiedono attenzione:
Il livello di servizio sostituisce sendType + transType. Scegli l'unico livello di servizio Zonos japan_post.* che corrisponde al servizio di posta e al trasporto che oggi invii 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).
Quando crei un'etichetta statunitense tramite Zonos, verifica che abbia funzionato dall'inizio alla fine:
Il flusso di lavoro restituisce un numero di tracciabilità e un'etichetta. Controlla shipmentCreateWorkflow.trackingDetails.number e shipmentCartons[].label.url nella risposta.
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.
DDP è stampato sull'etichetta. Aprire l'etichetta restituita e verificare che sia presente il contrassegno DDP.
La spedizione appare nel tuo Zonos Dashboard sotto il tuo account verificato.
Per la spedizione batch, conferma la chiusura del consolidamento e restituisce la distinta di spedizione Japan Post (codice 61). Vedere Invio batch (consolidamento).
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.
Prova prima di andare in diretta
Convalidare l'intero flusso su una spedizione di prova prima di inviare il volume di produzione negli Stati Uniti tramite Zonos. La tua integrazione My Page rimane in vigore per tutto il resto.
Utilizzando Zonos con My Page API
Usando Zonos con Japan Post My Page API
Crei già etichette con Japan Post My Page API? Mantieni la tua integrazione: aggiungi Zonos per le etichette statunitensi duty-prepaid.
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 flusso di lavoro GraphQL Zonos
CreateDeclarationShipmentinvece di chiamare direttamente My Page. In quell'unica richiesta, Zonos: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.CreateDeclarationShipmentincatena sette passaggi. Gli stessi dati che già assembli per una richiestactCode=52sono distribuiti su di essi:ORIGINeDESTINATIONdipartyCreateWorkflow.itemCreateWorkflow(le voci di riga all'interno dishipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.Non invii le credenziali Japan Post o il codice operazione (
ctCode,ctId,ctPw), la data di spedizione (sendDate), o le osservazioni della dichiarazione DDP. Zonos li imposta automaticamente quando chiama My Page.Come i tuoi campi My Page vengono mappati su Zonos
Ogni tabella mostra dove va un parametro Japan Post My Page
ctCode=52nel flusso di lavoro Zonos. Per i dettagli completi sui campi, i tipi e i campi obbligatori, vedere Crea un'unica spedizione.Assistenza e gestione →
shipmentCreateWorkflowsendType+transTypeserviceLevel(eshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Deve essere un livello di serviziojapan_post.*.pkgTypecontentsTypeSALE_OF_GOODS,ECOMMERCE_GOODS,COMMERCIAL_GOODS,COMMERCIAL_SAMPLE,RETURNED_GOODS,GIFT,DOCUMENTS, oOTHER.senderInstructionnonDelivery.optionRETURN_AFTER_RETENTION,RETURN_IMMEDIATELY,FORWARD, oABANDON. Zonos suddivide la singola istruzione di "ritorno" di My Page in due valori.fw_TransTypenonDelivery.transportMethodAIRoMOST_ECONOMICAL. Si applica alle due opzioniRETURN_*.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitMittente →
partyCreateWorkflow(parteORIGIN)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneDestinatario →
partyCreateWorkflow(parteDESTINATION)I parametri
to_*del destinatario vengono mappati sulla parteDESTINATIONallo stesso modo dei campi del mittente.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSoPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneArticoli →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(peso unitario)item_costamountitem_curUnitcurrencyCodeConversioni da sapere
Queste sono le trasformazioni che più spesso richiedono attenzione:
sendType+transType. Scegli l'unico livello di servizio Zonosjapan_post.*che corrisponde al servizio di posta e al trasporto che oggi invii come due parametri separati.declaredValue) deve essere JPY, yen intero. Altre valute o yen frazionari verranno rifiutati.weight+weightUnitsul cartone; Zonos converte.Verifica le tue etichette statunitensi
Quando crei un'etichetta statunitense tramite Zonos, verifica che abbia funzionato dall'inizio alla fine:
shipmentCreateWorkflow.trackingDetails.numbereshipmentCartons[].label.urlnella risposta.Convalidare l'intero flusso su una spedizione di prova prima di inviare il volume di produzione negli Stati Uniti tramite Zonos. La tua integrazione My Page rimane in vigore per tutto il resto.
Correlati
CreateDeclarationShipmentflusso di lavoro.Questa pagina è stata utile?