Import- / Exportvorlage > Modul Verkauf > Import- / Exportvorlage SOH (Verkaufsaufträge) 

Der Auftragsimport ermöglicht die Anlage neuer Aufträge oder den Import von Änderungen bereits im System vorhandener Aufträge.
Falls erforderlich, können Sie auch bestimmte Zeilen löschen, ohne dass der Auftrag selbst gelöscht wird. Das bedeutet, dass mindestens eine Auftragszeile vorhanden sein muss.

Der Import von Kontrakten wird nicht im Standard verwaltet.

Ein Verkaufsauftrag besteht aus einer Kopfzeile und mehreren Zeilen. Die wichtigste zu parametrisierende Datei ist immer die Datei SORDER (Auftragskopfzeile), weil diese mit dem Objekt SOH verbunden ist.

Bei der Anlage von Aufträgen müssen Sie daher zwei Identifikatoren parametrisieren:

  • einen für die Datei Kopfzeile SORDER,
  • einen für die Datei Detail SORDERQ.

Bei einem Änderungsimport erfolgt die Prüfung, ob das Hauptobjekt vorhanden ist, automatisch mit dem Hauptschlüssel, der die Auftragsnummer (SOHNUM) ist. Ob die Detailzeilen existieren, wird auf drei Arten geprüft, je nachdem, ob die Zeilennummer des Auftrags in der Importvorlage enthalten ist:

  • Suche anhand der Zeilennummer (SODLIN), falls diese parametrisiert und belegt ist. Wird eine Zeile gefunden, so wird diese geändert, sonst wird eine neue Zeile angelegt.
  • Suche anhand der Artikelreferenz und dem Versanddatum, wenn die zwei Felder parametrisiert und angegeben sind. Wird eine Zeile gefunden, so wird diese geändert, sonst wird eine neue Zeile angelegt.
  • Suche anhand der Artikelreferenz, sofern das Feld parametrisiert und belegt ist. Wird eine Zeile gefunden, so wird diese geändert, sonst wird eine neue Zeile angelegt.

SEEINFO Werden zwei Zeilen mit derselben Artikelreferenz (und demselben Versanddatum) gefunden, muss zur Unterscheidung die Zeilennummer parametrisiert werden. Andernfalls wird stets die erste den Kriterien entsprechende Zeile verarbeitet.

Der Auftragsimport verarbeitet das Löschen einer Detailzeile. Eine Auftragszeile wird gelöscht, wenn sie mit einer bestellten Menge Null importiert wird. Ein Auftrag kann nicht vollständig gelöscht werden. Es muss mindestens eine Zeile vorhanden sein.

Bei einem Import können Sie auch angeben, ob die Auftragszeile saldiert werden muss oder nicht. In der Vorlage muss dann das Feld SOQSTA hinzugefügt werden.

Beim Import einer großen Anzahl an Datensätzen kann die Verarbeitungszeit erheblich sein.
Diese Zeit kann mithilfe von Lösungen zur Leistungsverbesserung reduziert werden.
Diese Lösungen sehen wie folgt aus:

  • Umsetzung eines Mechanismus zur Deaktivierung der Verwaltung von Feldern, die nicht in der Importvorlage vorhanden sind.
    Weitere Informationen finden Sie im Abschnitt: Leistungsverbesserung beim Import.
  • Ablehnung von Datensätzen mit mehreren Rechtsordnungen für alle Rechtsordnungen des Ordners.
    Beispiel: es werden die Rechtsordnungen FRA, POR und USA in einem Ordner verwendet. Haben die Rechtsordnungen FRA und POR die gleiche Parametrisierung, wird empfohlen, einen Datensatz für die Rechtsordnung FRA und einen Datensatz für die Rechtsordnung POR anzulegen, anstatt nur einen einzigen Datensatz für alle Rechtsordnungen zu haben.

    Weitere Informationen zur Leistungsverbesserung im Zusammenhang mit Multi-Rechtsordnung und die Liste der Objekte, die Sie nach Rechtsordnung ablehnen können, entnehmen Sie dem folgenden Dokument: Liste der Multi-Rechtsordnung-Objekte.
