/catalogues

Este endpoint de la API de Lengow te permite gestionar tus catálogos de productos sin depender de importaciones manuales ni de actualizaciones desde la interfaz de usuario. Te permite:

• Recuperar tus catálogos y fuentes adicionales existentes

• Leer las estructuras y los atributos de los catálogos

• Enumerar, recuperar, crear, actualizar y eliminar un producto o un grupo de productos

• Mantener los datos de tus productos continuamente sincronizados desde tus sistemas (PIM, ERP, herramientas personalizadas)

Actualizaciones de la API y sincronización de catálogos

Cuando se actualiza un producto mediante la API de catálogos, el cambio se aplica inmediatamente en Lengow. Según tu arquitectura de datos, puedes elegir cómo interactúa la API con tus importaciones de catálogos estándar:

- Opción 1: Actualizaciones mediante la API + Importaciones programadas de catálogos

Si tu catálogo también se sincroniza mediante una importación de archivos programada, la siguiente actualización del archivo seguirá siendo la fuente de datos autorizada y sobrescribirá la información del producto con los valores incluidos en el archivo más reciente.

En la práctica, este es un flujo de trabajo excelente siempre que los datos de los productos del archivo de origen estén actualizados. Este mecanismo híbrido te permite enviar datos urgentes (como disminuciones de stock) mediante la API durante el día, mientras que una actualización nocturna programada garantiza que tu catálogo siga completamente alineado con tu fuente de datos principal y garantiza la coherencia de todos los productos.

- Opción 2: Solo actualizaciones mediante la API

• ✓ Actualizaciones de productos en tiempo real
• ✓ Sin conciliación programada

Si no necesitas una conciliación rutinaria basada en archivos y quieres que la API sea tu único mecanismo para gestionar el catálogo, puedes eliminar por completo las actualizaciones programadas. Para utilizar este modo, simplemente deja vacío el calendario de sincronización del catálogo en la interfaz de Lengow.

Informes de actualización de catálogos en Lengow

Las actualizaciones programadas y las actualizaciones mediante la API están visibles en Lengow, en «Catálogos» > Selecciona tu catálogo > «Ver informes de catálogos anteriores». 

Puedes filtrar por tipo de actualización: Programada, Manual o API. 
Los productos nuevos, actualizados y eliminados aparecen en cada actualización.

Funciones de la API compatibles

Conceptos clave

- catalogue_id

Las solicitudes a la API deben dirigirse a un catálogo específico mediante su «catalogue_id».

• Enumerar catálogos suele ser el primer endpoint que se debe utilizar, ya que devuelve una lista de todos los catálogos principales y fuentes adicionales disponibles en la cuenta. Incluye el «catalogue_id» de 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 de una fuente adicional (como su nombre, estado, product_id_key, etc.). En el caso de un catálogo principal, se muestran sus fuentes adicionales.

Ejemplo de respuesta para GET /catalogues/{catalogue_id} :

{
    "catalogue_id": 95000,
    "name": "FR Catalogue",
    "status": "enabled",
    "product_id_key": "id_product",
    "products_count": 2500,
    "role": "main_source",
    "created_at": "2024-09-11T10:42:28.661555Z",
    "updated_at": "2026-10-06T13:57:48.078126Z",
    "indexed_at": "2026-10-06T13:57:49.571801Z",
    "source": "link",
    "additional_sources": [
                124,
                125
            ]
}

- product_id_key

Todas las operaciones de la API relacionadas con productos dependen de «product_id_key» (que aparece 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 obtener más información, consulta Asignación inicial de atributos de productos

Al llamar a un endpoint de productos (por ejemplo, Obtener producto), debes proporcionar el valor del ID del producto almacenado en el campo del catálogo definido como product_id_key.
 

Descripción general de los endpoints de la API