Support-Zeiterfassung und Abrechnung für Dolibarr

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search


TempsSupport für Dolibarr
Erfassen Sie die telefonische Support-Zeit je Kunde und rechnen Sie sie direkt in Dolibarr ab, monatliches Kontingent inklusive
   Anruf-Timer
   Telefonsupport
   Schwebender Headset-Button
   Zeitabrechnung
   Monatliches Kontingent
   Partner-Reiter
   KPIs je Kunde

Überblick

TempsSupport ist ein externes Modul für Dolibarr ERP/CRM (Herausgeber KSIDol), das die Erfassung der telefonischen Support-Zeit vom Anruf bis zur Rechnung hinzufügt.

Ein schwebender Button (Headset-Symbol) ist auf jeder Seite vorhanden: mit einem Klick starten Sie einen Timer, der mit einem Kunden verknüpft ist, beschreiben das Anrufthema und speichern dann die Zeit. Jeder Geschäftspartner-Datensatz erhält einen Reiter, der seine Zeiten auflistet und deren Abrechnung ermöglicht, einzeln oder gesammelt, mit einem monatlich inkludierten Kontingent.

Das Modul ändert keine Datei des Dolibarr-Kerns.

Herausgeber und Support

Element Information
Herausgeber KSIDol
Spezialität Dolibarr-Integrator
Leistungen Individuelle Entwicklung, SaaS-Hosting, Dolibarr-Begleitung
Website https://www.ksidol.io
Support support@ksidol.io
Dolistore-Module https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Modulinformationen

Information Detail
Modulname TempsSupport
Hauptzweck Telefonische Support-Zeit je Kunde erfassen und abrechnen
Typ Externes Dolibarr-Modul
Familie CRM / Kundenbeziehung
Dokumentierte Version 24.0.0
Dolibarr-Kompatibilität Dolibarr 18.0 bis 24.x
PHP-Kompatibilität PHP 7.4 oder höher
Änderung des Dolibarr-Kerns Nein
Lizenz GNU GPLv3
Verfügbare Sprachen Französisch, Englisch, Deutsch, Spanisch, Italienisch

Offizielle Links

Ziele des Moduls

Dienstleistern, Softwareherstellern, Kundendienst und Hotlines ermöglichen, die am Telefon mit jedem Kunden verbrachte Zeit genau zu messen, ohne externes Werkzeug, und diese Zeit dann in eine Rechnung umzuwandeln:

  • jeden Anruf (eingehend oder ausgehend) von jeder Dolibarr-Seite aus erfassen;
  • die Zeit dem richtigen Kunden und Thema zuordnen;
  • die Zeit einzeln oder gesammelt abrechnen, mit Rundung und Mindestdauer;
  • Pauschal-Support-Angebote verwalten (inkludierte Minuten pro Monat, Abrechnung nur des Mehrverbrauchs).

Für wen?

  • Dienstleister und Softwarehersteller mit abrechenbarem Telefonsupport.
  • Kundendienst und Hotlines, die Telefonzeit erfassen und bewerten möchten.
  • Jede Organisation mit Pauschal-Support und einem monatlich inkludierten Minutenvolumen.

Hauptfunktionen

  • Schwebender Headset-Button: auf jeder Seite vorhanden, unabhängig vom Theme (eldy, moderntemplate), ohne Kernänderung; in der Konfiguration aktivierbar/deaktivierbar.
  • Anruf-Timer: einen Geschäftspartner suchen (oder anlegen), die Richtung wählen (eingehend / ausgehend), den Timer starten, das Thema eingeben, dann „Anruf beenden". Der Timer bleibt beim Navigieren erhalten (Local Storage des Browsers).
  • Datensatz: jeder Anruf wird zu einer Zeit (Referenz, Geschäftspartner, Kontakt, Richtung, Start/Ende, tatsächliche Dauer, abgerechnete Dauer, Thema, Status).
  • Partner-Reiter: Liste der Zeiten des Kunden (tatsächliche und abgerechnete Dauer) mit Aktionen Abrechnen / Bearbeiten / Nicht abrechnen / Abrechenbar machen und Kontrollkästchen für die Sammelabrechnung.
  • Abrechnung: erzeugt eine Rechnungsvorlage mit einer Zeile je Zeit (Menge in Stunden); der Preis stammt vom konfigurierten Produkt/Service oder einem Ersatz-Stundensatz. Rundung (Schritt) und Mindestdauer werden auf die abgerechnete Dauer angewendet.
  • KPIs je Geschäftspartner: Anzahl der erfassten Zeiten, kumulierte tatsächliche Dauer und abzurechnende Zeit.

Monatlich inkludiertes Kontingent

Jeder Geschäftspartner kann über ein Volumen an pro Monat inkludierten Minuten verfügen (oder ein Standard-Modulkontingent). Die Verfolgung zeigt den Verbrauch, den Rest und den Mehrverbrauch:

  • die vom Kontingent abgedeckte Zeit wird als „Inklusive" markiert und erzeugt keine Rechnung;
  • der Mehrverbrauch wird zum Preis der zusätzlichen Stunde abgerechnet (Extrafeld je Geschäftspartner).

