Saltar al contenido principal

Publicación de Tienda

La entidad Publicación se utiliza para vincular un artículo de YiQi con una publicación en una tienda online, permitiendo gestionar información relacionada con precio, stock, estado de publicación, logística y datos propios de la integración.

Datos principales​

Para crear o mantener una publicación se deben considerar principalmente los siguientes datos:

  • Artículo: artículo/material de YiQi asociado a la publicación.

  • Origen de pedido: tienda o integración relacionada con la publicación.

  • Lista de precios: lista utilizada para obtener el precio de publicación.

  • Id de Mercado Libre: identificador de la publicación cuando corresponde a Mercado Libre.

  • Variants id / Inventory id / User Product ID: datos utilizados para identificar variantes, inventario o stock en publicaciones específicas.

  • Canal y Tipo de logística: información asociada a la modalidad de publicación y despacho.

  • Estado de la publicación: permite visualizar el estado informado o procesado por la tienda.

Precio​

La publicación toma el precio según la lista de precios configurada. Si la publicación no tiene una lista asignada, se utiliza la lista configurada en el origen de pedido.

También se registran datos como:

  • Precio actual.

  • Precio variante.

  • Último precio publicado.

  • Diferencia entre el precio actual y el último precio publicado.

  • Precio informado por la tienda, con o sin promoción.

Si se marca No actualizar precio, el sistema no impactará cambios de precio en la tienda online.

Stock​

La publicación calcula el stock a informar tomando en cuenta el stock disponible en las ubicaciones configuradas para el origen de pedido.

Dentro de la publicación se pueden visualizar o configurar datos como:

  • Stock real.

  • Stock mínimo.

  • Stock máximo.

  • Stock publicación.

  • Stock informado por la tienda.

  • Stock propio.

  • Stock externo.

  • Stock en tránsito.

  • Umbral de stock.

El umbral de stock define un mínimo requerido para que el producto continúe publicado. Si el stock disponible es menor o igual al umbral, el sistema considera el stock como 0. Si la publicación tiene un umbral propio, este tiene prioridad sobre el definido en el origen de pedido.

Si se marca No actualizar stock, el sistema no impactará cambios de stock en la tienda online.

Dimensiones​

La publicación permite registrar dimensiones del producto y del envío:

  • Alto.

  • Ancho.

  • Largo.

  • Volumen.

  • Peso.

Estos datos pueden utilizarse para completar información logística o de envío según corresponda.

Publicaciones de Mercado Libre​

Para publicaciones de Mercado Libre, el sistema puede utilizar datos específicos como:

  • Id de Mercado Libre.

  • Variants id.

  • Inventory id.

  • User Product ID.

  • Tipo de logística.

  • Estado de publicación.

  • Stock informado.

  • Stock en tránsito.

  • Link de la publicación.

En el flujo de creación de publicaciones de Mercado Libre se ajustó la funcionalidad para utilizar el flujo actual requerido por la plataforma.

Los principales ajustes realizados fueron:

  • Se actualizó el endpoint utilizado para obtener la categoría sugerida.

  • Se corrigió el envío de category_id para que se informe como un identificador válido de categoría.

  • Se adaptó el payload de creación al formato actual requerido por Mercado Libre.

  • Se incorporaron atributos sugeridos y obligatorios de la categoría.

  • Se utilizó el campo ID Universal del artículo para completar el GTIN cuando corresponde.

  • Se informó la alícuota de IVA del artículo.

  • Se normalizó el precio a 2 decimales para evitar rechazos por precisión inválida.

Con estos cambios, la creación de publicaciones desde YiQi hacia Mercado Libre quedó operativa.

Luego de crear una publicación, Mercado Libre puede devolver estados o advertencias propias de su procesamiento, por ejemplo procesamiento pendiente de imágenes o advertencias de logística/envío. Estas situaciones deben revisarse según el mensaje informado por la tienda, ya que no siempre implican un error de creación de la publicación.

Estados y acciones​

La entidad cuenta con eventos relacionados con:

  • Publicar.

  • Pausar publicación.

  • Obtener JSON.

  • Actualizar publicación.

  • Actualizar umbral de stock.

  • Impactar precio y stock en tiendas online.

También se registran logs de actualización de precio y stock, junto con posibles causas de problemas informadas por el sistema.

Logs e información de control​

