Versions Compared

Old Version 19

changes.mady.by.user Ansgar Redder

Saved on

compared with

New Version Current

changes.mady.by.user Uwe Kern

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Über die Schnittstelle soll die automatisierte Bereitstellung von Verkaufsdokumente aus Fremdsystemen an Open Datacheck ermöglicht werden. Die Definition, der auf Open Datacheck mögliche Marketing- und Vertriebsunterlagen, finden sie unter Marketing- und Vertriebsunterlagen Open Datacheck.

Rahmenbedingungen

Bei der Bereitstellung von Marketing- und Verkaufsdokumente sind verschiedenen Informationen relevant. Diese sind zum einen die Datei, welche übergeben werden soll. Weiterhin sind aber auch zusätzliche Metadaten relevante, welche die Nutzung und Verteilung steuern. Diese Metadaten sind im einzelnen:

Metadatum

Beschreibung

Mögliche Inhalte

Beispiel

Anmerkungen

Art des Dokuments

Angabe um welche Marketing- bzw. Vertriebsunterlage es sich handelt.

Folgende Dokumentarten können angegeben werden:

  • Produktkatalog

  • Preisliste

  • Ersatzteilkatalog

  • Prospekt

  • Flyer

  • Magazin

  • Praesentation (Präsentation)

  • Aktion

  • Nutzerinformationen

  • Imagevideo

  • Produktvideo

  • Anwendungsvideo

  • Schulungsvideo

  • Montagevideo

“Produktkatalog”

Die Angabe erfolgt implizite implizit durch Ablage der Datei in den entsprechenden Unterordner im FTP (s. u.).

Dateiname des Dokuments

Angabe des Dateinamen zur Selection der zur Info-Datei zugeordneten Datei.

Filenamen ohne Pfadangabe

255 Zeichen

Code Block
<FileName>Produktkatalog_2022.odf</FileName>

Beginn des Gültigkeitszeitraums

Angabe des Datums ab dem das Dokument gültig ist.

Der Gültigkeitszeitraum wird zur Steuerung der Sichtbarkeit beim Großhandel genutzt.

Alle Dokumente werden, unabhängig vom Gültigkeitsdatum an den Großhandel weitergegeben.

Datumsangabe im Format YYY-MM-DD

Code Block
<ValidityBegin>2022-11-11</ValidityBegin><!--Beginn des Gültigkeitszeitraums-->

Ende des Gültigkeitszeitraums

Angabe des Datums bis zu dem das Dokument gültig ist.

Der Gültigkeitszeitraum wird zur Steuerung der Sichtbarkeit beim Großhandel genutzt.

Alle Dokumente werden, unabhängig vom Gültigkeitsdatum an den Großhandel weitergegeben.

Datumsangabe im Format YYY-MM-DD

Code Block
<ValidityEnd>2022-11-11</ValidityEnd>  <!-- Ende des Gültigkeitszeitraums -->

Kurzbeschreibung (pro Sprache)

Angabe der Kurzbeschreibung zum Dokument je Sprache (deutsch und englisch).

Die Beschreibung wird bei der Anzeige in den Großhandelssystemen verwendet.

Text mit bis zu 128 Zeichen

Code Block
<Description>
  <Language>de<Language/>
  <Text>Produktkatalog 2022</Text> <!-- Kurzbeschreibung in deutsch -->
  <IsDefaultLanguage>true</IsDefaultLanguage>
</Description>
<Description>
  <Language>en<Language/>
  <Text>Cataloge 2022</Text> <!-- Kurzbeschreibung in englisch -->
  <IsDefaultLanguage>false</IsDefaultLanguage>
</Description>

Dokumentensprachen (mehrfach)

Angabe in welchen Sprachen die in diesem Dokument verwendet werden.

Codeliste der Sprachen:

  • de

  • en

Code Block
<Language>de</Language>  <!-- Dokumentensprache deutsch enthalten -->
<Language>en</Language>  <!-- Dokumentensprache englisch enthalten  -->

Es gibt Dokumente, die mehrsprachig verfasst sind.

Verfügbar in Ländern

Hier können die Ländereinstellung hinterlegt werden, in denen das Dokument verfügbar sein soll.

Die Angabe wird zur Steuerung der Sichtbarkeit beim Großhandel genutzt.

Alle Dokumente werden, unabhängig vom der Angabe an den Großhandel weitergegeben.

Codeliste der Länder:

  • de

Code Block
<Countries>de</Countries>    <!-- Verfügbar in Deutschland -->

Aktuell werden nur Dokumente für den deutschen Markt verteilt.

Handelsstufe

Angabe für welche Handelsstufe das Dokument verwendet werden kann.

Alle Dokumente werden, unabhängig vom der Angabe an den Großhandel weitergegeben.

Codelisten:

  • wholesaler

  • craftsman

  • consumer

Code Block
<TradingLevel>wholesaler</TradingLevel>    <!-- Zielgruppe Großhandel -->
<TradingLevel>craftsman</TradingLevel>     <!-- ZielgruppeHandwerker -->
<TradingLevel>consumer</TradingLevel>      <!-- ZielgruppeEndkunde -->

Über die Angabe wird z. B. gesteuert, das Preislisten nicht für Handwerker und Endkunden verfügbar sind.

Seitenversatz

Hier kann der Versatz zwischen der Seitenzahl im Dokumente (technische) und der in der Seite angegebenen Seitenzahl (fachliche Angabe) angegeben werden.

Möglicher Werte

Ganzzahl >= 0

<PageShift>0</PageShift> <!-- Seitenversatz -->

Durch die Angabe kann beim Aufruf z. B. mit einer Katalogseite (fachliche Angabe) die korrekte Seite (technischen Angabe) angezeigt werden.

...