Modul: SAP-FTP

Um eine schnelle und einfache Anbindung und Übertragung von Bestelldaten an externe Systeme wie bspw. SAP zu ermöglichen, kann das Modul "SAP-FTP" aktiviert werden. Hier kann jeweils pro Shop eine Anbindung und eine entsprechende XML-Vorlage hinterlegt werden, welche bei jeder Bestellung (abhängig vom Status der Bestellung) an einen externen FTP-Server übertragen wird.

Konfiguration des Moduls

Pro Shop kann eine individuelle Konfiguration innerhalb der Modul-Einstellungen angelegt werden, wobei folgende Optionen zur Verfügung stehen:

Übertragungsstatus	Bei diesem Status wird der entsprechende Cronjob (Hintergrundaufgabe) angelegt, der dann die Übertragung ausführt.
E-Mail-Empfänger bei Fehlermeldung	Dieser Empfänger wird benachrichtigt, sollte es bei einer Übertragung zu einem Fehler kommen.
XML-Vorlage	Freie Eingabe einer Vorlage (bspw. XML), über die die relevanten Bestelldaten übertragen werden können.
FTP-Verbindung	Server, Port, Root, Benutzername und Passwort für den entsprechenden Zielserver. Die Datei wird immer als "orderdata_IdDerBestellung.xml" abgelegt.

Verfügbare Variablen innerhalb der XML-Vorlage

Die XML-Vorlage kann mithilfe der Smarty-Syntax möglichst dynamisch und flexibel bearbeitet werden. Hierbei stehen folgende Variablen zur Verfügung:

Bezeichnung Beschreibung

$order

Übergeordnete Variable: Das Order-Objekt bietet zahlreiche Informationen zu der Bestellung als solche. Es können hier bei folgende Detailinformationen abgerufen werden (bspw. {$order->id}):

`id`	ID der Bestellung
`payment`	Name / Bezeichnung der verwendeten Zahlungsart
`createDate`	Erstellungsdatum der Bestellung
`status`	Aktueller Bestellstatus (zum Zeitpunkt der Erstellung der XML-Datei)
`vat`	USt.-ID
`shippingPriceCart`	Versandkosten
`isNotPayed`	Information über den Bezahlstatus der Bestellung
`customerDiscount`	Eingeräumter Rabatt für den Kunden
`customerDiscountPercent`	Eingeräumter Rabatt für den Kunden in Prozent
`surchargePaymentOnDelivery`	Aufschlag für Zahlart "Nachname"
`surchargePaymentOnDebit`	Aufschlag für Zahlart "Abbuchung"
`surchargePaymentOnCash`	Aufschlag für Zahlart "Barzahlung"
`surchargePaymentOnPrepayment`	Aufschlag für Zahlart "Vorkasse"
`surchargePaymentOnCreditCard`	Aufschlag für Zahlart "Kreditkarte"
`surchargePaymentOnBill`	Aufschlag für Zahlart "Auf Rechnung"
`surchargePayment`	Aufschlag für Zahlart
`surchargeSaferpay`	Aufschlag für Zahlart "SaferPay"
`surchargePaypal`	Aufschlag für Zahlart "Paypal"
`surchargeSofortueberweisung`	Aufschlag für Zahlart "Sofortüberweistung"
`invoiceNumber`	Rechnungsnummer
`orderNumber`	Bestellnummer
`deliveryTicketNumber`	Lieferscheinnummer

$orderCartItems

Diese Variable enthält alle Bestellpositionen der Bestellung und kann mithilfe der Smarty-Syntax durchlaufen werden.

Codebeispiel

{foreach from=$orderCartItems key=orderCartItemKey item=orderCartItem}
{$orderCartItem->cartId}
{/foreach}

Es stehen hier folgende Detailinformationen zur Verfügung:

`cartId`	ID der Bestellposition
`jobNumber`	Jobnummer
`quantity`	Menge
`articleId`	ID des bestellten Artikels
`keyword`	Stichwort
`shippingId`	ID der Versandart
`status`	Status der Bestellposition
`paperId`	ID der Papierart
`varietyId`	ID der Sorte
`netPrice`	Nettopreis
`grossPrice`	Bruttopreis
`deliveryDate`	Liefertermin

Logging und fehlgeschlagene Übertragungen

Innerhalb jeder Bestellung (Auftragsdetailseite) können die Logeinträge eingesehen werden. Hier ist es auch möglich, die Übertragung nochmals manuell anzustoßen, sofern der Cronjob angelegt und bereits ausgeführt wurde. Es ist nicht möglich, eine manuelle Übertragung vor einer automatischen Übertragung auszulösen.