Wie man ein individuelles Angebot in Dolibarr erstellt (Vorlage + Schritt-für-Schritt-Anleitung)
   05/16/2025 00:00:00     Dolibarr , Wiki Dolibarr    0 Bemerkungen
Wie man ein individuelles Angebot in Dolibarr erstellt (Vorlage + Schritt-für-Schritt-Anleitung)

Ein professionelles, individuell gestaltetes Angebot ist für jedes Unternehmen unverzichtbar. Es spiegelt die Identität deiner Marke wider, stärkt die Kommunikation mit Kunden und trägt zur Vertrauensbildung bei. Wenn du Dolibarr ERP & CRM zur Verwaltung deiner Geschäftsprozesse verwendest, wirst du feststellen, dass das Angebotssystem leistungsfähig ist – aber die Standardvorlagen nicht immer deinen visuellen oder inhaltlichen Anforderungen entsprechen.

Die gute Nachricht: Dolibarr erlaubt die Erstellung vollständig angepasster Angebotsvorlagen, die genau auf deine geschäftlichen Bedürfnisse zugeschnitten sind.

In diesem Artikel findest du eine ausführliche Schritt-für-Schritt-Anleitung zur Erstellung eines individuellen Angebots in Dolibarr, inklusive:

  • Erklärung, wie das Angebotsmodul in Dolibarr funktioniert

  • Die Struktur der PDF-Vorlagen und deren Einbindung

  • Schrittweise Erstellung und Aktivierung einer eigenen Vorlage

  • Anpassung von Layout, Logo, Schriftarten und Feldern

  • Häufige Fehler und wie man sie vermeidet

  • Tipps zur Pflege und Aktualisierung deiner Vorlage bei neuen Dolibarr-Versionen

Ob Entwickler, Freelancer oder Unternehmer – mit diesem Guide kannst du dein eigenes professionelles Angebot in Dolibarr erstellen.


Wie funktioniert das Angebotsmodul in Dolibarr?

In Dolibarr werden Angebote (auch "Kommerzielle Vorschläge" genannt) über das Modul Verkauf erstellt. Dabei gibst du Kundendaten, Produkte oder Dienstleistungen, Preise, Steuern usw. über das Interface ein.

Die eigentlichen Angebotsdaten werden in der Datenbank gespeichert. Die PDF-Datei, die du erzeugst, basiert auf einer PHP-Vorlage, die das Layout steuert.

So funktioniert der Prozess:

  1. Benutzer erstellt ein Angebot über das Interface

  2. Dolibarr nutzt eine PHP-Datei als Modell, um ein PDF zu generieren

  3. Die Vorlage holt Daten aus der Datenbank und setzt sie mit FPDF-Funktionen ins Layout um

Dolibarr bringt Standardmodelle mit (z. B. crabe, azur, einstein), doch sie wirken oft generisch. Deshalb lohnt sich eine eigene Vorlage.


Warum eine Angebotsvorlage anpassen?

Die Standardvorlagen sind funktional, aber oft unzureichend:

  • Keine eigene Markenoptik (Logo, Farben, Schriftarten)

  • Eingeschränkte Layoutmöglichkeiten

  • Fehlende länderspezifische Hinweise (z. B. Steuerrecht)

  • Keine benutzerdefinierten Felder (z. B. Projektnummern, interne Referenzen)

Mit einer angepassten Vorlage kannst du:

  • Deinen professionellen Markenauftritt unterstreichen

  • Individuelle Informationen darstellen

  • Angebote in verschiedenen Sprachen oder Formaten erzeugen

  • Konsistente, hochwertige PDF-Dokumente erstellen


Schritt 1: Arbeitsumgebung vorbereiten

Du benötigst Zugriff auf die Dateistruktur von Dolibarr, also:

  • Zugang zum Server oder zur lokalen Dolibarr-Installation

  • Berechtigung zur Bearbeitung von PHP-Dateien

  • Den Pfad zur Dolibarr-Installation, z. B.: /var/www/html/dolibarr/

Die PDF-Vorlagen findest du unter:

swift
htdocs/core/modules/propale/doc/

⚠️ Bearbeite nie die Standarddateien direkt. Kopiere sie zuerst – so bleiben deine Änderungen bei Updates erhalten.


Schritt 2: Bestehendes Modell kopieren und umbenennen

  1. Wechsle in das Verzeichnis htdocs/core/modules/propale/doc/

  2. Wähle z. B. pdf_crabe.modules.php

  3. Kopiere die Datei als pdf_meinefirma.modules.php

  4. Öffne sie und ändere die Klassenbezeichnung:

