DOCS

Valider en deklarations-ID

HjemFor logistikudbydere Valider en deklarations-ID

Fragtetiketter | Valider en deklarations-ID

Hent status for en deklarations-ID og auto-udfyld tolddokumentation

Hvis du opretter postetiketter, kan du kalde Zonos for at hente komplette tolddeklarationsoplysninger, når en bruger angiver en deklarations-ID. Dette eliminerer behovet for, at brugerne manuelt udfylder tolddokumentation, hvilket skaber en problemfri forsendelsesoplevelse, hvor afgifter er forudbetalt, og toldformularer automatisk udfyldes.

Auto-udfyld tolddeklarationer 

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

1. Aktiver deklarations-ID-felt i etiketoprettelsesflowet

Tilføj et deklarations-ID-felt til din grænseflade til oprettelse af postetiketter. Når brugerne indtaster en gyldig deklarations-ID, kan din platform auto-udfylde tolddeklarationen, hvilket eliminerer manuel dataindtastning.

2. Forespørg deklarations-ID-status og tolddeklarationsoplysninger

Brug følgende forespørgsel til at hente komplette tolddeklarationsdata ved hjælp af deklarations-ID'en. Dette returnerer valideringsstatus sammen med vareoplysninger, værdier, HS-koder og modtagerinformation, når det er tilgængeligt.

Forespørgsel

GraphQL

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

Variabler

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Håndter svar og auto-udfyld tolddeklaration

API-svaret inkluderer valideringsstatus og tolddata. Brug status-oplysningerne til at bestemme, om deklarations-ID'et er gyldigt, og auto-udfyld derefter tilgængelige tolddata eller bed om manuel indtastning.

Eksempel svar

Gyldigt deklarations-ID med komplette tolddata:

Svar

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
{
  "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 at bruge enten automatisk udfyldte data fra en deklarations-ID eller manuelt indtastede deklarationsoplysninger.

5. Link sporingsnummer til deklarations-ID

Efter oprettelsen af etiketten, brug deklarationShipmentCreate mutation for at linke sporingsnummeret med deklarations-ID'en, hvilket sikrer korrekt validering af toldbetaling og forsendelsessporing.

Opret forsendelse

GraphQL

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

Du kan oprette en forsendelse knyttet til et deklarations-ID ved at sende et array af trackingNumbers og det declarationID, der bruges til forsendelsen.

Variabler uden kartonoplysninger

GraphQL

1
2
3
4
5
6
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "trackingNumbers": ["test_tracking_1", "test_tracking_2"]
  }
}

Du kan oprette en forsendelse ved at angive declarationID, der bruges til forsendelsen. Hvis du har oplysninger om kartonerne og varerne inden i kartonerne, kan du angive disse i shipmentCarton sammen med trackingNumber for den pågældende karton.

Variabler med kartonoplysninger

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "shipmentCartons": [
      {
        "dimensionalUnit": "INCH",
        "length": 8,
        "width": 4,
        "height": 2,
        "trackingNumber": "1234567890",
        "weight": 5,
        "weightUnit": "POUND",
        "items": [
          {
            "itemReference": "item_1",
            "quantity": 3,
            "hsCode": "1234.56.7890"
          }
        ]
      }
    ]
  }
}

Var denne side nyttig?

Book en demo

Spørgsmål?

Få support
© 2025 Zonoszonos.com
På denne side:
  • Fragtetiketter | Valider en deklarations-ID
  • Auto-udfyld tolddeklarationer