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

# Billomat

> Offene und überfällige Rechnungen aus Billomat an paywise übergeben – inklusive Mahnungen und Teilzahlungen

# paywise für Billomat

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

Verbinden Sie Ihr Billomat-Konto mit paywise und übergeben Sie offene und
überfällige Rechnungen mit wenigen Klicks an den Forderungseinzug. Rechnungs-PDF,
Kundendaten und bereits gebuchte Teilzahlungen kommen automatisch mit – ebenso Ihre
in Billomat verschickten **Mahnungen samt Mahngebühren**.

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

## Bevor Sie starten

<Warning>
  Der Billomat-API-Zugriff ist **ab dem Business-Tarif** verfügbar. Im
  Professional-Tarif lässt sich kein API-Schlüssel erzeugen.
</Warning>

* Ein Billomat-Konto ab dem Business-Tarif.
* Ihre **Billomat-ID** und einen **API-Schlüssel** (siehe unten).
* Ein paywise-Konto.
* Für Ihr paywise-Unternehmen darf kein aktiver DATEV-Import bestehen. Deaktivieren
  Sie ihn unter **DATEV Einstellungen → Gefahrenzone → Integration deaktivieren**,
  bevor Sie Billomat verbinden.

### Was paywise abruft

| Daten                        | Wofür paywise sie braucht                    |
| ---------------------------- | -------------------------------------------- |
| Rechnungen                   | Die offenen Forderungen, die Sie einreichen  |
| Kunden                       | Name und Anschrift des Schuldners            |
| Zahlungen zur Rechnung       | Der tatsächlich noch offene Betrag           |
| Mahnungen und Mahnpositionen | Mahndatum, Frist, Betrag und Mahngebühren    |
| Rechnungs- und Mahnungs-PDF  | Die Nachweise, die der Akte beigefügt werden |

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

## Billomat-ID und API-Schlüssel finden

In paywise erreichen Sie diese Anleitung jederzeit über **Anleitung öffnen** auf der
Billomat-Seite.

Ihre **Billomat-ID** steht in der Adresszeile Ihres Billomat-Kontos: Bei
`https://muster.billomat.net` lautet sie `muster`.

Den **API-Schlüssel** erzeugen Sie so:

<Steps>
  <Step title="Einstellungen öffnen">
    In Billomat auf das Zahnrad **Einstellungen** klicken.
  </Step>

  <Step title="Nutzer öffnen">
    Unter **Administration** den Punkt **Nutzer** öffnen.
  </Step>

  <Step title="Nutzer bearbeiten">
    Beim gewünschten Nutzer oben rechts auf **bearbeiten** klicken.
  </Step>

  <Step title="API-Zugriff aktivieren">
    Bei **API Zugriff** das Häkchen **aktivieren?** setzen.
  </Step>

  <Step title="Schlüssel anzeigen und kopieren">
    Auf **API-Schlüssel anzeigen** klicken und den Schlüssel kopieren.
  </Step>

  <Step title="Speichern">
    Unbedingt auf **Speichern** klicken – ohne Speichern ist der Schlüssel nicht
    aktiv.
  </Step>
</Steps>

## 1. Billomat verbinden

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

  <Step title="Billomat-ID eintragen">
    Tragen Sie im Feld **Billomat-ID** nur den Namen ein – ohne `https://`, ohne
    `.billomat.net` und ohne Schrägstriche.
  </Step>

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

  <Step title="Verbinden">
    Wählen Sie **Verbinden**. Mit dem Verbinden akzeptieren Sie die
    Nutzungsbedingungen der Billomat-Anbindung.
  </Step>
</Steps>

Nach dem Verbinden zeigt die Seite **Billomat ist verbunden** mit Ihrer Billomat-ID
und den letzten Zeichen des hinterlegten Schlüssels.

