入力フィールド
分類を生成するには説明のみが必要ですが、提供する製品の詳細が多いほど、分類の精度が向上します。以下は、Classifyが受け入れる各入力フィールドの包括的な説明です。これらの入力フィールドを理解することで、最大限に活用し、高精度の分類を生成できます。
入力フィールドの説明
| フィールド | 説明 |
|---|---|
| 名前（必須） | 製品の名前 |
| 説明（任意） | 製品の詳細な長文説明 |
| 画像URL（任意） | 製品の画像へのリンク。注意：実際の画像URLへのリンクを使用し、製品ページのURLではないことを確認してください |
| カテゴリ（任意） | 一般的なサブ製品カテゴリ、例：衣料品とアクセサリー、ペット用品、オフィス製品 または ベビー服、ペットベッド、接着剤とテープ |
| 素材（任意） | 製品の材料、例：プラスチック、木材、鋼 |
| 原産国（任意） | 製品の製造または生産国2文字の略称（ISOコード） |
| 提供されたHSコード（任意） | リクエストをガイドするために、既存のHSコードを分類リクエストに含めます。提供されたHSコードの出所や好みに応じて、ClassifyはHSコードを検証し、アイテムの説明詳細に対する一貫性を確認できます詳細を学ぶ。 |
| 宛先国（任意） | 製品が分類される国を特定します。宛先国は、各国2文字の略称（ISOコード）で表示され、実際の国名ではなく、例：AU、ではなくオーストラリア。このフィールドを含めることで、Classifyは普遍的な6桁のコードではなく、8桁以上の国別HSコードを返すことができます普遍的および国別HSコードの違いについて学ぶ。 |
| 製品ID（任意） | 製品を一意に識別するために使用できる製品IDまたは任意の番号。製品IDが提供されない場合、Classifyは1から始まる製品IDを割り当てます |
注意： ダッシュボードでバルクリクエストCSVをアップロードする場合、宛先国はテンプレートの一部には含まれず、バルクリクエストCSVをアップロードした後に宛先国を選択します。
分類をリクエストする
ダッシュボードまたはAPIを通じて分類をリクエストするには、以下の手順とミューテーションに従ってください。
以下の例は、普遍的（6桁）のリクエストを示しています。特定の国への分類をリクエストするには、Classifyリクエストに国'ISOコードを追加します。普遍的なHSコードをリクエストするには、Classifyリクエストで送付先国をnullのままにします。
入力はリストを取るため、一度に多くの分類または単一の分類をリクエストできます。
ミューテーション
GraphQL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
mutation {
classificationsCalculate(
input: [
{
categories: "women's clothing"
imageUrl: "https://zonos.com/images/cozygloves.webp"
name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
configuration: { shipToCountries: KR }
}
]
) {
id
name
categories
imageUrl
hsCode {
code
description {
full
}
}
}
}
応答
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
"data": {
"classificationsCalculate": [
{
"id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": ["women's clothing"],
"imageUrl": null,
"hsCode": {
"code": "6116.99.0000",
"description": {
"full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
}
}
}
]
}
}
可能なAPIレスポンス
Classify が分類リクエストを受け取ると、リクエストに含まれる入力アイテムデータを Classify's データベース内の一致と最高の信頼スコアに基づいて照合しようとします。見つかった内容に基づいて、Classify は以下のいずれかのレスポンスを返します：
hsCodeが6桁から8桁以上のHSコードと共に返される場合、発送先国がリクエストに含まれているかどうかに応じて、あなたの分類リクエストは成功しました。{"errors": [ { "message": "適切な応答がありません"}]}が返される場合、それは Classify が不十分な入力情報のために分類を見つけられなかったことを意味します。
アイテムの分類
ダッシュボードおよびAPIを通じて分類をリクエストする方法を学びます。
以下に、ダッシュボードまたはAPIを通じて普遍的および国別の分類をリクエストする方法を示す例を示します。より包括的な技術的詳細や広範なドキュメントを求めている方はZonos GraphQL APIリファレンス開発者サイトをご覧ください。この包括的なリソースは、APIエンドポイント、GraphQLミューテーション、および広範な技術情報に関する詳細な洞察を提供します。