Der Endpunkt /products stellt Ihnen eine Schnittstelle bereit, mit der Sie Produktdaten und Lagerbestände in unserem Shop-System verwalten können. Darüber können Sie Produkte erstellen, bearbeiten, filtern, abrufen und löschen sowie Lagerbestandsinformationen zu Produkten abrufen, aktualisieren und löschen.

Inhaltsverzeichnis

1 1. Unterstützte Methoden
2 2. Datenfelder
3 3. Methoden für Produkte
- 3.1 3.1 GET products
- 3.2 3.2 GET products/{productId}
- 3.3 3.3 GET products/{productId}/url
- 3.4 3.4 GET products/testRule
- 3.5 3.5 POST products
- 3.6 3.6 PUT products/{productId}
- 3.7 3.7 DELETE products/{productId}
4 4. Methoden für Variantenattribute
5 5. Methoden für Produktvarianten
6 6. Methoden für Lagerbestand Allgemein
7 7. Methoden für Produkte Lagerbestand
- 7.1 7.1 GET products/{productId}/inventory
- 7.2 7.2 PUT products/{productId}/inventory
8 8. Methoden für Varianten Lagerbestand
- 8.1 8.1 GET products/{productId}/variants/{variantId}/inventory
- 8.2 8.2 PUT products/{productId}/variants/{variantId}/inventory
9 9. Methoden für Set-Produkte
10 10. Ergänzende Referenzen
11 11. Hinweis zu Produktdatenfeldern
12 12. Support

1. Unterstützte Methoden

Befehl/Info	Endpunkte?	GET	POST	PUT	DELETE

Befehl/Info	Endpunkte?	GET	POST	PUT	DELETE
Allgemeines Produkt	products/
Variantenattribute	products/variants
Varianten	products/{productId}/variants
Lagerbestand Allgemein	products/inventory
Lagerbestand für Produkte	products/{productId}/inventory
Lagerbestand für Varianten	products/{productId}/variants/{variantId}/ inventory
Set-Produkte	products/{productId}/setproducts

2. Datenfelder

Felder werden in der Konfiguration verwaltet und als ein JSON-Objekt in der Tabelle gespeichert.

Es wird unterschieden zwischen Standardproduktdatenfeldern und benutzerdefinierten Produktdatenfeldern. Benutzerdefinierte Produktdatenfelder können beliebig angelegt werden, während Standardproduktdatenfelder vom Shop vorgegeben werden und immer definiert sind. Alle benutzerdefinierte Produktdatenfelder sind im Abschnitt custom zu finden. Alle anderen Einträge stellen Standardproduktdatenfelder dar.

Name	Typ	Bedeutung

Name	Typ	Bedeutung
active	String	Aktivitätsstatus des Produkts (z. B. „always“, „never“)
custom	Objekt	Benutzerdefinierte Felder
custom.liste	Array	Beispielhafte Liste
custom.map	Objekt	Beispielhafte Schlüssel-Wert-Zuordnungen
custom.robotsNoFollow	Boolean	True = Link zu diesem Produkt sollte von Suchmaschinen nicht gefolgt werden
custom.robotsNoIndex	Boolean	True = Produktseite sollte nicht in Suchmaschinen indiziert werden
custom.weight	Float	Gewicht des Produkts in Kilogramm (zur Priorisierung oder Sortierung)
descr	String	Produktbeschreibung
hasVariants	Boolean	Gibt an, ob das Produkt Varianten besitzt (z. B. Größe, Farbe)
id	String	Technische ID des Produkts
itemNumber	String	Artikelnummer (kann identisch mit `id` sein)
name	String	Klartext-Name des Produkts
price	String	Standardpreis des Produkts (z. B. "89.900000")
ratingApprovalConfig.maximumRating	Integer	Maximal zulässige Bewertung (z. B. 5)
ratingApprovalConfig.minimumRating	Integer	Minimal zulässige Bewertung (z. B. 0)
setPrice	String	Setpreis (bei Produktbündeln)
statistics.averageRating	Float	Durchschnittliche Bewertung des Produkts
statistics.ratingCount	Integer	Anzahl der abgegebenen Bewertungen
statisticsPerPoint	Array	Bewertungshistogramm: für jeden möglichen Wert Anzahl Bewertungen
taxRateId	String	ID des angewendeten Steuersatzes
timestampCreatedAt	String	Zeitpunkt der Erstellung (ISO 8601-Format, UTC)
timestampUpdatedAt	String	Zeitpunkt der letzten Produktänderung (ISO 8601-Format, UTC)

