Modul: SAP-FTP

Um eine schnelle und einfache Anbindung und Übertragung von Bestelldaten an externe Systeme wie beispielsweise 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, die 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-VorlageFreie Eingabe einer Vorlage (beispielsweise 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 mit Hilfe der Smarty-Syntax möglichst dynamisch und flexibel bearbeitet werden. Hierbei stehen folgende Variablen zur Verfügung:

BezeichnungBeschreibung
$order

Übergeordnete Variable: Das Order-Objekt bietet zahlreiche Informationen zu der Bestellung als solche. Es können hier 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überweisung"

invoiceNumber

Rechnungsnummer

orderNumber

Bestellnummer

deliveryTicketNumber

Lieferscheinnummer
invoiceAddress
deliveryAddress
senderAddress


Übergeordnete Variable mit Informationen zur Rechnungs-, Liefer- und Absenderadresse

companyUnternehmensname
firstNameVorname
lastNameNachname
streetStraße
zipPLZ
cityStadt
landLand
landList
phoneTelefonnummer
faxFaxnummer
mobileMobilnummer
homepageWebseite
mailE-Mail-Adresse
ustidUmsatzsteuer-ID
departmentAbteilung
genderGeschlecht
countryCodeLändercode
realCountryCode
$orderCartItems

Diese Variable enthält alle Bestellpositionen der Bestellung und kann mit Hilfe 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
articleIdID des bestellten Artikels
keywordStichwort
shippingIdID der Versandart
statusStatus der Bestellposition
paperIdID der Papierart
varietyIdID der Sorte
netPriceNettopreis
grossPriceBruttopreis
deliveryDateLiefertermin

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.