← Alle Themen · Anbindungen
In diesem Artikel 7 Kapitel
Sevdesk Anbindung
Zurück zur Übersicht | Anbindungen
Die Sevdesk-Anbindung ermöglicht es, Rechnungen und Gutschriften automatisch an Ihre Sevdesk-Buchhaltung zu übertragen. Sie unterstützt mehrere Sevdesk-Konten, Sammelbelege pro Marktplatz und die OSS-Steuersatz-Zuordnung für EU-Länder.
Sie finden die Seite unter Anbindungen → Sevdesk.
Sevdesk-Konten (Multi-Account)
Im oberen Bereich sehen Sie die Tabelle Sevdesk-Konten. Sie können mehrere Sevdesk-Konten anlegen, z.B. eines pro Firma oder Mandant.
Konto anlegen
Klicken Sie auf Neues Konto (grüner Button oben rechts in der Tabelle). Im Dialog füllen Sie folgende Felder aus:
| Feld | Beschreibung |
|---|---|
| Name | Frei wählbarer Name für dieses Konto (z.B. "Firma A Sevdesk") |
| Mandant | Der zugehörige Mandant aus Ihrer Scanalot-Konfiguration (siehe Einstellungen → Mandanten) |
| API-Token | Ihr Sevdesk-API-Token (finden Sie in Sevdesk unter Einstellungen → Benutzer → API-Token) |
| Lieferantenname | Der Name, unter dem Belege in Sevdesk als Lieferant erscheinen |
| Aktiv | Ja oder Nein → inaktive Konten werden bei der automatischen Verarbeitung übersprungen |
Konto auswählen und bearbeiten
- Klicken Sie auf eine Zeile in der Konten-Tabelle, um dieses Konto auszuwählen. Unterhalb der Tabelle erscheinen dann die Konfigurationsbereiche (Marktplätze, Steuersätze) für das ausgewählte Konto.
- Der Stift-Button öffnet den Bearbeitungsdialog.
- Der Papierkorb-Button löscht das Konto und alle zugehörigen Konfigurationen (nach Bestätigung).
In der Tabelle wird der API-Token aus Sicherheitsgründen nur mit den letzten 6 Zeichen angezeigt.
Marktplatz-Konfiguration
Unterhalb des ausgewählten Kontos finden Sie die Marktplatz-Konfiguration. Hier legen Sie fest, wie Belege pro Marktplatz in Sevdesk verbucht werden.
Marktplatz hinzufügen
Klicken Sie auf Neuer Marktplatz. Im Dialog konfigurieren Sie:
| Feld | Beschreibung |
|---|---|
| Marktplatz | Wählen Sie einen Marktplatz aus der Liste (die verfügbaren Marktplätze stammen aus Ihren unter Anbindungen eingerichteten Kanälen) |
| Pay-Account ID | (Optional) Die Pay-Account-ID in Sevdesk, falls Sie Zahlungen einem bestimmten Konto zuordnen möchten |
| Kostenstelle ID | (Optional) Die Kostenstellen-ID in Sevdesk |
| Buchungskonto (Rechnung) | Name des Buchungskontos für Rechnungen (z.B. "Einnahmen Warenverkauf") |
| Buchungstyp (Rechnung) | ID des Buchungstyps für Rechnungen in Sevdesk (z.B. "882665") |
| Buchungskonto (Gutschrift) | Name des Buchungskontos für Gutschriften (z.B. "Einnahmenminderung Warenverkauf") |
| Buchungstyp (Gutschrift) | ID des Buchungstyps für Gutschriften in Sevdesk (z.B. "885308") |
| Sammelbeleg aktiv | Ja oder Nein |
| Aktiv | Ja oder Nein |
Sammelbeleg-Toggle
In der Marktplatz-Tabelle finden Sie die Spalte Sammelbeleg mit einem Schalter (Toggle). Dieser kann direkt in der Tabelle umgeschaltet werden:
- Aktiv: Belege dieses Marktplatzes werden nicht einzeln hochgeladen, sondern gesammelt als Sammelbeleg verarbeitet. Das Event "Dokument bei Sevdesk hochladen" überspringt automatisch Einzelbelege für diesen Marktplatz.
- Inaktiv: Belege werden einzeln über Events an Sevdesk gesendet.
Hinweis: Wenn der Sammelbeleg für einen Marktplatz aktiv ist, wird der Einzel-Upload über das Event "Dokument bei Sevdesk hochladen" automatisch übersprungen.
Steuersatz-Zuordnungen (OSS)
Für den EU-weiten Versand mit dem One-Stop-Shop-Verfahren (OSS) können Sie hier länderspezifische Steuersätze ihren Sevdesk-TaxSet-IDs zuordnen.
Sevdesk V2 → OSS-Sätze werden Netto unter 0% gebucht
Sevdesk V2 erlaubt nur die deutschen Standardsätze (0%, 5%, 7%, 16%, 19%) als Steuerregel. OSS-Sätze wie 20% (AT), 21% (FR/NL/BE), 25% (DK/SE/HR), 25,5% (FI) usw. würde Sevdesk ablehnen.
Die Anbindung normalisiert solche Belege deshalb automatisch:
- Inland 0% / 5% / 7% / 16% / 19%: unverändert mit korrektem Brutto/Netto/USt-Split.
- Alle anderen Sätze (OSS, Auslandsmärkte): der Sammelbeleg wird mit
taxRate=0%undBrutto = Nettoan Sevdesk übergeben. Der Original-Satz bleibt zur Nachvollziehbarkeit als Tag in der Belegbeschreibung erhalten, z.B.[OSS 20% → Netto in DE-Buchhaltung, USt extern].
Das ist steuerlich korrekt: für die deutsche GuV zählt nur der Netto-Erlös, die OSS-USt wird separat über das OSS-Portal beim BZSt gemeldet (außerhalb von Sevdesk). Ihr Steuerberater sieht im Sevdesk-Auszug pro OSS-Land den Netto-Erlös auf dem konfigurierten OSS-Erlöskonto.
Hinweis: Bei Sevdesk V1 (Legacy) bleibt die TaxSet-Zuordnung unten weiterhin aktiv, weil V1 länderspezifische Steuersätze über das
taxSet-Feld unterstützt. Erst bei V2-Konten greift die 0%-Normalisierung.
Steuersatz hinzufügen
Klicken Sie auf Neuer Steuersatz. Im Dialog füllen Sie aus:
| Feld | Beschreibung |
|---|---|
| Ländercode (ISO 2) | Zweistelliger Ländercode, z.B. "FR" für Frankreich, "IT" für Italien, "ES" für Spanien |
| Sevdesk TaxSet ID | Die ID des Steuersatzes in Sevdesk (finden Sie in Sevdesk unter Einstellungen → Steuersätze) |
| Steuersatz (%) | Der zugehörige Steuersatz, z.B. 20.00 |
So wird beim Erstellen von Sammelbelegen der korrekte länderspezifische Steuersatz in Sevdesk verwendet.
Sammelbeleg manuell erstellen
Im Bereich Sammelbeleg manuell erstellen können Sie auf Knopfdruck Sammelbelege für ein bestimmtes Datum generieren.
Vorgehensweise
- Konto wählen: Wählen Sie ein bestimmtes Sevdesk-Konto oder "Alle Konten".
- Datum eingeben: Wählen Sie das Datum, für das Sammelbelege erstellt werden sollen.
- "Sammelbelege generieren" klicken.
Was passiert?
Pro Kombination aus Marktplatz + Steuersatz + Belegtyp wird ein Sammelbeleg erstellt:
- Rechnungen = Rechnungen (invoice) + Storno-Rechnungen (stornoinvoice)
- Gutschriften = Gutschriften (creditnote) + Storno-Gutschriften (stornocredit)
Für jeden Sammelbeleg werden automatisch ein PDF und eine CSV-Datei generiert und bei Sevdesk hochgeladen.
Ergebnis-Anzeige
Nach der Generierung zeigt eine Liste die erstellten Sammelbelege mit:
- Konto, Marktplatz, Steuersatz, Typ (Rechnungen/Gutschriften)
- Anzahl der enthaltenen Belege
- Brutto-Gesamtbetrag
- Status (grüner Haken = erfolgreich hochgeladen, rotes Kreuz = Fehler)
Sammelbelege (Übersicht)
Die Tabelle Sammelbelege zeigt alle erstellten Sammelbelege mit Filtermöglichkeiten.
Filter
| Filter | Beschreibung |
|---|---|
| Von / Bis | Zeitraum eingrenzen |
| Konto | Nach Sevdesk-Konto filtern (oder "Alle") |
| Marktplatz | Nach Marktplatz filtern (oder "Alle") |
| Belegnummer | Sucht den Sammelbeleg, der eine bestimmte Belegnummer enthält |
| Status | Alle Status, "uploaded" (erfolgreich) oder "failed" (fehlgeschlagen) |
Klicken Sie auf den Suchen-Button (Lupe), um die Filter anzuwenden. Mit Filter zurücksetzen setzen Sie alle Filter zurück.
Spalten der Tabelle
| Spalte | Beschreibung |
|---|---|
| Datum | Belegdatum |
| Konto | Name des Sevdesk-Kontos |
| Marktplatz | Marktplatz-Name |
| MwSt | Steuersatz in Prozent |
| Typ | Rechnungen oder Gutschriften |
| Belege | Anzahl der enthaltenen Einzelbelege |
| Brutto | Brutto-Gesamtbetrag |
| Status | "uploaded" (grün) oder "failed" (rot) |
Aktionen pro Sammelbeleg
| Button | Farbe | Beschreibung |
|---|---|---|
| Blau | Öffnet das generierte Sammelbeleg-PDF in einem neuen Tab | |
| CSV | Grün | Lädt die zugehörige CSV-Datei herunter |
| Erneut senden | Orange | Erscheint nur bei fehlgeschlagenen Belegen → sendet den Sammelbeleg erneut an Sevdesk |
Fehlende Belege
Der Bereich Fehlende Belege prüft, ob alle Belege eines Zeitraums in Sammelbelegen enthalten sind.
Vorgehensweise
- Jahr wählen: Wählen Sie das zu prüfende Jahr.
- Konto wählen: Ein bestimmtes Konto oder "Alle Konten".
- Gruppierung wählen: Bestimmt, wie die fehlenden Belege bei der Nachgenerierung zusammengefasst werden:
- Pro Tag → Ein Sammelbeleg pro Tag
- Pro Monat → Ein Sammelbeleg pro Monat (Standard)
- Pro Jahr → Ein Sammelbeleg für das ganze Jahr
- "Prüfen" klicken.
Ergebnis
- Wenn Belege fehlen, wird eine Tabelle angezeigt, gruppiert nach Konto + Marktplatz + Steuersatz + Typ, mit der Anzahl fehlender Belege und dem Brutto-Gesamtbetrag.
- Wenn keine Belege fehlen, erscheint ein grüner Haken mit der Meldung "Keine fehlenden Belege gefunden."
Fehlende Belege nachgenerieren
Wenn fehlende Belege gefunden wurden, erscheint der Button Alle fehlenden als Sammelbelege erstellen. Dieser generiert für alle fehlenden Gruppen Sammelbelege gemäß der gewählten Gruppierung und lädt sie bei Sevdesk hoch.
Automatischer Cron
Täglich um 06:00 Uhr werden automatisch Sammelbelege für den Vortag erstellt. Dies betrifft alle Marktplätze, bei denen der Sammelbeleg-Toggle aktiviert ist. So müssen Sie im Regelfall keine manuellen Sammelbelege erstellen.
Falls der automatische Lauf fehlschlägt, können Sie die fehlenden Belege über den Bereich Fehlende Belege prüfen und nachgenerieren.