Beispielhafter Datensatz:

{
    "active": "always",
    "custom": {
        "liste": [
            "123",
            "234",
            "456"
        ],
        "map": {
            "a": "b",
            "c": "d",
            "e": "f"
        },
        "robotsNoFollow": false,
        "robotsNoIndex": false,
        "weight": 0.33
    },
    "descr": "Lässiges Barbour-Shirt aus Baumwoll-Piqué mit Langarm.<span class='passform'> Gearbeitet in gerader, normaler Passform (Regular Fit)</span> mit Kontrastbesatz im 'Barbour-Tartan' an der Knopfleiste und im Kragen. Mit klassischem Polokragen, Ärmelbündchen und gesticktem Barbour-Logo. Ein Mode-Klassiker für die Freizeit, in dem sich jeder Mann wohlfühlt.<span class='mass'> Länge ca. 75 cm.</span> <span class='katalogfarbe'>Farbe: Navy.</span><span class='herkunft'> Original Barbour. </span>   <br><br><span class='groessen'> Größen: M (48), L (50), XL (52/54), XXL (56/58), XXXL (58/60) </span><br><br><span class='material'> Reine Baumwolle.</span>",
    "hasVariants": true,
    "id": "11-1701",
    "itemNumber": "11-1701",
    "name": "Tartan-Langarm-Polo in Navy",
    "price": "89.900000",
    "ratingApprovalConfig": {
        "maximumRating": 5,
        "minimumRating": 0
    },
    "setPrice": "0.000000",
    "statistics": {
        "averageRating": 0,
        "ratingCount": 0
    },
    "taxRateId": "1",
    "statisticsPerPoint": [
        [
            0,
            0
        ],
        [
            1,
            0
        ],
        [
            2,
            0
        ],
        [
            3,
            0
        ],
        [
            4,
            0
        ],
        [
            5,
            0
        ]
    ],
    "timestampCreatedAt": "2024-11-14T10:41:25.000Z",
    "timestampUpdatedAt": "2025-01-24T09:28:06.000Z"
}

3. Methoden für Produkte

Die hier dokumentierten Endpunkte ermöglichen den Lese-, Schreib-, Änderungs- und Löschzugriff auf Produktdaten im Shopsystem. Sie können zur Verwaltung des Produktkatalogs genutzt werden – sowohl zur Initialbefüllung als auch zur laufenden Aktualisierung von Inhalten.

Zusätzlich stehen Endpunkte zur Verfügung, um Produktsuchen auf Basis definierter Regeln durchzuführen.

Da jeder Subshop eine eigene Produktmenge hat, sollen URLs den Parameter subshopId enthalten.

Für alle Endpunkte ist eine gültige Authentifizierung erforderlich. Die jeweiligen Berechtigungen zum Lesen, Schreiben, Erstellen oder Löschen von Produkten müssen vorhanden sein.

3.1 GET products

Mit diesem Endpunkt können Sie eine Liste aller Produkte im System abrufen.

Optional kann die Ergebnismenge mithilfe von Filterparametern eingeschränkt werden, z. B. auf Produkte, die einer bestimmten Kategorie zugeordnet sind (inCategory) oder aus einer bestimmten Kategorie ausgeschlossen werden sollen (notInCategory). Beide Parameter dürfen nicht gleichzeitig verwendet werden.

Wenn der Parameter inCategory verwendet wird, erfolgt die Ausgabe der Produkte nicht in der im Shop gepflegten Reihenfolge innerhalb der Kategorie. Um die Produkte in der korrekten Reihenfolge zu erhalten, verwenden Sie bitte den Endpunkt GET categories/{categoryId}/products.

