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

Se você criar etiquetas postais, poderá chamar a Zonos para obter detalhes completos da declaração alfandegária quando um usuário fornecer um ID de declaração. Isso elimina a necessidade de os usuários preencherem manualmente a documentação alfandegária, criando uma experiência de remessa perfeita, onde as taxas são pré-pagas e os formulários alfandegários são preenchidos automaticamente.

Preencher automaticamente declarações alfandegárias 

Siga os passos abaixo para ativar o preenchimento automático de declarações aduaneiras usando o ID da declaração da sua plataforma.

1. Habilite o campo ID da declaração no fluxo de criação de etiquetas

Adicione um campo de ID de declaração à interface de criação de etiqueta postal. Quando os usuários inserem um ID de declaração válido, sua plataforma pode preencher automaticamente a declaração alfandegária, eliminando a entrada manual de dados.

2. Verifique o status do ID da declaração e os detalhes da declaração aduaneira

Use a consulta a seguir para obter os dados completos da declaração alfandegária usando o ID da declaração. Isso retorna o status de validação junto com detalhes do item, valores, códigos HS e informações do destinatário, quando disponíveis

3. Processar a resposta e preencher automaticamente a declaração aduaneira

A resposta API inclui status de validação e dados alfandegários. Utilize as informações de status para determinar se o ID da declaração é válido, preencha automaticamente os dados alfandegários disponíveis ou solicite a entrada manual.

Exemplos de respostas

ID de declaração válida com dados alfandegários completos:

{
  "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. Crie a remessa

Processe a criação de etiquetas usando dados preenchidos automaticamente de um ID de declaração ou informações de declaração inseridas manualmente.

5. Vincule o número de rastreamento ao ID da declaração

Depois de criar a etiqueta, use a mutação declarationShipmentCreate para vincular o número de rastreamento ao ID da declaração, garantindo a validação adequada do pagamento dos impostos e do rastreamento da remessa.

Você pode criar uma remessa vinculada a um ID de declaração passando uma matriz de trackingNumbers e o declarationID usado para envio.

Você também pode criar uma remessa passando o declarationID com detalhes sobre as caixas e os itens dentro delas; você pode informar esses detalhes em shipmentCarton, junto com o trackingNumber daquela caixa.