idealoUpdateOffers - Idealo Webservice

← Idealo Webservice Add-On Übersicht

Mit diesem Step können Angebote auf idealo hinzugefügt, geändert oder gelöscht werden. Voraussetzung ist die Freischaltung für idealo Webservices. Hierfür wenden Sie sich bitte unter der e-mail tam@idealo.de an idealo. Das Schema dieses Steps beinhaltet mehrere <em>Eingabefelder</em>, welche entsprechend der Aktion gemapped werden müssen bzw. können.<br /> Alle Eingabefleder enthalten eine ausführliche Beschreibung zu deren Verwendung und Bedeutung. <em>Ausgabefelder des Steps</em> (idealoUpdateOffersResponse): offerResponse_sku - SKU von dem Angebot, wie übertragen<br /> offerResponse_id - ID von dem Angebot (wird von idealo vergeben)<br /> offerResponse_status - Ergebnis der Verarbeitung durch den idealo WebService<br /> offerResponse_statusMsg - Eine kurze Beschreibung des Fehlers. Ansonsten leer. Bei fehlerfreier &Uuml;bertragung ist der offerResponse_status=OK.

Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
account	ACCOUNT		Nein
Aktion	STRING	<b>Anlegen</b>:<br>Ein neues Angebot wird mit den Daten aus der Anfrage erzeugt. Falls die SKU bereits vergeben ist, wird eine Fehlermeldung zurückgeliefert. <br><b>Aktualisieren:</b><br> Aktualisiert bei dem Angebot mit der übergebenen SKU alle ebenfalls übergebenen Angebotseigenschaften. Nicht übergebene Eigenschaften bleiben unverändert. Mit Update können derzeit keine Angebote komplett gelöscht werden, hierzu ist Replace notwendig. <br><b>Ersetzen:</b><br> Ersetzt das Angebot mit der übergebenen SKU durch ein neues Angebot mit den Daten im XML. Falls noch kein Angebot mit der SKU existiert, wird eine Fehlermeldung zurückgeliefert. <br><b>Anlegen oder Ersetzen:</b><br> Ersetzt das Angebot mit der übergebenen SKU durch ein neues Angebot mit den Daten im XML. Falls noch kein Angebot mit der SKU existiert, wird ein neues Angebot mit den übergebenen Daten erzeugt <br><b>Löschen:</b><br> Löscht das Angebot mit der übergebenen SKU.	Nein	Anlegen Aktualisieren Ersetzen Anlegen oder Ersetzen Löschen
limit	STRING	Limit the number or rows used from the input SPREADSHEET. Use low values for testing. Default: 5	Nein
idealoOffers	SPREADSHEET	Liste mit Angeboten	Nein
mappingdefinition	STRING	The mapping definition JSON String	Nein
	Folgende Felder sind zu konfigurieren: Feld Datentyp Beschreibung Pflichtfeld Standardwert sku SINGLE Eindeutiger Bezeichner eines Angebots, welcher von Ihnen frei gewählt werden kann Ja title SINGLE Bezeichnung des Angebots, wird im Preisvergleich angezeigt Ja url SINGLE URL zur Angebotsseite im Shop Ja price SINGLE Preis des Angebots in Euro Ja listPrice SINGLE Listenpreis für ein Produkt Nein formerPrices SINGLE Sogenannte Streichpreise sind ehemalige Verkaufspreise. Wird benutzt, um die Differenz zum aktuellen Verkaufspreis darzustellen. Nein productTitle SINGLE Hier kann eine für die automatische Produktzuordnung optimierte Produktbezeichnung übergeben werden. Diese enthält optimalerweise nur eine reduzierte Bezeichnung des Shopangebots. Nein description SINGLE Beschreibung des Angebots, verbessert die Zuordnung zum Produktkatalog und wird im Preisvergleich angezeigt. Nein category SINGLE frei wählbare Kategoriebezeichnung, welche die Produktgruppe beschreibt. Hier möglichst keine Hersteller-und Modellbezeichnungen verwenden. Nein image SINGLE URL zum Angebotsbild im Shop Nein brand SINGLE Hersteller des Produktes, verbessert die Zuordnung zum Produktkatalog Nein ean SINGLE EAN/GTIN des Angebots, verbessert die Zuordnung zum Produktkatalog. ISBN-Nummern können ebenfalls hier übergeben werden. Nein delivery SINGLE Lieferzeit des Angebots z.B: sofort lieferbar, versandfertig in 24 Stunden, 3-5 Werktage Nein shipping SINGLE Versandkosten für die angegebene Zahlungs-/Versandart. In dieses Feld können mehrere Versandkosten je Zahlart und optional die Länderkennung angeben werden. Die Werte sind durch einen Doppelpunkt zu trennen und Eingabe von mehreren Versandkosten, sind dies durch ein Semikolon getrennt. Bsp: 5.99:CREDITCARD;7.99:PAYPAL:AT Nein shippingComment SINGLE Kommentar zum Artikelversand oder zu Zahlungsweisen Nein checkoutApproved SINGLE Hiermit geben Sie ein Angebot im Feed für den Direktkauf frei. Nur für Angebote, die über dieses Datenfeld freigegeben werden, kann im idealo Direktkauf ein Kaufvorgang gestartet werden. Lassen Sie dieses Datenfeld weg, gilt das Angebot als nicht freigegeben. Nein checkoutLimitPerPeriod SINGLE Hier können Sie idealo den Lagerbestand des Angebots angeben. Dies ist insbesondere bei begrenzten Sonderangeboten sinnvoll oder wenn sie eine größere Stückzahl eines Artikels in einem Checkout-Vorgang verkaufen wollen. Bei gesetztem Wert stellt idealo sicher, dass nicht mehr Angebote verkauft werden, als Sie verfügbar haben. Ohne diese Angabe bleibt das Angebot im Direktkauf verfügbar, bis das Angebot entweder gelöscht wird oder über checkoutApproved" die Freigabe für den Direktkauf zurückgezogen wird. idealo empfiehlt im Kunden- und Händlerinteresse, dieses Feld bei allen Angeboten zu setzen. Nein voucherCode SINGLE GutscheinCode mit Beschreibung. Bitte unbedingt die Struktur des Beispiels einhalten → CODE (Beschreibung) Nein
Testmodus	STRING	Der Testmodus dient dazu, die Erreichbarkeit des Webservice und die syntaktische Korrektheit der Anfrage zu überprüfen.<br><br> <b>ein</b> - Anfrage wird getestet<br> <b>aus</b> - Anfrage wird übertragen	Nein	ein aus

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name	Datentyp	Beschreibung	Werte
idealoUpdateOffersResponse	SPREADSHEET
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Standardwert offerResponse_sku SINGLE offerResponse_id SINGLE offerResponse_status SINGLE offerResponse_statusMsg SINGLE