partner-news

Partner Newsletter #11

07. September 2020

Liebe Partner, wir hoffen, ihr kommt gut durch die Corona-Krise. Im letzten Newsletter haben wir euch diesbezüglich die Aktionen unserer Partner und von idealo vorgestellt. Heute informieren wir euch über wichtige Änderungen an der Merchant Order API v2 und stellen euch den Leitfaden für Technologiepartner vor. Bleibt weiterhin gesund!

Themen:


Neuer Bestellstatus REVOKING

In naher Zukunft werden wir den neuen Status "REVOKING" für Bestellungen einführen. Dieser Status wird von idealo gesetzt, wenn ein Endkunde bei uns einen Stornierungswunsch der Bestellung meldet. Häufig erfolgt dies kurz nach der Bestellung, wenn der Kunde einen Fehler bei der Bestellung bemerkt. Derzeit erhält der Händler von unserem Kundenservice eine Information zur Stornierung per Email. Der neue Status sorgt dafür, dass Stornierungswünsche schneller den Händler erreichen und so ggf. unnötige Kosten durch den Versand der Ware verhindert werden.

Der neue Status betrifft lediglich die MOAv2. Er wird erst aktiv geschaltet, wenn alle Partner und Shops, die die Endpunkte getOrder und/oder getOrders benutzen, diesen verarbeiten können. Dies wird voraussichtlich bis Ende September der Fall sein. Alle Partner und Shops, die den Status nicht abrufen oder auf der MOAv1 arbeiten, werden weiterhin nur per Email über den Stornierungswunsch des Kunden informiert.


Neue Fehlermeldung für Refunds

Für Refunds wurden für die MOAv2 neue Fehlermeldungen umgesetzt. Diese sind im Changelog der MOAv2 dokumentiert.

Folgende Fälle werden ab jetzt gemeldet:

  • order has not been paid with IDEALO_CHECKOUT_PAYMENTS (Bestellung wurde nicht mit idealo Direktkauf Payments bezahlt)
  • order is older than 50 days (Bestellung ist älter als 50 Tage)
  • sum of all refunds exceeds the total price of the order (Summer aller Rückerstattungen übersteigt Gesamtpreis der Bestellung)

Die Beschreibung findet ihr hier. Bitte stellt sicher, dass diese Meldungen verarbeitet werden und ggf. auch die Begründung für den Händler sichtbar ist.


Leitfaden für Technologiepartner

Wir freuen uns, euch in diesem Newsletter den Leitfaden für Technologiepartner vorstellen zu können. Der Leitfaden dient der optimalen und effektiven Zusammenarbeit von technischen Partnern und idealo. Neben den Grundlagen des idealo Geschäftsmodells und einer Beschreibung der Produkte von idealo enthält das Dokument auch die allgemeinen Anforderungen an die technische Zusammenarbeit über die idealo Schnittstellen.

Der Leitfaden soll weder die Informationen auf partner.idealo.com oder im Händlerbackend idealo Business noch die jeweiligen Dokumente zur Erstellung eines Export-Feeds, der Angebots oder Bestelldaten-API (PWS 2.0/ MOAPI 2.0) ersetzen, sondern als Zusammenfassung und Ergänzung dienen, um die Informationen im gesamtheitlichen Rahmen der Zusammenarbeit mit idealo für Händler und Partner transparent darzustellen und Best-Practices aufzuzeigen.

English version

_____________________________________________________________________________________________________________________________________________

Dear partners, we hope you manage to get through the Corona crisis well. In the last newsletter we introduced you to the initiatives of our partners and idealo. Today we will inform you about important changes of the Merchant Order API v2 and will present you our guideline for technology partners. Stay healthy!

Our topics:

New order status REVOKING

Soon we are going to introduce the new order status "REVOKING". This status will be set by idealo when an end customer informs us of an order cancellation request. This often happens shortly after the order is placed, when the customer notices an error in the order. Currently, the merchant receives a cancellation information from our customer service via email. The new status ensures that cancellation requests reach the retailer quicker, avoiding unnecessary costs for shipping the goods. 

The new status only affects MOAv2 and will only be activated when all partners and stores using the endpoints getOrder and/or getOrders can process it. This will probably be the case by the end of September. All partners and stores that do not retrieve the status or work on MOAv1 will continue to be informed about the customer's cancellation request only by email. 


New error message for Refunds

New error messages have been implemented for Refunds for the MOAv2. These are documented in the MOAv2 changelog.

The following cases are reported from now on:

  • order has not been paid with IDEALO_CHECKOUT_PAYMENTS
  • order is older than 50 days
  • sum of all refunds exceeds the total price of the order

You can find the description here. Please make sure that these messages are processed and if applicable the reason is visible for the merchant.


Guideline for technology partners

We are pleased to present to you our guideline for technology partners (in German) in this newsletter.

The guideline helps technical partners and idealo to work together in the best and most effective way. In addition to the basics of idealo's business model and a description of idealo's products, the document also contains the general requirements for technical cooperation via idealo interfaces.

The guideline for technology partners is not meant to replace either the information on partner.idealo.com or in the merchant backend idealo Business. Also the respective documents for the creation of an export feedback, the offer or order data API (PWS 2.0/ MOAPI 2.0) should not be compensated. Rather it should serve as a summary and addition in order to present the information in the overall framework of the cooperation with idealo in a transparent manner for merchants and partners and to highlight best practices.