La publicación guarda información de seguimiento para facilitar el diagnóstico:

  • Última fecha de actualización de precio.

  • Log de actualización de precio.

  • Causa de problema de precio.

  • Última fecha de actualización de stock.

  • Log de actualización de stock.

  • Causa de problema de stock.

  • Tags.

  • JSON de la publicación.

Estos datos permiten revisar qué información se envió o recibió desde la tienda y detectar problemas de sincronización, publicación, precio o stock.

Creación de publicaciones desde YiQi a Mercadolibre

Este instructivo describe las distintas formas de generar publicaciones de Mercado Libre desde YiQi y los requisitos necesarios para que la publicación se cree correctamente.

Requisitos previos

Antes de generar una publicación en Mercado Libre, verificar que el artículo cuente con la siguiente información:

  • SKU informado.

  • Nombre del artículo.

  • Precio mayor a cero en la lista de precios seleccionada.

  • Stock disponible.

  • Al menos una imagen asociada al artículo.

  • Marca informada.

  • Código Universal (GTIN/EAN), cuando la categoría de Mercado Libre lo requiera.

  • Alícuota de IVA configurada.

  • Impuesto interno/importación configurado, en caso de corresponder.

Importante: Mercado Libre puede solicitar atributos adicionales según la categoría seleccionada. En esos casos, YiQi requerirá completar dicha información antes de generar la publicación.

Cómo crear publicaciones

YiQi permite generar publicaciones en Mercado Libre de dos maneras diferentes:

1) Generar publicaciones desde el botón Publicar​

Esta opción permite generar publicaciones de uno o varios artículos sin necesidad de ingresar a la ficha de cada artículo.

Pasos​

  1. Ingresar al módulo Artículos.

  2. Seleccionar uno o varios artículos utilizando la casilla de selección.

  3. Presionar el botón Publicar ubicado en el menú lateral izquierdo.

  4. Seleccionar la Lista de Precios que se utilizará para obtener el precio de publicación.

  5. Seleccionar el Origen del Pedido.

  6. Confirmar la operación.

YiQi generará automáticamente las publicaciones en Mercado Libre para todos los artículos seleccionados.

2) Generar una publicación desde la solapa Publicación​

Esta opción permite configurar los datos de publicación directamente desde la ficha del artículo.

  1. Ingresar al módulo Artículos.

  2. Buscar y abrir el artículo que desea publicar.

  3. Acceder a la solapa Publicación.

  4. Seleccionar la Lista de Precios que se utilizará para obtener el precio de la publicación.

  5. Seleccionar el Origen del Pedido que se asociará a las ventas recibidas desde Mercado Libre.

  6. Completar los datos requeridos para la publicación.

  7. Guardar los cambios.

  8. Presionar el botón Publicar para generar la publicación en Mercado Libre.

Campos que no deben completarse​

Al crear una nueva publicación, los campos de la sección "Para publicaciones existentes" deben permanecer vacíos, ya que son completados automáticamente por Mercado Libre una vez creada la publicación.

Los siguientes campos no deben completarse manualmente:

  • ID

  • Variant ID

  • Inventory ID

  • Canal

  • Tipo de Logística

  • User Product ID

Una vez creada la publicación, Mercado Libre devolverá automáticamente estos datos al sistema.

¿Cómo verificar si la publicación se generó correctamente?

Una vez iniciada la creación de la publicación, es posible verificar el resultado desde la Publicación.

Revisar el estado de publicación​

Ingresar a la solapa Publicación y revisar el estado:

  • Si la publicación se generó correctamente, la misma quedará vinculada al artículo.

  • Si el campo muestra el estado Error, revisar el campo estado de publicación donde se informará el motivo por el cual Mercado Libre rechazó la creación de la publicación, indicando la información faltante o incorrecta que debe corregirse.

Una vez corregida la información indicada, podrá volver a intentar la creación de la publicación.

Consideraciones importantes

  • Mercado Libre puede dejar la publicación temporalmente en estado Pausada mientras procesa las imágenes asociadas al producto.

  • Este comportamiento es normal y no representa un error en la creación de la publicación.

  • Algunas categorías requieren atributos obligatorios definidos por Mercado Libre. Si faltara información, el sistema solicitará completarla antes de publicar.

  • Los datos de identificación de la publicación son informados automáticamente por Mercado Libre luego de la creación.

  • El precio publicado dependerá de la Lista de Precios seleccionada.

  • El stock publicado dependerá de la configuración del canal y del stock disponible para el artículo.