DOCS

Match orders to get customs info

/

Recupera la documentazione doganale per un ordine

Ottieni informazioni doganali per un ordine esistente.

GraphQL

Se sei un partner di Zonos e condividiamo clienti comuni, puoi utilizzare Clear per aggiornare e recuperare la documentazione doganale completa su un ordine esistente di Zonos. Puoi recuperare i dati doganali su una spedizione in cui il mittente potrebbe aver fornito informazioni mancanti o inaccurate. Ad esempio, è comune che un mittente fornisca una descrizione scadente o non fornisca un codice HS. Zonos può aggiungere, integrare o migliorare informazioni come una descrizione, codice HS, paese di origine, prezzi e altro.

1

Crea la parte di origine

Zonos non sarà in grado di conoscere l'origine di questa spedizione poiché l'etichetta non è stata manifestata nel dashboard di Zonos. Per garantire che possiamo recuperare i dettagli dell'ordine corretti, è necessario creare una party con i dettagli di origine, inclusi account e accountOrderNumber come referenceId. Il referenceId per questa parte DEVE essere l'account e l'accountOrderNumber uniti da un trattino come mostrato nell'esempio qui sotto.

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
mutation originParty {
  partyCreate(
    input: {
      referenceId: "100051-O-1434321"
      person: {
        firstName: "John"
        lastName: "Doe"
        email: "test@test.com"
        phone: "5555555555"
      }
      location: {
        administrativeArea: "Utah"
        administrativeAreaCode: "UT"
        countryCode: US
        line1: "348 N 2450 E"
        line2: "#245"
        locality: "St George"
        postalCode: "84790"
      }
      type: ORIGIN
    }
  ) {
    id
  }
}

Variabili

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "shipFrom": {
    "type": "ORIGIN",
    "referenceId": "root_cd8d3d85-283f-4865-af77-9cda0c123c0a",
    "location": {
      "administrativeArea": "Utah",
      "administrativeAreaCode": "UT",
      "countryCode": "US",
      "line1": "370 Buena Vista Boulevard",
      "locality": "St. George",
      "postalCode": "84790"
    }
  }
}

Risposta

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "shipFrom": {
      "id": "party_ac64040b-228e-424c-a090-6da03197011d",
      "location": {
        "countryCode": "US"
      }
    }
  }
}
2

Recupera l' Zonos orderId

Fornisci all' Zonos il numero di account del commerciante e il loro accountOrderNumber per abbinare i dettagli dal tuo sistema con l' order nel nostro sistema. Il riferimento API può essere trovato qui.

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
mutation {
  orderLink(input: { account: "10051", accountOrderNumber: "1434321" }) {
    id
    root {
      id
      parties {
        id
        type
        location {
          countryCode
          postalCode
        }
      }
      items {
        id
        description
      }
      shipmentRatings {
        id
      }
      landedCosts {
        amountSubtotals {
          duties
          taxes
          fees
          shipping
        }
      }
    }
  }
}

Risposta

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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
{
  "data": {
    "orderLink": [
      {
        "id": "order_cd6bca4e-6da4-430c-aaf3-7a8b161627a4",
        "root": {
          "id": "100051-O-1434321",
          "parties": [
            {
              "id": "party_2fdf56a0-2bb2-4443-b8ca-a984d335ffcf",
              "type": "ORIGIN",
              "location": {
                "countryCode": "US",
                "postalCode": "84790"
              }
            },
            {
              "id": "party_9b3ac542-da12-4869-bcf4-00f42af17f6f",
              "type": "DESTINATION",
              "location": {
                "countryCode": "FR",
                "postalCode": "47310"
              }
            }
          ],
          "items": [
            {
              "id": "item_c0a329ef-d157-4fa2-8982-be4420717f64",
              "description": "Monoprice 4-Port SATA Serial ATA PCI RAID Controller Card, Silicon Image"
            },
            {
              "id": "item_67e9fd3f-8f84-4027-9b06-f6b26915d1d2",
              "description": "CORSAIR iCUE H115i RGB PRO XT, 280mm Radiator, Dual 140mm PWM Fans, Software Control, Liquid CPU Cooler, CW-9060044-WW LGA 1700 Compatible"
            }
          ],
          "shipmentRatings": [
            {
              "id": "shipment_rating_fc73d892-1336-47c5-a620-40903388332d"
            }
          ],
          "landedCosts": [
            {
              "amountSubtotals": {
                "duties": 53.67,
                "taxes": 147.89,
                "fees": 42.37,
                "shipping": 15.0
              }
            }
          ]
        }
      }
    ]
  }
}
3

Crea una spedizione

L'ultimo passo per recuperare le informazioni doganali per una spedizione è creare la spedizione stessa. Parte di questo flusso consiste nel creare il shipmentCarton che contiene i dettagli degli articoli per la spedizione necessari per il customsSpec. La shipment genererà automaticamente un oggetto doganale se passi true nel campo generateCustoms.

Mutazione

1
2
3
4
5
6
7
8
9
10
11
12
13
mutation CreateShipment($createShipment: ShipmentCreateInput!) {
  shipmentCreate(input: $createShipment) {
    id
    customSpec {
      id
    }
    shipmentCartons {
      carton {
        id
      }
    }
  }
}

Variabili

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "createShipment": {
    "orderId": "order_3a369733-3046-4390-b0a4-99a2f8a1c2a2",
    "trackingNumber": "12345",
    "generateCustoms": true,
    "parties": [
      "party_2fdf56a0-2bb2-4443-b8ca-a984d335ff3g",
      "party_5c928cde-67fa-4ee4-b77a-2628fbcd5ac9"
    ],
    "serviceLevel": "custom.custom",
    "shipmentCartons": [
      {
        "height": 10,
        "length": 10,
        "width": 10,
        "weight": 1,
        "items": ["item_8a0ecee9-42ff-4544-9610-8e8d679ef0a3"]
      }
    ]
  }
}

Risposta

1
2
3
4
5
6
7
8
9
10
{
  "data": {
    "shipmentCreate": {
      "id": "shipment_a125e480-369c-4606-abf8-ff34295b15cb",
      "customSpec": {
        "id": "customsSpec_a19875ec-b85c-11ed-afa1-0242ac120002"
      }
    }
  }
}

Questa pagina è stata utile?