Damit der Endpunkt verwendet werden kann, müssen die entsprechenden Berechtigungen zum Lesen von Produkten vorhanden sein.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/products?subshopId=deutsch

Antwort:

{
    "endReached": false,
    "items": [
        {
            "active": "always",
            "custom": {
                ...
            },
            "descr": "Lässiges Barbour-Shirt aus Baumwoll-Piqué mit Langarm.<span class='passform'> Gearbeitet in gerader, normaler Passform (Regular Fit)</span> mit Kontrastbesatz im 'Barbour-Tartan' an der Knopfleiste und im Kragen. Mit klassischem Polokragen, Ärmelbündchen und gesticktem Barbour-Logo. Ein Mode-Klassiker für die Freizeit, in dem sich jeder Mann wohlfühlt.<span class='mass'> Länge ca. 75 cm.</span> <span class='katalogfarbe'>Farbe: Navy.</span><span class='herkunft'> Original Barbour. </span>   <br><br><span class='groessen'> Größen: M (48), L (50), XL (52/54), XXL (56/58), XXXL (58/60) </span><br><br><span class='material'> Reine Baumwolle.</span>",
            "id": "11-1701",
            "itemNumber": "11-1701",
            "name": "Tartan-Langarm-Polo in Navy",
            "price": "89.900000",
            "taxRateId": "1",
            "timestampCreatedAt": "2024-11-14T10:41:25.000Z",
            "timestampUpdatedAt": "2025-01-24T09:28:06.000Z"
        }
    ],
    "nextPageToken": "WzAuMCwiMTEtMjgxNV9kZXV0c2NoXzMiXQ",
    "totalCount": 1296
}

Filterfelder:

Alle Produktdatenfelder, inCategory, notInCategory, inSetProduct, notInSetProduct

Sortierfelder:

Alle Produktdatenfelder

Sonstige Parameter:

from

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen von Produkten.
400 Bad Request		Request body konnte nicht geladen werden.
400 Bad Request	"invalidValue"	"stage" ist ungültig \| `size` ∉ [1;300] \| `pageToken` ist keine Zahl oder kleiner als 0. \| `from` ist größer als 9999. Es wird versucht, Produkte nach einem Feld vom Typ `Liste`, `Map`, `Bild` oder `Video` zu sortieren.
400 Bad Request	"unknownDataField"	Ein Filter- oder Sortierfeld ist ungültig.
400 Bad Request	"illegalOperation"	Ein Filtertyp ist ungültig.
400 Bad Request	"invalidCharacters"	Ein Filterwert ist ungültig. `size` ist keine Ganzzahl.
400 Bad Request	"invalidCombination"	Die Filter `inCategory` und `notInCategory` oder `inSetProduct` und `notInSetProduct` sind gleichzeitig gesetzt.
503 Service Unavailable	"internalError"	Das Lesen von Daten ist fehlgeschlagen.

3.2 GET products/{productId}

Mit diesem Endpunkt können Sie die vollständigen Daten eines einzelnen Produkts abrufen. Geben Sie dazu die Produkt-ID als Pfadparameter an. Neben den Basisdaten werden auch benutzerdefinierte Felder zurückgegeben.

Damit der Endpunkt verwendet werden kann, müssen die entsprechenden Berechtigungen zum Lesen von Produkten vorhanden sein.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/products/11-1701?subshopId=deutsch

Antwort:

