sevDesk Belege exportieren

Dieses Skript exportiert die Belege von sevDesk für einen gewissen Zeitraum als PDFs. Der Zeitraum wird dabei über das payDate (also das in sevDesk hinterlegte Zahlungsdatum) eingeschränkt. Das ist besonders für Einnahmen-Ausgaben-Rechner nützlich, da hier in der monatlichen Buchhaltung einfach alle Belege, die in diesem Monat bezahlt wurden exportiert werden können. Die Belege werden als PDF mit den Dateinamen YYYY-MM-DD-Name-ID.pdf gespeichert. Durch das Datum ist die Sortierung und Zuordnung zum Kontoauszug einfacher. Der Name ist der Lieferanten- oder Kundenname. Die ID wird für eindeutige Dateinamen verwendet. Die Belege können sowohl im lokalen Filesystem als auch via WebDAV abgelegt werden.

Verwendung

Zum Ausführen wird mindestens NodeJS v16 (mit ES-Module-Support) benötigt. Das Skript bietet via --help eine Übersicht über die Parameter.

1. git clone https://github.com/gaambo/sevdesk-export
2. cd sevdesk-export
3. npm install
4. node .

Globale Verwendung

Mit npm install -g . kann das Skript global verfügbar gemacht werden und somit von jedem Verzeichnis via Shell/CMD sevdesk-export ausgeführt werden.

Parameter

--start: Startdatum (YYYY-MM-DD) (Standard: 1. Tag des letzten Monats) --end: Enddatum (YYYY-MM-DD) (Standard: Letzter Tag des letzten Monats) --dir: Export-Verzeichnis (Standard: Verzeichnis "export" im ausführenden Verzeichnis) --delete: Ob bestehende Dateien im Export-Verzeichnis gelöscht werden sollen (Standard: Falsch) --report: Ob ein Journal/Report im CSV-Format erstellt werden soll (Standard: Falsch) --api-token: Der API-Token für sevDesk (siehe Infos).

WebDAV Parameter

Alle WebDAV Parameter können auch via .env bzw. Environment Parameter übergeben werden.

--webdav-address: Die Adresse zum WebDAV. Wenn definiert, wird WebDAV als Filesystem verwendet! --webdav-username: WebDAV Username --webdav-password: WebDAV Passwort. Optional, werden Username/Password nicht gesetzt, wird die Verbindung ohne Authentifizierung aufgebaut --dir: Verzeichnis relativ zum Root des WebDav Filesystems. Muss angegeben werden.

Beispiel für Nextcloud: --webdav-address: https://cloud.example.com/remote.php/dav/files/USERNAME/ --webdav-password: Application Password Siehe Nextcloud Doku.

Beispiel Aufruf:

$ sevdesk-export --start 2022-02-01 --end 2022-02-28 --dir ~/buchhaltung/2022/02 --delete --api-token 1234

sevDesk API

Ein API-Token kann in sevDesk unter Einstellungen > Benutzer > API-Token kopiert werden. Der API-Token kann bei jedem Aufruf als Parameter übergeben werden oder in der .env (siehe .env.example) Datei gespeichert werden. Außerdem kann der API-Token auch als globale Umgebungsvariable gespeichert werden (zB in der .bashrc Datei).

Rechtliches

Dieses Programm wird ohne Haftung und Gewährleistung übermittelt. Es werden nur Daten von der sevDesk-API gelesen und lokal verarbeitet. Es werden keine Daten in sevDesk geschrieben/verändert oder übermittelt.

Dieses Programm steht in keinem Zusammenhang mit sevDesk und wird nicht von sevDesk entwickelt oder betrieben.

Changelog

v1.4.0

• Added support for WebDAV (eg Nextcloud) - props to @bitperfect-fitzi . See documentation above.
• DEV: Added prettier + editorconfig

v1.3.0

• Sanitize filenames
• Extra infos (sevDesk Kategorien) in Dateiname (optional via Flag)

v1.2.0

• Bericht/Journal-Funktionalität hinzugefügt
• Nicht-PDFs werden nun korrekt gespeichert