DOCS

Validieren Sie eine Deklarations-ID

StartseiteFür Logistikdienstleister Validieren Sie eine Deklarations-ID

Versandetiketten | Validieren Sie eine Deklarations-ID

Rufen Sie den Status einer Deklarations-ID ab und füllen Sie die Zollunterlagen automatisch aus

Wenn Sie Versandetiketten erstellen, können Sie Zonos aufrufen, um vollständige Zollanmeldedetails abzurufen, wenn ein Benutzer eine Deklarations-ID angibt. Dies beseitigt die Notwendigkeit für Benutzer, die Zollunterlagen manuell auszufüllen, und schafft ein nahtloses Versand-Erlebnis, bei dem die Zölle im Voraus bezahlt werden und die Zollformulare automatisch ausgefüllt werden.

Automatisches Ausfüllen von Zollanmeldungen 

Befolgen Sie die folgenden Schritte, um die automatische Ausfüllung von Zollanmeldungen mithilfe von Deklarations-IDs von Ihrer Plattform zu aktivieren.

1. Aktivieren Sie das Feld für die Deklarations-ID im Etikettenerstellungsprozess

Fügen Sie ein Feld für die Deklarations-ID in Ihre Benutzeroberfläche zur Erstellung von Versandetiketten ein. Wenn Benutzer eine gültige Deklarations-ID eingeben, kann Ihre Plattform die Zollanmeldung automatisch ausfüllen und die manuelle Dateneingabe eliminieren.

2. Abfragen des Deklarations-ID-Status und der Zollanmeldedetails

Verwenden Sie die folgende Abfrage, um vollständige Zollanmeldedaten mithilfe der Deklarations-ID abzurufen. Dies gibt den Validierungsstatus sowie Artikelinformationen, Werte, HS-Codes und Empfängerinformationen zurück, wenn verfügbar.

Abfrage

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
      }
    }
  }
}

Variablen

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Bearbeiten Sie die Antwort und füllen Sie die Zollanmeldung automatisch aus

Die API-Antwort enthält den Validierungsstatus und Zollinformationen. Verwenden Sie die status-Informationen, um zu bestimmen, ob die Deklarations-ID gültig ist, und füllen Sie dann die verfügbaren Zollinformationen automatisch aus oder fordern Sie die manuelle Eingabe an.

Beispielantworten

Gültige Deklarations-ID mit vollständigen Zollinformationen:

Antwort

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. Erstellen Sie den Versand

Verarbeiten Sie die Erstellung des Etiketts entweder mit automatisch ausgefüllten Daten aus einer Deklarations-ID oder manuell eingegebenen Deklarationsinformationen.

5. Verknüpfen Sie die Sendungsverfolgungsnummer mit der Deklarations-ID

Nach der Erstellung des Etiketts verwenden Sie die mutation declarationShipmentCreate, um die Sendungsverfolgungsnummer mit der Deklarations-ID zu verknüpfen, um eine ordnungsgemäße Validierung der Zollgebührenzahlung und die Sendungsverfolgung sicherzustellen.

Versand erstellen

GraphQL

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

Sie können eine Sendung, die an eine Deklarations-ID gebunden ist, erstellen, indem Sie ein Array von trackingNumbers und die für die Sendung verwendete declarationID übergeben.

Variablen ohne Kartondetails

GraphQL

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

Sie können eine Sendung erstellen, indem Sie die declarationID übergeben, die für die Sendung verwendet wird. Wenn Sie Details zu den Kartons und den darin enthaltenen Artikeln haben, können Sie diese im shipmentCarton zusammen mit der trackingNumber für diesen Karton übergeben.

Variablen mit Kartondetails

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"
          }
        ]
      }
    ]
  }
}

War diese Seite hilfreich?

Buchen Sie eine Demo
© 2025 Zonoszonos.com
Auf dieser Seite:
  • Versandetiketten | Validieren Sie eine Deklarations-ID
  • Automatisches Ausfüllen von Zollanmeldungen