/catalogues

Este endpoint de la API de Lengow le permite gestionar sus catálogos de productos sin depender de importaciones manuales ni de actualizaciones mediante la interfaz de usuario. Le permite:

• Recuperar sus catálogos y fuentes adicionales existentes

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

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

• Mantener los datos de sus productos continuamente sincronizados desde sus 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. En función de su arquitectura de datos, puede elegir cómo interactúa la API con sus importaciones de catálogos estándar:

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

Si su 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 principal y sobrescribirá la información del producto con los valores incluidos en el archivo más reciente.

En la práctica, este flujo de trabajo es excelente siempre que los datos de los productos del archivo de origen estén actualizados. Este mecanismo híbrido le permite enviar datos urgentes (como descensos de stock) mediante la API durante el día, mientras que una actualización nocturna programada garantiza que su catálogo permanezca totalmente alineado con su fuente de datos principal y asegura 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 necesita una conciliación rutinaria basada en archivos y desea que la API sea su único mecanismo para gestionar el catálogo, puede eliminar por completo las actualizaciones programadas. Para utilizar este modo, simplemente deje 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» > Seleccione su catálogo > «Ver informes anteriores del catálogo». 

Puede 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 de 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 las 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 enumeran 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 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 único del producto. 
Para obtener más información, consulte Asignación inicial de atributos de productos

Al llamar a un endpoint de productos (por ejemplo, Obtener producto), debe 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