Las cuentas sin acceso beta recibirán una respuesta 403 Prohibido.
/catalogues
Este punto final de la API de Lengow te permite gestionar tus catálogos de productos sin depender de importaciones manuales o actualizaciones basadas en UI. Te permite:
Recuperar tus catálogos existentes y fuentes adicionales
Leer estructuras de catálogo y atributos
Listar, recuperar, crear, actualizar y eliminar un solo producto o un grupo de productos
Mantén tus datos de producto continuamente sincronizados desde tus sistemas (PIM, ERP, herramientas personalizadas)
La API de Catálogos NO admite la creación de catálogos. Solo puede ser utilizada para actualizar y modificar catálogos existentes.
La estructura del catálogo debe crearse primero en la plataforma Lengow antes de que pueda ser gestionada a través de la API.
Actualizaciones de la API y Sincronización de Catálogos
Cuando un producto se actualiza a través de la API de Catálogos, el cambio se aplica inmediatamente dentro de Lengow. Dependiendo de tu arquitectura de datos, puedes elegir cómo interactúa la API con tus importaciones de catálogo estándar:
Opción 1: Actualizaciones de la API + Importaciones de catálogo programadas
Si tu catálogo también se sincroniza a través de una importación de archivo programada, la próxima actualización del archivo seguirá siendo la fuente autorizada de datos y sobrescribirá la información del producto con los valores contenidos en el último archivo.
En la práctica, este es un excelente flujo de trabajo siempre que los datos del producto en tu archivo fuente estén actualizados. Este mecanismo híbrido te permite impulsar datos urgentes (como caídas de stock) a través de la API durante el día, mientras que una actualización nocturna programada asegura que tu catálogo permanezca completamente alineado con tu fuente de datos principal y garantiza la consistencia en todos los productos.
Opción 2: Solo actualizaciones de la API
- ✓ Actualizaciones de productos en tiempo real
- ✓ Sin reconciliación programada
Si no necesitas una reconciliación basada en archivos de rutina y quieres que la API sea tu único mecanismo para la gestión de catálogos, puedes eliminar completamente las actualizaciones programadas. Para utilizar este modo, simplemente deja vacío el horario de sincronización del catálogo en la interfaz de Lengow.
Probando 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 de Sandbox aquí: https://my.lengow.net/registration
En tu cuenta de Sandbox, agrega tu catálogo. Luego, contacta al equipo de soporte de Lengow para solicitar acceso a la API de Catálogos (proporciona tu ID de cuenta de Sandbox en el ticket).
Las llamadas a la API se pueden hacer apuntando al entorno .net (sandbox) en lugar del habitual .io (producción).
Documentación de la API: https://api.lengow.io/docs/
Funciones de la API admitidas
| 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 | |
| Lista de productos en un catálogo | ✅ Soportado |
| Obtener un producto por product_id_key | ✅ Soportado |
| Crear o reemplazar productos (individual o en masa) | ✅ Soportado |
| Actualización parcial de 1 producto o un grupo de productos (individual o en masa) | ✅ Soportado |
| Eliminar productos (individual o en masa) | ✅ Soportado |
| Recuperar reglas de optimización en datos de producto | ❌ No soportado |
| Atributos | |
| Lista de 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 a través del catálogo principal | ❌ No soportado |
Conceptos clave
- catalogue_id
Las solicitudes de API deben dirigirse a un catálogo específico utilizando su "catalogue_id".
- Listar catálogos es normalmente el primer punto final 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 utiliza para todas las solicitudes posteriores.
- Obtener catálogo utiliza 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 de API relacionadas con el producto dependen del "product_id_key" (mostrado en la respuesta anterior).
El "product_id_key" se define en la configuración de su catálogo en Lengow e identifica el campo que contiene el ID de producto único.
Para más información, ver Mapeo inicial de atributos del producto
Al llamar a un punto final de producto (por ejemplo, Obtener producto), debe proporcionar el valor del ID del producto almacenado en el campo del catálogo definido como el product_id_key.
Resumen de los puntos finales de la API
| Operación | Propósito del punto final | 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 ctalogues accesible 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 la última actualización (modificación por el usuario) y la última indexación (recuperación por Lengow) |
| Atributos | |||
| Listar atributos | Recuperar lista de atributos para un catálogo | Entender la estructura del catálogo | - Devuelve todos los nombres de campo 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 | Navegar o exportar datos del catálogo | - Devuelve los productos disponibles en el catálogo, incluyendo todos los valores de atributo para cada producto - 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 atributo 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 | - Purga y reemplazo: sobrescribe los datos existentes - se requiere product_id_key - Disponible en modo individual o en bloque |
| Actualización parcial de productos | Actualizar solo los campos seleccionados del producto | Actualizaciones de precio y stock | |