/cataloghi

Questo endpoint dell'API di Lengow ti permette di gestire i tuoi cataloghi di prodotti senza fare affidamento su importazioni manuali o aggiornamenti basati su UI. Ti permette di:

• Recuperare i tuoi cataloghi esistenti e le fonti aggiuntive

• Leggere le strutture dei cataloghi e gli attributi

• Elencare, recuperare, creare, aggiornare e cancellare un singolo prodotto o un gruppo di prodotti

• Mantenere i dati del tuo prodotto continuamente sincronizzati dai tuoi sistemi (PIM, ERP, strumenti personalizzati)

Aggiornamenti API e Sincronizzazione Cataloghi

Quando un prodotto viene aggiornato tramite l'API Cataloghi, il cambiamento viene applicato immediatamente all'interno di Lengow. A seconda della tua architettura dei dati, puoi scegliere come l'API interagisce con le tue importazioni standard di cataloghi:

Opzione 1: aggiornamenti API + importazioni di cataloghi programmate

Se il tuo catalogo è anche sincronizzato tramite un'importazione di file programmata, il prossimo aggiornamento del file rimarrà la fonte autorevole dei dati e sovrascriverà le informazioni del prodotto con i valori contenuti nel file più recente.

In pratica, questo è un eccellente flusso di lavoro finché i dati del prodotto nel tuo file di origine sono aggiornati. Questo meccanismo ibrido ti permette di spingere dati urgenti (come le cadute di stock) tramite l'API durante il giorno, mentre un aggiornamento notturno programmato garantisce che il tuo catalogo rimanga completamente allineato con la tua fonte di dati primaria e garantisce la coerenza su tutti i prodotti.

Opzione 2: solo aggiornamenti API

• ✓ Aggiornamenti del prodotto in tempo reale
• ✓ Nessuna riconciliazione programmata

Se non richiedi una riconciliazione basata su file di routine e desideri che l'API sia il tuo unico meccanismo per la gestione dei cataloghi, puoi rimuovere completamente gli aggiornamenti programmati. Per utilizzare questa modalità, lascia semplicemente vuoto il programma di sincronizzazione del catalogo nell'interfaccia di Lengow.

Funzionalità API supportate

Concetti chiave

- catalogue_id

Le richieste API devono puntare a un catalogo specifico utilizzando il suo "catalogue_id".

• Elenca cataloghi è tipicamente il primo endpoint da chiamare in quanto restituisce un elenco di tutti i cataloghi principali e le fonti aggiuntive disponibili sull'account. Include il "catalogue_id" per ciascuno, che viene utilizzato per tutte le richieste successive. 
• Ottieni catalogo utilizza il "catalogue_id" per restituire i metadati di un catalogo principale o di una fonte aggiuntiva (come il suo nome, stato, product_id_key, ecc.).

Esempio di risposta per GET /catalogues/{catalogue_id} :

{
    "catalogue_id": 95000,
    "name": "Catalogo principale",
    "status": "abilitato",
    "product_id_key": "id_prodotto",
    "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

Tutte le operazioni API relative ai prodotti si basano sul "product_id_key" (mostrato nella risposta sopra).

Il "product_id_key" è definito nelle impostazioni del tuo catalogo in Lengow e identifica il campo che contiene l'ID univoco del prodotto. 
Per maggiori informazioni, vedi Mappatura iniziale degli attributi del prodotto

Quando si chiama un endpoint del prodotto (ad esempio, Ottieni prodotto), è necessario fornire il valore dell'ID del prodotto memorizzato nel campo del catalogo definito come product_id_key.
 

Panoramica degli endpoint API