1 Themenübersicht
In dieser Dokumentation wird die Vorgehensweise für den Umgang mit der Anwendung „Daten importieren“ bezogen auf Vertriebspreislisten und Vertriebspreis-Listungen beschrieben. Sie werden außerdem über mögliche Voraussetzungen, Auswirkungen und Beschränkungen informiert.
Die Beschreibung der Anwendung „Daten importieren“, die unter anderem auch Feld- und Button-Beschreibungen enthält, finden Sie in der Dokumentation „Daten importieren“.
2 Allgemeines
Der Import einer Vertriebspreisliste bzw. einer Vertriebspreis-Listung basiert im Wesentlichen auf dem aktuellen Datenmodell, welches in der Repository-Datenbank hinterlegt ist. Für den Datenexport stehen mehr Attribute als für den Datenimport zur Verfügung. Deshalb ist sinnvoll, für den Export und Import separate Filter festzulegen.
Bestimmte Daten wie interne Hilfsattribute können nicht importiert werden.
Wenn Sie sich nicht sicher sind, welches das geeignete Format der Importdatei ist, dann gehen Sie wie folgt vor: Erfassen Sie über die Anwendung „Vertriebspreislisten“ eine Beispiel-Preisliste und exportieren Sie diese mit dem Filter für den Import im gewünschten Format mit den gewünschten Attributen. Die so entstehende Beispieldatei lässt sich als Vorlage für die zu erzeugenden Importdateien verwenden.
Beim Import gelten die gleichen Regeln wie bei der Bearbeitung über die Anwendung. Zum Beispiel kann in einer gespeicherten Position der Artikel nicht mehr nachträglich geändert werden. Attributwerte, die im aktuellen Kontext nicht übernommen werden können, werden ignoriert. Ebenso wird bei der Vorschlagswertermittlung die gleiche Logik durchlaufen, sodass sich Import und Anwendung identisch verhalten. Gleiches gilt für die Prüfungen.
3 Vorgehensweise: Vertriebspreisliste/Vertriebspreis-Listung importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für eines dieser Business Objects anzeigen:
- Für Preislisten: cisag.app.sales.obj.PriceList
- Für Preis-Listungen: cisag.app.sales.obj.PriceListing
- Der jeweilige Filter für den Import wird geöffnet.
- Duplizieren oder erfassen Sie bei Bedarf einen neuen Filter für das gewählte Business Object.
- Ändern Sie bei Bedarf die bereits ausgewählten Attribute des Filters.
- Drücken Sie in der Standard-Symbolleiste den Button „Daten importieren“.
- Das Dialogfenster „Daten importieren“ wird geöffnet.
- Im Dialogfenster „Daten importieren“ können Sie Einstellungen für die Importdatei vornehmen. Eine Beschreibung der Felder finden Sie in der Dokumentation „Daten importieren“.
- Drücken Sie einen der Buttons „Im Hintergrund“ oder „Sofort“.
- Der Import wird ausgeführt.
4 Aufbau einer Vertriebspreisliste
Eine Vertriebspreisliste besteht aus folgenden Elementen:
- Basisdaten
- Positionsdaten (Preise, Rabatte etc.)
Die Positionsdaten können nicht separat, sondern nur mit Zuordnung zu einer eindeutig identifizierten Vertriebspreisliste importiert werden.
Sollte eine zu importierende Position bereits bestehen, dann wird diese Position nicht geändert, sondern eine neue Version erzeugt (Ausnahme: wenn die Vertriebspreisliste noch nicht in einer Vertriebspreis-Listung verwendet wird).
Zeitabhängigkeit der Positionsdaten
Den Gültigkeitszeitraum einer Preiskomponente legen Sie durch die Attribute „priceListValidFrom“ und „priceListValidUntil“ fest. Dieser Zeitraum wird in der Anwendung „Vertriebspreislisten“ angezeigt. Wenn Sie die Attribute nicht angeben, wird der Gültigkeitszeitraum der Preisliste übernommen.
Mit den Attributen „validFrom“ und „validUntil“ bestimmen Sie die Objektgültigkeit einer Preisfestlegung. Dieser Zeitraum wird in der Anwendung „Vertriebspreislisten“ nicht angezeigt. Sie können damit festlegen, wann eine Preiskomponente erfasst wurde bzw. wann sie ein Löschkennzeichen erhalten hat. Im Normalfall sollten Sie diese Attribute beim Import nicht verwenden. Sie greifen damit in die historische Preisermittlung ein.
Weitere Informationen zur Zeitabhängigkeit finden Sie der Dokumentation „Vertriebspreislisten“.
5 Aufbau einer Vertriebspreis-Listung
Eine Vertriebspreis-Listung besteht aus folgenden Elementen:
- Basisdaten
- Positionsdaten (zugeordnete Vertriebspreislisten, Priorität und Gültigkeit der Zuordnung)
Positionsdaten und Basisdaten müssen separat importiert werden. Beim Import der Vertriebspreis-Listungen müssen die referenzierten Vertriebspreislisten bereits bestehen.
Sollte eine zu importierende Position bereits bestehen, dann wird diese Position nicht geändert, sondern eine neue Version erzeugt.
Zeitabhängigkeit der Positionsdaten
Den Gültigkeitszeitraum einer Preislisten-Zuordnung legen Sie durch die Attribute „assignmentValidFrom“ und „assignmentValidUntil“ fest. Dieser Zeitraum wird in der Anwendung „Vertriebspreis-Listungen“ angezeigt. Wenn Sie die Attribute nicht angeben, wird der Gültigkeitszeitraum der Preisliste übernommen.
Mit den Attributen „validFrom“ und „validUntil“ bestimmen Sie die Objektgültigkeit einer Preislisten-Zuordnung. Dieser Zeitraum wird in der Anwendung „Vertriebspreis-Listungen“ nicht angezeigt. Sie können damit festlegen, wann eine Preislisten-Zuordnung erfasst wurde bzw. wann sie ein Löschkennzeichen erhalten hat. Im Normalfall sollten Sie diese Attribute beim Import nicht verwenden. Sie greifen damit in die historische Preisermittlung ein.
Weitere Informationen zur Zeitabhängigkeit finden Sie in der Dokumentation „Einführung: Vertriebspreise“.
6 Reihenfolge
Die Vertriebspreislisten werden für die Positionsdaten der Vertriebspreis-Listungen benötigt, deshalb müssen Sie folgende Reihenfolge einhalten:
- Import der Vertriebspreislisten
- Import der Vertriebspreis-Listungen
7 Übersicht: Attribute
Nachfolgend sind die Attribute der einzelnen Business Objects aufgeführt, die für den Import zur Verfügung stehen. Bei Fremdschlüsselattributen steht zusätzlich der entsprechende Beziehungsname dabei. Die Identifikations- und Pflichtfelder sind Änderungen unterworfen und können durch Anpassungen erweitert werden.
Die Identifikationsattribute (Key-Attribute) werden über ein (K) gekennzeichnet.
7.1 Vertriebspreisliste
7.1.1 Basisdaten: Vertriebspreisliste (PriceList)
Die Identifikation einer Vertriebspreisliste besteht aus einer Organisation und dem code der Preisliste.
| Attribut | Beziehung | Erläuterung |
| classification | Classification | Vertriebspreislisten- Klassifikation |
| code (K) | Preisliste | |
| currency | Currency | Währung |
| description | Bezeichnung | |
| guid (K) | Technische Identifikation:
Relevant für die Änderung/Löschung bereits gespeicherter Daten, sofern bekannt |
|
| organizationalUnit (K) | OrganizationalUnit | Organisation |
| priceIncludingTaxes | Endverbraucherpreise | |
| priceListValidFrom | Gültig von | |
| priceListValidUntil | Gültig bis | |
| standard | Standard | Standardpreisliste |
| type | Preislistentyp | |
| validityFixed | Gültigkeitszeitraum übernehmen |
7.1.2 Positionsdaten: Vertriebspreis-Komponenten (PriceDefinitions)
| Attribut | Beziehung | Erläuterung |
| customerItemNumber | Kunden-Artikelnummer | |
| customerItemDescription | Kunden-Artikelbezeichnung | |
| discountItem | DiscountItem | Rabattartikel |
| ean | Europäische Artikelnummer (EAN)
Weitere Informationen finden Sie in dieser Dokumentation: Belegposition mithilfe einer EAN importieren |
|
| item (K) | Item | Artikel
Hinweis: Artikel und Vertriebs-Artikelpreis-Klassifikation können Sie nur alternativ verwenden. |
| itemKeyType (K) | Typ der Artikelkomponente
Hinweis: Mindestens einen der Typen der Artikel- bzw. Partnerkomponente müssen Sie angeben. |
|
| itemPriceHierarchy | ItemPriceHierarchy | Vertriebs-Artikelpreis-Klassifikation
Hinweis: Artikel und Vertriebs-Artikelpreis-Klassifikation können Sie nur alternativ verwenden. |
| partner (K) | Partner | Partner
Hinweis: Partner und Kundenpreis-Klassifikation können Sie nur alternativ verwenden. |
| partnerKeyType (K) | Typ der Partnerkomponente
Hinweis: Mindestens einen der Typen der Artikel- bzw. Partnerkomponente müssen Sie angeben. |
|
| partnerPriceHierarchy | PartnerPriceHierarchy | Kundenpreis-Klassifikation
Hinweis: Partner und Kundenpreis-Klassifikation können Sie nur alternativ verwenden. |
| priceCurrency | PriceCurrency | Währung des Preiswerts
Hinweis: Währung und Einheit des Preiswerts können Sie nur alternativ verwenden. |
| priceDimension | Preisdimension | |
| priceDiscountType (K) | PriceDiscountType | Vertriebspreis-Komponentenart |
| priceKeyUom | PriceKeyUom | Einheit des Preiswerts
Hinweis: Währung und Einheit des Preiswerts können Sie nur alternativ verwenden. |
| pricelist (K) | Preisliste | |
| priceListValidFrom (K) | Gültig von | |
| priceListValidUntil | Gültig bis | |
| priceType | Typ des Preiswerts: Menge, Preis, Prozent | |
| priceUom | PriceUom | Einheit der Preisdimension |
| priceValue | Preiswert | |
| rebateInKind | Kennzeichen für Naturalrabatte:
· true = Preistyp der Position ist Naturalrabatt · false = Preistyp der Position ist kein Naturalrabatt |
|
| roundingParameters
· roundingParameters.algorithm · roundingParameters.base |
Rundungsparameter
· Rundungsregel · Rundungsbasis |
|
| scaleCurrency | ScaleCurrency | Währung der Staffel
Hinweis: Währung und Einheit der Staffel können Sie nur alternativ verwenden. |
| scaleType (K) | Staffeltyp: Menge, Preis, Prozent | |
| scaleUom | ScaleUom | Einheit der Staffel
Hinweis: Währung und Einheit der Staffel können Sie nur alternativ verwenden. |
| scaleValue (K) | Staffelwert | |
| validFrom (K) | Gültig ab
Hinweis: Verwenden Sie dieses Attribut nur, wenn Sie in die historische Preisermittlung eingreifen möchten. |
|
| validUntil | Gültig bis
Hinweis: Verwenden Sie dieses Attribut nur, wenn Sie in die historische Preisermittlung eingreifen möchten. |
7.2 Vertriebspreis-Listung
7.2.1 Basisdaten: Vertriebspreis-Listung (PriceListing)
Die Identifikation einer Vertriebspreis-Listung besteht aus dem code der Preis-Listung.
| Attribut | Beziehung | Erläuterung |
| classification | Classification | Vertriebspreis-Listungen-Klassifikation |
| code (K) | Listung | |
| currency | Currency | Währung |
| description | Beschreibung | |
| guid (K) | Technische Identifikation der Preis-Listung:
Relevant für die Änderung/Löschung bereits gespeicherter Daten, sofern bekannt |
|
| maintainingOrganization | MaintainingOrganization | Zuständige Organisation |
| priceIncludingTaxes | Endverbraucherpreise |
7.2.2 Positionsdaten: Vertriebspreislisten-Zuordnung
(PriceListingAssignments)
| Attribut | Beziehung | Erläuterung |
| assignmentValidFrom | Gültig von | |
| assignmentValidUntil | Gültig bis | |
| list (K) | List | Vertriebspreisliste |
| listing (K) | Preis-Listung | |
| priority | Priorität | |
| validFrom (K) | Gültig ab
Hinweis: Verwenden Sie dieses Attribut nur, wenn Sie in die historische Preisermittlung eingreifen möchten. |
|
| validUntil | Gültig bis
Hinweis: Verwenden Sie dieses Attribut nur, wenn Sie in die historische Preisermittlung eingreifen möchten. |