php
class pdf_crabe extends ModelePDFPropales

zu:

php
class pdf_meinefirma extends ModelePDFPropales
  1. Aktualisiere auch:

php
$this->name = "meinefirma"; $this->description = "Individuelle Vorlage von Meine Firma";
  1. Datei speichern.


Schritt 3: Vorlage in Dolibarr aktivieren

  1. Logge dich in Dolibarr ein

  2. Gehe zu Start > Module > Kommerzielle Vorschläge

  3. Klicke auf Konfigurieren

  4. Unter Verfügbare PDF-Modelle findest du meinefirma

  5. Aktiviere es

  6. (Optional) Als Standardvorlage festlegen


Schritt 4: Layout anpassen

Die Datei nutzt PHP und die FPDF-Bibliothek. Wichtige Abschnitte:

a) Kopfbereich

  • Firmenlogo (Position, Größe)

  • Dokumenttitel ("Angebot", "Kostenvoranschlag" etc.)

  • Firmenadresse und -daten

b) Kundenbereich

  • Name, Adresse, USt-ID, Ansprechpartner

c) Leistungstabelle

  • Spalten: Beschreibung, Menge, Preis, Gesamt

  • Reihenfolge und Spaltenbreite

  • Währungsdarstellung

d) Summenblock

  • Bezeichnungen ("Nettobetrag", "MwSt.", "Bruttobetrag")

  • Rabatte, Versandkosten, usw.

e) Fußbereich

  • Zahlungsbedingungen

  • Bankverbindung

  • Handelsregistereintrag

  • Rechtlicher Hinweis


Schritt 5: Benutzerdefinierte Felder einfügen

Wenn du zusätzliche Felder über das Modul ExtraFields erstellt hast, kannst du sie so einfügen:

php
$projektnr = $object->array_options['options_projektnr']; $pdf->MultiCell(70, 5, "Projekt-Nr.: " . $projektnr, 0, 'L');

Achte darauf, leere Werte zu prüfen, bevor du sie ins Layout integrierst.


Schritt 6: Vorlage testen

  1. Erstelle ein Angebot oder öffne ein bestehendes

  2. Klicke auf PDF generieren

  3. Wähle dein benutzerdefiniertes Modell

  4. Prüfe: Layout, Format, Texte, Preise, Felder

Bei Fehlern: Layout anpassen und erneut testen.


Schritt 7: Kompatibilität mit Updates sichern

  • Bearbeite nie die Kernvorlagen

  • Nutze Versionskontrolle (z. B. Git)

  • Nach Dolibarr-Updates: neue Standardvorlagen prüfen und vergleichen


Erweiterte Tipps

A) Bilder oder Wasserzeichen einfügen

php
$pdf->Image('/pfad/wasserzeichen.png', 0, 0, 210, 297);

B) Bedingungen im Layout

php
if ($object->total_ht > 1000) { $pdf->MultiCell(70, 5, "Bitte Lieferbedingungen bestätigen.", 0, 'L'); }

C) Mehrsprachige Dokumente

Sprachdateien laden:

php
$langs->load("bills"); $pdf->MultiCell(70, 5, $langs->trans("TotalHT") . ": " . price($object->total_ht), 0, 'R');

Häufige Fehler vermeiden

  • Originaldateien überschreiben

  • Klassennamen und Dateinamen nicht anpassen

  • Modell nicht aktiviert

  • Feste Inhalte statt dynamischer Felder

  • Layout ohne Rücksicht auf Seitenränder oder Umbrüche


Wann lieber ein Modul statt einer Vorlage?

Wenn du:

  • Komplexe Logik brauchst

  • Drittanbieter-APIs einbinden willst

  • Erweiterte Layout-Funktionen benötigst

… dann ist ein Dolibarr-Modul die bessere Wahl als nur ein PDF-Modell.


Fazit

Ein individuelles Angebotslayout in Dolibarr bietet dir:

  • Einen professionellen Auftritt

  • Vollständige Kontrolle über Design und Inhalte

  • Eingebundene Sonderfelder und kundenspezifische Daten

  • Einheitliche Kommunikation mit Kunden

Mit dieser Anleitung kannst du schnell ein eigenes Layout erstellen, das zu deiner Marke passt – klar, zuverlässig, und effizient.

Bemerkungen

Loggen Sie sich ein oder registrieren Sie sich, um Kommentare zu schreiben