Étiquettes d'expédition | Valider un Declaration ID

Si vous créez des étiquettes postales, vous pouvez appeler Zonos pour récupérer les détails complets de déclaration douanière lorsqu'un utilisateur fournit un Declaration ID. Cela élimine le besoin pour les utilisateurs de remplir manuellement la documentation douanière, créant une expérience d'expédition fluide où les droits sont prépayés et les formulaires douaniers sont automatiquement préremplis.

Préremplir les déclarations douanières 

Suivez les étapes ci-dessous pour activer le préremplissage automatique des déclarations douanières à l'aide des Declaration ID de votre plateforme.

1. Activer le champ Declaration ID dans le flux de création d'étiquette

Ajoutez un champ Declaration ID à votre interface de création d'étiquettes postales. Lorsque les utilisateurs saisissent un Declaration ID valide, votre plateforme peut préremplir la déclaration douanière, éliminant la saisie manuelle.

2. Interroger le statut du Declaration ID et les détails de déclaration douanière

Utilisez la requête suivante pour récupérer les données complètes de déclaration douanière à l'aide du Declaration ID. Cela renvoie le statut de validation ainsi que les détails d'articles, valeurs, codes SH et informations destinataire lorsqu'ils sont disponibles

3. Traiter la réponse et préremplir la déclaration douanière

La réponse API inclut le statut de validation et les données douanières. Utilisez les informations status pour déterminer si le Declaration ID est valide, puis préremplissez les données douanières disponibles ou invitez à une saisie manuelle.

Exemples de réponses

Declaration ID valide avec données douanières complètes :

{
  "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. Créer l'envoi

Traitez la création d'étiquette en utilisant soit les données préremplies d'un Declaration ID, soit les informations de déclaration saisies manuellement.

5. Lier le numéro de suivi au Declaration ID

Après la création de l'étiquette, utilisez la mutation declarationShipmentCreate pour lier le numéro de suivi au Declaration ID, garantissant la validation du paiement des droits et le suivi de l'envoi.

Vous pouvez créer un envoi lié à un Declaration ID en passant un tableau de trackingNumbers et le declarationID utilisé pour l'envoi.

Vous pouvez également créer un envoi en passant le declarationID avec les détails des colis et des articles dans les colis ; vous pouvez les transmettre dans shipmentCarton avec le trackingNumber de ce colis.