Datenimport und -export

Der Datenaustausch auf Mercanto erfolgt asynchron. Das heisst, Daten, die von Lieferanten hochgeladen werden, werden im Mercanto Shop nicht augenblicklich sichtbar sein für Kunden. Der Import von Daten erfolgt entweder über das Merchant Portal (MercantoXLSX, MercantoCSV) oder direkt über den Server (MercantoXLSX, MercantoCSV, JSON).

Es gilt:

• Die Zugangsdaten für das Merchant Portal und/oder den Server werden durch Mercanto zur Verfügung gestellt.
• Neu vom Lieferanten importierte Dateien werden alle 5 Minuten vom System "abgeholt" und verarbeitet.
• Gelangen in einem Zeitfenster weitere Files auf den Sever, so wird der Zeitzähler wieder zurückgesetzt und es dauert erneut 5 Minuten, bis die Verarbeitung der Dateien beginnt. 
• Hinweis: Mercanto bevorzugt nach dem Initialen Full-Import Deltaimports. Der Import von unveränderte Daten - wie das bei Full-Imports beim grössten Teil der Daten der Fall ist - verursachen unnötige Last und Kosten auf den Systemen.

Import via Merchant Portal

Im Merchant Portal gibt es den Bereich "Import", wo Templates für die verschiedenen Daten(-typen) heruntergeladen und die befüllten Dateien hochgeladen werden können. 

Import via Server

Die Daten werden in einem AWS S3-Bucket abgelegt. Jeder Lieferant erhält hierfür die entsprechende Serveradresse und einen persönlichen Zugangsschlüssel. Um Datenfiles und Mediendateien manuell auf S3 ablegen zu können, braucht es eine S3 fähige Client Software. Für die automatisierte Anbindung des S3-Buckets an das ERP ist der Lieferant (und/oder ggf. der IT-Partner) selbst verantwortlich.

Mögliche S3 Client Software (Beispiele):

• WinSCP
• Cyberduck
• Filezilla (Pro Version)

Ordnerstruktur auf dem Server

Auf dem S3-Bucket gibt es folgende Ordnerstruktur:

root/
├── in/
│   ├── data/
│   └── product_media/
│       ├── image/
│       └── pdf/
└── out/
    └── orders/

Der Ordner in enthält die Unterordner data und product_media. Die JSON-Files mit den Kunden- und Artikeldaten sind im Ordner data abzulegen. Artikelbilder gehören in den Ordner image. Weitere Files zu den Artikeln sind im Ordner pdf im gleichnamigen Format abzulegen. 

Hinweis: Dateien, die über das Merchant Portal hochgeladen werden, landen ebenfalls auf diesem Server. Das System kümmert sich automatisch um die richtige Verteilung der Dateien auf die entsprechenden Ordner.

Datenexport

Die einzigen Dateien die Mercanto exportiert, sind die Bestelldateien. Die Dateien werden in den Unterordner orders im Ordner out auf dem S3 Bucket abgelegt, wo sie vom Lieferanten abgeholt werden können für die weitere Prozessierung im ERP System. Das gewählte Import-Datenformat (xlsx, csv oder json) beeinflusst dabei das Datenformat der Bestelldatei:

Der Dateiname ist dabei wie folgt aufgebaut:

<Bestellnummer Mercanto>.<Datum der Bestellung>-<Uhrzeit der Bestellung>.<Dateiformat>

Beispiele:

• JSON: M474421.20240419-171701.json
• CSV: M474421.20240419-171701.csv