10. Mai 2010

Anbindung an x-HaBu Buchhaltungsprogramme verfügbar…

Abgelegt unter: Anbindungen an Drittplattformen, allgemeines zum Shopsystem, das Shopbackend - der Administrationsbereich | — Tags:, , , , , , , , , , , , — admin @ 09:44

Ab sofort können my-Warehouse Shopbetreiber eine Anbindung an die HaBu Buchhaltungsprogramme der MC Richter GbR nutzen.

Damit können die Buchhaltungsprogramme Lin-HaBu, Mac-HaBu und Win-HaBu Bestellungen/Rechnungsdaten direkt aus dem my-Warehouse Onlineshop über das XML API des Shopsystems holen. Die Konfiguration der Schnittstelle beschränkt sich shopsystemseitig durch das das X-HaBu Profil auf drei Klicks und ist in wenigen Sekunden erledigt, die Buchhaltungsprogramme können die Daten selbstständig holen, aufwendige Import-/Exportarbeiten entfallen komplett.

Die Programme der x-HaBu Serie sind einfach zu bedienende doppelte Buchhaltungsprogramme mit integrierter Faktura und angrenzenden Funktionen speziell für Freiberufler, Selbstständige, KMU’s, Vereine und Privathaushalte die es, wie die Namensgebung bereits andeutet, für Linux, Apple Macintosh und Windows gibt.

Damit steht das Programm auf allen wichtigen Plattformen zur Verfügung. Die my-Warehouse Schnittstelle ist in den jeweiligen Gold Versionen verfügbar, der Preis der Software in der Gold Version beträgt zur Zeit 100 Euro, wer die Software im Sorglos Paket bestellt bekommt dazu den kompletten begleitenden Softwaresupport der MC Richter GbR für 250 Euro zzgl. Mehrwertsteuer.

Die Anbindung an die x-HaBu Programme ist Bestandteil des my-Warehouse XML API und somit in jedem Shoppaket bereits enthalten.

19. Januar 2010

my-Warehouse XML API - eine Einführung in die XML Schnittstelle des my-Warehouse Shopsystems Teil 3/3

Abgelegt unter: Allgemein, Tips'n'Tricks | — Tags:, , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , — admin @ 16:57

verfügbare Calls:

Hier die zur Zeit aktuelle Liste:

Kommando Ergebnis
get_api_data gibt Daten über die Schnittstelle zurück
get_last_order_id gibt die Bestellnummer der aktuellsten Bestellung zurück
get_last_customer_id gibt die Kundennummer des aktuellsten Kunden zurück
get_last_products_id gibt die Produkt ID des aktuellsten Produktes zurück
get_todays_order_ids gibt die Bestellnummern der heutigen Bestellungen zurück
get_todays_order_volume gibt die Bestellwerte des heutigen Tages zurück
get_weekly_order_volume gibt die Bestellwerte der aktuellen Woche zurück
get_monthly_order_volume gibt die Bestellwerte des aktuellen Monats zurück
get_current_languages_list gibt die im System aktivierten Sprachen zurück
get_current_order_status_list gibt die im System hinterlegten Bestellstatus zurück
get_todays_reversal_quote gibt die Stornoquote des heutigen Tages zurück
get_weekly_reversal_quote gibt die Stornoquote der aktuellen Woche zurück
get_monthly_reversal_quote gibt die Stornoquote des aktuellen Monats zurück
get_todays_hits gibt die gezählten und erwarteten Hits des Tages zurück
get_todays_visitors gibt die gezählten und erwarteten Visitors des Tages zurück
get_todays_top_ten_refs gibt die Top 10 Referrer des heutigen Tages zurück
get_products_total_amount gibt die Anzahl aller im System vorhandenen Produkte zurück
get_connected_domains gibt alle auf den Shop konnektierten Domains zurück
get_newsletter_subscribers gibt die Zahl der Nesletterabonnenten zurück
get_customer_ids_with_newsletter gibt die Kundennr. der Kunden mit Newsletterabonnement zurück
get_customer_data_with_newsletter gibt die Kundendaten der Kunden mit Newsletterabonnement zurück
get_customer_ids_from_registered_dealers gibt die Kundennr. der Kunden die als Händler registriert sind zurück
get_current_customer_groups_list gibt die Liste der verfügbaren Kundengruppen zurück
get_customer_ids_from_registered_adults gibt die Kundennr. der Kunden die als Erwachsene registriert sind zurück
get_customer_ids_from_customers_with_pricelist_download gibt die Kundennr. der Kunden die Preislisten herunterladen dürfen zurück
get_open_questions gibt die Anzahl der noch offenen Anfragen zurück.
get_webspace_contingent gibt das Webspacekontingent für den Shop zurück
get_traffic_contingent gibt das Traffickontingent für den Shop zurück
get_visitors_online gibt die aktuellen Besucher online zurück
get_vshops_list gibt die im System befindlichen V-Shops zurück
get_taxrates_list gibt die im System befindlichen Steuersätze zurück
get_currencies_list gibt die die vorhandenen Währungen zurück
get_currently_running_action gibt die gerade laufende Aktion zurück
get_deposits_stats gibt die Anzahl der Kunden mit Guthaben sowie das Gesamtguthaben zurück
get_customers_main_data_by_id gibt die Hauptdaten des Kunden mit der übergebenen Kundennr. zurück
get_customers_full_data_by_id gibt die kompletten Daten des Kunden mit der übergebenen Kundennr. zurück
update_products_stock setzt den Bestand des Produktes oder der Produktvariante mit der übergebenen Artikelnummer
get_shop_name gibt den Namen des Shops zurück
get_products_stock gibt den Bestand eines Produktes oder einer Produktvariante zurück

