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 Grundeinstellungen hinterlegen. Um einen Print-on-Demand-Artikel direkt nach der Bestellung / Freigabe an DruckDiscount24.de zu übertragen, benötigen Sie ein 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.
Achtung
Wenn Sie per Rechnung zahlen möchten, so klären Sie vorab mit DruckDiscount24.de ob Sie dafür freigeschaltet sind.
Achtung
Bei Verwendung von Freigaben, muss der Abschnitt Externe Zahlungsanbieter und Freigabe beachtet werden.
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.
Vor- und Nachname
Nicht bei allen Konfigurationen stehen Ihnen Vor- und Nachname zur Verfügung. Da die DruckDiscount24.de Schnittstelle bei der Rechnungsadresse, die zwingend benötigt wird, sofern Vor- und Nachname nicht angegeben, immer geprüft wird, ob ein Ansprechpartner hinterlegt wurde. Ist dies der Fall wird der Asprechpartner im letzten Leerzeichen getrennt und Vor- und Nachname gebildet.
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.
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.
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.
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
Achtung
Bei der Verwendung eines externen Zahlungsanbieters, muss der Abschnitt Externe Zahlungsanbieter und Freigabe beachtet werden.
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).
| Status | |
|---|---|
| pending | Die Bestellung ist bereit zur Übertragung an DruckDiscount24.de. |
| submited | Die Bestellung wurde an DruckDiscount24.de übertragen. |
| transferred | Die Druckdaten wurden zur Bestellung an DruckDiscount24.de übertragen. |
| error | Bei der Übertragung an DruckDiscount24.de ist ein Fehler aufgetreten. (Details im Log) |
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.