> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywise.de/llms.txt
> Use this file to discover all available pages before exploring further.

# sevdesk

> Offene Rechnungen aus sevdesk an paywise übergeben – inklusive Zahlungsziel und Mahnstufen

# paywise für sevdesk

<div style={{width: '64px', height: '64px', background: '#ffffff', borderRadius: '10px', display: 'flex', alignItems: 'center', justifyContent: 'center', padding: '10px', boxSizing: 'border-box'}}>
  <img src="https://mintcdn.com/paywisegmbh/wAdTkukMeudh23V7/images/integrations/sevdesk-icon.png?fit=max&auto=format&n=wAdTkukMeudh23V7&q=85&s=80a7fb4b2a867f69eb046c1871ff56ca" alt="sevdesk" style={{width: '100%', height: '100%', objectFit: 'contain', display: 'block'}} noZoom width="128" height="128" data-path="images/integrations/sevdesk-icon.png" />
</div>

Mit der sevdesk-Anbindung übergeben Sie offene Rechnungen aus Ihrem sevdesk-Konto
direkt an den paywise-Forderungseinzug. sevdesk liefert dabei besonders viel mit:
das **Zahlungsziel**, bereits gebuchte **Teilzahlungen** und Ihre **Mahnungen samt
Mahnstufe und Mahngebühr**.

<Note>
  paywise liest aus sevdesk und schreibt nichts zurück. In Ihrer Buchhaltung wird
  nichts geändert, storniert oder als bezahlt markiert.
</Note>

## Bevor Sie starten

* Ein sevdesk-Konto mit Zugriff auf die API.
* Ein paywise-Konto.
* Mindestens eine fertiggestellte, offene Rechnung in sevdesk.
* Für Ihr paywise-Unternehmen darf kein aktiver DATEV-Import bestehen. Deaktivieren
  Sie ihn unter **DATEV Einstellungen → Gefahrenzone → Integration deaktivieren**,
  bevor Sie sevdesk verbinden.

### Was paywise abruft

| Daten                  | Wofür paywise sie braucht                              |
| ---------------------- | ------------------------------------------------------ |
| Rechnungen             | Die offenen Forderungen, die Sie einreichen            |
| Rechnungspositionen    | Die Aufstellung, aus der sich der Betrag zusammensetzt |
| Kontakte               | Name und Anschrift des Schuldners                      |
| Zahlungen zur Rechnung | Der tatsächlich noch offene Betrag                     |
| Mahnungen              | Mahndatum, Mahnfrist, Mahnstufe und Mahngebühr         |
| Rechnungs-PDF          | Der Nachweis, der der Akte beigefügt wird              |

Der API-Token wird ausschließlich lesend verwendet.

## Den sevdesk-API-Token finden

In paywise erreichen Sie diese Anleitung jederzeit über den Link **„Was ist das?“**
auf der sevdesk-Seite.

<Steps>
  <Step title="In sevdesk anmelden">
    Melden Sie sich unter [my.sevdesk.de](https://my.sevdesk.de/) in Ihrem
    sevdesk-Konto an.
  </Step>

  <Step title="API-Bereich öffnen">
    Navigieren Sie im Menü zu **Erweiterungen → API**.
  </Step>

  <Step title="Token anzeigen">
    Klicken Sie auf **Einblenden**, um den API-Token sichtbar zu machen.
  </Step>

  <Step title="Token kopieren">
    Kopieren Sie den Schlüssel in die Zwischenablage.
  </Step>
</Steps>

<Warning>
  Der API-Token gilt für Ihr gesamtes sevdesk-Konto. Geben Sie ihn nie per E-Mail
  oder Chat weiter.
</Warning>

## 1. sevdesk verbinden

<Steps>
  <Step title="Verbindungsseite öffnen">
    Gehen Sie auf [app.paywise.de/connect/sevdesk/](https://app.paywise.de/connect/sevdesk/).
  </Step>

  <Step title="Token einfügen">
    Fügen Sie den kopierten Schlüssel in das Feld **API-Token** ein. Die
    **API Basis-URL** ist mit `https://my.sevdesk.de/api/v1` vorbelegt und muss in
    der Regel nicht geändert werden.
  </Step>

  <Step title="Bedingungen akzeptieren und testen">
    Setzen Sie das Häkchen bei **Ich akzeptiere die Nutzungsbedingungen** und wählen
    Sie **API-Token testen**.

    paywise prüft den Token direkt bei sevdesk. Ist die Prüfung erfolgreich, wird
    die Verbindung sofort gespeichert.
  </Step>
</Steps>

## 2. Rechnungen einreichen

<Steps>
  <Step title="Rechnungsauswahl öffnen">
    Wählen Sie auf der sevdesk-Seite in paywise **Rechnungen einreichen**.
  </Step>

  <Step title="Rechnungen auswählen">
    paywise listet Ihre offenen Rechnungen live aus sevdesk – mit Rechnungsnummer,
    Kunde, Rechnungsdatum, Fälligkeit, Gesamtbetrag und offenem Betrag.

    Die **Fälligkeit** berechnet paywise aus dem Rechnungsdatum plus dem in sevdesk
    hinterlegten Zahlungsziel. Sie müssen dafür in paywise nichts einstellen.
  </Step>

  <Step title="Schuldnerdaten prüfen">
    Name und Anschrift kommen aus dem sevdesk-Kontakt, das Rechnungs-PDF wird
    automatisch angehängt. Prüfen Sie die Angaben und ergänzen Sie, was fehlt.
  </Step>

  <Step title="Mahnungen kontrollieren">
    Mahnungen, die Sie in sevdesk zu der Rechnung erstellt haben, übernimmt paywise
    automatisch – mit Mahndatum, Zahlungsfrist und, sofern erhoben, der
    **Mahngebühr der jeweiligen Mahnstufe**. Haben Sie außerhalb von sevdesk
    gemahnt, ergänzen Sie das hier von Hand.
  </Step>

  <Step title="Auftrag absenden">
    Legen Sie fest, wie der Einzug starten soll, beantworten Sie die rechtlichen
    Fragen, akzeptieren Sie die Bedingungen und wählen Sie **Auftrag absenden**.
  </Step>
</Steps>

### Rechnungen, die nicht eingereicht werden können

* **Entwürfe und nicht fertiggestellte Rechnungen.** paywise liest nur
  fertiggestellte Rechnungen aus sevdesk.
* **Unvollständige Empfängerdaten.** paywise übernimmt die Rechnung als
  bearbeitbaren Entwurf. Ergänzen Sie Name und Anschrift in paywise, bevor Sie den
  Auftrag absenden.
* **Bereits eingereichte Rechnungen** werden als *Eingereicht* angezeigt.

## Mahnservice: Rechnungen laufend übernehmen

Diese Anbindung versorgt nicht nur den einmaligen Forderungseinzug, sondern auch den
**paywise-Mahnservice**. Dabei ruft paywise Ihre offenen Rechnungen regelmäßig ab und
mahnt sie in Ihrem Namen – bevor daraus ein Inkassofall wird. Sie richten den
Mahnservice unter [app.paywise.de/mahnservice/](https://app.paywise.de/mahnservice/)
ein.

### Voraussetzungen

Damit der laufende Abgleich startet, müssen alle folgenden Punkte erfüllt sein:

* Eine **aktive sevdesk-Verbindung** mit gültigem API-Token.
* Ein **gebuchter Mahnservice** und die **akzeptierten Mahnservice-AGB**.
* Ein festgelegter **Importumfang** – Sie entscheiden einmalig, welche Rechnungen
  übernommen werden sollen.

### Was paywise vor jeder Mahnung prüft

<Steps>
  <Step title="Regelmäßiger Abgleich">
    paywise ruft Ihre offenen Rechnungen aus sevdesk in festen Abständen ab. Neue
    offene Rechnungen kommen dabei automatisch dazu.
  </Step>

  <Step title="Statusprüfung unmittelbar vor dem Versand">
    Direkt bevor eine Mahnung rausgeht, fragt paywise den aktuellen Rechnungsstatus
    noch einmal in sevdesk ab. Ist die Rechnung inzwischen bezahlt oder storniert,
    wird nicht gemahnt.
  </Step>

  <Step title="Im Zweifel wird nicht gemahnt">
    Lässt sich der Status nicht zweifelsfrei feststellen – etwa weil sevdesk
    vorübergehend nicht erreichbar ist –, hält paywise die Mahnung zurück. Das ist
    bewusst so: Lieber eine Mahnung zu spät als eine an jemanden, der schon bezahlt
    hat.
  </Step>
</Steps>

Zahlungen, die paywise beim Abgleich in sevdesk findet, beenden das Mahnverfahren
automatisch.

## 3. Verbindung trennen

Wählen Sie auf der sevdesk-Seite **Verbindung löschen** und bestätigen Sie mit
**Löschen**.

paywise entfernt den hinterlegten Token und ruft keine Rechnungen mehr ab. Bereits
übergebene Forderungen sind davon nicht betroffen. Laufende Mahnverfahren, die von
dieser Verbindung abhängen, pausiert paywise beim Trennen. Nach dem Wiederverbinden
können Sie sie fortsetzen.

<Warning>
  Der Token selbst bleibt in sevdesk gültig. Soll er vollständig entwertet werden,
  setzen Sie ihn zusätzlich in sevdesk unter **Erweiterungen → API** zurück.
</Warning>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="„Der API-Token konnte nicht verifiziert werden“">
    Prüfen Sie, ob Sie den vollständigen Token kopiert haben (ohne Leerzeichen am
    Anfang oder Ende) und ob die API-Basis-URL unverändert ist.
  </Accordion>

  <Accordion title="„Ihr API-Token ist nicht mehr gültig“">
    Der Token wurde in sevdesk zurückgesetzt oder entzogen. Holen Sie sich unter
    **Erweiterungen → API** einen aktuellen Token und hinterlegen Sie ihn erneut.
  </Accordion>

  <Accordion title="Die Rechnungsliste ist leer">
    paywise zeigt nur fertiggestellte, offene Rechnungen. Entwürfe erscheinen nicht.
    Prüfen Sie den Status der Rechnung in sevdesk.
  </Accordion>

  <Accordion title="Der offene Betrag stimmt nicht">
    paywise zieht die in sevdesk gebuchten Zahlungen vom Bruttobetrag ab. Ist eine
    Zahlung in sevdesk noch nicht der Rechnung zugeordnet, taucht sie hier nicht
    auf. Ordnen Sie die Zahlung in sevdesk zu und laden Sie die Liste neu.
  </Accordion>

  <Accordion title="Eine Anbindung ist bereits aktiv">
    Eine andere Importquelle steht mit sevdesk in Konflikt. Deaktivieren Sie einen
    in der Meldung genannten DATEV-Import; andere dort genannte Anbindungen trennen
    Sie. Versuchen Sie es anschließend erneut.
  </Accordion>
</AccordionGroup>

## Fragen

Schreiben Sie an [info@paywise.de](mailto:info@paywise.de).