{
    "active": "always",
    "custom": {
        "liste": [
            "123",
            "234",
            "456"
        ],
        "map": {
            "a": "b",
            "c": "d",
            "e": "f"
        },
        "robotsNoFollow": false,
        "robotsNoIndex": false,
        "weight": 0.33
    },
    "descr": "Lässiges Barbour-Shirt aus Baumwoll-Piqué mit Langarm.<span class='passform'> Gearbeitet in gerader, normaler Passform (Regular Fit)</span> mit Kontrastbesatz im 'Barbour-Tartan' an der Knopfleiste und im Kragen. Mit klassischem Polokragen, Ärmelbündchen und gesticktem Barbour-Logo. Ein Mode-Klassiker für die Freizeit, in dem sich jeder Mann wohlfühlt.<span class='mass'> Länge ca. 75 cm.</span> <span class='katalogfarbe'>Farbe: Navy.</span><span class='herkunft'> Original Barbour. </span>   <br><br><span class='groessen'> Größen: M (48), L (50), XL (52/54), XXL (56/58), XXXL (58/60) </span><br><br><span class='material'> Reine Baumwolle.</span>",
    "id": "11-1701",
    "itemNumber": "11-1701",
    "name": "Tartan-Langarm-Polo in Navy",
    "price": "89.900000",
    "taxRateId": "1",
    "timestampCreatedAt": "2024-11-14T10:41:25.000Z",
    "timestampUpdatedAt": "2025-01-24T09:28:06.000Z"
}

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen von Produkten.
400 Bad Request	"invalidValue"	`id` ist ungültig Es wurde eine ungültige Stage angegeben.
404 Not Found		Produkt mit `id`=`{id}` wurde nicht gefunden.

3.3 GET products/{productId}/url

Mit diesem Endpunkt können Sie die vollständige URL eines Produkts abrufen.

Für die Nutzung dieses Endpunkts sind Schreibberechtigungen für Produkt-Daten erforderlich.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/products/143-68071/url?subshopId=deutsch

Antwort:

https://www.<ihr-shop>.de/SEOURL/

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen von Produkten.
400 Bad Request	"invalidValue"	Es wurde eine ungültige Stage angegeben.

3.4 GET products/testRule

Mit diesem Endpunkt können Sie gezielt Produkte abrufen, die einer oder mehreren angegebenen Regeln entsprechen. Die Regeln werden als JSON-formatiertes Array in der Query-URL übergeben und ermöglichen eine flexible Filterung nach Produktfeldern wie z. B. Aktivitätsstatus, Artikelnummern oder Preisangaben. Die Regeln dürfen nur gültige Felder und zulässige Operatoren enthalten.

Damit dieser Endpunkt verwendet werden kann, müssen die entsprechenden Berechtigungen zum Lesen von Produktdaten vorhanden sein.

Beispiel:

Die Regeln werden in der URL als JSON-Array kodiert und über den Parameter rules übergeben. Um korrekt interpretiert zu werden, muss dieser Parameter URL-dekodiert werden.

https://www.<ihr-shop>.de/admin/api/v1/products/testRule?size=100&rules=%5B%7B%22field%22%3A%22&active%22%2C%22mode%22%3A%22eq%22%2C%22value%22%3A%22always%22%7D%2C%7B%22field%22%3A%22itemNumber%22%2C%22mode%22%3A%22contains%22%2C%22value%22%3A%225%22%7D%5D&&

Die URL ruft Produkte ab, die zwei Bedingungen erfüllen:

Das Feld active muss den Wert always haben.
Es werden nur Produkte berücksichtigt, die dauerhaft aktiv sind.
Die Artikelnummer (itemNumber) muss die Ziffer „5“ enthalten.
Es werden nur Produkte ausgewählt, deren Artikelnummer irgendwo die „5“ enthält (z. B. 11-2518).

Antwort:

