Infos zum Produkt
Beschreibung:
TYRIOS PIM speichert alle produktbezogenen Daten in einer Datenstruktur vom Typ ProductData. Die Datenklasse ist eine zentrale Informationsarchitektur, die im Onlineshop, im PIM-System, in der Auftragsverwaltung und im Kassensystem verwendet wird.
Bitte beachte: TYRIOS ist ein aspektorientiertes System, und die konkrete Datenstruktur hängt von deiner Systemkonfiguration ab. Vor allem wenn du bestehende Daten aktualisieren willst, solltest du darauf achten, alle verfügbaren Felder zu berücksichtigen oder einen aktualisierungsspezifischen API-Endpunkt zu verwenden, um Datenverluste zu vermeiden.
Es ist wichtig zu verstehen, dass die konkrete Datenstruktur von Produkten von der konkreten Einrichtung des Systems abhängt. Da ProductData eine zentrale Datenklasse ist, ist es sehr wahrscheinlich, dass zusätzlich installierte Apps und Module sie erweitern. Eine ProductData ist eine der komplexesten Datenstrukturen in TYRIOS, mit vielen Unterdatenklassen. Daher ist es in der Regel nicht empfehlenswert, die komplette Datenstruktur zu verwenden, sondern APIs zu nutzen, die partielle Aktualisierungen unterstützen.
Sprachabhängige Felder
TYRIOS kann mehrsprachige Systeme in so vielen Sprachen realisieren, wie du willst. Deshalb findest du in der API sprachabhängige Felder, z.B. "name_de" für das deutsche Namensfeld, "description_de" für die deutsche Beschreibung usw. Je mehr Sprachen es gibt, desto mehr entsprechende Felder bietet die API. Deutsch ist im Moment noch eine Pflichtsprache.
Bestandsdefinitionen
Mit TYRIOS ist es möglich, so viele Bestände zu verwalten, wie du willst. Daher muss jedes Produkt relevante Bestandsdaten wie Bestandszahl, Basispreis, Bestandsposition usw. enthalten.
Alternative Preise
In TYRIOS ist es möglich, alternative Preise für verschiedene Kundengruppen zu definieren. Die Produktdatenstruktur stellt entsprechende Felder automatisch zur Verfügung.
Allgemeine Datenstruktur
Mit den bisherigen Informationen können wir nun die allgemeine Datenstruktur der ProductData-Objekte besprechen:
{
"id": null,
"name_de": "Neues Produkt",
"shortDescription_de": "Kurzbeschreibung für Bestellübersicht",
"description_de": "<p>Ausführliche Produktbeschreibung mit HTML</p>",
"price": 19.99,
"tax": 19,
"unit": "Stk",
"productType": 2,
"ShopCategoryData": [{ "id": 2 }],
"visible": true,
"stockable": true,
"stockCount": 10,
"mainMediaFile": 123,
"MediahelperFile": [123, 124],
"state": "1",
"isDiscountable": true,
"salesSupportActivated": true,
"isPricePubliclyVisible": true,
"carry": true,
"freeDelivery": false,
"stockState": "1",
"showStockCountMode": "visibleIfLimited",
"reorderable": true,
"overbookable": true,
"inventoryItemType": "tracked",
"unit4unitPricing": "Stk"
}
Normalerweise gibt es in deiner Instanz viele Referenzen, um sicherzustellen, dass ein Medium nicht gelöscht werden kann, während es in Gebrauch ist. Je nach API können diese Referenzen geladen und bereitgestellt werden. Außerdem enthält das System normalerweise automatisch Vorschau- und Download-URLs über JSON.
ProduktDatenAngebot
Du kannst einem ProductData so viele Angebote hinzufügen, wie du möchtest. Das Angebot wird automatisch im Online-Shop, im Bestell-Editor und am POS berücksichtigt:
Die Datenstruktur sieht folgendermaßen aus:
{
"Preis": 50,
"alternativePreis1": null,
"alternativePreis2": null,
"alternativePreis3": null,
"startTime": "2021-12-31T23:00:00.000Z",
"endTime": "2022-01-30T23:00:00.000Z"
}
ZeroStockCountAction
Wenn du eine automatische Aufgabe ausführen willst, wenn der Bestand leer wird, musst du eine ZeroStockCountAction definieren:
{
"action": "1", // Regelaktion
"afterEventTime": 0, // Verzögerung in Sekunden nach Ereignis
"validUntil": null // Gültigkeitsende der Regel (optional)
}
Du kannst mehrere Aktionen auf einmal angeben.