Mercadolibre 问题处理

## Mercadolibre

### 刊登显示成功后，实际店铺后台并没有显示刊登的商品

回复：

```
美客多刊登的流程是：刊登全球成功 --> 发布站点成功 （用户后台才可以看到）！

用户后台看不到这个商品的原因是: 
当前商品只是全球刊登成功，而发布站点的时候失败了。而客户后台只能看到发布到站点成功的商品。
发布站点失败的商品需要在这里看：
```

![image-20230314194016584](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20230314194016584.png)

### 属性重复

```json
{
	"department": "items",
	"cause_id": 146,
	"type": "ERROR",
	"code": "item.attributes.invalid",
	"references": [
		"item.attributes",
		"item.variations.attribute_combinations",
		"item.variations.attributes"
	],
	"message": "Same attributes are used in more than of item.attributes, variation.attribute_combinations and variation.attributes",
	"custom_data": null
}
```

回复：

```
错误原因：属性主商品属性和变体属性重复
以前遇到几个都是因为：用户刊登了一个带变体的商品，刊登完成以后，拉下来在线商品变成了一个单品，用户在编辑的时候填了多变体，平台报错属性重复，是原来主商品属性和新添加的多变体属性重复！

需要产品优化，单品不支持修改为多品！
```

### 图片不能超过12张

```
Items in category CBT415256 cannot exceeds 12 pictures
```

回复：

```
查询类目详情，每个变体图片不能超过12张！变体传了图片以后，橱窗图自动会出来图片！
```

### 发布站点失败

```json
{
	"errors": "[{\"cause\":[\"Message: can not get key BRANDS-CBT_CN-MLB from cache;Error Code: internal_server_error;Status: 500;Cause: [Message: An error occurred ;Error Code: Internal Server Error;Status: 500;Cause: []]\"],\"message\":\"can not get key 1103415712-265673-ZELOTES F-35 VERTICAL WIRELESS CHARGING MOUSE 2.4G 2400DPI from cache\",\"error\":\"internal_server_error\",\"status\":500}]",
	"item_id": "",
	"logistic_type": "remote",
	"parent_id": "CBT1604118647",
	"site_id": "MLB"
}
```

回复：

```
 遇到这个问题，重新发布商品，这个平台的原因。
```

### 属性无效

```json
[{
	"cause": [],
	"message": "Attribute id is not valid",
	"error": "bad_request",
	"status": 400
}]
```

平台回复:

```
Developer Support Mercado Libre commented:

Hello!
Does this error keeps happening?
We are currently looking for this subject but we does not have any news about it.
Felipe
```

```
这个问题，Mercadolibre 官方也没找到原因，他们还在排查，只能等他们那边优化！
前段时间有用户遇到这个问题，重新发布好几次，也会发布成功！不过这个是偶发会成功！目前只能等平台修复这个问题！
用户只能把这个商品删掉，重新刊登一个新的商品试一下！
```

### 商品不被允许发布

```json
[{
	"cause": [{
		"code": "item.not_allowed",
		"cause_id": 5100,
		"department": "cbt-item-validation",
		"message": "You cannot offer this product in Chile.",
		"type": "error"
	}],
	"message": "validation error",
	"error": "validation_error",
	"status": 400
}]
```

平台回复：

```
Just confirming that we got your request ODDS-2628 [{\"cause\":[{\"code\":\"item.not_allowed\",\"cause_id\":5100,\"department\":\"cbt-item validation\",\"message\":\"You c
I can't understand item.not_allowed , why ? Thank you
We're on it.
Thank you!

I will check with our development team and as soon as I have new information, I will get back to you!
```

```
这个问题，Mercadolibre 官方回复没有任何有效信息，目前我们这边暂时没法处理！我这个已经反馈给产品！
用户只能把这个商品删掉，重新刊登一个新的商品试一下！
```

这是当时给平台提Case，平台回复的邮件：

![image-20230315143047640](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20230315143047640.png)

```
item.not allow 这个是平台那里限制的问题，这个类目的商品不允许在这个站点发布。
```

chatgpt的回答：

提问：Mercadolbre item.not_allowed

