DOCS
Landed Cost•
HomePer i fornitori di logistica Landed Cost Calcola un costo logistico - GraphQL

Calcola un costo logistico

Calcola dazi, tasse e commissioni con GraphQL.

GraphQL

Zonos calcola il costo logistico totale per le spedizioni internazionali, inclusi dazi, tasse ed eventuali commissioni aggiuntive addebitate da dogane, intermediari o corrieri. Nella maggior parte dei casi, garantiamo questi calcoli pagando noi stessi la fattura finale e addebitandoti esattamente l'importo che abbiamo calcolato. In alcuni casi, puoi utilizzare il nostro costo logistico senza garanzia, il che significa che ti assumi la responsabilità di qualsiasi differenza tra il nostro calcolo e le spese effettive.

Prepara la richiesta 

Il calcolo di un costo logistico tramite API richiede diversi input, che abbiamo organizzato in flussi di lavoro. Una volta completato, potrai effettuare un'unica richiesta per ottenere un costo logistico in base alla destinazione della spedizione, agli articoli nel carrello e ai dettagli di spedizione.

Ogni flusso di lavoro ha i propri input richiesti. GraphQL ti consente di trasferire più dati del necessario, ma solo alcuni campi sono obbligatori per restituire un costo logistico. Questi sono chiaramente indicati nel nostro riferimento API, dove puoi vedere tutti i campi possibili.

Tieni presente che alcuni campi sono obbligatori in modo condizionato, se desideri che il tuo calcolo sia garantito.

Di seguito abbiamo indicato tutti i campi richiesti per calcolare un costo logistico garantito. Assicurati che queste informazioni siano incluse prima di effettuare la richiesta.

Richiedi un costo logistico tramite API 

Una volta ottenuti i dati di input richiesti, invia la mutazione GraphQL all'endpoint API utilizzando la libreria o lo strumento client che preferisci. Ecco alcuni esempi di come strutturare la mutazione.

Utilizza questa richiesta quando fai calcolare a Zonos il costo di spedizione come parte della richiesta Landed Cost. Calcoleremo quindi dazi e tasse sulla spedizione, se previsti dal paese di destinazione.

1mutation CalculateLandedCost(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$landedCostConfig: LandedCostWorkFlowInput!
5) {
6 partyCreateWorkflow(input: $parties) {
7 type
8 id
9 organization
10 }
11 itemCreateWorkflow(input: $items) {
12 id
13 amount
14 productId
15 }
16 cartonizeWorkflow {
17 id
18 type
19 items {
20 item {
21 id
22 }
23 }
24 }
25 shipmentRatingCalculateWorkflow {
26 id
27 amount
28 }
29 landedCostCalculateWorkflow(input: $landedCostConfig) {
30 id
31 duties {
32 amount
33 currency
34 note
35 }
36 taxes {
37 amount
38 currency
39 note
40 }
41 fees {
42 amount
43 currency
44 note
45 }
46 }
47}

Prossimo passaggio: crea un ordine

Dopo aver calcolato un costo logistico e ricevuto il landedCostId dalla risposta dell'API, dovresti creare un ordine per finalizzare la transazione nel sistema Zonos. Usa la mutazione orderCreate e trasferisci il landedCostId del tuo preventivo. Scopri di più su come creare ordini.

Richiedi un costo logistico in Dashboard 

Puoi anche calcolare i costi logistici direttamente in Zonos Dashboard senza utilizzare l'API. Questo è utile per testare i calcoli, formare il tuo team o ottenere preventivi rapidi per le richieste dei clienti.

Dashboard utilizza gli stessi endpoint API descritti sopra, quindi i risultati corrisponderanno a quelli ottenuti tramite chiamate API dirette. Questo lo rende un ottimo modo per convalidare la tua integrazione API o esplorare come i diversi input influiscono sui calcoli.

Usare il calcolatore di Dashboard

Con il calcolatore del costo logistico in Dashboard, puoi ottenere preventivi con tariffe di spedizione calcolate, creare preventivi con costi di spedizione noti oppure elaborare più preventivi in blocco.

Utilizza questo flusso quando conosci già il livello di servizio e il costo di spedizione per la tua spedizione.

  1. Vai su Dashboard → Ordini → Preventivi
  2. Fai clic su Nuovo preventivo
  3. Facoltativo — modifica l'indirizzo di partenza della spedizione
  4. Seleziona un Paese di destinazione dal menu a discesa
  5. Inserisci l'importo della spedizione
    • Il livello di servizio è facoltativo; aggiungerlo ci permette di calcolare le eventuali commissioni del corriere applicabili
  6. Aggiungi i dettagli dell'articolo per la spedizione
    • Quando inserisci una descrizione, classifichiamo automaticamente il prodotto e generiamo un codice HS
    • Puoi sovrascrivere il codice HS generato, se necessario
    • Per più articoli, fai clic su Salva e aggiungine un altro. Altrimenti, fai clic su Salva
  7. Facoltativo — fai clic su Altre opzioni per modificare:
    • il tipo di vendita in Per rivendita
    • la modalità di consegna in Dazi di consegna non pagati
  8. Fai clic su Richiedi preventivo
    • Per apportare modifiche, fai clic su Modifica modulo e modifica i dettagli desiderati
    • Fai di nuovo clic su Richiedi preventivo per aggiornare

Un preventivo del costo logistico apparirà sulla destra, con i costi di prodotto, spedizione e importazione. Espandi il preventivo per vedere la ripartizione dettagliata di articoli, spedizione, dazi, tasse e commissioni. Tutti i preventivi vengono salvati nella pagina dei preventivi per riferimento futuro.

Modifica dei preventivi esistenti: fai clic su Richiedi di nuovo un preventivo in alto a destra per modificare un preventivo esistente invece di ricominciare da zero.

Vantaggi dell'utilizzo di Dashboard

  • Nessuna programmazione richiesta — genera preventivi tramite un'interfaccia intuitiva
  • Formazione del team — aiuta i membri del team non tecnici a comprendere le componenti del costo logistico
  • Convalida dell'API — verifica che la tua integrazione API produca i risultati attesi
  • Assistenza clienti — genera rapidamente preventivi per le richieste dei clienti
  • Elaborazione in blocco — gestisci più calcoli in modo efficiente (in arrivo)

I preventivi di Dashboard includono le stesse ripartizioni dettagliate disponibili tramite l'API, il che li rende un ottimo complemento alla tua integrazione automatizzata.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCalculateWorkflow shipmentRatingCreateWorkflow

Questa pagina è stata utile?

Ottieni supporto·Documenti legali·© 2026 Zonos
In questa pagina:
  • Calcola un costo logistico
  • Prepara la richiesta
  • Richiedi un costo logistico tramite API
  • Richiedi un costo logistico in Dashboard