DOCS
HjemTil logistikudbydere Valider et Declaration ID

Forsendelsesetiketter | Valider et Declaration ID

Hent status for et Declaration ID og udfyld tolddokumentation automatisk

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

1query DeclarationQuery($id: ID!) {
2 declaration(id: $id) {
3 id
4 status
5 paymentStatus
6 landedCost {
7 id
8 method
9 landedCostGuaranteeCode
10 amountSubtotals {
11 duties
12 taxes
13 fees
14 landedCostTotal
15 }
16 }
17 items {
18 id
19 sku
20 productId
21 amount
22 currencyCode
23 name
24 hsCode
25 description
26 hsCodeSource
27 countryOfOrigin
28 quantity
29 measurements {
30 type
31 value
32 unitOfMeasure
33 }
34 }
35 parties {
36 id
37 type
38 person {
39 firstName
40 lastName
41 email
42 phone
43 }
44 location {
45 id
46 line1
47 line2
48 countryCode
49 postalCode
50 }
51 }
52 }
53}

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.

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

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.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

DeclarationShipmentCreateInput

MUTATIONS

declarationShipmentCreate

Var denne side nyttig?

Få support·Juridiske dokumenter·© 2026 Zonos
På denne side:
  • Forsendelsesetiketter | Valider et Declaration ID
  • Udfyld tolddeklarationer automatisk