Buchhandel.de Caller Parameter Buchhandel.de Caller Version 0.1; Stand: September 2007 1
Inhalt 1 ÜBER DIESES DOKUMENT...3 2 BUCHHANDEL.DE WEBSERVICE CALLER...3 2.1 Suchfelder des Caller Service...3 2.2 Aufruf eines Artikels in der Detailansicht...5 2.3 Parameter für die Übergabe an den Buchhandel.de Warenkorb...5 2.4 Direkter Aufruf des Warenkorbes...7 3 KONTAKT...9 2
1 ÜBER DIESES DOKUMENT Dieses Dokument beschreibt die Parameter des Calleraufrufs aus dem Buchhandel.de Webshop der Buchhandlung sowie die weitern mit dem Caller Modell möglichen Funktionen. Die Parameter des Katalog Webservice mit eigenem Warenkorb sind gleich den Parametern des Caller Webservice. Der Unterschied besteht darin, dass für den Katalogservice die max. Treffermenge auf die Titel des Verlages eingeschränkt ist. 2 Buchhandel.de Webservice Caller Der Caller Webservice ist nur bei einer Einbindung des Webshops über die Webseite der Buchhandlung möglich. Der Caller Service erlaubt es der Buchhandlung, die Standard Buchhandel.de Suchmaske zu verwenden: Der erste Parameter <CALLER_ID> wird der Buchhandlung beim Einrichten des Webservice von der MVB mitgeteilt. 2.1 Suchfelder des Caller Service Die Suchmaske des Caller Service kann mit voreingestellten Parametern aufgerufen werden. mögliche Suchfelder: Die folgenden Suchfelder können einzeln oder in Kombination zur Suche verwendet werden: &stichwort=<searchterm> &autor=<searchterm> &preis_von=<searchterm> &preis_bis=<searchterm> &schlagwort=<searchterm> &jahr_von=<searchterm> &jahr_bis=<searchterm> &reihentitel=<searchterm> &medientyp=<searchterm> &verlag=<searchterm> &isbn=<searchterm> &titel=<searchterm> Die der URL angehängten Suchbegriffe müssen URL encoded sein, z.b. author=fäcke, Christiane ergibt: &autor=f%e4cke%2c+christiane Durch einen zusätzlichen Aufruf Parameter (&func=search) kann die Suche mit dem Aufruf sofort ausgeführt werden: http://www.buchhandel.de/webapi1/titelsuche.asp caller=<caller_id> &func=search &reihentitel=stadtgeschichte 3
Erläuterung der Suchparameter: Parameter Erläuterung Stichwort Ein oder mehrere Stichworte Autor Autor Preis_von Startpreis der Suche Preis_bis Endpreis der Suche Schlagwort Schlagwort Jahr_von Anfangsjahr für die Suche Jahr_bis Endjahr für die Suche reihentitel Reihentitel medientyp Medientyp aus der Auswahlliste verlag Verlag isbn ISBN13 titel Genauer Titel Tabelle 1 - mögliche Suchfelder Eine Kombination der Parameter ist auch möglich: &autor=f%e4cke%2c+c hristiane&stichwort=unterrichtswerk Medientypen: Medientyp Alle Medien Hardcover Hörbuch Kalender Landkarten Schulbücher Software Taschenbücher Zeitschriften Sonstige Non-Books Audiocassetten allg. Audio-CDs allg. DVD allg. Loseblattausgaben allg. Microfiches allg. Videokassetten allg. Argument Keine Angabe HC HOB KL LDK SB SCD TB ZS NB ACS ACD DVD LOS MIF VCS Tabelle 2 - mögliche Medientypen Eine Kombination der Medientyp Argumente ist auch möglich z.b. http://www.buchhandel.de/webapi1/titelsuche.asp?func=search&caller=<caller_id>&stichwort=mat hematik&medientyp=scd&sb Das Ergebnis sind Schulbücher mit dem Stichwort Mathematik und CD Beilage. 4
2.2 Aufruf eines Artikels in der Detailansicht Mit der folgenden URL kann ein Artikel in der Detailansicht aufgerufen werden. &func=directisbnsearch &isbn=<isbn13> Beispiel: &func=directisbnsearch &isbn=978-3-8155-9976-1 2.3 Parameter für die Übergabe an den Buchhandel.de Warenkorb Mit Hilfe der folgenden URL ist es möglich einzelne Titel in den VLB Warenkorb zu übergeben. Es kann jeder Titel nur einmal übergeben werden, d.h. bei zweimaliger Übergabe werden nicht zwei gleiche Titel in den Warenkorb übernommen. Die Anzahl pro Titel muß in der Weboberfläche des Warenkorbes angepasst werden. http://www.buchhandel.de/webapi1/warenkorb.asp?func=addtobasket &Caller=<CALLER_ID> &Isbn=ISBN13 &SrcId=ISBN13 &Title= <Titel> &haspriced=<hasprice Eur> &PriceD=<Price Eur> &haspricea=<hasprice A> &PriceA=<Price A> &haspricech=<hasprice CH> &PriceCH=<Price CH> &VATKey=<Vat Key> 5
Im Folgenden sind die Parameter des Webservice für die Tietlübergabe an den Buchhandel.de Warenkorb tabellarisch aufgelistet und erläutert: Parameter Erstellt von BSP Erläuterung CALLER_ID Buchhandel.de test Vom Buchhandel.de bei der Anmeldung der Buchhandlung vergebene Caller ID ISBN Buchhandlung 978-3-922269-18-2 Angabe der ISBN13 Nummer, es findet keine Überprüfung der ISBN Nummer statt SrcID Buchhandlung 978-3-922269-18-2 Angabe der ISBN13 Nummer, es findet keine Überprüfung der ISBN Nummer statt Title Buchhandlung Blutige Steine<br>Commissario Brunettis vierzehnter Fall<br>Leon, Donna (Diogenes) Titel der im Warenkorb angezeigt werden soll haspriced Buchhandlung 1 Legt fest ob ein Preis vorhanden ist (1) oder nicht (0) PriceD Buchhandlung 49.9 Deutscher Preis in Euro haspricea Buchhandlung 1 Legt fest ob ein Preis vorhanden ist (1) oder nicht (0) PriceA Buchhandlung 51.3 Österr. Preis in Euro haspricech Buchhandlung 0 Legt fest ob ein Preis vorhanden ist (1) oder nicht (0) PriceCH Buchhandlung 0 Schweizer Preis in CHF VATKey Buchhandlung 1 Mehrwertsteuerschlüssel (0,1,2,leer) siehe Tabelle 4 - mögliche Mehrwertsteuerschlüssel Tabelle 3 - Parameter der Warenkorbübergabe Der Parameter VatKey kann folgende Werte annehmen: Wert Erläuterung Anzeige auf Bsp ISBN (August 2007) Buchhandel.de 2 volle Mehrwertsteuer Preisangabe 978-3-936427-38-7 1 reduzierte Mehrwertsteuer Preisangabe 978-3-404-60504-0 0 keine Mehrwertsteuer Preisangabe 978-3-926311-81-8 Kein Wert keine MWST Angabe Preis auf Anfrage 978-3-925346-34-7 Tabelle 4 - mögliche Mehrwertsteuerschlüssel Bei der Titelübergabe an den Buchhandel.de Warenkorb wird keine Überprüfung der übergebenen Daten gegenüber dem VLB vorgenommen. Das Löschen eines Titels aus dem Warenkorb ist nur über die Weboberfläche durch Ändern der Anzahl auf 0 möglich. Beispiel: http://www.buchhandel.de/webapi1/warenkorb.asp?func=addtobasket &Caller=<CALLER_ID> &Isbn=978-3-257-06523-7 &SrcId=978-3-257-06523-7 6
&Title= Blutige Steine<br>Commissario Brunettis vierzehnter Fall<br>Leon, Donna (Diogenes) &haspriced=1 &PriceD=22,90 &haspricea=1 &PriceA=11,90 &haspricech=1 &PriceCH=9,90 &VATKey=1 Rückmeldung auf die Titelübergabe an den Warenkorb: Ein Popup mit der Meldung: Ihr Warenkorb wurde aktualisiert erscheint. Der folgender Text wird im Browser angezeigt: 0 basket(s) /// Blutige Steine Commissario Brunettis vierzehnter Fall Leon, Donna (Diogenes)/// ///22,90///11,90///9,90 ///VATKey : 1/// basket.id=78899 basket.itemcount=0 basket.totalprice=0 ///22,90///11,90///9,90 ADDED TO INTERNAL BASKET 0 basket(s) Just added : 978-3-257-06523-7 2.4 Direkter Aufruf des Warenkorbes Mit dem folgenden Aufruf kann der Warenkorb direkt aufgerufen werden: http://www.buchhandel.de/webapi1/warenkorb.asp?caller=<caller-id> Das Beispiel aus der Übergabe an den Buchhandel.de Warenkorb ergibt folgenden Eintrag im Warenkorb: 7
Die Anzahl der Artikel kann erst hier erhöht werden. 8
3 KONTAKT Technischer Support: Christoph Böbinger Tel. +49 (0)69 1306-212 E-Mail: buchhandel.de@mvb-online.de 9