Um die Schnittstelle nutzen zu können, benötigen Sie eine Freischaltung der API bei DruckDiscount24.de sowie die Aktivierung des Moduls innerhalb Ihrer PRINT LOUNGE.

Haben Sie Ihren Anbieter Token von DruckDiscount24.de erhalten, können Sie diesen in den DruckDiscount24.de#Grundeinstellungen hinterlegen. Um einen Print-on-Demand-Artikel direkt nach der DruckDiscount24.de#Bestellung / Freigabe an DruckDiscount24.de zu übertragen, benötigen Sie ein DruckDiscount24.de#Mapping zwischen den PRINT LOUNGE und DruckDiscount24.de Artikeln. Dies erfolgt über die "Globale Preisstaffeln" und erlaubt Ihnen für jede Auflage eine unterschiedliche Bestellung bei DruckDiscount24.de auszulösen. 

Sie können jeden Artikeltyp in der PRINT LOUNGE bei DruckDiscount24.de bestellen, allerdings erfolgt nur eine Übertragung der Druckdaten bei dem Artikeltyp Print-on-Demand, Handelsware Plus sowie Handelsware mit Upload. 

Grundeinstellungen

Die Konfiguration der DruckDiscount24.de-Schnittstelle erfolgt unter Module → DruckDiscount24.de

Wählen Sie zunächst aus, für welchen Shop Sie die Schnittstelle konfigurieren möchten. 

Geben Sie hier den von DruckDiscount24.de erhaltenen Anbieter Token ein sowie die gewünschte Zahlart für Ihre Bestellungen. Optional können Sie eine E-Mail-Adresse hinterlegen, an die Sie eine E-Mail im Fehlerfall bei der Bestellübertragung zu DruckDiscount24.de erhalten. 

Sie haben zudem die Möglichkeit den PRINT LOUNGE eigenen im Shop hinterlegten Lieferschein an DruckDiscount24.de zu übertragen, der eine Bestellung beigelegt wird. Der Lieferschein wird nur übertragen, wenn in den Shopeinstellungen eine Vorlage hinterlegt ist. 

Standardmäßig werden alle Bestellpositionen einzeln an DruckDiscount24.de übertragen. Sie können jedoch auch alle Positionen als eine Bestellung zusammenfassen. Bitte beachten Sie jedoch, dass dies zurzeit nicht mit Freigabe Workflows möglich ist. In diesem Fall wird weiterhin jede Position nach Freigabe an DruckDiscount24.de übermittelt.  

Durch "Verbindung testen" können Sie Ihre Einstellungen überprüfen. 

Übertragung der Bestellung

Es gibt die folgenden Optionenen:

• Einzelne Posten
• Bestellung zusammenfassen

Bestellung zusammenfassen

Wir diese option eingestellt, wird die komplette Bestellung übermittelt, wenn alle einzelpositionen freigegeben sind.

Kombiniert mit dem OCI Modul

Wird OCI genutzt, ist es wichtig, dass ein externer Bestellcode in "buyerOrderNumber" gesetzt wird.

Zudem wird der DD24-Header aus der ersten Bestellung übernommen und verwendet.

Gibt es mehrere Bestellcode, werden diese in dem Header unter dem Wert Fremdauftragsnummer mit Komma getrennt aufgelistet.

Jede einzelne Position hat die Referenz auf den Bestellcode in der KundenReferenz.

Zahlart

Die Zahlart kann in den Einstellungen hinterlegt werden. Es ist allerdings auch möglich, die Zahlart dem Benutzer im Warenkorb wählen zu lassen (Aus Bestelldaten). Zulässig sind die Zahlarten "Lastschrift", "PayPal", "Nachname", "Rechnung" und "Vorkasse". Dabei ist die genaue Bezeichnung wichtig. Wird eine ungültige Bezeichnung übergeben, so wird standardmäßig "Vorkasse" gewählt. Im Log wird dazu eine Warnung ausgegeben. 

IBAN und BIC

Haben Sie die Zahlart auf "Lastschrift" eingestellt bzw. wurde diese im Warenkorb gewählt und die Rechnungsadresse aus "Liefer- oder Rechnungsadresse" der Bestellung gefüllt, so können Sie ebenfalls die Zahlungsdaten aus den Bestelldaten füllen lassen. Legen Sie dazu eine Zahlungsart z. B. Lastschrift an und hinterlegen dort die Freifelder "IBAN" und "BIC". Dabei ist die auf genaue Bezeichnung der Felder zu achten.

Gutschein

Durch die Eingabe eines Gutscheincodes kann die Budgetfunktion der PRINT LOUNGE wie ein Gutschein bei DruckDiscount24.de genutzt werden. Das aktuelle PRINT LOUNGE-Budget wird dabei an DruckDiscount24.de übergeben bis dieses aufgebraucht ist. Den Gutscheincode erhalten Sie von DruckDiscount24.de. Den Betrag des Gutscheines tragen Sie in der Budgetgruppe ihres Shops ein. Bitte beachten Sie, dass für jede Budgetgruppe ein eigenes Budget genutzt wird. Es empfiehlt sich daher, alle Nutzer die dem Budget unterliegen in eine Budgetgruppe zu legen. 