Menüs

Das Modul fügt ein Hauptmenü Support-Zeit hinzu mit:

  • Zeitenliste — alle erfassten Zeiten
  • Abzurechnen — Zeiten mit Status „Abzurechnen"
  • Konfiguration — Moduleinstellungen

Ein Reiter Support-Zeit wird auch am Geschäftspartner-Datensatz hinzugefügt.

Konfiguration

Über Startseite → Konfiguration → Module → Support-Zeit:

  • schwebenden Button anzeigen (ja/nein);
  • Abrechnungs-Produkt/Service (Referenz auf den Rechnungszeilen);
  • Produktpreis verwenden (ja/nein);
  • Ersatz-Stundensatz (falls das Produkt keinen Preis hat);
  • Rundung der abgerechneten Dauer (Minuten; 0 = tatsächliche Dauer);
  • abgerechnete Mindestdauer (Minuten; 0 = keine);
  • Standard-Support-Kontingent / Monat (Minuten).

Zwei Extrafelder werden am Geschäftspartner-Datensatz hinzugefügt: inkludiertes Kontingent / Monat und Preis der zusätzlichen Stunde.

Benutzerrechte

Das Modul definiert fünf Berechtigungen:

  • Support-Zeiten lesen (read)
  • Support-Zeiten anlegen / bearbeiten (write)
  • Support-Zeiten abrechnen (bill)
  • Support-Zeiten löschen (delete)
  • das Modul konfigurieren (config)

Tägliche Nutzung

  1. Das Telefon klingelt: Klick auf den Headset-Button.
  2. Kunden suchen, Richtung „Eingehender Anruf", „Timer starten".
  3. Während des Anrufs frei in Dolibarr navigieren — der Timer läuft weiter.
  4. Thema eingeben, „Anruf beenden": die Zeit wird erfasst.
  5. Am Monatsende, Reiter „Support-Zeit" des Kunden: Zeiten auswählen, „Auswahl abrechnen".
  6. Die Rechnungsvorlage wird erstellt (eine Zeile je Anruf); die vom Kontingent abgedeckte Zeit wird als „Inklusive" markiert.

Technischer Hinweis

  • Tabelle: llx_tempssupport_ticket (ein Datensatz je Support-Zeit).
  • Assets werden auf jeder Seite über module_parts geladen (Main-Hook, Modul-CSS und -JS).
  • Timer-Persistenz auf Browserseite (Local Storage).
  • Dolibarr-Standards eingehalten: Hooks, Rechte, CSRF-Token, GETPOST, Escaping.
  • Keine Änderung des Dolibarr-Kerns.

Installation

  1. Entpacken Sie das Archiv, um einen Ordner tempssupport/ zu erhalten.
  2. Kopieren Sie ihn nach htdocs/custom/ Ihres Dolibarr.
  3. Prüfen Sie die Schreibrechte für documents/tempssupport/.
  4. Aktivieren Sie das Modul über Startseite → Konfiguration → Module/Anwendungen.
  5. Bei der Aktivierung werden die erforderliche Tabelle und die Extrafelder automatisch erstellt.

Aktualisierung

  1. Ersetzen Sie den Ordner htdocs/custom/tempssupport/ durch die neue Version.
  2. Laden Sie eine Administrationsseite neu: das Schema (Spalten, Extrafelder) wird automatisch und idempotent geprüft und ergänzt.
  3. Es werden keine bestehenden Daten durch die Aktualisierung gelöscht.

Fehlerbehebung

  • Der Button erscheint nicht: prüfen Sie, ob die Option „Schwebenden Button anzeigen" auf Ja steht und der Benutzer Leserecht hat.
  • Nichts abzurechnen: die Zeiten müssen den Status „Abzurechnen" haben und zum selben Geschäftspartner gehören; eine vollständig vom Kontingent abgedeckte Zeit erzeugt keine Zeile.
  • Preis Null auf der Rechnung: hinterlegen Sie einen Preis am Produkt/Service oder einen Ersatz-Stundensatz.

Siehe auch

  • KSIDol-Signaturterminal: Signatur aller nativen Dolibarr-Belege, kompatibel mit allen KSIDol-Modulen.
  • Kompatibilität: Dolibarr 18.0 bis 24.x — PHP 7.4+ — Lizenz GPLv3 — Herausgeber: KSIDol.

Zusammenfassung

TempsSupport erfasst die telefonische Support-Zeit Ihrer Kunden von jeder Dolibarr-Seite aus (Headset-Button), speichert sie je Geschäftspartner und wandelt sie in eine Rechnung um — einzeln oder gesammelt, mit Rundung, Mindestdauer und einem monatlich inkludierten Kontingent (Abrechnung nur des Mehrverbrauchs).