Abilita la stampa delle etichette
Segui i passaggi qui sotto per consentire ai tuoi clienti di recuperare le etichette di Zonos dalla tua piattaforma.
Consenti credenziali API
LAPI di Zonos è accessibile tramite un credentialToken. La tua piattaforma dovrà dare ai clienti la possibilità di inserire il loro credentialToken dal Dashboard di Zonos nella tua piattaforma. Da qui, sarai in grado di effettuare richieste a Zonos per loro conto.
Crea una spedizione
Per recuperare un label, è necessario creare una shipment con 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 passare un serviceLevel poiché utilizzeremo il serviceLevel utilizzato dal landedCost legato all'order. Per l'orderId, puoi utilizzare l'ID dell'ordine di Zonos o il accountOrderNumber che probabilmente è già nel tuo sistema.
Quando una spedizione e le etichette vengono create con successo, restituiremo le etichette come un labelImage che è un BASE64_ENCODED_IMAGE, o come un url da cui l'etichetta può essere recuperata.
Utilizza questo flusso di lavoro quando stai creando una spedizione per un ordine esistente e non hai bisogno di modificare i dettagli degli articoli o delle parti. Supporta numeri di tracciamento opzionali, centri di adempimento, selezione del livello di servizio e assicurazione sul valore dichiarato.
Mutazione
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
}
}
}
}
Variabili di Base
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Con Centro di Adempimento
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Con tracciamento personalizzato
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Con Livello di Servizio
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Con assicurazione sul valore dichiarato
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Valore dichiarato
Imposta "isDeclaredValue": true per abilitare la copertura del valore dichiarato per tutti gli articoli nella tua spedizione. Zonos richiede automaticamente il valore totale di tutti gli articoli inviati nell'ordine; i commercianti non possono modificare questo importo. Questo imposta la responsabilità massima che il vettore accetterà in caso di perdita, danno o furto durante il transito. Questa funzionalità è supportata solo per le spedizioni UPS, FedEx e DHL. Zonos gestisce automaticamente l'implementazione specifica del vettore quando abiliti il valore dichiarato, inclusi i parametri appropriati nelle nostre chiamate API a questi vettori, quindi non è necessario gestire i requisiti diversi dei vettori.
Limitazioni di UPS: UPS copre solo valori tra 100-50.000 USD e elabora il valore dichiarato a livello di cartone. Per spedizioni multi-cartone, i commercianti devono suddividere la spedizione per designare la copertura per cartone. UPS genera anche un modulo di assicurazione aggiuntivo che deve essere stampato con le etichette.
FedEx e DHL: Elaborano il valore dichiarato a livello di spedizione senza ulteriori restrizioni.
Annullare una spedizione
Nel caso in cui un cliente desideri annullare una spedizione, puoi utilizzare la seguente mutazione che annullerà tutte le etichette collegate alla spedizione.
Richiesta
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 e etichette di Zonos dalla tua piattaforma.
Questa guida è progettata per gli sviluppatori di piattaforme di spedizione che desiderano integrare le capacità di creazione di spedizioni di Zonos nella loro piattaforma per i loro clienti. Se stai già utilizzando l'API di Zonos e hai solo bisogno di creare spedizioni per ordini esistenti, consulta la nostra guida alla creazione di spedizioni.
Se sei una piattaforma di spedizione che supporta i clienti di Zonos che spediscono a livello internazionale, l'integrazione con Zonos per la creazione di spedizioni dovrebbe essere una considerazione prioritaria. Questo ti permetterà di offrire l'esperienza più fluida per i tuoi commercianti e i loro clienti sfruttando le funzionalità esistenti della tua piattaforma, mentre Zonos gestisce la creazione della spedizione, dell'etichetta e della documentazione doganale di supporto.
I vantaggi dell'utilizzo di Zonos per creare spedizioni includono:
Questa guida ti guiderà attraverso i passaggi per implementare un'integrazione completa end-to-end che ti permetterà di chiamare Zonos per le spedizioni dalla tua piattaforma.