Exportieren ▼

VIA-Connect - REST API » Products

Products

Zuletzt geändert von Thomas Hoffmann am 2017/08/02 12:48

Kommentare (0) · Anhänge (0) · Historie

Inhalt

Beschreibung
Properties
Navigation Properties

Bevor die Produkte vom Fremdsystem in unserer System übertragen werden, sollten Sie sicherstellen, dass Sie vorher die Kataloge/Kategorien aus dem Fremdsystem bei uns angelegt haben.

Somit wird gewährleistet, dass der Nutzer im Frontend unseres Systems eine Abbildung seiner Kataloge/Kategorien aus dem Fremdsystem vorfindet und komfortabler in unserem System navigieren kann.

Beschreibung

Das EntitySet Products enthält die minimalen Produktdaten.

Jeder Eintrag eines Produktes wird über das Property Id identifiziert.

Mit dieser Id können die aktuellen Daten des Produktes in unserem System angefragt und Änderungen der Daten durchgeführt werden.

Diese Id bildet die Assoziation zu anderen EntitySets

Properties

Alle Datums-/Zeitangaben werden in UTC ausgegeben.

Property	Werttyp	Angabe	Erläuterung
Id	Int64	-	Damit wird ein Entity in diesem EntitySet identifiziert.
*ForeignId*	String	Optional	Mit diesem Wert kann das Produkt im Fremdsystem identifiziert werden. Hier gibt man z.B. einen eindeutigen Wert für ein Produkt aus dem Fremdsystem an.
*CreationDate*	DateTime	-	Enthält das Anlagedatum Wird vom System automatisch gesetzt und kann nicht verändert werden.
*Title*	String	Pflicht	Enthält die Bezeichnung des Produktes Für eBay darf der Name nicht länger als 80 Zeichen sein.
*Description*	String	Konditional	Enthält die Beschreibung des Produktes Bei HTML oder XML reservierten Zeichen sollte die Beschreibung mittels CDATA übermittelt werden. Wenn eine der Eigenschaften Ean, Upc oder Isbn einen Wert enthält, ist die Angabe optional. Es wird dann versucht mit diesen Werten die eBay Katalogdaten zu nutzen. Enthält keine der Eigenschaften Ean, Upc oder Isbn einen Wert, ist diese Angabe Pflicht.
*Price*	Decimal	Optional	Enthält den Preis des Produktes Dieser Preis wird als Fest-/Sofortkaufenpreis für das eBay-Angebot genutzt. Das Dezimaltrennzeichen muss ein Punkt (.) sein. Beispiel: 19.99
*StockAmount*	Int32	Pflicht	Enthält den Bestand des Produktes Dieser Bestand wird als Menge für das eBay-Angebot genutzt. Wird der Bestand später reduziert, so wird die Menge des eBay-Angebots reduziert bzw. bei nicht ausreichendem Bestand wird das eBay-Angebot automatisch beendet. Wird der Bestand erhöht, so wird der aktueller Bestand als Menge zu eBay gesendet.
*Ean*	String	Optional	Ean des Produktes Mit diesem Wert wird versucht die eBay Katalogdaten zu nutzen. Sollte keine Angabe vorhanden sein, sollten Werte in den Eigenschaften Upc oder Isbn vorhanden sein. Ab dem 29.06.2015 ist die Angabe einer GTIN auf der eBay Plattform verpflichtend.
*Upc*	String	Optional	Upc des Produktes Mit diesem Wert wird versucht die eBay Katalogdaten zu nutzen. Sollte keine Angabe vorhanden sein, sollten Werte in den Eigenschaften Ean oder Isbn vorhanden sein. Ab dem 29.06.2015 ist die Angabe einer GTIN auf der eBay Plattform verpflichtend.
*Isbn*	String	Optional	Isbn des Produktes Mit diesem Wert wird versucht die eBay Katalogdaten zu nutzen. Sollte keine Angabe vorhanden sein, sollten Werte in den Eigenschaften Ean oder Upc vorhanden sein. Ab dem 29.06.2015 ist die Angabe einer GTIN auf der eBay Plattform verpflichtend.
*ProductType*	Int16	Pflicht	Gibt den Typen des Produktes an 0 = Einzelprodukt Nur ein Einzelprodukt kann Produktspezifikationen (Attribute) haben 1 = Variationsset Ein Variationsset ist eine Zusammenfassung von Einzelprodukten mit Spezifikationen 2 = Produktset Ein Produktset ist eine Zusammenfassung von Einzelprodukten ohne Spezifikationen
*ModificationDate*	DateTime	-	Enthält das Änderungsdatum Bei Änderungen vom Nutzer sowie bei Änderungen seitens eBay wird das Datum automatisch aktualisiert
*MatchingStatus*	Int16	-	Interner Identifikator
*VatPercent*	Float	Optional	Enthält die Mehrwertsteuer des Produktes
*IsWowDeal*	Boolean	-	Interner Identifikator
*UnitQuantity*	Float	Optional	Enthält den Inhalt des Produktes (z.B. 1,5 \| 0,7) Die Angabe dient zur Darstellung des Grundabgabepreises
*UnitType*	String	Optional	Enthält die Maßeinheit des Produktes (z.B. L, 100ml, Kilogramm) Die Angabe dient zur Darstellung des Grundabgabepreises Folgende Angaben sind zulässig: Kg 100g 10g L 100ml 10ml M M2 M3 Unit Die Schreibweise darf variieren. Es existiert eine interne Übersetzungs-Tabelle (Beispiel: 100 Gramm wird in 100g übersetzt). Sollte eine Übersetzung nicht greifen, kontaktieren Sie bitte unseren Support.
*DisableAutomatch*	Boolean	Optional	Gibt an, ob der interne Matchingprozess für die eBay Kategorievorschläge durchgeführt werden soll. Dieses Flag wird benötigt, wenn die ServiceOperation SetEbayCategory aufgerufen wird. Damit wird gewährleistet, dass der interne MatchingProzess übersprungen wird unhd stattdessen die Ebay Kategorien aus der ServiceOperation SetEbayCategory übernommen werden sollen.
*ShortDescription*	String	Optional	Enthält die Kurzbeschreibung des Produktes
*ConditionId*	String	Optional	Enthält den Zustand des Produktes Unterstütze Werte: "gebraucht" oder "neu"
*BestOfferAutoAcceptPrice*	Decimal	Optional	Enthält den Preis, ab dem Preisvorschläge automatisch angenommen werden sollen Angabe muss kleiner dem Verkaufspreis sein
*BestOfferMinimumPrice*	Decimal	Optional	Enthält den Preis, ab dem Preisvorschläge automatisch abgelehnt werden sollen Angabe muss kleiner dem BestOfferAutoAcceptPrice sein
*Mpn*	String	Optional	Enthält die Herstellernummer des Produktes. Ab dem 29.06.2015 ist die Angabe einer Mpn auf der eBay Plattform verpflichtend.
*Brand*	String	Optional	Enthält die Marke der Produktes Ab dem 29.06.2015 ist die Angabe einer Brand auf der eBay Plattform verpflichtend.

