Technische Merkmale – etwa Leistung, Maße oder ETIM-Klassifikationswerte – lassen sich über die ComBinder REST API ebenso automatisiert pflegen wie Stammdaten und Texte. Merkmale werden über ihre Merkmal-Referenz (FT_IDREF) angesprochen und sind, wie Texte, je Sprache hinterlegt.
Voraussetzungen
- REST API aktiv, Workspace geöffnet, gültiges Bearer-Token.
- Die
FT_IDREF-Werte der gewünschten Merkmale (entnehmbar aus der Merkmalvorlage bzw. ETIM-Klassifikation des Produkts im Produktmanager).
Endpunkte im Überblick
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /api/product/{id}/features | Alle Merkmale eines Produkts (alle Sprachen) |
| GET | /api/product/{id}/features/{ftidref} | Ein Merkmal, alle Sprachwerte |
| GET | /api/product/{id}/features/{ftidref}/{lang} | Merkmalswert für eine Sprache |
| PUT | /api/product/{id}/features/{ftidref} | Mehrere Sprachwerte + Einheit gebündelt setzen |
| PUT | /api/product/{id}/features/{ftidref}/{lang} | Nur einen Sprachwert setzen |
| DELETE | .../{ftidref} bzw. .../{ftidref}/{lang} | Merkmal komplett bzw. nur eine Sprache entfernen |
Beispiel: Merkmal mit Einheit und mehreren Sprachen setzen
PUT /api/product/123/features/FT-LEISTUNG
Authorization: Bearer <token>
Content-Type: application/json
{
"funit": "W",
"values": [
{ "lang": "deu", "value": "750" },
{ "lang": "eng", "value": "750" }
]
}Existiert das Merkmal am Produkt noch nicht, legt ComBinder es automatisch an. Bereits vorhandene Werte für die angegebenen Sprachen werden überschrieben, Werte anderer Sprachen bleiben erhalten.
Nur eine Sprache aktualisieren
PUT /api/product/123/features/FT-LEISTUNG/eng
Content-Type: application/json
{ "value": "750" }Typischer Anwendungsfall
Beim Import aus einem Lieferanten-Feed liegen technische Daten oft in einem Drittformat vor. Statt eines vollständigen BMEcat-Re-Imports lassen sich über die Feature-Endpunkte gezielt einzelne Merkmalswerte nachpflegen – z. B. wenn ein Lieferant nur Preis und Verfügbarkeit per API, technische Daten aber separat liefert.
Hinweis: Die FT_IDREF-Werte müssen zur im Workspace verwendeten Merkmalvorlage bzw. ETIM-Klasse passen. Welche Referenzen für ein Produkt gültig sind, lässt sich aktuell am einfachsten über den Produktmanager (Merkmals-Reiter) oder einen vorherigen GET /api/product/{id}/features-Aufruf an einem Referenzprodukt ermitteln.