data
e1bc646c06
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>
77 lines
2.6 KiB
Markdown
77 lines
2.6 KiB
Markdown
# 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](COPYING)
|
||
|
||
## Autor
|
||
|
||
Eduard Wisch — [Alles Watt läuft](https://alles-watt-laeuft.de)
|