/catalogues

Dieser Endpunkt der Lengow-API ermöglicht es Ihnen, Ihre Produktkataloge zu verwalten, ohne auf manuelle Importe oder UI-basierte Aktualisierungen angewiesen zu sein. Sie können damit:

• Ihre vorhandenen Kataloge und zusätzlichen Quellen abrufen

• Katalogstrukturen und Attribute lesen

• ein einzelnes Produkt oder eine Produktgruppe auflisten, abrufen, erstellen, aktualisieren und löschen

• Ihre Produktdaten kontinuierlich mit Ihren Systemen synchronisieren (PIM, ERP, individuelle Tools)

API-Aktualisierungen und Katalogsynchronisierung

Wenn ein Produkt über die Katalog-API aktualisiert wird, wird die Änderung sofort in Lengow übernommen. Abhängig von Ihrer Datenarchitektur können Sie festlegen, wie die API mit Ihren standardmäßigen Katalogimporten interagiert:

Option 1: API-Aktualisierungen + geplante Katalogimporte

Wenn Ihr Katalog auch über einen geplanten Dateiimport synchronisiert wird, bleibt die nächste Dateiaktualisierung die maßgebliche Datenquelle und überschreibt die Produktinformationen mit den in der neuesten Datei enthaltenen Werten.

In der Praxis ist dies ein hervorragender Workflow, solange die Produktdaten in Ihrer Quelldatei aktuell sind. Dieser hybride Mechanismus ermöglicht es Ihnen, dringende Daten (z. B. Bestandsrückgänge) tagsüber über die API zu übertragen, während eine geplante nächtliche Aktualisierung sicherstellt, dass Ihr Katalog vollständig mit Ihrer primären Datenquelle übereinstimmt und die Konsistenz über alle Produkte hinweg gewährleistet ist.

Option 2: Nur API-Aktualisierungen

• ✓ Produktaktualisierungen in Echtzeit
• ✓ Keine geplante Abstimmung

Wenn Sie keine routinemäßige dateibasierte Abstimmung benötigen und die API als einzigen Mechanismus zur Katalogverwaltung verwenden möchten, können Sie geplante Aktualisierungen vollständig entfernen. Lassen Sie dazu einfach den Zeitplan für die Katalogsynchronisierung in der Lengow-Oberfläche leer.

Berichte zu Katalogaktualisierungen in Lengow

Geplante Aktualisierungen und API-Aktualisierungen sind in Lengow unter „Kataloge“ > Katalog auswählen > „Vorherige Katalogberichte anzeigen“ sichtbar. 

Sie können nach dem Aktualisierungstyp filtern: Geplant, Manuell oder API. 
Die neuen, aktualisierten und gelöschten Produkte werden für jede Aktualisierung aufgelistet.

Unterstützte API-Funktionen

Wichtige Konzepte

- catalogue_id

API-Anfragen müssen mithilfe der „catalogue_id“ an einen bestimmten Katalog gerichtet werden.

• Kataloge auflisten ist in der Regel der erste aufzurufende Endpunkt, da er eine Liste aller im Konto verfügbaren Hauptkataloge und zusätzlichen Quellen zurückgibt. Sie enthält die „catalogue_id“ für jeden Katalog, die für alle nachfolgenden Anfragen verwendet wird. 
• Katalog abrufen verwendet die „catalogue_id“, um die Metadaten eines Hauptkatalogs oder einer zusätzlichen Quelle zurückzugeben (z. B. Name, Status, product_id_key usw.). Bei einem Hauptkatalog werden dessen zusätzliche Quellen aufgelistet.

Beispielantwort für 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

Alle produktbezogenen API-Vorgänge basieren auf dem „product_id_key“ (in der obigen Antwort angezeigt).

Der „product_id_key“ wird in Ihren Katalogeinstellungen in Lengow definiert und identifiziert das Feld, das die eindeutige Produkt-ID enthält. 
Weitere Informationen finden Sie unter Erste Zuordnung von Produktattributen

Beim Aufrufen eines Produktendpunkts (z. B. Produkt abrufen) müssen Sie den Produkt-ID-Wert angeben, der im Katalogfeld gespeichert ist, das als product_id_key definiert wurde.
 

Übersicht über die API-Endpunkte