data/dolibarr.metallzuschlag
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
dolibarr.metallzuschlag/README.md
data 8729b5fdb7 Metallzuschlag v1.1 - Kupferzuschlag-Berechnung + Notierungsverlauf 
- 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>
2026-02-19 17:41:31 +01:00

2.4 KiB
Executable file
Raw 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, 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.