Ottenere la chiave API
Per prima cosa, si registri per un account Zonos e configuri il Suo account in Zonos Dashboard. Potrà quindi ottenere la Sua chiave API, che Le consentirà di autenticarsi con l'API Zonos.
Decidere quali dettagli recuperare
Grazie al funzionamento di GraphQL, può richiedere dall'API solo i campi che La interessano, oppure può scegliere di richiedere tutte le informazioni che il sistema ha in relazione a un ordine: la scelta spetta a Lei. Consulti il riferimento API GraphQL per i campi disponibili.
Informazioni associate all'ordine come dettagli del preventivo Landed Cost, dettagli della valutazione di spedizione, dettagli del carrello, ecc. possono essere interrogati tramite il graph aggiungendo campi da quegli oggetti alla Sua query order.
Al minimo, Le serve un numero d'ordine per poter interrogare l'API. Questo viene passato nel campo orderId con le variabili nella Sua richiesta GraphQL.
query order($orderId: String!) { order(orderId: $orderId) { # ... other field names here }}Inviare la richiesta
Ora che ha creato e configurato la Sua richiesta, può inviare una richiesta POST all'API Zonos. Si assicuri di autenticarsi con la Sua chiave API e di fornire l'intestazione di versione corretta nella Sua richiesta.
POST https://api.zonos.com/graphql
query order($orderId: String!) { order(orderId: $orderId) { accountOrderNumber amountSubtotals { duties taxes fees shipping items } landedCosts { id rootId tariffRate duties { amount currency formula item { id description } exchangeRate { rate sourceCurrencyCode targetCurrencyCode } } fees { amount currency description note formula type item { id description } exchangeRate { rate } } taxes { amount currency formula item { id description } exchangeRate { rate } } deMinimis { formula method note threshold type } shipmentRating { id amount currencyCode displayName minTransitAt maxTransitAt details amount carrierCode amountSubtotals shipping fuelSurcharge insuranceCost otherSurcharge shipmentRatingCartons chargeableWeight carton length width height weight shippingProfile id customServiceLevelCode landedCostMethod serviceLevel code
Recuperare i dettagli dell'ordine
Recuperi i dettagli dell'ordine con GraphQL.Per recuperare i dettagli dei Suoi ordini internazionali nel sistema Zonos, può interrogare l'API GraphQL. Questo Le consente di recuperare i dettagli dell'ordine e qualsiasi informazione applicabile collegata a un ordine, come valutazioni di spedizione, preventivi Landed Cost, ecc.