Crea spedizioni tramite API
Dopo aver calcolato un Landed Cost e creato un ordine, puoi inviare i numeri di tracciabilità e altri dettagli della spedizione a Zonos tramite API.
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 documentFiling } } }}Opzioni 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
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.
Limiti UPS: UPS copre solo valori compresi tra 100,01 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 inoltre un modulo assicurativo aggiuntivo (UPS Control Log) che deve essere stampato insieme alle etichette per valori dichiarati superiori a 999 USD.
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.
Annulla una spedizione
Per annullare un'etichetta creata, utilizzare la seguente mutazione per annullare la spedizione. Anche eventuali etichette associate verranno automaticamente annullate. Tieni presente che una volta annullata una spedizione, non può essere aggiornata o ripristinata.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Crea una spedizione per gli ordini esistenti
Crea spedizioni ed etichette con Zonos API dopo aver calcolato i costi logistici e creato gli ordini.
GraphQL
Questa guida è pensata per gli utenti già integrati con Zonos API che necessitano di creare spedizioni per ordini esistenti nel proprio sistema. Se sei una piattaforma di spedizione e desideri invece offrire ai tuoi clienti la creazione di spedizioni Zonos, consulta la nostra Guida alla spedizione API.
Se sei integrato con Zonos API e approvato per spedire al di fuori di Dashboard, utilizzare il
shipmentCreateWorkflowmutazione per creare spedizioni e fornire informazioni di tracciamento. Queste mutazioni consentono inoltre di informare Zonos sulle spedizioni nazionali alle strutture di cross-docking.Nota: Se utilizzi un'app Duty and Tax con una piattaforma che sincronizza automaticamente i numeri di tracciabilità con Zonos o se effettui la spedizione direttamente tramite Dashboard, queste mutazioni non sono necessarie.