DOCS

Recupera i dettagli doganali

Recupera i dettagli doganali

Recupera i dettagli dell'ordine per preparare una spedizione.

GraphQL

Se sei un partner di Zonos e lavori con un cliente che utilizza la tua piattaforma per la spedizione, puoi chiamare Zonos per i dettagli sull'ordine. Questi dettagli possono essere utilizzati nella richiesta di etichetta al corriere per garantire che i dettagli trasmessi siano gli stessi utilizzati per garantire che Zonos garantisca i dazi e le tasse valutati su quella spedizione. Restituiremo i dettagli sugli identificativi fiscali, sugli articoli, inclusi i codici HS e le descrizioni doganali, e i numeri di conto a cui devono essere fatturati dazi e tasse.

Chiama Zonos per i dettagli doganali 

Segui i passaggi seguenti per consentire ai tuoi clienti di recuperare i dettagli doganali che possono essere utilizzati durante la creazione di spedizioni dalla tua piattaforma.

1

Consenti ai clienti di trasmettere le proprie credenziali Zonos API

Il Zonos API è accessibile tramite un credentialToken. La tua piattaforma dovrà offrire ai clienti la possibilità di inserire il proprio credentialToken dal Zonos Dashboard nella tua piattaforma. Da qui potrai effettuare richieste a Zonos per loro conto.

Utilizza la seguente query per recuperare i dettagli doganali necessari per creare la spedizione. Per il orderId, puoi utilizzare l'ID ordine Zonos o il accountOrderNumber che probabilmente sarà già nel tuo sistema.

1query GetCustomsSpec($referenceId: String!) {
2 customsSpecByReference(referenceId: $referenceId) {
3 id
4 currencyCode
5 amountSubtotals {
6 items
7 shipping
8 }
9 reasonForExport
10 incoterm
11 declarationStatement
12 attributes {
13 type
14 value
15 }
16 serviceLevel {
17 name
18 code
19 carrier {
20 name
21 code
22 }
23 }
24 parties {
25 id
26 type
27 person {
28 companyName
29 firstName
30 lastName
31 email
32 phone
33 }
34 location {
35 countryCode
36 line1
37 locality
38 postalCode
39 administrativeAreaCode
40 administrativeArea
41 }
42 }
43 customsItems {
44 id
45 amount
46 quantity
47 hsCode
48 hsCodeSource
49 description
50 countryOfOrigin
51 items {
52 id
53 amount
54 currencyCode
55 quantity
56 }
57 }
58 }
59}

Dopo aver recuperato i dettagli doganali per un ordine, puoi utilizzare tali dettagli nella tua richiesta al corriere. Quando recuperi l'etichetta e il numero di tracciabilità dal corriere, puoi utilizzare la mutazione shipmentCreate, per indicare a Zonos il numero di tracciamento in modo da poter aggiornare lo stato dell'ordine.

Questa pagina è stata utile?