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

# apaleo

> Offene Debitorenrechnungen aus apaleo an paywise übergeben

# paywise für apaleo

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

paywise zieht unbezahlte Rechnungen ein. Mit der apaleo-Anbindung übergeben Sie eine
offene Debitorenrechnung – ein Aufenthalt, der **auf Rechnung** ausgecheckt und nie
bezahlt wurde – direkt aus Ihrem Property-Management-System an paywise, ohne Gast,
Betrag oder Rechnungsdokument abzutippen.

Typische Fälle sind Firmenbuchungen, Veranstalter und Langzeitgäste, bei denen keine
Karte hinterlegt ist und per Überweisung gezahlt wird.

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

## Bevor Sie starten

* Ein apaleo-Konto mit mindestens einer Property und der Berechtigung, Apps dafür zu
  autorisieren.
* Ein paywise-Konto. Sie können es auch während der Verbindung neu anlegen – eine
  vorherige Registrierung ist nicht nötig.
* Mindestens eine Rechnung in apaleo, die **Unpaid** ist und **auf Debitor**
  ausgecheckt wurde. Nur diese kommen infrage; ein noch offenes Folio oder ein
  bereits beglichener Aufenthalt erscheint nicht.

### Welche Berechtigungen paywise anfragt

Während der Verbindung zeigt apaleo Ihnen genau, welche Berechtigungen paywise
anfragt:

| Berechtigung        | Wofür paywise sie braucht                                                       |
| ------------------- | ------------------------------------------------------------------------------- |
| `invoices.read`     | Ihre offenen Debitorenrechnungen, deren Empfänger und das Rechnungs-PDF lesen   |
| `offline_access`    | Die Verbindung am Leben halten; ohne sie läuft der Zugriff nach einer Stunde ab |
| `openid`, `profile` | Das verbundene apaleo-Konto identifizieren                                      |

Das ist die vollständige Liste. paywise fragt **keine** Schreibberechtigung, **keine**
Reservierungsdaten und **keine** Gästeprofile an.

## 1. apaleo mit paywise verbinden

