Transportverfahren	Datei-Import/Export über SFTP-Hotfolder
Objekt	Anzeigen (XML (Buchungsdaten, eine XML-Datei pro Auftrag oder pro Anzeige mit jeweils allen Daten des Auftrages / der Anzeige), PDF (Anzeigenmotive))
Trigger	zeitgesteuert mit Intervall (Workflow)
Typische Drittsysteme	Typische Drittsysteme sind zum Beispiel Vi&Va, SAP, alfa adsuite

Funktionalitäten der Schnittstelle

Import Auftragsdaten
Import Anzeigenmotive
Export Anstrich/Statusrückmeldungen

Inhaltsverzeichnis

Expand

title	Inhaltsverzeichnis anzeigen

Table of Contents

maxLevel	4

Funktionalitäten der Schnittstelle

...

Import Auftragsdaten

...

Import Anzeigenmotive

...

Besondere Angaben zu Eigenschaften

...

Die Tag-Namen sind genau den Namen aus dem oben genannten Beispiel zu entnehmen. Andere Tag-Strukturen werden nicht verarbeitet.Beispiel:

Warning
Fehlerhaftes Beispiel, da nicht exakte Struktur/Tag-Benennung

<?xml version="1.0" encoding="UTF-8" ?>

- <Anzeigen>

...

/wiki/spaces/CORE/pages/912424975 <Anzeigen>

/wiki/spaces/CORE/pages/912424975 <Anzeige>
<DAnzeigeNr>638524-1</DAnzeigeNr>
<DAnzAuftragNr>638524</DAnzAuftragNr>
<DAnzMotivNr>1</DAnzMotivNr>
<DAnzeigeName>638524(1-1)/AanzName</DAnzeigeName>
<DAnzeigeKunde>AnzKunde</DAnzeigeKunde>
<DAnzeigeKundenNr>444921</DAnzeigeKundenNr>
<Status>beauftragt</Status>
<DAnzProduktTyp>TA</DAnzProduktTyp>
<DAnzeigeBreiteGebucht>47</DAnzeigeBreiteGebucht>
<DAnzeigeHoeheGebucht>29</DAnzeigeHoeheGebucht>
<DAnzeigeFarbPlanGebucht>K,C,M,Y</DAnzeigeFarbPlanGebucht>
<DAnzSort1></DAnzSort1>
<DAnzSort2></DAnzSort2>

-/wiki/spaces/CORE/pages/912424975 <Buchungen>

-/wiki/spaces/CORE/pages/912424975 <Buchung1>
<Ausgabe>ausgabe1</Ausgabe>
<Termin>2023-02-22</Termin>
<AnzeigenRubrik>Immo</AnzeigenRubrik>
<Platzierung></Platzierung>
<PlKommentar />
</Buchung1>

</Buchungen>
</Anzeige>

</Anzeigen>

→ Fehler, da nicht exakte Struktur/Tag-Benennung

Beispiel:

Tip
Beispiel für eine korrekte Struktur

<?xml version="1.0" encoding="UTF-8" ?>

- <Anzeigen>

...

/wiki/spaces/CORE/pages/912424975 <Anzeigen>

/wiki/spaces/CORE/pages/912424975 <Anzeige>
<DAnzeigeNr>638524-1</DAnzeigeNr>
<DAnzAuftragNr>638524</DAnzAuftragNr>
<DAnzMotivNr>1</DAnzMotivNr>
<DAnzeigeName>638524(1-1)/AanzName</DAnzeigeName>
<DAnzeigeKunde>AnzKunde</DAnzeigeKunde>
<DAnzeigeKundenNr>444921</DAnzeigeKundenNr>
<Status>beauftragt</Status>
<DAnzProduktTyp>TA</DAnzProduktTyp>
<DAnzeigeBreiteGebucht>47</DAnzeigeBreiteGebucht>
<DAnzeigeHoeheGebucht>29</DAnzeigeHoeheGebucht>
<DAnzeigeFarbPlanGebucht>K,C,M,Y</DAnzeigeFarbPlanGebucht>
<DAnzSort1></DAnzSort1>
<DAnzSort2></DAnzSort2>
- <AnzeigeBuchungen>

...

/wiki/spaces/CORE/pages/912424975 <AnzeigeBuchungen>

/wiki/spaces/CORE/pages/912424975 <Buchung>
<Ausgabe>ausgabe1</Ausgabe>
<Termin>2023-02-22</Termin>
<AnzeigenRubrik>Immo</AnzeigenRubrik>
<Platzierung></Platzierung>
<PlKommentar />
</Buchung>

