DOCS

Valida un ID di Dichiarazione

HomePer i fornitori di logistica Valida un ID di Dichiarazione

Etichette di spedizione | Valida un ID di Dichiarazione

Recupera lo stato di un ID di Dichiarazione e compila automaticamente la documentazione doganale

Se crei etichette postali, puoi chiamare Zonos per recuperare i dettagli completi della dichiarazione doganale quando un utente fornisce un ID di Dichiarazione. Questo elimina la necessità per gli utenti di compilare manualmente la documentazione doganale, creando un'esperienza di spedizione fluida in cui i dazi sono prepagati e i moduli doganali sono automaticamente popolati.

Compilazione automatica delle dichiarazioni doganali 

Segui i passaggi seguenti per abilitare la popolazione automatica delle dichiarazioni doganali utilizzando gli ID di Dichiarazione dalla tua piattaforma.

1. Abilita il campo ID di Dichiarazione nel flusso di creazione dell'etichetta

Aggiungi un campo ID di Dichiarazione alla tua interfaccia di creazione delle etichette postali. Quando gli utenti inseriscono un ID di Dichiarazione valido, la tua piattaforma può compilare automaticamente la dichiarazione doganale, eliminando l'inserimento manuale dei dati.

2. Interroga lo stato dell'ID di Dichiarazione e i dettagli della dichiarazione doganale

Utilizza la seguente query per recuperare i dati completi della dichiarazione doganale utilizzando l'ID di Dichiarazione. Questo restituisce lo stato di validazione insieme ai dettagli degli articoli, valori, codici HS e informazioni sul destinatario quando disponibili.

Query

GraphQL

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
query DeclarationQuery($id: ID!) {
  declaration(id: $id) {
    id
    status
    paymentStatus
    landedCost {
      id
      method
      landedCostGuaranteeCode
      amountSubtotals {
        duties
        taxes
        fees
        landedCostTotal
      }
    }
    items {
      id
      sku
      productId
      amount
      currencyCode
      name
      hsCode
      description
      hsCodeSource
      countryOfOrigin
      quantity
      measurements {
        type
        value
        unitOfMeasure
      }
    }
    parties {
      id
      type
      person {
        firstName
        lastName
        email
        phone
      }
      location {
        id
        line1
        line2
        countryCode
        postalCode
      }
    }
  }
}

Variabili

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Gestire la risposta e auto-compilare la dichiarazione doganale

La risposta dell'API include lo stato di validazione e i dati doganali. Utilizza le informazioni sul status per determinare se l'ID della dichiarazione è valido, quindi auto-compila i dati doganali disponibili o richiedi l'inserimento manuale.

Esempi di risposte

ID dichiarazione valido con dati doganali completi:

Risposta

JSON

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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
{
  "data": {
    "declaration": {
      "id": "0mm1993s0mdcn",
      "status": "OPEN",
      "paymentStatus": "OPEN",
      "landedCost": {
        "id": "landed_cost_eabb13ab-df23-45df-9ce8-96dd29d396d1",
        "method": "DAP",
        "landedCostGuaranteeCode": "NOT_APPLICABLE",
        "amountSubtotals": {
          "duties": 0.0,
          "taxes": 0.0,
          "fees": 2.62,
          "landedCostTotal": 2.62
        }
      },
      "items": [
        {
          "id": "item_0mm199388v57g",
          "sku": "item_1",
          "productId": "item_1",
          "amount": 70.0,
          "currencyCode": "USD",
          "name": "Item 1",
          "hsCode": "9504.90.4000",
          "description": "This is the description for Item 1",
          "hsCodeSource": "TARIFF_COMPLETED",
          "countryOfOrigin": "CN",
          "quantity": 2,
          "measurements": [
            {
              "type": "WEIGHT",
              "value": 1,
              "unitOfMeasure": "POUND"
            }
          ]
        }
      ],
      "parties": [
        {
          "id": "party_0kesb32rw5hfa",
          "type": "DESTINATION",
          "person": {
            "firstName": "test",
            "lastName": "origin",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_c7882546-652e-49cb-81a4-98962a54c49f",
            "line1": "123 Test Street",
            "line2": "",
            "countryCode": "US",
            "postalCode": "84790"
          }
        },
        {
          "id": "party_0mjfz59bgg175",
          "type": "ORIGIN",
          "person": {
            "firstName": "test",
            "lastName": "destination",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_0mdzb9vk8bp7c",
            "line1": "998 Ridgehaven",
            "line2": null,
            "countryCode": "CA",
            "postalCode": "N0N 0N0"
          }
        }
      ]
    }
  }
}

4. Crea la spedizione

Elabora la creazione dell'etichetta utilizzando i dati auto-compilati da un ID di dichiarazione o informazioni di dichiarazione inserite manualmente.

5. Collega il numero di tracciamento all'ID di dichiarazione

Dopo la creazione dell'etichetta, utilizza la mutazione declarationShipmentCreate per collegare il numero di tracciamento con l'ID di dichiarazione, garantendo una corretta validazione del pagamento dei dazi e il tracciamento della spedizione.

Crea spedizione

GraphQL

1
2
3
mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {
  declarationShipmentCreate(input: $input)
}

Puoi creare una spedizione legata a un ID di Dichiarazione passando un array di trackingNumbers e l'declarationID utilizzato per la spedizione.

Variabili senza dettagli del cartone

GraphQL

1
2
3
4
5
6
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "trackingNumbers": ["test_tracking_1", "test_tracking_2"]
  }
}

Puoi creare una spedizione passando il declarationID utilizzato per la spedizione. Se hai dettagli sui cartoni e sugli articoli all'interno dei cartoni, puoi passarli nel shipmentCarton insieme al trackingNumber per quel cartone.

Variabili con dettagli del cartone

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "shipmentCartons": [
      {
        "dimensionalUnit": "INCH",
        "length": 8,
        "width": 4,
        "height": 2,
        "trackingNumber": "1234567890",
        "weight": 5,
        "weightUnit": "POUND",
        "items": [
          {
            "itemReference": "item_1",
            "quantity": 3,
            "hsCode": "1234.56.7890"
          }
        ]
      }
    ]
  }
}

Questa pagina è stata utile?

Prenota una demo
© 2025 Zonoszonos.com
In questa pagina:
  • Etichette di spedizione | Valida un ID di Dichiarazione
  • Compilazione automatica delle dichiarazioni doganali