<Steps>
  <Step title="Verbindungsseite öffnen">
    Gehen Sie auf [app.paywise.de/connect/apaleo/](https://app.paywise.de/connect/apaleo/).
    Kommen Sie aus dem apaleo Store, sind Sie bereits auf der paywise-Willkommensseite –
    melden Sie sich dort an oder legen Sie Ihr paywise-Konto an.
  </Step>

  <Step title="Autorisierung starten">
    Wählen Sie **Mit apaleo verbinden**. paywise leitet Sie zu apaleo weiter, wo Sie
    sich mit Ihren eigenen apaleo-Zugangsdaten anmelden.

    Sie geben apaleo-Zugangsdaten niemals bei paywise ein. Die Autorisierung findet
    vollständig bei apaleo statt.
  </Step>

  <Step title="Zugriff bei apaleo freigeben">
    apaleo zeigt die oben aufgeführten Berechtigungen. Bestätigen Sie mit
    **Authorize**.
  </Step>

  <Step title="Verbindung in paywise bestätigen">
    Sie kehren zu paywise zurück. Dort sehen Sie den empfangenen **apaleo Account
    Code** und das **paywise-Unternehmen**, zu dem die Verbindung gehören wird.

    Prüfen Sie beides. Erkennen Sie das apaleo-Konto nicht wieder, brechen Sie ab und
    bestätigen Sie nichts – dieser Schritt existiert, damit eine Verbindung nie
    stillschweigend am falschen Unternehmen landet.

    Akzeptieren Sie die Nutzungsbedingungen und wählen Sie **Verbindung bestätigen**.
  </Step>
</Steps>

Nach der Verbindung zeigt die Seite den Verbindungsstatus, das apaleo-Konto, das
Verbindungsdatum und die erteilten Berechtigungen.

<Note>
  Ein apaleo-Konto kann zu einem Zeitpunkt mit genau einem paywise-Unternehmen
  verbunden sein. Um eine Verbindung zu verschieben, trennen Sie sie zuerst in dem
  Unternehmen, das sie aktuell hält.
</Note>

## 2. Rechnungen einreichen

<Steps>
  <Step title="Rechnungsauswahl öffnen">
    Wählen Sie auf der apaleo-Seite in paywise **Jetzt starten**.
  </Step>

  <Step title="Rechnungen auswählen">
    paywise listet Ihre offenen Debitorenrechnungen live aus apaleo – mit
    Rechnungsnummer, Empfänger, Rechnungsdatum, Fälligkeit, dem
    Gesamtbetrag und dem **offenen Betrag**.

    Der offene Betrag ist das, was paywise beitreibt. Hat ein Gast vor dem Check-out
    einen Teil bezahlt, wird nur der Rest verfolgt.

    Suchen Sie nach Rechnungsnummer oder Gast/Firma, filtern Sie nach Datum und
    wählen Sie bei jeder gewünschten Rechnung **Hinzufügen**.
  </Step>

  <Step title="Schuldnerdaten prüfen">
    paywise füllt die Forderung aus dem Rechnungsempfänger in apaleo: Name,
    Anschrift und die Einordnung als Unternehmen oder Privatperson. Das
    Rechnungs-PDF wird automatisch aus apaleo geholt und angehängt.

    Prüfen Sie die Angaben und korrigieren Sie, was falsch ist oder fehlt.
  </Step>

  <Step title="Mahnung erfassen">
    apaleo hat kein Mahnwesen, deshalb kann paywise keines übernehmen. Tragen Sie
    ein, wie und wann Sie den Schuldner zur Zahlung aufgefordert haben –
    schriftlich oder mündlich, mit Datum und gesetzter Zahlungsfrist.

    Das ist rechtlich relevant: Gegenüber Verbrauchern ist eine Mahnung in der Regel
    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>

Ab hier ist der Fall eine paywise-Akte. Sie verfolgen den Fortschritt in Ihrem
paywise-Dashboard; in apaleo passiert nichts weiter.

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

paywise lehnt eine Rechnung bewusst ab, statt eine zweifelhafte Forderung anzulegen:

* **Keine offene Forderung.** Nur Rechnungen im Status `Unpaid` vom Typ `Initial`
  oder `Correction` kommen infrage. Eine in apaleo stornierte Rechnung wird dort auf
  `FullyPaid` gesetzt, obwohl ihr offener Betrag bestehen bleibt – paywise prüft den
  Status deshalb beim Einreichen erneut, statt der Liste zu vertrauen.
* **Unvollständiger Empfänger.** Trägt die Rechnung keinen Namen oder keine
  vollständige Anschrift, stoppt paywise, statt eine Forderung gegen einen nicht
  identifizierbaren Schuldner anzulegen. Vervollständigen Sie die Debitorendaten in
  apaleo und erstellen Sie die Rechnung erneut.
* **Bereits eingereicht.** Eine bereits an paywise übergebene Rechnung wird als
  *Eingereicht* angezeigt und kann nicht ein zweites Mal eingereicht werden.

## 3. Verbindung trennen

Wählen Sie auf der apaleo-Seite in paywise **Verbindung löschen** und bestätigen Sie.

paywise widerruft die Autorisierung für Sie bei apaleo und entfernt anschließend die
Verbindung. **In apaleo müssen Sie nichts tun** – die App erscheint dort nicht mehr
als verbunden.

Bereits eingereichte Inkassoaufträge sind davon nicht betroffen: Sie sind jetzt
paywise-Akten und werden weiter bearbeitet. Das Trennen stoppt nur den weiteren
Rechnungsabruf.

Zum Wiederverbinden führen Sie den Verbindungsablauf einfach erneut aus.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Die Rechnungsliste ist leer">
    paywise zeigt nur Rechnungen, die **Unpaid** sind und **auf Debitor**
    ausgecheckt wurden. Ein noch offenes Folio oder ein beim Check-out beglichener
    Aufenthalt erscheint nicht. Prüfen Sie den Rechnungsstatus in apaleo unter
    Finanzen → Rechnungen.
  </Accordion>

  <Accordion title="Eine Rechnung konnte nicht hinzugefügt werden">
    Häufigste Ursache ist ein unvollständiger Rechnungsempfänger – fehlender Name
    oder fehlende Anschrift. paywise lehnt hier bewusst ab. Siehe *Rechnungen, die
    nicht eingereicht werden können*.
  </Accordion>

  <Accordion title="Die Verbindung wird als ungültig angezeigt">
    Die Autorisierung wurde bei apaleo zurückgezogen oder ist abgelaufen. Wählen Sie
    auf derselben Seite **Mit apaleo verbinden**, um sie zu erneuern; Ihre
    bisherigen Aufträge sind nicht betroffen.
  </Accordion>
</AccordionGroup>

## Fragen

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