Anmerkung: Dieses Modul wird befindet sich in Entwicklung und wird voraussichtlich 2025 veröffentlicht.
Nur in Verbindung mit dem Modul DRUCKSHOP Order-API Methoden
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:
Schnittstellenbeschreibung
{"theme":"Electric Blue","features":["titles","active","border","rounded","icons","ripples","fullscreen"],"padding":10,"height":600,"tabFont":"Atlassian","tabSize":15,"tabBold":true,"tabItalic":false,"tabUnderline":false,"tabColor":"#ffffff","tabColorBG":"#172b4d","type":"scrollable","opacity":100,"activeColor":"#ffffff","activeColorBG":"#0052cc","borderWidth":1,"borderColor":"#ebecf0","radius":5,"hoverColor":"#ffffff","hoverColorBG":"#0052cc","iconSize":"medium","iconInline":true,"iconPrimary":"#ffffff","iconSecondary":"#172b4d","separatorWidth":1,"separatorColor":"#42526E","indicatorPercent":5,"indicatorColor":"#ff5630","indicatorColorBG":"#0052cc","hide":false,"vertical":false,"preload":true,"animate":false,"uuid":"8-luMtpyn8","isNew":false,"loaded":false,"attachmentId":"att47415331"}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.
Screenshot | Bezeichnung | Beschreibung |
|---|---|---|
Shop | Shop in dem die Bestellung eingegangen ist | |
Bestelldatum | Datum/Uhrzeit der Bestellung | |
Jobnummer | Eindeutige Jobnummer | |
Externe Referenz-ID | übermittelte externe Referenznummer Neue Variable: {externalReferenceId} | |
Auftragsnummer | generierte Auftragsnummer | |
Paketnummer | Paketnummer | |
Rechnungsnummer | generierte Rechnungsnummer | |
allgemeine Bestelldaten | übermittelte allgemeine Bestelldaten, diese stehen jeder Position des Auftrages zur Verfügung. Neue Variable: {additionalOrderData} | |
Artikel / Bezeichnung | übermittelte Artikelbezeichnung | |
Artikelnummer | übermittelte Artikelnummer | |
Artikel-Zusatzfelder | Auflistung der Artikelzusatzfelder, sofern vorhanden. | |
Personalisierungs-ID | Übermittelte Personalisierungs-ID, sofern vorhanden Neue Variable: {personalisationId} | |
Personalisierungsdaten | Daten der Personalisierung. Nur vorhanden, wenn auch eine Personalisierungs-ID vorhanden ist Neue Variable: {personalisationData} | |
Liefertermin | übermittelter Liefertermin | |
Preis | übermittelter Preis |
Beispielaufruf der Variablen anhand der Rechnungsvorlage :
minimalistische Vorlage:
html #rgBlock p, .nopadmarg{padding: 0;margin: 0;} .headline {font-size:24px; font-weight:bold; color:#000000; display: block; padding: 5mm 0 10mm 0; } .billingInformation{padding:0px!important;width: 100%;} .orderHeader td{background-color:#d9d9d9;} .tablePadding > td{padding:0 5px;} .leftSpace{padding-left: 10px;} {/literal}{$r.firma}
{/if}{if $bestellung.0.rg_geschlecht == "m"} Herr {elseif $bestellung.0.rg_geschlecht == "w"} Frau {/if} {if $r.vorname or $r.nachname} {$r.vorname} {$r.nachname} {/if}
{if $r.strasse}{$r.strasse}
{/if} {if $r.plz or $r.ort}{$r.plz} {$r.ort}
{if $r.land}{$r.land}
{/if}{/if} {if $r.ustid}
USt- ID .: {$r.ustid}
{/if}Rechnung
|
{if $bestellung.0.auftragsnummer}
Auftrags-Nr.: {$bestellung.0.auftragsnummer} {/if} |
{if $bestellung.0.rechnungsnummer}
Rechnungs-Nr.: {$bestellung.0.rechnungsnummer} {/if} |
{if $bestellung.0.lieferscheinnummer}
Lieferschein-Nr.: {$bestellung.0.lieferscheinnummer} {/if} |
{if $bestellung.0.lieferscheinnummer_datum}
Datum: {$bestellung.0.lieferscheinnummer_datum} {/if} |
externe Referenz-Id: {$bestellung.0.externalReferenceId}
allgemeine Bestelldaten:
{foreach from=$bestellung.0.additionalOrderData item=item key=key}{$key}:{$item}
{/foreach}| {$item_best.bezeichnung} | USt. | Preis |
|
Auftrags-Nr.: {$item_best.jobnummer} |
||
| Material + Verarbeitung ({$item_best.preis.orig_druckpreis} {$item_best.waehrung}) {assign var="rep" value="0"} {assign var="rep_ges" value="0"} {foreach from=$item_best.zusatz item=item_zusatz key=key_zusatz} {assign var="rep" value=$item_zusatz.aufschlag|replace:",":"."} {assign var="rep_ges" value="`$rep_ges|replace:",":"."+$rep`"} {$item_zusatz.wert} ({$item_zusatz.aufschlag} {$item_best.waehrung}) {/foreach} |
{$item_best.mwst}% | {assign var="preis_ges" value="0"} {assign var="rep2" value="0"} {assign var="rep2" value=$item_best.preis.orig_druckpreis|replace:",":"."} {assign var="preis_ges" value="`$preis_ges+$rep_ges+$rep2`"} {$preis_ges|number_format:2:",":"."} {$item_best.waehrung} |
|
{if $item_best.zusatzfelder} {foreach from=$item_best.zusatzfelder item=item_zusatzfelder key=key_zusatzfelder} {$item_zusatzfelder.bezeichnung}: {$item_zusatzfelder.value} {/foreach} {/if} {if $item_best.personalisationId} Personalisierungs-ID: {$item_best.personalisationId} Personalisierungsdaten: {foreach from=$item_best.personalisationData item=item_personalisationData key=key_personalisationData} {$item_personalisationData.bezeichnung}: {$item_personalisationData.value} {/foreach} {/if} |
||
{/foreach}
|
vorgesehenes Lieferdatum: {$bestellung.0.liefertermin} |
|
Ausgabe
Druckdaten
erfolgreich abgerufene Druckdaten
Fehler beim Abruf der Druckdaten. Hier hast du die Möglichkeit, die Druckdaten erneut abzurufen, sofern die Fehler behoben sind.
Statuswechsel
Hier hast du die Möglichkeit, den Status des Auftrages zu ändern und dadurch weitere Routinen des Auftrages anzustoßen.
Auftragsdokumente
Hier lassen sich zum Auftrag die einzelnen Dokumente Aufrufen bzw. erstellen. Achte Bitte auf eine Fehlerfreie Vorlage.
Adressen
Die zum Auftrag gehörende Rechnungsadresse und wenn angegeben auch die abweichende Liefer- bzw. Absenderadresse. Der Übersichtshalber, sind diese Bereiche immer eingeklappt.