DOCS

Validar um ID de Declaração

InícioPara provedores de logística Validar um ID de Declaração

Etiquetas de envio | Validar um ID de Declaração

Recuperar o status de um ID de Declaração e preencher automaticamente a documentação aduaneira

Se você criar etiquetas postais, pode chamar Zonos para recuperar detalhes completos da declaração aduaneira quando um usuário fornecer um ID de Declaração. Isso elimina a necessidade de os usuários preencherem manualmente a documentação aduaneira, criando uma experiência de envio sem interrupções, onde os impostos são pré-pagos e os formulários aduaneiros são automaticamente preenchidos.

Preencher automaticamente declarações aduaneiras 

Siga os passos abaixo para habilitar a população automática da declaração aduaneira usando IDs de Declaração da sua plataforma.

1. Habilitar campo de ID de Declaração no fluxo de criação de etiquetas

Adicione um campo de ID de Declaração à sua interface de criação de etiquetas postais. Quando os usuários inserirem um ID de Declaração válido, sua plataforma pode preencher automaticamente a declaração aduaneira, eliminando a entrada manual de dados.

2. Consultar status do ID de Declaração e detalhes da declaração aduaneira

Use a seguinte consulta para recuperar dados completos da declaração aduaneira usando o ID de Declaração. Isso retorna o status de validação junto com detalhes dos itens, valores, códigos HS e informações do destinatário quando disponíveis.

Consulta

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
      }
    }
  }
}

Variáveis

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Lidar com a resposta e auto-preencher a declaração de impostos

A resposta da API inclui o status de validação e os dados de impostos. Use a informação de status para determinar se o ID da Declaração é válido, em seguida, auto-preencha os dados de impostos disponíveis ou solicite a entrada manual.

Exemplos de respostas

ID de Declaração Válido com dados de impostos completos:

Resposta

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. Criar o envio

Processe a criação do rótulo usando dados auto-preenchidos de um ID de Declaração ou informações de declaração inseridas manualmente.

5. Vincular o número de rastreamento ao ID da Declaração

Após a criação do rótulo, use a mutação declarationShipmentCreate para vincular o número de rastreamento ao ID da Declaração, garantindo a validação adequada do pagamento de impostos e o rastreamento do envio.

Criar envio

GraphQL

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

Você pode criar um envio vinculado a um ID de Declaração passando um array de trackingNumbers e o declarationID usado para o envio.

Variáveis sem detalhes do cartão

GraphQL

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

Você pode criar um envio passando o declarationID usado para o envio. Se você tiver detalhes sobre as caixas e os itens dentro das caixas, pode passar esses detalhes no shipmentCarton junto com o trackingNumber para essa caixa.

Variáveis com detalhes da caixa

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"
          }
        ]
      }
    ]
  }
}

Esta página foi útil?

Agendar uma demonstração

Perguntas?

Obter suporte
© 2025 Zonoszonos.com
Nesta página:
  • Etiquetas de envio | Validar um ID de Declaração
  • Preencher automaticamente declarações aduaneiras