Entwickler und Partner

Dieser Bereich richtet sich an Partner, Integratoren und technische Administratoren, die den invoiceR an andere Systeme anbinden. Die Seiten sind technisch und setzen Kenntnisse in REST, JSON und der Konfiguration von Webanwendungen voraus.

Übersicht

Thema	Worum es geht
API	Die öffentliche Schnittstelle (Public API) und die Management API, die Swagger-Dokumentation und das Format von Fehlermeldungen.
Authentifizierung an der API	Wie sich eine externe Anwendung anmeldet: Zugriffstoken über Benutzername und Passwort oder persönliches Zugriffstoken (PAT).
OpenID-Provider	Anmeldung über einen oder mehrere OpenID-Connect-Provider, zum Beispiel Microsoft Entra ID.
Stammdaten	Welche Stammdaten der invoiceR kennt und wie ein Import bestehende Datensätze wiedererkennt (MappingKeys).
Stammdaten-Import	Import-Jobs konfigurieren, CSV-Dateien liefern und das Mapping-Skript schreiben.
ERP-Plugins	Die Anbindung an Buchhaltungs- und ERP-Systeme: Stammdaten-Import, Buchungsexport und Fehler-Rückmeldung.
Hangfire-Jobs	Wiederkehrende Hintergrund-Jobs überwachen und von Hand starten.

Wie der invoiceR mit anderen Systemen zusammenspielt

Der invoiceR verarbeitet Kreditorenrechnungen: Belege kommen herein, werden kontiert, visiert und geprüft. Zahlungen führt er nicht selbst aus. Dafür ist er mit dem ERP- oder Buchhaltungssystem verbunden:

Stammdaten kommen aus dem ERP. Konten, Kostenstellen, Projekte, Lieferanten, MwSt-Codes und weitere Daten importiert der invoiceR regelmässig, damit Benutzer gültige Kontierungen erfassen können.
Belege kommen über verschiedene Kanäle. Neben Scan, E-Mail und Upload in der Oberfläche kann eine externe Anwendung Belege auch über die API einliefern.
Freigegebene Belege gehen ins ERP. Nach der Schlusskontrolle übergibt ein ERP-Plugin die Buchung an das ERP, das die Zahlung ausführt.

Die regelmässigen Aufgaben (Import, Export, Aufräumarbeiten) laufen als Hangfire-Jobs im Hintergrund.