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

  1. Nein 
  2. Ja, Artikelpreis
  3. 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
disabledDie Bestellung wird nicht an Symphony übertragen.
newEine neue Bestellung für Symphony.
pendingDie Bestellung ist bereit zur Übertragung an Symphony.
submitedDie Bestellung wurde an Symphony übertragen.
errorBei 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 ArtikeltypenAnmerkung
Print-on-Demand
  1. Druckdatei (Keine Serienpersonalisierung)
Handelsware mit Upload
  1. Hochgeladene Datei
Handelsware Plus
  1. Hochgeladene Datei (Dateien mit einem 'preview' im Namen werden ignoriert).


Übermittlung PO-Nummer

In der Administration wird unter "Shops → bearbeiten → Freifelder" ein Freifeld "PO-Nummer" angelegt.

Wahlweise kann das Feld als EingabefeldListe 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 EingabefeldListe 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

  • email
  • mailadresse
  • e-mail

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.