</AnzeigeBuchungen>
</Anzeige>

</Anzeigen>

→ Korrekte Struktur

Pflichtfelder

Um einen fehlerlosen Anzeigenimport zu gewährleisten, müssen die Inhalte folgender Felder zwingend mitgeliefert werden:

DAnzeigeNr
DAnzAuftragNr
DAnzMotivNr
DAnzeigeName
DAnzProduktTyp
DAnzeigeBreiteGebucht
DAnzeigeHoeheGebucht
DAnzeigeFarbplanGebucht

Einschränkungen zu mitgelieferten Inhalten

...

Zu DAnzeigeProduktTyp dürfen nur folgende Werte geliefert werden: AT“AT”, TT oder TA

...

“TT” oder “TA”.

Warning

Falsch angelieferte Beispiele:

<DAnzProduktTyp>TT-Textteil</DAnzProduktTyp>

...

<DAnzProduktTyp>ST</DAnzProduktTyp>

...

Tip

Richtig angeliefertes Beispiel:

<DAnzProduktTyp>TT</DAnzProduktTyp>

DAnzeigeBreiteGebucht und DAnzeigeHoeheGebucht

Kommastellen müssen hier mit einem “.” oder “,” voneinander getrennt werden (Ein ein Punkt wird in dem Stylesheet in ein Komma umgewandelt). Beispiel:

angeliefert: <DAnzeigeBreiteGebucht>47.8</DAnzeigeBreiteGebucht> → Fehler
wird übersetzt in: <DAnzeigeBreiteGebucht>47,8</DAnzeigeBreiteGebucht>

Termin

Termine (Erscheinungstage) müssen in dem Format JJJJ“JJJJ-MM-TT TT” mitgeliefert werden.

Warning
Falsch angeliefertes Beispiel:

...

<Termin>22.02.2023</Termin>

...

Tip

Richtig angeliefertes Beispiel:

<Termin>2023-02-22</Termin>

Storno

Um Anzeigen als Storniert zu kennzeichnen, sind leere Buchungen mitzugeben. Wichtig zu beachten ist, dass das Tag für die Buchungen weiterhin bestehen muss. Lediglich die Inhalte sind leer zu lassen.

Tip
Beispiel einer korrekt angelieferten, stornierten Anzeige:

- <Anzeigen>

/wiki/spaces/CORE/pages/912424975 <Anzeige>

<DAnzeigeNr>638308-1</DAnzeigeNr>
<DAnzAuftragNr>638308</DAnzAuftragNr>
<DAnzMotivNr>1</DAnzMotivNr>
<DAnzeigeName>638308name</DAnzeigeName>
<DAnzeigeKunde />
<DAnzeigeKundenNr />
<Status>storno</Status>
<DAnzProduktTyp>AT</DAnzProduktTyp>
<DAnzeigeBreiteGebucht>42</DAnzeigeBreiteGebucht>
<DAnzeigeHoeheGebucht>42</DAnzeigeHoeheGebucht>
<DAnzeigeFarbPlanGebucht />
<DAnzSort1 />
<DAnzSort2 />
<AnzeigeBuchungen />
</Anzeige>

...

Vom kaufmännischen Anzeigensystem werden XML-Dateien mit Auftragsdaten in einem von NGen PRINT NGEN überwachten Hotfolder (siehe /wiki/spaces/CORE/pages/906133524 ) abgelegt. Je nach kaufmännischem System hat das angelieferte XML eine jeweils eigene Struktur (siehe Beispieldaten unten). NGen PRINT NGEN importiert die Auftragsdaten mittels einer komplexen Workflow-Aktion und bringt sie mittels XSLT-Stylesheet und Konfigurationsabbildungen in die benötigte Struktur. Dabei werden auch die Bezeichnungen der Ausgaben, Rubriken und Platzierungsvorschriften an die gewünschte Schreibweise in der Blattplanung angepasst. So werden entsprechende Buchungen in NGen PRINT NGEN erstellt und aktualisiert.

...

Die Motive werden vom technischen Anzeigensystem in einem weiteren Hotfolder als PDF angeliefert. NGen PRINT NGEN importiert diese und führt sie mit den Auftragsdaten zusammen. Als eindeutiges Kennzeichen der Zuordnung dient dabei die Auftragsnummer in Kombination mit der Motivnummer im Dateinamen des Motivs.

