Landed Cost を計算

partyCreateWorkflowInput は関係者とその所在地を識別します。GraphQL API reference で完全なスキーマを確認してください。必須フィールド:

• location
  • administrativeAreaCode: 都道府県・州のコード（2文字）。CA と BR の場合のみ必須。
  • countryCode: 国の2文字のISO コード。
  • line1: 住所の1行目。
  • postalCode: 住所の郵便番号。
• person
  • email: 担当者のメールアドレス。
  • firstName: 担当者の名。
  • lastName: 担当者の姓。
  • phone: 担当者の電話番号。
• type
  • DESTINATION: 配送先の location および person 情報。
  • ORIGIN: 配送元の location 情報。配送元に関連する person は不要です。

itemCreateWorkflowInput はカート内の品目を一覧表示します。任意フィールドは多数あります（API reference ですべて確認可能)が、以下が必須です。

• amount: 配送される商品の単価（数量を掛ける前の1単位あたりの金額）。これは郵便物における品目の定義とは異なることに注意してください。品目の quantity が1の場合、これは品目の総額です。quantity が1より大きい場合、API は品目の amount に quantity を掛けてラインアイテムの合計を算出します。品目の全単位分の合計金額を amount に入力しないでください。
• currencyCode: 品目の金額の通貨コード。
• quantity: 品目の数量。API は品目の amount に quantity を掛けてラインアイテムの合計を算出します。
• countryOfOrigin: 品目が製造された国。
• 以下のいずれか（品目キーの設定に応じて選択します。品目キーは Catalog に保存された情報とカート内の品目を結び付け、ラベル作成時に使用されます。）
  • productId: 品目のプロダクト ID。
  • sku: 品目の SKU。

measurements（WEIGHT、LENGTH、WIDTH、HEIGHT）は、配送レートの取得時に品目をカートン化したい場合のみ必須です。

cartonsCreateWorkflowInput 自体の入力のみが必要です。GraphQL API reference で渡せるすべての値を確認できます。Zonos が配送コストを計算する場合、カートンの寸法と重量を渡すことが重要です。

このワークフローは、配送サービスとコストが既にわかっている場合に使用します。有効化済みのサービスについて Zonos にコストを計算させたい場合は、このワークフローの代わりに shipmentRatingCalculateWorkflow を使用してください。

shipmentRatingCreateWorkflowInput は配送コストを伝えます。GraphQL API reference で完全なスキーマを確認してください。必須フィールド:

• amount: 配送コスト。
• currencyCode: 配送コストの通貨コード。
• serviceLevelCode: 配送レートで使用される配送サービスレベルを示すコード。

landedCostWorkFlowInput は Landed Cost 計算の設定を指定します。GraphQL API reference で完全なスキーマを確認してください。必須フィールド:

• calculationMethod: 配送方法の希望を示します。DDP（関税・税を前払い）または DAP（関税・税を配達時に支払う、または納付制度が適用される場合は税 ID を通じて納付する）。
  • Landed Cost 保証を利用する場合、この値は常に DDP_PREFERRED にしてください。これにより、可能な場合は DDP の見積もりが提供され、DDP が許可されない場合に DAP の見積もりが提供されます。代わりに DAP を使用すると、通常は関税・税が配達時に支払われることになるため、Landed Cost が保証されなくなる場合があります。
• endUse: 商品が他の事業者へ転売される（FOR_RESALE）か、消費者による最終利用向けである（NOT_FOR_RESALE）かを示します。
• tariffRate: 適用可能な関税率に幅がある場合に、この見積もりの関税率を Zonos がどの方法で計算するかを示します。*Landed Cost 保証を利用する場合、これは常に ZONOS_PREFERRED にしてください。

Zonos は、より正確な Landed Cost の見積もりにつながるため、商品固有の HS コードを使用することを強く推奨します。HS コードがわかっている場合は、itemCreateWorkflow の実行時に各 item に hsCode を渡してください。

HS コードを渡すと、Zonos は Landed Cost の見積もり取得時にその場で検証します。指定された HS コードが無効(つまり存在しない)場合、Zonos はその場で品目を再分類し、指定された HS コードの代わりに新しい有効な HS コードを使用します。

商品の HS コード生成にサポートが必要な場合は、Zonos Classifyと分類のリクエスト方法についてご確認ください。

Zonos に hsCode を渡さない場合、まずZonos Catalogを確認し、品目に保存された HS コードがあるかを調べます。ない場合は、Classifyを呼び出し、itemCreateWorkflow の以下の商品詳細フィールド(description、category、material)に基づいて Landed Cost 計算に使用する分類を生成します。商品詳細フィールドの情報が十分でなく、Classify の信頼度スコアに基づく分類を生成できない場合は、ストアに割り当てられたデフォルト HS コードが使用されます。

Zonos に配送コストを計算させるには、shipmentRatingCalculateWorkflow を使用します。計算済み配送のレスポンスで返される配送オプションは、Dashboardの配送プロファイルに割り当てた serviceLevels に対応します。

トラブルシューティング: レスポンスに serviceLevel が表示されるはずなのに表示されない場合は、その serviceLevel が有効化されており、選択した method でサポートされていることを確認してください。

配送コストを算出する前に Zonos に品目をカートンに振り分けさせたい場合は、cartonizeWorkflow(入力なし)を追加してください(容積重量に使用)。

配送の serviceLevel と amount がわかっている場合は、リクエストの shipmentRatingCreateWorkflow 部分でそれらを渡すことができます。Zonos はその値を使用して関連するキャリア手数料を計算し、レスポンスで返します。