Erpnext Sevdesk Sync
Kleiner spezifischer ERPNext zu SevDesk Sync
- Author: DrdotHouse2106
- Repository: https://github.com/DrdotHouse2106/ERPNext-Sevdesk-Sync
- GitHub stars: 0
- Forks: 0
- License: MIT
- Category: Integrations
- Maintenance: Actively Maintained
Install Erpnext Sevdesk Sync
bench get-app https://github.com/DrdotHouse2106/ERPNext-Sevdesk-Sync
Tags
- erpnext
- frappe
- frappe-app
- sevdesk
- sync
Add the Frappe Gems badge to your README
Maintain Erpnext Sevdesk Sync? Paste this into your README:
[](https://frappegems.com/gems/apps/DrdotHouse2106/ERPNext-Sevdesk-Sync)
About Erpnext Sevdesk Sync
ERPNext-Sevdesk-Sync
Kleine, spezifische ERPNext-App: überträgt den Preis der Standard-Preisliste aus ERPNext (dort als Bruttopreis geführt) unverändert als Nettopreis nach sevDesk. Das heißt konkret: ERPNext 100 € (Brutto-Feld) → sevDesk 100 € netto, sevDesk zeigt/berechnet daraus dann 119 € brutto (bei 19 % USt.). Es wird also keine Steuer aus dem ERPNext-Preis herausgerechnet, sondern der Zahlenwert direkt als sevDesk-Nettopreis übernommen.
Das Projekt ist als echte ERPNext-/Frappe-App (sevdesk_sync) aufgebaut, die auf
einer ERPNext-Instanz installiert wird und dort läuft — kein externes Skript, keine
separaten API-Zugangsdaten für ERPNext nötig.
Funktionsweise
- Die Preise (
price_list_rate) werden für alle Artikel der konfigurierten ERPNext-Preisliste direkt über die Frappe-ORM (frappe.get_all) gelesen, zusammen mit dem Artikelnamen (für ggf. neu anzulegende sevDesk-Artikel). - Für jeden ERPNext-Artikel (
item_code) wird perpartNumberder passende Artikel (Part) in sevDesk über die sevDesk-REST-API gesucht. - Existiert der Artikel in sevDesk bereits: Der ERPNext-Preis wird 1:1 als
sevDesk-Nettopreis (
price) übernommen. Der sevDesk-Bruttopreis (priceGross) wird daraus mit dem am sevDesk-Artikel hinterlegten Steuersatz (taxRate) berechnet:brutto = netto * (1 + steuersatz / 100). Hat der sevDesk-Artikel noch keinen Steuersatz, wird ersatzweise der in den App-Einstellungen hinterlegteDefault Tax Rateverwendet. Ist beides nicht vorhanden, wird der Artikel übersprungen (mit einer Warnung im Log). Weicht der neue Nettopreis vom aktuellen ab, wird der sevDesk-Artikel per API aktualisiert. - Existiert der Artikel in sevDesk noch nicht: Er wird neu angelegt
(
partNumber= ERPNextitem_code, Name = ERPNext-Artikelbezeichnung), mit dem ERPNext-Preis als Nettopreis und dem daraus berechneten Bruttopreis. Dafür müssenDefault Tax RateundsevDesk Default Unity ID(die sevDesk-Einheit, z. B. "Stück") in den Einstellungen gesetzt sein — fehlt eines von beiden, wird der Artikel übersprungen (mit Warnung im Log). Ist der ERPNext-Artikel deaktiviert, wird stattdessen kein neuer sevDesk-Artikel angelegt. - Wird ein ERPNext-Artikel deaktiviert (Feld „Disabled"), wird der passende
sevDesk-Artikel beim nächsten Sync auf inaktiv gesetzt (
status = 50), ohne ihn zu löschen. Wird er in ERPNext wieder aktiviert, wird der sevDesk-Artikel entsprechend wieder auf aktiv gesetzt (status = 100). - Der Sync läuft automatisch einmal täglich über Frappes Scheduler
(
scheduler_eventsinhooks.py).
Installation in ERPNext (bench)
Direkt von GitHub:
bench get-app https://github.com/DrdotHouse2106/ERPNext-Sevdesk-Sync
bench --site install-app sevdesk_sync
bench --site migrate
Oder von einem bereits lokal geklonten Repo:
bench get-app sevdesk_sync /pfad/zu/ERPNext-Sevdesk-Sync
bench --site install-app sevdesk_sync
bench --site migrate
Konfiguration
Nach der Installation in ERPNext unter SevDesk Sync Settings (Single-DocType) öffnen und ausfüllen:
| Feld | Beschreibung |
|---|---|
| Synchronisierung aktiv | Ein/Aus-Schalter für den täglichen automatischen Sync (Default: an). Deaktiviert nur den Scheduler-Lauf, die Buttons unten funktionieren immer |
| ERPNext-Preisliste | Name der zu exportierenden Preisliste (Default: Standard Selling) |
| Ausgeschlossene Artikelgruppen | Mehrfachauswahl von ERPNext-Artikelgruppen, deren Artikel komplett vom Sync ausgenommen werden (weder aktualisiert noch in sevDesk neu angelegt). Wirkt nicht automatisch auf Unterartikelgruppen |
| Nur syncen, wenn Feld befüllt ist (Feldname) | Technischer Feldname eines Artikel-Felds (z. B. eines Custom Fields). Ist das gesetzt, werden nur Artikel synct, bei denen dieses Feld einen Wert hat; leer lassen, um alle Artikel der Preisliste zu syncen. Feldname finden unter Einstellungen → Customize Form → Item → Feld anklicken → „Field Name" |
| Standard-Steuersatz (%) | Steuersatz für Artikel ohne sevDesk-Steuersatz und Pflichtfeld für die Neuanlage von Artikeln |
| sevDesk-API-Basis-URL | sevDesk-API-Basis-URL (Default: https://my.sevdesk.de/api/v1) |
| sevDesk-API-Token | API-Token aus sevDesk (Einstellungen → Benutzer → API), wird verschlüsselt gespeichert |
| sevDesk-Standardeinheit (ID) | Die numerische sevDesk-ID der Einheit (z. B. 1 für „Stk"/„Stück"), NICHT der Name der Einheit, für neu anzulegende Artikel; Pflichtfeld für die Neuanlage von Artikeln. Zu finden unter sevDesk → Einstellungen → Stammdaten → Einheiten oder via GET /Unity |
| Trockenlauf | Wenn aktiviert, wird bei jedem Sync (auch dem geplanten) nur simuliert/geloggt, nichts in sevDesk geschrieben oder angelegt |
| Letzte Synchronisierung am / Zusammenfassung | Read-only, wird nach jedem echten Lauf automatisch aktualisiert (nicht beim manuellen Trockenlauf-Button) |
Oben auf der Settings-Seite gibt es drei Buttons:
- Verbindung testen — prüft, ob sevDesk-API-Basis-URL und Token funktionieren, ohne etwas zu ändern.
- Trockenlauf starten — führt den Sync sofort im Trockenlauf-Modus aus (unabhängig vom Trockenlauf-Häkchen), schreibt/legt nichts in sevDesk an, und zeigt das Ergebnis direkt an.
- Jetzt synchronisieren — führt den echten Sync sofort aus (mit Sicherheitsabfrage, da dabei tatsächlich in sevDesk geschrieben bzw. angelegt wird).
Beide Buttons zeigen nach dem Lauf eine Zusammenfassung sowie einen Link zum zugehörigen SevDesk Sync Log-Eintrag (siehe unten) mit der vollständigen Liste.
Trockenlauf-Häkchen vs. „Trockenlauf starten"-Button
Das Häkchen wirkt auf den täglichen automatischen Sync (Scheduler) — damit kann die Automatik dauerhaft im Simulationsmodus laufen (z. B. während der Testphase), ohne dass man jeden Tag manuell eingreifen muss. Der Button „Trockenlauf starten" ist dagegen ein einmaliger, sofortiger Test unabhängig vom Häkchen — beide sind also für unterschiedliche Situationen gedacht und schließen sich nicht aus.
Übersicht der Änderungen (SevDesk Sync Log)
Jeder Lauf (geplant, Trockenlauf oder manuell über „Jetzt synchronisieren") erzeugt einen Eintrag im DocType SevDesk Sync Log mit Zeitpunkt, Zähler (angelegt/aktualisiert/bereits synchron/übersprungen/fehlgeschlagen) und Zusammenfassung. Über den Link „Details ansehen" bzw. direkt in ERPNext gelangt man zu den zugehörigen SevDesk Sync Log Item-Zeilen — einer Zeile pro angelegtem, aktualisiertem, übersprungenem oder fehlgeschlagenem (jeweils mit Grund/Fehlermeldung) Artikel. Das ist eine normale ERPNext-Listenansicht: filter-, sortier- und exportierbar (z. B. nach Excel). Artikel, die bereits synchron waren, werden dort nicht einzeln aufgeführt (nur als Zähler im Log-Kopf), um die Tabelle bei großen Katalogen nicht unnötig aufzublähen.
Fehlertoleranz: Schlägt der sevDesk-API-Aufruf für einen einzelnen Artikel fehl
(z. B. ungültige ID, vorübergehender API-Fehler), wird das als Fehler im Log erfasst
und der Lauf läuft für alle übrigen Artikel normal weiter — ein einzelner
fehlerhafter Artikel bricht nicht mehr den gesamten Sync ab.
Nutzung
Der Sync läuft automatisch täglich über den Frappe-Scheduler, sofern „Synchronisierung aktiv" angehakt ist. Ein manueller Lauf ist auch über die Bench-Console möglich:
bench --site execute sevdesk_sync.tasks.run_sync_now
run_sync_now respektiert dabei das „Trockenlauf"-Häkchen aus den Settings; für einen
erzwungenen Trockenlauf unabhängig davon gibt es sevdesk_sync.tasks.run_dry_run (das,
was auch der „Trockenlauf starten"-Button aufruft) sowie sevdesk_sync.tasks.test_connection
für den reinen Verbindungstest.
Tests
Die Kernlogik (price_sync.py, sevdesk_client.py, erpnext_source.py) ist reines
Python und lässt sich ohne laufende Bench-/ERPNext-Instanz testen. Für
erpnext_source.py wird frappe dabei durch ein minimales Fake-Modul ersetzt.
python3 -m unittest discover -s tests -v
sevdesk_sync_settings.py (die DocType-Controller-Klasse) benötigt hingegen eine
echte Bench-/Site-Umgebung und wird nicht durch diese Tests abgedeckt.
Unterstützen
Wenn dir dieses Projekt weiterhilft, freue ich mich über eine kleine Spende:
Für Unternehmen: Unterstützung für die Weiterentwicklung
Ihr setzt das Projekt im Betrieb ein und möchtet die Weiterentwicklung unterstützen? Gern auch mit Rechnung – einmalig oder monatlich. Auf Wunsch nenne ich euch hier unter „Unterstützer“ mit Firmenname und Link.
Bitte beachtet: Ich bin kein Profi-Entwickler, das Projekt ist mein Hobby. Eine Unterstützung ist deshalb kein Supportvertrag – Support, Reaktionszeiten oder Gewährleistung kann ich nicht anbieten. Wünsche und Verbesserungsvorschläge nehme ich aber gerne mit auf.
Kontakt: info@francetec.de
Unterstützer
Noch keine – über euren Namen hier würde ich mich freuen.
Related Integrations apps for Frappe & ERPNext
- Insights — Open Source Business Intelligence Tool
- Raven — Simple, open source team messaging platform
- Frappe Whatsapp — WhatsApp cloud integration for frappe
- Frappe Assistant Core — Infrastructure that connects LLMs to ERPNext. Frappe Assistant Core works with the Model Context Protocol (MCP) to expose ERPNext functionality to any compatible Language Model
- Biometric Attendance Sync Tool — A simple tool for syncing Biometric Attendance data with your ERPNext server
- Frappe React Sdk — React hooks for Frappe
- Frappe Js Sdk — TypeScript/JavaScript library for Frappe REST API
- Mcp — Frappe MCP allows Frappe apps to function as MCP servers