← Alle Themen · Anbindungen

In diesem Artikel 7 Kapitel
  1. Sevdesk-Konten (Multi-Account)
  2. Marktplatz-Konfiguration
  3. Steuersatz-Zuordnungen (OSS)
  4. Sammelbeleg manuell erstellen
  5. Sammelbelege (Übersicht)
  6. Fehlende Belege
  7. Automatischer Cron

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:

FeldBeschreibung
NameFrei wählbarer Name für dieses Konto (z.B. "Firma A Sevdesk")
MandantDer zugehörige Mandant aus Ihrer Scanalot-Konfiguration (siehe Einstellungen → Mandanten)
API-TokenIhr Sevdesk-API-Token (finden Sie in Sevdesk unter Einstellungen → Benutzer → API-Token)
LieferantennameDer Name, unter dem Belege in Sevdesk als Lieferant erscheinen
AktivJa 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:

FeldBeschreibung
MarktplatzWä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 aktivJa oder Nein
AktivJa 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% und Brutto = Netto an 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:

FeldBeschreibung
Ländercode (ISO 2)Zweistelliger Ländercode, z.B. "FR" für Frankreich, "IT" für Italien, "ES" für Spanien
Sevdesk TaxSet IDDie 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

  1. Konto wählen: Wählen Sie ein bestimmtes Sevdesk-Konto oder "Alle Konten".
  2. Datum eingeben: Wählen Sie das Datum, für das Sammelbelege erstellt werden sollen.
  3. "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

FilterBeschreibung
Von / BisZeitraum eingrenzen
KontoNach Sevdesk-Konto filtern (oder "Alle")
MarktplatzNach Marktplatz filtern (oder "Alle")
BelegnummerSucht den Sammelbeleg, der eine bestimmte Belegnummer enthält
StatusAlle 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

SpalteBeschreibung
DatumBelegdatum
KontoName des Sevdesk-Kontos
MarktplatzMarktplatz-Name
MwStSteuersatz in Prozent
TypRechnungen oder Gutschriften
BelegeAnzahl der enthaltenen Einzelbelege
BruttoBrutto-Gesamtbetrag
Status"uploaded" (grün) oder "failed" (rot)

Aktionen pro Sammelbeleg

ButtonFarbeBeschreibung
PDFBlauÖffnet das generierte Sammelbeleg-PDF in einem neuen Tab
CSVGrünLädt die zugehörige CSV-Datei herunter
Erneut sendenOrangeErscheint 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

  1. Jahr wählen: Wählen Sie das zu prüfende Jahr.
  2. Konto wählen: Ein bestimmtes Konto oder "Alle Konten".
  3. Gruppierung wählen: Bestimmt, wie die fehlenden Belege bei der Nachgenerierung zusammengefasst werden:
  4. Pro Tag → Ein Sammelbeleg pro Tag
  5. Pro Monat → Ein Sammelbeleg pro Monat (Standard)
  6. Pro Jahr → Ein Sammelbeleg für das ganze Jahr
  7. "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.