Prepara la richiesta
Il calcolo di un costo logistico API richiede diversi input, che abbiamo organizzato in flussi di lavoro. Una volta completato, potrai effettuare un'unica richiesta di restituzione di 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 ns Riferimento API per vedere tutti i campi possibili.
Tieni presente che alcuni campi sono obbligatori in modo condizionale se desideri che il tuo calcolo sia garantito.
Di seguito, abbiamo delineato tutti i campi richiesti per calcolare un costo logistico garantito. Assicurati che queste informazioni siano incluse prima di effettuare la richiesta.
Input richiesti per calcoli garantiti
partyCreateWorkflowInputIL partyCreateWorkflowInput identifica le parti coinvolte e la loro ubicazione. Visualizza lo schema completo nel nostro GraphQL API riferimento. I campi obbligatori sono:
locationadministrativeAreaCode: The state or province code, in two letters. Only required for CA and BR.countryCode: Le due lettere Codice ISO del paese.line1: la prima riga dell'indirizzo.postalCode: il codice postale o il codice postale dell'indirizzo.
personemail: l'indirizzo email della persona.firstName: il nome della persona.lastName: Il cognome della persona.phone: il numero di telefono della persona.
typeDESTINATION: ILlocation&personinformazioni sulla destinazione della spedizione.ORIGIN: ILlocationinformazioni sull'origine della spedizione. ILpersonassociato all'origine della spedizione non è obbligatorio.
itemCreateWorkflowInputIL itemCreateWorkflowInput elenca gli articoli nel carrello. Ci sono molti campi facoltativi (vedi tutte le possibilità nel nostro Riferimento API), ma i campi sottostanti sono obbligatori.
amount: Il valore di una singola unità del prodotto spedito, prima di essere moltiplicato per la quantità. Si noti che ciò differisce dalla definizione postale di un invio postale. Se l'articolo èquantityè 1, questo è il costo totale dell'articolo. Se l'articolo èquantityè >1, API moltiplicherà l'elementoamountdall'articoloquantityper ottenere il totale dell'elemento pubblicitario. Non inserire il prezzo totale di tutte le unità dell'articolo nel campoamount.currencyCode: il codice valuta per l'importo dell'articolo.quantity: la quantità dell'articolo. Il API moltiplicherà l'elementoamountdall'articoloquantityper ottenere il totale dell'elemento pubblicitario.countryOfOrigin: il paese in cui è stato prodotto l'articolo.- Uno dei seguenti (a seconda di quale sia impostato come tuo preferenza chiave dell'elemento. La chiave dell'articolo collega le informazioni archiviate nel Catalogo all'articolo nel carrello e viene utilizzata durante la creazione dell'etichetta.)
productId: l'ID prodotto dell'articolo.sku: L'oggetto è SKU.
IL measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) sono necessari solo se lo desideri cartolare i tuoi articoli quando ricevi una valutazione della spedizione.
cartonsCreateWorkflowInputIL cartonsCreateWorkflowInput richiede solo l'input stesso. Visualizza lo schema completo nel nostro GraphQL API riferimento per vedere tutti i valori che possono essere passati. È importante indicare le dimensioni e il peso del cartone se Zonos sta calcolando il costo di spedizione.
shipmentRatingCreateWorkflowInputQuesto flusso di lavoro viene utilizzato quando conosci già il servizio e il costo di spedizione; se desideri che Zonos calcoli questi costi per i servizi che hai abilitato, scambia questo flusso di lavoro e utilizza il shipmentRatingCalculateWorkflow invece.
Il shipmentRatingCreateWorkflowInput comunica il costo di spedizione. Visualizza lo schema completo nel nostro GraphQL API riferimento. I campi obbligatori sono:
amount: Il costo di spedizione.currencyCode: il codice valuta del costo di spedizione.serviceLevelCode: il codice che indica il livello del servizio di spedizione utilizzato nella valutazione della spedizione.
landedCostWorkFlowInputIL landedCostWorkFlowInput detta le preferenze per il calcolo dei costi allo sbarco. Visualizza lo schema completo nel nostro GraphQL API riferimento. I campi obbligatori sono:
calculationMethod: indica la tua preferenza per la modalità di spedizione: DDP (dazi e tasse prepagati) o DAP (i dazi e le tasse vengono pagati alla consegna o, se si applica uno schema di rimessa, vengono rimessi tramite un codice fiscale).- Se utilizzi la nostra garanzia sui costi d'importazione, questo valore dovrebbe sempre essere
DDP_PREFERRED, che fornirà una citazione DDP quando possibile e una citazione DAP è DDP non è consentita. UtilizzandoDAPinvece, i costi allo sbarco potrebbero non essere più garantiti, in quanto ciò comporta in genere il pagamento di dazi e tasse alla consegna.
- Se utilizzi la nostra garanzia sui costi d'importazione, questo valore dovrebbe sempre essere
endUse: Indica se la merce viene venduta ad un'altra azienda (FOR_RESALE) o per l'uso finale presso un consumatore (NOT_FOR_RESALE).tariffRate: Indica il metodo che Zonos dovrebbe utilizzare per calcolare le tariffe per questo preventivo, nel caso in cui esista un range di tariffe che potrebbero essere applicate. *Quando utilizzi la nostra garanzia sui costi d'importazione, questo dovrebbe sempre essereZONOS_PREFERRED.
Aggiungi spedizione calcolata: Se desideri che Zonos calcoli il costo di spedizione per te, sostituisci il
shipmentRatingCreateWorkflowcon ilshipmentRatingCalculateWorkflow. Aggiungi ilcartonizeWorkflowse vuoi Zonos ordinare i tuoi articoli nei cartoni prima di trovare il costo di spedizione (utilizzato per peso dimensionale).
Codice HS e opzioni di spedizione
GraphQL ti dà la flessibilità di personalizzare la richiesta secondo le tue preferenze. Ci sono un paio di opzioni su come includere Codici HS e spese di spedizione nella richiesta.
Codici numbernumbernumbernumber HS
Sono pertanto necessari codici HS che incidono sulle aliquote del dazio. Puoi passare il codice HS per ciascun articolo o lasciare che sia Classify a generarlo.
Zonos consiglia vivamente di utilizzare codici HS specifici del prodotto poiché consentono di ottenere un preventivo dei costi logistici più accurato. Se conosci i tuoi codici HS, passa il hsCode per ciascuno item durante il itemCreateWorkflow.
Se passi un codice HS, Zonos lo convaliderà al volo quando riceverai un preventivo dei costi logistici. Se il codice HS fornito non è valido (ovvero non esiste), Zonos verrà riclassificare il tuo articolo al volo e utilizza il nuovo codice HS valido invece di quello fornito.
Se hai bisogno di aiuto per generare i codici HS per i tuoi prodotti, scopri di più Zonos Classify e come farlo richiedere una classificazione.
Se non superi Zonos an hsCode, controlleremo prima Zonos Catalogo per vedere se hai un codice HS memorizzato per il tuo articolo. Se non lo fai, chiameremo Classify per generare una classificazione per alimentare il calcolo dei costi d'importazione in base a quanto segue itemCreateWorkflow campi dettaglio prodotto: description, category, E material. Se i campi dei dettagli del prodotto non sono sufficientemente dettagliati per generare una classificazione basata su Classify punteggio di fiducia, IL codice HS predefinito verranno utilizzati i dati assegnati al tuo negozio.
Costo di spedizione
Sia il livello del servizio di spedizione che i relativi costi influiscono su dazi, tasse e commissioni e sono pertanto obbligatori. Zonos puoi calcolare la spedizione oppure puoi trasmettercelo.
Per fare in modo che Zonos calcoli le spese di spedizione, utilizza il shipmentRatingCalculateWorkflow. Le opzioni di spedizione restituite nella risposta di spedizione calcolata saranno correlate a serviceLevels hai assegnato ai profili di spedizione in Dashboard.
Risoluzione dei problemi: Se ti aspetti a
serviceLevelnella risposta ma non viene visualizzato, assicurati che il fileserviceLevelè abilitato ed è supportato damethodhai selezionato.
Aggiungi il cartonizeWorkflow (che non ha input) se vuoi Zonos ordinare i tuoi articoli nei cartoni prima di trovare il costo di spedizione (utilizzato per peso dimensionale.
Se conosci il serviceLevel E amount per una spedizione, puoi passare quelli nel file shipmentRatingCreateWorkflow parte della richiesta. Utilizzeremo questi valori per calcolare eventuali tariffe del corriere associate e restituirle nella risposta.
Richiedi un costo allo sbarco tramite API
Una volta ottenuti i dati di input richiesti, invia la mutazione GraphQL all'endpoint API utilizzando la libreria o lo strumento client scelto. Ecco alcuni esempi di come è possibile strutturare la mutazione.
Utilizza questa richiesta quando devi calcolare Zonos il costo di spedizione come parte della richiesta Landed Cost. Successivamente calcoleremo i dazi e le tasse sulla spedizione se valutati dal paese di destinazione.
mutation CalculateLandedCost($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$landedCostConfig: LandedCostWorkFlowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount productId } cartonizeWorkflow { id type items { item { id } } } shipmentRatingCalculateWorkflow { id amount } landedCostCalculateWorkflow(input: $landedCostConfig) { id duties { amount currency note } taxes { amount currency note } fees { amount currency note } }}Passaggio successivo: crea un ordine
Dopo aver calcolato un costo logistico e ricevuto il file landedCostId dalla risposta API, dovresti creare un ordine per finalizzare la transazione nel sistema Zonos. Usa il orderCreate mutazione e passaggio nel landedCostId dalla tua citazione. Scopri di più su creazione di ordini.
Richiedi un costo d'importazione in Dashboard
Puoi anche calcolare direttamente i costi logistici Zonos Dashboard senza utilizzare API. Ciò è utile per testare 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 che otterresti dalle chiamate dirette API. Questo lo rende un ottimo modo per convalidare la tua integrazione API o esplorare come i diversi input influenzano i calcoli.
Utilizzando la calcolatrice Dashboard
Con il calcolatore dei costi di spedizione in Dashboard, puoi ottenere preventivi con tariffe di spedizione calcolate, creare preventivi con costi di spedizione noti o elaborare più preventivi in blocco.
Utilizza questo flusso quando conosci il livello del servizio di spedizione e il costo della spedizione.
- Vai a Dashboard → Ordini → Citazioni
- Fai clic su Nuovo preventivo
- Facoltativo: modifica la posizione dell'indirizzo di partenza della spedizione
- Seleziona un Paese di destinazione dal menu a discesa
- Inserisci l'importo della spedizione
- Il livello di servizio è facoltativo; aggiungendolo possiamo calcolare le tariffe applicabili del corriere
- Aggiungi i dettagli dell'articolo per la spedizione
- Quando inserisci una descrizione, classifichiamo automaticamente il prodotto e generiamo un codice HS
- Se necessario, è possibile sovrascrivere il codice HS generato
- Per più elementi, fai clic su Salva e aggiungine un altro. Altrimenti, fai clic su Salva
- Facoltativo: fai clic su Altre opzioni per modificare:
- Tipo di vendita a Per rivendita
- Modalità di consegna a Dazi di consegna non pagati
- Fai clic su Richiedi preventivo
- Per apportare modifiche, fai clic su Modifica modulo e modifica tutti i dettagli
- Fai di nuovo clic su Richiedi preventivo per aggiornare
Sulla destra verrà visualizzato un preventivo dei costi logistici, inclusi i costi del prodotto, della spedizione e dell'importazione. Espandi il preventivo per visualizzare dettagliati dettagli su articoli, spedizioni, dazi, tasse e commissioni. Tutte le citazioni vengono salvate nella pagina delle citazioni per riferimento futuro.
Modifica preventivi esistenti: fai clic su Cita di nuovo in alto a destra per modificare un preventivo esistente anziché ricominciare da zero.
Vantaggi dell'utilizzo di Dashboard
- Nessuna codifica richiesta — Genera preventivi tramite un'interfaccia intuitiva
- Formazione del team: aiuta i membri del team non tecnici a comprendere i componenti dei costi logistici
- Convalida API: verifica che l'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 (disponibile a breve)
I preventivi Dashboard includono le stesse suddivisioni dettagliate disponibili tramite API, rendendolo un eccellente complemento alla tua integrazione automatizzata.
Calcola un costo logistico
Calcola dazi, tasse e commissioni con GraphQL.GraphQL
Zonos calcola il costo totale allo sbarco per le spedizioni internazionali, inclusi dazi, tasse ed eventuali costi aggiuntivi addebitati da dogane, intermediari o corrieri. Nella maggior parte dei casi, garantiamo questi calcoli pagando noi stessi la fattura finale e addebitandoti esattamente l'importo da noi calcolato. In alcuni casi, puoi utilizzare i nostri costi allo sbarco senza garanzia, il che significa che ti assumi la responsabilità per qualsiasi differenza tra il nostro calcolo e le spese effettive.