リクエストの準備
landed cost APIを計算するには、いくつかの入力が必要であり、これをワークフローに整理しました。完了すると、出荷先、カート内のアイテム、および出荷の詳細に基づいてlanded costを返す単一のリクエストを行うことができます。
各ワークフローには、それぞれ必要な入力があります。GraphQLでは、必要以上のデータを渡すことができますが、landed costを返すために必要なフィールドは限られています。これらは、すべての可能なフィールドを確認するために、私たちAPIリファレンスに明確にマークされています。
計算を保証したい場合は、一部のフィールドが条件付きで必要であることに注意してください。
以下に、保証されたlanded costを計算するために必要なすべてのフィールドを示します。この情報がリクエストを行う前に含まれていることを確認してください。
保証された計算のための必要な入力
partyCreateWorkflowInputpartyCreateWorkflowInputは、関与する当事者とその所在地を特定します。完全なスキーマは、私たちのGraphQL APIリファレンスで確認できます。必要なフィールドは以下の通りです：
locationadministrativeAreaCode: 州または州のコード（2文字）。CAおよびBRの場合のみ必要です。countryCode: 国の2文字ISOコード。line1: 住所の最初の行。postalCode: 住所の郵便番号またはZIPコード。
personemail: 人のメールアドレス。firstName: 人の名。lastName: 人の姓。phone: 人の電話番号。
typeDESTINATION: 出荷先のためのlocationおよびperson情報。ORIGIN: 出荷元のためのlocation情報。出荷元に関連するpersonは必要ありません。
itemCreateWorkflowInputitemCreateWorkflowInputは、カート内のアイテムをリストします。多くのオプションフィールドがあります（すべての可能性は私たちAPIリファレンスで確認できます）が、以下のフィールドは必須です。
amount: アイテムの価格。currencyCode: アイテム金額の通貨コード。quantity: アイテムの数量。- 次のいずれか（あなたアイテムキーの優先度として設定されているもの）。アイテムキーは、カタログに保存された情報をカート内のアイテムに接続し、ラベル作成時に使用されます。
productId: アイテムの製品ID。sku: アイテムのSKU。
measurements（WEIGHT、LENGTH、WIDTH、HEIGHT）は、出荷評価を取得する際にアイテムカートン化したい場合にのみ必要です。
cartonsCreateWorkflowInputcartonsCreateWorkflowInputは、入力自体のみが必要です。完全なスキーマは、私たちのGraphQL APIリファレンスで確認して、渡すことができるすべての値を確認してください。Zonosが送料を計算する場合、カートンの寸法と重量を渡すことが重要です。
shipmentRatingCreateWorkflowInputこのワークフローは、すでに出荷サービスとコストを知っている場合に使用されます。Zonosに有効にしたサービスのコストを計算させたい場合は、このワークフローを交換し、shipmentRatingCalculateWorkflowを使用してください。
shipmentRatingCreateWorkflowInputは、出荷コストを伝えます。完全なスキーマは、私たちのGraphQL APIリファレンスで確認できます。必要なフィールドは以下の通りです：
amount: 出荷コスト。currencyCode: 出荷コストの通貨コード。serviceLevelCode: 出荷評価に使用される出荷サービスレベルを示すコード。
landedCostWorkflowInputlandedCostWorkflowInputは、landed cost計算のための優先設定を決定します。完全なスキーマは、私たちのGraphQL APIリファレンスで確認できます。必要なフィールドは以下の通りです：
calculationMethod: 出荷方法の優先設定を示します：DDP（前払いの関税および税金）またはDAP（関税および税金が配達時に支払われるか、リメittanceスキームが適用される場合は税IDを介して支払われる）。- landed cost保証を使用する場合、この値は常に
DDP_PREFERREDであるべきです。これは、可能な場合はDDP見積もりを提供し、DDPが許可されていない場合はDAP見積もりを提供します。代わりにDAPを使用すると、通常、配達時に支払われる関税および税金が発生するため、ランデッドコストが保証されなくなる可能性があります。
- landed cost保証を使用する場合、この値は常に
endUse: 商品が他のビジネスに販売されるか（FOR_RESALE）、消費者との最終使用のためであるか（NOT_FOR_RESALE）を示します。tariffRate: この見積もりのためにZonosが関税率を計算するために使用すべき方法を示します。適用可能な関税率の範囲がある場合。*landed cost保証を使用する場合、これは常にZONOS_PREFERREDであるべきです。
計算された送料を追加: Zonosに送料を計算させたい場合は、
shipmentRatingCreateWorkflowをshipmentRatingCalculateWorkflowに置き換えます。Zonosアイテムをカートンに分けるようにしたい場合は、cartonizeWorkflowを追加します寸法重量に使用されます）。
HSコードと配送オプション
GraphQLは、リクエストを好みに合わせてカスタマイズする柔軟性を提供します。リクエストHSコードと配送コストを含める方法にはいくつかのオプションがあります。
HSコード
HSコードは関税率に影響を与えるため、必要です。各アイテムのHSコードを渡すか、Classifyに生成させることができます。
Zonosは、製品固有のHSコードを使用することを強くお勧めします。これにより、より正確なlanded costの見積もりが得られます。HSコードを知っている場合は、itemCreateWorkflow中に各itemのhsCodeを渡してください。
HSコードを渡すと、Zonosはlanded costの見積もりを取得する際にその場で検証します。提供されたHSコードが無効（存在しないことを意味する）場合、Zonosはその場でアイテム再-classifyし、新しい有効なHSコードを使用します。
製品のHSコードの生成に関してサポートが必要な場合はZonos Classifyについて学び分類をリクエストする方法を確認してください。
ZonosにhsCodeを渡さない場合、まZonosカタログを確認し、アイテムに保存されているHSコードがあるかどうかを確認します。ない場合はClassifyを呼び出して、次のitemCreateWorkflow製品詳細フィールドに基づいてlanded cost計算を行うための分類を生成します：description、category、およびmaterial。製品詳細フィールドがClassify's信頼度スコアに基づいて分類を生成するのに十分な詳細でない場合、ストアに割り当てられデフォルトのHSコードが使用されます。
配送コスト
配送サービスレベルとそのコストは関税、税金、および手数料に影響を与えるため、必要です。Zonosは配送を計算することができますし、あなたがこれを渡すこともできます。
Zonosに配送コストを計算させるには、shipmentRatingCalculateWorkflowを使用します。計算された配送応答で返される配送オプションはDashboardで配送プロファイルに割り当てたserviceLevelsと関連付けられます。
トラブルシューティング: 応答に
serviceLevelが期待されるが表示されない場合は、serviceLevelが有効であり、選択したmethodでサポートされていることを確認してください。
Zonosに配送コストを見つける前にアイテムカートンに仕分けさせたい場合は、cartonizeWorkflow（入力なし）を追加します寸法重量に使用）。
配送のserviceLevelとamountを知っている場合は、リクエストのshipmentRatingCreateWorkflow部分にそれらを渡すことができます。これらの値を使用して関連するキャリア料金を計算し、応答に返します。
APIを介してlanded costをリクエスト
必要な入力データを取得したら、選択したクライアントライブラリまたはツールを使用してAPIエンドポイントにGraphQLミューテーションを送信します。ミューテーションを構成する方法の例を以下に示します。
このリクエストは、ZonosがLanded Costリクエストの一部として配送コストを計算する場合に使用します。その後、配送先の国によって課される場合、配送に関する関税と税金を計算します。
Mutation
mutation CalculateLandedCostWithShipping(
$parties: [PartyCreateWorkflowInput!]!
$items: [ItemCreateWorkflowInput!]!
$landedCostConfig: LandedCostWorkflowInput!
) {
partyCreateWorkflow(input: $parties) {
type
id
organization
}
itemCreateWorkflow(input: $items) {
id
amount
}
cartonizeWorkflow {
id
type
items {
item {
id
}
}
}
shipmentRatingCalculateWorkflow {
id
amount
}
landedCostCalculateWorkflow(input: $landedCostConfig) {
id
duties {
amount
currency
}
taxes {
amount
currency
}
fees {
amount
currency
}
}
}
変数
{
"parties": [
{
"location": {
"administrativeArea": "Utah",
"administrativeAreaCode": "UT",
"countryCode": "US",
"line1": "345 N 2450 E",
"line2": "#151",
"locality": "St George",
"postalCode": "84790"
},
"type": "ORIGIN"
},
{
"location": {
"administrativeArea": "BC",
"administrativeAreaCode": "BC",
"countryCode": "CA",
"line1": "27 Sussex Dr.",
"locality": "Victoria",
"postalCode": "V8T 2V9"
},
"person": {
"email": "test@gmail.com",
"firstName": "firstName",
"lastName": "lastName",
"phone": "5022303021",
"companyName": "goProTest",
"metadata": { "key": "key", "value": "value" }
},
"type": "DESTINATION"
},
{
"type": "PAYOR",
"location": {
"administrativeArea": "ON",
"administrativeAreaCode": "ON",
"countryCode": "CA",
"latitude": 1.2,
"line1": "asdf",
"line2": "asdf",
"locality": "locality",
"longitude": 3423.2,
"postalCode": "M4C 1A1"
},
"person": {
"email": "test@gmail.com",
"firstName": "firstName",
"lastName": "lastName",
"phone": "5022303021",
"companyName": "goProTest",
"metadata": { "key": "key", "value": "value" }
}
}
],
"items": [
{
"amount": 69,
"currencyCode": "USD",
"countryOfOrigin": "US",
"quantity": 1,
"productId": "productId",
"hsCode": "1006.30",
"description": "description",
"measurements": [
{ "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
{ "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
]
},
{
"amount": 62,
"currencyCode": "CAD",
"countryOfOrigin": "US",
"hsCode": "1006.30",
"quantity": 1,
"productId": "productId2",
"description": "description2",
"measurements": [
{ "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
{ "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
]
}
],
"landedCostConfig": {
"endUse": "FOR_RESALE",
"method": "DAP",
"tariffRate": "ZONOS_PREFERRED"
}
}
応答
{
"data": {
"partyCreateWorkflow": [
{
"type": "ORIGIN",
"id": "party_749959ae-b9ff-4de4-b4ac-59cc990c53ba",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
},
{
"type": "DESTINATION",
"id": "party_cd7ff245-76b6-464f-a7bf-151ebe1f8833",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
},
{
"type": "PAYOR",
"id": "party_00e63a9e-9735-44d9-b129-3b3e76c5df25",
"organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
}
],
"itemCreateWorkflow": [
{
"id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e",
"amount": 69
},
{
"id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115",
"amount": 62
}
],
"cartonizeWorkflow": [
{
"id": "carton_b34b29c1-ce27-464b-b91b-df8e4a696312",
"type": "PACKAGE",
"items": [
{
"item": {
"id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e"
}
},
{
"item": {
"id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115"
}
}
]
}
],
"shipmentRatingCalculateWorkflow": [
{
"id": "shipment_rating_96787309-9510-43cc-b4fa-c341ff80f4cc",
"amount": 173.2
},
{
"id": "shipment_rating_b0ccb109-7794-4c7c-b5cc-e2cfbbc5c8ac",
"amount": 190.1
}
],
"landedCostCalculateWorkflow": [
{
"id": "landed_cost_74d3ce11-bff2-4326-9e6f-368e03ac88b4",
"duties": [
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"taxes": [
{
"amount": 3.45,
"currency": "USD"
},
{
"amount": 3.1,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"fees": [
{
"amount": 0.13,
"currency": "USD"
},
{
"amount": 1.44,
"currency": "USD"
}
]
},
{
"id": "landed_cost_7bbfd354-028c-457f-8c8e-c81bb8fa09a0",
"duties": [
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"taxes": [
{
"amount": 3.45,
"currency": "USD"
},
{
"amount": 3.1,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
},
{
"amount": 0.0,
"currency": "USD"
}
],
"fees": [
{
"amount": 0.13,
"currency": "USD"
},
{
"amount": 1.44,
"currency": "USD"
}
]
}
]
}
}
ダッシュボードでのlanded costのリクエスト
APIを使用せずにZonos ダッシュボードで直接、着地コストを計算することもできます。これは、計算のテスト、チームのトレーニング、または顧客の問い合わせに対する迅速な見積もりを取得するのに役立ちます。
ダッシュボードは、上記で説明したのと同じAPIエンドポイントを使用しているため、結果は直接API呼び出しから得られるものと一致します。これにより、API統合の検証や、異なる入力が計算にどのように影響するかを探るのに最適な方法となります。
ダッシュボード計算機の使用
ダッシュボードのlanded cost計算機を使用すると、計算された送料で見積もりを取得したり、既知の送料で見積もりを作成したり、複数の見積もりを一括処理したりできます。
配送サービスレベルとコストがわかっている場合は、このフローを使用します。
- ダッシュボード → 注文 → **見積もり**に移動します
- 新しい見積もりをクリックします
- オプション — 発送元住所の場所を変更します
- ドロップダウンから宛先国を選択します
- 送料を入力します
- サービスレベルはオプションです; 追加すると、適用される運送業者の手数料を計算できます
- 発送のアイテム詳細を追加します
- 説明を入力すると、当社は自動的にclassify製品を分類し、HSコードを生成します
- 必要に応じて生成されたHSコードを上書きできます
- 複数のアイテムの場合は、保存して別のアイテムを追加をクリックします。そうでない場合は、保存をクリックします
- オプション — 詳細オプションをクリックして変更します:
- 販売タイプを再販用に変更
- 配送モードを配送料未払いに変更
- 見積もりを取得をクリックします
- 変更を加えるには、フォームを編集をクリックして詳細を修正します
- 再度見積もりを取得をクリックして更新します
右側にlanded costの見積もりが表示され、製品、送料、輸入コストが含まれます。見積もりを展開して、アイテム、送料、関税、税金、手数料の詳細な内訳を確認できます。すべての見積もりは、将来の参照のために見積もりページに保存されます。
既存の見積もりを編集: 上部右側の再見積もりをクリックして、最初から始めるのではなく、既存の見積もりを修正します。
ダッシュボードを使用する利点
- コーディング不要 — ユーザーフレンドリーなインターフェースを通じて見積もりを生成
- チームトレーニング — 非技術的なチームメンバーがlanded costのコンポーネントを理解するのを支援
- API検証 — API統合が期待される結果を生成することを確認
- 顧客サポート — 顧客の問い合わせに対する迅速な見積もり生成
- 一括処理 — 複数の計算を効率的に処理（近日公開予定）
ダッシュボードの見積もりには、APIを通じて利用可能なのと同じ詳細な内訳が含まれており、自動化された統合の優れた補完となります。
landed costを計算する
GraphQLを使用して関税、税金、手数料を計算します。GraphQL
Zonosは、国際出荷のための総landed costを計算します。これには、関税、税金、および税関、ブローカー、または運送業者によって請求される追加手数料が含まれます。ほとんどの場合、私たちは最終請求書を自ら支払い、計算した金額を正確に請求することで、これらの計算を保証します。場合によっては、保証なしでlanded costを使用することができ、これは私たちの計算と実際の請求額との間の差異に対する責任を負うことを意味します。