PHP-Schnittstelle (API) für Buchkatalog.de-Webservice von KNV
Eine einfache und effiziente PHP-API ermöglicht Verlagen und Buchhändlern die Echtzeitanbindung ihrer Online-Shops an die XML-basierte Webservice-Schnittstelle des Grossisten Koch, Neff & Volckmar GmbH (KNV). Dessen Lagerbestand samt Produktdaten kann so als externe Produktdatenbank dynamisch in Webanwendungen zur Ergänzung des eigenen Produktportfolios integriert werden.
Dokumentation der SOAP-Schnittstelle von Buchkatalog.de
Dokumentation der KNV-PHP-API von eCCOMES
Pionierarbeit an der Schnittstelle
Als erster Anbieter realisierte eCCOMES Ende 2006 eine PHP-basierte Implementierung dieser KNV-Schnittstelle. Während der Projektdurchführung wurde in enger Zusammenarbeit mit KNV die Schnittstellenkommunikation erweitert und die Leistungsfähigkeit der Anbindung stark verbessert. Daten aus dem KNV-Bestand werden unabhängig von der eigenen Datenbank dynamisch und in Echtzeit auf dem KNV-Server ermittelt und wie eigene Produkte im Sortiment integriert.
Anwendungsbeispiele
Die PHP-API ermöglicht mit nur einem einzigen Funktionsaufruf (oder alternativ mit fünf Teilaufrufen), KNV-Bestände während der Laufzeit, z.B. bei einer konkreten Online-Suche, aus PHP-Anwendungen heraus effizient abzufragen und die Informationen in der Webanwendung innerhalb der eigenen Suchergebnisse darzustellen.
Die Anfrage an die KNV-Datenbank kann innerhalb Ihrer Suchprozedur stattfidnen. Die zeitliche Verzögerung ist bei optimaler Konfiguration minimal, kann jedoch andernfalls zu inakzeptablen Suchzeiten von mehreren Sekunden führen.
Sie können mit der API den Buchkatalog.de-Datenbestand
bei Suchanfragen innerhalb Ihrer Webanwendung parallel zur eigenen Suche abfragen und in die Suchergebnisse integrieren.
nur bzgl. eines Sachgebietes abfragen, den Bestand lokal speichern und in regelmäßigen Abständen über einen Cronjobs automatisch aktualisieren.
dazu nutzen, eigene Artikel um zusätzliche Texte und Angaben zu ergänzen (in Absprache mit KNV).
Shopspezifisch können KNV-Produkte gekennzeichnet, gesperrt oder in Statistiken gesondert ausgewiesen werden.
Unser Web Management System haben wir um ein Formular zur einfachen Steuerung der Schnittstelle erweitert.
Umsetzung und Einsatz in der Praxis
Wie einfach die PHP-Schnittstelle eingesetzt werden kann zeigt das folgende Code-Beispiel.
Mittels knv_login() identifizieren Sie sich als autorisierter Schnittstellennutzer bei KNV. knv_create_searchterm() erzeugt die Suchanfrage, die mittels knv_search() an den Webservices-Server von KNV übertragen wird. Danach kann Ihre eigene Suche stattfinden. Zum Schluss holen Sie die Suchergebnisse mittels knv_read() ab und melden sich durch knv_logout() aus. In dem Beispiel werden die Ergebnisse der Suche nach "Potter" direkt mit print_r() als array ausgegeben.
Mit der gemeinsam entwickelten quickSearch-Anfrage kann eine Suchanfrage mittels nur eines Befehls knv_quickSearch() durchgeführt werden, der das Login und das Logout bereits mit ausführt und direkt die Suchergebnisse liefert. Die anderen Aufrufe entfallen, was die Performance erheblich verbessert.
Der Einsatz in der Praxis erforderte über die minimale API hinaus noch weitere Funktionen, um die Vorgänge zu steuern und die Ergebnisse auszuwerten. Sie sind Inhalt des Moduls eCCOMES.KNV-SOAP-Webservice. In ersten Projekten konnten unsere Kunden signifikante Umsätze (ca. 10%) mit den zusätzlichen KNV-Artikeln erzielen.
Wir beraten Sie gerne bezüglich des Einsatzes der Schnittstelle sowie bei allgemeinen Fragen zur Anbindung des Buchkatalog.de-Webservice in Ihre Anwendung und Ihr Verwaltungssystem. Auch begleiten wir Sie bei der Umsetzung einer Anbindung oder führen diese für Sie durch.
Ihr Ansprechpartner
Peter Stanberg
eCCOMES GmbH
Reinsburgstr. 4
D-70178 Stuttgart