Import der Rechnungsbedingungen

Ist in der Importvorlage eine Rechnungsbedingung in der Kopfzeile oder der Zeile vorhanden, wird diese Bedingung für die Berechnung der offenen Posten zur Fakturierung der Zeilen zu nicht lieferbaren Artikeln verwendet. Diese Regel gilt nur für Aufträge der Kategorie Normal.

Vertriebsstücklisten und Stücklisten importieren

Vertriebsstücklisten und Stücklisten können auf zwei Arten importiert werden.

  • Fall 1: Das Feld LINTYP ist nicht in der Vorlage vorhanden. In diesem Fall muss lediglich das Erzeugnis importiert werden (die Komponenten werden nicht als zur Vertriebsstückliste oder zu Stückliste gehörig angesehen, sondern wie klassische Artikel verwaltet). Der Import des Erzeugnisses zieht die automatische Generierung sämtlicher durch die erste Variante definierter Komponenten nach sich. Komponenten vom Typ Option oder Variante werden für die erste Option und die erste Variante ebenfalls generiert.
  • Fall 2: Das Feld LINTYP ist in der Vorlage vorhanden. In diesem Fall zieht der Import des Erzeugnisses nicht die automatische Komponentengenerierung nach sich. Die Komponentenzeilen müssen unter Angabe des entsprechenden LINTYP-Wertes importiert werden. Es ist in diesem Fall also möglich, zu Vertriebsstücklisten oder Stücklisten mit Optionen oder Varianten die gewählten Komponenten anzugeben.
Import von ASCII-Texten:

Sofern dies notwendig ist, können Texte für die Auftragskopfzeile, die Auftragsfußzeile und die Auftragszeilen importiert werden. Dies kann über die globale Variable GIMP im Importmodell parametrisiert werden (Erwähnung der *71-Felder im Modell).

  • Mit GIMP(71,...,78) werden Texte für die Auftragskopfzeile importiert. Sie können einen 8*100 (also 800) Zeichen langen Text importieren.
  • Mit GIMP(81,...,88) werden Texte für die Auftragsfußzeile importiert.
  • Mit GIMP(91,...,98) werden Texte für die Auftragszeilen importiert.
Import der Dimensionen der Zeile

Siehe Importvorlage SOHFL.

Import der Rechnungselemente

Der Erfassungswert der Rechnungselemente kann in den verschiedenen Dokumenten über die Felder INVDTAAMT importiert werden (SQH, SOH, SDH).

Import des Projektcodes und Auswirkung auf die Preise und Nachlässe
  • Verwaltung des Projektcodes:

    Die Single-Projekt- und Multiprojektverwaltung der Dokumente muss unterschieden werden. Die Verwaltungsmodalität wird vom Parameter PJTNSGDOC - Ein Projekt pro Dokument (Kapitel TC, Gruppe PRP) festgelegt.

    1/ Single-Projektverwaltung der Dokumente:

    Importvorlage mit
    dem Projektcode...

    Verwaltung des Projektcodes
    im Auftrag

    ... in der Kopfzeile

    ... in der Zeile

    Bei der Anlage

    Bei der Änderung

    JA

    NEIN

    Kopfzeile = Wert der Importdatei Kopfzeile
    Zeile = Wert der Kopfzeile

    JA

    JA

    Kopfzeile = Wert der Importdatei Kopfzeile
    Zeile = Wert der Importdatei Zeile
    oder Wert der Kopfzeile, wenn sich der Wert der Zeile von der Kopfzeile unterscheidet, + Meldung

    NEIN

    JA

    Kopfzeile = leerer Wert
    Zeile = leerer Wert (+ Meldung, falls versucht wird,
    einen nicht leeren Projektcode zu importieren)

    Kopfzeile = Nicht geänderter Wert
    Zeile = Nicht geänderter Wert (+ Meldung,
    falls versucht wird, einen anderen Projektcode zu importieren)



    2/ Multi-Projektverwaltung der Dokumente:

    Importvorlage mit
    dem Projektcode...

    Verwaltung des Projektcodes
    im Auftrag

    ... in der Kopfzeile

    ... in der Zeile

    Bei der Anlage

    Bei der Änderung

    JA

    NEIN

    Kopfzeile = Wert der Importdatei Kopfzeile
    Zeile = Wert der Kopfzeile

    Kopfzeile = Wert der Importdatei Kopfzeile
    Zeile = Nicht geänderter Wert

    JA

    JA

    Kopfzeile = Wert der Importdatei Kopfzeile
    Zeile = Wert der Importdatei Zeile

    NEIN

    JA

    Kopfzeile = leerer Wert
    Zeile = Wert der Importdatei Zeile

    Kopfzeile = Nicht geänderter Wert
    Zeile = Wert der Importdatei Zeile


  • Einfluss auf die Preise und Nachlässe

    Während des Imports erfolgt keine Neuberechnung der Preise und Nachlässe. Das Verhalten unterscheidet sich, je nach dem ob der Preis in der Importdatei angegeben ist oder nicht:

    1 / Der Preis ist nicht in der Datei angegeben:
    - Bei der Anlage stammt der Preis aus der Preissuche, die auf dem Projektcode des Angebots beruht.
    - Bei der Änderung wird der Preis nicht neu berechnet.

    2/ Der Preis ist in der Importdatei angegeben: der Preis entspricht sowohl bei der Anlage als auch bei der Änderung dem in der Importdatei angegebenen Preis.

