【场景】将德国站点ASIN,跟卖到法意西站。对标后台/表格操作:填入已上架的德国站点ASIN➡️补充必填信息
【接口】putlisting-> "requirements": "LISTING_OFFER_ONLY"
【接口调用结果】
putlisting请求参数:
{
"listingsItemPutRequest": {
"attributes": {
"merchant_suggested_asin": [
{
"marketplace_id": "A1RKKUPIHCS9HS",
"value": "**********"
}
],
"purchasable_offer": [
{
"marketplace_id": "A1RKKUPIHCS9HS",
"our_price": [
{
"schedule": [
{
"value_with_tax": 149.99
}
]
}
]
}
],
"fulfillment_availability": [
{
"quantity": 0,
"fulfillment_channel_code": "DEFAULT"
}
],
"condition_type": [
{
"marketplace_id": "A1RKKUPIHCS9HS",
"value": "new_new"
}
],
"supplier_declared_dg_hz_regulation": [
{
"marketplace_id": "A1RKKUPIHCS9HS",
"value": "not_applicable"
}
]
},
"productType": "CABINET",
"requirements": "LISTING_OFFER_ONLY"
},
"sellerId": "西班牙店铺的SellerID",
"site": "ES",
"sku": "新的Seller SKU"
}
putlisting,response显示成功:
{
"issues": [
],
"sku": "新的Seller SKU",
"status": "ACCEPTED",
"submissionId": "**********************"
}
但用getlistingitem请求新的Seller SKU,响应错误:
{
"offers" : [ ],
"issues" : [ {
"severity" : "ERROR",
"code" : "13013",
"message" : "No se puede añadir tu SKU porque el producto no está en el catálogo o se ha eliminado. Comprueba los datos del producto, corrige cualquier error y vuelve a enviarlo con el UPC o el GTIN originales en lugar del ASIN sugerido. Si publicas un producto en otro sitio web, es posible que el listing tarde unas horas en estar disponible. Comprueba si hay algún problema o progreso en tu cuenta de vendedor."
}, {
"severity" : "ERROR",
"code" : "90220",
"message" : "Se requiere 'Nombre del producto' pero no se ha suministrado.",
"attributeNames" : [ "item_name" ]
} ],
"procurement" : [ ],
"fulfillmentAvailability" : [ ],
"attributes" : {
"purchasable_offer" : [ {
"marketplace_id" : "A1RKKUPIHCS9HS",
"audience" : "ALL",
"our_price" : [ {
"schedule" : [ {
"value_with_tax" : 149.99
} ]
} ],
"currency" : "EUR"
} ],
"condition_type" : [ {
"marketplace_id" : "A1RKKUPIHCS9HS",
"value" : "new_new"
} ],
"merchant_shipping_group" : [ {
"marketplace_id" : "A1RKKUPIHCS9HS",
"value" : "legacy-template-id"
} ],
"merchant_suggested_asin" : [ {
"marketplace_id" : "A1RKKUPIHCS9HS",
"value" : "**********"
} ],
"fulfillment_availability" : [ {
"quantity" : 18,
"fulfillment_channel_code" : "DEFAULT"
} ],
"supplier_declared_dg_hz_regulation" : [ {
"marketplace_id" : "A1RKKUPIHCS9HS",
"value" : "not_applicable"
} ]
},
"sku" : "新的Seller SKU",
"summaries" : [ ]
}
【问题】
这套方法,在店铺后台直接上架、店铺后台表格上架能成功,并且此前使用feed接口上架、同样的方法同站点跟卖上架能成功,但跨站点跟卖失败,有没有小伙伴遇到过类似的场景,是哪一步出错了,求解~~
看起来并不是“接口坏了”,而是没能在目标站点把你的 SKU 挂到同一个目录商品上,所以 LISTING_OFFER_ONLY
被系统判定为“没有找到可挂载的目录商品 → 走成了创建商品流(LISTING)”,于是返回了:
13013
:西语提示“该商品不在该站点目录或已被删除。不要用 建议 ASIN,要用原始 UPC/GTIN 再发一次。”90220
:既然被当成“创建商品”,就需要 item_name
等标题类必填字段,但你没传,所以报缺失。你的请求里最关键的一点是:
你只传了 merchant_suggested_asin
(“建议 ASIN”),这不会保证在 ES 站点成功匹配。如果该 ASIN 在西班牙站没有对应目录条目(或还没被跨站同步),SP-API 就无法把你挂到现有目录,于是走创建流并要求标题等信息。
LISTING_OFFER_ONLY
+ merchant_suggested_asin
,如果目标站点没有该 ASIN,系统就找不到“可挂”的目录 → 报 13013/90220。该 ASIN 在目标站点是否存在?
用 Catalog Items API(2022-04-01 版)查 GET /catalog/2022-04-01/items/{ASIN}?marketplaceIds=A1RKKUPIHCS9HS
。
productType
是否与该 ASIN 的 item_type_keyword 匹配?
你传的是 "productType": "CABINET"
。如果目标站点该 ASIN 实际的 product type 不是 CABINET,会导致校验偏离。
getDefinitionsProductType
(传 marketplace=ES、locale=es_ES)核对该 ASIN 的 item_type_keyword
,把 productType
改成目标站点实际的 product type。requirements: LISTING_OFFER_ONLY
下,只传报价/配送相关字段:价格(purchasable_offer
)、库存(fulfillment_availability
)、成色(condition_type
)、运费模板(merchant_shipping_group
)等。merchant_suggested_asin
不足以匹配。quantity: 0
,但响应里读回是 18——说明后面有别的系统/模板同步了库存。若想立即在 ES 站点上架,确保 quantity > 0
且有有效价格。前提:该 ASIN 在 ES 站点确实存在。
做法:
productType
改成与该 ASIN 在 ES 的 item_type_keyword 一致的值。requirements: LISTING_OFFER_ONLY
,并去掉一切创建商品用的字段(别传 item_name
等)。merchant_suggested_asin
可以保留,但不要指望它完成匹配,真正的匹配取决于该 ASIN是否在该站存在。若这样仍报 13013,基本就是该 ASIN 在 ES 没目录或暂未可售 → 用方案 B。
前提:该 ASIN 在 ES 不存在/不可售。
做法:
requirements: "LISTING"
(不是 OFFER_ONLY)。external_product_id
(+类型)、brand
/manufacturer
、item_name
、item_type_keyword
等。这与后台/表格成功的原理一致:它们也是用 GTIN 做跨站归并。
如果你常规要把 DE 的上架自动“推”到 FR/IT/ES,考虑用 Build International Listings 或后台的“跨国上架”功能,让系统负责在目标站点建立/映射目录,再由 API 只发报价和库存即可。
{
"listingsItemPutRequest": {
"attributes": {
"purchasable_offer": [{
"marketplace_id": "A1RKKUPIHCS9HS",
"our_price": [{
"schedule": [{ "value_with_tax": 149.99 }]
}],
"currency": "EUR"
}],
"condition_type": [{
"marketplace_id": "A1RKKUPIHCS9HS",
"value": "new_new"
}],
"fulfillment_availability": [{
"quantity": 18,
"fulfillment_channel_code": "DEFAULT"
}],
"merchant_shipping_group": [{
"marketplace_id": "A1RKKUPIHCS9HS",
"value": "legacy-template-id"
}]
/* 可选:supplier_declared_dg_hz_regulation 等 */
},
"productType": "<与该 ASIN 在ES的item_type_keyword一致>",
"requirements": "LISTING_OFFER_ONLY"
},
"sellerId": "ES店铺SellerID",
"site": "ES",
"sku": "你的SellerSKU"
}
item_name
、品牌等。merchant_suggested_asin
。这是提示性字段,不保证匹配。LISTING_OFFER_ONLY
。应改走 LISTING
+GTIN,或先用 BIL 建好。