```
MercadoLibre 中的“item.not_allowed”错误消息通常意味着对发布您尝试销售的商品存在限制。这可能是由于多种原因造成的，例如：

您尝试发布的商品是 MercadoLibre 政策禁止的商品，例如武器、毒品、假冒商品或非法商品。

对于某些类型的项目，不允许或限制您尝试在其中列出项目的类别。

您尝试发布的国家或地区的商品可能存在法律或法规限制。

要解决此问题，您应该查看 MercadoLibre 的产品销售政策和法规，以确定是否有任何限制或要求适用于您的商品。您可能还需要检查在您尝试发布商品的国家或地区是否有适用于您的商品的任何法律或监管限制。

如果您认为您的商品被允许在 MercadoLibre 上销售，但仍然遇到“item.not_allowed”错误信息，您应该联系 MercadoLibre 的支持团队，询问错误信息的具体原因以及是否有任何办法解决问题。
```

### 发布站点失败:全球商品不存在，或者平台还在加载中，请稍后重新发布！

回复：

```
这个问题原因已找到，线上已于3.23晚上发布上线，请用户查看，后续如有其他问题，请及时反馈！
```

### 修改库存，报错图片不能超过12张

update stock, error message : Items in category CBT4283 cannot exceeds 12 pictures.

平台回复：

```
Hello team!

This error occurs when an item has registered a larger amount of pictures than allowed via PUMA - Massive Publication (remembering that PUMA does not perform picture validations), and when the item is created, it is not allowed to make changes to the item until this issue is resolved.

I recommend that you remove the necessary amount of pictures so that you can modify the same item again.

Felipe
```

```
当项目注册的图片数量超过通过PUMA - Massive Publication(记住PUMA不执行图片验证)所允许的数量时，就会发生此错误，并且当项目创建时，不允许对项目进行更改，直到此问题得到解决。

我建议您删除必要数量的图片，以便您可以再次修改相同的项目。
```

```
平台的意思是当图片超过限制以后，任何修改操作都不可以执行，只能去后台把图片删一些。
```

### 发布站点 restrictions_coliving 403

```
{
	"errors": "[{\"cause\":[\"restrictions_coliving\"],\"message\":\"seller.unable_to_list\",\"error\":\"User is unable to list.\",\"status\":403}]",
	"item_id": "",
	"logistic_type": "remote",
	"parent_id": "CBT1645346496",
	"site_id": "MLB"
}
```

```
[{
        "cause": ["restrictions_coliving"],
        "message": "seller.unable_to_list",
        "error": "User is unable to list.",
        "status": 403
}]
```

回复：

```
需要用户检查下店铺的状态，当前站点店铺被限制刊登了，需要联系下美客多客服核实下店铺状态。 
```

芒果店长错误回复原文：

>  https://help.mangoerp.com/article/1667801773008

chatgpt的回答：

提问：Mercadolibre seller.unable_to_list

```
MercadoLibre 中的“seller.unable_to_list”错误消息通常表示您的卖家账户存在限制或局限，阻止您在平台上发布商品。您的帐户无法列出项目的原因可能有多种，例如：

您的账户可能是新账户，尚未经过验证或获准在 MercadoLibre 上发布商品。

您可能违反了 MercadoLibre 的政策或服务条款，例如销售违禁或非法物品、在您的列表中使用不适当的语言或图像，或参与欺诈活动。

您的帐户信息或付款设置可能存在问题，需要先解决这些问题才能发布商品。

要解决此问题，您应该检查您的 MercadoLibre 账户信息和设置，以确保一切都是最新和准确的。您还应该查看 MercadoLibre 的政策和服务条款，以确保您符合所有要求。

如果您认为 MercadoLibre 方面可能存在错误或失误，您应该联系他们的支持团队，询问错误消息的具体原因以及是否有解决问题的方法。他们可能会就如何解决问题提供额外信息或指导，并让您的账户获准在平台上发布商品。
```

### The attributes [MODEL] are required for category

```
{
	"department": "items",
	"cause_id": 147,
	"type": "error",
	"code": "item.attributes.missing_required",
	"references": [
		"item.attributes",
		"item.variations.attribute_combinations"
	],
	"message": "The attributes [MODEL] are required for category CBT373770 and channel marketplace. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes."
}
```

刊登入参：刊登入参传了MODEL，但是平台报错。

```json
{
	"attributes": [{
			"id": "BRAND",
			"value_name": "leca"
		},
		{
			"id": "MODEL",
			"value_name": "连衣裙"
		},
		{
			"id": "GENDER",
			"value_name": "Woman"
		},
		{
			"id": "AGE_GROUP",
			"value_name": "Adults"
		},
		{
			"id": "IS_SPORTIVE",
			"value_name": "No"
		}
	]
}
```

