Fraktetiketter | Validera ett Declaration ID

Om ni skapar postetiketter kan ni anropa Zonos för att hämta fullständiga tulldeklarationsuppgifter när en användare anger ett Declaration ID. Det eliminerar behovet av manuell ifyllnad av tulldokumentation och skapar en sömlös fraktupplevelse där tullar är förbetalda och tullformulär fylls i automatiskt.

Fyll i tulldeklarationer automatiskt 

Följ stegen nedan för att aktivera automatisk ifyllnad av tulldeklarationer med Declaration ID:n från er plattform.

1. Aktivera Declaration ID-fält i flödet för att skapa etiketter

Lägg till ett Declaration ID-fält i ert gränssnitt för att skapa postetiketter. När användare anger ett giltigt Declaration ID kan er plattform fylla i tulldeklarationen automatiskt och eliminera manuell datainmatning.

2. Fråga Declaration ID-status och tulldeklarationsuppgifter

Använd följande query för att hämta fullständiga tulldeklarationsdata med Declaration ID. Det returnerar valideringsstatus tillsammans med artikeluppgifter, värden, HS-koder och mottagarinformation när det finns tillgängligt

3. Hantera svaret och fyll i tulldeklarationen automatiskt

API-svaret innehåller valideringsstatus och tulldata. Använd status för att avgöra om Declaration ID är giltigt och fyll sedan automatiskt i tillgängliga tulldata eller be om manuell inmatning.

Exempelsvar

Giltigt Declaration ID med fullständiga tulldata:

{
  "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. Skapa sändningen

Hantera etikettskapandet med antingen automatiskt ifyllda data från ett Declaration ID eller manuellt angiven deklarationsinformation.

5. Koppla spårningsnummer till Declaration ID

Efter etikettskapande använder ni mutationen declarationShipmentCreate för att koppla spårningsnumret till Declaration ID, så att korrekt validering av tullbetalning och sändningsspårning säkerställs.

Ni kan skapa en sändning kopplad till ett Declaration ID genom att skicka en array av trackingNumbers och declarationID för sändningen.

Ni kan också skapa en sändning genom att skicka declarationID med uppgifter om kartonger och artiklar i kartongerna i shipmentCarton tillsammans med trackingNumber för den kartongen.