Revision: 4a460f7def

Create Wiki Page

Restore Revision

Administrator edited on 27 may 2022, 14:10:31

@@ -0,0 +1,130 @@
+> Solo quienes hayan contratado el módulo Mercadolibre tendrán acceso a esta funcionalidad.
+>
+> La cantidad de Publicaciones vinculadas que se puede tener en el sistema dependerá del plan contratado.
+
+Una **Publicación de Mercadolibre** es un documento dentro de DiamoERP que representa una publicación existente en Mercadolibre.
+
+Estas no pueden ser creadas manualmente desde el ERP, sino que son sincronizadas desde MercadoLibre.
+Desde el sistema se podrá manejar la cantidad y el precio de la publicación que se mostrará en Mercadolibre.
+
+
+Para acceder a la lista de Publicación de Mercadolibre, ir a:
+> Inicio > Integraciones > Mercadolibre > Publicación de Mercadolibre
+
+![Listado de publicaciones](https://raw.githubusercontent.com/federicocalvo/DiamoERP-images/main/doc/ecommerce/publicacion-de-mercadolibre-listado.png)
+
+## 1. Prerrequisitos
+Para poder sincronizar publicaciones se deberá contar con:
+
+1. la [Cuenta de Mercadolibre](/doc/ecommerce/cuenta-de-mercadolibre) creada y autorizada en el ERP.
+2. [Productos](/doc/almacen/producto), los cuales serán vinculados a las publicaciones.
+
+> Nota: si se define un SKU en la publicación en Mercadolibre y este coincide con el Código de producto de alguno de los que se encuentran en el ERP, al 
+crearse la Publicación de Mercadolibre, dicho producto se vinculará automáticamente a la misma.
+
+## 2. Sincronización de Publicaciones
+
+Las publicaciones de MercadoLibre serán **creadas o actualizadas en el ERP** cada vez que:
+
+- Se sincronice la Cuenta a la que pertenecen por medio del botón **Sincronizar**.
+- MercadoLibre envíe una notificación perteneciente a dicha publicación; esto sucede cada vez que se cambian datos de una publicación, cuando se crea una 
+nueva o cuando ingresa una Orden de venta.
+
+Los datos de **precio y stock se enviarán a Mercadolibre** cada vez que:
+
+- Se **modifique el precio/stock de Productos** vinculados a Publicaciones con la opción Sincronizar precio/cantidad.
+- Se **modifiquen configuraciones de la Publicación**, como cambiar el producto o tildar la opción Sincronizar precio/cantidad en una publicación que tenía estas 
+opciones deshabilitadas.
+- Se **modifiquen configuraciones de la Cuenta** como Almacenes, Lista de precios, Agregar IVA, etc; ya que estas opciones afectan la forma en que se calculan dichos 
+valores.
+
+### 2.1 Creación de Publicaciones
+
+Cuando se crea una publicación en el ERP, se hace con los siguientes datos obtenidos desde MercadoLibre:
+
+* **ID de publicación en MercadoLibre**: este dato se verá en el nombre del documento, el cual estará conformado por el _Site ID_ + _ID de publicación en 
+MercadoLibre_. Ej: MLA1113582677.
+* **Estado**: los estados posibles de una Publicación en Mercadolibre son: Activa, Pausada, Cerrada, Inactiva, Falta activar, Falta pagar, En revisión.
+ Una publicación puede estar creada en el ERP y con estado Activa; pero no se la considerará para sincronizar datos y ventas a menos que la misma esté 
+correctamente vinculada. De no estarlo, aparecerá un mensaje en la publicación advirtiéndolo. Una publicación está correctamente vinculada cuando:
+
+ * Tiene asignados los Productos requeridos.
+ * Dichos productos están Habilitados y son para la venta.
+ * La Publicación no quedó fuera del límite máximo de publicaciones definido por el plan contratado.
+
+* **Título**: es el mismo título que posee la publicación en Mercadolibre.
+* **Imagen**: se toma la imagen principal de la Publicación.
+* **Producto/Listado de variantes**: si la publicación en Mercadolibre poseía variantes, en el ERP la publicación tendrá una tabla donde cada fila contendrá los datos
+que distinguen cada variante (estos atributos no pueden ser modificados desde el ERP). Aquí se debe completar con los Productos correspondientes.
+
+ ![Publicación con variantes](https://raw.githubusercontent.com/federicocalvo/DiamoERP-images/main/doc/ecommerce/publicacion-de-mercadolibre-con-variantes-2.png)
+ Si la publicación no posee variantes, aparecerá un campo Producto donde se deberá seleccionar el indicado.
+ ![Publicación sin variantes](https://raw.githubusercontent.com/federicocalvo/DiamoERP-images/main/doc/ecommerce/publicacion-de-mercadolibre-sin-variantes-2.png)
+ En ambos casos, los productos que aparecerán para vincular deberán:
+    - estar habilitados
+    - ser de venta
+    - poseer tildada la opción Mantener stock (a menos que sea el Producto Principal de un [Conjunto / paquete de productos](/doc/ventas/paquete-de-productos))
+    - no ser plantillas
+* **Sincronizar cantidad/precio**: estas opciones aparecerán tildadas/destildadas por defecto según lo configurado en la cuenta. Luego se las puede modificar 
+en cada publicación. Para que se sincronicen estos datos desde el ERP hacia Mercadolibre, deben estar tildadas.
+* **Cuenta**: Cuenta de Mercadolibre a la cual pertenecen.
+
+
+**Información complementaria**
+
+Estos datos son meramente informativos y no pueden ser modificados desde el ERP.
+
+- Categoría
+- Precio y cantidad disponible de la publicación
+- Se muestra en catálogo
+- Exposición
+- Calidad
+- Modo de envío
+- Tipo de logística
+
+### 2.2 Actualización de Publicaciones
+
+Si al momento de sincronizar se detecta que ya existe una publicación con el mismo id, se actualizará la existente en lugar de crear una nueva. Los campos 
+que se actualizarán serán los siguientes (en caso de que hayan cambiado):
+
+- Titulo de la publicación
+- Imagen
+- Datos de variantes
+- Precio y cantidad disponible de la publicación
+- Estado en MercadoLibre
+- Información complementaria
+
+### 2.3 Sincronización de precio y cantidad
+
+Una vez que se tiene la Publicación de Mercadolibre correctamente configurada, se enviarán desde el ERP a Mercadolibre automáticamente el precio y la cantidad.
+
+Estos datos son obtenidos del Producto vinculado a la Publicación:
+
+- se tomará el último **Precio de producto** creado para dicho Producto en la Lista de precios configurada en la Cuenta de mercadolibre. A este se le agregará el
+importe del IVA si así está configurado en la [Cuenta](/doc/ecommerce/cuenta-de-mercadolibre#33-sincronizacion-de-ventas).
+- se tomará la suma del **stock del Producto** en los Almacenes definidos en la Cuenta de Mercadolibre. Si se seleccionan almacenes padre, se tomará el stock de
+todos los almacenes hijos.
+
+Consideraciones:
+
+- si se elige una Lista de precios en una moneda diferente a pesos, el valor será convertido ya que en Mercadolibre debe estar en dicha moneda.
+Esto se realizará tomando el Tipo de cambio definido en el ERP o, de no encontrar uno, se usará el valor de cotización de mercado.
+- en Mercadolibre, las publicaciones con variantes no pueden tener diferentes precios por variante; por lo que al sincronizar este dato desde el ERP, se
+considerará el mayor precio de todas las variantes en la publicación.
+- en Mercadolibre, algunas categorías tienen un precio mínimo y máximo, así como una cantidad mínima y máxima. En caso de que el precio/stock definido en el 
+ERP esté fuera este rango, el mismo no se actualiza.
+- solo se sincronizará precio y stock de publicaciones correctamente vinculadas. Una publicación no se considerará vinculada en los siguientes casos:
+    - no posee Producto.
+    - el producto vinculado fue deshabilitado o ya no es apto para venta.
+    - se alcanzó el límite de publicaciones permitido según el plan contratado.
+
+
+## 3. Acciones desde la Publicación
+
+* **Ver en Mercadolibre**: este botón lleva a la vista final de la publicación en Mercadolibre.
+* **Pausar/Activar**: hacer click en este botón cambiará el estado de la publicación en Mercadolibre, de Activa a Pausada o viceversa.