data
2e2cb5b710
- Formel: Kupfergehalt × CU-Notiz / 100.000 × Mindestmenge - Ergebnis auf 2 Nachkommastellen gerundet - Cronjob und Trigger angepasst - Dokumentation aktualisiert - Version auf 1.2 erhöht Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
67 lines
2.5 KiB
Markdown
Executable file
67 lines
2.5 KiB
Markdown
Executable file
# 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**: Gesamtbetrag auf Einkaufspreisen = Kupfergehalt x CU-Notiz / 100.000 x Mindestmenge
|
|
- **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 (Gesamtbetrag fuer Mindestmenge, automatisch per Trigger + Cronjob)
|
|
|
|
## Berechnung
|
|
|
|
```
|
|
Kupfergehalt (kg/km) = Aderanzahl x Querschnitt (mm2) x 8,89
|
|
Kupferzuschlag (EUR) = Kupfergehalt (kg/km) x CU-Notiz (EUR/100kg) / 100.000 x Mindestmenge
|
|
```
|
|
|
|
Beispiel: NYM-J 3x1,5mm2 bei CU = 1.092,10 EUR/100kg, Mindestmenge 100m
|
|
- Kupfergehalt = 3 x 1,5 x 8,89 = 40,005 kg/km
|
|
- Kupferzuschlag = 40,005 x 1.092,10 / 100.000 x 100 = 43,69 EUR
|
|
|
|
## 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.
|