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 da a credentialToken. La tua piattaforma dovrà offrire ai clienti la possibilità di inserire i propri file credentialToken dal Zonos Dashboard nella tua piattaforma. Da qui potrai effettuare richieste a Zonos per loro conto.
Crea una spedizione
Per recuperare a label, è necessario creare un file shipment che il label sarà associato a. Zonos gestisce questo processo con un flusso di lavoro che crea shipments E labels nella stessa richiesta. Quando si esegue questa mutazione, non è necessario superare a serviceLevel come useremo il serviceLevel utilizzato da landedCost che è legato al order. Per il orderId, puoi utilizzare l'ID ordine Zonos o il accountOrderNumber che probabilmente sarà già nel tuo sistema.
Quando una spedizione e le etichette vengono create correttamente, restituiremo le etichette come a labelImage che è un BASE64_ENCODED_IMAGE, o come a url da dove è 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.
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) { shipmentCreateWorkflow(input: $input) { id status trackingDetails { number } serviceLevel { id name carrier { id name } } shipmentCartons { id carton { id width length height weight items item id amount description label url trackingNumber id documentFilingOpzioni variabili:
- Con Centro logistico: Aggiungi
"fulfillmentCenter": "fulfillment_center_12345"per specificare la posizione di origine - Con monitoraggio personalizzato: Imposta
"generateLabel": falsee 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: Agg
"isDeclaredValue": trueper consentire la copertura del valore dichiarato - Con Servizi Speciali: Vedi il guida ai servizi speciali per batterie, ghiaccio secco, merci pericolose e opzioni di firma.
Valore dichiarato
Impostato "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 il 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 a shipment, puoi utilizzare la seguente mutazione che annullerà tutto labels legato al shipment.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
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. If you're already using the Zonos API and just need to create shipments for existing orders instead, see our 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.