In dieser Dokumentation werden die Vorgehensweisen für den Umgang mit der Anwendung „Daten importieren“ bezogen auf Beschaffungsbonusvereinbarungen beschrieben. Diese Vorgehensweise enthält allgemeine Anleitungsschritte und Sie werden außerdem über mögliche Voraussetzungen und Auswirkungen informiert.
Die Beschreibung der Anwendung „Daten importieren“, die unter anderem auch Feld- und Button-Beschreibungen enthält, finden Sie in der Dokumentation Daten importieren.
1 Begriffsbestimmung
Bonustypen
Ein Bonus ist eine Treueprämie, die einem Kunden meistens nachträglich, in Form einer Gutschrift, gewährt wird. Der Bonus gilt als Dank für eine langjährige Geschäftsbeziehung (Bonustyp: Fixbetrag) oder für eine bestimmte Umsatzhöhe (Bonustypen: Umsatzbonus, Steigerungsbonus).
Umsatzbonus
Bonus werden mit dem Erreichen bestimmter vereinbarter Umsätze gezahlt. Die Umsätze, ab denen Bonus gezahlt werden, können stufenweise definiert werden. Der Umsatzbonus ist von den erreichten Bonusstufen abhängig. Wird eine Bonusstufe erreicht, wird prozentual vom Umsatz ein Bonus gezahlt.
Steigerungsbonus
Bonus werden mit dem Erreichen bestimmter vereinbarter Umsätze gezahlt. Die Umsätze, ab denen Bonus gezahlt werden, können stufenweise definiert werden. Der Steigerungsbonus ist abhängig von der prozentualen Überschreitung eines erreichten Umsatzes. Die Vergütung ist abhängig vom erreichten Umsatz und den darauf basierenden vereinbarten Prozenten.
Bonusstufen
Bonusstufen dienen der Festlegung bestimmter vorher vereinbarter Umsatzziele in einem definierten Zeitraum. Werden Bonusstufen überschritten, wird prozentual vom erreichten Umsatz Bonus gezahlt.
2 Allgemeines
Lesen Sie nachfolgend allgemeine Informationen zu Beschaffungsbonusvereinbarungen. Sie erfahren, wie die zu importierenden Datenobjekte zusammengesetzt sind.
Beschaffungsbonusvereinbarungen können aus folgenden Komponenten bestehen:
- Basisdaten
- Bonusstufen
- Ein- bzw. Ausschlüssen von Artikelbonus-Klassifikationen
- Zu berücksichtigende Beschaffungsorganisationen
Die letzten drei Komponenten sind Teil der Beschaffungsbonusvereinbarung und können nicht separat, sondern nur mit Zuordnung zu einer eindeutig identifizierten Beschaffungsbonusvereinbarung importiert werden.
Der Import von Bonuszahlungen und Texten wird nicht unterstützt.
3 Vorgehensweisen
Lesen Sie nachfolgend, die Vorgehensweisen beim Import von Beschaffungsbonusvereinbarungen:
- Daten importieren
- Notwendige Attribute für den Import
- Import einer neuen Beschaffungsbonusvereinbarung
- Import von Bonusstufen in eine vorhandene Beschaffungsbonusvereinbarung
3.1 Daten importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für das Business Object „com.cisag.app.purchasing.obj.BonusAgreement“ anzeigen.
- Der Filter für den Import der Daten wird angezeigt.
- Die ausgewählten Attribute des Filters sind bereits markiert. Bei Bedarf können Sie die Attribute noch anpassen.
- Drücken Sie in der Standard-Symbolleiste den Button „Daten importieren“.
- Das Dialogfenster „Daten importieren“ wird geöffnet.
- In diesem Dialogfenster können Sie Einstellung für die Importdatei vornehmen. Eine ausführliche Beschreibung der Felder finden Sie in der Dokumentation Daten importieren im gleichnamigen Abschnitt.
- Durch Drücken des Buttons „Im Hintergrund“ oder „Sofort“ können Sie den Import durchführen.
Hinweis:
Beim Import von Daten ist die Option „Verarbeitung im Hintergrund“ nur für voneinander unabhängige Daten empfohlen.
3.2 Notwendige Attribute für den Import
Geben Sie mindestens folgende Attribute pro Business Entity an:
- Identifikationsattribute (Business Key)
- Pflichtfelder
Ohne die Identifikationsattribute kann das Business Entity nicht zugeordnet werden, und fehlt ein Pflichtfeld, wird in jedem Fall die Nachbearbeitung gestartet. Die Pflichtfelder und Identifikationsattribute der einzelnen Business Objects werden im Abschnitt Tabellarische Übersicht: Identifikations- und Pflichtfelder zusammengestellt.
Zusätzlich gibt es noch Beziehungen zu anderen Business Objects, die nicht direkt zum Business Entity „Beschaffungsbonusvereinbarung“ gehören (Beziehungen über Fremdschlüssel, erkennbar durch Kursivschrift im Filter). Um diese Beziehungen auflösen zu können, müssen die Identifikationsattribute dieser Business Objects im Filter ausgewählt werden. Über Fremdschlüssel referenzierte Daten können nicht gemeinsam importiert werden. Sie müssen bereits im System vorhanden sein. Werden über die Fremdschlüssel-Beziehung andere Attribute angegeben als deren Identifikationsattribute, so werden diese ignoriert.
Wenn der Primärschlüssel eines Business Objects ganz oder teilweise aus Fremdschlüsseln besteht, dann muss in der Importdatei das Business Object, auf das sich dieser Fremdschlüssel bezieht, über seine Identifikationsattribute aufgelöst werden.
Zum Beispiel enthält eine Beschaffungsbonusvereinbarung das Attribut „paymentCurrency“. Dieses Attribut bezieht sich auf die Währung, in der die Bonusbeträge abgerechnet werden, die wiederum durch eine Identifikation (String) über die Fremdschlüssel-Beziehung „Currency“ spezifiziert wird.
3.3 Import einer neuen Beschaffungsbonusvereinbarung
In der Importdatei müssen alle Identifikations- und Pflichtattribute der Basisdaten angegeben werden. Im CSV-Format können die restlichen Daten nur in mehreren Dateien importiert werden, da mehrere 1:n-Beziehungen (Bonusstufen, zu berücksichtigende Beschaffungsorganisationen) angegeben werden müssen. Lesen Sie die Dokumentation zur Anwendung „Daten importieren“, um zu erfahren, wie separate Importdateien verknüpft werden.
Beispiel für das Importieren neuer Beschaffungsbonusvereinbarungen mit mehreren Importdateien:
Basisdaten
number | Bonus Agreement Type.code |
description | Currency | Responsible Partner |
… |
100 | UMS | Umsatzbonus | EUR | MUELLER | … |
200 | STG | Steigerungsbonus | EUR | MUELLER | … |
Bonusstufen
number | BonusAgree mentType.code |
BonusAgree mentDetails. level |
BonusAgreementDetails. bonusPercent |
… |
100 | UMS | 1 | 0,25 | … |
100 | UMS | 2 | 0,75 | … |
100 | UMS | 3 | 1,25 | … |
200 | STG | 1 | 0,5 | … |
200 | STG | 2 | 1 | … |
Zu berücksichtigende Beschaffungsorganisationen
number | BonusAgreementType.code | BonusAgreementOrganizationAssignments.InvoicingPartyPartner | … |
100 | UMS | IT01 | … |
200 | STG | SA01 | … |
200 | STG | SA02 | … |
200 | STG | SA03 | … |
3.4 Import von Bonusstufen in eine vorhandene Beschaffungsbonusvereinbarung
Voraussetzung für diesen Weg des Imports von Bonusvereinbarungen ist, dass die Basisdaten bereits erfolgreich importiert wurden. In der Importdatei müssen lediglich die Identifikationsattribute (number, BonusAgreementType.code) der Basisdaten angegeben werden. Geben Sie andere Attribute der Basisdaten an, werden die vorhandenen Daten überschrieben.
Existiert bereits eine zu importierende Bonusstufe (entsprechend der Attribut-Kombination number, BonusAgreementType, BonusAgreementDetails.level), so werden die Daten überschrieben.
Sie sollten diese Importmöglichkeit nur zum Aktualisieren einer Beschaffungsbonusvereinbarung anwenden. Der getrennte Import von Bonusvereinbarungen und Bonusstufen führt zu Performance-Einbußen.
Beispiel einer Importdatei für das Aktualisieren von Bonusstufen:
number | BonusAgree mentType.code |
BonusAgree mentDetails. level |
BonusAgreementDetails. bonusPercent |
… |
100 | UMS | 1 | 0,25 | … |
100 | UMS | 2 | 0,75 | … |
100 | UMS | 3 | 1,25 | … |
200 | STG | 1 | 0,5 | … |
200 | STG | 2 | 1 | … |
4 Übersicht: Identifikations- und Pflichtfelder
In diesem Kapitel werden die Identifikations- und Pflichtattribute zusammengestellt.
Hinweis:
Beim Import im CSV-Format müssen Sie für alle Fremdwährungs-Attribute (ForeignAmount), die Sie für den Import ausgewählt haben, mindestens das Attribut „amount“ angeben. Verwenden Sie bei Bedarf die Ziffer „0“.
4.1 Basisdaten
Attributpfad | Bezeichnung | Fremdschlüssel-Beziehung |
number (K) | Identifikation | |
type (K) | Land | BonusAgreementType |
description | Bezeichnung | |
responsible | Zuständiger Mitarbeiter | ResponsiblePartner |
supplier | Lieferant, nur alternativ zur Lieferantenbonus-Klassifikation | SupplierPartner |
supplierType | Partnerverwendung | |
supplier Classification |
Lieferantenbonus-Klassifikation, nur alternativ zum Lieferanten | Supplier BonusClassification |
currency | Währung | Currency |
payee | Abrechnungspartner | PayeePartner |
maintainingOrganization | Beschaffungsorganisation | Maintaining Organization |
agreementBeginn | Abrechnungszeitraum (von) | |
agreementEnd | Abrechnungszeitraum (bis) | |
paymentDueDate | Fälligkeit |
4.2 Bonusstufen
Attributpfad | Bezeichnung | Fremdschlüssel-Beziehung |
BonusAgreement Details.level (K) |
Stufe | |
BonusAgreement Details.salesTarget |
Umsatz
· aufsteigend entsprechend der Stufe · nur bei Umsatzbonus |
|
BonusAgreement Details.sales IncreasePercent |
Steigerung
· aufsteigend entsprechend der Stufe · nur bei Umsatzbonus |
|
BonusAgreement Details. bonusPercent |
Bonus-Prozentsatz |
4.3 Ein- bzw. Ausschlüsse von Artikelbonus-Klassifikationen
Attributpfad | Bezeichnung | Fremdschlüssel-Beziehung |
BonusAgreement Exclusions. itemHierarchy (K) |
Ein- oder ausgeschlossene Artikelbonus-Klassifikation | ItemBonusHierarchy |
4.4 Zu berücksichtigende Beschaffungsorganisationen
Attributpfad | Bezeichnung | Fremdschlüssel-Beziehung |
BonusAgreement Organization Assignments. invoicingParty (K) |
Zu berücksichtigende Beschaffungsorganisationen | InvoicingPartyPartner |