アカウントキーの仕組み
Zonosのアカウントキーを持つ組織は、ラベル作成中に宣言IDを動的に生成でき、シームレスな配送体験を提供しながら関税支払いのコンプライアンスを確保します。
組織は、Zonosとの特定の使用ケースおよび関係に基づいて、Zonosダッシュボードを通じてアカウントキーを取得できます。
アカウントキーを使用して宣言IDを生成する
アカウントキーを持つ組織は、Zonos APIを通じて出荷のために個別の宣言IDを動的に生成できます。このプロセスにより、ユーザーが手動で宣言IDを入力することなく、自動的に関税を徴収できます。
出荷の詳細なしに宣言IDを生成するために、次のGraphQLミューテーションを使用します。
リクエスト
GraphQL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
declarationCreate(input: $input) {
id
status
paymentStatus
source
organizationId
parties {
id
}
items {
id
}
landedCost {
id
currencyCode
}
}
}
変数
JSON
1
2
3
4
5
{
"input": {
"source": "POST"
}
}
応答
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"data": {
"declarationCreate": {
"id": "0mm32wfyrn5es",
"status": "OPEN",
"paymentStatus": "OPEN",
"source": "POST",
"organizationId": "organization_test",
"parties": [],
"items": [],
"landedCost": null
}
}
}
アカウントキーの作成
郵便事業者および配送プラットフォームのためのアカウントキーを通じて宣言IDを作成する
アカウントキーは、承認された組織がユーザーのために各出荷ごとに個別の宣言IDを必要とせずに、関税をcollectすることを可能にするユニークな認証資格情報（APIキーに似ています）です。アカウントキーは手動での関税徴収の必要を排除し、郵便のDDP要件に対する自動請求とコンプライアンスを可能にします。
アカウントキーは、関税の支払いに対して最終的に責任を負う当事者を表します。たとえば、配送プラットフォームが独自のアカウントキーを取得したい場合、このキーを使用してユーザーのために宣言IDを生成できます。この場合、配送プラットフォームはユーザーから関税をcollectし、Zonosはそのアカウントキーから生成された宣言IDに基づいて配送プラットフォームに関税を請求します。