Inhaltsverzeichnis

  1. Einführung

  2. Warum der Import von Produkten über Excel effizient ist

  3. Das Produktmanagementmodul von Dolibarr verstehen

  4. Vorbereiten Ihrer Produktdaten in Excel

  5. Erforderliche und optionale Felder in der Importvorlage

  6. Formatieren Ihrer Excel-Datei für die Kompatibilität

  7. Zugriff auf das Produktimport-Tool in Dolibarr

  8. Zuordnen von Excel-Spalten zu Dolibarr-Feldern

  9. Importieren einfacher Produkte vs. Produkt-/Servicevarianten

  10. Massenimport von Produktpreisen und Steuerregeln

  11. Handhabung von Lagerbeständen und Lagern beim Import

  12. Hochladen von Produktbildern in großen Mengen

  13. Fehlerbehandlung und Fehlerbehebung beim Import

  14. Automatisieren von Importen mit geplanten Aufgaben

  15. Best Practices für Sicherheit und Datenintegrität

  16. Integration von Drittanbieter-Tools für erweiterte Importe

  17. Überprüfung importierter Produkte und Durchführung von Stichproben

  18. Bearbeiten und Aktualisieren importierter Daten in großen Mengen

  19. Exportieren von Produktdaten zum Sichern oder erneuten Importieren

  20. Fazit und Empfehlungen

1. Einleitung

Für Unternehmen mit einem umfangreichen Produktkatalog ist die manuelle Eingabe von Artikeln in ein ERP-System zeitaufwändig und fehleranfällig. Dolibarr ERP & CRM enthält ein robustes Importprogramm, das Excel- und CSV-Dateien unterstützt und Ihnen den effizienten Massenimport von Produkt- und Servicedaten ermöglicht. Diese Anleitung beschreibt alle Schritte zur Vorbereitung, Formatierung und zum Import Ihres Produktkatalogs in Dolibarr mit Excel.

2. Warum der Import von Produkten über Excel effizient ist

  • Spart Zeit, da die manuelle Dateneingabe vermieden wird

  • Reduziert das Risiko menschlicher Fehler

  • Unterstützt die Migration von Altsystemen

  • Erleichtert saisonale Katalogaktualisierungen oder Batch-Uploads

Das Importtool von Dolibarr ist für die strukturierte Stapelverarbeitung konzipiert.

3. Das Produktmanagementmodul von Dolibarr verstehen

Stellen Sie vor dem Importieren sicher, dass die folgenden Module aktiviert sind:

  • Produkte

  • Lagerverwaltung (falls zutreffend)

  • MwSt.- und Preiskonfigurationsmodule

Diese finden Sie unter „Startseite > Setup > Module“. Auf die Import-Tools können nur Administratoren oder Benutzer mit entsprechenden Berechtigungen zugreifen.

4. Vorbereitung Ihrer Produktdaten in Excel

Beginnen Sie mit einer sauberen Excel-Datei. Verwenden Sie eine Zeile pro Produkt. Die Spalten sollten Felder wie folgt darstellen:

  • Produktname

  • Referenzcode (eindeutige ID)

  • Preis (HT oder TTC)

  • Mehrwertsteuer

  • Produkttyp (0 = Produkt, 1 = Dienstleistung)

  • Lagermenge

  • Lagercode

  • Beschreibung

Stellen Sie sicher, dass Ihre Kopfzeilen klar sind und mit den erwarteten Feldbeschriftungen von Dolibarr übereinstimmen.

5. Erforderliche und optionale Felder in der Importvorlage

Benötigte Felder:

  • Ref (eindeutige Kennung)

  • Bezeichnung (Name)

  • Produkttyp (0 oder 1)

  • Verkaufspreis

Optionale Felder:

  • Strichcode

  • Lagermenge

  • Beschreibung

  • Kauf- und Verkaufseinheiten

  • Mehrwertsteuer

Verwenden Sie die Importbeispieldateien von Dolibarr als Vorlage.

6. Formatieren Ihrer Excel-Datei für die Kompatibilität

  • Speichern im CSV-Format (durch Kommas getrennt) oder im XLSX-Format

  • Stellen Sie die UTF-8-Kodierung sicher

  • Vermeiden Sie leere Zeilen oder zusätzliche Leerzeichen

  • Verwenden Sie eine einheitliche Formatierung für Dezimalzeichen (z. B. Punkt statt Komma).

  • Keine zusammengeführten Zellen

7. Zugriff auf das Produktimport-Tool in Dolibarr

Navigieren Sie zu: „Startseite > Tools > Importe“

  • Wählen Sie den Importtyp "Produkte/Dienstleistungen"

  • Laden Sie Ihre Excel- oder CSV-Datei hoch

Stellen Sie sicher, dass Sie das richtige Importprofil ausgewählt haben (z. B. „Neue Produkte“ oder „Vorhandene aktualisieren“).

8. Zuordnen von Excel-Spalten zu Dolibarr-Feldern

