DOCS

Validar un ID de Declaración

InicioPara proveedores de logística Validar un ID de Declaración

Etiquetas de envío | Validar un ID de Declaración

Recuperar el estado de un ID de Declaración y autocompletar la documentación aduanera

Si creas etiquetas postales, puedes llamar a Zonos para recuperar los detalles completos de la declaración aduanera cuando un usuario proporciona un ID de Declaración. Esto elimina la necesidad de que los usuarios completen manualmente la documentación aduanera, creando una experiencia de envío fluida donde los derechos son prepagados y los formularios aduaneros se completan automáticamente.

Autocompletar declaraciones aduaneras 

Sigue los pasos a continuación para habilitar la población automática de declaraciones aduaneras utilizando IDs de Declaración de tu plataforma.

1. Habilitar el campo de ID de Declaración en el flujo de creación de etiquetas

Agrega un campo de ID de Declaración a tu interfaz de creación de etiquetas postales. Cuando los usuarios ingresen un ID de Declaración válido, tu plataforma puede autocompletar la declaración aduanera, eliminando la entrada manual de datos.

2. Consultar el estado del ID de Declaración y los detalles de la declaración aduanera

Utiliza la siguiente consulta para recuperar los datos completos de la declaración aduanera utilizando el ID de Declaración. Esto devuelve el estado de validación junto con los detalles del artículo, valores, códigos HS e información del destinatario cuando esté disponible.

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

Variables

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Manejar la respuesta y autocompletar la declaración de aduanas

La respuesta de la API incluye el estado de validación y los datos de aduanas. Utilice la información de status para determinar si el ID de la declaración es válido, luego autocompletar los datos de aduanas disponibles o solicitar la entrada manual.

Ejemplos de respuestas

ID de declaración válido con datos de aduanas completos:

Respuesta

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. Crear el envío

Procese la creación de la etiqueta utilizando datos autocompletados de un ID de Declaración o información de declaración ingresada manualmente.

5. Vincular el número de seguimiento al ID de Declaración

Después de la creación de la etiqueta, utilice la mutación declarationShipmentCreate para vincular el número de seguimiento con el ID de Declaración, asegurando la validación adecuada del pago de derechos e el seguimiento del envío.

Crear envío

GraphQL

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

Puedes crear un envío vinculado a un ID de Declaración pasando un array de trackingNumbers y el declarationID utilizado para el envío.

Variables sin detalles de cartón

GraphQL

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

Puedes crear un envío pasando el declarationID utilizado para el envío. Si tienes detalles sobre los cartones y los artículos dentro de los cartones, puedes pasarlos en el shipmentCarton junto con el trackingNumber para ese cartón.

Variables con detalles del cartón

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

¿Fue útil esta página?

Reservar una demostración

¿Preguntas?

Obtener soporte
© 2025 Zonoszonos.com
En esta página:
  • Etiquetas de envío | Validar un ID de Declaración
  • Autocompletar declaraciones aduaneras