# 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)