A veces se producen errores de integración de stock en los marketplaces para los que VTEX ha desarrollado un conector nativo. Este artículo reúne los errores más frecuentes de integración de stock con Mercado Libre y explica cómo resolverlos.
Hay mensajes que identifican cuáles son los errores. Puedes verlos en el Admin VTEX, en MARKETPLACE > Conexiones > Stock, haciendo clic en el mensaje de proceso con error.
Después de resolver un error, debes volver a procesar manualmente la integración del stock del SKU en cuestión. Esto se hace en el mismo lugar donde se muestra el error, haciendo clic en Acciones > Reprocesar.
A continuación se muestran los principales mensajes de error de integración de stock con Mercado Libre:
Mensaje de error
Mensagem de erro não mapeada pela integração. Entre em contato com a VTEX informando o ocorrido para que o mapeamento seja realizado. Mensagem no Mercado Livre: Validation error. Is not possible to activate an item without stock.
Mensaje traducido: Mensaje de error no mapeado por la integración. Ponte en contacto con VTEX informando de lo sucedido para que se pueda realizar el mapeo. Mensaje en Mercado Libre: Error de validación. No se puede activar un ítem sin stock.
La causa más común del error es la falta de stock, y en Mercado Libre no se puede activar un ítem sin stock. Por lo tanto, se debe actualizar la cantidad de los SKU en stock y volver a procesar el error. Si el error persiste tras volver a procesarlo de forma manual, otra posible causa es que el SKU esté inactivo. Verifica el status del SKU en tu Admin, en Catálogo > Productos y SKU. Una tercera posibilidad es que el ítem no esté correctamente marcado en la colección o en la política comercial definida para Mercado Libre. Si es necesario, consulta el artículo Asociación de SKU a una política comercial.
Mensaje de error
Mensagem de erro não mapeada pela integração. Entre em contato com a VTEX informando o ocorrido para que o mapeamento seja realizado. Mensagem no Mercado Livre: ProductId not found.
Mensaje traducido: Mensaje de error no mapeado por la integración. Ponte en contacto con VTEX informando de lo sucedido para que se pueda realizar el mapeo. Mensaje en Mercado Libre: ProductId no encontrado.
Para que un ítem se integre a Mercado Libre, al rellenar los campos de registro de este producto es necesario que las opciones Mostrar en la tienda y Mostrar producto agotado estén activadas. De lo contrario, los SKU de este producto no se integrarán a Mercado Libre.
Mensaje de error
Estoque não atualizado pois o anúncio no Mercado Livre está finalizado.
Mensaje traducido: Stock no actualizado porque el anuncio en Mercado Libre está finalizado.
Hay diferentes razones para que Mercado Libre considere un anuncio como finalizado. Por ejemplo, puede que el periodo de publicación del anuncio haya finalizado, o puede que el anuncio incumpla la política del marketplace.
No es posible actualizar el stock de los anuncios finalizados en Mercado Libre. Para saber por qué se ha finalizado un anuncio, ponte en contacto con Mercado Libre. Para más información, consulta la documentación de Mercado Libre sobre ayuda con los anuncios.
Mensajes de error
Não é possível atualizar um anúncio que está sob revisão pelo Mercado Livre. Mensagens no Mercado Livre: Cannot update item XXX [status:under_review, has_bids:false] variations is not modifiable.
Mensaje traducido: No se puede actualizar un anuncio que está en proceso de revisión por parte de Mercado Libre. Mensajes en Mercado Libre: No se puede actualizar el ítem. No es posible modificar las variaciones.
Não é possível atualizar um anúncio que está sob revisão pelo Mercado Livre. Mensagens no Mercado Livre: Cannot update item XXX [status:under_review, has_bids:false] available quantity is not modifiable.
Mensaje traducido: No se puede actualizar un anuncio que está en proceso de revisión por parte de Mercado Libre. Mensajes en Mercado Libre: No se puede actualizar el ítem. No es posible modificar la cantidad disponible.
«Under review» significa «en revisión», es decir, Mercado Libre está revisando el anuncio porque ha violado las condiciones requeridas. En los mensajes anteriores, por ejemplo, es posible que algunos datos de registro se hayan rellenado incorrectamente. Cuando un anuncio está en revisión en Mercado Libre, no es posible integrar el stock. Para solucionar el problema, ponte en contacto con Mercado Libre.
Mensaje de error
Mensagem de erro não mapeada pela integração. Entre em contato com a VTEX informando o ocorrido para que o mapeamento seja realizado. Mensagem no Mercado Livre: The caller is not authorized to access this resource.
Mensaje traducido: Mensaje de error no mapeado por la integración. Ponte en contacto con VTEX informando de lo sucedido para que se pueda realizar el mapeo. Mensaje en Mercado Libre: El autor de la llamada no está autorizado a acceder a este recurso
Este mensaje significa que el usuario está suspendido y, por lo tanto, su autorización para integrar el stock ha sido interrumpida. La suspensión puede ocurrir por varias razones, desde pagos pendientes a Mercado Libre hasta la expiración del token de integración. Solo Mercado Libre puede identificar la causa y resolver el problema, así que debes ponerte en contacto con el marketplace.
Mensaje de error
La cantidad disponible no es modificable en items con logistica Fulfillment
Cuando el seller elige el servicio Mercado Envíos Full, Mercado Libre es el responsable del fulfillment del pedido. En otras palabras, la logística de la entrega del producto al consumidor final es responsabilidad del propio marketplace. En este caso, Mercado Libre controla el stock, y VTEX no puede actualizar el stock para anuncios de este tipo.
Mensaje de error
The attributes [GTIN] are required for category. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes.
Mensaje traducido: Los atributos GTIN son obligatorios para la categoría. Verifica si el atributo está presente en la lista de atributos o en todas las variaciones attributes_combination o attributes.
También llamado EAN en VTEX, el GTIN es el código de identificación único de un SKU. Se trata del código de barras rellenado en el registro de SKU, y el mensaje indica que el GTIN es obligatorio para la categoría a la que pertenece el SKU. Si el código se ha rellenado incorrectamente o no es válido, el SKU no se integrará a Mercado Libre. Proporcionar el GTIN correcto de un producto es responsabilidad de los proveedores y fabricantes. VTEX no genera códigos de barras para suplir este escenario.
Mensajes de error
Error validating grant. Your authorization code or refresh token may be expired or it was already used.
Mensaje traducido: Error al validar la concesión. Tu código de autorización o token de actualización puede estar expirado o ya ha sido utilizado.
Error converting access token.
Mensaje traducido: Error al convertir el token de acceso.
Los mensajes indican que hay un problema con tu token. Mercado Libre puede considerar que un token no es válido por diferentes razones, como un periodo de caducidad expirado o una sospecha de amenaza a la seguridad, por ejemplo. Los asuntos relacionados con tokens deben tratarse directamente con Mercado Libre. Una vez resuelto el error, es necesario volver a autorizar la integración con Mercado Libre en el Admin VTEX. Si el error persiste, puede que sea necesario volver a configurar el registro del conector en el Admin VTEX y luego autorizar la integración otra vez.
Mensaje de error
User not active
Mensaje traducido: Usuario inactivo.
Un usuario puede ser desactivado en Mercado Libre por diversos motivos, desde haber rellenado incorrectamente los datos de registro hasta haber sido expulsado de la plataforma por una conducta incompatible con la política del marketplace. Para solucionar el problema, ponte en contacto con Mercado Libre.