data/buchhaltungswidget
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
buchhaltungswidget/README.md

5.2 KiB
Executable file
Raw Permalink Blame History

BUCHHALTUNGS-WIDGET / ACCOUNTING WIDGETS FOR DOLIBARR ERP & CRM

Version: 1.1 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)

Rechnungsstatistik nach Kategorie

Neue Statistikseite unter Kundenrechnungen:

  • Filter nach Rechnungskategorie (Schlagwort/Tag)
  • Zusaetzliche Filter: Kunde, Benutzer, Status, Jahr
  • Diagramme: Anzahl, Betrag, Durchschnitt pro Monat
  • Jahrestabelle mit prozentualen Veraenderungen

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)

Invoice Category Statistics

New statistics page under Customer Invoices:

  • Filter by invoice category (tag)
  • Additional filters: Customer, User, Status, Year
  • Charts: Count, Amount, Average per month
  • Year table with percentage changes

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.1

  • New: Invoice Category Statistics page
    • Filter invoices by category/tag
    • Charts for count, amount, average
    • Year comparison with percentage changes
  • Menu entry under Customer Invoices

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: