出品アイテムAPIの問題のトラブルシューティング
出品商品の統合時によくある問題の背景とトラブルシューティング
出品アイテムAPIの問題のトラブルシューティング
出品アイテムAPIは、プログラムを使用してAmazonに掲載された出品パートナーの出品にアクセスします。出品パートナーのAmazon出品(SKU)の詳細の作成、編集、削除、および取得を行うことができます。これには、商品タイトルなどの商品情報や、価格や在庫などの販売条件が含まれます。
Listings data submitted to the Listings Items API abide by the JSON Schema format provided by the Selling Partner API for Product Type Definitions.
以下のトラブルシューティングのヒントは、送信時、処理中、または一般的な申請プロセスとは無関係に、出品に関する問題が報告された場合にブロックを解除する際に役立ちます。
出品に関する問題はどのように受信されますか?
同期と非同期
出品中は、プロセスのさまざまな段階で問題が発生することがあります。出品APIへの送信時に、申請が受け付けられず、それ以上処理が行われない問題を同期的に受信することがあります。また、報告された問題の非同期通知を送信後に受け取ることもあります。出品データの読み取り時に問題を取得する場合もあります。
同期的問題は、最初のリクエスト中にサーバーがリクエストを拒否すると発生します。最も可能性が高いのは、リクエストに添付されている不正な属性やパラメーターの処理ミスに起因する問題です。
非同期的問題は、リクエストが初期検証に合格したものの、受信したデータの処理後にエラーが返されると発生します。返される問題は、メッセージ形式であり、問題の解決に使用できます。
送信後の処理
Amazonは、出品パートナーからの申請に対してさまざまな検証を行います。こうした検証の一部は、申請に対するレスポンス内で同期的に返されます。必須属性が欠落している場合や属性が無効である場合など、入力自体に関するデータ検証が対象となります。
申請が前述の同期検証に合格すると、申請は受け付けられ、SKUを作成または更新するためにダウンストリームに送信されます。その後、Amazonカタログに商品を正常に作成するために、さまざまなダウンストリームプロセスが実行されます。このようなダウンストリームプロセスのいずれかで問題が生成され、非同期的に返される場合があります。
考えられるすべての問題を適切に処理するには、同期と非同期の両方で報告された問題に対応する必要があります。
問題のコードとメッセージ:その意味と回避方法
問題コード | 出品に関する問題 | 説明 | その他の詳細と予防措置 |
---|---|---|---|
90220 | attribute_name は必須ですが、指定されていません。 |
この問題は、必須属性が指定されていない場合に発生します。 例: item_package_dimensions は必須ですが、指定されていません。問題のメッセージに示されているように、必須属性の情報を入力してください。 |
To avoid this, use the Product Type Definitions API to identify required attributes and add to validation checks. Use the Notifications API to be updated with instant updates of Product Type definitions. |
4000001 | attribute_name に指定されている値が無効です。 |
特定の属性に指定された値が無効です。一部の属性には、許容値の制限付きリストがあります。この問題は通常、商品カテゴリー、商品サブカテゴリー、商品タイプのキーワード、推奨ブラウズノードのいずれかに関連しています。条件に従う必要があることに注意してください。つまり、特定の商品カテゴリーに対しては特定のサブカテゴリーしか選択できず、特定のサブカテゴリーに対しては特定のブラウズノードしか選択できないということです。 | To avoid this, use the Product Type Definitions API to verify permitted values and conditionality and ensure that they reflect the list of accepted values that can be selected within your system. |
4005011 | attribute_name の値が、Amazonカタログ内の別の商品conflicting_asin と競合しています。値をconflicting_value に変更するか、またはAmazonに問い合わせて、競合するデータの問題を解決してください。 |
この問題は、申請にAmazonカタログ内の別の商品と競合するデータが含まれている場合に返されます。参照先のASINと属性について、競合する情報を確認してください。既存のデータとの競合を解決するために、送信対象のデータを変更する必要が生じる場合があります。 既存の値を変更するためには、Amazonサポートケースを送信する必要があります。 |
や APIを使用して、SKUの既存のカタログデータをすべて表示するワークフローを構築します。 |
99022 | 属性attribute_name のフィールドfield_name の値の数が足りません。最低限必要な値の数はmin_occurrences です。 |
最小値を満たしていません。この問題は、送信したフィールドの値数が最小要件を満たしていないか、または値が入力されていない場合に発生します。問題のメッセージを確認して欠落している値や要件を特定し、ベンダーに再送信を依頼してください。 例:属性 list_price のフィールドcurrency には少なくとも1 の値が必要です。定価を追加する場合は、通貨の値(GB、EURなど)を指定する必要があります。 |
これを回避するための解決策として、システムに検証チェックを追加して、最小要件が満たされていない箇所を強調表示することをお勧めします。 |
4005034 | コスト値の増加はサポートされていません。ベンダー/セラーセントラルの商品コストの編集機能を使用してください。 | コストの増加は許可されていません。ベンダー/セラーセントラルの商品コストの編集機能を使用してください。必要な場合は、Skip Cost Price 属性を使用してAPI経由で原価の指定に関する要件を削除できます。 |
これを回避するには、 APIを使用して、既存のコストを表示します。また、可能な場合は、API経由で送信する前に、ベンダー/セラーセントラルの「商品コストの編集」機能を使用してコスト増額を申請し、承認を得てください。 |
90225 | attribute_name の値が許容最大値(上限の単位)を超えています。 |
一部の属性には、送信できる値の長さに上限があります。属性値の長さを短くして、もう一度送信してみてください。 文字数に上限のある一般的な属性については、以下を参照してください。
|
|
4005013 | 入力された情報は、すでにカタログに登録されている商品と一致します(SKU:matched_sku 、ASIN:matched_asin )。カタログで商品を重複させることはできません。 |
商品を送信し、それがすでにアカウントに追加されている既存のASINと一致する場合、またはベンダーが既存のASINのSKUを編集しようとする場合、この問題が返されます。SKUは編集できない属性であり、一度商品を作成すると変更できません。ベンダーは、属性の編集前に商品の作成に使用した元のSKUを使用する必要があります。 | や APIを使用して、SKUの既存のカタログデータをすべて表示するワークフローを構築します。 |
90180 | 属性attribute_name のフィールド値に指定された値Boolean | [false, true] のタイプが間違っています。指定されたタイプはSTRING ですが、予期されるタイプはBOOL です。 |
解決するには、問題のメッセージで参照されている予期されるタイプを使用して再送信します。 例:属性 battery のフィールドweight#1.value に指定された値number のタイプが間違っています。指定されたタイプはSTRING ですが、予期されるタイプはDECIMAL です。 |
これを回避するには、システムに警告を追加して、その値に予期されるタイプを指示します。 |
4005007 | attribute_name の値に一致するものが、指定されたブランドでは見つかりませんでした。値を修正して再送信してください。値が正しい場合は、ベンダーマネージャーに連絡し、その値と指定されたブランドとの関係を証明する書類を提出してください。 |
この問題は、送信した商品の外部IDが、指定したブランドで使用できるように登録されていない場合に返されます。適切な値(UPC、EAN、または GTIN)を使用しているかどうかを確認してください。 値が正しい場合は、外部IDが登録されている会社と選択したブランドとの提携の証明(ライセンス契約など)を提出する必要があります。 次の情報を送信する必要があります。
|
Contact Us: Open a case to Developer Support if you require technical support or where indicated in the troubleshooting guide. |
90244 | 属性attribute_name の列挙値value が無効です。 |
This issue means the provided value for the attribute is not valid. Certain attributes have hard enumerated values which the provided value must match exactly. Ensure you are calling the latest version of the Product Type Definitions API and confirm that the Product Type in the JSON payload is correct. If this issue still remains unresolved, you can always submit a ticket to Developer Support. |
Reference the Product Type Definitions API for a list of permitted values and ensure that they are reflected in your system to prevent failed submissions. |
4005033 | attribute_name の値を編集できません。値をoriginal_value に戻して、再送信してください。 |
This issue is returned when you attempt to modify an un-editable attribute. The attribute value should be changed back to the original provided in the issue message. If the original value is incorrect and you wish to have the value updated, then a Contact Us case should be submitted providing the following:
|
や APIを使用して、SKUの既存のカタログデータをすべて表示するワークフローを構築します。 |
90248 | 属性attribute_name のフィールドfield に指定された値が多すぎます。上限はallowed_count の値ですが、現在はactual_count の値です。 |
指定したフィールドに、許容されている数よりも多くの値があります。この問題は、商品タイプによって値が異なるアパレルサイズ属性に関連して発生することが最も一般的です。 例: bottoms_size は、商品タイプshirt に予期されていません。これを解決するには、問題のメッセージに応じて値を削除または削減します。 |
これを回避するには、特定の商品タイプに制限を追加して、関連するアパレルサイズ属性のみを選択できるようにします。通貨など、値が1つしかないと想定されるその他の項目について、事前検証チェックを追加してください。 |
90114 | attribute_name の値が最小要件limit を下回っています。 |
この問題は、整数または10進数の属性値が許容される最小値の制限を満たしていない場合に発生します。通常、この問題は原価、ケースパックの数量、およびitems_per_inner_pack で見られます。問題のメッセージを確認し、最小値を入力して送信内容を修正するようベンダーに依頼してください。 例:原価は0より大きいことが予期されるため、このエントリでは問題が返されます。 cost_price: [{ "currency" : "GBP", "value" : 0 }] |
これを回避するには、事前検証チェックを追加するか、指定された値が最小要件を下回った場合の警告を追加します。 |
90193 | left_attribute_name の値left_attribute_value が、right_attribute_name の値right_attribute_value より小さくありません。 |
例:cost_price の値が「126.1」で、list_price の値「33.21」より小さくありません。 |
これを回避するには、right_attribute_value よりも小さい値を指定します。 |
90147 | left_attribute_name の値left_attribute_value が、right_attribute_name の値right_attribute_value 以下ではありません。 |
問題のメッセージに記載されているright_attribute_value 以下の値を指定してください。最も一般的な原因は、 item_weight がitem_package_weight より小さいことです。例: item_weight#1.value の値が3.4 で、item_package_weight#1.value の値6d-1 以下ではありません。 |
システム内に事前検証チェックを追加して、item_weight がitem_package_weight 以下の場合にフラグを立てます。これにより、送信前に是正措置を講じることができます。 |
90221 | attribute_name の値value は、制限limit より大きくなければなりません。 |
この問題は通常、重量またはコストの0 の値を送信した際に返されます。例:item_package_weight の値0 は、制限0 より大きくなければなりません。 |
これを回避するには、入力された値が指定されたしきい値よりも低い場合に警告を追加します。コストと重量の値はゼロより大きくなければなりません。 |
4005015 | 指定されたASINは、Amazonカタログの既存の商品と一致しません。値をattribute_value のいずれかに置き換えて、再送信してください。 |
この問題は、Amazon Matching Serviceが、指定されているMerchant Suggested ASIN属性値ではなく、カタログ内の別のASINを検出した場合に発生します。 「Merchant Suggested ASIN」属性列に、問題のメッセージで参照されている一致するASINを入力する必要があります。入力ミスがあると、ASIN無効エラーが返されます。 注: Merchant Suggested ASINの値を大文字で入力するようベンダーに依頼してください。 |
や APIを使用して、SKUの既存のカタログデータをすべて表示するワークフローを構築します。 |
4005008 | attribute_name の値が、制限されているか、GS1に登録されていません。Amazonに問い合わせて、関連するGS1証明書を提出してください。 |
この問題は、外部商品IDが制限されているか、GS1に登録されていない場合に返されます。商品の所有権の証明がある場合は、Amazonに連絡して関連するGS1証明書を提出してください。 | 入力したUPC/EAN/GTINが正しいことを確認してください。 |
99016 | 属性attribute_name の許容される発生上限はmax_count 回ですが、現在actual_count 回発生しています。 |
This occurs when there are too many entries for a certain attribute name. A solution would be to remove any additional entries and resubmit. If the issue persists, contact Developer Support to request that they delete the duplicate attributes. Example: A maximum of two occurrence are allowed for the attribute sport_type but it currently occurs four times. In order to fix this, the vendor should remove two of the entries:
"sport_type": [{ "language_tag", "en_GB", "value" : "Multi-Sport" }, { "language_tag" : "en_GB", "value" : "Surfing" }, { "language_tag" : "en_GB", "value" : "Snowboarding"}, { "language_tag" : "en_GB", "value" : "Cycling" }] |
これを回避するには、事前検証チェックを追加するか、許容されている数よりも多くのエントリを指定した場合の警告を追加します。 |
90188 | 値がISBN/UCCIDを満たしていません。属性attribute_name のチェックサム要件。 |
入力されているExternal Product ID属性の値が無効です。external_id_type にはそれぞれ求められる文字数があり、UPCは12文字、EANは13文字、GTINは14文字です。要件を確認し、満たすように修正してください。 |
これを回避するには、規則に違反した場合のシステムの警告を追加します。例:UPCをタイプとして選択しましたが、IDの文字数が求められている12文字ではなく、13文字になっています。 |
90226 | attribute_name の値が、許容される最小値(下限の単位)よりも短くなっています。 |
この問題は、送信した値が指定されている最小値よりも短い場合に返されます。この問題を解決するには、値を修正して再送信します。 例: short_item_name の値が最小要件(X 文字)よりも短いです。最も一般的な例は、externally_assigned_product_identifier の値が許容される最小値よりも短いことです。 |
これを回避するには、既知の許容最小値が存在する場合、システムの制限または警告を適用します。 |
4005022 | 商品のパッケージ寸法は、商品を入れるパッケージ階層のパッケージ寸法よりも小さくなければなりません。 | 申請するパッケージの寸法値(幅、高さ、長さ、重量)は、親商品の値より大きくすることはできません。 | これを回避するには、寸法の値を親商品と比較し、階層全体で矛盾しないよう値を修正します。 |
4005001 | attribute_name に指定されている通貨は、この商品の既存の通貨と一致しません。 |
通貨がこのASINと一致しません。 | Contact Us: Open a case to Developer Support if you require technical support or where indicated in the troubleshooting guide. |
90194 | 値が属性attribute_name のパターン制約を満たしていません。値はパターンpattern と一致している必要があります。 |
例:[fabric_type] の値が、<パーセント値>% <ファブリック名>のパターン(100%コットンなど)を満たしていません。 |
これを回避するには、問題のメッセージに記載されたパターンの値を指定します。 |
4005018 | 高級ブランド製品には、高級品カテゴリーまたはプロフェッショナルな商品カテゴリーが必要です。 | これは高級ブランド商品です。Luxury またはProfessional が先頭に付いた商品カテゴリーを選択する必要があります。ご自身のブランドが高級ブランドではないと思われる場合は、Amazonの窓口にお問い合わせください。 |
これを回避するには、Luxury 商品タイプを選択します。 |
90197 | attribute_name の値が許容される最大値limit を超えています。 |
この問題は、許容される整数または10進数の属性値の上限を満たしていない場合に発生します。例:[manufacturer_minimum_age] の値が許容される最大値(1188)を超えています。 |
これを回避するには、値を減らしてもう一度送信を試みます。 |
4005006 | カタログの商品は、attribute_name の値ですでに存在していて、attribute_name の値は編集できません。異なる商品の場合は、別の値を指定して再送信してください。 |
この問題は、すでにアカウントに登録されている既存の商品の外部商品ID値を編集しようとした場合に発生します。外部商品IDのフィールドは、一度商品が作成されると編集できない属性です。 商品の編集を続けるには、元の外部商品IDを入力する必要があります。 |
や APIを使用して、SKUの既存のカタログデータをすべて表示するワークフローを構築します。 |
4005019 | 高級品カテゴリーやプロフェッショナルな商品カテゴリーに対しては、非高級品ブランドを送信できません。 | 出品パートナーが、非高級品の美容ブランドを高級美容カテゴリーで出品しようとしました。Luxury とProfessional 以外の商品カテゴリーを選ぶように、出品パートナーに依頼してください。 |
出品パートナーが高級美容カテゴリーでの出品を希望する場合は、このカテゴリーを使用できるようにAmazonベンダーマネージャーと直接協力するよう依頼してください。 |
4000000 | 内部エラーが発生しました。もう一度お試しください。 | 内部障害が発生しました。当社がこの問題の詳細を連絡する可能性があります。 | 2回試しても問題が解決しない場合は、カスタマーサポートへのチケットを切ってください。 |
90199 | attribute_name の値にHTMLタグを含めることはできません。 |
HTMLタグをこのフィールドに含めることはできません。この問題を解決するには、HTMLタグを含まない値を入力します。 | これを回避するには、事前検証チェックを追加するか、または入力された値にHTMLタグが含まれている場合の警告を追加します。 |
4005039 | この商品に関する複数の申請があります。そのうちの1つを編集するためには、Amazonサポートにお問い合わせください。 |
There are multiple contributions within the catalog for this item. Raise a Contact Us case via Vendor Central if you're a vendor or Developer Support if you're a seller that states:
|
解決するには、Amazonのサポートが必要です。 |
90196 | attribute_name の値にURLを含めることはできません。 |
このフィールドにURLを含めるはできません。この問題を解決するには、URLが含まれない値を入力します。 | これを回避するには、事前検証チェックを追加するか、または入力された値にURLが含まれている場合の警告を追加します。 |
4005038 | 入力した商品IDが、同じSKUに対して以前に入力した商品IDと異なります。元の商品IDを入力してください。 | この問題の原因は、異なるexternal_id が既存のSKUに割り当てられていることです。それでもこの外部商品ID(編集不可の属性)を更新する必要がある場合は、Amazonサポートに連絡する必要があります。 |
や APIを使用して、SKUの既存のカタログデータをすべて表示するワークフローを構築します。 |
4005002 | attribute_name の値の減少分が最大許容値を超えています。減らす金額の値を少なくして、再送信してください。 |
この問題は、原価の大幅な引き下げが許可されないために発生します。問題が発生した場合は、原価を再検討する必要があります。原価を指定する必要のないSkip Cost Price 属性を使用することもできます。原価を変更する場合は、Amazonの窓口に問い合わせるか、Amazonサポートを通じてASIN/EANの旧価格、新価格、通貨を記載のうえケースを送信してください。 |
これを回避するには、 APIを使用して既存のコストを表示します。 |
4005003 | attribute_name の値は、定価を超えることができません。 |
入力した原価が定価よりも高くなっています。 | これを回避するには、原価を定価よりも低く設定します。 |
4000002 | attribute_name の値は必須です。 |
指定した属性に必須値が入力されていません。問題のメッセージに記載されているように、値が入力されていない属性に必須値を指定してください。 | Amazon makes frequent updates to PT schemas. Integrators and Selling Partners need to stay updated with the latest requirements in order to prevent this issue. This can be done as follows: Implement the Notifications API: notification_type PRODUCT_TYPE_DEFINITIONS_CHANGE to to know about when the updates happen.Refresh the schema on your end to pull the latest from the Product Type Definitions API and identify required and conditionally required attributes and add them to validation checks. Pre-release versions of product type definitions can be retrieved with release_candidate . |
4000003 | 指定したAmazon商品タイプが無効であるか、またはサポートされていません。 | 指定したAmazon商品タイプが無効であるか、またはサポートされていません。 商品タイプ定義 オペレーションを使用して、商品タイプが有効であることを確認する必要があります。注: 商品タイプ定義 オペレーションでは、親商品タイプに「ロールアップ」され、未ローンチのPTに「200」レスポンスが返されます。この場合、商品タイプ定義取得APIレスポンスでは、productType 属性が親PT(通常、PRODUCT )に設定されます。 |
For selling partners, select a valid Product Type. For vendors, ensure that you are authorized to sell for that Product Type prior to making the submission, as stated in Step 1 of the Product Type Definitions Use Case Guide. |
4005035 | 入力されているベンダーコードでは、このブランドを販売する資格がありません。ベンダーマネージャーに連絡して承認を受けてください。 | ベンダーのベンダーコードは、このブランドを販売する認可を受けていません。この問題を解決するには、Amazonの窓口にお問い合わせください。 | 入力されているベンダーコードでは、このブランドを販売する資格がありません。ベンダーマネージャーに連絡して承認を受けてください。 |
4005012 | attribute_name の入力値とベンダーコードが異なるASINに割り当てられています。 |
The SKU is already assigned to a different ASIN. A single vendor code + SKU can be assigned to only one ASIN. Raise a Contact Us case to Amazon to support with resolution. | や APIを使用して、SKUの既存のカタログデータをすべて表示するワークフローを構築します。 |
18280 | attribute_name の値にパーセントが含まれていません(例:「100%コットン」ではなく、「コットン」)。 |
この問題は、出品パートナーがfabric_type を求められる形式で指定していない場合、またはすでに不適切なfabric_type 値がコントリビューションカタログにある場合に発生します。 |
出品パートナーがリクエストにfabric_type 属性を指定した場合は、パーセント記号を入れて正しい形式にしてもらってください。出品パートナーがリクエストに fabric_type 属性を指定せず、それを設定したくないと考えている場合は、この属性をコントリビューションから削除することで問題を修正できます。 |
Updated 23 days ago