Navigation Properties

Mittels der Navigation Properties können assoziierte EntitySets zum EntitySet ListingItems abgerufen werden.

Die unten aufgeführten Beispiele beziehen sich auf das Entity mit der Id 1.

ProductImages

Abrufen von Produktbildern

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/ProductImages

ProductSpecifics

Abrufen von Produktspezifikationen

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/ProductSpecifics

ProductVariations

Abrufen der Produktvariationen

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/ProductVariations

ChildProducts

Abrufen von untergeordneten Produkten (zugeordnete Standardprodukte eines Produkt-/Variationsset)

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/ChildProducts

ParentProducts

Abrufen von übergeordneten Produkten

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/ParentProducts

Listings

Abrufen von plattformspezifischen Daten

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/Listings

ListingItems

Abrufen von eingestellten/verkauften Mengen

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/ListingItems

CarParts

Abrufen von zugehörigen CarParts

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/CarParts

DiscountOffers

Abrufen von zugehörigen DiscountOffer

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/DiscountOffers

OptionalProductAttributes

Abrufen von zugehörigen OptionalProductAttributes

GET https://sandboxapi.via.de/publicapi/v1/api.svc/Products(1L)/OptionalProductAttributes

Tags:

Erstellt von Thomas Hoffmann am 2012/08/16 15:08