In diesem Dokument werden die Vorgehensweisen für den Umgang mit der Anwendung „Daten importieren“ bezogen auf Eingangsrechnungen beschrieben. Diese Vorgehensweisen enthalten allgemeine Anleitungsschritte und welche Besonderheiten zu berücksichtigen sind. 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 Allgemeines
Der Import der Eingangsrechnung 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. Des-halb ist sinnvoll, für den Export und Import separate Filter festzulegen.
1:1-Beziehungen basieren im Datenmodell in der Regel auf einem technischen GUID-Attribut. Je nach Anwendungsfall kann beim Import entweder das technische GUID-Attribut verwendet werden oder der fachliche Schlüssel aus dem Ziel-Objekt (meist code oder number).
Bestimmte Daten der Eingangsrechnungen wie Hauswährungswerte, Status sowie interne Hilfsattribute können nicht importiert werden.
Weitere Informationen finden Sie im Kapitel „Übersicht: Attribute“.
Wenn Sie sich nicht sicher sind, welches das geeignete Format der Importdatei ist, dann gehen Sie wie folgt vor: Erfassen Sie über die Anwendung „Eingangsrechnungen“ einen Beispiel-Beleg und exportieren Sie diesen 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 werden ignoriert, wenn sie im aktuellen Kontext nicht übernommen werden können. Ebenso wird bei der Vorschlagswertermittlung die gleiche Logik durchlaufen, sodass sich Import und Anwendung identisch verhalten. Gleiches gilt für die Prüfungen.
2 Vorgehensweise: Eingangsrechnungen importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für dieses Business Object anzeigen: cisag.app.purchasing.obj.SupplierInvoice
- Der Filter für den Import von Eingangsrechnungen wird angezeigt.
- Duplizieren oder erfassen Sie bei Bedarf einen neuen Filter für dieses 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.
3 Neue Eingangsrechnung importieren
Die minimal notwendigen Attribute pro Basisobjekt:
Attribut-Bezeichnung | Attribut |
Beschaffungsorganisation
(in Single-Site-Systemen mit deaktivierten inhaltsbezogenen Berechtigungen ist das automatisch der Mandant) |
invoiceRecipient |
Eingangsrechnungsart | Type |
Rechnungssteller | SupplierPartner |
Fremdbelegnummer | invoice |
Fremdbelegdatum | invoiceDate |
Optional können Sie mithilfe des Imports auch die Nummer (number) übergeben. In diesem Fall wird die über den Nummernkreis gemäß Art ermittelte Nummer ignoriert. Zudem muss über geeignete Konventionen dafür gesorgt werden, dass die über den Import vergebene Nummer nicht mit einer bereits vergebenen oder zukünftig automatisch zu vergebenen übereinstimmt.
Die minimal notwendigen Attribute pro Positionsobjekt:
Attribut-Bezeichnung | Attribut |
Fremdbelegposition | supplierInvoiceDetailNumber |
Artikel | Item |
Gesamtmenge | totalQuantity |
Nettobetrag | netAmount |
Optional können Sie mithilfe des Imports einer Position auch eine Nummer (number) mitgeben.
Ein entsprechendes Minimal-XML mit fachlichen Attributen, zwei Positionen und mit Bezug zu einer Beschaffungsauftragsposition hat z. B. den folgenden Inhalt:
<?xml version=”1.0″ encoding=”UTF-8″?>
<semiramis xmlns=”com.cisag.app.purchasing.obj.SupplierInvoice” xsi:schemaLocation=”com.cisag.app.purchasing.obj.SupplierInvoice SupplierInvoice.xsd” created=”2005-01-05T15:45:21.861Z” locale=”en-US-XMLSchemaCompliant” xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”>
<SupplierInvoice xmlns=”com.cisag.app.purchasing.obj.SupplierInvoice”>
<invoice>34534534</invoice>
<invoiceDate>2005-01-04T23:00:00.000Z</invoiceDate>
<InvoiceRecipient>00000</InvoiceRecipient>
<Type>100</Type>
<SupplierPartner>70000</SupplierPartner>
<Details>
<supplierInvoiceDetailNumber>1</supplierInvoiceDetailNumber>
<Item>4711</Item>
<totalQuantity>
<amount>10.000000</amount>
<Uom>Stk</Uom>
</totalQuantity>
<netAmount>
<amount>58.650000</amount>
<Currency>EUR</Currency>
</netAmount>
<OrderAssignments>
<invoicedQuantity>
<amount>10.000000</amount>
<Uom>Stk</Uom>
</invoicedQuantity>
<netPrice>
<amount>58.650000</amount>
<Currency>EUR</Currency>
</netPrice>
<PurchaseOrderDetail>
<number>7</number>
<subNumber>0</subNumber>
</PurchaseOrderDetail>
<PurchaseOrder>
<number>BA00780</number>
<Type>100</Type>
</PurchaseOrder>
</OrderAssignments>
</Details>
<Details>
<supplierInvoiceDetailNumber>2</supplierInvoiceDetailNumber>
<Item>4712</Item>
<totalQuantity>
<amount>20.000000</amount>
<Uom>Stk</Uom>
</totalQuantity>
<netAmount>
<amount>58.650000</amount>
<Currency>EUR</Currency>
</netAmount>
<OrderAssignments>
<invoicedQuantity>
<amount>20.000000</amount>
<Uom>Stk</Uom>
</invoicedQuantity>
<netPrice>
<amount>58.650000</amount>
<Currency>EUR</Currency>
</netPrice>
<PurchaseOrderDetail>
<number>8</number>
<subNumber>0</subNumber>
</PurchaseOrderDetail>
<PurchaseOrder>
<number>BA00780</number>
<Type>100</Type>
</PurchaseOrder>
</OrderAssignments>
</Details>
</SupplierInvoice>
</semiramis>
Die restlichen Attribute werden in diesem Beispiel über die Vorschlagswerte gemäß Stammdaten etc. hinzugefügt.
Sie können darüber hinaus weitere Werte importieren und statt der fachlichen Attribute auch technische verwenden. Eine Auflistung der Attribute finden Sie im Kapitel „Übersicht: Attribute“.
4 Besonderheiten bei der Bearbeitung einer vorhandenen Eingangsrechnung
Bei der Bearbeitung einer vorhandenen Eingangsrechnung müssen Sie Folgendes beachten: Beim Importieren von Eingangsrechnungen in Multi-Site-Systemen und Single-Site-Systemen mit aktivierten inhaltsbezogenen Berechtigungen wird zwingend eine Beschaffungsorganisation benötigt. Beim Bearbeiten einer vorhandenen Eingangsrechnung ergibt sich die Beschaffungsorganisation immer aus dem in der Datenbank gespeicherten Beleg. Eine evtl. abweichende Beschaffungsorganisation in der Import-Quelle wird also in diesem Fall ignoriert.
Für das Auffinden einer in der Datenbank gespeicherten Eingangsrechnung wird entweder seine technische Identifikation (SupplierInvoice:guid) oder seine fachliche Identifikation (SupplierInvoiceType [oder type] und number) benötigt.
Bei den Positionen können sämtliche Möglichkeiten des Imports – also insbesondere auch Löschen – verwendet werden. Auch dafür wird für das Auffinden einer gespeicherten Position entweder die technische Identifikation (SupplierInvoiceDetail:guid) oder die fachliche Identifikation (number) benötigt.
Änderungen über den Import sind nur dann möglich, wenn keine Prüfung dies verhindert.
5 Ü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 zudem über ein (K) gekennzeichnet.
5.1 Basisdaten
5.1.1 Eingangsrechnung (SupplierInvoice)
Attribut | Beziehung | Erläuterung |
addressData
· addressData.city · addressData. · addressData. · addressData. · addressData. · addressData. · addressData. · addressData. · addressData. |
Country
Region |
Adressdaten
· Ort · PLZ · Land · Landkreis · Postfach · Postfach-Ort · Postfach-PLZ · PLZ · Region · Straße |
consignment WithdrawalNotice |
Consignment WithdrawalNotice |
Konsignations-Entnahmemeldung |
currency | Currency | Währung |
date | Eingangsdatum | |
esrCode | ESR-Nummer | |
exchangeRate | Kurs | |
grossAmount
· grossAmount. · grossAmount. |
Currency |
Bruttobetrag
· Betrag · Währung |
guid (K) | Technische Identifikation für die Änderung/ Löschung bereits gespeicherter Daten – sofern bekannt. |
|
invoice | Fremdbelegnummer | |
invoiceDate | Fremdbelegdatum | |
invoiceRecipient | InvoiceRecipient | Beschaffungsorganisation |
number (K) | Nummer (fachliche Identifikation), optional bei Neuerzeugung – wird sonst automatisch ermittelt.
Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
|
outputSettings.invoice
· medium · mediumAddress |
Ausgabeeinstellungen Eingangsrechnung
· Medium · Kommunikationsverbindung |
|
paymentMethod | PaymentMethod | Zahlungsart |
paymentTerms | PaymentTerms | Zahlungsbedingungen |
purchaseOrder | PurchaseOrder | Beschaffungsauftrag |
responsible | ResponsiblePartner | Zuständiger Mitarbeiter |
stopPayment | Zahlsperre | |
supplier | SupplierPartner | Rechnungssteller |
supplierName | Name | |
taxDate | Leistungsdatum | |
taxDueDate | Steuerdatum | |
taxDueMonth.value | Steuermonat, Wert | |
taxRegister | TaxRegister | Steuer-Register |
text | Notiz
(nur für Rechnungen des Typs „Eingangsrechnung ohne Belegbeziehung“) |
|
type (K) | Type | Eingangsrechnungsart (fachliche Identifikation):
Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
valuationDate | Valutadatum |
5.1.2 Eingangsrechnung-Lieferschein-Zuordnung (DeliverySlipAssignments)
Attribut | Beziehung | Erläuterung |
deliverySlip | Lieferscheinnummer |
5.2 Positionsdaten (Details)
5.2.1 Eingangsrechnungsposition (SupplierInvoiceDetail)
Attribut | Beziehung | Erläuterung |
account | Account | Konto |
accountOriginType | Kontoherkunft | |
bonusAutoCalc | Bonus-Berechnungsbasis bearbeiten/nicht bearbeiten | |
bonusBase
· bonusBase.amount · bonusBase.currency |
Currency |
Bonus-Berechnungsbasis (nur für Rechnungen der Typen „Eingangsrechnung“ oder „Zusatzkostenrechnung“) |
bonusRelevant | Bonus (nur für Rechnungen des Typs „Eingangsrechnung ohne Belegbeziehung“) | |
cashDiscountBaseAutoCalc | Skonto-Berechnungsbasis bearbeiten/nicht bearbeiten | |
cashDiscountBase
· cashDiscountBase.amount · cashDiscountBase.currency |
Currency |
Skonto-Berechnungsbasis
· Betrag · Währung |
deliverySupplier | DeliverySupplierPartner | Lieferpartner |
distributionType | Verteilung (nur für Verrechnungs-Artikel) | |
ean | Europäische Artikelnummer (EAN)
Weitere Informationen finden Sie in dieser Dokumentation: Belegposition mithilfe einer EAN importieren |
|
guid (K) | Technische Identifikation der Position | |
item | Item | Artikel |
netAmount
· netAmount.amount · netAmount.currency |
Currency |
Nettobetrag
· Betrag · Währung |
number (K) | Positionsnummer (fachliche Identifikation), optional bei Neuerzeugung – wird sonst automatisch ermittelt.
Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
|
pseudoItemDescription | Pseudo-Artikelbezeichnung (nur für Pseudo-Artikel) | |
redistributeAdditionalCost | Zusatzkosten erneut verteilen | |
supplierInvoiceDetailNumber | Fremdbelegposition | |
supplierItemNumber | Lieferanten-Artikelnummer
Weitere Informationen finden Sie in dieser Dokumentation: Belegposition mithilfe einer EAN importieren |
|
taxCode | TaxCode | Steuerschlüssel |
totalQuantity
· totalQuantity. · totalQuantity.uom |
Uom |
Gesamtmenge
· Menge · Mengeneinheit |
5.2.2 Auftragszuordnungen (OrderAssignments)
Zu jeder Eingangsrechnungsposition können beliebig viele Auftragspositionen mit den zugehörigen Mengen und Nettobeträgen zugeordnet werden, sofern die Eingangsrechnung zu einem der folgenden Rechnungstypen gehört:
- Eingangsrechnung
- Zusatzkostenrechnung
- Zusatzkostenrechnung für Verteilung
- Konsignationsentnahmerechnung
Damit eine Auftragsposition in der OLTP-Datenbank gefunden werden kann, müssen folgende Attribute aktiviert und mit Werten befüllt sein:
- In der Beziehung PurchaseOrder oder DistributionOrder die Attribute number und type (technisch) bzw. code (fachlich).
- In der Beziehung PurchaseOrderDetail oder DistributionOrderDetail die Attribute number und subNumber.
Falls eine Auftragsposition bereits einem Wareneingang zugeordnet ist oder eine Konsignationsentnahmerechnung vorliegt, dann kann die entsprechende Position ebenfalls gefunden werden, wenn die folgenden Attribute aktiviert und mit Werten befüllt sind:
- In der Beziehung ReceiptOfGoods oder ConsignmentWithdrawalNotice die Attribute number und type (technisch) bzw. code (fachlich).
- In der Beziehung ReceiptOfGoodsDetail die Attribute number und subNumber
- In der Beziehung ConsignmentWithdrawalNoticeDetail das Attribut
Zusätzlich müssen die anteilige Menge und der anteilige Nettobetrag der Eingangsrechnungsposition angegeben werden, auf die sich diese Auftragsposition bezieht.
Attribut | Beziehung | Erläuterung |
costDistribution | Kostenverteilung | |
guid (K) | Technische Identifikation der Auftragszuordnung | |
invoicedQuantity
· invoiced.Quantity.amount · invoiced.Quantity.uom |
Uom |
Anteil der Menge dieser Auftragsposition
· Menge · Mengeneinheit |
netPrice
· netPrice.amount · netPrice. |
Currency |
Anteil des Betrags dieser Auftragsposition
· Betrag · Währung |
orderDetail | PurchaseOrderDetail
oder DistributionOrderDetail |
Abhängig vom Rechnungstyp entweder eine Beschaffungsauftragsposition oder eine Verteilauftragsposition |
orderHeader | PurchaseOrder
oder DistributionOrder |
Abhängig vom Rechnungstyp entweder ein Beschaffungsauftrag oder ein Verteilauftrag |
receiptDetail | ReceiptOfGoodsDetail oder
ConsignmentWithdrawalNoticeDetail |
Abhängig vom Rechnungstyp entweder eine Wareneingangsposition oder die Position einer Konsignationsentnahmerechnung |
receiptHeader | ReceiptOfGoods oder
ConsignmentWithdrawalNotice |
Abhängig vom Rechnungstyp entweder ein Wareneingang oder eine Konsignationsentnahmerechnung |
5.2.3 Kostenrechnungsdaten (CostingData)
Über diese Beziehung können jeder Eingangsrechnungsposition, die zu einer Eingangsrechnung des Typs „Eingangsrechnung“ gehört, beliebig viele Kostenrechnungsdaten mit den zugehörigen Mengen und Nettobeträgen zugeordnet werden.
Mindestens eine Kostenstelle oder ein Kostenträger muss angegeben werden.
Attribut | Beziehung | Erläuterung |
costAmount
· costAmount. · costAmount. |
Currency |
Kostenbetrag
· Betrag · Währung |
costCentre | CostCentre | Kostenstelle |
costObjective | CostObjective | Kostenträger |
costQuantity
· costQuantity. · costQuantity.uom |
Uom |
Menge
· Betrag der Menge · Mengeneinheit |
guid (K) | Technische Identifikation der Kostenrechnungsdaten |
5.2.4 Zusatzkostenaufteilung (CostingInfos)
Über diese Beziehung können jeder Eingangsrechnungsposition, die zu einer Eingangsrechnung des Typs „Eingangsrechnung“ gehört, beliebig viele Aufteilungen der Zusatzkosten zugeordnet werden.
Attribut | Beziehung | Erläuterung |
assignedSupplierInvoiceDetail | AssignedSupplierInvoiceDetail | Eingangsrechnungsposition |
cost
· cost.amount · cost.currency |
Currency |
Nettobetrag
· Betrag · Währung |
costDistribution | Kostenverteilung | |
guid (K) | Technische Identifikation der Zusatzkostenaufteilung | |
orderDetail | PurchaseOrderDetail | Beschaffungsauftragsposition |
orderHeader | PurchaseOrder | Beschaffungsauftrag |
receiptDetail | ReceiptOfGoodsDetail | Wareneingangsposition |
receiptHeader | ReceiptOfGoods | Wareneingang |
5.3 Detailpositionsdaten (SubDetails)
5.3.1 Eingangsrechnungsposition (SupplierInvoiceDetail)
Attribut | Beziehung | Erläuterung |
account | Account | Konto |
accountOriginType | Kontoherkunft | |
deliverySupplier | DeliverySupplierPartner | Lieferpartner |
ean | Europäische Artikelnummer (EAN)
Weitere Informationen finden Sie in dieser Dokumentation: Belegposition mithilfe einer EAN importieren |
|
guid (K) | Technische Identifikation der Detailposition | |
item | Item | Artikel |
pseudoItemDescription | Pseudo-Artikelbezeichnung (nur für Pseudo-Artikel) | |
subNumber (K) | Positionsnummer der Detailposition (fachliche Identifikation), optional bei Neuerzeugung – wird sonst automatisch ermittelt.
Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
|
supplierInvoiceDetailNumber | Fremdbelegposition | |
supplierItemNumber | Lieferanten-Artikelnummer
Weitere Informationen finden Sie in dieser Dokumentation: Belegposition mithilfe einer EAN importieren |
|
taxCode | TaxCode | Steuerschlüssel |
totalQuantity
· totalQuantity. · totalQuantity.uom |
Uom |
Menge der Detailposition
· Menge · Mengeneinheit |
5.3.2 Auftragszuordnungen (OrderAssignments)
Die Attribute der Detailpositionen entsprechen denen der Positionsdaten, die in diesem Kapitel beschrieben sind: Auftragszuordnungen (OrderAssignments)
5.3.3 Kostenrechnungsdaten (CostingData)
Die Attribute der Detailpositionen entsprechen denen der Positionsdaten, die in diesem Kapitel beschrieben sind: Kostenrechnungsdaten (CostingData)