入力フィールド
分類を生成するには説明のみが必要ですが、提供する商品詳細が多いほど、分類の精度が向上します。または、商品 URL を提供するだけで、Classify が関連する品目詳細を自動的に抽出します。以下は、Classify が受け付ける各入力フィールドの包括的な説明です。これらの入力フィールドを理解することで、最大限に活用し、高精度な分類を生成できます。
入力フィールドの説明
| Field↕ | Description↕ |
|---|---|
| Name (required) | 商品名 |
| Product URL (optional) | 商品 URL を貼り付けると、Classify がページを自動的に取得し、分類に関連する品目詳細（名前、説明、カテゴリなど）を抽出します。Dashboard では + アイコンをクリックするか、メインテキストフィールドに直接追加することで利用できます。API 統合については、Zonos 担当者にお問い合わせください。デモやテストには最適ですが、本番実装ではバックエンドシステムから品目データを直接渡すことで、最適なパフォーマンスとコスト効率が得られます。 |
| Description (optional) | 商品の詳細な長文説明 |
| Image URL (optional) | 商品画像へのリンク。注: 商品ページ URL ではなく、実際の画像 URL へのリンクを使用してください |
| Categories (optional) | 一般的なサブ商品カテゴリ。例: Clothing & Accessories, Pet Supplies, Office Products または Baby Clothes, Pet Beds, Adhesives & Tape |
| Material (optional) | 商品の素材。例: plastic, wood, steel |
| Country of Origin (optional) | 商品の製造または生産国の 2 文字略称（ISO コード） |
| Provided HS Code (optional) | 分類リクエストに既存の HS コードを含めて、リクエストをガイドします。設定と提供された HS コードの出所に応じて、Classify は HS コードを検証し、品目の説明詳細との整合性を確認できます。詳細はこちら。 |
| Destination country (optional) | 商品を分類する国を指定します。仕向国は各国の 2 文字略称（ISO コード） で表示する必要があり、実際の国名ではありません。例: AU（Australia ではない）。このフィールドを含めると、Classify はユニバーサル 6 桁コードの代わりに 8 桁以上の国別 HS コードを返します。ユニバーサル HS コードと国別 HS コードの違い について詳しくはこちらをご覧ください。 |
| Product ID (optional) | 商品 ID または各商品を一意に識別するために使用できる任意の番号。product ID が提供されない場合、Classify は 1 から始まる product ID を割り当てます |
注: Dashboard で一括リクエスト CSV をアップロードする場合、仕向国はテンプレートの一部ではありません。一括リクエスト CSV をアップロードした後に仕向国を選択します。
分類のリクエスト
Dashboard または API 経由で分類をリクエストするには、以下の手順と mutation に従います。
以下の例は、ユニバーサル（6 桁）リクエストを示しています。特定の国への分類をリクエストするには、以下の例のように Classify リクエストに各国の ISO コード を追加します。ユニバーサル HS コードをリクエストする場合は、Classify リクエストで ship-to 国を null のままにします。
入力はリスト形式のため、1 件または複数の分類を一度にリクエストできます。
注: API 経由で audit trail を生成するには、クエリに
auditTrailフィールドを含めてください。アクセスと実装の詳細については、Zonos 担当者にお問い合わせください。
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) { classificationsCalculate(input: $input) { id name categories imageUrl hsCode { code description { full } } }}考えられる API レスポンス
Classify が分類リクエストを受信すると、最高の confidence score に基づいて、リクエストに含まれる入力品目データを Classify データベース内の一致と照合しようとします。見つかった内容に応じて、Classify は以下のいずれかのレスポンスを返します。
hsCodeが 6 桁から 8 桁以上の HS コード（リクエストに ship-to 国が含まれているかどうかによります）で返された場合、分類リクエストは成功しました。{"errors": [ { "message": "No adequate response"}]}が返された場合、入力情報が不十分なため、Classify は分類を見つけられませんでした。
品目の分類
Dashboard および API 経由で分類をリクエストする方法を学びます。
以下では、Dashboard または API 経由でユニバーサル分類および国別分類をリクエストする例を示します。より包括的な技術的詳細と広範なドキュメントについては、Zonos GraphQL API リファレンス開発者サイト をご覧ください。この包括的なリソースでは、API エンドポイント、GraphQL mutation、広範な技術情報について詳しく説明しています。