{
    "items": [
        {
            "active": "always",
            "custom": {
                "brand": "",
                "commission": 0,
                "commissionTaxRate": "",
                "crossSelling": [],
                "customNumber": "",
                "ean": "",
                "filterField": "",
                "image": [],
                "isbn": "",
                "mainCategory": "",
                "metaDescription": "",
                "metaDescriptionSetManually": false,
                "metaTitle": "",
                "metaTitleSetManually": false,
                "multiProducts": "",
                "oneTimeFee": 0,
                "oneTimeFeeTaxRate": "",
                "productDiscount": 0,
                "productDiscountAbsolute": false,
                "productType": "",
                "robotsNoFollow": false,
                "robotsNoIndex": false,
                "setOrgPrice": "0.000000",
                "validForDiscount": false,
                "video": "",
                "voucherProductActive": false,
                "voucherProductHtmlTemplate": "",
                "voucherProductPrice": false,
                "voucherProductTemplate": "",
                "weight": 0
            },
            "descr": "Dieses weiße Poloshirt ist alles andere als gewöhnlich, sondern ...",
            "hasVariants": true,
            "id": "11-2451",
            "itemNumber": "11-2451",
            "name": "Samtweiches Polo aus Luxusjersey",
            "price": "89.900000",
            "setPrice": "0.000000",
            "taxRateId": "1",
            "timestampCreatedAt": "2025-02-14T10:50:38.000Z",
            "timestampUpdatedAt": "2025-04-28T10:24:24.000Z"
        },
        {
            "active": "always",
            "custom": {
                "brand": "",
                "commission": 0,
                "commissionTaxRate": "",
                "crossSelling": [],
                "customNumber": "",
                "ean": "",
                "filterField": "",
                "image": [],
                "isbn": "",
                "mainCategory": "",
                "metaDescription": "",
                "metaDescriptionSetManually": false,
                "metaTitle": "",
                "metaTitleSetManually": false,
                "multiProducts": "",
                "oneTimeFee": 0,
                "oneTimeFeeTaxRate": "",
                "productDiscount": 0,
                "productDiscountAbsolute": false,
                "productType": "",
                "robotsNoFollow": false,
                "robotsNoIndex": false,
                "setOrgPrice": "0.000000",
                "validForDiscount": false,
                "video": "",
                "voucherProductActive": false,
                "voucherProductHtmlTemplate": "",
                "voucherProductPrice": false,
                "voucherProductTemplate": "",
                "weight": 0
            },
            "descr": "Einmal angezogen, wollen Sie aus diesem kuschelig weichen Flane...",
            "hasVariants": true,
            "id": "11-2518",
            "itemNumber": "11-2518",
            "name": "Lieblingshemd aus Fischgrat-Gewebe",
            "price": "79.900000",
            "setPrice": "0.000000",
            "taxRateId": "1",
            "timestampCreatedAt": "2025-02-14T10:50:45.000Z",
            "timestampUpdatedAt": "2025-04-28T10:24:24.000Z"
        },
        ...
    ],
    "nextPageToken": "WzAuMCwiMTQzLTY4MDcxX2RldXRzY2hfMyJd",
    "totalCount": 64,
    "warnings": {
        "invalidValue": [],
        "unknownFilters": [],
        "wrongOperators": []
    }
}

Mögliche Werte für `mode`:

gt (größer), gte (größer oder gleich), lt (kleiner), lte (kleiner oder gleich), eq (gleich), neq (ungleich), contains (enthält), notcontains (nicht enthält)

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Lesen von Produkt-Daten.
400 Bad Request		Regeln konnten nicht geparst werden.
400 Bad Request	"syntaxError"	`sort` enthält mehr als einen oder keinen ":".
400 Bad Request	"unknownDataField"	Ein Sortierfeld ist ungültig.
400 Bad Request	"invalidValue"	"stage" ist ungültig. `size` ∉ [1;1000] `sort` ∉ {"asc", "desc"} Das Sortierfeld hat den Typ `Liste`, `Map`, `Bild` oder `Video`.

3.5 POST products

Mit dem Endpunkt /products können neue Produkte im Shop-System angelegt werden. Alle für die Erstellung erforderlichen Produktinformationen müssen im Request Body übergeben werden. Die Antwort enthält die vollständigen Produktdaten des neu erstellten Produkts im JSON-Format.

Zum Erstellen eines Produkts sind entsprechende Berechtigungen erforderlich.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/products

Request Body:

{
    "custom": {
        "liste": [],
        "map": {}
    },
    "active": "always",
    "descr": "This is a new Produkt",
    "itemNumber": "new",
    "name": "NewProdukt",
    "price": "1",
    "taxRateId": "19"
}

Antwort:

