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, Verlaufsdiagramme (Chart.js) und Historie
• Kabel-Diagramm: Kupferzuschlag-Verlauf pro Kabel, filterbar per Checkbox, mit Differenz-Anzeige
• 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.