解决办法：把中文换成英文，可以刊登成功！

```json
{
"id": "MODEL",
"value_name": "dress
}
```

```
回复：
用户这几个属性不全的商品，我都已经重新刊登，请用户看一下。

开始用户刊登失败的原因：属性里面Model字段，这个地方用户填的都是中文，平台报错说这个字段没传，我修改成了英文试了一下，目前都可以看到成功。

平台接口文档虽然没有指定语种，但是早好是用英文刊登。
```

### 刚授权完店铺，同步商品，显示店铺异常，请重新授权

![](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20230331095337858.png)

回复:

```
错误的原因：是用户刚授权完，就拉取在线商品。新授权店铺，最多等30分钟，授权那边定时器才会执行，这个店铺才可以用。
这个问题产品已知悉，目前已联系开发优化。
```

### 标题描述包含上市品牌，需要授权

```json
[{
	"cause": [{
		"code": "moderations.seller.not_authorized",
		"references": ["samsung", "https://global-selling.mercadolibre.com/help/20159"],
		"cause_id": 5102,
		"department": "moderations",
		"message": "To list this product you must provide the documentation and authorizations granted by samsung. Find all requirements in https://global-selling.mercadolibre.com/help/20159",
		"type": "error"
	}],
	"message": "validation error",
	"error": "validation_error",
	"status": 400
}]
```

回复：

```
错误原因：当前商家在美客多刊登的是三星的商品，但是没有在平台申请三星品牌的授权
平台给了一个帮助文档，给用户看一下：https://global-selling.mercadolibre.com/help/20159
解决办法：需要用户去后台去申请对应品牌的授权。
```

### 物流不支持 item.shipping.mode.not_supported

```json
[{
	"cause": [{
		"code": "item.shipping.mode.not_supported",
		"references": ["item.shipping.mode"],
		"cause_id": 5101,
		"department": "cbt-item-validation",
		"message": "You can't send the product in this kind of shipment in Chile.",
		"type": "error"
	}],
	"message": "validation error",
	"error": "validation_error",
	"status": 400
}]
```

chatgpt回复

提问：Mercadolibre item.shipping.mode.not_supported

```
MercadoLibre 中的“item.shipping.mode.not_supported”错误消息通常表示您尝试发布的商品不支持您尝试使用的运输模式。这可能是由于多种原因造成的，例如：

您尝试使用的运输方式不适用于您发布的商品类别或类型。

您尝试使用的运输方式不适用于您发布商品的地区或国家。

对于某些物品，例如易碎或易腐烂的物品，您可以使用的运输方式类型可能会有限制或限制。

要解决此问题，您应该查看 MercadoLibre 的运输方式政策和法规，以确定是否有任何限制或要求适用于您的商品。您可能还想检查是否有适用于您尝试使用的运输方式的任何法律或法规限制。

如果您认为您尝试使用的运输方式应该适用于您的商品，您应该联系 MercadoLibre 的支持团队，询问错误消息的具体原因以及是否有任何方法可以解决该问题。他们可能会提供更多信息或指导，说明如何解决问题并以适当的运输方式列出您的商品。
```

### 提交的尺寸和/或重量与包装的实际尺寸不符

```json
{
	"message": "Cannot update item CBT1661001879",
	"error": "validation_error",
	"status": 400,
	"cause": [{
		"department": "cbt-item-validation",
		"cause_id": 5125,
		"type": "ERROR",
		"code": "item.dimensions",
		"references": ["https://global-selling.mercadolibre.com/help/22213"],
		"message": "The submitted dimensions and/or weights do not correspond to real measurements of the package. You must use the correct dimensions of the package that you'll use to dispatch your product, as well as the net weight of the item. https://global-selling.mercadolibre.com/help/22213",
		"custom_data": null
	}]
}
```

回复：

```
遇到平台提示尺寸和重量不对，这个只需要去全球商品编辑的地方，把全球商品尺寸和重量改大，然后重新发布。

因为这个平台这里计算的是包裹的尺寸和重量，填太小平台不支持！
具体改多大，没有统一的标准，不同类目不一样。我们这边拿不到平台关于尺寸的具体限制，只能等平台报错以后，重新修改尺寸。

因为尺寸这个地方会涉及到后续的运输金额，尺寸填太大的话，后续运费太高，对商家不利！所以我们要找到一个刚好可以刊登成功,并且尺寸是最小的。
这里给一个大概的尺寸标准：30cm * 30cm * 30cm 50g，当然用户不用上来就设置这么大，可以从小到大试一下，如果报错就继续往上加尺寸和重量，如果成功可以了，然后重新同步一下单个商品信息。
```

