DOCS

申告IDの検証

ホーム物流提供者向け 申告IDの検証

送料ラベル | 申告IDの検証

申告IDのステータスを取得し、税関書類を自動入力します

郵便ラベルを作成する場合、ユーザーが申告IDを提供すると、Zonosを呼び出して完全な税関申告の詳細を取得できます。これにより、ユーザーが税関書類を手動で記入する必要がなくなり、関税が前払いされ、税関フォームが自動的に入力されるシームレスな配送体験が実現します。

税関申告の自動入力 

以下の手順に従って、プラットフォームからの申告IDを使用して自動的に税関申告を入力できるようにします。

1. ラベル作成フローに申告IDフィールドを有効にする

郵便ラベル作成インターフェースに申告IDフィールドを追加します。ユーザーが有効な申告IDを入力すると、プラットフォームは税関申告を自動的に入力し、手動でのデータ入力を排除します。

2. 申告IDのステータスと税関申告の詳細を照会する

以下のクエリを使用して、申告IDを使用して完全な税関申告データを取得します。これにより、利用可能な場合は、検証ステータス、アイテムの詳細、値、HSコード、および受取人情報が返されます。

クエリ

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

変数

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. 応答を処理し、税関申告を自動入力する

APIの応答には、検証ステータスと税関データが含まれています。status情報を使用して、申告IDが有効かどうかを判断し、利用可能な税関データを自動入力するか、手動入力を促してください。

例の応答

完全な税関データを持つ有効な申告ID:

応答

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. 出荷を作成する

宣言IDから自動入力されたデータを使用するか、手動で入力された宣言情報を使用してラベル作成を処理します。

5. 追跡番号を宣言IDにリンクする

ラベル作成後、declarationShipmentCreateミューテーションを使用して追跡番号を宣言IDにリンクし、適切な関税支払いの検証と出荷追跡を確保します。

出荷を作成する

GraphQL

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

あなたは、trackingNumbers の配列と出荷に使用される declarationID を渡すことによって、宣言IDに関連付けられた出荷を作成できます。

カートンの詳細なしの変数

GraphQL

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

出荷を作成するには、出荷に使用される declarationID を渡すことができます。カートンの詳細やカートン内のアイテムに関する情報がある場合は、それらを shipmentCarton に渡し、そのカートンの trackingNumber とともに渡すことができます。

カートンの詳細を含む変数

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

このページは役に立ちましたか？

デモを予約する

質問はありますか？

サポートを受ける
© 2025 Zonoszonos.com
このページでは：
  • 送料ラベル | 申告IDの検証