dolibarr.stockkonversion/README.md
data e1bc646c06 Stock-Konversion Modul v1.0.0
Umrechnung von Einkaufs- in Lagereinheiten bei Wareneingang.
Extrafeld "Umrechnungsfaktor" auf Produkten, Hook auf stockMovementCreate (type=3).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 18:16:31 +01:00

2.6 KiB
Raw Permalink Blame History

Stock-Konversion

Umrechnung von Einkaufs- in Lagereinheiten bei Wareneingang

Dolibarr-Modul für die automatische Mengenumrechnung zwischen Einkaufs- und Verkaufs-/Lagereinheiten.

Problem

Sie kaufen beim Lieferanten "1 Packung Lüsterklemmen" für 12€ (enthält 12 Stück). Dem Kunden wollen Sie aber 12 Stück à 1€ berechnen — nicht 0,08 Packungen.

Dolibarr hat keinen nativen Umrechnungsfaktor zwischen Einkaufs- und Verkaufseinheit. Dieses Modul löst das.

Lösung

  • Extrafeld Umrechnungsfaktor auf Produkt-Ebene (Standard: 1)
  • Bedeutung: "1 Einkaufseinheit = X Stück im Lager"
  • Bei Wareneingang aus Lieferantenbestellungen wird automatisch umgerechnet

Beispiel

Vorgang Ohne Modul Mit Modul (Faktor 12)
Lieferantenbestellung 1 × 12,00€ 1 × 12,00€ (unverändert)
Wareneingang Lager +1 Stück +12 Stück
PMP pro Stück 12,00€ 1,00€
Kundenrechnung 12 × 1,00€ 12 × 1,00€ (unverändert)

Der Gesamtwert bleibt identisch (1 × 12€ = 12 × 1€). Buchhalterisch sauber.

Installation

  1. Modul-Ordner nach custom/stockkonversion/ kopieren
  2. In Dolibarr: Einstellungen → Module → Produkte → "Stock-Konversion" aktivieren
  3. Das Extrafeld "Umrechnungsfaktor" wird automatisch auf Produkten angelegt

Verwendung

  1. Produkt bearbeiten → Extrafeld "Umrechnungsfaktor (EK->Lager)" eintragen (z.B. 12)
  2. Lieferantenbestellung wie gewohnt erstellen (1 Packung à 12€)
  3. Wareneingang buchen — das Modul rechnet automatisch um:
    • Lagerbewegung: 12 Stück à 1€
    • Label wird ergänzt: [Konv: 1×12=12]

Admin-Seite

Unter Einstellungen → Module → Stock-Konversion finden Sie:

  • Erklärung der Funktionsweise
  • Übersicht aller Produkte mit Umrechnungsfaktor > 1

Technische Details

  • Modul-Nummer: 500035
  • Hook: stockMovementCreate im Context mouvementstock
  • Trigger: Nur bei type=3 (Wareneingang aus Lieferantenbestellung)
  • Manuelle Lagerbewegungen (type=0) werden nicht konvertiert
  • Keine eigenen Datenbanktabellen
  • Keine eigenen CSS/JS-Dateien

Einschränkungen

  • Faktor ist pro Produkt, nicht pro Lieferant
  • Nicht zusammen mit Kits/Virtuellen Produkten verwenden (Doppel-Multiplikation)
  • Nur bei Wareneingang aus Bestellungen, nicht bei manuellen Eingängen

Voraussetzungen

  • Dolibarr >= 19.0
  • Modul "Lager" muss aktiviert sein
  • PHP >= 7.1

Lizenz

GPLv3 — siehe COPYING

Autor

Eduard Wisch — Alles Watt läuft