Einrichtungstutorial App Datenimport

Datenimport-App – Einrichtung und Konfiguration

Die Einrichtung der Datenimport-App für automatisierte XML/CSV-Importe erfolgt in mehreren Schritten. Diese Anleitung führt Sie durch die vollständige Konfiguration am Beispiel eines XML-Imports.

1. Neuen Import anlegen und Grundkonfiguration
2. Übertragungsmedium und Datenquelle konfigurieren
3. Datenfelder zuordnen (Mapping)
4. Grunddaten und Importeinstellungen festlegen
5. Kategoriezuordnung konfigurieren (optional)
6. Importintervalle einstellen
7. Test-Import durchführen

1. Neuen Import anlegen und Grundkonfiguration

Öffnen Sie in tricoma: Schnittstellen → Datenimport

Klicken Sie auf "Neuen Import anlegen" und vergeben Sie einen aussagekräftigen Namen (z.B. "Lieferant XY - Produktimport").

Wählen Sie zunächst das Übertragungsmedium:

Feed-URL: Wenn der Lieferant eine URL zum Abrufen der Daten bereitstellt

FTP: Bei FTP-Server-Zugriff

Wählen Sie den Datentyp:

XML: Für XML-Dateien

CSV: Für CSV-Dateien

Klicken Sie auf "Speichern", um die Grundkonfiguration zu sichern.

2. Übertragungsmedium und Datenquelle konfigurieren

Wechseln Sie zum Reiter "Übertragungsmedium".

Tragen Sie im Feld "URL" die Feed-URL ein, die Ihnen Ihr Lieferant zur Verfügung gestellt hat.

Optionale Bestands-URL:
Falls Ihr Lieferant Produktdaten und Bestandsinformationen in separaten Dateien liefert, können Sie unter "URL Bestand" eine zweite URL hinterlegen. In den meisten Fällen sind beide Informationen jedoch in einer Datei enthalten – lassen Sie dieses Feld dann leer.

Speichern Sie die Einstellungen mit "Speichern".

3. Datenfelder zuordnen (Mapping)

Wechseln Sie zum Reiter "Datentyp" und klicken Sie auf "Konfigurieren".

Klicken Sie auf "Importvorlage" – die App lädt automatisch die Datei von der konfigurierten URL herunter und analysiert die Struktur.

Die App zeigt nun alle verfügbaren Datenfelder aus der Lieferantendatei an. Ordnen Sie diese den entsprechenden tricoma-Feldern zu.

Pflichtfelder (müssen zugeordnet werden):

Lieferantartikelnummer: Eindeutige Artikelnummer des Lieferanten (z.B. "product_id")

Titel/Name: Produktbezeichnung (z.B. "title", "name")

EAN/GTIN: Internationale Artikelnummer (z.B. "gtin", "ean")

Empfohlene optionale Felder:

Hersteller/Brand: Markenname des Produkts

Preis: Einkaufspreis, Verkaufspreis (netto/brutto) – wählen Sie das für Sie relevante Preisfeld

Beschreibung: Produktbeschreibung (kann auch HTML enthalten)

Bild-URL: Link zu Produktbildern

Kategorien: Produktkategorien des Lieferanten

Besonderheiten bei der Feldzuordnung:

Bild-URL:

Bild-URL einzeln: Wenn pro Feld nur eine URL enthalten ist

Bild-URL mit Trennzeichen: Wenn mehrere URLs in einem Feld stehen (z.B. getrennt durch ";", "|" oder andere Zeichen). Die App erkennt das Trennzeichen automatisch.

Kategorien:

Kategorie einzeln: Ein Kategoriewert pro Feld

Kategorie mit Trennzeichen: Kategoriepfade mit automatischer Trennzeichenerkennung (z.B. "Schuhe > Damen > Ballerinas")

Weitere Produktdatenfelder können Sie nach Bedarf aus den tricoma-Produktdatenfeldern auswählen und zuordnen.

Bestandsverwaltung konfigurieren:

Wählen Sie die Art, wie Ihr Lieferant Bestandsinformationen liefert:

Variante 1: Lieferantenbestand (Zahlenwert)
Wenn die Datei einen numerischen Bestandswert liefert (z.B. "stock: 150"), wählen Sie "Lieferantenbestand" und ordnen Sie das entsprechende Feld zu.

Variante 2: Lieferantenverfügbarkeit mit Text
Wenn die Datei Textwerte für Verfügbarkeit liefert (z.B. "In Stock", "Available", "Verfügbar"):

Wählen Sie "Lieferantenverfügbarkeit mit Text"

Klicken Sie auf "Speichern"

