Symphony - SOAP-Schnittstelle
Allgemein
Dieses Modul ermöglicht die Übertragung der Bestelldaten von der PRINT LOUNGE an Symphony. Dabei wird ein einfacher Freigabe-Workflow unterstützt. Zudem werden bei Lagerartikel (Handelsware) der Lagerbestand synchronisiert. Die Übertragung der Bestellungen erfolgt Asyncron im Hintergrund und kann bis zu 5 Minuten dauern.
Konfiguration
Um dieses Modul zu konfigurieren, muss dieses zunächst aktiviert werden und in der PRINT LOUNGE mindestens ein Shop angelegt sein.
Um einen Symphonyshop mit einem PRINT LOUNGE-Shop zu verknüpfen, gehen Sie unter Add-ons → Symhonyshop und wählen den gewünschten PRINT LOUNGE-Shop aus. Sie haben die Möglichkeit, einen neuen Shop zu erstellen, oder die Symphonyshop-ID zu hinterlegen. Bitte beachten Sie, nachdem Sie die Shops einmal miteinander verbunden haben, können diese nur noch durch den Lead-Print-Support gelöst werden.
Sie können jederzeit die Schnittstelle aktiv/inaktiv setzen. Sobald diese inaktiv ist, werden keine Bestellungen mehr übertragen.
Um eine Testbestellung durchzuführen, geben Sie dies hier an. Die Bestellungen werden in Symphony als Testbestellung markiert.
Es besteht zudem die Möglichkeit die Preise (siehe Kosten) zu übertragen. Dies kann unter Preise übertragen werden.
Preise übertragen
Es gibt drei Möglichkeiten
- Nein
- Ja, Artikelpreis
- Ja, Gesamtpreis der Warenkorbposition
Erforderliche Einstellung im Shop
Damit eine Übermittlung der Bestellung an Symphony erfolgreich ist, ist es unbedingt erforderlich, alle Felder der Lieferadresse als Pflichtfelder zu definieren, sowie die Lieferländer zu aktivieren. Optional ist es möglich, die Rechnungsadresse im Warenkorb anzubieten. Ist dies der Fall, müssen auch hier alle Felder als Pflichtfelder definiert werden.
Anlage von Artikel
Um einen PRINT LOUNGE-Artikel mit Symphony zu verknüpfen, ist es erforderlich die Symphony Product Id im Feld "SAP-Nummer/openTRANS Manufacturer-AID" einzugeben. Das Feld finden Sie unter, im Artikel, im Reiter "Erweiterte Einstellungen".
Wird für den Artikel ein Lagerbestand benötigt, so kann dieses ebenfalls im Artikel konfiguriert werden. Hierzu muss zunächst das Modul Lagerverwaltung aktiviert sein. Anschließend können Sie im Artikel unter dem Reiter "Lagerverwaltung" die Lagerverwaltung aktivieren. Nach der Aktivierung wird innerhalb von ca. 5 Minuten der Lagerbestand abgerufen und mit Symphony synchronisiert. Im Fehlerfall erhalten Sie eine E-Mail.
Bitte beachten Sie
Wird der Lagerbestand in einem Artikel aktiviert, darf nur ein Shop hinterlegt sein, zudem dieser Artikel gehört. Der Shop muss zudem mit Symphony verknüpft sein. (Ist mehr als ein Shop hinterlegt, wird versucht vom ersten Shop der gefunden wird, den Lagerbestand abzurufen)
Bitte beachten Sie zudem, dass nur der Bestand nach jeder Bestellung, 1x nachts synchronisiert wird. Die PRINT LOUNGE-Funktionen zur Benachrichtigung etc. werden dabei nicht berücksichtigt, jedoch bei Bestellungen über die PRINT LOUNGE.
Bestellung
Den Status der Übertragung an Symphony kann jederzeit in der Bestellübersicht eingesehen werden.
Status | |
---|---|
disabled | Die Bestellung wird nicht an Symphony übertragen. |
new | Eine neue Bestellung für Symphony. |
pending | Die Bestellung ist bereit zur Übertragung an Symphony. |
submited | Die Bestellung wurde an Symphony übertragen. |
error | Bei der Übertragung an Symphony ist ein Fehler aufgetreten. (Details in der Meldung) |
Verwendete Felder für die Rechnung
die übermittelten Rechnungsadressfelder resultieren aus folgenden Feldern:
name
Es wird aus der Bestellung das Company1 aus der Rechnungsanschrift genommen.
Falls dies nicht gefüllt ist, wird der Vor- und Nachname aus der Rechnungsanschrift genommen.
Falls diese nicht gefüllt sind, wird der Ansprechpartner aus der Rechnungsanschrift verwendet.
name2
Damit die gefüllt ist, muss das Feld Company1 aus der Rechnungsanschrift gefüllt sein. Ansonsten ist es leer.
Dann wird es mit dem Vor- und Nachname aus der Rechnungsanschrift genommen.
Falls diese nicht gefüllt sind, wird der Ansprechpartner aus der Rechnungsanschrift verwendet.
name3
Wird immer leer übermittelt.
restlichen (street, zip, city, country)
Werden 1:1 aus der Rechnungsanschrift der Bestellung übernommen.
Download URL
Als Download URL wird Ihre Shop URL mit /symphony/download/ angegeben.
Anhand dieser URL und den Symphony-Parameter kann die Datei herunter geladen werden. Order Id und Line Item sind aus der Bestellposition übergebene IDs. Als Password wird der Ordercode aus Alt Customer Order Id benötigt.
Unterstützte Artikeltypen | Anmerkung |
---|---|
Print-on-Demand |
|
Handelsware mit Upload |
|
Handelsware Plus |
|
Übermittlung PO-Nummer
In der Administration wird unter "Shops → bearbeiten → Freifelder" ein Freifeld "PO-Nummer" angelegt.
Wahlweise kann das Feld als Eingabefeld, Liste oder verdecktes Feld konfiguriert werden.
Sofern eine "PO-Nummer" im Warenkorb eingegeben wurde, wird diese als Parameter "CustomerPO" pro Bestellposition an die Symphony-Schnittstelle übertragen.
Übermittlung Reference
Ab Version 5.14.0
In der Administration wird unter "Shops → bearbeiten → Freifelder" ein Freifeld angelegt.
Wahlweise kann das Feld als Eingabefeld, Liste oder verdecktes Feld konfiguriert werden.
Sofern das erste Freifeld (unter Shops → bearbeiten → Freifelder) im Warenkorb eingegeben wurde, wird diese als Parameter "Reference" pro Bestellposition an die Symphony-Schnittstelle übertragen.
Übermittlung Kostenstelle
Ab Version 5.14.0
In der Administration wird unter "Shops → bearbeiten → Bestelloptionen" die Option Kostenstelle aktiviert.
Die Kostenstelle wird als Parameter "CostCenterID" pro Bestellposition, an die Symphony-Schnittstelle übertragen.
Kosten
Bei der Übermittlung der Bestellung werden zusätzlich die Kosten pro Position übermittelt.
Die Gesamtkosten der Bestellung werden aus den Einzelpositionen berechnet.
WICHTIG!
Da die Währung mit übergeben wird, ist es wichtig für den Mandanten dies korrekt einzutragen.
Es muss unter Verwaltung → Einstellungen → Allgemein, das Feld Währungscode anhand dem ISO-Standard gesetzt werden. Zum Beispiel für Euro lautet dies EUR.
Ausführliche Beschriftung - dynamisch erweitert
Die ausführliche Beschriftung wird je nach bestelltem Artikel dynamisch erweitert.
Personalisierung
Bei der Personalisierung werden die Werte übernommen, die folgende Feldbezeichnung haben, wobei die Groß- und Kleinschreibung egal ist:
- first name
- firstname
- vorname
- last name
- lastname
- name
- mailadresse
Artikel ohne Personalisierung
Bei allen anderen Artikeln wird die Beschreibung des Artikels genutzt.
Dokumentation für den Kunden
Der Kunde kann die PDF zugestellt bekommen.
Die Worddatei ist zum Erweitern.
Diese müssen bei allen Änderungen wieder ausgetauscht werden.