/catalogues

Dieser Endpunkt der Lengow-API ermöglicht es Ihnen, Ihre Produktkataloge zu verwalten, ohne auf manuelle Importe oder Aktualisierungen über die Benutzeroberfläche angewiesen zu sein. Sie können damit:

• Ihre vorhandenen Kataloge und zusätzlichen Quellen abrufen

• Katalogstrukturen und Attribute auslesen

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

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

API-Aktualisierungen und Katalogsynchronisierung

Wenn ein Produkt über die Kataloge-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 Dateia k tualisierung die maßgebliche Datenquelle und überschreibt die Produktinformationen mit den in der neuesten Datei enthaltenen Werten.

In der Praxis ist dies ein hervorragender Ablauf, solange die Produktdaten in Ihrer Quelldatei aktuell sind. Mit diesem hybriden Mechanismus können Sie dringende Daten (z. B. Bestandsrückgänge) tagsüber über die API ü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 regelmäßige dateibasierte Abstimmung benötigen und die API als alleinigen Mechanismus für die 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 neu erstellten, aktualisierten und gelöschten Produkte werden für jede Aktualisierung aufgeführt.

Unterstützte API-Funktionen

Wichtige Konzepte

– catalogue_id

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

• Kataloge auflisten ist normalerweise 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 auch die zusätzlichen 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“ (der in der obigen Antwort angezeigt wird).

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

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

Übersicht über API-Endpunkte