data
8729b5fdb7
- Sonepar Metal Note API: CU/AL Tageswerte + Monatsdurchschnitte - Dashboard mit Chart.js Verlaufsdiagramm (30/90/365 Tage) - Trigger: Kupfergehalt (kg/km) = Aderanzahl × Querschnitt × 8,89 - Trigger: Kupferzuschlag (€/m) auf Einkaufspreisen berechnen - CU-Logik: Lieferant-eigener Wert oder aktuellster aus History - Cronjobs: Wöchentlicher API-Abruf + Kupferzuschlag-Neuberechnung - Extrafields: Lieferantenkarte (CU/AL/Datum/Quelle), Produkt (Aderanzahl/Querschnitt/Kupfergehalt) - Admin-Seite mit API-URL, Auto-Fetch, Lieferantenübersicht - Mehrsprachig (de_DE, en_US) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
67 lines
2.4 KiB
Markdown
Executable file
67 lines
2.4 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**: 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.
|