buchhaltungswidget/README.md
data db82df2234 Stabile 1.0 Version Firmen Statistik Widgets und
Beurteilung der Rechnungsfristen auf der Kundenkarte
2026-01-30 11:41:02 +01:00

4.4 KiB
Executable file

BUCHHALTUNGS-WIDGET / ACCOUNTING WIDGETS FOR DOLIBARR ERP & CRM

Version: 1.0 Compatibility: Dolibarr 19.0+ Author: Eduard Wisch - Data IT Solution License: GPL v3+


Deutsch

Beschreibung

Das Buchhaltungs-Widget Modul erweitert Dolibarr um drei leistungsstarke Dashboard-Widgets fuer die Finanzuebersicht sowie eine Zahlungsstatistik auf der Kundenkarte.

Widgets

1. Umsatzsteuer-Uebersicht (USt)

  • Quartalsweise Darstellung der USt-Zahllast
  • Vergleich mit Vorjahr (gestrichelte Linie)
  • Aktuelles Quartal hervorgehoben
  • Farbcodierung: Rot = Zahllast, Gruen = Erstattung
  • Detailseite mit monatlicher/quartalsweiser Ansicht

2. Gewinn/Verlust

  • Kumulierter Gewinn/Verlust im Jahresverlauf
  • Beruecksichtigt nur kundenbezogene Materialkosten
  • Keine Betriebskosten (Miete, Nebenkosten etc.)
  • Schaetzung der Einkommensteuer
  • Farbige Linie: Gruen = Gewinn, Rot = Verlust

3. Rentabilitaet

  • Vergleich: Materialeinkauf vs. Rechnungsstellung
  • Gewinnmarge in Prozent
  • Produktivitaetsbewertung mit 5 Stufen:
    • Ausgezeichnet (>50%)
    • Gut (30-50%)
    • Durchschnittlich (15-30%)
    • Niedrig (0-15%)
    • Kritisch (<0%)

Zahlungsstatistik (Kundenkarte)

Zeigt auf der Kundenkarte das Zahlungsverhalten des Kunden:

  • Durchschnittliche Zahlungsdauer
  • Vergleich zur Faelligkeit
  • Farbcodierte Bewertung:
    • Gruen: Vorbildlich (>5 Tage frueh)
    • Blau: Puenktlich
    • Gelb: Spaetzahler (bis 7 Tage)
    • Orange: Verspaetet (7-14 Tage)
    • Rot: Problematisch (>14 Tage)

Einstellungen

Im Admin-Bereich koennen folgende Optionen konfiguriert werden:

  • Zahlungsstatistik auf Kundenkarte ein/ausschalten
  • Menueeintrag im Hauptmenue ein/ausschalten

Installation

  1. Ordner buchaltungswidget nach htdocs/custom/ kopieren
  2. In Dolibarr: Startseite > Einstellungen > Module
  3. Modul "Buchhaltungs-Widget" aktivieren
  4. Widgets auf dem Dashboard hinzufuegen

Voraussetzungen

  • Dolibarr 19.0 oder hoeher
  • PHP 7.1 oder hoeher
  • Modul "Rechnungen" aktiviert
  • Modul "Lieferantenrechnungen" aktiviert (fuer vollstaendige Funktion)

English

Description

The Accounting Widgets module extends Dolibarr with three powerful dashboard widgets for financial overview and payment statistics on the customer card.

Widgets

1. VAT Overview

  • Quarterly VAT balance display
  • Year-over-year comparison (dashed line)
  • Current quarter highlighted
  • Color coding: Red = to pay, Green = refund
  • Detail page with monthly/quarterly view

2. Profit/Loss

  • Cumulative profit/loss throughout the year
  • Only considers customer-related material costs
  • Excludes operating costs (rent, utilities, etc.)
  • Income tax estimation
  • Colored line: Green = profit, Red = loss

3. Profitability

  • Comparison: Material purchases vs. invoiced amounts
  • Profit margin percentage
  • Productivity rating with 5 levels:
    • Excellent (>50%)
    • Good (30-50%)
    • Average (15-30%)
    • Low (0-15%)
    • Critical (<0%)

Payment Statistics (Customer Card)

Displays payment behavior on the customer card:

  • Average payment duration
  • Comparison to due date
  • Color-coded rating:
    • Green: Excellent (>5 days early)
    • Blue: On time
    • Yellow: Slow payer (up to 7 days)
    • Orange: Late (7-14 days)
    • Red: Critical (>14 days)

Settings

The following options can be configured in the admin area:

  • Enable/disable payment statistics on customer card
  • Enable/disable menu entry in main menu

Installation

  1. Copy buchaltungswidget folder to htdocs/custom/
  2. In Dolibarr: Home > Setup > Modules
  3. Enable "Accounting Widgets" module
  4. Add widgets to your dashboard

Requirements

  • Dolibarr 19.0 or higher
  • PHP 7.1 or higher
  • "Invoices" module enabled
  • "Supplier Invoices" module enabled (for full functionality)

Changelog

Version 1.0

  • Initial release
  • VAT Overview Widget with quarterly/monthly view
  • Profit/Loss Widget with cumulative chart
  • Profitability Widget with productivity rating
  • Payment statistics on customer card
  • Full German and English translations
  • Theme-compatible styling (Dark/Light mode)
  • Admin settings for feature toggling

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Support

For issues and feature requests, please contact: