Modul: Freiaufträge (Release: 2025)

Anmerkung: Dieses Modul wird befindet sich in Entwicklung und wird voraussichtlich 2025 veröffentlicht.


Nur in Verbindung mit dem Modul Printshop API

Mit dem Modul Freiaufträge, hast du die Möglichkeit, automatisiert Auftrage in deinem Shop aus anderen Quellen zu erstellen.

Zusätzlich lassen sich auch personalisierte Produkte übermitteln, wodurch automatisch der Position das personalisierte Druckdokument zur Verfügung gestellt wird. Dafür benötigst du lediglich einen Closedshop / eine PRINT LOUNGE, mit aktivierter API-Schnittstelle, personalisierbare Artikel und einen freigeschalteten Benutzer.

Um die personalisierte Druckdatei korrekt abrufen zu können, musst du das Modul unter Module / Freiaufträge konfigurieren:

Feldbeschreibung der Einstellungen

Bezeichnung

Wert

Printlounge API Domain

Bitte tragen hier deine Shop-Domain des Closedshops / der PRINT LOUNGE ein

Benutzername

Benutzername aus der eingetragenen API-Schnittstelle

Passwort

Passwort aus der eingetragenen API-Schnittstelle

Benutzer-ID

Benutzer-ID des Printlounge Shop, zu finden unter Shops. Dort nun unter “Printlounge API Domain” ausgewählten Shop wählen und über “Aktionen” die Benutzergruppen anklicken. Im nächsten Schritt wählst du die Benutzergruppe, in der Ssch der Benutzer befindet, den du benutzen möchtest. In der nun erscheinenden Liste kannst du für den Benutzer die ID kopieren und eintragen.

Uber folgender URL kannst du nun Freiaufträg anlegen:

{{domain}}/api/component/Order

Bitte beachte das korrekte Format, welches Übergeben werden muss.
Für eine bessere Übersicht über Pflichtfelder, Schema und Beispieldaten, nutze bitte die Schnittstellenbeschreibung.

Für die Erstellung der personalisierten Druckdatei, muss die korrekte “persId” übertragen werden.
Bei der “persId” handelt es sich um die Artikel-ID aus deinem Closed Shop / PRINT LOUNGE Shop.
Bei der Verwendung der “persId”, muss “persData” gefüllt sein. Bei “persData” handelt es sich um ein Key / Value-Paar mit den im Artikel konfigurierten Personalisierungsvariablen und baut sich wie folgt auf:

wide760

Schnittstellenbeschreibung

Auftragsdetailansicht

Wir haben die Auftragsdetailansicht erneuert und übersichtlicher gestaltet:

Auftragsdetailansicht

Auftragshistorie


Historie der jeweiligen Statuswechsel

Barcode

generierter Barcode samt Jobnummer

Weitere bestellte Artikel

Verlinkung zu weiteren Bestellpositionen des Auftrages, sofern vorhanden

Bestelldetails

Info: Es sind neue Vorlagenvariablen hinzugekommen, die du hier in der Liste findest. Standardvariablen stehen in Klammern zu jeder Bezeichnung in der Beschreibung sofern Vorhanden.

Bezeichnung

Beschreibung

Shop

Shop in dem die Bestellung eingegangen ist

Bestelldatum

Datum/Uhrzeit der Bestellung (Variablenname: bestelldatum)

Jobnummer

Eindeutige Jobnummer (Variablenname: jobnummer)

Externe Referenz-ID

übermittelte externe Referenznummer

Auftragsnummer

generierte Auftragsnummer

Paketnummer

Paketnummer

Rechnungsnummer

generierte Rechnungsnummer

allgemeine Bestelldaten

übermittelte allgemeine Bestelldaten, diese stehen jeder Position des Auftrages zur Verfügung.

Neue Variable: TODO

Artikel / Bezeichnung

übermittelte Artikelbezeichnung

Artikelnummer

übermittelte Artikelnummer

Artikel-Zusatzfelder

Personalisierungs-ID

Personalisierungsdaten

Liefertermin

Preis

Druckdaten

Statuswechsel

Auftragsdokumente

Adressen