Waren

Der Bereich Waren ermöglicht den Lesezugriff auf Artikelstammdaten, Lagerbewegungen, Bestellungen, Warenkategorien, Lagerorte und Lieferanten deines Unternehmens.

Erforderlicher Scope: wares

Die Einrichtung eines API-Zugangs ist im Help Center beschrieben.

Benötigte Lizenz

Artikelstammdaten (/wares, /wares/{uuid}) und Warenkategorien (/wares/categories, /wares/categories/{uuid}) sind ohne Zusatzlizenz abrufbar. Bestand, Lagerbewegungen, Bestellungen, Lagerorte und Lieferanten benötigen zusätzlich die Lizenz Lagerverwaltung.

Endpoints

Method	Endpoint	Beschreibung
GET	/api/oauth/v2/resource/wares	Paginierte Liste aller Waren und Leistungen
GET	/api/oauth/v2/resource/wares/{uuid}	Details einer einzelnen Ware
GET	/api/oauth/v2/resource/wares/movements	Paginierte Liste aller Lagerbewegungen
GET	/api/oauth/v2/resource/wares/movements/{uuid}	Details einer einzelnen Lagerbewegung
GET	/api/oauth/v2/resource/wares/purchases	Paginierte Liste offener Bestellungen
GET	/api/oauth/v2/resource/wares/purchases/{uuid}	Details einer einzelnen Bestellung
GET	/api/oauth/v2/resource/wares/categories	Paginierte Liste aller Warenkategorien
GET	/api/oauth/v2/resource/wares/categories/{uuid}	Details einer einzelnen Warenkategorie
GET	/api/oauth/v2/resource/wares/storages	Paginierte Liste aller Lagerorte
GET	/api/oauth/v2/resource/wares/storages/{uuid}	Details eines einzelnen Lagerorts
GET	/api/oauth/v2/resource/wares/distributors	Paginierte Liste aller Lieferanten
GET	/api/oauth/v2/resource/wares/distributors/{uuid}	Details eines einzelnen Lieferanten

Lizenzabhängigkeit

GET /wares, GET /wares/{uuid}, GET /wares/categories und GET /wares/categories/{uuid} benötigen keine Zusatzlizenz.

GET /wares/movements, GET /wares/movements/{uuid}, GET /wares/purchases, GET /wares/purchases/{uuid}, GET /wares/storages, GET /wares/storages/{uuid}, GET /wares/distributors und GET /wares/distributors/{uuid} erfordern die Lizenz Lagerverwaltung. Ohne sie antworten diese Endpoints mit 403 insufficient_scope.

GET /wares und GET /wares/{uuid} hängen ebenfalls von der Lizenz ab, allerdings anders: Statt eines Fehlers fehlt im Response einfach der Schlüssel stock komplett, wenn Lagerverwaltung nicht lizenziert ist. Der Schlüssel existiert nicht – er wird nicht als null zurückgegeben. Siehe Waren abrufen für Beispiel-Responses beider Fälle.

Vollabgleich vs. inkrementeller Abgleich

GET /wares unterstützt keine inkrementellen Filter (updatedSince, deletedSince). Stammdatenänderungen wie Preis, Name oder Kategorie erfordern einen Vollabgleich.

Bestandsänderungen benötigen keinen Vollabgleich von /wares selbst: Jede Bestandsänderung erzeugt eine Lagerbewegung, und stockNew der jüngsten Bewegung je Ware trägt den aktuellen Bestand. GET /wares/movements unterstützt dafür createdSince/createdUntil als inkrementelles Abgleich-Fenster.

GET /wares/purchases unterstützt ebenfalls noch keine inkrementellen Filter und liefert ausschließlich offene Bestellungen – erledigte werden gelöscht, eine Erledigung lässt sich also nicht inkrementell erkennen. Siehe Bestellungen abrufen für Details.