====== Import von Artikelstammdaten ======
Artikelstammdaten bestehen aus Daten, die in unterschiedlichen Tabellen gespeichert werden:
  * Artikeldaten
  * Artikeltexte
  * Übersetzungen
  * Einkaufspreise
  * Verkaufspreise
  * Verpackungen

Die Schritte beim Artikelimport sind folgende:

  - [[api:genenic:stammdaten:artikel#Erstellung und Speicherung der Importdatei|]]
  - [[api:genenic:stammdaten:artikel#Übernahme in mercaware vorbereiten|]]
  - [[api:genenic:stammdaten:artikel#Kontrolle und Überarbeitung der übernommenen Daten|]]
  - [[api:genenic:stammdaten:artikel#Anlagen der Artikelstammdaten|]]

===== Erstellung und Speicherung der Importdatei =====
Die Übernahmedatei besteht im bestenfalls in einem csv-Format oder eine durch Trennzeichen separierte Datei. In der ersten Zeile steht das Feld, in das der Wert übernommen werden soll. Bitte beachten Sie folgende Punkte:
  * Pflichtfelder müssen vollständig übernommen gefüllt werden
  * Daten, denen eine separate Tabelle hinterlegt ist, wie z.B. Mengeneinheit, muss in der dazugehörigen Einheitstabelle vorhanden sein

<note tip>Die Übernahmedatei muss im Import-Verzeichnis in mercaware abgespeichert werden. Der Serverpfad lautet /opt/mercaware/mx001/import/ *

* Das Verzeichnis kann je nach Installation variieren. Bei mehreren Mandanten muss ggf. "mx001" durch eine andere Mandantennummer (z.B. mx002) ersetzt werden.
</note>

<note warning>Damit die Datensätze zum Import zugeordnet werden können, muss die Importnummer angegeben werden. Deshalb muss vor dem finalen abspeichern der Datei die Importnummer in eine Spalte mit der Überschrift //atrinr// übernommen werden.</note>

===== Übernahme in mercaware vorbereiten =====
{{:api:genenic:artikelimport_vorbereiten.png?600|}}

==== Import-Nr. ====
Die Importnummer kann manuell vorgegeben werden. Wenn dieses Feld leer ist

==== Status ====
Der Status kann 3 Zustände haben:
  - **Erfasst:** Die Daten wurden noch nicht übernommen oder die Daten wurden erfolgreich übernommen, aber noch nicht bearbeitet:
  - **in Arbeit:** Die Daten wurden übernommen und ganz oder teilweise verändert
  - **erledigt:** Die Daten wurden vollständig als Artikel angelegt

==== Datum ====
Hier wird das Datum eingetragen, an dem die Daten übernommen werden. 

==== Datei ====
Geben Sie in diesem Feld den Dateinahmen an. Bitte beachten Sie, dass der Dateiname inkl. der Dateiendung angegeben werden muss.

==== Separator ====
Geben Sie das Trennzeichen an, mit dem die Informationen voneinander getrennt wurden.

==== Kennzeichen Testaufruf ====
Wenn dieses Kennzeichen aktiviert wurde, wird die Datenübernahme simuliert. Sie erhalten die Rückmeldung, ob der Datenimport erfolgreich verlaufen würde oder nicht.

==== Import Artikeldaten ====
Mit der Funktion //Import Artikeldaten// werden die Daten in die Sub-Tabelle Artikelimport übernommen. Wenn die Datei fehlerhaft ist, erhalten Sie eine Meldung mit dem Hinweis auf die Ursache.

===== Kontrolle und Überarbeitung der übernommenen Daten =====
Mit Doppelklick in das Fenster Artikelimport können Sie die Datensätze sehen, die übernommen wurden. Sie können die Datensätze ändern (Bestätigung mit F2), Datensätze manuell hinzufügen (Hinzufügen mit F1) oder Datensätze löschen (Löschen mit F3).

{{:api:genenic:artikelimport-1.png?600|Artikelimport Register "Import Artikelstammdaten"}}

{{:api:genenic:artikelimport-2.png?600|Artikelimport Register "Erweitert"}}


===== Anlegen der Artikelstammdaten =====
Mit Klick auf die Funktion //Artikel anlegen// werden die Artikel inkl. der dazu notwendigen Tabellen angelegt. Bitte beachten Sie, dass die Anlage der Artikel nicht rückgängig gemacht werden kann, nachdem diese Funktion ausgeführt wurde.