/catalogues

Questo endpoint delle API Lengow consente di gestire i cataloghi dei prodotti senza ricorrere a importazioni manuali o ad aggiornamenti tramite l'interfaccia utente. Ti consente di:

• Recuperare i cataloghi esistenti e le fonti aggiuntive

• Leggere le strutture e gli attributi dei cataloghi

• Elencare, recuperare, creare, aggiornare ed eliminare un singolo prodotto o un gruppo di prodotti

• Mantenere i dati dei prodotti continuamente sincronizzati dai tuoi sistemi (PIM, ERP, strumenti personalizzati)

Aggiornamenti API e sincronizzazione dei cataloghi

Quando un prodotto viene aggiornato tramite le API Cataloghi, la modifica viene applicata immediatamente in Lengow. A seconda della tua architettura dei dati, puoi scegliere come interagiscono le API con le importazioni standard dei cataloghi:

- Opzione 1: aggiornamenti API + importazioni programmate dei cataloghi

Se il catalogo viene sincronizzato anche tramite un'importazione programmata da file, il successivo aggiornamento del file rimarrà la fonte dati autorevole e sovrascriverà le informazioni sul prodotto con i valori contenuti nell'ultimo file.

In pratica, questo è un flusso di lavoro eccellente purché i dati dei prodotti nel file di origine siano aggiornati. Questo meccanismo ibrido consente di inviare dati urgenti (come le diminuzioni delle scorte) tramite API durante il giorno, mentre un aggiornamento notturno programmato garantisce che il catalogo rimanga completamente allineato alla fonte dati principale e assicura la coerenza tra tutti i prodotti.

- Opzione 2: solo aggiornamenti API

• ✓ Aggiornamenti dei prodotti in tempo reale
• ✓ Nessuna riconciliazione programmata

Se non hai bisogno di una riconciliazione periodica basata sui file e vuoi che le API siano il tuo unico meccanismo per la gestione del catalogo, puoi rimuovere completamente gli aggiornamenti programmati. Per utilizzare questa modalità, lascia semplicemente vuoto il programma di sincronizzazione del catalogo nell'interfaccia Lengow.

Report degli aggiornamenti dei cataloghi in Lengow

Gli aggiornamenti programmati e gli aggiornamenti API sono visibili in Lengow, in "Cataloghi" > Seleziona il tuo catalogo > "Visualizza i report precedenti del catalogo". 

Puoi filtrare per tipo di aggiornamento: Programmato, Manuale o API. 
I prodotti nuovi, aggiornati ed eliminati sono elencati per ogni aggiornamento.

Funzionalità API supportate

Concetti chiave

- catalogue_id

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

• Elencare i cataloghi è in genere il primo endpoint da chiamare, poiché restituisce un elenco di tutti i cataloghi principali e delle fonti aggiuntive disponibili sull'account. Include il "catalogue_id" per ciascuno di essi, utilizzato per tutte le richieste successive. 
• Ottenere il catalogo utilizza il "catalogue_id" per restituire i metadati di un catalogo principale o di una fonte aggiuntiva (come nome, stato, product_id_key, ecc.). Nel caso di un catalogo principale, vengono elencate le relative fonti aggiuntive.

Esempio di risposta per 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

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

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

Quando chiami un endpoint relativo a un prodotto (ad esempio, Ottenere il prodotto), devi fornire il valore dell'ID prodotto memorizzato nel campo del catalogo definito come product_id_key.
 

Panoramica degli endpoint API