Absender- und Rechnungsadresse

Standardmäßig wird die Absenderadresse aus den Shopeinstellungen übermittelt (Firma, Straße, Plz und Ort). Alternativ haben Sie die Möglichkeit eine eigene Absenderadresse einzugeben. Zurzeit werden von DruckDiscount24.de nur deutsche Adressen unterstützt.

Bei der Rechnungsadresse haben Sie wie bei der Absenderadresse die Möglichkeit diese aus den Shopeinstellungen füllen zu lassen oder eigenständig einzugeben. Die eigene Eingabe ermöglicht Ihnen weitere Angaben wie UstId. Alternativ können Sie Rechnungsdaten aus der Liefer- oder Rechnungsadresse der Bestellung füllen lassen. Bitte achten Sie dabei, dass Sie Vor- und Nachname statt Ansprechpartner aktiviert haben sowie alle die Adressfelder Straße, Stadt und Plz.  

Benachrichtigung

Standardmäßig wird an die bei DruckDiscount24 hinterlegte E-Mail-Adresse der Auftragsstatus übermittelt. Sie können alternativ eine abweichende E-Mail-Adresse angeben. Wie bei der Absender- und Rechnungsadresse kann diese aus den Shopeinstellungen und Lieferadresse übernommen werden oder eine eigene angegeben werden. 

Wenn Sie möchten, dass die Rechnung an eine abweichende E-Mail-Adresse - als Benachrichtigungs-E-Mail - geschickt wird, können Sie dies ebenfalls hier einstellen. Es besteht zusätzlich die Möglichkeit die Rechnung an die E-Mail aus der "Shop Rechnungsadresse" schicken zu lassen. Diese kann zurzeit nur über Schnittstellen gesetzt und nicht im Warenkorb eingegeben werden. 

Auslandsversand

Standardmäßig wird der Versand nur an deutsche Adressen unterstützt. Möchten Sie in Ihrem Shop auch den Versand an Adressen im Ausland unterstützen, so müssen Sie in Ihrem Shop Lieferländer (Shop → Warenkorb) definieren. Zurzeit werden ca. 33 Länder von DruckDiscount24.de unterstützt. Unter anderem alle an Deutschland angrenzenden Länder. Welche Länder unterstützt werden, bitten wir Sie direkt bei DruckDiscount24.de anzufragen.

Wird ein Lieferland nicht unterstützt, so erhalten Sie eine Fehlermeldung bei der Bestellübertragung. 

Versand in die USA/Kanada

Um in die USA/Kanada zu versenden, sind noch zwei weitere Pflichtfelder erforderlich.

Hierfür muss eine entsprechende Versandart existieren, welche die folgenden Warenkorbzusatzfelder als Pflichtfelder mit der entsprechenden Validierung beinhaltet.

Bezeichnung	Bezeichnung(en)	Regex	Pflichtfeld
Lieferadresse Telefon	Delivery address telephone	^\d{10,}$
Lieferadresse Ländercode	Delivery StateProvince Code	^\w{2}$
Rechnungsadresse Telefon	Billing address telephone	^\d{10,}$
Rechnungsadresse Ländercode	Billing StateProvince Code	^\w{2}$

Versandarten

Standardmäßig wird bei der Bestellung Standard UPS (Bei Versand in die USA und Kanada - UPS Express) als Versandart übergeben. Optional ist es möglich weitere Versandarten von DruckDiscount.de im Warenkorb des Shops anzubieten. Dazu wählen Sie die gewünschten Versandarten unter Add-ons → DruckDiscount24.de → Versandarten aus. Die ausgewählten Versandarten werden in der Print Lounge angelegt und dem Shop zugewiesen. Die angelegten Versandarten können anschließend nach belieben bearbeitet werden. Bitte beachten Sie, dass im Shop "Versandarten anzeigen" aktivert ist. Wird im Warenkorb eine Versandart ausgewählt, so werden die Versandkosten von DruckDiscount24.de ermittelt und als Versandkosten hinzuberechnet. 

Haben Sie OCI aktviert, so werden bei Vendor "dd24" und bei Vendor Material Number die Versandkosten-Id von DruckDiscount24.de hinterlegt.  

Warenkorbzusatzfelder-Mapping

Es gibt drei feste Felder dynamisch mit den Warenkorbzusatzfeldern verknüpft werden.

Die Warenkorbzusatzfelder können unter Shops > bearbeiten > Freifelder  hinzugefügt werden:

Anschließend ist es möglich über einen DropDown diese in den Moduleinstellungen Add-ons > DruckDiscount24.de  zu verknüpfen.