Auf der Importseite:

  • Ordnen Sie jede Excel-Spalte dem entsprechenden Dolibarr-Feld zu

  • Überprüfen der Standardwerteinstellungen

  • Lassen Sie optionale Felder leer, wenn sie nicht zutreffend sind

  • Vorschau der Daten vor der endgültigen Übermittlung

9. Importieren einfacher Produkte vs. Produkt-/Servicevarianten

Dolibarr unterstützt den Massenimport von Varianten nicht nativ, aber Sie können:

  • Basisprodukte importieren

  • Verwenden Sie Attribute (Farbe, Größe) über benutzerdefinierte Module

  • Berücksichtigen Sie Drittanbietermodule für Matriximporte

Bleiben Sie vorerst bei einfachen Einträgen auf SKU-Ebene.

10. Preise und Steuervorschriften für Massenimportprodukte

Fügen Sie Spalten ein für:

  • Verkaufspreis (vor Steuern oder nach Steuern)

  • Mehrwertsteuersatz (zB 20 für 20%)

  • Kaufpreis

Dolibarr berechnet die Preise inklusive Steuern automatisch basierend auf Ihren Einstellungen.

11. Handhabung von Lagerbeständen und Lagern beim Import

So importieren Sie Lagerbestände:

  • Fügen Sie eine Spalte „Lagermenge“ hinzu

  • Fügen Sie eine „Warehouse Ref“ hinzu, wenn Sie ein Multi-Warehouse-Setup verwenden

Stellen Sie vor dem Importieren sicher, dass die Lager in Dolibarr vorhanden sind.

12. Hochladen von Produktbildern in großen Mengen

Dolibarr unterstützt den Bildimport über Excel nicht nativ, aber Sie können:

  • Laden Sie Bilder in das Produktverzeichnis hoch (z. B. /documents/products)

  • Bildnamen mit Produktreferenzen abgleichen

  • Verwenden Sie API oder Module, um Bilder nach dem Import zu verknüpfen

13. Fehlerbehandlung und Fehlerbehebung beim Import

Häufige Probleme:

  • Doppelte Referenzen

  • Falsche Feldzuordnung

  • Codierungsfehler

  • Ungültige Datentypen (z. B. Text in numerischen Feldern)

Dolibarr zeigt nach dem Import eine Zusammenfassung der Fehler an. Testen Sie immer zuerst mit einer kleinen Datei.

14. Importe mit geplanten Aufgaben automatisieren

Für wiederkehrende Importe:

  • Verwenden Sie Dolibarr-Cronjobs

  • Schreiben Sie Skripte, um Excel in CSV zu konvertieren und in einem überwachten Verzeichnis abzulegen

  • Verwenden Sie die API, um den Import über CLI-Tools oder Erweiterungen auszulösen

15. Best Practices für Sicherheit und Datenintegrität

  • Sichern Sie Ihre Dolibarr-Instanz vor dem Importieren

  • Verwenden Sie Importprotokolle zur Rückverfolgbarkeit

  • Importberechtigungen auf vertrauenswürdige Benutzer beschränken

Vermeiden Sie das Überschreiben vorhandener Produktreferenzen, sofern dies nicht beabsichtigt ist.

16. Integration von Drittanbieter-Tools für erweiterte Importe

Erwägen Sie die Verwendung von:

  • OpenRefine zur Datenbereinigung

  • Python- oder PHP-Skripte zur Transformation

  • Zapier/Integromat mit Dolibarr-API für Cloud-basierte Importe

17. Überprüfung importierter Produkte und Durchführung von Stichproben

Nach dem Import:

  • Gehen Sie zu „Produkte > Liste“

  • Sortieren nach „Erstellungsdatum“

  • Öffnen Sie einige Datensätze und überprüfen Sie Preise, Typen und Beschreibungen

18. Bearbeiten und Aktualisieren importierter Daten in großen Mengen

So aktualisieren Sie vorhandene Produkte:

  • Aktuelle Liste exportieren

  • In Excel bearbeiten

  • Erneuter Import mit ausgewähltem „Update-Modus“

Datensätze nach Produktreferenzfeld abgleichen.

19. Exportieren von Produktdaten zur Sicherung oder zum erneuten Import

Verwenden Sie: „Extras > Exporte > Produkte“

  • Auswählen der zu exportierenden Felder

  • Speichern Sie CSV zur Sicherung oder zum Teilen mit Partnern

20. Schlussfolgerung und Empfehlungen

Der Import von Produktkatalogen in Dolibarr mit Excel ist eine hocheffiziente und skalierbare Methode zur Verwaltung von Bestands- und Servicedaten. Durch das Verständnis der erforderlichen Felder, die korrekte Formatierung und den effektiven Einsatz von Mapping-Tools können Sie Ihr Datenmanagement optimieren und menschliche Fehler reduzieren. Testen Sie Importe stets in einer kontrollierten Umgebung, erstellen Sie Backups und befolgen Sie bewährte Methoden, um Datenkonsistenz und ERP-Integrität sicherzustellen.