1 Themenübersicht
In dieser Dokumentation wird die Vorgehensweise für den Umgang mit der Anwendung „Daten importieren“ bezogen auf Vertriebsschnellerfassungsbelege 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“.
2 Allgemeines
Der Import eines Vertriebsschnellerfassungsbeleges 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.
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). Bei einigen Business Objects ist für die Umwandlung fachlicher Schlüssel zu technischem Schlüssel eine Organisation (Organisation) notwendig. Die jeweils relevante Organisation steht im Normalfall nicht direkt in der Import-Quelle, sondern ist über den Belegkontext vorgegeben. Weitere Informationen dazu finden Sie im Kapitel „Übersicht: Attribute“.
In der Basis eines Vertriebsschnellerfassungsbeleges werden Hash-Code-Business-Objects referenziert. Das sind fachlich zusammengehörende Attributgruppen, die für viele Belege immer wieder gleich sind und somit durch Wiederverwendung einigen Speicherplatz in der Datenbank und im Hauptspeicher sparen. Über eine spezielle Konvertierung stellen sich die Hash-Code-Business-Objects für den Export bzw. Import wie Parts dar.
Bestimmte Daten der Vertriebsschnellerfassungsbelege wie die Statusfelder sowie 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 „Vertriebsschnellerfassungsbelege“ 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.
Hinweis:
Bestehende Vertriebsschnellerfassungsbelege können durch den Import zusätzlicher Daten erweitert werden. Die bestehenden Daten werden sofern möglich durch die Importdaten ersetzt.
3 Vorgehensweise: Vertriebsschnellerfassungsbelege importieren
- Öffnen Sie die Anwendung „Daten importieren“.
- Lassen Sie sich den bzw. einen Filter für dieses Business Object anzeigen: cisag.app.sales.obj.SalesRapidDocument
- Der Filter für den Import von Vertriebsschnellerfassungsbelegen wird geöffnet.
- 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.
4 Ü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.
4.1 Basisdaten
4.1.1 Vertriebsschnellerfassungsbeleg (SalesRapidDocument)
Die Identifikation eines Vertriebsschnellerfassungsbeleges besteht aus einer Vertriebs-Schnellerfassungsbelegart und einer Nummer aus dem bei der Art hinterlegten Nummernkreis.
| Attribut | Beziehung | Erläuterung |
| afterTransfer | Nach Übernahme | |
| autoConfirmWarnings | Warnungen automatisch bestätigen | |
| customerData | Siehe dieses Kapitel: Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData) | |
| customerOrderData. purchaseOrder |
Fremdbelegnummer | |
| customerOrderData. date.value |
Fremdbelegdatum | |
| CustomerProposal. Type.code |
Vertriebs-Angebotsart
Hinweis: Wenn Sie Schnellerfassungsbelege für Vertriebsangebote importieren, dann hinterlegen Sie in diesem Attribut die zu verwendende Vertriebs-Angebotsart. |
|
| date | Erfassungsdatum | |
| deliveryCustomerData | Siehe dieses Kapitel: Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData) | |
| deliveryData | Siehe dieses Kapitel:
Lieferdaten (deliveryData) |
|
| discountOriginType | Rabattherkunft
Hinweis: Sie können Preisdaten nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen mit Belegpositionen kann dieses Attribut nur dann durch den Import geändert werden, wenn die Preise gemäß Belegart verzögert ermittelt werden. |
|
| discounts[0..3]
· discounts.discountType · value · code |
DiscountType |
Rabatte 1 bis 4
· Preis-Komponentenart · Menge, Preis, Prozent · Art Hinweis: Sie können Preisdaten nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. Für den Import von Rabatten muss zudem die Rabattherkunft auf „Manuell“ eingestellt sein. Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen mit Belegpositionen kann dieses Attribut nur dann durch den Import geändert werden, wenn die Preise gemäß Belegart verzögert ermittelt werden. |
| guid (K) | Technische Identifikation für die Änderung/ Löschung bereits gespeicherter Daten – sofern bekannt. |
|
| invoiceCustomerData | Siehe dieses Kapitel: Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData) | |
| invoicingData | Siehe dieses Kapitel: Rechnungsdaten (invoicingData) | |
| invoicingPartyData | Siehe dieses Kapitel: Vertriebsorganisationsdaten (invoicingPartyData) | |
| number (K) | Nummer (fachliche Identifikation)
Optional bei Neuerzeugung – wird sonst automatisch ermittelt. Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
|
| payee | PayeePartner | Zahlungspartner
Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen kann dieses Attribut durch den Import nur geändert werden, wenn noch keine Belegpositionen bestehen. |
| priceDate | Berechnungszeitpunkt
Hinweis: Sie können Preisdaten nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen mit Belegpositionen kann dieses Attribut nur dann durch den Import geändert werden, wenn die Preise gemäß Belegart verzögert ermittelt werden. |
|
| priceListing | PriceListing | Preis-Listung
Hinweis: Sie können Preisdaten nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen kann dieses Attribut durch den Import nur geändert werden, wenn noch keine Belegpositionen bestehen. |
| priceValidityDate | Bezugsdatum für Preisermittlung
Hinweis: Sie können Preisdaten nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen mit Belegpositionen kann dieses Attribut nur dann durch den Import geändert werden, wenn die Preise gemäß Belegart verzögert ermittelt werden. |
|
| pricingPartner Relation |
Partnerverwendung
Hinweis: Sie können Preisdaten nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen mit Belegpositionen kann dieses Attribut nur dann durch den Import geändert werden, wenn die Preise gemäß Belegart verzögert ermittelt werden. |
|
| requestDate.value | Wunschtermin | |
| RequestForProposal. Type.code |
Vertriebs-Anfrageart
Hinweis: Wenn Sie Schnellerfassungsbelege für Vertriebsanfragen importieren, dann hinterlegen Sie in diesem Attribut die zu verwendende Vertriebs-Anfrageart. |
|
| responsible | ResponsiblePartner | Zuständiger Mitarbeiter |
| SalesOrder.Type. code |
Vertriebs-Auftragsart
Hinweis: Wenn Sie Schnellerfassungsbelege für Vertriebsaufträge importieren, dann hinterlegen Sie in diesem Attribut die zu verwendende Vertriebs-Auftragsart. |
|
| salesRepresentatives[0:2] | SalesRepresentatives | Bis zu drei Vertreter |
| shippingDate | Versandtermin | |
| storageArea.warehouse | Lagerort
Hinweis: Sie können den Lagerort nur für Belege importieren, für die gemäß Belegart die Funktion „Lagerort verwenden“ aktiviert ist. |
|
| targetOrderType | Zielbelegtyp | |
| TextAssignments | Datei-Anhänge/Texte
Siehe dieses Kapitel: Texte (TextAssignments) |
|
| type (K) | Type | Art (fachliche Identifikation):
Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
4.1.2 Kundendaten (customerData, deliveryCustomerData, invoiceCustomerData)
Die Kundendaten in den drei Partnerrollen sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar. Das gleiche gilt für die Adressdaten.
Analog zu den technischen Attributnamen wurden die folgenden Part-Namen vergeben:
- customerData Kunde
- deliveryCustomerData Lieferempfänger
- invoiceCustomerData Rechnungsempfänger
Die folgenden Attribute bestehen also pro Rolle jeweils einmal.
| Attribut | Beziehung | Erläuterung |
| addressData.city | Adresse – Ort | |
| addressData.country | addressData.Country | Adresse – Land |
| addressData.district | Adresse – Distrikt | |
| addressData.poBox | Adresse – Postfach | |
| addressData. poBoxCity |
Adresse – Postfach Ort | |
| addressData. poBoxPostalCode |
Adresse – Postfach PLZ | |
| addressData. postalCode |
Adresse – Postleitzahl | |
| addressData.region | addressData.Region | Adresse – Region |
| addressData.street | Adresse – Straße | |
| customer | CustomerPartner | Kunde |
| name | Kundenname | |
| careOf | CareOfPartner | Zu Händen |
| careOfName | Zu Händen Name |
Im Unterschied zu vielen anderen Belegen können Sie beim Import von Vertriebsschnellerfassungsbelegen bereits bestehende Kundendaten auch dann ändern, wenn bereits Positionen vorhanden sind.
4.1.3 Lieferdaten (deliveryData)
Die Lieferdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.
Hinweis:
Sie können Lieferdaten nur für Belege importieren, für die gemäß Belegart die Funktion „Lieferkonditionen verwenden“ aktiviert ist.
| Attribut | Beziehung | Erläuterung |
| deliveryTerms | DeliveryTerms | Lieferbedingung |
| deliveryTermsLocation | Lieferbedingung
Ortsbezug |
|
| shippingTerms | ShippingTerms | Versandbedingung |
4.1.4 Rechnungsdaten (invoicingData)
Einige Rechnungsdaten sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.
| Attribut | Beziehung | Erläuterung |
| currency | Currency | Währung
Hinweis: Sie können die Währung nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen kann dieses Attribut durch den Import nur geändert werden, wenn noch keine Belegpositionen bestehen. |
| paymentMethod (Firma) | PaymentMethod | Zahlungsart
Hinweis: Sie können die Zahlungsart nur für Belege importieren, für die gemäß Belegart die Funktion „Zahlungskonditionen verwenden“ aktiviert ist. |
| paymentTerms (Firma) | PaymentTerms | Zahlungsbedingung
Hinweis: Sie können die Zahlungsart nur für Belege importieren, für die gemäß Belegart die Funktion „Zahlungskonditionen verwenden“ aktiviert ist. |
4.1.5 Vertriebsorganisationsdaten (invoicingPartyData)
Einige Daten der Vertriebsorganisation sind in der Datenbank als Hash-Code-Business-Object abgelegt und stellen sich für den Export/Import als Part dar.
| Attribut | Beziehung | Erläuterung |
| partner | Partner | Partner
Hinweis: Bei bestehenden Vertriebsschnellerfassungsbelegen kann dieses Attribut nicht durch den Import geändert werden. Daten in der Importdatei werden beim Import ignoriert. |
| careOf | CareOfPartner | Zu Händen |
| careOfName | Zu Händen Name |
4.1.6 Texte (TextAssignments)
| Attribut | Beziehung | Erläuterung |
| code | Textbaustein (optional) |
|
| document | Beleg | |
| sequence | Nummer | |
| text | Texte pro Sprache
(Wird nur verwendet, wenn kein Textbaustein angegeben wurde. Siehe dieses Kapitel: text) |
|
| type | Texttyp |
text
| Attribut | Beziehung | Erläuterung |
| contentType | Inhaltstyp | |
| language | Sprache | |
| text | Text |
Bei den Texten können Sie auch diverse Formatierungen verwenden. Benötigen Sie Beispiele für konkrete Formatierungen, dann erfassen Sie am besten einen Musterbeleg mit den gewünschten Textformatierungen und exportieren diesen.
Hinweis:
Normalerweise werden Texte aus der Importdatei importiert und evtl. Vorschlagswerte aus den Partner-Stammdaten usw. ignoriert. Hat die Server-Property com.cisag.app.general.order.bi.applyAllwaysTextDefaults den Wert true, dann werden in jedem Fall die Vorschlagswerte ermittelt und mit den ggf. in der Importdatei vorhandenen Texten kombiniert. Hierbei ist zum ei-nen zu beachten, dass die Nummern der Textzeilen passend gewählt sein müs-sen und dass zum anderen im Ergebnis nur eine Text-Zeile mit einem Artikel-text entsteht.
4.2 Vertriebsschnellerfassungsbelegpositionen (SalesRapidDocumentDetail)
| Attribut | Beziehung | Erläuterung |
| customerItemNumber | Kunden-Artikelnummer
Weitere Informationen finden Sie in dieser Dokumentation: Belegposition mithilfe einer EAN importieren |
|
| discounts[0..3]
· discounts.discountType · discounts.type · discounts.value · discounts.measure |
· DiscountType
· Measure.UOM · Measure.Currency |
Rabatte 1 bis 4
· Preis-Komponentenart · Art · Menge, Preis, Prozent · Einheit · Währung Hinweis: Sie können die Rabatte nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. |
| ean | Europäische Artikelnummer (EAN)
Weitere Informationen finden Sie in dieser Dokumentation: Belegposition mithilfe einer EAN importieren |
|
| grossPrice
· grossPrice.amount · grossPrice.currency |
Currency |
Bruttopreis
Hinweis: Sie können den Bruttopreis nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. Hinweis: Wird nur für Nicht-Endverbraucherbelege verwendet (siehe auch retailGrossPrice). |
| guid (K) | Technische Identifikation (Position) für die Änderung/Löschung bereits gespeicherter Daten – sofern bekannt. | |
| item | Item | Artikel |
| netCode | Keine Basisrabatte
Hinweis: Sie können das Attribut „Keine Basisrabatte“ nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. |
|
| number (K) | Nummer (fachliche Identifikation)
Optional bei der Neuerzeugung – wird sonst automatisch ermittelt. Pflicht, sofern bei Änderung/Löschung die guid nicht angegeben wurde. |
|
| noCashDiscount Enabled |
Kein Skonto
Hinweis: Sie können das Attribut „Kein Skonto“ nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. |
|
| noClassification Discounts |
Keine positionsübergreifenden Rabatte
Hinweis: Sie können das Attribut „Keine positionsübergreifenden Rabatte“ nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. |
|
| noOrderValue Discounts |
Keine Auftragswertrabatte
Hinweis: Sie können das Attribut „Keine Auftragswertrabatte“ nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. |
|
| priceDimension | Preisdimension
Hinweis: Sie können die Preisdimension nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. |
|
| priceOriginType | Preisherkunft
Hinweis: Sie können die Preisherkunft nur für Belege importieren, für die gemäß Belegart die Funktion „Preise verwenden“ aktiviert ist. |
|
| priceUom | PriceUom | Preiseinheit
Hinweis: Sie können die Preiseinheit nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. |
| pseudoItemDescription | Pseudo-Artikelbezeichnung
Hinweis: Nur für Pseudo-Artikel. Für alle anderen wird die Angabe ignoriert. |
|
| retailGrossPrice
· retailGrossPrice.amount · retailGrossPrice.currency |
Currency |
Bruttopreis inkl. Steuern
Hinweis: Sie können den Bruttopreis inkl. Steuern nur für Belege importieren, die Preise mit manueller Preisherkunft verwenden. Hinweis: Wird nur für Endverbraucherbelege verwendet (siehe auch grossPrice). |
| TextAssignments | Datei-Anhänge/Texte
Siehe dieses Kapitel: Texte (TextAssignments) |
|
| totalQuantity. amount |
Wert der Gesamtmenge | |
| totalQuantity.uom | Uom | Mengeneinheit der Gesamtmenge |
| uomObligation | Einheiten-Verbindlichkeit
Hinweis: Sie können die Einheiten-Verbindlichkeit nur importieren, wenn für den Mandanten in der Anwendung „Customizing“ die Funktion „Bestand in logistischen Einheiten führen“ aktiviert ist. |
|
| uomObligationOrigin | Herkunft Einheiten- Verbindlichkeit Hinweis: Sie können die Herkunft Einheiten-Verbindlichkeit nur importieren, wenn für den Mandanten in der Anwendung „Customizing“ die Funktion „Bestand in logistischen Einheiten führen“ aktiviert ist. |