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

# FastBill

> Send open invoices from FastBill to paywise for debt collection

# paywise for FastBill

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

The FastBill integration hands open invoices from FastBill straight to paywise for
collection. Invoice data, customer data and the invoice PDF come along automatically.

<Note>
  paywise reads from FastBill and never writes back. Nothing in your bookkeeping is
  changed, cancelled or marked as paid.
</Note>

## Before you start

* A FastBill account with API access.
* A paywise account.
* At least one open invoice in FastBill.
* No active DATEV import may exist for your paywise company. Deactivate it under
  **DATEV Einstellungen → Gefahrenzone → Integration deaktivieren** before
  connecting FastBill.

### What paywise reads

| Data              | Why paywise needs it              |
| ----------------- | --------------------------------- |
| Invoices          | The open receivables you submit   |
| Invoice positions | The breakdown behind the amount   |
| Customers         | The debtor's name and address     |
| Invoice PDF       | The evidence attached to the case |

The credentials are used read-only.

<Warning>
  **FastBill does not expose reminders over its API.** Reminders you sent from FastBill
  therefore cannot be imported — you record them by hand when submitting.
</Warning>

## 1. Connect FastBill

You need two things from FastBill: the **email address of your FastBill account** and
your **API key**. Both are found in FastBill in your account settings, in the section
covering API credentials.

<Steps>
  <Step title="Open the connection page">
    Go to [app.paywise.de/connect/fastbill/](https://app.paywise.de/connect/fastbill/).
  </Step>

  <Step title="Enter the credentials">
    Enter the **E-Mail Ihres FastBill-Accounts** and paste the **API-Schlüssel**
    (API key) into the second field.
  </Step>

  <Step title="Accept the terms and save">
    Tick **Ich akzeptiere die Nutzungsbedingungen** and choose **API-Schlüssel testen
    und Verbindung speichern** (*test API key and save connection*).

    paywise verifies the credentials directly with FastBill and saves the connection
    only after a successful check.
  </Step>
</Steps>

## 2. Submit invoices for collection

<Steps>
  <Step title="Open the invoice picker">
    On the FastBill page in paywise, choose **Rechnungen einreichen**.
  </Step>

  <Step title="Pick the invoices">
    paywise lists your open invoices live from FastBill — with invoice number,
    customer, invoice date, due date, total and open amount.

    The **due date comes straight from FastBill**; paywise calculates nothing here.
    paywise subtracts partial payments reported by FastBill from the total and
    submits only the remaining open amount.
  </Step>

  <Step title="Check the debtor data">
    Name and address come from the FastBill customer, the invoice PDF is attached
    automatically. Review and correct anything missing.
  </Step>

  <Step title="Record your payment reminder">
    Since FastBill supplies no reminders over its API, enter how and when you asked
    the debtor to pay — in writing or verbally, the date, and any payment deadline
    you set.

    This matters legally: for consumers a reminder is normally required before
    default interest and collection costs can be claimed.
  </Step>

  <Step title="Send the order">
    Confirm how collection should start, answer the legal questions, accept the terms
    and choose **Auftrag absenden**.
  </Step>
</Steps>

### Invoices that cannot be submitted

* **Drafts.** Only issued invoices appear in the picker.
* **Incomplete recipient details.** paywise imports the invoice as an editable
  draft. Complete the name and address in paywise before submitting the order.
* **Already submitted** invoices are shown as *Eingereicht*.

## 3. Disconnect

On the FastBill page, choose **Verbindung löschen** and confirm with **Löschen**.

paywise removes the stored key and stops reading invoices. Orders you already
submitted are unaffected. You can store the key again at any time.

## Troubleshooting

<AccordionGroup>
  <Accordion title="„Verbindung mit FastBill fehlgeschlagen“">
    Check the email address and API key. Both must belong to the same FastBill
    account.
  </Accordion>

  <Accordion title="„Ihr API-Schlüssel ist nicht mehr gültig“">
    The key was reset in FastBill. Fetch a current key and store it again.
  </Accordion>

  <Accordion title="The invoice list is empty">
    paywise shows only open, issued invoices. Check the invoice status in FastBill.
  </Accordion>

  <Accordion title="My reminders are missing">
    That is by design: FastBill does not expose reminders over its API. Record them
    by hand when submitting.
  </Accordion>
</AccordionGroup>

## Questions

Write to [info@paywise.de](mailto:info@paywise.de).