HomePer i fornitori di logistica Convalidare un ID di dichiarazione

Etichette di spedizione | Convalidare un ID di dichiarazione

Recupera lo stato di un ID 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 dichiarazione. Ciò 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 vengono compilati automaticamente.

Compilazione automatica delle dichiarazioni doganali

Segui i passaggi seguenti per abilitare il popolamento automatico delle dichiarazioni doganali utilizzando gli ID dichiarazione dalla tua piattaforma.

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

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

2. Richiedere lo stato dell'ID della dichiarazione e i dettagli della dichiarazione doganale

Utilizzare la query seguente per recuperare i dati completi della dichiarazione doganale utilizzando l'ID dichiarazione. Ciò restituisce lo stato di convalida insieme ai dettagli dell'articolo, ai valori, ai codici HS e alle informazioni sul destinatario, quando disponibili

1query DeclarationQuery($id: ID!) {

2 declaration(id: $id) {

3 id

4 status

5 paymentStatus

6 landedCost {

7 id

8 method

9 landedCostGuaranteeCode

10 amountSubtotals {

11 duties

12 taxes

13 fees

14 landedCostTotal

15 }

16 }

17 items {

18 id

19 sku

20 productId

21 amount

22 currencyCode

23 name

24 hsCode

25 description

26 hsCodeSource

27 countryOfOrigin

28 quantity

29 measurements {

30 type

31 value

32 unitOfMeasure

33 }

34 }

35 parties {

36 id

37 type

38 person {

39 firstName

40 lastName

41 email

42 phone

43 }

44 location {

45 id

46 line1

47 line2

48 countryCode

49 postalCode

50 }

51 }

52 }

53}

3. Gestire la risposta e compilare automaticamente la dichiarazione doganale

La risposta API include lo stato di convalida e i dati doganali. Usa le informazioni di status per determinare se l'ID della dichiarazione è valido, quindi compila automaticamente i dati doganali disponibili o richiedi l'immissione manuale.

Risposte di esempio

ID dichiarazione valida con dati doganali completi:

{
  "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 compilati automaticamente da un ID dichiarazione o le informazioni della dichiarazione immesse manualmente.

5. Collega il numero di tracciabilità all'ID della dichiarazione

Dopo la creazione dell'etichetta, utilizzare la mutazione declarationShipmentCreate per collegare il numero di tracciabilità all'ID dichiarazione, garantendo la corretta convalida del pagamento dei dazi e il tracciamento della spedizione.

1mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {

2 declarationShipmentCreate(input: $input)

3}

È possibile creare una spedizione legata a un ID dichiarazione passando un array di trackingNumbers e il declarationID utilizzato per la spedizione.

Puoi anche creare una spedizione passando il declarationID con i dettagli sui cartoni e sugli articoli all'interno dei cartoni; puoi passarli nel shipmentCarton insieme al trackingNumber per quel cartone.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

DeclarationShipmentCreateInput

MUTATIONS

declarationShipmentCreate

Prenota una demo