<Info>
  **Optional: eigenes Anfrage-Kontingent.** Registrieren Sie in Billomat unter
  **Einstellungen → Administration → Apps** eine eigene App (z. B. „paywise“), erhält
  die Anbindung ein eigenes Anfrage-Kontingent und teilt es sich nicht mit Ihren
  anderen Integrationen. Tragen Sie **App-ID** und **App-Secret** beim Verbinden mit
  ein – oder lassen Sie beide Felder leer.
</Info>

## 2. Rechnungen einreichen

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

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

    Das **Fälligkeitsdatum kommt direkt aus Billomat**. paywise berechnet hier
    nichts selbst. Der **offene Betrag** berücksichtigt bereits gebuchte
    Teilzahlungen.
  </Step>

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

  <Step title="Mahnungen kontrollieren">
    Bereits **versendete** Mahnungen zu der Rechnung übernimmt paywise automatisch –
    mit Datum, Frist, Betrag, Mahnungs-PDF und, sofern Billomat sie als solche
    ausweist, der **Mahngebühr**. Haben Sie außerhalb von Billomat 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

paywise prüft die Beitreibbarkeit selbst und verlässt sich nicht allein auf den
Status in Billomat:

* **Rechnungen ohne offenen Betrag.** Eine Rechnung wird nur angeboten, wenn sie in
  Billomat den Status *offen* oder *überfällig* hat **und** ein offener Betrag
  größer null verbleibt. Das ist Absicht: Eine vollständig bezahlte Rechnung behält
  in Billomat den Status *überfällig*, wenn die Zahlung nicht mit „Rechnung als
  bezahlt markieren" gebucht wurde.
* **Entwürfe und stornierte Rechnungen.**
* **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.

## 3. Verbindung trennen

Wählen Sie auf der Billomat-Seite **Verbindung trennen** und bestätigen Sie.

paywise löscht den gespeicherten API-Schlüssel und ruft keine Rechnungen mehr aus
Billomat ab. Bereits übergebene Forderungen sind davon nicht betroffen.

<Warning>
  **Der Schlüssel selbst bleibt in Billomat gültig.** Ein Zurücksetzen oder
  Deaktivieren des API-Zugriffs in Billomat macht ihn nicht ungültig. Wenden Sie sich
  an den Billomat-Support, wenn der Schlüssel vollständig entwertet werden soll.
</Warning>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="„Diese Billomat-ID gibt es nicht“">
    Prüfen Sie den Namen in Ihrer Billomat-Adresse. Tragen Sie nur den Namen ein –
    ohne `https://`, ohne `.billomat.net` und ohne Schrägstriche.
  </Accordion>

  <Accordion title="„Der API-Schlüssel wurde nicht akzeptiert“">
    Prüfen Sie, ob der API-Zugriff in Billomat aktiviert **und gespeichert** wurde.
    Ohne den Klick auf **Speichern** ist der Schlüssel nicht aktiv.
  </Accordion>

  <Accordion title="„App-ID oder App-Secret wurden von Billomat nicht akzeptiert“">
    Prüfen Sie beide Werte in Billomat unter **Einstellungen → Administration →
    Apps** – oder lassen Sie die Felder leer. Die eigene App ist optional.
  </Accordion>

  <Accordion title="„Billomat ist derzeit nicht erreichbar oder das Anfragelimit ist ausgeschöpft“">
    Billomat begrenzt die Anzahl der Anfragen pro Konto und Zeitfenster. Versuchen
    Sie es in einigen Minuten erneut. Wenn das häufiger vorkommt, registrieren Sie in
    Billomat eine eigene App und hinterlegen Sie App-ID und App-Secret – die
    Anbindung erhält dann ein eigenes Kontingent.
  </Accordion>

  <Accordion title="Eine bezahlte Rechnung steht noch in der Liste">
    Prüfen Sie, ob die Zahlung in Billomat der Rechnung zugeordnet ist. paywise
    entscheidet anhand des offenen Betrags, nicht anhand des Status.
  </Accordion>
</AccordionGroup>

## Fragen

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