my-Warehouse XML API - eine Einführung in die XML Schnittstelle des my-Warehouse Shopsystems Teil 2/3

Abgelegt unter: Allgemein, Tips'n'Tricks | — Tags:, , , , , , , , , , , , , — admin @ 14:29

Schnittstellenarchitektur:

Transportmethode:

Die XML Calls werden mit Hilfe des HTTP Protokolls an die Zieldomain (die des Shops) übertragen.
Dazu wird mit dem HTTP Request vermittels der POST Methode auf die Zieladresse ein Parameter mit dem Namen xml übergeben der die jeweiligen Daten enthält.

Zeichensatz:

Grundsätzlich wird der UTF-8 Zeichensatz verwendet.

Authentifikation:

Um den API Benutzer sicher zu authentifizieren muss dieser zunächst im XML API Tool des Shopsystems angelegt werden. Die Zugangsdaten bestehen aus dem Benutzernamen und dem Passwort sowie dem API Key.
Damit der Benutzer authentifiziert werden kann müssen diese Daten im Call mitgesendet werden. Dies sollte aus Sicherheitsgründen niemals im Klartext geschehen daher werden grundsätzlich Hashwerte (MD5) statt Klartextangaben verwendet. Somit müssen die Zugangsdaten auch bei der aufrufenden Plattform niemals im Klartext vorliegen.

Bitte beachten, jeder Zugriff muss die Authentifikationsdaten mitsenden!

Beispiel:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<call>
<authentification>
<user>5d9c68c6c50ed3d02a2fcf54f63993b6</user>
<pass>179ad45c6ce2cb97cf1029e212046e81</pass>
<api_key>e26b518c6bfe6f605acc211201071bad</api_key>
</authentification>
</call>

Kommandoübergabe:

Damit das API weiß was es tun soll muss ein gültiges Kommando übertragen werden. Daher wird jedem Call ein entsprechender Parameter mitgegeben.
Bitte beachten, jeder Zugriff muss ein Kommando mitsenden!

Beispiel:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<call>
<action>get_api_data</action>
</call>
Beispielcall:

Da die beiden obigen Angaben mitgegeben werden müssen ergibt sich ein Mindestschema für einen korrekten Call an das API.

Beispiel:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<call>
<authentification>
<user>5d9c68c6c50ed3d02a2fcf54f63993b6</user>
<pass>179ad45c6ce2cb97cf1029e212046e81</pass>
<api_key>e26b518c6bfe6f605acc211201071bad</api_key>
</authentification>
<action>get_api_data</action>
</call>

Dieser Call würde (korrekte Zugangsdaten vorausgesetzt) die Version des XML API zurückgeben.

Rückgabewerte:

Nachdem die Eingaben überprüft und der Benutzer authentifiziert wurde stellt das API die angeforderten Daten gemäß des übergebenen Kommandos zusammen und gibt diese als XML Dokument zurück.
Sollten die Eingaben nicht korrekt sein wird eine entsprechende Fehlermeldung zurückgegeben.

Beispiel:

Es wurde kein Kommando übergeben:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<document>
<result>
<error>no action given</error>
</result>
</document>

Der Inhalt des Tags error ermöglicht ein genaues Debugging.
Sollte der Call korrekt sein wird die angeforderte Information zurückgegeben.

Beispiel:

Es wurde die API Version angefordert:

<?xml version=’1.0′ encoding=’UTF-8′ standalone=’yes’?>
<document>
<result>
<api_name>my-Warehouse XML API</api_name>
<api_version>v 0.2 beta</api_version>
<api_date>2010-01-10</api_date>
</result>
</document>

Bei Calls die eine Parameterübergabe erfordern wird der Wert unterhalb des Kommandos mitgesendet.

Beispiel:

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?>
<call>
<authentification>
<user>5d9c68c6c50ed3d02a2fcf54f63993b6</user>
<pass>179ad45c6ce2cb97cf1029e212046e81</pass>
<api_key>e26b518c6bfe6f605acc211201071bad</api_key>
</authentification>
<action>get_customers_main_data_by_id</action>
<customers_id>1</customers_id>
</call>

Sandbox:

Sollten Sie ein Produkt auf Basis der XML API erstellen wollen setzen Sie sich bitte mit uns in Verbindung. Gern stellen wir Ihnen einen Sandboxshop zur Verfügung um die Schnittstellenfunktionalität zu testen.

Calls:

Die Anzahl der Calls wird von der STAPIS GmbH permanent erweitert und den Bedürfnissen der Shopbetreiber bzw. denen der angeschlossenen Drittplattformen angepasst. Anregungen sind jederzeit willkommen.

my-Warehouse XML API - eine Einführung in die XML Schnittstelle des my-Warehouse Shopsystems Teil 1/3

Abgelegt unter: Allgemein, Tips'n'Tricks | — Tags:, , , , , , , , , , , , — admin @ 11:12

Allgemeines :

Begriffserklärung:

Das XML API stellt eine Schnittstelle zum Shopsystem zur Verfügung die über das XML Protokoll vermittels des HTTP Transportprotokolls angesprochen werden kann. Die Schnittstelle stellt genau definierte Kommandos, sogenannte Calls, zur Verfügung mit deren Hilfe Daten aus dem System ausgelesen, verändert oder neu angelegt werden können.

Nutzen:

Über die Schnittstelle können angeschlossene Softwareprodukte Daten aus dem Shopsystem beziehen und diese gemäß der eigenen Funktionalität weiterverarbeiten. So können über die Schnittstelle beispielsweise externe Newsletterdienste, ERP oder CRM Systeme und einiges mehr elegant angebunden werden.
Es gibt aber auch den Weg das die aufrufende Software Daten in das Shopsystem schreibt, das wäre beispielsweise bei Warenwirtschaftssystemen durchaus sinnvoll.
Das API ermöglicht es so externen Anbietern Ihre bereits vorhandene Software an das my-Warehouse Shopsystem anzubinden oder neue Software für das Shopsystem zu erstellen und diese als externen Dienst anzubieten.
Da die Dokumentation der Schnittstelle frei zur Verfügung steht können fast beliebige Anbindungen geschaffen werden.

Sicherheit:

