Las cuentas sin acceso a la beta recibirán una respuesta 403 Forbidden.
/catalogues
Este endpoint de la API de Lengow te permite gestionar tus catálogos de productos sin depender de importaciones manuales o actualizaciones basadas en la interfaz de usuario. Te permite:
Recuperar tus catálogos existentes y fuentes adicionales
Leer estructuras y atributos del catálogo
Listar, recuperar, crear, actualizar y eliminar un solo producto o un grupo de productos
Mantener tus datos de productos sincronizados continuamente desde tus sistemas (PIM, ERP, herramientas personalizadas)
La API de Catálogos NO soporta la creación de catálogos. Solo puede usarse para actualizar y modificar catálogos existentes.
La estructura del catálogo debe ser creada primero en la plataforma Lengow antes de poder gestionarse mediante la API.
Puedes actualizar tu catálogo vía API manteniendo la frecuencia de indexación programada configurada en la plataforma Lengow, según tus necesidades.
Importante: cuando se active una indexación programada, esta sobrescribirá cualquier actualización realizada previamente vía API.
Pruebas de la API de Catálogos en el Sandbox de Lengow
Puedes usar el Sandbox de Lengow para probar la API de Catálogos, abriendo una cuenta Sandbox aquí: https://my.lengow.net/registration
En tu cuenta Sandbox, añade tu catálogo. Luego, contacta con el equipo de Soporte de Lengow para solicitar acceso a la API de Catálogos (proporciona el ID de tu cuenta Sandbox en el ticket).
Las llamadas a la API pueden hacerse apuntando al entorno .net (sandbox) en lugar del habitual .io (producción).
Documentación de la API: https://api.lengow.io/docs/
Funciones soportadas por la API
| Función | Estado |
|---|---|
| Catálogos | |
| Listar catálogos y fuentes adicionales | ✅ Soportado |
| Obtener metadatos de catálogo o fuente adicional por catalogue_id | ✅ Soportado |
| Crear un catálogo | ❌ No soportado |
| Habilitar, deshabilitar, eliminar un catálogo | ❌ No soportado |
| Leer segmento | ❌ No soportado |
| Productos | |
| Listar productos en un catálogo | ✅ Soportado |
| Obtener un producto por product_id_key | ✅ Soportado |
| Crear o reemplazar productos (individual o en lote) | ✅ Soportado |
| Actualización parcial de 1 producto o grupo de productos (individual o en lote) | ✅ Soportado |
| Eliminar productos (individual o en lote) | ✅ Soportado |
| Recuperar reglas de optimización en datos de producto | ❌ No soportado |
| Atributos | |
| Listar atributos en un catálogo o fuente adicional | ✅ Soportado |
| Crear atributos | ❌ No soportado |
| Actualizar atributos | ❌ No soportado |
| Eliminar atributos | ❌ No soportado |
| Listar atributos de fuentes adicionales vía el catálogo principal | ❌ No soportado |
Conceptos clave
- catalogue_id
Las solicitudes API deben dirigirse a un catálogo específico usando su "catalogue_id".
- Listar catálogos es típicamente el primer endpoint a llamar ya que devuelve una lista de todos los catálogos principales y fuentes adicionales disponibles en la cuenta. Incluye el "catalogue_id" para cada uno, que se usa para todas las solicitudes posteriores.
- Obtener catálogo usa el "catalogue_id" para devolver los metadatos de un catálogo principal o fuente adicional (como su nombre, estado, product_id_key, etc.).
Ejemplo de respuesta para GET /catalogues/{catalogue_id} :
{
"catalogue_id": 95000,
"name": "Catálogo Principal",
"status": "enabled",
"product_id_key": "id_product",
"created_at": "2024-09-11T10:42:28.661555Z",
"updated_at": "2025-11-06T13:57:48.078126Z",
"indexed_at": "2025-11-06T13:57:49.571801Z",
"source": "link",
"products_count": 2134
}- product_id_key
Todas las operaciones API relacionadas con productos dependen del "product_id_key" (mostrado en la respuesta anterior).
El "product_id_key" se define en la configuración de tu catálogo en Lengow e identifica el campo que contiene el ID único del producto.
Para más información, consulta Mapeo inicial de atributos de producto
Al llamar a un endpoint de producto (por ejemplo, Obtener producto), debes proporcionar el valor del ID de producto almacenado en el campo del catálogo definido como product_id_key.
Resumen de endpoints de la API
| Operación | Propósito del Endpoint | Caso de Uso Típico | Comportamiento |
|---|---|---|---|
| Catálogos | |||
| Listar catálogos | Recuperar todos los catálogos y fuentes adicionales en la cuenta | Obtener el catalogue_id de un catálogo | Devuelve todos los catálogos accesibles en la cuenta |
| Obtener catálogo | Recuperar detalles del catálogo por catalogue_id | Obtener el product_id_key de un catálogo | - Devuelve información del catálogo como nombre, estado, product_id_key, etc. - Indica última actualización (modificación por usuario) y última indexación (recuperación por Lengow) |
| Atributos | |||
| Listar atributos | Recuperar la lista de atributos para un catálogo | Entender la estructura del catálogo | - Devuelve todos los nombres de campos presentes en el catálogo - Los atributos de fuentes adicionales no se muestran en el catálogo principal |
| Productos | |||
| Listar productos | Recuperar todos los productos de un catálogo | Explorar o exportar datos del catálogo | - Devuelve los productos disponibles en el catálogo, incluyendo todos los valores de atributos para cada producto - Las reglas de optimización añadidas en la plataforma Lengow no se muestran |
| Obtener producto | Recuperar un solo producto por product_id_key | Inspeccionar o depurar un producto | - Devuelve todos los valores de atributos para un solo producto - Se requiere product_id_key |
| Crear o reemplazar productos | Crear o sobrescribir completamente los datos del producto | Resincronización completa del catálogo | - Purgar y reemplazar: sobrescribe los datos existentes - Se requiere product_id_key - Disponible en modo individual o por lotes |
| Actualización parcial de productos | Actualizar solo campos seleccionados del producto | Actualizaciones de precio y stock | - Actualiza solo los campos proporcionados (los campos no especificados permanecen sin cambios) - Se requiere product_id_key - Disponible en modo individual o por lotes |
| Eliminar productos | Eliminar productos del catálogo | Eliminar productos obsoletos | - Elimina productos basados en product_id_key - Disponible en modo individual o por lotes |