Bestellungen in Warenwirtschaftssystem übernehmen

Ab xaranshop® V5.0.16.0 können Bestellungen per SOAP in Warenwirtschaftssysteme übermittelt werden.
WSDL- Datei: http://xaranshop5.xaran.de/konnektor.php?wsdl

I. Bestellungen einbuchen

Diese Funktion liefert bisher nicht gebuchte Bestellungen als XML- Datei.
Parameter:
• Kennwort       In der Software xaranshop® V5.0 in Menü » Service » Konnektor... festgelegtes Kennwort.

PHP-Code
Anfrage:

<?php
  $kennwort = 'Yn{%$iA4XG_geheimes_kennwort_9zpsSqW[hvT';
  $soapclient = new SoapClient('http://xaranshop5.xaran.de/konnektor.php?wsdl');
  echo $soapclient->einbuchen($kennwort);
?>

erfolgreiche Antwort mit einer oder mehreren Bestellungen:

<?xml version="1.0" charset="UTF-8" ?>
<antwort>
    <beschreibung>Einbuchung...</beschreibung>
    <anzahl>7</anzahl>
    <bestellung>
        <id>83424</id>
        <betreff>1</betreff>
        <rechnungsadresse...
        <lieferadresse...
        <warenkorb...
            <id...
            <preis...
            <varianten>
                <variante>
                    <farbe...
                <variante>
            </varianten>
        <endbetrag...
    </bestellung>
    <bestellung>
        <id>83435</id>
        <betreff>1</betreff>
        ...
        ...
        <endbetrag...
    </bestellung>
</antwort>

erfolgreiche Antwort, aber keine neuen Bestellungen verfügbar:

<?xml version="1.0" charset="UTF-8" ?>
<antwort>
    <beschreibung>Einbuchung...</beschreibung>
    <anzahl>0</anzahl>
</antwort>

Demo: http://xaranshop5.xaran.de/konnektor.php?einbuchen Empfehlenswert ist, vorab eine neue Testbestellung durchführen, damit eine bisher nicht gebuchte Bestellung existiert.

II. Bestellungen ausbuchen

Diese Funktion ändert den Status der Bestellungen, die erfolgreich eingebucht werden konnten, damit diese Bestellungen zukünftig nicht wiederholt eingebucht werden.
Ein Warenwirtschaftssystem muss also zunächst die Bestellungen einbuchen und dabei die ids zwischenspeichern. Nachdem die Bestellungen erfolgreich in die Datenbank des Warenwirtschaftssystem übernommen wurden, müssen die Bestellungen ausgebucht werden.
Parameter:
• ids       Eine mit Kommata getrennte Auflistung der erfolgreich eingebuchten Bestellungen (<id>...</id>).
• Kennwort       In der Software xaranshop® V5.0 in Menü » Service » Konnektor... festgelegtes Kennwort.

PHP-Code
Anfrage:

<?php
  $kennwort = 'Yn{%$iA4XG_geheimes_kennwort_9zpsSqW[hvT';
  $ids = '1236,9563,2569,4582,6523,4581,2632';
  $soapclient = new SoapClient('http://xaranshop5.xaran.de/konnektor.php?wsdl');
  echo $soapclient->ausbuchen($ids, $kennwort);
?>

erfolgreiche Antwort mit einer oder mehreren Bestellungen:

<?xml version="1.0" charset="UTF-8" ?>
<antwort>
    <beschreibung>Einbuchung...</beschreibung>
    <ids>1236,9563,2569,4582,6523,4581,2632</ids>
    <anzahl>7</anzahl>
    <bestellung>
        <id>1236</id>
        <konnektor>1</konnrktor>
        <betreff...
    </bestellung>
    <bestellung>
        <id>9563</id>
        <konnektor>1</konnrktor>
        <betreff...
    </bestellung>
    ...
    ...
    ...
</antwort>

III. Bestellungen löschen

Ein Warenwirtschaftssystem kann auch (eingebuchte und/oder ausgebuchte) Bestellungen endgültig löschen. Gelöschte Bestellungen können nicht wiederhergestellt werden.
• ids       Eine mit Kommata getrennte Auflistung der erfolgreich eingebuchten Bestellungen (<id>...</id>).
• Kennwort       In der Software xaranshop® V5.0 in Menü » Service » Konnektor... festgelegtes Kennwort.

PHP-Code
Anfrage:

<?php
  $kennwort = 'Yn{%$iA4XG_geheimes_kennwort_9zpsSqW[hvT';
  $ids = '1236,9563,2569,4582,6523,4581,2632';
  $soapclient = new SoapClient('http://xaranshop5.xaran.de/konnektor.php?wsdl');
  echo $soapclient->loeschen($ids, $kennwort);
?>

erfolgreiche Antwort:

<?xml version="1.0" charset="UTF-8" ?>
<antwort>
    <beschreibung>Löschen...</beschreibung>
    <ids>1236,9563,2569,4582,6523,4581,2632</ids>
    <anzahl>7</anzahl>
</antwort>

IV. Fehlerbehandlung

Alle Methoden geben im Fehlerfall eine Fehlermeldung als XML zurück, Antwort mit Fehlermeldung:

<?xml version="1.0" charset="UTF-8" ?>
<soapfault>
    <faultcode>...</faultcode>
    <faultstring>...</faultstring>
    <faultactor>...</faultactor>
    <detail>...</detail>
</soapfault>