# BUCHHALTUNGS-WIDGET / ACCOUNTING WIDGETS FOR [DOLIBARR ERP & CRM](https://www.dolibarr.org)

**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:
- Email: data@data-it-solution.de