/catalogues

Questo endpoint dell'API Lengow consente di gestire i cataloghi dei prodotti senza ricorrere a importazioni manuali o ad aggiornamenti tramite l'interfaccia utente. 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 propri sistemi (PIM, ERP, strumenti personalizzati)

Aggiornamenti API e sincronizzazione del catalogo

Quando un prodotto viene aggiornato tramite l'API Cataloghi, la modifica viene applicata immediatamente in Lengow. A seconda dell'architettura dei dati, è possibile scegliere come l'API interagisce con le importazioni standard dei cataloghi:

Opzione 1: aggiornamenti API + importazioni pianificate del catalogo

Se il catalogo viene sincronizzato anche tramite un'importazione di file pianificata, 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 riduzioni delle scorte) tramite l'API durante il giorno, mentre un aggiornamento notturno pianificato 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 pianificata

Se non è necessaria una riconciliazione periodica basata sui file e si desidera che l'API sia l'unico meccanismo per la gestione del catalogo, è possibile rimuovere completamente gli aggiornamenti pianificati. Per utilizzare questa modalità, è sufficiente lasciare vuoto il programma di sincronizzazione del catalogo nell'interfaccia Lengow.

Report degli aggiornamenti del catalogo in Lengow

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

È possibile filtrare per tipo di aggiornamento: Pianificato, 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 essere indirizzate a un catalogo specifico utilizzando il relativo "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 nell'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" (visualizzato 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, vedere Mappatura iniziale degli attributi dei prodotti

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

Panoramica degli endpoint API