DOCS

Creare una spedizione

Landed Cost•
HomePer i fornitori di logistica Landed Cost Creare una spedizione

Creare una spedizione per ordini esistenti

Crea spedizioni e etichette con l'API di Zonos dopo aver calcolato i costi di sbarco e creato ordini.

GraphQL

Questa guida è progettata per gli utenti che sono già integrati con l'API di Zonos e hanno bisogno di creare spedizioni per ordini esistenti nel loro sistema. Se sei una piattaforma di spedizione e desideri offrire la creazione di spedizioni Zonos ai tuoi clienti, consulta la nostra guida all'API di spedizione.

Se sei integrato con l'API di Zonos e approvato per spedire al di fuori del Dashboard, utilizza la mutazione shipmentCreateWorkflow per creare spedizioni e fornire informazioni di tracciamento. Queste mutazioni ti consentono anche di informare Zonos riguardo le spedizioni nazionali verso strutture di cross-docking.

Nota: Se stai utilizzando un'app per Dazi e Tasse con una piattaforma che sincronizza automaticamente i numeri di tracciamento con Zonos, o se stai spedendo direttamente tramite il Dashboard, queste mutazioni non sono necessarie.

Creare spedizioni tramite API 

Dopo aver calcolato un Landed Cost e creato un ordine, puoi inviare numeri di tracciamento e altri dettagli della spedizione a Zonos tramite l'API.

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 evasione, selezione del livello di servizio e assicurazione sul valore dichiarato.

Mutazione

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Con Centro di Adempimento

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Con tracciamento personalizzato

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Con Livello di Servizio

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Con assicurazione sul valore dichiarato

1
2
3
4
5
6
7
{
  "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 

Per annullare un'etichetta creata, utilizzare la seguente mutazione per annullare la spedizione. Qualsiasi etichetta associata sarà annullata automaticamente. Si noti che una volta che una spedizione è stata annullata, non può essere aggiornata o ripristinata.

Mutazione

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Questa pagina è stata utile?

Prenota una demo
© 2025 Zonoszonos.com
In questa pagina:
  • Creare una spedizione per ordini esistenti
  • Creare spedizioni tramite API
  • Annullare una spedizione