{
	"active": "always",
	"custom": {
		"brand": "",
		"commission": {
			"source": "0.0",
			"parsedValue": 0
		},
		"commissionTaxRate": "",
		"crossSelling": [],
		"customNumber": "",
		"ean": "",
		"filterField": "",
		"image": [],
		"isbn": "",
        "liste": [],
        "map": {},
        ...
		"weight": {
			"source": "0.0",
			"parsedValue": 0
		}
	},
	"descr": "This is a new Produkt",
	"hasVariants": false,
	"id": "144-46864",
	"itemNumber": "new",
	"name": "NewProdukt",
	"price": "1.000000",
	"setPrice": "0.000000",
	"taxRateId": "19",
	"timestampCreatedAt": "2025-05-09T14:57:36.000Z",
	"timestampUpdatedAt": "2025-05-09T14:57:36.000Z"
}

Fehlercodes:

Fehler	Typ	Grund

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet oder verfügen nicht über die erforderlichen Rechte zum Erstellen von Produkten.
400 Bad Request		Der Request-Body konnte nicht geladen werden.
400 Bad Request	"invalidValue"	Es wurde eine ungültige Stage oder ein ungültiger Subshop angegeben. `custom` ist kein Objekt. Ein Feld enthält den Wert `null`. Ein Wert hat den Typ, der mit dem Typ aus der Konfiguration nicht übereinstimmt. Ein Preis-Wert kann nicht geparst werden. Ein Feld vom Typ `Map` hat einen Schlüssel, der kein String ist. Ein Feld vom Typ `List` ist kein Array von Strings. Ein Zeitwert ist nicht in ISO 8601 Format. Bild-Daten von einem Bild sind kein Array von Objekten. `id` des Formats oder `path` sind keine Strings.
400 Bad Request	“unknownField”	Ein nicht existierendes Produktdatenfeld wurde im Request-Body angegeben.
400 Bad Request	“invalidSource”	Ein nicht bearbeitbares Produktdatenfeld wurde im Request-Body angegeben.

3.6 PUT products/{productId}

Mit dem Endpunkt products/{productId} können Produktdaten aktualisiert werden. Wird ein Produkt mit der angegebenen ID nicht gefunden, kann bei gesetztem Parameter createMissing=yes automatisch ein neues Produkt angelegt werden.

Die vollständigen Produktdaten müssen im Request-Body übergeben werden.

Das optionale Feld set kann benutzt werden, um andere Produkte zusammen mit dem Aktuellen einem Set zuzuweisen. Alternativ können die Endpunkte für Set-Produkte genutzt werden.

Zum Bearbeiten oder Anlegen eines Produkts sind entsprechende Berechtigungen erforderlich.

Beispiel:

https://www.<ihr-shop>.de/admin/api/v1/products11-1966

Request-Body:

{
    "custom": {
        "brand": "",
        "commission": 0,
        "commissionTaxRate": "",
        "crossSelling": [],
        "customNumber": "",
        "ean": "",
        "filterField": "",
        "image": [],
        "isbn": "",
        "mainCategory": "",
        "metaDescription": "",
        "metaDescriptionSetManually": false,
        "metaTitle": "",
        "metaTitleSetManually": false,
        "multiProducts": "",
        "oneTimeFee": 0,
        "oneTimeFeeTaxRate": "",
        "productDiscount": 0,
        "productDiscountAbsolute": false,
        "productType": "",
        "robotsNoFollow": false,
        "robotsNoIndex": false,
        "setOrgPrice": "0.000000",
        "validForDiscount": false,
        "video": "",
        "voucherProductActive": false,
        "voucherProductHtmlTemplate": "",
        "voucherProductPrice": false,
        "voucherProductTemplate": "",
        "weight": 0
    },
    "active": "always",
    "descr": "Jedes Stück, das von dem Strickunternehmen Kero Design kommt, ist ein echtes Unikat! Genau wie dieser Cardigan: Hier mischen sich zarte und kräftige Blautöne und ergeben ein effektvolles Strickkunstwerk. Diese handgestrickte Optik mit ihren schönen Farbverläufen erhält der Cardigan vor allem durch seine aufwendig von Hand gefärbten Garne. Reine Baumwolle macht die Strickjacke schön leicht und weich. Ein echter Blickfang und sehr besonders! Mit langen Ärmeln, Rundhals und Perlmutt-Knöpfen.   <span class='passform'> Gerade Form (Regular Fit).</span>   <span class='mass'> Länge ca. 60 cm.</span>  <span class='katalogfarbe'>Farbe: Multicolor Blue.</span>  <span class='herkunft'> Original Kero Design.</span>  <br><br><span class='material'>65 % Baumwolle (Bio-Baumwolle), 35 % Baumwolle.</span>",
    "itemNumber": "12-2144",
    "name": "Cardigan 'Amelia'",
    "price": "139.00",
    "setPrice": "0.00",
    "taxRateId": "1",
    "set": [
        {
            "id": "11-2497",
            "quantityFactor": 1,
            "usePrice": true,
            "fixQuantity": false,
            "hidden": false
        },
        {
            "id": "11-2492",
            "quantityFactor": 1,
            "usePrice": true,
            "fixQuantity": false,
            "hidden": false
        }
    ]
}

