DOCS

Validera en deklarations-ID

HemFör logistikleverantörer Validera en deklarations-ID

Fraktetiketter | Validera en deklarations-ID

Hämta status för en deklarations-ID och autofyll tulldokumentation

Om du skapar postetiketter kan du anropa Zonos för att hämta kompletta tulldeklarationsdetaljer när en användare anger en deklarations-ID. Detta eliminerar behovet för användare att manuellt fylla i tulldokumentation, vilket skapar en sömlös fraktupplevelse där avgifter är förbetalda och tullformulär automatiskt fylls i.

Autofyll tulldeklarationer 

Följ stegen nedan för att aktivera automatisk ifyllning av tulldeklarationer med hjälp av deklarations-ID från din plattform.

1. Aktivera deklarations-ID-fält i etikettens skapelseflöde

Lägg till ett deklarations-ID-fält i din postetikettens skapelsegränssnitt. När användare anger en giltig deklarations-ID kan din plattform autofylla tulldeklarationen, vilket eliminerar manuell datainmatning.

2. Fråga deklarations-ID-status och tulldeklarationsdetaljer

Använd följande fråga för att hämta kompletta tulldeklarationsdata med hjälp av deklarations-ID. Detta returnerar valideringsstatus tillsammans med artikelinformation, värden, HS-koder och mottagarinformation när det är tillgängligt.

Fråga

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. Hantera svar och automatiskt fyll i tulldeklaration

API-svaret inkluderar valideringsstatus och tullinformation. Använd status-informationen för att avgöra om deklarations-ID:t är giltigt, och fyll sedan automatiskt i tillgänglig tullinformation eller be om manuell inmatning.

Exempel på svar

Giltigt deklarations-ID med fullständig tullinformation:

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. Skapa frakten

Bearbeta skapandet av etiketten med antingen automatiskt ifylld data från ett deklarations-ID eller manuellt inmatad deklarationsinformation.

5. Koppla spårningsnummer till deklarations-ID

Efter skapandet av etiketten, använd mutation för declarationShipmentCreate för att koppla spårningsnumret med deklarations-ID:t, vilket säkerställer korrekt validering av tullbetalning och spårning av frakten.

Skapa frakt

GraphQL

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

Du kan skapa en försändelse kopplad till ett deklarations-ID genom att skicka en array av trackingNumbers och det declarationID som används för försändelsen.

Variabler utan kartongdetaljer

GraphQL

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

Du kan skapa en försändelse genom att skicka declarationID som används för försändelsen. Om du har detaljer om kartongerna och artiklarna inom kartongerna kan du skicka dessa i shipmentCarton tillsammans med trackingNumber för den kartongen.

Variabler med kartongdetaljer

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 den här sidan till hjälp?

Boka en demo

Frågor?

Få support
© 2025 Zonoszonos.com
På den här sidan:
  • Fraktetiketter | Validera en deklarations-ID
  • Autofyll tulldeklarationer