Erforderliche Vorlagenfelder

Es müssen mindestens folgende Informationen importiert werden:

  • Der Kundencode (BPCORD)
  • Der Artikelcode (ITMREF)
  • Die Menge (QTY). Ist die Einheit nicht angegeben, wird standardmäßig die Verkaufseinheit des Artikels verwendet.
    Wird die Einheit bei einem Änderungsimport geändert, wird diese nicht berücksichtigt und die importierte Änderungsmenge entspricht der in der Auftragsposition vorhandenen Einheit.
    Um einen Import mit Einheitenänderung durchzuführen, müssen Sie zunächst die Position löschen.

Leistungsverbesserung beim Import

Während eines Standardimports simuliert die Verarbeitung den interaktiven Modus und führt alle Aktionen aus, die mit allen erfassbaren Feldern der Masken der Funktion Aufträge verbunden sind. So werden auch die nicht in der Importvorlage vorhandenen Felder verwaltet und die damit verbundenen Aktionen ausgeführt. Die Verarbeitungszeit kann in diesem Fall erheblich sein.

Um die Leistung zu verbessern, ist es möglich, einen Mechanismus einzurichten, um die Verwaltung von Feldern, die nicht in der Importvorlage vorhanden sind, während der gesamten Verarbeitungszeit zu deaktivieren.
Dieser Mechanismus basiert auf der Verwendung einer für Importe dedizierten Erfassungstransaktion und einer personalisierten Vorlage, die mit dieser Transaktion übereinstimmt.
Dieser Mechanismus erfordert Maßnahmen in Bezug auf die folgenden Elemente:

  • Importvorlage
  • Objekt
  • Erfassungstransaktion
  • Fenster der Erfassungstransaktion
  • Verarbeitung

Gehen Sie hierzu wie folgt vor:

1.Legen Sie eine Vorlage an, die nur die benötigten Felder enthält.
Diese Vorlage heißt z.B. SOHIMP: sie enthält nur die Felder, die nicht von der Erfassungstransaktion deaktiviert werden können oder die nicht von einer anderen Funktion initialisiert werden können, wie Verkaufsstandort, Kundenauftrag und Bestellmenge.

2.Legen Sie eine Erfassungstransaktion an deren erfassbare Felder den Felder der Vorlage entsprechen.
Zum Beispiel die Transaktion IMP.

3.Duplizieren Sie das Datenbankobjekt SOH.
Das duplizierte Objekt heißt z.B. SOHIMP. Benennen Sie in diesem neuen Objekt den Code jeder der Masken SOH1 bis SOH4 um, damit dieser Code mit dem der neu angelegten Erfassungstransaktion übereinstimmt.
In unserem Beispiel muss der Maskencode SOH1 in WK2IMP1, SOH2 in WK2IMP2, etc. umbenannt werden.

