SP API putListingsItem中merchant_suggested_asin字段异常问题求助

问题背景 #

调用SP API的putListingsItem接口创建TEMPORARY_TATTOO品类的新Listing时，merchant_suggested_asin被标记为必填字段，但按文档尝试多种填值方式均报错，无法完成接口调用。

尝试过的填值方式及报错情况 #

1. 填写"WPID||ASIN"格式值 #

提交的字段内容：

"merchant_suggested_asin": [
    {
        "value": "WPID||ASIN"
    }
],

返回错误（错误码8105）：

"issues": [
        {
            "code": "8105",
            "message": "The data you provided for an attribute is invalid. Please refer the data definitions and resubmit with a valid value.",
            "severity": "ERROR",
            "attributeNames": [
                "merchant_suggested_asin"
            ],
            "categories": [
                "INVALID_ATTRIBUTE"
            ]
        }
    ],

2. 填写随机10位数字（模拟ASIN格式） #

提交随机10位数字后，返回错误（错误码8541），提示Listing数据与亚马逊目录冲突：

"code": "8541",
            "message": "The Listing data provided is different from what's already in the Amazon catalog. The item_id provided matches ASIN 0000000000, but some of the listing data contradicts what is already in the Amazon catalog. The following listing attribute value(s) conflict with Amazon catalog value(s): 'item_name' (Merchant [\"100 PCS Two Fast Race Car Temporary Tattoos Stickers Theme 2nd Birthday Party Decorations Favors Supplies Decor 2 Fast Racing Checkered Tattoo Sticker Gifts For Boys Girls School Prizes Carnival\"] / Amazon [en_US: \"Finding Peaches in the Desert\", en_IN: \"Special Education Teachers Kit: The Cartography of Syntactic Structures, Volume 6\", en_GB: \"Ksiega Diny: The Cartography of Syntactic Structures, Volume 6 (Äldre Svenska Frälsesläkter)\" and 19 other variant(s) en_SG, en_CA, en_AE, en_AU, nl_NL, de_DE, fr_FR, pl_PL, es_ES, hi_IN, zh_CN, ja_JP, es_MX, fr_BE, pt_BR, sv_SE, it_IT, ar_AE, tr_TR]), 'customer_id' (Merchant [\"692323389502\"] / Amazon []). To fix the issue, please follow these steps 1) If the product you are listing is the same as 0000000000, then update your listing's 'item_name, customer_id' attribute(s) to match Amazon's catalog value, 2) If it's not the right ASIN, make sure the item_id provided is correct, or 3) If you disagree with the data in Amazon catalog contact Selling Partner Support to start the appeal process.",
            "severity": "ERROR",

3. 设为null或不填的矛盾点 #

根据字段Schema说明：

"merchant_suggested_asin": {
            "title": "Merchant Suggested ASIN",
            "description": "Provide an ASIN for your product if one exists. If a value is not provided, the system will attempt a match based on the External Product ID.",
            "examples": [
                "B007KQBXN0"
            ],
            "type": "array",
            "minItems": 1,
            "minUniqueItems": 1,
            "maxUniqueItems": 1,
            "selectors": [
                "marketplace_id",
                "value"
            ],
            "items": {
                "type": "object",
                "required": [
                    "marketplace_id",
                    "value"
                ],
                "properties": {
                    "value": {
                        "title": "Merchant Suggested ASIN",
                        "description": "Provide an ASIN for your product if one exists. If a value is not provided, the system will attempt a match based on the External Product ID.",
                        "editable": false,
                        "hidden": false,
                        "examples": [
                            "B007KQBXN0"
                        ],
                        "type": "string",
                        "minLength": 10,
                        "maxLength": 10,
                        "maxUtf8ByteLength": 40
                    },
                    "marketplace_id": {
                        "$ref": "#/$defs/marketplace_id"
                    }
                },
                "additionalProperties": false
            }
        }

文档描述提到「若不提供值，系统会尝试通过外部产品ID匹配」，但Schema明确要求minItems=1，且子项的value和marketplace_id均为必填，这就导致创建无现有ASIN的新Listing时陷入矛盾：不填字段不满足Schema校验，填无效值又报错。

内容的提问来源于stack exchange，提问作者Quoc Nguyen