Antwort:

{
    "active": "always",
    "custom": {
        "brand": "",
        "commission": 0,
        "commissionTaxRate": "",
        "crossSelling": [],
        "customNumber": "",
        "ean": "",
        "filterField": "",
        "image": [],
        "isbn": "",
        "mainCategory": "",
        "metaDescription": "",
        "metaDescriptionSetManually": false,
        "metaTitle": "",
        "metaTitleSetManually": false,
        "multiProducts": "",
        "oneTimeFee": 0,
        "oneTimeFeeTaxRate": "",
        "productDiscount": 0,
        "productDiscountAbsolute": false,
        "productType": "",
        "robotsNoFollow": false,
        "robotsNoIndex": false,
        "setOrgPrice": "0.000000",
        "validForDiscount": false,
        "video": "",
        "voucherProductActive": false,
        "voucherProductHtmlTemplate": "",
        "voucherProductPrice": false,
        "voucherProductTemplate": "",
        "weight": 0
    },
    "descr": "Jedes Stück, das von dem Strickunternehmen Kero Design kommt, ist ein echtes Unikat! Genau wie dieser Cardigan: Hier mischen sich zarte und kräftige Blautöne und ergeben ein effektvolles Strickkunstwerk. Diese handgestrickte Optik mit ihren schönen Farbverläufen erhält der Cardigan vor allem durch seine aufwendig von Hand gefärbten Garne. Reine Baumwolle macht die Strickjacke schön leicht und weich. Ein echter Blickfang und sehr besonders! Mit langen Ärmeln, Rundhals und Perlmutt-Knöpfen.   <span class='passform'> Gerade Form (Regular Fit).</span>   <span class='mass'> Länge ca. 60 cm.</span>  <span class='katalogfarbe'>Farbe: Multicolor Blue.</span>  <span class='herkunft'> Original Kero Design.</span>  <br><br><span class='material'>65 % Baumwolle (Bio-Baumwolle), 35 % Baumwolle.</span>",
    "hasVariants": true,
    "id": "12-2144",
    "itemNumber": "12-2144",
    "name": "Cardigan 'Amelia'",
    "price": "139.000000",
    "setPrice": "259.700000",
    "taxRateId": "1",
    "timestampCreatedAt": "2025-02-14T10:54:45.000Z",
    "timestampUpdatedAt": "2025-05-10T16:19:36.000Z"
}

Fehlercodes:

API-Referenz Produkte

Inhaltsverzeichnis

1. Unterstützte Methoden

2. Datenfelder

Beispielhafter Datensatz:

3. Methoden für Produkte

3.1 GET products

Beispiel:

Antwort:

Filterfelder:

Sortierfelder:

Sonstige Parameter:

Fehlercodes:

3.2 GET products/{productId}

Beispiel:

Antwort:

Fehlercodes:

3.3 GET products/{productId}/url

Beispiel:

Antwort:

Fehlercodes:

3.4 GET products/testRule

Beispiel:

Antwort:

Mögliche Werte für mode:

Fehlercodes:

3.5 POST products

Beispiel:

Request Body:

Antwort:

Fehlercodes:

3.6 PUT products/{productId}

Beispiel:

Request-Body:

Antwort:

Fehlercodes:

Mögliche Werte für `mode`: