sevdesk mit Billbee verbinden

Du hast die Möglichkeit, deinen Billbee Account mit sevdesk zu verbinden. sevdesk ist eine cloudbasierte Rechnungs- und Buchhaltungssoftware, die über die offizielle API direkt mit Billbee verbunden werden kann. Wie du sevdesk an Billbee anbindest, kannst du in diesem Artikel nachlesen.

Schritt-für-Schritt Anleitung zur Einrichtung

Für die Einrichtung deines sevdesk Accounts bei Billbee musst du zuerst Daten aus deinem sevdesk Account entnehmen. Anschließend kannst du dann die Anbindung von deinem sevdesk Account an Billbee vornehmen.

Voreinstellungen bei sevdesk

Damit du sevdesk an Billbee anbinden kannst, benötigst du einen sevdesk Account. Logge dich dort entweder ein oder lege einen neuen Account an. Gehe anschließend in deinem sevdesk Account in deine Einstellungen und dann in den Reiter "Benutzer". Hier siehst du alle Benutzer:innen deines sevdesk Accounts. Klicke nun auf deinen Administrator-Zugang. Hier öffnet sich ein Fenster, in dem du deinen API-Token entnehmen kannst, indem du im Feld des API-Tokens auf "Einblenden" klickst. Dann wirst du aufgefordert, dein Passwort einzugeben. Anschließend kannst du deinen API-Token kopieren. 

sevdesk mit Billbee verbinden

Nachdem du deinen API-Token hast, kannst du mit der Anbindung von sevdesk an Billbee beginnen. Um eine neue Buchhaltungsschnittstelle bei Billbee einzurichten, rufe zunächst deine Einstellungen / Buchhaltung & Mahnwesen auf. Dann klickst du den "+Neu"- Button an und wählst im Dropdownmenü "mit sevdesk verbinden" aus. 

Im nächsten Fenster kannst du alle Einstellungen rund um deine sevdesk Anbindung vornehmen. Im ersten Reiter "Allgemeine Einstellungen" kannst du allgemeine Einstellungen vornehmen:

1

Name: Gib einen internen Namen für deine sevdesk Anbindung ein. 

2

Startdatum:Wähle aus, ab welchem Datum deine Bestellungen an sevdesk übertragen werden sollen.

3

Shops: Du kannst einschränken, ob Bestellungen nur von bestimmten Shops oder von allen Shops übertragen werden sollen. Klickst du in dieses Feld, dann erhältst du eine Übersicht deiner angebundenen Shops und Marktplätze. Du musst hier aber mindestens eine Shopverbindung auswählen, damit die Übertragung funktioniert.

4

Status: Wähle aus, in welchem Status sich die Bestellung befinden soll, wenn sie übermittelt wird. Bedenke hierbei, dass es nicht darum geht, dass sich die Bestellung jemals in diesem Status befunden hat, sondern ob sie zum Zeitpunkt der Übertragung zu sevdesk in diesem Status ist. Daher ist es ratsam, dass du mehrere Status wählst, in denen sich Bestellungen länger oder sogar final befinden (z.B bezahlt, versendet und abgeschlossen). Du musst hier mindestens einen Status ausgewählt haben, damit die Übertragung funktioniert.

Im zweiten Reiter "API Anbindung" kannst du alle API-spezifischen Einstellungen vornehmen und auch deinen API-Token hinterlegen.

1

System für Zahlungsabgleich: Wähle aus, ob der Zahlungsabgleich bei Billbee oder bei sevdesk stattfinden soll. Wählst du Billbee aus, dann werden die bezahlten Bestellungen (d. h. Bestellungen mit Zahldatum) als bezahlt an sevdesk übermittelt. Wenn du sevdesk auswählst, dann werden die bezahlten Rechnungen als offen übermittelt.

2

API Key: Gib hier den API-Token ein, den du zuvor aus deinem sevdesk Account kopiert hast.

3

Vollständige Kunden (*)  anlegen: Wähle aus, ob für jeden Billbee Kundendatensatz auch ein Datensatz in sevdesk angelegt werden soll.

4

Nicht zugeordnete Zahlungen als Standard-Zahlung buchen: Wähle aus, ob nicht zugeordnete Zahlungen bei sevdesk als Standard-Zahlungen gebucht werden sollen.

5

Belegdatum entspricht: Gib an, ob das Belegdatum dem Rechnungsdatum, dem Zahldatum oder dem Bestelldatum entsprechen soll.

Nachdem du alle Angaben gemacht hast, kannst du deine neue sevdesk Anbindung speichern.

Kontozuweisung

Nach der erfolgreichen Anbindung von sevdesk an dein Billbee-Konto, kannst du im dritten Reiter "Kontozuweisung" über den Button "Neu" eine neue Kontozuweisung vornehmen. Grundsätzlich kannst du deine Zahlungsarten nur Verrechnungskonten (ehem. Offline-Konto) zuweisen, weil Billbee keine Berechtigung für das Zuweisen von Zahlungen auf echte Konten hat. Richte dir bei sevdesk deshalb ein entsprechendes Verrechnungskonto ein, welches du anschließend bei Billbee für eine bestimmte Zahlart auswählst. Die Zahlungen kannst du im Nachgang direkt bei sevdesk den richtigen Konten zuordnen. Es bietet sich an, wenn du z. B. für jeden angebundenen Shop oder für Kostenstellen ein Verrechnungskonto bei sevdesk anlegst und dann die Zahlungen im Nachhinein bei sevdesk richtig zuordnest. Außerdem funktioniert die Kontozuweisung nur, wenn Billbee als System für den Zahlungsabgleich ausgewählt ist.

Umsatzsteuerregelung

Nach der erfolgreichen Anbindung von sevdesk an dein Billbee-Konto werden dir beim erneuten Öffnen der Anbindung im Reiter "API Anbindung" zusätzlich die Optionen zu den Umsatzsteuerreglungen angezeigt, sofern in deinem sevdesk-Account unter Einstellungen → Buchhaltung → Umsatzsteuerregelungen mindestens eine Regelung von dir angelegt wurde.

Hast du in sevdesk die entsprechenden Umsatzsteuerregelungen angelegt, kannst du sie nun in den Drop-Down Menüs auswählen und somit zuordnen.

Damit diese in Billbee sichtbar werden, musst du in sevdesk unter Einstellungen → Buchhaltung → Umsatzsteuerregelungen bei den jeweiligen Regelungen jeweils den Schalter "Für Rechnungen" aktivieren.

Die entsprechenden Hinweistexte zu den einzelnen Steuermodi kannst du hier hinterlegen.

Länderzuweisung für OSS

Hast du in sevdesk Regelungen für OSS erstellt, können diese über Billbee entsprechend gemappt werden. Sollten bereits im Vorfeld allgemeine Mappings in der sevdesk-Anbindung für die Umsatzsteuerregelungen vorhanden gewesen sein, so werden diese jetzt den jeweiligen Umsatzsteuerregelungen für alle Länder hinzugefügt.

Ein Mapping kann für folgende Umsatzsteuerregelungen vorgenommen werden:

• Umsatzsteuerregelung Ust. ausweisen (OSS)
• Umsatzsteuerregelung IGL (netto)
• Umsatzsteuerregelung Export Drittland (netto)
• Umsatzsteuerregelung Differenzbesteuerung (brutto)

Bitte beachte:

• Für ein erfolgreiches Mapping von OSS-Bestellungen muss es sich auch tatsächlich um Fernverkauf-Bestellungen handeln (die Bestellung in Billbee muss also das entsprechende Fernverkauf-Tag tragen). Maßgebend für die Zuordnung ist in dem Fall die Lieferadresse.
• Hast du bereits eine sevdesk Anbindung in Billbee und fügst in sevdesk die entsprechenden Regelungen hinzu, greifen diese erst, wenn du in Billbee die sevdesk Verbindung erneut öffnest und auf "Speichern" klickst.

Wichtig / zu beachten

Automatischer Export und Rechnungen als Belege bei sevdesk

Exportiert Billbee Rechnungen zu sevdesk, dann werden diese als "Belege" abgelegt. Damit die Rechnungen aber überhaupt bei sevdesk erscheinen, ist es wichtig, dass die Rechnung auch vorher in Billbee erzeugt wird. Nach dem Erzeugen der Rechnung kann es ca. 3–4 Stunden dauern, bis der Beleg bei sevdesk erscheint, da der Upload alle paar Stunden im Hintergrund ausgeführt wird.

Manueller Export von Rechnungen an sevdesk

Du musst nicht auf den automatischen Export im Hintergrund warten, sondern kannst auch einen manuellen Export der Rechnungen an sevdesk anstoßen. Hierfür folge bitte der Anleitung für das Exportieren von Bestellungen und wähle im Exportvorgang deine sevdesk-Anbindung als Exportformat aus. Du kannst auch noch entscheiden, ob die exportierten Bestellungen das Tag "sevdesk" erhalten sollen. Nachdem du auf "Exportdatei erzeugen" klickst, wird die Übertragung angestoßen. Wundere dich nicht, dass keine Datei o. Ä. dann heruntergeladen wird, denn die Daten werden direkt zu sevdesk übertragen. Während beim automatischen Export (dieser erfolgt in der Regel 3 -4 Stunden, nachdem die Rechnung erzeugt wurde) nur Rechnungen übertragen werden, die bisher nicht übertragen wurden, können die Rechnungen manuell auch mehrfach übertragen werden.

Beim manuellen Export kannst du auch Bestellungen exportieren, für welche du noch keine Rechnung erzeugt hast. Bitte beachte hierbei, dass du im Reiter "API Anbindung" unter Punkt 5 (siehe oben) für diesen Fall nicht das Rechnungsdatum hinterlegen darfst, da beim Export sonst auf das nicht vorhandene Rechnungsdatum geprüft werden würde und es zu einer Fehlermeldung kommt.

Hinweise zur sevdesk API V2

sevdesk nimmt aktuell Änderungen an ihrer API vor. Bis Ende dieses Jahres soll die API V1 von sevdesk abgeschaltet werden.

Wurdest du bereits von sevdesk auf die V2 umgestellt oder ist dein sevdesk-Account jünger als 3 Monate, betreffen dich diese Änderungen:

• OSS wird aktuell über die V2 bisher nicht von sevdesk unterstützt, eine entsprechende Implementierung soll aber bis Ende des Jahres folgen.
• Bei den Steuermodi "Drittland" / "Innergemeinschaftliche Leistung" und "Differenzbesteuerung" kann ein Export zu sevdesk nur noch erfolgen, wenn ein entsprechendes Mapping konfiguriert wurde. Es können hierbei aktuell trotzdem noch Fehler auftreten, da die API V2 von sevdesk bisher nicht vollständig konfiguriert ist. Alle Informationen zum Mapping findest du hier.

Kann eine Bestellung mit einer Rechnung aufgrund der Änderungen an der API nicht mehr zu sevdesk exportiert werden, erhältst du folgende Fehlermeldung:

"sevdesk API Version 2.0 wird aktuell nicht vollständig unterstützt. Es ist aktuell nur ein Export von umsatzsteuerpflichtigen Einnahmebelegen möglich."

Mögliche Fehlercodes & ihre Bedeutung

Nachfolgend findest du einige Fehlerbenachrichtigungen, die im Zusammenhang mit der Anbindung der sevdesk-Schnittstelle oder mit dem Export von Bestellungen zu sevdesk auftauchen können.

(*) Wie du vielleicht schon gesehen hast, gendern wir auf unserer Webseite, unserer Hilfeseite und in unserer Außenkommunikation, da Billbee für mehr Vielfalt im E-Commerce stehen soll – und das auf allen Ebenen. Die Namen für Bereiche/Buttons/Einstellungen kommen direkt aus der Softwarelösung, wo aktuell nicht gegendert wird. Um hier keine Verwirrung aufkommen zu lassen, haben wir uns dazu entschieden, dass wir die direkten Namen aus der Software auf der Hilfeseite in diesem Fall übernehmen.