CSV

mention®Connect - CSV - Schnittstelle - Funktionsumfang

• Import von Bestellungen aus CSV Dateien.
  • Individuelle Spaltenzuordnung für Versand-, Rechnungsadresse sowie Positionsdaten.
  • Optional Überwachung von Verzeichnissen, gespeicherte Dateien werden sofort nach Eintreffen verarbeitet. Für die Aktivierung muss bei 'Interv. Bestellungen' eine Zahl größer 0 eingetragen werden
  • Importieren von CSV-Dateien von einem SFTP- / FTP-Server (optional)
  • Manueller Import mit einem Dateiauswahl-Dialog.

• Export Versandbestätigungen als CSV-Datei
  • Ausgabe von Versandbestätigungen mit einem selbstdefinierten Format.
  • Achtung Spaltenüberschriften werden nicht exportiert
  • Für die Aktivierung muss innerhalb Upload-Intervall eine Zahl größer 0 eingetragen werden
• Einstellungen können importiert und exportiert werden.

• Export von Artikeldaten (seit dem 28.06.2018)
  • Formatierung der Ausgabe über XSLT
  • Export nach SFTP / FTP oder lokales Verzeichnis möglich
  • Derzeit mögliche Daten Netto, Brutto, Bestand, Artikelnummer (aranummer), EAN-Code (Products_ean), Name, herstellerName, ProductsStatus (Online / Offline)

Konfiguration

Einstellungen:

Feld	Bedeutung oder Verwendungszweck	Beispiel
Verz. Best.	Das zu überwachende Verzeichnis	Stellen Sie bitte sicher, dass Connect Schreibzugriff auf dieses Verzeichnis hat. Im automatischen Betrieb werden zu verarbeitende Dateien in ein Unterverzeichnis "Imported" verschoben, um sicher zu stellen, dass die Datei nicht ein weiteres Mal verarbeitet wird.
Datei Präfix	selbsterklärend	Es werden nur Dateien verarbeitet, die einem bestimmten Schema entsprechen. Hierbei handelt es sich um den vorangestellten Text. Beispiel 'order_*' (* als Platzhalter nicht vergessen), hierbei werden nur Dateien verarbeitet welche mit dem Text order_ beginnen.
Datei Extension	Dateiendung	Beispiel 'csv'
CSV-Datei	selbsterklärend	Wählen Sie hier eine Beispieldatei welche als Formatvorlage für das Einlesen der Bestellung dient. Nachdem die Datei ausgewählt wurde, werden die Zuordnungen generiert.
Spalten Trenner	Wertetrennung innerhalb der CSV Datei	Beispiel Inhalt ";" Nach einer Änderung des Trennzeichens werden die Zuordnungsdropdowns neu initialisiert, es kann vorkommen, dass Zuweisungen erneut vorgenommen werden müssen.
Text Qualifizierer	selbsterklärend	Es kommt vor, dass Textinhalte mit Anführungszeichen versehen sind.
Remote-Pfad	optional wenn Dateien von einem SFTP / FTP Server heruntergeladen werden sollen	sftp://username@example.com/Quell/Verzeichnis/ oder ftp://username@example.com/Quell/Verzeichnis/ wird die gefundenen Dateien in das Verzeihnis "Verz. Best." gespeichert. Hinweis Es wird für das Abrufen der Datei-Präfix wie auch die Dateierweiterung verwendet. Hierbei können auch Wildcards als Stern * verwendet werden, der Stern steht für ein beliebiges Zeichen.
Remote-Passwort	selbsterklärend	Wenn das Quellverzeichnis eine Passwort-Authentifizierung benötigt, ist hier das Passwort für den Remote-Pfad zu hinterlegen.
Zuordnung Bestellungen	selbsterklärend	Essentiell hierbei ist die Zuordnung der externen Bestellnummer, nach dieser Spalte werden die in der CSV-Datei enthaltenen Bestellpositionen gruppiert
Zuordnung Bestell-Positionen	selbsterklärend	Essentiell hierbei ist die Zuordnung der Artikelnummer in mention bzw. die EAN Nummer (ab mention®Connect 28.06.2018)
Versandstatus (Achtung: Idee und Spiel unterstützt keinen Versandstatus)	Definition der CSV-Datei für den Versandstatus	Fügen Sie neue Spalten mit der '+' Schaltfläche zu, sollte die Position nicht stimmen, kann diese über das grüne Viereck verschoben werden.
Artikel-Export	selbsterklärend	Über diese Einstellungen können Artikel in ein lokales Verzeichnis bzw. SFTP- oder FTP-Verzeichnis exportiert werden
Artikel exp.	Aktiv / Inaktiv	Ist die Einstellung aktiv, werden automatisch Artikelexporte ausgeführt (Voraussetzung: in Upload-Intervall wurde ein Zeitintervall hinterlegt)
Wohin	Aktiv / Inaktiv	Zielpfad Beispiel sftp://username@example.com/ziel/verzeichnis/catalog.csv oder sftp://username@example.com/ziel/verzeichnis/catalog.csv Es werden auch Datums-Platzhalter berücksichtigt. Zum Beispiel: catalog_{DateTime.Now.ToString("yyyy-MM-dd-hhmmss")}.csv Hinweise zur Datumsformatierung finden sie unter: https://docs.microsoft.com/de-de/dotnet/standard/base-types/custom-date-and-time-format-strings

