Buchhandel.de Callback. Konfiguration, Parameter und Rückgabewerte

Transkript

1 Konfiguration, Parameter und Rückgabewerte 1

2 Inhalt 1 ÜBER DIESES DOKUMENT BUCHHANDEL.DE WEBSERVICE CALLBACK - EINZELTITELÜBERGABE Funktionsweise Datenfelder der Bestellweiterleitung Konfiguration Webservice KONTAKT...7 2

3 1 ÜBER DIESES DOKUMENT Dieses Dokument beschreibt einen Standard-Webservice zur Integration der Buchhandel.de- VLB-Suche in die Webseite/den Online-Shop eines Kunden samt Weiterleitung von Bestellungen an das Shopsystem des Kunden (sog. Callback-Lösung). Die Bestellweiterleitung gestaltet sich derzeit wie folgt: Beim Auslösen einer Bestellung durch den Endkunden werden Titelinformationen (ISBN, Preis, Titel u. a.) an ein von Kunden bereitgestelltes Shopsystem weitergeleitet. Die Übermittlung findet titelweise statt. Die Verwaltung der Bestellungen und Kundendaten ist vom Shopsystem des Kunden zu leisten. Die hier beschriebene Bestellweiterleitung erfolgt nur bei Nutzung des Callback-Webservices. Die Bestellweiterleitung aus dem zentralen Buchhandel.de Portal erfolgt weiterhin per . 2 Buchhandel.de Webservice Callback - Einzeltitelübergabe Die Einbindung der Callback-Lösung in die kundeneigene Präsenz erfolgt über den folgenden Aufruf, der zwei durch eckige Klammern gekennzeichnete Variablen enthält. der_buchhandlung> Der erste Parameter, zur Identifizierung des Kunden, die <CALLER_ID> wird der Buchhandlung beim Einrichten des Webservice von der MVB mitgeteilt. Der zweite Parameter uid dient der Identifizierung einer Transaktion/eines Bestellvorgangs und kann von der Buchhandlung generiert und dem Link angefügt werden. Für die Konfiguration der Anwendung sind einige Angaben von Kundenseite notwendig (siehe Abschnitt 2.3). 2.1 Funktionsweise Bei der Einzeltitelübergabe wird jede einzelne bestellte Titel aus der Titelliste oder Titeldetailansicht der Buchhandel.de-Suche an den Shop der Buchhandlung übergeben. wird der Artikel mit den unten aufgeführten Pa- Beim Anklicken des Warenkorbsymbols rametern an die Buchhandlung übergeben. Gleichzeitig erscheint eine vom Callback-System generierte Meldung Ihr Warenkorb wurde aktualisiert. 3

4 Abbildung 1 - Titelliste Abbildung 2 - Titeldetailansicht 4

5 2.2 Datenfelder der Bestellweiterleitung Bei der Bestellweiterleitung über den Callback-Service werden die folgenden Felder durch Lehrzeichen(Tabulator) getrennt übertragen: Rückgabewerte am Beispiel des Titels mit ISBN : SessionId=1d1a8099af95c8da uid=buha_sessionid ArtNr= flagpriceeurd=1 PriceEURD=49.9 flagpriceeura=1 PriceEURA=51.3 flagpricechf=0 PriceCHF=0 VatCode=1 Artikel=Augenoptik<br%20/>Köhl,%20Hans%20/%20Roth,%20Günter%20(DOZ- Verlag%20Optische%20Fachveröffentlichung) Im Folgenden sind die Rückgabewerte des Webservice tabellarisch aufgelistet und erläutert: Parameter Erstellt von BSP Erläuterung SessionId Buchhandel.de 1d1a8099af95c8da Vom Buchhandel.de System generierte Session ID uid Buchhandlung Unique Identifier Die UID muss beim Aufruf des Shoplinks von der Buchhandlung mitgegeben werden. Die UID wird wieder an die Buchhandlung zurückgegeben und kann z.b. zur Identifikation des Kunden, der sich auf der Webseite der Buchhandlung befindet verwendet werden ArtNr Buchhandel.de stellige ISBN oder anderer Identifier wie z.b. ISSN flagpriceeurd Buchhandel.de 1 Legt fest ob ein Preis vorhanden ist (1) oder nicht (0) PriceEURD Buchhandel.de 49.9 Deutscher Preis in Euro flagpriceeura Buchhandel.de 1 Legt fest ob ein Preis vorhanden ist (1) oder nicht (0) PriceEURA Buchhandel.de 51.3 Österreichischer Preis in Euro flagpricechf Buchhandel.de 0 Legt fest ob ein Preis vorhanden ist (1) oder nicht (0) PriceCHF Buchhandel.de 0 Schweizer Preis in CHF VatCode Buchhandel.de 1 Mehrwertsteuerschlüssel (0,1,2,leer) siehe Tabelle 2 - mögliche Mehrwertsteuerschlüssel Artikel Buchhandel.de Augenoptik<br%20/>Köhl Der Parameter Artikel enthält den Titel, Autor sowie den Verlag durch Zeilenumbruch bzw. Klammern getrennt (siehe Beispiel) Tabelle 1 Rückgabewerte des Titelservice 5

6 Der Parameter VatCode kann folgende Werte annehmen: Wert Erläuterung Anzeige auf Bsp ISBN (August 2007) Buchhandel.de 2 volle Mehrwertsteuer Preisangabe reduzierte Mehrwertsteuer Preisangabe keine Mehrwertsteuer Preisangabe Kein Wert keine MWST Angabe Preis auf Anfrage Tabelle 2 - mögliche Mehrwertsteuerschlüssel Der Rückgabewert Artikel enthält, sofern für diesen Titel vorhanden, die folgenden Angaben in der aufgeführten Reihenfolge: 1. Titel 2. Autor(en) 3. Verlag 2.3 Konfiguration Webservice Zur Konfiguration des Webservice sind verschiedene Parameter im Backendsystem von Buchhandel.de durch die MVB zu konfigurieren. Diese Parameter sind der MVB von der Buchhandlung mitzuteilen und können ausschließlich durch die MVB geändert werden. Parameter Vorgabe durch Beispiel Erläuterung URL Buchhandlung Allgemeine Webseite der Buchhandlung URL Titel hinzufügen URL Warenkorb anzeigen Aktion nach der Titelübergabe Buchhandlung URL, an die die Titelparameter ü- bergeben werden Buchhandlung URL, die aufgerufen wird, wenn der Link zum Warenkorb angeklickt wird und zur Anzeige des Warenkorbs nach der Titelübergabe Auswahl durch Buchhandlung zwischen weiterstöbern und zum Warenkorb Tabelle 3 - Titelübergabepfade weiterstöbern Diese Auswahl gibt an, ob nach der Auswahl eines Titels wieder die Ergebnisliste mit der Suchmaske oder der Warenkorb der Buchhandlung angezeigt werden soll. 6

7 3 KONTAKT Technischer Support: Christoph Böbinger Tel. +49 (0)