Modulversion: auto
Herausgeber / Lizenz: CAP-REL / Eric Seigne - GPL-v3
Sprachen: Français, English, Español, Deutsch, Italiano
Support: sav@doliscan.fr
Dolibarr: auto bis auto - PHP: 7.4+
Bitte vor dem Kauf lesen. Dieses Modul ist ein Konnektor: es funktioniert nicht allein. Es benötigt einen DoliSCAN-Server, der die von der mobilen Anwendung gesendeten Belegfotos empfängt und verarbeitet. Dafür gibt es zwei Wege, und nur einer davon ist einfach:
- ein Abonnement des Dienstes doliscan.fr, das getrennt von diesem Modul abgerechnet wird (Preise ansehen);
- oder der Betrieb eines eigenen DoliSCAN-Servers, der Kenntnisse in der Systemadministration und eine eigene Infrastruktur erfordert. Das ist kein Häkchen in einem Formular: die tatsächlichen Kosten liegen, an Hardware wie an Zeit, deutlich über denen eines Abonnements.
Der Kauf dieses Moduls umfasst keines von beiden.
Vorstellung
DoliSCAN ist die umfassende Lösung zur Verwaltung von Spesenabrechnungen für Dolibarr. Mit der mobilen Anwendung doliscan.fr fotografieren Ihre Mitarbeiter ihre Belege unterwegs, und das DoliSCAN-Modul für Dolibarr erledigt den Rest: automatische Synchronisation, Erstellung von Lieferantenrechnungen, Erstellung der Spesenabrechnungen, Mehrwertsteuerverwaltung gemäß den geltenden Steuervorschriften.
Das Prinzip ist einfach:
➔ Jede Ausgabe, die mit einem geschäftlichen Zahlungsmittel (Firmenkreditkarte) bezahlt wird, wird automatisch in eine Lieferantenrechnung in Dolibarr umgewandelt, mit angehängtem PDF-Beleg.
➔ Jede Ausgabe, die mit einem persönlichen Zahlungsmittel bezahlt wird, wird automatisch der laufenden Spesenabrechnung des betreffenden Benutzers hinzugefügt.
Ein wichtiger Unterschied zwischen dem eigenständigen DoliSCAN und DoliSCAN mit Dolibarr-Anbindung: Alles, was die Buchhaltung betrifft (Verwaltung spezieller Steuerregeln), das in DoliSCAN implementiert ist, wird beim Import in Dolibarr deaktiviert, um Konflikte mit der Dolibarr-Buchhaltung zu vermeiden.
Hauptfunktionen
Automatische Synchronisation
- Konfigurierbarer automatischer täglicher Abgleich über geplante Aufgabe (Cron)
- Import der Spesenabrechnungen von der mobilen DoliSCAN-Anwendung nach Dolibarr
- Automatischer Download der PDF-Belege und Verknüpfung mit Dolibarr-Einträgen (DMS/ECM)
- Erzwungene Neusynchronisation fehlender Belege
- Bidirektionale Synchronisation der Dolibarr-Projekte mit DoliSCAN (Schlüsselwörter)
Verwaltung geschäftlicher Ausgaben
- Automatische Erstellung von Lieferantenrechnungen aus geschäftlichen Ausgaben
- Konfigurierbares Mapping: Jede Art von Geschäftsausgabe (Kraftstoff, Mahlzeiten, Unterkunft...) ist mit einem Dolibarr-Lieferanten verknüpft
- Automatische Erstellung von „generischen" Lieferantendatensätzen bei Bedarf
- Automatische Validierung und Zahlungserfassung (optional)
- Anwendung der auf dem Lieferantendatensatz konfigurierten Standard-Zahlungsmethoden
- Liste der mit jedem DoliSCAN-Import verknüpften Lieferantenrechnungen
Verwaltung persönlicher Ausgaben
- Automatisches Hinzufügen persönlicher Ausgabenzeilen zur Dolibarr-Spesenabrechnung des Benutzers
- Konfigurierbares Mapping der persönlichen Ausgabenarten auf Dolibarr-Spesenabrechnungseinträge
- Spezielle Höchstgrenzen für Verpflegung (Essenspauschale allein, Essen mit Kundengast)
- Aktivierung der Sonderregeln nach Benutzergruppe
Erweiterte Mehrwertsteuerverwaltung
- Automatische Überprüfung und Korrektur der MwSt.- / Nettobeträge beim Import
- Unterstützung der französischen Steuerregeln für Kraftstoff (MwSt. zu 80 % oder 100 % erstattungsfähig, je nach Fahrzeugtyp)
- Verarbeitung von Belegen mit inkonsistenten MwSt.-Daten (Umschaltung auf manuellen Modus)
- Unterstützung mehrerer MwSt.-Sätze auf einem einzelnen Beleg (Verpflegung)
Multi-Entity-Unterstützung
- Kompatibel mit dem Dolibarr Multi-Entity-Modul (multicompany)
- Jede Entität verfügt über eigene DoliSCAN-Konten, Lieferanten-Mappings und Spesenabrechnungen
- Multi-Entity-Benutzerzuordnung: Ein Benutzer kann je nach Entität verschiedene DoliSCAN-E-Mails haben
- Spezielle Diagnoseseite zur automatischen Erkennung und Behebung von Entitäts-Inkonsistenzen
- Super-Admin-Freigabemodus oder unabhängiger Entitätsmodus
Benutzerkontenverwaltung
- Automatische Erstellung eines DoliSCAN-Kontos bei der Erstellung eines Dolibarr-Benutzers (optional)
- Kontoerstellung direkt aus Dolibarr heraus, ohne den DoliSCAN-Server aufrufen zu müssen
- Synchronisierte Aktivierung/Deaktivierung zwischen Dolibarr und DoliSCAN (über Trigger)
- Unterstützung externer Benutzer (optional)
- Jeder Benutzer kann eine geschäftliche Kreditkarte bei verschiedenen Banken/Konten haben
Projekte
- Verknüpfung der Spesenabrechnungen mit Dolibarr-Projekten
- Automatische Synchronisation der Dolibarr-Projekte mit der mobilen DoliSCAN-Anwendung
- Verwendung der Projektbezeichnung, wenn der DoliSCAN-Code leer ist (optional)
- Möglichkeit, abgeschlossene Projekte auszublenden
Berechtigungen und Sicherheit
- 9 granulare Berechtigungen in 3 Kategorien:
- Persönliches Konto: Lesen, Erstellen, Löschen des eigenen DoliSCAN-Kontos
- Meine Spesen: Lesen, Löschen der eigenen Spesenabrechnungen, Herunterladen der Spesen anderer Benutzer (Administrator)
- Verwaltung: Lesen, Erstellen, Löschen aller Benutzerkonten
- Verwaltung der adaptiven CAP-REL-Firewall (automatisches Entsperrverfahren, wenn Ihr Server auf der Blacklist steht)
Kompatibilität
- Dolibarr 18.x und höher
- PHP 7.4 und höher (kompatibel mit PHP 8+)
- MySQL / MariaDB und PostgreSQL
- Unterstützung für Frankreich und Belgien (belgische Unternehmensidentifikationsnummern BCE/KBO)
- Oberfläche verfügbar in Französisch, Englisch und Spanisch
Modulkonfiguration
Das Modul bietet 11 Konfigurationsseiten, die über den Verwaltungsbereich zugänglich sind:
- Server - Auswahl des DoliSCAN-Servers (offiziell, kostenloser Test, selbst gehostet), Importstartdatum, Multi-Entity-Einstellungen
- Administrator - E-Mail und API-Schlüssel des Administratorkontos, Verbindungstest
- Geschäftliche Ausgaben - Zuordnung der geschäftlichen Ausgabenarten zu Dolibarr-Lieferanten
- Persönliche Ausgaben - Zuordnung der persönlichen Ausgabenarten zu Dolibarr-Spesenabrechnungseinträgen
- Zahlungsmittel - Verknüpfung der DoliSCAN-Bankkonten mit Dolibarr-Konten, benutzerspezifische Konfiguration
- Kraftstoff - Französische Steuerregeln (MwSt. zu 80 % oder 100 % erstattungsfähig)
- Sonderregeln - Verpflegungshöchstgrenzen, Aktivierung nach Benutzergruppe
- Verschiedenes - Automatische Kontoerstellung, automatische Rechnungsvalidierung, Neusynchronisationsoptionen
- Multi-Entity - Zuordnung der DoliSCAN-E-Mails pro Benutzer und pro Entität
- Diagnose - Erkennung und Korrektur von Dateninkonsistenzen zwischen Entitäten
- Über - Modulinformationen und Updateprüfung
Erforderliche Dolibarr-Module
Für den ordnungsgemäßen Betrieb von DoliSCAN müssen die folgenden Dolibarr-Module aktiviert sein:
- Lieferanten - Für die Erstellung von Lieferantenrechnungen (geschäftliche Ausgaben)
- Drittparteien - Für die Lieferantenverwaltung
- Banken/Kassen - Für Zahlungsmittel
- Spesenabrechnungen - Für die Erstellung von Spesenabrechnungen
- Rechnungen - Für die Rechnungsverwaltung
- DMS/ECM - Für die Verknüpfung von Belegen
- Geplante Aufgaben - Für die automatische tägliche Synchronisation
Optionale Module: Multi-Entity (Multi-Unternehmen), Projekte (Projektverknüpfung).
Neuerungen seit Version 2.0.86
Sicherheit
- Verstärkter Schutz gegen SQL-Injection: systematisches Escaping aller Parameter und Integer-Casting in allen Suchmethoden (fetchAll)
- Korrekte Initialisierung aller Variablen zur Vermeidung von PHP 8+-Warnungen
Multi-Entity
- Entitätsfeld bei DoliSCAN-Spesenabrechnungen für bessere Datenisolierung hinzugefügt
- Neue Diagnoseseite zur automatischen Erkennung und Behebung von Inkonsistenzen zwischen Entitäten (Lieferantenrechnungen, Spesenabrechnungen, Benutzerkonten)
- Neue Multi-Entity-Benutzerzuordnung: Möglichkeit, verschiedene DoliSCAN-E-Mails für jede Entität desselben Benutzers zu konfigurieren
- Behebung von Entitätsfehlern bei der Dokumentensynchronisation
Leistung und Synchronisationsoptionen
- Neue Option, um die Neusynchronisation bereits genehmigter Spesenabrechnungen zu überspringen
- Neue Option, um die Neusynchronisation bereits bezahlter Lieferantenrechnungen zu überspringen
- Neue Option, um die Neusynchronisation stornierter Rechnungen zu überspringen
- Verbesserter Synchronisations- und Flush-Prozess beim Import
- Erzwungene Beleg-Neusynchronisation mit Anzeige verknüpfter Dateien
- SQL-Indizes zur Verbesserung der Abfrageleistung hinzugefügt
MwSt.
- Automatische Überprüfung und Korrektur der MwSt.- / Nettowerte bei jedem Import
Internationale Unterstützung
- Belgien-Unterstützung: Verarbeitung belgischer Unternehmensidentifikationsnummern (BCE/KBO)
- Aktualisierung der Übersetzungen
Qualität und Zuverlässigkeit
- Statische Codeanalyse mit PHPStan (Stufe 5) und zugehörige Korrekturen
- Zusätzliche automatisierte Tests (Administratorverbindung, Multi-Entity)
- Verbesserte Sammlung technischer Protokolle für einfachere Diagnose
- Fehler bei der automatischen Referenznummerierung behoben
Installation
- Gehen Sie zum Menü Startseite > Einrichtung > Module > Externes Modul bereitstellen und laden Sie die ZIP-Datei hoch
- Das Modul ist dann verfügbar und kann in der Modulliste aktiviert werden
- Folgen Sie dann Schritt für Schritt der Installations- und Konfigurationsdokumentation
Achtung: Schulung und Installationshilfe für das Modul sind nicht im Preis enthalten.
Achtung: Wenn Sie keinen eigenen DoliSCAN-Server betreiben, ist ein Abonnement beim doliscan.fr-Dienst erforderlich (und hilft bei der Finanzierung der Weiterentwicklung des Dolibarr-Moduls, der doliscan.fr-Engine und der Smartphone-Anwendung). Besuchen Sie doliscan.fr für weitere Informationen.
Demo
Ein fiktives Unternehmen „devtemp" ermöglicht es Ihnen, die verschiedenen möglichen Konten und die DoliSCAN-Anwendung zu testen: doliscan.devtemp.fr
Vollständige Dokumentation: doliscan.fr/fr/plugins/dolibarr
Im Kauf enthalten
- Zugang zu Modulaktualisierungen und allen zukünftigen Entwicklungen ohne zeitliche Begrenzung.
- Funktionelle Korrekturen des Moduls basierend auf Ihrem Feedback und Fehlermeldungen.
Aktualisierungen
- Bei jeder neuen Veröffentlichung dieses Moduls wird Ihnen eine E-Mail zugesandt.
- Modulpatches werden auf DoliStore veröffentlicht.
Kontakt
Über unser Kontaktformular auf der Website cap-rel.fr
Was im Kauf enthalten ist
- Das Modul und der Zugang zu seinen Aktualisierungen für den auf dieser Seite genannten Zeitraum
- Fehlerbehebungen, auch zu den von Ihnen gemeldeten
- Eine E-Mail zu jeder neuen Version
Wer über neue Versionen automatisch Bescheid wissen möchte, zu diesem Modul wie zum Dolibarr-Umfeld überhaupt, abonniert dolinews.com: dort erscheinen unsere Versionsankündigungen.
Unterstützung
Die Unterstützung läuft über unser Supportformular, nicht über die Kommentare auf dieser Seite.
Unterstützung ist nicht kostenlos. Sie wünschen sich fachkundige Menschen als Gegenüber: dann ist es nur recht, dass diese Zeit bezahlt wird. Der angezeigte Preis deckt das Modul und seine Aktualisierungen ab. Er deckt weder die Installation noch die Einrichtung Ihres Dolibarr ab, auch nicht die Schulung Ihrer Teams, keine Sonderentwicklungen und keine Untersuchung einer Umgebung, die wir nicht betreiben.
Ein nachvollziehbarer Fehler im Modul wird kostenfrei behoben, das gehört zu den oben genannten Aktualisierungen.
Vor dem Kauf
- Prüfen Sie die oben auf dieser Seite genannten Dolibarr- und PHP-Versionen: darüber hinaus ist das Modul nicht getestet
- Module werden über Startseite > Einstellungen > Module > Externes Modul bereitstellen eingespielt, wofür Ihre Installation ein aktives Verzeichnis custom braucht
- Stützt sich ein Modul auf einen Onlinedienst, ist das Abonnement dieses Dienstes vom Kauf des Moduls getrennt und oben angegeben
Herausgeber
Modul entwickelt von CAP-REL, unter der Lizenz GPL-3.0-or-later. Dokumentation unter doc.cap-rel.fr.
Versionsverlauf
2.2.24 -- 20261006
- Stop logging a PHP 8.2 deprecation when the info tab of a report is opened on Dolibarr 23
2.2.22 -- 20261005
- Stop writing API tokens and security codes to the Dolibarr log
- Refuse a report or an account whose company is unknown when multicompany is on
- Only list the DoliSCAN accounts of the company being browsed
- Stop a resynchronisation from writing into the expense report of a colleague
- Keep the reports of two companies apart when they share a server identifier
- Stop deleting the DoliSCAN account of another employee when a user is removed
- Keep a receipt download inside the folder of its own expense report
- Store the main DoliSCAN token encrypted, and never print it in a page
- Reserve the diagnostics, catch-up and entity mapping pages to the super administrator
- Ask for a confirmation token before launching a DoliSCAN synchronisation
- Ask for a confirmation token before any call to the server from the setup page
- Ask for a confirmation token before creating or deleting a remote account
- Check every selected report before a mass import or validation
- Gate the deletion of an account on the delete right, not on the write right
- Gate each menu entry on the right it needs
- Stop running MySQL-only statements on a PostgreSQL or SQLite database
- Escape the values typed in the mobile app before showing them in a page
- Escape the user columns of the account list
- Filter the identifiers posted by the entity mapping pages
- Stop a receipt label from becoming a formula when the list is opened in a spreadsheet
- Refuse to reach the DoliSCAN server over plain http, and warn when security is lowered
- Make the creation of the default suppliers repeatable without duplicating them
- Fix the recoverable VAT on a fuel receipt for a utility vehicle (HT and VAT were swapped)
- Spot and repair the expense report lines whose VAT is wrong, from the diagnostics page
- Stop dropping an expense line when the app declares a VAT amount at a rate of zero
- Look for an existing line only in the report being filled, never in an older one
- Show the total line at the bottom of the expense report list
- Keep the expense report list, the resync and the sync marker inside the current company
- Push to DoliSCAN only the logins of the current company
- Look for a linked supplier invoice only in the current company
- Skip an expense report with an unusable date instead of stopping the whole nightly sync
- Tell an unusable date from a date simply older than the import start date
- Report a failed import in the result of the account synchronisation
- Report every failed write, payment and update instead of staying silent
- Show a message instead of a blank page when a database read fails
- Stop a failed supplier invoice from breaking the transaction of its caller
- Change the project code of a project again, even when Dolibarr omits the previous value
- Open the info tab of a DoliSCAN account again: it read columns that do not exist
- Name the unknown users of a diagnostic instead of showing a Dolibarr error page
- Let the owner of a report validate it again, once granted the write right
- Validate the import start date before saving it, and stop echoing the server answer
- Wait after a DoliSCAN call only when the server asks to slow down, which speeds up a sync
- Index the import key and the expense report link, for a faster sync on a large base
- Send the feedback mail from the configured address and answer to the one typed in
- Check the module version from the pages instead of at every include
- Remove the mass action that silently did nothing
- List the DoliSCAN trigger as a production trigger, no longer as a demo under development
- Freeze an expense report through its status method, so the change is logged like the others
- Show the module interface in English, Spanish, German and Italian, not only in French
- Display the labels that carried stray quotation marks correctly
- Translate the field labels, the status values and the payment deduplication page
- Load the translation file the module really ships
- Read every module setting through its accessor, with a default when it is not set yet
- Make the address of the DoliSCAN side channel configurable
- Address the DoliSCAN API with the account login, encoded per url segment
2.2.20 -- 20260924
- enforce ownership and permissions on the module pages: an employee can no longer open, download or delete the expense report of a colleague
- declare the missing doliscan->myndf->write permission, and offer to reinstall the module permissions from the diagnostics page
- isolate duplicate lookups and the draft purge per entity (multicompany)
- raise the floor to Dolibarr 18 / PHP 7.4 and drop the backport layer
- partner configuration and permissions warning banner on the admin page
- prevent double submit on the admin forms
- user documentation rewritten with screenshots, README in English and French
- static analysis green on Dolibarr 18 to 23, tests migrated to PHPUnit 11
2.2.18 -- 20260803
- fix loop call on triggers / doliscan cron
2.2.16 -- 20260702
- force recompute of total for dolibarr expense reports
2.2.14 -- 20260616
- better token auto recovery tests
- better cron tests
2.2.12 -- 20260601
2.2.4 -- 20260530
- add a cron test to display message to end user "no cron ... no cron" :)
- tool to relink accounts on entity with multicompany module
- add a test for invalid token
- better logs for debug
- better error handler on api requests
- new admin page for dedup payments
2.2.2 -- 20260513
- improve admin connection diagnostics
- surface the actual check-result message on admincreate failure
- log full checkAdmin result in LOG_ERR when admincreate is aborted
- clearer handleDoliscanTimeoutBlacklist traces
2.2.1 -- 20260428
- auto fix duplicates ER
- auto fix date/time settings due to servers dates
2.2.0 -- 20260426
- big rework on base code
- fix multi-VAT rounding
- fix MyAccount::validate()
- fix mod_myndf_standard / mod_myaccount_standard getNextValue
- fix MyNDF::getNextNumRef / MyAccount::getNextNumRef
- fix ds_vat_from_ttc
- fix create_fact_fournisseur_common
- fix MyDoliSCAN::syncAccount
- DoliSCAN API keys storage
- Re-enabled permission checks
- add 73 unit tests (139 assertions)
- add 142 integration tests
- add HTTP tests
2.0.114 -- 20260407
- fix php warnings
- force resync missing files or temporary doliscan pdf files
2.0.113 -- 20260324
2.0.110 -- 20260317
- fix json_decode
- fix multicompany settings
- change search filter on ndf list
- add mass action to validate dolibarr expense reports linked to doliscan ndf
2.0.102 -- 20260310
- better checks on downloads & api key renew
2.0.98 -- 20260302
- re-download file if status "is prov"
2.0.96 -- 20260220
- add new tests and quality checks
- better force resync system
- better multicompany support
- add a new tests to handle admin token errors
2.0.94 -- 20251129
- do not sync validated expenses documents (new option for 12 month)
- correct entity on missing documents while sync
2.0.92 -- 20251031
- add new options to disable sync of paid or cancelled invoices
- add new option to disable expense repports when dolibarr one is mark as validated
2.0.90 -- 20250901
- fix siren/siret idprof1/idprof2 preflight check
2.0.88 -- 20250701
- fix race condition ht/vat reverted values [PRIORITY]
2.0.86 -- 20250630
- fix vat rate values on some race conditions
- add more debug entry points for dev
- fix include priority on files for dolibarr < 16 setup
2.0.84 -- 20250616
- fix multicompany support thanks to InfraS
2.0.83 -- 20250522
- fix filter syntax when multicompany thirdparties sharing is activated
2.0.82 -- 20250430
- display user entity AND doliscan entity on all account listing
2.0.80 -- 20250425
- better handle json_decode data as array
- add entity number in all accounts list
2.0.76 -- 20250321
- fix bank setup (object vs array)
2.0.74 -- 20250318
- apply default payment rules on supplier invoices
- add list of supplier invoices on doliscan import page of each people
- one more check on resync missing documents to get main doliscan pdf
2.0.72 -- 20250306
- add special rules on expenses "restaurant"
2.0.70 -- 20250303
- code cleanup (getDolGlobalString)
- cleanup syntax typo (double $$, single % and so on)
- cleanup function call
- cleanup objects and vars types
- fix some undef vars warnings
- switch to next phpstan value
- fix sql for PostGreSQL thanks to Thomas
- allow loopback setup
- remove some debug messages
2.0.68 -- 20250213
- add an other check to avoid expense multi-payment
- better log messages
2.0.66 -- 20250107
- new refresh on synchro thanks to william mead (inovea) (DOLISCAN_REFRESH_DRAFT)
- use default payment configured on thirdpart in priority
- and fallback to module global setup
- better connectivity tests
- better multicompany compatibility
2.0.64 -- 20241030
- solution for false VAT tickets amounts
2.0.62 -- 20241028
- better sync all missing doc via cron call
- avoid double payment if invoice is already paid
- new double check on ht/ttc totals
Für die älteren Versionen, zurück bis zur ersten Veröffentlichung am 08.07.2020, finden Sie das vollständige Änderungsprotokoll auf der Seite "Über" des Moduls, sobald es installiert ist.