Publicaciones
En esta sección podrás informarte de como realizar una publicación en un canal externo, Marketplace o tienda de e-Commerce
Última actualización
En esta sección podrás informarte de como realizar una publicación en un canal externo, Marketplace o tienda de e-Commerce
Última actualización
Generar un publicación puede ser un proceso complejo, cada canal tiene sus especificaciones y requerimientos. Ventiapp se encargará de facilitar la tarea de mapeo de datos hacia los canales, pero estos pueden estar en constante actualización. Será trabajo del desarrollador tener una correcta gestión del mapeo de categorias y atributos para las publicaciones de cada canal.
Es importante que el flujo de datos para la integración sea correcto, a continuación el diagrama correcto
Actualmente esta funcionalidad está disponible solamente para Mercado Libre
GET
https://ventiapi.azurewebsites.net/api/listing/getOptions
Este metodo brindará las opciones disponibles para realizar una publicación, sin estas opciones no podrás continuar en el paso de Listing Create
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
POST
https://ventiapi.azurewebsites.net/api/listing/create
Este método es utilizado para crear una nueva publicación, es necesario que tenga todas las opciones requeridas por el canal.
A pesar de que los parámetros id y parentSku son opcionales, al menos uno de los dos debe ser enviado para poder publicar el producto.
Canales disponibles
Mercado Libre - "meli"
Shopify - "shopify"
Magento - "magento"
GET
https://ventiapi.azurewebsites.net/api/listing/GetRequiredAttributes
Los atributos devueltos pueden ser de dos tipos:
Con valores predeterminados. Este tipo de atributos cuenta con un array de valores (values) que determinan los valores válidos para este atributo (véase response body). El campo freeValues viene como false.
Con valor libre. Este tipo de atributo acepta cualquier valor tipo string. El campo freeValues viene como true.
Descripción de los campos de los atributos
id. Identificador del atributo. Sirve para identificar un atributo al usar el endpoint UpdateAttributes.
name. Campo informativo que representa el nombre del atributo.
values. Lista de valores permitidos para el atributo. En caso de que el campo freeValues sea true y haya una lista de valores, la lista es sólo una lista de sugerencias.
freeValues. Este campo determina si el atributo puede recibir cualquier valor o necesita ser tomado de una lista de atributos determinada. Si el valor es true, se puede colocar cualquier valor cuando se actualiza un atributo determinado, en caso de ser false, el valor debe ser tomado de la lista de valores perteneciente al atributo.
Canales disponibles
Mercado Libre - "meli"
Magento - "magento"
POST
https://ventiapi.azurewebsites.net/api/listing/UpdateAttributes
Actualiza los atributos de las publicaciones en Mercado Libre.
Descripciones de los campos contenidos dentro de la lista "values":
id. Identificador del atributo obtenido en el endpoint GetRequiredAttributes.
value. Valor del atributo. En caso de que sea un atributo con valores predeterminados (Ver endpoint GetRequiredAttributes) Se necesita llenar con el campo id de algún elemento seleccionado de la lista, en caso de ser un atributo con valor libre se puede llenar con cualquier valor
Canales disponibles
Mercado Libre - "meli"
Magento - "magento"
Esta sección engloba los procesos relacionados a las guías de tallas
GET
https://ventiapi.azurewebsites.net/api/Listing/GetSizeChartOptions
Este recurso obtiene las variables disponibles para crear una guía de talla (Creación de guía de talla pendiente)
GET
https://ventiapi.azurewebsites.net/api/Listing/GetAllSizeCharts
Obtiene todas las guías de talla creadas por el usuario de la cuenta de Mercado Libre
GET
https://ventiapi.azurewebsites.net/api/Listing/GetSizeChartItems
Este recurso obtiene las publicaciones utilizadas para una guía de talla específica
POST
http://ventiapi.azurewebsites.net/api/Listing/ApplySizeChart
Este recurso asigna una guía de talla específica a una lista de publicaciones
Esta sección engloba los procesos de actualización de status de las publicaciones
GET
https://ventiapi.azurewebsites.net/api/listing/changestatuspub
Este método cambia el status de las publicaciones asignadas a determinados productos. Esta función está disponible por ahora sólo para Mercado Libre
GET
https://ventiapi.azurewebsites.net/api/listing/Search
Este método busca algún producto que cuente con publicaciones y sus variaciones.
Canales permitidos:
Amazon "amazon"
Claroshop "claroshop"
Elektra "elektra"
Linio "linio"
Mercado Libre "meli"
Mercado Shops "mshops"
Prestashop "prestashop"
VentiCommerce "venticommerce"
Vtex "vtex"
Walmart "walmart"
Wish "wish"
WooCommerce "woocommerce"
Liverpool "liverpool"
WalmartEDI (México) "walmartEDI"
Amazon (Estados Unidos) "amazonUS"
Walmart (Estados Unidos) "walmartUS"
TiendaNube "tiendanube"
Magento "magento"
Bestbuy (Canadá) "bestbuyca"
Cyberpuerta "cyberpuerta"