Tragen Sie im Feld "Text für Verfügbarkeit" den exakten Text ein, der Verfügbarkeit signalisiert (z.B. "In Stock")

Geben Sie einen "Pseudo-Bestand" ein (z.B. 100) – dieser Wert wird für verfügbare Produkte als Bestand gesetzt

Variante 3: Permanente Verfügbarkeit
Wenn alle Produkte in der Datei immer verfügbar sind und keine Bestandsangaben geliefert werden, können Sie die Bestandsfelder leer lassen und später unter "Grunddaten" einen Standard-Bestand festlegen.

Speichern Sie die Konfiguration mit "Speichern".

4. Grunddaten und Importeinstellungen festlegen

Wechseln Sie zum Reiter "Allgemeine Importeinstellungen".

Lieferant zuweisen:
Wählen Sie den entsprechenden Lieferanten aus der Dropdown-Liste. Dieser muss zuvor in tricoma als Kundenlieferant angelegt worden sein.

Steuersatz:
Wählen Sie den passenden Mehrwertsteuersatz für die importierten Produkte.

EK-Preisanpassung (optional):
Falls Sie die Einkaufspreise prozentual anpassen möchten:

Positiver Wert (z.B. +2%): Für Aufschläge (z.B. Versandpauschalen)

Negativer Wert (z.B. -10%): Für Rabatte oder Skonto

Produktdatenupdate:

Aktiviert: Produktdaten (Titel, Beschreibung, Bilder etc.) werden bei jedem Import aktualisiert

Deaktiviert: Produktdaten werden nur beim ersten Import (Neuanlage) geschrieben

Empfehlung: Aktivieren Sie diese Option nur, wenn Ihr Lieferant hochwertige und zuverlässige Produktdaten liefert. Bei mehreren Lieferanten für dasselbe Produkt sollten Sie nur bei einem Lieferanten die Aktualisierung aktivieren.

Produktkategorie (Lieferantenkategorie):
Legen Sie eine Standard-Kategorie für alle importierten Produkte an. Erstellen Sie z.B. eine Hauptkategorie "Lieferantenimport" und darunter für jeden Lieferanten eine Unterkategorie.
Vorteile:

Einfache Übersicht über alle Produkte eines Lieferanten

Schnelle Freischaltung für Verkaufsplattformen über Kategoriezuordnung

Klare Trennung zwischen verschiedenen Lieferanten

Priorität:
Standardwert ist 10.000 – diese hohe Zahl sorgt dafür, dass die Lieferantenkategorien in der Kategorieansicht nachrangig behandelt werden.

Lieferantenbestand (bei permanenter Verfügbarkeit):
Falls Ihr Lieferant keine Bestandsinformationen liefert, aber alle Produkte immer verfügbar sind, tragen Sie hier einen Standard-Bestandswert ein (z.B. 999).

Währung:
Wählen Sie die Währung, in der die Preise in der Lieferantendatei angegeben sind. Die App rechnet automatisch in Euro um, falls eine andere Währung gewählt wurde.

Artikelnummer-Format:

Standard (Produkt-ID) - empfohlen: Die App verwendet die interne tricoma Produkt-ID als Artikelnummer. Dies verhindert Konflikte bei mehreren Lieferanten.

Original-Lieferantartikelnummer: Die Artikelnummer des Lieferanten wird übernommen (Achtung: kann bei mehreren Lieferanten zu Duplikaten führen)

Mit Präfix: Lieferantartikelnummer mit vorangestelltem Kürzel (z.B. "LF_12345") – guter Kompromiss für bessere Zuordnung

Speichern Sie die Grunddaten mit "Speichern".

5. Kategoriezuordnung konfigurieren (optional)

Falls Sie im Datenfeld-Mapping "Kategorie mit Trennzeichen" zugeordnet haben, können Sie nun die Lieferantenkategorien Ihren Shop-Kategorien zuordnen.

Wichtig: Führen Sie zunächst einen manuellen Import durch (siehe Schritt 7), damit die App die Kategorien aus der Datei einlesen kann.

Öffnen Sie nach dem ersten Import die "Produktkategorien zuordnen".

Die App zeigt alle Kategorien aus der Lieferantendatei hierarchisch an. Die unterste Ebene ist immer die Kategorie, der das Produkt zugeordnet wird.

Klicken Sie auf eine Lieferantenkategorie und wählen Sie die entsprechende tricoma-Kategorie aus dem Dropdown-Menü.

Speichern Sie nach jeder Zuordnung.