Es ist möglich zu einem Feld, mehrere Zusatzfelder zuzuordnen. Dazu kann mittels dem Plus ein weiteres Feld ergänzt werden.

Um wieder eins zu löschen, muss die Auswahl nur entfernt werden, indem dies auf "Bitte wählen" gestellt und gespeichert wird. Nach dem Neuladen ist dieses zusätzliche Feld nicht mehr vorhanden.

Wird kein Feld ausgewählt, werden diese leer übermittelt.
Werden mehrere Felder ausgewählt, werden diese aneinander gereit in dem Feld übermittelt.

Preis-Mapping

In der globalen Preisstaffel wird durch das Modul DruckDiscount24.de eine weitere Spalte eingeblendet, in der Sie ein Mapping zu einem DruckDiscounrt24.de Artikel Konfigurationen durchführen können. 

Wählen Sie zuerst den gewünschten Artikel aus und legen Sie anschließend die gewünschte Konfiguration zur Bestellung fest. Dabei müssen alle Felder ausgefüllt werden. Zur Unterstützung werden, wenn Sie die nächste Stückzahl bearbeiten, alle Einstellungen aus Stückzahl zuvor kopiert. 

Preise

Nach dem vollständigen Mapping erhalten Sie einen Preis sowie Versandkosten für den Versand innerhalb Deutschland angezeigt. Haben Sie mehrere Shops mit unterschiedlichen Token können Sie sich die Preise für jeden Shop anzeigen lassen. Der Preis wird immer für den zuletzt ausgewählten Shop angezeigt. 

Zusatzoptionen

Die Zusatzoptionen können erst gewählt werden, wenn für dieses Produkt ein Preis ermittelt werden kann.

Zu beachten ist, dass die Produktionszeit standardmäßig auf Express-Druck gesetzt ist.

Spezialprodukte

Eine Besonderheit stellen Spezialprodukte dar. Wenn Sie ein Spezialprodukt von DruckDiscount24.de erhalten haben, können Sie den Artikel Spezialprodukt auswählen und die Artikelnummer ohne Auflage übernehmen. Diese besteht aus 9 Ziffern die durch einen Unterstrich getrennt sind. Beispiel (1_2_3_4_5_6_7_8_9). Die erste Ziffer max. vierstellig, alle anderen Ziffern max. dreistellig. Die letzten beiden Zahlen können zudem negativ sein. Die Auflage wird immer aus der Preisstaffel übernommen. 

Zusatzoptionen beim Spezialprodukt

Auch beim Spezialprodukt muss erst ein Preis ermittelt werden können, bevor dies gesetzt werden kann.
Hierbei ändert sich nichts zu der Informationen aus der normalen Preis-Mapping.

Freigabe

Bei den Freigaben wird die Übermittlung zum Zeitpunkt der Bestellung nicht ausgeführt.

Nach der Freigabe wird die Bestellung asynchrone übermittelt und der Übermittlungsstatus auf "Pending" gesetzt.

Unterstützte Freigaben sind:

• Artikelfreigabe
• Kostenfreigabe

Bestellung

Wurde ein Artikel mit einer Auflage die für DruckDiscount24.de konfiguriert wurde bestellt, so können Sie den Status dieser Bestellung in der Bestelldetailansicht (Version 2) verfolgen. Die Übertragung an DruckDiscount24.de kann bis zu 15 Minuten nach der Bestellung/Freigabe innerhalb der Print Lounge benötigen. Ist bei der Übertragung ein Fehler aufgetreten, haben Sie die Möglichkeit die Bestellung erneut zu übertragen. Dabei wird der Übertragungsprozess im Hintergrund erneut gestartet (Belegnumer, Preis und Status zurückgesetzt). 

Bei DruckDiscount24.de finden Sie Ihre Bestellung unter der Referenz mit Print Lounge Bestellcode : Positionsnummer. Wurde ein Jobname (Auftrag) vergeben, so wird dieser anstelle der Positionsnummer übergeben Bestellcode _ Jobname. 

Auftragsstatus Rückübermittlung 

Es ist möglich, dass der Status einer Bestellung/Bestellposition von DruckDiscount24 direkt in die PRINT LOUNGE zurückübermittelt wird. Bitte sprechen Sie dazu unseren Support an. 

Bemerkungen

Haben Sie Bemerkungen in Ihren Shop aktiviert, so werden diese ebenfalls für die jeweilige Position als Kommentar übertragen. 

Ausschluss

Es gibt Einstellungsmöglichkeiten die zu Problemen bei der Abwicklung führen.

Externe Zahlungsanbieter und Freigabe

Bei Verwendung eines externen Zahlungsanbieters wie "PayPal", mit der Verwendung einer Freigabe, gibt es Probleme bei der Übermittlung des Auftrages. Dies kann schon vor der Freigabe oder gar nicht erfolgen.

Deshalb ist es hier nötig, den Freigabe-Workflow bei Zahlungen zu aktivieren. Siehe Zahlungsarten.