partner-news

Partner Newsletter #12

09. Dezember 2020
von

Liebe Partner, in unserem letzten Partner Newsletter vor Weihnachten wollen wir Euch nochmal einige interessante Neuigkeiten mit auf den Weg geben. Dieses Mal geht es um Änderungen an der Merchant Order API v1 und um unsere idealo business API.

Wir wünschen Euch eine besinnliche Weihnachtszeit, viel Gesundheit und einen guten Rutsch ins Jahr 2021!

Themen:


Onboarding-Stop für die MOAPI v1

Anfang des Jahres hatten wir bereits verkündet, dass die Merchant Order API v1 abgeschaltet wird und daher alle Shops, die bisher auf der v1 liefen, langfristig auf die v2 migrieren müssen. Daraus ergibt sich der nächste Schritt, in welchem wir ab dem 01.01.2021 über die Merchant Order API v1 keine neuen Onboardings von Shops vornehmen werden. Neue Shops müssen dann über die v2 angebunden werden.
Bestehende Shops können noch über die v1 weiterlaufen, allerdings wird diese im Verlauf des nächsten Jahres abgeschaltet


Erinnerung REVOKE - Live Schaltung 31.01.21

Wie wir euch bereits im letzten Newsletter mitgeteilt haben, wird es einen neuen Bestellstatus REVOKING geben.  Die Einführung dieses Status ist für den 31.01.2021 geplant.   
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 E-Mail. 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 vermieden werden. 
Der neue Status REVOKING bleibt als Status nur über Get Order(s) abrufbar und muss nur verfügbar gemacht werden, wenn dieser Endpunkt genutzt wird.


idealo Business API für Shops

Häufig sprechen uns Shops an, dass sie Daten aus idealo business nicht direkt im Portal abrufen, sondern lieber per API automatisiert zur Verfügung gestellt haben wollen. Diesen Wunsch der Händler nehmen wir sehr ernst. Im Rahmen einer idealo business API bündeln wir nun alle Schnittstellen, welche wir unseren Händlern via idealo business zur Verfügung stellen, um Daten automatisiert abzurufen. Im ersten Schritt bündeln wir nun die Schnittstelle zum Abrufen der Klickdaten unter der idealo business API.

Klickreport API  
Allen Preisvergleichs-Shops sowie Direktkauf-Shops wird nun die Möglichkeit geboten, ihre Klickdaten auch per API abzurufen. Hierbei geben wir aktuell den Klickreport auf Tagesbasis nach außen, sowie den detaillierten Klickreport. Das bedeutet, dass ein Shop sich in einem selbst gewählten Zeitraum einen Report erstellen kann, in welchem er: 

  • die absolute Anzahl der Klicks pro Tag für den ausgewählten Zeitraum zurück bekommt (Klickreport auf Tagesbasis) ODER
  • die einzelnen Klicks aufgeschlüsselt je Angebote für den ausgewählten Zeitraum zurück bekommt (detaillierter Klickreport) 

Die Dokumentation findet ihr hier bzw. zeigen wir sie dem Shop auch beim Erstellen des Zugangs zur API an. 

English version

_____________________________________________________________________________________________________________________________________________

Dear partners, in our last Partner Newsletter before Christmas we want to give you some interesting news. This time we will focus on changes to the Merchant Order API v1 and our idealo business API.

We wish you a merry christimas time and a happy new year 2021! 

Themen:


Onboarding stop for MOAPI v1

Earlier this year we announced that the Merchant Order API v1 would be switched off and therefore all merchants that were running on v1 had to migrate to v2 in the long term. This will result in the next step, in which we will not be able to perform any new onboarding of merchants via the Merchant Order API v1 as of 01.01.2021. New merchants will then have to be connected via v2.  

Existing merchants can still continue to use v1, but it will be switched off during the next year.


Reminder REVOKE – Launch: 31.01.2021

As we already informed you in the last newsletter, there will be a new order status REVOKING. The launch of this status is planned for 31.01.2021.   

This status will be set by idealo when an end customer informs us that he wishes to cancel his order. Often this happens shortly after the order is placed if the customer notices an error in the order. Currently, the merchant receives a cancellation information from our customer service department via e-mail. The new status ensures that cancellation requests reach the merchant more quickly, thus avoiding unnecessary costs for shipping the goods. 

The new status REVOKING remains available as a status only via Get Order(s) and must be made available now if this endpoint is used.


idealo Business API for Shops

Frequently, merchants tell us that they do not want to retrieve data from idealo business directly from the portal, but would rather have it made available automatically via API. We take this request from shops very seriously. Within the framework of an idealo business API, we are now pooling all interfaces that we make available to our merchants via idealo business in order to retrieve data automatically. In a first step, we are now pooling the interface for retrieving click data under the idealo business API. 

Click report API

All price comparison and direct purchase merchants are now offered the possibility to retrieve their click data via API. In this case we currently provide the click report on a daily basis to the outside world, as well as the detailed click report. This means that a merchant can create a report in a self-selected period of time, in which he is able to see all the click data: 

  • the absolute number of clicks per day for the selected period (click report on a daily basis) OR
  • gets back the individual clicks broken down per offer for the selected period (detailed click report)

You can find the documentation here or we will show it to the merchant when creating access to the API.