配送ラベル | Declaration ID を検証する

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

税関申告の自動入力 

プラットフォームから Declaration ID を使用して税関申告の自動入力を有効にするには、以下の手順に従ってください。

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

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

2. Declaration ID ステータスと税関申告の詳細を問い合わせる

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

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

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

応答例

完全な税関データを含む有効な Declaration ID:

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

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

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

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

出荷に使用される trackingNumbers と declarationID の配列を渡すことにより、Declaration ID に関連付けられた出荷を作成できます。

また、カートンに関する詳細を含む declarationID を渡して出荷を作成することもできます。カートン内のアイテムは、そのカートンの trackingNumber とともに shipmentCarton で渡すことができます。