4.Ändern Sie die neue Vorlage, um den Objektcode SOH durch den neuen Objektcode SOHIMP zu ersetzen.

5.Ändern Sie das Fenster der Erfassungstransaktion, um es dem neuen Objektcode zuzuordnen.
In unserem Beispiel handelt es sich dabei um das Fenster WOSOHIMP. Ersetzen Sie den Objektcode SOH durch den Code SOHIMP.
Diese Änderung muss jedes Mal ausgeführt werden, wenn die Erfassungstransaktionen erneut freigegeben werden. Tatsächlich führt diese Freigabe zur erneuten Anlage der Fenster und zur automatischen erneuten Zuordnung des ursprüngliche Objektcodes.

6.Legen Sie die Verarbeitung des neuen Objekts wie folgt an (in unserem Beispiel handelt es sich um die Verarbeitung SUBSOHIMP):

$ACTION
Gosub ACTION From SUBSOH
Retoure

Fehlermeldungen

Während der Erfassung können außer den generischen Meldungen folgende Fehlermeldungen auftreten: :

Beim Auftragsimport werden alle Prüfungen durchgeführt, die auch bei der interaktiven Erfassung durchgeführt werden. Im Folgenden werden die wichtigsten Prüfungen aufgeführt:

Verkaufsstandort nicht vorhanden

Meldung nach der Prüfung des Verkaufsstandorts zum Auftrag.

Versandstandort nicht vorhanden

Meldung nach der Prüfung des Versandstandorts zum Auftrag.

Kunde XXX Datei nicht vorhanden

Meldung nach der Prüfung auf Existenz des Kunden.

Artikel YYY Datei nicht vorhanden

Meldung nach der Prüfung auf Existenz des Artikels und des Verkaufsartikels.

Einheit ZZZ Datei nicht vorhanden

Meldung nach der Prüfung auf Existenz und Gültigkeit der Artikeleinheit.

QTY Pflichtfeld

Meldung nach der Prüfung auf Existenz dieser Daten beim Import eines Auftrags.

Verwendete Tabellen

Diese Vorlage kann sowohl beim Import als auch beim Export verwendet werden. Die Daten werden in den folgenden Tabellen aktualisiert :

Tabelle

Tabellentitel

BPADDRESS [BPA]

Adressen

BPARTNER [BPR]

Personenkonten

BPCUSTMVT [MVC]

Kundenbewegungen

BPCUSTOMER [BPC]

Kunden

BPDLVCUST [BPD]

Leistungsempfänger

CPTANALIN [CAL]

Kostenrechnungsbuchungszeilen

FACILITY [FCY]

Standorte

ITMBPC [ITU]

Artikel - Kunden

ITMCATEG [ITG]

Artikelkategorie

ITMFACILIT [ITF]

Artikel - Standorte

ITMMASTER [ITM]

Artikel

ITMMVT [ITV]

Artikel-Standort gesamt

ITMSALES [ITS]

Artikel - Verkauf

ITMWRH [ITW]

Artikel - Lager

PRICSTRUCT [PRS]

Preisstruktur (Kunde / Lief)

SALESREP [REP]

Vertreter

SORDER [SOH]

Verkaufsaufträge - Kopfzeile

SORDERP [SOP]

Verkaufsaufträge - Preise

SORDERQ [SOQ]

Verkaufsaufträge - Mengen

SPRICLINK [SPK]

Suche Verkaufspreise (Link)

SPRICLIST [SPL]

Kundenpreis

SQUOTED [SQD]

Detail Angebot

SVCRFOOT [SVF]

Vertriebsdokument - Fußzeilenelement

SVCRVAT [SVV]

Vertriebsdokument - Steuern

TABCUR [TCU]

Währungstabelle

TABMODELIV [TMD]

Lieferartentabelle

TABPRTMOD [TPM]

Tabelle Druckvorlagen

TABSOHTYP [TSO]

Auftragsartentabelle

TABUNIT [TUN]

Einheitentabelle

WAREHOUSE [WRH]

Lager