> ## 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.

# easyVerein

> Offene Vereinsrechnungen und Mitgliedsbeiträge aus easyVerein an paywise übergeben

# paywise für easyVerein

<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/easyverein-icon.png?fit=max&auto=format&n=wAdTkukMeudh23V7&q=85&s=468b974d389edc80b9f6909c27bb24e2" alt="easyVerein" style={{width: '100%', height: '100%', objectFit: 'contain', display: 'block'}} noZoom width="128" height="128" data-path="images/integrations/easyverein-icon.png" />
</div>

Mit der easyVerein-Anbindung übergeben Sie offene Forderungen Ihres Vereins –
Mitgliedsbeiträge, Rechnungen, Spenden – direkt an den paywise-Forderungseinzug. Sie
hinterlegen dafür einen eigenen API-Schlüssel für paywise; Ihre easyVerein-Zugangsdaten
geben Sie nicht heraus.

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

## Bevor Sie starten

* Ein easyVerein-Konto, in dem Sie API-Schlüssel erzeugen dürfen.
* Ein paywise-Konto.
* Mindestens eine offene Rechnung in easyVerein.

<Note>
  easyVerein ist eine eigene Quelle für den Forderungseinzug. Die Verbindung kann
  parallel zu einer Buchhaltungs- oder DATEV-Verbindung aktiv sein. Ist easyVerein
  verbunden, verwendet die Rechnungsauswahl easyVerein.
</Note>

### Was paywise abruft

| Daten                          | Wofür paywise sie braucht                                     |
| ------------------------------ | ------------------------------------------------------------- |
| Organisationsidentität         | Erkennt, zu welchem Verein der Schlüssel gehört               |
| Mitglieder- und Kontaktdaten   | Name und Anschrift des Schuldners                             |
| Rechnungsdaten und -positionen | Die offenen Forderungen und ihre Zusammensetzung              |
| Zahlungsdifferenzen            | Der tatsächlich noch offene Betrag                            |
| Bankverbindungsdaten           | Zuordnung eingehender Zahlungen                               |
| Rechnungs-PDF                  | Der Nachweis, sofern easyVerein ihn über die API bereitstellt |

Der API-Schlüssel wird ausschließlich lesend verwendet.

## Den easyVerein-API-Schlüssel erstellen

In paywise erreichen Sie diese Anleitung jederzeit über **So erstellen Sie einen
API-Schlüssel** auf der easyVerein-Seite.