Artikel-XSLT (Hinweis: Es wird nur xslt 1.0 unterstützt):

<xsl:stylesheet xmlns:xsl='http://www.w3.org/1999/XSL/Transform' version='1.0'>
<xsl:output method="text" encoding="utf-8"/>
<xsl:strip-space elements="*" /><xsl:template match="/">product-id-type<xsl:text>	</xsl:text>product-id<xsl:text>	</xsl:text>sku<xsl:text>	</xsl:text>item-price<xsl:text>	</xsl:text>condition-typ<xsl:text>	</xsl:text>quantity<xsl:text>&#xD;</xsl:text>
<xsl:for-each select="./ArrayOfProduct/Product">
<xsl:if test="Products_ean != ''">
EAN<xsl:text>	</xsl:text><xsl:value-of select='Products_ean'/><xsl:text>	</xsl:text><xsl:value-of select='aranummer'/><xsl:text>	</xsl:text><xsl:value-of select='Brutto'/><xsl:text>	</xsl:text>NEW<xsl:text>	</xsl:text><xsl:value-of select='Bestand'/><xsl:text>&#xD;</xsl:text>

    </xsl:if>
</xsl:for-each>
    </xsl:template>
</xsl:stylesheet>

Bitte beachten Sie die Zeilenumbrüche - Zeilen-Definitionen bitte nicht umbrechen
Richtig:

<xsl:value-of select='Products_ean'/><xsl:text>	</xsl:text><xsl:value-of select='aranummer'/>

Falsch (Artikelnummer in eine neue Zeile Umgebrochen)

<xsl:value-of select='Products_ean'/><xsl:text>	</xsl:text>
<xsl:value-of select='aranummer'/>

Beispielkonfiguration (ältere CSV Schnittstelle ohne Artikel-Export und Order-Import über einen Remote-Pfad)

Nachträglich hinzugefügte Felder

• Artikel-Typ (Verknüpfung zum Artikel-Typ. Hier dürfen nur folgende, groß geschriebene, Werte rein: "A" (Artikel); "E" (Ersatzteil); "L" (Leistung))

Pflichtangaben Bestellimport

Zuordnung Bestellung:

• Externe Bestellnummer (darüber wird der Bezug zu den Belegen und denen darin enthaltenen Positionen vorgenommen)
• Zahlart (externe ZB - Verknüpfung mit mention-ZB in der CSV-Schnittstelle notwendig)
• Versandkosten
• Externe Versandart (externe Versandart - Verknüpfung mit mention-Versandart in der CSV-Schnittstelle notwendig)
• Währung
• Email-Adresse des Bestellers (darüber wird aktuell die Kunden-Verknüpfung vorgenommen)

Bestell-Position:

• Artikelnummer in Mention (Verknüpfung zur Artikel-Nr.)
• Menge
• Einzelpreis oder Gesamtpreis
• MwSt in Prozent

Rechnungsadresse:

• CompanyName1 oder CompanyName2
• Vorname
• Nachname
• Straße
• Postleitzahl
• Ort
• Iso2 Länderkennzeichen
• Telefonnummer
• UmsatzsteuerID (Wenn vorhanden)

Versandadresse:

• CompanyName1 oder CompanyName2
• Vorname
• Nachname
• Straße
• Postleitzahl
• Ort
• Iso2 Länderkennzeichen
• Telefonnummer
• UmsatzsteuerID (Wenn vorhanden)