Etiquetas de envío | Validar un Declaration ID

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

Completar automáticamente declaraciones aduaneras 

Siga los pasos a continuación para habilitar el llenado automático de declaraciones aduaneras usando Declaration ID de su plataforma.

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

Agregue un campo Declaration ID a su interfaz de creación de etiquetas postales. Cuando los usuarios ingresen un Declaration ID válido, su plataforma puede completar automáticamente la declaración aduanera, eliminando la entrada manual de datos.

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

Use la siguiente consulta para obtener los datos completos de la declaración aduanera usando el Declaration ID. Esto devuelve el estado de validación junto con detalles de artículos, valores, códigos HS e información del destinatario cuando esté disponible

3. Manejar la respuesta y completar automáticamente la declaración aduanera

La respuesta de la API incluye el estado de validación y los datos aduaneros. Use la información de status para determinar si el Declaration ID es válido, luego complete automáticamente los datos aduaneros disponibles o solicite entrada manual.

Respuestas de ejemplo

Declaration ID válido con datos aduaneros 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. Crear el envío

Procese la creación de la etiqueta usando datos completados automáticamente de un Declaration ID o información de declaración ingresada manualmente.

5. Vincular el número de seguimiento al Declaration ID

Después de crear la etiqueta, use la mutación declarationShipmentCreate para vincular el número de seguimiento con el Declaration ID, asegurando la validación adecuada del pago de aranceles y el seguimiento del envío.

Puede crear un envío vinculado a un Declaration ID pasando un array de trackingNumbers y el declarationID utilizado para el envío.

También puede crear un envío pasando el declarationID con detalles sobre los cartones y los artículos dentro de los cartones; puede pasarlos en shipmentCarton junto con el trackingNumber de ese cartón.