Integra il tuo sistema di evasione ordini con Zonos GraphQL API per creare etichette Japan Post duty-prepaid.
Questa sezione è rivolta ai team di tecnici che stanno creando un flusso di lavoro programmatico per le etichette Japan Post che utilizzerà gli account verificati. Se sei uno spedizioniere di piccole o medie dimensioni senza risorse di sviluppo, consulta invece Crea etichette in Dashboard.
I commercianti con account verificato Japan Post chiamano Zonos direttamente. Zonos utilizza le proprie credenziali con Japan Post e include il tuo numero di pagamento successivo su ogni etichetta in modo che le spese postali vengano fatturate sul tuo account.
In un'unica richiesta GraphQL, Zonos:
Convalida il tuo account verificato e i tuoi numeri di pagamento successivi.
Chiama la Japan Post Label API (codice 52) per tuo conto per generare l'etichetta e il numero di tracciamento.
Crea un ID dichiarazione per il pagamento anticipato dei dazi statunitensi.
Collega l'ID della dichiarazione al numero di tracciamento tramite declarationShipmentCreate.
Ti restituisce l'etichetta, il numero di tracciabilità e il record di spedizione.
Non sono necessarie le tue credenziali Japan Post API (CTID / CT password). Hai bisogno che i tuoi numeri di pagamento successivi Japan Post (後納お客様番号) siano collegati al tuo account verificato Zonos.
Tutti chiamano Zonos per creare sia l'etichetta che il manifest, quindi non fornisci mai le tue credenziali Japan Post (CTID / CT password). Ciò che cambia in base alla configurazione sono le intestazioni API Zonos che passi — trova la tua riga qui sotto, quindi usa la scheda corrispondente nella sezione Endpoint e autenticazione di ciascun flusso.
↕
Commerciante di e-commerce↕
Piattaforma di spedizione (BYOA)↕
3PL / Partner logistico / Rivenditore↕
Chi sei
Un marchio che spedisce i tuoi ordini
Una piattaforma attraverso la quale molti commercianti creano etichette
Un partner che spedisce per conto di molti clienti commerciali
Account verificato che hai configurato
Un account verificato (il tuo)
Ogni commerciante crea il proprio; spedisci per loro conto
Un account verificato utilizzato per tutti i tuoi spedizionieri
Il cui numero di pagamento successivo viene fatturato con le spese di spedizione
Il tuo
Quello di ogni commerciante
Il tuo
Chi Zonos fattura i dazi
Voi
Ogni commerciante
Voi
BYOA (Bring Your Own Account): ogni commerciante possiede il proprio account verificato Japan Post, e la piattaforma crea le etichette per conto di tale commerciante passando la sua account key, anziché spedire tramite l'account proprio della piattaforma.
Esistono due modelli di integrazione a seconda della modalità di spedizione dei pacchi.
Crea un'unica spedizione
La catena fondativa. Una richiesta GraphQL prende una spedizione dagli input grezzi (parti, articoli, imballaggio) fino a un'etichetta stampabile Japan Post. Utilizzalo se spedisci i pacchi individualmente man mano che arrivano gli ordini.
Il flusso batch con pagamento differito. Apri un consolidamento al mattino, aggiungici le spedizioni durante il giorno utilizzando la catena di spedizione singola, quindi chiudi il consolidamento a fine giornata per ottenere una distinta di spedizione Japan Post che copre l'intero lotto. Utilizzalo se paghi la spedizione Japan Post in un'unica transazione a fine giornata anziché pacco per pacco.
Se attualmente crei etichette con Japan Post My Page API (ctCode=52), puoi mantenere tale integrazione e aggiungere Zonos per le etichette statunitensi con dazio prepagato. Vedere Utilizzando Zonos con My Page API per una mappatura campo per campo e una checklist di verifica.
Crea etichette tramite API
Crea etichette tramite API
Integra il tuo sistema di evasione ordini con Zonos GraphQL API per creare etichette Japan Post duty-prepaid.
Questa sezione è rivolta ai team di tecnici che stanno creando un flusso di lavoro programmatico per le etichette Japan Post che utilizzerà gli account verificati. Se sei uno spedizioniere di piccole o medie dimensioni senza risorse di sviluppo, consulta invece Crea etichette in Dashboard.
Come funziona il modello Zonos + Japan Post API
I commercianti con account verificato Japan Post chiamano Zonos direttamente. Zonos utilizza le proprie credenziali con Japan Post e include il tuo numero di pagamento successivo su ogni etichetta in modo che le spese postali vengano fatturate sul tuo account.
In un'unica richiesta GraphQL, Zonos:
declarationShipmentCreate.Non sono necessarie le tue credenziali Japan Post API (CTID / CT password). Hai bisogno che i tuoi numeri di pagamento successivi Japan Post (後納お客様番号) siano collegati al tuo account verificato Zonos.
Quale configurazione sei?
Tutti chiamano Zonos per creare sia l'etichetta che il manifest, quindi non fornisci mai le tue credenziali Japan Post (CTID / CT password). Ciò che cambia in base alla configurazione sono le intestazioni API Zonos che passi — trova la tua riga qui sotto, quindi usa la scheda corrispondente nella sezione Endpoint e autenticazione di ciascun flusso.
credentialToken(tuo) solocredentialToken(tuo) +accountKey(di ciascun commerciante)credentialToken(tuo) soloBYOA (Bring Your Own Account): ogni commerciante possiede il proprio account verificato Japan Post, e la piattaforma crea le etichette per conto di tale commerciante passando la sua account key, anziché spedire tramite l'account proprio della piattaforma.
Due flussi API
Esistono due modelli di integrazione a seconda della modalità di spedizione dei pacchi.
Crea un'unica spedizione
La catena fondativa. Una richiesta GraphQL prende una spedizione dagli input grezzi (parti, articoli, imballaggio) fino a un'etichetta stampabile Japan Post. Utilizzalo se spedisci i pacchi individualmente man mano che arrivano gli ordini.
Crea un'unica spedizione →
Invio batch (consolidamento)
Il flusso batch con pagamento differito. Apri un consolidamento al mattino, aggiungici le spedizioni durante il giorno utilizzando la catena di spedizione singola, quindi chiudi il consolidamento a fine giornata per ottenere una distinta di spedizione Japan Post che copre l'intero lotto. Utilizzalo se paghi la spedizione Japan Post in un'unica transazione a fine giornata anziché pacco per pacco.
Invio batch (consolidamento) →
Stai già utilizzando Japan Post My Page API?
Se attualmente crei etichette con Japan Post My Page API (
ctCode=52), puoi mantenere tale integrazione e aggiungere Zonos per le etichette statunitensi con dazio prepagato. Vedere Utilizzando Zonos con My Page API per una mappatura campo per campo e una checklist di verifica.Questa pagina è stata utile?