Come funziona il modello Zonos + Japan Post API
Japan Post Commercianti con account verificati chiama direttamente Zonos. 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 successivamente i numeri di pagamento.
- Chiama l'etichetta Japan Post 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 proprie 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.
Which setup are you?
Everyone calls Zonos to create both the label and the manifest, so you never provide your own Japan Post credentials (CTID / CT password). What changes by setup is which Zonos API headers you pass — find your row below, then use the matching tab in each flow's Endpoint and authentication section.
| ↕ | 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 |
| Zonos API intestazioni da passare | credentialToken (tuo) solo | credentialToken (tuo) + accountKey (di ciascun commerciante) | credentialToken (tuo) solo |
| 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): each merchant holds their own Japan Post Verified Account, and the platform creates labels on that merchant's behalf by passing the merchant's account key, rather than shipping under the platform's own account.
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.
Invio batch (consolidamento)
Il flusso batch con pagamento differito. Apri un consolidamento al mattino, allegavi 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.
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.
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 Crea etichette in Dashboard Invece.