Eine Anzeige besteht in NGen PRINT NGEN aus genau einem Anzeigenmotiv. Eine Anzeige kann dabei mehrere Buchungen haben. Aus jedem Motiv eines Anzeigenauftrags im Kaufmännischen System wird in NGen PRINT NGEN eine Anzeige generiert. Bei jeder Anzeige wird in NGen PRINT NGEN zur Identifizierung die Auftragsnummer sowie die Motivnummer als Anzeigennummer (DAnzeigeNr“DAnzeigeNr”) gespeichert.

Die Erscheinungen des Auftrages werden der jeweiligen Anzeige in NGen PRINT NGEN zugeordnet und dort als Buchung hinzugefügt. Bei jeder Buchung in NGen PRINT NGEN wird eine ID der Erscheinung gespeichert. Diese wird später in der Rückmeldung an das kaufmännische System zur eindeutigen Identifizierung der Erscheinung enthalten sein.

...

Bei einer Kombi im kaufmännischen System müssen entsprechend für jede zugehörige Belegung einzelne Buchungen übergeben werden.

Eindeutigkeit der

...

PRINT NGEN Buchungen

Im kaufmännischen System kann es vorkommen, dass es zu einem Motiv mehrere Erscheinungen am gleichen Tag in der gleichen Ausgabe gibt, zum Beispiel wenn ein- und dieselbe Anzeige dort in mehreren Rubriken erscheinen soll. Damit würde in NGen PRINT NGEN die Eindeutigkeit (Ausgabe und Erscheinungstag) der Buchungen innerhalb einer Anzeige verletzt werden. Beim Import werden deshalb in einem solchen Fall automatisch durch Kopieren mehrere Anzeigen mit der gleichen Anzeigennummer in NGen PRINT NGEN erstellt, und die nicht eindeutigen Buchungen auf diese Anzeigen verteilt. Die so erstellten Kopien haben die gleiche Anzeigennummer wie das Original und sind über die Relation COID mit der Original-Anzeige verknüpft. Beim PDF-Import wird dann das PDF automatisch vom Original auf alle Kopien übertragen.

...

Buchungen (=Erscheinungen) werden beim Import grundsätzlich immer nach NGen PRINT NGEN übernommen. Wenn eine Buchung im Import-XML komplett wegfällt, dann wird sie auch in NGen PRINT NGEN wegfallen, sofern sie in NGen dort noch nicht angestrichen wurde. Angestrichene Buchungen bleiben erhalten.

...

Eine Rückmeldung über die importierten Anzeigen aus NGen PRINT NGEN heraus erfolgt in Form des Anstrichs für die erschienenen Buchungen nach der täglichen Produktion in Form von XML-Dateien an das kaufmännische System, wenn das für die Verrechnung und Reklamationsbearbeitung nötig ist. Die Rückmeldung erfolgt jeweils in Form einer XML-Datei pro Anzeige, die von NGen PRINT NGEN in einem definierten Verzeichnis abgelegt wird.

Der Anstrich erfolgt in NGen PRINT NGEN für alle Anzeigen in einem erschienenen Druckprodukt. Bei den zugehörigen Buchungen dieser Anzeigen werden die Informationen für jede Erscheinung in dem Tag <Anstrich> vermerkt.

...

Code Block

