Forsendelsesetiketter | Valider et Declaration ID

Hvis du opretter postetiketter, kan du kalde Zonos for at hente fuldstændige tolddeklarationsdetaljer, når en bruger angiver et Declaration ID. Det eliminerer behovet for, at brugere manuelt skal udfylde tolddokumentation, og skaber en problemfri forsendelsesoplevelse, hvor told er forudbetalt, og toldformularer udfyldes automatisk.

Udfyld tolddeklarationer automatisk 

Følg trinene nedenfor for at aktivere automatisk udfyldning af tolddeklarationer ved hjælp af Declaration ID'er fra din platform.

1. Aktiver Declaration ID-felt i etiketoprettelsesflowet

Tilføj et Declaration ID-felt til din grænseflade til oprettelse af postetiketter. Når brugere indtaster et gyldigt Declaration ID, kan din platform udfylde tolddeklarationen automatisk og dermed eliminere manuel dataindtastning.

2. Forespørg Declaration ID-status og tolddeklarationsdetaljer

Brug følgende query til at hente fuldstændige tolddeklarationsdata ved hjælp af Declaration ID'et. Det returnerer valideringsstatus sammen med varedetaljer, værdier, HS-koder og modtageroplysninger, når de er tilgængelige

3. Håndter svar og udfyld tolddeklaration automatisk

API-svaret inkluderer valideringsstatus og tolddata. Brug status-oplysningerne til at afgøre, om Declaration ID'et er gyldigt, og udfyld derefter tilgængelige tolddata automatisk, eller bed om manuel indtastning.

Eksempelsvar

Gyldigt Declaration ID med fuldstændige tolddata:

{
  "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. Opret forsendelsen

Behandl oprettelsen af etiketten ved hjælp af enten automatisk udfyldte data fra et Declaration ID eller manuelt indtastede deklarationsoplysninger.

5. Knyt trackingnummer til Declaration ID

Efter oprettelse af etiketten skal du bruge mutationen declarationShipmentCreate til at knytte trackingnummeret til Declaration ID'et og sikre korrekt validering af toldbetaling og forsendelsessporing.

Du kan oprette en forsendelse knyttet til et Declaration ID ved at sende et array af trackingNumbers og det declarationID, der blev brugt til forsendelsen.

Du kan også oprette en forsendelse ved at sende declarationID sammen med oplysninger om kartoner og varer i kartonerne; disse kan sendes i shipmentCarton sammen med trackingNumber for den pågældende karton.