# Metallzuschlag - Dolibarr Modul

Metallnotierungen (Kupfer/Aluminium) von Sonepar abrufen, verwalten und automatisch auf Einkaufspreise anwenden.

## Funktionen

- **Metallnotierungen abrufen**: Tageswerte und Monatsdurchschnitte (CU/AL) von der Sonepar Metal Note API
- **Dashboard**: Aktuelle Notierungen, Verlaufsdiagramm (Chart.js) und Historie
- **Kupfergehalt berechnen**: Automatisch aus Aderanzahl x Querschnitt x 8,89 kg/(km*mm2) beim Speichern von Produkten
- **Kupferzuschlag berechnen**: EUR/m auf Einkaufspreisen = Kupfergehalt x CU-Notiz / 100.000
- **Lieferanten-Zuschlaege**: CU/AL-Werte pro Lieferant (automatisch oder manuell)
- **Cronjobs**: Woechentlicher API-Abruf + Neuberechnung aller Kupferzuschlaege

## Datenquellen

- **Sonepar Metal Note API** (oeffentlich, ohne Authentifizierung)
  - Tageswert: `https://www.sonepar.de/api/content/metalnote/day?date=YYYYMMDD`
  - Monatsdurchschnitt: `https://www.sonepar.de/api/content/metalnote/previousmonth?date=YYYYMM01`

## Extrafields

### Auf Lieferantenkarten (thirdparty)
- `metallzuschlag_cu` - Kupferzuschlag (EUR/100kg)
- `metallzuschlag_al` - Aluminiumzuschlag (EUR/100kg)
- `metallzuschlag_date` - Datum der letzten Aktualisierung
- `metallzuschlag_source` - Quelle (sonepar, kluxen, manuell)

### Auf Produkten
- `aderanzahl` - Anzahl Kupfer-Adern
- `querschnitt` - Leiterquerschnitt in mm2
- `kupfergehalt` - Berechnetes Kupfergewicht in kg/km (automatisch per Trigger)

### Auf Einkaufspreisen (product_fournisseur_price)
- `kupferzuschlag` - Berechneter Kupferzuschlag in EUR/m (automatisch per Trigger + Cronjob)

## Berechnung

```
Kupfergehalt (kg/km) = Aderanzahl x Querschnitt (mm2) x 8,89
Kupferzuschlag (EUR/m) = Kupfergehalt (kg/km) x CU-Notiz (EUR/100kg) / 100.000
```

Beispiel: NYM-J 3x1,5mm2 bei CU = 1.092,10 EUR/100kg
- Kupfergehalt = 3 x 1,5 x 8,89 = 40,005 kg/km
- Kupferzuschlag = 40,005 x 1.092,10 / 100.000 = 0,4369 EUR/m

## CU-Notiz Logik

1. Lieferant hat eigenen Wert (metallzuschlag_cu auf Lieferantenkarte) -> diesen verwenden
2. Kein eigener Wert -> aktuellsten aus der Metallzuschlag-Historie

## Installation

1. Modul in `/custom/metallzuschlag/` ablegen
2. In Dolibarr unter Einrichtung > Module aktivieren
3. Einstellungen unter Metallzuschlag > Einrichtung konfigurieren
4. "Jetzt abrufen" auf dem Dashboard klicken

## Voraussetzungen

- Dolibarr >= 19.0
- PHP >= 7.1
- cURL-Erweiterung (fuer API-Abruf)

## Lizenz

GPLv3 oder (nach Wahl) jede spaetere Version. Siehe COPYING.