<?xml version="1.0" encoding="UTF-8"?>
<Anzeigen>
	<Anzeige>
		<DAnzeigeNr>16642-1</DAnzeigeNr>
		<DAnzAuftragNr>16642</DAnzAuftragNr>
		<DAnzMotivNr>1</DAnzMotivNr>
		<DAnzeigeName>Mein Stichwort Motiv 1</DAnzeigeName>
		<DAnzeigeKunde>Reisebüro PEIQ</DAnzeigeKunde>
		<DAnzeigeKundenNr>3085</DAnzeigeKundenNr>
		<Status>Fertig</Status>
		<DAnzProduktTyp>AT</DAnzProduktTyp>
		<DAnzeigeBreiteGebucht>45</DAnzeigeBreiteGebucht>
		<DAnzeigeHoeheGebucht>100</DAnzeigeHoeheGebucht>
		<DAnzeigeFarbPlanGebucht>K,C,M,Y</DAnzeigeFarbPlanGebucht>
		<DAnzSort1>Mein Kriterium 1</DAnzSort1>
		<DAnzSort2>Mein Kriterium 2</DAnzSort2>
		<AnzeigeBuchungen>
			<Buchung>
				<Ausgabe>ost</Ausgabe>
				<Termin>14.12.2021</Termin>
				<AnzeigenRubrik>E00100</AnzeigenRubrik>
				<Platzierung>s:3</Platzierung>
				<PlKommentar>Bitte ganz oben rechts</PlKommentar>
				<Kollektiv>12345</Kollektiv>
			</Buchung>
			<Buchung>
				<Ausgabe>west</Ausgabe>
				<Termin>14.12.2021</Termin>
				<AnzeigenRubrik>E00100</AnzeigenRubrik>
				<Platzierung>s:3</Platzierung>
				<PlKommentar>Bitte ganz oben rechts</PlKommentar>
				<Kollektiv>12345</Kollektiv>
			</Buchung>
			<Buchung>
				<Ausgabe>ost</Ausgabe>
				<Termin>15.12.2021</Termin>
				<AnzeigenRubrik>E00100</AnzeigenRubrik>
				<Platzierung>s:3</Platzierung>
				<PlKommentar>Bitte ganz oben rechts</PlKommentar>
				<Kollektiv>12345</Kollektiv>
			</Buchung>
			<Buchung>
				<Ausgabe>west</Ausgabe>
				<Termin>15.12.2021</Termin>
				<AnzeigenRubrik>E00100</AnzeigenRubrik>
				<Platzierung>s:3</Platzierung>
				<PlKommentar>Bitte ganz oben rechts</PlKommentar>
				<Kollektiv>12345</Kollektiv>
			</Buchung>
		</AnzeigeBuchungen>
		</Anzeige>
		<Anzeige>
			<DAnzeigeNr>16642-2</DAnzeigeNr>
			<DAnzAuftragNr>16642</DAnzAuftragNr>
			<DAnzMotivNr>2</DAnzMotivNr>
			<DAnzeigeName>Mein Stichwort Motiv 2</DAnzeigeName>
			<DAnzeigeKunde>Reisebüro PEIQ</DAnzeigeKunde>
			<DAnzeigeKundenNr>3085</DAnzeigeKundenNr>
			<Status>Geplant</Status>
			<DAnzProduktTyp>TT</DAnzProduktTyp>
			<DAnzeigeBreiteGebucht>90</DAnzeigeBreiteGebucht>
			<DAnzeigeHoeheGebucht>200</DAnzeigeHoeheGebucht>
			<DAnzeigeFarbPlanGebucht>K,C,M,Y</DAnzeigeFarbPlanGebucht>
			<DAnzSort1>Mein Kriterium 1</DAnzSort1>
			<DAnzSort2>Mein Kriterium 2</DAnzSort2>
			<AnzeigeBuchungen>
				<Buchung>
					<Ausgabe>ost</Ausgabe>
					<Termin>16.12.2021</Termin>
					<AnzeigenRubrik>E00100</AnzeigenRubrik>
					<Platzierung>r:reise</Platzierung>
					<PlKommentar>Bitte ganz oben links</PlKommentar>
					<Kollektiv>5678</Kollektiv>
				</Buchung>
				<Buchung>
					<Ausgabe>west</Ausgabe>
					<Termin>17.12.2021</Termin>
					<AnzeigenRubrik>E00100</AnzeigenRubrik>
					<Platzierung>r:reise</Platzierung>
					<PlKommentar>Bitte ganz oben links</PlKommentar>
					<Kollektiv>5678</Kollektiv>
				</Buchung>
			</AnzeigeBuchungen>
		</Anzeige>
</Anzeigen>

Infonote

Voraussetzungen für den Betrieb der Schnittstelle:

Belieferung des sFTP mit entsprechendem XML
Das Modul Blattplanung (optional Anzeigenumbruch, technisches Anzeigensystem) muss sich im Einsatz befinden
Es müssen immer die gesamten Daten eines Auftrages im XML mitgeliefert werden, auch beim Update (kein Delta, Teile oder einzelne Erscheinungstage)

...

Include Page

	Disclaimer der PEIQ PRINT NGEN - Produktdokumentation
	Disclaimer der PEIQ PRINT NGEN - Produktdokumentation

Nur für PEIQ-Mirabeiter:innen

/wiki/spaces/CORE/pages/912424975

Versions Compared

Old Version 27

New Version Current

Key

Besondere Angaben zu Eigenschaften

Pflichtfelder

Einschränkungen zu mitgelieferten Inhalten

Storno

Eindeutigkeit der

PRINT NGEN Buchungen

Page Comparison

Versions Compared

Old Version 27

New Version Current

Key

Besondere Angaben zu Eigenschaften

Pflichtfelder

Einschränkungen zu mitgelieferten Inhalten

Storno

Eindeutigkeit der

PRINT NGEN Buchungen