Consultar información de categorías y atributos de los marketplaces vía API

Consultar las categorías de los Marketplaces:

Cada Marketplace (como Mercado Libre, Amazon o Walmart) posee su propio árbol de categorías, y este endpoint es la herramienta que te permite consultar ese listado de forma precisa según el canal y el país.

El endpoint Get Marketplaces Categories permite obtener el catálogo oficial de categorías disponibles para una conexión específica.

Para que la consulta sea exitosa, debes reemplazar los siguientes parámetros:

:channel: El nombre del canal técnico. Algunos ejemplos son: mercadolibre, amazon, walmart, fcom (Falabella), tiktok, entre otros.

:marketplace_connection_id: El identificador único de la tienda que has vinculado en Multivende.

:country: El código de dos letras (ISO) del país correspondiente: cl (Chile), br (Brasil), mx (México), pe (Perú), co (Colombia), uy (Uruguay).

Estructura de la Respuesta (Response)
La API responderá con un arreglo (array) de objetos JSON. Cada objeto representa una categoría y contiene dos campos clave:

id: El identificador alfanumérico único de la categoría (este es el valor que debes usar para mapear productos).

name: El nombre legible de la categoría (ej. "Ropa", "Electrónica").

Consulta de Atributos de Categoría

Este recurso permite recuperar la lista completa de campos (atributos) que componen una categoría específica: Get Marketplaces categories attributes

Parámetros de Ruta (Path Variables)
:marketplace_connection_id: El identificador único de tu conexión de Mercado Libre en Multivende.

:category_id: El ID de la categoría que deseas consultar (obtenido previamente con el endpoint de categorías).

Estructura de la Respuesta (ejemplo Mercadolibre) 
La API devuelve un arreglo de objetos, donde cada uno detalla un atributo y sus reglas de validación. Los campos más importantes para tu lógica de integración son:

tags: Contiene metadatos cruciales.

required: Si es true, el producto no se publicará si este campo está vacío.

catalog_required: Indica si es obligatorio para participar en el catálogo de Mercado Libre.

value_type: Define el tipo de dato (ej. string, number, list).

values: Si el atributo es de tipo lista, aquí encontrarás los IDs y nombres de las opciones permitidas (ej. "Rojo", "Azul").

Consulta de Mapeos de Atributos

Permite validar la configuración del mapeo de atributos en la conexión con el marketplaces mediante el endpoint: Get Marketplaces attributes mappings

Variable de Ruta (Path Variable)
:marketplace_connection_id: Es el identificador único de la conexión de Marketplace que deseas consultar. Debes reemplazar este marcador con el ID real de la tienda vinculada.

Si en la respuesta del endpoint el campo "MarketplaceConnectionAttributeMappings" llega con información, indica que el atributo se encuentra mapeado, si llega vacío entonces el atributo no está mapeado hacia el canal de venta.

Equipo Integraciones API Multivende