### ERP 类目和站点类目不一致

站点商品：https://articulo.mercadolibre.com.mx/MLM-1476702881-juego-de-cubiertos-de-silicona-antideslizante-para-bebe-5pcs-_JM?vip_filters=shipping%3Afulfillment&skipInApp=true

后台类目和ERP全球类目不一致回复：

```
当前ERP只对接了美客多全球刊登，ERP中看到的类目都是全球类目。
用户的后台看到的类目是各个站点的类目，这两者不完全一样，有些类目是对应不上的。

解决办法: 
1、如果还是想用ERP全球刊登，只能换个类目刊登，换个其他类目可以和站点类目对上，这样才能发布到站点，用户才可以在后台看到这个站点商品！
2、直接使用本土刊登，目前我们这边产品还在规划这一部分内容，后续才会上，现在还没有。
```

#### no world-tree target category found for category CBT120351 and target site MLM

回复：

```
报错原因：当前ERP只对接了美客多全球刊登，刊登所使用的类目和属性也都是全球类目，现在的刊登流程是：1、使用全球类目刊登-> 2、发布到各个站点，现在报错的原因是第二步的时候，全球类目和站点的类目没有对应上，所以发布不成功。

解决办法: 
1、如果还是想用ERP全球刊登，只能换个类目刊登，换个其他类目可以和站点类目对上，这样才能发布到站点，用户才可以在后台看到这个站点商品！
2、直接使用本土刊登，目前我们这边产品还在规划这一部分内容，后续才会上，现在还没有。
```

### 全球商品没有包裹重量，发布站点失败

no value for attribute PACKAGE_WIDTH in cbt item CBT1690984789

从2023-05-19 开始发现这个问题，修改全球商品填了尺寸和重量，发现包裹长宽没生效，拉在线商品变体数据如下:

```
{
	"id": "PACKAGE_LENGTH",
	"name": "Package length",
	"value_id": null,
	"value_name": "40 cm",
	"value_struct": null,
	"values": [{
		"id": null,
		"name": "40 cm",
		"struct": {
			"number": 40,
			"unit": "cm"
		}
	}],
	"value_type": "number_unit"
}
```

前端拿的这个值：value_struct，里面没有值，所以没生效

然后把长宽变大以后，重新拉取在线商品，如下：

```
{
	"id": "PACKAGE_LENGTH",
	"name": "Package length",
	"value_id": null,
	"value_name": "40 cm",
	"value_struct": {
		"number": 40,
		"unit": "cm"
	},
	"values": [{
		"id": null,
		"name": "40 cm",
		"struct": {
			"number": 40,
			"unit": "cm"
		}
	}],
	"value_type": "number_unit"
}
```

value_struct 里面有值了，全球商品就正常了，可以重新发布站点

### 发布描述失败

回复:

```
美客多刊登的流程是：1、刊登全球成功 --> 2、发布站点成功 （用户后台才可以看到）！--> 3、发布站点描述

当前报错是由于第三步发生错误，所以用户在页面会看到这个错误提示！
目前我们ERP只对于前2步报错可以重新操作，第2步成功以后，用户后台已经可以看到这个商品了。
而对于第3步报错的商品，ERP目前不能单独操作第3步！这个商品其他信息已经有啦，只是没有描述，。所以只能用户去平台后台给这个商品添加一下描述。
```

### 物流模式错误 international_delivery_mode

```
[{
	"cause": [{
		"code": "body.invalid_field_types",
		"references": ["item.international_delivery_mode"],
		"cause_id": 101,
		"department": "items",
		"message": "invalid property type: [international_delivery_mode] expected one of [none, DDP, DDU] but was String value: DAP",
		"type": "error"
	}],
	"message": "body.invalid_field_types",
	"error": "validation_error",
	"status": 400
}]
```

回复：

```
这个问题前几天其他用户遇到过，当时我给平台提了case，问了平台，平台回复是：

他们已经反馈给他们技术团队了，有结果会再回复。请告知用户！
```

![image-20230628104608647](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20230628104608647.png)

##