<Steps>
  <Step title="API-Einstellungen öffnen">
    Öffnen Sie
    [easyverein.com/app/settings/easyVereinApi/](https://easyverein.com/app/settings/easyVereinApi/)
    und wechseln Sie zu **Einstellungen → easyVerein API**.
  </Step>

  <Step title="Eigene Administratorgruppe wählen">
    Wählen oder erstellen Sie eine eigene Administratorgruppe für paywise und
    vergeben Sie nur die erforderlichen Rechte.
  </Step>

  <Step title="Separaten Schlüssel erstellen">
    Erstellen Sie für paywise einen **separaten** API-Schlüssel. Verwenden Sie
    diesen Schlüssel für keinen anderen Zweck.
  </Step>

  <Step title="Schlüssel kopieren und einfügen">
    Kopieren Sie den neu erzeugten Schlüssel einmal und fügen Sie ihn direkt in das
    Feld bei paywise ein.
  </Step>
</Steps>

<Warning>
  Senden Sie den API-Schlüssel niemals per E-Mail oder Chat.
</Warning>

<Info>
  **Gültigkeit und Erneuerung.** Laut easyVerein-Hilfe ist ein neuer API-Schlüssel
  30 Tage gültig und kann ab dem 15. Tag erneuert werden. **paywise übernimmt die
  regelmäßige Erneuerung automatisch** – Sie müssen den Schlüssel nicht turnusmäßig
  austauschen.
</Info>

## 1. easyVerein verbinden

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

  <Step title="Schlüssel einfügen">
    Fügen Sie den Schlüssel in das Feld **easyVerein API-Schlüssel** ein.
  </Step>

  <Step title="Bedingungen akzeptieren und prüfen">
    Setzen Sie das Häkchen bei **Ich akzeptiere die Nutzungsbedingungen** und wählen
    Sie **API-Schlüssel prüfen und verbinden**.
  </Step>
</Steps>

Nach dem Verbinden zeigt die Seite den **verbundenen Verein**.

## 2. Rechnungen einreichen

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

  <Step title="Rechnungen auswählen">
    paywise listet Ihre offenen Rechnungen live aus easyVerein – mit
    Rechnungsnummer, Empfänger, Rechnungsdatum, Betrag und offenem Betrag.
  </Step>

  <Step title="Schuldnerdaten prüfen">
    Name und Anschrift kommen aus den Mitglieds- bzw. Kontaktdaten in easyVerein,
    ein verfügbares Rechnungs-PDF wird automatisch angehängt. Fehlt das Dokument,
    zeigt paywise einen Hinweis; laden Sie es vor dem Absenden manuell hoch. Prüfen
    Sie außerdem die Empfängerdaten und ergänzen Sie, was fehlt.
  </Step>

  <Step title="Mahnung erfassen">
    easyVerein stellt Mahnungen nicht über die Schnittstelle bereit. Tragen Sie hier
    ein, wie und wann Sie zur Zahlung aufgefordert haben – schriftlich oder
    mündlich, mit Datum und gesetzter Zahlungsfrist.

    Das ist rechtlich relevant: Gegenüber Verbrauchern – und Vereinsmitglieder sind
    das in der Regel – ist eine Mahnung meist Voraussetzung dafür, dass
    Verzugszinsen und Inkassokosten geltend gemacht werden können.
  </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

paywise prüft jede Rechnung streng und lehnt im Zweifel ab, statt eine zweifelhafte
Forderung anzulegen:

* **Nur bestimmte Rechnungsarten** sind einreichbar: Mitgliedsbeitrag, Einnahme,
  Saldo und Spende.
* **Entwürfe, Vorlagen, Anfragen und Quittungen** sind ausgeschlossen.
* **Angebote** sind ausgeschlossen – auch dann, wenn nur eine Angebotsnummer oder
  ein Angebotsgültigkeitsdatum gesetzt ist.
* **Stornierte Rechnungen und Stornobelege** sind ausgeschlossen.
* **Vollständig bezahlte und überzahlte Rechnungen** sind ausgeschlossen.
* **Bereits eingereichte Rechnungen** werden als *Eingereicht* angezeigt.

<Note>
  **Der Mitgliedschaftsantrag wird nicht mitimportiert.** easyVerein führt zwar ein
  Feld „Mitgliedschaftsantrag“ am Mitglied, dessen Bezug zu einer konkreten Rechnung
  aber nicht gesichert ist. paywise übernimmt dieses Dokument deshalb bewusst nicht –
  reichen Sie es bei Bedarf manuell zur Akte nach.
</Note>

## 3. Verbindung trennen

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

Der hinterlegte API-Schlüssel wird entfernt und paywise ruft keine Rechnungen mehr
ab. Bereits übergebene Forderungen sind davon nicht betroffen. Sie können easyVerein
anschließend jederzeit erneut verbinden.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="„Der easyVerein API-Schlüssel konnte nicht geprüft werden“">
    Kontrollieren Sie, ob Sie den vollständigen Schlüssel eingefügt haben und ob die
    Administratorgruppe in easyVerein die nötigen Leserechte besitzt.
  </Accordion>

  <Accordion title="„Verbindung erneuern: Ihr easyVerein API-Schlüssel ist nicht mehr gültig“">
    Der Schlüssel wurde in easyVerein gelöscht oder ist über die Erneuerungsfrist
    hinaus abgelaufen. Erstellen Sie einen neuen Schlüssel und hinterlegen Sie ihn.
  </Accordion>

  <Accordion title="Eine Rechnung fehlt in der Liste">
    Prüfen Sie die Rechnungsart und den Status: Entwürfe, Vorlagen, Angebote,
    Stornos sowie bezahlte und überzahlte Rechnungen werden bewusst nicht angeboten.
  </Accordion>
</AccordionGroup>

## Fragen

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