DashboardまたはAPIでZonos Catalog商品の追加、変更、削除方法を学びます。コードを書きたくない場合や小規模な変更にはDashboardのCatalogを使用してください。本番実装でCatalogと直接統合する場合はAPIを使用します。
Catalogで商品を作成：
Catalogで複数の商品を作成：
複数の商品またはカタログ全体を一度にアップロード。
重要： 既存の商品を作成しようとすると、CatalogはSKUおよび/またはproduct IDに基づいて商品を認識し、元の商品の詳細を新しい詳細で上書きします。
DHL配送では、商品を危険物としてタグ付けすると、その商品のlabelを作成するたびに正しいDHL付加価値サービスが自動適用されます。これは規制商品の「低リスク」または免除クラス—技術的に規制されるが特例または数量免除の下で配送される商品—をカバーします。
危険物タグはCatalog商品attributeとして保存されます：商品のkey/valueペアです。attributeはAPI（catalogItemsCreateまたはcatalogItemsUpdate）経由で設定され、DashboardフィールドやCSV列はありません。
key
value
catalogItemsCreate
catalogItemsUpdate
危険物タグ付けはDHL配送にのみ影響します。他のキャリアではタグは無視されます。
DANGEROUS_GOODSはDHL危険物タグ付けでサポートされるattribute keyです。ItemAttributeInputリファレンスの承認済みkey一覧にはまだ記載されていませんが、APIで受け付けられます。
DANGEROUS_GOODS
ItemAttributeInput
商品にタグ付けするには、key DANGEROUS_GOODS と以下のサポートされるカテゴリのいずれかのvalueを持つattributeを追加します。
mutation CatalogItemsCreate(
$sku: String!
$name: String
$attributes: [ItemAttributeInput!]
) {
catalogItemsCreate(
input: [{ sku: $sku, name: $name, attributes: $attributes }]
id
name
sku
attributes {
}
NOT_RESTRICTED_A70
NOT_RESTRICTED_A67
NOT_RESTRICTED_A02
LIMITED_QUANTITY
EXCEPTED_QUANTITY
CONSUMER_COMMODITY
MAGNETIZED_MATERIAL
BIOLOGICAL_SUBSTANCE
商品のタグ付けが最初のステップです。ZonosがDHL labelにカテゴリを自動適用するには、label settingsで Ship dangerous goods を有効にします。単一labelで手動選択も可能—declare dangerous goodsを参照。
商品の編集により、既存商品を追加または更新情報で効率的に更新できます。商品を削除して再アップロードする代わりに、更新情報をアップロードすると、Catalogはitem key preferenceに応じたSKUまたはproduct IDで既存商品と照合します。DashboardまたはAPIで新規商品を作成または既存商品を編集する場合も、最小限の労力でカタログを最新に保てます。
Catalogに既存のCatalog商品を作成/編集する場合、以下が想定されます：
Catalogは既存商品の空白フィールドを上書きします。
Catalogは既存フィールドを新しい値で上書きします。
Catalogは空白フィールドで既存値を上書きしません。
商品を編集するには：
複数またはすべての商品を一度に編集するには、SKUまたはproduct IDを含む更新CSVをCatalogにアップロードするだけです。既存商品の自動更新がトリガーされます。
商品を削除するには：
すべての商品を削除するには：
大量（約20,000商品以上）を削除する場合、削除が進行中であることを示す通知が表示されます。この間、削除完了までCatalogと操作できません。ただし、通知を閉じて移動しても削除プロセスは中断されません。
特定の国（複数可）への配送を防ぐ場合、商品の作成または更新時に制限を追加できます。
Zonos Duty & Tax appは、国際注文から特定商品を除外する商品レベル制限をサポートしません。制限商品がカートにある場合、その国への配送はカート全体をブロックする必要があります。これはオンボーディング時に事前設定するカートレベル制限ルールで処理されます。CatalogはDuty & Tax appと互換性がありますが、商品レベル制限はZonos Checkout使用時のみサポートされます。
Catalogで単一商品を制限するには：
Catalogで複数商品を制限するには：
AU|KR|MY|SG
ALL
ALL-
ALL-CA|FR|US
NONE
制限商品のフィルタリング：
Dashboardからカタログ全体をCSV形式でダウンロードし、ExcelまたはGoogle Sheetsで開くことで、カタログ内で直接制限商品をフィルタリングできます。フィルター機能で制限商品のみ表示できます。カタログ内の制限商品を簡単に見つけて管理できます。
CSV変更後にカタログを更新する必要がある場合、ファイルを再アップロードすると、一致する商品は更新版に置き換えられます。SKUおよび/またはproduct IDの識別と照合により行われます。
Checkoutを使用している場合、商品が顧客の国に制限されているとき、Checkoutに制限メッセージが表示されます。デフォルトメッセージは「This item is restricted from import to your country.」です。
DashboardまたはAPIでSKU、product ID、商品名を使用してCatalog内の商品を検索できます。SKUとproduct ID検索は完全一致のみ、部分一致はサポートされません。商品名検索では部分一致がサポートされます。
SKUまたはproduct IDでフィルタリングするには：
商品名を検索するには：
Catalogテーブルから50件以下を選択すると、Dashboardから直接ダウンロードされます。Export all または50件超を選択すると、CSVはメールでエクスポートされます。
50件以下をエクスポートする手順：
メールリンクからCSVをダウンロードできない場合、ブラウザがダウンロードをブロックしている可能性があります。その場合：
APIでClassificationsCreateFromCatalog mutationのcatalogItemIdを使用して、カタログから商品をClassifyできます。
ClassificationsCreateFromCatalog
catalogItemId
カタログから商品をClassifyするにはnameが必須です。CatalogおよびClassifyフィールドの完全なリストはGraphQL API referenceを参照してください。
Catalog商品を同時に作成・Classifyするには、以下のClassificationsCreateFromCatalog mutationをCatalogItemsCreate mutationに追加します。
CatalogItemsCreate
shipToCountriesフィールドが入力されている場合、Classifyは8桁以上（国別）HS codeになります。shipToCountriesがない場合、6桁（ユニバーサル）HS codeがデフォルトです。ユニバーサルと国別HS codeの違いの詳細を学びます。
shipToCountries
以下の例では、カナダ向け国別codeを生成するためshipToCountriesフィールドを指定しています。
mutation ClassificationsCreateFromCatalog(
$catalogItemToClassify: [ClassificationFromCatalogInput!]!
classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
configuration {
hsCode {
code
リクエスト例です。Zonos ClassifyはnameのみでClassifyを生成しますが、最良のClassify結果のため可能な限り詳細を追加することを強く推奨します。
{
"catalogItemToClassify": [
"catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
digital_good
physical_good
ships_alone
consolidated
* API errorのみ
Manage products
Catalog管理
商品の作成と変更。DashboardまたはAPIでZonos Catalog商品の追加、変更、削除方法を学びます。コードを書きたくない場合や小規模な変更にはDashboardのCatalogを使用してください。本番実装でCatalogと直接統合する場合はAPIを使用します。
商品の作成
Catalogで商品を作成：
Catalogで複数の商品を作成：
複数の商品またはカタログ全体を一度にアップロード。
商品を危険物としてタグ付け（DHL）
DHL配送では、商品を危険物としてタグ付けすると、その商品のlabelを作成するたびに正しいDHL付加価値サービスが自動適用されます。これは規制商品の「低リスク」または免除クラス—技術的に規制されるが特例または数量免除の下で配送される商品—をカバーします。
危険物タグはCatalog商品attributeとして保存されます：商品の
key/valueペアです。attributeはAPI（catalogItemsCreateまたはcatalogItemsUpdate）経由で設定され、DashboardフィールドやCSV列はありません。危険物タグ付けはDHL配送にのみ影響します。他のキャリアではタグは無視されます。
DANGEROUS_GOODSはDHL危険物タグ付けでサポートされるattribute keyです。ItemAttributeInputリファレンスの承認済みkey一覧にはまだ記載されていませんが、APIで受け付けられます。商品にタグ付けするには、key
DANGEROUS_GOODSと以下のサポートされるカテゴリのいずれかのvalueを持つattributeを追加します。mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) {catalogItemsCreate(input: [{ sku: $sku, name: $name, attributes: $attributes }]) {idnameskuattributes {keyvalue}}}サポートされる危険物value
NOT_RESTRICTED_A70NOT_RESTRICTED_A67NOT_RESTRICTED_A02LIMITED_QUANTITYEXCEPTED_QUANTITYCONSUMER_COMMODITYMAGNETIZED_MATERIALBIOLOGICAL_SUBSTANCE商品のタグ付けが最初のステップです。ZonosがDHL labelにカテゴリを自動適用するには、label settingsで Ship dangerous goods を有効にします。単一labelで手動選択も可能—declare dangerous goodsを参照。
商品の編集
商品の編集により、既存商品を追加または更新情報で効率的に更新できます。商品を削除して再アップロードする代わりに、更新情報をアップロードすると、Catalogはitem key preferenceに応じたSKUまたはproduct IDで既存商品と照合します。DashboardまたはAPIで新規商品を作成または既存商品を編集する場合も、最小限の労力でカタログを最新に保てます。
Catalogに既存のCatalog商品を作成/編集する場合、以下が想定されます：
Catalogは既存商品の空白フィールドを上書きします。
Catalogは既存フィールドを新しい値で上書きします。
Catalogは空白フィールドで既存値を上書きしません。
商品を編集するには：
複数またはすべての商品を一度に編集するには、SKUまたはproduct IDを含む更新CSVをCatalogにアップロードするだけです。既存商品の自動更新がトリガーされます。
商品の削除
商品を削除するには：
すべての商品を削除するには：
大量（約20,000商品以上）を削除する場合、削除が進行中であることを示す通知が表示されます。この間、削除完了までCatalogと操作できません。ただし、通知を閉じて移動しても削除プロセスは中断されません。
商品の制限
特定の国（複数可）への配送を防ぐ場合、商品の作成または更新時に制限を追加できます。
Zonos Duty & Tax appは、国際注文から特定商品を除外する商品レベル制限をサポートしません。制限商品がカートにある場合、その国への配送はカート全体をブロックする必要があります。これはオンボーディング時に事前設定するカートレベル制限ルールで処理されます。CatalogはDuty & Tax appと互換性がありますが、商品レベル制限はZonos Checkout使用時のみサポートされます。
Catalogで単一商品を制限するには：
Catalogで複数商品を制限するには：
AU|KR|MY|SG）。すべての国を制限する場合はALL。特定の国を除く場合はALL-の後に縦棒区切りで国を指定（例：ALL-CA|FR|US）。CSV formattingの詳細を学びます。既存の制限国をすべて削除する場合はNONE。制限商品のフィルタリング：
Dashboardからカタログ全体をCSV形式でダウンロードし、ExcelまたはGoogle Sheetsで開くことで、カタログ内で直接制限商品をフィルタリングできます。フィルター機能で制限商品のみ表示できます。カタログ内の制限商品を簡単に見つけて管理できます。
CSV変更後にカタログを更新する必要がある場合、ファイルを再アップロードすると、一致する商品は更新版に置き換えられます。SKUおよび/またはproduct IDの識別と照合により行われます。
Checkoutを使用している場合、商品が顧客の国に制限されているとき、Checkoutに制限メッセージが表示されます。デフォルトメッセージは「This item is restricted from import to your country.」です。
商品のフィルタリング
DashboardまたはAPIでSKU、product ID、商品名を使用してCatalog内の商品を検索できます。SKUとproduct ID検索は完全一致のみ、部分一致はサポートされません。商品名検索では部分一致がサポートされます。
SKUまたはproduct IDでフィルタリングするには：
商品名を検索するには：
商品のエクスポート
Catalogテーブルから50件以下を選択すると、Dashboardから直接ダウンロードされます。Export all または50件超を選択すると、CSVはメールでエクスポートされます。
50件以下をエクスポートする手順：
すべての商品をエクスポートするには：
メールからのダウンロードで問題が発生した場合
メールリンクからCSVをダウンロードできない場合、ブラウザがダウンロードをブロックしている可能性があります。その場合：
商品のClassify
APIで
ClassificationsCreateFromCatalogmutationのcatalogItemIdを使用して、カタログから商品をClassifyできます。カタログから商品をClassifyするには
nameが必須です。CatalogおよびClassifyフィールドの完全なリストはGraphQL API referenceを参照してください。Catalog商品を同時に作成・Classifyするには、以下の
ClassificationsCreateFromCatalogmutationをCatalogItemsCreatemutationに追加します。Catalog商品を8桁以上（国別）にClassify
shipToCountriesフィールドが入力されている場合、Classifyは8桁以上（国別）HS codeになります。shipToCountriesがない場合、6桁（ユニバーサル）HS codeがデフォルトです。ユニバーサルと国別HS codeの違いの詳細を学びます。以下の例では、カナダ向け国別codeを生成するため
shipToCountriesフィールドを指定しています。mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) {classificationsCalculateFromCatalog(input: $catalogItemToClassify) {idconfiguration {shipToCountries}hsCode {code}name}}リクエスト例です。Zonos Classifyは
nameのみでClassifyを生成しますが、最良のClassify結果のため可能な限り詳細を追加することを強く推奨します。{"catalogItemToClassify": [{"catalogItemId": "catalog_item_893jkdkllg03k9khjd9",APIエラーと解決方法
digital_goodとphysical_goodのみサポートします。physical good（最も一般的）の場合、このフィールドは空白にしてください。ships_aloneとconsolidatedをサポートします。他の商品とまとめられる場合、空白のままにできます（デフォルトはconsolidated）。ItemAttributeInput
このページは役に立ちましたか？