ComBinder REST API: Produktgruppen und Warengruppenbaum automatisieren

Mit den Gruppen-Endpunkten der ComBinder REST API lässt sich die komplette Warengruppenhierarchie eines Workspace automatisiert verwalten: Gruppen anlegen, umbenennen, verschieben, löschen sowie Produkte zuordnen oder entfernen. Das ist besonders nützlich, wenn eine externe Taxonomie (z. B. aus einem ERP oder Marktplatz) regelmäßig mit ComBinder synchron gehalten werden soll.

Voraussetzungen

  • REST API aktiv, Workspace geöffnet, gültiges Bearer-Token.

Endpunkte im Überblick

MethodePfadBeschreibung
GET / POST/api/groupFlache Liste aller Gruppen / neue Gruppe anlegen
GET/api/group/treeVollständiger rekursiver Gruppenbaum
GET / PUT / DELETE/api/group/{id}Gruppe lesen / umbenennen / löschen
POST/api/group/{id}/moveGruppe unter neuen Elternknoten verschieben
GET / POST/api/group/{id}/productsProdukte der Gruppe listen / zuordnen
DELETE/api/group/{id}/products/{productId}Produkt aus Gruppe entfernen

Wichtig: Die {id} in der URL ist immer der numerische Datenbank-Primärschlüssel der Gruppe – nicht zu verwechseln mit der hierarchischen, punktgetrennten groupId (z. B. 1.2.3), die in den Antwort-Objekten zusätzlich mitgeliefert wird.

Beispiel: Neue Untergruppe anlegen

POST /api/group
Authorization: Bearer <token>
Content-Type: application/json

{
  "name": "Akku-Werkzeuge",
  "parentId": 12
}

Ohne parentId wird die Gruppe auf oberster Ebene angelegt. ComBinder meldet 409, wenn unter dem Elternknoten bereits eine Gruppe mit demselben Namen existiert, sowie 422, wenn die maximale Anzahl an Untergruppen bzw. die maximale Baumtiefe erreicht ist.

Gruppe verschieben

POST /api/group/45/move
Content-Type: application/json

{ "parentId": 12 }

parentId: null verschiebt die Gruppe auf die oberste Ebene.

Produkte zuordnen

POST /api/group/45/products
Content-Type: application/json

{ "productIds": [101, 102, 103] }

Gruppe löschen

DELETE /api/group/45?deleteProducts=false löscht nur die Gruppe; enthaltene Produkte bleiben erhalten und verlieren lediglich ihre Gruppenzuordnung (sie wandern an die Wurzel). Mit ?deleteProducts=true werden auch die enthaltenen Produkte unwiderruflich gelöscht.

Typischer Anwendungsfall

Eine externe Kategorien-Taxonomie (z. B. aus einem Marktplatz-Export) wird per Skript regelmäßig mit dem ComBinder-Gruppenbaum abgeglichen, der manuell auch im Produktmanager gepflegt werden kann: GET /api/group/tree liefert den Ist-Zustand, Abweichungen werden über POST/PUT/POST .../move nachgezogen.

Weiterlesen