Wie bei allen bidirektionalen Schnittstellen ist auch hier das Missbrauchspotential groß, daher muss der Zugang zum API auf authorisierte Personen / Parteien beschränkt bleiben. Um dies abzusichern müssen Benutzer der Schnittstelle vorher als solche angelegt werden und Zugangsdaten sowie einen API Key bekommen die eine eindeutige Authentifikation sicherstellen.
Bei allen Zugriffen müssen diese Authentifizierungsdaten gesendet werden, zur Sicherheit geschieht dies niemals im Klartext. Shops die über ein eigenes SSL Zertifikat verfügen können die Kommunikation über das SSL Zertifikat verschlüsseln und solchermaßen zusätzlich absichern.
Die Benutzung der Schnittstelle erfolgt auf eigene Gefahr!

Zertifizierung:

Sie haben eine Anwendung mit Anbindung an das my-Warehouse XML API erstellt und möchten diese nun von uns zertifizieren lassen?

Kein Problem, bitte wenden Sie sich unter der unten angegeben Adresse an uns, gern testen wir Ihre Anwendung der Test ist selbstverständlich kostenlos.

Zertifizierte Anwendungen bekommen unser Schnittstellensiegel als „zertifizierte Anwendung“, ein eigenes Anwendungsprofil im Administrationsbereich und können in unser Anwendungsverzeichnis aufgenommen werden.

Weiterentwicklung:

Schnittstellen müssen alle möglichen Anwendungsfälle abbilden können, daher werden Sie gewöhnlich kontinuierlich weiterentwickelt. So ist es auch mit diesem API, sollten Sie Anregungen, Lob oder Tadel haben wenden Sie sich bitte direkt an uns.

14. Januar 2010

my-Warehouse XML API mit ersten Calls online…

Abgelegt unter: Anbindungen an Drittplattformen, allgemeines zum Shopsystem, das Shopbackend - der Administrationsbereich | — Tags:, , , , , , , , , , , , , — admin @ 17:18

Ab sofort steht my-Warehouse Shopbetreibern das XML API zur Verfügung.

Diese XML Schnittstelle, über das Administrationsbackend konfigurierbar, erlaubt die Anbindung beliebiger Drittplattformen an das my-Warehouse Shopsystem.

Für das API lassen sich beliebig viele Schnittstellennutzer erstellen, für jeden Nutzer können die Calls individuell freigeschaltet werden.

Zum Start wurde eine ganze Reihe an Calls online gestellt, ebenso eine Dokumentation derselben sowie Beispielcode in PHP.

Weitere Calls sollen folgen, Anregungen werden gern entgegengenommen.
Dienste / Programmierer die an einer Anbindung interessiert sind können gern mit uns Kontakt aufnehmen.

Fertige Anwendungen können von der STAPIS GmbH kostenlos zertifiziert werden, anschliessend kann ein Siegel vergeben, die Anwendung in das Anwendungsverzeichnis aufgenommen und ggfls. ein Freischaltungsprofil erstellt werden.

Das XML API ist in jedem my-Warehouse Shoppaket bereits enthalten.

10. August 2009

XML Schnittstelle für my-Warehouse Shopsysteme geplant…

Abgelegt unter: Allgemein, Ankündigungen | — Tags:, , , , , , , , , , — admin @ 10:31

Das my-Warehouse XML API wird es ermöglichen Drittplattformen auf eine einfache und elegante Art und Weise mit dem Shopsystem zu verbinden.

Dazu wird eine Schnittstelle eingerichtet die eine Kommunikation mit der Drittplattform über das XML Protokoll ermöglicht, sämtliche Calls werden genau dokumentiert, die Dokumentation wird frei verfügbar sein so das Drittplattformen die notwendigen Anbindungen schaffen können.

Die einzelnen Calls ermöglichen es Informationen aus dem Shopsystem zu holen oder in das Shopsystem einzuspielen.

Zur Zeit befindet sich das API noch im Aufbau, erste Calls sind gegen Ende des Monats zu erwarten. Shopbetreiber können gern Wünsche äussern, einfach als Kommentar zu diesem Artikel posten.

Da nicht alle Shopbetreiber das API nutzen werden wird dieses als Zusatzpaket buchbar sein.

Kontakt | Impressum | © by STAPIS GmbH

Hannes Peterseim fragt an ob Sie eine Beratung wünschen:

  
Chat beenden