Version 1.0 Dateiname VVA_OLA_Schnittstellenbeschreibung_2012.docx Erstellt am 30.05.2010 Seitenanzahl 5 arvato media GmbH
Historie der Dokumentversionen Version Datum Autor Änderungsgrund / Bemerkungen 1.0 30.05.2010 arvato media GmbH Ersterstellung Inhaltsverzeichnis Historie der Dokumentversionen... 2 Inhaltsverzeichnis... 2 1 Allgemeines... 3 2 Web Service Definition/Adresse Webservice... 3 3 Felder für die Anfrage... 3 4 Felder der Antwort... 4 5 Beispiel... 4 5.1 Anfrage... 4 5.2 Antwort... 4 6 Ansprechpartner... 5 Seite 2 von 5
1 Allgemeines Über den Webservice OLA der VVA-Gruppe kann die Verfügbarkeit von einem oder mehreren Artikeln, welche über die VVA oder den Verlegerdienst München ausgeliefert werden, abgefragt werden. Eine Reservierung oder Bestellung der Artikel über den Webservice ist noch nicht vorgesehen. Das Warenwirtschaftssystem verschickt einen XML Datensatz mit der EAN (ISBN oder VVA Artikelnummer) und ggf. Positionsnummer. Es können zwei verschiedene Abfragemöglichkeiten genutzt werden: 1. Abfrage nach Einzeltitel Der Kunde fragt aus der Bibliographie einen Einzeltitel ab. Pflichtfeld ist die EAN (ISBN oder VVA Artikelnummer) 2. Abfrage nach Auftrag Der Kunde hat einen kompletten Auftrag erfasst. Für diesen Auftrag wird eine OLA an einen Webservice gestartet. Angefragt werden alle Artikel des Auftrags. Pflichtfelder sind die Positionsnummer und die EAN (ISBN oder VVA Artikelnummer). Die Verfügbarkeit wird mit folgenden Stati angezeigt: JA Artikel ist lieferbar NEIN Artikel ist nicht lieferbar VIELLEICHT Artikel ist noch am Lager, aber der durchschnittliche Tagesabsatz ist höher als der aktuelle Bestand, so dass eine Lieferbarkeit nicht zu 100 Prozent zugesichert werden kann. Ist ein Artikel nicht lieferbar, so wird als zusätzliche Information der Meldetext bzw. soweit vorhanden der geplante Wiedererscheinungstermin angezeigt. Kann der Artikel in der Anfrage nicht identifiziert werden (z.b. weil er nicht über die VVA oder den Verlegerdienst München ausgeliefert wird) oder handelt es sich um einen Artikel der schon sehr lange nicht mehr lieferbar ist, so wird die Information UNBEKANNTER ARTIKEL zurückgegeben. Diese Dokumentation soll bei der Implementierung des VVA OLA Webservices in ein Warenwirtschaftssystem helfen. Der Webservice OLA wurde auf den Standardprotokollen des W3C entwickelt: Übertragung der Daten: Verpacken der Daten: Webservice Protokoll: Beschreibung Funktionen/Parameter: HTTP (Hypertext Transfer Protocol) XML (Extensible Markup Language) SOAP (Simple Object Access Protocol) WSDL (Web Service Definition Language) Eine explizite Anmeldung für den Webservice ist nicht notwendig. 2 Web Service Definition/Adresse Webservice Die Beschreibung des Webservices in WSDL kann unter der URL: http://vva-ola.de.dedi3253.yourserver.de/olawebservice.php abgerufen werden. Über diese URL wird auch der Webservice aufgerufen. 3 Felder für die Anfrage Feld Datentyp Beschreibung Positionsnummer String Nur notwendig, wenn mehr als ein Artikel gleichzeitig angefragt wird Artikelnummer String EAN, ISBN 10 oder die VVA-Artikelnummer Seite 3 von 5
4 Felder der Antwort Feld Datentyp Beschreibung positionsnummer String artikelnummer String EAN, ISBN 10 oder die VVA-Artikelnummer artikelbezeichnung String verlagsname String Name des Verlags lieferbarkeit String Möglicher Inhalt: Ja/Nein/Vielleicht/UnbekannterArtikel meldetext String Hinweis wann der Artikel voraussichtlich wieder lieferbar ist 5 Beispiel 5.1 Anfrage <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ola="http://ola"> <soapenv:header/> <soapenv:body> <ola:einzeltitel> <!--Optional:--> <ola:positionsnummer>1</ola:positionsnummer> <ola:artikelnummer>9783404160464</ola:artikelnummer> </ola:einzeltitel> </soapenv:body> </soapenv:envelope> 5.2 Antwort <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://ola"> <SOAP-ENV:Body> <ns1:einzeltitelresponse> <ns1:rettitel> <ns1:positionsnummer>1</ns1:positionsnummer> <ns1:artikelnummer>9783404160464</ns1:artikelnummer> <ns1:artikelbezeichnung>beck, Das zerbrochene Fenster </ns1:artikelbezeichnung> <ns1:verlagsname>bastei Lübbe TB</ns1:verlagsname> <ns1:lieferbarkeit>nein</ns1:lieferbarkeit> <ns1:meldetext>lieferbar ab: 12.07.2012</ns1:meldetext> </ns1:rettitel> </ns1:einzeltitelresponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Seite 4 von 5
6 Ansprechpartner Bei Fragen zur Umsetzung des Webservices können Sie sich an die Mitarbeiter der Zentralen Handelsbetreuung wenden: Doris Figgemeier Telefon: +49 (0) 52 41-80 40 192 Patrick Arp Telefon: +49 (0) 52 41-80 28 93 E-Mail: vva-handelsbetreuung@bertelsmann.de Seite 5 von 5