Offri ai clienti la possibilità di creare spedizioni ed etichette Zonos dalla tua piattaforma.
Questa guida è progettata per gli sviluppatori di piattaforme di spedizione che desiderano integrare le funzionalità di creazione di spedizioni Zonos nella propria piattaforma per i propri clienti. Se stai già utilizzando l'API Zonos e devi solo creare spedizioni per ordini esistenti, consulta la nostra guida alla creazione della spedizione.
Se sei una piattaforma di spedizione che supporta i clienti Zonos che spediscono a livello internazionale, l'integrazione con Zonos per la creazione della spedizione dovrebbe essere una considerazione importante. Ciò ti consentirà di offrire l'esperienza più fluida ai tuoi commercianti e ai loro clienti sfruttando le funzionalità esistenti della tua piattaforma e consentendo a Zonos di gestire la creazione della spedizione, dell'etichetta e della documentazione doganale di supporto.
I vantaggi derivanti dall'utilizzo di Zonos per creare spedizioni includono:
Fatturazione di dazi e tasse a terze parti - Ci assicureremo che tu o il numero di conto del corriere del tuo commerciante venga utilizzato per le spese di spedizione mentre le fatture per dazi e tasse arrivano a Zonos.
Flessibilità - Invece di svolgere attività di sviluppo per assicurarti di poter generare etichette conformi con la tua piattaforma, integra con il nostro API e lascia a noi la conformità transfrontaliera in continua evoluzione.
Documentazione doganale accurata - Quando utilizzi Zonos per generare etichette, ci assicuriamo che i dettagli corretti vengano trasmessi al corriere per garantire che il pacco sdogana rapidamente.
Questa guida ti guiderà attraverso i passaggi per implementare un'integrazione end-to-end completa che ti consentirà di chiamare Zonos per le spedizioni dalla tua piattaforma.
Segui i passaggi seguenti per consentire ai tuoi clienti di recuperare le etichette Zonos dalla tua piattaforma.
1
Consenti credenziali API
Il Zonos API è accessibile tramite un credentialToken. La tua piattaforma dovrà offrire ai clienti la possibilità di inserire il proprio credentialToken dal Zonos Dashboard nella tua piattaforma. Da qui potrai effettuare richieste a Zonos per loro conto.
2
Crea una spedizione
Per recuperare un label, è necessario creare un shipment a cui il label sarà associato. Zonos gestisce questo processo con un flusso di lavoro che crea shipments e labels nella stessa richiesta. Quando esegui questa mutazione, non è necessario specificare un serviceLevel, poiché utilizzeremo il serviceLevel usato dal landedCost collegato all'order. Per l'orderId, puoi utilizzare l'ID ordine Zonos o l'accountOrderNumber, che probabilmente sarà già presente nel tuo sistema.
Quando una spedizione e le etichette vengono create correttamente, restituiremo le etichette come labelImage, che è un BASE64_ENCODED_IMAGE, oppure come url da cui è possibile recuperare l'etichetta.
Utilizza questo flusso di lavoro quando crei una spedizione per un ordine esistente e non è necessario modificare i dettagli dell'articolo o della parte. Supporta numeri di tracciabilità opzionali, centri logistici, selezione del livello di servizio e assicurazione sul valore dichiarato.
Commercianti Shopify
Shopify passa un valore nullo per person nella parte di origine. Di conseguenza, orderId da solo non funzionerà per i commercianti Shopify: utilizza invece la scheda Creazione avanzata della spedizione e fornisci i dettagli completi della parte, inclusi person.
Con Centro logistico: Aggiungi "fulfillmentCenter": "fulfillment_center_12345" per specificare la posizione di origine
Con monitoraggio personalizzato: Imposta "generateLabel": false e aggiungi "trackingNumbers": ["tracking_1", "tracking_2"]
Con livello di servizio: Aggiungi "serviceLevel": "dhl.express_example" per selezionare un servizio di corriere specifico
Con assicurazione sul valore dichiarato: Aggiungi "isDeclaredValue": true per consentire la copertura del valore dichiarato
Con Servizi Speciali: Vedi la guida ai servizi speciali per batterie, ghiaccio secco, merci pericolose e opzioni di firma.
Valore dichiarato
Imposta "isDeclaredValue": true per abilitare la copertura del valore dichiarato per tutti gli articoli della spedizione. Zonos rivendica automaticamente l'intero valore di tutti gli articoli inseriti nell'ordine; i commercianti non possono modificare questo importo. Ciò stabilisce la responsabilità massima che il corriere accetterà in caso di smarrimento, danneggiamento o furto durante il trasporto. Questa funzione è supportata solo per le spedizioni UPS, FedEx e DHL. Zonos gestisce automaticamente l'implementazione specifica dell'operatore quando abiliti il valore dichiarato, inclusi i parametri appropriati nelle nostre chiamate API a questi operatori, quindi non è necessario gestire requisiti diversi dell'operatore.
Limitazioni UPS: UPS copre solo valori compresi tra 100 e 50.000 USD ed elabora il valore dichiarato a livello di cartone. Per le spedizioni composte da più cartoni, i commercianti devono suddividere la spedizione per designare la copertura per cartone. UPS genera anche un modulo assicurativo aggiuntivo che deve essere stampato insieme alle etichette.
FedEx e DHL: elabora il valore dichiarato a livello di spedizione senza ulteriori restrizioni.
Servizi speciali
Utilizzare specialServices su un cartone per indicare requisiti speciali di gestione di batterie, ghiaccio secco, merci pericolose o requisiti di firma. Vedi la guida ai servizi speciali per tutti i dettagli e gli esempi.
ShipStation UPS Unlock: le spedizioni multicollo non sono supportate. Quando un ordine viene spedito in più pacchi, il campo di riferimento viene duplicato, causando un errore nella corrispondenza del numero dell'ordine sul back-end. I commercianti che necessitano di spedizioni multicollo dovrebbero invece creare l'etichetta in Zonos Dashboard. Le spedizioni a scatola singola non sono interessate.
3
Annulla una spedizione
Nel caso in cui un cliente desideri annullare un shipment, puoi utilizzare la seguente mutazione che annullerà tutte le labels collegate al shipment.
Integrazione della spedizione della piattaforma
Crea spedizioni dalla tua piattaforma
Offri ai clienti la possibilità di creare spedizioni ed etichette Zonos dalla tua piattaforma.
Questa guida è progettata per gli sviluppatori di piattaforme di spedizione che desiderano integrare le funzionalità di creazione di spedizioni Zonos nella propria piattaforma per i propri clienti. Se stai già utilizzando l'API Zonos e devi solo creare spedizioni per ordini esistenti, consulta la nostra guida alla creazione della spedizione.
Se sei una piattaforma di spedizione che supporta i clienti Zonos che spediscono a livello internazionale, l'integrazione con Zonos per la creazione della spedizione dovrebbe essere una considerazione importante. Ciò ti consentirà di offrire l'esperienza più fluida ai tuoi commercianti e ai loro clienti sfruttando le funzionalità esistenti della tua piattaforma e consentendo a Zonos di gestire la creazione della spedizione, dell'etichetta e della documentazione doganale di supporto.
I vantaggi derivanti dall'utilizzo di Zonos per creare spedizioni includono:
Questa guida ti guiderà attraverso i passaggi per implementare un'integrazione end-to-end completa che ti consentirà di chiamare Zonos per le spedizioni dalla tua piattaforma.
Abilita la stampa delle etichette
Segui i passaggi seguenti per consentire ai tuoi clienti di recuperare le etichette Zonos dalla tua piattaforma.
Consenti credenziali API
Il Zonos API è accessibile tramite un
credentialToken. La tua piattaforma dovrà offrire ai clienti la possibilità di inserire il propriocredentialTokendal Zonos Dashboard nella tua piattaforma. Da qui potrai effettuare richieste a Zonos per loro conto.Crea una spedizione
Per recuperare un
label, è necessario creare unshipmenta cui illabelsarà associato. Zonos gestisce questo processo con un flusso di lavoro che creashipmentselabelsnella stessa richiesta. Quando esegui questa mutazione, non è necessario specificare unserviceLevel, poiché utilizzeremo ilserviceLevelusato dallandedCostcollegato all'order. Per l'orderId, puoi utilizzare l'ID ordine Zonos o l'accountOrderNumber, che probabilmente sarà già presente nel tuo sistema.Quando una spedizione e le etichette vengono create correttamente, restituiremo le etichette come
labelImage, che è unBASE64_ENCODED_IMAGE, oppure comeurlda cui è possibile recuperare l'etichetta.Utilizza questo flusso di lavoro quando crei una spedizione per un ordine esistente e non è necessario modificare i dettagli dell'articolo o della parte. Supporta numeri di tracciabilità opzionali, centri logistici, selezione del livello di servizio e assicurazione sul valore dichiarato.
Shopify passa un valore nullo per
personnella parte di origine. Di conseguenza,orderIdda solo non funzionerà per i commercianti Shopify: utilizza invece la scheda Creazione avanzata della spedizione e fornisci i dettagli completi della parte, inclusiperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitemsitemidamountdescriptionlabelurltrackingNumberiddocumentFilingOpzioni variabili:
"fulfillmentCenter": "fulfillment_center_12345"per specificare la posizione di origine"generateLabel": falsee aggiungi"trackingNumbers": ["tracking_1", "tracking_2"]"serviceLevel": "dhl.express_example"per selezionare un servizio di corriere specifico"isDeclaredValue": trueper consentire la copertura del valore dichiaratoValore dichiarato
Imposta
"isDeclaredValue": trueper abilitare la copertura del valore dichiarato per tutti gli articoli della spedizione. Zonos rivendica automaticamente l'intero valore di tutti gli articoli inseriti nell'ordine; i commercianti non possono modificare questo importo. Ciò stabilisce la responsabilità massima che il corriere accetterà in caso di smarrimento, danneggiamento o furto durante il trasporto. Questa funzione è supportata solo per le spedizioni UPS, FedEx e DHL. Zonos gestisce automaticamente l'implementazione specifica dell'operatore quando abiliti il valore dichiarato, inclusi i parametri appropriati nelle nostre chiamate API a questi operatori, quindi non è necessario gestire requisiti diversi dell'operatore.Limitazioni UPS: UPS copre solo valori compresi tra 100 e 50.000 USD ed elabora il valore dichiarato a livello di cartone. Per le spedizioni composte da più cartoni, i commercianti devono suddividere la spedizione per designare la copertura per cartone. UPS genera anche un modulo assicurativo aggiuntivo che deve essere stampato insieme alle etichette.
FedEx e DHL: elabora il valore dichiarato a livello di spedizione senza ulteriori restrizioni.
Servizi speciali
Utilizzare
specialServicessu un cartone per indicare requisiti speciali di gestione di batterie, ghiaccio secco, merci pericolose o requisiti di firma. Vedi la guida ai servizi speciali per tutti i dettagli e gli esempi.ShipStation UPS Unlock: le spedizioni multicollo non sono supportate. Quando un ordine viene spedito in più pacchi, il campo di riferimento viene duplicato, causando un errore nella corrispondenza del numero dell'ordine sul back-end. I commercianti che necessitano di spedizioni multicollo dovrebbero invece creare l'etichetta in Zonos Dashboard. Le spedizioni a scatola singola non sono interessate.
Annulla una spedizione
Nel caso in cui un cliente desideri annullare un
shipment, puoi utilizzare la seguente mutazione che annullerà tutte lelabelscollegate alshipment.mutation {shipmentStatusUpdate(input: {shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"status: VOIDEDnote: "Voiding shipment"}) {idstatus}}CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate
Questa pagina è stata utile?