data/dolibarr.metallzuschlag
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
dolibarr.metallzuschlag/README.md
data 105443f2e9 feat: Differenz-Anzeige und UI-Verbesserungen 
- Differenz-Anzeige (+/-) im CU/AL-Diagramm (immer sichtbar)
- Differenz-Anzeige im Kabel-Diagramm (per Checkbox einblendbar)
- Farbkästchen bei Kabel-Checkboxen passend zur Diagrammfarbe
- Kabel-Diagramm Legende ausgeblendet (nicht doppelt)
- ChangeLog und README aktualisiert

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-24 11:08:01 +01:00

2.6 KiB
Executable file
Raw Permalink Blame History

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.