Hinweis: Die App unterstützt beliebig viele Kategorieebenen. Die Zuordnung erfolgt rekursiv, d.h. Sie ordnen nur die untersten Kategorien zu – der vollständige Pfad wird automatisch berücksichtigt.

6. Importintervalle einstellen

Wechseln Sie zum Reiter "Intervalle".

Import aktivieren:
Setzen Sie den Haken bei "Import aktivieren", damit der automatische Import über den tricoma-Cronjob läuft.

Intervall Produkteimport:
Legen Sie fest, wie oft Produktdaten importiert werden sollen (z.B. "24h" für einmal täglich).

Intervall Bestandimport:
Legen Sie fest, wie oft Lagerbestände aktualisiert werden sollen (z.B. "2h" für alle 2 Stunden).
Hinweis: Falls Sie keine separate Bestands-URL konfiguriert haben, lassen Sie dieses Feld leer – die Bestände werden dann zusammen mit den Produktdaten importiert.

Intervall tricoma Abgleich:
Legen Sie fest, wie oft die importierten Daten in tricoma synchronisiert werden sollen.

Wichtig: Passen Sie die Intervalle an die Aktualisierungsfrequenz Ihres Lieferanten an. Wenn der Lieferant seine Daten nur einmal täglich aktualisiert, macht ein stündlicher Import keinen Sinn und belastet nur unnötig die Serverressourcen.

Cronjob-Konfiguration:
Der Master-Cronjob für alle Importe wird unter Administration → Erweitert → Cronjobs konfiguriert. Dort finden Sie den Eintrag "Datenimport". Empfohlener Wert: 10 Minuten.

Speichern Sie die Einstellungen mit "Speichern".

7. Test-Import durchführen

Bevor Sie den automatischen Import aktivieren, sollten Sie die Konfiguration testen.

Schritt 1: Produkte und Bestände importieren
Klicken Sie auf "Produkte und Bestände manuell importieren".
Die App lädt nun die Datei vom Server und importiert alle Daten in den internen Container.

Sie können die importierten Rohdaten unter "Daten" → "Rohdaten" einsehen und überprüfen.

Schritt 2: tricoma-Abgleich durchführen
Klicken Sie auf "tricoma-Abgleich manuell ausführen".
Die App überträgt nun die Daten aus dem Container in tricoma und legt neue Produkte an bzw. aktualisiert bestehende Produkte.

Wichtig: Es werden nur Produkte angelegt, die einen Bestand oder eine Verfügbarkeit haben. Produkte ohne Bestand werden übersprungen.

Schritt 3: Produkte in tricoma überprüfen
Öffnen Sie in tricoma: Artikel → Produkte

Überprüfen Sie, ob die Produkte korrekt angelegt wurden:

Titel, Beschreibung, EAN

Hersteller

Bilder

Kategorien (Lieferantenkategorie + Shop-Kategorien)

Lieferantenzuordnung und Bestand (unter "Sonstige Preise")

Container-Prinzip:
Die App arbeitet nach dem Container-Prinzip. Das bedeutet:

Schritt 1: Import aller Daten in den internen App-Container

Schritt 2: Abgleich der Container-Daten mit tricoma

Dieses zweistufige Verfahren sorgt für maximale Stabilität und ermöglicht es, mehrere Datenquellen zu verwalten.

Wichtige Hinweise und Best Practices

Nur verfügbare Produkte werden angelegt
Die App legt ausschließlich Produkte an, die laut Lieferantendatei verfügbar sind (Bestand > 0 oder Verfügbarkeitsstatus = "verfügbar").

Automatische Bestandsaktualisierung
Wenn ein Produkt beim nächsten Import nicht mehr verfügbar ist, wird der Bestand automatisch auf 0 gesetzt. Das Produkt bleibt in tricoma erhalten, wird aber als nicht verfügbar markiert.

Import deaktivieren
Wenn Sie einen Import dauerhaft deaktivieren möchten:

Entfernen Sie den Haken bei "Aktiv" im Reiter "Automatismen"

Klicken Sie auf "Bestand und Preise zurücksetzen"

Dies setzt alle Verfügbarkeiten und Bestände dieses Lieferanten zurück, damit keine veralteten Daten im System verbleiben.

Mehrere Lieferanten
Sie können beliebig viele Importe anlegen und parallel verwalten. Jeder Import arbeitet unabhängig mit eigenen Intervallen und Einstellungen.

Universelle Kompatibilität
Die App ist nicht lieferantenspezifisch entwickelt, sondern arbeitet mit allen sauber strukturierten XML- und CSV-Dateien. Die flexible Feldzuordnung ermöglicht die Integration nahezu jeder Datenquelle.