# Übersicht (/de-DE/aan-de-slag)

Auf dieser Seite gehst du deinen ersten Tag in Tillor durch: von der Anmeldung bis zur ersten Rechnung. Die Reihenfolge ist wichtig, denn jeder Teil baut auf dem vorherigen auf. Eine Belegung braucht zum Beispiel einen Kunden und eine Parzelle, also legst du diese zuerst an. Möchtest du lieber einem Beispiel aus dem echten Alltag folgen, schau unter [Aus der Praxis](/praktijk). Stößt du auf ein Wort, das du nicht kennst, schlage es unter [Begriffe](/begrippen) nach.

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Das sind die Bausteine und was sie brauchen:

```mermaid
flowchart LR
  I[Einstellungen] --> T[Parzellen]
  T --> B[Belegung]
  T --> R[Reservierung]
  K[Kunden] --> B
  K --> R
  P[Produkte] --> F[Rechnung]
  K --> F
  B --> F
  R --> F
  F --> Bet[Zahlung]
```

Eine Rechnung gehört immer zu einem Kunden. Ein Kunde, der für längere Zeit auf einer Parzelle steht, heißt Belegung, ein Aufenthalt mit Check-in- und Check-out-Datum heißt Reservierung. Produkte sind nicht Pflicht, sorgen aber dafür, dass Preis, MwSt. und Aktionen auf der Rechnungszeile stimmen.

<Callout type="info" title="Gut zu wissen">
- Hast du mehr als eine Organisation, wählst du nach der Anmeldung eine aus. Fehlt dir eine, bitte deinen Administrator, dich einzuladen.
- Welche Menüpunkte du siehst, hängt von deinen Berechtigungen ab. Siehst du etwas nicht, bitte deinen Administrator um die Berechtigung.
- Ohne Parzelle kannst du keine Belegung anlegen. Ohne Kunde kannst du keine Reservierung, Belegung oder Rechnung anlegen.
- Bar, Überweisung und andere manuelle Zahlungen funktionieren ohne Anbindung. Für Online-Zahlung oder Kartenzahlung am Terminal verbindest du Mollie.
- Am schnellsten findest du etwas mit der Suche über **Strg+K** oder **⌘K**.
</Callout>

Bevor du anfängst:

- Du hast ein Microsoft-, Google- oder Apple-Konto, und dein Administrator hat dich in deine Organisation eingeladen. Ohne Einladung siehst du keine Organisation.
- Du hast die Berechtigungen für das, was du tun willst. Fehlen sie, fehlt der Menüpunkt oder die Schaltfläche ist ausgegraut.

## Deinen Park einrichten [#je-park-inrichten]

<Steps>
<Step>
### Melde dich an und wähle deine Organisation [#log-in-en-kies-je-organisatie]
Melde dich mit deinem Microsoft-, Google- oder Apple-Konto an. Hast du Zugang zu mehr als einer Organisation, wählst du eine aus. Hast du noch keinen Zugang, bitte deinen Administrator, dich einzuladen. Siehe [Anmelden](/inloggen).
</Step>
<Step>
### Prüfe die Organisationseinstellungen [#loop-de-organisatie-instellingen-na]
Öffne <UIPath>Support > Einstellungen</UIPath>. Prüfe unter **Allgemein** die Zeitzone und das Standardland, und trage unter **Öffnungszeiten** deine Öffnungszeiten ein. Unter **Rechnungsstellung** findest du unter anderem die Standard-Zahlungsfrist und die MwSt.-Sätze. Kollegen lädst du unter **Benutzer** ein. Siehe [Organisation](/gebruikers/organisaties).
</Step>
<Step>
### Lege deine Parzellen an [#maak-je-terreinen-aan]
Gehe zu <UIPath>Park > Parzellen</UIPath> und füge deine Plätze hinzu, etwa Stellplätze, Chalets und Dauerplätze. Ohne Parzelle kannst du keine Belegung anlegen, und Zähler verknüpfst du mit einer Parzelle. Siehe [Parzellen](/terreinen).
</Step>
<Step>
### Lege deine Produkte an [#maak-je-producten-aan]
Gehe zu <UIPath>Verwaltung > Produkte</UIPath> und lege die Tarife und Leistungen an, die auf Rechnungen erscheinen, zum Beispiel Übernachtungen. Eine Rechnungszeile geht auch ohne Produkt, aber mit einem Produkt stimmen Preis, MwSt. und eventuelle Aktionen sofort. Siehe [Produkte](/producten).
</Step>
<Step>
### Füge deine Kunden hinzu [#voeg-je-klanten-toe]
Gehe zu <UIPath>Kunden > Übersicht</UIPath> und lege einen Kunden an. Reservierungen, Belegungen und Rechnungen gehören immer zu einem Kunden. Siehe [Kundenverwaltung](/klantenbeheer).
</Step>
<Step>
### Lege eine Reservierung oder Belegung an [#maak-een-reservering-of-bezetting-aan]
Eine Reservierung gilt für einen Aufenthalt mit Check-in- und Check-out-Datum und lässt sich auch ohne feste Parzelle anlegen. Eine Belegung verknüpft einen Kunden für längere Zeit mit einer Parzelle, zum Beispiel einem Jahresplatz. Siehe [Reservierungen](/reserveringen) und [Belegungen](/bezettingen).
</Step>
<Step>
### Erstelle deine erste Rechnung [#maak-je-eerste-factuur]
Öffne das Profil des Kunden und lege dort eine neue Rechnung an. Füge Zeilen hinzu, buche die Rechnung und versende sie. Siehe [Rechnungen](/facturen).
</Step>
<Step>
### Verbinde Zahlungen [#koppel-betalingen]
Sollen Kunden online oder per Karte am Terminal zahlen, verbinde Mollie unter <UIPath>Support > Einstellungen</UIPath> bei **Integrationen**. Bar, Überweisung und andere manuelle Zahlungen funktionieren ohne Anbindung. Siehe [Zahlungsabwicklung](/betalingsverwerking) und [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).
</Step>
</Steps>

Nutzt du Zähler, Schranken oder NFC-Tags, richtest du diese danach ein. Sieh dir zuerst [Park](/park) und [Zugangskontrolle](/toegangscontrole) an.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Deine Kunden, Parzellen und Produkte stehen bereit, sodass du täglich Reservierungen, Belegungen und Rechnungen anlegen kannst.
- Deine erste Rechnung liegt als Entwurf beim Kunden. Erst nach **Buchen** erhält sie eine endgültige Nummer, danach kannst du sie versenden und bezahlen lassen.
- Hast du Mollie verbunden, können Kunden online oder per Karte am Terminal zahlen, und die Zahlung erscheint automatisch auf der Rechnung.

## Dich zurechtfinden [#je-weg-vinden]

Das Hauptmenü steht links. Oben wechselst du die Organisation, wenn du mehr als eine hast. Welche Bereiche du siehst, hängt von deinen Berechtigungen ab.

<DocScreenshot src="/screenshots/inleiding/dashboard-welcome.png" alt="Dashboard - Startseite nach der Anmeldung" />

| Menü | Wofür |
|------|-------|
| **Dashboard** | Startseite mit den Ankünften und Abreisen von heute |
| **Reservierungen** | Aufenthalte und der Reservierungskalender |
| **Aufgaben** | Arbeit verteilen und verfolgen |
| **Zugangskontrolle** | Zugangspunkte und Zugangsprotokoll |
| **Kunden** | **Übersicht** und **Offener Verbrauch** |
| **Park** | **Karte**, **Parzellen**, **Zähler**, **Zählerschränke** und **Wetter** |
| **Kommunikation** | **Telefonanrufe**, **Benachrichtigungen** und **Anmerkungen** |
| **Verwaltung** | **Dokumente**, **Unterschriften**, **Rechnungen**, **Zahlungen**, **Banktransaktionen** (mit der Berechtigung, sie anzusehen), **Zahlungsberichte**, **Druckwarteschlange** und **Produkte** |

Unter der Überschrift **Administrator** stehen **Automatisierungen** (mit der Berechtigung, sie anzusehen) und **Controller**. Ganz unten, unter **Support**, findest du deine Benachrichtigungen, **Posteingang** und **Auditprotokoll** (mit den zugehörigen Berechtigungen), **Einstellungen** und **Weitere Ressourcen** mit der Dokumentation. Welche Bereiche du siehst, hängt von deinen Berechtigungen ab.

Suchen kannst du mit **Suchen** in der Kopfzeile oder mit **⌘K** (Mac) oder **Strg+K** (Windows). Damit springst du direkt zu einem Kunden, einer Rechnung, einer Reservierung oder einer Parzelle. Siehe [Suche](/zoeken).

Dein eigenes Konto, deine Sitzungen und API-Schlüssel findest du über deinen Namen unten im Menü.


## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich komme nicht in meine Organisation">
Dein Administrator muss dich zuerst einladen. Melde dich mit dem Konto an, mit dem er dich eingeladen hat. Siehe [Anmelden](/inloggen).
</Accordion>
<Accordion title="Ich sehe einen Menüpunkt nicht, der in diesem Handbuch steht">
Du siehst nur die Bereiche, für die du Berechtigungen hast. Bitte deinen Administrator um die Berechtigung oder um die passende Rolle.
</Accordion>
<Accordion title="Ich kann keine Belegung anlegen">
Es ist keine Parzelle verfügbar, oder der Kunde existiert noch nicht. Lege zuerst eine Parzelle und einen Kunden an. Eine Parzelle mit laufender Belegung steht nicht in der Auswahlliste.
</Accordion>
<Accordion title="Ich weiß nicht, wo ich etwas finde">
Nutze **Suchen** in der Kopfzeile oder suche in diesem Handbuch mit der Suchleiste oben.
</Accordion>
</Accordions>

## Brauchst du Hilfe? [#hulp-nodig]

- Suchst du etwas in diesem Handbuch, nutze die Suchleiste oben oder wähle in Tillor **Weitere Ressourcen > Dokumentation**.
- Funktioniert Tillor nicht wie erwartet? Prüfe zuerst den [Systemstatus](https://status.tillor.eu) auf Störungen und geplante Wartung.
- Fehlt dir der Zugang zu einer Organisation, oder möchtest du Firmendaten auf Rechnungen ändern lassen? Schreibe an support@tillor.eu.
- Daten aus einem Backup wiederherstellen? Siehe [Daten und Backups](/gegevens-backups).

## Begriffe [#begrippen]

- **Organisation**: dein Tillor-Konto, meistens dein Unternehmen. Siehe [Begriffe](/begrippen#organisatie).
- **Park**: der physische Ort. Siehe [Begriffe](/begrippen#park).
- **Kunde**: eine Person oder ein Unternehmen in Tillor. Siehe [Begriffe](/begrippen#klant).
- **Parzelle**: ein Platz in deinem Park. Siehe [Begriffe](/begrippen#terrein).
- **Belegung** und **Reservierung**: ein Kunde für längere Zeit auf einer Parzelle, oder ein Aufenthalt mit Check-in- und Check-out-Datum. Siehe [Begriffe](/begrippen#bezetting).
- **Buchen**: eine Rechnung endgültig machen. Siehe [Begriffe](/begrippen#boeken).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Aus der Praxis" href="/praktijk" description="Ausgearbeitete Beispiele für einen Arbeitstag" />
  <Card title="Begriffe" href="/begrippen" description="Alle Begriffe auf einen Blick" />
  <Card title="Anmelden" href="/inloggen" description="Anmeldemethoden und dein Konto" />
  <Card title="Suche" href="/zoeken" description="Schnell finden, was du suchst" />
  <Card title="Daten und Backups" href="/gegevens-backups" description="Aufbewahrungsfristen und Wiederherstellung" />
  <Card title="Was ist neu" href="/wat-is-nieuw" description="Aktuelle Änderungen pro Monat" />
</Cards>


# Begriffe (/de-DE/begrippen)

Tillor verwendet ein paar Wörter häufiger, als du es gewohnt bist, und manche ähneln sich. Auf dieser Seite steht pro Begriff, was er bedeutet und wo du mehr darüber liest. Die Liste ist alphabetisch geordnet. Suchst du etwas zu den Controllern selbst, etwa ACL oder Firmware, schau in das [Glossar der Controller](/controllers/lexicon).

<Callout type="info" title="Zwei Wörter, die oft verwechselt werden">
Eine **Belegung** ist ein Kunde, der längere Zeit auf einer Parzelle steht, zum Beispiel ein Saisonkunde. Eine **Reservierung** ist eine Buchung für einen einzelnen Aufenthalt. Mit **Buchen** meint Tillor immer das endgültige Festschreiben einer Rechnung, nie das Reservieren eines Aufenthalts.
</Callout>

### Mahnung [#aanmaning]

Eine Erinnerung an einen Kunden, dass eine gebuchte Rechnung noch nicht bezahlt ist. Du verschickst sie pro Rechnung, mit demselben Link zum Online-Bezahlen. Siehe [Eine Mahnung versenden](/facturen/versturen#een-aanmaning-versturen).

### Automatisierung [#automatisering]

Eine Regel, die Tillor selbst ausführt: Wenn dies passiert, tue das. Zum Beispiel eine Nachfolgeaufgabe anlegen, wenn eine Belegung endet. Die Schritte einer Automatisierung bilden zusammen einen Flow, die Zeichnung auf der Arbeitsfläche. Siehe [Automatisierungen](/automatiseringen).

### Zahlung [#betaling]

Ein Betrag, den ein Kunde zahlt oder der noch unterwegs ist, mit Methode, Status und meistens einer Rechnung. Du findest sie unter <UIPath>Verwaltung > Zahlungen</UIPath>. Siehe [Zahlungen wiederfinden](/betalingsverwerking/betalingen-bekijken).

### Zahlungsgruppe [#betalingsgroep]

Ein Bündel von Zahlungen unter einem Namen, das du später in einem Schritt mit einer gebuchten Rechnung verknüpfst. Zum Beispiel alle Kartenzahlungen eines Tages. Siehe [Zahlungsgruppen](/betalingsverwerking/groepen).

### Zahlungsbericht [#betalingsrapport]

Die Übersicht aller Zahlungen eines Kalendertages, gedacht für deine Buchhaltung. Der Bericht von heute ist ein Entwurf und wird endgültig, wenn der Tag vorbei ist. Siehe [Zahlungsberichte](/boekhouden/betalingsrapporten).

### Nachweisseite [#bewijspagina]

Die Seiten am Ende eines unterzeichneten PDFs, mit dem Titel des Dokuments, wer wann unterzeichnet hat und zwei digitalen Fingerabdrücken. Sie heißen **Signaturnachweis** und zeigen später, dass das Dokument nicht verändert wurde. Siehe [Nachweis und Gültigkeit](/handtekeningen/bewijs-en-geldigheid).

### Belegung [#bezetting]

Ein Kunde, der für einen längeren Zeitraum auf einer Parzelle steht. Solange die Belegung läuft, rechnet Tillor den Verbrauch der Zähler auf dieser Parzelle diesem Kunden an. Eine Parzelle hat höchstens einen Kunden gleichzeitig. Siehe [Belegungen](/bezettingen).

### Buchen [#boeken]

Eine Rechnung im Entwurf endgültig machen. Die Rechnung erhält eine Rechnungsnummer und du kannst sie danach nicht mehr frei ändern. Das Wort hat in Tillor nichts mit Reservieren zu tun. Siehe [Eine Rechnung buchen](/facturen/boeken).

### Entwurf [#concept]

Eine Rechnung, die noch nicht gebucht ist. Du kannst die Zeilen noch anpassen, und es ist noch nichts an den Kunden oder die Buchhaltung gegangen. Siehe [Status einer Rechnung](/facturen/statussen).

### Connector [#connector]

Ein kleiner Kasten im Netzwerk deines Parks, der Tillor mit Geräten vor Ort verbindet, etwa Druckern und Zugangscontrollern. Tillor liefert ihn vorkonfiguriert und aktualisiert ihn selbst. Siehe [Connector](/connector).

### Controller [#controller]

Ein Kasten mit Touchscreen in deinem Park, an einer Dusche oder Tür. Er liest einen NFC-Tag oder einen QR-Code, und Tillor entscheidet, ob der Gast weiter darf. Du verwaltest Controller unter **Controller**. Siehe [Controller](/controllers).

### Gutschrift [#creditnota]

Eine Rechnung mit negativen Beträgen, die eine frühere Rechnung aufhebt. Die App nennt dies eine **Gutschrift**. Du erstellst sie mit **Rechnung stornieren**. Siehe [Eine Rechnung stornieren](/facturen/corrigeren#een-factuur-omkeren).

### Eigenes Feld [#eigen-veld]

Ein Feld, das deine Organisation selbst zu einem Kunden, einer Parzelle, Belegung, einem Zähler oder einer Aufgabe hinzufügt, zusätzlich zu den Feldern, die Tillor mitbringt. Du verwaltest sie unter <UIPath>Einstellungen > Eigene Felder</UIPath>. Siehe [Eigene Felder](/eigen-velden).

### Rechnung [#factuur]

Was du einem Kunden berechnest, mit Zeilen pro Produkt. Eine neue Rechnung ist immer ein Entwurf. Du legst sie im Kundenprofil an und verwaltest alle Rechnungen unter <UIPath>Verwaltung > Rechnungen</UIPath>. Siehe [Rechnungen](/facturen).

### Ereignis [#gebeurtenis]

Eine Zeile in der Zeitleiste eines Kunden, einer Rechnung oder eines anderen Datensatzes, die zeigt, was passiert ist, von wem und was sich geändert hat. Siehe [Aktivitätsprotokoll](/activiteitenlog).

### Benutzer [#gebruiker]

Ein Konto mit Zugang zu Tillor. Im Fließtext nennen wir einen anderen Benutzer einen Kollegen. Benutzer und ihre Berechtigungen verwaltest du unter <UIPath>Einstellungen > Benutzer</UIPath>. Siehe [Organisation](/gebruikers/organisaties).

### Gruppe [#groep]

Eine feste Gruppe von Kollegen, zum Beispiel **Rezeption**. Du weist Aufgaben einer Gruppe zu, teilst Ansichten mit einer Gruppe und kannst einer Gruppe Berechtigungen geben oder entziehen. Siehe [Gruppen](/gebruikers/groepen). Eine Zahlungsgruppe ist etwas anderes.

### Hauptbuch [#grootboek]

Die Kontonummer in deiner Buchhaltung, auf die ein Produkt gebucht wird. Du trägst sie beim Produkt ein, und sie wird beim Weiterleiten an deine Buchhaltung mitgeschickt. Siehe [Die Hauptbuchnummer](/producten/product-aanmaken#grootboeknummer).

### Lastschrift [#incasso]

Tillor zieht den Betrag einer Rechnung selbst vom Bankkonto des Kunden ein. Das geht nur mit einem aktiven Mandat. Siehe [Eine Rechnung per Lastschrift einziehen](/betalingsverwerking/incasso).

### Auswahlliste [#keuzelijst]

Eine feste Liste von Optionen, aus der ein eigenes Feld vom Typ **Auswahl** oder **Mehrfachauswahl** schöpft. Du legst die Liste einmal an und nutzt sie in mehreren Feldern. Siehe [Auswahllisten](/eigen-velden/keuzelijsten).

### Kiosk [#kiosk]

Ein Android-Tablet, das die Tillor-App anzeigt und dabei bleibt, sodass Gäste nicht an die Einstellungen des Geräts kommen. Siehe [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten).

### Kunde [#klant]

Der Datensatz in Tillor einer Person oder eines Unternehmens: Daten, Rechnungen, Belegungen, Zugangsmethoden und mehr. Das Wort Gast verwenden wir nur im Fließtext für jemanden, der in deinem Park wohnt. Siehe [Kundenverwaltung](/klantenbeheer).

### Mandat [#mandaat]

Die Erlaubnis eines Kunden, Rechnungen von seinem Bankkonto einzuziehen (ein SEPA-Mandat). Der Kunde unterzeichnet es in Tillor selbst. Siehe [Ein SEPA-Mandat unterzeichnen lassen](/betalingsverwerking/mandaat).

### Zähler [#meter]

Ein Gerät für Wasser, Strom oder Gas. Ein Zähler gehört zu einer Parzelle, nicht zu einem Kunden. Der Verbrauch geht an den Kunden, der zu diesem Zeitpunkt eine Belegung auf der Parzelle hat. Siehe [Zählerverwaltung](/meterbeheer).

### Zählerschrank [#meterkast]

Ein Schrank, in dem Zähler sitzen. Unter <UIPath>Park > Zählerschränke</UIPath> verwaltest du die Zählerschränke und die ihnen zugewiesenen Zähler. Siehe [Park](/park#meterkasten).

### NFC-Tag [#nfc-tag]

Eine Karte, ein Armband oder ein Schlüsselanhänger, den ein Gast an einen Controller hält, zum Beispiel für die Dusche oder einen Zugangspunkt. Ein Tag kann ein Guthaben haben. Siehe [NFC](/nfc).

### Benachrichtigung [#notificatie]

Eine Nachricht, die Tillor an einen Kunden oder Kollegen schickt, per E-Mail, SMS, Post, WhatsApp oder Push. Unter <UIPath>Kommunikation > Benachrichtigungen</UIPath> siehst du, ob sie angekommen ist. Siehe [Benachrichtigungen](/notificaties).

### Unterschriftsanfrage [#ondertekenverzoek]

Die Anfrage, ein PDF, etwa einen Mietvertrag, von einer oder mehreren Personen nacheinander online unterzeichnen zu lassen. Du verwaltest sie unter <UIPath>Verwaltung > Unterschriften</UIPath>. Siehe [Unterschriften](/handtekeningen).

### Offener Verbrauch [#openstaand-verbruik]

Verbrauch von Zählern, der noch nicht auf einer Rechnung steht. Du siehst ihn pro Kunde unter <UIPath>Kunden > Offener Verbrauch</UIPath> und rechnest ihn mit **Verbrauch abrechnen** ab. Siehe [Zählerverwaltung](/meterbeheer/verbruik-factureren).

### Anmerkung [#opmerking]

Eine interne Notiz bei einem Kunden, einer Rechnung, einer Reservierung oder einem anderen Datensatz. Anmerkungen sind für den Kunden nie sichtbar. Siehe [Anmerkungen](/notities).

### Organisation [#organisatie]

Dein Tillor-Konto, also dein Unternehmen mit seinen Benutzern, Einstellungen und Daten. Der Park ist der physische Ort. Siehe [Organisation](/gebruikers/organisaties).

### Park [#park]

Der physische Ort: dein Campingplatz oder Ferienpark. Unter **Park** findest du die Karte, die Parzellen, die Zähler und die Zählerschränke. Siehe [Park](/park).

### Peppol [#peppol]

Ein europäisches Netzwerk, über das du Rechnungen elektronisch direkt an das Buchhaltungssystem des Empfängers schickst, ohne PDF. Für belgische Rechnungen an Unternehmen mit MwSt.-Nummer ist es Pflicht. Siehe [Peppol](/boekhouden/peppol).

### Produkt [#product]

Ein Tarif oder eine Leistung, die du auf eine Rechnungszeile setzt, etwa eine Nacht, Stellplatzgebühr oder eine kWh Strom. Ein Produkt kann Aktionen haben, die Tillor beim Buchen oder Bezahlen ausführt. Siehe [Produkte](/producten).

### Produktaktion [#productactie]

Etwas, das Tillor automatisch tut, wenn eine Rechnungszeile mit diesem Produkt gebucht oder bezahlt wird, etwa eine Belegung verlängern oder einen NFC-Tag aufladen. Siehe [Produktaktionen](/producten/productacties).

### Berechtigung [#recht]

Was ein Benutzer in Tillor darf, zum Beispiel Produkte bearbeiten oder Rechnungen zurücksetzen. Du vergibst Berechtigungen pro Benutzer oder über eine Gruppe. Eine Verweigerung über eine Gruppe gewinnt immer. Siehe [Berechtigungen bearbeiten](/gebruikers/organisaties#rechten-bewerken) und [Gruppenberechtigungen](/gebruikers/groepen#groepsrechten).

### Reservierung [#reservering]

Eine Buchung für einen einzelnen Aufenthalt auf einer Parzelle, mit Ankunft und Abreise. Eine Reservierung ist nicht dasselbe wie eine Belegung. Siehe [Reservierungen](/reserveringen).

### Aufgabe [#taak]

Eine Arbeit für dich oder einen Kollegen, mit unter anderem Frist, Teilaufgaben und verknüpften Kunden oder Parzellen. Aufgaben siehst du in Ansichten. Siehe [Aufgaben](/taken).

### Tablet [#tablet]

Das Gerät an der Rezeption, auf dem die Tillor-App läuft, zum Beispiel damit ein Kunde einen Vertrag oder ein Mandat unterzeichnet. Tablets, Kioske und Telefone, auf denen jemand angemeldet ist, findest du unter **Einstellungen**. Siehe [Tablets und Kioske](/mobiele-app/tablets-en-kiosken).

### Parzelle [#terrein]

Ein Platz in deinem Park, den du vermietest oder auf dem du Aufenthalte planst, mit einem Namen und eventuell Zählern. Mit einer Parzelle verknüpfst du Zähler, und Kunden kommen über eine Belegung oder Reservierung darauf. Siehe [Parzellen](/terreinen).

### Parzellentyp [#terreintype]

Eine Einteilung deiner Parzellen, etwa **Stellplatz**, **Chalet** oder **Wohnmobilstellplatz**. Du nutzt den Typ, um die Liste zu filtern, die Karte einzufärben und in Automatisierungen. Siehe [Parzellentypen](/terreinen#terreintypes).

### Zugangsmethode [#toegangsmethode]

Die Art, wie ein Kunde durch einen Zugangspunkt kommt: Kennzeichenerkennung, ein NFC-Tag oder ein QR-Code. Du verwaltest sie beim Kunden auf dem Tab **Zugangskontrolle**. Siehe [Zugangskontrolle](/toegangscontrole).

### Zugangspunkt [#toegangspunt]

Eine Schranke, ein Tor oder eine elektronische Tür, an der der Zugang kontrolliert wird. Du kannst einen Zugangspunkt aus Tillor öffnen und schließen und im Protokoll sehen, wer vorbeigekommen ist. Siehe [Zugangskontrolle](/toegangscontrole).

### Trigger [#trigger]

Der Beginn einer Automatisierung: das Ereignis, der Zeitpunkt oder die Nachricht, die sie starten lässt. Ein Trigger kann einen Filter haben, sodass die Automatisierung nur startet, wenn etwas zutrifft. Siehe [Trigger](/automatiseringen/triggers).

### Verbrauchsbatch [#verbruiksbatch]

Ein Zeitraum mit Zählerverbrauch für einen Kunden und einen Zähler, mit Anfangs- und Endstand. Die App nennt dies einen **Verbrauchszeitraum**, in diesem Handbuch steht auch Verbrauchsbatch. Siehe [Verbrauchsbatches](/meterbeheer/consumptie-batches).

### Ansicht [#weergave]

Eine gespeicherte Art, deine Aufgaben anzusehen, zum Beispiel **Offene Aufgaben** oder **Wartung**. Jede Ansicht steht als Tab oben auf der Aufgabenseite. Siehe [Ansichten](/taken/weergaven).

### Siegel [#zegel]

Die digitale Signatur deiner Organisation, mit der Tillor ein unterzeichnetes PDF abschließt. Ändert sich danach etwas an der Datei, meldet das ein PDF-Reader. Dazu gehört auch ein Zeitstempel. Siehe [Siegel und Zeitstempel](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="In der Praxis" href="/praktijk" description="Vier ausgearbeitete Beispiele, die mehrere Module verbinden" />
  <Card title="Controller: Glossar" href="/controllers/lexicon" description="Technische Begriffe rund um Controller" />
</Cards>


# Daten und Backups (/de-DE/gegevens-backups)

Tillor erstellt automatisch Backups der Daten deiner Organisation. Du musst dafür nichts einstellen und siehst sie nicht in Tillor. Brauchst du Daten aus der Vergangenheit oder ist etwas schiefgegangen, stellt der Tillor-Support einen früheren Stand für dich wieder her. So beantragst du das, und so weit kannst du zurück.

<Callout type="info" title="Gut zu wissen">
- Backups reichen bis zum ersten vergangenen Kalendermonat zurück, mit einem Archiv pro Monat. Details stehen in der Tabelle unten.
- Wiederherstellen machst du nicht selbst: Das läuft immer über den Tillor-Support.
- Du kannst selbst kein Backup herunterladen oder ansehen.
</Callout>

Bevor du anfängst: Wisse, welche Daten du brauchst und ab welchem Zeitpunkt oder welchem Monat.

## Wie lange bewahrt Tillor Backups auf? [#hoe-lang-bewaart-tillor-back-ups]

Tillor bewahrt drei Arten von Backups nebeneinander auf. Zusammen ergeben sie einen aktuellen Wiederherstellungspunkt und eine längere Historie.

| Zeitraum | Was du wiederfinden kannst |
|----------|----------------------------|
| **Letzte 48 Stunden** | Ein Backup alle 4 Stunden, für die Wiederherstellung auf einen aktuellen Zeitpunkt |
| **Letzte 14 Tage** | Ein Backup pro Nacht |
| **Jeder vergangene Kalendermonat** | Ein Monatsarchiv pro Monat, ohne automatische Löschung |

Der aktuelle Kalendermonat hat nur die nächtlichen Backups der letzten 14 Tage. Sobald ein Monat vorbei ist, bleibt ein Backup dieses Monats als Monatsarchiv erhalten.

Die Fristen gelten für alle Organisationen. Ändert Tillor die Richtlinie, passen wir diese Seite an.

## Ein Backup wiederherstellen lassen [#een-back-up-laten-terugzetten]

Wiederherstellen machst du nicht selbst in Tillor. Der Tillor-Support macht es gemeinsam mit dir, damit deine aktuellen Daten nicht versehentlich überschrieben werden.

<Steps>
<Step>
### Sammle, was du zurückholen willst [#verzamel-wat-je-wilt-terughalen]
Bestimme, welche Daten du brauchst, etwa Rechnungen, Kunden oder Reservierungen. Notiere den Zeitpunkt oder Zeitraum, zu dem du zurück willst, zum Beispiel "gestern gegen 14:00" oder "März 2026".
</Step>
<Step>
### Nimm Kontakt mit dem Tillor-Support auf [#neem-contact-op-met-tillor-support]
Schreibe an support@tillor.eu und nenne den Namen deiner Organisation, welche Daten du zurück willst und den gewünschten Zeitpunkt oder Zeitraum.
</Step>
<Step>
### Besprich, was genau zurückkommt [#overleg-wat-er-precies-terugkomt]
Der Tillor-Support sucht das Backup, das zu deiner Anfrage passt, und bespricht mit dir, was passiert, bevor die Wiederherstellung startet.
</Step>
</Steps>

<Callout type="warn" title="Achtung">
Wiederherstellen kann Daten auf einen früheren Stand zurücksetzen. Alles, was du nach dem gewählten Zeitpunkt eingegeben hast, kann dadurch verschwinden. Besprich das immer zuerst mit dem Tillor-Support.
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Der Tillor-Support sucht das passende Backup und bespricht mit dir, was zurückkommt, bevor die Wiederherstellung startet.
- Während der Wiederherstellung ist deine Organisation im Wartungsmodus, und nur Tillor-Mitarbeiter kommen heran. Danach ist wieder alles verfügbar.
- Daten, die du nach dem gewählten Zeitpunkt eingegeben hast, können verschwunden sein. Sprich deshalb immer zuerst ab.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich möchte ein Backup selbst herunterladen oder ansehen">
Das geht in Tillor nicht. Backups sind nur für den Tillor-Support verfügbar. Bitte den Support, die Daten zu suchen, die du brauchst.
</Accordion>
<Accordion title="Ich möchte Daten von mehr als einem Monat zurück">
Für frühere Monate bewahrt Tillor ein Backup pro Kalendermonat auf. Du kannst also auf einen Monat zurück, aber nicht auf einen bestimmten Tag oder eine bestimmte Stunde in diesem Monat. Für die letzten 14 Tage geht es pro Tag, für die letzten 48 Stunden pro 4 Stunden.
</Accordion>
<Accordion title="Tillor ist während der Wiederherstellung nicht erreichbar">
Während einer Wiederherstellung ist deine Organisation im Wartungsmodus, und nur Tillor-Mitarbeiter kommen heran. Vereinbare mit dem Tillor-Support einen Zeitpunkt, der dir passt.
</Accordion>
<Accordion title="Ich habe versehentlich eine Rechnung oder einen Kunden gelöscht">
Schreibe dem Tillor-Support mit dem Namen der Daten und dem Zeitpunkt der Löschung. Schau zuerst im [Aktivitätsprotokoll](/activiteitenlog) nach, wer wann was geändert hat.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Erste Schritte" href="/aan-de-slag" description="Deinen Park Schritt für Schritt einrichten" />
  <Card title="Aktivitätsprotokoll" href="/activiteitenlog" description="Sieh, wer wann was geändert hat" />
</Cards>


# Bei Tillor anmelden (/de-DE/inloggen)

Du meldest dich bei Tillor mit einem Konto an, das du schon bei Microsoft, Google oder Apple hast. Tillor hat kein eigenes Passwort: Dieser Anbieter verwaltet dein Passwort. Nach der Anmeldung wählst du deine Organisation und landest auf dem Dashboard. Ist dies dein erster Tag, geh weiter zu [Erste Schritte](/aan-de-slag).

Bevor du anfängst:

- Du brauchst ein Microsoft-, Google- oder Apple-Konto.
- Ein Administrator muss dich zuerst mit derselben E-Mail-Adresse als Benutzer eingeladen haben. Ist das nicht geschehen, siehst du **Keine Organisationen gefunden**.

## Anmelden [#inloggen]

<Steps>
<Step>
### Öffne Tillor [#open-tillor]
Gehe in deinem Browser zur Tillor-Webanwendung. Bist du schon angemeldet, leitet Tillor dich sofort zu deiner Organisation weiter.
</Step>
<Step>
### Wähle deine Anmeldemethode [#kies-je-inlogmethode]
Klicke auf **Mit Microsoft anmelden**, **Mit Google anmelden** oder **Mit Apple anmelden**. Die Methode, mit der du dich zuletzt angemeldet hast, ist mit **Zuletzt verwendet** markiert.
</Step>
<Step>
### Folge den Schritten des Anbieters [#volg-de-stappen-van-de-provider]
Du gelangst zum Anmeldebildschirm von Microsoft, Google oder Apple. Bei Microsoft und Google wählst du selbst, welches Konto du verwendest. Danach kehrst du zu Tillor zurück.
</Step>
<Step>
### Wähle deine Organisation [#kies-je-organisatie]
Hast du Zugang zu mehr als einer Organisation, siehst du einen Auswahlbildschirm. Suche deine Organisation in der Liste und klicke auf **Öffnen**. Hast du nur eine, gehst du direkt zum Dashboard.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Du landest auf dem Dashboard deiner Organisation. Tillor merkt sich deine letzte Anmeldemethode und markiert sie beim nächsten Mal mit **Zuletzt verwendet**.
- Du siehst nur die Bereiche, für die du Berechtigungen hast.
- Deine Sitzung bleibt auf diesem Gerät aktiv, bis zu 30 Tage ohne Nutzung oder bis du dich selbst abmeldest.

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Person hat ein Tillor-Konto. Dieses Konto kannst du mit mehreren Anmeldemethoden verknüpfen. Ein Administrator fügt dich als Benutzer zu einer Organisation hinzu und gibt dir Berechtigungen. Was du danach siehst, hängt von diesen Berechtigungen ab.

```mermaid
flowchart LR
  A[Dein Microsoft-, Google- oder<br/>Apple-Konto] --> B[Dein Tillor-Konto]
  B --> C[Eine oder mehrere Organisationen]
  C --> D[Deine Berechtigungen<br/>bestimmen, was du siehst]
```

<Callout type="info" title="Gut zu wissen">
- Du bleibst angemeldet, solange du Tillor nutzt. Nach 30 Tagen ohne Nutzung meldest du dich neu an.
- Ein Bestätigungslink für deine E-Mail-Adresse ist 15 Minuten gültig. Du kannst höchstens alle zwei Minuten eine neue E-Mail anfordern.
- Microsoft ist immer als Anmeldemethode aktiv. Google und Apple können fehlen, je nach deiner Tillor-Umgebung.
- Deine letzte Anmeldemethode kannst du nicht trennen.
</Callout>

## Einem Kollegen Zugang geben [#een-collega-toegang-geven]

Ein Administrator mit den passenden Berechtigungen lädt Kollegen ein.

<Requires permission="Benutzerberechtigungen verwalten" />

<Steps>
<Step>
### Öffne die Benutzer [#open-de-gebruikers]
Gehe zu <UIPath>Support > Einstellungen</UIPath> und wähle **Benutzer**.
</Step>
<Step>
### Lade den Kollegen ein [#nodig-de-collega-uit]
Klicke auf **Benutzer einladen**, trage die E-Mail-Adresse ein und klicke auf **Einladen**.
</Step>
</Steps>

Gibt es schon ein Tillor-Konto mit dieser E-Mail-Adresse, wird der Kollege direkt hinzugefügt. Sonst erhält der Kollege eine Einladung per E-Mail und wird bei der ersten Anmeldung Mitglied. Danach stellst du die Berechtigungen ein, siehe [Organisation](/gebruikers/organisaties). Der Kollege sieht erst etwas Nützliches, wenn diese Berechtigungen gesetzt sind.

## Dein eigenes Konto verwalten [#je-eigen-account-beheren]

Klicke unten im Menü auf deinen Namen und wähle **Konto**. Dort findest du:

- **E-Mail**: ob deine E-Mail-Adresse **Verifiziert** oder **Nicht verifiziert** ist. Steht dort **Nicht verifiziert**, siehst du die Schaltfläche **E-Mail-Adresse bestätigen**, siehe [Deine E-Mail-Adresse bestätigen](#je-e-mailadres-verifiëren).
- **Verknüpfte Plattformen**: verknüpfe Microsoft, Google oder Apple mit **Verknüpfen** mit demselben Konto, oder entferne eine Verknüpfung mit **Trennen**. Deine letzte Anmeldemethode kannst du nicht trennen.
- **Aktive Sitzungen**: sieh, auf welchen Geräten du angemeldet bist. Mit **Abmelden** beendest du eine Sitzung, mit **Alle anderen Geräte abmelden** alle anderen.
- Deine Telefonnummer und die Sprache deines Kontos.

Du bleibst angemeldet, solange du Tillor nutzt. Nach 30 Tagen ohne Nutzung meldest du dich neu an. Zum Abmelden wählst du **Abmelden** im Menü unter deinem Namen.

## Deine E-Mail-Adresse bestätigen [#je-e-mailadres-verifiëren]

Tillor übernimmt deine E-Mail-Adresse von dem Anbieter, mit dem du dich zum ersten Mal angemeldet hast. Google und Apple geben dabei weiter, dass die Adresse dir gehört. Microsoft tut das meistens nicht, und dann steht deine Adresse auf der Seite **Konto** als **Nicht verifiziert**.

Solange deine Adresse nicht bestätigt ist, verknüpft Tillor bei der Anmeldung keine zweite Anmeldemethode mit deinem Konto. Meldest du dich zum Beispiel zum ersten Mal mit Google an, obwohl dein Konto mit Microsoft angelegt wurde, siehst du die Meldung, dass die Adresse schon zu einem Konto gehört, das noch nicht bestätigt ist. Bestätige deine Adresse einmal, danach funktioniert es.

<Steps>
<Step>
### Fordere die Bestätigungs-E-Mail an [#vraag-de-verificatiemail-aan]
Bist du angemeldet, klicke auf der Seite **Konto** auf **E-Mail-Adresse bestätigen**. Bist du nicht angemeldet und hast die Meldung auf der Anmeldeseite bekommen, trage dort deine E-Mail-Adresse ein und klicke auf **Bestätigungs-E-Mail senden**. Diese Seite zeigt immer dieselbe Bestätigung, auch wenn es kein Konto mit dieser Adresse gibt.
</Step>
<Step>
### Öffne die E-Mail [#open-de-e-mail]
Du erhältst eine E-Mail mit dem Betreff **Bestätige deine E-Mail-Adresse für Tillor**. Klicke auf **E-Mail-Adresse bestätigen**. Der Link ist 15 Minuten gültig; ist er abgelaufen, fordere einfach einen neuen an.
</Step>
<Step>
### Melde dich an [#log-in]
Nach dem Klick kommst du zurück auf die Anmeldeseite oder deine Kontoseite. Melde dich mit der Methode deiner Wahl an. Ab jetzt verknüpft Tillor eine neue Anmeldemethode mit derselben E-Mail-Adresse mit deinem Konto.
</Step>
</Steps>

Du kannst höchstens alle zwei Minuten eine neue Bestätigungs-E-Mail anfordern. Willst du nicht auf die E-Mail warten, kannst du als angemeldeter Benutzer eine zweite Methode auch sofort unter **Konto > Verknüpfte Plattformen** verknüpfen.

## API-Schlüssel für Anbindungen [#api-sleutels-voor-koppelingen]

Für technische Anbindungen verwaltest du API-Schlüssel auf der Seite **Konto**. Öffne **Entwickler** in deinem Profilmenü und klicke auf **Zu API-Schlüsseln**, oder gehe zu **Konto** > **API-Schlüssel**. Siehe [Entwickler](/ontwikkelaars) für die Integrationsdokumentation.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Konto - Bereich API-Schlüssel" />

## Probleme? [#problemen]

<Accordions>
<Accordion title="Du siehst Keine Organisationen gefunden">
Dein Konto existiert, ist aber noch keiner Organisation zugeordnet. Bitte einen Administrator deiner Organisation, dich mit derselben E-Mail-Adresse einzuladen wie die deines Microsoft-, Google- oder Apple-Kontos.
</Accordion>
<Accordion title="Du siehst, dass die E-Mail-Adresse schon zu einem Konto gehört, das noch nicht bestätigt ist">
Es gibt schon ein Tillor-Konto mit dieser Adresse, angelegt mit einer anderen Anmeldemethode, und diese Adresse ist noch nicht bestätigt. Trage unter der Meldung deine E-Mail-Adresse ein und klicke auf **Bestätigungs-E-Mail senden**, oder melde dich mit der Methode an, die du früher benutzt hast, und klicke auf der Seite **Konto** auf **E-Mail-Adresse bestätigen**. Siehe [Deine E-Mail-Adresse bestätigen](#je-e-mailadres-verifiëren).
</Accordion>
<Accordion title="Der Bestätigungslink ist abgelaufen oder ungültig">
Ein Bestätigungslink funktioniert 15 Minuten. Fordere auf der Anmeldeseite oder der Seite **Konto** einen neuen an und nutze die neueste E-Mail.
</Accordion>
<Accordion title="Das Konto konnte nicht verknüpft werden">
Dieses Konto hängt schon an einem anderen Benutzer, oder die E-Mail-Adresse stimmt nicht mit deinem aktuellen Konto überein. Nutze dieselbe E-Mail-Adresse, oder melde dich mit dem Konto an, das schon verknüpft ist, und trenne es dort zuerst.
</Accordion>
<Accordion title="Die Anmeldesitzung ist abgelaufen">
Die Anmeldung dauerte zu lange oder die Seite war zu lange geöffnet. Klicke erneut auf deine Anmeldemethode und schließe die Schritte schneller ab.
</Accordion>
<Accordion title="Ich sehe nicht alles, was mein Kollege sieht">
Was du siehst, hängt von deinen Berechtigungen ab. Bitte einen Administrator, deine Berechtigungen anzupassen, siehe [Organisation](/gebruikers/organisaties).
</Accordion>
<Accordion title="Du bekommst eine andere Fehlermeldung">
Versuche es noch einmal. Klappt es wieder nicht, schreibe an support@tillor.eu und gib die Meldung weiter.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Erste Schritte" href="/aan-de-slag" description="Deinen Park Schritt für Schritt einrichten" />
  <Card title="Benutzer" href="/gebruikers" description="Benutzerberechtigungen und Organisationseinstellungen" />
</Cards>


# Vraag het Tillie (/de-DE/vraag-het-tillie)

Tillie is de assistent van deze handleiding. Je stelt een vraag zoals je ze aan een collega zou stellen, bijvoorbeeld "Hoe maak ik een creditnota?". Tillie zoekt de pagina's op die erover gaan, leest ze en antwoordt in een paar zinnen of stappen, met een link naar elke pagina die ze gebruikte. Zoek je een pagina waarvan je de naam al kent, dan is de [zoekfunctie](#zoeken-of-tillie) bovenaan sneller.

<Callout type="info" title="Goed om te weten">
- Tillie antwoordt uit deze handleiding. Over je eigen klanten, facturen of meters weet ze alleen iets als je haar [toegang tot je account](#tillie-in-je-account-laten-kijken) geeft.
- Ze antwoordt met AI en kan zich vergissen. Controleer een belangrijke stap op de pagina waar ze naar linkt.
- Ze antwoordt in de taal waarin je de handleiding leest.
- Zet geen persoonlijke gegevens van klanten in je vraag. Die heeft Tillie niet nodig.
</Callout>

## Een vraag stellen [#een-vraag-stellen]

<Steps>
<Step>
### Open Tillie [#open-tillie]
Klik rechtsonder op **Vraag het Tillie**, of druk op **⌘I** (Mac) of **Ctrl+I** (Windows). Tillie opent aan de rechterkant; op een telefoon vult ze het scherm. Met **Groter** maak je het venster breder.
</Step>
<Step>
### Stel je vraag [#stel-je-vraag]
Typ je vraag onderaan en druk op **Enter**. Met **Shift+Enter** begin je een nieuwe regel. Weet je niet goed hoe te beginnen, kies dan een van de voorbeeldvragen. Een vraag is maximaal 1.000 tekens lang.

Ben je niet aangemeld bij Tillor, dan controleert Tillie bij je eerste vraag dat je geen robot bent. Meestal merk je daar niets van; soms vraagt een vakje om een klik.
</Step>
<Step>
### Volg wat Tillie opzoekt [#volg-wat-tillie-opzoekt]
Boven het antwoord zie je wat Tillie doet: **Zocht naar** met de zoekwoorden en **Las** met de titel van elke pagina die ze opende. Daarna verschijnt het antwoord, woord voor woord. Met de stopknop rechts in het invoerveld breek je een antwoord af.
</Step>
<Step>
### Open de bronnen [#open-de-bronnen]
Klik op **bronnen gebruikt** om de pagina's te zien waar het antwoord op steunt, en klik een titel om de pagina te openen. Links in het antwoord zelf werken ook. Tillie blijft open terwijl je leest, behalve op een telefoon.
</Step>
</Steps>

## Tillie in je account laten kijken [#tillie-in-je-account-laten-kijken]

Ben je aangemeld bij Tillor, dan kan Tillie ook vragen over je eigen gegevens beantwoorden, zoals "Welke facturen van de familie Peeters staan nog open?" of "Wat was de laatste meterstand van plaats 12?". Daarvoor geef je haar eerst toegang.

<Steps>
<Step>
### Geef Tillie toegang [#geef-tillie-toegang]
Open Tillie. Bovenaan staat **Mag Tillie in je account kijken?**. Ben je lid van meer dan één organisatie, kies dan de organisatie. Klik **Toegang geven**.
</Step>
<Step>
### Stel je vraag [#stel-je-vraag-1]
Bovenaan staat nu **Tillie leest mee in** met de naam van je organisatie. Stel je vraag zoals altijd. Wat Tillie in je account opzoekt, zie je boven het antwoord: **Zocht in je account naar** en **Las** met wat ze bekeek.
</Step>
</Steps>

<Callout type="info" title="Wat Tillie mag">
- Tillie kan alleen **lezen**, en alleen wat jij zelf mag zien in die organisatie. Ze kan niets wijzigen, verwijderen of versturen.
- De toegang geldt 30 dagen. Met **Intrekken** stop je ze meteen.
- Geven en intrekken van de toegang staan in de [activiteitenlog](/activiteitenlog#beveiligingsgebeurtenissen) van je organisatie.
- Wat Tillie leest, gaat naar het taalmodel dat haar antwoord schrijft, net als bij de AI-assistent in de inbox. Het wordt niet bewaard om modellen te trainen.
</Callout>

## Een wijziging bevestigen [#een-wijziging-bevestigen]

Vraag je Tillie iets te veranderen, bijvoorbeeld "Zet factuur 2026-0142 terug naar concept", dan doet ze dat niet zelf. Ze stelt het voor in een kaart **Voorgestelde wijziging** met wat er zal gebeuren en welke velden veranderen, met hun nieuwe waarde.

- Klik **Bevestigen** om de wijziging uit te voeren. Tillor voert ze uit met jouw rechten, alsof je ze zelf deed, en toont daarna **Uitgevoerd.** of waarom het niet lukte.
- Klik **Annuleren** als je de wijziging niet wil. Er gebeurt dan niets.
- Een voorstel verloopt na 10 minuten. Vraag het dan opnieuw.

Elke bevestigde wijziging staat in de [activiteitenlog](/activiteitenlog#beveiligingsgebeurtenissen) van je organisatie, en de wijziging zelf staat in de **Gebeurtenissen** van het record, op jouw naam.

## Wat gebeurt er daarna? [#wat-gebeurt-er-daarna]

- Je gesprek blijft bewaard zolang het tabblad open is, ook als je naar een andere pagina gaat. Een vervolgvraag mag dus naar het vorige antwoord verwijzen ("En als de factuur al betaald is?"). Tillie onthoudt de laatste drie vragen met hun antwoord.
- Met **Nieuw gesprek** (het ronde pijltje bovenaan) begin je opnieuw. Sluit je het tabblad, dan is het gesprek weg.
- Onder elk antwoord laat je met een duim weten of het hielp. Zo zien we welke vragen de handleiding nog slecht beantwoordt.

## Hoeveel vragen kan je stellen? [#hoeveel-vragen-kan-je-stellen]

Tillie beantwoordt één vraag tegelijk. Daarnaast gelden grenzen, zodat de assistent beschikbaar blijft voor iedereen:

| Wie | Per minuut | Per dag |
|-----|------------|---------|
| Niet aangemeld | 5 vragen | 30 vragen |
| Aangemeld bij Tillor | 10 vragen | 100 vragen |

Op een netwerk dat je deelt met anderen, zoals de wifi van een kantoor of camping, geldt ook een grens voor iedereen samen. Heeft Tillie op een dag veel bezoekers geholpen, dan vraagt ze wie niet aangemeld is om zich aan te melden.

## Zoeken of Tillie? [#zoeken-of-tillie]

| Je wil | Gebruik |
|--------|---------|
| Een pagina openen waarvan je de naam kent, zoals "Mandaat" | De zoekfunctie bovenaan (**⌘K** of **Ctrl+K**) |
| Weten hoe je iets doet, in je eigen woorden | Tillie |
| Een antwoord dat meerdere pagina's combineert | Tillie |

## Problemen? [#problemen]

<Accordions>
<Accordion title="Ik zie Vraag het Tillie niet">
Tillie is nog niet voor iedereen beschikbaar. Staat de knop niet rechtsonder, gebruik dan de zoekfunctie bovenaan.
</Accordion>
<Accordion title="Je ziet Je stelde veel vragen kort na elkaar">
Je zit aan de grens per minuut of per dag. De melding zegt hoe lang je moet wachten. Ben je niet aangemeld, meld je dan aan bij Tillor: dan krijg je meer vragen per dag.
</Accordion>
<Accordion title="Je ziet Tillie beantwoordde vandaag al veel vragen van bezoekers">
De vragen voor bezoekers die niet aangemeld zijn, zijn voor vandaag op. Klik **Aanmelden bij Tillor** en stel je vraag opnieuw, of gebruik de zoekfunctie.
</Accordion>
<Accordion title="Je ziet Tillie is nu niet beschikbaar">
Tillie neemt even geen vragen aan. Gebruik de zoekfunctie bovenaan en probeer het later opnieuw.
</Accordion>
<Accordion title="Je ziet De controle of je geen robot bent lukte niet">
Herlaad de pagina en stel je vraag opnieuw. Blokkeert een extensie in je browser scripts of cookies, zet ze dan uit voor deze site.
</Accordion>
<Accordion title="Ik zie Mag Tillie in je account kijken? niet">
Dat staat er alleen als je aangemeld bent bij Tillor in dezelfde browser. Meld je aan en open Tillie opnieuw. Heb je al toegang gegeven, dan staat er **Tillie leest mee in**.
</Accordion>
<Accordion title="Je ziet Niet uitgevoerd bij een wijziging">
Tillor weigerde de wijziging, meestal omdat je er de rechten niet voor hebt of omdat het record intussen veranderde. De melding zegt waarom. Doe de wijziging dan in Tillor zelf.
</Accordion>
<Accordion title="Je ziet Verlopen bij een wijziging">
Je bevestigde niet binnen 10 minuten. Vraag Tillie de wijziging opnieuw voor te stellen.
</Accordion>
<Accordion title="Het antwoord klopt niet">
Open de bronnen onder het antwoord en controleer de stap op die pagina. Geef het antwoord een duim omlaag, zodat we het kunnen verbeteren.
</Accordion>
</Accordions>

## Zie ook [#zie-ook]

<Cards>
  <Card title="Zoeken in Tillor" href="/zoeken" description="Een klant, factuur of terrein vinden in de app" />
  <Card title="Begrippen" href="/begrippen" description="Alle termen in Tillor op een rij" />
  <Card title="Aan de slag" href="/aan-de-slag" description="Je eerste stappen in Tillor" />
</Cards>


# Was ist neu (/de-DE/wat-is-nieuw)

Tillor bekommt fast jeden Tag ein Update. Auf dieser Seite stehen die Änderungen, die du als Administrator bemerkst. Kleine Verbesserungen und Fehlerbehebungen lassen wir weg.

## November 2026 [#november-2026]

### Aufgaben [#taken]

- Filtere Aufgaben nach **Text**: Zeige nur Aufgaben, deren Name oder Beschreibung einen Text enthält oder gerade nicht enthält, und füge so viele Texte hinzu, wie du möchtest (zum Beispiel **Enthält nicht** `Verzekering vervallen:`). Siehe [Nach Text filtern](/taken/filteren#filteren-op-tekst).
- Filter und Ansichtseinstellungen in der eingebauten Ansicht **Alle** kannst du jetzt für die ganze Organisation speichern, mit dem Recht **Labels und geteilte Ansichten verwalten**. Siehe [Änderungen speichern oder verwerfen](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

### Suche [#zoeken]

- Das Suchfenster zeigt die Ergebnisse nach Kategorie, mit der Kategorie des besten Treffers oben und pro Kategorie den drei besten Treffern. Mit der Schaltfläche **Alles** vorne im Suchfeld oder mit **⌥1** bis **⌥9** (**Alt** unter Windows) suchst du in einer Kategorie, auch schon bevor du tippst. Unten stehen die Tastenkürzel und die Kategorien ohne Ergebnis. Siehe [Suche](/zoeken).

### Handbuch [#handleiding]

- Tillie kann jetzt auch in dein Konto schauen: Gib ihr Lesezugriff auf deine Organisation und frag nach deinen eigenen Kunden, Rechnungen oder Zählern. Eine Änderung schlägt sie vor; sie passiert erst, wenn du sie bestätigst. Siehe [Tillie in dein Konto schauen lassen](/vraag-het-tillie#tillie-in-je-account-laten-kijken).
- Hell oder dunkel wählst du jetzt nur einmal: Das Handbuch folgt dem Design, das du in Tillor gewählt hast, und umgekehrt.
- Neu: [Frag Tillie](/vraag-het-tillie). Stell unten rechts eine Frage in deinen eigenen Worten, und Tillie antwortet aus dem Handbuch, mit den Seiten, die sie verwendet hat.
- Das Handbuch gibt es jetzt auch in anderen Sprachen: Wähle oben rechts deine Sprache. Es öffnet sich automatisch in der Sprache, die du in Tillor verwendest. Eine Seite, die noch nicht übersetzt ist, zeigt den niederländischen Text.

### Website-Chat [#website-chat]

- Ein Besucher kann über den Chat jetzt 10 Nachrichten pro Minute und 200 pro Tag senden, alle Besucher in einem Netzwerk zusammen 30 pro Minute. Darüber wird der Besucher gebeten, kurz zu warten. So kann ein Skript deinen Posteingang und die Antworten von Tillie nicht überfluten. Siehe [Probleme?](/inbox/website-chat#problemen).

### Zähler (ICY) [#meters-icy]

- Tillor liest ICY jetzt über die neue API v2. Trage unter <UIPath>Einstellungen > Integrationen > ICY</UIPath> die Anmeldedaten für API v2 ein und wähle die Nummer deines Parks in der Auswahlliste; ohne diese Daten werden ICY-Zähler nicht mehr aktualisiert.
- Ein ICY-Zähler zeigt, welches **Modul** am Platz hängt (Campère oder PRM) und, wenn ICY es kennt, die **Seriennummer des Moduls**. Ändert sich diese Seriennummer bei ICY, steht das in der **Aktivität** des Zählers.
- Die Karte **ICY-Controller** in <UIPath>Park > Zähler</UIPath> zeigt pro Controller, wann ICY ihn zuletzt gesehen hat, wie viele Zähler daran hängen. Alarme, die ICY an einem Controller meldet, stehen jetzt auch dort, und du bekommst dafür dieselbe Push-Benachrichtigung wie für einen Zähleralarm. Ein Controller mit einem Alarm oder einer, der länger als eine Stunde still ist, steht ganz oben. Ein Controller trägt den Namen deines Zählerschranks (zum Beispiel **MK6**) statt der Nummer von ICY. Siehe [ICY-Controller](/meterbeheer/alarmen-en-status#icy-controllers).
- Ein ICY-Zähler zeigt jetzt auch seinen **Controller** und die **Abschaltzeit**. Eine andere Abschaltzeit des Moduls steht in der **Aktivität** des Zählers.
- Die Liste in <UIPath>Park > Zähler</UIPath> hat eine Spalte **Modul** (Campère oder PRM), und die Excel-Datei von **Alle Zähler exportieren** hat auf dem Blatt ICY die Spalte `module`.
- Bei **Stromstärke** stehen nur noch die Werte bis zu dem Maximum, das bei ICY für das Modul an diesem Platz eingestellt ist. Früher bot Tillor an jedem Zähler die ganze Liste des Parks an.
- Alarme von ICY bekommen einen festen Namen in deiner eigenen Sprache, etwa **Überstrom** oder **Stromausfall**, und die **Warnungen** zeigen jetzt, wie oft die Schaltgrenze schon genutzt wurde.

### Entwickler [#ontwikkelaars]

- **Nicht abwärtskompatibel:** Alarme heißen in der API und in Events künftig `integration-alarm`, weil sie jetzt auch an einem ICY-Controller hängen können. Die Events `meter-alarm:created` und `meter-alarm:resolved` wurden durch [`integration-alarm:created`](/ontwikkelaars/events#integration-alarm-created) und [`integration-alarm:resolved`](/ontwikkelaars/events#integration-alarm-resolved) ersetzt, und die REST-Pfade `/meter-alarms` durch `/integration-alarms`. Die alten Namen gibt es nicht mehr. Bestehende Webhooks und Automatisierungen wurden automatisch auf die neuen Events umgestellt; passe in deinem eigenen Code den Eventnamen und den Pfad an. Das Feld `meterId` eines Alarms kann leer sein; `icyControllerId` ist dann gefüllt.
- Ein OAuth-Client lässt sich jetzt auf Personen Ihrer Organisation beschränken, und weiter auf Gruppen und Berechtigungen: Aktivieren Sie **Nur Personen von (Ihrer Organisation) können sich anmelden** im Fenster des Clients unter <UIPath>Konto > OAuth-Clients</UIPath>. Gedacht für Single Sign-on bei einem externen Dienst. Siehe [OAuth-Clients](/ontwikkelaars/oauth-clients).
- Jeder Endpunkt in der [API-Referenz](/api-referentie) zeigt jetzt unter **Zugriff**, wer ihn aufrufen darf und welche Berechtigung ein Mitglied dafür braucht. Ein API-Schlüssel mit Scopes braucht diese Berechtigung auch in seinen Scopes. Der [Event-Index](/ontwikkelaars/events) zeigt dasselbe pro Event.

### API-Schlüssel [#api-sleutels]

- Einen API-Schlüssel kannst du jetzt auf die Berechtigungen beschränken, die eine Anbindung braucht: Aktiviere **Auf ausgewählte Berechtigungen beschränken** im Schlüsselfenster unter <UIPath>Konto > API-Schlüssel</UIPath>. Ein beschränkter Schlüssel kann nie mehr als du selbst. Siehe [Berechtigungen beschränken](/ontwikkelaars/http#rechten-beperken).

### Eigene Felder [#eigen-velden]

- Ein Verknüpfungsfeld zu Zählern kann sich auf die Zähler der Parzelle der Belegung beschränken, und jedes Verknüpfungsfeld zu einem auflistbaren Datensatz kann seine Optionen mit eigenem TypeScript filtern. Tillor lehnt beim Speichern einen Datensatz außerhalb dieser Beschränkung ab. Kurze Listen (weniger als 50 Datensätze) zeigt die Auswahlliste sofort, ohne dass du zuerst 2 Zeichen tippen musst. Siehe [Optionen filtern](/eigen-velden/veldtypes#opties-filteren).
- Derselbe Filter kann einer Option auch ein eigenes Label und eine Überschrift in der Auswahlliste geben, indem er einen Text oder `{ label, group }` statt `true` zurückgibt. Siehe [Eigene Labels](/eigen-velden/veldtypes#eigen-labels).

### Handbuch [#handleiding-1]

- Neu im Handbuch: [Begriffe](/begrippen), eine Wortliste aller Begriffe in Tillor, und [In der Praxis](/praktijk), vier ausgearbeitete Beispiele, die einer ganzen Arbeitsweise über die Module hinweg folgen, etwa einen Saisonkunden gewinnen oder Verbrauch abrechnen.
- Jedes Modul beginnt jetzt damit, was es ist, was du dafür brauchst und was danach passiert, mit einem Block **Gut zu wissen** und einer Liste **Probleme?** pro Aufgabe. Neu sind auch [Benutzer einladen und Berechtigungen geben](/gebruikers/gebruikers-en-rechten), eine Übersicht aller [Benachrichtigungstypen](/communicatie/notificatietypes) und eigene Seiten pro Aufgabe für [Zähler](/meterbeheer), [Controller](/controllers) und [Drucker](/printer).

### Unterschriften [#handtekeningen]

- Kunden, Kontaktpersonen und externe Parteien können ein Dokument jetzt auch am Tablet an der Rezeption unterzeichnen. Klicke bei ihrer Reihe auf **Am Tablet signieren**, mit Code oder ohne Code, wenn du die Identität selbst geprüft hast; das Tablet zeigt ihren Namen in großen Buchstaben, auch bei einem SEPA-Mandat. Siehe [Am Tablet an der Rezeption](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).
- Bei **Senden** prüft der Editor alles auf einmal: Ein Unterzeichner ohne Unterschriftsfeld oder ein Kunde oder eine Kontaktperson ohne E-Mail-Adresse und Handynummer wird sofort markiert. Siehe [Ich kann nicht senden](/handtekeningen/handtekening-vragen#problemen).

### Banktransaktionen [#banktransacties]

- Klicke auf das (i)-Symbol bei einer Banktransaktion, um ihr Detailfenster zu öffnen. Über das Aktionsmenü legst du dazu eine Aufgabe an oder kopierst einen Link, der das Fenster sofort öffnet. Siehe [Banktransaktionen ansehen](/boekhouden/betalingsrapporten/betaalmethodes/ponto#banktransacties-bekijken).

### Produkte und Rechnungen [#producten-en-facturen]

- Reverse Charge ist jetzt eine Auswahl bei **MwSt. %**, neben den Sätzen: für EU-Dienstleistungen und Mitvertragspartner, und auch innergemeinschaftliche Lieferung, Ausfuhr und befreit. Die Rechnung erhält den gesetzlichen Vermerk, das Buchen verlangt eine MwSt.-Nummer, wo es nötig ist, und die Zeile landet in Admisol im richtigen Raster. Für Odoo trägst du pro Regime den Namen der Odoo-MwSt. in den [Exporteinstellungen](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo#btw-regimes) ein; ein geplanter Preis kann ein Produkt auch auf ein Regime umstellen. Siehe [Reverse Charge und andere Regime ohne MwSt.](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw).
- Lege Beträge aus der Zeit vor Tillor, etwa alte Kautionen, als Anfangssaldo auf das Konto eines Kunden: von Hand oder mit einem Import für alle Kunden gleichzeitig. Sie zählen im Saldo und in der Überwachung mit, sind aber keine Rechnung und gehen nicht an die Buchhaltung. Siehe [Anfangssalden aus der Zeit vor Tillor](/producten/product-aanmaken#beginsaldi-van-voor-tillor).
- Ein Produktbündel ist jetzt Code: Jeder Schritt hat ein Produkt, eine Menge und eine optionale **Formel** in TypeScript, die beim Speichern der Rechnung bestimmt, ob der Schritt darauf kommt, mit welcher Menge, oder genau welche Zeilen (eigene Beschreibung, Preis, Zugangsmethode). Die Formel liest Kunde, Belegung, Parzelle und Hauptzeile, einschließlich eigener Felder, sowie die Listen der Zähler und Zugangsmethoden. Die festen Auswahlen pro Zähler, NFC-Tag und Hund sind weg; was sie taten, steht als Beispielformel im Handbuch. Siehe [Formel pro Schritt](/producten/bundel-velden#formule-per-stap).
- Überwache den Saldo eines Kunden auf einem Hauptbuch, zum Beispiel für Kautionen. Tillor zeigt den Saldo auf der Rechnung und lehnt eine Rechnung ab, die ihn unter null bringt. Mit einer eigenen Berechtigung buchst du trotzdem, mit einer Begründung in der Zeitleiste. Siehe [Den Saldo des Kunden überwachen](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
- Auf dem Tab **Rechnungen** eines Kunden steht die neue Tabelle **Konten**: der Saldo pro Hauptbuch, auf dem etwas gebucht ist, darunter die gebuchten Rechnungen und das laufende Konto. Hast du überwachte Hauptbücher, siehst du standardmäßig nur diese; mit einem Filter siehst du alle. Siehe [Den Saldo des Kunden überwachen](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

### Rechnungen und Zahlungen [#facturen-en-betalingen]

- Mit **Link für Teilzahlung** im Menü einer gebuchten Rechnung erstellst du einen Zahlungslink für einen Teil des offenen Betrags. Siehe [Einen Link für eine Teilzahlung erstellen](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).
- Ein unterzeichnetes SEPA-Mandat ist versiegelt, sodass ein PDF-Reader jede spätere Änderung anzeigt. Siehe [SEPA-Mandat](/betalingsverwerking/mandaat).

### Benutzer und Berechtigungen [#gebruikers-en-rechten]

- Eine Gruppe kann Berechtigungen für alle ihre Mitglieder erlauben oder verweigern; eine Verweigerung gewinnt immer. Unter **Berechtigungen bearbeiten** siehst du pro Berechtigung, ob sie direkt oder über eine Gruppe kommt. Siehe [Gruppenberechtigungen](/gebruikers/groepen#groepsrechten).

### Park und Technik [#park-en-techniek]

- Ein Controller kann mehrere WLAN-Netzwerke kennen, in einer Reihenfolge, die du selbst bestimmst. Siehe [Controller-Einstellungen](/controllers/settings).
- Bei einem Zähler zeigt **Verbrauch und Trends** den Verbrauch pro Stunde für einen Tag, mit einer neuen Zeitraumauswahl. Siehe [Zählerverwaltung](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).

### Aufgaben [#taken-1]

- Drucke eine Aufgabe auf A4 oder auf einem Bondrucker aus dem Menü der Aufgabe; der Ausdruck zeigt auch die verknüpften Elemente und Blockaden. Im selben Menü steht **Löschen**, außer bei Aufgaben, die nur eine Automatisierung abschließen darf. Siehe [Aufgabendetails](/taken/taakdetails#het-menu-van-de-taak).
- Füge Teilaufgaben hinzu, während du eine Aufgabe anlegst. Siehe [Eine Aufgabe anlegen](/taken/taakdetails#een-taak-aanmaken).
- Eine Ansicht kann erledigte Aufgaben nach einem Tag, einer Woche oder einem Monat ausblenden. Siehe [Erledigte Aufgaben ausblenden](/taken/indelingen#voltooide-taken-verbergen).

## Oktober 2026 [#oktober-2026]

### Parzellen [#terreinen]

- Der **Berechnete Tarif** einer Parzelle folgt jetzt einer Formel, die du pro Organisation selbst unter <UIPath>Einstellungen > Platztarif</UIPath> schreibst, mit denselben `{terrain.…}`-Variablen wie in Automatisierungen. Du probierst die Formel sofort an einer Parzelle aus, und jeder benannte Teil bekommt eine Spalte im Parzellenexport. Das Ergebnis wird bei der Parzelle gespeichert und folgt jeder Änderung der Parzelle oder der Formel. Siehe [Tarifformel](/terreinen#tariefformule).

### Unterschriften [#handtekeningen-1]

- Lass ein PDF wie einen Mietvertrag von Kunden, Kontaktpersonen, Kollegen und externen Parteien nacheinander online unterzeichnen. Das unterzeichnete PDF mit Nachweisseite kommt zu den Dokumenten des Kunden. Siehe [Unterschriften](/handtekeningen).
- Ein Unterzeichner kann seine Unterschrift oder sein Kürzel auch tippen statt zeichnen. Siehe [So unterzeichnet jemand](/handtekeningen/ondertekenen).
- Im Editor wählst du bei **Felder für**, für wen du Felder platzierst, und setzt ein platziertes Feld mit **Unterzeichner** auf den Namen von jemand anderem. Felder platzierst du durch Tippen oder Ziehen. Siehe [Platziere die Felder](/handtekeningen/handtekening-vragen).

### Anmelden [#inloggen]

- Ist deine E-Mail-Adresse noch **Nicht verifiziert**, bestätigst du sie mit einem Klick von der Seite **Konto** oder von der Anmeldeseite aus. Erst danach verknüpft Tillor eine zweite Anmeldemethode mit deinem Konto. Siehe [Deine E-Mail-Adresse bestätigen](/inloggen#je-e-mailadres-verifiëren).

### Automatisierungen [#automatiseringen]

- Mit dem Schritt **Code ausführen** schreibst du ein Stück TypeScript auf den Variablen des Flows, zum Beispiel um zu bestimmen, welche Teilaufgaben eine Aufgabe bekommt. Das Ergebnis liest du in späteren Schritten als `{result}`. Siehe [Code ausführen](/automatiseringen/logica#code-uitvoeren).
- Ein Flow kann zuerst **Banktransaktionen synchronisieren** und danach eine Zahlungserinnerung senden, sodass eine Rechnung, die gerade bezahlt wurde, keine Erinnerung bekommt. Speichere diese Automatisierung vom Büronetzwerk aus, dann merkt sich Tillor die IP für die Bankanbindung. Siehe [Banktransaktionen synchronisieren](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren).
- Schalte automatische Mahnungen für einen Kunden oder für eine einzelne Rechnung aus. Ein Erinnerungs-Flow überspringt Kunden, bei denen das schon aktiv ist. Siehe [Automatische Erinnerungen für Kunden ausschalten](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant).
- Bei **Aufgabe erstellen** kannst du einstellen, dass nur der Flow die Aufgabe abschließt. Mit **Aufgabe löschen** entfernst du diese Aufgabe später wieder. Siehe [Aufgaben](/automatiseringen/acties/taken).
- Bei einer Aufgabenaktion kannst du **Bestätigung verlangen** aktivieren. Der Kollege bestätigt die Wahl dann zuerst, und danach läuft der Flow weiter.
- Baue selbst Automatisierungen auf einer Arbeitsfläche: Wähle einen Trigger, füge Schritte, Bedingungen und Wartezeiten hinzu und sieh pro Ausführung, was passiert ist. Siehe [Automatisierungen](/automatiseringen).
- Eine Automatisierung kann mehrere Trigger haben. Tillor blockiert Schleifen, in denen sich eine Automatisierung ständig selbst startet.
- Warten kann jetzt bis zu einem festen Zeitpunkt, eine Anzahl Stunden oder Minuten, oder bis deine Organisation schließt.
- Starte eine Automatisierung an einem Datum aus einem Datensatz, mit einem geplanten Trigger oder aus deinem eigenen System über einen [eingehenden Webhook](/ontwikkelaars/automatiseringen).
- Mit dem Schritt **Um eine Entscheidung bitten** baust du selbst die Schaltflächen an der Aufgabe, mit eigener Farbe und eigenem Symbol, eventuell mit einer Pflichtnotiz oder Bestätigung. Jede Schaltfläche ist ein Ausgang des Schritts. Siehe [Um eine Entscheidung bitten](/automatiseringen/logica#vraag-om-een-beslissing).
- Der Trigger **Eine Aufgabenaktion wird gewählt** startet eine Automatisierung, wenn jemand eine verknüpfte Schaltfläche an einer Aufgabe wählt. Bei einem eingehenden Webhook verhinderst du mit **Wiederholungen ignorieren**, dass derselbe Aufruf den Flow zweimal startet. Siehe [Trigger](/automatiseringen/triggers).
- **Auf ein Ereignis warten** hat einen Ausgang **Gelöscht** für den Fall, dass der Datensatz des Flows verschwindet. Siehe [Logik](/automatiseringen/logica#wachten-op-een-gebeurtenis).
- Im Editor testest du mit einem echten Datensatz, setzt **Rahmen** um Schritte und stellst über **Verlauf** eine frühere Version wieder her. Siehe [Erste Schritte](/automatiseringen/aan-de-slag#de-editor).

### Aufgaben [#taken-2]

- In der Aufgabenliste siehst du alle verknüpften Datensätze und filterst mit **Verknüpft mit** nach Art. Siehe [Filtern](/taken/filteren).
- Aufgaben-E-Mails zeigen eine Vorschau der Aufgabe. Aufgaben findest du auch über die [Suche](/zoeken).
- Bevor eine private Aufgabe für die ganze Organisation sichtbar wird, fragt Tillor, ob du sie öffentlich machen willst. Siehe [Private Aufgaben](/taken/prive-taken).
- Private Aufgaben, eine Kalenderansicht und ein Timer, der weiterläuft, während du weiterarbeitest. Siehe [Aufgaben](/taken).
- Teile eine Ansicht als schreibgeschützte Seite oder als Kalenderlink. Siehe [Aufgaben teilen](/taken/delen).
- Die Warte-Status wurden zu einem einzigen Status **Wartet auf Antwort** zusammengeführt.
- Weise eine Aufgabe einer Gruppe zu und teile eine Ansicht mit Gruppen von Kollegen. Siehe [Wer sieht eine Ansicht](/taken/weergaven#wie-ziet-een-weergave).
- Eine Aufgabe kann Auswahlschaltflächen haben, eventuell mit einer Pflichtnotiz oder Bestätigung. Siehe [Aufgaben mit Auswahlschaltflächen](/taken/taakdetails#taken-met-keuzeknoppen).
- Füge eine Datei im Aufgabenfenster ein, um sie als Anhang hinzuzufügen. Eigene Felder von Aufgaben stehen ebenfalls in diesem Fenster.

### Posteingang [#inbox]

- Die Erinnerungs-E-Mail des Website-Chats öffnet das Gespräch jetzt auch auf einem anderen Gerät oder in einem anderen Browser. Siehe [Erinnerung per E-Mail](/inbox/website-chat-instellingen#herinnering-per-e-mail).

### Benachrichtigungen [#meldingen]

- Wähle pro Benachrichtigung, ob Tillor dich per E-Mail oder Push erreicht. Das stellst du unter **Konto** bei **Benachrichtigungen** ein, oder für einen Kollegen über die **Benachrichtigungseinstellungen** bei den Organisationsmitgliedern. Siehe [Benutzer](/gebruikers).

### Tablets und Kioske [#tablets-en-kiosken]

- Jedes Tablet und jeder Kiosk hat eine eigene Geräteseite mit Fernaktionen, Diagnose, Verlauf und Einstellungen. Siehe [Tablets und Kioske](/mobiele-app/tablets-en-kiosken).
- Kiosksperre, Nachtmodus und Benachrichtigungen pro Gerät für Android-Tablets.

### Rechnungen und Zahlungen [#facturen-en-betalingen-1]

- Wähle auf einer Rechnungszeile mit einem Zeitraum die Parzelle auf der Karte. Beim Buchen legt Tillor die Reservierung an und checkt den Gast ein, je nach Produkt. Siehe [Rechnungen](/facturen/aanmaken-en-bewerken#periode-en-terrein-kiezen).
- Entwürfe von Zahlungsberichten für den laufenden Tag. Siehe [Zahlungsberichte](/boekhouden/betalingsrapporten).
- Behält Mollie eine Bilanzreserve bei einer Auszahlung ein, bucht Tillor sie als *Balansreserve* auf den Lieferanten Mollie statt auf das Verrechnungskonto, und bei Freigabe fällt sie dort wieder weg. Siehe [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#balansreserve).
- Kunden erhalten eine Erinnerung, ihr SEPA-Mandat zu unterzeichnen, bevor es abläuft.

### Kunden und Dateien [#klanten-en-bestanden]

- Anhänge, Dokumente und Outlook-E-Mails siehst du in einem Dateibetrachter, ohne Herunterladen. Videos kannst du abspielen; Uploads dürfen bis zu 250 MB groß sein.
- Die Kundenübersicht zeigt aktive und überfällige Aufenthalte. Automatisches Abrechnen pausiert bei ungewöhnlich hohem Wasserverbrauch.
- Auf einer Parzelle siehst du die Geschichte der Belegungen, mit einem Link zum Kunden.

### Eigene Felder [#eigen-velden-1]

- Füge selbst Felder zu Kunden, Parzellen, Belegungen, Zählern, Aufgaben, Produkten, Dokumenten, Reservierungen und Zugangsmethoden hinzu, unter <UIPath>Einstellungen > Eigene Felder</UIPath>. Du platzierst sie zwischen den Standardfeldern, lässt sie unter einer Bedingung erscheinen und bestimmst, wer sie sieht oder bearbeitet. Siehe [Eigene Felder](/eigen-velden).

### Produkte [#producten]

- Plane einen neuen Preis ab einem Datum mit **Geplante Preise**; Tillor wendet ihn an diesem Tag an und schickt dir eine E-Mail. Der **MwSt.-Rechner** rechnet einen Preis um oder passt ihn mit einem Prozentsatz an. Siehe [Eine Preisänderung planen](/producten/prijzen-plannen).

### Kunden [#klanten]

- Oben bei einem Kunden steht die Karte mit den wichtigsten Daten, mit angehefteten Anmerkungen. Geburtstage von Kunden und Partnern werden hervorgehoben. Siehe [Kundenverwaltung](/klantenbeheer).
- Eine Adresse trägst du mit **Straße**, **Nr.** und **Zusatz** ein, mit Adressvorschlägen beim Tippen. Siehe [Kundenverwaltung](/klantenbeheer#adres-invullen).

### Zugangskontrolle [#toegangscontrole]

- Bei einem QR-Pass siehst du, in welchem Wallet er liegt, und mit **Wallet-Pass synchronisieren** stellst du den Pass neu bereit. Siehe [Zugangskontrolle](/toegangscontrole).

### Integrationen [#integraties]

- Verbinde Partoo, um deine Öffnungszeiten, Saisons und Ausnahmen automatisch an deinen Standort weiterzugeben. Siehe [Partoo](/integraties/partoo).

## September 2026 [#september-2026]

### Zahlungen [#betalingen]

- SEPA-Mandate unterzeichnest du in Tillor selbst, aus der Ferne oder am Tablet an der Rezeption. Siehe [SEPA-Mandat](/betalingsverwerking/mandaat).
- Eine neue Zahlungsseite mit eigener Wahl der Zahlungsmethode, QR-Code und Weiterleitung an die Bancontact-App. Tillor warnt, wenn eine Zahlungsmethode gestört ist.

### Zugangskontrolle [#toegangscontrole-1]

- Neue Zugangsmethode: PIN-Code. Ein PIN-Code kann automatisch in ein Kennzeichen umgewandelt werden. Siehe [Zugangskontrolle](/toegangscontrole#toegangsmethoden-beheren-via-het-klantprofiel).

### Aufgaben [#taken-3]

- Gespeicherte Ansichten mit einem Filterbaukasten, Teilen mit Kollegen und ein Kalender-Feed pro Ansicht. Siehe [Ansichten](/taken/weergaven).
- Abhängigkeiten zwischen Aufgaben, die Priorität **Dringend** und Labels, die du inline anlegst.
- Verknüpfe eine Aufgabe mit mehreren Kunden oder mit Parzellen, Zählern, Rechnungen und Reservierungen.

### Park und Kommunikation [#park-en-communicatie]

- Färbe Parzellen auf der Karte nach Typ ein und exportiere die Karte als A4-PDF. Siehe [Karte](/kaart).
- Für Voys-Telefonie: Routing pro Kunde und automatische Voicemail. Siehe [Voys Telefonie](/communicatie/providers/voys).
- Exportiere die Rechnungsübersicht eines Kunden nach Excel.


# Suchen in Tillor (/de-DE/zoeken)

Mit der Suche findest du von jeder Seite aus einen Kunden, eine Rechnung, eine Belegung, eine Reservierung, einen Telefonanruf, eine Parzelle, einen Zähler, eine Aufgabe oder einen Zahlungsbericht in einem Schritt. Du musst also nicht erst zum richtigen Bereich gehen. Das Ergebnis öffnet direkt die richtige Seite.

<Callout type="info" title="Gut zu wissen">
- Bei **Alle Ergebnisse** holt Tillor pro Kategorie höchstens zehn Treffer und zeigt die besten drei. Wähle eine Kategorie, um bis zu hundert zu sehen.
- Bei Kunden findet Tillor auch Treffer mit einem kleinen Tippfehler, sodass „Jansen“ auch „Janssen“ liefert.
- Notizen zu Telefonanrufen sind verschlüsselt und werden nicht durchsucht. Suche nach der Telefonnummer.
- NFC-Tags und Kennzeichen haben keine eigene Kategorie. Du findest sie unter **Kunden**.
</Callout>

## Suchen und ein Ergebnis öffnen [#zoeken-en-een-resultaat-openen]

<Steps>
<Step>
### Öffne das Suchfenster [#open-het-zoekvenster]
Klicke in der Kopfzeile auf **Suchen** (auf einem schmalen Bildschirm auf die Lupe) oder drücke **⌘K** (Mac) oder **Strg+K** (Windows). Mit demselben Tastenkürzel schließt du das Fenster wieder.

<DocScreenshot src="/screenshots/zoeken/search-dialog-open.png" alt="Geöffnete globale Suche" />
</Step>
<Step>
### Gib deinen Suchbegriff ein [#typ-je-zoekterm]
Die Ergebnisse erscheinen, sobald du kurz mit dem Tippen aufhörst. Sie stehen nach Kategorie geordnet, und die Kategorie mit dem besten Treffer steht oben: Die oberste Zeile ist also immer der beste Treffer. Ein guter Treffer im Titel zählt stärker als ein Treffer in der Beschreibung. Pro Kategorie siehst du die drei besten Treffer, mit **… weitere anzeigen** öffnest du die ganze Kategorie. Unten steht, in welchen Kategorien nichts gefunden wurde.

<DocScreenshot src="/screenshots/zoeken/search-results.png" alt="Suchergebnisse für Jonas nach Kategorie, die Kategorie mit dem besten Treffer oben" />
</Step>
<Step>
### Auf eine Kategorie beschränken (optional) [#beperk-tot-één-categorie-optioneel]
Suchst du nur in einer Art von Daten, wähle sie mit der Schaltfläche **Alles** vorne im Suchfeld, zum Beispiel **Kunden**. Das geht vor oder nach dem Tippen; das Suchfeld zeigt danach **In Kunden suchen…**. Du kannst auch in den Ergebnissen auf den Namen einer Kategorie klicken.

Mit der Tastatur:
- **Shift+Tab** öffnet die Liste der Kategorien.
- **⌥1** bis **⌥9** (**Alt+1** bis **Alt+9** unter Windows) wählt direkt eine Kategorie, in der Reihenfolge dieser Liste. Die Ziffer steht auch neben dem Namen jeder Kategorie in den Ergebnissen.
- **Tab** geht die Kategorien durch, die Ergebnisse haben.

Zurück zu allem: Wähle **Alles** in der Liste oder drücke **Backspace** in einem leeren Suchfeld.
</Step>
<Step>
### Öffne das Ergebnis [#open-het-resultaat]
Wähle mit den Pfeiltasten und drücke **Enter**. Mit **Strg+Enter** (**⌘+Enter** auf dem Mac) öffnet sich das Ergebnis in einem neuen Tab. Ein Klick mit der Maus funktioniert auch. **Escape** schließt das Fenster.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das gewählte Ergebnis öffnet den Kunden, die Rechnung oder eine andere Seite im selben Tab. Mit **Strg+Enter** (**⌘+Enter** auf dem Mac) öffnet es sich in einem neuen Tab.
- An deinen Daten ändert sich nichts: Die Suche liest nur.
- Bei einem Ergebnis steht, worüber es gefunden wurde, zum Beispiel **Telefon:** oder **Rechnung:** mit dem passenden Wert.

## Was Tillor durchsucht [#wat-tillor-doorzoekt]

| Kategorie | Wonach du suchen kannst |
|-----------|-------------------------|
| **Kunden** | Name, Kundennummer, E-Mail, Telefon, Adresse und Ort, USt-IdNr., Kommentare, Kontaktpersonen (Name, E-Mail, Telefon) und Zugangsmethoden wie eine NFC-Karte oder ein Kennzeichen |
| **Rechnungen** | Rechnungsnummer (mit oder ohne Präfix, Jahreszahl und Trennzeichen), Gesamtbetrag, die ID aus dem Link der Rechnung und die Notizen (öffentlich und intern) |
| **Belegungen** | Name der Parzelle, Vor- und Nachname des Kunden und die ID der Belegung |
| **Reservierungen** | Reservierungsnummer (zum Beispiel `RES/2026/0001`, mit oder ohne Präfix und Jahreszahl, oder kompakt `20260001`), Notiz, Name des Kunden und die ID aus dem Link |
| **Telefonanrufe** | Eingehende und ausgehende Nummer, Anruf-ID und externe Referenz |
| **Parzellen** | Name, Beschreibung, ID und die Gaszählernummer der Parzelle |
| **Zähler** | Name, Seriennummer und ID des Zählers |
| **Aufgaben** | Titel, Beschreibung und ID. Ein Treffer zeigt auch den verknüpften Kunden oder die Parzelle |
| **Zahlungsberichte** | Berichtsnummer |

<Callout type="info" title="NFC und Kennzeichen">
Für NFC-Tags gibt es keine eigene Kategorie. NFC-Karten und andere Zugangswerte gehören zu **Kunden** und erscheinen dort, sobald sie zu deinem Suchbegriff passen.
</Callout>

## Wie viele Ergebnisse siehst du? [#hoeveel-resultaten-zie-je]

Gibt es zehn oder mehr Treffer in einer Kategorie, steht neben dem Namen dieser Kategorie **10+**. In der Übersicht siehst du pro Kategorie die drei besten Treffer. Wähle die Kategorie oder klicke auf **… weitere anzeigen**, um bis zu hundert Treffer zu sehen. Bei Reservierungen und Rechnungen wirkt die Toleranz für Tippfehler vor allem bei Nummern und Notizen.

## Suchtipps [#zoektips]

- **Kennzeichen, NFC oder QR-Code**: Suche nach dem Wert, der beim Kunden steht. Du findest den Kunden unter **Kunden**.
- **Rechnungs- oder Reservierungsnummer**: Tippe die Nummer so, wie sie auf dem Dokument steht, oder einen Teil davon. Für `RES/2026/0042` funktionieren auch `2026/0042` und `20260042`.
- **Betrag**: Eine Rechnung findest du auch über den Gesamtbetrag, zum Beispiel `120,50`.
- **Wer steht wo**: Suche unter **Belegungen** nach dem Namen der Parzelle oder des Kunden.
- **Teilweise Namen**: Bei Kunden genügt meistens ein Teil des Namens. Bei Reservierungen hilft ein Wort aus der Notiz.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Du siehst Keine Ergebnisse gefunden">
Prüfe die Schreibweise und versuche einen kürzeren Teil des Begriffs. Hast du eine Kategorie gewählt, sucht Tillor nur darin. Gibt es Ergebnisse in einer anderen Kategorie, weist das Fenster darauf hin. Wähle **Alles** mit der Schaltfläche vorne im Suchfeld oder klicke auf **Filter entfernen**.
</Accordion>
<Accordion title="Du siehst Suche nicht verfügbar">
Bei der Suche ist etwas schiefgelaufen. Klicke auf **Erneut versuchen**. Passiert es weiterhin, schau auf den [Systemstatus](https://status.tillor.eu).
</Accordion>
<Accordion title="Ich finde einen Kunden nicht über sein Kennzeichen oder seine NFC-Karte">
Suche nach dem genauen Wert, wie er beim Kunden steht. Du findest den Kunden unter **Kunden**, nicht in einer eigenen Kategorie.
</Accordion>
<Accordion title="Ich finde eine Reservierung nicht">
Tippe die Nummer so, wie sie auf dem Dokument steht, oder einen Teil davon: Für `RES/2026/0042` funktionieren auch `2026/0042` und `20260042`. Suche sonst nach dem Namen des Kunden.
</Accordion>
<Accordion title="Ein Telefonanruf wird über die Notiz nicht gefunden">
Notizen zu Telefonanrufen werden verschlüsselt gespeichert und deshalb nicht durchsucht. Suche nach der Telefonnummer.
</Accordion>
<Accordion title="Das Tastenkürzel funktioniert nicht">
Manche Browser oder Erweiterungen nutzen Strg+K oder ⌘K selbst. Klicke dann in der Kopfzeile auf **Suchen**.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Kunden verwalten" />
  <Card title="Belegungen" href="/bezettingen" description="Ein Kunde auf einer Parzelle" />
  <Card title="Reservierungen" href="/reserveringen" description="Reservierungen verwalten" />
  <Card title="Rechnungen" href="/facturen" description="Rechnungen verwalten" />
</Cards>


# Aktivitätsprotokoll (/de-DE/activiteitenlog)

Im Aktivitätsprotokoll siehst du, was sich in Tillor geändert hat, wann und durch wen. Du öffnest es bei einem Kunden, einer Rechnung, einer Aufgabe oder einem anderen Datensatz und zentral über **Auditprotokoll**, wenn du dafür die Berechtigung hast. Es ist eine schreibgeschützte Spur, mit der du etwas nachprüfen oder belegen kannst.

<Callout type="info" title="Gut zu wissen">
- Einen Eintrag kannst du weder bearbeiten noch löschen
- Ein Export enthält standardmäßig die letzten 30 Tage, höchstens ein Jahr
- Wird dasselbe Dokument innerhalb von zehn Minuten mehrfach geöffnet, steht es nur einmal im Protokoll
- Zeiten werden in deiner Zeitzone angezeigt
- Auch Aktionen einer Automatisierung, eines API-Schlüssels oder des Systems stehen darin, mit der Art des Akteurs
</Callout>

## Aktivitätsprotokoll ansehen [#activiteitenlog-bekijken]

In der App heißt es meist **Ereignisse** oder **Aktivität**, je nachdem, wo du bist. Wer die Berechtigung *Auditprotokoll ansehen* hat, kann zusätzlich eine zentrale Übersicht über *Auditprotokoll* in der Seitenleiste (über Einstellungen) öffnen, mit Filtern nach Benutzer, Ereignistyp und Datum.

| Wo | Navigation | Label in der App |
|------|-----------|-----------------|
| Kunde (alle zugehörigen Aktivitäten) | *Kunden > Kunde > Ereignisse* | Ereignisse |
| Rechnung | *Verwaltung > Rechnungen > Rechnung* | Ereignisse |
| Reservierung | *Kunden > Kunde > Reservierungen > Reservierung* | Aktivität |
| Parzelle | *Park > Parzellen > Parzelle* | Ereignisse |
| Zähler | *Park > Zähler > Zähler* | Aktivität |
| Produkt | *Verwaltung > Produkte > Produkt* | Ereignisse |
| Aufgabe | *Aufgaben > Aufgabe* oder *Kunden > Kunde > Aufgaben > Aufgabe* | Aktivität |
| NFC-Tag | *Controller > NFC-Tags > Tag* | Aktivität |
| Tablet, Kiosk oder Telefon | *Einstellungen > Tablets & Kioske > Gerät* | Verlauf |
| Organisation (zentral) | *Auditprotokoll* (über Einstellungen, Berechtigung *Auditprotokoll ansehen*) | Auditprotokoll |
| Zahlungsbericht | *Verwaltung > Zahlungsberichte > Bericht* | Ereignisprotokoll |

Pro Aktivität siehst du in der Zeitleiste:

- **Titel** - Art des Ereignisses (z. B. „Rechnung gebucht“, „Kunde aktualisiert“)
- **Benutzer** - Kollege, der die Aktion ausgeführt hat (oder Tillor bei automatischen Aktionen)
- **Zeitpunkt** - Datum und relative Zeit
- **Beschreibung** - zusätzliche Details, manchmal mit Verknüpfungen zu zugehörigen Rechnungen oder anderen Datensätzen
- **Vorher / nachher** (manchmal) - beim Anlegen, Ändern oder Löschen von Kunden-, Kontakt-, Rechnungs-, Zahlungs-, Zahlungsmandat-, Zahlungsgruppen-, Dokument-, Zugangsmethoden-, Zugangspunkt-, Controller-, Parzellen-, Zähler-, Zählerstand-, Produkt-, Belegungs-, Aufgaben- oder Kommentardaten, außerdem beim Scannen, Zuweisen oder Trennen eines Ausweises und bei Änderungen an Einstellungen, Mitgliedsrechten, Rechnungsstellung oder NFC: welche Felder geändert wurden. PIN-Codes von Zugangspunkten und personenbezogene Daten eines Ausweises werden nicht im Protokoll gespeichert
- **Anhänge** (manchmal) - herunterladbare Dateien, zum Beispiel bei fehlgeschlagenen Integrationen
- **Login / Logout** - wann sich ein Kollege an- oder abmeldet, sichtbar in der zentralen Auditprotokoll-Übersicht
- **OAuth-Apps und Einwilligung** - Anlegen, Ändern, Löschen oder Geheimnis-Rotation von OAuth-Apps sowie erteilte, verweigerte oder widerrufene Einwilligungen; sichtbar in der zentralen Auditprotokoll-Übersicht. Client-Geheimnisse werden nicht im Protokoll gespeichert
- **Verwaltung und Sicherheit** - Änderungen am Organisationsprofil (Name, rechtliche Angaben, USt, IBAN, Logo, Wartungsmodus), Einladungen und neue Mitglieder, persönliche API-Schlüssel (anlegen, ändern, erneuern, löschen), beendete Sitzungen, Webhooks, Automatisierungen, Kollegengruppen, Parzellentypen, Zählerkästen, Controller-Gruppen, installierte oder entfernte Integrationen und die Annahme des Auftragsverarbeitungsvertrags; sichtbar in der zentralen Auditprotokoll-Übersicht. Schlüssel, Webhook-Geheimnisse und Integrationseinstellungen werden nicht gespeichert; bei einer Integration siehst du nur, welche Einstellungen geändert wurden
- **Einsicht in personenbezogene Daten** - wer ein Dokument geöffnet oder heruntergeladen hat, die Bilder oder Dateien eines Ausweises angesehen oder heruntergeladen hat oder das PDF einer Rechnung geöffnet oder an das Tablet gesendet hat. Mehrfaches Öffnen innerhalb von zehn Minuten wird nur einmal vermerkt; jeder Download eines Ausweises wird einzeln vermerkt

## Aktivitäten pro Datensatz [#activiteiten-per-record]

Auf Detailseiten siehst du eine Zeitleiste mit der Aktivität für diesen Datensatz. Auf dem Tab **Ereignisse** bei einem Kunden stehen alle Aktivitäten, die mit diesem Kunden verknüpft sind (Rechnungen, Zahlungen, Belegungen usw.).


<DocScreenshot src="/screenshots/activiteitenlog/customer-events.png" alt="Ereignisse im Kundenprofil Jonas Maes" />

Bei **Reservierungen** gehören dazu unter anderem Anlegen, Einchecken und Auschecken, Stornierungen und zugehörige Rückbuchungen sowie das Aktualisieren von Reservierungsdaten.

Bei **Zahlungsgruppen** siehst du auch, welche Zahlungen einer Gruppe hinzugefügt oder daraus entfernt wurden, und bei **Controllern**, welche Übernahmeanfragen genehmigt oder abgelehnt wurden.

Bei **Zahlungsberichten** gehören dazu unter anderem das Anlegen des Berichts, das Finalisieren eines Entwurfs und das Senden an die Buchhaltung.

Bei **Signaturanfragen** siehst du jeden Schritt: angelegt und geändert, gesendet, Link (erneut) gesendet, erinnert, Unterschriftsseite geöffnet, Code gesendet oder falsch eingegeben, unterschrieben, abgelehnt, auf Entwurf zurückgesetzt, storniert, abgelaufen und abgeschlossen. Siehe [Nachweis und Gültigkeit](/handtekeningen/bewijs-en-geldigheid).

Bei **externen Benachrichtigungen** siehst du, wann ein verbundenes System eine von ihm registrierte Benachrichtigung aktualisiert oder gelöscht hat.

<Callout type="info">
Das Aktivitätsprotokoll ist schreibgeschützt. Einträge können nicht bearbeitet oder gelöscht werden.
</Callout>

## Wer hat es getan? [#wie-heeft-het-gedaan]

Jede Zeile zeigt neben dem Benutzer auch, **welche Art von Akteur** die Aktion ausgeführt hat: ein angemeldeter Benutzer, ein API-Schlüssel, eine OAuth-Verbindung, eine Automatisierung, der Tillor-Connector oder das System selbst. Bei einem API-Schlüssel oder einer OAuth-Verbindung steht die ID dieses Schlüssels oder dieser Verbindung in den Details, sodass du bei einem durchgesickerten Schlüssel genau siehst, was damit geschehen ist. Steht dort **Unbekannt**, konnte Tillor den Akteur nicht feststellen; das ist bewusst etwas anderes als „System“.

## Sicherheitsereignisse [#beveiligingsgebeurtenissen]

Fehlgeschlagene Anmeldungen, abgelehnte API-Schlüssel und OAuth-Tokens, verweigerter Zugriff (fehlende Berechtigungen), überschrittene Anfragelimits und das Öffnen deiner Organisation durch einen Tillor-Administrator werden ebenfalls im Aktivitätsprotokoll angezeigt, mit IP-Adresse und Browser. Mitglieder mit der Berechtigung **Sicherheitswarnungen** erhalten jede Stunde eine Meldung, wenn Webhooks, API-Schlüssel oder Automatisierungen geändert wurden oder wenn der Zugriff wiederholt verweigert wurde.

Auch der Zugriff, den du [Tillie](/vraag-het-tillie#tillie-in-je-account-laten-kijken) auf dein Konto gibst oder widerrufst, und jede Änderung, die du über Tillie bestätigst, stehen hier.

## Für ein Audit exportieren [#exporteren-voor-een-audit]

Mit **Exportieren** im Aktivitätsprotokoll lädst du alle Zeilen des gewählten Zeitraums (standardmäßig die letzten 30 Tage, höchstens ein Jahr) als ZIP herunter, mit der Datendatei (CSV oder JSON Lines), einer `manifest.json` mit der Zeilenanzahl, dem Zeitraum, wer exportiert hat und der SHA-256-Prüfsumme der Datendatei, und einer Datei `CHECKSUMS.sha256`, die du mit `sha256sum -c` prüfen kannst. Der Export selbst wird ebenfalls im Protokoll festgehalten, mit derselben Prüfsumme. Auch das Öffnen des vollständigen Aktivitätsprotokolls und Massenexporte von Kundendaten (Kundenliste, Zugangsprotokoll, Parzellen, Zähler) werden protokolliert.

Alle Zeiten werden in **UTC** auf Servern mit NTP-Zeitsynchronisierung gespeichert und in deiner Zeitzone angezeigt; der Export enthält ISO-8601-Zeitangaben in UTC.

## Wofür nutzt du das Protokoll? [#waarvoor-gebruik-je-de-log]

- **Kontrolle** - nachprüfen, welcher Kollege eine Rechnung gebucht oder einen Kunden geändert hat
- **Fehlersuche** - herausfinden, wann ein Fehler aufgetreten ist
- **Audits** - eine vollständige Spur für interne oder externe Prüfungen führen

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Benutzer" href="/gebruikers" description="Benutzer und Berechtigungen verwalten" />
  <Card title="Rechnungen" href="/facturen" description="Rechnungsverlauf ansehen" />
</Cards>


# Erste Schritte (/de-DE/automatiseringen/aan-de-slag)

Auf dieser Seite baust du deine erste Automatisierung und lernst den Editor kennen, den Bildschirm, in dem du Abläufe zeichnest. Du brauchst die Berechtigung **Automatisierungen verwalten** oder **Alle Berechtigungen**. Den Hintergrund findest du in der [Übersicht](/automatiseringen).

## Die Übersicht [#het-overzicht]

Gehe zu **Administrator > Automatisierungen**. Du siehst eine Liste mit einer Zeile pro Automatisierung:

- der Name und ein Label wie **2 Probleme**, wenn mit dem Ablauf noch etwas nicht stimmt (siehe [Probleme und Aktivieren](/automatiseringen/problemen))
- die Beschreibung
- der gewählte Auslöser, die Anzahl der Schritte und wer die Automatisierung erstellt hat (**von**)
- eine Reihe von Balken mit den letzten Ausführungen, daneben der Zeitpunkt der letzten Ausführung oder **Noch nicht ausgeführt**. Ein roter Balken ist eine fehlgeschlagene Ausführung
- ein Schalter, um die Automatisierung ein- oder auszuschalten, und ein Menü mit drei Punkten

<DocScreenshot src="/screenshots/automatiseringen/overview.png" alt="Übersicht der Automatisierungen mit der Liste, den Filtern und dem Suchfeld" />

Oben in der Liste filterst du mit **Alle**, **Aktiviert** und **Pausiert**. Hat eine Automatisierung Probleme, kommt außerdem ein Filter **Probleme** hinzu. Mit **Automatisierungen suchen** suchst du nach Name oder Beschreibung.

Klicke auf den Namen, um den Editor zu öffnen. Mit dem Schalter schaltest du eine Automatisierung ein oder aus. Einschalten ist nicht möglich, solange es Probleme gibt. Das Menü **Aktionen für Automatisierung** hat zwei Auswahlmöglichkeiten:

| Auswahl | Was sie tut |
|---|---|
| **Duplizieren** | Erstellt eine Kopie mit dem Namen *[Name] (Kopie)*. Die Kopie ist pausiert |
| **Löschen** | Löscht die Automatisierung und den Ausführungsverlauf. Tillor bittet vorher um Bestätigung |

Ausführungen, die gerade in einer Verzögerung warten, werden beendet, wenn du die Automatisierung löschst.

## Eine neue Automatisierung erstellen [#een-nieuwe-automatisering-maken]

Klicke auf **Neue Automatisierung**. Es öffnet sich eine Galerie mit sechs Startpunkten. Jeden Schritt kannst du nachträglich anpassen.

| Startpunkt | Was er tut |
|---|---|
| **Von Grund auf starten** | Ein leerer Ablauf mit nur einem Auslöser |
| **Parzelle nach Abreise prüfen** | Legt eine Kontrollaufgabe für die Parzelle an, wenn eine Belegung endet, mit hoher Priorität und zugewiesen an die Person, die die Belegung beendet hat |
| **Unbezahlte Rechnungen nachverfolgen** | Wartet bis nach dem Fälligkeitsdatum, sendet eine Zahlungserinnerung und legt eine Woche später eine Aufgabe an, den Kunden anzurufen, wenn die Rechnung noch offen ist |
| **Reservierungen an ein anderes System senden** | Sendet für jede neue Reservierung eine eigene Payload an deinen Webhook-Endpunkt und legt eine Aufgabe an, wenn die Zustellung fehlschlägt |
| **Zähler prüfen, der nicht mehr zählt** | Legt eine Aufgabe für die Rezeption an, wenn ein Zähler stehen bleibt, obwohl die Parzelle genutzt wurde, mit Unteraufgaben für die Prüfung vor Ort |
| **Die Tillor API aufrufen** | Fügt über die Tillor API jeder neuen Aufgabe einen Kommentar hinzu |

<DocScreenshot src="/screenshots/automatiseringen/gallery.png" alt="Galerie Neue Automatisierung mit den Startpunkten" />

Sobald du auswählst, legt Tillor die Automatisierung an und öffnet den Editor. Die Automatisierung ist pausiert, bis du sie aktivierst.

## Der Editor [#de-editor]

Der Editor füllt den ganzen Bildschirm und hat drei Teile: links die Schrittliste, in der Mitte die Arbeitsfläche und rechts den Bereich. Der Name der Automatisierung steht oben in der Brotkrumennavigation und lässt sich dort direkt ändern.

<DocScreenshot src="/screenshots/automatiseringen/editor.png" alt="Editor mit der Schrittliste links, der Arbeitsfläche in der Mitte und dem Bereich rechts" />

Bewege den Mauszeiger über die ℹ-Markierungen für eine kurze Erklärung zu jedem Teil.

**Schrittliste (links).** Suche einen Schritt mit **Schritte suchen**. Oben steht die Gruppe **Hilfsmittel** mit **Notiz** und **Rahmen** (siehe [Notizen und Rahmen](#opmerkingen-en-kaders)). Darunter stehen die Schritte in sechs Gruppen, mit **Dokumente** dazwischen:

- **Logik**: der Auslöser **Wenn das passiert** und Bedingungen, Warten, Nachschlagen und Durchlaufen, wie **Wenn / sonst**, **Verzweigung**, **Verzögerung**, **Jetzt geöffnet?**, **Datensatz nachschlagen**, **Für jedes** und **Um eine Entscheidung bitten**. Siehe [Bedingungen, Verzweigungen und Verzögerungen](/automatiseringen/logica)
- **Aufgaben**: Aufgaben anlegen, suchen und aktualisieren
- **Dokumente**: Dokumente suchen und aktualisieren
- **Gäste und Nachrichten**: Nachrichten an Gäste und Kollegen, Kommentare, die Inbox, Kunden und Reservierungen
- **Rechnungen und Zahlungen**: Rechnungen, Zahlungslinks, Mandate und Verbrauch
- **Zugang und Geräte**: Zugangsmittel, Schranken, Strom, NFC-Tags und Tablets
- **Integrationen**: **Webhook senden** und **API-Anfrage**

Was jede Aktion tut, steht unter [Aktionen](/automatiseringen/acties). Ganz unten steht **Schritt anfragen**, falls dir ein Schritt fehlt.

**Arbeitsfläche (Mitte).** Hier siehst du den Ablauf. Oben steht der Auslöser, darunter die Schritte mit Linien dazwischen. Unten links zoomst du hinein und heraus.

**Bereich (rechts).** Oben stehen der Schalter **Aktiv**, bei Problemen eine Schaltfläche wie **1 Problem**, eine Schaltfläche **Aufräumen**, die die Schritte ordentlich untereinander anordnet (Notizen bleiben, wo sie sind), und eine Schaltfläche **Bereich ausblenden**. Blendest du den Bereich aus, zeigt **Bereich einblenden** ihn wieder an. Darunter wählst du einen Tab:

| Tab | Was du dort tust |
|---|---|
| **Konfigurieren** | Den gewählten Schritt anpassen. Wählst du nichts aus, kannst du eine **Beschreibung** für die Automatisierung eingeben |
| **Testlauf** | Den Ablauf ausprobieren, siehe [Testen und Ausführungen](/automatiseringen/testen-en-uitvoeringen) |
| **Ausführungen** | Nachsehen, was echte Ausführungen getan haben |
| **Verlauf** | Frühere gespeicherte Versionen ansehen und wiederherstellen, siehe [Frühere Versionen](#eerdere-versies) |

Hast du Änderungen gemacht, steht unten im Bereich **Nicht gespeicherte Änderungen** mit den Schaltflächen **Zurücksetzen** und **Speichern**. **Zurücksetzen** setzt den Ablauf auf die zuletzt gespeicherte Version zurück. Ist der Bereich ausgeblendet, stehen diese Schaltflächen oben rechts auf der Arbeitsfläche.

Solange du keinen Schritt ausgewählt hast, steht unter der Beschreibung, wer die Automatisierung erstellt hat. Fehlgeschlagene Ausführungen werden an diese Person gemailt, höchstens einmal pro Stunde pro Automatisierung.

Auf einem Telefon ist der Bereich zunächst ausgeblendet, damit die Arbeitsfläche den ganzen Bildschirm bekommt. Tippe auf einen Schritt oder auf **Bereich einblenden**, um ihn zu öffnen.

### Schritte hinzufügen und verbinden [#stappen-toevoegen-en-verbinden]

Du hast vier Möglichkeiten, einen Schritt hinzuzufügen:

- Klicke links in der Liste auf einen Schritt. Er erscheint in der Mitte der Arbeitsfläche
- Ziehe einen Schritt aus der Liste auf die Arbeitsfläche
- Klicke auf das Plus unter einem Ausgang, der noch nirgendwohin führt (**Schritt nach "[Ausgang]" hinzufügen**), und wähle einen Schritt. Der neue Schritt wird sofort verbunden
- Ziehe einen Schritt auf eine Linie. Er wird dann zwischen die beiden Schritte gesetzt (**Hier einen Schritt einfügen**)

Um Schritte miteinander zu verbinden, ziehst du vom Ausgang unter einem Schritt zu einem anderen Schritt. Dabei gilt:

- Jeder Ausgang führt zu einem Schritt. Verbindest du einen Ausgang erneut, ersetzt die neue Linie die alte
- Eine Linie, die einen Kreis ergeben würde, wird abgelehnt. Steckt trotzdem eine Schleife im Ablauf, kannst du die Automatisierung nicht aktivieren. Eine Ausführung stoppt, sobald sie einen Schritt erneut ausführen würde
- Ein Schritt ohne eingehende Linie wird nie ausgeführt. Tillor meldet das als Problem (**Nicht verbunden, daher wird dieser Schritt nie ausgeführt.**)
- Einen Auslöser kannst du über die Liste links anpassen, duplizieren und zusätzlich hinzufügen. Den letzten Auslöser kannst du nicht entfernen. Ein Auslöser gehört nicht auf eine Linie: Er startet eine eigene Ausführung

Gib einem Schritt im Feld **Schrittname** einen eigenen Namen. Das hilft, wenn dein Ablauf größer wird. Mit den Schaltflächen **Schritt duplizieren** und **Schritt löschen** oben im Bereich kopierst oder entfernst du den gewählten Schritt.

### Notizen und Rahmen [#opmerkingen-en-kaders]

Mit einer Notiz erklärst du auf der Arbeitsfläche, was ein Teil des Ablaufs tut, zum Beispiel warum eine Bedingung dort steht. Ein **Rahmen** ist eine gestrichelte Linie mit einem Namen, die du um eine Gruppe von Schritten setzt.

- Klicke in der Gruppe **Hilfsmittel** auf **Notiz** oder **Rahmen** und tippe deinen Text
- Ziehe die Notiz oder den Rahmen zu den Schritten, die sie erklären. Wähle sie aus, um sie mit den Ecken größer oder kleiner zu machen
- Lösche eine Notiz mit **Notiz löschen** oder einen Rahmen mit **Rahmen löschen**, oder wähle sie aus und drücke Entf
- Notizen und Rahmen werden nie ausgeführt und zählen nicht für Probleme. Du kannst zusammen höchstens 50 platzieren. Sie werden mit **Speichern** gesichert, genau wie die Schritte, und Strg/Cmd + Z macht eine Änderung rückgängig

### Frühere Versionen [#eerdere-versies]

Bei jedem Speichern einer Änderung bewahrt Tillor die vorherige Version auf. Auf dem Tab **Verlauf** siehst du die Versionen mit dem, was sich geändert hat, zum Beispiel **1 Schritt hinzugefügt** oder **Anordnung oder Verbindungen geändert**, und von wem oder was die Änderung kam (zum Beispiel **Über die API**). Mit **Wiederherstellen** legst du eine Version auf die Arbeitsfläche. Das zählt als nicht gespeicherte Änderung: Speichere, um die Version zu behalten, oder mache sie rückgängig.

### Tastenkürzel [#sneltoetsen]

| Taste | Was sie tut |
|---|---|
| Strg/Cmd + S | Speichern |
| Strg/Cmd + Z | Rückgängig |
| Strg/Cmd + Shift + Z oder Strg/Cmd + Y | Wiederholen |
| Strg/Cmd + C, Strg/Cmd + V | Gewählte Schritte kopieren und einfügen |
| Strg/Cmd + D | Gewählte Schritte duplizieren |
| Strg/Cmd + A | Alles auswählen |
| Entf oder Rücktaste | Gewählte Schritte oder Linien löschen |
| Esc | Auswahl aufheben |

## Speichern und aktivieren [#opslaan-en-inschakelen]

Tillor speichert nicht automatisch. Klicke auf **Speichern** (oder drücke Strg/Cmd + S), um deine Änderungen zu sichern. Die Schaltfläche ist aktiv, sobald etwas geändert wurde und der Name nicht leer ist.

<Callout type="warn">
Ist die Automatisierung eingeschaltet, kannst du nur speichern, wenn es keine Probleme mehr gibt. Ein laufender Ablauf muss immer gültig bleiben. Behebe die Probleme oder pausiere die Automatisierung zuerst.
</Callout>

Mit dem Schalter **Aktiv** schaltest du die Automatisierung ein. Das speichert den Ablauf auch sofort. Der Schalter funktioniert nicht, solange es Probleme gibt, mit der Erklärung **Behebe zuerst die offenen Probleme**. Danach startet die Automatisierung bei jedem passenden Ereignis. Es kann eine halbe Minute dauern, bis eine Änderung überall wirkt.

Änderst du später einen eingeschalteten Ablauf, gelten diese Änderungen nur für neue Ausführungen. Ausführungen, die schon laufen oder in einer Verzögerung warten, werden mit dem Ablauf beendet, wie er war, als sie gestartet sind.

## Deine erste Automatisierung: eine Aufgabe nach der Abreise [#je-eerste-automatisering-een-taak-na-vertrek]

Dieses Beispiel legt eine Aufgabe an, wenn eine Belegung endet.

1. Klicke auf **Neue Automatisierung** und wähle **Parzelle nach Abreise prüfen**
2. Klicke auf den Auslöser. Bei **Ereignis** steht `occupation:ended`
3. Klicke auf den Schritt **Aufgabe erstellen**. Passe **Titel**, **Beschreibung** und **Priorität** an, oder wähle bei **Zum Board hinzufügen** ein Board und eine **Spalte**
4. Öffne den Tab **Testlauf** und klicke auf **Test ausführen**. Du siehst, welche Schritte der Ablauf durchlaufen würde
5. Klicke auf **Speichern** und schalte **Aktiv** ein
6. Beende eine Belegung und sieh auf dem Tab **Ausführungen** nach, was passiert ist

## Einen Schritt oder ein Ereignis anfragen [#een-stap-of-gebeurtenis-aanvragen]

Fehlt dir ein Auslöser, eine Bedingung oder eine Aktion? Klicke unter der Schrittliste auf **Schritt anfragen**. In der Ereignisliste des Auslösers steht außerdem ein Link **Fehlt ein Ereignis? Frag es an**.

1. Wähle bei **Was brauchst du?** eine der Optionen **Ein Auslöser oder Ereignis**, **Eine Bedingung oder ein Filter**, **Eine Aktion** oder **Etwas anderes**
2. Beschreibe bei **Was soll er tun?**, was du automatisieren möchtest. Schreibe mindestens 10 Zeichen, höchstens 1000
3. Klicke auf **Anfrage senden**

Deine Anfrage geht an das Tillor-Team, zusammen mit deinem Namen und dem Namen deiner Organisation. Du erhältst eine Meldung, dass die Anfrage gesendet wurde.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Eine neue Automatisierung ist pausiert. Es passiert nichts, bis du **Aktiv** einschaltest.
- Nach dem Aktivieren startet die Automatisierung bei jedem passenden Ereignis. Es kann eine halbe Minute dauern, bis eine Änderung überall wirkt.
- Jeder Start ist eine Ausführung. Du siehst sie auf dem Tab **Ausführungen**, mit dem Status **Abgeschlossen**, **Wartet**, **Fehlgeschlagen** oder **Abgebrochen**.
- Schlägt eine Ausführung fehl, erhält die Person, die die Automatisierung erstellt hat, eine E-Mail, höchstens eine pro Stunde pro Automatisierung.
- Änderst du einen laufenden Ablauf, gelten die Änderungen nur für neue Ausführungen. Was schon läuft oder wartet, wird mit dem alten Ablauf beendet.
- Aufgaben und Kommentare, die die Automatisierung erstellt, stehen unter dem Namen **Workflow**. Siehe [Wer führt eine Automatisierung aus?](/automatiseringen/workflow-gebruiker).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Schalter Aktiv funktioniert nicht">
Tillor zeigt **Behebe zuerst die offenen Probleme**. Klicke oben im Bereich auf die Schaltfläche mit der Anzahl der Probleme und behebe sie. Siehe [Probleme und Aktivieren](/automatiseringen/problemen).
</Accordion>
<Accordion title="Ich kann nicht speichern">
Die Schaltfläche **Speichern** ist erst aktiv, wenn etwas geändert wurde und der Name nicht leer ist. Ist die Automatisierung eingeschaltet, kannst du nur ohne Probleme speichern. Behebe sie oder pausiere zuerst.
</Accordion>
<Accordion title="Mein Schritt wird nie ausgeführt">
Tillor meldet **Nicht verbunden, daher wird dieser Schritt nie ausgeführt.** Ziehe vom Ausgang eines früheren Schritts zu diesem Schritt.
</Accordion>
<Accordion title="Ich kann eine Linie nicht verbinden">
Eine Linie, die einen Kreis ergeben würde, wird abgelehnt. Ein Ablauf kann nur vorwärts gehen.
</Accordion>
<Accordion title="Ich sehe Automatisierungen nicht im Menü">
Das Menü erscheint nur, wenn du die Berechtigung **Automatisierungen ansehen** hast. Zum Bauen und Ändern brauchst du **Automatisierungen verwalten**. Bitte einen Administrator, deine Berechtigungen anzupassen.
</Accordion>
<Accordion title="Der Ablauf reagiert nicht auf meine Aktion">
Gehe die Punkte bei [Warum startet meine Automatisierung nicht?](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet) durch.
</Accordion>
</Accordions>

## Nächste Schritte [#volgende-stappen]

<Cards>
  <Card
    title="Auslöser"
    href="/automatiseringen/triggers"
    description="Wähle, wann eine Automatisierung startet"
  />
  <Card
    title="Aktionen"
    href="/automatiseringen/acties"
    description="Was eine Automatisierung alles tun kann"
  />
  <Card
    title="Beispiel: Kontrolle Mietwohnwagen"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Ein kompletter Ablauf mit einer Suche, einer Verzweigung und Unteraufgaben"
  />
</Cards>


# Dokumente (/de-DE/automatiseringen/acties/documenten)

Mit diesen Aktionen arbeitest du mit den Dokumenten eines Kunden, zum Beispiel mit einem Zahlungsnachweis der Versicherung. Der Typ und das Ablaufdatum eines Dokuments stehen bei den Dokumentdaten. In einem Ablauf liest du sie als `{document.userMetadata.documentType}` und `{document.userMetadata.insuranceExpiryDate}`.

## Dokument suchen [#document-zoeken]

Sucht das neueste Dokument eines Kunden. Der Schritt hat zwei Ausgänge: **Gefunden** und **Nicht gefunden**.

| Feld | Was du eingibst |
|---|---|
| **Kunde** | Die ID des Kunden, zum Beispiel `{document.customerId}` oder `{customer.id}`. Pflichtfeld |
| **Typ** | Zum Beispiel **Zahlungsnachweis der Versicherung**. Leer lassen für jeden Typ |
| **Archivierte Dokumente überspringen** | Standardmäßig an |
| **Nur Dokumente, die nicht abgelaufen sind** | Das Ablaufdatum muss nach jetzt liegen. Dokumente ohne Ablaufdatum zählen dann nicht mit. Standardmäßig aus |

Passen mehrere Dokumente, nimmt der Schritt das neueste. Über **Gefunden** können spätere Schritte `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}` und `{foundDocument.userMetadata.insuranceExpiryDate}` verwenden.

So prüfst du zum Beispiel bei einer abgelaufenen Versicherung, ob der Kunde schon einen neuen, gültigen Zahlungsnachweis hat: Suche mit **Typ** *Zahlungsnachweis der Versicherung* und **Nur Dokumente, die nicht abgelaufen sind** eingeschaltet, und mache nur über **Nicht gefunden** weiter.

## Dokument aktualisieren [#document-bijwerken]

Ändert den Typ eines Dokuments oder archiviert bzw. stellt es wieder her. Leere Felder bleiben, wie sie sind.

| Feld | Was du eingibst |
|---|---|
| **Dokument** | Die ID des Dokuments. Standardmäßig `{document.id}`. Pflichtfeld |
| **Neuer Typ** | Leer lassen, um den Typ zu behalten |
| **Status** | **Aktiv** oder **Archiviert**. Leer lassen, um den Status zu behalten |

Ein Typ, der ein Ablaufdatum verlangt, wie **Zahlungsnachweis der Versicherung**, schlägt fehl, wenn das Dokument kein Ablaufdatum hat. Die Aktion liefert `{updatedDocument.id}`.


# Rechnungen und Zahlungen (/de-DE/automatiseringen/acties/facturen-en-betalingen)

Diese Schritte stehen in der Gruppe **Rechnungen und Zahlungen**. Wie die Ausgänge funktionieren, liest du unter [Ausgänge einer Aktion](/automatiseringen/acties#uitgangen-van-een-actie).

## Zahlungserinnerung senden [#betalingsherinnering-versturen]

Sendet die Zahlungserinnerung einer Rechnung an den Kunden, genau wie die Erinnerungsschaltfläche an der Rechnung.

| Feld | Was du eingibst |
|---|---|
| **Rechnung** | Die ID der Rechnung. Standardmäßig `{invoice.id}`. Pflichtfeld |

Beachte, dass das Feld die interne ID der Rechnung erwartet (`{invoice.id}`) und nicht die Rechnungsnummer (`{invoice.displayId}`).

Der Schritt schlägt fehl, wenn:

- die Rechnung nicht gebucht ist
- nichts mehr offen ist, die Rechnung also schon bezahlt ist
- der Kunde keine E-Mail-Adresse, keine Telefonnummer und keine vollständige Postadresse hat

Die Ausführung erhält dann den Status **Fehlgeschlagen** und der Rest des Ablaufs wird nicht ausgeführt. Setze daher vor die Erinnerung ein **Wenn / sonst**, das prüft, ob die Rechnung noch offen ist, wie in der Vorlage **Unbezahlte Rechnungen nachverfolgen**.

Der Schritt überspringt eine Rechnung auch, wenn sie aus den automatischen Erinnerungen genommen wurde oder wenn beim Kunden **Von automatischen Mahnungen ausschließen** eingeschaltet ist.

## Banktransaktionen synchronisieren [#banktransacties-synchroniseren]

Holt neue Banktransaktionen ab und wartet, bis der Import fertig ist. Setze diesen Schritt vor **Zahlungserinnerung senden**, damit eine Rechnung, die gerade bezahlt wurde, keine Erinnerung erhält. Ist Ponto nicht verbunden, wird der Schritt übersprungen.

Speichere die Automatisierung vom Büronetzwerk aus. Tillor merkt sich dann die IP, die die Bankverbindung braucht. Ohne diese IP kann die Synchronisierung nicht starten.

## Automatische Mahnungen für Kunden deaktivieren [#automatische-herinneringen-uitschakelen-voor-klant]

Schaltet **Von automatischen Mahnungen ausschließen** in den Rechnungseinstellungen des Kunden ein. Erinnerungsabläufe überspringen danach alle seine Rechnungen. Eine manuelle Mahnung bleibt möglich.

| Feld | Was du eingibst |
|---|---|
| **Kunde** | Die ID des Kunden. Pflichtfeld |

## Automatische Mahnungen für Rechnung deaktivieren [#automatische-herinneringen-uitschakelen-voor-factuur]

Nimmt eine einzelne Rechnung aus den Abläufen für überfällige Erinnerungen und den automatischen Erinnerungen. Mitarbeiter können weiterhin manuell eine Erinnerung senden.

| Feld | Was du eingibst |
|---|---|
| **Rechnung** | Die ID der Rechnung. Pflichtfeld |

## Rechnung senden [#factuur-versturen]

Sendet eine Rechnung an den Kunden, auf dieselbe Weise wie die Sendeschaltfläche an der Rechnung.

| Feld | Was du eingibst |
|---|---|
| **Rechnung** | Die ID der Rechnung. Standardmäßig `{invoice.id}`. Pflichtfeld |

Der Schritt schlägt fehl, wenn die Rechnung nicht gebucht ist oder wenn der Kunde keine E-Mail-Adresse, keine Telefonnummer und keine vollständige Postadresse hat.

## Rechnung buchen [#factuur-boeken]

Bucht eine Entwurfsrechnung, damit sie ihre Rechnungsnummer erhält.

| Feld | Was du eingibst |
|---|---|
| **Rechnung** | Die ID der Rechnung. Standardmäßig `{invoice.id}`. Pflichtfeld |

Ist die Rechnung schon gebucht, passiert nichts und der Ablauf geht über **Übersprungen** weiter. Nach dem Buchen liefert die Aktion `{bookedInvoice.displayId}`, die Rechnungsnummer. Die kannst du in einer Nachricht oder Aufgabe verwenden. Kombiniere den Schritt mit **Rechnung senden**, um eine Entwurfsrechnung in einem Zug zu buchen und zu senden.

## Rechnung drucken [#factuur-afdrukken]

Druckt eine Rechnung aus oder zeigt sie auf dem Tablet an der Rezeption an.

| Feld | Was du eingibst |
|---|---|
| **Rechnung** | Die ID der Rechnung. Standardmäßig `{invoice.id}`. Pflichtfeld |
| **Wo** | **A4-Drucker** (Standard), **Bondrucker** oder **Tablet** |

Die Drucker stellst du unter [Druckeinstellungen](/printer/afdrukinstellingen) ein. Eine Rechnung, die du mit diesem Schritt ein zweites Mal druckst, wird einfach erneut gedruckt.

## Zahlungslink erstellen [#betaallink-aanmaken]

Erstellt einen Online-Zahlungslink für den Betrag, der auf einer Rechnung noch offen ist.

| Feld | Was du eingibst |
|---|---|
| **Rechnung** | Die ID der Rechnung. Standardmäßig `{invoice.id}`. Pflichtfeld |
| **Zahlungsmethode** | **Kunde wählt selbst** (Standard), **Bancontact**, **iDEAL**, **Kreditkarte** oder **Payconiq** |

Den Link gibt es nur für eine gebuchte Rechnung, bei der noch etwas offen ist. Ist die Rechnung nicht gebucht oder schon bezahlt, geht der Ablauf über **Übersprungen** weiter. Danach liefert die Aktion `{paymentLink.url}`. Setze das in einen Text, zum Beispiel in eine Nachricht über [Nachricht an Gast](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen).

## SEPA-Mandat anfordern [#sepa-mandaat-aanvragen]

Sendet einem Kunden per E-Mail die Aufforderung, ein SEPA-Mandat zu unterschreiben, oder eine Erinnerung für eine noch offene Anfrage. Zum Mandat selbst siehe [Mandat](/betalingsverwerking/mandaat).

| Feld | Was du eingibst |
|---|---|
| **Kunde** | Die ID des Kunden. Standardmäßig `{customer.id}`. Pflichtfeld |
| **Senden** | **Eine neue Anfrage** (Standard) oder **Eine Erinnerung** |

Eine neue Anfrage wird übersprungen, wenn schon eine offen ist. Eine Erinnerung wird übersprungen, wenn keine offene Anfrage existiert oder wenn die Anfrage abgelaufen ist. In beiden Fällen geht der Ablauf über **Übersprungen** weiter.

## Per Lastschrift einziehen [#innen-via-domiciliëring]

Zieht mit dem aktiven SEPA-Mandat des Kunden ein, was auf einer Rechnung noch offen ist.

| Feld | Was du eingibst |
|---|---|
| **Rechnung** | Die ID der Rechnung. Standardmäßig `{invoice.id}`. Pflichtfeld |
| **Nach Tagen** | Wie viele Tage Tillor mit dem Einzug wartet. Bei 0 wird sofort eingezogen. Das Maximum ist 7 Tage, eine höhere Zahl wird zu 7. Standardmäßig 0 |

Der Schritt zieht den gesamten offenen Betrag ein. Ist die Rechnung nicht gebucht oder schon bezahlt oder hat der Kunde kein aktives Mandat, passiert nichts und der Ablauf geht über **Übersprungen** weiter. Hat der Kunde mehr als ein aktives Mandat, verwendet der Schritt das neueste.

## Verbrauch abrechnen [#verbruik-factureren]

Rechnet den offenen Zählerverbrauch eines Kunden ab, bucht die Rechnung und sendet sie.

| Feld | Was du eingibst |
|---|---|
| **Kunde** | Die ID des Kunden. Standardmäßig `{occupation.customerId}`. Pflichtfeld |
| **Per E-Mail senden** | Standardmäßig an |
| **Per SMS senden** | Standardmäßig aus |

Gibt es nichts Offenes abzurechnen, wird keine Rechnung erstellt und der Ablauf geht über **Übersprungen** weiter. Andernfalls liefert die Aktion `{consumptionInvoice.id}`. Wie der Verbrauch erfasst wird, siehe [Zählerverwaltung](/meterbeheer).

## Verlängerungsrechnung entwerfen [#conceptfactuur-voor-verlenging]

Erstellt eine Entwurfsrechnung, die eine Belegung verlängert, bereit zur Kontrolle. Die Rechnung ist noch nicht gebucht. Das ist dieselbe Art Rechnung wie bei **Belegung verlängern (Rechnung)** im Kundenprofil.

| Feld | Was du eingibst |
|---|---|
| **Belegung** | Die ID der Belegung. Standardmäßig `{occupation.id}`. Pflichtfeld |
| **Offenen Verbrauch hinzufügen** | Setzt den offenen Zählerverbrauch des Kunden auf dieselbe Rechnung. Standardmäßig aus |

Die Aktion liefert `{extendInvoice.id}`. Willst du die Rechnung sofort buchen und senden, nutze danach **Rechnung buchen** und **Rechnung senden** mit `{extendInvoice.id}` als Rechnung.


# Gäste und Nachrichten (/de-DE/automatiseringen/acties/gasten-en-berichten)

Diese Schritte stehen in der Gruppe **Gäste und Nachrichten**. Wie die Ausgänge funktionieren, liest du unter [Ausgänge einer Aktion](/automatiseringen/acties#uitgangen-van-een-actie).

## Nachricht an Gast [#gast-een-bericht-sturen]

Sendet deinen eigenen Text per E-Mail, SMS oder WhatsApp an einen Kunden. Nutze es für Nachrichten, für die Tillor keine feste Vorlage hat, zum Beispiel eine Willkommensnachricht am Anreisetag.

| Feld | Was du eingibst |
|---|---|
| **Kunde** | Die ID des Kunden, zum Beispiel `{reservation.customerId}`. Pflichtfeld |
| **Betreff** | Nur für E-Mail. Leer verwendet den Namen deiner Organisation |
| **Nachricht** | Der Text, ohne Formatierung. Variablen werden eingesetzt. Pflichtfeld |
| **Per E-Mail senden** | Standardmäßig an |
| **Per SMS senden** | Standardmäßig aus |
| **Per WhatsApp senden** | Standardmäßig aus |

Beachte Folgendes:

- Kunden, die keine Kommunikation akzeptieren, erhalten nichts. Der Ablauf geht dann über **Übersprungen** weiter
- Außerhalb des 24-Stunden-Fensters von WhatsApp sendet Tillor deinen Text als genehmigte Vorlage. Innerhalb dieses Fensters geht er als normale Nachricht raus
- Existiert der Kunde nicht, schlägt der Schritt fehl

## Kollegen benachrichtigen [#collegas-verwittigen]

Sendet Kollegen eine Push-Benachrichtigung, eine E-Mail oder beides.

| Feld | Was du eingibst |
|---|---|
| **Kollegen** | Wähle einen oder mehrere Kollegen |
| **Auch die Person benachrichtigen, die das Ereignis ausgelöst hat** | Benachrichtigt auch den Kollegen, der das Ereignis ausgelöst hat. Hat das System das Ereignis ausgelöst, wird niemand hinzugefügt |
| **Titel** | Die Überschrift der Benachrichtigung. Pflichtfeld |
| **Nachrichtentext** | Der Inhalt der Benachrichtigung |
| **Als Push-Benachrichtigung senden** | Standardmäßig an |
| **Per E-Mail senden** | Standardmäßig aus |

Der **Workflow**-Benutzer erhält selbst nie eine Benachrichtigung. Gibt es keine Kollegen zu benachrichtigen, tut der Schritt nichts und der Ablauf geht einfach weiter.

## Kommentar hinzufügen [#opmerking-toevoegen]

Setzt einen [Kommentar](/notities) im Namen von **Workflow**.

| Feld | Was du eingibst |
|---|---|
| **Kommentar** | Der Text des Kommentars. Pflichtfeld |
| **Bei** | **Den Datensätzen des Ereignisses** (Standard) oder **Einer Aufgabe** |
| **Aufgabe** | Nur bei **Einer Aufgabe**: die ID der Aufgabe, zum Beispiel `{createdTask.id}`. Pflichtfeld |

Beachte Folgendes:

- Erwähne einen Kollegen mit `@{triggeredBy.name}({triggeredBy.id})`. Dieser Kollege erhält dann eine Benachrichtigung, genau wie bei einem Kommentar, den du selbst tippst. Das funktioniert nur, wenn ein Kollege das Ereignis ausgelöst hat
- Bei **Den Datensätzen des Ereignisses** landet der Kommentar beim Kunden, bei der Rechnung, der Reservierung, der Zahlung, der Parzelle, dem Zähler und der Aufgabe, um die es im Ereignis geht. Hat das Ereignis keinen dieser Datensätze, schlägt der Schritt fehl
- Die Aktion liefert `{createdComment.id}`

## Im Posteingang antworten [#antwoorden-in-de-inbox]

Sendet eine Antwort in einem Inbox-Gespräch, über denselben Kanal, über den der Gast geschrieben hat.

| Feld | Was du eingibst |
|---|---|
| **Gespräch** | Die ID des Gesprächs. Standardmäßig `{threadId}`. Pflichtfeld |
| **Antwort** | Der Text, ohne Formatierung. Variablen werden eingesetzt. Länger als 4096 Zeichen wird abgeschnitten. Pflichtfeld |
| **KI-Assistent aktiv lassen** | Standardmäßig aus |

Beachte Folgendes:

- `{threadId}` gibt es bei Ereignissen zu Inbox-Nachrichten, wie `inbox:message-created`
- Dieses Ereignis gilt für jede neue Nachricht, auch für deine eigene Antwort. Prüfe deshalb zuerst, ob die Nachricht vom Gast kam, sonst startet deine Antwort den Ablauf erneut. Setze vor diesen Schritt ein [Datensatz nachschlagen](/automatiseringen/logica#record-opzoeken) auf **Nachricht im Posteingang** mit `{messageId}` und ein **Wenn / sonst**, das prüft, ob `foundInboxMessage.direction` gleich `INBOUND` ist
- Standardmäßig stellt deine Antwort den [KI-Assistenten](/inbox/inbox-ai-assistant) in diesem Gespräch still, genau wie wenn ein Kollege selbst antwortet. Mit **KI-Assistent aktiv lassen** spricht der Assistent weiter. Ist das Gespräch dann archiviert, schlägt der Schritt fehl

## Gespräch taggen oder archivieren [#gesprek-taggen-of-archiveren]

Gibt einem Inbox-Gespräch Tags, archiviert es oder beides.

| Feld | Was du eingibst |
|---|---|
| **Gespräch** | Die ID des Gesprächs. Standardmäßig `{threadId}`. Pflichtfeld |
| **Tags hinzufügen** | Wähle einen oder mehrere Tags. Sie kommen dazu, vorhandene Tags bleiben bestehen |
| **Gespräch archivieren** | Standardmäßig aus |

## Kunde aktualisieren [#klant-bijwerken]

Ändert den Status eines Kunden oder fügt eine Notiz hinzu. Andere Daten des Kunden bleiben unverändert.

| Feld | Was du eingibst |
|---|---|
| **Kunde** | Die ID des Kunden, zum Beispiel `{invoice.customerId}`. Pflichtfeld |
| **Status** | **Unverändert lassen** (Standard), **Standard**, **Bevorzugt**, **VIP**, **Warnung** oder **Gesperrt** |
| **Zu Notizen hinzufügen** | Text, der in einer neuen Zeile unter den vorhandenen Notizen landet. Leer fügt nichts hinzu |

## Einchecken, auschecken oder stornieren [#inchecken-uitchecken-of-annuleren]

Setzt eine Reservierung in ihren nächsten Status.

| Feld | Was du eingibst |
|---|---|
| **Reservierung** | Die ID der Reservierung. Standardmäßig `{reservation.id}`. Pflichtfeld |
| **Aktion** | **Einchecken** (Standard), **Auschecken** oder **Stornieren** |

Die Reservierung muss dafür im richtigen Status sein. **Einchecken** und **Stornieren** funktionieren bei einer Reservierung mit dem Status **Gebucht**, **Auschecken** bei einer Reservierung mit dem Status **Eingecheckt**. Ist sie in einem anderen Status, passiert nichts und der Ablauf geht über **Übersprungen** weiter.


# Übersicht (/de-DE/automatiseringen/acties)

Aktionen sind die Schritte, die wirklich etwas tun. Du findest sie in der Schrittliste in den Gruppen **Aufgaben**, **Dokumente**, **Gäste und Nachrichten**, **Rechnungen und Zahlungen**, **Zugang und Geräte** und **Integrationen**. Die Schritte in der Gruppe **Logik** steuern den Ablauf selbst. Die stehen unter [Bedingungen, Verzweigungen und Verzögerungen](/automatiseringen/logica). Alle Aktionen werden vom [**Workflow**-Benutzer](/automatiseringen/workflow-gebruiker) deiner Organisation ausgeführt.

| Gruppe | Aktion | Was sie tut |
|---|---|---|
| Aufgaben | [Aufgabe erstellen](/automatiseringen/acties/taken#taak-aanmaken) | Legt eine Aufgabe an, eventuell mit Unteraufgaben, auf einem Board und verknüpft mit Kunde, Parzelle oder Rechnung |
| Aufgaben | [Aufgabenstatus setzen](/automatiseringen/acties/taken#taakstatus-zetten) | Ändert den Status einer bestehenden Aufgabe |
| Aufgaben | [Aufgabe suchen](/automatiseringen/acties/taken#taak-zoeken) | Sucht eine Aufgabe nach Titel und macht über **Gefunden** oder **Nicht gefunden** weiter |
| Aufgaben | [Aufgabenpriorität festlegen](/automatiseringen/acties/taken#taakprioriteit-zetten) | Erhöht, senkt oder wählt die Priorität einer bestehenden Aufgabe |
| Aufgaben | [Aufgabe aktualisieren](/automatiseringen/acties/taken#taak-bijwerken) | Benennt eine Aufgabe um, fügt Personen oder Labels hinzu oder verschiebt die Frist |
| Aufgaben | [Aufgabe löschen](/automatiseringen/acties/taken#taak-verwijderen) | Löscht eine Aufgabe, zum Beispiel die Aufgabe, die dieser Ablauf angelegt hat |
| Dokumente | [Dokument suchen](/automatiseringen/acties/documenten#document-zoeken) | Sucht das neueste Dokument eines Kunden und macht über **Gefunden** oder **Nicht gefunden** weiter |
| Dokumente | [Dokument aktualisieren](/automatiseringen/acties/documenten#document-bijwerken) | Ändert den Typ eines Dokuments oder archiviert bzw. stellt es wieder her |
| Gäste und Nachrichten | [Nachricht an Gast](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen) | Sendet einen eigenen Text per E-Mail, SMS oder WhatsApp an einen Kunden |
| Gäste und Nachrichten | [Kollegen benachrichtigen](/automatiseringen/acties/gasten-en-berichten#collegas-verwittigen) | Sendet Kollegen eine Push-Benachrichtigung oder E-Mail |
| Gäste und Nachrichten | [Kommentar hinzufügen](/automatiseringen/acties/gasten-en-berichten#opmerking-toevoegen) | Setzt einen Kommentar bei den Datensätzen des Ereignisses oder bei einer Aufgabe |
| Gäste und Nachrichten | [Im Posteingang antworten](/automatiseringen/acties/gasten-en-berichten#antwoorden-in-de-inbox) | Sendet eine Antwort in einem Inbox-Gespräch |
| Gäste und Nachrichten | [Gespräch taggen oder archivieren](/automatiseringen/acties/gasten-en-berichten#gesprek-taggen-of-archiveren) | Fügt einem Inbox-Gespräch Tags hinzu oder archiviert es |
| Gäste und Nachrichten | [Kunde aktualisieren](/automatiseringen/acties/gasten-en-berichten#klant-bijwerken) | Ändert den Status eines Kunden oder fügt eine Notiz hinzu |
| Gäste und Nachrichten | [Einchecken, auschecken oder stornieren](/automatiseringen/acties/gasten-en-berichten#inchecken-uitchecken-of-annuleren) | Setzt eine Reservierung in ihren nächsten Status |
| Rechnungen und Zahlungen | [Zahlungserinnerung senden](/automatiseringen/acties/facturen-en-betalingen#betalingsherinnering-versturen) | Sendet die Zahlungserinnerung einer Rechnung an den Kunden |
| Rechnungen und Zahlungen | [Banktransaktionen synchronisieren](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren) | Holt neue Banktransaktionen ab, bevor der Ablauf weitergeht |
| Rechnungen und Zahlungen | [Automatische Mahnungen für Kunden deaktivieren](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant) | Überspringt alle Rechnungen eines Kunden in automatischen Mahnungen |
| Rechnungen und Zahlungen | [Automatische Mahnungen für Rechnung deaktivieren](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-factuur) | Nimmt eine einzelne Rechnung aus den automatischen Erinnerungsabläufen |
| Rechnungen und Zahlungen | [Rechnung senden](/automatiseringen/acties/facturen-en-betalingen#factuur-versturen) | Sendet eine Rechnung an den Kunden |
| Rechnungen und Zahlungen | [Rechnung buchen](/automatiseringen/acties/facturen-en-betalingen#factuur-boeken) | Bucht eine Entwurfsrechnung |
| Rechnungen und Zahlungen | [Rechnung drucken](/automatiseringen/acties/facturen-en-betalingen#factuur-afdrukken) | Druckt eine Rechnung oder zeigt sie auf einem Tablet an |
| Rechnungen und Zahlungen | [Zahlungslink erstellen](/automatiseringen/acties/facturen-en-betalingen#betaallink-aanmaken) | Erstellt einen Online-Zahlungslink für das, was noch offen ist |
| Rechnungen und Zahlungen | [SEPA-Mandat anfordern](/automatiseringen/acties/facturen-en-betalingen#sepa-mandaat-aanvragen) | Bittet einen Kunden, ein Mandat zu unterschreiben, oder sendet eine Erinnerung |
| Rechnungen und Zahlungen | [Per Lastschrift einziehen](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring) | Zieht mit dem aktiven Mandat des Kunden ein, was offen ist |
| Rechnungen und Zahlungen | [Verbrauch abrechnen](/automatiseringen/acties/facturen-en-betalingen#verbruik-factureren) | Rechnet den offenen Zählerverbrauch eines Kunden ab |
| Rechnungen und Zahlungen | [Verlängerungsrechnung entwerfen](/automatiseringen/acties/facturen-en-betalingen#conceptfactuur-voor-verlenging) | Erstellt eine Entwurfsrechnung, die eine Belegung verlängert |
| Zugang und Geräte | [Zugangsmethode erstellen](/automatiseringen/acties/toegang-en-toestellen#toegangsmiddel-aanmaken) | Gibt einem Kunden Zugang per QR-Code, Kennzeichen, PIN-Code oder NFC |
| Zugang und Geräte | [Zugang aktualisieren](/automatiseringen/acties/toegang-en-toestellen#toegang-bijwerken) | Sperrt, entsperrt oder verlängert Zugangsmittel |
| Zugang und Geräte | [QR-Code senden oder drucken](/automatiseringen/acties/toegang-en-toestellen#qr-code-versturen-of-afdrukken) | Sendet einen QR-Zugangscode an den Kunden oder druckt ihn |
| Zugang und Geräte | [Schranke öffnen oder schließen](/automatiseringen/acties/toegang-en-toestellen#slagboom-openen-of-sluiten) | Öffnet oder schließt eine Schranke oder ein Tor |
| Zugang und Geräte | [Strom schalten](/automatiseringen/acties/toegang-en-toestellen#stroom-schakelen) | Schaltet den Strom eines Smart-Zählers an oder aus |
| Zugang und Geräte | [NFC-Tags aktualisieren](/automatiseringen/acties/toegang-en-toestellen#nfc-tags-bijwerken) | Sperrt, entsperrt oder lädt NFC-Tags eines Kunden auf |
| Zugang und Geräte | [Tablet oder Kiosk steuern](/automatiseringen/acties/toegang-en-toestellen#tablet-of-kiosk-bedienen) | Weckt ein Tablet oder einen Kiosk, versetzt ihn in den Ruhemodus oder lädt ihn neu |
| Zugang und Geräte | [Diashow setzen](/automatiseringen/acties/toegang-en-toestellen#diavoorstelling-instellen) | Setzt Fotos auf Tablets und Kioske, aus einer Liste oder einer früheren Anfrage |
| Integrationen | [Webhook senden](/automatiseringen/acties/integraties#webhook-versturen) | Liefert eine eigene Nachricht an einen deiner Webhook-Endpunkte |
| Integrationen | [API-Anfrage](/automatiseringen/acties/integraties#api-verzoek) | Ruft die Tillor API oder eine andere Website auf |

In allen Textfeldern kannst du [Variablen](/automatiseringen/variabelen) verwenden, wie `{invoice.displayId}`. Oben rechts an jedem Feld steht eine Schaltfläche **Variable**, um eine einzufügen. Felder, in denen ein Kunde, eine Rechnung oder ein anderer Datensatz verlangt wird, erwarten die interne ID dieses Datensatzes, wie `{invoice.id}`. Eine Rechnungsnummer oder ein Name funktioniert also nicht.

## Ausgänge einer Aktion [#uitgangen-van-een-actie]

Unter einem Schritt stehen ein oder mehrere Ausgänge. Du verbindest jeden Ausgang mit einem Folgeschritt. Lässt du einen Ausgang unverbunden, endet die Ausführung dort.

| Ausgang | Bei welchen Aktionen | Wann |
|---|---|---|
| **Weiter** | Die meisten Aktionen | Der Schritt ist gelungen |
| **Fertig** und **Übersprungen** | Aktionen, die manchmal nichts zu tun haben | **Fertig**, wenn der Schritt seine Arbeit getan hat. **Übersprungen**, wenn nichts zu tun war, zum Beispiel weil die Rechnung schon gebucht war. Das ist kein Fehler |
| **Gefunden** und **Nicht gefunden** | **Aufgabe suchen** | Ob die Aufgabe existiert |
| **Gefunden** und **Nicht gefunden** | **Dokument suchen** | Ob der Kunde so ein Dokument hat |
| **Erfolgreich** und **Fehlgeschlagen** | **Webhook senden** und **API-Anfrage** | Ob die Gegenseite die Nachricht angenommen hat |

**Fertig** und **Übersprungen** gibt es bei **Nachricht an Gast**, **Einchecken, auschecken oder stornieren**, **Rechnung buchen**, **Zahlungslink erstellen**, **SEPA-Mandat anfordern**, **Per Lastschrift einziehen** und **Verbrauch abrechnen**. Bei jeder dieser Aktionen steht unter der Aktion, wann ein Schritt übersprungen wird.

### Fortfahren, wenn dieser Schritt fehlschlägt [#doorgaan-als-deze-stap-mislukt]

Geht bei einer Aktion etwas schief, stoppt die Ausführung normalerweise mit dem Status **Fehlgeschlagen**. Willst du selbst bestimmen, was dann passiert, schalte unten in den Einstellungen des Schritts **Fortfahren, wenn dieser Schritt fehlschlägt** ein. Das geht bei jeder Aktion außer **Webhook senden** und **API-Anfrage**, die schon einen eigenen Ausgang **Fehlgeschlagen** haben.

Der Schritt erhält dann einen zusätzlichen Ausgang **Fehler**. Schlägt die Aktion fehl, geht der Ablauf über **Fehler** weiter, statt zu stoppen. Spätere Schritte können diese Variablen verwenden:

| Variable | Inhalt |
|---|---|
| `{error.message}` | Die Fehlermeldung. Sie kann auf Englisch sein |
| `{error.step}` | Der Name des Schritts, der fehlgeschlagen ist, so wie du ihn bei **Schrittname** eingegeben hast |

Ein paar Dinge, die du wissen solltest:

- Ist die Aktion gelungen oder übersprungen, ändert sich nichts und **Fehler** wird nicht verwendet
- Lässt du **Fehler** unverbunden, endet die Ausführung dort ohne weitere Schritte. Die Ausführung erhält dann den Status **Abgeschlossen**, aber der Schritt selbst steht auf dem Tab **Ausführungen** mit seiner Fehlermeldung
- Ein zweiter fehlgeschlagener Schritt im selben Ablauf ersetzt `{error.message}` und `{error.step}` des ersten

Ein Beispiel: Lass **Nachricht an Gast** weitermachen, wenn er fehlschlägt, und lege über **Fehler** eine Aufgabe an, mit `{error.message}` in der Beschreibung. So übernimmt ein Kollege das Gespräch mit dem Gast selbst.

## Wenn ein Schritt fehlschlägt [#als-een-stap-mislukt]

Ein Fehlschlag kann auf drei Arten verlaufen.

- **Ein Ausgang Fehlgeschlagen.** Das passiert bei **Webhook senden** und **API-Anfrage**, wenn die Gegenseite einen Fehler zurückgibt. Der Ablauf geht über den Ausgang **Fehlgeschlagen** weiter. Verbinde ihn mit einem Folgeschritt, wie einer Aufgabe für einen Kollegen. Lässt du den Ausgang unverbunden, endet die Ausführung dort einfach
- **Ein Ausgang Fehler.** Schaltest du bei einer anderen Aktion **Fortfahren, wenn dieser Schritt fehlschlägt** ein, erhält der Schritt einen Ausgang **Fehler** und du kannst mit `{error.message}` den Grund verwenden. Siehe [Fortfahren, wenn dieser Schritt fehlschlägt](#doorgaan-als-deze-stap-mislukt)
- **Der Schritt stoppt die Ausführung.** Fehlt nach dem Einsetzen der Variablen ein Wert, kann eine Rechnung nicht gesendet werden, existiert ein Endpunkt nicht mehr oder ist das JSON ungültig, erhält die Ausführung den Status **Fehlgeschlagen**. Die Schritte danach werden nicht ausgeführt und Tillor versucht den Schritt nicht erneut. Das passiert nur, wenn du **Fortfahren, wenn dieser Schritt fehlschlägt** nicht eingeschaltet hast

Die Fehlermeldung steht beim Schritt auf dem Tab **Ausführungen**. Diese Meldungen können auf Englisch sein.

<Callout type="idea" title="Fehlschläge nicht übersehen">
Willst du, dass ein Fehlschlag nie unbemerkt bleibt? Verbinde den Ausgang **Fehlgeschlagen** einer **API-Anfrage** oder von **Webhook senden**, oder den Ausgang **Fehler** einer anderen Aktion, mit einem Schritt [Aufgabe erstellen](/automatiseringen/acties/taken#taak-aanmaken). So kann ein Kollege es übernehmen.
</Callout>

## Gruppen [#groepen]

<Cards>
  <Card title="Aufgaben" href="/automatiseringen/acties/taken" description="Aufgaben anlegen, suchen und aktualisieren" />
  <Card title="Gäste und Nachrichten" href="/automatiseringen/acties/gasten-en-berichten" description="Nachrichten, Kommentare, Inbox und Reservierungen" />
  <Card title="Rechnungen und Zahlungen" href="/automatiseringen/acties/facturen-en-betalingen" description="Erinnerungen, Rechnungen und Zahlungen" />
  <Card title="Zugang und Geräte" href="/automatiseringen/acties/toegang-en-toestellen" description="Zugang, Strom, NFC und Tablets" />
  <Card title="Integrationen" href="/automatiseringen/acties/integraties" description="Webhooks und API-Anfragen" />
</Cards>


# Integrationen (/de-DE/automatiseringen/acties/integraties)

Diese Schritte stehen in der Gruppe **Integrationen**. Eine fehlgeschlagene Zustellung läuft über **Fehlgeschlagen** weiter. Bei anderen Aktionen liest du [Wenn ein Schritt fehlschlägt](/automatiseringen/acties#als-een-stap-mislukt).

## Webhook senden [#webhook-versturen]

Liefert eine eigene Nachricht an einen der Webhook-Endpunkte deiner Organisation. Das ist praktisch, um ein anderes System zu informieren, zum Beispiel dein Kassensystem oder deine Website.

| Feld | Was du einträgst |
|---|---|
| **Endpunkt** | Wähle einen deiner Webhook-Endpunkte. Du erkennst sie an ihrer Adresse. Pflichtfeld |
| **Ereignisname** | Der Name, der mit der Nachricht mitgeht, damit der Empfänger sie erkennen kann, zum Beispiel `automation.invoice_unpaid`. Pflichtfeld |
| **Payload** | Der Inhalt der Nachricht, als JSON. Variablen werden eingetragen, bevor die Nachricht gesendet wird. Pflichtfeld |

Endpunkte erstellst und verwaltest du über das Profilmenü unter **Entwickler**. Der Endpunkt muss existieren und eingeschaltet sein. Ist das nicht so, schlägt der Schritt fehl und die Ausführung stoppt.

Die Nachricht wird mit dem eigenen Schlüssel des Endpunkts signiert, genau wie die anderen Webhooks, die der Endpunkt empfängt. Tillor versucht es mehrmals erneut, wenn dein Server nicht richtig antwortet. Der Endpunkt muss dem Namen deines Ereignisses nicht folgen: Die Nachricht kommt in jedem Fall an.

Der Schritt hat zwei Ausgänge:

| Ausgang | Wann |
|---|---|
| **Erfolgreich** | Dein Server antwortete mit einem erfolgreichen Status |
| **Fehlgeschlagen** | Die Zustellung schlug nach allen Versuchen fehl. Die Nachricht wird danach im Hintergrund noch einmal versucht, genau wie ein normaler Webhook |

Die Vorlage **Reservierungen an ein anderes System senden** nutzt **Fehlgeschlagen**, um eine Aufgabe anzulegen, damit sich jemand darum kümmert.

Ein Payload sieht zum Beispiel so aus:

```json
{
  "reservation": "{reservation.displayId}",
  "checkIn": "{reservation.checkIn}",
  "adults": {reservation.numberOfAdults},
  "customer": {
    "firstName": "{reservation.customer.firstName}",
    "email": "{reservation.customer.email}"
  }
}
```

Setze Text in Anführungszeichen und Zahlen ohne. Daten werden in JSON als internationales Datum mit Uhrzeit übergeben, etwa `2026-10-05T08:00:00.000Z`. Lies [Variablen und Vorlagen](/automatiseringen/variabelen#hoe-waarden-worden-ingevuld) für die Details. Die technische Seite, etwa der Aufbau der Nachricht, steht unter [Entwickler > Automatisierungen](/ontwikkelaars/automatiseringen).

## API-Anfrage [#api-verzoek]

Ruft die Tillor-API deiner eigenen Organisation auf, oder eine andere Adresse im Internet. Damit kannst du fast alles tun, was Tillor kann, und Daten nachschlagen, um danach etwas damit zu tun.

Bei **Senden an** wählst du zwischen **Tillor API** und **Eigene URL**. Bei **Methode** wählst du **GET** (abrufen), **POST** (anlegen), **PUT** oder **PATCH** (ändern) oder **DELETE** (löschen).

### Tillor API [#tillor-api]

| Feld | Was du einträgst |
|---|---|
| **Pfad** | Der Teil der Adresse nach der API deiner Organisation, zum Beispiel `/tasks` oder `/tasks/{task.id}`. Er muss mit `/` beginnen. Pflichtfeld |
| **Body** | Die Daten, die du mitsendest, als JSON. Leer lassen, wenn du nichts mitsendest |

Oben im Feld steht **API-Endpunkt auswählen**. Klicke darauf und suche in der Liste, zum Beispiel nach *tasks*. Wenn du einen Endpunkt wählst, trägt Tillor die Methode und den Pfad ein. Ist der **Body** noch leer, bekommst du außerdem ein Beispiel dafür, was der Endpunkt erwartet. Ersetze die Namen in geschweiften Klammern im Pfad durch Variablen aus früheren Schritten. Stehen Query-Parameter dabei, siehst du das unter dem Feld.

Der Aufruf erfolgt als **Workflow**-Benutzer und kann nie außerhalb deiner eigenen Organisation landen. Eine Automatisierung kann keine Automatisierungen verwalten, daher werden Aufrufe, die Automatisierungen oder ihre Ausführungen betreffen, abgelehnt.

### Eigene URL [#eigen-url]

| Feld | Was du einträgst |
|---|---|
| **URL** | Die Adresse. Sie muss mit `https://` beginnen. Pflichtfeld |
| **Header** | Zusätzliche Angaben für den Empfänger, zum Beispiel ein Schlüssel. Klicke auf **Header hinzufügen** und fülle den **Name** und den **Wert** aus |
| **Body** | Die Daten, die du mitsendest, als JSON. Leer lassen, wenn du nichts mitsendest |

Dafür gelten diese Regeln:

- Adressen ohne `https://` werden abgelehnt
- Private und interne Adressen werden abgelehnt, auch wenn ein gewöhnlicher Name darauf verweist
- Weiterleitungen werden nicht verfolgt. Antwortet der Server mit einer Weiterleitung, zählt das als **Fehlgeschlagen**
- Header werden verschlüsselt gespeichert. Du kannst also einen Schlüssel oder Token hineinschreiben
- Bei **GET** und **DELETE** wird kein Body mitgesendet

### Ausgänge und Antwort [#uitgangen-en-antwoord]

Die Anfrage hat zwei Ausgänge: **Erfolgreich** (der Server antwortete mit einem erfolgreichen Status) und **Fehlgeschlagen** (der Server antwortete mit einem Fehlerstatus). Erreicht Tillor den Server gar nicht, zum Beispiel durch ein Timeout nach 15 Sekunden oder eine abgelehnte Adresse, stoppt die Ausführung mit dem Status **Fehlgeschlagen**.

Für spätere Schritte gibt es drei Variablen:

| Variable | Inhalt |
|---|---|
| `{response.status}` | Der Statuscode, zum Beispiel 200 |
| `{response.body}` | Die Antwort als Text, gekürzt auf die ersten 4000 Zeichen |
| `{response.data}` | Die Antwort als Daten, sodass du mit `{response.data.items.0.id}` Felder daraus holen kannst |

Wie du das nutzt, steht unter [Eine API-Antwort verwenden](/automatiseringen/variabelen#een-api-antwoord-gebruiken). Ein vollständiges Beispiel mit einer Suchanfrage steht unter [Mietwohnwagen nach Abreise prüfen](/automatiseringen/voorbeeld-nalopen).


# Aufgaben (/de-DE/automatiseringen/acties/taken)

Mit diesen Schritten lässt eine Automatisierung Aufgaben anlegen und aktualisieren, damit ein Kollege etwas übernimmt. Sie stehen in der Gruppe **Aufgaben**. Wie die Ausgänge funktionieren, liest du unter [Ausgänge einer Aktion](/automatiseringen/acties#uitgangen-van-een-actie).

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Aufgabe einer Automatisierung ist eine normale Aufgabe: Du findest sie auf der Aufgabenseite, in den Ansichten, in die sie passt, und beim Kunden oder Datensatz, an dem sie hängt.

```mermaid
flowchart LR
  A["Schritt Aufgabe erstellen"] --> T["Aufgabe auf der Aufgabenseite<br/>im Namen von Workflow"]
  T --> V["Ansichten zeigen sie an,<br/>wenn sie passt oder in der Liste steht"]
  T --> C["Ein Kollege übernimmt sie"]
  C -- "Status oder Zuweisung ändert sich" --> E["Eine andere Automatisierung kann darauf starten"]
  D["Schritt Um eine Entscheidung bitten"] --> T2["Aufgabe mit Auswahlschaltflächen"]
  T2 -- "Ein Kollege wählt eine Schaltfläche" --> F["Die Automatisierung geht über diese Option weiter"]
```

Mehr darüber, was Kollegen sehen und tun, steht unter [Aufgaben](/taken) und [Aufgaben mit Auswahlschaltflächen](/taken/taakdetails#taken-met-keuzeknoppen).

## Aufgabe erstellen [#taak-aanmaken]

Legt eine Aufgabe im Aufgabensystem an. Die Aufgabe steht im Namen von **Workflow**.

<DocScreenshot src="/screenshots/taken/automation-task-create-step.png" alt="Automatisierung mit dem ausgewählten Schritt Aufgabe erstellen und den Einstellungen rechts" />


| Feld | Was du einträgst |
|---|---|
| **Titel** | Der Name der Aufgabe. Pflichtfeld |
| **Beschreibung** | Eine Erläuterung zur Aufgabe |
| **Zuweisen an** | Wähle einen oder mehrere Kollegen. Klicke auf einen Namen, um ihn ein- oder auszuschalten |
| **Gruppen zuweisen** | Wähle eine oder mehrere [Gruppen](/gebruikers/groepen). Die Aufgabe gilt dann für alle, die zu diesem Zeitpunkt in der Gruppe sind |
| **Labels** | Wähle ein oder mehrere [Labels](/taken/labels) |
| **Auch der Person zuweisen, die das Ereignis ausgelöst hat** | Weist die Aufgabe auch dem Kollegen zu, der das Ereignis ausgelöst hat, zum Beispiel wer die Belegung beendet hat. Hat das System das Ereignis ausgelöst, wird niemand hinzugefügt |
| **Priorität** | **Niedrig**, **Mittel**, **Hoch** oder **Dringend**. Standard ist **Mittel** |
| **Zum Board hinzufügen** | Wähle ein Board, auf dem die Aufgabe erscheint, oder lass das Feld leer |
| **Spalte** | Wähle eine Spalte des Boards darüber. Die Liste zeigt die Spalten als *[Board] · [Spalte]* |
| **Unteraufgaben** | Eine Unteraufgabe pro Zeile, oder genau eine Variable mit einer Liste, etwa `{result}` aus [Code ausführen](/automatiseringen/logica#code-uitvoeren) |
| **Fällig nach** | Wie viele Minuten, Stunden, Tage oder Wochen nach Ausführung des Schritts die Frist liegt. Bei 0 bekommt die Aufgabe keine Frist. Standard ist 1 Tag |
| **Mit Datensätzen verknüpfen** | Verknüpft die Aufgabe mit den Datensätzen darunter und mit deren Kunde, Parzelle, Rechnung, Reservierung oder Zähler. Standardmäßig eingeschaltet |
| **Verknüpfen mit** | Erscheint, wenn **Mit Datensätzen verknüpfen** eingeschaltet ist. Wähle, bei welchen Datensätzen die Aufgabe erscheint. Vorab ist alles angehakt, was der Schritt kennt: die Datensätze des Auslösers und das, was ein früherer Suchschritt gefunden hat |
| **Nur der Ablauf kann sie abschließen** | Kollegen können die Aufgabe nicht abschließen oder löschen. Setze weiter hinten einen Schritt **Aufgabe löschen** oder **Aufgabenstatus setzen** ein, um sie abzuschließen |

Beachte Folgendes:

- Wählst du niemanden bei **Zuweisen an** oder **Gruppen zuweisen** und lässt **Auch der Person zuweisen, die das Ereignis ausgelöst hat** aus, hat die Aufgabe keinen zugewiesenen Kollegen. **Workflow** wird nie selbst zugewiesen
- Unteraufgaben haben denselben Titel, den du einträgst, keinen zugewiesenen Kollegen und keine Frist. Leere Zeilen werden übersprungen. Du darfst Variablen in den Zeilen verwenden
- Bei **Verknüpfen mit** geht es um Kunden, Parzellen, Rechnungen, Reservierungen und Zähler. Bei einer Belegung, die endet, wird die Aufgabe also standardmäßig mit der Parzelle, dem Kunden und der Reservierung verknüpft. Nimmst du einen Datensatz aus der Liste, bleibt die Aufgabe davon unberührt. Datensätze, die später zum Ablauf hinzukommen, fügt Tillor nicht von selbst hinzu, sobald du die Liste selbst angepasst hast. Wählst du wieder alles aus, folgt der Schritt erneut allen verfügbaren Datensätzen
- Steht eine Aufgabe nur auf einem persönlichen Board, sehen sie nur die Beteiligten. Siehe [Private Aufgaben](/taken/prive-taken)

Für spätere Schritte liefert die Aktion `{createdTask.id}` und `{createdTask.name}`. Damit kannst du danach zum Beispiel den Status setzen.

Willst du keine zweite Aufgabe, wenn es für dieselbe Parzelle oder denselben Kunden schon eine offene Aufgabe gibt, setze zuerst einen Schritt [Aufgabe suchen](#taak-zoeken) ein und lege die Aufgabe nur über **Nicht gefunden** an. Das [Beispiel Mietwohnwagen nach Abreise prüfen](/automatiseringen/voorbeeld-nalopen) macht das so.

Schaltest du **Nur der Ablauf kann sie abschließen** ein, steht auf der Aufgabe **Wird von der Automatisierung abgeschlossen**. Kollegen können sie nicht abschließen oder löschen.

## Aufgabe löschen [#taak-verwijderen]

Löscht eine Aufgabe, zum Beispiel die Aufgabe, die dieser Ablauf angelegt hat, sobald sie nicht mehr gebraucht wird.

| Feld | Was du einträgst |
|---|---|
| **Aufgabe** | Die Id der Aufgabe. Standard ist `{createdTask.id}`. Pflichtfeld |

Eine Aufgabe, die schon weg ist, wird übersprungen. Der Ablauf geht dann einfach weiter.

## Aufgabenstatus setzen [#taakstatus-zetten]

Ändert den Status einer bestehenden Aufgabe, zum Beispiel um sie abzuschließen.

| Feld | Was du einträgst |
|---|---|
| **Aufgabe** | Die Id der Aufgabe. Standard ist `{task.id}`. Pflichtfeld |
| **Status** | **Ausstehend**, **In Bearbeitung**, **Wartet auf Antwort** oder **Abgeschlossen**. Standard ist **Abgeschlossen** |

`{task.id}` funktioniert, wenn die Automatisierung auf einem Aufgabenereignis startet, etwa `task:created`. Nach einem Schritt **Aufgabe erstellen** nutzt du `{createdTask.id}`. Die Aktion liefert `{updatedTask.id}` und `{updatedTask.status}`.

## Aufgabe suchen [#taak-zoeken]

Sucht eine bestehende Aufgabe nach Titel. Der Schritt hat zwei Ausgänge: **Gefunden** und **Nicht gefunden**. So kannst du eine Aufgabe aktualisieren, wenn sie schon existiert, und sonst eine neue anlegen.

| Feld | Was du einträgst |
|---|---|
| **Titel** | Der Titel, den die Aufgabe genau haben muss, zum Beispiel `Nalopen {occupation.terrain.name}`. Variablen werden zuerst eingetragen. Pflichtfeld |
| **Mit den Datensätzen des Ereignisses verknüpft** | Nur Aufgaben, die mit mindestens einem derselben Datensätze verknüpft sind, etwa der Parzelle oder dem Kunden. Standardmäßig eingeschaltet |
| **Nur nicht abgeschlossene Aufgaben** | Überspringt abgeschlossene Aufgaben. Standardmäßig eingeschaltet |
| **Unteraufgaben überspringen** | Sucht nur Hauptaufgaben. Standardmäßig eingeschaltet |

Passen mehrere Aufgaben, nimmt der Schritt die neueste. Ist **Mit den Datensätzen des Ereignisses verknüpft** eingeschaltet, hat das Ereignis aber keinen Kunden, keine Parzelle, keine Rechnung, keine Reservierung und keinen Zähler, geht der Ablauf über **Nicht gefunden**.

Über **Gefunden** können spätere Schritte `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}` und `{foundTask.status}` verwenden.

## Aufgabenpriorität festlegen [#taakprioriteit-zetten]

Ändert die Priorität einer bestehenden Aufgabe.

| Feld | Was du einträgst |
|---|---|
| **Aufgabe** | Die Id der Aufgabe. Standard ist `{foundTask.id}`. Pflichtfeld |
| **Änderung** | **Eine Stufe höher** (Standard), **Eine Stufe niedriger** oder **Auf eine feste Priorität** |
| **Priorität** | Nur bei **Auf eine feste Priorität**: **Niedrig**, **Mittel**, **Hoch** oder **Dringend** |
| **Erhöhen bis** | Nur bei **Eine Stufe höher**: die höchste Priorität, die der Schritt vergeben darf. Standard ist **Hoch**. Eine Aufgabe, die schon so hoch oder höher steht, bleibt, wie sie ist |

Die Reihenfolge ist **Niedrig**, **Mittel**, **Hoch**, **Dringend**. Eine Stufe niedriger hört bei **Niedrig** auf. Ändert sich nichts, ist der Schritt trotzdem erfolgreich, ohne die Aufgabe zu ändern. Die Aktion liefert `{updatedTask.id}` und `{updatedTask.priority}`.

## Aufgabe aktualisieren [#taak-bijwerken]

Passt eine bestehende Aufgabe an. Felder, die du leer lässt, bleiben, wie sie sind.

| Feld | Was du einträgst |
|---|---|
| **Aufgabe** | Die Id der Aufgabe. Standard ist `{foundTask.id}`. Pflichtfeld |
| **Neuer Titel** | Der neue Name der Aufgabe. Leer lässt den Titel, wie er ist |
| **Zugewiesen** | Wähle einen oder mehrere Kollegen |
| **Gruppen** | Wähle eine oder mehrere [Gruppen](/gebruikers/groepen) |
| **Auch der Person zuweisen, die das Ereignis ausgelöst hat** | Fügt auch den Kollegen hinzu, der das Ereignis ausgelöst hat. Hat das System das Ereignis ausgelöst, wird niemand hinzugefügt |
| **Zuweisung** | **Zu den aktuellen hinzufügen** (Standard) oder **Die aktuellen ersetzen** |
| **Labels hinzufügen** | Wähle ein oder mehrere [Labels](/taken/labels). Sie kommen dazu, bestehende Labels bleiben |
| **Fällig nach** | Setzt die Frist auf diese Anzahl Minuten, Stunden, Tage oder Wochen nach Ausführung des Schritts. Bei 0 bleibt die Frist, wie sie ist |

Beachte Folgendes:

- Wählst du **Die aktuellen ersetzen** und gibst niemanden an, ist der Aufgabe danach niemand mehr zugewiesen
- Existiert die Aufgabe nicht mehr, schlägt der Schritt fehl
- Die Aktion liefert `{updatedTask.id}`


# Zugang und Geräte (/de-DE/automatiseringen/acties/toegang-en-toestellen)

Diese Aktionen betreffen den Park selbst: wer hereinkommt, welche Zähler Strom haben und was Tablets tun. Siehe [Zutrittskontrolle](/toegangscontrole) für den Hintergrund zu Zugangsmethoden. Wie die Ausgänge funktionieren, liest du unter [Ausgänge einer Aktion](/automatiseringen/acties#uitgangen-van-een-actie).

## Zugangsmethode erstellen [#toegangsmiddel-aanmaken]

Gibt einem Kunden Zugang per QR-Code, Kennzeichen, PIN-Code oder NFC.

| Feld | Was du einträgst |
|---|---|
| **Kunde** | Die Id des Kunden, zum Beispiel `{reservation.customerId}`. Pflichtfeld |
| **Typ** | **QR-Code** (Standard), **Kennzeichen**, **PIN-Code** oder **NFC** |
| **Wert** | Das Kennzeichen oder die NFC-Nummer. Leer lassen für einen QR-Code oder PIN-Code, denn Tillor erstellt diese selbst |
| **Gültig ab** | Eine Datumsvariable, zum Beispiel `{reservation.checkIn}`. Leer bedeutet keine Begrenzung |
| **Gültig bis** | Eine Datumsvariable, zum Beispiel `{reservation.checkOut}`. Leer bedeutet keine Begrenzung |

Bei **Kennzeichen** und **NFC** ist **Wert** Pflicht. Die Aktion liefert `{createdAccessMethod.id}` und `{createdAccessMethod.value}`. Der Wert ist der Code des QR-Codes oder der PIN-Code. Mit der Id kannst du den Code danach über **QR-Code senden oder drucken** versenden.

## Zugang aktualisieren [#toegang-bijwerken]

Sperrt, entsperrt oder verlängert eine Zugangsmethode oder alle Zugangsmethoden eines Kunden.

| Feld | Was du einträgst |
|---|---|
| **Welche** | **Eine Zugangsmethode** (Standard) oder **Alle eines Kunden** |
| **Zugangsmethode** | Nur bei **Eine Zugangsmethode**: die Id, zum Beispiel `{createdAccessMethod.id}`. Pflichtfeld |
| **Kunde** | Nur bei **Alle eines Kunden**: die Id des Kunden, zum Beispiel `{occupation.customerId}`. Pflichtfeld |
| **Status** | **Unverändert lassen** (Standard), **Aktiv**, **Weich blockiert**, **Blockiert** oder **Inaktiv** |
| **Gültig bis** | Eine Datumsvariable. Leer behält das aktuelle Enddatum |

Beachte Folgendes:

- Lässt du **Status** auf **Unverändert lassen** und **Gültig bis** leer, tut der Schritt nichts
- Bei **Alle eines Kunden** behalten Zugangsmethoden, die auf **Nicht automatisch verlängern** stehen, ihr Enddatum, so wie es auch geschieht, wenn ein Kunde eine Rechnung bezahlt. Ihr Status ändert sich aber. Bei **Eine Zugangsmethode** passt der Schritt das Enddatum an, auch wenn diese Zugangsmethode auf **Nicht automatisch verlängern** steht

## QR-Code senden oder drucken [#qr-code-versturen-of-afdrukken]

Sendet einen QR-Zugangscode an den Kunden, druckt ihn aus oder beides.

| Feld | Was du einträgst |
|---|---|
| **Zugangsmethode** | Die Id der Zugangsmethode. Standard ist `{createdAccessMethod.id}`. Pflichtfeld |
| **Per E-Mail senden** | Standardmäßig eingeschaltet |
| **Per SMS senden** | Standardmäßig ausgeschaltet |
| **Per WhatsApp senden** | Standardmäßig ausgeschaltet |
| **Drucken** | **Nicht drucken** (Standard), **Etikettendrucker** oder **Bondrucker** |

Schaltest du alle drei Kanäle aus und wählst **Nicht drucken**, tut der Schritt nichts.

## Schranke öffnen oder schließen [#slagboom-openen-of-sluiten]

Öffnet oder schließt eine Schranke oder ein Tor.

| Feld | Was du einträgst |
|---|---|
| **Zugangspunkt** | Wähle einen deiner Zugangspunkte. Pflichtfeld |
| **Aktion** | **Öffnen** (Standard) oder **Schließen** |

## Strom schalten [#stroom-schakelen]

Schaltet den Strom eines intelligenten Zählers ein oder aus. Zum Beispiel, um den Strom auszuschalten, wenn eine Belegung endet.

| Feld | Was du einträgst |
|---|---|
| **Welche Zähler** | **Alle schaltbaren Zähler einer Parzelle** (Standard) oder **Ein Zähler** |
| **Parzelle** | Nur bei **Alle schaltbaren Zähler einer Parzelle**: die Id der Parzelle. Standard ist `{occupation.terrainId}`. Pflichtfeld |
| **Zähler** | Nur bei **Ein Zähler**: wähle den Zähler. Pflichtfeld |
| **Strom** | **An** oder **Aus**. Standard ist **Aus** |

Beachte Folgendes:

- Bei **Alle schaltbaren Zähler einer Parzelle** schaltet der Schritt nur die Zähler, die schalten können. Hat die Parzelle keine, passiert nichts
- Gelingt das Schalten eines Zählers nicht, schlägt der Schritt fehl. Bei **Ein Zähler** passiert das auch, wenn der Zähler nicht schalten kann. Zähler, die vorher schon geschaltet waren, bleiben geschaltet

## NFC-Tags aktualisieren [#nfc-tags-bijwerken]

Aktualisiert alle [NFC-Tags](/nfc/nfc-tags) eines Kunden.

| Feld | Was du einträgst |
|---|---|
| **Kunde** | Die Id des Kunden, zum Beispiel `{occupation.customerId}`. Die Aktion gilt für jeden NFC-Tag dieses Kunden. Pflichtfeld |
| **Aktion** | **Sperren** (Standard), **Entsperren**, **Aufladen** oder **Hinweis zu niedrigem Guthaben senden** |
| **Betrag** | Nur bei **Aufladen**: der Betrag in Euro, pro Tag. Muss größer als 0 sein. Pflichtfeld |

Hat der Kunde zwei Tags und du trägst 20 ein, bekommt jeder Tag 20 Euro dazu. Ohne Tags tut der Schritt nichts. Bei einem Betrag, der keine Zahl über 0 ist, schlägt der Schritt fehl.

## Tablet oder Kiosk steuern [#tablet-of-kiosk-bedienen]

Sendet einen Befehl an ein [Tablet oder einen Kiosk](/mobiele-app/tablets-en-kiosken).

| Feld | Was du einträgst |
|---|---|
| **Gerät** | Wähle das Gerät. Pflichtfeld |
| **Befehl** | **Aufwecken** (Standard), **Schlafen legen**, **Neu laden**, **Identifizieren** oder **Testton abspielen** |

## Diashow setzen [#diavoorstelling-instellen]

Setzt die Diashow auf jedem Tablet und Kiosk oder auf einem einzelnen Gerät. Die übrigen Geräteeinstellungen bleiben bestehen. Ist dieselbe Diashow dort schon gesetzt, wird das Gerät übersprungen.

Ein stündlicher Auslöser, danach eine [API-Anfrage](/automatiseringen/acties/integraties#api-verzoek) an einen Veranstaltungsfeed und dann dieser Schritt: So ersetzt du eine separate Synchronisierung. Verbinde den Schritt mit dem Ausgang **Erfolgreich** der Anfrage.

| Feld | Was du einträgst |
|---|---|
| **Geräte** | **Jedes Tablet und jeder Kiosk** (Standard) oder **Ein Gerät** |
| **Gerät** | Nur bei **Ein Gerät**. Pflichtfeld |
| **Modus** | **Bildschirmschoner** (Standard, nach einer Zeit ohne Berührung) oder **Hintergrund** |
| **Sekunden pro Foto** | Wie lange ein Foto stehen bleibt. Standard ist 10. Von 3 bis 600 |
| **Warten bis zum Start** | Nur bei **Bildschirmschoner**: Sekunden ohne Berührung. Standard ist 15 |
| **Einpassen** | **Füllen** oder **Einpassen** |
| **Fotos** | **Aus einer früheren Anfrage** (Standard) oder **Adressen** |
| **Bildadressen** | Nur bei **Adressen**: eine https-Adresse pro Zeile. Pflichtfeld |
| **Liste** | Pfad der JSON-Liste, ohne geschweifte Klammern. Nach einer API-Anfrage ist das `response.data`. Pflichtfeld |
| **Feld mit dem Bild** | Name des Feldes mit der https-Adresse, zum Beispiel `signage_image`. Pflichtfeld |
| **Feld mit der Id** | Sorgt dafür, dass dasselbe Foto dieselbe Id behält, damit eine unveränderte Liste keine neue Nachricht an das Gerät sendet |
| **Feld mit dem Status** und **Status** | Nur Zeilen, bei denen dieses Feld diesen Wert hat, zum Beispiel `CONFIRMED` |
| **Überspringen wenn gesetzt** | Zeilen, bei denen dieses Feld einen Wert hat, fallen weg, zum Beispiel `deleted_at` |
| **Feld mit dem Datum** und **Feld mit dem Enddatum** | Eine Zeile bleibt, solange dieser Zeitpunkt noch nicht vorbei ist. Ist das Enddatum leer, zählt das Datum |
| **Sortierfeld** | Sortiert die Liste aufsteigend, zum Beispiel nach `date` |
| **Maximale Anzahl Fotos** | Standard ist 5, höchstens 20 |

Eine Adresse, die nicht mit `https://` beginnt, zählt nicht mit. Ist die Liste kein JSON-Array, schlägt der Schritt fehl und die aktuelle Diashow bleibt bestehen.


# Übersicht (/de-DE/automatiseringen)

Mit Automatisierungen lässt du Tillor etwas tun, ohne dass ein Kollege daran denken muss. Du legst eine Regel fest: *Wenn das passiert, dann tu das*. Ein paar Beispiele:

- Eine Belegung auf einem Mobilheim endet, also legt Tillor eine Kontrollaufgabe mit Unteraufgaben an und weist sie dem Kollegen zu, der die Belegung beendet hat
- Eine Rechnung ist überfällig, also sendet Tillor eine Zahlungserinnerung und legt eine Woche später eine Aufgabe an, den Kunden anzurufen, wenn die Rechnung noch offen ist
- Eine neue Reservierung geht ein, also sendet Tillor die Daten an dein eigenes System
- Jeden Montag um 08:00 legt Tillor eine Aufgabe für die wöchentliche Kontrolle an
- Eine neue Reservierung geht ein, also erstellt Tillor einen QR-Code für den Gast und sendet ihn per E-Mail

Eine Automatisierung baust du selbst auf einer Zeichenfläche, ohne Code. Du wählst einen Startzeitpunkt, fügst Schritte hinzu und verbindest sie mit Linien.

## In einfachen Worten [#in-gewone-woorden]

Eine Automatisierung hat drei Arten von Bausteinen. Die technischen Details musst du erst kennen, wenn du sie brauchst.

- **Der Startzeitpunkt (Auslöser)** ist das "Wenn". In Tillor passiert etwas, etwa eine Belegung, die endet, oder es ist eine bestimmte Uhrzeit oder ein bestimmtes Datum. Siehe [Auslöser](/automatiseringen/triggers)
- **Die Logik** ist das "Falls". Hier sieht sich der Ablauf die Daten an und wählt einen Weg, oder er wartet, bis etwas passiert. Ein Beispiel: *Ist die Rechnung nach einer Woche noch nicht bezahlt?* Siehe [Bedingungen, Verzweigungen und Verzögerungen](/automatiseringen/logica)
- **Die Aktionen** sind das "Dann tu". Eine Aufgabe anlegen, eine Nachricht senden, eine Rechnung buchen. Siehe [Aktionen](/automatiseringen/acties)

Außerdem sind **Variablen** die Daten des Moments selbst, etwa der Name der Parzelle oder des Kunden. Du setzt sie in einem Text in geschweifte Klammern, und Tillor trägt den echten Wert ein. Siehe [Variablen und Vorlagen](/automatiseringen/variabelen).

## Wer sie nutzen kann [#wie-kan-het-gebruiken]

<Callout type="warn" title="Nur für Administratoren">
Automatisierungen arbeiten mit vollen Rechten in deiner Organisation. Ansehen erfordert die Berechtigung **Automatisierungen ansehen**, Erstellen und Ändern **Automatisierungen verwalten**. Administratoren mit **Alle Berechtigungen** können beides. Siehe [Wer kann Automatisierungen nutzen?](/automatiseringen/veelgestelde-vragen#wie-kan-automatiseringen-gebruiken).
</Callout>

Du findest die Seite im Seitenmenü unter <UIPath>Administrator > Automatisierungen</UIPath>.

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Jede Automatisierung besteht aus Schritten, die du zu einem Ablauf verbindest. Eine Automatisierung arbeitet mit Aufgaben zusammen: Sie legt Aufgaben an, wartet auf einen Kollegen, der eine Schaltfläche wählt, oder startet, sobald sich eine Aufgabe ändert. Siehe [Aufgaben](/taken#hoe-hangt-dit-samen). Jedes Mal, wenn eine Automatisierung startet, nennen wir das eine Ausführung. Eine Ausführung beginnt beim Startzeitpunkt und folgt den Linien nach unten.

| Baustein | Was er tut |
|---|---|
| **Wenn das passiert** (Auslöser) | Der Startzeitpunkt. Ein Ereignis in Tillor, ein Webhook, eine gewählte Aufgabenaktion, eine überfällige Rechnung, ein Datum wie die Ankunft eines Gastes, eine feste Uhrzeit oder ein eigener Zeitplan. Ein Ablauf kann mehrere Auslöser haben. Jeder Auslöser startet eine eigene Ausführung |
| **Nur wenn** | Ein Filter auf dem Auslöser. Die Automatisierung startet nur, wenn die Daten stimmen, zum Beispiel nur für Mobilheime |
| **Wenn / sonst** | Teilt den Ablauf anhand einer oder mehrerer Bedingungen in **Ja** und **Nein** |
| **Verzweigung** | Teilt den Ablauf je nach Wert eines Feldes in mehrere Zweige |
| **Verzögerung** und andere Warteschritte | Lassen den Ablauf warten, auf eine Zeit, ein Datum, die Öffnungszeiten, eine Bedingung, ein Ereignis oder die Entscheidung eines Kollegen |
| **Jetzt geöffnet?**, **Datensatz nachschlagen**, **Für jedes** | Prüfen, ob du geöffnet hast, einen Datensatz abrufen oder die folgenden Schritte für jedes Element einer Liste ausführen |
| **Aktionen** | Tun wirklich etwas: Aufgaben, Nachrichten an Gäste und Kollegen, Rechnungen, Zahlungen und Mandate, Zugang, Zähler und Geräte, Webhooks und API-Anfragen |

Schritte mit mehreren Ausgängen, etwa **Ja** und **Nein**, **Fertig** und **Übersprungen** oder **Erfolgreich** und **Fehlgeschlagen**, lassen dich für jedes Ergebnis eine andere Fortsetzung wählen. Bei jeder Aktion kannst du außerdem einen Ausgang **Fehler** einschalten, damit der Ablauf weitergeht, wenn der Schritt fehlschlägt.

```mermaid
flowchart TD
  A["Wenn das passiert<br/>Rechnung ist überfällig"] --> B["Zahlungserinnerung senden"]
  B --> C["Verzögerung<br/>7 Tage"]
  C --> D{"Wenn / sonst<br/>noch nicht bezahlt?"}
  D -- Ja --> E["Aufgabe anlegen<br/>Kunden anrufen"]
  D -- Nein --> F["Ende"]
```

## Variablen [#variabelen]

Textfelder in einem Schritt akzeptieren Variablen in geschweiften Klammern, etwa `{occupation.terrain.name}`. Tillor trägt dort den Namen der Parzelle ein, die zum Ereignis gehört. So erstellst du Nachrichten und Aufgaben, die je nach Fall anders sind. Mehr dazu unter [Variablen und Vorlagen](/automatiseringen/variabelen).

## Schnellstart [#snel-aan-de-slag]

1. Gehe zu **Administrator > Automatisierungen** und klicke auf **Neue Automatisierung**
2. Wähle eine Vorlage oder **Von Grund auf starten**
3. Stelle den Auslöser und die Schritte ein und klicke auf **Speichern**
4. Probiere den Ablauf auf dem Tab **Testlauf** aus. Dabei wird nichts wirklich gesendet oder angelegt
5. Schalte **Aktiv** ein, wenn du zufrieden bist

Die neue Automatisierung ist pausiert, bis du sie selbst einschaltest. Eine Schritt-für-Schritt-Anleitung findest du unter [Erste Schritte](/automatiseringen/aan-de-slag).

<Callout type="info" title="Gut zu wissen">
- Eine neue Automatisierung ist pausiert, bis du sie selbst einschaltest
- Eine Automatisierung hat höchstens 100 Schritte. Anmerkungen und Rahmen auf der Zeichenfläche zählen gesondert, höchstens 50
- Eine **Verzweigung** hat höchstens 8 Zweige, und **Um eine Entscheidung bitten** höchstens 8 Optionen
- Zeitpläne und Daten werden jede Minute geprüft. Ein Ereignis startet sofort
- Änderungen können eine halbe Minute dauern, bis sie überall gelten
- Eine fehlgeschlagene Ausführung wird per E-Mail an die Person gesendet, die die Automatisierung erstellt hat, höchstens einmal pro Stunde
- Auf dem Tab **Ausführungen** stehen die letzten 20 Ausführungen
- Ein Ablauf kann sich selbst oder einen anderen Ablauf nicht über das starten, was er selbst anlegt
</Callout>

<Callout type="info" title="Automatisierungen tun wirklich etwas">
Eine eingeschaltete Automatisierung sendet echte Erinnerungen und legt echte Aufgaben an. Nutze den Tab **Testlauf** und sieh dir die ersten Ausführungen auf dem Tab **Ausführungen** an, bevor du sicher bist, dass alles stimmt.
</Callout>

## Bestandteile [#onderdelen]

<Cards>
  <Card
    title="Erste Schritte"
    href="/automatiseringen/aan-de-slag"
    description="Die Übersicht, die Vorlagen und der Editor, und wie du eine Automatisierung speicherst und aktivierst"
  />
  <Card
    title="Auslöser"
    href="/automatiseringen/triggers"
    description="Ereignisse, Daten, überfällige Rechnungen und Zeitpläne, dazu Filter und einmaliges Starten"
  />
  <Card
    title="Bedingungen, Verzweigungen und Verzögerungen"
    href="/automatiseringen/logica"
    description="Den Ablauf verzweigen und warten lassen, Datensätze nachschlagen, Listen durchlaufen und um eine Entscheidung bitten"
  />
  <Card
    title="Aktionen"
    href="/automatiseringen/acties"
    description="Alles, was eine Automatisierung tun kann, mit allen Feldern"
  />
  <Card
    title="Variablen und Vorlagen"
    href="/automatiseringen/variabelen"
    description="Daten des Ereignisses in deinen Texten verwenden"
  />
  <Card
    title="Wer führt eine Automatisierung aus?"
    href="/automatiseringen/workflow-gebruiker"
    description="Warum Aufgaben und Kommentare einer Automatisierung im Namen eines festen Systembenutzers stehen"
  />
  <Card
    title="Testen und Ausführungen"
    href="/automatiseringen/testen-en-uitvoeringen"
    description="Einen Testlauf durchführen und echte Ausführungen nachsehen"
  />
  <Card
    title="Probleme und Aktivieren"
    href="/automatiseringen/problemen"
    description="Warum sich eine Automatisierung nicht einschalten lässt und was die Meldungen bedeuten"
  />
  <Card
    title="Beispiel: Mietwohnwagen nach Abreise prüfen"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Einen kompletten Ablauf Schritt für Schritt aufbauen"
  />
  <Card
    title="Häufige Fragen"
    href="/automatiseringen/veelgestelde-vragen"
    description="Grenzen, Erklärungen zum Pausieren und was zu tun ist, wenn nichts passiert"
  />
  <Card
    title="Für Entwickler"
    href="/ontwikkelaars/automatiseringen"
    description="Die API-Anfrage, der Webhook-Umschlag, die Signatur und die Verwaltung über die API"
  />
</Cards>

<Cards>
  <Card title="Praxisbeispiele" href="/praktijk" description="Ausgearbeitete Beispiele aus der Praxis" />
</Cards>

## Begriffe [#begrippen]

- **Automatisierung**: eine Regel nach dem Muster "Wenn das passiert, dann tu das", aufgebaut als Ablauf
- **Ablauf**: die Zeichenfläche einer einzelnen Automatisierung, mit Schritten und Linien
- **Auslöser**: der Startzeitpunkt eines Ablaufs
- **Ausführung**: ein einzelner Start einer Automatisierung, bei dem der Ablauf durchlaufen wird
- **Aktion**: ein Schritt, der wirklich etwas tut, etwa eine Aufgabe anlegen
- **Variable**: eine Angabe des Moments, in geschweiften Klammern in einem Text
- **Testlauf**: ein Probelauf, bei dem nichts wirklich gesendet oder angelegt wird
- **Workflow**: der Benutzer, in dessen Namen eine Automatisierung arbeitet

Weitere Begriffe stehen im [Glossar](/begrippen).


# Bedingungen, Verzweigungen und Verzögerungen (/de-DE/automatiseringen/logica)

Mit den Schritten in der Gruppe **Logik** bestimmst du, in welche Richtung ein Flow läuft und wann: das "wenn" und das "warte kurz". Ein Beispiel: *Wenn die Rechnung nach einer Woche noch offen ist, erstelle eine Aufgabe*. Sie steuern die Aktionen danach. Nur [Um eine Entscheidung bitten](#vraag-om-een-beslissing) erstellt selbst etwas, nämlich eine Aufgabe.

| Schritt | Was er tut | Ausgänge |
|---|---|---|
| [Wenn / sonst](#als--anders) | Verzweigt anhand von Bedingungen | **Ja**, **Nein** |
| [Verzweigung](#schakel) | Wählt einen Zweig anhand des Werts eines Felds | Einer pro Zweig und **Standard** |
| [Verzögerung](#vertraging) | Wartet eine feste Zeit oder bis zu einem Datum | **Weiter** |
| [Jetzt geöffnet?](#nu-open) | Prüft, ob du gerade geöffnet hast | **Geöffnet**, **Geschlossen** |
| [Bis zur Öffnung warten](#wachten-tot-open) | Wartet bis zur nächsten Öffnungszeit | **Weiter** |
| [Bis zur Schließung warten](#wachten-tot-gesloten) | Wartet bis zur nächsten Schließzeit | **Weiter** |
| [Höchstens einmal pro Zeitraum](#hoogstens-één-keer-per-periode) | Hält Wiederholungen auf | **Fortfahren**, **Bereits ausgeführt** |
| [Datensatz nachschlagen](#record-opzoeken) | Holt einen Datensatz über seine ID | **Gefunden**, **Nicht gefunden** |
| [Für jedes](#voor-elk) | Führt die Schritte danach pro Element einer Liste aus | **Für jedes**, **Fertig** |
| [Warten bis](#wachten-tot) | Wartet, bis Bedingungen zutreffen | **Erfüllt**, **Zeit abgelaufen** |
| [Auf ein Ereignis warten](#wachten-op-een-gebeurtenis) | Wartet, bis in Tillor etwas passiert | **Empfangen**, **Zeit abgelaufen**, manchmal **Gelöscht** |
| [Um eine Entscheidung bitten](#vraag-om-een-beslissing) | Lässt eine Kollegin oder einen Kollegen zwischen deinen Optionen wählen | Einer pro Option und **Zeit abgelaufen** |

## Wenn / sonst [#als--anders]

Teilt den Flow anhand der Daten in zwei Wege. Es ist dasselbe Prinzip wie der Filter bei **Nur wenn** des Auslösers, nur mitten im Flow.

Der Schritt hat zwei Ausgänge: **Ja** (die Bedingungen treffen zu) und **Nein** (sie treffen nicht zu).

1. Füge einen Schritt **Wenn / sonst** hinzu
2. Klicke bei **Bedingungen** auf **Bedingung hinzufügen**
3. Wähle das Feld mit der Schaltfläche **Variable**, oder tippe den Pfad selbst ein, zum Beispiel `invoice.paymentStatus`
4. Wähle den Vergleich (**ist**, **ist nicht**, **enthält**, **ist größer als**, **ist kleiner als**, **ist eines von**, **ist leer** oder **ist nicht leer**) und gib den Wert ein
5. Verbinde den Ausgang **Ja** und gegebenenfalls **Nein** mit einem Folgeschritt

Ein Schritt **Wenn / sonst** braucht mindestens eine Bedingung. Sonst meldet Tillor **Füge eine Bedingung hinzu.** Bei mehreren Bedingungen wählst du zwischen **Alle müssen zutreffen** und **Mindestens eine muss zutreffen**. Die Vergleiche funktionieren wie bei [Nur wenn](/automatiseringen/triggers#alleen-wanneer) beschrieben.

Du musst nicht beide Ausgänge verbinden. Führt ein Ausgang nirgendwohin, endet die Ausführung dort. Ein Flow, der nur bei **Ja** etwas tut, ist also völlig in Ordnung.

Du kannst auch Felder früherer Schritte verwenden. Nach einer [API-Anfrage](/automatiseringen/acties/integraties#api-verzoek) kannst du zum Beispiel `response.status` oder `response.data.paymentStatus` prüfen.

## Verzweigung [#schakel]

Wähle **Verzweigung**, wenn du mehr als zwei Wege brauchst. Der Schritt schaut auf den Wert eines Felds und wählt den passenden Zweig.

1. Wähle bei **Feld** das Feld, auf das du schauen willst, zum Beispiel `occupation.occupationType`
2. Klicke bei **Zweige** auf **Zweig hinzufügen**. Gib den **Zweig** (den Namen, der am Ausgang steht) und **Gleich** (den Wert, den das Feld haben muss) ein
3. Wiederhole das für jeden Zweig
4. Verbinde jeden Ausgang mit einem Folgeschritt

Jeder Zweig bekommt unter dem Schritt einen eigenen Ausgang. Dazu gibt es immer einen Ausgang **Standard**. Er wird genommen, wenn kein Zweig passt.

- Das Feld muss genau mit dem Wert übereinstimmen, auch in der Groß- und Kleinschreibung
- Passt mehr als ein Zweig, gewinnt der erste in der Liste
- Ein Zweig ohne Wert bei **Gleich** zählt nicht mit
- Du kannst höchstens 8 Zweige einstellen, plus **Standard**
- Ist das Feld leer oder existiert es nicht, läuft der Flow über **Standard**

Werte von Auswahlfeldern stehen in der Schreibweise von Tillor. Eine Belegung vom Typ Mietwohnwagen hat zum Beispiel den Wert `RENTAL_CARAVAN`, eine bezahlte Rechnung `PAID`.

<Callout type="info">
Die Liste bei **Feld** zeigt die Felder des Ereignisses und früherer Schritte. Felder aus der Antwort einer API-Anfrage erscheinen erst in der Liste, wenn Tillor ein Beispiel dieser Antwort kennt. Siehe [Eine API-Antwort verwenden](/automatiseringen/variabelen#een-api-antwoord-gebruiken).
</Callout>

## Verzögerung [#vertraging]

Mit **Verzögerung** lässt du den Flow warten, bevor er weiterläuft. Das nutzt du für Dinge wie *eine Woche später noch einmal nachsehen*.

Bei **Warten** wählst du eine von zwei Arten.

### Eine feste Zeit [#een-vaste-tijd]

Wähle **Für eine feste Zeit** und gib bei **Dauer** eine Anzahl und eine Einheit ein: **Sekunden**, **Minuten**, **Stunden**, **Tage** oder **Wochen**. Sekunden sind nicht exakt. Der Flow kann ein paar Sekunden später weiterlaufen.

Eine Verzögerung von 0 bewirkt nichts, deshalb meldet Tillor **Eine Verzögerung von 0 bewirkt nichts.**

### Bis zu einem Datum [#tot-een-datum]

Wähle **Bis zu einem Datum**, wenn die Wartezeit von einem Datum aus den Daten abhängt, etwa dem Fälligkeitsdatum einer Rechnung oder dem Enddatum einer Reservierung.

| Feld | Was du eingibst |
|---|---|
| **Datum** | Ein Feld mit einem Datum, zum Beispiel `invoice.dueDate`. Die Liste zeigt nur Felder, die ein Datum sind |
| **Relativ zu diesem Datum** | **Davor** oder **Danach** |
| **Versatz** | Wie viel Zeit vor oder nach diesem Datum, in Minuten, Stunden, Tagen oder Wochen. Bei 0 läuft der Flow genau an diesem Datum weiter |

Beispiele:

- **Datum** `invoice.dueDate`, **Danach**, **Versatz** 1 Tag: Der Flow läuft einen Tag nach dem Fälligkeitsdatum weiter
- **Datum** `reservation.checkIn`, **Davor**, **Versatz** 2 Tage: Der Flow läuft zwei Tage vor der Anreise weiter

Liegt dieser Zeitpunkt schon in der Vergangenheit oder ist das Datum leer, läuft der Flow sofort weiter.

### Was während des Wartens passiert [#wat-er-tijdens-het-wachten-gebeurt]

- Die Ausführung bekommt den Status **Wartet**. Auf dem Tab **Ausführungen** steht, wann sie weiterläuft (**Geht weiter …**). Lange Wartezeiten, etwa Wochen, sind kein Problem
- Nach der Verzögerung liest Tillor die Daten erneut, damit die Schritte danach den aktuellen Stand sehen. Siehe unten
- Pausierst du die Automatisierung während des Wartens, stoppt die Ausführung, sobald die Wartezeit vorbei ist. Sie läuft nicht weiter und bekommt den Status **Abgebrochen**. Schaltest du die Automatisierung ein, bevor die Wartezeit vorbei ist, läuft die Ausführung ganz normal weiter
- Löschst du die Automatisierung, stoppen die wartenden Ausführungen
- Änderst du den Flow, während eine Ausführung wartet, arbeitet diese Ausführung mit dem Flow, wie er war, als sie startete

### Daten werden erneut gelesen [#gegevens-worden-opnieuw-gelezen]

Eine Ausführung merkt sich die Daten des Moments des Ereignisses, liest die dazugehörigen Datensätze aber erneut, bevor sie weiterläuft. Das sind der Datensatz des Ereignisses (zum Beispiel die Rechnung) und die Datensätze, auf die er verweist (zum Beispiel der Kunde).

Ein Beispiel: Eine Automatisierung schickt eine Erinnerung für eine Rechnung, wartet 7 Tage und prüft dann mit **Wenn / sonst**, ob `invoice.paymentStatus` nicht `PAID` ist. Wurde die Rechnung in dieser Woche bezahlt, sieht die Bedingung die bezahlte Rechnung und der Flow läuft über **Nein**.

Es gibt zwei Ausnahmen:

- Existiert der Datensatz nicht mehr, weil zum Beispiel eine Belegung gelöscht wurde, behält die Ausführung die Kopie vom Moment des Ereignisses
- Daten, die ein früherer Schritt geliefert hat, etwa die Antwort einer API-Anfrage, werden nicht erneut abgerufen. Willst du solche Daten nach einer Verzögerung aktualisieren, mache eine neue API-Anfrage

<Callout type="info" title="In einem Test wird nichts erneut gelesen">
Ein [Testlauf](/automatiseringen/testen-en-uitvoeringen) überspringt Verzögerungen und arbeitet mit den Beispieldaten, die du selbst eingibst. Was nach einer echten Verzögerung passiert, siehst du erst in einer echten Ausführung.
</Callout>

## Jetzt geöffnet? [#nu-open]

Prüft, ob deine Organisation gerade geöffnet ist, und teilt den Flow in **Geöffnet** und **Geschlossen**. Es gibt nichts einzustellen. Tillor nutzt die Zeiten unter **Einstellungen > Öffnungszeiten**, mit Saisonzeiträumen, Feiertagen und Ausnahmen. Siehe [Organisationseinstellungen](/gebruikers/organisaties#openingsuren).

Nutze es zum Beispiel, um außerhalb der Öffnungszeiten einen anderen Text zu senden oder eine Aufgabe zu erstellen. Willst du lieber warten, bis du wieder geöffnet hast, nutze [Bis zur Öffnung warten](#wachten-tot-open). Willst du warten, bis du schließt, nutze [Bis zur Schließung warten](#wachten-tot-gesloten).

## Bis zur Öffnung warten [#wachten-tot-open]

Lässt den Flow bis zur nächsten Öffnungszeit pausieren und läuft danach weiter. Ist deine Organisation schon geöffnet? Dann läuft der Flow sofort weiter. Es gibt nichts einzustellen.

- Die Öffnungszeit kommt aus **Einstellungen > Öffnungszeiten**, in der Zeitzone deiner Organisation
- Gibt es im kommenden Monat keine einzige Öffnungszeit, läuft der Flow sofort weiter, statt weiter zu warten
- Während des Wartens bekommt die Ausführung den Status **Wartet**. Was dabei passiert, steht unter [Verzögerung](#wat-er-tijdens-het-wachten-gebeurt)

## Bis zur Schließung warten [#wachten-tot-gesloten]

Lässt den Flow bis zur nächsten Schließzeit pausieren und läuft danach weiter. Ist deine Organisation schon geschlossen? Dann läuft der Flow sofort weiter. Es gibt nichts einzustellen.

- Die Schließzeit kommt aus **Einstellungen > Öffnungszeiten**, in der Zeitzone deiner Organisation
- Aneinander anschließende Blöcke, etwa 9:00–12:00 und 12:00–17:00, zählen als ein Stück. Der Flow wartet bis zum Ende dieses Stücks
- Während des Wartens bekommt die Ausführung den Status **Wartet**. Was dabei passiert, steht unter [Verzögerung](#wat-er-tijdens-het-wachten-gebeurt)

## Höchstens einmal pro Zeitraum [#hoogstens-één-keer-per-periode]

Lässt den Flow nur durch, wenn er diesen Schritt für denselben Datensatz innerhalb des Zeitraums noch nicht passiert hat. So schickst du einem Kunden nicht jeden Tag dieselbe Erinnerung.

| Feld | Was du eingibst |
|---|---|
| **Zeitraum** | Wie lange frühere Ausführungen mitzählen, in Minuten, Stunden, Tagen oder Wochen. Standard 1 Tag |
| **Pro** | Worauf du zählst. Leer bedeutet pro Datensatz, der den Flow gestartet hat, etwa die Rechnung oder die Reservierung. Gib eine Variable ein, zum Beispiel `{customer.id}`, um pro Kunde oder pro Parzelle zu zählen |

Der Schritt hat zwei Ausgänge: **Fortfahren**, wenn der Flow im Zeitraum noch nicht hier durchkam, und **Bereits ausgeführt**, wenn doch. Verbinde **Bereits ausgeführt** mit einem anderen Schritt oder lass ihn leer, damit die Ausführung dort endet.

Beachte Folgendes:

- Nur Ausführungen derselben Automatisierung zählen mit, und nur, wenn sie über **Fortfahren** durch diesen Schritt kamen
- Verbindest du **Gelöscht** mit nichts, stoppt Tillor die wartenden Flows dieses Datensatzes und löscht die Aufgaben, die der Flow erstellt hat und die nur der Flow abschließen konnte. Verbindest du den Ausgang, läuft der Flow dort weiter
- Startet der Flow ohne Datensatz, etwa bei **Jeden Tag zu einer Uhrzeit**, gib bei **Pro** selbst eine Variable ein. Ohne diesen Wert ist jede Ausführung neu und der Schritt hält nichts auf
- Die Ausführung, die gerade läuft, zählt selbst nicht mit

Ein Beispiel: **Zeitraum** 7 Tage und **Pro** `{invoice.customerId}` lässt pro Kunde höchstens einmal pro Woche eine Erinnerung durch, auch wenn dieser Kunde mehrere überfällige Rechnungen hat.

## Datensatz nachschlagen [#record-opzoeken]

Lädt einen Datensatz anhand seiner ID, damit die Schritte danach seine Felder nutzen können. Das ist praktisch, wenn das Ereignis nur eine ID mitgibt, etwa die Nachricht in einem Posteingangsgespräch.

| Feld | Was du eingibst |
|---|---|
| **Datensatztyp** | **Kunde**, **Reservierung**, **Belegung**, **Rechnung**, **Zahlung**, **Parzelle**, **Aufgabe**, **Dokument**, **Zugangsmethode**, **NFC-Tag**, **Zähler**, **Gespräch im Posteingang** oder **Nachricht im Posteingang**. Standard **Nachricht im Posteingang** |
| **ID** | Die ID des Datensatzes, zum Beispiel `{messageId}`. Pflichtfeld |

Der Schritt hat zwei Ausgänge: **Gefunden** und **Nicht gefunden**. Existiert der Datensatz nicht oder ist die ID leer, läuft der Flow über **Nicht gefunden**.

Nach **Gefunden** stehen die Felder des Datensatzes in Variablen, die mit `found` und dann dem Typ beginnen: `{foundCustomer.firstName}`, `{foundInvoice.displayId}`, `{foundReservation.checkIn}`, `{foundTerrain.name}`, `{foundInboxMessage.direction}`. Die anderen Typen heißen `foundOccupation`, `foundPayment`, `foundTask`, `foundAccessMethod`, `foundNfcTag`, `foundMeter` und `foundInboxThread`. Auch die Datensätze, auf die er verweist, sind dabei, eine Ebene tief, etwa `{foundReservation.customer.firstName}`. Alles steht in der Liste hinter der Schaltfläche **Variable**.

Eine zweite Suche desselben Typs ersetzt die erste. Achtung bei **Aufgabe**: Das nutzt denselben Namen `foundTask` wie [Aufgabe suchen](/automatiseringen/acties/taken#taak-zoeken), und die letzte von beiden gewinnt. Dasselbe gilt für **Dokument** und `foundDocument` von [Dokument suchen](/automatiseringen/acties/documenten#document-zoeken).

## Variablen zuordnen [#variabelen-mappen]

Kopiert Werte in neue Variablennamen, damit spätere Schritte eine einzige Form nutzen können. Praktisch, wenn ein Flow über **Eingehender Webhook** (`{body.…}`) und über **Rechnung überfällig** (`{invoice.…}`) startet.

| Feld | Was du eingibst |
|---|---|
| **Zuordnungen** | Zeilen mit **Zielvariable** (z. B. `invoice`) und **Quelle** (z. B. `{foundInvoice}` oder `{body.invoiceId}`) |

Der Schritt hat einen Ausgang: **Weiter**. Ist die Quelle genau eine Variable in geschweiften Klammern, zum Beispiel `{foundInvoice}`, kopiert Tillor den ganzen Datensatz (das Objekt). Sonst füllt Tillor die Quelle als Text ein, etwa `Rechnung {foundInvoice.displayId}` in `meta.label`.

Ein typischer Webhook-Test: **Eingehender Webhook** → **Datensatz nachschlagen** (Rechnung, ID `{body.invoiceId}`) → **Variablen zuordnen** (`invoice` ← `{foundInvoice}`) → dieselben Bedingungen und Genehmigung wie beim Zeitplan-Auslöser.

## Code ausführen [#code-uitvoeren]

Führt ein Stück TypeScript auf den Variablen des Flows aus und speichert das Ergebnis als neue Variable. Für Logik, die du nicht in Feldern und Bedingungen unterbringst: welche Unteraufgaben entstehen sollen, einen Betrag oder ein Datum berechnen, einen Webhook-Body umformen.

| Feld | Was du eingibst |
|---|---|
| **Code** | TypeScript. Variablen schreibst du wie in Texten, mit geschweiften Klammern: `{customer.firstName}` wird als Wert gelesen, nicht als Text eingesetzt. Schließe mit `return` ab. Pflichtfeld |
| **Ausgabevariable** | Der Name, unter dem spätere Schritte das Ergebnis lesen, etwa `result` (dann `{result}`) oder `result.names`. Standard `result` |

Der Schritt hat einen Ausgang: **Weiter**. So funktioniert es:

- Der Code sieht nur die Variablen, die er nennt. Eine Variable, die der Flow nicht hat, ist `null`; ein Datum kommt als Text (`2026-07-01T10:00:00.000Z`)
- Formatierungen und Datumsverschiebungen (`{bedrag|currency}`, `{datum + 1 day}`) funktionieren hier nicht: Berechne sie im Code
- Gib eine Liste, einen Text, eine Zahl oder ein Objekt zurück. Ein Objekt liest du danach pro Feld: `{result.total}`
- Der Code kann nichts abrufen oder senden: kein Internet, keine Datenbank. Er rechnet nur. Zu langes Rechnen (mehr als 50 ms) wird abgebrochen
- Wirft der Code einen Fehler, stoppt die Ausführung mit diesem Fehler und der Zeilennummer. Du siehst sie auf dem Tab **Ausführungen**
- Rechts neben dem Code siehst du sofort, was er im Beispiel zurückgibt; beim Testen läuft er mit

Ein Beispiel: Nach der Abreise willst du Unteraufgaben, die von der Parzelle abhängen. Setze einen Schritt **Code ausführen** mit:

```ts
const tasks = ["Plaats vegen", "Sanitair"];
if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren");
return tasks;
```

Fülle danach bei **Aufgabe erstellen** das Feld **Unteraufgaben** nur mit `{result}`: Jeder Text in der Liste wird zu einer Unteraufgabe.

## Für jedes [#voor-elk]

Führt die Schritte nach **Für jedes** einmal für jedes Element einer Liste aus, zum Beispiel für jede offene Rechnung eines Kunden. Der Flow selbst läuft über **Fertig** weiter.

| Feld | Was du eingibst |
|---|---|
| **Liste** | **Zugangsmethoden eines Kunden**, **NFC-Tags eines Kunden**, **Offene Rechnungen eines Kunden**, **Gebuchte Reservierungen eines Kunden**, **Belegungen eines Kunden**, **Dokumente eines Kunden** (nur aktive) oder **Zähler einer Parzelle**. Standard **Zugangsmethoden eines Kunden** |
| **Von** | Der Kunde oder die Parzelle, deren Liste du willst, zum Beispiel `{customer.id}` oder `{occupation.terrainId}`. Pflichtfeld |

Der Schritt hat zwei Ausgänge mit eigener Bedeutung:

- **Für jedes** führt zu den Schritten, die du pro Element ausführen willst
- **Fertig** ist der Weg, auf dem der Flow selbst weiterläuft

So funktioniert es:

- Jedes Element bekommt eine eigene Ausführung, die die Schritte nach **Für jedes** bis zum Ende dieses Zweigs durchläuft. Du siehst sie auf dem Tab **Ausführungen**, der nur die letzten 20 zeigt
- Das Element steht in der Variable `item`, zum Beispiel `{item.id}`. Variablen des Ereignisses und früherer Schritte bleiben verfügbar
- Der Flow wartet nicht, bis die Elemente fertig sind. Direkt nachdem sie gestartet wurden, läuft er über **Fertig** weiter. Ein Ergebnis eines Elements kannst du also in den Schritten nach **Fertig** nicht verwenden
- Es werden höchstens 100 Elemente verarbeitet, die ältesten zuerst. Stehen mehr in der Liste, werden die übrigen nicht verarbeitet
- Ist die Liste leer oder das Feld **Von** leer, startet nichts und der Flow läuft sofort über **Fertig** weiter
- **Offene Rechnungen eines Kunden** sind gebuchte Rechnungen, bei denen noch etwas offen ist. **Gebuchte Reservierungen eines Kunden** sind Reservierungen mit dem Status **Gebucht**

Ein Beispiel: Eine Rechnung wird überfällig und du willst für jede offene Rechnung dieses Kunden einen Zahlungslink erstellen. Wähle **Offene Rechnungen eines Kunden**, gib bei **Von** `{invoice.customerId}` ein und setze hinter **Für jedes** einen Schritt **Zahlungslink erstellen** mit `{item.id}` als Rechnung.

## Warten bis [#wachten-tot]

Prüft Bedingungen immer wieder, bis sie zutreffen, oder hört nach einer Zeit auf. Nutze es, wenn du nicht weißt, wann etwas passiert, aber worauf du wartest, zum Beispiel bis eine Rechnung bezahlt ist.

| Feld | Was du eingibst |
|---|---|
| **Bis** | Eine oder mehrere Bedingungen, auf dieselbe Weise wie bei [Wenn / sonst](#als--anders) |
| **Prüfen alle** | Wie oft Tillor erneut nachsieht, in Minuten, Stunden, Tagen oder Wochen. Mindestens 5 Minuten. Standard 1 Stunde |
| **Warten beenden nach** | Wie lange der Schritt höchstens wartet. Standard 7 Tage |

Der Schritt hat zwei Ausgänge: **Erfüllt** (die Bedingungen treffen zu) und **Zeit abgelaufen** (die Wartezeit ist vorbei, ohne dass sie zutrafen).

Beachte Folgendes:

- Die erste Prüfung geschieht sofort. Treffen die Bedingungen schon zu, läuft der Flow direkt über **Erfüllt** weiter. Hast du keine Bedingung eingegeben, trifft es immer zu
- Bei jeder Prüfung liest Tillor die Datensätze des Ereignisses erneut, wie bei einer [Verzögerung](#gegevens-worden-opnieuw-gelezen). Eine Bedingung wie `invoice.paymentStatus` ist `PAID` sieht die Zahlung also, sobald sie da ist
- Ein Intervall unter 5 Minuten wird zu 5 Minuten
- Während des Wartens bekommt die Ausführung den Status **Wartet**. Fürs Pausieren und Ändern des Flows gilt dasselbe wie bei [Verzögerung](#wat-er-tijdens-het-wachten-gebeurt)

## Auf ein Ereignis warten [#wachten-op-een-gebeurtenis]

Lässt den Flow pausieren, bis in Tillor etwas passiert, zum Beispiel dass die Rechnung bezahlt wurde.

| Feld | Was du eingibst |
|---|---|
| **Ereignis** | Worauf du wartest. Dieselbe Liste wie beim [Auslöser](/automatiseringen/triggers#als-er-iets-gebeurt). Pflichtfeld |
| **Nur für denselben Datensatz** | Läuft nur weiter, wenn das Ereignis den Datensatz betrifft, der den Flow gestartet hat. Standardmäßig an |
| **Warten beenden nach** | Wie lange der Schritt höchstens wartet. Standard 7 Tage |

Der Schritt hat zwei Ausgänge: **Empfangen** (das Ereignis kam) und **Zeit abgelaufen** (die Wartezeit ist vorbei, ohne Ereignis). Ist **Nur für denselben Datensatz** an, kommt ein dritter Ausgang hinzu, **Gelöscht**. Den nutzt du, wenn der Datensatz des Flows gelöscht wurde, während der Flow wartete.

Beachte Folgendes:

- Bei eingeschaltetem **Nur für denselben Datensatz** zählt zum Beispiel nur die Zahlung der Rechnung, mit der der Flow startete. Schaltest du es aus, lässt jedes Ereignis dieses Typs den Flow weiterlaufen
- Verbindest du **Gelöscht** mit nichts, stoppt Tillor die wartenden Flows dieses Datensatzes und löscht die Aufgaben, die der Flow erstellt hat und die nur der Flow abschließen konnte. Verbindest du den Ausgang, läuft der Flow dort weiter
- Startet der Flow ohne Datensatz, etwa bei **Jeden Tag zu einer Uhrzeit**, zählt jedes Ereignis dieses Typs
- Ein Ereignis, das ein Schritt einer Automatisierung selbst auslöst, zählt ebenfalls. Wartende Flows laufen also auch aufgrund von Arbeit von **Workflow** weiter
- Nach **Empfangen** stehen die Daten des Ereignisses, auf das du gewartet hast, in den Variablen, ohne die Kollegin oder den Kollegen, die oder der es ausgelöst hat. Wartest du auf `invoice:paid`, liefert `{invoice.paymentStatus}` danach den neuen Stand
- Während des Wartens bekommt die Ausführung den Status **Wartet**. Fürs Pausieren und Ändern des Flows gilt dasselbe wie bei [Verzögerung](#wat-er-tijdens-het-wachten-gebeurt)

## Um eine Entscheidung bitten [#vraag-om-een-beslissing]

Erstellt eine Aufgabe mit Schaltflächen, die du selbst festlegst, und wartet, bis jemand eine Schaltfläche wählt. So baust du einen Moment ein, in dem ein Mensch mitschaut, zum Beispiel bevor der Flow einen Kunden sperrt oder eine Rechnung bucht. Jede Option ist eine Schaltfläche auf der Aufgabe und ein Ausgang des Schritts.

| Feld | Was du eingibst |
|---|---|
| **Aufgabentitel** | Der Titel der Aufgabe. Pflichtfeld |
| **Beschreibung** | Sag deiner Kollegin oder deinem Kollegen, was entschieden werden muss |
| **Optionen** | Die Schaltflächen auf der Aufgabe. Siehe unten. Mindestens eine |
| **Zuweisen an** | Wähle eine oder mehrere Kolleginnen oder Kollegen |
| **Gruppen zuweisen** | Wähle eine oder mehrere Gruppen |
| **Verknüpfen mit** | Die Datensätze, bei denen die Aufgabe erscheint, etwa der Kunde oder die Rechnung. Vorausgefüllt mit den Datensätzen, die bei diesem Schritt bekannt sind |
| **Warten beenden nach** | Wie lange der Schritt höchstens wartet. Standard 3 Tage |

### Optionen einstellen [#opties-instellen]

1. Klicke bei **Optionen** auf **Option hinzufügen** und gib den Namen ein, zum Beispiel **Genehmigen**. Dieser Name steht auf der Schaltfläche und am Ausgang
2. Klicke auf das farbige Feld links vom Namen (**Symbol und Farbe**), um eine Farbe und ein Symbol zu wählen. Ein Symbol ist nicht Pflicht
3. Schalte **Notiz verlangen** ein, wenn die Kollegin oder der Kollege bei dieser Wahl einen Grund angeben soll
4. Schalte **Bestätigung verlangen** ein, wenn zuerst bestätigt werden soll. Du gibst dann einen **Bestätigungstitel** und einen **Bestätigungstext** ein und wählst bei **Schweregrad** zwischen **Info**, **Warnung** oder **Destruktiv**. In diesen Texten kannst du Variablen verwenden
5. Wiederhole das für jede Option. Du kannst höchstens 8 Optionen anlegen

Ist die Liste noch leer, legt die Schaltfläche **Genehmigen / Ablehnen** sofort zwei Optionen an: ein grünes **Genehmigen** und ein rotes **Ablehnen**. Jede Option braucht einen Namen, sonst meldet Tillor **Jede Option braucht einen Namen.** Ohne Optionen meldet Tillor **Füge mindestens eine Option hinzu.**

### Ausgänge [#uitgangen]

Der Schritt hat einen Ausgang pro Option, mit dem Namen und der Farbe dieser Option, plus immer **Zeit abgelaufen**.

| Ausgang | Wann |
|---|---|
| Der Name einer Option | Jemand hat diese Schaltfläche auf der Aufgabe gewählt |
| **Zeit abgelaufen** | Die Wartezeit ist vorbei, ohne dass gewählt wurde, oder die Aufgabe wurde gelöscht |

Beachte Folgendes:

- Die Schaltflächen stehen auf der Aufgabenkarte, in der Aufgabenliste und in der Aufgabe selbst. Eine solche Aufgabe hat kein Häkchen: Du kannst sie nicht einfach abschließen, nur eine Schaltfläche wählen. Nach der Wahl steht die Aufgabe auf **Abgeschlossen** und es steht dabei, welche Option gewählt wurde. Siehe [Aufgaben mit Auswahlschaltflächen](/taken/taakdetails#taken-met-keuzeknoppen)
- Wählen kann, wer der Aufgabe zugewiesen ist, auch über eine Gruppe, sowie Administratoren. Weist du niemanden zu, kann jeder wählen, der die Aufgabe sieht
- Die Aufgabe bekommt die Priorität **Hoch**. Sie läuft auf den Namen **Workflow**
- Wird die Aufgabe gelöscht, bevor jemand gewählt hat, läuft der Flow über **Zeit abgelaufen** weiter. Nach **Zeit abgelaufen** wegen der Wartezeit bleibt die Aufgabe bestehen
- Spätere Schritte können `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}` und `{approval.decidedBy.name}` verwenden. `{approval.label}` ist der Name der gewählten Option und `{approval.note}` die Notiz, die die Kollegin oder der Kollege eingegeben hat
- Während des Wartens bekommt die Ausführung den Status **Wartet**. Fürs Pausieren und Ändern des Flows gilt dasselbe wie bei [Verzögerung](#wat-er-tijdens-het-wachten-gebeurt)

<Callout type="info" title="In einem Test wählst du den Ausgang selbst">
Ein [Testlauf](/automatiseringen/testen-en-uitvoeringen) kann nicht wissen, ob du geöffnet hast, was eine Kollegin oder ein Kollege entscheidet und ob ein Datensatz existiert. Unter **Was passiert bei diesen Schritten?** wählst du deshalb selbst den Ausgang von **Jetzt geöffnet?**, **Höchstens einmal pro Zeitraum**, **Datensatz nachschlagen**, **Für jedes**, **Warten bis**, **Auf ein Ereignis warten** und **Um eine Entscheidung bitten**. Bei **Für jedes** läuft der Test durch den Ausgang, den du wählst, **Für jedes** oder **Fertig**, nicht durch beide.
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein Ausgang, den du nicht verbindest, lässt die Ausführung dort enden.
- Bei einem Warteschritt bekommt die Ausführung den Status <Status tone="info">Wartet</Status> und läuft später weiter. Eine pausierte Automatisierung stoppt wartende Ausführungen, sobald die Wartezeit vorbei ist.
- Nach einer Wartezeit liest Tillor die Daten erneut, damit die Schritte den aktuellen Stand sehen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet Füge eine Bedingung hinzu">
Ein Schritt **Wenn / sonst** braucht mindestens eine Bedingung. Klicke auf **Bedingung hinzufügen**.
</Accordion>
<Accordion title="Tillor meldet Eine Verzögerung von 0 bewirkt nichts">
Gib bei **Dauer** eine Anzahl größer als 0 ein.
</Accordion>
<Accordion title="Der Flow läuft immer über Standard">
Eine **Verzweigung** vergleicht den Wert genau, auch in der Groß- und Kleinschreibung. Auswahlwerte stehen in der Schreibweise von Tillor, etwa `RENTAL_CARAVAN`. Ist das Feld leer, läuft der Flow ebenfalls über **Standard**.
</Accordion>
<Accordion title="Tillor meldet Füge mindestens eine Option hinzu oder Jede Option braucht einen Namen">
Ein Schritt **Um eine Entscheidung bitten** braucht mindestens eine Option mit einem Namen. Klicke bei **Optionen** auf **Option hinzufügen**.
</Accordion>
<Accordion title="Die Ausführung bleibt auf Wartet stehen">
Der Flow wartet auf eine Zeit, eine Bedingung, ein Ereignis oder eine Entscheidung. Auf dem Tab **Ausführungen** steht, wann er weiterläuft oder abläuft. Bei **Warten bis** ist das standardmäßig nach 7 Tagen, bei **Um eine Entscheidung bitten** nach 3 Tagen.
</Accordion>
<Accordion title="Die Aufgabe von Um eine Entscheidung bitten ist verschwunden">
Wird die Aufgabe gelöscht, bevor jemand gewählt hat, läuft der Flow über **Zeit abgelaufen** weiter. Siehe [Aufgaben mit Auswahlschaltflächen](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
</Accordions>


# Probleme und Aktivieren (/de-DE/automatiseringen/problemen)

Tillor prüft deinen Flow fortlaufend, während du ihn baust. Solange es offene Probleme gibt, kannst du die Automatisierung nicht aktivieren. So wird verhindert, dass ein Flow, der nicht funktionieren kann, echte Erinnerungen oder Aufgaben zu senden versucht.

## Wo du die Probleme siehst [#waar-zie-je-de-problemen]

- Auf jedem Schritt mit einem Problem steht eine kleine Warnzahl
- Im Panel rechts stehen die Probleme des ausgewählten Schritts in einem orangefarbenen Block über den Einstellungen
- Oben im Panel steht eine Schaltfläche mit der Gesamtzahl, zum Beispiel **3 Probleme**. Klicke darauf für die Liste und klicke auf eine Meldung, um zum Schritt zu springen
- In der Übersicht der Automatisierungen steht bei dem Namen ein Label wie **3 Probleme**, und es gibt einen Filter **Probleme**

<DocScreenshot src="/screenshots/automatiseringen/issues.png" alt="Schaltfläche 1 Problem oben im Panel mit der Meldung Titel ist erforderlich" />

## Warum kann ich nicht aktivieren [#waarom-kan-ik-niet-inschakelen]

Der Schalter **Aktiv** funktioniert nicht, solange es Probleme gibt, mit dem Text **Behebe zuerst die offenen Probleme**. In der Übersicht kannst du den Schalter der Automatisierung dann ebenfalls nicht einschalten.

Ist die Automatisierung schon eingeschaltet, kannst du Änderungen mit Problemen nicht speichern. Ein Flow, der läuft, muss gültig bleiben. Behebe die Probleme oder pausiere die Automatisierung zuerst.

## Was die Meldungen bedeuten [#wat-de-meldingen-betekenen]

| Meldung | Was los ist | Was du tust |
|---|---|---|
| **Füge zum Start einen Auslöser hinzu.** | Der Flow hat keinen Auslöser | Ein Flow braucht immer mindestens einen Auslöser. Ziehe **Wenn das passiert** aus der Liste links auf die Fläche |
| **Dieses Ereignis gibt es nicht mehr. Wähle ein anderes.** | Das Ereignis des Auslösers gibt es nicht mehr | Wähle bei **Ereignis** ein anderes |
| **Nicht verbunden, daher wird dieser Schritt nie ausgeführt.** | Zu dem Schritt führt keine Linie | Verbinde den Schritt mit einem Ausgang eines anderen Schritts oder lösche ihn |
| **Dieser Schritt gehört zu einer Schleife. Ein Flow kann nur vorwärts gehen.** | Eine Linie führt zu einem früheren Schritt zurück | Lösche die Linie, die zurückzeigt. Ein Flow kann nicht im Kreis laufen |
| **[Feld] ist erforderlich.** | Ein Pflichtfeld ist leer, etwa der **Titel** einer Aufgabe | Fülle das Feld aus. Pflichtfelder haben ein Sternchen |
| **[Feld]: [Variable] ist in diesem Schritt nicht verfügbar.** | Du verwendest eine Variable, die in diesem Schritt nicht existiert | Wähle eine Variable aus der Liste hinter der Schaltfläche **Variable**. Prüfe auch, ob der Schritt, der die Variable liefert, im Flow weiter vorne steht |
| **[Feld] ist kein gültiges JSON.** | Der **Payload** oder **Body** stimmt als JSON nicht | Prüfe geschweifte Klammern, Kommas und Anführungszeichen. Variablen sind erlaubt |
| **Füge mindestens eine Option hinzu.** | Ein Schritt **Um eine Entscheidung bitten** hat keine Optionen | Klicke bei **Optionen** auf **Option hinzufügen** |
| **Jede Option braucht einen Namen.** | Eine Option von **Um eine Entscheidung bitten** hat keinen Namen | Gib den Namen ein oder lösche die Option |
| **Füge eine Bedingung hinzu.** | Ein Schritt **Wenn / sonst** hat keine Bedingungen | Klicke auf **Bedingung hinzufügen** |
| **Eine Bedingung hat kein gültiges Feld.** | Das Feld einer Bedingung ist leer oder unbekannt | Wähle oder tippe ein Feld, das in der Liste hinter **Variable** steht |
| **Gib einen Wert für [Variable] ein.** | Eine Bedingung hat einen Vergleich, aber noch keinen Wert | Gib den Wert ein oder wähle einen Vergleich wie **ist leer**, der keinen braucht |
| **[Feld]: [Variable] ist kein bekanntes Format.** | Du verwendest hinter dem `\|` ein Format, das es nicht gibt | Verwende `currency`, `number`, `date`, `datetime`, `time`, `upper` oder `lower`. Siehe [Einen Wert formatieren](/automatiseringen/variabelen#een-waarde-opmaken) |
| **[Feld]: [Variable] ist keine Einheit.** | Du schreibst eine Datumsverschiebung mit einer Einheit, die es nicht gibt | Verwende `minutes`, `hours`, `days`, `weeks` oder `months` |
| **[Feld]: eigenes Feld [Variable] existiert nicht.** | Du verwendest ein eigenes Feld, das nicht (mehr) existiert | Wähle ein vorhandenes Feld aus der Liste hinter **Variable** |
| **[Feld]: [Variable] hat ein Format oder eine Datumsverschiebung, das funktioniert nur in Texten.** | Du verwendest ein Format im Codefeld von **Code ausführen** | Berechne es im Code |
| **[Feld]: [Variable] ist kein Variablenname.** | Der Name eines Ergebnisses enthält unzulässige Zeichen | Verwende Buchstaben, Ziffern und Punkte, etwa `result` oder `result.names` |
| **Eine Verzögerung von 0 bewirkt nichts.** | Die Verzögerung steht auf 0 | Gib eine Dauer größer als 0 ein |
| **Der Pfad muss mit / beginnen und innerhalb der API deiner Organisation bleiben.** | Der **Pfad** einer API-Anfrage ist nicht erlaubt | Lass den Pfad mit einem einzigen `/` beginnen und setze kein `..` oder `\` hinein |
| **Die URL muss mit https:// beginnen.** | Die **URL** einer API-Anfrage ist nicht sicher | Verwende eine Adresse, die mit `https://` beginnt |
| **Der Cron-Ausdruck ist ungültig. Verwenden Sie fünf Felder, zum Beispiel 0 8 * * 1.** | Der Cron-Ausdruck stimmt nicht | Siehe [Nach einem Cron-Ausdruck](/automatiseringen/triggers#volgens-een-cron-expressie) |

## Was Tillor nicht vorab prüfen kann [#wat-tillor-niet-vooraf-kan-controleren]

Manche Fehler zeigen sich erst, wenn der Flow wirklich läuft.

- Eine URL, die aus Variablen besteht, lässt sich erst prüfen, wenn sie ausgefüllt ist
- Bei Ereignissen, deren Daten nicht beschrieben sind, prüft Tillor die Variablen nicht
- Ob ein Datensatz existiert, ob eine Rechnung gesendet werden kann oder ob ein anderer Server erreichbar ist, zeigt sich erst während einer Ausführung

Ein Flow ohne Meldungen ist also nicht unbedingt ein Flow, der immer gelingt. Teste ihn mit [Testen und Ausführungen](/automatiseringen/testen-en-uitvoeringen) und sieh dir die ersten echten Ausführungen an.

<Callout type="info" title="Ein Ereignis, das verschwindet">
Ändert sich ein Ereignis oder ein Feld, auf das dein Flow baut, siehst du das als Meldung beim betreffenden Schritt. Passe den Schritt an, bevor du die Automatisierung wieder aktivierst.
</Callout>


# Testen und Ausführungen (/de-DE/automatiseringen/testen-en-uitvoeringen)

Im Editor arbeitest du mit zwei Tabs, um zu prüfen, ob ein Flow tut, was du willst: **Testlauf** für einen Versuch und **Ausführungen** für das, was wirklich passiert ist. Du öffnest sie rechts im Panel. Der vierte Tab, **Verlauf**, zeigt frühere Versionen des Flows, siehe [Frühere Versionen](/automatiseringen/aan-de-slag#eerdere-versies).

## Ein Testlauf [#een-testuitvoering]

Wähle den Tab **Testlauf**. Ein Test durchläuft den Flow mit Beispieldaten und zeigt, welche Schritte er nehmen würde.

<Callout type="info" title="Es passiert nichts Echtes">
Ein Testlauf sendet nichts, erstellt nichts und ändert nichts. Verzögerungen werden übersprungen, damit du sofort das Endergebnis siehst. Aktionen zeigen nur, was sie tun würden, mit dem Text **Im Test nicht ausgeführt.**
</Callout>

<DocScreenshot src="/screenshots/automatiseringen/test-run.png" alt="Tab Testlauf mit Beispieldaten und dem Ergebnis pro Schritt" />

### Beispieldaten [#voorbeeldgegevens]

Oben steht **Mit einem echten Datensatz testen**. Wähle bei jedem Datensatz des Auslösers, etwa **Belegung**, über **Datensatz wählen** einen Datensatz (suche nach Name oder Nummer). Tillor lädt den Datensatz, wie er jetzt ist, mit den Datensätzen, auf die er verweist, in die Beispieldaten. Der Test sendet, erstellt und ändert weiterhin nichts.

Unter **Beispieldaten des Ereignisses** stehen die Daten, mit denen der Test arbeitet, in JSON-Form. Wurde die Automatisierung schon einmal wirklich gestartet, beginnt der Test mit den Daten der letzten echten Ausführung. Sonst füllt Tillor ein Beispiel ein, das die Form des Ereignisses hat: Ein Text wird *example*, eine Zahl 1 und ein Datum der aktuelle Moment.

Passe die Werte an, um andere Fälle auszuprobieren, zum Beispiel einen anderen Parzellentyp oder eine Rechnung mit einem anderen Status. Ist der Text kein gültiges JSON, steht dort **Die Beispieldaten sind kein gültiges JSON.** und du kannst den Test nicht starten.

Enthält der Flow eine **API-Anfrage**, gibt es auch ein Feld **Beispiel-API-Antwort**. Füge dort die Antwort ein, die du von der Anfrage erwartest. Damit kann der Test die Schritte nach der Anfrage durchlaufen, und Tillor zeigt die Felder der Antwort als Variablen an. Siehe [Eine API-Antwort verwenden](/automatiseringen/variabelen#een-api-antwoord-gebruiken).

### Was passiert bei diesen Schritten [#wat-gebeurt-er-bij-deze-stappen]

Bei manchen Schritten hängt das Ergebnis von der Außenwelt ab: **Webhook senden**, **API-Anfrage**, Aktionen mit einem Ausgang **Übersprungen** oder **Fehler**, und Logik wie **Jetzt geöffnet?**, **Datensatz nachschlagen**, **Auf ein Ereignis warten** und **Um eine Entscheidung bitten**. Unter **Was passiert bei diesen Schritten?** wählst du pro Schritt, über welchen Ausgang der Test weiterläuft. So testest du auch den Weg für den Fall, dass etwas schiefgeht.

### Das Ergebnis [#het-resultaat]

Klicke auf **Test ausführen**. Du siehst die Schritte der Reihe nach, mit pro Schritt:

- den eingesetzten Werten, zum Beispiel dem Titel einer Aufgabe, wie sie erstellt würde
- bei einer Bedingung pro Zeile, was verglichen wurde und ob es zutraf. Grün ist erfüllt, rot nicht, mit dem Wert, der tatsächlich dort stand (*war …*)
- über welchen Ausgang der Flow weiterlief (**Weiter über: Ja**)
- bei einer Verzögerung, bis wann gewartet würde

Nach dem Ausführen heißt die Schaltfläche **Erneut ausführen**. Der Test spielt die Schritte einzeln ab (**Schritt 2 von 5…**). Mit **Alle anzeigen** überspringst du das Abspielen. Auf der Fläche färbt sich der Weg, den der Test nahm, und die Schritte, die nicht an der Reihe waren, werden abgedunkelt. Klicke im Ergebnis auf einen Schrittnamen, um zu diesem Schritt zu springen. Unten steht **Nach 5 Schritten beendet.**

Passt der Filter bei **Nur wenn** nicht zu deinen Beispieldaten, siehst du **Der Filter des Auslösers passt nicht zu diesen Daten, daher würde der Flow nicht starten.** Prüfe dann, welche Bedingung rot ist. Mit **Leeren** entfernst du das Ergebnis wieder von der Fläche.

### Was ein Test nicht zeigt [#wat-een-test-niet-laat-zien]

- Ob eine Rechnung wirklich gesendet werden kann, ob ein Endpunkt erreichbar ist oder ob ein API-Pfad existiert
- Wie Datensätze nach einer Verzögerung aussehen. Der Test arbeitet mit deinen Beispieldaten und liest nichts erneut
- Fehler, die erst bei echten Daten auftreten, etwa ein leeres Feld

Sieh dir deshalb die ersten echten Ausführungen immer kurz auf dem Tab **Ausführungen** an.

## Echte Ausführungen [#echte-uitvoeringen]

Auf dem Tab **Ausführungen** stehen die letzten 20 echten Ausführungen dieser Automatisierung, die neueste oben. Die Liste aktualisiert sich etwa alle 15 Sekunden von selbst. Solange noch nichts gestartet wurde, steht dort **Noch keine Ausführungen. Aktiviere die Automatisierung und warte auf ihr Ereignis.**

Jede Ausführung zeigt die Startzeit, die Anzahl der Schritte oder (beim Warten), wann sie weiterläuft, und einen Status.

| Status | Was es bedeutet |
|---|---|
| **Läuft** | Die Ausführung läuft gerade |
| **Wartet** | Die Ausführung steht in einer [Verzögerung](/automatiseringen/logica#vertraging), wartet auf ein Ereignis oder auf eine Genehmigung und läuft später weiter |
| **Abgeschlossen** | Der Flow wurde bis zum Ende durchlaufen |
| **Fehlgeschlagen** | Ein Schritt konnte nicht ausgeführt werden. Die Meldung steht dabei als **Fehlgeschlagen: …** |
| **Abgebrochen** | Die Ausführung stoppte, weil die Automatisierung pausiert oder gelöscht wurde, während sie wartete |

Klicke auf eine Ausführung, um sie zu öffnen. Du siehst dann:

- alle Schritte, die gemacht wurden, mit dem Zeitpunkt und dem, was der Schritt tat
- die eingesetzten Werte, zum Beispiel den Titel, den die Aufgabe wirklich bekam
- bei einer Bedingung, welche Zeilen zutrafen
- bei einem fehlgeschlagenen Schritt die Fehlermeldung, die auf Englisch sein kann

Auf der Fläche färbt sich der Weg, den diese Ausführung nahm. Schritte, die nicht an der Reihe waren, werden abgedunkelt. Klicke auf einen Schrittnamen, um zu diesem Schritt zu springen.

Unter den Schritten steht eine Schaltfläche wie **3 Datensätze**. Sie zeigt die Daten, mit denen die Ausführung startete, und was jede Aktion lieferte, etwa die ID der erstellten Aufgabe oder die Antwort einer API-Anfrage. So kannst du nachvollziehen, welche Werte eine Variable hatte.

Unten in einer geöffneten Ausführung steht außerdem eine **Trace**: ein Code aus Buchstaben und Ziffern. Stimmt etwas an einer Ausführung nicht, gib diesen Code an den Support weiter. So finden wir genau diese Ausführung wieder.

<Callout type="info">
Ereignisse, die den Filter bei **Nur wenn** nicht passierten oder für die die Automatisierung bei **Einmal pro Datensatz ausführen** schon einmal lief, starten keine Ausführung und stehen daher nicht in der Liste.
</Callout>

In der Übersicht der Automatisierungen steht bei jeder Automatisierung der Zeitpunkt der letzten Ausführung, daneben ein Balken pro jüngster Ausführung.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Nach einem Testlauf hat sich in Tillor nichts verändert. Erst wenn du **Aktiv** einschaltest, läuft die Automatisierung wirklich.
- Echte Ausführungen bleiben auf dem Tab **Ausführungen** stehen. Er zeigt die letzten 20.
- Eine fehlgeschlagene Ausführung löst eine E-Mail an die Person aus, die die Automatisierung erstellt hat, höchstens eine pro Stunde.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Beispieldaten sind kein gültiges JSON">
Tillor zeigt **Die Beispieldaten sind kein gültiges JSON.** und lässt den Test nicht starten. Prüfe geschweifte Klammern, Kommas und Anführungszeichen.
</Accordion>
<Accordion title="Der Filter des Auslösers passt nicht zu diesen Daten">
Mit diesen Beispieldaten würde der Flow nicht starten. Sieh nach, welche Bedingung rot ist, und passe die Daten oder die Bedingung an.
</Accordion>
<Accordion title="Ich sehe keine Ausführungen">
Tillor zeigt **Noch keine Ausführungen. Aktiviere die Automatisierung und warte auf ihr Ereignis.** Ereignisse, die den Filter nicht passierten, stehen nicht dort. Siehe [Häufige Fragen](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="Der Test gelingt, aber die echte Ausführung schlägt fehl">
Ein Test sendet nichts und liest Datensätze nicht erneut. Ob eine Rechnung gesendet werden kann oder eine Adresse erreichbar ist, zeigt sich erst wirklich. Öffne die Ausführung für die Fehlermeldung und die Daten pro Schritt. Brauchst du Hilfe vom Support? Gib den **Trace**-Code der Ausführung an.
</Accordion>
</Accordions>

## Eine Ausführung, die nicht starten will [#een-uitvoering-die-niet-wil-starten]

Siehe [Häufige Fragen](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet) für eine Checkliste.


# Auslöser (/de-DE/automatiseringen/triggers)

Der Auslöser ist der Startpunkt einer Automatisierung: das "Wann". Er steht ganz oben in jedem Ablauf, unter dem Namen **Wenn das passiert**. Ein Beispiel: *starte, wenn eine Belegung endet*. Er bestimmt auch, welche Daten die folgenden Schritte nutzen können. Ein Ablauf kann mehrere Auslöser haben. Jeder Auslöser startet eine eigene Ausführung, mit seinem eigenen Filter. Du fügst einen über die Liste links hinzu. Den letzten Auslöser kannst du nicht löschen.

<DocScreenshot src="/screenshots/automatiseringen/trigger-settings.png" alt="Ausgewählter Auslöser mit den Feldern Startet durch und Ereignis, dem Filter Nur wenn und den Daten, die das Ereignis liefert" />

## Wodurch startet die Automatisierung [#waar-start-de-automatisering-op]

Bei **Startet durch** wählst du einen von sieben Startpunkten.

| Auswahl | Startet, wenn |
|---|---|
| **Wenn etwas passiert** | In Tillor ein Ereignis eintritt, etwa eine Belegung, die endet, oder eine Rechnung, die bezahlt wird |
| **Rechnung überfällig** | Eine gebuchte Rechnung nach dem Fälligkeitsdatum noch offen ist |
| **Eingehender Webhook** | Ein anderes System eine Nachricht an die eigene Adresse der Automatisierung sendet |
| **Eine Aufgabenaktion wird gewählt** | Jemand bei einer Aufgabe eine Auswahlschaltfläche wählt, die mit dieser Automatisierung verknüpft ist |
| **Ein Datum ist erreicht** | Ein Datum eines Datensatzes erreicht ist, wahlweise eine Zeit davor oder danach. Zum Beispiel einen Tag vor der Ankunft einer Reservierung |
| **Jeden Tag zu einer Uhrzeit** | Die gewählte Uhrzeit jeden Tag erreicht ist |
| **Nach einem Cron-Ausdruck** | Der Zeitplan, den du angibst, an der Reihe ist |

Du wählst also zuerst die Art des Startpunkts und danach die Details. Wählst du einen anderen Startpunkt, werden die Filter bei **Nur wenn** geleert. Sie waren für die vorherige Auswahl geschrieben und passen nicht mehr.

## Wenn etwas passiert [#als-er-iets-gebeurt]

Wähle bei **Ereignis**, was die Automatisierung starten soll. Klicke auf das Feld und tippe, um zu suchen, zum Beispiel *occupation* oder *invoice*. Die Ereignisse stehen in der Schreibweise von Tillor, wie `occupation:ended`: zuerst, worum es geht, dann, was geschah.

Das sind die Ereignisse, die du am häufigsten brauchst:

| Ereignis | Startet, wenn |
|---|---|
| `occupation:ended` | Eine Belegung endet |
| `reservation:created` | Eine Reservierung erstellt wird |
| `reservation:updated` | Eine Reservierung geändert wird |
| `customer:created` | Ein Kunde erstellt wird |
| `customer:updated` | Ein Kunde geändert wird |
| `invoice:created` | Eine Rechnung erstellt wird |
| `invoice:updated` | Eine Rechnung geändert wird |
| `invoice:paid` | Eine Rechnung bezahlt ist |
| `payment:created` | Eine Zahlung eingeht |
| `task:created` | Eine Aufgabe erstellt wird |
| `task:status-changed` | Der Status einer Aufgabe sich ändert |
| `task:assigned` | Eine Aufgabe jemandem zugewiesen wird |
| `task:action-chosen` | Jemand bei einer Aufgabe eine Auswahlschaltfläche wählt |
| `integration-alarm:created` | Ein Zähler einen Alarm meldet |
| `comment:created` | Ein Kommentar geschrieben wird |
| `document:created` | Ein Dokument hinzugefügt wird |
| `signatureRequest:updated` | Eine Unterschriftsanfrage aktualisiert wird |
| `signatureRequest:completed` | Alle Unterzeichner einer Unterschriftsanfrage unterschrieben haben |
| `mandate-agreement:signed` | Ein Kunde ein SEPA-Mandat unterschrieben hat |
| `mandate-agreement:activated` | Ein SEPA-Mandat aktiv geworden ist |
| `mandate-agreement:expired` | Eine Anfrage für ein SEPA-Mandat ohne Unterschrift abgelaufen ist |
| `mandate-agreement:failed` | Die Aktivierung eines SEPA-Mandats abgelehnt wurde oder fehlgeschlagen ist |
| `productPriceChange:applied` | Ein [geplanter Produktpreis](/producten/prijzen-plannen) in Kraft tritt |

Das ist dieselbe Liste wie die der [Webhooks](/ontwikkelaars/events). Du kannst also jedes Ereignis nutzen, für das Tillor einen Webhook senden kann. Ein paar Ereignisse, die extrem häufig vorkommen, etwa der physische Zustand von Schranken, das Tippen im Posteingang, Controller-Logs und die Anwesenheit von Fahrzeugen, stehen nicht in der Liste.

<Callout type="info" title="Fehlt dir ein Ereignis?">
Unter dem Feld **Ereignis** steht der Link **Fehlt ein Ereignis? Frag es an**. Siehe [Einen Schritt oder ein Ereignis anfragen](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).
</Callout>

### Welche Daten bekommst du mit [#welke-gegevens-krijg-je-mee]

Zu den meisten Ereignissen gehört ein Datensatz, etwa eine Belegung, eine Rechnung oder eine Aufgabe. Dieser Datensatz, plus die Datensätze, auf die er verweist, stehen danach als Variablen in den Schritten zur Verfügung. Bei `occupation:ended` kannst du zum Beispiel nutzen:

- `{occupation.terrain.name}` für den Namen des Stellplatzes
- `{occupation.customer.firstName}` für den Vornamen des Kunden
- `{occupation.reservation.displayId}` für die Nummer der Reservierung. Nicht jede Belegung hat eine Reservierung: dann bleibt dieser Wert leer

Außerdem gibt es immer `{triggeredBy.name}` und `{triggeredBy.id}`: den Kollegen, der das Ereignis ausgelöst hat. Wurde das Ereignis vom System ausgelöst, etwa durch eine Bankabgleich-Synchronisierung, sind diese Felder leer.

Unter den Einstellungen des Auslösers steht **Daten, die dieses Ereignis liefert**. Dort siehst du genau, welche Variablen du nutzen kannst. Bei einem Ereignis, dessen Daten nicht beschrieben sind, sagt Tillor, dass es nichts auszuwählen gibt. Variablen, die du selbst tippst, funktionieren trotzdem. Siehe [Variablen und Vorlagen](/automatiseringen/variabelen).

## Eine Aufgabenaktion wird gewählt [#er-wordt-een-taakactie-gekozen]

Manche Aufgaben haben Auswahlschaltflächen statt eines Häkchens, zum Beispiel aus [Um eine Entscheidung bitten](/automatiseringen/logica#vraag-om-een-beslissing). Eine Schaltfläche kann mit einer Automatisierung verknüpft sein. Mit diesem Auslöser startet diese Automatisierung, sobald jemand die Schaltfläche wählt. Siehe auch [Aufgaben mit Auswahlschaltflächen](/taken/taakdetails#taken-met-keuzeknoppen).

Eine Schaltfläche mit einer Automatisierung zu verknüpfen, machst du nicht im Ablauf-Editor. Brauchst du das, frage deinen Tillor-Administrator oder den Support.

Die Schritte bekommen die Daten der Aufgabe mit, zum Beispiel `{task.name}` und `{task.id}`, plus `{action.label}` (der Name der gewählten Schaltfläche) und `{note}` (die Notiz, die der Kollege eingetragen hat, wenn die Schaltfläche danach fragte). Unter **Daten, die dieses Ereignis liefert** siehst du die vollständige Liste.

## Rechnung überfällig [#factuur-is-vervallen]

Dieser Auslöser startet für jede Rechnung, die:

- gebucht ist (Entwürfe und stornierte Rechnungen zählen nicht)
- keine Gutschrift ist
- noch einen offenen Betrag hat
- ein Fälligkeitsdatum vor heute hat

Für jede solche Rechnung startet eine eigene Ausführung. Die Daten der Rechnung und des Kunden stehen als `{invoice.…}` zur Verfügung, zum Beispiel `{invoice.displayId}`, `{invoice.amountOutstanding}` und `{invoice.customer.firstName}`.

Schaltest du **Einmal pro Datensatz ausführen** aus, startet die Automatisierung für dieselbe Rechnung höchstens einmal pro Tag, solange sie überfällig ist. Lässt du es an, startet sie für jede Rechnung genau einmal. Das ist meistens das, was du für eine Erinnerung willst.

Bei **Erinnerung fällig** wählst du, wie lange die Rechnung schon offen sein muss, nach derselben Regel wie in der Rechnungsliste. Schalte **Kunden ohne automatische Mahnungen auslassen** ein, um Kunden zu überspringen, die das in ihren Rechnungseinstellungen so eingestellt haben. Eine Rechnung, die selbst aus den automatischen Erinnerungen genommen wurde, startet den Ablauf ebenfalls nicht.

## Eingehender Webhook [#inkomende-webhook]

Ein Webhook ist eine Nachricht, die ein anderes System an eine Adresse sendet. Mit diesem Auslöser startet dieses System die Automatisierung, zum Beispiel deine Website, ein Formular oder eine Buchungsplattform. Jede Automatisierung bekommt eine eigene, geheime Adresse.

1. Wähle bei **Startet durch** **Eingehender Webhook**
2. Speichere die Automatisierung. Bei **Adresse** erscheint die URL
3. Klicke auf **Kopieren** und trage die Adresse im anderen System ein
4. Schalte die Automatisierung ein

Das andere System sendet einen `POST` mit JSON an diese Adresse. Der Inhalt steht danach als `{body.…}` zur Verfügung, zum Beispiel `{body.email}` oder `{body.reservering.nummer}`, und Parameter in der URL als `{query.…}`. Mit **Nur wenn** kannst du auch nach diesen Feldern filtern.

So funktioniert es weiter:

- Die Adresse ist das Geheimnis. Wer sie kennt, kann die Automatisierung starten. Gib sie also nur an das System weiter, das sie braucht
- Ist die Adresse durchgesickert, klicke auf **Neue Adresse** und speichere. Die alte Adresse funktioniert ab dann nicht mehr
- Eine ausgeschaltete Automatisierung oder eine falsche Adresse ergibt einen Fehler `404`
- Der Inhalt darf höchstens 100 KB groß sein
- Jeder Aufruf startet pro Webhook-Auslöser im Ablauf eine Ausführung. Die Adresse gehört zum ersten Webhook-Auslöser. **Neue Adresse** bei diesem Auslöser ersetzt sie
- Es ist kein Datensatz damit verknüpft, daher hat **Einmal pro Datensatz ausführen** keine Wirkung

### Wiederholungen ignorieren [#herhalingen-negeren]

Sendet das andere System manchmal denselben Aufruf zweimal, verhinderst du mit **Wiederholungen ignorieren**, dass der Ablauf zweimal startet. Tillor merkt sich einen Schlüssel des Aufrufs. Kommt derselbe Schlüssel erneut, startet nichts.

| Auswahl | Was der Schlüssel ist |
|---|---|
| **Jeder Aufruf startet den Ablauf** | Es gibt keinen Schlüssel. Standard |
| **Aus einem Header** | Der Wert eines Headers, den du bei **Headername** wählst, zum Beispiel `Idempotency-Key` |
| **Aus dem JSON-Body** | Der Wert eines Felds im JSON, das du bei **Feld** wählst, wie `id` oder `data.eventId` |
| **Derselbe JSON-Body** | Der gesamte Inhalt. Ein Aufruf mit genau demselben Inhalt zählt als Wiederholung |

Bei **Schlüssel merken für** wählst du, wie lange der Schlüssel gilt, in Stunden, Tagen oder Wochen. Danach startet derselbe Schlüssel den Ablauf erneut. Bei 0 gilt der Schlüssel, bis du die Automatisierung löschst. Ein Aufruf ohne den gewählten Header oder ohne das gewählte Feld wird abgelehnt.

## Ein Datum ist erreicht [#een-datum-is-bereikt]

Dieser Auslöser startet an einem Datum eines Datensatzes. Bei **Datum** wählst du jedes Datumsfeld eines Datensatzes, das Tillor auch bei Ereignissen mitsendet, geschrieben als Datensatz und Feld. Einige Beispiele:

| Datum | Datensatz |
|---|---|
| `reservation.checkIn` | Das Ankunftsdatum einer Reservierung |
| `reservation.checkOut` | Das Abreisedatum einer Reservierung |
| `invoice.dueDate` | Das Fälligkeitsdatum einer Rechnung |
| `task.dueDate` | Die Frist einer Aufgabe |
| `occupation.paidUntil` | Bis wann eine Belegung bezahlt ist |
| `accessMethod.periodTo` | Das Ende der Gültigkeit eines QR-Codes, Kennzeichens oder anderen Zugangsmittels |
| `nfcTag.activatedUntil` | Bis wann ein NFC-Tag aktiviert ist |
| `mandateAgreement.expiresAt` | Wann eine Anfrage zur Unterschrift eines SEPA-Mandats abläuft |
| `customer.birthday` | Das Geburtsdatum eines Kunden |
| `contact.birthday` | Das Geburtsdatum einer Kontaktperson |

Standardmäßig startet der Auslöser einmal, am Datum selbst. Schalte **Jedes Jahr wiederholen** ein, damit nur Tag und Monat zählen: dann startet der Ablauf jedes Jahr erneut, etwa am Geburtstag bei `contact.birthday`. Ein 29. Februar fällt in anderen Jahren auf den 28. Februar.

Auch Daten, die bei einem Datensatz als zusätzliche Felder gespeichert sind, kannst du wählen. `document.userMetadata.insuranceExpiryDate` ist das Ablaufdatum eines Dokuments, etwa eines Zahlungsnachweises der Versicherung. Ein solches Datum ohne Uhrzeit zählt als Mitternacht (UTC, die internationale Standardzeit). Mit **Nur wenn** beschränkst du den Auslöser dann auf einen Typ, zum Beispiel `document.userMetadata.documentType` ist `INSURANCE_PAYMENT_PROOF`, und auf aktive Dokumente mit `document.status` ist `ACTIVE`.

Mit **Wie lange** und **Davor oder danach** verschiebst du den Zeitpunkt. *1 Tag* und **Davor** bei `reservation.checkIn` startet den Ablauf einen Tag vor der Ankunft. Bei 0 startet er am Datum selbst. Ein Datum ohne Uhrzeit zählt als Mitternacht.

Mit **Uhrzeit** wählst du, wann an diesem Tag der Ablauf startet. **Die Uhrzeit im Datum** nutzt den Zeitpunkt, der im Feld steht, etwa die Ankunftszeit einer Reservierung. **Feste Uhrzeit** startet am Tag des Datums zu der Stunde und Minute, die du wählst, in der Zeitzone deiner Organisation. So startet `contact.birthday` mit **Jedes Jahr wiederholen** jedes Jahr um 09:00 am Geburtstag. **Wie lange** zählt dann ab dieser Uhrzeit: *1 Tag* und **Davor** startet am Vortag um 09:00, auch wenn in dieser Nacht die Uhr umgestellt wird.

Für jeden Datensatz startet eine eigene Ausführung, mit den Daten dieses Datensatzes als Variablen, zum Beispiel `{reservation.displayId}` und `{reservation.customer.firstName}`. Mit **Nur wenn** schränkst du es ein, etwa auf Reservierungen mit dem Status Gebucht.

So funktioniert es weiter:

- Pro Datensatz und pro Zeitpunkt startet der Ablauf einmal. Verschiebt sich das Datum nach hinten, etwa weil ein Gast später ankommt, startet er zum neuen Zeitpunkt erneut
- Lag der Zeitpunkt schon in der Vergangenheit, als du die Automatisierung gespeichert oder eingeschaltet hast, startet sie dafür nicht mehr
- Verpasste Zeitpunkte, zum Beispiel während einer Wartung, holt Tillor bis zu einer Stunde später noch nach

## Jeden Tag zu einer Uhrzeit [#elke-dag-op-een-uur]

Wähle bei **Stunde** eine Stunde (0 bis 23) und bei **Minute** eine Minute von 0 bis 59. Die Zeit gilt in der Zeitzone deiner Organisation.

Die Schritte bekommen `{now}` mit: den Zeitpunkt, zu dem die Ausführung gestartet ist.

## Nach einem Cron-Ausdruck [#volgens-een-cron-expressie]

Wähle einen Rhythmus, etwa jeden Tag, jeden Montag um 08:00 oder die ungeraden Montage (der 1., 3. und 5.). Bei **Benutzerdefiniert** stellst du das Intervall, die Wochentage und die Uhrzeit minutengenau ein. Bei **Cron-Ausdruck** schreibst du den Zeitplan selbst.

Ein Cron-Ausdruck ist eine kurze Schreibweise für einen wiederkehrenden Zeitpunkt. Er hat fünf Teile, getrennt durch ein Leerzeichen: **Minute**, **Stunde**, **Tag des Monats**, **Monat** und **Wochentag**.

| Ausdruck | Bedeutung |
|---|---|
| `0 8 * * 1` | Jeden Montag um 08:00 |
| `7 8 * * 1` | Jeden Montag um 08:07 |
| `30 7 * * 1-5` | Jeden Werktag um 07:30 |
| `0 9 1 * *` | Am Ersten jedes Monats um 09:00 |
| `0 8 * * 1#1,1#3,1#5` | Jeden ungeraden Montag (1., 3. und 5. des Monats) um 08:00 |
| `0 8 * * 1L` | Am letzten Montag des Monats um 08:00 |
| `0 8 * * 1 W2:2026-10-05` | Alle zwei Wochen montags um 08:00, ab der Woche des 5. Oktober 2026 |
| `*/15 * * * *` | Alle 15 Minuten |
| `* * * * *` | Jede Minute |

In jedem Teil kannst du eine Zahl, eine Liste mit Kommas (`8,17`), einen Bereich (`1-5`), einen Schritt (`*/15`) oder einen Stern (`*`, jeder Wert) verwenden. Wochentag 0 und 7 sind beide Sonntag. `1#2` ist der zweite Montag, `1L` der letzte. Ein sechstes Feld `W2:2026-10-05` wiederholt alle zwei Wochen, gezählt ab dieser Woche. Namen wie *MON* oder *JAN* funktionieren nicht. Gibst du sowohl einen Tag des Monats als auch einen Wochentag an, startet die Automatisierung an einem von beiden.

Ist der Ausdruck ungültig, meldet Tillor das beim Auslöser. Die Zeiten gelten in der Zeitzone deiner Organisation.

## Wann genau startet ein Zeitplan [#hoe-laat-start-een-schema-precies]

<Callout type="warn" title="Ein Zeitplan startet in der Minute, in der er an der Reihe ist">
Tillor prüft jede Minute, welche Zeitpläne an der Reihe sind. Eine Automatisierung, die um 08:07 starten soll, startet in dieser Minute. Das gilt für **Rechnung überfällig**, **Ein Datum ist erreicht**, **Jeden Tag zu einer Uhrzeit** und **Nach einem Cron-Ausdruck**.
</Callout>

Pro Minute startet ein Zeitplan höchstens einmal. Eine Prüfung, die erst in der nächsten Minute läuft, holt die vorherige Minute nicht mehr nach.

Ereignisse starten sofort, ohne diese Verzögerung.

## Nur wenn [#alleen-wanneer]

Mit **Nur wenn** lässt du die Automatisierung nur starten, wenn die Daten stimmen. So startest du zum Beispiel nur für Mobilheime oder nur für Rechnungen über einem bestimmten Betrag. Lass es leer, um bei jedem Ereignis dieses Typs zu starten.

1. Klicke auf **Bedingung hinzufügen**
2. Wähle das Feld mit der Schaltfläche **Variable** (oder tippe den Pfad, zum Beispiel `invoice.status`)
3. Wähle, wie verglichen wird
4. Trage den Wert ein. Bei Feldern mit fester Auswahl, wie einem Status, einem Stellplatztyp oder einem Kollegen, wählst du aus einer Liste

Du kannst die folgenden Vergleiche nutzen:

| Auswahl | Trifft zu, wenn |
|---|---|
| **ist** | Das Feld gleich dem Wert ist |
| **ist nicht** | Das Feld nicht gleich dem Wert ist |
| **enthält** | Der Wert irgendwo im Feld vorkommt |
| **ist größer als** | Das Feld größer als der Wert ist (bei Zahlen und Daten) |
| **ist kleiner als** | Das Feld kleiner als der Wert ist (bei Zahlen und Daten) |
| **ist eines von** | Das Feld gleich einem der gewählten Werte ist |
| **ist leer** | Das Feld leer ist |
| **ist nicht leer** | Das Feld nicht leer ist |

Groß- und Kleinschreibung spielt keine Rolle. Zahlen werden als Zahl verglichen, also ist 10 größer als 9.

Hast du mehr als eine Bedingung, wählst du, wie sie zusammenwirken: **Alle müssen zutreffen** oder **Mindestens eine muss zutreffen**.

<Callout type="info">
Ereignisse, die vom Filter aufgehalten werden, starten keine Ausführung und hinterlassen daher auch keine Spur im Tab **Ausführungen**. Willst du sehen, ob dein Filter stimmt, nutze den Test: Dort siehst du pro Bedingung, ob sie zugetroffen hat.
</Callout>

## Einmal pro Datensatz ausführen [#eén-keer-per-record-uitvoeren]

Mit **Einmal pro Datensatz ausführen** startet die Automatisierung höchstens einmal pro Rechnung, Reservierung oder anderem Datensatz, egal wie oft das Ereignis dafür eintritt.

Das ist vor allem bei Ereignissen praktisch, die oft wiederkehren, wie `invoice:updated`: Eine Rechnung wird dutzende Male geändert, aber du willst nur eine Erinnerung senden. Tillor merkt sich pro Datensatz, dass die Automatisierung schon gestartet ist. Dieses Merken verschwindet, wenn du die Automatisierung löschst.

Es funktioniert nur bei Ereignissen, zu denen ein Datensatz gehört, sowie bei **Rechnung überfällig** und **Ein Datum ist erreicht**. Bei **Ein Datum ist erreicht** bedeutet es: Auch wenn sich das Datum später verschiebt, startet der Ablauf nicht erneut. Bei einem Zeitplan wie **Jeden Tag zu einer Uhrzeit** hat es keine Wirkung.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Jedes Mal, wenn der Startpunkt eintritt und der Filter zutrifft, startet eine Ausführung mit den Daten dieses Moments als Variablen.
- Ein Ereignis startet sofort. Ein Datum, eine Uhrzeit oder ein Zeitplan startet in der Minute, in der er an der Reihe ist.
- Passt der Filter nicht, startet nichts und es steht keine Spur im Tab **Ausführungen**.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Automatisierung startet bei meinem Ereignis nicht">
Prüfe, ob die Automatisierung eingeschaltet ist, ob du das richtige **Ereignis** gewählt hast und ob der Filter bei **Nur wenn** nicht zu streng ist. Teste mit den Daten eines echten Falls im Tab **Testlauf**. Mehr dazu in [Häufige Fragen](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="Tillor meldet Der Cron-Ausdruck ist ungültig">
Nutze fünf Felder, getrennt durch ein Leerzeichen, wie `0 8 * * 1`. Namen wie *MON* funktionieren nicht.
</Accordion>
<Accordion title="Ein eingehender Webhook ergibt einen Fehler 404">
Die Automatisierung ist ausgeschaltet oder die Adresse stimmt nicht. Schalte die Automatisierung ein und kopiere die Adresse erneut.
</Accordion>
<Accordion title="Mein Filter ist verschwunden, als ich einen anderen Startpunkt gewählt habe">
Bei einem anderen Startpunkt werden die Filter bei **Nur wenn** geleert, weil sie für den vorherigen Startpunkt geschrieben waren. Füge sie erneut hinzu.
</Accordion>
<Accordion title="Der Ablauf startet nicht erneut für dieselbe Rechnung">
**Einmal pro Datensatz ausführen** ist eingeschaltet. Dann startet er höchstens einmal pro Rechnung, Reservierung oder anderem Datensatz.
</Accordion>
</Accordions>

## Weiterlesen [#meer-lezen]

<Cards>
  <Card
    title="Bedingungen, Verzweigungen und Verzögerungen"
    href="/automatiseringen/logica"
    description="Den Ablauf verzweigen und warten lassen"
  />
  <Card
    title="Variablen und Vorlagen"
    href="/automatiseringen/variabelen"
    description="Daten des Ereignisses in deinen Schritten nutzen"
  />
</Cards>


# Variablen und Vorlagen (/de-DE/automatiseringen/variabelen)

Mit Variablen erstellst du Texte, die von Fall zu Fall anders sind. Du schreibst eine Variable in geschweifte Klammern und Tillor setzt den echten Wert ein, sobald die Automatisierung läuft.

Ein Beispiel für einen Aufgabentitel:

```text
Controleer {occupation.terrain.name}
```

Endet die Belegung auf Stellplatz 12, heißt die Aufgabe *Controleer 12*.

## Eine Variable einfügen [#een-variabele-invoegen]

Über jedem Textfeld, in dem Variablen funktionieren, steht die Schaltfläche **Variable**. Klicke darauf und du siehst eine Liste aller verfügbaren Daten, gruppiert nach Datensatz. Tippe, um zu suchen (**Variablen suchen**), und klicke auf eine Zeile. Tillor setzt die Variable an die Stelle deines Cursors.

<DocScreenshot src="/screenshots/automatiseringen/variables-picker.png" alt="Schaltfläche Variable beim Feld Titel mit geöffneter Liste der verfügbaren Variablen" />

Du kannst eine Variable auch einfach selbst tippen. Unter dem Feld zeigt ein graues Feld, wie der Text mit Beispieldaten aussieht, sodass du sofort siehst, ob es stimmt.

Variablen funktionieren in Textfeldern wie Titeln, Beschreibungen, Unteraufgaben, Nachrichten, der ID eines Kunden, einer Rechnung oder eines anderen Datensatzes, dem Pfad oder der URL einer API-Anfrage, dem Body, der Payload eines Webhooks, dem Namen des Webhook-Ereignisses und den Werten von Headern. Bei den letzten beiden fehlt die Schaltfläche **Variable**, aber eine Variable, die du selbst tippst, wird trotzdem eingesetzt. Tillor prüft diese beiden Felder nicht auf Fehler und zeigt dort keine Vorschau.

In Feldern, in denen du eine Angabe zum Vergleichen wählst, schreibst du die Variable ohne geschweifte Klammern. Das gilt für **Nur wenn**, **Wenn / sonst** und **Bis** bei **Warten bis** (zum Beispiel `invoice.status`), für das **Feld** einer **Verzweigung** und für das **Datum** einer **Verzögerung**.

## Welche Variablen gibt es [#welke-variabelen-zijn-er]

| Variable | Verfügbar | Inhalt |
|---|---|---|
| `{occupation.…}`, `{invoice.…}`, `{task.…}`, `{reservation.…}` und andere | Nach einem Ereignis | Die Felder des Datensatzes, um den es im Ereignis geht. Der Name des Datensatzes ist auch der Anfang der Variable |
| `{occupation.terrain.name}` | Nach einem Ereignis | Felder der Datensätze, auf die der Datensatz verweist, wie der Kunde oder der Stellplatz. Das funktioniert eine Ebene tief |
| `{triggeredBy.name}`, `{triggeredBy.id}` | Immer | Der Kollege, der das Ereignis ausgelöst hat. Leer, wenn das System es getan hat |
| `{invoice.…}` | Bei **Rechnung überfällig** | Die Felder der überfälligen Rechnung und des Kunden |
| `{reservation.…}`, `{task.…}` und andere | Bei **Ein Datum ist erreicht** | Die Felder des Datensatzes, dessen Datum erreicht ist, plus die Datensätze, auf die er verweist |
| `{now}`, `{today}` | Immer | Der Zeitpunkt, zu dem der Schritt läuft, und Mitternacht dieses Tages in der Zeitzone der Organisation. Zusammen mit einer Verschiebung (unten) ergibt `{today + 1 day}` morgen |
| `{threadId}`, `{messageId}` | Bei Ereignissen zu Posteingangsnachrichten, wie `inbox:message-created` | Die ID der Unterhaltung und der Nachricht |
| Die Felder des Ereignisses | Nach **Auf ein Ereignis warten**, über **Empfangen** | Die Daten des Ereignisses, auf das gewartet wurde. Sie ersetzen die Daten derselben Datensätze vom Anfang des Ablaufs |
| `{createdTask.id}`, `{createdTask.name}` | Nach **Aufgabe erstellen** | Die Aufgabe, die gerade erstellt wurde |
| `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}`, `{foundTask.status}` | Nach **Aufgabe suchen**, über **Gefunden** | Die Aufgabe, die der Schritt gefunden hat |
| `{updatedTask.id}`, `{updatedTask.status}` | Nach **Aufgabenstatus setzen** | Die Aufgabe, deren Status geändert wurde |
| `{updatedTask.id}`, `{updatedTask.priority}` | Nach **Aufgabenpriorität festlegen** | Die Aufgabe, deren Priorität geändert wurde |
| `{updatedTask.id}` | Nach **Aufgabe aktualisieren** | Die Aufgabe, die angepasst wurde |
| `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}`, `{foundDocument.userMetadata.insuranceExpiryDate}` | Nach **Dokument suchen**, über **Gefunden** | Das Dokument, das der Schritt gefunden hat |
| `{updatedDocument.id}` | Nach **Dokument aktualisieren** | Das Dokument, das angepasst wurde |
| `{response.status}`, `{response.body}`, `{response.data.…}` | Nach **API-Anfrage** | Die Antwort der Anfrage |
| `{foundCustomer.…}`, `{foundInvoice.…}`, `{foundReservation.…}` und andere | Nach **Datensatz nachschlagen**, über **Gefunden** | Die Felder des Datensatzes, den der Schritt gefunden hat, plus die Datensätze, auf die er verweist. Der Name ist `found` plus der Datensatztyp: `foundCustomer`, `foundReservation`, `foundOccupation`, `foundInvoice`, `foundPayment`, `foundTerrain`, `foundTask`, `foundDocument`, `foundAccessMethod`, `foundNfcTag`, `foundMeter`, `foundInboxThread` oder `foundInboxMessage` |
| `{body.…}`, `{query.…}`, `{receivedAt}` | Nach **Eingehender Webhook** | Der JSON-Body, die Query-Parameter und der Empfangszeitpunkt des Webhook-Aufrufs |
| Jeder Zielname aus **Variablen zuordnen** | Nach **Variablen zuordnen** | Was du in diesem Schritt als Ziel einträgst, zum Beispiel `{invoice.displayId}` nach `invoice` ← `{foundInvoice}` |
| `{item.…}` | In den Schritten hinter **Für jedes** | Die Felder des Elements, für das der Schritt gerade läuft, wie `{item.id}` |
| `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}`, `{approval.decidedBy.name}` | Nach **Um eine Entscheidung bitten**, über eine Option | Die Aufgabe, die gewählte Option, der Name dieser Option, die Notiz und der Kollege, der gewählt hat |
| `{task.…}`, `{action.label}`, `{note}` | Bei **Eine Aufgabenaktion wird gewählt** | Die Aufgabe, die gewählte Schaltfläche und die Notiz, die dazu eingetragen wurde |
| `{createdComment.id}` | Nach **Kommentar hinzufügen** | Der Kommentar, der gerade geschrieben wurde |
| `{bookedInvoice.displayId}` | Nach **Rechnung buchen**, über **Fertig** | Die Rechnungsnummer der gebuchten Rechnung |
| `{paymentLink.url}` | Nach **Zahlungslink erstellen**, über **Fertig** | Der Link, mit dem der Kunde online bezahlen kann |
| `{consumptionInvoice.id}` | Nach **Verbrauch abrechnen**, über **Fertig** | Die Rechnung für den Zählerverbrauch |
| `{extendInvoice.id}` | Nach **Verlängerungsrechnung entwerfen** | Die Entwurfsrechnung, die die Belegung verlängert |
| `{createdAccessMethod.id}`, `{createdAccessMethod.value}` | Nach **Zugangsmethode erstellen** | Das neue Zugangsmittel und sein Wert, wie der Code eines QR-Codes oder PIN-Codes |
| `{error.message}`, `{error.step}` | Nach einer Aktion mit **Fortfahren, wenn dieser Schritt fehlschlägt**, über **Fehler** | Die Fehlermeldung und der Name des Schritts, der fehlgeschlagen ist |

Welche Felder ein Datensatz genau hat, siehst du in der Liste hinter der Schaltfläche **Variable**. Beim Auslöser steht außerdem die Übersicht **Daten, die dieses Ereignis liefert**.

### Nur, was im Ablauf früher kommt [#alleen-wat-eerder-in-de-flow-komt]

Ein Schritt kann nur Variablen nutzen aus dem Auslöser, der ihn erreicht, und aus Schritten, die auf demselben Weg früher stehen. Erreichen mehrere Auslöser denselben Schritt, sind nur die Variablen verfügbar, die jeder dieser Auslöser liefert. Ein Feld aus einem früheren Schritt zählt, wenn jeder dieser Auslöser auch an diesem Schritt vorbeikommt. Nutzt du eine Variable, die an dieser Stelle nicht existiert, meldet Tillor **[Feld]: [Variable] ist bei diesem Schritt nicht verfügbar.** Ein Ablauf mit so einer Meldung kann nicht eingeschaltet werden.

Manche Datensätze speichern zusätzliche Daten in einem Feld, wie die Dokumentdaten in `userMetadata`. Jeder Schlüssel darunter ist eine Variable: `{document.userMetadata.documentType}`, `{document.userMetadata.insuranceExpiryDate}` oder ein anderer Schlüssel. Die bekannten Schlüssel, wie der Typ und das Ablaufdatum eines Dokuments, stehen auch in der Liste und lassen sich als Datum vergleichen. Ein Datum ohne Uhrzeit, wie `2026-10-07`, erscheint in einer Nachricht als `07-10-2026`.

Variablen von **Für jedes** (`{item.…}`) existieren nur in den Schritten hinter dem Ausgang **Für jedes**, nicht hinter **Fertig**. Variablen eines Ausgangs, den du nicht genommen hast, existieren ebenfalls nicht: `{paymentLink.url}` gibt es nur, wenn der Schritt über **Fertig** lief, und `{foundTask.id}` nur nach **Gefunden**.

Bei Ereignissen, deren Daten nicht beschrieben sind, kann Tillor nicht prüfen, welche Variablen existieren. Dann bekommst du diese Meldung nicht. Prüfe solche Abläufe also besonders gut mit einer Testausführung.

### Ein neuer Wert ersetzt den alten [#een-nieuwe-waarde-vervangt-de-oude]

Eine zweite **API-Anfrage** im selben Ablauf ersetzt die `response` der ersten. Dasselbe gilt für `createdTask` nach einem zweiten **Aufgabe erstellen**, für `foundTask` nach einem zweiten **Aufgabe suchen** oder **Datensatz nachschlagen** bei **Aufgabe**, und für `error` nach einem zweiten fehlgeschlagenen Schritt. Nutze die Daten aus einer Antwort also in dem Schritt, der direkt darauf folgt.

## Wie Werte eingesetzt werden [#hoe-waarden-worden-ingevuld]

Tillor passt die Schreibweise an die Art des Felds an.

**In normalem Text** (Titel, Beschreibungen, Unteraufgaben):

- Daten stehen in der Zeitzone deiner Organisation, zum Beispiel `05-10-2026`. Liegt der Zeitpunkt nicht genau auf Mitternacht, steht auch eine Uhrzeit dabei, wie `05-10-2026 14:30`
- Ein leeres Feld ergibt einen leeren Text
- Eine Variable, die Tillor nicht kennt, bleibt so stehen, wie du sie geschrieben hast, zum Beispiel `{occupation.terain.name}`. Ein Tippfehler fällt so sofort in der Aufgabe oder der Nachricht auf
- Gibt es einen verknüpften Datensatz nicht, bleibt die Variable leer. Eine Belegung ohne Reservierung ergibt für `{occupation.reservation.displayId}` also nichts, und ein vom System ausgelöstes Ereignis ergibt nichts für `{triggeredBy.name}`. Willst du in diesem Fall einen anderen Text, setze ein **Wenn / sonst** mit **ist leer** davor

**In JSON** (die **Payload** eines Webhooks und der **Body** einer API-Anfrage):

- Text wird sicher eingesetzt. Anführungszeichen, Zeilenumbrüche und andere Sonderzeichen im Wert können das JSON nicht kaputt machen
- Zahlen und Ja/Nein-Werte kommen ohne Anführungszeichen, setze also keine darum. Text setzt du dagegen in Anführungszeichen
- Daten gehen als internationales Datum mit Uhrzeit durch, wie `2026-10-05T08:00:00.000Z`, damit das empfangende System gut damit umgehen kann

```json
{
  "reservation": "{reservation.displayId}",
  "adults": {reservation.numberOfAdults}
}
```

Ist das JSON nach dem Einsetzen nicht gültig, zum Beispiel weil eine Zahl leer ist, bricht die Ausführung mit einer Fehlermeldung ab.

**In einem Pfad oder einer URL** (bei einer API-Anfrage):

- Werte werden so umgewandelt, dass sie in eine Adresse passen. Ein Name mit einem Leerzeichen ergibt also keine kaputte Adresse
- Daten gehen auch hier als internationales Datum mit Uhrzeit
- Was du selbst tippst, bleibt so, wie du es tippst. Willst du ein Leerzeichen in einem Suchbegriff, tippe selbst `%20`

## Ein Datum verschieben [#een-datum-verschuiven]

Hinter einer Datumsvariable darf eine Verschiebung stehen: `{reservation.checkOut + 1 day}`, `{today - 2 weeks}`, `{invoice.dueDate + 3 hours|date}`. Die Einheiten sind `minutes`, `hours`, `days`, `weeks` und `months` (die Einzahl geht auch). Tage und Wochen haben feste Längen, sodass eine Gültigkeit über die Sommer- und Winterzeit hinweg gleich lang bleibt; Monate folgen dem Kalender, also ist der 31. Januar plus ein Monat der 28. oder 29. Februar. Bei einem Wert, der kein Datum ist, tut die Verschiebung nichts, und eine Einheit, die es nicht gibt, ist ein Fehler im Schritt. Datumsfelder wie **Gültig bis** akzeptieren dieselbe Schreibweise.

## Einen Wert formatieren [#een-waarde-opmaken]

Setze hinter die Variable ein `|` und ein Format, zum Beispiel `{invoice.amountOutstanding|currency}`. Ohne Format steht ein Betrag nackt da, wie `1295.3`. Mit `|currency` wird daraus `€ 1.295,30`.

| Format | Beispiel | Ergebnis |
|--------|-----------|-----------|
| `currency` | `{invoice.amountOutstanding\|currency}` | `€ 1.295,30` |
| `currency:USD` | `{invoice.amountOutstanding\|currency:USD}` | `US$ 1.295,30` |
| `number` | `{invoice.amountOutstanding\|number}` | `1.295,3` |
| `number:2` | `{invoice.amountOutstanding\|number:2}` | `1.295,30` (feste Anzahl Dezimalstellen) |
| `date` | `{invoice.dueDate\|date}` | `30-06-2026` |
| `datetime` | `{invoice.createdAt\|datetime}` | `01-06-2026 16:04` |
| `time` | `{invoice.createdAt\|time}` | `16:04` |
| `upper` / `lower` | `{customer.lastName\|upper}` | `VAN DEN BROECKE` |

- Zahlen und Beträge stehen immer in belgischer Schreibweise: ein Punkt für Tausender und ein Komma für Dezimalstellen
- Daten und Uhrzeiten stehen in der Zeitzone deiner Organisation
- Kann das Format den Wert nicht lesen, zum Beispiel `|currency` bei Text, steht der Wert einfach ohne Format da
- Ein Format, das Tillor nicht kennt, bleibt so stehen, wie du es geschrieben hast, und der Editor zeigt dazu eine Meldung
- In JSON und in einer URL wird der formatierte Wert als Text eingesetzt. Setze in JSON also Anführungszeichen darum

## Eine API-Antwort nutzen [#een-api-antwoord-gebruiken]

Nach einer [API-Anfrage](/automatiseringen/acties/integraties#api-verzoek) kannst du Felder aus der Antwort mit `{response.data.…}` nutzen. Die Antwort einer Suche nach Aufgaben sieht zum Beispiel so aus:

```json
{
  "items": [
    { "id": "task_1", "priority": "LOW" }
  ]
}
```

Dann ergibt `{response.data.items.0.id}` die ID der ersten Aufgabe (die erste in einer Liste hat die Nummer 0) und `{response.data.items.0.priority}` deren Priorität.

Tillor kann die Felder einer Antwort erst als Variable anbieten, wenn es weiß, wie die Antwort aussieht. Das geht auf zwei Arten:

- Lass die Automatisierung einmal echt laufen. Tillor nutzt dann die Antwort der letzten Ausführung
- Füge ein Beispiel im Tab **Testlauf** ein, im Feld **Beispiel-API-Antwort**. Dieses Feld erscheint, sobald der Ablauf eine **API-Anfrage** enthält. Darunter stehen **Felder in dieser Antwort**. Klicke auf ein Feld, um es kopiert zu bekommen, samt geschweiften Klammern

Danach stehen die Felder in der Liste hinter der Schaltfläche **Variable** und in der Liste bei **Feld** einer **Verzweigung**.

Tippst du selbst einen Pfad unter `response.data`, wird er immer akzeptiert, auch ohne Beispiel. Außerdem:

- `{response.body}` enthält die ersten 4000 Zeichen der Antwort. Ist die Antwort länger, wird der Rest abgeschnitten
- `{response.data}` ist leer, wenn die Antwort kein JSON ist oder wenn die Antwort sehr groß ist (mehr als 100.000 Zeichen)
- Bei einer Suche ohne Ergebnis existiert `{response.data.items.0.id}` nicht. Eine **Verzweigung** auf so ein Feld geht dann über **Standard**

<Callout type="info" title="Ein Beispiel im Test">
Im Tab **Testlauf** trägst du auch die Beispieldaten des Ereignisses ein. So siehst du im Testlauf, welche Werte Tillor einsetzen würde. Siehe [Testen und Ausführungen](/automatiseringen/testen-en-uitvoeringen).
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Sobald die Automatisierung läuft, ersetzt Tillor jede Variable durch den echten Wert. Eine Variable, die Tillor nicht kennt, bleibt so stehen, wie du sie geschrieben hast.
- Ist eine Angabe leer, bleibt die Stelle leer. Willst du dann einen anderen Text, setze ein **Wenn / sonst** mit **ist leer** davor.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe {occupation.terain.name} in meiner Aufgabe stehen">
Eine Variable, die Tillor nicht kennt, bleibt wörtlich stehen. Meistens liegt ein Tippfehler vor. Wähle die Variable über die Schaltfläche **Variable**.
</Accordion>
<Accordion title="Tillor sagt, dass eine Variable bei diesem Schritt nicht verfügbar ist">
Du nutzt eine Angabe, die an dieser Stelle des Ablaufs noch nicht existiert, zum Beispiel von einem Schritt, der später kommt, oder von einem Ausgang, den du nicht genommen hast. Setze den Schritt, der die Angabe liefert, früher in den Ablauf. Solange die Meldung da ist, kannst du die Automatisierung nicht einschalten.
</Accordion>
<Accordion title="Das JSON stimmt nach dem Einsetzen nicht">
Eine leere Zahl macht das JSON ungültig. Text setzt du in Anführungszeichen, Zahlen nicht. Prüfe die Felder mit einer Testausführung.
</Accordion>
<Accordion title="Ich sehe die Felder einer API-Antwort nicht in der Liste">
Tillor kennt die Form der Antwort noch nicht. Lass die Automatisierung einmal echt laufen oder füge ein Beispiel bei **Beispiel-API-Antwort** im Tab **Testlauf** ein.
</Accordion>
</Accordions>


# Häufige Fragen (/de-DE/automatiseringen/veelgestelde-vragen)

## Wer kann Automatisierungen nutzen? [#wie-kan-automatiseringen-gebruiken]

Wer **Automatisierungen ansehen** hat, sieht die Automatisierungen und ihre Ausführungen. Wer **Automatisierungen verwalten** hat, kann sie auch erstellen, ändern, einschalten und löschen. Administratoren mit **Alle Berechtigungen** können alles. Du vergibst diese Berechtigungen bei den Mitgliedern deiner Organisation.

Vorsicht bei **Automatisierungen verwalten**: Eine Automatisierung arbeitet mit allen Berechtigungen deiner Organisation. Wer Abläufe bauen darf, kann über einen Ablauf also alles tun. Gib es nur Personen, denen du das zutraust. Wer keine der beiden Berechtigungen hat, sieht den Menüpunkt **Administrator > Automatisierungen** nicht.

## Warum startet meine Automatisierung nicht? [#waarom-start-mijn-automatisering-niet]

Gehe diese Punkte durch.

1. **Ist sie eingeschaltet?** Eine Automatisierung, deren Schalter aus ist (Filter **Pausiert**), startet nicht. Stehen Probleme dabei, konntest du sie nicht einschalten. Siehe [Probleme und Einschalten](/automatiseringen/problemen)
2. **Ist es das richtige Ereignis?** Eine neue Reservierung ist `reservation:created`, eine Änderung `reservation:updated`. Prüfe auch, ob das Ereignis bei deiner Aktion wirklich eintritt
3. **Hält der Filter sie auf?** Ereignisse, die den Filter bei **Nur wenn** nicht passieren, hinterlassen keine Ausführung. Nutze den Tab **Testlauf** mit den Daten eines echten Falls, um zu sehen, welche Bedingung nicht zutrifft. Achte auf die Werte von Auswahlfeldern: Ein Rechnungsstatus ist zum Beispiel `BOOKED`
4. **Ist Einmal pro Datensatz ausführen eingeschaltet?** Dann startet die Automatisierung nicht erneut für eine Rechnung oder Reservierung, für die sie schon einmal lief. Siehe [Einmal pro Datensatz ausführen](/automatiseringen/triggers#eén-keer-per-record-uitvoeren)
5. **Ist es ein Zeitplan?** Dann startet er in der Minute, in der er an der Reihe ist. Eine feste Uhrzeit und ein Zeitplan nutzen die Zeitzone deiner Organisation
6. **Hast du sie gerade erst eingeschaltet oder geändert?** Es kann eine halbe Minute dauern, bis alles das bemerkt
7. **Kommen viele Ereignisse gleichzeitig?** Dann werden die Ausführungen nacheinander abgearbeitet und es kann etwas dauern, bis deine an der Reihe ist

Startet die Automatisierung, aber danach geht etwas schief, schau im Tab **Ausführungen** nach, was geschah und wo die Ausführung hängen blieb.

## Warum startet mein Zeitplan zu spät? [#waarom-start-mijn-schema-te-laat]

Zeitpläne werden jede Minute geprüft. Eine Automatisierung, die an einem Datum, zu einer Uhrzeit oder nach einem Zeitplan startet, beginnt in dieser Minute. Ein Ereignis startet sofort.

## Kann eine Automatisierung sich selbst immer wieder starten? [#kan-een-automatisering-zichzelf-blijven-starten]

Innerhalb eines Ablaufs nicht. Verbindest du einen Ausgang so, dass der Ablauf zu einem früheren Schritt zurückspringen würde, lehnt Tillor diese Linie ab. Einen Ablauf mit so einer Schleife kannst du nicht einschalten. Kommt eine Ausführung doch an einem Schritt an, den sie schon ausgeführt hat, stoppt sie, statt den Schritt erneut auszuführen.

Auch nicht über Ereignisse. Was ein Schritt tut, geschieht als der Benutzer **Workflow**, und Ereignisse, die **Workflow** auslöst, starten keine Automatisierungen. Eine Automatisierung, die bei `task:created` startet und eine **Aufgabe erstellen** ausführt, startet also nicht erneut bei der Aufgabe, die sie selbst erstellt hat. Das gilt auch zwischen Automatisierungen: Die eine kann die andere nicht starten.

Kommen in kurzer Zeit viele Ereignisse herein, zum Beispiel durch einen großen Versand, startet jedes Ereignis eine Ausführung. Tillor arbeitet sie einige gleichzeitig ab. Es geht nichts verloren, aber es kann etwas dauern.

## Welche Grenzen gelten? [#welke-grenzen-gelden-er]

| Was | Grenze |
|---|---|
| Schritte in einer Automatisierung | 100 |
| Zweige in einer **Verzweigung** | 8, neben **Standard** |
| Verbindungen von einem Ausgang | 1 Schritt. Verbindest du erneut, ersetzt die neue Linie die alte |
| Länge des Namens | 120 Zeichen |
| Länge der Beschreibung | 500 Zeichen |
| Notizen und Rahmen auf der Arbeitsfläche | 50 zusammen |
| Optionen bei **Um eine Entscheidung bitten** | 8 |
| Wartezeit einer API-Anfrage | 15 Sekunden |
| Die Antwort in `{response.body}` | Die ersten 4000 Zeichen |
| Die Antwort in `{response.data}` | Bis 100.000 Zeichen, größer ist leer |
| Verzögerung in Sekunden | Nicht exakt, kann einige Sekunden später sein |
| Zeitpläne | Prüfung jede Minute |
| Elemente in einem **Für jedes** | 100 pro Durchlauf |
| Prüfung bei **Warten bis** | Höchstens alle 5 Minuten |
| Inhalt eines eingehenden Webhooks | 100 KB |
| Ausführungen im Tab **Ausführungen** | Die letzten 20 |

## Können mehrere Automatisierungen beim selben Ereignis starten? [#kunnen-er-meerdere-automatiseringen-op-dezelfde-gebeurtenis-starten]

Ja. Jede eingeschaltete Automatisierung, deren Auslöser und Filter passen, startet ihre eigene Ausführung. Rechne nicht mit einer festen Reihenfolge.

## Kann ich nach einem Ausgang zwei Dinge gleichzeitig tun lassen? [#kan-ik-na-één-uitgang-twee-dingen-tegelijk-laten-doen]

Nein, ein Ausgang führt zu einem Schritt. Setze die Aktionen hintereinander oder erstelle eine zweite Automatisierung mit demselben Auslöser.

## Was passiert mit laufenden Ausführungen, wenn ich etwas ändere? [#wat-gebeurt-er-met-lopende-uitvoeringen-als-ik-iets-verander]

| Was du tust | Was mit Ausführungen passiert |
|---|---|
| Den Ablauf anpassen und speichern | Neue Ausführungen nutzen den neuen Ablauf. Ausführungen, die schon laufen oder warten, arbeiten mit dem Ablauf weiter, wie er war |
| Die Automatisierung pausieren | Ausführungen, die in einer Verzögerung warten, stoppen, sobald die Wartezeit vorbei ist, und bekommen den Status **Abgebrochen**. Was in diesem Moment schon läuft, läuft zu Ende. Schaltest du sie vor Ablauf der Wartezeit wieder ein, läuft die Ausführung einfach weiter |
| Die Automatisierung löschen | Die Ausführungen und der Verlauf werden gelöscht. Wartende Ausführungen stoppen |

## Was passiert, wenn ein Schritt fehlschlägt? [#wat-gebeurt-er-als-een-stap-mislukt]

Die Ausführung stoppt mit dem Status **Fehlgeschlagen** und die Schritte danach werden nicht ausgeführt. Wer die Automatisierung erstellt hat, bekommt eine E-Mail über die fehlgeschlagene Ausführung, höchstens eine pro Stunde pro Automatisierung. Tillor versucht den Schritt nicht erneut. Bei **Webhook senden** und **API-Anfrage** kannst du einen Fehlschlag mit dem Ausgang **Fehlgeschlagen** abfangen. Bei anderen Aktionen schaltest du **Fortfahren, wenn dieser Schritt fehlschlägt** ein: Der Schritt bekommt dann einen Ausgang **Fehler** und der Ablauf geht dort weiter. Siehe [Wenn ein Schritt fehlschlägt](/automatiseringen/acties#als-een-stap-mislukt).

## Wird bei einem Test wirklich etwas versendet? [#wordt-er-echt-iets-verstuurd-tijdens-een-test]

Nein. Eine Testausführung versendet nichts, erstellt nichts und ändert nichts. Siehe [Testen und Ausführungen](/automatiseringen/testen-en-uitvoeringen).

## Sind meine Daten sicher gespeichert? [#zijn-mijn-gegevens-veilig-opgeslagen]

Deine Abläufe und der Ausführungsverlauf, einschließlich Headern mit Schlüsseln oder Tokens, werden verschlüsselt gespeichert. Für Adressen im Internet gilt, dass nur `https` erlaubt ist und dass interne Adressen abgelehnt werden.

## Mir fehlt ein Ereignis, eine Bedingung oder eine Aktion [#ik-mis-een-gebeurtenis-voorwaarde-of-actie]

Nutze **Schritt anfragen** im Editor. Siehe [Einen Schritt oder ein Ereignis anfragen](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).

## Kann ich Automatisierungen auch aus meinem eigenen System verwalten? [#kan-ik-automatiseringen-ook-vanuit-mijn-eigen-systeem-beheren]

Ja, wenn deine Anbindung über alle Berechtigungen verfügt. Siehe [Für Entwickler](/ontwikkelaars/automatiseringen).

<Callout type="idea" title="Klein anfangen">
Beginne mit einem Auslöser und einer Aktion, lass sie ein paar Tage mitlaufen und sieh dir die Ausführungen an. Baue erst danach mit Bedingungen und Verzögerungen aus.
</Callout>


# Beispiel: Nachkontrolle Mietwohnwagen (/de-DE/automatiseringen/voorbeeld-nalopen)

Dieses Beispiel baut einen Ablauf mit einem Filter, **Aufgabe suchen**, **Aufgabenpriorität festlegen**, einem **Wenn / sonst** und einer Aufgabe mit Unteraufgaben. Du brauchst dafür keine API-Anfrage.

In Demo-Umgebungen von Tillor steht dieser Ablauf als pausiertes Beispiel unter dem Namen **Nalopen huurcaravan** schon bereit. Du kannst ihn dort ansehen, während du mitbaust.

## Was der Ablauf tut [#wat-de-flow-doet]

Ein Gast reist von einem Mobilheim ab. Der Wohnwagen muss für den nächsten Gast kontrolliert werden.

- Gibt es noch keine offene Kontrollaufgabe für diesen Stellplatz, erstellt der Ablauf eine, mit fünf Unteraufgaben und einer Frist nach 7 Tagen. Die Aufgabe geht auch an den Kollegen, der die Belegung beendet hat
- Gibt es schon eine offene Kontrollaufgabe, zum Beispiel weil der Wohnwagen zweimal kurz hintereinander frei wurde, erstellt der Ablauf keine zweite Aufgabe. Stattdessen steigt die Priorität der bestehenden Aufgabe um eine Stufe

```mermaid
flowchart TD
  A["Belegung beendet<br/>nur Mobilheime"] --> F{"Offene Kontrollaufgabe?"}
  F -- Gefunden --> P["Priorität eine Stufe höher<br/>bis Hoch"]
  F -- Nicht gefunden --> B{"Von einem Kollegen beendet?"}
  B -- Ja --> C["Kontrollaufgabe erstellen<br/>mit Namen des Kollegen"]
  B -- Nein --> D["Kontrollaufgabe erstellen"]
```

Die beiden Aufgabenschritte unten sind fast gleich. Nur die Beschreibung unterscheidet sich: Hat das System die Belegung beendet, gibt es keinen Kollegen, den man erwähnen könnte.

## Was du brauchst [#wat-je-nodig-hebt]

- Du hast die Berechtigung **Automatisierungen verwalten** oder **Alle Berechtigungen**
- In deiner Organisation gibt es einen Stellplatztyp für Mobilheime, in diesem Beispiel **Mobilheim**
- Optional: ein Board und eine Spalte für die Kontrollaufgaben

## Den Ablauf bauen [#de-flow-bouwen]

### 1. Einen leeren Ablauf erstellen [#1-een-lege-flow-maken]

1. Gehe zu **Administrator > Automatisierungen** und klicke auf **Neue Automatisierung**
2. Wähle **Von Grund auf starten**
3. Trage in der Brotkrumennavigation oben den Namen **Nachkontrolle Mietwohnwagen** ein
4. Klicke auf die Arbeitsfläche, neben die Schritte, und trage im Bereich bei **Beschreibung** ein, wofür der Ablauf dient

### 2. Den Auslöser einstellen [#2-de-trigger-instellen]

1. Klicke auf den Auslöser. Lass **Startet durch** auf **Wenn etwas passiert** stehen
2. Wähle bei **Ereignis** `occupation:ended`. Tippe *occupation*, um zu suchen
3. Gib dem Schritt bei **Schrittname** den Namen *Belegung beendet*

Jetzt startet der Ablauf bei jeder Belegung, die endet. Du willst ihn nur für Mobilheime:

1. Klicke bei **Nur wenn** auf **Bedingung hinzufügen**
2. Klicke auf **Variable** und wähle `occupation.terrain.terrainTypeId`
3. Lass den Vergleich auf **ist** stehen
4. Wähle beim Wert den Stellplatztyp **Mobilheim**

<DocScreenshot src="/screenshots/automatiseringen/trigger-filter.png" alt="Auslöser mit der Bedingung Stellplatztyp ist Mobilheim" />

### 3. Eine offene Kontrollaufgabe suchen [#3-een-open-nalooptaak-zoeken]

1. Füge einen Schritt **Aufgabe suchen** hinzu, verbinde den Auslöser damit und gib ihm den Namen *Offene Kontrollaufgabe?*
2. Trage bei **Titel** `Nalopen {occupation.terrain.name}` ein
3. Lass **Mit den Datensätzen des Ereignisses verknüpft**, **Nur nicht abgeschlossene Aufgaben** und **Unteraufgaben überspringen** eingeschaltet

Der Schritt sucht nun eine Hauptaufgabe, die noch nicht abgeschlossen ist, genau *Nalopen* gefolgt vom Namen des Stellplatzes heißt und mit demselben Stellplatz, demselben Kunden oder derselben Reservierung verknüpft ist. Danach geht der Ablauf über **Gefunden** oder **Nicht gefunden** weiter.

### 4. Die Priorität erhöhen [#4-de-prioriteit-verhogen]

1. Füge einen Schritt **Aufgabenpriorität festlegen** hinzu, gib ihm den Namen *Priorität erhöhen* und verbinde den Ausgang **Gefunden** damit
2. Lass **Aufgabe** auf `{foundTask.id}` stehen
3. Lass **Änderung** auf **Eine Stufe höher** und **Erhöhen bis** auf **Hoch** stehen

### 5. Prüfen, wer die Belegung beendet hat [#5-nagaan-wie-de-bezetting-stopzette]

1. Füge einen Schritt **Wenn / sonst** hinzu, verbinde den Ausgang **Nicht gefunden** von *Offene Kontrollaufgabe?* damit und gib ihm den Namen *Von einem Kollegen beendet?*
2. Klicke auf **Bedingung hinzufügen** und wähle bei **Variable** `triggeredBy.id`
3. Wähle den Vergleich **ist nicht leer**

`{triggeredBy.id}` ist leer, wenn das System die Belegung beendet hat, zum Beispiel eine geplante Aufgabe. Dann geht der Ablauf über **Nein**.

### 6. Die Aufgabe erstellen [#6-de-taak-aanmaken]

Füge einen Schritt **Aufgabe erstellen** hinzu, gib ihm den Namen *Kontrollaufgabe erstellen* und verbinde den Ausgang **Ja** damit. Fülle die Felder so aus:

| Feld | Wert |
|---|---|
| **Titel** | `Nalopen {occupation.terrain.name}` |
| **Beschreibung** | `Automatisch gegenereerd.`, eine leere Zeile und `Bezetting stopgezet door @{triggeredBy.name}({triggeredBy.id})` |
| **Priorität** | **Niedrig** |
| **Fällig nach** | 7 Tage |
| **Auch der Person zuweisen, die das Ereignis ausgelöst hat** | An |
| **Mit Datensätzen verknüpfen** | An |
| **Unteraufgaben** | Fünf Zeilen: *Kuisen*, *Inboedel*, *Internet + TV*, *Kader QR code*, *Controleren op werkjes* |

Mit `@{triggeredBy.name}({triggeredBy.id})` wird der Kollege in der Beschreibung erwähnt. Willst du, dass die Aufgabe auf ein Board kommt, wähle bei **Zum Board hinzufügen** ein Board und bei **Spalte** eine Spalte. Wer die Aufgabe immer bekommen soll, wählst du bei **Zuweisen an**.

Lass den Titel gleich dem in *Offene Kontrollaufgabe?*. Sonst findet der Suchschritt die Aufgabe beim nächsten Mal nicht wieder.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Schritt Kontrollaufgabe erstellen mit den Einstellungen im Bereich" />

### 7. Die Aufgabe für das System [#7-de-taak-voor-het-systeem]

1. Klicke auf den Schritt *Kontrollaufgabe erstellen* und dann auf **Schritt duplizieren**
2. Gib der Kopie den Namen *Kontrollaufgabe erstellen (System)* und verbinde den Ausgang **Nein** damit
3. Setze die **Beschreibung** nur auf `Automatisch gegenereerd.`

### 8. Testen und einschalten [#8-testen-en-inschakelen]

1. Prüfe, dass oben im Bereich keine Schaltfläche mit Problemen (wie **1 Problem**) steht
2. Öffne den Tab **Testlauf** und klicke auf **Test ausführen**. Du siehst, welchen Weg der Ablauf nimmt und welchen Titel und welche Beschreibung die Aufgabe bekäme. Es wird nichts erstellt
3. Schalte den Schalter **Aktiv** ein

## Warum zwei Schritte statt einem [#waarom-twee-stappen-in-plaats-van-één]

Du kannst die Schritte **Aufgabe suchen** und **Aufgabenpriorität festlegen** auch einzeln nutzen. Willst du zum Beispiel nichts tun, wenn die Aufgabe schon existiert, verbinde einfach nichts mit **Gefunden**. Willst du der bestehenden Aufgabe einen Kommentar oder einen anderen Status geben, setze einen anderen Schritt hinter **Gefunden**, wie **Aufgabenstatus setzen** mit `{foundTask.id}`.

## Was in der Praxis passiert [#wat-er-in-de-praktijk-gebeurt]

| Situation | Was der Ablauf tut |
|---|---|
| Keine offene Kontrollaufgabe für diesen Stellplatz | Erstellt eine neue Aufgabe mit fünf Unteraufgaben |
| Offene Aufgabe mit Priorität **Niedrig** | Setzt sie auf **Mittel** |
| Offene Aufgabe mit Priorität **Mittel** | Setzt sie auf **Hoch** |
| Offene Aufgabe mit Priorität **Hoch** oder **Dringend** | Lässt die Priorität, wie sie ist |
| Belegung auf einem anderen Stellplatztyp | Startet nicht |

<Callout type="info" title="Wie die Aufgabe in Tillor aussieht">
Die Aufgabe steht auf den Namen von [**Workflow**](/automatiseringen/workflow-gebruiker) und ist mit dem Stellplatz und dem Kunden der Belegung verknüpft, und mit der Reservierung, wenn es eine gibt. Nicht jede Belegung hat eine Reservierung. Der Kollege, der die Belegung beendet hat, steht als zugewiesene Person bei der Aufgabe.
</Callout>


# Wer führt eine Automatisierung aus? (/de-DE/automatiseringen/workflow-gebruiker)

Eine Automatisierung arbeitet nicht unter deinem Namen. Alle Schritte werden von einem festen Benutzer deiner Organisation ausgeführt, der **Workflow** heißt.

## Was du davon merkst [#wat-je-ervan-merkt]

- Eine Aufgabe, die eine Automatisierung anlegt, steht auf den Namen **Workflow**
- Ein Kommentar, den eine Automatisierung über eine [API-Anfrage](/automatiseringen/acties/integraties#api-verzoek) hinzufügt, steht ebenfalls auf den Namen **Workflow**
- Im Editor steht im Bereich rechts, solange du keinen Schritt ausgewählt hast, der Hinweis, dass Schritte als **Workflow**-Benutzer deiner Organisation ausgeführt werden, nie als du selbst

So ist immer klar, was ein Kollege getan hat und was eine Automatisierung getan hat. Dein Name steht nie bei etwas, das du nicht selbst getan hast.

## Was **Workflow** ist [#wat-workflow-is]

- Ein Systembenutzer, kein Kollege. Du kannst dich nicht damit anmelden, und er hat kein E-Mail-Postfach
- Es gibt einen pro Organisation. Er existiert nur innerhalb deiner Organisation und kann sonst nirgends etwas tun
- Er hat alle Rechte innerhalb deiner Organisation, wie ein Administrator. Das ist auch der Grund, warum nur Administratoren Automatisierungen erstellen und ändern können
- Er ist kein Mitglied der Organisation, so wie es ein Kollege ist

<Callout type="warn" title="Eine Automatisierung kann viel">
Weil **Workflow** alles darf, kann eine Automatisierung auch alles tun, was die Tillor-API erlaubt. Eine **API-Anfrage** kann also zum Beispiel Daten ändern oder löschen. Halte deine Flows deshalb klein und teste sie gut.
</Callout>

## Was **Workflow** nicht darf [#wat-workflow-niet-mag]

Eine Automatisierung kann keine Automatisierungen anlegen, ändern, aktivieren oder löschen und kann ihre Ausführungen nicht ansehen. Eine API-Anfrage dafür wird abgelehnt. So kann ein Flow sich selbst oder einen anderen Flow nicht verändern.

## Ereignis, das von **Workflow** ausgelöst wurde [#gebeurtenis-veroorzaakt-door-workflow]

Was **Workflow** tut, löst ganz normale Ereignisse aus, zum Beispiel eine neue Aufgabe. In der Zeitleiste und in Webhooks steht dann **Workflow** als Auslöser. Solche Ereignisse starten keine Automatisierungen: Ein Flow kann sich selbst oder einen anderen Flow also nicht starten. Eine Ausführung, die mit **Auf ein Ereignis warten** wartet, läuft dagegen weiter: Das kann keinen neuen Flow starten, also auch keine Schleife. Mehr dazu steht unter [Häufige Fragen](/automatiseringen/veelgestelde-vragen#kan-een-automatisering-zichzelf-blijven-starten).

## Wen du zuweist [#wie-wijs-je-toe]

**Workflow** wird nie selbst einer Aufgabe zugewiesen und bekommt nie eine Benachrichtigung von **Kollegen benachrichtigen**. Möchtest du, dass ein Kollege die Aufgabe übernimmt, wähle bei **Zuweisen an** einen Kollegen oder setze das Häkchen bei **Auch der Person zuweisen, die das Ereignis ausgelöst hat**.


# Eine Zahlung erfassen (/de-DE/betalingsverwerking/betaling-registreren)

Eine Zahlung erfasst du auf einer gebuchten Rechnung mit offenem Saldo. Der Zahlungsbildschirm ist für alle Methoden derselbe. Nur die Felder unter **Zahlungsmethode** unterscheiden sich.

<Steps>
<Step>
### Öffne die Rechnung [#open-de-factuur]
Gehe zu <UIPath>Verwaltung > Rechnungen</UIPath> oder öffne die Rechnung über <UIPath>Kunden > Kunde > Rechnungen</UIPath>. Die Rechnung muss gebucht sein und einen offenen Saldo haben.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Gebuchte Rechnung - Zahlung vornehmen" />
</Step>
<Step>
### Klicke auf Zahlung vornehmen [#klik-op-maak-betaling]
Der Bildschirm **Neue Zahlung für** die Rechnung öffnet sich. Oben stehen der Rechnungsbetrag und der offene Betrag.
</Step>
<Step>
### Wähle die Zahlungsmethode [#kies-de-betaalmethode]
Wähle bei **Zahlungsmethode**, wie die Zahlung eingeht. Welche Optionen du siehst, hängt von der Rechnung und von den Einstellungen deiner Organisation ab.

- **Terminal** sendet die Anfrage an ein Kartenterminal. Siehe [Terminal](/betalingsverwerking/terminal).
- **Bar**, **Überweisung** und gegebenenfalls **Sonstige** erfassen Geld, das außerhalb von Tillor eingegangen ist. Siehe [Bar und Überweisung](/betalingsverwerking/contant).
- **Interne Überweisung** verschiebt Saldo auf eine andere Rechnung desselben Kunden. Siehe [Interne Überweisung](/betalingsverwerking/interne-overboeking).
- **SEPA-Mandat** zieht den Betrag mit einem aktiven Mandat des Kunden ein. Siehe [Eine Rechnung einziehen](/betalingsverwerking/incasso).
</Step>
<Step>
### Gib den Betrag ein [#vul-het-bedrag-in]
**Betrag** steht standardmäßig auf dem offenen Betrag. Mit den Schaltflächen 25%, 50%, 75% und 100% trägst du schnell einen Teil ein, oder du tippst selbst einen Betrag. Der Betrag darf nicht höher sein als der offene Betrag.
</Step>
<Step>
### Führe die Zahlung aus [#voer-de-betaling-uit]
Klicke auf **Zahlung ausführen**.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

Der offene Betrag und der Zahlungsstatus der Rechnung werden aktualisiert. Die Zahlung steht auf der Rechnung unter **Zahlungen** und unter <UIPath>Verwaltung > Zahlungen</UIPath>. Wie du sie wiederfindest, steht unter [Zahlungen wiederfinden](/betalingsverwerking/betalingen-bekijken).

Möchte der Kunde lieber selbst bezahlen? Dann sende die Rechnung mit **Benachrichtigung senden**. Siehe [Online bezahlen](/betalingsverwerking/online).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe keine Schaltfläche Zahlung vornehmen">
Die Schaltfläche steht nur auf einer gebuchten Rechnung mit offenem Saldo. Einen Rechnungsentwurf buchst du zuerst. Eine vollständig bezahlte Rechnung hat keine Schaltfläche mehr.
</Accordion>
<Accordion title="SEPA-Mandat ist ausgegraut">
Der Kunde hat kein aktives Mandat, dessen Höchstbetrag für diesen Betrag hoch genug ist. Bei einer Gutschrift steht die Methode nicht in der Liste. Siehe [Eine Rechnung einziehen](/betalingsverwerking/incasso).
</Accordion>
<Accordion title="Die Methode Terminal fehlt">
Terminal steht nur in der Liste, wenn Mollie verbunden ist und deine Organisation Kartenzahlungen empfangen kann. Siehe [Terminal](/betalingsverwerking/terminal).
</Accordion>
</Accordions>


# Zahlungen wiederfinden (/de-DE/betalingsverwerking/betalingen-bekijken)

Du siehst Zahlungen an drei Stellen: auf der Rechnung selbst, in der Übersicht aller Zahlungen und im Detailbildschirm einer Zahlung.

## Zahlungen einer Rechnung ansehen [#betalingen-van-een-factuur-bekijken]

Öffne die Rechnung und scrolle zu **Zahlungen**. Du siehst nur die Zahlungen, die an dieser Rechnung hängen.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Zahlungen auf der Rechnung" />

## Alle Zahlungen durchsuchen [#alle-betalingen-doorzoeken]

Gehe zu <UIPath>Verwaltung > Zahlungen</UIPath>. Filtere nach Datum, Zahlungsmethode, Status oder Kunde, oder suche nach Kundenname oder Rechnungsnummer.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Zahlungsübersicht - Alle Zahlungen" />

Über das Aktionsmenü (drei Punkte) bei einer Zahlung kannst du je nach Zahlung Folgendes tun:

| Aktion | Was sie bewirkt |
|---|---|
| **Details** | Öffnet den Detailbildschirm |
| **Zahlungs-PDF** | Erstellt einen Zahlungsbeleg |
| **Synchronisieren** | Ruft den aktuellen Status bei Mollie ab. Nur bei Mollie-Zahlungen, die bei Mollie bereits existieren |
| **Verzögerung überspringen** | Sendet einen geplanten Einzug jetzt an die Bank. Siehe [Eine Rechnung einziehen](/betalingsverwerking/incasso) |
| **Rechnungszuordnung aufheben** | Nimmt die Zahlung von der Rechnung weg |
| **Abbrechen** | Bricht eine Zahlung ab, die noch nicht abgeschlossen ist |
| **Entfernen** | Entfernt die Zahlung |

## Die Details einer Zahlung lesen [#de-details-van-een-betaling-lezen]

Klicke auf **Details** für den Bildschirm **Zahlungsdetails**. Du siehst dort den Betrag, den Status, die Methode, die Rechnung und eine Zeitleiste.

- **Fälligkeitsdatum** steht bei einem laufenden SEPA-Einzug. Der Status zeigt dann <Status tone="warning">Erwartet</Status> mit diesem Datum.
- **Senden nach** steht bei einem Einzug, den Tillor noch nicht an die Bank gesendet hat.
- **Zahlungsbericht** zeigt den Bericht, in dem die Zahlung landet. Solange die Zahlung noch in keinem Bericht ist, steht dort die Berichtsnummer mit **(erwartet)** dahinter. Bei einer Mollie-Zahlung steht dort **Bei der nächsten Mollie-Auszahlung**, weil der Bericht erst bei der Auszahlung bekannt ist.

Mehr zu Berichten steht unter [Zahlungsberichte](/boekhouden/betalingsrapporten).

## Statuslabels [#statuslabels]

| Status | Bedeutung |
|---|---|
| <Status tone="warning">In Bearbeitung</Status> | Die Zahlung läuft noch |
| <Status tone="info">Autorisiert</Status> | Genehmigt, noch nicht abgeschlossen |
| <Status tone="success">Bezahlt</Status> | Abgeschlossen |
| <Status tone="error">Fehlgeschlagen</Status> | Nicht gelungen |
| <Status>Abgebrochen</Status> | Abgebrochen, bevor sie fertig war |
| <Status>Abgelaufen</Status> | Die Zahlungssitzung ist abgelaufen |
| <Status>Erstattet</Status> und <Status>Teilweise erstattet</Status> | Der Betrag wurde ganz oder teilweise zurückgegeben |
| <Status tone="error">Zurückgebucht</Status> | Die Bank oder der Kartenherausgeber hat den Betrag zurückgeholt |

## Offene Beträge nachverfolgen [#openstaande-bedragen-opvolgen]

Gehe zu <UIPath>Verwaltung > Rechnungen</UIPath>. Die Karte **Rechnungen mit offenem Saldo** zeigt gebuchte Rechnungen, die noch nicht vollständig bezahlt sind. In den Tabellen filterst du nach dem Zahlungsstatus **Offen** und sortierst nach Fälligkeitsdatum.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Rechnungen mit offenem Saldo" />

### Eine Mahnung senden [#een-aanmaning-versturen]

Eine Mahnung sendest du pro Rechnung, nicht gesammelt.

<Steps>
<Step>
### Öffne die Rechnung [#open-de-factuur]
Wähle eine Rechnung, die noch offen ist.
</Step>
<Step>
### Sende die Mahnung [#verstuur-de-aanmaning]
Klicke auf **Benachrichtigung senden** und wähle **Erinnerung senden**. Bestätige den Versand.
</Step>
</Steps>

Der Kunde erhält eine Erinnerung mit einem Link zum Online-Bezahlen. Siehe [Online bezahlen](/betalingsverwerking/online).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Status stimmt nicht mit Mollie überein">
Nutze **Synchronisieren** im Aktionsmenü der Zahlung. Tillor ruft dann die aktuellen Daten ab. Das hilft vor allem, wenn eine Meldung von Mollie verpasst wurde.
</Accordion>
<Accordion title="Ich sehe Synchronisieren nicht">
Die Aktion steht nur bei Mollie-Zahlungen, die bereits eine Transaktion bei Mollie haben. Bei einem Einzug, den Tillor noch nicht gesendet hat, gibt es nichts abzurufen.
</Accordion>
</Accordions>


# Bar und Überweisung erfassen (/de-DE/betalingsverwerking/contant)

Mit **Bar**, **Überweisung** und gegebenenfalls **Sonstige** hältst du fest, dass ein Kunde außerhalb von Tillor bezahlt hat. Tillor sendet dann nichts. Es aktualisiert den offenen Saldo der Rechnung.

- **Bar**: Der Kunde zahlt in bar an der Rezeption.
- **Überweisung**: Du hast eine Banküberweisung erhalten, die nicht automatisch der Rechnung zugeordnet wurde.
- **Sonstige**: für andere Zahlungen mit eigener Beschreibung, etwa einen Scheck oder einen Tausch. Die Methode steht nur da, wenn deine Organisation sie aktiviert hat.

## Eine Zahlung erfassen [#een-betaling-registreren]

<Steps>
<Step>
### Öffne den Zahlungsbildschirm [#open-het-betaalscherm]
Öffne eine gebuchte Rechnung mit offenem Saldo und klicke auf **Zahlung vornehmen**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Zahlungsdialog - Bar" />
</Step>
<Step>
### Wähle die Methode [#kies-de-methode]
Wähle bei **Zahlungsmethode** die Option **Bar** oder **Überweisung**.
</Step>
<Step>
### Gib den Betrag ein [#vul-het-bedrag-in]
Tippe einen Betrag oder nutze die Schaltflächen 25%, 50%, 75% und 100%.
</Step>
<Step>
### Prüfe das Eingangsdatum [#controleer-de-datum-van-ontvangst]
**Eingangsdatum** steht standardmäßig auf heute. Passe es an, wenn das Geld an einem anderen Tag eingegangen ist.
</Step>
<Step>
### Füge bei Bedarf einen Hinweis hinzu [#voeg-eventueel-een-opmerking-toe]
Bei **Hinweis** kannst du eine Referenznummer oder Notiz eintragen. Bei **Sonstige** ist eine Beschreibung Pflicht.
</Step>
<Step>
### Führe die Zahlung aus [#voer-de-betaling-uit]
Klicke auf **Zahlung ausführen**.
</Step>
</Steps>

<Callout type="idea" title="Eingangsdatum">
Das Datum bestimmt, in welchem Zahlungsbericht die Zahlung landet. Erfasst du heute eine Zahlung von gestern, setze das Datum auf gestern, damit der richtige Bericht ergänzt wird.
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

Die Zahlung steht sofort auf der Rechnung und unter <UIPath>Verwaltung > Zahlungen</UIPath>. Siehe [Zahlungen wiederfinden](/betalingsverwerking/betalingen-bekijken).

Bei **Überweisung** kannst du dem Kunden auch eine E-Mail senden lassen, die ihm rät, bei künftigen Überweisungen die strukturierte Mitteilung zu verwenden. Das Häkchen **Erinnerung zur strukturierten Mitteilung senden** steht im Zahlungsbildschirm. Das Häkchen ist ausgegraut, wenn der Kunde keine E-Mail-Adresse hat.

## Einstellungen für manuelle Zahlungen [#instellingen-voor-handmatige-betalingen]

Unter <UIPath>Support > Einstellungen > Zahlungen</UIPath> findest du diese Einstellungen:

| Einstellung | Was sie bewirkt |
|---|---|
| **Zahlungsmethode "Sonstige" anzeigen** | Zeigt die Methode **Sonstige** im Zahlungsbildschirm an |
| **Höchstbetrag Bargeld** | Der höchste Barbetrag pro Zahlung, standardmäßig 2999 Euro |
| **Standard: Erinnerung bei manueller Überweisung** | Setzt das Häkchen für die Erinnerung standardmäßig |
| **Höchstbetrag Bargeld** | Höchster Betrag, den du als Barzahlung erfassen kannst, in ganzen Euro (standardmäßig 2999) |

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor lehnt meinen Barbetrag ab">
Eine Barzahlung darf nicht höher sein als der **Höchstbetrag Bargeld** unter <UIPath>Support > Einstellungen > Zahlungen</UIPath> (standardmäßig 2999 Euro). Erfasse den Betrag in Teilen oder wähle eine andere Methode.
</Accordion>
<Accordion title="Ich sehe die Methode Sonstige nicht">
Die Methode ist ausgeschaltet. Schalte **Zahlungsmethode "Sonstige" anzeigen** ein unter <UIPath>Support > Einstellungen > Zahlungen</UIPath>.
</Accordion>
<Accordion title="Ich sehe keine manuellen Methoden">
Manuelle Zahlungen sind nicht für jede Rechnung verfügbar. Der Bildschirm weist dann darauf hin.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Zahlung erfassen" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" />
</Cards>


# Zahlungsgruppen (/de-DE/betalingsverwerking/groepen)

Eine Zahlungsgruppe bündelt mehrere eingehende Zahlungen unter einem Namen, damit du sie in einem Schritt einer gebuchten Rechnung zuordnen kannst. Praktisch, wenn du erst am Ende des Tages oder einer Aktivität abgleichen möchtest.

Beispiele:

- **Eine Kassenschicht abschließen**: Alle Kartenzahlungen des Tages sind in einer Gruppe. Du ordnest sie der Tagesumsatzrechnung zu.
- **Eine Aktivität abrechnen**: Teilnehmer zahlen vorab online. Beim Buchen ordnest du die ganze Gruppe der Rechnung zu.
- **Eine Reservierung mit Anzahlung und Restbetrag**: Anzahlung und Schlusszahlung sind zusammen in einer Gruppe und werden in einem Schritt zugewiesen.

## Die Regeln [#de-regels]

- Eine Gruppe hat den Status <Status tone="info">Offen</Status> (noch nicht zugeordnet) oder <Status tone="success">Zugewiesen</Status> (bereits einer Rechnung zugeordnet).
- Eine Gruppe hat keinen eigenen Kunden. Der Kunde ergibt sich aus der Rechnung, der du die Gruppe zuordnest.
- Zahlungen in einer Gruppe verschiebst du nur gemeinsam. Eine einzelne Zahlung aus einer Gruppe kannst du nicht an eine andere Rechnung hängen.
- Du kannst eine Gruppe nur einer gebuchten Rechnung zuordnen. Rechnungsentwürfe können sich noch ändern oder verschwinden.

## Eine Gruppe einer Rechnung zuordnen [#een-groep-aan-een-factuur-koppelen]

<Steps>
<Step>
### Öffne die Zahlungsgruppen [#open-de-betalingsgroepen]
Gehe zu <UIPath>Verwaltung > Zahlungen</UIPath> und schau unter **Zahlungsgruppen**. Die Liste zeigt standardmäßig nur offene Gruppen. Passe den Filter **Status** an, um auch zugewiesene Gruppen zu sehen.

<DocScreenshot src="/screenshots/betalingen/payment-groups.png" alt="Zahlungsübersicht - Zahlungsgruppen" />
</Step>
<Step>
### Wähle Verknüpfen [#kies-koppelen]
Öffne das Aktionsmenü (drei Punkte) bei einer offenen Gruppe und wähle **Verknüpfen**.
</Step>
<Step>
### Wähle die Rechnung [#kies-de-factuur]
Wähle die gebuchte Rechnung, der die ganze Gruppe zugeordnet werden soll.
</Step>
<Step>
### Bestätige [#bevestig]
Klicke im Fenster auf **Verknüpfen**. Alle Zahlungen der Gruppe gehen in einem Schritt an diese Rechnung, und die Gruppe erhält den Status <Status tone="success">Zugewiesen</Status>.
</Step>
</Steps>

Du kannst es auch von der Rechnung aus tun. Wähle dort im Aktionsmenü **Zahlung zuweisen**, gehe zum Tab **Zahlungsgruppen** und klicke auf **Gruppe zuweisen**.

## Was passiert danach? [#wat-gebeurt-er-daarna]

Eine zugewiesene Gruppe steht im Rechnungs-PDF als eine Zeile mit der Summe der Gruppe. Die einzelnen Zahlungen klappst du in der Zahlungsübersicht der Rechnung auf. Die Gruppe selbst siehst du in den Details jeder Zahlung, die darin enthalten ist.

Enthält die Gruppe eine Mollie-Zahlung, die bei Mollie bereits existiert, steht neben **Verknüpfen** auch **Synchronisieren**. Diese Aktion ruft die aktuellen Daten aller geeigneten Zahlungen in der Gruppe gleichzeitig ab. Das hilft, wenn du beim Status unsicher bist oder eine Meldung verpasst wurde. Eine leere Gruppe kannst du mit **Entfernen** entfernen.

## Wie kommen Zahlungen in eine Gruppe? [#hoe-komen-betalingen-in-een-groep]

Dein Kassen- oder Aktivitätensystem kann beim Anlegen einer Mollie-Zahlung einen Gruppennamen mitgeben. Tillor legt dann selbst eine Gruppe an oder verwendet eine bestehende offene Gruppe und legt die Zahlung hinein. Die Felder dafür stehen unter [Mollie-Metadaten](/ontwikkelaars/mollie-metadata#ingestie-hints-voor-betalingsgroepen).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann die Gruppe nicht meiner Rechnung zuordnen">
Die Rechnung ist noch ein Entwurf. Buche sie zuerst, denn nur gebuchte Rechnungen können eine Gruppe aufnehmen.
</Accordion>
<Accordion title="Ich möchte eine Zahlung aus der Gruppe auf eine andere Rechnung setzen">
Das geht für eine Zahlung, die noch in einer Gruppe ist, nicht. Arbeite auf Ebene der Gruppe.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zahlungen wiederfinden" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Mollie-Metadaten" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Eine Rechnung mit einem Mandat einziehen (/de-DE/betalingsverwerking/incasso)

Hat ein Kunde ein aktives Mandat, kann Tillor eine Rechnung von seinem Bankkonto einziehen. Du entscheidest selbst wie: Du verknüpfst das Mandat mit der Rechnung, sodass der Einzug nach dem Buchen von selbst startet, oder du startest den Einzug manuell mit **Zahlung vornehmen**.

Ein Mandat beantragst du über [Ein SEPA-Mandat unterschreiben lassen](/betalingsverwerking/mandaat). Eine Gutschrift kannst du nicht einziehen.

## Eine Rechnung automatisch einziehen lassen [#een-factuur-automatisch-laten-innen]

<Steps>
<Step>
### Öffne die Rechnung [#open-de-factuur]
Gehe zu <UIPath>Verwaltung > Rechnungen</UIPath> und öffne eine Entwurfs- oder gebuchte Rechnung des Kunden.
</Step>
<Step>
### Wähle das Mandat [#kies-het-mandaat]
Wähle bei **Lastschriftmandat** das Mandat des Kunden. Nur aktive Mandate stehen in der Liste. Wähle **Kein Mandat**, um die Verknüpfung wieder zu entfernen.

Das Feld sagt, was passiert: Tillor legt sofort eine offene Zahlung an, und die Bank wird zwei Tage nach dem Buchen belastet. Bis dahin kannst du die Zahlung abbrechen.
</Step>
<Step>
### Buche die Rechnung [#boek-de-factuur]
Nach dem Buchen steht bei der Rechnung der Hinweis **Der Einzug ist für** (Datum) **geplant**. An diesem Tag sendet Tillor den Einzug an die Bank.
</Step>
</Steps>

War die Rechnung schon gebucht, als du das Mandat verknüpft hast, gilt dieselbe Frist von zwei Tagen ab diesem Zeitpunkt. Hat Tillor den Einzug bereits an die Bank gesendet, kannst du das Mandat auf der Rechnung nicht mehr ändern.

### Der Höchstbetrag eines Mandats [#het-maximumbedrag-van-een-mandaat]

Jedes Mandat hat einen Höchstbetrag. Du siehst ihn in der Mandatsliste als **max.** mit einem Betrag. Ist eine Rechnung höher, dann:

- steht das Mandat ausgegraut in der Liste, mit dem Hinweis, dass der Höchstbetrag unter dem Rechnungsbetrag liegt;
- zeigt die Rechnung den Hinweis, dass der Rechnungsbetrag den Höchstbetrag des Mandats überschreitet;
- kann Tillor eine Rechnung mit einem solchen verknüpften Mandat nicht buchen.

Wähle dann ein Mandat mit einem höheren Höchstbetrag, oder lass den Kunden auf andere Weise bezahlen.

## Einen Einzug manuell starten [#een-incasso-handmatig-starten]

<Steps>
<Step>
### Öffne den Zahlungsbildschirm [#open-het-betaalscherm]
Öffne die gebuchte Rechnung und klicke auf **Zahlung vornehmen**.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Gebuchte Rechnung - Zahlung vornehmen" />
</Step>
<Step>
### Wähle SEPA-Mandat [#kies-sepa-mandaat]
Wähle bei **Zahlungsmethode** die Option **SEPA-Mandat**. Ist sie ausgegraut, hat der Kunde kein aktives Mandat, das den Betrag abdeckt.
</Step>
<Step>
### Wähle das Mandat und die Verzögerung [#kies-het-mandaat-en-de-vertraging]
Wähle das **Mandat**. Tillor wählt selbst das erste aktive Mandat, das den Betrag abdeckt. Bei **Verzögerung (Tage)** trägst du 0 bis 7 Tage ein. Bei 0 geht der Einzug sofort an die Bank, bei einer höheren Zahl wartet Tillor entsprechend viele Tage.
</Step>
<Step>
### Führe die Zahlung aus [#voer-de-betaling-uit]
Klicke auf **Zahlung ausführen**.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

Die Zahlung steht bei der Rechnung und unter <UIPath>Verwaltung > Zahlungen</UIPath>.

- Solange der Einzug wartet, steht in den Details **Senden nach** mit dem Datum. Wähle **Verzögerung überspringen** im Aktionsmenü, um ihn jetzt an die Bank zu senden, oder **Abbrechen**, um ihn zu stoppen.
- Nach dem Senden hat die Zahlung den Status <Status tone="warning">In Bearbeitung</Status> mit dem **Fälligkeitsdatum**. Ein SEPA-Einzug dauert einige Tage. Danach wird sie <Status tone="success">Bezahlt</Status>, oder <Status tone="error">Fehlgeschlagen</Status>, wenn die Bank den Einzug ablehnt.
- Ein laufender Einzug zählt in der Buchhaltung schon als Zahlung in Bearbeitung. Schlägt er fehl oder brichst du ihn ab, verschwindet er wieder aus dem Entwurf. Siehe [Zahlungsberichte](/boekhouden/betalingsrapporten).
- Der Kunde sieht auf der Zahlungsseite **Wird per Lastschrift eingezogen** mit dem Betrag und dem Datum, aber keine Zahlungsschaltflächen. So zahlt niemand doppelt. Das Rechnungs-PDF und die Rechnungs-E-Mail nennen den Betrag und das Einzugsdatum.

Die kleine erste Zahlung, mit der ein Kunde sein Mandat bestätigt hat, zieht Tillor von der nächsten Rechnung ab.

## Nebenkostenrechnungen automatisch einziehen [#nutsfacturen-automatisch-innen]

Verbrauchsrechnungen für Wasser, Strom und Gas kannst du automatisch mit dem Mandat des Kunden einziehen lassen.

- Setzt der Kunde beim Unterschreiben das Häkchen bei **Dieses Mandat auch für die automatische Zahlung meiner Nebenkosten (Wasser, Strom, Gas) verwenden**, stellt Tillor dieses Mandat ein, sobald es aktiv ist. Das Häkchen ist standardmäßig gesetzt.
- Du kannst das Mandat auch selbst wählen unter <UIPath>Kunden > Kunde > Rechnungen</UIPath>, in der Karte **Rechnungseinstellungen**, bei **Mandat**.
- In der Mandatsliste ist das Mandat für Versorgungsleistungen mit **Nebenkosten** gekennzeichnet.

Eine neue Verbrauchsrechnung erhält dieses Mandat dann von selbst als **Lastschriftmandat**.

## Probleme? [#problemen]

<Accordions>
<Accordion title="SEPA-Mandat ist bei Zahlung vornehmen ausgegraut">
Der Kunde hat kein Mandat mit dem Status <Status tone="success">Aktiv</Status>, dessen Höchstbetrag hoch genug ist. Prüfe die Karte **Mandate** unter <UIPath>Kunden > Kunde > Rechnungen</UIPath>.
</Accordion>
<Accordion title="Ich kann die Rechnung nicht buchen">
Das verknüpfte Mandat hat einen niedrigeren Höchstbetrag als der Rechnungsbetrag. Wähle ein anderes Mandat oder entferne das Mandat von der Rechnung.
</Accordion>
<Accordion title="Ich kann das Mandat auf der Rechnung nicht mehr ändern">
Tillor hat den Einzug bereits an die Bank gesendet. Verfolge die Zahlung unter <UIPath>Verwaltung > Zahlungen</UIPath>.
</Accordion>
<Accordion title="Der Einzug ist fehlgeschlagen">
Öffne die Zahlung für den Grund. Die Rechnung ist wieder offen. Wähle **Zahlung vornehmen** für einen neuen Einzug oder eine andere Methode, oder sende dem Kunden einen Zahlungslink mit **Benachrichtigung senden**.
</Accordion>
<Accordion title="Ich möchte den Einzug noch aufhalten">
Solange die Zahlung unter <UIPath>Verwaltung > Zahlungen</UIPath> noch **Senden nach** zeigt, kannst du sie abbrechen. Ist sie schon gesendet, geht das nicht mehr. Du kannst aber das Mandat für die folgenden Rechnungen widerrufen, siehe [Ein Mandat widerrufen](/betalingsverwerking/mandaat-beheren).
</Accordion>
</Accordions>

Automatisierungen können ebenfalls einziehen: der Schritt [Per Lastschrift einziehen](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Ein SEPA-Mandat unterschreiben lassen" href="/betalingsverwerking/mandaat" />
  <Card title="Ein Mandat widerrufen oder erneut senden" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Zahlungen wiederfinden" href="/betalingsverwerking/betalingen-bekijken" />
</Cards>


# Übersicht (/de-DE/betalingsverwerking)

Eine Zahlung in Tillor hängt meist an einer gebuchten Rechnung. Der Kunde kann selbst online bezahlen, du kannst eine Zahlung an der Rezeption erfassen, oder Tillor zieht den Betrag automatisch über ein SEPA-Mandat ein. Auf dieser Seite siehst du, welche Methode wofür dient.

<Callout type="info" title="Gut zu wissen">
- Eine Zahlung hängt an einer gebuchten Rechnung. Auf einen Entwurf kannst du nicht zahlen.
- Eine Barzahlung darf standardmäßig höchstens 2999 Euro betragen. Das passt du mit **Höchstbetrag Bargeld** unter <UIPath>Support > Einstellungen > Zahlungen</UIPath> an.
- Ab 2500 Euro warnt die Zahlungsseite den Kunden, dass die Bank oder Karte die Online-Zahlung ablehnen kann. Der Kunde erhält dann die IBAN und die strukturierte Mitteilung für eine Überweisung.
- Ein Einzug mit einem Mandat geht zwei Tage nach dem Buchen an die Bank. Bei **Zahlung vornehmen** wählst du selbst eine Verzögerung von 0 bis 7 Tagen. Bis der Einzug abgeht, kannst du ihn abbrechen.
- Ist eine Rechnung höher als der Höchstbetrag des Mandats, kannst du nicht einziehen. Steht dieses Mandat auf der Rechnung, kannst du die Rechnung auch nicht buchen.
- Der Unterschriftslink eines Mandats gilt 14 Tage. Tillor erinnert den Kunden nach 7 Tagen, 2 Tage vor dem Ablauf und am letzten Tag.
- Eine interne Überweisung ist nur zwischen zwei gebuchten Rechnungen desselben Kunden möglich.
- Tillor kann einem Kunden kein Geld zurückzahlen. Eine Rückzahlung regelst du außerhalb von Tillor, zum Beispiel mit einer Banküberweisung.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Jede Methode endet an derselben Stelle: einer Zahlung auf der Rechnung. Danach läuft sie weiter zum Zahlungsbericht und in deine Buchhaltung.

```mermaid
flowchart LR
  F[Gebuchte Rechnung] --> M{Zahlungsmethode}
  M -- Online --> P[Zahlung]
  M -- Terminal --> P
  M -- Bar oder Überweisung --> P
  M -- SEPA-Einzug --> P
  M -- Interne Überweisung --> P
  P -- Status und Saldo --> F
  P -- Pro Tag --> R[Zahlungsbericht]
  R --> B[Buchhaltung]
```

Ein Einzug bleibt zuerst <Status tone="warning">In Bearbeitung</Status>. Die Rechnung steht dann bereits als bezahlt (in Bearbeitung). Schlägt der Einzug fehl, ist die Rechnung wieder offen. Zahlungsberichte und die Verbindung mit Buchhaltungssoftware stehen unter [Buchhaltung](/boekhouden).

## Welche Methode wählst du? [#welke-methode-kies-je]

| Methode | Wann | Wie zahlt der Kunde | Was bucht Tillor |
|---|---|---|---|
| [Online bezahlen](/betalingsverwerking/online) | Der Kunde zahlt selbst, zu Hause oder unterwegs | Über den Link in der Rechnungs-E-Mail oder -SMS, mit iDEAL, Bancontact, Kreditkarte oder einer anderen Methode | Die Zahlung, sobald der Zahlungspartner sie bestätigt, auch wenn der Kunde nichts mehr tut |
| [Terminal](/betalingsverwerking/terminal) | Der Kunde steht an der Rezeption | Mit Karte oder Handy an einem Mollie-Kartenterminal | Die Zahlung, sobald das Terminal sie abschließt |
| [Bar und Überweisung](/betalingsverwerking/contant) | Geld, das außerhalb von Tillor eingegangen ist | Bargeld an der Rezeption oder eine Banküberweisung | Die Zahlung, die du erfasst, mit dem Eingangsdatum |
| [SEPA-Mandat](/betalingsverwerking/incasso) | Wiederkehrende oder große Rechnungen, Verbrauch | Gar nicht. Tillor zieht den Betrag vom Bankkonto ein | Eine Zahlung in Bearbeitung, bis die Bank den Einzug bestätigt |
| [Interne Überweisung](/betalingsverwerking/interne-overboeking) | Saldo zwischen zwei Rechnungen desselben Kunden verschieben | Gar nicht. Es geht kein Geld ein | Zwei verknüpfte Zahlungen, eine positive und eine negative |

Online-Zahlungen, Kartenzahlungen und Einzüge laufen über Mollie. Barzahlungen und Überweisungen erfasst du selbst.

<Cards>
  <Card title="Eine Zahlung erfassen" href="/betalingsverwerking/betaling-registreren" icon={<ReceiptTextIcon />} description="Der Zahlungsbildschirm auf einer gebuchten Rechnung" />
  <Card title="Zahlungen wiederfinden" href="/betalingsverwerking/betalingen-bekijken" icon={<SearchIcon />} description="Pro Rechnung, in der Übersicht und in den Details" />
  <Card title="Online bezahlen" href="/betalingsverwerking/online" icon={<GlobeIcon />} description="Die Zahlungsseite, die der Kunde sieht" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" icon={<MonitorSmartphoneIcon />} description="Kartenzahlungen an der Rezeption" />
  <Card title="Bar und Überweisung" href="/betalingsverwerking/contant" icon={<BanknoteIcon />} description="Zahlungen außerhalb von Tillor erfassen" />
  <Card title="Interne Überweisung" href="/betalingsverwerking/interne-overboeking" icon={<ArrowLeftRightIcon />} description="Saldo zwischen Rechnungen verschieben" />
  <Card title="Ein SEPA-Mandat unterschreiben lassen" href="/betalingsverwerking/mandaat" icon={<FileSignatureIcon />} description="Aus der Ferne oder an der Rezeption" />
  <Card title="Eine Rechnung einziehen" href="/betalingsverwerking/incasso" icon={<LandmarkIcon />} description="Automatisch einziehen mit einem Mandat" />
  <Card title="Zahlungsgruppen" href="/betalingsverwerking/groepen" icon={<LayersIcon />} description="Zahlungen bündeln und in einem Schritt zuordnen" />
  <Card title="Praxisbeispiele" href="/praktijk" icon={<ReceiptTextIcon />} description="Ausgearbeitete Beispiele aus der Praxis" />
</Cards>

## Begriffe [#begrippen]

- **Zahlung**: ein eingegangener oder laufender Betrag, mit einer Methode, einem Status und meist einer Rechnung.
- **Mandat**: die Zustimmung eines Kunden, Rechnungen von seinem Bankkonto einzuziehen. Siehe [SEPA-Mandat](/betalingsverwerking/mandaat).
- **Zahlungsgruppe**: ein Bündel von Zahlungen, das du später in einem Schritt an eine Rechnung hängst. Siehe [Zahlungsgruppen](/betalingsverwerking/groepen).
- **Zahlungsbericht**: die Tagesübersicht eingegangener Zahlungen für die Buchhaltung. Siehe [Zahlungsberichte](/boekhouden/betalingsrapporten).
- **Interne Überweisung**: Saldo zwischen zwei Rechnungen desselben Kunden verschieben, ohne dass Geld eingeht.
- **Einzug**: Tillor holt den Betrag vom Bankkonto des Kunden, mit seinem Mandat.
- **Kunde**: der Kunde, dem die Rechnung gehört. Siehe [Kunde](/begrippen#klant).


# Eine interne Überweisung erstellen (/de-DE/betalingsverwerking/interne-overboeking)

Mit **Interne Überweisung** verschiebst du einen Betrag von einer gebuchten Rechnung auf eine andere gebuchte Rechnung desselben Kunden. Es geht kein Geld ein. Tillor legt eine positive Zahlung auf der Rechnung an, die du ausbuchst, und eine verknüpfte negative Zahlung auf der Zielrechnung.

Das ist keine Barzahlung, keine Kartenzahlung und keine Überweisung. Diese Methoden stehen separat im Zahlungsbildschirm.

## Eine interne Überweisung erfassen [#een-interne-overboeking-registreren]

<Steps>
<Step>
### Öffne den Zahlungsbildschirm [#open-het-betaalscherm]
Öffne die gebuchte Rechnung mit offenem Saldo und klicke auf **Zahlung vornehmen**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-internal-transfer.png" alt="Zahlungsdialog - Interne Überweisung mit geöffnetem Dropdown der Zielrechnung" />
</Step>
<Step>
### Wähle Interne Überweisung [#kies-interne-overboeking]
Wähle bei **Zahlungsmethode** die Option **Interne Überweisung**.
</Step>
<Step>
### Wähle die Zielrechnung [#kies-de-doelfactuur]
Wähle bei **Zielrechnung** die gebuchte Rechnung, auf die der Betrag geht. Die Liste zeigt nur gebuchte Rechnungen desselben Kunden.
</Step>
<Step>
### Gib den Betrag ein [#vul-het-bedrag-in]
Tippe einen Betrag oder nutze die Schaltflächen 25%, 50%, 75% und 100%.
</Step>
<Step>
### Führe die Zahlung aus [#voer-de-betaling-uit]
Trage bei Bedarf das **Eingangsdatum** ein und klicke auf **Zahlung ausführen**.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Tillor legt zwei verknüpfte Zahlungen an, **Interne Überweisung von** und **Interne Überweisung an**, jeweils mit der Rechnungsnummer der anderen Rechnung.
- Der offene Saldo beider Rechnungen wird aktualisiert.
- Entfernst du eine der beiden Zahlungen, entfernt Tillor die andere ebenfalls.

## Interne Überweisung und Buchhaltung [#interne-overboeking-en-boekhouding]

- Eine interne Überweisung steht im Zahlungsbericht des Tages, an dem du sie erfasst. Erfasst du sie heute, steht sie sofort im [Entwurfsbericht](/boekhouden/betalingsrapporten#concept-en-definitief) von heute.
- Sie geht zusammen mit den Mollie-Zahlungen in den Buchhaltungsexport.
- Barzahlungen, Überweisungen und Bankkonten gehen nicht in den Buchhaltungsexport.

## Nach dem Stornieren einer Rechnung mit Belegung verlängern [#na-het-omkeren-van-een-factuur-met-bezetting-verlengen]

Mit **Rechnung stornieren** machst du aus einer Rechnung eine Gutschrift. Eine interne Überweisung zwischen diesen beiden Rechnungen ist nur eine Verrechnung in der Buchhaltung. Sie verlängert oder verkürzt die Belegung nicht noch einmal.

Was das für **Bezahlt bis** bedeutet:

- Auf der ursprünglichen Rechnung ändert sich **Bezahlt bis** nicht.
- Auf der Gutschrift wird **Bezahlt bis** nur zurückgesetzt, wenn die ursprüngliche Rechnung bereits mit einer echten Zahlung bezahlt war, etwa bar, per Überweisung oder über Mollie. Wurde sie nur mit einer internen Überweisung verrechnet, bleibt **Bezahlt bis** gleich.
- **Fakturiert bis** wurde schon beim Buchen angepasst.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Zielrechnung steht nicht in der Liste">
Es erscheinen nur gebuchte Rechnungen desselben Kunden. Buche einen Rechnungsentwurf zuerst und wähle nicht dieselbe Rechnung, auf der du die Zahlung erstellst.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Zahlung erfassen" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Bankkonten" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Ein Mandat widerrufen oder erneut senden (/de-DE/betalingsverwerking/mandaat-beheren)

Alle Aktionen für ein Mandat stehen im Menü (drei Punkte) hinter der Zeile in der Karte **Mandate**. Du findest diese Karte unter <UIPath>Kunden > Kunde > Rechnungen</UIPath>. Welche Aktionen du siehst, hängt vom Status ab.

| Status | Aktionen im Menü |
|---|---|
| <Status tone="info">Wartet auf Unterschrift</Status> | **Auf dem iPad anzeigen**, **Erinnerung senden**, **Signaturlink erneut senden**, **Anfrage abbrechen** |
| <Status>Link abgelaufen</Status> | **Signaturlink erneut senden**, **Anfrage abbrechen** |
| <Status tone="error">Aktivierung fehlgeschlagen</Status> | **Anfrage abbrechen** |
| <Status tone="success">Aktiv</Status> | **Unterschriebenes Mandat öffnen**, **Mandat widerrufen** |
| <Status>Widerrufen</Status> | **Unterschriebenes Mandat öffnen** |

**Auf dem iPad anzeigen** steht nur da, wenn die Tillor-App auf einem Gerät deiner Organisation online ist.

## Eine offene Anfrage erneut senden [#een-openstaande-aanvraag-opnieuw-versturen]

<Steps>
<Step>
### Öffne das Menü bei der Anfrage [#open-het-menu-bij-de-aanvraag]
Suche die Anfrage mit dem Status <Status tone="info">Wartet auf Unterschrift</Status> oder <Status>Link abgelaufen</Status>.
</Step>
<Step>
### Wähle die Aktion [#kies-de-actie]
- **Erinnerung senden** mailt dem Kunden erneut, mit einem neuen Link. Das Enddatum ändert sich nicht.
- **Signaturlink erneut senden** mailt einen neuen Link, der wieder 14 Tage gilt.

Ein früher gesendeter Link funktioniert nach beiden Aktionen nicht mehr.
</Step>
</Steps>

Tillor meldet **Erinnerung gesendet** oder **Signaturlink erneut gesendet**. Der Kunde erhält eine E-Mail. Wie die automatischen Erinnerungen funktionieren, steht unter [Ein SEPA-Mandat unterschreiben lassen](/betalingsverwerking/mandaat#herinneringen-voor-het-tekenen).

## Eine Anfrage abbrechen [#een-aanvraag-annuleren]

Wähle **Anfrage abbrechen**, wenn der Kunde nicht mehr unterschreiben muss. Die Anfrage erhält den Status <Status>Abgebrochen</Status>. Steht sie auf dem Tablet, verschwindet sie dort. Danach kannst du eine neue Anfrage starten.

## Ein aktives Mandat widerrufen [#een-actief-mandaat-intrekken]

Widerrufe ein Mandat, wenn beim Kunden nicht mehr eingezogen werden darf, zum Beispiel bei einem Umzug, einem gekündigten Vertrag oder auf Wunsch des Kunden.

<Callout type="warn" title="Ein Widerruf lässt sich nicht rückgängig machen">
Für die automatische Zahlung ist danach ein neues Mandat nötig, mit einer neuen Unterschrift des Kunden.
</Callout>

<Steps>
<Step>
### Wähle Mandat widerrufen [#kies-mandaat-intrekken]
Öffne das Menü beim aktiven Mandat und wähle **Mandat widerrufen**.
</Step>
<Step>
### Bestätige [#bevestig]
Im Bildschirm **Dieses Mandat widerrufen?** klickst du auf **Widerrufen**. Tillor meldet **Mandat widerrufen**.
</Step>
</Steps>

Was danach passiert:

- Über dieses Mandat werden keine Rechnungen mehr eingezogen. Einzüge, die Tillor noch nicht an die Bank gesendet hatte, werden abgebrochen.
- Der Status des Mandats wird <Status>Widerrufen</Status>.
- Das unterschriebene Dokument bleibt als Nachweis erhalten, wandert aber ins Archiv. Bei den Dokumenten des Kunden findest du es unter **Archiviert**, sodass die Liste nur Mandate zeigt, die noch gelten.
- Der Kunde erhält eine E-Mail, dass das Mandat widerrufen wurde, mit einer Kopie des unterschriebenen Dokuments.

Mandate, die außerhalb von Tillor eingerichtet wurden, zeigen im Menü nur **Mandat widerrufen**.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe Mandat widerrufen nicht">
Die Aktion steht nur bei einem Mandat mit dem Status <Status tone="success">Aktiv</Status>. Eine Anfrage, die noch nicht unterschrieben ist, brichst du mit **Anfrage abbrechen** ab.
</Accordion>
<Accordion title="Ein Einzug war schon unterwegs zur Bank">
Ein Widerruf bricht nur Einzüge ab, die Tillor noch nicht an die Bank gesendet hatte. Einen Einzug, der schon unterwegs ist, verfolgst du unter <UIPath>Verwaltung > Zahlungen</UIPath>.
</Accordion>
<Accordion title="Ich möchte für eine Rechnung ein anderes Mandat verwenden">
Wähle das Mandat bei **Lastschriftmandat** auf der Rechnung. Siehe [Eine Rechnung einziehen](/betalingsverwerking/incasso).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Ein SEPA-Mandat unterschreiben lassen" href="/betalingsverwerking/mandaat" />
  <Card title="Eine Rechnung einziehen" href="/betalingsverwerking/incasso" />
</Cards>


# Ein SEPA-Mandat unterschreiben lassen (/de-DE/betalingsverwerking/mandaat)

Mit einem SEPA-Mandat erlaubt ein Kunde, Rechnungen automatisch von seinem Bankkonto einzuziehen. Der Kunde unterschreibt das Mandat direkt in Tillor. Tillor bewahrt das unterschriebene Dokument beim Kunden auf, und danach kannst du Rechnungen einziehen lassen. Das steht unter [Eine Rechnung einziehen](/betalingsverwerking/incasso).

Bevor du anfängst:

- Mandate müssen für deine Organisation aktiviert sein. Ist das nicht der Fall, meldet die Schaltfläche **Mandat erstellen**, dass du den Administrator kontaktieren musst.
- Der Kunde braucht eine E-Mail-Adresse.
- Ein Kunde kann nur eine Anfrage gleichzeitig offen haben.

## Ein Mandat anfragen [#een-mandaat-aanvragen]

<Steps>
<Step>
### Öffne den Kunden [#open-de-klant]
Gehe zu <UIPath>Kunden > Kunde > Rechnungen</UIPath>. Unten steht die Karte **Mandate** mit allen Mandaten und Anfragen des Kunden.
</Step>
<Step>
### Klicke auf Mandat erstellen [#klik-op-mandaat-aanmaken]
Es öffnet sich ein Menü mit einer oder zwei Optionen. Wähle, wie der Kunde unterschreibt.
</Step>
</Steps>

<Tabs items={["Aus der Ferne", "An der Rezeption"]}>
<Tab value="Aus der Ferne">
Wähle **Mandatseinladung senden**. Der Kunde erhält eine E-Mail mit einem Link zur Unterschriftsseite, und Tillor meldet **Mandat zur Unterschrift an** (E-Mail-Adresse des Kunden) **gesendet**.

Der Link gilt 14 Tage, bis einschließlich zum letzten Tag. Der Kunde muss keine IBAN angeben. Er wählt selbst, wie er das Mandat bestätigt.
</Tab>
<Tab value="An der Rezeption">
Wähle **Auf dem iPad an der Rezeption unterschreiben lassen**. Das Mandat erscheint auf dem Tablet an der Rezeption, und Tillor meldet **Das Mandat ist auf dem iPad, der Kunde kann unterschreiben**.

Diese Option steht nur im Menü, wenn die Tillor-App auf einem Gerät deiner Organisation online ist. Siehe [Tablets und Kioske](/mobiele-app/tablets-en-kiosken). Der Kunde unterschreibt mit dem Finger auf dem Tablet. Im unterschriebenen Dokument wird vermerkt, dass es an der Rezeption unterschrieben wurde und welcher Kollege das Tablet benutzt hat.

Ist die Anfrage schon gesendet und du möchtest sie doch auf dem Tablet zeigen? Öffne das Menü bei der Anfrage und wähle **Auf dem iPad anzeigen**.
</Tab>
</Tabs>

## Was macht der Kunde? [#wat-doet-de-klant]

Der Kunde durchläuft mehrere Bildschirme. Auf dem Tablet sind es dieselben Bildschirme, mit ein paar Unterschieden, die weiter unten stehen.

<Steps>
<Step>
### Das Mandat ansehen [#het-mandaat-bekijken]
Die Seite **Unterschreibe dein SEPA-Mandat für** deine Organisation zeigt, wer der Gläubiger ist, für wen er einzieht und um welche Art von Zahlung es sich handelt. Der Kunde tippt auf **Mandat unterschreiben**.
</Step>
<Step>
### Den Text akzeptieren [#de-tekst-accepteren]
Der Kunde liest die Zusammenfassung oder über **Vollständigen Mandatstext lesen** den ganzen Text und setzt das Häkchen, dass er einverstanden ist.

Darunter steht ein zweites Häkchen, um das Mandat auch für Nebenkostenrechnungen (Wasser, Strom, Gas) zu nutzen. Dieses Häkchen ist standardmäßig gesetzt. Siehe [Eine Rechnung einziehen](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
</Step>
<Step>
### Unterschreiben [#tekenen]
Der Kunde unterschreibt mit dem Finger oder der Maus.
</Step>
<Step>
### Die Bestätigung wählen [#de-bevestiging-kiezen]
Unter **Wie möchtest du ermächtigen?** wählt der Kunde zwischen zwei Arten der Bestätigung.

- **Eine kleine erste Zahlung** mit der eigenen Bank oder Karte, zum Beispiel über iDEAL, Bancontact, Kreditkarte oder Apple Pay. Der Betrag liegt je nach Methode zwischen 0 und 1 Euro. So bestätigt die Bank, dass das Konto dem Kunden gehört, und der Kunde muss keine IBAN abtippen. Tillor zieht den Betrag von der nächsten Rechnung ab.
- **Bankkonto (SEPA)**: Der Kunde trägt seine IBAN ein, bestätigt, dass das Konto ihm gehört, und gibt einen sechsstelligen Code ein. Dieser Code kommt per SMS auf die Telefonnummer des Kunden, oder per E-Mail, wenn keine Nummer bekannt ist.
</Step>
</Steps>

Auf dem Tablet funktioniert der IBAN-Weg genauso: Der Code geht per SMS an das Telefon des Kunden. Wählt der Kunde die erste Zahlung, zeigt das Tablet einen QR-Code, den der Kunde mit seinem Handy scannt, um zu bezahlen.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Mandat erscheint in der Liste mit dem Status <Status tone="warning">Unterschrieben, wird aktiviert</Status>, oder <Status tone="warning">Wartet auf erste Zahlung</Status>, wenn der Kunde die kleine Zahlung gewählt hat.
- Sobald das Mandat beim Zahlungspartner gültig ist, wird der Status <Status tone="success">Aktiv</Status>. Der Kunde erhält eine Kopie des unterschriebenen Mandats per E-Mail.
- Tillor bewahrt das unterschriebene Dokument bei den Dokumenten des Kunden auf. Du öffnest es über das Menü beim Mandat mit **Unterschriebenes Mandat öffnen**. Das Dokument ist versiegelt und mit einem Zeitstempel versehen, sodass eine spätere Änderung in einem PDF-Reader sichtbar ist. Siehe [Siegel und Zeitstempel](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).
- Wurde das Fenster des Kunden geschlossen, bevor die erste Zahlung fertig war, bleibt die Anfrage offen. Der Kunde kann über denselben Link erneut versuchen oder auf seine IBAN wechseln.

## Status [#statussen]

| Status | Bedeutung |
|---|---|
| <Status tone="info">Wartet auf Unterschrift</Status> | Der Kunde hat noch nicht unterschrieben |
| <Status tone="warning">Unterschrieben, wird aktiviert</Status> | Mit IBAN unterschrieben, Tillor legt das Mandat an |
| <Status tone="warning">Wartet auf erste Zahlung</Status> | Unterschrieben, die kleine Zahlung muss noch gelingen |
| <Status tone="success">Aktiv</Status> | Du kannst das Mandat für Einzüge nutzen |
| <Status tone="error">Aktivierung fehlgeschlagen</Status> | Der Zahlungspartner hat das Mandat abgelehnt. Tillor versucht es später erneut |
| <Status>Link abgelaufen</Status> | Der Kunde hat nicht innerhalb von 14 Tagen unterschrieben |
| <Status>Abgebrochen</Status> | Du hast die Anfrage abgebrochen |
| <Status>Widerrufen</Status> | Das aktive Mandat wurde widerrufen |

Mandate, die außerhalb von Tillor eingerichtet wurden, zeigen die Status <Status tone="warning">In Bearbeitung</Status>, <Status tone="success">Aktiv</Status>, <Status tone="error">Inaktiv</Status> und <Status>Abgebrochen</Status>. Nur ein aktives Mandat kannst du für Einzüge nutzen.

## Erinnerungen vor dem Unterschreiben [#herinneringen-voor-het-tekenen]

Tillor sendet dem Kunden selbst Erinnerungen per E-Mail, solange die Anfrage offen ist: wenn noch 7 Tage übrig sind, zwei Tage vor dem Ablauf und am letzten Tag. Jede Erinnerung enthält einen frischen Signaturlink.

Möchtest du den Kunden selbst anstupsen? Wähle im Menü bei der Anfrage **Erinnerung senden**. Das Enddatum bleibt dann gleich. Ist der Link abgelaufen, oder möchtest du wieder 14 Tage geben, wähle **Signaturlink erneut senden**. Mehr zu diesen Aktionen steht unter [Ein Mandat widerrufen oder erneut senden](/betalingsverwerking/mandaat-beheren).

Möchtest du, dass eine Automatisierung reagiert, wenn eine Anfrage abläuft? Dafür gibt es den Trigger **Mandatsanfrage abgelaufen**, siehe [Automatisierungen](/automatiseringen).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Schaltfläche Mandat erstellen ist ausgegraut">
Bewege den Mauszeiger über die Schaltfläche, um den Grund zu sehen. Meist hat der Kunde keine E-Mail-Adresse, oder Mandate sind für deine Organisation nicht aktiviert. Füge dem Kunden eine E-Mail-Adresse hinzu oder bitte deinen Administrator, Mandate einzuschalten.
</Accordion>
<Accordion title="Tillor sagt, dass bereits ein Mandat auf Unterschrift wartet">
Pro Kunde kann nur eine Anfrage gleichzeitig offen sein. Sende die bestehende Anfrage erneut oder brich sie ab und erstelle danach eine neue.
</Accordion>
<Accordion title="Die Option zum Unterschreiben an der Rezeption fehlt">
Die Option erscheint nur, wenn die Tillor-App auf einem Gerät deiner Organisation kürzlich Kontakt mit Tillor hatte. Öffne die App auf dem Tablet, warte kurz und versuche es erneut.
</Accordion>
<Accordion title="Der Kunde bekommt den SMS-Code nicht">
Der Code geht an die Telefonnummer im Kundenprofil. Prüfe, ob sie stimmt. Hat der Kunde keine Nummer, kommt der Code per E-Mail. Der Kunde kann einen neuen Code anfordern.
</Accordion>
<Accordion title="Der Kunde sieht, dass der Link abgelaufen ist">
Der Kunde sieht **Dieser Signaturlink ist abgelaufen**. Wähle bei der Anfrage **Signaturlink erneut senden**.
</Accordion>
<Accordion title="Der Status bleibt auf Aktivierung fehlgeschlagen">
Der Zahlungspartner hat das Mandat abgelehnt. Tillor versucht es später automatisch erneut. Gelingt es dauerhaft nicht, brich die Anfrage mit **Anfrage abbrechen** ab und bitte den Kunden, erneut zu unterschreiben, gegebenenfalls mit einer anderen Bestätigung.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Rechnung einziehen" href="/betalingsverwerking/incasso" />
  <Card title="Ein Mandat widerrufen oder erneut senden" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Zahlungsmethoden" href="/betalingsverwerking" />
</Cards>


# Einen Kunden online bezahlen lassen (/de-DE/betalingsverwerking/online)

Online bezahlen läuft über die persönliche Zahlungsseite einer Rechnung. Der Kunde öffnet die Seite, wählt eine Zahlungsmethode und schließt die Zahlung bei seiner Bank oder seinem Kartenherausgeber ab. Tillor arbeitet dafür mit [Mollie](https://www.mollie.com) zusammen, also muss Mollie verbunden sein.

Es gibt keine eigene Schaltfläche Zahlungslink senden. Du teilst die Seite mit einer Benachrichtigung oder mit der persönlichen URL der Rechnung.

Bevor du anfängst:

- Die Rechnung ist gebucht und es steht ein Betrag offen. Sonst hat der Kunde nichts zu bezahlen.
- Mollie ist verbunden. Ohne Methoden von Mollie sieht der Kunde nur eine Zahlungsschaltfläche, siehe [Probleme?](#problemen).
- Der Kunde hat eine E-Mail-Adresse oder Telefonnummer, oder du teilst den Link selbst.

## Den Zahlungslink an den Kunden senden [#de-betaallink-naar-de-klant-sturen]

<Steps>
<Step>
### Buche die Rechnung [#boek-de-factuur]
Online bezahlen ist nur auf einer gebuchten Rechnung mit offenem Saldo möglich.
</Step>
<Step>
### Sende eine Benachrichtigung [#verstuur-een-notificatie]
Klicke auf **Benachrichtigung senden** und wähle einen Kanal, etwa E-Mail oder SMS. Der Kunde erhält eine Nachricht mit der Schaltfläche **Online ansehen und bezahlen**.
</Step>
</Steps>

Lieber selbst teilen? Öffne das Aktionsmenü (drei Punkte) auf der Rechnung und wähle **Persönliche URL**. Tillor kopiert den Link in deine Zwischenablage. Eine Mahnung mit demselben Link sendest du mit **Erinnerung senden**, siehe [Zahlungen wiederfinden](/betalingsverwerking/betalingen-bekijken#een-aanmaning-versturen). Möchte der Kunde nur einen Teil bezahlen? Erstelle dann einen [Link für eine Teilzahlung](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).

## Was sieht der Kunde? [#wat-ziet-de-klant]

Der Kunde öffnet die Seite **Ihre Rechnung von** deiner Organisation. Dort stehen der zu zahlende Betrag, eine Übersicht der Rechnungspositionen und eine Schaltfläche, um die Rechnung anzusehen. Von diesem Bildschirm aus geht der Kunde in drei Schritten weiter.

<Steps>
<Step>
### Bezahlen [#betaal]
Der Kunde tippt auf die Schaltfläche **Betrag bezahlen** (mit dem Betrag). Steht dort eine Apple-Pay-Schaltfläche, kann der Kunde damit direkt bezahlen.
</Step>
<Step>
### Eine Methode wählen [#kies-een-methode]
Unter **Wie möchten Sie bezahlen?** stehen die verfügbaren Methoden, etwa iDEAL, Bancontact und Kreditkarte. Die Reihenfolge kommt von Mollie und passt sich der Sprache des Kunden an. Dabei gelten diese Regeln:

- Die Methode, die der Kunde beim letzten Mal auf diesem Gerät benutzt hat, steht mit **Zuletzt verwendet** dabei.
- Bei französischsprachigen Kunden steht Pay By Bank mit **Oft die beste Wahl** ganz oben.
- Hat eine Methode bei Mollie eine Störung, steht eine Warnung dabei, zum Beispiel dass die Methode teilweise nicht erreichbar oder in Wartung ist. Der Kunde kann die Methode trotzdem versuchen, aber die Meldung sagt, dass es möglicherweise nicht klappt. Der Text der Störung kommt von Mollie.
</Step>
<Step>
### Die Zahlung abschließen [#rond-de-betaling-af]
Was danach passiert, hängt von der Methode und vom Gerät ab. Siehe unten.
</Step>
</Steps>

### Abschließen am Computer oder Handy [#afronden-op-computer-of-telefoon]

<Tabs items={["Auf einem Computer", "Auf einem Handy"]}>
<Tab value="Auf einem Computer">
Bei iDEAL und Bancontact zeigt Tillor einen QR-Code unter **Scannen und mit iDEAL bezahlen** (bzw. der gewählten Methode). Der Kunde öffnet die Banking-App auf seinem Handy und scannt den Code. Die Seite geht von selbst weiter, sobald die Zahlung eingegangen ist. Möchte der Kunde lieber am Computer bezahlen, geht das mit **Im Browser bezahlen**.
</Tab>
<Tab value="Auf einem Handy">
Bei Bancontact zeigt Tillor die Schaltfläche **Bancontact-App öffnen**. Der Kunde schließt die Zahlung in der App ab und kommt danach zur Seite zurück. Über **Im Browser bezahlen** kann der Kunde auch auf dem Handy im Browser bezahlen.
</Tab>
</Tabs>

Bei anderen Methoden, etwa Kreditkarte, leitet Tillor den Kunden auf die Zahlungsseite des Zahlungspartners weiter und bringt ihn danach zurück. Passiert die Weiterleitung nicht von selbst, steht dort ein Link zum Fortfahren.

### Wenn es nicht klappt [#als-het-niet-lukt]

- **Andere Methode wählen** bringt den Kunden zurück zur Liste.
- **Neu beginnen** startet eine neue Zahlung mit derselben Methode. Praktisch, wenn der Kunde in der Banking-App abgebrochen hat oder nichts passiert ist.
- Bei einer fehlgeschlagenen, abgebrochenen oder abgelaufenen Zahlung meldet die Seite das Ergebnis, und der Kunde kann eine andere Methode wählen.

## Was die Seite noch zeigen kann [#wat-de-pagina-nog-meer-kan-tonen]

| Situation | Was der Kunde sieht |
|---|---|
| Die Rechnung ist bezahlt | **Vollständig bezahlt** mit dem erhaltenen Betrag und einer Bestätigung per E-Mail |
| Die Bank hat eine Überweisung gestartet | **Ihre Zahlung wird bestätigt**. Bei Pay By Bank dauert das meist einige Sekunden und höchstens ein paar Werktage |
| Ein SEPA-Einzug ist eingeplant | **Wird per Lastschrift eingezogen** mit dem Betrag und dem Datum. Der Kunde muss nichts tun. Zahlungsoptionen stehen dort nicht, damit niemand doppelt zahlt |
| Der Betrag ist höher als 2.500 Euro | Eine Warnung, dass die Bank oder Karte die Online-Zahlung wegen Limits ablehnen kann, mit der IBAN und der strukturierten Mitteilung für eine Überweisung |
| Online bezahlen ist für diese Rechnung nicht möglich | **Per Überweisung bezahlen** mit den Bankdaten |

## Was passiert danach? [#wat-gebeurt-er-daarna]

Der persönliche Link hat kein Ablaufdatum. Der Kunde kann ihn also auch später noch öffnen. Sobald Mollie die Zahlung bestätigt, erscheint sie auf der Rechnung und unter <UIPath>Verwaltung > Zahlungen</UIPath>. Die Rechnung wechselt auf <Status tone="success">Bezahlt</Status>, wenn der ganze Betrag eingegangen ist. Du musst selbst nichts erfassen. Siehe [Zahlungen wiederfinden](/betalingsverwerking/betalingen-bekijken) für die Status.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Kunde sieht keine Zahlungsmethoden">
Mollie gibt dann keine Methoden weiter. Der Kunde sieht nur die Zahlungsschaltfläche und gelangt damit direkt auf die Zahlungsseite von Mollie. Bleibt das so, prüfe die Verbindung mit Mollie.
</Accordion>
<Accordion title="Der Kunde hat bezahlt, aber die Rechnung ist noch offen">
Öffne die Zahlung über <UIPath>Verwaltung > Zahlungen</UIPath> und nutze **Synchronisieren**. Bei Pay By Bank kann die Bestätigung einige Werktage dauern.
</Accordion>
<Accordion title="Der Kunde bekommt eine Meldung über eine Störung bei einer Methode">
Mollie meldet, dass die Methode Probleme hat. Der Kunde kann eine andere Methode wählen oder es später erneut versuchen.
</Accordion>
</Accordions>

Bindest du ein eigenes System mit Mollie-Zahlungen an? Siehe [Mollie-Metadaten](/ontwikkelaars/mollie-metadata).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zahlungen wiederfinden" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="SEPA-Mandat" href="/betalingsverwerking/mandaat" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Mit einem Kartenterminal bezahlen (/de-DE/betalingsverwerking/terminal)

Mit der Zahlungsmethode **Terminal** senden Sie den offenen Betrag einer Rechnung an ein Kartenterminal an der Rezeption. Der Kunde zahlt mit Karte oder Smartphone, und Tillor bucht die Zahlung, sobald das Terminal sie abschließt.

Tillor ist exklusiver [Mollie](https://www.mollie.com) Tech Partner für Kartenzahlung. Tillor liefert die Mollie-Terminals und richtet Mollie Connect, das Gerät und die Rechnungsanbindung gemeinsam mit Ihnen ein. Fragen zur Kartenzahlung an der Rezeption landen also bei Tillor.

<Callout type="info" title="Nur Mollie-Terminals">
Tillor bindet keine Worldline-, CCV- oder andere Kartenterminals an. Haben Sie bereits ein solches Terminal, erhalten Sie von uns ein Mollie-Gerät. So bleiben Online-Zahlung, Kartenzahlung und der [Zahlungsbericht](/boekhouden/betalingsrapporten) eine durchgängige Kette.
</Callout>

## Eine Kartenzahlung starten [#een-pinbetaling-starten]

<Steps>
<Step>
### Zahlungsfenster öffnen [#open-het-betaalscherm]
Öffnen Sie eine gebuchte Rechnung mit offenem Saldo und klicken Sie auf **Zahlung vornehmen**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-terminal.png" alt="Zahlungsdialog - Zahlungsmethode Terminal ausgewählt" />
</Step>
<Step>
### Terminal wählen [#kies-terminal]
Wählen Sie bei **Zahlungsmethode** die Option **Terminal**.
</Step>
<Step>
### Das Terminal auswählen [#kies-de-terminal]
Wählen Sie das Terminal an Ihrer Rezeption. Tillor zeigt nur Terminals, die gerade verfügbar sind. Haben Sie nur eines, ist es bereits ausgewählt.
</Step>
<Step>
### Betrag eingeben [#vul-het-bedrag-in]
Geben Sie einen Betrag ein oder nutzen Sie die Schaltflächen 25 %, 50 %, 75 % und 100 %. Ein Teilbetrag ist praktisch bei einer Anzahlung oder wenn der Kunde einen Teil bar und einen Teil mit Karte bezahlt.
</Step>
<Step>
### Zahlung senden [#stuur-de-betaling]
Klicken Sie auf **Zahlung ausführen**. Das Fenster **Zahlung wird verarbeitet** erscheint, während Tillor die Anforderung an das Terminal sendet.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

Das Fenster verfolgt die Zahlung live. Der Kunde zahlt am Terminal, und das Fenster wechselt von **Zahlung in Bearbeitung** zu **Zahlung erfolgreich**. Es schließt sich nach einigen Sekunden von selbst, und der offene Saldo der Rechnung ist aktualisiert.

Solange das Terminal wartet, können Sie zwei Häkchen setzen:

- **A4 bei Zahlung drucken** stellt das Rechnungs-PDF in die Warteschlange des A4-Druckers, sobald die Zahlung gelingt. Die Option ist ausgegraut, wenn kein Connector online ist.
- **Nach Zahlung per E-Mail senden** sendet die Rechnung per E-Mail an den Kunden, sobald die Zahlung gelingt. Die Option ist ausgegraut, wenn der Kunde keine E-Mail-Adresse hat.

Schlägt die Zahlung fehl oder läuft sie ab, erhalten Sie die Meldung **Zahlung fehlgeschlagen** oder **Zahlung abgelaufen**. Klicken Sie auf **Erneut an Terminal senden**, um es noch einmal zu versuchen.

## Das Standardterminal festlegen [#de-standaardterminal-instellen]

Tillor aktiviert das Kartengerät mit Ihrem Mollie-Konto. Nach der Anbindung von Mollie wählt Tillor das Terminal selbst, wenn es genau ein aktives Terminal gibt. Ein anderes wählen Sie unter <UIPath>Einstellungen > Integrationen</UIPath> bei Mollie im Feld **Standardterminal** (neben dem **Hauptprofil**). Tillor schlägt dieses Terminal dann bei einer Kartenzahlung vor.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe Terminal nicht bei Zahlungsmethode">
Die Methode erscheint erst, wenn Mollie angebunden ist und zu Ihrem Konto ein Terminal gehört. Prüfen Sie die Anbindung unter <UIPath>Einstellungen > Integrationen</UIPath>.
</Accordion>
<Accordion title="Das Terminal fehlt in der Liste">
Tillor zeigt nur Terminals, die online und aktiv sind. Prüfen Sie, ob das Terminal eingeschaltet und verbunden ist, und versuchen Sie es erneut.
</Accordion>
<Accordion title="Es steht noch eine alte Zahlung aus">
Nach einem neuen Versuch kann eine alte Zahlung mit dem Status <Status tone="warning">In Bearbeitung</Status> stehen bleiben. Stornieren Sie sie unter <UIPath>Verwaltung > Zahlungen</UIPath> mit **Stornieren** im Aktionsmenü, damit die Rechnung stimmt.
</Accordion>
<Accordion title="Störung oder eine zusätzliche Rezeption">
Schreiben Sie an **support@tillor.eu**.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Zahlung erfassen" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Zahlungsgruppen" href="/betalingsverwerking/groepen" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Belegungen (/de-DE/bezettingen)

Eine Belegung hält fest, dass ein Kunde eine bestimmte Parzelle (einen Stellplatz, einen Stromanschluss und Ähnliches) nutzt. Solange die Belegung läuft, rechnet Tillor den Verbrauch der Zähler auf dieser Parzelle automatisch dem Kunden zu. Sie verwalten Belegungen im Kundenprofil. Beginnen Sie bei [Eine Belegung erstellen](#een-bezetting-aanmaken).

<Callout type="info" title="Gut zu wissen">
- Eine Parzelle kann nur von einem Kunden gleichzeitig belegt sein. Parzellen mit einer aktiven Belegung stehen nicht in der Auswahlliste.
- **Bezahlt bis** akzeptiert nur heute oder ein späteres Datum.
- Die Parzelle einer Belegung können Sie nachträglich nicht ändern. Zieht ein Kunde um, beenden Sie die Belegung und erstellen Sie eine neue.
- Eine Belegung zu löschen lässt sich nicht rückgängig machen, aber der Verbrauch bis zum Enddatum bleibt erhalten und kann noch abgerechnet werden.
- Bei **Belegung verlängern (Rechnung)** erhält der Rechnungsentwurf ein Fälligkeitsdatum von 14 Tagen nach dem Erstellen.
- Nur die Felder **Art**, **Mietrhythmus** und **Preis** sind informativ. Sie steuern die Zählererfassung oder Fakturierung nicht automatisch.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Belegung verbindet drei Dinge: den Kunden, die Parzelle und die Zähler auf dieser Parzelle. Dadurch weiß Tillor, auf wessen Namen der Verbrauch läuft.

```mermaid
flowchart LR
  K[Kunde] --> B[Belegung]
  B --> T[Parzelle]
  T --> M[Zähler auf der Parzelle]
  M --> V[Verbrauchszeitraum des Kunden]
  V --> F[Rechnung]
  B -->|Belegung verlängern| F
```

Beim Erstellen notiert Tillor die Anfangszählerstände, beim Beenden die Endzählerstände. Der Verbrauch dazwischen gehört dem Kunden. Eine neue Belegung auf derselben Parzelle beginnt einen neuen Zeitraum.

## Belegungen ansehen [#bezettingen-bekijken]

Öffnen Sie ein Kundenprofil über <UIPath>Kunden > Übersicht</UIPath> und gehen Sie zur Karte **Belegungen** auf dem Tab **Übersicht**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Belegungen im Kundenprofil" />

- Die Tabelle zeigt pro Belegung die **Parzelle**, **Art**, **Mietrhythmus**, **Preis**, **Status** und **Bezahlt bis**, mit einer relativen Angabe wie "in 12 Tagen".
- Bei **Bezahlt bis** steht ein Info-Symbol mit **Fakturiert bis** in einem Tooltip, wenn dieses Datum ausgefüllt oder gleich **Bezahlt bis** ist.
- Mit **Belegungen filtern...** suchen Sie nach dem Parzellennamen.
- Aktionen pro Belegung (bearbeiten, verlängern, löschen) stehen im Menü mit drei Punkten am Zeilenende.

## Eine Belegung erstellen [#een-bezetting-aanmaken]

Bevor Sie beginnen:

- Die Parzelle muss frei sein. Steht sie nicht in der Liste, ist sie bereits belegt. Siehe Probleme am Ende.
- Hat die Parzelle Zähler, halten Sie die Anfangszählerstände bereit. Tragen Sie nichts ein, übernimmt Tillor den letzten bekannten Stand.

<Steps>
<Step>
### Kundenprofil öffnen [#open-het-klantprofiel]
Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath>, öffnen Sie den Kunden und gehen Sie zur Karte **Belegungen**.
</Step>
<Step>
### Auf Belegung erstellen klicken [#klik-op-bezetting-aanmaken]
Die Schaltfläche finden Sie in der Symbolleiste der Tabelle. Es öffnet sich ein Dialog.
</Step>
<Step>
### Daten eingeben [#vul-de-gegevens-in]
Nur **Parzelle** ist Pflicht. Der Rest ist optional.

- **Parzelle**: Wählen Sie über **Parzelle auswählen**. In der Liste stehen nur verfügbare Parzellen. Ist keine Parzelle verfügbar, sehen Sie **Keine verfügbaren Parzellen gefunden.**
- **Bezahlt bis (optional)**: bis wann der Kunde im Voraus bezahlt hat. Sie wählen heute oder später.
- **Fakturiert bis (optional)**: leer lassen, um dem gleichen Datum wie **Bezahlt bis** zu folgen, oder ein eigenes Datum wählen.
- **Art**: **Eigene Unterkunft** (Standard) oder **Mietwohnwagen**.
- **Mietrhythmus (optional)**: eine der Optionen, die Ihre Organisation eingerichtet hat, jeweils mit einem Startmonat und einer Anzahl Monate (zum Beispiel Start im Januar, 6 Monate). Wählen Sie **Kein Rhythmus**, wenn Sie keinen festlegen möchten.
- **Beschreibung (optional)**: eine Erläuterung, zum Beispiel Tarifvereinbarungen.
- **Preis**: Die Belegung übernimmt den Preis der Parzelle. Mit **Geerbten Parzellenpreis überschreiben** geben Sie einen eigenen Preis an.
- **Start-Zählerstände (optional)**: erscheint, sobald die Parzelle Zähler hat. Hat sie keine Zähler, sehen Sie **Keine Zähler verknüpft**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Aktionsmenü einer Belegung mit Bearbeiten, Verlängern und Löschen" />
</Step>
<Step>
### Bestätigen [#bevestig]
Klicken Sie auf **Belegung erstellen**, um zu speichern.
</Step>
</Steps>

### Zählerstände eintragen [#meterstanden-invullen]

<Tabs items={["Manueller Zähler", "Automatischer Zähler"]}>
<Tab value="Manueller Zähler">
Geben Sie den Stand selbst über den Tab **Manuell** ein. Das Feld zeigt den letzten bekannten Stand als Beispiel. Gibt es frühere Ablesungen, können Sie über **Auswählen** auch eine vorhandene Ablesung wählen.
</Tab>
<Tab value="Automatischer Zähler">
Ein Zähler, der selbst Ablesungen übermittelt, erlaubt keine manuelle Eingabe. Wählen Sie eine vorhandene Ablesung über **Zählerstand auswählen**.
</Tab>
</Tabs>

Geben Sie einen Stand ein, der niedriger ist als der zuvor gespeicherte, zeigt Tillor eine Warnung. Sie können den niedrigeren Wert dann trotzdem bestätigen oder die Eingabe anpassen.

### Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Belegung ist sofort aktiv und steht in der Tabelle im Kundenprofil.
- Tillor startet für jeden Zähler auf der Parzelle einen Verbrauchszeitraum für diesen Kunden. Neue Zählerstände zählen ab jetzt als Verbrauch des Kunden.
- Die Parzelle ist für keine andere Belegung mehr verfügbar.

## Eine Belegung bearbeiten [#een-bezetting-bewerken]

<Steps>
<Step>
### Menü der Belegung öffnen [#open-het-menu-van-de-bezetting]
Klicken Sie auf das Menü mit drei Punkten neben der Belegung und wählen Sie **Bearbeiten**.
</Step>
<Step>
### Felder anpassen [#pas-de-velden-aan]
Sie können **Art**, **Mietrhythmus**, **Beschreibung**, **Bezahlt bis**, **Fakturiert bis** und **Preis** ändern. **Parzelle** ist schreibgeschützt. Hat Ihre Organisation [eigene Felder](/eigen-velden) für Belegungen, stehen diese am Ende des Dialogs.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-edit-dialog.png" alt="Dialog Belegung bearbeiten" />
</Step>
<Step>
### Speichern [#sla-op]
Klicken Sie auf **Änderungen speichern**. Die Änderung steht mit einer Vorher-nachher-Übersicht auf dem Tab **Ereignisse** des Kunden.
</Step>
</Steps>

## Eine Belegung beenden [#een-bezetting-beëindigen]

Beenden entfernt die Verknüpfung zwischen Kunde und Parzelle. Die Parzelle ist danach wieder verfügbar.

<Steps>
<Step>
### Löschen wählen [#kies-verwijderen]
Klicken Sie auf das Menü mit drei Punkten neben der Belegung und wählen Sie **Löschen**. Das Fenster **Belegung löschen** öffnet sich.
</Step>
<Step>
### Datum und Endzählerstände wählen [#kies-de-datum-en-de-eindmeterstanden]
Hat die Parzelle Zähler, können Sie **End-Zählerstände (optional)** eintragen. Wählen Sie zuerst bei **Datum** den Tag, an dem die Belegung endet (heute oder früher). Danach erscheint pro Zähler ein Feld für den Endstand. Einen manuellen Zähler tragen Sie über **Manuell** ein oder wählen ihn über **Auswählen**. Ein automatischer Zähler verlangt immer eine vorhandene Ablesung über **Zählerstand auswählen**.
</Step>
<Step>
### Bestätigen [#bevestig-1]
Klicken Sie auf **Löschen**. Das lässt sich nicht rückgängig machen.
</Step>
</Steps>

### Was passiert danach? [#wat-gebeurt-er-daarna-1]

- Tillor schließt die offenen Verbrauchszeiträume des Kunden ab. Der Verbrauch bis zum Enddatum bleibt erhalten und kann noch abgerechnet werden.
- Die Parzelle ist wieder für eine neue Belegung verfügbar.
- Die Belegung verschwindet aus der Tabelle.

## Fakturierung: Belegung verlängern [#facturatie-bezetting-verlengen]

Mit **Belegung verlängern (Rechnung)** erstellen Sie einen Rechnungsentwurf für den nächsten Zeitraum einer Belegung, zum Beispiel das jährliche Stellplatzgeld. Das können Sie für eine Belegung tun oder für alle Belegungen des Kunden gleichzeitig.

Bevor Sie beginnen: Es muss mindestens ein Produkt mit der Aktion **Belegung verlängern** existieren (oft Stellplatzgeld). Siehe [Produkte](/producten).

<Steps>
<Step>
### Aktion starten [#start-de-actie]
<Tabs items={["Eine Belegung", "Alle Belegungen"]}>
<Tab value="Eine Belegung">
Öffnen Sie das Menü mit drei Punkten neben der Belegung und wählen Sie **Belegung verlängern (Rechnung)**.
</Tab>
<Tab value="Alle Belegungen">
Klicken Sie in der Symbolleiste auf **Alle verlängern**. Alle Belegungen kommen auf einen Rechnungsentwurf, mit einer Hauptzeile pro Belegung.
</Tab>
</Tabs>
</Step>
<Step>
### Wählen, ob Verbrauch mit abgerechnet wird [#kies-of-je-verbruik-meefactureert]
Setzen Sie das Häkchen bei **Offenen Verbrauch für diese Parzelle fakturieren** (bei **Alle verlängern**: **Offenen Verbrauch fakturieren (alle Parzellen)**), wenn Sie auf demselben Rechnungsentwurf auch offenen Verbrauch abrechnen möchten. Ist auf den betroffenen Zählern nichts offen, bleibt es bei den Zeilen für die Belegungsverlängerung.
</Step>
<Step>
### Rechnungsentwurf erstellen [#maak-de-conceptfactuur]
Klicken Sie auf **Rechnungsentwurf erstellen**. Tillor verwendet das erste Produkt mit der Aktion **Belegung verlängern** (alphabetisch nach Name) und baut die Zeilen für Sie auf. Ergänzen Sie danach den Zeitraum auf der Rechnung und buchen Sie, wenn Sie fertig sind.
</Step>
</Steps>

### Was passiert danach? [#wat-gebeurt-er-daarna-2]

- Beim Kunden liegt ein Rechnungsentwurf bereit, mit der Meldung **Bereit** und einer Beschreibung dessen, was erstellt wurde.
- Buchen Sie die Rechnung, setzt Tillor **Fakturiert bis** auf den Endzeitpunkt der Zeile.
- Nach der Zahlung aktualisiert Tillor **Bezahlt bis**. **Fakturiert bis** rückt nur mit vor, wenn es noch vor diesem Endzeitpunkt lag.

<Callout type="warn" title="Achtung bei einem bestehenden Entwurf">
Gibt es bereits einen Rechnungsentwurf, der diese Parzelle verlängert, zeigt Tillor **Vor dem Fortfahren prüfen**. Ein zweiter Entwurf kann doppelte Zeilen ergeben oder einen Zeitraum überspringen. Öffnen Sie den bestehenden Entwurf mit **Entwurf ... öffnen**, oder wählen Sie **Trotzdem Entwurf erstellen**.
</Callout>

## Bezahlt bis, Art, Mietrhythmus und Preis [#betaald-tot-type-huurfrequentie-en-prijs]

| Feld | Bedeutung |
|---|---|
| **Bezahlt bis** | Bis wann der Kunde im Voraus bezahlt hat. Beim Erstellen oder Bearbeiten wählen Sie heute oder später. |
| **Fakturiert bis** | Bis wann fakturiert wurde. Lassen Sie es leer, folgt die Anzeige **Bezahlt bis**. |
| **Art** | Unterscheidet eigene Unterkunft von Vermietung. |
| **Mietrhythmus** | Legt den Rhythmus der Miete für die administrative Nachverfolgung fest. |
| **Preis** | Folgt standardmäßig der Parzelle, kann aber pro Belegung angepasst werden. |

## Häufige Szenarien [#veelvoorkomende-scenarios]

### Ein neuer Gast checkt ein [#een-nieuwe-gast-checkt-in]

1. Suchen Sie den Kunden oder legen Sie ihn an.
2. Erstellen Sie im Kundenprofil eine Belegung auf der Parzelle.
3. Tragen Sie den Anfangszählerstand ein oder lassen Sie Tillor den letzten Stand übernehmen.
4. Tillor ordnet den Verbrauch der Zähler auf dieser Parzelle fortan diesem Kunden zu.

### Ein Gast reist ab [#een-gast-vertrekt]

1. Wählen Sie bei der Belegung **Löschen**.
2. Wählen Sie das Abreisedatum und tragen Sie die Endzählerstände ein.
3. Bestätigen Sie. Tillor schließt die Verbrauchszeiträume ab und die Parzelle ist wieder verfügbar.

### Ein Kunde zieht auf eine andere Parzelle um [#een-klant-verhuist-naar-een-ander-terrein]

1. Beenden Sie die aktuelle Belegung mit den Endzählerständen der alten Parzelle.
2. Erstellen Sie eine neue Belegung auf der neuen Parzelle mit den Anfangszählerständen.
3. Tillor führt die Verbrauchszeiträume pro Parzelle getrennt.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Parzelle steht nicht in der Auswahlliste">
In der Liste stehen nur Parzellen ohne aktive Belegung. Hat ein anderer Kunde die Parzelle noch, beenden Sie zuerst diese Belegung. Ist nichts verfügbar, sehen Sie **Keine verfügbaren Parzellen gefunden.** Fehlen alle Parzellen und sehen Sie **Beim Laden der Parzellen ist ein Fehler aufgetreten.**, laden Sie die Seite neu.
</Accordion>
<Accordion title="Die Belegung kann nicht erstellt werden, weil die Parzelle bereits belegt ist">
Ein anderer Benutzer war Ihnen zuvorgekommen und hat die Parzelle belegt. Laden Sie die Kundenseite neu, wählen Sie eine andere Parzelle oder beenden Sie zuerst die Belegung des anderen Kunden.
</Accordion>
<Accordion title="Ich kann bei Bezahlt bis kein Datum in der Vergangenheit wählen">
Das ist beabsichtigt. Beim Erstellen oder Bearbeiten akzeptiert **Bezahlt bis** nur heute oder später.
</Accordion>
<Accordion title="Die Endzählerstände erscheinen beim Löschen nicht">
Wählen Sie zuerst bei **Datum** den Tag, an dem die Belegung endet. Danach erscheint pro Zähler ein Feld. Hat die Parzelle keine Zähler, gibt es kein Feld.
</Accordion>
<Accordion title="Ich kann bei einem Zähler keinen Stand eintippen">
Das ist ein Zähler, der selbst Ablesungen übermittelt. Wählen Sie eine vorhandene Ablesung über **Zählerstand auswählen**. Steht dort **Keine Zählerstände verfügbar**, hat der Zähler noch keine Ablesung übermittelt.
</Accordion>
<Accordion title="Tillor meldet: Erstellung fehlgeschlagen. Die Rechnung konnte nicht erstellt werden">
Meist existiert kein Produkt mit der Aktion **Belegung verlängern**. Legen Sie eines an, siehe [Produkte](/producten), und versuchen Sie es erneut. Verlängern Sie alle Belegungen gleichzeitig, prüfen Sie außerdem, dass sie zum selben Kunden gehören.
</Accordion>
<Accordion title="Tillor zeigt beim Verlängern Vor dem Fortfahren prüfen">
Es gibt bereits einen Entwurf für diese Parzelle, oder die Parzelle ist bis zu einem Datum fakturiert, das noch nicht bezahlt ist. Lesen Sie die Meldung. Mit **Trotzdem Entwurf erstellen** machen Sie bewusst weiter, mit **Entwurf ... öffnen** prüfen Sie zuerst den bestehenden Entwurf.
</Accordion>
<Accordion title="Ich habe versehentlich eine Belegung gelöscht">
Das lässt sich nicht rückgängig machen. Erstellen Sie eine neue Belegung auf derselben Parzelle. Der Verbrauch bis zum Enddatum der alten Belegung ist erhalten geblieben.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Belegung**: ein Kunde auf einer Parzelle für einen Zeitraum. Siehe [Belegung](/begrippen#bezetting).
- **Parzelle**: der Platz selbst, mit eventuellen Zählern. Siehe [Parzelle](/begrippen#terrein).
- **Bezahlt bis**: das Datum, bis zu dem der Kunde im Voraus bezahlt hat.
- **Fakturiert bis**: das Datum, bis zu dem bereits fakturiert wurde.
- **Verbrauchszeitraum**: der Zeitraum, in dem der Verbrauch eines Zählers einem Kunden zugerechnet wird. Siehe [Verbrauchsbatch](/begrippen#verbruiksbatch).
- **Mietrhythmus**: der Rhythmus der Miete, zum Beispiel jährlich oder halbjährlich.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Kunden hinzufügen und verwalten" />
  <Card title="Zählerverwaltung" href="/meterbeheer" description="Wie Zähler abgelesen und mit Belegungen verknüpft werden" />
  <Card title="Verbrauchsbatches" href="/meterbeheer/consumptie-batches" description="Wie Verbrauchszeiträume geführt und fakturiert werden" />
  <Card title="Praxisbeispiele" href="/praktijk" />
  <Card title="Einen Saisonkunden gewinnen" href="/praktijk/seizoensklant-binnenhalen" />
  <Card title="Ein Dauercampingwagen wird frei" href="/praktijk/stacaravan-komt-vrij" />
</Cards>


# MwSt. & Steuern (/de-DE/boekhouden/belasting)

Hier lesen Sie, wie die MwSt. auf Ihre Rechnungen kommt und wie Tillor die USt-IdNr. eines Kunden prüft. Die Prüfung läuft über VIES, den europäischen Dienst, mit dem sich eine USt-IdNr. überprüfen lässt.

## MwSt.-Sätze [#btw-tarieven]

MwSt.-Sätze werden pro Produkt eingestellt. Gehen Sie zu **Verwaltung > Produkte** und öffnen Sie ein Produkt, um **MwSt. %** aus den verfügbaren Sätzen zu wählen (standardmäßig 0 %, 6 %, 9 %, 12 % und 21 %).

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Produktübersicht - MwSt.-Spalte pro Produkt" />

## Reverse-Charge und andere Regelungen ohne MwSt. [#btw-verlegd-en-andere-regimes-zonder-btw]

Manchmal berechnen Sie keine MwSt., aber das ist kein gewöhnlicher 0-%-Satz: Der Kunde muss die MwSt. selbst anmelden, oder die Lieferung ist befreit. In der Auswahlliste **MwSt. %** eines Produkts stehen deshalb unter den Sätzen fünf Regelungen. Wählen Sie eine, steht das Produkt auf 0 % und Tillor weiß, warum.

| Regelung | Wann | Feld in der MwSt.-Erklärung |
|----------|------|-----------------------------|
| **Reverse-Charge (EU-Dienstleistungen)** | Eine Dienstleistung für einen umsatzsteuerpflichtigen Kunden in einem anderen EU-Land | 44 |
| **Reverse-Charge (Bauleistungen)** | Arbeiten an Immobilien für einen belgischen umsatzsteuerpflichtigen Kunden, der periodische Erklärungen abgibt | 45 |
| **Innergemeinschaftliche Lieferung** | Waren, die Sie an einen umsatzsteuerpflichtigen Kunden in einem anderen EU-Land senden | 46 |
| **Ausfuhr außerhalb der EU** | Waren, die die EU verlassen | 47 |
| **Umsatzsteuerfrei** | Eine Lieferung, die ihrer Art nach befreit ist (Artikel 44 des belgischen MwSt.-Gesetzbuchs) | 00 |

Eine Regelung bewirkt vier Dinge, die ein gewöhnlicher 0-%-Satz nicht bewirkt:

- **Auf der Rechnung** steht bei der Zeile `0%*`, mit dem gesetzlichen Hinweis zur Regelung unter den Summen, zum Beispiel *Reverse-Charge: Die MwSt. schuldet der Leistungsempfänger*. Stehen zwei Regelungen auf einer Rechnung, erhält die zweite `**`.
- **Buchen gelingt nur mit einer USt-IdNr.** bei den beiden Reverse-Charge-Regelungen und bei einer innergemeinschaftlichen Lieferung. Tragen Sie die Nummer im Kundenprofil ein; sie steht dann auch auf der Rechnung.
- **An die Buchhaltung** geht die Zeile mit dem Code der Regelung, damit sie im richtigen Feld Ihrer MwSt.-Erklärung landet. Siehe [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#btw-regimes).
- **Über Peppol** erhält die Zeile die MwSt.-Kategorie der Regelung.

<Callout type="warn" title="Welche Regelung gilt, entscheiden Sie selbst">
Tillor prüft nicht, ob ein Kunde oder eine Lieferung Anspruch auf eine Regelung hat. Sind Sie unsicher, fragen Sie Ihren Buchhalter.
</Callout>

## Validierung der USt-IdNr. [#btw-nummer-validatie]

Wenn Sie im Kundenprofil eine USt-IdNr. eingeben, prüft Tillor sie automatisch über den europäischen VIES-Dienst, sobald das Land ausgefüllt ist.

### So funktioniert es [#hoe-het-werkt]

1. Öffnen Sie **Kunden > Kunde** (Abschnitt **Kundendetails**)
2. Stellen Sie das **Land** ein und geben Sie die USt-IdNr. ein (z. B. `NL123456789B01` oder `BE0123456789`)
3. Tillor validiert die Nummer automatisch (nach einer kurzen Pause)
4. Bei einer gültigen USt-IdNr. erscheint ein grünes Häkchen; klicken Sie darauf für Firmendaten aus VIES
5. Möchten Sie Name und Adresse übernehmen? Klicken Sie in diesem Fenster auf **Firmenadresse übernehmen** (der Firmenname kommt in das Feld Vorname)
6. Bei einer ungültigen USt-IdNr. erscheint ein rotes Symbol mit Erklärung

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Kundenprofil - Kundendetails mit MwSt.-Feldern" />

<Callout type="info">
Die MwSt.-Validierung funktioniert für alle EU-Länder. Für Unternehmen außerhalb der EU können Sie die USt-IdNr. manuell ohne Validierung eingeben.
</Callout>

### Unterstützte Länder [#ondersteunde-landen]

Die Validierung unterstützt alle EU-Mitgliedstaaten, darunter die Niederlande (NL), Belgien (BE), Deutschland (DE), Frankreich (FR) und alle anderen EU-Länder.

### Ländercode auf dem Rechnungs-PDF [#landcode-op-de-factuur-pdf]

Auf dem Rechnungs-PDF ergänzt Tillor einen fehlenden Ländercode automatisch für Länder, in denen das die übliche Schreibweise ist: Geben Sie bei einem belgischen Kunden `0123456789` ein, steht auf der Rechnung `BE0123456789`. Für Spanien, Italien und Portugal geschieht das nicht, weil die nationale Steuernummer dort ohne Ländercode geschrieben wird (eine spanische NIF wie `B04876793` bleibt also unverändert). Tippen Sie den Ländercode selbst mit ins Feld, wird er immer übernommen.

## Belgische Kunden und Peppol [#belgische-klanten-en-peppol]

Bei belgischen Kunden mit USt-IdNr. muss auf dem Tab **Rechnungsstellung** eine **Peppol-ID** stehen, bevor Sie Rechnungen buchen können. Das ist in Belgien für B2B-Rechnungen gesetzlich vorgeschrieben.

Siehe die [Peppol-Dokumentation](/boekhouden/peppol) für mehr Informationen.

## MwSt. auf Rechnungen [#btw-op-facturen]

Alle Rechnungszeilen zeigen automatisch den richtigen MwSt.-Satz auf Basis des verknüpften Produkts. Auf der Rechnung sehen Sie **Zwischensumme**, **MwSt.** und **Gesamt**; auf dem Rechnungs-PDF steht zusätzlich eine Übersicht pro MwSt.-Satz.

<Callout type="info" title="MwSt. pro Zeile anpassen">
Haben Sie das Recht, Organisationseinstellungen zu ändern? Gehen Sie zu **Einstellungen > Rechnungsstellung** und schalten Sie **MwSt.-Satz als Dropdown in Rechnungsentwurfszeilen** ein. Auf **Rechnungsentwürfen** erscheint dann eine Spalte, um den Satz pro Zeile zu wählen (die Optionen folgen den für Ihre Organisation konfigurierten Sätzen). Wenn Sie ein Produkt auswählen, bleibt der Standardsatz des Produkts der Startwert. In derselben Spalte wählen Sie auch eine [Regelung ohne MwSt.](#btw-verlegd-en-andere-regimes-zonder-btw) für eine Zeile.
</Callout>

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die USt-IdNr. des Kunden erhält ein rotes Symbol">
Tillor konnte die Nummer nicht über VIES bestätigen. Prüfen Sie Land und Nummer. Für ein Unternehmen außerhalb der EU können Sie die Nummer auch ohne Validierung eingeben.
</Accordion>
<Accordion title="Ich kann eine Rechnung mit Reverse-Charge nicht buchen">
Der Kunde hat keine USt-IdNr. Reverse-Charge und eine innergemeinschaftliche Lieferung gibt es nur für einen umsatzsteuerpflichtigen Kunden. Tragen Sie die Nummer unter <UIPath>Kunden > Kunde</UIPath>, Abschnitt **Kundendetails**, ein und buchen Sie erneut.
</Accordion>
<Accordion title="Ich kann eine Rechnung mit zwei Regelungen nicht über Peppol senden">
Eine Peppol-Rechnung kann nur einen Grund für das Fehlen der MwSt. tragen. Legen Sie die Zeilen jeder Regelung auf eine eigene Rechnung.
</Accordion>
<Accordion title="Mir fehlt ein MwSt.-Satz bei einem Produkt">
Sie können nur aus den zulässigen Sätzen wählen, standardmäßig 0 %, 6 %, 9 %, 12 % und 21 %.
</Accordion>
<Accordion title="Ich kann den MwSt.-Satz einer Rechnungszeile nicht wählen">
Die Spalte mit den Sätzen steht nur auf Rechnungsentwürfen und nur, wenn **MwSt.-Satz als Dropdown in Rechnungsentwurfszeilen** eingeschaltet ist.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Produkte" href="/producten" description="MwSt.-Sätze mit Produkten verknüpfen" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Elektronisch fakturieren in Belgien" />
  <Card title="Rechnungen" href="/facturen" description="Rechnungen erstellen und buchen" />
</Cards>


# Zahlungsmethoden (/de-DE/boekhouden/betalingsrapporten/betaalmethodes)

Zahlungsberichte enthalten Zahlungen aus verschiedenen Quellen. Nur **Mollie** und **interne Überweisungen** werden an die Buchhaltung gesendet.

| Methode | Im Tillor-Bericht | An die Buchhaltung |
|---------|-------------------|--------------------|
| [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | Ja (über die Mollie-Abrechnung) | Ja |
| [Bankkonten](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | Ja (am Zahltag) | Nein |
| [Interne Überweisung](/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) | Ja | Ja |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Zahlungsbericht - Zahlungen aus verschiedenen Quellen" />

```mermaid
flowchart LR
  Mollie[Mollie] --> R[Tillor-Bericht]
  Bank[Bankkonten] --> R
  Internal[Interne Überweisung] --> R
  R --> BH[Buchhaltung]
  Mollie --> BH
  Internal --> BH
```

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Bankkonten" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Interne Überweisung" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Interne Überweisungen (/de-DE/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers)

Mit **Interne Überweisung** verschieben Sie einen offenen Betrag von einer Rechnung auf eine andere **gebuchte** Rechnung **desselben Kunden**. Tillor erstellt eine positive Zahlung auf der Rechnung, die Sie bezahlen, und eine verknüpfte negative Zahlung auf der Zielrechnung.

Siehe [Interne Überweisung - Erfassen](/betalingsverwerking/interne-overboeking) für den Schritt-für-Schritt-Ablauf mit Screenshots.

## In Zahlungsberichten [#in-betalingsrapporten]

- Interne Überweisungen stehen im Tillor-Zahlungsbericht des Tages, an dem Sie sie erfassen (Brüsseler Zeit).
- Sie gehen **sehr wohl** in den Buchhaltungsexport: zusammen mit Mollie-Zahlungen, und **nicht** zusammen mit Bankkonten oder anderen manuellen Methoden (bar, Überweisung, ...).
- Im Buchhaltungsexport erscheint jede Zeile als `Tillor - Interne overboeking - {factuurnummer}`, verknüpft mit der jeweiligen Rechnung und dem Kunden.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Erfassen" href="/betalingsverwerking/interne-overboeking" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Bankkonten" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Mollie (/de-DE/boekhouden/betalingsrapporten/betaalmethodes/mollie)

Mollie-Zahlungen (iDEAL, Kreditkarte, Bancontact, Terminal usw.) werden in Tillor synchronisiert und über das **Mollie-Settlement** mit Zahlungsberichten verknüpft.

## In Tillor verbinden [#koppelen-in-tillor]

1. Gehen Sie zu **Einstellungen > Integrationen** und wählen Sie **Mollie** in der Liste.
2. Folgen Sie den Mollie-OAuth-Schritten, wenn die Anbindung noch nicht aktiv ist.
3. Wählen Sie auf der Detailseite unter **Websiteprofil** ein **Hauptprofil** (das Mollie-Websiteprofil für Zahlungen und Synchronisierung). Optional wählen Sie ein **Standardterminal** (das Kartengerät, das Tillor bei Rechnungen standardmäßig vorschlägt).
4. Klicken Sie auf **Speichern**. Ohne Hauptprofil funktionieren Mollie-Zahlungen in Tillor nicht; ein Terminal wird nur für Kartenzahlungen benötigt.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-marketplace-install.png" alt="Einstellungen > Integrationen - Mollie in der Liste" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-connection-settings.png" alt="Mollie-Einstellungen - Hauptprofil und Standardterminal" />

### Statussymbole in den Auswahllisten [#statusiconen-in-de-keuzelijsten]

Links neben dem Profil- und Terminalnamen steht ein farbiges Symbol. Es zeigt den Status bei Mollie, nicht den Namen selbst.

| Symbol | Websiteprofil | Terminal |
|--------|---------------|----------|
| Grün (Häkchen) | Verifiziert - geeignet für Live-Zahlungen | Aktiv - bereit für Kartenzahlungen |
| Orange (Uhr) | Bei Mollie noch nicht verifiziert | Ausstehend - noch nicht aktiv |
| Rot (Verbotszeichen) | Gesperrt | - |
| Grau | - | Inaktiv |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-profile-select-open.png" alt="Hauptprofil geöffnet - Statussymbol neben dem Profilnamen" />

Wählen Sie vorzugsweise ein **verifiziertes** Profil. Ein **aktives** Terminal ist optional und nur nötig, wenn Sie Kartenzahlungen aus Tillor vorschlagen lassen möchten. Ohne Hauptprofil laufen Zahlungen und Synchronisierung nicht.

## Mollie-Settlements [#mollie-settlements]

Solange Mollie eine Zahlung noch nicht ausgezahlt hat, steht sie als **Vorschuss** im offenen Entwurfsbericht. Erst beim Finalisieren entscheidet das Settlement, in welchen Bericht sie gehört; siehe [Mollie-Zahlungen im Entwurf](/boekhouden/betalingsrapporten#mollie-betalingen-op-het-concept).

Für **Berichtstag D** sucht Tillor ein Settlement in dieser Reihenfolge:

1. Settlement **erstellt an Tag D**
2. Sonst Settlement **erstellt an Tag D+1** (typisch: der Umsatz von D wird am nächsten Morgen ausgezahlt)

```mermaid
flowchart TD
  D[Berichtstag D] --> E{Settlement erstellt an D?}
  E -- ja --> F[Mit Bericht D verknüpfen]
  E -- nein --> G{Settlement erstellt an D+1?}
  G -- ja --> F
  G -- nein --> H[Noch kein Mollie in diesem Bericht]
  F --> I[Eine Settlement-ID pro Bericht]
```

**Festgelegte Regeln:**

- Jede Settlement-ID steht auf **höchstens einem** Zahlungsbericht.
- Hat ein Bericht bereits ein Settlement? Diese Verknüpfung **bleibt bestehen**; Tillor ersetzt sie nicht.
- Fehlen sowohl D als auch D+1 (z. B. am Wochenende): Der Bericht kann bereits existieren, nur mit manuellen Zahlungen und Bankkonto-Zahlungen; sobald Mollie veröffentlicht, ergänzt die tägliche Synchronisierung Mollie.

## Beispiele [#voorbeelden]

| Berichtstag D | Settlement bei Mollie erstellt | Ergebnis |
|---------------|--------------------------------|----------|
| Di 20. Mai | Di 20. Mai (`stl_aaa`) | `PAYR/2026/0140` (20. Mai) erhält `stl_aaa` |
| Di 20. Mai | Mi 21. Mai früh (`stl_bbb`) | `PAYR/2026/0140` (20. Mai) erhält `stl_bbb` (Regel D+1) |
| So 18. Mai | Mo 19. Mai (`stl_ccc`) | `PAYR/2026/0138` (Sonntag) erhält `stl_ccc`, **nicht** der Montagsbericht |
| Mo 19. Mai | Mo 19. Mai (`stl_ccc`) | Der Montagsbericht sucht sein eigenes Settlement (`stl_ddd` am Di oder später), nicht `stl_ccc` |
| Sa 17. Mai | Kein Settlement Sa/So/Mo früh | Bericht 17. Mai: zunächst manuell/Bankkonten; Mollie folgt, sobald ein Settlement da ist |
| Di 20. Mai | Bericht existierte schon ohne Settlement | Nächster Lauf 09:00: Settlement wird noch am 20. Mai zugeordnet, Zahlungen verknüpft |

**Konkret (D+1):** Der Umsatz von **Dienstag, 20. Mai** steht im Settlement `stl_6necch`, erstellt am **Mittwoch, 21. Mai** um 06:08. Tillor verknüpft `stl_6necch` mit **`PAYR/2026/0140` (Berichtstag 20. Mai)**, nicht mit dem Bericht vom 21. Mai.

**Bestehender Bericht:** Stand `PAYR/2026/0140` bereits in Tillor ohne verknüpfte Mollie-Abrechnung und mit zwei manuellen Zeilen? Nach der Synchronisierung wird `stl_6necch` noch verknüpft; bestehende Zeilen bleiben; Mollie-Zahlungen aus diesem Settlement kommen hinzu.

**Bereits verknüpft:** Der Bericht vom **15. Mai** hat bereits `stl_old`. Tillor ändert diese ID **nicht**. Einzelne Mollie-Zahlungen mit derselben Settlement-ID landen trotzdem im Bericht, der dieses Settlement bereits hat.

## Synchronisierung bestehender Berichte [#synchronisatie-op-bestaande-rapporten]

Nach dem Anlegen fehlender Berichte sucht Tillor **nur Berichte ohne verknüpfte Mollie-Abrechnung** in einem rollierenden Fenster von **einem Kalendermonat vor gestern** bis gestern. Berichte, die bereits eine Mollie-Abrechnung haben, werden dabei **nicht** erneut über die Mollie-Settlement-Liste abgerufen.

```mermaid
flowchart TD
  start[Synchronisierung<br/>Mo-Sa 09:00] --> scope[Berichtstag von<br/>Monat vor gestern bis gestern]
  scope --> nullOnly[Nur Berichte<br/>ohne Mollie-Abrechnung]
  nullOnly --> U{Settlement für D oder D+1 suchen}
  U -- gefunden --> V[Settlement festhalten]
  U -- nicht --> W[Kein Mollie-Schritt]
  V --> X[Nicht verknüpfte Mollie-Zahlungen<br/>aus Settlement verknüpfen]
  X --> Z[Zahlungen mit derselben<br/>Settlement-ID in diesem Bericht]
```

Zahlungen, die bereits eine Settlement-ID von Mollie haben, aber noch in keinem Bericht stehen, kommen in den Bericht mit derselben Settlement-ID.

## Mollie-Zahlungen in Tillor [#mollie-betalingen-in-tillor]

Tillor ruft Mollie-Zahlungen **alle 15 Minuten** ab (pro Organisation mit aktiver Mollie-Anbindung). Webhooks von Mollie wirken zusätzlich sofort: Eine Zahlung wird direkt **Bezahlt**, **Erstattet** oder **Zurückgebucht**, auch wenn sie außerhalb von Tillor entstanden ist (zum Beispiel am Kartenterminal). Bei Zweifel oder einem verpassten Webhook: **Synchronisieren** im Aktionsmenü der Zahlung.

Eine Zahlung kommt in einen Bericht, wenn:

- sie im verknüpften **Settlement** steht (Liste von Mollie), oder
- die Zahlung bereits eine Settlement-ID hat, die zum Bericht gehört.

| Typ im Bericht | Bedeutung |
|----------------|-----------|
| Bekannt | Zahlung mit einer Rechnung in Tillor verknüpft |
| Unbekannt | Keine Rechnungsverknüpfung in Tillor → Wartekonto 499000, es sei denn, Sie senden Buchhaltungsdaten über Mollie mit |

Settlement-Zahlungen, die in Tillor **nicht** existieren, erscheinen als unbekannte Mollie-Zahlung im Bericht.

In einem Zahlungsbericht sehen Sie verknüpfte Mollie-Zahlungen in der Tabelle **Zahlungen**:

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Detail des Zahlungsberichts - Zahlungen und An Buchhaltung senden" />

## Mollie-Metadaten [#mollie-metadata]

Haben Sie eine Kasse oder ein anderes System, das selbst Mollie-Zahlungen erstellt? Sie können Tillor über Metadaten an dieser Zahlung steuern: Verknüpfung mit einer Rechnung oder [Zahlungsgruppe](/betalingsverwerking/groepen) oder direkt an die Buchhaltung. Die Felder stehen unter [Mollie-Metadaten](/ontwikkelaars/mollie-metadata).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zahlungsberichte" href="/boekhouden/betalingsrapporten" />
  <Card title="Zahlungsgruppen" href="/betalingsverwerking/groepen" />
  <Card title="Bankkonten" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Interne Überweisungen" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Mollie-Metadaten (API)" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Bankkonten (/de-DE/boekhouden/betalingsrapporten/betaalmethodes/ponto)

Die Bankanbindung verbindet sich über Open Banking mit Ihrem Bankkonto und ruft Transaktionen automatisch ab.

## So funktioniert es [#hoe-het-werkt]

1. **Transaktionen**: Alle 5 Minuten ruft Tillor Banktransaktionen bei Ihrer Bank ab
2. **Strukturierte Mitteilung**: +++123/4567/89002+++ oder Rechnungsnummer (INV/2024/0001) wird ausgelesen
3. **Verknüpfung**: Tillor sucht eine passende Rechnung → die Zahlung wird erstellt und verknüpft
4. **Doppelte manuelle Überweisung**: Steht auf derselben Rechnung bereits eine manuelle Überweisung mit demselben Betrag, wird sie entfernt, damit die Zahlung nicht doppelt zählt
5. In Tillor sehen Sie diese Zahlung als **Überweisung**

## Verbinden [#koppelen]

Die Integration heißt **Bankkonten** und steht unter <UIPath>Einstellungen > Integrationen > Bankkonten</UIPath>. Sie tragen eine **Client ID** und ein **Client Secret** ein; ein Tillor-Administrator hilft Ihnen bei der Einrichtung und begleitet das Onboarding.

## Banktransaktionen ansehen [#banktransacties-bekijken]

Importierte Banktransaktionen stehen unter **Verwaltung > Banktransaktionen**. Diese Seite ist nur für Benutzer mit dem Recht **Banktransaktionen anzeigen** sichtbar. Ohne dieses Recht sehen Sie die Seite nicht im Menü.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-list.png" alt="Übersicht der Banktransaktionen mit Spalte Rechnung" />

In der Tabelle **Transaktionen** steht die Spalte **Rechnung** zwischen **Wertstellungsdatum** und **Verwendungszweck**:

- Steht die Transaktion bereits auf einer Rechnung? Dann sehen Sie die Rechnungsnummer als Link (z. B. `INV/2026/0001`).
- Noch keine Verknüpfung? Öffnen Sie das Aktionsmenü (drei Punkte) am Zeilenende und wählen Sie **Rechnung zuordnen**. Tillor erstellt notfalls zuerst eine Zahlung und verknüpft sie mit der Transaktion. Dafür benötigen Sie das Recht **Zahlung zuweisen**; ohne dieses Recht sehen Sie diese Aktion nicht im Menü.
- Steht die Transaktion bereits auf einer Rechnung? Öffnen Sie dasselbe Aktionsmenü und wählen Sie **Rechnungszuordnung aufheben**, um die Verknüpfung zu entfernen (manuell und automatisch zugeordnet).

Klicken Sie auf das (i)-Symbol beim IBAN, um das Detailfenster dieser Transaktion zu öffnen: Betrag, Wertstellungsdatum, Gegenpartei und IBAN, Verwendungszweck, die Daten des Kontoauszugs (Bankreferenz, Referenz des Auftraggebers, Kartennummer, ...), die verknüpfte Rechnung, Zahlung und der Zahlungsbericht sowie die Referenzen. Das Aktionsmenü steht auch oben in diesem Fenster.

Im Aktionsmenü wählen Sie außerdem:

- **Aufgabe anlegen**, um der Transaktion eine Aufgabe zuzuordnen, zum Beispiel um eine Zahlung manuell zu verarbeiten. Die Aufgabe zeigt die Transaktion als verknüpftes Element; klicken Sie darauf, um das Detailfenster zu öffnen. Siehe [Verknüpfte Elemente](/taken/taakdetails#gekoppelde-items).
- **Link kopieren** für einen Link, der die Seite **Banktransaktionen** mit dem Detailfenster dieser Transaktion öffnet, zum Beispiel zum Einfügen in eine Notiz oder Nachricht.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-assign-dialog.png" alt="Dialog Rechnung zuordnen bei einer Banktransaktion" />

Dieselbe Spalte **Rechnung** sehen Sie in einem **Zahlungsbericht** in der Tabelle **Bankkonto-Transaktionen**, solange Sie das Leserecht haben.

## Zuordnung aufheben [#ontkoppelen]

Unter **Verwaltung > Banktransaktionen** (und in einem Zahlungsbericht unter **Bankkonto-Transaktionen**) öffnen Sie das Aktionsmenü einer verknüpften Zeile und wählen **Rechnungszuordnung aufheben**. Das funktioniert sowohl für manuell verknüpfte als auch für automatisch zugeordnete Transaktionen.

Unter **Verwaltung > Zahlungen** steht **Rechnungszuordnung aufheben** nur bei Zahlungen, die Sie selbst mit einer Rechnung verknüpft oder verschoben haben. So vermeiden Sie, versehentlich eine korrekte automatische Verknüpfung über die Zahlungsübersicht zu entfernen.

<DocScreenshot src="/screenshots/betalingen/payment-unassign-menu.png" alt="Aktionsmenü einer Zahlung mit Rechnungszuordnung aufheben" />

## Manuell synchronisieren [#handmatig-synchroniseren]

Unter **Verwaltung > Banktransaktionen** und in einem **Zahlungsbericht** (Tabelle **Bankkonto-Transaktionen**) steht die Schaltfläche **Bankkonto synchronisieren**, wenn die Bankanbindung installiert ist und Sie das Recht **Banktransaktionen synchronisieren** haben. Damit fordern Sie eine neue Banksynchronisierung an; Tillor importiert danach neue Transaktionen und versucht, sie Rechnungen zuzuordnen.

Ohne Bankanbindung oder ohne dieses Recht erscheint die Schaltfläche nicht. Tillor importiert neue Transaktionen auch automatisch, alle 5 Minuten.

Beide Rechte legen Sie unter **Einstellungen > Benutzerberechtigungen** fest (Gruppe **Banktransaktionen**).

## In Zahlungsberichten [#in-betalingsrapporten]

Banküberweisungen kommen **sehr wohl** in den Tillor-Zahlungsbericht des Zahldatums (Brüsseler Zeit), zusammen mit manuellen Zahlungen dieses Tages. Sie gehen **nicht** in den Buchhaltungsexport: nur Mollie und interne Überweisungen. Die Bankanbindung dient vor allem der automatischen Zuordnung zu Rechnungen in Tillor.

<Callout type="idea" title="Automatische Zuordnung">
Kunde überweist mit strukturierter Mitteilung → Tillor ruft bei Ihrer Bank ab → Rechnung wird zugeordnet → Zahlung + Rechnung bezahlt.
</Callout>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Interne Überweisungen" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Admisol (/de-DE/boekhouden/betalingsrapporten/boekhoudsystemen/admisol)

Admisol ist ein Buchhaltungspaket, das Tillor zum Versenden von Zahlungsberichten unterstützt. Zahlungsberichte werden in Admisol-XML umgewandelt und automatisch oder manuell an Admisol gesendet.

## Installation [#installatie]

1. Gehen Sie zu **Einstellungen** (Markierung **1** im Screenshot) und wählen Sie **Integrationen**.
2. Suchen Sie **Admisol** in der Integrationsliste (Markierung **2**) und öffnen Sie die Detailseite.
3. Tragen Sie auf der Detailseite Ihre **Company ID** und **Web Service Key** ein (Daten von Admisol) und klicken Sie auf **Installieren**.

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-marketplace-install.png" alt="Einstellungen > Integrationen - Admisol in der Liste" />

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-credentials-dialog.png" alt="Admisol-Detail - Company ID und Web Service Key" />

## Automatisch senden [#automatisch-versturen]

Wenn sich ein Zahlungsbericht **inhaltlich ändert** (zum Beispiel nach dem Verknüpfen von Zahlungen oder nach **Bericht neu berechnen**):

1. Tillor prüft, ob Admisol für die Organisation installiert ist
2. Der Bericht wird in Admisol-XML umgewandelt
3. Das XML wird an Admisol gesendet

Bei der **täglichen Erstellung** (09:00) geht Tillor die fehlenden Tage **von alt nach neu** durch. Jeder neue Bericht geht erst an Admisol, wenn der vorige Bericht eine Antwort erhalten hat (Annahme oder Ablehnung). Gelingt das Senden nicht, hält Tillor für diese Organisation bis zum nächsten Lauf an.

Der [Entwurfsbericht](/boekhouden/betalingsrapporten#concept-en-definitief) des laufenden Tages geht bereits an Admisol, sobald eine Mollie-Zahlung oder interne Überweisung darauf steht, und danach nur erneut, wenn sich die Buchung ändert. Barzahlungen im Entwurf lösen keinen Versand aus. Mollie-Zahlungen in einem Entwurf werden beim Lieferanten Mollie **ohne Dokumentverweis** gegengebucht; Admisol bucht das als **Vorschuss** ("nog te ontvangen"). Erstattungen, die Mollie noch nicht einbehalten hat, stehen als zweite, getrennte Vorschusszeile bei Mollie ("nog in te houden"). Beim endgültigen Versand tritt an ihre Stelle die echte Auszahlung mit Bankgebühren, und Zahlungen, die nicht im Settlement waren, wandern als Vorschuss in den nächsten Entwurf. Solange der Bericht ein Entwurf ist, steht in Admisol die Dokumentreferenz als `PAYR/2026/0275 - Concept`; dieser Zusatz verschwindet beim endgültigen Versand. Wird der Bericht am nächsten Werktag endgültig, sendet Tillor ihn erneut, nun mit dem Mollie-Settlement, unter **derselben Dokumentnummer und demselben Buchungsdatum**.

Bei einem fehlgeschlagenen automatischen Versand erhalten Sie eine Meldung und es erscheint eine Zeile auf der Ereigniszeitleiste des Berichts.

## Manuell senden [#handmatig-versturen]

1. Gehen Sie zu **Verwaltung > Zahlungsberichte**
2. Öffnen Sie den Bericht, den Sie senden möchten
3. Klicken Sie auf **"An Buchhaltung senden"**

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Zahlungsbericht - An Buchhaltung senden" />

## Welche Zahlungen werden mitgesendet? [#welke-betalingen-gaan-mee]

Nur Zahlungen mit:

- **Mollie** als Provider, oder
- **Interne Überweisung** als Zahlungsmethode

Zahlungen über Bankkonten werden nicht an die Buchhaltung gesendet.

## Teilerstattung (Mollie) [#gedeeltelijke-terugbetaling-mollie]

Ist eine verknüpfte Mollie-Zahlung teilweise oder vollständig erstattet, sendet Tillor den **ursprünglichen Zahlungsbetrag** im Zahlungsbericht des **Mollie-Settlements, in dem die Zahlung eingegangen ist**. Die **Erstattung** kommt als negative Zeile in den Bericht des **Settlements, in dem Mollie den Refund abzieht** (Bezeichnung *Terugbetaling*). Das können spätere Settlements sein; mehrere Refunds erhalten jeweils eine eigene Zeile im Bericht ihres Settlements. So passt der Bericht zu dem, was Mollie tatsächlich auszahlt. Weil Refunds nur am Settlement-Tag gebucht werden, gehört keine zusätzliche Zeile auf das Wartekonto **499000** (*restant saldo*).

## Bankgebühren pro Mollie-Rechnung [#bankkosten-per-mollie-factuur]

Mollie behält seine Gebühren bei jeder Auszahlung ein und stellt sie einmal pro Monat in Rechnung. Tillor bucht die einbehaltenen Gebühren daher **pro Rechnungszeitraum**: Jede Zeile trägt den Monat, für den Mollie die Gebühren berechnet, zum Beispiel *Bankkosten 01/2026*. Eine Auszahlung in den ersten Tagen des Monats enthält oft noch Gebühren des Vormonats; diese stehen dann als eigene Zeile im selben Bericht.

Alle Zeilen desselben Zeitraums ergeben zusammen den Betrag der Mollie-Rechnung dieses Monats. Zeilen des laufenden Monats bleiben offen, bis Mollie die Rechnung ausstellt.

### Beim Lieferanten Mollie [#op-de-leverancier-mollie]

Die einbehaltenen Gebühren sind keine zweiten Kosten: Mollie bezahlt damit die eigene Rechnung. Tillor bucht sie daher beim **Lieferanten Mollie**, ohne Dokumentverweis. Die Kosten und die MwSt. kommen nur über die Mollie-Eingangsrechnung herein. Pro Monat gleichen Sie beim Lieferanten Mollie die Rechnung gegen die Zeilen *Bankkosten* dieses Zeitraums aus; sie sind zusammen gleich groß. Eine Korrektur über eine Diverse Buchung ist nicht nötig.

Mollie behält die Gebühren einer Zahlung meist schon ein, wenn die Zahlung eingeht, auch wenn die Auszahlung später folgt. Ein Entwurfsbericht bucht diese Gebühren daher bereits pro Rechnungszeitraum, und der Vorschuss bei Mollie ist der Betrag nach Gebühren. Eine Kartenzahlung, die Mollie noch zurückhält, hat noch keine einbehaltenen Gebühren: Diese kommen erst in den Bericht mit der Auszahlung. Bis dahin ist der Monat beim Lieferanten Mollie noch nicht vollständig.

Gleichen Sie in Admisol **keine Zeilen eines Entwurfsberichts aus** (Dokumentreferenz endet auf *- Concept*). Beim endgültigen Versand ersetzt Admisol die Zeilen des Berichts, und Ausgleiche auf diesen Zeilen können entfallen. Das kann auch passieren, wenn Sie einen endgültigen Bericht erneut senden, selbst wenn sich nichts geändert hat: Prüfen Sie danach die Ausgleiche beim Lieferanten Mollie.

## Saldoreserve [#balansreserve]

Mollie behält manchmal einen Teil der Auszahlung als **Saldoreserve** ein: Geld, das Ihnen noch zusteht, das Mollie aber vorübergehend zurückhält. Weil es weder Gebühr noch Erstattung ist, bucht Tillor diesen Betrag beim **Lieferanten Mollie** mit der Bezeichnung *Balansreserve*, genau wie die Auszahlung selbst. So bleibt es als offenes Guthaben bei Mollie stehen statt auf dem Wartekonto. Gibt Mollie die Reserve später wieder frei, erscheint im Bericht dieses Settlements eine gegenläufige *Balansreserve*-Zeile, die das Guthaben wieder ausbucht. Sie müssen dafür nichts tun; beim Lieferanten Mollie heben sich die beiden Zeilen gegenseitig auf.

## Rechnungen, die in Admisol bereits ausgeglichen sind [#facturen-die-in-admisol-al-afgepunt-zijn]

Admisol weist eine Zeile auf einer Rechnung oder Gutschrift ab, die Sie in Admisol manuell gegen eine andere Buchung als den Zahlungsbericht ausgeglichen haben. Tillor bucht die Zeilen dieser einen Rechnung dann beim Kunden **ohne Dokumentverweis**, damit der Bericht trotzdem durchgeht. Die Beträge und der Kunde bleiben gleich; nur die Verknüpfung mit der Rechnung gleichen Sie in Admisol selbst neu aus. Auf der Ereigniszeitleiste des Berichts steht im gesendeten XML, um welche Rechnung es geht.

## Buchhaltungsparameter [#boekhoudparameters]

Nach der Installation stellen Sie die Buchhaltungsparameter über **Einstellungen** in der Admisol-App ein (derselbe Bildschirm wie Company ID und Web Service Key). Dort stehen unter anderem Dokumenttypen für Rechnungen und Settlements, der Mollie-Lieferantencode, das Standard-Sachkonto für Rechnungszeilen und die Standardabteilung. Fehlende Felder erhalten Tillor-Standardwerte.

Unbekannte Mollie-Zahlungen werden auf das Wartekonto **499000** gebucht. Pro Zahlung können Sie über [Mollie-Metadaten](/ontwikkelaars/mollie-metadata#directe-boekhoudmetadata-tillorbookkeeping) auch Abteilung und Geschäftsjahr mitgeben.

### MwSt.-Regelungen [#btw-regimes]

Eine Rechnungszeile mit einer [Regelung ohne MwSt.](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) geht mit eigenem **Tax-Adressprofil** und **Tax-Code** an Admisol. Zusammen bestimmen diese, in welches Feld der MwSt.-Erklärung die Zeile kommt. Die Standardwerte sind die einer neuen Admisol-Akte:

| Regelung | Tax-Adressprofil | Tax-Code | Feld |
|----------|------------------|----------|------|
| Reverse-Charge (EU-Dienstleistungen) | `EU` | `vd21` | 44 |
| Reverse-Charge (Bauleistungen) | `MED` | `v21` | 45 |
| Innergemeinschaftliche Lieferung | `EU` | `v21` | 46 |
| Ausfuhr außerhalb der EU | `EXP` | `v21` | 47 |
| Umsatzsteuerfrei | `NA` | `v0` | 00 |

Verwendet Ihre Akte andere Codes, passen Sie sie bei den Buchhaltungsparametern an: Pro Regelung gibt es ein Feld für das Tax-Adressprofil und eines für den Tax-Code. Die Codes Ihrer Akte finden Sie in Admisol unter **Instellingen > BTW-instellingen > Tax-relaties**. Die Kundenkarte in Admisol behält ihr eigenes Tax-Adressprofil; nur die Rechnungszeile erhält das der Regelung.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Exact Online (/de-DE/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online)

Exact Online ist das Buchhaltungspaket, das viele niederländische Parks und ihre Büros nutzen. Tillor verbindet **Kunden**, **gebuchte Rechnungen** und **Zahlungsberichte** mit Exact Online. Die Anbindung ist **auf Anfrage verfügbar** - noch nicht als Selbstbedienung im App Marketplace.

<Callout type="info" title="Auf Anfrage">
Möchten Sie Tillor mit Exact Online verbinden? Beantragen Sie die Aktivierung über die [Demo](https://tillor.eu/demo) oder schreiben Sie an **support@tillor.eu**. Wir richten die Anbindung gemeinsam mit Ihrem Buchhalter ein.
</Callout>

## Was die Anbindung abdeckt [#wat-de-koppeling-dekt]

Der vorgesehene Export folgt derselben Kette wie bei [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) und [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo). Die genaue Zuordnung von Journalen und Erlöskonten stimmen wir bei der Aktivierung ab.

- **Kunden** aus Tillor nach Exact Online
- **Gebuchte Rechnungen** (Positionen und MwSt.)
- **Zahlungsberichte** - nur **Mollie** und **interne Überweisungen**, wie bei den anderen Buchhaltungsexporten

Zahlungen über Bankkonten stehen zwar im Tillor-Bericht, gehen aber nicht in den Buchhaltungsexport. Siehe [Buchhaltungssysteme](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Noch keine Selbstbedienung [#nog-geen-zelfbediening]

Exact Online finden Sie noch nicht unter **Einstellungen > Integrationen**. Auswahl der Administration, Sachkontenzuordnung und erster Export erfolgen gemeinsam mit dem Tillor-Support. Es gibt kein Installationsformular zum Selbstausfüllen.

<Callout type="warn" title="Ein aktives Buchhaltungssystem">
Tillor exportiert pro Organisation in ein Buchhaltungspaket. Nutzen Sie bereits Admisol oder Odoo, stimmen wir ab, welches System aktiv bleibt.
</Callout>

## Beantragen [#aanvragen]

1. Notieren Sie Ihre Exact-Online-Administration (Division) und ob Ihr Buchhalter mitliest.
2. Beantragen Sie die Anbindung über [tillor.eu/demo](https://tillor.eu/demo) oder **support@tillor.eu**.
3. Tillor plant die Aktivierung und die Zuordnung von Journalen und Erlöskonten.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Buchhaltungssysteme" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Übersicht (/de-DE/boekhouden/betalingsrapporten/boekhoudsystemen)

Tillor unterstützt die Integration mit Buchhaltungssoftware zum Versenden von Zahlungsberichten. Zahlungsberichte werden in das Format Ihres Buchhaltungspakets umgewandelt (derzeit Admisol) und automatisch oder manuell versendet. [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) ist auf Anfrage verfügbar.

## Unterstützte Systeme [#ondersteunde-systemen]

| System | Status |
|---------|--------|
| [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | Unterstützt |
| [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | Kunden und gebuchte Rechnungen |
| [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) | Auf Anfrage |

## Allgemein [#algemeen]

- **Automatisch**: Beim Erstellen oder bei einer wesentlichen Änderung eines Zahlungsberichts wird er an Admisol gesendet (nur wenn Admisol installiert ist)
- **Manuell**: Über **Verwaltung > Zahlungsberichte** → Bericht öffnen → **An Buchhaltung senden**
- **Welche Zahlungen**: Nur **Mollie** und **interne Überweisungen**. Bankkonten stehen zwar im Tillor-Bericht, gehen aber nicht in den Buchhaltungsexport.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Zahlungsbericht - manuell An Buchhaltung senden" />

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
</Cards>


# Odoo (/de-DE/boekhouden/betalingsrapporten/boekhoudsystemen/odoo)

Die Odoo-Verknüpfung in Tillor exportiert **Kunden** und **gebuchte Rechnungen** nach Odoo. Zahlungsberichte nach Odoo folgen in einem späteren Release. Bis dahin nutzen Sie [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol), wenn Sie Zahlungsberichte automatisch weiterleiten möchten.

## Installation [#installatie]

1. Gehen Sie zu **Einstellungen** und öffnen Sie den App Marketplace.
2. Suchen Sie die **Odoo**-Karte und klicken Sie auf **Installieren**.
3. Füllen Sie zuerst unter **Verbindung** Folgendes aus:
   - **Odoo-URL** - zum Beispiel `https://mijnbedrijf.odoo.com` oder nur `mijnbedrijf` (Tillor ergänzt dann die `.odoo.com`-URL)
   - **Benutzername** - Benutzer mit API-Zugriff
   - **API-Schlüssel** - API-Schlüssel (Odoo: Benutzerprofil > API-Schlüssel)
4. Klicken Sie auf **Weiter zur Datenbank**. Tillor ruft die verfügbaren Datenbanken ab (oder lässt Sie den Namen manuell eingeben).
5. Wählen Sie die Datenbank unter **Datenbank** und schließen Sie die Installation ab.

Beim Speichern testet Tillor die Verbindung.

<Callout type="info" title="Ein aktives Buchhaltungssystem">
Sind sowohl Admisol als auch Odoo installiert, verwendet Tillor **Admisol** für den Export (feste Priorität). Installieren Sie Odoo nur, wenn Sie Admisol nicht mehr nutzen.
</Callout>

## Buchhaltungsparameter (Odoo-App) [#boekhoudparameters-odoo-app]

Nach der Installation legen Sie die Exportparameter unter **Einstellungen** der Odoo-App fest (neben URL, Datenbank, Benutzer und API-Schlüssel). Tillor ruft Verkaufsjournale und Erlöskonten live aus Odoo ab. Sie wählen sie über ein Suchfeld (Code und Name).

| Feld in der App | Standard | Bedeutung |
|---|---|---|
| **Code Verkaufsjournal** | INV | Verkaufsjournal in Odoo mit diesem Code |
| **Standard-Erlöskonto** | 700000 | Erlöskonto, wenn die Rechnungszeile keine eigene Sachkontonummer hat |
| **Rechnungen automatisch buchen** | aus | Nach dem Export sofort in Odoo buchen |
| **Rechnungs-PDF anhängen** | ein | Tillor-Rechnungs-PDF als Anhang an der Odoo-Rechnung |
| **Peppol UBL anhängen** | ein | Peppol-UBL als zusätzlicher Anhang (nur wenn Tillor diese UBL bereits hat) |

Tillor sucht pro Rechnungszeile zuerst ein Odoo-Konto mit demselben Code wie die **Sachkontonummer** der Zeile, sonst das Standard-Erlöskonto. Für die MwSt. sucht Tillor in Odoo eine Verkaufssteuer mit demselben Prozentsatz wie auf der Zeile.

### MwSt.-Regime [#btw-regimes]

Eine Rechnungszeile mit einem [Regime ohne MwSt.](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), etwa Reverse Charge, braucht in Odoo eine eigene Verkaufssteuer: Eine gewöhnliche 0 % landet im falschen Feld Ihrer Steuererklärung. Tragen Sie daher bei den Exporteinstellungen für jedes Regime, das Sie verwenden, den **Namen der Verkaufssteuer in Odoo** ein, genau so, wie er in Odoo unter **Buchhaltung > Konfiguration > Steuern** steht (in einem belgischen Odoo zum Beispiel `0% EU S` für EU-Dienstleistungen). Es gibt fünf Felder: Reverse Charge (EU-Dienstleistungen), Reverse Charge (Vertragspartner), innergemeinschaftliche Lieferung, Ausfuhr außerhalb der EU und von der MwSt. befreit.

Ist das Feld eines Regimes leer oder existiert die Steuer in Odoo nicht, bricht der Export dieser Rechnung mit einer Fehlermeldung ab. Tragen Sie den Namen ein und senden Sie die Rechnung erneut.

## Rechnungs-PDF in Odoo [#factuur-pdf-in-odoo]

Mit **Rechnungs-PDF anhängen** (standardmäßig ein) lädt Tillor dieselbe PDF hoch wie in Tillor. Bei einem neuen Export geschieht das **vor** dem Buchen in Odoo, damit die Vorschau rechts an der Rechnung verknüpft werden kann. Der Dateiname folgt der Tillor-Rechnungsnummer (z. B. `INV_2026_0001.pdf`). Tillor setzt diese PDF auch als Hauptanhang an der Odoo-Rechnung.

Unter **Ereignisse** der Tillor-Rechnung sehen Sie, ob der Export gelungen ist, einschließlich Kunde, Rechnung, PDF und UBL.

- Existiert die Odoo-Rechnung bereits (gleiche Referenz: die Tillor-Rechnungsnummer), aktualisiert Tillor Kunde, Zeilen, Datumsangaben und Zahlungsreferenz. War die Rechnung in Odoo schon gebucht, setzt Tillor sie zuerst auf Entwurf zurück, passt die Daten an und bucht erneut, wenn **Rechnungen automatisch buchen** aktiviert ist oder die Rechnung bereits gebucht war.
- Danach werden PDF- und UBL-Anhänge ersetzt oder hinzugefügt, wenn diese Optionen aktiviert sind.
- Schlägt der Upload nach einer neu angelegten Entwurfsrechnung fehl, wird diese Odoo-Rechnung gelöscht, damit ein folgender Export es erneut versuchen kann.

## Peppol UBL in Odoo [#peppol-ubl-in-odoo]

Mit **Peppol UBL anhängen** (standardmäßig ein) lädt Tillor die Peppol-UBL als zusätzlichen Anhang an der Odoo-Rechnung hoch. Der Dateiname folgt der Tillor-Rechnungsnummer (z. B. `INV_2026_0001.xml`).

- Tillor erzeugt selbst keine UBL: Die Datei steht erst nach einer erfolgreichen Peppol-Zustellung bereit.
- Ist die UBL zum Zeitpunkt des Exports noch nicht fertig, überspringt Tillor den UBL-Anhang. Sobald die UBL eintrifft, wird sie nachträglich an die bestehende Odoo-Rechnung angehängt.
- Schlägt der UBL-Upload fehl, scheitert der gesamte Odoo-Export **nicht** (im Gegensatz zur PDF). Nur ein PDF-Fehler nach einer neuen Rechnung macht den Odoo-Entwurf rückgängig.

## Rechnungen [#facturen]

- Beim **Buchen** oder **erneuten Buchen** einer Rechnung exportiert Tillor die Rechnung automatisch nach Odoo.
- Manuell: Rechnungsaktionen > Export an die Buchhaltung (dieselbe Schaltfläche wie bei Admisol).
- Nur Rechnungen mit dem Status **Gebucht** werden exportiert.
- Existiert bereits eine Odoo-Rechnung mit derselben Tillor-Rechnungsnummer, wird keine zweite Rechnung angelegt. Tillor aktualisiert Kunde, Zeilen und Datumsangaben dieser Rechnung (zum Beispiel nach dem Verschieben zu einem anderen Kunden oder nach dem erneuten Buchen) und ersetzt PDF-/UBL-Anhänge, wenn diese Optionen aktiviert sind.
- Ändert sich die Rechnungs-PDF nach einer **Zahlung** (oder ein anderer Betrag auf dem Dokument), ersetzt Tillor den bestehenden PDF-Anhang in Odoo, sobald die neue PDF fertig ist. Es entsteht keine zweite Odoo-Rechnung und in Odoo wird keine Zahlung gebucht.

## Kunden [#klanten]

Kunden werden in Odoo mit der Tillor-Kundennummer als Referenz aktualisiert oder angelegt. Bestehende Partner mit derselben Nummer werden aktualisiert.

## Zahlungsberichte [#betalingsrapporten]

Das automatische und manuelle Senden von Zahlungsberichten nach Odoo ist **noch nicht verfügbar**. Der tägliche Zahlungsbericht-Prozess überspringt Odoo ohne Fehlermeldung.

## Voraussetzungen in Odoo [#vereisten-in-odoo]

- Verkaufsjournal mit dem eingestellten Code (standardmäßig `INV`)
- Sachkonten mit Codes, die mit Tillor-Zeilen oder dem Standard-Erlöskonto übereinstimmen
- Optional: Verkaufssteuersätze in Odoo mit denselben Prozentsätzen wie in Tillor

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Buchhaltungssysteme" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Übersicht (/de-DE/boekhouden/betalingsrapporten)

Ein **Zahlungsbericht** ist eine tägliche Übersicht der Zahlungen eines Kalendertags. Nummerierung: `PAYR/YYYY/DDDD` (Tag des Jahres, vier Ziffern; z. B. `PAYR/2026/0054`).

**Inhalt:** bekannte und unbekannte Zahlungen, die Mollie-Auszahlung (falls zutreffend) und nicht verknüpfte Banktransaktionen Ihrer Bankkonten. Eine Auszahlung von Mollie heißt in der Buchhaltung Settlement: der Betrag, den Mollie für eine Reihe von Zahlungen auf Ihr Bankkonto überweist.

Ihr Buchhalter arbeitet mit diesen Berichten. Sie müssen sie weder erstellen noch abschließen. Siehe auch [Wie hängt das zusammen?](/boekhouden#hoe-hangt-dit-samen).

## Entwurf und endgültig [#concept-en-definitief]

Ein Bericht hat einen **Status**:

| Status | Bedeutung |
|--------|-----------|
| **Entwurf** | Der Bericht des **laufenden Tages**. Zahlungen von heute (interne Umbuchungen, Bargeld, Bankkonten und Mollie) werden bereits verknüpft und der Bericht geht schon an die Buchhaltung. Mollie-Zahlungen stehen dort als **Vorschuss**: Geld, das Mollie noch auszahlen muss. Es gibt noch kein Mollie-Settlement und der Bericht wird noch nicht automatisch gedruckt. |
| **Endgültig** | Der Tag ist abgeschlossen. Tillor hat das Mollie-Settlement verknüpft (falls zutreffend), den Bericht gedruckt und die endgültige Version an die Buchhaltung gesendet. |

Der Entwurfsbericht von heute entsteht automatisch: beim Lauf um 09:00 Uhr oder früher, sobald Sie die erste manuelle Zahlung oder Bankkontozahlung des Tages erfassen. Sie müssen einen Entwurf nie selbst endgültig machen. Das tut Tillor beim nächsten täglichen Lauf, nachdem der Tag vorbei ist.

Einen Entwurf erkennen Sie an der **grauen, gepunktet unterstrichenen Berichtsnummer** und dem Badge **Entwurf**, in der Liste (Spalte und Filter **Status**), auf der Detailseite und überall dort, wo auf den Bericht verlinkt wird. Die PDF eines Entwurfs trägt **(Entwurf)** im Titel. Die Berichtsnummer und das Buchungsdatum in der Buchhaltung bleiben gleich, wenn der Entwurf endgültig wird.

### Mollie-Zahlungen im Entwurf [#mollie-betalingen-op-het-concept]

Jede bezahlte Mollie-Zahlung, die Mollie noch nicht ausgezahlt hat, kommt sofort in den offenen Entwurfsbericht. In der Buchhaltung steht die Summe als **Vorschuss beim Lieferanten Mollie**: So sehen Sie jederzeit, wie viel Sie noch von Mollie zu bekommen haben.

Ein **noch laufendes SEPA-Lastschriftverfahren** zählt auf dieselbe Weise mit, auch wenn der Einzug erst in einigen Tagen an Mollie geht. Die Rechnung steht in Tillor dann schon als bezahlt (in Bearbeitung), und so steht sie auch in der Buchhaltung. Schlägt der Einzug fehl oder wird er storniert, verschwindet die Zahlung wieder aus dem Entwurf.

Wird der Entwurf endgültig, vergleicht Tillor den Bericht mit dem Mollie-Settlement:

- Zahlungen, die **im Settlement** enthalten sind, bleiben im Bericht. Der Vorschuss wird durch die echte Auszahlung ersetzt, mit den Bankkosten.
- Zahlungen, die **nicht** darin enthalten sind (zum Beispiel Kreditkarte mit späterer Auszahlung oder Umsatz nach dem Abschluss von Mollie), rutschen in den **nächsten Entwurfsbericht** und bleiben dort als Vorschuss stehen.
- War eine Zahlung aus dem Settlement bereits in einem späteren Entwurf, holt Tillor sie in den Bericht des Settlements zurück.

Nur aktuelle Zahlungen kommen in Frage: im letzten Monat bezahlt und noch ohne Settlement bei Mollie.

**Erstattungen** zählen sofort mit. Eine Erstattung, die Mollie noch nicht von einer Auszahlung einbehalten hat, steht als negative Zeile im offenen Entwurf. In der Buchhaltung bleiben es zwei getrennte Vorschüsse auf Mollie: einer für die noch zu erhaltenden Zahlungen und einer für die noch einzubehaltenden Erstattungen. Sie werden nicht miteinander verrechnet. Das gilt auch, wenn die ursprüngliche Zahlung schon in einem älteren, endgültigen Bericht steht: Mollie behält den Betrag dann bei einer späteren Auszahlung ein. Sobald ein Settlement die Erstattung verrechnet, steht sie im Bericht dieses Settlements und verschwindet aus dem Entwurf.

<Callout type="info" title="Entwurf in der Buchhaltung">
Ein Entwurf geht an die Buchhaltung, sobald etwas darin steht, das die Buchhaltung bucht (eine Mollie-Zahlung oder eine interne Umbuchung). Danach sendet Tillor ihn nur erneut, wenn sich die Buchung ändert, jedes Mal unter derselben Dokumentnummer. Änderungen werden gebündelt: Der Versand geht etwa zehn Sekunden nach der letzten Änderung raus, spätestens nach einer Minute, sodass zum Beispiel das Zuweisen einer Zahlung zu einer Rechnung einen Versand ergibt. Ein Entwurf mit nur Barzahlungen oder Bankkontozahlungen wird also nicht gesendet, und eine zusätzliche Barzahlung löst keinen neuen Versand aus.
</Callout>

## Tägliche Erstellung [#dagelijkse-generatie]

Jeden **Werktag um 09:00 Uhr** (Montag bis Samstag, Zeitzone Europa/Brüssel) verarbeitet Tillor alle Berichte vom **1. Januar bis gestern**, die noch fehlen oder noch **Entwurf** sind, **von alt nach neu**: Entwürfe werden endgültig gemacht, fehlende Tage werden sofort als endgültiger Bericht angelegt. Pro Bericht wartet Tillor auf die Admisol-Antwort (Erfolg oder Fehler), bevor der nächste Bericht verarbeitet und gesendet wird. Danach öffnet Tillor den **Entwurfsbericht von heute**. Pro Organisation mit aktiver Mollie-Verknüpfung folgt anschließend eine **begrenzte** Synchronisierung: Berichte **ohne** Mollie-Settlement von **einem Kalendermonat vor gestern** bis gestern (siehe [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)).

```mermaid
flowchart TD
  start[Start Werktag 09:00] --> create[Entwürfe bis gestern endgültig machen<br/>fehlende Tage anlegen]
  create --> manual[Manuelle und Bankkontozahlungen<br/>am Berichtstag verknüpfen]
  manual --> rollover[Nicht ausgezahlte Mollie-Zahlungen<br/>in den nächsten Entwurf]
  rollover --> concept[Entwurfsbericht von heute öffnen]
  concept --> mollieCheck{Mollie aktiv?}
  mollieCheck -- nein --> done[Fertig]
  mollieCheck -- ja --> sync[Berichte ohne Settlement<br/>des letzten Monats aktualisieren]
  sync --> done
```

### Was steht in einem Bericht? [#wat-zit-in-een-rapport]

| Quelle | Wann verknüpft |
|------|-------------------|
| Manuelle Zahlungen | Kalendertag des Erstellungsdatums (Brüssel) |
| Bankkontozahlungen | Kalendertag des Zahlungsdatums (Brüssel) |
| Mollie | Settlement für Berichtstag D (siehe [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)) |

Bankkontozahlungen stehen **sehr wohl** im Tillor-Bericht für diesen Tag, gehen aber **nicht** in den Buchhaltungsexport (nur Mollie und interne Umbuchungen).

### Gestern ohne Mollie-Settlement [#gisteren-zonder-mollie-settlement]

Muss der Bericht von **gestern** noch endgültig werden (oder noch angelegt werden) und hat Mollie noch kein Settlement für gestern oder heute? Dann **wartet** Tillor bis zum nächsten Werktag. Der Bericht bleibt solange **Entwurf**. Ältere Tage ohne Settlement bekommen sehr wohl einen Bericht (manuell/Bankkonten). Mollie wird später bei der Synchronisierung noch verknüpft.

<Callout type="warn" title="Wochenende">
Der Umsatz von Samstag und Sonntag bekommt oft erst am Montagmorgen ein Mollie-Settlement. Dieses gehört zum **Sonntags**-Bericht (Regel D+1), nicht zum Montags-Bericht. Siehe [Beispiele auf der Mollie-Seite](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).
</Callout>

## Beispiele [#voorbeelden]

| Situation | Was Sie sehen |
|----------|-------------|
| Werktag, Settlement am nächsten Morgen | Der Bericht von **gestern** bekommt nachträglich Mollie (D+1-Regel) |
| Interne Umbuchung heute erfasst | Steht sofort im **Entwurfsbericht von heute** und geht an die Buchhaltung |
| Mollie-Zahlung heute erhalten | Steht sofort im Entwurf, in der Buchhaltung als Vorschuss auf Mollie |
| Mollie-Zahlung nicht im Settlement des Berichts | Rutscht beim Endgültigmachen in den nächsten Entwurf |
| Bericht von gestern noch Entwurf, kein Settlement | Tillor **wartet**, bis Mollie veröffentlicht (nächster Werktag 09:00); der Bericht bleibt Entwurf |
| Bericht bestand ohne Mollie | Der nächste Lauf um 09:00 ergänzt Settlement und Zahlungen |
| Bericht hatte schon eine Settlement-ID | Die ID **bleibt**; nur zusätzliche Zahlungen können noch verknüpft werden |

Weitere Datumsbeispiele (Wochenende, doppeltes Settlement): [Mollie > Beispiele](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

## Zahlungsbericht öffnen und navigieren [#betalingsrapport-openen-en-navigeren]

1. Gehen Sie zu **Verwaltung > Zahlungsberichte** (grüne Markierung **1** im Screenshot).
2. Öffnen Sie einen Bericht in der Liste.
3. Auf der Detailseite nutzen Sie in der Aktionsleiste rechts die Pfeile, um zum vorherigen oder nächsten Bericht zu gehen.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Zahlungsberichtsübersicht" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Zahlungsberichtsdetail - An Buchhaltung senden und Navigationspfeile" />

Wenn Sie mit der Maus über einen Pfeil fahren, sehen Sie zusätzlichen Kontext (Berichtsnummer, Datum und Anzahl der Zahlungen) des Berichts, zu dem Sie navigieren.

Rechts auf der Detailseite steht das **Ereignisprotokoll**. Dort sehen Sie, wann der Bericht angelegt wurde, wann er endgültig gemacht wurde und ob er an die Buchhaltung gesendet wurde.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Bericht von gestern bleibt Entwurf">
Mollie hat für gestern noch keine Auszahlung veröffentlicht. Tillor wartet dann bis zum nächsten Werktag um 09:00 Uhr. Der Bericht wird von selbst endgültig, Sie müssen nichts tun.
</Accordion>
<Accordion title="Eine Zahlung steht nicht im Bericht des Tages, den ich erwartet habe">
Eine Zahlung kommt in den Bericht des Tages, an dem sie eingegangen ist. Bei Bargeld und Überweisung ist das das **Eingangsdatum**, das Sie eingetragen haben. Passen Sie dieses Datum beim Erfassen an, siehe [Bargeld und Überweisung](/betalingsverwerking/contant).
</Accordion>
<Accordion title="Eine Mollie-Zahlung steht im nächsten Bericht">
Die Zahlung war nicht in der Auszahlung des Berichts enthalten. Sie rutscht in den nächsten Entwurf und bleibt dort als Vorschuss stehen, bis Mollie auszahlt.
</Accordion>
<Accordion title="Der Bericht steht nicht in meiner Buchhaltung">
Nur Mollie-Zahlungen und interne Umbuchungen gehen mit. Ein Bericht mit nur Barzahlungen oder Bankkontozahlungen wird nicht gesendet. Einen Fehler beim Senden finden Sie im **Ereignisprotokoll** des Berichts.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Buchhaltungssysteme" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Zahlungsmethoden" href="/boekhouden/betalingsrapporten/betaalmethodes" />
</Cards>

## Begriffe [#begrippen]

- **Zahlungsbericht**: die Tagesübersicht der Zahlungen eines Kalendertags, mit der Nummer `PAYR/Jahr/Tag`.
- **Entwurf**: der Bericht des laufenden Tages. Er kann sich noch ändern.
- **Endgültig**: der Tag ist abgeschlossen und der Bericht wurde an die Buchhaltung gesendet.
- **Vorschuss**: eine Mollie-Zahlung, die Mollie noch nicht ausgezahlt hat.
- **Settlement**: die Auszahlung von Mollie an Sie.


# Übersicht (/de-DE/boekhouden)

Hier übertragen Sie Zahlungen und Rechnungen aus Tillor in Ihre Buchhaltungssoftware. Tillor bündelt die Zahlungen pro Tag in einem Zahlungsbericht und leitet diesen Bericht weiter, damit Ihr Buchhalter nichts abtippen muss.

<Callout type="info" title="Gut zu wissen">
- Es gibt einen Zahlungsbericht pro Kalendertag. Der Bericht von heute existiert bereits als **Entwurf** und wird endgültig, sobald der Tag vorbei ist.
- Tillor verarbeitet die Berichte jeden Werktag (Montag bis Samstag) um 09:00 Uhr belgischer Zeit.
- Nur Mollie-Zahlungen und interne Umbuchungen gehen an die Buchhaltung. Bargeld, Überweisungen und Bankkonten stehen zwar im Bericht, werden aber nicht weitergeleitet.
- Mollie-Zahlungen werden alle 15 Minuten aktualisiert, Bankkonten alle 5 Minuten.
- Mollie zahlt meist am nächsten Tag aus. Für das Wochenende gibt es oft erst am Montagmorgen eine Auszahlung.
- Tillor bündelt Änderungen an einem Entwurf und versendet ihn etwa zehn Sekunden nach der letzten Änderung, spätestens nach einer Minute.
- Ein belgischer Kunde mit einer MwSt.-Nummer braucht eine Peppol-ID, bevor Sie eine Rechnung buchen können.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  F[Gebuchte Rechnung] --> B[Zahlung]
  B --> R[Zahlungsbericht des Tages]
  R -- Mollie und interne Umbuchungen --> X[Buchhaltungssoftware]
  R -- Bankkonten und Bargeld --> O[Nur Übersicht in Tillor]
```

- Eine Zahlung hängt an einer Rechnung. Siehe [Rechnungen](/facturen).
- Jede Zahlung steht im Bericht des Tages, an dem sie eingegangen ist.
- Eine Mollie-Zahlung steht zunächst als Vorschuss im Entwurfsbericht. Sobald Mollie auszahlt, wird dieser Vorschuss zur echten Auszahlung.
- Der Bericht geht an Ihre Buchhaltungssoftware. Welche Systeme möglich sind, lesen Sie unter [Buchhaltungssysteme](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Was leistet das? [#wat-doet-het]

- **Zahlungsberichte**: tägliche Übersichten mit der Nummer `PAYR/YYYY/DDDD`, wobei DDDD der Tag des Jahres ist
- **Buchhaltungssysteme**: Anbindung an Admisol, Odoo für Kunden und Rechnungen (Zahlungsberichte nach Odoo folgen später) und [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) auf Anfrage
- **Zahlungsmethoden**: Mollie, Bankkonten und interne Umbuchungen

**Beispiel:** Der Umsatz vom **20. Mai** wird am **21. Mai** ausgezahlt und steht im Bericht **`PAYR/2026/0140` (20. Mai)**. Weitere Beispiele: [Mollie-Beispiele](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

In der Web-App sehen Sie Zahlungen und Rechnungen wie unten gezeigt.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Zahlungsübersicht - Alle Zahlungen" />

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Rechnungsübersicht - Alle Rechnungen" />

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zahlungsberichte" href="/boekhouden/betalingsrapporten" />
  <Card title="Buchhaltungssysteme" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Zahlungsmethoden" href="/boekhouden/betalingsrapporten/betaalmethodes" />
  <Card title="MwSt. und Steuern" href="/boekhouden/belasting" />
  <Card title="Peppol" href="/boekhouden/peppol" />
  <Card title="Praxisbeispiele" href="/praktijk" />
</Cards>

## Begriffe [#begrippen]

- **Zahlungsbericht**: die Tagesübersicht der Zahlungen eines Kalendertags.
- **Entwurf**: der Bericht des laufenden Tages, der sich noch ändern kann.
- **Endgültig**: ein abgeschlossener Bericht, der an die Buchhaltung gesendet wurde.
- **Auszahlung (Settlement)**: der Betrag, den Mollie für eine Reihe von Zahlungen auf Ihr Bankkonto überweist.
- **Vorschuss auf Mollie**: Geld, das Mollie Ihnen noch auszahlen muss, so wie es in der Buchhaltung steht.
- **Hauptbuch**: die Kontonummer in Ihrer Buchhaltung. Siehe [Produkte](/producten).
- **Peppol**: das europäische Netzwerk, um Rechnungen direkt an das System des Empfängers zu senden. Siehe [Peppol](/boekhouden/peppol).


# Peppol (/de-DE/boekhouden/peppol)

Mit Peppol senden Sie eine Rechnung direkt an das Buchhaltungssystem des Empfängers, ohne PDF. Peppol ist das europäische Netzwerk für elektronische Rechnungsstellung. Bei Tillor läuft das automatisch: Hat ein Kunde eine Peppol-ID, geht die Rechnung nach dem Buchen von selbst mit.

## Wann nutzen Sie Peppol? [#wanneer-gebruik-je-peppol]

Peppol ist verpflichtend für:

- **Belgische B2B-Rechnungen** - das Versenden von Rechnungen an belgische Unternehmen mit einer MwSt.-Nummer
- **Öffentliche Aufträge** - Rechnungsstellung an Behörden in den meisten EU-Ländern

Für niederländische Kunden ist Peppol optional, wird aber unterstützt.

<Callout type="warn">
Ab 2026 ist Peppol für alle B2B-Rechnungen in Belgien verpflichtend. Stellen Sie sicher, dass die Peppol-IDs Ihrer belgischen Kunden korrekt eingerichtet sind.
</Callout>

## Peppol einrichten [#peppol-instellen]

### Peppol für Ihre Organisation [#peppol-voor-je-organisatie]

Peppol verwendet die **MwSt.-Nummer** und die **Adresse** Ihrer Organisation. Prüfen Sie, dass diese Daten unter **Einstellungen** korrekt hinterlegt sind.

Beim ersten Peppol-Versand registriert Tillor Ihre Organisation automatisch als Absender im Peppol-Netzwerk.

<Callout type="info">
Wenden Sie sich an den Tillor-Support, wenn Peppol für Ihre Organisation noch nicht verfügbar ist.
</Callout>

### Peppol-ID für einen Kunden einrichten [#peppol-id-instellen-voor-een-klant]

Für jeden Kunden, dem Sie über Peppol Rechnungen stellen möchten:

1. Gehen Sie zu *Kunden > [Kunde] > Rechnungen*
2. Öffnen Sie **Rechnungseinstellungen**
3. Geben Sie die **Peppol-ID** ein oder wählen Sie über das Suchsymbol einen Empfänger aus
4. Klicken Sie auf **Speichern**

<Callout type="warn">
Haben Sie einen belgischen Kunden mit einer MwSt.-Nummer? Dann können Sie keine Rechnung buchen, solange keine Peppol-ID eingerichtet ist.
</Callout>

## Einen Peppol-Empfänger suchen [#een-peppol-ontvanger-opzoeken]

Kennen Sie die Peppol-ID eines Kunden nicht? Verwenden Sie das Suchsymbol links neben dem Feld:

1. Gehen Sie zu *Kunden > [Kunde] > Rechnungen*
2. Klicken Sie auf das Suchsymbol links neben **Peppol-ID**
3. Tillor sucht automatisch anhand der MwSt.-Nummer des Kunden
4. Wählen Sie den richtigen Empfänger aus den Ergebnissen

<Callout type="info">
Nicht alle Unternehmen sind im Peppol-Netzwerk registriert. Wird ein Unternehmen nicht gefunden, können Sie die Rechnung weiterhin per E-Mail versenden.
</Callout>

## Rechnungen über Peppol versenden [#facturen-via-peppol-versturen]

Hat ein Kunde eine Peppol-ID hinterlegt, sendet Tillor die Rechnung nach dem Buchen automatisch über Peppol:

1. Erstellen Sie die Rechnung wie gewohnt
2. Prüfen Sie, dass die **Peppol-ID** des Kunden korrekt eingerichtet ist
3. Prüfen Sie Zeilen und Beträge auf der Entwurfsrechnung und klicken Sie dann auf **Rechnung buchen**

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Entwurfsrechnung mit Rechnung buchen" />

4. Tillor sendet die Rechnung automatisch über das Peppol-Netzwerk (meist innerhalb weniger Minuten nach dem Buchen)

### Versandstatus prüfen [#verzendstatus-controleren]

Öffnen Sie die gebuchte Rechnung und sehen Sie sich **Ereignisse** im rechten Bereich an. Dort sehen Sie, ob die Rechnung über Peppol gesendet wurde oder ob Versand oder Zustellung fehlgeschlagen ist.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Rechnung wird automatisch versendet, sobald Sie sie buchen. Sie müssen nichts senden.
- Eine Rechnung, die über Peppol gesendet wurde, erhält das Label **Über Peppol gesendet** in der Liste im Kundenprofil.
- Eine solche Rechnung können Sie nicht mehr auf Entwurf zurücksetzen und nicht zu einem anderen Kunden verschieben. Korrigieren Sie sie mit einer Gutschrift. Siehe [Eine Rechnung korrigieren](/facturen/corrigeren).
- Schlägt der Versand fehl, sehen Sie das unter **Ereignisse** an der Rechnung und es erscheint eine Meldung unter <UIPath>Kommunikation > Benachrichtigungen</UIPath>. Senden Sie die Rechnung dann per E-Mail, siehe [Eine Rechnung versenden](/facturen/versturen).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Rechnung kann nicht gebucht werden, weil der Kunde keine Peppol-ID hat">
Der Kunde ist Belgier und hat eine MwSt.-Nummer. Tragen Sie die Peppol-ID unter <UIPath>Kunden > Kunde > Rechnungen</UIPath>, **Rechnungseinstellungen** ein. Kennen Sie die ID nicht, verwenden Sie das Suchsymbol links neben dem Feld.
</Accordion>
<Accordion title="Ich finde den Empfänger nicht in den Suchergebnissen">
Nicht alle Unternehmen sind an Peppol angeschlossen. Senden Sie die Rechnung dann per E-Mail.
</Accordion>
<Accordion title="Die Rechnung wurde nicht über Peppol gesendet">
Prüfen Sie, ob die Peppol-ID des Kunden eingetragen ist, bevor Sie buchen.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Rechnungen" href="/facturen" description="Rechnungen erstellen und buchen" />
  <Card title="MwSt. & Steuern" href="/boekhouden/belasting" description="MwSt.-Nummern validieren" />
  <Card title="Buchhaltung" href="/boekhouden" description="Finanzübersicht" />
</Cards>


# Eine Rechnung oder Erinnerung senden (/de-DE/communicatie/e-mails)

Mit **Benachrichtigung senden** schicken Sie eine gebuchte Rechnung an den Kunden. Mit **Erinnerung senden** erinnern Sie den Kunden an eine offene Rechnung. Sie wählen selbst zwischen E-Mail, SMS, Post oder WhatsApp, und anschließend verfolgen Sie die Zustellung unter [Benachrichtigungen](/notificaties).

Tillor versendet diese Nachrichten nicht von selbst beim Buchen. Sie bestimmen, wann der Kunde etwas bekommt. Soll es automatisch geschehen, geht das mit einer [Automatisierung](/begrippen#automatisering).

Bevor Sie beginnen:

- Die Rechnung muss **gebucht** sein. Auf einer Entwurfsrechnung fehlt die Schaltfläche.
- Der Kunde hat mindestens eine E-Mail-Adresse, eine Telefonnummer oder eine vollständige Postadresse (Straße, Postleitzahl und Ort). Sonst sehen Sie **Benachrichtigung senden** nicht.
- Für eine Erinnerung muss noch ein Betrag offen sein. Bei einer bezahlten Rechnung gibt es keine Option **Erinnerung senden**.
- Pro Kanal muss die passende Angabe bekannt sein. Sonst ist der Kanal grau, mit der Meldung **Keine E-Mail-Adresse hinterlegt**, **Keine Telefonnummer hinterlegt** oder **Keine Postadresse hinterlegt**.

## Eine Rechnung senden [#een-factuur-versturen]

<Steps>
<Step>
### Die Rechnung öffnen [#open-de-factuur]
Gehen Sie zu <UIPath>Verwaltung > Rechnungen</UIPath> und öffnen Sie eine gebuchte Rechnung.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification-button.png" alt="Gebuchte Rechnung mit der Schaltfläche Benachrichtigung senden in der Aktionsleiste" />
</Step>
<Step>
### Auf Benachrichtigung senden klicken [#klik-op-verstuur-notificatie]
Das Fenster **Benachrichtigung senden** öffnet sich. Wählen Sie die Kanäle, über die der Kunde die Rechnung bekommt.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification.png" alt="Das Fenster Benachrichtigung senden mit E-Mail, SMS und Post" />
</Step>
<Step>
### Die Kanäle wählen und auf Senden klicken [#kies-de-kanalen-en-klik-op-versturen]
Tillor meldet **Benachrichtigung gesendet**. Klappt es nicht, sehen Sie **Benachrichtigung nicht gesendet**.
</Step>
</Steps>

So funktionieren die Kanäle:

| Kanal | Was der Kunde bekommt |
|---|---|
| **E-Mail** | Ist standardmäßig an. Die Rechnung hängt als PDF an der Nachricht, an die E-Mail-Adresse aus dem Kundenprofil |
| **SMS** | Ein kurzer Text mit dem persönlichen Link zur Rechnung |
| **Post** | Die Rechnung als Brief an die Postadresse aus dem Kundenprofil. Ist standardmäßig aus. Tillor zeigt einen Richtwert für das Porto pro Brief |
| **WhatsApp** | Erscheint, wenn Sie WhatsApp Business verknüpft haben. Ist das 24-Stunden-Fenster des Kunden geschlossen und haben Sie keine Zahlungsmethode bei Meta, blockiert Tillor den Versand |

## Eine Erinnerung senden [#een-aanmaning-versturen]

<Steps>
<Step>
### Das Menü neben Benachrichtigung senden öffnen [#open-het-menu-naast-verstuur-notificatie]
Klicken Sie auf den Pfeil neben der Schaltfläche und wählen Sie **Erinnerung senden**.
</Step>
<Step>
### Die Kanäle wählen [#kies-de-kanalen]
Bei einer Erinnerung ist **SMS** standardmäßig an, wenn der Kunde eine Telefonnummer hat. Wählen Sie **Post**, bekommt der Kunde einen Mahnbrief mit der Rechnung als Anlage und einem QR-Code auf dem Brief. Siehe [Eine Rechnung senden](/facturen/versturen).

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Erinnerung senden mit der Auswahl Post und Einschreiben" />
</Step>
<Step>
### Bestätigen [#bevestig]
Klicken Sie auf **Senden**. Haben Sie auch **Einschreiben mit Rückschein** gewählt, steht dort **Mit Zusatzkosten senden**. Diese Option gibt es nur, wenn Einschreiben im Land der Postadresse unterstützt wird. Tillor berechnet die zusätzlichen Kosten Ihrer Organisation.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Nachricht erscheint unter <UIPath>Kommunikation > Benachrichtigungen</UIPath> mit Kanal, Status und einem Link zur Rechnung. Sie sehen sie auch beim Kunden.
- E-Mail und SMS starten auf <Status tone="info">Ausstehend</Status> und werden <Status tone="success">Gesendet</Status>, sobald sie zugestellt sind. Der Kunde kann die Nachricht lesen und auf den Link klicken. Beides sehen Sie im Detailfenster.
- Bei Post wird der Status <Status tone="success">Gesendet</Status>, sobald der Postdienst bestätigt, dass der Brief unterwegs oder zugestellt ist. Bei Post sehen Sie das Porto zum Zeitpunkt des Versands, bei Einschreiben auch den Zusatzbetrag.
- Hängt eine Nachricht länger als 5 Minuten fest, versucht Tillor es erneut. Nach 2 Tagen ohne Versand wird sie <Status tone="error">Fehlgeschlagen</Status>.
- Schlägt die Nachricht fehl, bleibt die Rechnung, wie sie war. Sie können jederzeit erneut senden.

Möchten Sie, dass Tillor selbst reagiert, zum Beispiel indem ein Kollege benachrichtigt wird, wenn eine Erinnerung fehlschlägt? Dafür können Sie eine [Automatisierung](/begrippen#automatisering) erstellen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe die Schaltfläche Benachrichtigung senden nicht">
Die Rechnung ist noch ein Entwurf, oder der Kunde hat weder E-Mail-Adresse noch Telefonnummer noch vollständige Postadresse. Buchen Sie die Rechnung oder ergänzen Sie eine dieser Angaben im Kundenprofil.
</Accordion>
<Accordion title="Ich sehe Erinnerung senden nicht im Menü">
Die Rechnung ist bereits bezahlt oder noch nicht gebucht. Eine Erinnerung ist nur für eine gebuchte Rechnung möglich, bei der noch ein Betrag offen ist.
</Accordion>
<Accordion title="Ein Kanal ist grau mit Keine E-Mail-Adresse hinterlegt">
Die Angabe fehlt im Kundenprofil. Fügen Sie die E-Mail-Adresse, die Telefonnummer oder die Postadresse hinzu und öffnen Sie das Fenster erneut.
</Accordion>
<Accordion title="Tillor meldet Benachrichtigung nicht gesendet">
Öffnen Sie <UIPath>Kommunikation > Benachrichtigungen</UIPath> und klicken Sie auf den Kanal der Nachricht. Im Detailfenster steht die Fehlermeldung. Meist stimmt die Adresse oder Nummer nicht. Passen Sie sie im Kundenprofil an und senden Sie erneut.
</Accordion>
<Accordion title="Ich sehe Einschreiben nicht bei Post">
Einschreiben ist nur an Postadressen in Ländern möglich, in denen Tillor das unterstützt. Für andere Adressen bleibt normale Post möglich.
</Accordion>
<Accordion title="Der Kunde sagt, er habe nichts erhalten">
Prüfen Sie unter <UIPath>Kommunikation > Benachrichtigungen</UIPath> den Status. Steht die Nachricht auf **Zurückgewiesen**, existiert die Adresse nicht. Steht sie auf **Gesendet**, bitten Sie den Kunden, seinen Spam-Ordner zu prüfen. Siehe [Benachrichtigungen](/notificaties#problemen).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Benachrichtigungen" href="/notificaties" description="Zustellstatus gesendeter Nachrichten" />
  <Card title="Benachrichtigungsarten" href="/communicatie/notificatietypes" description="Alle Arten von Nachrichten, die Tillor versendet" />
  <Card title="Eine Rechnung senden" href="/facturen/versturen" description="Post, QR-Code und Mahnbriefe" />
</Cards>


# Übersicht (/de-DE/communicatie)

Unter Kommunikation verfolgen Sie alles, was zwischen Ihrem Park und Ihren Kunden gesagt oder gesendet wird: Telefonanrufe, Nachrichten, die Tillor versendet, und interne Kommentare. Hier bestimmen Sie auch, welche Nachrichten an einen Kunden gehen, und sehen, ob sie angekommen sind. Gespräche, die Kunden über Chat oder soziale Medien beginnen, stehen in der [Inbox](/inbox).

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Übersicht der Telefonanrufe unter Kommunikation" />

<Callout type="info" title="Gut zu wissen">
- Eine Rechnungsnachricht oder Erinnerung geht beim Buchen nie von selbst raus. Sie starten sie selbst, oder eine [Automatisierung](/begrippen#automatisering)
- Hängt eine Nachricht länger als 5 Minuten fest, versucht Tillor es erneut. Nach 2 Tagen ohne Versand steht sie auf **Fehlgeschlagen**
- Eine SMS mit Organisationsdetails können Sie nur während eines laufenden Anrufs senden, über das Panel unten rechts
- Eine neue Nachricht in der Inbox erscheint als Karte unten rechts und verschwindet nach etwa zehn Sekunden
- Telefonanrufe kommen erst an, nachdem Voys installiert ist und der Anrufplan auf Tillor verweist
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Die gesamte Kommunikation mit einem Kunden läuft im Kundenprofil zusammen. Was hinausgeht und was hereinkommt, läuft über verschiedene Kanäle.

```mermaid
flowchart LR
  K[Kunde] -->|ruft an| T[Telefonanrufe]
  K -->|Chat, WhatsApp, Messenger, Instagram| I[Inbox]
  P[Park] -->|Rechnung oder Erinnerung| N[Benachrichtigungen]
  N -->|E-Mail, SMS, Post, WhatsApp| K
  P -->|interner Kommentar| O[Kommentare]
  T --> KP[Kundenprofil]
  I --> KP
  N --> KP
```

- **Anrufe** kommen über Ihren Telefonanbieter herein und hängen über die Telefonnummer am Kunden.
- **Nachrichten von Kunden** über Chat oder soziale Medien kommen in die Inbox.
- **Nachrichten an Kunden** senden Sie von einer Rechnung aus. Die Zustellung verfolgen Sie unter Benachrichtigungen.
- **Kommentare** sind intern. Kunden sehen sie nicht.

## Bereiche [#onderdelen]

<Cards>
  <Card title="Inbox" href="/inbox" description="WhatsApp, Messenger, Instagram und Website-Chat an einem Ort" />
  <Card title="Telefonanrufe" href="/communicatie/telefoongesprekken" description="Anrufe nachverfolgen, Aufnahmen anhören und Daten per SMS senden" />
  <Card title="Eine Rechnung oder Erinnerung senden" href="/communicatie/e-mails" description="Selbst eine Nachricht an einen Kunden senden" />
  <Card title="Benachrichtigungen" href="/notificaties" description="Zustellstatus gesendeter Nachrichten ansehen" />
  <Card title="Benachrichtigungsarten" href="/communicatie/notificatietypes" description="Alle Arten von Nachrichten und wann sie rausgehen" />
  <Card title="Kommentare" href="/notities" description="Interne Kommentare zu Kunden, Rechnungen und anderen Datensätzen" />
  <Card title="Anbieter" href="/communicatie/providers" description="Voys und Twilio: wer anruft und wer SMS versendet" />
</Cards>

## Begriffe [#begrippen]

- **Telefonanbieter**: das Unternehmen, das Ihre Telefonleitung liefert, zum Beispiel Voys.
- **Benachrichtigung**: eine Nachricht, die Tillor an einen Kunden oder [Benutzer](/begrippen#gebruiker) sendet.
- **Kanal**: der Weg, über den eine Nachricht geht, etwa E-Mail, SMS, Post oder WhatsApp.
- **Inbox**: der Ort, an dem Nachrichten von Kunden über Chat und soziale Medien eingehen.
- **Kommentar**: eine interne Notiz an einem [Kunden](/begrippen#klant), einer Rechnung oder einem anderen Datensatz.

Weitere Begriffe finden Sie im [Glossar](/begrippen).


# Benachrichtigungsarten (/de-DE/communicatie/notificatietypes)

Diese Liste zeigt jede Art von Nachricht, der Sie in der [Benachrichtigungsübersicht](/notificaties) begegnen können, und wann Tillor sie versendet. Die Art sehen Sie in der Spalte **Art** und können mit dem Filter **Art** danach filtern. Die Namen entsprechen dem Bildschirm.

Nachrichten an Kunden gehen per E-Mail, SMS, Post oder WhatsApp. Nachrichten an Kollegen gehen per Push, E-Mail oder Telefon, gemäß den Einstellungen des jeweiligen Kollegen. Siehe [Meldungen in der App](/notificaties#meldingen-in-de-app).

<Callout type="info" title="Rechnungsnachrichten gehen nicht von selbst raus">
Nachrichten wie **Neue Rechnung** oder **Rechnungserinnerung** versendet Tillor beim Buchen einer Rechnung nicht automatisch. Sie starten sie mit **Benachrichtigung senden** oder **Erinnerung senden** an der Rechnung. Siehe [Eine Rechnung oder Erinnerung senden](/communicatie/e-mails).
</Callout>

## Rechnungen und Zahlungen [#facturen-en-betalingen]

| Art | Wann sie versendet wird |
|---|---|
| Neue Rechnung | An den Kunden, wenn Sie eine Rechnung senden. Die Rechnung hängt als Anlage an der Nachricht |
| Rechnung bezahlt | An den Kunden, wenn eine Rechnung bezahlt ist |
| Rechnungserinnerung | An den Kunden, als Erinnerung an eine offene Rechnung |
| Erinnerung Überweisung | An den Kunden, der per Überweisung zahlt, mit dem Tipp, den strukturierten Verwendungszweck zu verwenden |
| Rechnungsarchiv | An die Support-Adresse Ihrer Organisation, mit Ihrem Buchhalter in Kopie, wenn ein Rechnungsarchiv bereitsteht |
| Peppol Rechnungsversand fehlgeschlagen | Wenn eine Rechnung nicht über Peppol gesendet werden konnte |
| Rechnung konnte nicht an Buchhaltungssoftware gesendet werden | Wenn die Weiterleitung einer Rechnung an Ihre Buchhaltungssoftware fehlschlägt |
| Rechnungsexport an Buchhaltungssoftware wiederhergestellt | Wenn diese Weiterleitung nach früheren Meldungen doch noch gelungen ist |
| Zahlungsbericht konnte nicht an Buchhaltungssoftware gesendet werden | Wenn die Weiterleitung eines Zahlungsberichts fehlschlägt |
| Zurückgesetzte Rechnungen erneut gebucht | Wenn zurückgesetzte Rechnungen nachts automatisch erneut gebucht wurden |
| Bankzahlung gleicht Rechnung nicht aus | Wenn eine Bankzahlung mit einer Rechnung verknüpft ist, die Rechnung danach aber noch offen ist |
| Verbrauch deutlich über dem Üblichen, von der automatischen Abrechnung zurückgehalten | Wenn ein Kunde nicht automatisch abgerechnet wurde, weil Strom oder Wasser weit über dem Üblichen liegt |
| Geplanter Produktpreis angewendet | An Ihre Organisation, an dem Tag, an dem ein [geplanter Preis](/producten/prijzen-plannen) gilt. Alter und neuer Preis stehen nebeneinander |
| Maschinenstart Auto-Rückerstattung | Wenn eine Online-Zahlung für einen Maschinenstart erstattet wurde, weil die Maschine nicht startete |
| Prüfung Offline-NFC-Zahlungen | Wenn Offline-NFC-Zahlungen nach der Synchronisierung nicht geprüft werden konnten |
| NFC-Tag niedriger Kontostand | An den Kunden, wenn das Guthaben eines NFC-Tags niedrig ist |

## SEPA-Mandate und Unterzeichnen [#sepa-mandaten-en-ondertekenen]

| Art | Wann sie versendet wird |
|---|---|
| SEPA-Mandat zur Unterschrift | An den Kunden mit dem Link zum Unterschreiben des Mandats, auch für die Erinnerungen, bevor der Link abläuft |
| Bestätigungscode SEPA-Mandat | An den Kunden mit dem Code, den er auf der Unterschriftsseite eingibt, per SMS oder E-Mail |
| Kopie des unterschriebenen SEPA-Mandats | An den Kunden, sobald das Mandat aktiv ist |
| SEPA-Mandat widerrufen | An den Kunden, mit dem unterschriebenen Dokument noch einmal als Anlage |
| Signaturanfrage | An einen Unterzeichner, wenn er an der Reihe ist, per E-Mail oder per SMS, wenn es keine E-Mail-Adresse gibt |
| Signaturcode | An den Unterzeichner mit dem Code zum Unterschreiben, per SMS oder E-Mail |
| Unterschriebenes Dokument | An alle Unterzeichner mit der unterschriebenen PDF, sobald der Letzte unterschrieben hat |
| Unterschrift abgelehnt | An den Kollegen, der die Anfrage gesendet hat, wenn ein Unterzeichner ablehnt |
| AVV-Annahme | Bestätigung der AVV-Annahme, mit dem unterschriebenen AVV als Anlage |
| AVV-Bestätigungscode | Per SMS an den Verantwortlichen mit dem Code zur Annahme des Auftragsverarbeitungsvertrags |

## Zähler, Controller und Zugang [#meters-controllers-en-toegang]

| Art | Wann sie versendet wird |
|---|---|
| Zähleralarm | Wenn ein Zähler einen neuen Alarm hat |
| Zähleralarm behoben | Wenn ein Zähleralarm behoben ist |
| Zählerentfernung | Wenn Zähler entfernt wurden |
| Zähler benötigen Aufmerksamkeit | Übersicht der Zähler, deren Messwerte ausbleiben oder die schon lange einen Alarm haben |
| Controller nicht erreichbar | Wenn ein Controller länger als 5 Minuten kein Lebenszeichen gibt |
| Controller überhitzt | Dringende Meldung, wenn ein Controller zu heiß wird |
| Connector nicht erreichbar | Wenn der Connector Ihres Parks kein Lebenszeichen mehr gibt |
| Connector wieder online | Wenn der Connector wieder erreichbar ist |
| Connector-HTTP-Gateway ausgefallen | Wenn der Connector noch läuft, Kameras ihn aber nicht mehr erreichen |
| LPR-Kamera offline | Wenn eine Kennzeichenkamera länger als 5 Minuten nicht reagiert |
| Zugangspunkt zu lange offen | Wenn ein Zugangspunkt länger offen steht als erlaubt |
| Übersicht der Ausfahrten abgelaufener Kennzeichen | Zusammenfassung von Fahrzeugen mit abgelaufenem Zugangszeitraum, die ausgefahren sind, während die Rezeption geschlossen war |
| QR-Zugangscode | An den Kunden mit dem QR-Code für den Zugang |
| Tablet oder Kiosk offline | Wenn ein Tablet oder Kiosk außerhalb seiner Ruhezeit kein Lebenszeichen gibt |
| Akku von Tablet oder Kiosk fast leer | Wenn ein Tablet oder Kiosk fast leer ist und nicht lädt |

## Aufgaben, Kommentare und Inbox [#taken-opmerkingen-en-inbox]

| Art | Wann sie versendet wird |
|---|---|
| Aufgabe zugewiesen | An den Kollegen, dem eine Aufgabe zugewiesen wurde |
| Aufgabe entzogen | An den Kollegen, dem eine Aufgabe weggenommen wurde |
| Aufgabe abgeschlossen | Wenn eine Aufgabe abgeschlossen ist |
| Aufgabenerinnerung | Wenn der Erinnerungszeitpunkt einer Aufgabe erreicht ist |
| Aufgabenfrist | Wenn eine Aufgabe ihre Frist erreicht, ohne abgeschlossen zu sein |
| Tägliche Zusammenfassung einer Ansicht | Per E-Mail, die tägliche Zusammenfassung einer Aufgabenansicht, der Sie folgen |
| Kommentar-Antwort | Jemand hat auf einen Kommentar geantwortet |
| Kommentar-Erwähnung | Sie wurden in einem Kommentar erwähnt |
| Kommentar gelöst | Ein Kommentar wurde als gelöst markiert |
| Kommentarantwort abgelehnt | Wenn eine E-Mail-Antwort auf einen Kommentar nicht gepostet wurde, weil die Absenderadresse nicht stimmt |
| Posteingang-Nachricht | Wenn eine neue Nachricht in der Inbox eingeht |
| Dringende KI-Übergabe | Wenn der KI-Assistent ein dringendes Gespräch an Sie übergibt |
| Website-Chat-Erinnerung | An einen Websitebesucher mit einer ungelesenen Antwort, mit einem Link, um das Gespräch fortzusetzen |

## Automatisierungen und Integrationen [#automatiseringen-en-integraties]

| Art | Wann sie versendet wird |
|---|---|
| Automatisierungsnachricht | Text, den eine Automatisierung an einen Kunden sendet |
| Automatisierungshinweis | Hinweis, den eine Automatisierung an einen Kollegen sendet, per Push, E-Mail oder beides |
| Automatisierungslauf fehlgeschlagen | An den Ersteller einer Automatisierung, wenn ein Lauf mit einem Fehler endete |
| Webhook-Zustellung fehlgeschlagen | Wenn Zustellungen an Ihren Webhook fehlschlagen und Tillor es weiter versucht |
| Webhook-Zustellung endgültig fehlgeschlagen | Wenn Tillor nach allen Versuchen ein Webhook-Event nicht zustellen konnte |
| Externe Benachrichtigung | Nachricht, die ein verknüpftes System selbst gesendet hat, siehe [Externe Benachrichtigungen](/notificaties#externe-notificaties) |

Ein Webhook ist eine Verknüpfung, mit der Tillor ein Ereignis automatisch an ein anderes System weitergibt.

## Konto und Organisation [#account-en-organisatie]

| Art | Wann sie versendet wird |
|---|---|
| Benutzer-Begrüßung | Willkommensnachricht für einen neuen Benutzer |
| E-Mail-Verifizierung | Der Link, um eine E-Mail-Adresse zu bestätigen |
| Organisationseinladung | Einladung für jemanden ohne Tillor-Konto, Mitglied Ihrer Organisation zu werden |
| Organisationsdetails | SMS an einen Anrufer mit einem Link zu den Daten Ihrer Organisation |
| Kontaktformular-Einreichung | Wenn jemand das Kontaktformular ausfüllt |
| Erinnerung Öffnungszeiten Feiertag | Erinnerung, die Öffnungszeiten für einen kommenden Feiertag einzutragen |
| Dokument gelöscht | An den Benutzer, der ein Dokument gelöscht hat |

## Meldungen des Tillor-Teams [#meldingen-van-het-tillor-team]

Diese Nachrichten sind für das Tillor-Team gedacht und Sie sehen sie normalerweise nicht: **Systemvorfall**, **Sicherheitswarnung**, **Grafana-Alarm** und **Ausfall des LoRa-Gateways**.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Benachrichtigungen" href="/notificaties" description="Zustellstatus und Meldungen in der App" />
  <Card title="Eine Rechnung oder Erinnerung senden" href="/communicatie/e-mails" description="Selbst eine Nachricht senden" />
  <Card title="Automatisierungen" href="/automatiseringen" description="Nachrichten durch eine Automatisierung" />
</Cards>


# Übersicht (/de-DE/communicatie/providers)

Über einen Telefonanbieter wie Voys sieht Tillor, wer anruft, und speichert Anrufe, Aufnahmen und Transkriptionen. Sie verknüpfen den Anbieter über <UIPath>Einstellungen > Integrationen</UIPath>. Twilio ist kein Telefonanbieter: Es versendet die SMS-Nachrichten von Tillor und wurde von Tillor selbst eingerichtet.

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Einstellungen > Integrationen" />

## Verfügbare Anbieter [#beschikbare-providers]

<Cards>
  <Card
    title="Voys"
    href="/communicatie/providers/voys"
    description="Eingehende Telefonanrufe mit Kundenprofilen verknüpfen"
  />
  <Card
    title="Twilio"
    href="/communicatie/providers/twilio"
    description="SMS- und WhatsApp-Zustellung über eine Plattformeinstellung"
  />
  <Card title="Inbox" href="/inbox" description="Messenger und WhatsApp Business für die Omnichannel-Inbox" />
</Cards>


# Twilio (/de-DE/communicatie/providers/twilio)

Twilio versendet im Namen von Tillor die SMS-Nachrichten und, sofern eingerichtet, WhatsApp-Benachrichtigungen. Es ist kein Telefonieanbieter wie Voys und Sie installieren es nicht selbst: Tillor hat es für die gesamte Plattform eingerichtet.

## Unterschied zu Voys [#verschil-met-voys]

| | Voys | Twilio |
|---|---|---|
| Telefonie (Anrufe, Gespräche) | Ja | Nein |
| Konfiguration in Tillor | **Einstellungen > Integrationen** | Nein - Plattformeinstellung |
| Sichtbar für Benutzer | Anrufe, Aufnahmen, Transkriptionen | Gesendete SMS und WhatsApp-Benachrichtigungen |

## Was macht Twilio in Tillor? [#wat-doet-twilio-in-tillor]

Sobald Twilio eingerichtet ist, verwendet Tillor es unter anderem für:

- **SMS-Benachrichtigungen** versenden (zum Beispiel Zahlungserinnerungen, Buchungsbestätigungen und Rechnungsbenachrichtigungen)
- **Organisationsdetails per SMS** senden aus **Kommunikation > Telefonanrufe** (SMS-Schaltfläche mit dem Tooltip **Organisationsdetails per SMS an den Anrufer senden**)
- **WhatsApp-Benachrichtigungen** zustellen, wenn WhatsApp über Twilio auf der Plattform eingerichtet ist
- **SMS-Bestätigungscodes** verwenden beim Unterzeichnen des Auftragsverarbeitungsvertrags (AVV)

Gesendete SMS und WhatsApp-Benachrichtigungen verfolgen Sie unter **Kommunikation > Benachrichtigungen**:

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Benachrichtigungsübersicht - Zustellstatus von Nachrichten" />

<Callout type="info">
Twilio richten Sie nicht selbst in Tillor ein. Fragen Sie Ihren Plattformadministrator oder den Tillor-Support nach der passenden Verknüpfung für Ihre Umgebung.
</Callout>

## Keine Installation unter Integrationen [#geen-installatie-in-integraties]

Anders als Voys finden Sie Twilio **nicht** unter **Einstellungen > Integrationen**. Die Verknüpfung wird vom Administrator der Tillor-Umgebung verwaltet.

## Siehe auch [#zie-ook]

<Cards>
  <Card
    title="Voys Telefonie"
    href="/communicatie/providers/voys"
    description="Telefonie-Integration für Anrufe"
  />
  <Card
    title="Telefonanrufe"
    href="/communicatie/telefoongesprekken"
    description="Organisationsdetails per SMS senden"
  />
</Cards>


# Voys Telefonie (/de-DE/communicatie/providers/voys)

Mit der Voys-Integration sieht Tillor, wer anruft, und zeigt sofort die Kundendaten an. Anrufe, Aufnahmen und Transkriptionen landen anschließend unter [Telefonanrufe](/communicatie/telefoongesprekken). Voys ist ein Telefonanbieter für Unternehmen.

Bevor Sie beginnen:

- Sie benötigen ein aktives Voys-VoIP-Konto und Zugriff auf die Einstellungen des Anrufplans in Voys.
- Sie benötigen die Berechtigung **Integrationen verwalten**.
- Die Telefonnummer des Anrufers muss im Kundenprofil oder bei einer Kontaktperson stehen, sonst verknüpft Tillor den Anruf nicht mit einem Kunden.

<DocScreenshot src="/screenshots/communicatie/providers/voys/incoming-call.png" alt="Eingehender Anruf auf dem Dashboard" />

## Voys einrichten [#voys-instellen]

1. Gehen Sie zu **Einstellungen** (Seitenleiste unter **Support**)

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-nav.png" alt="Navigation zu Einstellungen" />

2. Wählen Sie **Integrationen** und öffnen Sie **Voys** in der Liste
3. Tragen Sie auf der Detailseite Ihre Voys-Zugangsdaten ein (`username`, `password`, `client_uuid`, `token`) und klicken Sie auf **Installieren**

Sie benötigen ein aktives Voys-VoIP-Konto.

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-voys.png" alt="Einstellungen > Integrationen - Voys in der Liste" />

<Callout type="info">
Nach Installation und Konfiguration verknüpft Tillor Anrufe automatisch mit Kunden, wenn die Telefonnummer mit einem Kunden oder Kontakt übereinstimmt.
</Callout>

## URLs für Voys wiederfinden [#urls-voor-voys-terugvinden]

Tillor und Voys kommunizieren über Adressen (URLs). Bei manchen Schritten erwartet Voys eine Antwort von Tillor, zum Beispiel ob Sie geöffnet haben. Diese Antwort lautet **ACK** (ja, weiter) oder **NAK** (nein, den anderen Pfad nehmen). Ein Webhook ist eine Adresse, die Voys während eines Anrufs aufruft.


Für Webhooks, Anrufernamen-Suche und Zugangscodes verwenden Sie die URLs, die Tillor für Sie erzeugt.

1. Gehen Sie zu **Einstellungen > Integrationen** und öffnen Sie **Voys**
2. Nach der Installation steht auf der Detailseite unter **Einstellungen** der Block **Zu konfigurierende URLs** - kopieren Sie dort die passende URL für den jeweiligen Zweck

Unter anderem finden Sie hier:

- **Gesprächsbenachrichtigungen** - Webhook-URL für Anrufereignisse
- **Webhook für Anrufer-Suche** - URL für die Anrufernamen-Suche (Caller Name Lookup) in Ihrem Voys-Anrufplan
- **XML-Telefonbuch** - URL, über die VoIP-Telefone das Telefonbuch abrufen
- **Zugangscodes** - URL zur Bedienung des Zugangspunkts (Schranke, Tor oder Tür) über den Anrufplan
- **Webhook für Öffnungszeiten** - ACK, wenn Tillor geöffnet ist, NAK, wenn Tillor geschlossen ist
- **Webhook Anrufer erlaubt** - ACK, wenn der Anrufer durchgestellt werden darf, NAK, wenn der Anrufer auf die Mailbox soll
- **Routing-Webhook** - ACK mit einem Ziel, NAK, wenn kein Ziel eingestellt ist

Verwenden Sie im Voys-Anrufplan dieselben Variablen, die in Tillor angegeben sind (wie `{callerid}`, `{did}`, `{callername}`, `{callid}` und `{code}`).

<DocScreenshot src="/screenshots/communicatie/providers/voys/config-urls-dialog.png" alt="Voys-Details - Zu konfigurierende URLs auf der Seite" />

## Gesprächsbenachrichtigungen in Voys konfigurieren [#gespreksnotificaties-in-voys-configureren]

1. Öffnen Sie in Voys das Modul [Gesprächsbenachrichtigungen](https://freedom.voys.nl/redirect/CallNotification)
2. Klicken Sie auf **Hinzufügen**
3. Wählen Sie bei Paket/Service die Option **Benutzerdefiniert**
4. Fügen Sie die Tillor-URL aus **Gesprächsbenachrichtigungen** ein
5. Speichern Sie

Voys-Dokumentation:

- [Gesprächsbenachrichtigungen](https://help.voys.nl/gespreksnotificaties)

## Anrufernamen (Caller Lookup) im Anrufplan konfigurieren [#bellernamen-caller-lookup-in-call-plan-configureren]

Für die Anrufernamen-Suche verwenden Sie in Voys einen Webhook-Schritt im Anrufplan.

1. Öffnen Sie in Tillor die URL **Webhook für Anrufer-Suche** (unter **Einstellungen > Integrationen > Voys**, bei **Zu konfigurierende URLs**) und kopieren Sie diese URL
2. Öffnen Sie in Voys das Modul [Webhooks](https://help.voys.nl/webhooks) und legen Sie einen Webhook mit dieser URL-Vorlage an
3. Aktivieren Sie diesen Webhook über den Webhook-Schritt in Ihrem Anrufplan
4. Verwenden Sie in der URL-Vorlage die Variablen, die Voys unterstützt (`{callerid}`, `{did}`, `{callername}` und bei Bedarf `{code}`)
5. Stellen Sie im Webhook-Routing **Variabele bellernaam** ein, damit der zurückgegebene Name auf den Geräten angezeigt wird

Die Webhooks für Öffnungszeiten und Routing führen keine Anrufernamen-Suche durch. Verwenden Sie dafür diesen separaten Schritt.

Mehr Hintergrund:

- [Webhooks](https://help.voys.nl/webhooks)
- [Was sind Gesprächsbenachrichtigungen (Unterschied zu Webhooks)](https://help.voys.nl/gespreksnotificaties)

## Öffnungszeiten und Ziele im Anrufplan [#openingsuren-en-bestemmingen-in-het-belplan]

Tillor ist die Quelle für Öffnungszeiten, Urlaubszeiten und Feiertagsausnahmen. Voys muss diesen Kalender nicht mehr selbst kennen.

1. Wählen Sie unter **Einstellungen > Integrationen > Voys** das Voys-Gerät für **geöffnet** und optional für **geschlossen**
2. Kopieren Sie **Webhook für Öffnungszeiten** oder **Routing-Webhook** aus **Zu konfigurierende URLs**
3. Legen Sie in Voys einen [Webhook](https://help.voys.nl/webhooks) mit dieser URL-Vorlage an
4. Setzen Sie diesen Webhook als Schritt in den Anrufplan, **oberhalb** etwaiger Auswahlmenüs
5. Lassen Sie **Menu gebruiken** ausgeschaltet

Zwei Muster:

- **Webhook für Öffnungszeiten** - `status=ACK` folgt dem Pfad **HTTP und Menü erfolgreich** (geöffnet), `status=NAK` folgt **HTTP oder Menü fehlgeschlagen** (geschlossen). Ist ein Ziel für geöffnet eingestellt, steht es bei ACK als `destination` dabei.
- **Routing-Webhook** - Tillor wählt das Ziel. Setzen Sie im erfolgreichen Schritt **Variabele eindbestemming**. ACK + `destination`, wenn es ein Ziel gibt, sonst NAK.

Bei einem Fehler oder Timeout nimmt Voys den fehlgeschlagenen Pfad. Behandeln Sie das wie geschlossen.

Voys-Dokumentation: [Webhooks](https://help.voys.nl/webhooks).

## Anrufer automatisch auf die Mailbox leiten [#bellers-automatisch-naar-voicemail-sturen]

Mit dem **Webhook Anrufer erlaubt** lassen Sie Voys pro Anrufer entscheiden, ob ein Anruf durchgestellt wird. Tillor prüft, ob die Nummer des Anrufers zu einem Kunden gehört, bei dem die automatische Mailbox aktiviert ist.

Richten Sie zuerst den Anrufplan ein:

1. Kopieren Sie **Webhook Anrufer erlaubt** aus **Zu konfigurierende URLs** unter **Einstellungen > Integrationen > Voys**
2. Legen Sie in Voys einen [Webhook](https://help.voys.nl/webhooks) mit dieser URL-Vorlage an
3. Setzen Sie diesen Webhook als Schritt in den Anrufplan, **oberhalb** der Schritte, die den Anruf durchstellen
4. Lassen Sie **Menu gebruiken** ausgeschaltet
5. Leiten Sie den Pfad **HTTP und Menü erfolgreich** an Ihr normales Routing weiter und den Pfad **HTTP oder Menü fehlgeschlagen** an die Mailbox
6. Aktivieren Sie unter **Einstellungen > Integrationen > Voys** bei **Anrufweiterleitung** die Option **Automatische Mailbox in Voys**

Solange diese Option ausgeschaltet ist, sehen Sie **Anrufe an die Mailbox weiterleiten** nicht im Kundenprofil.

Aktivieren Sie die automatische Mailbox anschließend pro Kunde:

1. Öffnen Sie das Kundenprofil und gehen Sie zum Tab **Kommunikation**
2. Aktivieren Sie in den **Kommunikationseinstellungen** die Option **Anrufe an die Mailbox weiterleiten**
3. Klicken Sie auf **Speichern**

So funktioniert die Antwort:

- **ACK** - der Anrufer darf durch. Das gilt auch für unbekannte Nummern und für Anrufer mit unterdrückter Nummer.
- **NAK** - die Nummer gehört zu einem Kunden mit automatischer Mailbox. Voys folgt dem fehlgeschlagenen Pfad.

Tillor vergleicht die Nummer des Anrufers mit der Telefonnummer im Kundenprofil, unabhängig von Leerzeichen oder der Schreibweise der Landesvorwahl. Telefonnummern von Kontaktpersonen zählen nicht.

<Callout type="warn">
Bei einem Fehler oder Timeout nimmt Voys ebenfalls den fehlgeschlagenen Pfad. Dann gehen vorübergehend alle Anrufer auf die Mailbox, nicht nur die blockierten. Verwenden Sie daher ein Mailbox-Ziel, dessen Nachrichten Sie regelmäßig abhören.
</Callout>

Dieser Webhook berücksichtigt keine Öffnungszeiten. Kombinieren Sie ihn mit dem Webhook für Öffnungszeiten oder dem Routing-Webhook, indem Sie beide als getrennte Schritte in den Anrufplan setzen.

Voys-Dokumentation: [Webhooks](https://help.voys.nl/webhooks).

## Feste Weiterleitung pro Anrufer [#vaste-routering-per-beller]

Derselbe **Routing-Webhook** kann einen Anrufer sofort an ein eigenes Voys-Gerät, eine Durchwahl oder eine Telefonnummer weiterleiten. Das gilt nur für Kunden, für die Sie ein Ziel gewählt haben, und nur, wenn **Feste Anrufweiterleitung in Voys** aktiviert ist.

1. Setzen Sie den **Routing-Webhook** in den Anrufplan, wie bei den Öffnungszeiten
2. Setzen Sie im erfolgreichen Schritt **Variabele eindbestemming**
3. Aktivieren Sie unter **Einstellungen > Integrationen > Voys** bei **Anrufweiterleitung** die Option **Feste Anrufweiterleitung in Voys**

Solange diese Option ausgeschaltet ist, sehen Sie **Feste Anrufweiterleitung** nicht im Kundenprofil. Der Webhook verwendet dann nur das Gerät für geöffnet oder geschlossen.

Stellen Sie das Ziel anschließend pro Kunde ein:

1. Öffnen Sie das Kundenprofil und gehen Sie zum Tab **Kommunikation**
2. Wählen Sie bei **Feste Anrufweiterleitung** ein Voys-Gerät oder **Andere** für eine Telefonnummer oder Durchwahl (zum Beispiel 411)
3. Wählen Sie **Keine**, um die feste Weiterleitung auszuschalten
4. Klicken Sie auf **Speichern**

So wählt der Routing-Webhook das Ziel:

- Gibt es für diesen Anrufer ein festes Ziel, ist das die `destination`.
- Sonst ist `destination` das Voys-Gerät für geöffnet oder geschlossen.
- **NAK** - es gibt kein festes Ziel und auch kein Gerät für den aktuellen Zustand. Das gilt auch für unbekannte Nummern und für Anrufer mit unterdrückter Nummer, solange es kein Gerät für geöffnet oder geschlossen gibt.

Tillor vergleicht die Nummer des Anrufers mit der Telefonnummer im Kundenprofil, unabhängig von Leerzeichen oder der Schreibweise der Landesvorwahl. Telefonnummern von Kontaktpersonen zählen nicht.

Bei einem Fehler oder Timeout nimmt Voys den fehlgeschlagenen Pfad.

Voys-Dokumentation: [Webhooks](https://help.voys.nl/webhooks).

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Jeder eingehende oder ausgehende Anruf steht unter <UIPath>Kommunikation > Telefonanrufe</UIPath>, mit dem Kunden dabei, wenn die Nummer übereinstimmt. Siehe [Telefonanrufe](/communicatie/telefoongesprekken).
- Bei einem eingehenden Anruf erscheint der Anrufer als Karte unten rechts in Tillor, mit den Kundendaten dabei.
- Aufnahmen und Transkriptionen kommen mit, sobald der Anruf beendet ist, wenn Gesprächsaufnahmen in Ihrem Voys-Konto aktiviert sind.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe den Block Zu konfigurierende URLs nicht">
Der Block erscheint erst nach der Installation. Klicken Sie zuerst auf der Detailseite von Voys auf **Installieren**.
</Accordion>
<Accordion title="Es kommen keine Anrufe in Tillor an">
Voys leitet Anrufe erst weiter, wenn das Modul Gesprächsbenachrichtigungen die URL **Gesprächsbenachrichtigungen** aus Tillor verwendet. Prüfen Sie in Voys, ob diese URL dort steht und ob sie aus dem Block **Zu konfigurierende URLs** stammt.
</Accordion>
<Accordion title="Der Anrufername erscheint nicht auf dem Gerät">
Prüfen Sie, ob der Webhook für die Anrufernamen-Suche im Anrufplan steht und ob im erfolgreichen Schritt **Variabele bellernaam** eingestellt ist. Die Webhooks für Öffnungszeiten und Routing suchen keine Namen heraus.
</Accordion>
<Accordion title="Ich sehe Anrufe an die Mailbox weiterleiten nicht im Kundenprofil">
Aktivieren Sie zuerst **Automatische Mailbox in Voys** unter <UIPath>Einstellungen > Integrationen > Voys</UIPath>, bei **Anrufweiterleitung**. Erst danach erscheint die Option im Tab **Kommunikation** des Kunden. Dasselbe gilt für **Feste Anrufweiterleitung**.
</Accordion>
<Accordion title="Plötzlich gehen alle Anrufer auf die Mailbox">
Bei einem Fehler oder Timeout eines Webhooks nimmt Voys den fehlgeschlagenen Pfad. Prüfen Sie, ob Tillor erreichbar ist und ob die URL im Webhook noch stimmt. Siehe die Warnung bei [Anrufer automatisch auf die Mailbox leiten](#bellers-automatisch-naar-voicemail-sturen).
</Accordion>
<Accordion title="Ein Anruf gehört zu keinem Kunden">
Tillor vergleicht die Nummer mit der Telefonnummer im Kundenprofil. Nummern von Kontaktpersonen zählen für die Verknüpfung von Anrufen mit, aber nicht für Mailbox und feste Weiterleitung.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card
    title="Telefonanrufe"
    href="/communicatie/telefoongesprekken"
    description="Anrufaktionen wie Organisationsdetails per SMS"
  />
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Kundenprofile und Kontaktdaten" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Wie SMS-Nachrichten versendet werden" />
</Cards>


# Telefonanrufe (/de-DE/communicatie/telefoongesprekken)

Unter <UIPath>Kommunikation > Telefonanrufe</UIPath> steht jeder Anruf, der über Ihren Telefonanbieter eingeht oder ausgeht, mit dem Kunden dabei, wenn Tillor die Nummer erkennt. Sie nutzen die Seite, um Anrufe nachzuverfolgen und während eines laufenden Anrufs die Daten Ihrer Organisation per SMS an den Anrufer zu senden.

Bevor Sie beginnen:

- Die Anrufe erscheinen erst, nachdem Sie [Voys](/communicatie/providers/voys) installiert und eingerichtet haben. Ohne Verknüpfung bleibt die Liste leer.
- Aufnahmen und Transkriptionen gibt es nur, wenn Gesprächsaufnahmen in Ihrem Voys-Konto aktiviert sind.
- Die SMS-Schaltfläche in einem laufenden Anruf funktioniert nur, wenn der SMS-Versand für Ihre Umgebung eingerichtet ist. Siehe [Twilio](/communicatie/providers/twilio).

## Anrufe ansehen [#gesprekken-bekijken]

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Übersicht der Telefonanrufe" />

In der Tabelle **Alle Anrufe** sehen Sie pro Anruf:

| Spalte | Was Sie sehen |
|---|---|
| **Richtung** | **Eingehend** oder **Ausgehend** |
| **Begonnen am** | Datum und Uhrzeit |
| **Von** und **An** | Die Telefonnummern |
| **Dauer** | Die Länge des Anrufs, nach dessen Ende |
| **Kunde** | Der verknüpfte Kunde oder ein von Voys übermittelter Name (nicht verifiziert), wenn kein Kunde dazugehört |
| **Status** | Wo der Anruf gerade steht |

Tillor verknüpft einen Anruf anhand der Telefonnummer mit einem Kunden. Gehört die Nummer noch zu keinem Kunden, fügen Sie sie dem Kundenprofil oder einer Kontaktperson hinzu. Neue Anrufe werden danach automatisch verknüpft.

Ein Anruf durchläuft diese Status:

| Status | Bedeutung |
|---|---|
| <Status tone="info">Erstellt</Status> | Der Anruf hat gerade begonnen |
| <Status tone="info">Klingelt</Status> | Das Telefon klingelt |
| <Status tone="warning">Angenommen</Status> | Jemand hat abgenommen |
| <Status tone="warning">Läuft</Status> | Der Anruf läuft |
| <Status tone="warning">Warme Weiterleitung</Status> und <Status tone="warning">Kalte Weiterleitung</Status> | Der Anruf wurde weitergeleitet, mit oder ohne Ankündigung |
| <Status>Aufgelegt</Status> und <Status>Beendet</Status> | Der Anruf ist zu Ende |
| <Status tone="error">Fehlgeschlagen</Status> | Der Anruf kam nicht zustande |

## Organisationsdetails per SMS senden [#organisatiegegevens-via-sms-versturen]

Ein Anrufer fragt nach Ihrer Adresse oder Ihren Öffnungszeiten? Senden Sie sie ihm innerhalb weniger Sekunden per SMS, während der Anruf läuft.

<Steps>
<Step>
### Warten, bis der Anruf läuft [#wacht-tot-het-gesprek-loopt]
Die Aktion befindet sich im Panel mit den aktiven Anrufen unten rechts, nicht in der Liste. Der Anruf muss den Status **Läuft** haben. Auf einem Telefon tippen Sie zuerst oben rechts auf das Telefonsymbol.
</Step>
<Step>
### Anruf aufklappen [#klap-het-gesprek-uit]
Ist der Anruf eingeklappt, klappen Sie ihn auf.
</Step>
<Step>
### Auf das Nachrichtensymbol klicken [#klik-op-het-berichtenpictogram]
Der Tooltip lautet **Organisationsdetails per SMS an den Anrufer senden**.
</Step>
<Step>
### Sprache wählen [#kies-de-taal]
Tillor markiert die Sprache, die es beim Anrufer erkennt, mit *(erkannt)*. Wählen Sie die Sprache der SMS.
</Step>
</Steps>

Der Anrufer erhält einen kurzen Link zu einer öffentlichen Seite mit den Daten Ihrer Organisation. Ist die Adresse Ihrer Organisation eingetragen, gibt es dort auch Routenschaltflächen für **Waze**, **Google Maps** und **Apple Maps**. Die E-Mail-Schaltfläche auf dieser Seite hat bereits einen Betreff und einen Nachrichtentext, mit Nummer und Uhrzeit des Anrufs darin, sofern bekannt. Der Website-Link erhält Tracking-Tags, sodass Sie messen können, wie viele Anrufer weiterklicken.

## Aufnahmen und Transkriptionen [#opnames-en-transcripties]

<Steps>
<Step>
### Anruf öffnen [#open-het-gesprek]
Klicken Sie in der Liste beim Anruf auf **Transkription**. Das Fenster **Anrufdetails** öffnet sich.
</Step>
<Step>
### Tab wählen [#kies-een-tabblad]
Unter **Aufnahme** wird der Anruf in Ihrem Browser abgespielt. Unter **Transkription** steht der ausgeschriebene Text pro Sprecher und unter **Zusammenfassung** eine kurze Zusammenfassung.
</Step>
</Steps>

Tillor erstellt Transkription und Zusammenfassung selbst, sobald der Anruf beendet ist und eine Aufnahme existiert. Das dauert einen Moment. Bei einem Anruf ohne Aufnahme gibt es keine Tabs.

<Callout type="warn">
Gesprächsaufnahmen können datenschutzrelevante Informationen enthalten. Stellen Sie sicher, dass Sie beim Aufnehmen von Anrufen die Datenschutzgesetze (DSGVO) einhalten, und informieren Sie Anrufer darüber, dass Gespräche aufgezeichnet werden.
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein Anruf steht nach dem Ende in der Liste mit der Dauer, dem Kunden und, wenn es eine Aufnahme gibt, einer Transkription und Zusammenfassung.
- Eine gesendete SMS mit Organisationsdetails steht unter <UIPath>Kommunikation > Benachrichtigungen</UIPath> mit dem Typ **Organisationsdetails**.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Anrufliste ist leer">
Prüfen Sie, ob Voys unter <UIPath>Einstellungen > Integrationen</UIPath> installiert ist und ob die Gesprächsbenachrichtigungen in Voys auf die URL aus Tillor zeigen. Siehe [Voys Telefonie](/communicatie/providers/voys).
</Accordion>
<Accordion title="Ein Anruf gehört zu keinem Kunden">
Tillor vergleicht die Nummer des Anrufers mit der Telefonnummer im Kundenprofil oder bei einer Kontaktperson. Fügen Sie die Nummer hinzu, dann werden neue Anrufe verknüpft. Bereits eingegangene Anrufe bleiben, wie sie waren.
</Accordion>
<Accordion title="Ich finde die SMS-Schaltfläche nicht">
Die Schaltfläche befindet sich nur im Panel mit den aktiven Anrufen unten rechts und nur, solange der Anruf den Status **Läuft** hat. In der Liste auf dieser Seite gibt es sie nicht.
</Accordion>
<Accordion title="Ich sehe keinen Tab Aufnahme">
Voys hat den Anruf nicht aufgezeichnet. Aktivieren Sie Gesprächsaufnahmen in Ihrem Voys-Konto. Frühere Anrufe können nicht nachträglich aufgezeichnet werden.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Voys Telefonie" href="/communicatie/providers/voys" description="Voys installieren und den Anrufplan einrichten" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Wie SMS-Nachrichten versendet werden" />
  <Card title="Benachrichtigungen" href="/notificaties" description="Zustellstatus gesendeter SMS-Nachrichten" />
</Cards>


# Connector (/de-DE/connector)

Der Tillor Connector ist ein kleines Kästchen im Netzwerk Ihres Parks. Er verbindet Tillor mit den Geräten vor Ort: Bondruckern, Schranken, Zutrittscontrollern und Ausweislesern. Ohne Connector kann Tillor diese Geräte nicht bedienen. Ist er aus, funktionieren das Drucken und das Bedienen von Schranken aus Tillor nicht. Wie Sie dann weiterkommen, steht unter [Probleme](#problemen).

Tillor liefert den Connector vorkonfiguriert und überwacht ihn aus der Ferne. Sie müssen nichts installieren oder aktualisieren.

<Callout type="info" title="Gut zu wissen">
- Jede Organisation hat einen Connector. Verwalten Sie mehrere Parks, erhält jeder Park (jede Organisation) ein eigenes Kästchen.
- Der Connector meldet sich alle 15 Sekunden bei Tillor.
- Hört Tillor 3 Minuten lang nichts von ihm, erhält das Tillor-Team automatisch eine Meldung.
- Updates installiert Tillor selbst, ohne dass Sie etwas tun müssen.
- Der Connector baut selbst eine gesicherte, ausgehende Verbindung auf. Sie müssen keine Ports in Ihrem Router öffnen.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Der Connector steht zwischen Tillor im Internet und den Geräten in Ihrem eigenen Netzwerk. Tillor sendet einen Auftrag an den Connector, und der Connector führt ihn auf dem richtigen Gerät aus. Umgekehrt meldet der Connector, was passiert ist, zum Beispiel ein gelesenes Kennzeichen.

```mermaid
flowchart LR
  T[Tillor] <-->|gesicherte Verbindung über das Internet| C[Connector in Ihrem Park]
  C --> P[Bondrucker]
  C --> S[Schranke oder Zutrittscontroller]
  C --> I[Ausweisleser]
```

Zum Beispiel:

- Sie drucken einen Bon oder ein Etikett. Tillor sendet es an den Connector, und dieser gibt es auf Ihrem Drucker aus.
- Sie geben einem Kunden eine Zugangsmethode. Tillor sendet die Änderung über den Connector an die Zutrittscontroller, siehe [Zugangskontrolle](/toegangscontrole#hoe-hangt-dit-samen).
- Ein Gast scannt beim Einchecken einen Ausweis. Der Connector leitet den Scan an Tillor weiter, siehe [Ausweisscans](/identiteitsscans).

## Was Tillor für Sie erledigt [#wat-tillor-voor-je-doet]

- **Lieferung**: Das Kästchen kommt vorkonfiguriert für Ihre Organisation bei Ihnen an.
- **Installation und Verknüpfung**: Wir verknüpfen Ihre Drucker, Schranken und Scanner beim Start.
- **Updates**: Neue Versionen werden automatisch und ohne Unterbrechung installiert.
- **Überwachung**: Tillor sieht, ob der Connector verbunden ist, und meldet sich bei einem Ausfall selbst.

## Was Sie selbst benötigen [#wat-je-zelf-nodig-hebt]

- Eine Steckdose in der Nähe Ihrer Netzwerkgeräte
- Ein Netzwerkkabel zu Ihrem Router oder Switch, im selben Netzwerk wie Ihre Drucker und Schranken
- Eine stabile Internetverbindung

## Verbundene Geräte [#gekoppelde-apparaten]

- **Drucker**: siehe [Drucker](/printer) zum Einrichten und Verwenden.
- **Schranken, Tore und Zutrittscontroller**: siehe [Zugangskontrolle](/toegangscontrole).
- **Ausweisleser**: siehe [Ausweisscans](/identiteitsscans) zum Anlegen von Kunden aus einem Scan und zu Aufbewahrungsfristen.

<Callout type="info" title="Für technisch Interessierte">
Im Netzwerk Ihres Parks können Sie den Status des Connectors unter `http://[adres-van-de-connector]:3000/` ansehen. Dort sehen Sie die Verbindung mit Tillor, die Druckwarteschlange und die zuletzt gelesenen Kennzeichen. Der Tillor-Support nennt Ihnen die Adresse bei der Installation. Mehr zum Protokoll steht unter [MQTT](/ontwikkelaars/mqtt).
</Callout>

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Connector ist nicht verbunden">
Prüfen Sie, ob das Kästchen Strom bekommt und das Netzwerkkabel richtig steckt. Schauen Sie, ob das Internet in Ihrem Park funktioniert. Ziehen Sie danach kurz den Stecker des Kästchens und stecken Sie ihn wieder ein. Bleibt das Problem bestehen, wenden Sie sich an den Tillor-Support. Einen Ausfall sehen wir meist bereits selbst.
</Accordion>
<Accordion title="Drucken oder eine Schranke bedienen funktioniert nicht">
Sehen Sie sich zuerst den Status des Connectors an, siehe den technischen Hinweis oben. Prüfen Sie, ob das Gerät eingeschaltet ist und im selben Netzwerk hängt. Ist der Connector verbunden und das Gerät erreichbar, aber es passiert nichts, wenden Sie sich an den Support.
</Accordion>
<Accordion title="Neue Zugangsmethoden kommen nicht am Tor an">
Schauen Sie unter **Controller-Operationen** auf der Seite Zugangskontrolle. Bleibt ein Auftrag auf **Ausstehend** stehen, ist der Connector offline.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Connector**: das Kästchen in Ihrem Park, das Tillor mit Ihren Geräten verbindet.
- **Zutrittscontroller**: ein Kästchen an einer Schranke, das Tags und QR-Codes liest.
- **Verwaltete Lösung**: Tillor liefert, konfiguriert und wartet das Kästchen für Sie.

Mehr Erklärungen stehen im [Glossar](/begrippen).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Controller" href="/controllers" description="Tag-Leser an Duschen, Türen und Ladepunkten" />
  <Card title="Drucker" href="/printer" description="Drucker einrichten und verwenden" />
  <Card title="Zugangskontrolle" href="/toegangscontrole" description="Schranken und Zugangsmethoden" />
  <Card title="Ausweisscans" href="/identiteitsscans" description="Ausweise beim Einchecken scannen" />
</Cards>


# Dokumente (/de-DE/documenten)

Mit der Dokumentenverwaltung bewahren Sie Dateien bei einem Kunden auf, etwa Versicherungspolicen, Ausweise, Verträge, Genehmigungen und andere Anhänge. Dateien, die noch zu niemandem gehören, stehen in der zentralen Dokumentenliste, bis Sie sie einem Kunden zuordnen. Beginnen Sie bei [Dokumente bei einem Kunden](#documenten-bij-een-klant) oder bei [Die zentrale Dokumentenliste](#de-centrale-documentenlijst).

<Callout type="info" title="Gut zu wissen">
- Eine Datei darf höchstens 250 MB groß sein.
- Sie können PDF, Word, Outlook-Nachrichten (.msg), Excel, PowerPoint, Bilder (JPEG, PNG, GIF) und Textdateien hochladen.
- Bilder wandelt Tillor nach dem Hochladen in PDF um. Die anderen Dateitypen bleiben, wie sie sind, mit einer PDF-Vorschau daneben.
- Bei einem gelöschten Dokument erhalten Sie an Ihre E-Mail-Adresse eine Kopie als Anhang, sofern die Datei gesichert werden konnte.
- Eine PDF, die zu einer Signaturanfrage gehört, und die unterschriebene PDF können Sie archivieren, aber nicht löschen.
- Ein archiviertes Dokument bleibt erhalten, steht aber nicht mehr unter den aktiven Dokumenten.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  U[Upload oder E-Mail] --> C[Zentrale Dokumentenliste]
  C -->|Dem Kunden zuordnen| K[Dokumente des Kunden]
  K --> S[Signaturanfrage]
  S --> O[Unterschriebene PDF beim Kunden]
  M[SEPA-Mandat] --> K
```

Ein Dokument steht an einem Ort: entweder in der zentralen Liste oder bei einem Kunden. Ordnen Sie es einem Kunden zu, verschwindet es aus der zentralen Liste. Unterschriebene PDFs und unterschriebene Mandate landen automatisch bei den Dokumenten des Kunden.

## Dokumente bei einem Kunden [#documenten-bij-een-klant]

### Dokumente ansehen [#documenten-bekijken]

1. Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath> und öffnen Sie das Profil des Kunden.
2. Klicken Sie auf den Tab **Dokumente**.
3. Sie sehen die Dokumente dieses Kunden, aufgeteilt in **Aktiv** und **Archiviert**.
4. Klicken Sie auf ein Dokument (oder auf das Auge), um es rechts in der **Vorschau** anzusehen. Mit dem Download-Symbol speichern Sie es.

### Ein Dokument bearbeiten, verschieben oder archivieren [#een-document-bewerken-verplaatsen-of-archiveren]

Das Menü **…** neben einem Dokument enthält **Bearbeiten**, **Zu Kunde verschieben**, **Herunterladen**, **Archivieren** (oder **Wiederherstellen**) und **Löschen**.

### Ein Dokument löschen [#een-document-verwijderen]

Bevor Sie beginnen: Ein Dokument, das zu einer Signaturanfrage gehört, können Sie nicht löschen. Archivieren Sie es stattdessen.

<Steps>
<Step>
### Löschen wählen [#kies-verwijderen]
Wählen Sie **Löschen** im Menü **…** neben dem Dokument.
</Step>
<Step>
### Bestätigen [#bevestig]
Bestätigen Sie im Dialogfenster mit **Löschen** oder brechen Sie mit **Abbrechen** ab. Das Löschen kann nicht rückgängig gemacht werden.

<DocScreenshot src="/screenshots/documenten/document-delete-dialog.png" alt="Bestätigungsdialog zum Löschen eines Dokuments" />
</Step>
</Steps>

Nach dem Löschen erhalten Sie an die E-Mail-Adresse Ihres Kontos eine Nachricht mit dem gelöschten Dokument als Anhang, sodass Sie meist eine Kopie zur Hand haben.

### Ein Dokument unterschreiben lassen [#een-document-laten-ondertekenen]

Unter den Dokumenten eines Kunden stehen die **Signaturanfragen**. Mit **Unterschriften anfragen** lassen Sie eine PDF online vom Kunden, einer Kontaktperson, einem Kollegen oder einem externen Partner unterschreiben. Die unterschriebene PDF erscheint als **[Titel] (unterschrieben)** bei den Dokumenten, mit dem Typ **Unterschriebene Vereinbarung**, wenn die ursprüngliche PDF keinen Typ hatte. Siehe [Unterschriften](/handtekeningen).

## Die zentrale Dokumentenliste [#de-centrale-documentenlijst]

Neben Dokumenten bei Kunden hat Tillor eine zentrale Liste. Hier erscheinen Dateien, die noch keinem Kunden zugeordnet sind, zum Beispiel Dokumente, die per E-Mail eingehen. Gehen Sie zu <UIPath>Verwaltung > Dokumente</UIPath>.

<DocScreenshot src="/screenshots/documenten/documents-upload.png" alt="Zentrale Dokumentenliste mit Upload-Bereich" />

### Ein Dokument hochladen [#een-document-uploaden]

<Tabs items={["Ziehen oder wählen", "Per E-Mail"]}>
<Tab value="Ziehen oder wählen">
Ziehen Sie eine Datei in den Upload-Bereich oder klicken Sie auf **Datei auswählen**. Die Datei wird automatisch gespeichert und erscheint als neuer Eintrag in der Liste.
</Tab>
<Tab value="Per E-Mail">
Im Upload-Bereich steht eine spezielle E-Mail-Adresse. Senden Sie die Datei als Anhang an diese Adresse, dann erscheint sie automatisch in der zentralen Liste.
</Tab>
</Tabs>

### Ein Dokument einem Kunden zuordnen [#een-document-koppelen-aan-een-klant]

Jedes Dokument in der zentralen Liste hat ein Bearbeitungsformular und ein Vorschaufenster.

<Steps>
<Step>
### Dokument suchen [#zoek-het-document]
Gehen Sie zu <UIPath>Verwaltung > Dokumente</UIPath> und scrollen Sie zum Dokument.
</Step>
<Step>
### Felder ausfüllen [#vul-de-velden-in]
- **Dokumentname**: der Name des Dokuments.
- **Kunde zuweisen**: der Kunde, zu dem dieses Dokument gehört (optional).
- **Dokumenttyp**: zum Beispiel **Versicherungspolice**, **Zahlungsnachweis der Versicherung**, **Personalausweis**, **SEPA-Mandat**, **Unterschriebene Vereinbarung** oder **Sonstige** (optional).
- **Versicherungsablaufdatum**: das Datum, an dem eine Versicherung oder Genehmigung abläuft. Dieses Feld erscheint nur bei Dokumenttypen, die ein Ablaufdatum haben können.
- **Kommentare**: freie Notizen zum Dokument (optional).
</Step>
<Step>
### Speichern [#sla-op]
Klicken Sie auf **Änderungen speichern**.
</Step>
</Steps>

### Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Dokument verschwindet aus der zentralen Liste und steht im Tab **Dokumente** dieses Kunden.
- Haben Sie ein **Versicherungsablaufdatum** eingetragen, sehen Sie es als Label beim Dokument.

## KI-Vorschläge bei Dokumenten [#ai-suggesties-bij-documenten]

Wenn Sie eine PDF hochladen, analysiert Tillor den Inhalt im Hintergrund. Erkennt Tillor einen Namen, der zu einem Kunden in Ihrer Verwaltung passt, erscheint neben **Kunde zuweisen** eine Vorschlagsschaltfläche mit dem Namen des Kunden und einem Prozentwert, der angibt, wie sicher Tillor ist. Auch für ein Versicherungsablaufdatum kann ein solcher Vorschlag erscheinen.

Klicken Sie auf die Schaltfläche, um den Vorschlag zu übernehmen, oder wählen Sie selbst einen anderen Kunden. Ein Vorschlag ist immer nur ein Angebot. Klicken Sie auf **Änderungen speichern**, um Ihre Wahl zu bestätigen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann ein Dokument nicht löschen">
Gehört das Dokument zu einer Signaturanfrage, als ursprüngliche PDF oder als unterschriebene PDF, verweigert Tillor das Löschen, weil es ein Nachweis ist. Archivieren Sie es mit **Archivieren** im Menü **…**.
</Accordion>
<Accordion title="Tillor meldet: Archivierung fehlgeschlagen">
Die Meldung lautet **Das Dokument konnte nicht archiviert werden.** Versuchen Sie es erneut. Dasselbe gilt für **Wiederherstellung fehlgeschlagen** bei **Wiederherstellen**.
</Accordion>
<Accordion title="Tillor meldet: Aktualisierung fehlgeschlagen">
Ihre Änderungen an **Dokumentname**, Kunde, Typ oder Kommentaren wurden nicht gespeichert. Prüfen Sie das Formular und klicken Sie erneut auf **Änderungen speichern**.
</Accordion>
<Accordion title="Tillor meldet: Download fehlgeschlagen">
Das Dokument konnte nicht heruntergeladen werden. Versuchen Sie es erneut.
</Accordion>
<Accordion title="Das Feld Versicherungsablaufdatum fehlt">
Dieses Feld erscheint nur bei Dokumenttypen, die ein Ablaufdatum haben können, wie **Versicherungspolice**. Wählen Sie zuerst bei **Dokumenttyp** den passenden Typ.
</Accordion>
<Accordion title="Meine Datei wird nicht akzeptiert">
Prüfen Sie den Dateityp (PDF, Word, Outlook-Nachricht, Excel, PowerPoint, JPEG, PNG, GIF oder Text) und die Größe (höchstens 250 MB).
</Accordion>
<Accordion title="Das Dokument steht nicht mehr in der zentralen Liste">
Sobald ein Dokument einem Kunden zugeordnet ist, steht es nur noch bei diesem Kunden unter **Dokumente**. Steht es im Archiv, finden Sie es unter **Archiviert**.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Dokumenttyp**: die Art des Dokuments, zum Beispiel **Versicherungspolice** oder **Personalausweis**.
- **Archiviert**: ein Dokument, das erhalten bleibt, aber nicht mehr unter den aktiven Dokumenten steht.
- **Zentrale Dokumentenliste**: Dateien, die noch keinem Kunden zugeordnet sind.
- **Signaturanfrage**: ein Auftrag, eine PDF unterschreiben zu lassen. Siehe [Signaturanfrage](/begrippen#ondertekenverzoek).
- **Kunde**: der Datensatz in Tillor, an dem ein Dokument hängt. Siehe [Kunde](/begrippen#klant).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Kundenverwaltung" href="/klantenbeheer" />
  <Card title="Unterschriften" href="/handtekeningen" />
</Cards>


# Übersicht (/de-DE/eigen-velden)

Mit eigenen Feldern fügen Sie einem Datensatz selbst Felder hinzu. Denken Sie an eine Gasflaschen-Pfandnummer bei einem Kunden, einen Zuschlag bei einem Stellplatz oder eine erwartete Ankunftszeit bei einer Reservierung. Das Feld erscheint im Formular dieses Datensatzes, genau wie die Felder, die Tillor selbst mitbringt.

Sie verwalten sie unter <UIPath>Einstellungen > Eigene Felder</UIPath>.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-list.png" alt="Einstellungen > Eigene Felder mit dem Tab Kunden und der Liste der Felder" />

<Callout type="info" title="Gut zu wissen">
- Den Typ eines Feldes und den Schlüssel können Sie nach dem Anlegen nicht mehr ändern
- Text: standardmäßig höchstens 1.000 Zeichen, Langer Text 10.000. Eine Auswahlliste hat höchstens 200 Optionen
- Eine Feldgruppe hat höchstens 30 Unterfelder. Wiederholende Zeilen: standardmäßig höchstens 100 Zeilen, nie mehr als 500
- Dateien: standardmäßig höchstens 20 pro Feld (nie mehr als 50), jeweils höchstens 50 MB
- Ein Feld, das durch eine Bedingung verschwindet, wird beim Speichern des Datensatzes geleert
- Ein gelöschtes Feld verschwindet aus den Formularen. Die eingetragenen Werte bleiben jedoch auf den Datensätzen erhalten
- Alle Limits pro Typ stehen unter [Feldtypen und Einstellungen](/eigen-velden/veldtypes)
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Sie legen ein Feld einmal an, und es erscheint danach überall, wo diese Art von Datensatz ausgefüllt wird.

```mermaid
flowchart LR
  L[Auswahlliste mit Optionen] -->|verwendet von| V[Eigenes Feld vom Typ Auswahl]
  V -->|steht im Formular von| R[Kunde, Stellplatz, Belegung, Aufgabe und andere Datensätze]
  T[Zugriff: wer darf sehen und bearbeiten] --> V
  R -->|Werte erscheinen in| E[Exporten, Filtern und Automatisierungen]
```

- **Auswahllisten** legen Sie getrennt von den Feldern an. Passen Sie eine Option an, stimmt das in jedem Feld, das die Liste verwendet.
- **Ein Feld** gehört zu einer Art von Datensatz. Typ und Schlüssel stehen fest.
- **Zugriff** regeln Sie pro Feld. Wer ein Feld nicht sehen darf, bekommt den Wert nie zu sehen, auch nicht in Exporten oder Automatisierungen.

## Wo Sie eigene Felder hinzufügen können [#waar-kun-je-eigen-velden-toevoegen]

Jede Art von Datensatz hat einen eigenen Tab. Hinter dem Namen steht die Anzahl der Felder.

| Tab | Datensatz |
|---|---|
| **Kunden** | Kundenprofil |
| **Stellplätze** | Stellplatz |
| **Belegungen** | Belegung |
| **Zähler** | Zähler |
| **Aufgaben** | Aufgabe |
| **Produkte** | Produkt |
| **Dokumente** | Dokument |
| **Reservierungen** | Reservierung |
| **Zugangsmethoden** | Zugangsmethode |

Der Tab **Auswahllisten** hat keine Datensätze. Dort legen Sie Listen mit Optionen an, die Sie in Auswahlfeldern wiederverwenden.

## Was Sie damit tun können [#wat-je-ermee-kunt]

- Ein Feld eines bestimmten Typs hinzufügen, etwa Text, Zahl, Betrag, Datum, Auswahl oder Datei. Siehe [Feldtypen und Einstellungen](/eigen-velden/veldtypes)
- Das Feld im Formular zwischen die bestehenden Felder setzen oder es nur anzeigen, wenn ein anderer Wert zutrifft
- Das Feld zum Pflichtfeld machen, gegebenenfalls nur unter einer Bedingung
- Festlegen, wer das Feld sehen und wer es bearbeiten darf. Siehe [Sichtbarkeit und Zugriff](/eigen-velden/zichtbaarheid-en-toegang)

Die Werte sind im Export von Kunden und Stellplätzen und in Automatisierungen verfügbar. Eine Automatisierung kann ein eigenes Feld auch mit dem Schritt **Eigen veld instellen** füllen.

## Wer es nutzen kann [#wie-kan-het-gebruiken]

<Callout type="info" title="Verwalten erfordert eine Berechtigung">
Felder anlegen, ändern, umsortieren und löschen ist mit der Berechtigung **Eigene Felder verwalten** möglich. Wer sie nicht hat, kann die Seite öffnen, wenn er Einstellungen ansehen darf, aber die Schaltflächen sind dann deaktiviert.
Ein Feld an einem Datensatz ausfüllen kann jeder, der das Feld sehen und bearbeiten darf.
</Callout>

## Bestandteile [#onderdelen]

<Cards>
  <Card
    title="Ein eigenes Feld anlegen"
    href="/eigen-velden/veld-aanmaken"
    description="Schritt für Schritt ein Feld hinzufügen, platzieren und anpassen"
  />
  <Card
    title="Auswahllisten"
    href="/eigen-velden/keuzelijsten"
    description="Optionen für die Typen Auswahl und Mehrfachauswahl festlegen"
  />
  <Card
    title="Feldtypen und Einstellungen"
    href="/eigen-velden/veldtypes"
    description="Welche Einstellungen und Grenzen es pro Typ gibt"
  />
  <Card
    title="Sichtbarkeit und Zugriff"
    href="/eigen-velden/zichtbaarheid-en-toegang"
    description="Wo die Werte stehen und wer sie sehen oder bearbeiten darf"
  />
</Cards>

## Begriffe [#begrippen]

- **[Eigenes Feld](/begrippen#eigen-veld)**: ein zusätzliches Feld, das Sie selbst einem Datensatz hinzufügen
- **Bezeichnung**: der Name, den Kollegen über dem Eingabefeld sehen
- **Schlüssel**: der feste Name des Feldes, zum Beispiel `gasMeterNumber`. Sie sehen ihn in der Liste, und er wird in Exporten und Filtern verwendet
- **Typ**: welche Art von Wert das Feld speichert
- **[Auswahlliste](/begrippen#keuzelijst)**: eine Liste mit Optionen, die Sie in mehreren Auswahlfeldern verwenden

Weitere Begriffe stehen im [Glossar](/begrippen). Ein ausgearbeitetes Beispiel finden Sie unter [Praxisbeispiele](/praktijk).


# Auswahllisten anlegen (/de-DE/eigen-velden/keuzelijsten)

Ein Feld vom Typ **Auswahl** oder **Mehrfachauswahl** braucht eine Auswahlliste. Sie legen die Liste einmal an und verwenden sie in so vielen Feldern, wie Sie möchten. Passen Sie eine Option an, stimmt das sofort überall.

<Requires permission="Eigene Felder verwalten" />

<Steps>
<Step>
### Tab Auswahllisten öffnen [#open-het-tabblad-keuzelijsten]
Gehen Sie zu <UIPath>Einstellungen > Eigene Felder</UIPath> und klicken Sie auf **Auswahllisten**. Jede Liste zeigt ihre Optionen mit Farbe und die Anzahl der Felder, die sie verwenden.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enums.png" alt="Der Tab Auswahllisten mit der Liste Vertragsart" />
</Step>
<Step>
### Liste anlegen [#maak-een-lijst-aan]
Klicken Sie auf **Neue Auswahlliste**. Tragen Sie einen **Name** und gegebenenfalls eine **Beschreibung** ein. Tillor erzeugt selbst einen **Schlüssel**.
</Step>
<Step>
### Optionen hinzufügen [#voeg-opties-toe]
Klicken Sie auf **Option hinzufügen** und tragen Sie die **Bezeichnung** ein, zum Beispiel *Saison*. Wählen Sie mit dem Farbpunkt eine Farbe. Eine Liste braucht mindestens eine Option.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enum-dialog.png" alt="Dialog Neue Auswahlliste" />
</Step>
<Step>
### Speichern [#sla-op]
Klicken Sie auf **Speichern**. Wählen Sie die Liste danach beim Anlegen eines Feldes vom Typ **Auswahl** oder **Mehrfachauswahl**.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Liste steht beim Anlegen eines Feldes vom Typ **Auswahl** oder **Mehrfachauswahl** zur Verfügung.
- Passen Sie später die Bezeichnung oder die Farbe einer Option an, stimmt das sofort in jedem Feld, das die Liste verwendet.
- Der **Wert** einer Option steht fest, sobald er auf einem Datensatz verwendet wurde.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann eine Liste nicht löschen">
Eine Liste, die noch in einem Feld verwendet wird, können Sie nicht löschen. Tillor meldet, dass die Liste noch von einem Feld verwendet wird. Entfernen Sie die Liste zuerst aus diesen Feldern oder löschen Sie diese Felder.
</Accordion>
<Accordion title="Bei meinem Auswahlfeld steht Zuerst eine Auswahlliste anlegen">
Es gibt noch keine Liste. Legen Sie auf dem Tab **Auswahllisten** eine an und wählen Sie sie danach im Feld aus.
</Accordion>
<Accordion title="Ich kann die Liste nicht speichern">
Eine Liste braucht mindestens eine und höchstens 200 Optionen. Fügen Sie mit **Option hinzufügen** eine Option hinzu.
</Accordion>
</Accordions>


# Ein eigenes Feld anlegen (/de-DE/eigen-velden/veld-aanmaken)

Mit einem eigenen Feld speichern Sie eine Angabe, die Tillor selbst nicht kennt, etwa eine Gasflaschen-Pfandnummer bei einem Kunden. Sie legen es in wenigen Minuten an, und rechts auf der Seite sehen Sie sofort, wie Ihre Kollegen das Feld später bekommen. Danach füllen Sie es im Datensatz selbst aus, siehe [Sichtbarkeit und Zugriff](/eigen-velden/zichtbaarheid-en-toegang).

Bevor Sie beginnen:

- Sie benötigen die Berechtigung **Eigene Felder verwalten**. Ohne diese Berechtigung ist die Schaltfläche **Neues Feld** grau.
- Braucht das Feld eine Auswahl, legen Sie zuerst eine [Auswahlliste](/eigen-velden/keuzelijsten) an. Sonst steht dort **Zuerst eine Auswahlliste anlegen**.
- Wählen Sie den Typ sorgfältig: Sie können ihn danach nicht mehr ändern.

<Requires permission="Eigene Felder verwalten" />

<Steps>
<Step>
### Eigene Felder öffnen und den Tab wählen [#open-eigen-velden-en-kies-het-tabblad]
Gehen Sie zu <UIPath>Einstellungen > Eigene Felder</UIPath> und öffnen Sie den Tab des Datensatzes, zu dem das Feld gehört, zum Beispiel **Kunden**. Klicken Sie auf **Neues Feld**.

Ist der Tab noch leer, sehen Sie unter **Schnellstart** einige Vorschläge, wie **Anzahl Hunde** bei Kunden. Klicken Sie auf einen Vorschlag, um das Formular bereits ausgefüllt zu öffnen. Vorschläge mit einer Auswahlliste verlangen zuerst eine Liste. Siehe [Auswahllisten](/eigen-velden/keuzelijsten).
</Step>
<Step>
### Feld ausfüllen [#vul-het-veld-in]
Unter **1. Feld** wählen Sie bei **Gilt für** die Art des Datensatzes, geben dem Feld eine **Bezeichnung** und wählen den **Typ**. Jede Typkarte hat eine kurze Erklärung.

Tillor erzeugt aus Ihrer Bezeichnung selbst einen **Schlüssel**. Unter **3. Schlüssel** können Sie ihn mit **Ändern** anpassen, bevor Sie speichern.

<DocScreenshot src="/screenshots/eigen-velden/field-new-form.png" alt="Neues eigenes Feld mit den Typkarten, den Einstellungen und der Vorschau rechts" />
</Step>
<Step>
### Feld feinabstimmen [#stel-het-veld-af]
Unter **2. Einstellungen** stehen die Optionen, die zum gewählten Typ gehören. Siehe [Feldtypen und Einstellungen](/eigen-velden/veldtypes). Außerdem können Sie wählen:

- **Breite**: **Halb** oder **Volle Breite** im Formular
- **Position im Formular**: lassen Sie das Feld unten stehen (**Standardbereich (unten)**) oder wählen Sie ein bestehendes Feld des Formulars und setzen Sie das Feld **Davor** oder **Danach**
- **Pflichtfeld**: der Datensatz kann nicht gespeichert werden, solange das Feld leer ist
- **Sichtbarkeit**: zeigen Sie das Feld nur an, wenn eine Bedingung erfüllt ist
- **Erforderlich wenn**: machen Sie das Feld nur dann zum Pflichtfeld, wenn eine Bedingung erfüllt ist
- **Validierungsregeln**: vergleichen Sie den Wert mit einem anderen Feld oder prüfen Sie ihn mit einem Ausdruck
- **Hilfetext**: eine kurze Erklärung unter dem Eingabefeld
</Step>
<Step>
### Festlegen, wer Zugriff hat [#bepaal-wie-erbij-mag]
Unter **4. Zugriff** steht standardmäßig, dass alle das Feld sehen und bearbeiten dürfen. Klicken Sie auf **Einschränken**, um das anzupassen. Siehe [Sichtbarkeit und Zugriff](/eigen-velden/zichtbaarheid-en-toegang).
</Step>
<Step>
### Feld speichern [#sla-het-veld-op]
Klicken Sie auf **Speichern**. Tillor meldet **Feld gespeichert** und bringt Sie zurück zur Liste. Das Feld steht sofort im Formular des Datensatzes.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Feld steht sofort im Formular des Datensatzes, an der Stelle, die Sie gewählt haben.
- Bestehende Datensätze haben noch einen leeren Wert. Ist das Feld ein Pflichtfeld, muss ein Kollege es ausfüllen, bevor er einen solchen Datensatz erneut speichert.
- Die Werte erscheinen im Export von Kunden und Stellplätzen und sind in Automatisierungen verfügbar.
- Wer das Feld sehen oder bearbeiten darf, regeln Sie unter **4. Zugriff**.

## Position und Bedingungen [#plaats-en-voorwaarden]

Mit **Position im Formular** setzen Sie ein Feld zu den Feldern, zu denen es gehört, statt ans Ende. Mit **Sichtbarkeit** zeigen Sie ein Feld nur an, wenn ein anderer Wert es verlangt. In diesem Beispiel erscheint **Winterstellplatz** nur bei einem Stellplatz mit der **Vertragsart** Saison, direkt nach **Beschreibung**.

<DocScreenshot src="/screenshots/eigen-velden/field-edit-conditions.png" alt="Feld bearbeiten mit Position im Formular und einer Bedingung bei Sichtbarkeit und Erforderlich wenn" />

Eine Bedingung besteht aus einer oder mehreren Regeln. Bei **Bedingungstyp** wählen Sie **Regeln** oder **Ausdruck**. Der Ausdruck ist für komplizierte Fälle gedacht und erfordert ein Stück Code. Für die meisten Felder genügen Regeln.

<Callout type="info" title="Ein ausgeblendetes Feld wird geleert">
Verschwindet ein Feld, weil die Bedingung nicht mehr zutrifft, löscht Tillor den Wert beim Speichern des Datensatzes. Kommt das Feld zurück, ist es leer. Ein Feld, das unter einer Bedingung erforderlich ist, ist nur erforderlich, solange es sichtbar ist.
</Callout>

## Ein Feld bearbeiten, verschieben oder löschen [#een-veld-bewerken-verplaatsen-of-verwijderen]

In der Liste hat jedes Feld vier Schaltflächen.

| Schaltfläche | Was sie bewirkt |
|---|---|
| **Nach oben** und **Nach unten** | Ändert die Reihenfolge der Felder im Formular |
| **Feld bearbeiten** | Öffnet das Feld. Typ, Schlüssel und der Datensatz, zu dem das Feld gehört, stehen dann fest |
| **Löschen** | Löscht das Feld nach einer Bestätigung |

Ein gelöschtes Feld verschwindet aus den Formularen. Die eingetragenen Werte bleiben jedoch auf den Datensätzen erhalten, werden aber nicht mehr angezeigt oder bearbeitet.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann Neues Feld nicht anklicken">
Die Schaltfläche ist ohne die Berechtigung **Eigene Felder verwalten** deaktiviert. Bitten Sie einen Administrator, die Berechtigung zu erteilen.
</Accordion>
<Accordion title="Ich möchte den Typ oder den Schlüssel eines bestehenden Feldes ändern">
Das ist nicht möglich. Legen Sie ein neues Feld mit dem richtigen Typ an und löschen Sie danach das alte Feld. Werte des alten Feldes übernimmt Tillor nicht.
</Accordion>
<Accordion title="Mein Feld steht nicht dort, wo ich es erwarte">
Prüfen Sie bei **Position im Formular**, ob Sie ein Feld gewählt haben. Bei **Standardbereich (unten)** steht das Feld nach den Standardfeldern des Formulars. Hat es eine Bedingung bei **Sichtbarkeit**, steht es nur dort, wenn diese zutrifft.
</Accordion>
</Accordions>


# Feldtypen und Einstellungen (/de-DE/eigen-velden/veldtypes)

Beim Anlegen eines Feldes wählen Sie einen Typ. Den Typ können Sie danach nicht mehr ändern. Unter **2. Einstellungen** stehen die Optionen dieses Typs. Alle Optionen sind optional, sofern unten nichts anderes steht.

Bei fast jedem Typ können Sie auch eine **Fehlermeldung** eintragen. Sie ersetzt die Standardmeldung, wenn ein Wert nicht stimmt. Mit **Platzhalter** bestimmen Sie, was im leeren Eingabefeld steht.

## Text und Langer Text [#tekst-en-lange-tekst]

**Text** ist eine Zeile, **Langer Text** mehrere Zeilen.

| Einstellung | Was sie bewirkt |
|---|---|
| **Mindestlänge** und **Maximale Länge** | Die Anzahl der Zeichen. Ohne Maximum gelten 1.000 Zeichen bei Text und 10.000 bei Langer Text |
| **Format** | **Beliebiger Text**, **E-Mail-Adresse**, **Telefonnummer**, **Webadresse**, **IBAN**, **Postleitzahl**, **Nur Ziffern** oder **Eigenes Muster** |
| **Muster (regulärer Ausdruck)** | Bei **Eigenes Muster**. Der gesamte Wert muss passen. Tillor lehnt Muster mit verschachtelten Wiederholungen oder Rückverweisen und Muster mit mehr als 200 Zeichen ab |

## Zahl und Betrag [#getal-en-bedrag]

**Betrag** verwendet die Währung Ihrer Organisation.

| Einstellung | Gilt für | Was sie bewirkt |
|---|---|---|
| **Minimum** und **Maximum** | Zahl, Betrag | Untergrenze und Obergrenze |
| **Nur ganze Zahlen** | Zahl | Keine Dezimalstellen erlaubt |
| **Darstellung** | Zahl, nur bei ganzen Zahlen | **Eingabefeld** oder **Zähler (− / +)** mit Schaltflächen |
| **Schrittweite** | Zahl | Der Wert muss das Minimum (oder 0) plus eine ganze Zahl von Schritten sein |
| **Maximale Nachkommastellen** | Zahl | Begrenzt die Dezimalstellen |

## Ja / Nein [#ja--nee]

Ein Ein/Aus-Schalter. Mit **Muss angekreuzt sein** kann der Datensatz nur mit gesetztem Häkchen gespeichert werden. Praktisch für eine Einwilligung.

## Datum [#datum]

| Einstellung | Was sie bewirkt |
|---|---|
| **Frühestes Datum** und **Spätestes Datum** | Feste Grenzen |
| **Nicht in der Vergangenheit** und **Nicht in der Zukunft** | Verglichen mit heute in der Zeitzone Ihrer Organisation |
| **Innerhalb von Tagen ab heute** | Höchstens so viele Tage vor oder nach heute |

## Auswahl und Mehrfachauswahl [#keuze-en-meerkeuze]

Sie wählen eine [Auswahlliste](/eigen-velden/keuzelijsten). **Auswahl** speichert eine Option, **Mehrfachauswahl** mehrere. Bei Mehrfachauswahl stellen Sie **Mindestens ausgewählt** und **Höchstens ausgewählt** ein. Eine Liste hat höchstens 200 Optionen.

## Verknüpfung mit Datensatz [#koppeling-naar-record]

Das Feld verweist auf einen anderen Datensatz in Tillor.

| Einstellung | Was sie bewirkt |
|---|---|
| **Verknüpft mit** | Kunde, Stellplatz, Belegung, Zähler, Aufgabe, Rechnung, Reservierung, Zahlungsbericht, Telefonanruf, Kontaktperson, Produkt, Zählerschrank, Zahlung, Dokument, NFC-Tag oder Zugangsmethode |
| **Mehrere Datensätze** | Erlaubt mehr als einen verknüpften Datensatz. Sie können dann auch ein Minimum und Maximum einstellen |
| **Darstellung** | **Auswahl** oder **Dropdown** (eine durchsuchbare Liste) |
| **Nur Datensätze dieses Kunden** | Beschränkt die Optionen auf Datensätze des Kunden, den Sie bearbeiten. Nur bei Kontaktperson, Rechnung, Reservierung, Belegung, Zahlung, Dokument, NFC-Tag und Zugangsmethode |
| **Nur Datensätze der Parzelle** | Beschränkt die Optionen auf die Zähler der Parzelle: bei einer Belegung die Parzelle dieser Belegung, bei einer Parzelle die Parzelle selbst. Nur bei Zähler. Einen Zähler einer anderen Parzelle können Sie nicht speichern |
| **Optionen filtern** | Optionales TypeScript, das pro Option bestimmt, ob sie in die Liste kommt, siehe [Optionen filtern](#opties-filteren). Bei Kontaktperson, Produkt, Zählerschrank, Zahlung, Dokument, NFC-Tag, Zugangsmethode, Rechnung, Reservierung, Belegung, Zähler und Parzelle |

Wird ein verknüpfter Datensatz später gelöscht, zeigt das Feld **Gelöscht**.

Gibt es mindestens 50 Datensätze zur Auswahl, geben Sie zuerst 2 Zeichen zum Suchen ein. Sind es weniger, etwa die Zähler einer einzelnen Parzelle, sehen Sie sofort alle.

### Optionen filtern [#opties-filteren]

Mit **Optionen filtern** bestimmen Sie selbst, welche Datensätze das Feld anbietet. Sie schreiben TypeScript, wie bei der [Tarifformel](/terreinen#tariefformule), das Tillor für jede Option ausführt. Gibt es `true` zurück, kommt die Option in die Liste, sonst nicht.

Im Filter lesen Sie Felder mit geschweiften Klammern. Das Menü **Variable** zeigt, was es gibt, einschließlich eigener Felder:

| Variable | Was es ist |
|-----------|------------|
| `{option.…}` | Der Datensatz, den Sie auswählen könnten, zum Beispiel `{option.type}` oder `{option.terrainId}` bei einem Zähler |
| `{occupation.…}`, `{terrain.…}`, … | Der Datensatz, den Sie bearbeiten, unter dem Namen seines Typs, mit `customFields` für seine eigenen Felder |

Beispiel: nur Stromzähler der Parzelle der Belegung.

```ts
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};
```

### Eigene Bezeichnungen [#eigen-labels]

Derselbe Filter kann auch bestimmen, wie eine Option in der Liste heißt. Was Sie zurückgeben, bestimmt das Ergebnis:

| Sie geben zurück | Ergebnis |
|----------------|-----------|
| `true` | Die Option steht unter ihrem eigenen Namen in der Liste |
| `false`, `null` oder ein leerer Text | Die Option steht nicht in der Liste |
| Ein Text | Die Option steht unter diesem Text in der Liste |
| `{ label, group }` | Die Option erhält diese Bezeichnung und kommt unter die Überschrift `group`. Beide sind optional |

Beispiel: nur Zähler von ICY und Hydrodigit, mit dem Typ dabei und nach Lieferant gruppiert.

```ts
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };
```

Die Bezeichnung gilt in der Auswahlliste und auf den gewählten Chips im Formular. An Stellen, die nur den Wert anzeigen, wie der Detailseite oder einem Export, steht der eigene Name des Datensatzes.

**Beispiel einfügen** unter dem Feld liefert einen Ausgangspunkt. Einen Filter, der nicht kompiliert, können Sie nicht speichern; die Meldung unter dem Feld sagt, was falsch ist.

Der Filter beschränkt nicht nur die Liste. Wählen Sie über die API oder ein altes Formular trotzdem einen Datensatz, den der Filter auslässt, verweigert Tillor das Speichern unter Nennung des Feldnamens. Automatisierungen und Importe werden nicht geprüft, so wie sie auch ausgeblendete Felder füllen dürfen.

## Feldgruppe [#groep-velden]

Ein fester Satz von Unterfeldern, die gemeinsam im Formular stehen, wie **Hunde** und **Andere Tiere** unter **Tiere**.

| Einstellung | Was sie bewirkt |
|---|---|
| **Unterfeld hinzufügen** | Jedes Unterfeld hat eine Bezeichnung, einen Typ und eigene Einstellungen. Klicken Sie auf **Mehr** für den Schlüssel, die Breite und Bedingungen. Eine Gruppe kann höchstens 30 Unterfelder haben |
| **Darstellung** | **Rahmen** (mit Rand) oder **Inline** (die Felder laufen im Formular weiter) |
| **Spalten** | 1 bis 4 |
| **Breite in der Gruppe** | Pro Unterfeld, wie viele Spalten es einnimmt |

## Wiederholende Zeilen [#herhalende-rijen]

Eine Tabelle, der Sie mit **Zeile hinzufügen** Zeilen hinzufügen, zum Beispiel mehrere Fahrzeuge. Sie stellen die Unterfelder ein wie bei einer Gruppe. Mit **Mindestanzahl Zeilen** und **Maximale Zeilen** begrenzen Sie die Liste. Ohne Maximum gelten 100 Zeilen, und mehr als 500 sind nicht möglich.

Eine Gruppe oder wiederholende Zeile darf eine Ebene tief eine weitere Gruppe oder wiederholende Zeile enthalten, nicht weiter.

## Dateien [#bestanden]

Für Dokumente und Fotos. Eine hochgeladene Datei kann nur öffnen, wer das Feld sehen darf.

| Einstellung | Was sie bewirkt |
|---|---|
| **Mehrere Dateien** | Erlaubt mehr als eine Datei |
| **Mindestanzahl Dateien** und **Höchstanzahl Dateien** | Ohne Maximum gelten 20 Dateien, und mehr als 50 sind nicht möglich |
| **Maximale Größe pro Datei (MB)** | Höchstens 50 MB pro Datei, auch wenn Sie einen höheren Wert wünschen |
| **Erlaubte Dateitypen** | **Jede Datei**, **Bilder**, **PDF**, **Office-Dokumente** oder eine eigene Endung wie `.dwg` oder ein MIME-Typ wie `application/zip` |

Tillor prüft den Typ anhand des Inhalts der Datei, nicht nur anhand des Namens.

## JSON [#json]

Gedacht für strukturierte Daten, die eine Verknüpfung mit einem anderen System mitliefert. Kollegen füllen dies selten im Formular aus. Mit **Maximale Größe (KB)** legen Sie eine Grenze fest, standardmäßig 64 KB und höchstens 256 KB.

## Einstellungen für jeden Typ [#instellingen-voor-elk-type]

| Einstellung | Was sie bewirkt |
|---|---|
| **Diesen Wert verschlüsseln** | Speichert den Wert verschlüsselt. Ein verschlüsseltes Feld lässt sich nicht durchsuchen, filtern oder sortieren und steht nicht als Variable in Automatisierungen zur Verfügung. Nur für Felder der obersten Ebene, also nicht für Unterfelder. Alle eigenen Felder werden ohnehin verschlüsselt gespeichert, ob Sie dies aktivieren oder nicht |
| **Nur API** | Blendet das Feld in Formularen und Detailansichten aus. Eine Verknüpfung füllt es über die API. Ein solches Feld kann kein Pflichtfeld sein |
| **Nur API, schreibgeschützt** | Zeigt das Feld an, aber deaktiviert, sodass Kollegen den Wert sehen, aber nicht ändern |
| **Validierungsregeln** | Vergleichen Sie ein Datum, eine Zahl oder einen Betrag mit einem anderen Feld (**Vor**, **Am oder vor**, **Nach**, **Am oder nach**, mit einem Abstand in Tagen, Wochen oder Monaten) oder prüfen Sie den Wert mit einem Ausdruck. Höchstens 10 Regeln pro Feld |

Eine geänderte Grenze gilt nicht rückwirkend. Ein Wert, den Sie nicht anpassen, blockiert das Speichern des Datensatzes nicht, auch wenn er der neuen Regel nicht mehr entspricht.


# Sichtbarkeit und Zugriff (/de-DE/eigen-velden/zichtbaarheid-en-toegang)

Ein eigenes Feld steht im Formular des Datensatzes, zu dem es gehört. Standardmäßig darf jeder mit Zugriff auf diesen Datensatz das Feld sehen und ausfüllen. Das können Sie pro Feld einschränken.

## Wo Sie die Werte sehen [#waar-je-de-waarden-ziet]

Eigene Felder füllen Sie an derselben Stelle aus wie die übrigen Daten des Datensatzes.

| Datensatz | Wo |
|---|---|
| Kunde | Der Block **Kundendetails** im Kundenprofil |
| Gelände, Zähler, Belegung, Reservierung, Produkt, Dokument, Zugangsmethode | Das Formular zum Anlegen oder Bearbeiten des Datensatzes |
| Aufgabe | Das Aufgabenfenster. Änderungen speichern Sie mit **Felder speichern** |

Ein Feld steht an der Stelle, die Sie bei **Position im Formular** gewählt haben. Ohne Auswahl steht es nach den Standardfeldern.

<DocScreenshot src="/screenshots/eigen-velden/customer-custom-fields.png" alt="Das Kundenprofil mit eigenen Feldern wie Hunde, Ankunftsdatum und Nummer der Gasflaschenkaution zwischen den Standardfeldern" />

Ist ein Feld ein Pflichtfeld, können Sie den Datensatz nicht speichern, solange es leer ist. Ein Feld mit **Sichtbarkeit** erscheint erst, wenn die Bedingung erfüllt ist.

Eigene Felder finden Sie auch im Export von Kunden und Geländen wieder und können sie in Automatisierungen verwenden.

## Wer ein Feld sehen oder bearbeiten darf [#wie-mag-een-veld-zien-of-bewerken]

Öffnen Sie das Feld unter <UIPath>Einstellungen > Eigene Felder</UIPath> und gehen Sie zu **4. Zugriff**. Klicken Sie auf **Einschränken**.

<Requires permission="Eigene Felder verwalten" />

<DocScreenshot src="/screenshots/eigen-velden/field-edit-access.png" alt="Feld bearbeiten mit Wer dieses Feld sieht und Wer dieses Feld bearbeitet" />

Es gibt zwei Blöcke.

| Block | Was er bewirkt |
|---|---|
| **Wer dieses Feld sieht** | Lassen Sie ihn leer, darf es jedes Mitglied sehen. Wer es nicht sehen darf, bekommt den Wert nie zu sehen, auch nicht in Exporten oder Automatisierungen, die er bearbeitet |
| **Wer dieses Feld bearbeitet** | Lassen Sie ihn leer, darf jeder, der das Feld sieht, es auch bearbeiten. Andere sehen es nur schreibgeschützt |

In jedem Block wählen Sie einen **Kollegen oder eine Gruppe** und/oder eine **Berechtigung**. Passt jemand zu einem der gewählten Kollegen, Gruppen oder Berechtigungen, hat er Zugriff. Bearbeiten ist nur möglich, wenn Sie das Feld auch sehen dürfen.

In der Liste erhält ein solches Feld das Label **Eingeschränkt**. Fahren Sie mit der Maus darüber für die Erklärung: Nur bestimmte Kollegen, Gruppen oder Berechtigungen dürfen dieses Feld sehen oder bearbeiten.

<Callout type="warn" title="Ein verborgenes Feld ist kein geschütztes Feld">
Die Option **Sichtbarkeit** (eine Bedingung) verbirgt ein Feld nur im Formular. Wer das Feld sehen darf, kann den Wert trotzdem finden. Verwenden Sie **Wer dieses Feld sieht**, wenn sonst niemand es lesen darf.
</Callout>

## Wer Felder verwalten darf [#wie-mag-velden-beheren]

Felder anlegen, ändern, neu anordnen und löschen sowie Auswahllisten verwalten erfordert die Berechtigung **Eigene Felder verwalten**. Wie Sie Berechtigungen vergeben, steht unter [Benutzer einladen und Berechtigungen vergeben](/gebruikers/gebruikers-en-rechten). Die Seite **Eigene Felder** ist für alle sichtbar, die Einstellungen ansehen oder bearbeiten dürfen oder diese Berechtigung haben. Ohne die Berechtigung sehen Sie nur die Felder, die Sie lesen dürfen, und **Neues Feld**, Bearbeiten und Löschen sind deaktiviert.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ein Kollege sieht ein Feld nicht">
Prüfen Sie bei **Wer dieses Feld sieht**, ob dieser Kollege, seine Gruppe oder eine seiner Berechtigungen ausgewählt ist. Ist das Feld ein **Nur API**-Feld, steht es nicht in Formularen.
</Accordion>
<Accordion title="Ein Kollege kann ein Feld nicht ändern">
Schauen Sie bei **Wer dieses Feld bearbeitet**. Sind dort Kollegen, Gruppen oder Berechtigungen ausgewählt, sind andere auf Lesen beschränkt. Versucht jemand trotzdem, den Wert zu ändern, lehnt Tillor das ab.
</Accordion>
</Accordions>


# Eine Rechnung erstellen und bearbeiten (/de-DE/facturen/aanmaken-en-bewerken)

Eine neue Rechnung ist immer ein Entwurf: Sie erstellen sie im Kundenprofil und füllen die Positionen aus. Solange sie ein Entwurf ist, können Sie Positionen hinzufügen, anpassen, verschieben und löschen. Danach [buchen Sie sie](/facturen/boeken).

Bevor Sie beginnen:

- Der Kunde existiert bereits in Tillor. Siehe [Kundenverwaltung](/klantenbeheer).
- Für Produkte mit einem Gelände oder einer Belegung hat der Kunde eine Belegung auf diesem Gelände. Ohne Belegung erstellen Sie ein Angebot, das Sie nicht buchen können.

## Eine Rechnung erstellen [#een-factuur-aanmaken]

Rechnungen erstellen Sie im Kundenprofil, nicht über <UIPath>Verwaltung > Rechnungen</UIPath>.

<Steps>
<Step>
### Den Kunden öffnen [#open-de-klant]
Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath> und öffnen Sie das Profil des Kunden.
</Step>
<Step>
### Die Rechnung erstellen [#maak-de-factuur-aan]
Klicken Sie im Block **Rechnungen** auf **Neue Rechnung**. Tillor erstellt einen Rechnungsentwurf und öffnet sofort die Rechnungsseite.

<DocScreenshot src="/screenshots/klanten/customer-new-invoice.png" alt="Neue Rechnung aus dem Kundenprofil" />
</Step>
</Steps>

Die Rechnung erhält eine vorläufige Entwurfsnummer. Die endgültige Rechnungsnummer, das Rechnungsdatum und das Fälligkeitsdatum kommen erst beim [Buchen](/facturen/boeken).

## Positionen hinzufügen und anpassen [#regels-toevoegen-en-aanpassen]

Auf der Rechnungsseite steht eine Tabelle mit den Rechnungspositionen. Unten steht eine leere Zeile, in der Sie eine neue Position beginnen.

<Steps>
<Step>
### Ein Produkt wählen oder eine Beschreibung eingeben [#kies-een-product-of-typ-een-omschrijving]
Wählen Sie ein **Produkt** aus der Liste, dann füllt Tillor die **Beschreibung** und den Preis aus. Sie können auch selbst eine Beschreibung eingeben.
</Step>
<Step>
### Menge und Preis eingeben [#vul-aantal-en-prijs-in]
Passen Sie die **Menge** und den **Preis (inkl. MwSt.)** pro Einheit an, wo nötig. Der **Gesamt**betrag der Position wird automatisch berechnet. Ist für Ihre Organisation die Einstellung für MwSt. pro Position aktiviert, wählen Sie auch den MwSt.-Satz.
</Step>
<Step>
### Eine Notiz hinzufügen (optional) [#voeg-een-notitie-toe-optioneel]
Unter der Tabelle können Sie eine **Notiz (optional)** ausfüllen. Dieser Text steht auf der Rechnung und ist für den Kunden sichtbar.
</Step>
</Steps>

Änderungen werden fast sofort automatisch gespeichert. Sie können auch auf **Änderungen speichern** klicken oder auf **Abbrechen**, um nicht gespeicherte Änderungen zurückzunehmen.

### Positionen neu anordnen oder löschen [#regels-herschikken-of-verwijderen]

- Ziehen Sie eine Position am Griff links daneben, um die Reihenfolge zu ändern.
- Klicken Sie auf das Kreuz rechts neben einer Position, um sie zu löschen.

In der Zeitleiste **Ereignisse** neben der Rechnung sehen Sie, was wann geändert wurde, mit dem Vorher und Nachher der Felder und Positionen.

## Positionen mit einer Aktion [#regels-met-een-actie]

Hat das gewählte Produkt eine Aktion auf der Rechnungsposition, erscheinen unter der Position zusätzliche Eingaben. Welche Aktionen ein Produkt hat, stellen Sie beim Produkt selbst ein. Siehe [Produktaktionen](/producten/productacties).

| Aktion | Was Sie auf der Rechnung ausfüllen |
|-------|-----------------------------|
| **NFC-Tag aufladen** | Der Tag, der aufgeladen werden soll. Nach der Zahlung schreibt Tillor den Betrag dem Guthaben des Tags gut. |
| **Periode** | Start- und Enddatum und bei einem Produkt mit Gelände auch der **Stellplatz** (in einer Liste oder **Auf der Karte wählen**). |
| **Belegung verlängern** | Der Stellplatz, für den Sie die Belegung verlängern, plus Start- und Enddatum. |
| **Kontaktdaten abfragen** | E-Mail-Adresse und Telefonnummer des Kunden. Sind sie Pflicht, können Sie ohne sie nicht buchen. |
| **Zugangsmethode erstellen** | Der Typ der Zugangsmethode und gegebenenfalls ein Kennzeichen oder eine PIN. |
| **Hinweis anzeigen** | Nichts. Sie sehen nur einen Hinweis mit dem Text, der beim Produkt eingestellt ist. |
| **Buchung verhindern** | Nichts. Die Rechnung kann nicht gebucht werden, solange die Position darauf steht. |

### Zeitraum und Stellplatz wählen [#periode-en-terrein-kiezen]

Bei einer Position mit **Periode** wählen Sie ein Start- und ein Enddatum. Darunter sehen Sie die Anzahl der Tage und die **Menge**, die Tillor berechnet. Passt der Zeitraum nicht genau auf eine Woche oder einen Monat des Produkts, rundet Tillor auf und es steht **Aufgerundet** dabei. Mit dem Kästchen **Pro rata** berechnen Sie eine angebrochene Woche oder einen angebrochenen Monat dagegen anteilig. Dieses Kästchen erscheint nur bei Produkten mit einer Wochen- oder Monatsperiode.

Verlangt das Produkt einen Stellplatz, wählen Sie zuerst den Zeitraum und danach den **Stellplatz**.

Beim Buchen erstellt Tillor die Reservierung. Auf der Position erscheint danach eine Karte mit Reservierungsnummer, Status, Stellplatz und Daten. Ob der Kunde sofort eingecheckt wird, hängt vom Produkt ab: Bei **Beim Buchen einchecken** geschieht es beim Buchen, bei **Beim Bezahlen einchecken** erst, sobald die Rechnung bezahlt ist. Eine Anzahlung hält nur den Stellplatz fest.

### Eine Belegung verlängern [#een-bezetting-verlengen]

Mit **Belegung verlängern** stellen Sie einen Zeitraum für eine Belegung des Kunden in Rechnung, zum Beispiel Stellplatzgebühren.

<Steps>
<Step>
### Den Stellplatz wählen [#kies-het-terrein]
Wählen Sie bei **Aktive Belegung auswählen** den Stellplatz. Die Liste zeigt die aktiven Belegungen des Kunden.
</Step>
<Step>
### Den Zeitraum wählen [#kies-de-periode]
Wählen Sie das **Startdatum**. Danach öffnet Tillor sofort den Kalender für das **Enddatum**. Unter den Daten sehen Sie, bis wann die Belegung jetzt in Rechnung gestellt ist und wie viele Tage und welche Menge die Position umfasst.
</Step>
<Step>
### Das Runden einstellen [#stel-het-afronden-in]
Das Kästchen **Auf nächste Periodengrenze runden** ist standardmäßig aktiviert. Dann endet die Position an der nächsten Periodengrenze der Mietfrequenz, sodass der Kunde auf Dauer demselben Zyklus folgt. Ist das Kästchen ausgeschaltet, dauert die Position genau eine Periode ab dem Startdatum.
</Step>
</Steps>

Die Position erhält eine Beschreibung in der Form **Produktname | Stellplatzname | Zeitraum**. Das Enddatum zählt als letzter Tag, und eine halbe Periode wird auch zur Hälfte berechnet.

Hat die Belegung bereits ein Datum bei **Bezahlt bis** und ist das Runden aktiv, beginnt die neue Position am Tag danach. Ist **Bezahlt bis** noch leer, wählen Sie das Startdatum selbst und Tillor berechnet das Enddatum bis zur nächsten Periodengrenze. Was nach dem Buchen und Bezahlen mit **Bezahlt bis** und **Fakturiert bis** geschieht, steht unter [Belegungen](/bezettingen).

Zwei zusätzliche Kästchen helfen in Ausnahmesituationen:

- **Alle Terrains anzeigen (Angebot)** lässt Sie einen beliebigen Stellplatz wählen, um ein Angebot zu erstellen. Hat der Kunde diesen Stellplatz nicht in Belegung, können Sie die Rechnung nicht buchen. Benutzer mit der Berechtigung **Rechnungskorrekturen** können eine solche Rechnung trotzdem einbuchen, siehe [Eine Rechnung buchen](/facturen/boeken#problemen).
- **Als Gutschrift (Erstattung)** macht aus der Position eine Erstattung. Die Menge wird negativ und der Zeitraum läuft von heute bis **Bezahlt bis**. Mit **Auf Periodengrenze runden** runden Sie ihn auf eine Periodengrenze.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Änderungen werden fast sofort automatisch gespeichert. Die Zeitleiste **Ereignisse** zeigt, wer was geändert hat.
- Es geht nichts an den Kunden, und an Belegungen oder Tags ändert sich nichts. Das geschieht erst beim [Buchen](/facturen/boeken) und bei der Zahlung.
- Einen Entwurf mit einer Position **Buchung verhindern** können Sie nicht buchen.
- Einen Entwurf löschen Sie mit **Rechnung löschen** im Aktionsmenü.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann die Positionen nicht mehr anpassen">
Nur Rechnungsentwürfe sind bearbeitbar. Eine gebuchte Rechnung können Sie unter Bedingungen in den Entwurf zurücksetzen, siehe [Eine Rechnung korrigieren](/facturen/corrigeren#terugzetten-naar-concept).
</Accordion>
<Accordion title="Eine Position mit NFC-Tag aufladen zeigt keine Tags">
Der Kunde hat keinen verfügbaren Tag. Verknüpfen Sie zuerst einen NFC-Tag mit dem Kunden. Siehe [NFC](/nfc).
</Accordion>
<Accordion title="Ich sehe die Schaltfläche Neue Rechnung nicht">
Die Schaltfläche steht im Kundenprofil im Block **Rechnungen**, nicht in der Rechnungsliste unter **Verwaltung**.
</Accordion>
<Accordion title="Der Kunde steht nicht in der Liste Aktive Belegung auswählen">
Bei **Belegung verlängern** zeigt die Liste nur aktive Belegungen des Kunden. Legen Sie zuerst eine Belegung an, siehe [Belegungen](/bezettingen), oder verwenden Sie **Alle Terrains anzeigen (Angebot)** für ein Angebot.
</Accordion>
</Accordions>

## Weiter [#verder]

<Cards>
  <Card title="Eine Rechnung buchen" href="/facturen/boeken" />
  <Card title="Produkte" href="/producten" description="Aktionen auf Rechnungspositionen einstellen" />
</Cards>


# Eine Rechnung drucken, herunterladen oder teilen (/de-DE/facturen/afdrukken-en-downloaden)

Mit **Drucken** drucken Sie eine Rechnung, speichern sie als PDF oder senden sie an einen Drucker. Die Schaltfläche steht auf jeder Rechnungsseite, auch bei einem Entwurf. Der Pfeil daneben öffnet ein Menü mit den anderen Optionen. Einen Link für den Kunden erstellen Sie unter [Einen persönlichen Link teilen](#een-persoonlijke-link-delen).

Bevor Sie beginnen: Für die Druckeroptionen läuft ein Tillor Connector für Ihre Organisation. Ohne Connector sind diese Optionen grau.

## Drucken oder speichern [#afdrukken-of-opslaan]

| Option | Was sie bewirkt |
|-------|--------------|
| **Drucken** | Öffnet das Druckfenster Ihres Browsers. Dafür können Sie auch das Tastenkürzel Strg+P (Cmd+P auf einem Mac) verwenden. |
| **In neuem Fenster öffnen** | Zeigt das PDF in einem neuen Fenster. |
| **PDF herunterladen** | Speichert die Rechnung als PDF-Datei. |
| **An A4-Drucker senden** | Sendet die Rechnung an Ihren angeschlossenen A4-Drucker. |
| **An Belegdrucker senden** | Sendet die Rechnung an Ihren angeschlossenen Belegdrucker. |

Die beiden Druckeroptionen sind grau, solange kein Tillor Connector für Ihre Organisation aktiv ist. Wie Sie Drucker einrichten, steht unter [Drucker](/printer).

## Die Rechnung auf einem Tablet anzeigen [#de-factuur-tonen-op-een-tablet]

Steht an der Rezeption ein Tablet, das Kundendokumente anzeigt, können Sie die Rechnung dort erscheinen lassen. Öffnen Sie die drei Punkte oben rechts auf der Rechnungsseite und wählen Sie **Vorschau auf iPad**. Bei einer Barzahlung steht dieselbe Schaltfläche auch im Zahlungsfenster.

## Einen persönlichen Link teilen [#een-persoonlijke-link-delen]

Bei einer gebuchten Rechnung können Sie einen Link erstellen, den der Kunde selbst öffnen kann, um die Rechnung anzusehen und, wenn noch etwas offen ist, online zu bezahlen.

<Steps>
<Step>
### Das Aktionsmenü öffnen [#open-het-actiemenu]
Klicken Sie auf die drei Punkte oben rechts auf der Rechnungsseite und wählen Sie **Persönliche URL**.
</Step>
<Step>
### Den Link teilen [#deel-de-link]
Tillor kopiert den Link in Ihre Zwischenablage und zeigt die Meldung **URL generiert**. Fügen Sie ihn in eine Nachricht oder E-Mail an den Kunden ein.
</Step>
</Steps>

<DocScreenshot src="/screenshots/facturen/invoice-actions-menu.png" alt="Aktionsmenü der Rechnung - Persönliche URL, Rechnung kopieren, Rechnung stornieren" />

Das Aktionsmenü enthält noch weitere Optionen. Siehe [Eine Rechnung korrigieren](/facturen/corrigeren) zum Kopieren, Stornieren und Neuberechnen einer Rechnung.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Drucken, Herunterladen und das Senden an den Drucker ändern nichts an der Rechnung.
- Bei **Vorschau auf iPad** sieht der Kunde die Rechnung auf dem Tablet. In der Zeitleiste der Rechnung steht, dass das PDF an das Tablet gesendet wurde.
- Der persönliche Link hat kein Ablaufdatum. Der Kunde sieht dort den offenen Betrag und kann online bezahlen. Siehe [Einen Kunden online bezahlen lassen](/betalingsverwerking/online).
- Produkte können bei der Zahlung auch automatisch drucken. Siehe [Produktaktionen](/producten/productacties#thermisch-printen-en-a4-printen).

## Probleme? [#problemen]

<Accordions>
<Accordion title="An A4-Drucker senden ist grau">
Für Ihre Organisation ist kein aktiver Tillor Connector vorhanden. Prüfen Sie die Verbindung und die Druckereinstellungen, siehe [Drucker](/printer).
</Accordion>
<Accordion title="Persönliche URL fehlt">
Diese Option steht nur im Aktionsmenü einer gebuchten Rechnung.
</Accordion>
<Accordion title="Das Drucken schlägt fehl">
Tillor zeigt dann eine Meldung mit dem Grund, zum Beispiel dass Papier oder Toner leer ist. Beheben Sie das und versuchen Sie es erneut.
</Accordion>
</Accordions>

## Weiter [#verder]

<Cards>
  <Card title="Drucker" href="/printer" description="Drucker einrichten und automatisch drucken" />
  <Card title="Eine Rechnung versenden" href="/facturen/versturen" />
</Cards>


# Eine Zahlung erfassen (/de-DE/facturen/betalingen-registreren)

Auf einer gebuchten Rechnung mit offenem Betrag führen Sie eine Zahlung aus oder erfassen eine, zum Beispiel eine Kartenzahlung, Barzahlung oder ein Lastschrifteinzug. Der Betrag, der Zahlungsstatus und die Liste **Zahlungen** neben der Rechnung werden danach aktualisiert. Alle Methoden stehen auch unter [Zahlungsabwicklung](/betalingsverwerking).

Bevor Sie beginnen:

- Die Rechnung ist gebucht und es ist noch ein Betrag offen. Sonst fehlt **Zahlung vornehmen**.
- Für **Terminal** ist Mollie verknüpft. Für **SEPA-Mandat** hat der Kunde ein aktives Mandat. Sonst steht die Methode nicht in der Liste oder ist grau.

## Eine Zahlung ausführen [#een-betaling-uitvoeren]

<Steps>
<Step>
### Die gebuchte Rechnung öffnen [#open-de-geboekte-factuur]
Gehen Sie zu <UIPath>Verwaltung > Rechnungen</UIPath> und öffnen Sie eine gebuchte Rechnung. Die Schaltfläche **Zahlung vornehmen** steht dort, solange ein Betrag offen ist.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Gebuchte Rechnung - Zahlung vornehmen" />
</Step>
<Step>
### Die Zahlungsmethode wählen [#kies-de-betaalmethode]
Klicken Sie auf **Zahlung vornehmen** und wählen Sie eine **Zahlungsmethode**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Zahlungsdialog - Zahlungsmethode und Betrag" />

| Methode | Verwenden Sie für |
|---------|-----------------|
| **Terminal** | Eine Kartenzahlung. Sie wählen ein Zahlungsterminal und Tillor sendet die Zahlung dorthin. Siehe [Terminal](/betalingsverwerking/terminal). |
| **Interne Überweisung** | Den Betrag auf eine andere gebuchte Rechnung desselben Kunden verschieben (**Zielrechnung**). Siehe [Interne Überweisung](/betalingsverwerking/interne-overboeking). |
| **Bar** | Eine Barzahlung erfassen. Siehe [Bar](/betalingsverwerking/contant). |
| **Überweisung** | Eine eingegangene Banküberweisung erfassen. |
| **SEPA-Mandat** | Einen automatischen Einzug über ein aktives **Mandat** des Kunden. Siehe [Mandat](/betalingsverwerking/mandaat). |
| **Sonstige** | Eine andere Zahlungsform, etwa ein Scheck. Steht hinter **Weitere Zahlungsmethoden** und ist nur sichtbar, wenn Sie das aktiviert haben. Eine Beschreibung ist dann Pflicht. |

**Terminal** und **SEPA-Mandat** stehen nur dort, wenn sie für Ihre Organisation verfügbar sind. **SEPA-Mandat** ist grau, solange der Kunde kein aktives Mandat hat, und existiert nicht für Gutschriften.
</Step>
<Step>
### Den Betrag eingeben [#vul-het-bedrag-in]
Der **Betrag** steht standardmäßig auf dem vollständigen offenen Betrag. Geben Sie einen anderen Betrag ein oder verwenden Sie die Schaltflächen **25%**, **50%**, **75%** und **100%**. Der Betrag darf nicht höher sein als der offene Betrag.
</Step>
<Step>
### Die zusätzlichen Felder ausfüllen [#vul-de-extra-velden-in]
Bei **Bar**, **Überweisung** und **Sonstige** füllen Sie optional das **Eingangsdatum** (nicht in der Zukunft) und einen **Hinweis** aus. Bei einem Einzug wählen Sie das **Mandat** und gegebenenfalls eine **Verzögerung (Tage)**, wobei 0 sofort sendet.

Wählen Sie **Überweisung** und hat der Kunde eine E-Mail-Adresse, können Sie **Erinnerung zur strukturierten Mitteilung senden** anhaken. Der Kunde erhält dann eine E-Mail mit dem Tipp, bei späteren Zahlungen die strukturierte Mitteilung zu verwenden.
</Step>
<Step>
### Die Zahlung ausführen [#voer-de-betaling-uit]
Klicken Sie auf **Zahlung ausführen**.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Zahlungen auf der Rechnung" />
</Step>
</Steps>

Bei **Bar** gibt es auch eine Schaltfläche **Vorschau auf iPad**, um dem Kunden die Rechnung auf einem verknüpften Tablet zu zeigen.

## Höchstbeträge [#maximumbedragen]

Eine Barzahlung darf nicht höher sein als der **Höchstbetrag Bargeld** unter <UIPath>Support > Einstellungen > Zahlungen</UIPath> (standardmäßig 2999 Euro). Bei einem Einzug darf der Betrag den Höchstbetrag des Mandats nicht überschreiten.

## Eine bestehende Zahlung verknüpfen [#een-bestaande-betaling-koppelen]

Ist bereits eine Zahlung oder Banktransaktion eingegangen, die zu dieser Rechnung gehört, verknüpfen Sie diese, statt eine neue zu erstellen.

<Requires permission="Zahlung zuweisen" />

<Steps>
<Step>
### Das Aktionsmenü öffnen [#open-het-actiemenu]
Klicken Sie auf die drei Punkte oben rechts auf der Rechnungsseite und wählen Sie **Zahlung zuweisen**.
</Step>
<Step>
### Die Zahlung wählen [#kies-de-betaling]
Wählen Sie im Fenster eine Zahlung oder Gruppe. Auf den Registerkarten **Zahlungsgruppen**, **Karten- und Onlinezahlungen** und **Banktransaktionen** steht, was verfügbar ist. Oben stehen Vorschläge, die zum offenen Betrag passen.
</Step>
<Step>
### Verknüpfen [#koppel]
Klicken Sie auf **Zahlung zuweisen**, **Gruppe zuweisen** oder **Banktransaktion zuweisen**, je nachdem, was Sie gewählt haben.
</Step>
</Steps>

Für Banktransaktionen benötigen Sie außerdem die Berechtigung **Banktransaktionen anzeigen**.

## Einen Link für eine Teilzahlung erstellen [#een-link-voor-een-deelbetaling-maken]

Möchte der Kunde nur einen Teil des offenen Betrags bezahlen, erstellen Sie einen Zahlungslink für einen Betrag, den Sie wählen. Das ist bei jeder gebuchten Rechnung mit offenem Betrag möglich.

<Steps>
<Step>
### Das Aktionsmenü öffnen [#open-het-actiemenu-1]
Klicken Sie auf die drei Punkte neben **Benachrichtigung senden** und wählen Sie **Link für Teilzahlung**.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-menu.png" alt="Aktionsmenü einer Rechnung mit Link für Teilzahlung" />
</Step>
<Step>
### Den Betrag eingeben [#vul-het-bedrag-in-1]
Geben Sie bei **Betrag** ein, was der Kunde bezahlen darf. Der Betrag muss größer als 0 sein und darf nicht höher sein als der noch offene Betrag.
</Step>
<Step>
### Den Link erstellen [#maak-de-link]
Klicken Sie auf **Link erstellen und kopieren**. Tillor kopiert den Link in Ihre Zwischenablage und zeigt ihn unter **Zahlungslink** an. Mit der Kopierschaltfläche daneben kopieren Sie ihn erneut.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-dialog.png" alt="Dialog Link für Teilzahlung mit Betrag und Zahlungslink" />
</Step>
</Steps>

Senden Sie den Link selbst an den Kunden, zum Beispiel per E-Mail oder Chat. Der Kunde öffnet die normale Zahlungsseite der Rechnung, die nun aber nur Ihren Betrag verlangt, mit dem Hinweis, dass es sich um eine Teilzahlung des noch offenen Betrags handelt. Der Kunde bezahlt dann auf die Weise, die er auf [der Zahlungsseite](/betalingsverwerking/online) wählt.

Der Link bleibt gültig, verlangt aber nie mehr, als zu diesem Zeitpunkt noch offen ist. Ist zwischenzeitlich schon ein Teil bezahlt worden, geht die Zahlungsseite entsprechend zurück. Nach einer Zahlung steht die Rechnung auf <Status tone="warning">Teilweise</Status>, bis der gesamte Betrag eingegangen ist.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Der offene Betrag sinkt und der Zahlungsstatus ändert sich: <Status tone="warning">Teilweise</Status>, solange noch etwas offen ist, <Status tone="success">Bezahlt</Status>, wenn alles eingegangen ist.
- Bei einem Einzug oder einer Kartenzahlung steht die Rechnung zunächst auf <Status tone="info">Ausstehend</Status>, bis das Geld endgültig eingegangen ist.
- Hat eine Position eine Zahlungsaktion, führt Tillor diese aus, sobald die Rechnung bezahlt ist. Denken Sie an das Aufladen eines NFC-Tags, das Verlängern von **Bezahlt bis** einer Belegung oder das Drucken eines Belegs. Siehe [Wie hängt das zusammen?](/producten#hoe-hangt-dit-samen).
- Die Zahlung kommt in den Zahlungsbericht des Tages. Siehe [Zahlungsberichte](/boekhouden/betalingsrapporten).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe Zahlung vornehmen nicht">
Die Rechnung muss gebucht sein und es muss ein Betrag offen sein. Auf einem Rechnungsentwurf können Sie nicht bezahlen.
</Accordion>
<Accordion title="Ich sehe Link für Teilzahlung nicht">
Die Rechnung muss gebucht sein und es muss noch ein Betrag offen sein.
</Accordion>
<Accordion title="SEPA-Mandat ist grau">
Der Kunde hat kein aktives Mandat. Richten Sie das in den Kundendaten ein, siehe [Mandat](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Ich kann Sonstige nicht wählen">
Diese Zahlungsmethode ist standardmäßig ausgeschaltet. Aktivieren Sie **Zahlungsmethode "Sonstige" anzeigen** unter <UIPath>Support > Einstellungen > Zahlungen</UIPath>.
</Accordion>
<Accordion title="Die Rechnung steht auf Ausstehend">
Die Zahlung ist gestartet, zum Beispiel ein Einzug, aber das Geld ist noch nicht endgültig eingegangen. Sobald die Zahlung verarbeitet ist, springt der Status auf **Bezahlt**. Siehe [Status](/facturen/statussen).
</Accordion>
</Accordions>

## Weiter [#verder]

<Cards>
  <Card title="Zahlungsabwicklung" href="/betalingsverwerking" description="Alle Zahlungsmethoden im Detail" />
  <Card title="Status" href="/facturen/statussen" />
</Cards>


# Eine Rechnung buchen (/de-DE/facturen/boeken)

Das Buchen macht aus einem Entwurf eine endgültige Rechnung mit eigener Rechnungsnummer. Erst danach können Sie die Rechnung [versenden](/facturen/versturen) und [bezahlen lassen](/facturen/betalingen-registreren). Prüfen Sie die Positionen also, bevor Sie buchen, denn eine gebuchte Rechnung lässt sich nicht mehr frei ändern.

Bevor Sie beginnen:

- Die Rechnung hat mindestens eine Position oder einen Gesamtbetrag, der nicht null ist.
- Positionen mit **Periode** oder **Belegung verlängern** haben ein Start- und Enddatum.
- Hat eine Position eine Aktion, die Daten verlangt, sind diese ausgefüllt. Denken Sie an **Kontaktdaten abfragen** oder **Zugangsmethode erstellen**.
- Für einen belgischen Kunden mit einer MwSt.-Nummer ist eine Peppol-ID eingetragen. Siehe [Peppol](/boekhouden/peppol).

Stimmt etwas nicht, ist **Rechnung buchen** grau. Fahren Sie mit der Maus über die Schaltfläche, um den Grund zu lesen. Siehe auch [Probleme?](#problemen).

## Eine Rechnung buchen [#een-factuur-boeken]

<Steps>
<Step>
### Den Rechnungsentwurf öffnen [#open-de-conceptfactuur]
Gehen Sie zu <UIPath>Verwaltung > Rechnungen</UIPath> und öffnen Sie eine Rechnung mit dem Status <Status>Entwurf</Status>, zum Beispiel über die Liste **Entwürfe**.
</Step>
<Step>
### Die Rechnung prüfen [#controleer-de-factuur]
Sehen Sie die Positionen und die Notiz durch.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Rechnungsentwurf - Positionen und Rechnung buchen" />
</Step>
<Step>
### Auf Rechnung buchen klicken [#klik-op-boek-factuur]
Die Rechnung erhält eine fortlaufende Rechnungsnummer. Tillor meldet, dass die Rechnung gebucht wurde.
</Step>
</Steps>

## Was ändert sich? [#wat-verandert-er]

So sieht eine Rechnung vor und nach dem Buchen aus. Es sind zwei verschiedene Beispielrechnungen, aber Sie sehen den Unterschied bei Nummer, Status und Schaltflächen.

**Vor dem Buchen**: eine vorläufige Entwurfsnummer und die Schaltfläche **Rechnung buchen**.

<DocScreenshot src="/screenshots/facturen/invoice-before-title.png" alt="Titel eines Rechnungsentwurfs mit der Entwurfsnummer CON/2026/0001" />

<DocScreenshot src="/screenshots/facturen/invoice-before-toolbar.png" alt="Schaltflächen eines Rechnungsentwurfs: Rechnung buchen und Drucken" />

**Nach dem Buchen**: eine endgültige Rechnungsnummer, ein Zahlungsstatus und die Schaltflächen **Zahlung vornehmen** und **Benachrichtigung senden**.

<DocScreenshot src="/screenshots/facturen/invoice-after-title.png" alt="Titel einer gebuchten Rechnung mit der Nummer INV/2026/0001 und dem Zahlungsstatus Teilweise" />

<DocScreenshot src="/screenshots/facturen/invoice-after-toolbar.png" alt="Schaltflächen einer gebuchten Rechnung: Zahlung vornehmen, Drucken und Benachrichtigung senden" />

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das **Rechnungsdatum** ist der Tag des Buchens. Das **Fälligkeitsdatum** ist dieser Tag plus die **Standardfälligkeit (Tage)** Ihrer Organisation, standardmäßig 7 Tage. Sie passen diese unter <UIPath>Support > Einstellungen > Rechnungseinstellungen</UIPath> an.
- Ist der Gesamtbetrag kein Vielfaches von 5 Cent, fügt Tillor selbst eine Position **Rundung** hinzu.
- Hat die Rechnung einen negativen Gesamtbetrag, wird sie zur **Gutschrift**.
- Hat der Kunde eine Peppol-ID, versendet Tillor die Rechnung automatisch über Peppol. Siehe [Peppol](/boekhouden/peppol).
- Positionen mit **Belegung verlängern** setzen **Fakturiert bis** der Belegung auf das Ende der Position. **Bezahlt bis** folgt erst bei der Zahlung. Siehe [Wie hängt das zusammen?](/producten#hoe-hangt-dit-samen).
- Positionen mit **Periode** und **Stellplatz abfragen** erstellen eine Reservierung. Ob der Kunde sofort eingecheckt wird, hängt vom Produkt ab.
- Ist ein Einzugsmandat verknüpft, erstellt Tillor sofort eine offene Zahlung. Die Bank wird zwei Tage nach dem Buchen belastet.
- Der Kunde erhält nichts automatisch. Die Benachrichtigung senden Sie selbst, siehe [Eine Rechnung versenden](/facturen/versturen).
- Möchten Sie doch noch etwas ändern? Innerhalb von 7 Tagen und solange nichts versendet wurde, setzen Sie die Rechnung [in den Entwurf zurück](/facturen/corrigeren#terugzetten-naar-concept).

## Eine andere Zahlungsfrist wählen [#een-andere-betaaltermijn-kiezen]

Weicht das Fälligkeitsdatum von Ihrem Standard ab, müssen Sie das nicht vorab einstellen.

<Steps>
<Step>
### Das Auswahlmenü öffnen [#open-het-keuzemenu]
Klicken Sie auf den Pfeil neben **Rechnung buchen** und wählen Sie **Abweichende Zahlungsbedingungen…**.
</Step>
<Step>
### Die Frist wählen [#kies-de-termijn]
Wählen Sie bei **Zahlungsbedingungen** eine Option, von **Am Rechnungsdatum fällig** bis **Netto 60 Tage**. Sie sehen direkt das **Voraussichtliche Fälligkeitsdatum**.
</Step>
<Step>
### Buchen [#boek]
Klicken Sie auf **Rechnung buchen**.
</Step>
</Steps>

## An Ihre Buchhaltung weiterleiten [#doorsturen-naar-je-boekhouding]

Die Weiterleitung an Ihre Buchhaltungssoftware geschieht normalerweise von selbst. Möchten Sie sie erneut starten, zum Beispiel nach einem Fehler, ist das pro Rechnung möglich.

<Requires permission="An Buchhaltung senden" />

Öffnen Sie die gebuchte Rechnung, klicken Sie oben rechts auf die drei Punkte und wählen Sie **An Buchhaltungssoftware senden**. Welche Systeme verfügbar sind, lesen Sie unter [Buchhaltung](/boekhouden). [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) ist auf Anfrage verfügbar.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Rechnung buchen ist grau">
Fahren Sie mit der Maus über die Schaltfläche. Tillor nennt den Grund. Die häufigsten stehen unten.
</Accordion>
<Accordion title="Diese Konzeptrechnung enthält eine Zeile Buchung verhindern">
Das Produkt auf dieser Position erlaubt das Buchen nicht. Löschen Sie die Position oder wählen Sie ein anderes Produkt.
</Accordion>
<Accordion title="Ergänzen Sie auf jeder Zeile mit Periode oder verlängerter Belegungsperiode Start- und Enddatum">
Einer Position mit **Periode** oder **Belegung verlängern** fehlt ein Datum. Füllen Sie Start- und Enddatum aus.
</Accordion>
<Accordion title="Fügen Sie mindestens eine Zeile oder einen von null abweichenden Gesamtbetrag hinzu">
Fügen Sie eine Position hinzu oder sorgen Sie dafür, dass der Gesamtbetrag nicht null ist.
</Accordion>
<Accordion title="Füllen Sie die erforderlichen Kontaktdaten aus oder wählen Sie einen Typ der Zugangsmethode">
Füllen Sie bei Positionen mit **Kontaktdaten abfragen** die Pflichtfelder aus. Wählen Sie bei Positionen mit **Zugangsmethode erstellen** einen Typ und bei Kennzeichenerkennung auch das Kennzeichen.
</Accordion>
<Accordion title="Diese Rechnung verlängert ein Terrain, das der Kunde nicht belegt (nur Angebot)">
Eine solche Rechnung ist ein Angebot und lässt sich nicht buchen. Lassen Sie den Kunden zuerst den Stellplatz in Belegung nehmen. Haben Sie die Berechtigung **Rechnungskorrekturen**, können Sie über den Pfeil neben **Rechnung buchen** **Erzwungen buchen** wählen. Die Belegung wird dann erst verlängert, sobald der Kunde den Stellplatz belegt.
</Accordion>
<Accordion title="Der Rechnungsbetrag überschreitet den Höchstbetrag des verknüpften Mandats">
Der Rechnungsbetrag darf den Höchstbetrag des verknüpften Mandats nicht überschreiten. Passen Sie das Mandat bei **Lastschriftmandat** in den **Rechnungsinformationen** neben der Rechnung an oder senken Sie den Betrag. Siehe [SEPA-Mandat](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Diese Rechnung bringt den Kundensaldo unter null">
Ein Produkt mit überwachtem Konto (zum Beispiel eine Kaution) darf den Saldo des Kunden nicht unter null bringen. Haben Sie die Berechtigung **Kontosaldo übersteuern**, können Sie mit einer Begründung trotzdem buchen. Siehe [Den Saldo des Kunden überwachen](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
</Accordion>
<Accordion title="Die Rechnung kann nicht gebucht werden, da der Kunde keine Peppol-ID hat">
Für einen belgischen Kunden mit einer MwSt.-Nummer muss eine Peppol-ID bekannt sein. Öffnen Sie <UIPath>Kunden > Kunde > Rechnungen</UIPath>, gehen Sie zu **Rechnungseinstellungen** und tragen Sie die ID ein. Siehe [Peppol](/boekhouden/peppol).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Rechnung versenden" href="/facturen/versturen" />
  <Card title="Zahlungen erfassen" href="/facturen/betalingen-registreren" />
  <Card title="Eine Rechnung korrigieren" href="/facturen/corrigeren" description="Wenn Sie nach dem Buchen doch etwas ändern möchten" />
</Cards>


# Eine Rechnung korrigieren (/de-DE/facturen/corrigeren)

Eine gebuchte Rechnung können Sie nicht einfach anpassen. Welchen Weg Sie wählen, hängt davon ab, wie weit die Rechnung schon ist.

Alle Korrekturen außer dem Zurücksetzen stehen im Aktionsmenü (drei Punkte) neben **Benachrichtigung senden**.

<DocScreenshot src="/screenshots/facturen/invoice-correct-menu.png" alt="Aktionsmenü einer gebuchten Rechnung mit Rechnung kopieren und Rechnung stornieren" />

| Situation | Was Sie tun |
|----------|-------------|
| Die Rechnung ist gerade gebucht und noch nicht versendet | [In den Entwurf zurücksetzen](#terugzetten-naar-concept) |
| Die Rechnung ist schon versendet oder zu alt | [Stornieren](#een-factuur-omkeren) mit einer Gutschrift |
| Sie möchten dieselben Positionen erneut verwenden | [Kopieren](#een-factuur-kopiëren) |
| Die Rechnung steht auf dem falschen Kunden | [Verschieben](#een-factuur-verplaatsen-naar-een-andere-klant) |
| Die Beträge stimmen nicht | [Neu berechnen](#een-factuur-herberekenen) |

## In den Entwurf zurücksetzen [#terugzetten-naar-concept]

Solange die Rechnung noch nicht das Haus verlassen hat, setzen Sie sie in den Entwurf zurück und buchen sie nach Ihrer Anpassung erneut.

Das ist möglich, wenn alles Folgende erfüllt ist:

- Die Rechnung ist gebucht.
- Tillor hat dafür noch keine Benachrichtigung versendet, über welchen Kanal auch immer.
- Die Rechnung wurde nicht über Peppol versendet.
- Das Rechnungsdatum liegt weniger als 7 Tage zurück.

<Steps>
<Step>
### Die gebuchte Rechnung öffnen [#open-de-geboekte-factuur]
Gehen Sie zu <UIPath>Verwaltung > Rechnungen</UIPath> und öffnen Sie die Rechnung.
</Step>
<Step>
### Sie zurücksetzen [#zet-hem-terug]
Klicken Sie auf **In Entwurf zurücksetzen** und bestätigen Sie mit **Ja, in Entwurf zurücksetzen**. Fehlt die Schaltfläche, erfüllt die Rechnung die Bedingungen nicht.
</Step>
<Step>
### Die Rechnung anpassen und erneut buchen [#pas-de-factuur-aan-en-boek-opnieuw]
Ändern Sie die Positionen und klicken Sie auf **Rechnung buchen**.
</Step>
</Steps>

In der Zwischenzeit hat die Rechnung eine Entwurfsnummer, die die ursprüngliche Nummer in Klammern enthält. Die Position **Rundung** wird entfernt und kommt beim erneuten Buchen wieder. Beim erneuten Buchen erhält die Rechnung ihre ursprüngliche Nummer zurück, mit dem ursprünglichen Rechnungsdatum und Fälligkeitsdatum. Einen Entwurf, der aus einer gebuchten Rechnung stammt, können Sie nicht löschen.

Nach einem Zurücksetzen steht bei diesem Ereignis in der Zeitleiste **Ereignisse** eine Schaltfläche **Version wiederherstellen**. Damit ersetzen Sie die aktuellen Positionen durch die Positionen, wie sie zum Zeitpunkt des Zurücksetzens waren. Ist die Rechnung dann wieder gebucht, setzt Tillor sie zuerst erneut in den Entwurf zurück.

<Callout type="warn" title="Achtung">
Wurde die Rechnung bereits gedruckt, dem Kunden gezeigt oder auf andere Weise geteilt, seien Sie vorsichtig. Der Kunde hat dann eine Version, die bald nicht mehr stimmt.
</Callout>

### Wenn das Zurücksetzen nicht mehr möglich ist [#als-terugzetten-niet-meer-kan]

<Requires permission="Rechnungskorrekturen" />

Erfüllt die Rechnung die Bedingungen nicht mehr, zum Beispiel weil bereits eine Benachrichtigung versendet wurde oder die Rechnung älter als 7 Tage ist, können Sie mit der Berechtigung **Rechnungskorrekturen** trotzdem zurücksetzen. Öffnen Sie die drei Punkte oben rechts auf der Rechnungsseite und wählen Sie **Erzwungen in den Entwurf zurücksetzen**. Verwenden Sie das nur, wenn es rechtlich und buchhalterisch zulässig ist. Eine Gutschrift über [Stornieren](#een-factuur-omkeren) ist meist die sauberere Lösung.

## Eine Rechnung stornieren [#een-factuur-omkeren]

Mit dem Stornieren erstellen Sie eine Gutschrift, die eine gebuchte Rechnung aufhebt. Das funktioniert immer, auch wenn die Rechnung schon versendet oder bezahlt ist.

<Steps>
<Step>
### Die Rechnung stornieren [#keer-de-factuur-om]
Öffnen Sie die drei Punkte oben rechts auf der gebuchten Rechnung und wählen Sie **Rechnung stornieren**. Tillor erstellt einen neuen Entwurf mit denselben Positionen in negativen Beträgen und öffnet ihn.
</Step>
<Step>
### Prüfen und buchen [#controleer-en-boek]
Passen Sie den Entwurf bei Bedarf an und klicken Sie auf **Rechnung buchen**. Er wird dann zu einer **Gutschrift**.
</Step>
</Steps>

Die beiden Rechnungen verweisen aufeinander. In den **Rechnungsinformationen** steht bei der Gutschrift **Stornierung von** und bei der ursprünglichen Rechnung **Storniert als**. In der Rechnungsliste im Kundenprofil sehen Sie beim Entwurf das Label **Stornierungsentwurf** und bei der ursprünglichen Rechnung **Diese Rechnung wurde storniert**.

Haben Sie eine Rechnung schon früher storniert, bittet Tillor um Bestätigung mit **Ja, erneut stornieren**, damit Sie nicht versehentlich zwei Gutschriften erstellen.

Möchten Sie die Gutschrift mit der ursprünglichen Rechnung verrechnen, wählen Sie beim Bezahlen **Interne Überweisung**. Siehe [Interne Überweisung](/betalingsverwerking/interne-overboeking).

## Eine Rechnung kopieren [#een-factuur-kopiëren]

Wählen Sie **Rechnung kopieren** im Aktionsmenü einer gebuchten Rechnung. Tillor erstellt einen neuen Entwurf mit denselben Positionen, derselben Notiz und demselben Einzugsmandat und öffnet ihn. Die Position **Rundung** wird nicht mitkopiert.

## Eine Rechnung zu einem anderen Kunden verschieben [#een-factuur-verplaatsen-naar-een-andere-klant]

<Requires permission="Rechnungskorrekturen" />

Steht eine Rechnung auf dem falschen Kunden, verschieben Sie sie.

<Steps>
<Step>
### Das Aktionsmenü öffnen [#open-het-actiemenu]
Klicken Sie auf die drei Punkte oben rechts auf der Rechnungsseite und wählen Sie **Zu Kunde verschieben**.
</Step>
<Step>
### Den Kunden wählen [#kies-de-klant]
Wählen Sie den **Zielkunden** und klicken Sie auf **Rechnung verschieben**.
</Step>
</Steps>

Die Rechnung zieht mit den verknüpften Zahlungen, Zählerchargen und Kommentaren um. Eine gebuchte Rechnung wird danach erneut an Ihre Buchhaltung gesendet. Wurde die Rechnung bereits über Peppol versendet, können Sie sie nicht verschieben.

## Eine Rechnung neu berechnen [#een-factuur-herberekenen]

Stimmen die Beträge auf einer gebuchten Rechnung nicht mit den Positionen überein, wählen Sie **Rechnung neu berechnen** im Aktionsmenü. Tillor berechnet die Summen neu.

## Einen Entwurf löschen [#een-concept-verwijderen]

Einen Rechnungsentwurf können Sie mit **Rechnung löschen** im Aktionsmenü löschen. Sie kommen dann zurück zum Profil des Kunden. Gebuchte Rechnungen können Sie nicht löschen, die stornieren Sie.

## Was passiert danach? [#wat-gebeurt-er-daarna]

| Weg | Folge |
|-------|--------|
| In den Entwurf zurücksetzen | Die Rechnungsnummer bleibt erhalten. Beim erneuten Buchen erhält die Rechnung ihre ursprüngliche Nummer und Daten zurück. |
| Stornieren | Es entsteht eine Gutschrift, die auf die ursprüngliche Rechnung verweist. Verrechnen ist mit einer [internen Überweisung](/betalingsverwerking/interne-overboeking) möglich. |
| Kopieren | Es entsteht ein neuer Entwurf. Die ursprüngliche Rechnung ändert sich nicht. |
| Verschieben | Zahlungen, Zählerchargen und Kommentare ziehen mit um. Eine gebuchte Rechnung geht erneut an Ihre Buchhaltung. |
| Neu berechnen | Die Summen werden aus den Positionen neu berechnet. |

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe In Entwurf zurücksetzen nicht">
Eine der Bedingungen ist nicht erfüllt. Wurde bereits eine Benachrichtigung versendet oder ist die Rechnung 7 Tage oder älter? Dann können Sie stornieren oder mit der Berechtigung **Rechnungskorrekturen** erzwungen zurücksetzen.
</Accordion>
<Accordion title="Zu Kunde verschieben fehlt">
Dafür benötigen Sie die Berechtigung **Rechnungskorrekturen**. Wurde die Rechnung über Peppol versendet, ist das Verschieben nicht möglich.
</Accordion>
<Accordion title="Welche Berechtigungen hat mein Benutzer?">
Ein Administrator stellt sie ein. Siehe [Benutzer](/gebruikers).
</Accordion>
</Accordions>

## Weiter [#verder]

<Cards>
  <Card title="Eine Rechnung buchen" href="/facturen/boeken" />
  <Card title="Status" href="/facturen/statussen" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Rechnungen über Peppol versenden" />
</Cards>


# Übersicht (/de-DE/facturen)

Unter <UIPath>Verwaltung > Rechnungen</UIPath> finden Sie alle Rechnungen Ihres Parks, mit den offenen Beträgen ganz oben. Eine Rechnung beginnt als Entwurf und wird erst endgültig, wenn Sie sie buchen. Danach können Sie sie versenden, bezahlen lassen und gegebenenfalls korrigieren.

<Callout type="info" title="Gut zu wissen">
- Eine neue Rechnung erstellen Sie im Kundenprofil, nicht über diese Liste.
- Eine gebuchte Rechnung erhält ein Fälligkeitsdatum: der Tag des Buchens plus die Standardfälligkeit Ihrer Organisation, standardmäßig 7 Tage. Sie können pro Rechnung eine andere Frist wählen.
- Ist der Gesamtbetrag kein Vielfaches von 5 Cent, fügt Tillor beim Buchen eine Position **Rundung** hinzu.
- Tillor sendet eine gebuchte Rechnung nicht von selbst an den Kunden. Das tun Sie selbst mit **Benachrichtigung senden**.
- Das Zurücksetzen in den Entwurf ist bis zu 7 Tage nach dem Rechnungsdatum möglich, solange keine Benachrichtigung versendet wurde und die Rechnung nicht über Peppol versendet wurde. Danach stornieren Sie die Rechnung mit einer Gutschrift.
- Eine Barzahlung darf standardmäßig höchstens 2999 Euro betragen. Sie passen das mit **Höchstbetrag Bargeld** unter <UIPath>Support > Einstellungen > Zahlungen</UIPath> an.
- Ein Einzug mit einem SEPA-Mandat geht zwei Tage nach dem Buchen an die Bank. Bis dahin können Sie die Zahlung stornieren.
- Der persönliche Link einer Rechnung hat kein Ablaufdatum. Der Kunde sieht dort, was noch offen ist.
- Hat der Kunde eine Peppol-ID, versendet Tillor die Rechnung nach dem Buchen automatisch über Peppol.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Rechnung ist der Anfang einer Kette. Eine Zahlung hängt an einer gebuchten Rechnung, die Zahlungen eines Tages kommen in einen Zahlungsbericht und dieser Bericht geht an Ihre Buchhaltung.

```mermaid
flowchart LR
  A[Rechnungsentwurf] -- Buchen --> B[Gebuchte Rechnung]
  B -- Benachrichtigung senden --> K[Kunde erhält die Rechnung]
  K -- Kunde zahlt online --> C[Zahlung]
  B -- Sie erfassen eine Zahlung --> C
  C -- Saldo und Zahlungsstatus --> B
  C -- Pro Tag gebündelt --> D[Zahlungsbericht]
  D -- Mollie und interne Überweisungen --> E[Buchhaltung]
```

- Der offene Saldo und der Zahlungsstatus der Rechnung ergeben sich von selbst aus den Zahlungen.
- Eine Zahlung ohne Rechnung können Sie später mit einer gebuchten Rechnung verknüpfen.
- Welche Zahlungen an die Buchhaltung gehen, lesen Sie unter [Buchhaltung](/boekhouden).

## Die Rechnungsliste [#de-facturenlijst]

Ganz oben stehen vier Zähler: **Rechnungen gesamt**, **Offene Rechnungen** (unbezahlt oder teilweise bezahlt), **Überfällige Rechnungen** (Fälligkeitsdatum verstrichen) und **Gesamt offen** (der Gesamtbetrag der offenen Rechnungen).

Darunter stehen vier Listen:

- **Ausstehende Zahlungen**: gebuchte Rechnungen, deren Zahlung gestartet, aber noch nicht endgültig eingegangen ist
- **Rechnungen mit offenem Saldo**: gebuchte Rechnungen mit einem Betrag, der noch bezahlt werden muss, nach Fälligkeitsdatum sortiert
- **Entwürfe**: die zehn zuletzt erstellten Rechnungsentwürfe
- **Alle Rechnungen**: die vollständige Liste, standardmäßig auf gebuchte Rechnungen gefiltert

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Rechnungsübersicht - Alle Rechnungen" />

Neue Rechnungen erstellen Sie nicht über diese Liste. Das tun Sie im Kundenprofil, siehe [Eine Rechnung erstellen](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken).

### Suchen und filtern [#zoeken-en-filteren]

Die Suchleiste sucht nach Rechnungsnummer, Vor- oder Nachname des Kunden, E-Mail-Adresse und Betrag. In der Liste **Alle Rechnungen** können Sie außerdem filtern nach:

| Filter | Was Sie damit tun |
|--------|-------------------|
| **Zeitraum** | Nur Rechnungen innerhalb eines bestimmten Zeitraums |
| **Status** | **Entwurf** oder **Gebucht** |
| **Zahlungsstatus** | **Unbezahlt**, **Teilweise**, **Ausstehend** oder **Bezahlt** |
| **Kundentyp** | **Standard**, **Worker Mietwohnwagen** oder **Worker Zugwohnwagen** |
| **Kunde** | Alle Rechnungen eines Kunden |
| **Produkte** | Rechnungen mit einem bestimmten Produkt auf einer Position |
| **Betrag** | Rechnungen mit einem Mindest- oder Höchstbetrag |

In der Liste **Rechnungen mit offenem Saldo** gibt es außerdem den Filter **Erinnerung fällig**. Sie wählen eine Anzahl Tage (7 bis 90) und sehen dann die überfälligen Rechnungen, die mindestens so lange her erstellt wurden und für die in den letzten Tagen keine Mahnung per E-Mail oder SMS versendet wurde. Praktisch, um zu entscheiden, wen Sie erneut mahnen müssen.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Rechnungen mit offenem Saldo" />

### Rechnungen pro Kunde [#facturen-per-klant]

In einem Kundenprofil finden Sie alle Rechnungen dieses Kunden im Block **Rechnungen** auf der Registerkarte **Übersicht** oder auf der Registerkarte **Rechnungen**. Dort erstellen Sie auch eine neue Rechnung.

## Anleitungen [#handleidingen]

<Cards>
  <Card title="Erstellen und bearbeiten" href="/facturen/aanmaken-en-bewerken" description="Einen Rechnungsentwurf erstellen und Positionen hinzufügen" />
  <Card title="Eine Rechnung buchen" href="/facturen/boeken" description="Die Rechnung endgültig machen" />
  <Card title="Eine Rechnung versenden" href="/facturen/versturen" description="Benachrichtigung oder Mahnung an den Kunden" />
  <Card title="Zahlungen erfassen" href="/facturen/betalingen-registreren" description="Eine Zahlung erfassen oder verknüpfen" />
  <Card title="Drucken und herunterladen" href="/facturen/afdrukken-en-downloaden" description="PDF, Drucker und persönlicher Link" />
  <Card title="Korrigieren" href="/facturen/corrigeren" description="Zurücksetzen, stornieren, kopieren und verschieben" />
  <Card title="Status" href="/facturen/statussen" description="Was Entwurf, Gebucht und Bezahlt bedeuten" />
</Cards>

## Verwandt [#gerelateerd]

<Cards>
  <Card title="Zahlungsabwicklung" href="/betalingsverwerking" description="Zahlungsmethoden im Detail" />
  <Card title="Produkte" href="/producten" description="Aktionen auf Rechnungspositionen" />
  <Card title="Buchhaltung" href="/boekhouden" description="Zahlungsberichte und Buchhaltungsanbindungen" />
  <Card title="Praxisbeispiele" href="/praktijk" description="Ausgearbeitete Beispiele aus der Praxis" />
</Cards>

## Begriffe [#begrippen]

- **Entwurf**: eine Rechnung, die Sie noch anpassen können, mit einer vorläufigen Entwurfsnummer.
- **Gebucht**: eine endgültige Rechnung mit eigener Rechnungsnummer. Siehe [Buchen](/begrippen#boeken).
- **Gutschrift**: eine gebuchte Rechnung mit negativem Gesamtbetrag, zum Beispiel nach dem Stornieren einer Rechnung.
- **Zahlungsstatus**: ob und wie viel von der Rechnung bezahlt ist. Siehe [Status](/facturen/statussen).
- **Kunde**: der Kunde, für den die Rechnung ist. Siehe [Kunde](/begrippen#klant).
- **Belegung**: ein Kunde auf einem Gelände für einen Zeitraum. Siehe [Belegung](/begrippen#bezetting).


# Rechnungsstatus (/de-DE/facturen/statussen)

Jede Rechnung hat einen **Status** (ob sie schon endgültig ist) und, sobald sie gebucht ist, einen **Zahlungsstatus** (wie viel bezahlt ist). Beide können Sie in der [Rechnungsliste](/facturen) filtern.

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Rechnungsliste mit Status und Zahlungsstatus pro Rechnung" />

## Rechnungsstatus [#factuurstatus]

| Status | Bedeutung |
|--------|-----------|
| <Status>Entwurf</Status> | Die Rechnung ist noch bearbeitbar und hat eine vorläufige Entwurfsnummer. Sie können sie noch nicht versenden oder bezahlen lassen. |
| <Status tone="success">Gebucht</Status> | Die Rechnung ist endgültig und hat eine eigene Rechnungsnummer. Sie können sie versenden, bezahlen lassen und korrigieren. |

Ein Entwurf, der aus einer gebuchten Rechnung zurückgesetzt wurde, hat eine Entwurfsnummer mit der ursprünglichen Rechnungsnummer in Klammern. Siehe [Eine Rechnung korrigieren](/facturen/corrigeren).

## Zahlungsstatus [#betalingsstatus]

Der Zahlungsstatus steht neben der Rechnungsnummer einer gebuchten Rechnung.

| Status | Bedeutung |
|--------|-----------|
| <Status tone="error">Unbezahlt</Status> | Es ist noch nichts bezahlt. |
| <Status tone="warning">Teilweise</Status> | Ein Teil ist bezahlt und es ist noch ein Betrag offen. |
| <Status tone="info">Ausstehend</Status> | Der volle Betrag ist angestoßen, zum Beispiel ein Einzug, aber das Geld ist noch nicht endgültig verarbeitet. |
| <Status tone="success">Bezahlt</Status> | Die Rechnung ist vollständig beglichen. |

Eine Rechnung ist **überfällig**, wenn das Fälligkeitsdatum verstrichen ist und noch ein Betrag offen ist. Das ist kein eigener Status. Sie sehen es im Zähler **Überfällige Rechnungen** in der Rechnungsliste.

## Rechnungstyp [#factuurtype]

| Typ | Bedeutung |
|------|-----------|
| **Rechnung** | Eine normale Rechnung mit positivem Gesamtbetrag. |
| **Gutschrift** | Eine gebuchte Rechnung mit negativem Gesamtbetrag, zum Beispiel nach [dem Stornieren einer Rechnung](/facturen/corrigeren#een-factuur-omkeren). |

## Labels in der Liste im Kundenprofil [#labels-in-de-lijst-op-het-klantprofiel]

| Label | Bedeutung |
|-------|-----------|
| **Über Peppol gesendet** | Die Rechnung wurde über Peppol versendet. |
| **Stornierungsentwurf** | Dieser Entwurf wurde erstellt, um eine andere Rechnung zu stornieren. |
| **Diese Rechnung wurde storniert** | Es existiert eine Gutschrift oder ein Entwurf, der diese Rechnung aufhebt. |

## Weiter [#verder]

<Cards>
  <Card title="Übersicht" href="/facturen" description="Die Rechnungsliste und Filter" />
  <Card title="Zahlungen erfassen" href="/facturen/betalingen-registreren" />
</Cards>


# Eine Rechnung versenden (/de-DE/facturen/versturen)

Mit **Benachrichtigung senden** senden Sie dem Kunden eine gebuchte Rechnung per E-Mail, SMS, WhatsApp oder Post. Tillor tut das nie von selbst. Ist die Rechnung bereits versendet, aber noch nicht bezahlt, senden Sie eine Mahnung. Bezahlen kann der Kunde danach über den Link in der Nachricht, siehe [Einen Kunden online bezahlen lassen](/betalingsverwerking/online).

Bevor Sie beginnen:

- Die Rechnung ist gebucht. Bei einem Entwurf fehlen die Schaltflächen.
- Der Kunde hat mindestens eine E-Mail-Adresse, eine Telefonnummer oder eine vollständige Postadresse (Straße, Postleitzahl und Ort). Sonst fehlen die Schaltflächen.
- Für eine Mahnung ist noch ein Betrag offen.

## Eine Rechnung versenden [#een-factuur-versturen]

<Steps>
<Step>
### Die gebuchte Rechnung öffnen [#open-de-geboekte-factuur]
Gehen Sie zu <UIPath>Verwaltung > Rechnungen</UIPath> und öffnen Sie eine Rechnung mit dem Status <Status tone="success">Gebucht</Status>.
</Step>
<Step>
### Auf Benachrichtigung senden klicken [#klik-op-verstuur-notificatie]
Es öffnet sich ein Fenster **Benachrichtigung senden**.
</Step>
<Step>
### Die Kanäle wählen [#kies-de-kanalen]
Sie können wählen aus:

- **E-Mail**: Der Kunde erhält eine E-Mail mit der Rechnung als Anhang. Ist standardmäßig aktiviert, wenn eine E-Mail-Adresse vorhanden ist.
- **SMS**: Der Kunde erhält eine SMS. Nur mit einer Telefonnummer verfügbar.
- **WhatsApp**: Nur sichtbar, wenn WhatsApp Business installiert ist. Verlangt eine Telefonnummer sowie eine Zahlungsmethode bei Meta oder ein laufendes Gespräch mit dem Kunden.
- **Post**: Die Rechnung geht als PDF per Post. Nur mit einer vollständigen Postadresse verfügbar. Ist standardmäßig ausgeschaltet und zeigt einen indikativen Portobetrag pro Brief.

Ein Kanal, der für diesen Kunden nicht möglich ist, ist ausgeschaltet, mit dem Grund dabei, zum Beispiel **Keine E-Mail-Adresse hinterlegt**. Wählen Sie mindestens einen Kanal.
</Step>
<Step>
### Senden [#verstuur]
Klicken Sie auf **Senden**.
</Step>
</Steps>

## Eine Mahnung senden [#een-aanmaning-versturen]

Eine Mahnung ist möglich, sobald die Rechnung gebucht ist und noch ein Betrag offen ist.

<Steps>
<Step>
### Das Auswahlmenü öffnen [#open-het-keuzemenu]
Klicken Sie auf den Pfeil neben **Benachrichtigung senden** und wählen Sie **Erinnerung senden**.
</Step>
<Step>
### Die Kanäle wählen [#kies-de-kanalen-1]
Hier sind **E-Mail** und **SMS** standardmäßig aktiviert, wenn der Kunde eine E-Mail-Adresse und eine Telefonnummer hat. Bei **Post** erhält der Kunde einen Mahnbrief mit der Rechnung als Anhang, mit einem QR-Code zum Ansehen oder Bezahlen online.

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Bestätigungsdialog Mahnung senden" />
</Step>
<Step>
### Gegebenenfalls Einschreiben wählen [#kies-eventueel-aangetekend]
Haben Sie **Post** angehakt, können Sie **Einschreiben mit Rückschein** wählen. Das ist nur bei einer Mahnung möglich, nicht bei der ersten Rechnungsmeldung, und nur wenn Einschreiben für diese Adresse verfügbar ist. Tillor zeigt dann den indikativen Mehrbetrag zusätzlich zu den normalen Portokosten. Die Schaltfläche heißt dann **Mit Zusatzkosten senden**.
</Step>
<Step>
### Senden [#verstuur-1]
Klicken Sie auf **Senden**.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

Auf der Rechnungsseite steht im Block **Benachrichtigungen**, welche Nachrichten versendet wurden. Alle Nachrichten Ihrer Organisation stehen unter <UIPath>Kommunikation > Benachrichtigungen</UIPath>.

Postsendungen starten auf **Ausstehend**. Danach folgt der Status des Briefs: **PDF empfangen**, **Validiert**, **In Bearbeitung**, **Im Druckzentrum** und **An Post übergeben**. Sobald der Transporteur es bestätigt, wird der Status **Gesendet**. Unzustellbare Post wird **Fehlgeschlagen**. Ein Brief, der beim Transporteur storniert wurde, erhält den Status **Übersprungen**. Öffnen Sie die Nachricht für den Portobetrag, die Referenz des Transporteurs und den letzten Tracking-Status. Mehr dazu steht unter [Benachrichtigungen](/notificaties).

- Tillor sendet die Nachricht sofort. Der Kunde erhält einen Link, um die Rechnung anzusehen und online zu bezahlen.
- Eine Mahnung bleibt eine einzelne Aktion pro Rechnung. Der Filter **Erinnerung fällig** in der [Rechnungsliste](/facturen) hilft Ihnen zu wählen, wen Sie erneut mahnen.
- Automatisierungen können Mahnungen auch automatisch versenden. Siehe [Automatisierungen](/automatiseringen).

<Callout type="info">
Eine Rechnung, für die bereits eine Benachrichtigung versendet wurde, können Sie nicht mehr einfach in den Entwurf zurücksetzen. Siehe [Eine Rechnung korrigieren](/facturen/corrigeren#terugzetten-naar-concept).
</Callout>

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe Benachrichtigung senden nicht">
Die Rechnung muss gebucht sein und der Kunde muss eine E-Mail-Adresse, eine Telefonnummer oder eine vollständige Postadresse haben. Ergänzen Sie die Daten im Kundenprofil.
</Accordion>
<Accordion title="Ich sehe Erinnerung senden nicht">
Eine Mahnung ist nur bei einer gebuchten Rechnung mit offenem Betrag möglich.
</Accordion>
<Accordion title="Die Nachricht ist fehlgeschlagen">
Öffnen Sie die Nachricht unter <UIPath>Kommunikation > Benachrichtigungen</UIPath> für die Fehlermeldung. Prüfen Sie danach die E-Mail-Adresse, Telefonnummer oder Postadresse des Kunden und senden Sie erneut. Siehe [Benachrichtigungen](/notificaties).
</Accordion>
</Accordions>

## Weiter [#verder]

<Cards>
  <Card title="Benachrichtigungen" href="/notificaties" description="Status und Verlauf versendeter Nachrichten" />
  <Card title="Zahlungen erfassen" href="/facturen/betalingen-registreren" />
</Cards>


# Benutzer einladen und Berechtigungen vergeben (/de-DE/gebruikers/gebruikers-en-rechten)

Eine Kollegin oder ein Kollege mit einem Tillor-Konto heißt in Tillor Benutzer. Sie bestimmen, wer Zugang zu Ihrer Organisation hat und was die Person sehen und tun darf, und zwar mit Berechtigungen. Für Kolleginnen und Kollegen, die Sie oft gemeinsam ansprechen, legen Sie anschließend eine [Gruppe](/gebruikers/groepen) an.

Bevor Sie beginnen:

- Sie brauchen die Berechtigung **Benutzerberechtigungen verwalten**. Ohne diese Berechtigung sind die Schaltflächen **Benutzer einladen** und **Berechtigungen bearbeiten** ausgegraut.
- Sie können nur Berechtigungen vergeben, die Sie selbst haben. Eine Berechtigung, die Ihnen fehlt, können Sie für andere nicht aktivieren.
- Die Berechtigung **Benutzerberechtigungen verwalten** selbst kann nur ein Benutzer mit **Alle Berechtigungen** an andere weitergeben.

## Eine Kollegin oder einen Kollegen einladen [#een-collega-uitnodigen]

<Steps>
<Step>
### Die Benutzer öffnen [#open-de-gebruikers]
Gehen Sie zu <UIPath>Support > Einstellungen > Benutzer</UIPath>. Sie sehen die **Mitglieder** Ihrer Organisation und die **Ausstehende Einladungen**.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Einstellungen > Benutzer mit der Mitgliederliste" />
</Step>
<Step>
### Auf Benutzer einladen klicken [#klik-op-gebruiker-uitnodigen]
Das Fenster **Benutzer einladen** öffnet sich.

<DocScreenshot src="/screenshots/gebruikers/settings-members-invite-dialog.png" alt="Das Fenster Benutzer einladen" />
</Step>
<Step>
### Die E-Mail-Adresse eingeben [#vul-het-e-mailadres-in]
Geben Sie die **E-Mail-Adresse** der Kollegin oder des Kollegen ein und klicken Sie auf **Einladen**.
</Step>
</Steps>

Was danach passiert, hängt von der E-Mail-Adresse ab:

<Tabs items={["Es gibt bereits ein Tillor-Konto", "Noch kein Tillor-Konto"]}>
<Tab value="Es gibt bereits ein Tillor-Konto">
Der Benutzer wird sofort Mitglied Ihrer Organisation. Tillor meldet **Benutzer zur Organisation hinzugefügt**. Die Person sieht Ihre Organisation sofort bei ihren Organisationen.
</Tab>
<Tab value="Noch kein Tillor-Konto">
Tillor meldet **Einladung gesendet** und verschickt eine Einladung per E-Mail. Bis sich die Person zum ersten Mal anmeldet, steht sie unter **Ausstehende Einladungen** mit dem Badge **Ausstehend**. Bei der ersten Anmeldung wird sie Mitglied Ihrer Organisation. Mit **Einladung zurückziehen** ziehen Sie die Einladung zurück, und Tillor meldet **Einladung zurückgezogen**.
</Tab>
</Tabs>

Ein neuer Benutzer erhält zu Beginn diese Berechtigungen: **Einstellungen anzeigen**, **Einstellungen bearbeiten**, **Integrationen anzeigen**, **Integrationen verwalten**, **Zähleralarm-Benachrichtigungen**, **Posteingang-Benachrichtigungen**, **Tablet- und Kiosk-Warnungen**, **Unterschriftsanfragen verwalten** und **Eigene Felder verwalten**. Prüfen Sie, ob das passt, und passen Sie es an.

## Berechtigungen bearbeiten [#rechten-bewerken]

<Steps>
<Step>
### Beim Benutzer auf Berechtigungen bearbeiten klicken [#klik-bij-de-gebruiker-op-rechten-bewerken]
Das Fenster **Benutzerberechtigungen bearbeiten** öffnet sich. Oben stehen die Gruppen, in denen der Benutzer Mitglied ist. Mit **Berechtigungen suchen** finden Sie eine Berechtigung schnell.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions-dialog.png" alt="Das Fenster Benutzerberechtigungen bearbeiten mit Berechtigungen pro Bereich" />
</Step>
<Step>
### Berechtigungen ein- oder ausschalten [#zet-rechten-aan-of-uit]
Die Berechtigungen sind nach Bereich gruppiert, zum Beispiel **Rechnungen**, **Zahlungen** oder **Posteingang**. Unten steht, wie viele effektive Berechtigungen der Benutzer hat.
</Step>
<Step>
### Die Berechtigungen speichern [#sla-de-rechten-op]
Klicken Sie auf **Berechtigungen speichern**. Tillor meldet **Benutzerberechtigungen gespeichert**.
</Step>
</Steps>

### Woher kommt eine Berechtigung? [#waar-komt-een-recht-vandaan]

Bei jeder Berechtigung steht die Quelle. So sehen Sie, warum jemand etwas kann oder nicht kann.

| Quelle | Bedeutung |
|---|---|
| **Direkt** | Sie haben diese Berechtigung direkt an diesen Benutzer vergeben. Sie können sie hier ausschalten |
| Ein Gruppenname | Diese [Gruppe](/gebruikers/groepen#groepsrechten) vergibt die Berechtigung. Sie können sie hier nicht ausschalten, sondern nur bei der Gruppe |
| **Gesperrt** mit einem Gruppennamen | Diese Gruppe verweigert die Berechtigung. Auch wenn der Benutzer sie selbst hatte, bleibt sie gesperrt |
| **Nicht gewährt** | Niemand vergibt die Berechtigung |

Die Schaltfläche **Berechtigungen bearbeiten** ist bei Ihrer eigenen Zeile und bei Benutzern mit dem Badge **Alle Berechtigungen** ausgegraut. Diese Benutzer haben alles und lassen sich nicht einschränken.

## Benachrichtigungen einer Kollegin oder eines Kollegen einstellen [#meldingen-van-een-collega-instellen]

Mit dem Glockensymbol (**Benachrichtigungseinstellungen**) bei einem Benutzer öffnen Sie dessen Benachrichtigungen in dieser Organisation. Pro Benachrichtigung wählen Sie E-Mail, Push oder Anruf. Mit **Alle Benachrichtigungen** schalten Sie einen Kanal auf einmal aus. Änderungen wirken sofort und gelten nur in dieser Organisation.

<DocScreenshot src="/screenshots/gebruikers/settings-members-notifications-dialog.png" alt="Das Fenster mit den Benachrichtigungen einer Kollegin oder eines Kollegen" />

Benachrichtigungen, die immer versendet werden, können Sie nicht ausschalten. Was eine Benachrichtigung ist und wo Sie sie wiederfinden, steht unter [Benachrichtigungen](/notificaties#meldingen-in-de-app).

## Einen Benutzer entfernen [#een-gebruiker-verwijderen]

Klicken Sie auf das Papierkorbsymbol (**Aus Organisation entfernen**) und bestätigen Sie mit **Benutzer entfernen**. Tillor meldet **Benutzer aus der Organisation entfernt**. Die Person verliert sofort den Zugang zu dieser Organisation. Ihr Tillor-Konto bleibt bestehen, ebenso eventuelle andere Organisationen.

Sie können sich nicht selbst entfernen. Einen Benutzer mit **Alle Berechtigungen** können Sie nur entfernen, wenn Sie selbst auch **Alle Berechtigungen** haben.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Der Benutzer sieht Ihre Organisation bei seinen Organisationen und kann alles nutzen, wofür er Berechtigungen hat.
- Eine Änderung der Berechtigungen gilt sofort nach dem Speichern.
- Ein entfernter Benutzer verliert sofort den Zugang. Sein Tillor-Konto bleibt bestehen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Schaltfläche Benutzer einladen ist ausgegraut">
Sie haben die Berechtigung **Benutzerberechtigungen verwalten** nicht. Bitten Sie eine Kollegin oder einen Kollegen mit **Alle Berechtigungen**, sie Ihnen zu geben.
</Accordion>
<Accordion title="Tillor meldet Einladung fehlgeschlagen">
Diese E-Mail-Adresse ist bereits Mitglied Ihrer Organisation, oder für diese Adresse liegt bereits eine offene Einladung vor. Schauen Sie in die Listen **Mitglieder** und **Ausstehende Einladungen**. Steht die Einladung schon dort, ziehen Sie sie zurück und laden Sie erneut ein, falls die Person die E-Mail nicht erhalten hat.
</Accordion>
<Accordion title="Die eingeladene Person findet ihre E-Mail nicht">
Bitten Sie sie, ihren Spam-Ordner zu prüfen. Sie wird erst Mitglied, wenn sie sich genau mit der E-Mail-Adresse anmeldet, mit der Sie eingeladen haben. Meldet sie sich mit einer anderen Adresse an, ziehen Sie die Einladung zurück und laden Sie diese Adresse ein.
</Accordion>
<Accordion title="Eine Berechtigung ist ausgegraut und ich kann sie nicht aktivieren">
Sie können nur Berechtigungen vergeben, die Sie selbst haben. Steht bei der Berechtigung ein Gruppenname, vergibt oder blockiert diese Gruppe die Berechtigung, und Sie passen sie bei der Gruppe an.
</Accordion>
<Accordion title="Berechtigungen bearbeiten ist bei einer Kollegin oder einem Kollegen ausgegraut">
Die Person hat **Alle Berechtigungen**, oder es ist Ihre eigene Zeile. Diese lassen sich nicht bearbeiten.
</Accordion>
<Accordion title="Einer Kollegin oder einem Kollegen fehlt eine Schaltfläche, obwohl ich die Berechtigung vergeben habe">
Prüfen Sie im Fenster **Benutzerberechtigungen bearbeiten**, ob eine Gruppe die Berechtigung als **Gesperrt** anzeigt. Eine Verweigerung durch eine Gruppe gewinnt immer gegen eine Berechtigung, die Sie direkt vergeben haben.
</Accordion>
<Accordion title="Ich kann einen Benutzer nicht entfernen">
Sie können sich nicht selbst entfernen. Einen Benutzer mit **Alle Berechtigungen** entfernen Sie nur, wenn Sie selbst auch **Alle Berechtigungen** haben.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Gruppen" href="/gebruikers/groepen" description="Kolleginnen und Kollegen bündeln und Berechtigungen pro Gruppe einstellen" />
  <Card title="Benachrichtigungen" href="/notificaties" description="Wie Benachrichtigungen eintreffen" />
  <Card title="Sichtbarkeit und Zugriff auf eigene Felder" href="/eigen-velden/zichtbaarheid-en-toegang" description="Berechtigungen pro eigenem Feld" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Alle Bereiche der Einstellungen" />
</Cards>


# Gruppen (/de-DE/gebruikers/groepen)

Eine Gruppe ist ein fester Kreis von Kolleginnen und Kollegen, zum Beispiel **Rezeption** oder **Technischer Dienst**. Sie verwenden eine Gruppe an diesen Stellen:

- **Aufgaben zuweisen**: Suchen Sie beim Zuweisen einer Aufgabe nach dem Gruppennamen
- **Erwähnen und benachrichtigen**: Eine Erwähnung oder Benachrichtigung an eine Gruppe geht an alle Mitglieder
- **Ansichten teilen**: Wählen Sie bei einer Aufgabenansicht **Bestimmte Gruppen**, siehe [Ansichten](/taken/weergaven#wie-ziet-een-weergave)
- **Automatisierungen**: Die Schritte, die eine Aufgabe erstellen oder aktualisieren, können Gruppen zuweisen

## Eine Gruppe anlegen [#een-groep-maken]

<Steps>
<Step>
### Gruppen öffnen [#open-groepen]
Gehen Sie zu <UIPath>Support > Einstellungen > Gruppen</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-groups.png" alt="Einstellungen > Gruppen mit zwei Gruppen" />
</Step>
<Step>
### Auf Neue Gruppe klicken [#klik-op-nieuwe-groep]
Geben Sie einen **Namen** ein, zum Beispiel Rezeption.
</Step>
<Step>
### Die Mitglieder wählen [#kies-de-leden]
Wählen Sie bei **Mitglieder** die Personen aus. Sie können nur Benutzer hinzufügen, die bereits Mitglied der Organisation sind.
</Step>
<Step>
### Auf Speichern klicken [#klik-op-opslaan]
Tillor meldet **Gruppe gespeichert**.
</Step>
</Steps>

Klicken Sie auf eine Gruppe, um den Namen oder die Mitglieder zu ändern. Löschen Sie eine Gruppe, bleiben Aufgaben denjenigen zugewiesen, die direkt darauf stehen. Nur die Gruppe selbst verschwindet.

## Gruppenberechtigungen [#groepsrechten]

Eine Gruppe kann auch Berechtigungen geben oder entziehen. Klicken Sie bei der Gruppe auf das Schlüsselsymbol (**Gruppenberechtigungen**). Pro Berechtigung wählen Sie:

| Auswahl | Was sie bewirkt |
|---|---|
| **Erlauben** | Alle in der Gruppe erhalten die Berechtigung („Für alle gewährt“) |
| **Erben** | Die Gruppe tut nichts mit dieser Berechtigung. Jedes Mitglied behält seinen eigenen Zugriff („Erbt eigenen Zugriff“). Das ist der Ausgangszustand |
| **Verweigern** | Die Berechtigung ist für alle in der Gruppe gesperrt („Für alle gesperrt“) |

<DocScreenshot src="/screenshots/gebruikers/settings-group-permissions-dialog.png" alt="Das Fenster Gruppenberechtigungen mit Verweigern, Erben und Erlauben" />

Mit **Berechtigungen suchen** finden Sie eine Berechtigung schnell. Unten steht, wie viele Berechtigungen Sie eingestellt haben. Klicken Sie auf **Speichern**, danach meldet Tillor **Gruppenberechtigungen gespeichert**.

<Requires permission="Benutzerberechtigungen verwalten" />

Ohne diese Berechtigung ist die Schaltfläche **Gruppenberechtigungen** ausgegraut. Sie können dann auch keine Gruppe löschen, die noch Gruppenberechtigungen hat.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Gruppenberechtigungen kommen zu den eigenen Berechtigungen jedes Mitglieds hinzu. Eine Verweigerung gewinnt immer: Steht eine Berechtigung bei der einen Gruppe auf **Verweigern** und bei einer anderen auf **Erlauben**, bleibt sie gesperrt.
- Im Fenster **Benutzerberechtigungen bearbeiten** eines Mitglieds sehen Sie pro Berechtigung, welche Gruppe sie gibt oder sperrt. Siehe [Berechtigungen bearbeiten](/gebruikers/gebruikers-en-rechten#rechten-bewerken).
- Fügen Sie ein Mitglied hinzu, gelten die Gruppenberechtigungen auch für dieses Mitglied. Entfernen Sie es, gelten sie nicht mehr.
- Eine Aufgabe zuweisen, jemanden erwähnen oder eine Benachrichtigung an die Gruppe senden erreicht alle, die zu diesem Zeitpunkt Mitglied sind.

## Gruppen aus Microsoft Entra [#groepen-uit-microsoft-entra]

Verwalten Sie Ihr Personal bereits in Microsoft Entra ID, kann Entra die Mitglieder einer Gruppe automatisch pflegen. Unter der Gruppenliste steht dann die Tabelle **Entra-Gruppen**, in der Sie jede Entra-Gruppe mit einer Tillor-Gruppe verknüpfen.

<Callout type="info">
Bei einer verknüpften Gruppe ist Entra die Quelle. Ein Mitglied, das Sie in Tillor von Hand hinzufügen oder entfernen, wird bei der nächsten Synchronisierung wieder an Entra angeglichen.
</Callout>

Siehe [Microsoft Entra-Gruppen](/gebruikers/microsoft-entra), um die Verknüpfung einzurichten.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet Die Gruppe konnte nicht gespeichert werden">
Versuchen Sie es erneut. Schlägt es weiter fehl, wenden Sie sich an den Tillor-Support.
</Accordion>
<Accordion title="Die Schaltfläche Gruppenberechtigungen ist ausgegraut">
Sie haben die Berechtigung **Benutzerberechtigungen verwalten** nicht.
</Accordion>
<Accordion title="Ein Mitglied kann etwas nicht, obwohl die Gruppe es erlaubt">
Eine andere Gruppe dieses Mitglieds verweigert diese Berechtigung. Eine Verweigerung gewinnt immer. Öffnen Sie das Fenster **Benutzerberechtigungen bearbeiten** des Mitglieds, um zu sehen, welche Gruppe sie sperrt.
</Accordion>
<Accordion title="Ich sehe ein Mitglied nicht in der Auswahlliste">
In der Liste stehen nur Benutzer Ihrer Organisation. Laden Sie die Person zuerst ein. Siehe [Benutzer einladen](/gebruikers/gebruikers-en-rechten).
</Accordion>
<Accordion title="Ein Mitglied verschwindet immer wieder aus der Gruppe">
Ist die Gruppe mit Microsoft Entra verknüpft, ist Entra die Quelle und die nächste Synchronisierung gleicht die Mitglieder an. Passen Sie das Mitglied in Entra an.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Microsoft Entra-Gruppen" href="/gebruikers/microsoft-entra" description="Gruppen automatisch aus Entra pflegen" />
  <Card title="Ansichten" href="/taken/weergaven" description="Eine Aufgabenansicht mit einer Gruppe teilen" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Einstellungen und Benutzerberechtigungen" />
</Cards>


# Übersicht (/de-DE/gebruikers)

Hier regeln Sie, wer mit Tillor arbeitet und was die Personen tun dürfen: Benutzer einladen, Berechtigungen vergeben, Kolleginnen und Kollegen in Gruppen einordnen und die Einstellungen Ihrer Organisation anpassen. Ein Benutzer ist jede Person mit einem Konto, die Zugang zu Ihrer Organisation hat. Sie verwalten das unter <UIPath>Support > Einstellungen</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Einstellungen > Benutzer mit der Mitgliederliste" />

<Callout type="info" title="Gut zu wissen">
- Ein neuer Benutzer erhält einen festen Satz Startberechtigungen (Einstellungen, Integrationen, einige Benachrichtigungen, Unterschriftsanfragen und eigene Felder). Alles andere vergeben Sie
- Sie können nur Berechtigungen vergeben, die Sie selbst haben. Die Berechtigung **Benutzerberechtigungen verwalten** kann nur ein Benutzer mit **Alle Berechtigungen** weitergeben
- Eine Verweigerung über eine Gruppe gewinnt immer gegen eine Berechtigung, die Sie direkt vergeben haben
- Sie können sich nicht selbst entfernen und Ihre eigenen Berechtigungen nicht bearbeiten
- Sie haben kein eigenes Tillor-Passwort: Sie melden sich über Google, Microsoft oder Apple an
- Firmendaten wie die USt-IdNr. oder die IBAN ändern Sie nicht selbst. Das erledigt der Tillor-Support
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Ein Benutzer hat Berechtigungen auf zwei Wegen: direkt oder über eine Gruppe. Eine Gruppe kann eine Berechtigung auch verweigern.

```mermaid
flowchart TD
  U[Benutzer] -->|direkt vergeben| R[Berechtigungen des Benutzers]
  U -->|ist Mitglied von| G[Gruppe]
  G -->|Erlauben| R
  G -->|Erben| N[Tut nichts, der Benutzer behält seine eigenen Berechtigungen]
  G -->|Verweigern| B[Berechtigung gesperrt, auch wenn der Benutzer sie selbst hatte]
  R --> A[Was der Benutzer in Tillor sieht und tun darf]
  B --> A
```

- **Direkt**: Sie schalten eine Berechtigung im Fenster **Benutzerberechtigungen bearbeiten** ein. Siehe [Benutzer einladen und Berechtigungen vergeben](/gebruikers/gebruikers-en-rechten).
- **Über eine Gruppe**: Bei **Gruppenberechtigungen** wählen Sie pro Berechtigung **Erlauben**, **Erben** oder **Verweigern**. Das gilt für alle in der Gruppe. Siehe [Gruppen](/gebruikers/groepen).
- **Verweigert**: Steht eine Berechtigung bei einer Gruppe auf **Verweigern**, ist sie gesperrt, egal wie viele andere Gruppen oder direkte Berechtigungen sie geben.
- Dieselben Gruppen verwenden Sie, um Aufgaben zuzuweisen, jemanden zu erwähnen und Ansichten zu teilen.

## Ihr eigenes Konto [#je-eigen-account]

Klicken Sie in der Seitenleiste unten auf Ihren Namen und wählen Sie **Konto**. Dort verwalten Sie Ihr Profil, Ihre Telefonnummer, aktive Sitzungen, OAuth-Apps und verknüpfte Anmeldeplattformen. Unter **Benachrichtigungen** wählen Sie pro Benachrichtigung, ob Tillor Sie per E-Mail oder Push erreicht. Siehe [Anmelden & Zugang](/inloggen).

## API-Schlüssel [#api-sleutels]

Ein API-Schlüssel lässt ein anderes Programm in Ihrem Namen mit Tillor sprechen. Er gehört zu Ihrem Konto. Sie verwalten sie auf Ihrer Kontoseite.

<Steps>
<Step>
### Ihr Konto öffnen [#open-je-account]
Klicken Sie in der Seitenleiste unten auf Ihren Namen und wählen Sie **Konto**.
</Step>
<Step>
### Den Schlüssel erstellen [#maak-de-sleutel]
Öffnen Sie den Abschnitt **API-Schlüssel** und klicken Sie auf **API-Schlüssel erstellen**.
</Step>
<Step>
### Ihn sofort kopieren [#kopieer-hem-meteen]
Danach zeigt Tillor den Schlüssel nicht mehr vollständig an.
</Step>
</Steps>

Über **Entwickler** (dasselbe Benutzermenü) finden Sie außerdem die Verknüpfung **Zu API-Schlüsseln**.

<Callout type="warn">
Bewahren Sie API-Schlüssel sicher auf und teilen Sie sie nie über ungesicherte Kanäle. Ist ein Schlüssel offengelegt worden, löschen Sie ihn oder klicken Sie auf **Neu generieren** und erstellen Sie bei Bedarf einen neuen.
</Callout>

## Bereiche [#onderdelen]

<Cards>
  <Card title="Benutzer einladen und Berechtigungen vergeben" href="/gebruikers/gebruikers-en-rechten" description="Kolleginnen und Kollegen hinzufügen und festlegen, was sie dürfen" />
  <Card title="Gruppen" href="/gebruikers/groepen" description="Kolleginnen und Kollegen gemeinsam zuweisen, erwähnen und Berechtigungen geben" />
  <Card title="Microsoft Entra-Gruppen" href="/gebruikers/microsoft-entra" description="Gruppenmitglieder automatisch aus Entra pflegen" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Alle Bereiche der Einstellungen" />
  <Card title="Einstellungen für Rechnungsstellung" href="/gebruikers/instellingen-facturatie" description="PDF, Zahlungsfrist und MwSt.-Sätze" />
  <Card title="Einstellungen für Zahlungen" href="/gebruikers/instellingen-betalingen" description="Sonstige, Erinnerungen und Absenderadresse" />
  <Card title="Mietperioden einstellen" href="/gebruikers/instellingen-huurperiodes" description="Mietrhythmen für Belegungen" />
  <Card title="Einstellungen für Zugangskontrolle" href="/gebruikers/instellingen-toegangscontrole" description="Ausfahren mit einem abgelaufenen Kennzeichen" />
  <Card title="Entwickler" href="/ontwikkelaars" description="Integrationsdokumentation und Webhooks" />
</Cards>

## Begriffe [#begrippen]

- **Benutzer**: Jemand mit einem Konto, der Zugang zu Ihrer [Organisation](/begrippen#organisatie) hat.
- **[Berechtigung](/begrippen#recht)**: Eine Erlaubnis, etwas zu sehen oder zu tun, zum Beispiel **Produkte bearbeiten**.
- **Alle Berechtigungen**: Ein Badge für Benutzer, die alles dürfen. Ihre Berechtigungen bearbeiten Sie nicht.
- **[Gruppe](/begrippen#groep)**: Ein fester Kreis von Kolleginnen und Kollegen, gegebenenfalls mit eigenen Berechtigungen.
- **Einladung**: Eine offene Anfrage an jemanden ohne Konto, Mitglied zu werden.
- **API-Schlüssel**: Ein Code, mit dem ein anderes Programm mit Tillor arbeitet.

Weitere Begriffe stehen im [Begriffsverzeichnis](/begrippen).


# Einstellungen für Zahlungen (/de-DE/gebruikers/instellingen-betalingen)

Unter <UIPath>Support > Einstellungen > Zahlungen</UIPath> stehen einige Einstellungen, die das Erfassen von Zahlungen und den Versand von Benachrichtigungen beeinflussen. Die Einstellungen gelten für Ihre gesamte Organisation.

<Requires permission="Einstellungen bearbeiten" />

<DocScreenshot src="/screenshots/instellingen/settings-payments.png" alt="Einstellungen > Zahlungen" />

## Einstellungen [#instellingen]

| Einstellung | Was sie bewirkt |
|---|---|
| **Zahlungsmethode "Sonstige" anzeigen** | Zeigt die Methode **Sonstige** im Zahlungsfenster an. Damit erfassen Sie Zahlungen mit einer eigenen Beschreibung, zum Beispiel einen Scheck oder einen Tausch. Standardmäßig aus. |
| **Standard: Erinnerung bei manueller Überweisung** | Setzt den Haken für die Erinnerung zum strukturierten Verwendungszweck standardmäßig, wenn Sie eine manuelle Banküberweisung erfassen. Sie können den Haken pro Zahlung weiterhin ein- oder ausschalten. Standardmäßig aus. |
| **Höchstbetrag Bargeld** | Ein Betrag in ganzen Euro. Standardmäßig 2999. |
| **E-Mail-Absenderadresse** | Die Adresse, mit der Tillor Benachrichtigungen per E-Mail versendet. |

## Höchstbetrag Bargeld [#maximumbedrag-contant]

Mit **Höchstbetrag Bargeld** legen Sie fest, wie hoch eine einzelne Barzahlung sein darf. Standardmäßig sind das 2999 Euro. Tillor prüft das bei jeder Barzahlung, auch wenn sie über eine Verknüpfung hereinkommt. Ist der Betrag höher, erfassen Sie ihn in Teilen oder wählen eine andere Methode. Siehe [Bar und Überweisung](/betalingsverwerking/contant).

## Absenderadresse von Benachrichtigungen [#afzenderadres-van-meldingen]

Lassen Sie die **E-Mail-Absenderadresse** leer, steht der Name Ihrer Organisation als Absender auf Benachrichtigungen, mit einer Adresse von Tillor. Geben Sie eine gültige E-Mail-Adresse ein, zum Beispiel `meldingen@recreatiepark-het-meer.be`, verwendet Tillor diese Adresse, mit dem Namen Ihrer Organisation als Absendername. Geben Sie nur die Adresse ein, ohne Namen. Eine ungültige Adresse wird nicht gespeichert.

## Änderungen speichern [#wijzigingen-opslaan]

Klicken Sie unten auf **Einstellungen speichern**. Mit **Abbrechen** setzen Sie das Formular auf die gespeicherten Werte zurück.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Bar und Überweisung" href="/betalingsverwerking/contant" description="Zahlungen erfassen, die außerhalb von Tillor eingegangen sind" />
  <Card title="Zahlungen auf einer Rechnung erfassen" href="/facturen/betalingen-registreren" description="Zahlungsmethoden und Felder im Zahlungsfenster" />
  <Card title="Einstellungen für Rechnungsstellung" href="/gebruikers/instellingen-facturatie" description="Zahlungsfrist, MwSt. und PDF" />
</Cards>


# Einstellungen für Rechnungsstellung (/de-DE/gebruikers/instellingen-facturatie)

Unter <UIPath>Support > Einstellungen > Rechnungsstellung</UIPath> stellen Sie die Standardwerte für Rechnungen und für das PDF ein, das Sie an Kunden senden. Die Einstellungen gelten für Ihre gesamte Organisation.

<Requires permission="Einstellungen bearbeiten" />

<DocScreenshot src="/screenshots/instellingen/settings-invoicing.png" alt="Einstellungen > Rechnungsstellung" />

## Was auf dem Rechnungs-PDF steht [#wat-staat-er-op-de-factuur-pdf]

| Einstellung | Was sie bewirkt |
|---|---|
| **Allgemeine Geschäftsbedingungen im Rechnungs-PDF** | Das PDF erhält zu jeder Seite eine Rückseite mit den allgemeinen Geschäftsbedingungen. In der Fußzeile steht ein Verweis darauf. Der Text der Bedingungen ist fest und nennt den juristischen Namen Ihrer Organisation. Standardmäßig aus. |
| **MwSt.-Übersichtstabelle im Rechnungs-PDF** | Neben den Summen steht eine Tabelle mit Bemessungsgrundlage und MwSt.-Betrag pro MwSt.-Satz. Standardmäßig aus. |
| **Rechnungspositionen pro PDF-Seite** | Die maximale Anzahl Positionen auf einer Seite. Gibt es mehr Positionen, folgt eine neue Seite. Standardmäßig 20, mindestens 1. |

## Zahlungsfrist [#betaaltermijn]

Bei **Standardfälligkeit (Tage)** geben Sie die Anzahl Tage zwischen Rechnungsdatum und Fälligkeitsdatum ein. Sie gilt für Rechnungen, bei denen Sie selbst kein Fälligkeitsdatum gewählt haben. Standardmäßig sind das 7 Tage. Sie können 0 eingeben, dann ist die Rechnung am Tag der Buchung fällig. Siehe [Eine Rechnung buchen](/facturen/boeken).

## MwSt.-Sätze wählen [#btw-tarieven-kiezen]

Unter **Zulässige MwSt-Sätze** stehen die Sätze, die Sie in der MwSt.-Auswahlliste auf Rechnungsentwürfen wählen können. Standardmäßig sind das 0 %, 6 %, 9 %, 12 % und 21 %.

1. Geben Sie im Feld unter der Liste einen Prozentsatz zwischen 0 und 100 ein. Ein Komma oder ein Punkt ist erlaubt.
2. Klicken Sie auf **Satz hinzufügen**.
3. Entfernen Sie einen Satz mit dem Kreuz neben dem Prozentsatz.
4. Klicken Sie auf **Einstellungen speichern**.

Die Liste ist immer von niedrig nach hoch sortiert. Einen Satz, der bereits in der Liste steht, fügen Sie nicht doppelt hinzu. Steht auf einer bestehenden Rechnungsposition ein Satz, den Sie später aus der Liste entfernen, bleibt dieser Satz auf der Position stehen.

Diese Auswahlliste sehen Sie nur, wenn **MwSt.-Satz als Dropdown in Rechnungsentwurfszeilen** eingeschaltet ist. Dann erhält ein Rechnungsentwurf eine MwSt.-Spalte, in der Sie pro Position einen Satz wählen. Wählen Sie ein Produkt, bleibt der Satz dieses Produkts der Ausgangswert. Siehe [MwSt.](/boekhouden/belasting) und [Rechnungen erstellen und bearbeiten](/facturen/aanmaken-en-bewerken).

## Automatische Rechnungen für Verbrauch [#automatische-facturen-voor-verbruik]

Bei **Mindestbetrag für automatische Verbrauchsrechnungen** geben Sie einen Betrag in Euro ein. Für Kunden mit automatischer Abrechnung von Versorgungsleistungen erstellt Tillor erst dann eine Rechnung, wenn der offene Betrag diesen Betrag erreicht. Lassen Sie das Feld leer (**Kein Mindestbetrag**), wird jeder offene Betrag abgerechnet.

Hat ein Kunde im Kundenprofil ein eigenes Minimum, gilt dieses Minimum für diesen Kunden anstelle dieser Einstellung. Siehe [Zählerverwaltung](/meterbeheer).

## Änderungen speichern [#wijzigingen-opslaan]

Klicken Sie unten auf **Einstellungen speichern**. Mit **Abbrechen** setzen Sie das Formular auf die gespeicherten Werte zurück. Haben Sie nur die Berechtigung **Einstellungen anzeigen**, sind die Felder ausgegraut.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Rechnung buchen" href="/facturen/boeken" description="Rechnungsdatum und Fälligkeitsdatum" />
  <Card title="MwSt." href="/boekhouden/belasting" description="MwSt.-Sätze und MwSt. auf Rechnungen" />
  <Card title="Zahlungseinstellungen" href="/gebruikers/instellingen-betalingen" description="Bar, Sonstige und Absenderadresse" />
</Cards>


# Mietperioden einstellen (/de-DE/gebruikers/instellingen-huurperiodes)

Bei einer Belegung wählen Sie einen **Mietrhythmus**. Welche Auswahl Sie dort sehen, legen Sie unter <UIPath>Support > Einstellungen > Mietperioden</UIPath> fest. Jede Periode, die Sie hier hinzufügen, wird zu einer Auswahl in der Liste.

<Requires permission="Einstellungen bearbeiten" />

<DocScreenshot src="/screenshots/instellingen/settings-occupation.png" alt="Einstellungen > Mietperioden mit einer neuen Periode" />

## Eine Periode hinzufügen [#een-periode-toevoegen]

<Steps>
<Step>
### Eine Periode hinzufügen [#voeg-een-periode-toe]
Öffnen Sie **Mietperioden** und klicken Sie auf **Periode hinzufügen**. Es erscheint ein Block mit den Ausgangswerten: Januar, 12 Monate.
</Step>
<Step>
### Die Periode ausfüllen [#vul-de-periode-in]
Wählen Sie den **Startmonat** und geben Sie bei **Dauer (Monate)** eine Zahl von 1 bis 12 ein. Eine Periode von 12 Monaten, die im Januar beginnt, ist ein Kalenderjahr. Eine Periode von 1 Monat ist eine monatliche Miete. Bei **Bezeichnung** können Sie einen eigenen Namen eintragen, zum Beispiel Jährlich.
</Step>
<Step>
### Wählen, wie gerundet wird [#kies-hoe-je-afrondt]
Der Haken **Startdaten auf die nächste Periode runden** ist standardmäßig gesetzt. Was er bewirkt, lesen Sie unter [Auf die nächste Periode runden](#afronden-naar-de-volgende-periode).
</Step>
<Step>
### Speichern [#sla-op]
Klicken Sie auf **Einstellungen speichern**. Mit **Periode entfernen** entfernen Sie eine Periode. Mit **Abbrechen** setzen Sie das Formular auf die gespeicherte Liste zurück.
</Step>
</Steps>

Haben Sie noch keine Perioden hinzugefügt, steht dort **Keine Mietperioden eingestellt**. Im Formular einer Belegung können Sie dann keinen Mietrhythmus wählen.

## Wo Sie die Perioden wiederfinden [#waar-zie-je-de-periodes-terug]

Im Formular einer Belegung steht die Liste unter **Mietrhythmus**, oben mit **Kein Rhythmus**. Eine Periode von 1 Monat heißt dort **Monatlich**. Eine Periode von 12 Monaten wird als **Jahr (Jan - Dez)** angezeigt, mit dem ersten und letzten Monat Ihrer Periode. Andere Dauern erscheinen als **6 Monate (Apr - Sep)**. Haben Sie bei einer Periode eine **Bezeichnung** eingetragen, steht diese Bezeichnung anstelle dieses Textes, in der Liste und in der Spalte **Mietrhythmus** der Belegungen.

Entfernen Sie eine Periode aus den Einstellungen, behalten Belegungen, die bereits damit angelegt wurden, ihren Mietrhythmus.

## Auf die nächste Periode runden [#afronden-naar-de-volgende-periode]

Der Haken legt den Ausgangszustand von **Auf nächste Periodengrenze runden** auf der Rechnungsposition fest, mit der Sie eine Belegung verlängern. Auf der Rechnungsposition können Sie den Haken weiterhin selbst ein- oder ausschalten.

- Ist der Haken gesetzt, endet die Position an der nächsten Periodengrenze. Beginnen Sie mitten in einer Periode, berechnen Sie das erste Stück anteilig. Danach folgt der Kunde demselben Zyklus wie die anderen Mieter.
- Ist der Haken nicht gesetzt, dauert die Position genau eine Periode ab dem Startdatum.

Siehe [Rechnungen erstellen und bearbeiten](/facturen/aanmaken-en-bewerken) und [Belegungen](/bezettingen).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Belegungen" href="/bezettingen" description="Einen Kunden langfristig mit einem Gelände verknüpfen" />
  <Card title="Rechnungen erstellen und bearbeiten" href="/facturen/aanmaken-en-bewerken" description="Auf nächste Periodengrenze runden auf einer Rechnungsposition" />
</Cards>


# Einstellungen für Zugangskontrolle (/de-DE/gebruikers/instellingen-toegangscontrole)

Unter <UIPath>Support > Einstellungen > Zugangskontrolle</UIPath> stellen Sie das Verhalten der Schranken für Kennzeichen ein, deren Zugangszeitraum abgelaufen ist.

<Requires permission="Einstellungen bearbeiten" />

<DocScreenshot src="/screenshots/instellingen/settings-access-control.png" alt="Einstellungen > Zugangskontrolle" />

## Abgelaufene Kennzeichen ausfahren lassen [#verlopen-kentekens-laten-uitrijden]

Ein Besucher mit einem Kennzeichen, dessen Zugangszeitraum abgelaufen ist, kommt sonst nicht mehr durch die Ausfahrtschranke. Mit **Abgelaufene Kennzeichen ausfahren lassen** öffnet sich die Ausfahrtschranke trotzdem, und zwar während einer Karenzzeit nach dem Ablauf. Das funktioniert nur außerhalb der Öffnungszeiten. Ist die Rezeption geöffnet, erledigt das Personal das Fahrzeug am Schalter.

Der Haken ist standardmäßig gesetzt. Schalten Sie ihn aus, bleibt die Ausfahrtschranke für ein abgelaufenes Kennzeichen geschlossen.

| Einstellung | Was sie bewirkt |
|---|---|
| **Abgelaufene Kennzeichen ausfahren lassen** | Schaltet die Karenzzeit ein oder aus. |
| **Karenzzeit für Ausfahrt (Tage)** | Die Anzahl Tage nach dem Ablauf, in denen ein Fahrzeug außerhalb der Öffnungszeiten noch ausfahren kann. Standardmäßig 2, höchstens 30. Bei 0 gibt es keine Karenzzeit. |

Die Karenzzeit gilt nur für Kennzeichen an einer Ausfahrt. Ein Kennzeichen, das gesperrt oder nicht aktiv ist, erhält nie eine Karenzzeit. Für andere Zugangsmethoden, zum Beispiel NFC-Tags oder QR-Codes, gibt es keine Karenzzeit.

Die Öffnungszeiten stammen aus <UIPath>Support > Einstellungen > Öffnungszeiten</UIPath>. Siehe [Öffnungszeiten](/gebruikers/organisaties#openingsuren).

## Änderungen speichern [#wijzigingen-opslaan]

Klicken Sie unten auf **Einstellungen speichern**. Mit **Abbrechen** setzen Sie das Formular auf die gespeicherten Werte zurück.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zugangskontrolle" href="/toegangscontrole" description="Zugangspunkte, Fahrzeuge und Protokoll" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Öffnungszeiten und weitere Einstellungen" />
</Cards>


# Microsoft Entra-Gruppen (/de-DE/gebruikers/microsoft-entra)

Mit Provisioning sendet Microsoft Entra ID Ihre Benutzer und Gruppen an Tillor. Verknüpfen Sie eine Entra-Gruppe mit einer Tillor-[Gruppe](/gebruikers/groepen), folgen die Mitglieder dieser Gruppe Entra: Wen Sie in Entra hinzufügen, erhält die Aufgaben und Ansichten der Gruppe, und wen Sie entfernen oder deaktivieren, verliert sie. Dafür muss sich niemand neu anmelden.

Entra verwendet dafür das SCIM-Protokoll. Tillor liest selbst nichts aus Ihrem Microsoft-Tenant: Entra bestimmt, welche Benutzer und Gruppen es sendet. Nur während [Schnell einrichten](#snel-instellen) spricht Ihr Browser mit Microsoft, um die App für Sie anzulegen.

## Was passiert und was nicht [#wat-er-wel-en-niet-gebeurt]

- **Nur bestehende Mitglieder.** Entra legt keine Tillor-Konten an. Wer noch nicht Mitglied Ihrer Organisation ist, zählt nicht mit, bis Sie die Person [einladen](/gebruikers/organisaties). Sobald sie Mitglied wird, landet sie sofort in ihren verknüpften Gruppen
- **Keine Daten von Nicht-Mitgliedern.** Von Personen ohne Tillor-Konto speichert Tillor weder Namen noch E-Mail-Adresse, nur einen unlesbaren Code, an dem Tillor sie erkennt, wenn sie später Mitglied werden
- **Nichts ohne Verknüpfung.** Eine Entra-Gruppe ändert in Tillor erst etwas, wenn Sie sie unter **Entra-Gruppen nicht verknüpft** mit einer Tillor-Gruppe verknüpfen
- **Eins zu eins.** Eine Tillor-Gruppe gehört zu höchstens einer Entra-Gruppe
- **Der Name bleibt bei Tillor.** Benennen Sie die Gruppe in Entra um, sehen Sie den neuen Namen hinter **Entra ·**, aber die Tillor-Gruppe behält ihren eigenen Namen
- **Verschachtelte Gruppen** werden nicht aufgelöst. Eine Gruppe, die Mitglied einer anderen Gruppe ist, zählt nicht als Mitglied. Möchten Sie diese Personen ebenfalls, weisen Sie die verschachtelte Gruppe in Entra separat zu und verknüpfen Sie sie mit derselben oder einer anderen Tillor-Gruppe
- **Die Anmeldung ändert sich nicht.** Personen melden sich weiterhin mit Microsoft an, siehe [Anmelden](/inloggen)

## Bevor Sie beginnen [#voordat-je-begint]

Sie brauchen:

- In Tillor die Berechtigung **Einstellungen bearbeiten**
- In Microsoft Entra die Rolle **Cloud Application Administrator** oder **Application Administrator** (oder höher)
- Eine Entra-Lizenz, die automatisches Provisioning für eigene Apps erlaubt (Microsoft Entra ID P1 oder höher)

Achten Sie darauf, dass Ihre Kolleginnen und Kollegen in Tillor dasselbe Microsoft-Konto oder dieselbe E-Mail-Adresse haben wie in Entra. So erkennt Tillor, wer wer ist, siehe [Wie Tillor Personen erkennt](#hoe-tillor-mensen-herkent).

## Schnell einrichten [#snel-instellen]

Sind Sie selbst Entra-Administrator, richtet Tillor die Verknüpfung in einem Schritt für Sie ein.

1. Gehen Sie zu **Support > Einstellungen** und wählen Sie **Gruppen**
2. Klicken Sie bei **Microsoft Entra** auf **Mit Microsoft einrichten** und danach auf **Anmelden und einrichten**
3. Melden Sie sich im Microsoft-Fenster mit Ihrem Administratorkonto an und erteilen Sie die Zustimmung. Microsoft bittet um die Erlaubnis, Apps und Provisioning zu verwalten und Ihre Gruppen zu lesen

Tillor legt dann die App in Entra an, trägt die Tenant-URL und das Token ein, lässt Benutzer an ihrem Microsoft-Konto erkennen und lässt Entra den Typ jeder Gruppe mitsenden. Danach startet die Synchronisierung, und Tillor sendet Sie und alle Ihre Gruppen sofort weiter, sodass Sie nicht auf die erste Synchronisierung warten müssen. Zum Schluss liest Tillor pro Gruppe den Typ aus und ob ein Team dazugehört. Sie sehen, wie jeder Schritt abgehakt wird. Tillor erledigt das im Hintergrund: Sie können das Fenster oder sogar die Seite schließen. Klicken Sie später erneut auf **Mit Microsoft einrichten**, sehen Sie, wie weit es ist, oder bis zu einer Stunde nach Abschluss, ob es geklappt hat oder fehlgeschlagen ist. Danach können Sie mit **Erneut einrichten** noch einmal beginnen.

Entra sendet dabei alle Ihre Benutzer und Gruppen. Sie müssen vorab nichts wählen: Die Gruppen erscheinen unter **Entra-Gruppen nicht verknüpft** und ändern nichts, bis Sie sie verknüpfen. Machen Sie dafür bei [Gruppen in Tillor verknüpfen](#groepen-koppelen-in-tillor) weiter. Die Mitglieder der Gruppen folgen mit der ersten Synchronisierung. Sie dauert einige Minuten, bei großen Organisationen einige Stunden.

<Callout type="info">
Tillor verwendet den Zugriff nur für diese Einrichtung. Er geht verschlüsselt an die Hintergrundaufgabe und wird danach nirgends gespeichert; Microsoft lässt ihn nach etwa einer Stunde von selbst ablaufen. Durchlaufen Sie **Mit Microsoft einrichten** erneut, findet Tillor dieselbe App wieder und legt keine zweite an.
</Callout>

<Callout type="warn">
Schnell einrichten erzeugt ein neues Token. Ein Token, das Sie zuvor von Hand in Entra eingefügt haben, funktioniert danach nicht mehr. Bricht die Einrichtung auf halbem Weg ab, klicken Sie auf **Erneut versuchen**.
</Callout>

Klappt die Anmeldung nicht, zum Beispiel weil Ihre Organisation die Zustimmung für Apps blockiert, oder möchten Sie, dass Entra nur bestimmte Gruppen sendet, richten Sie die Verknüpfung wie unten beschrieben von Hand ein.

## Manuell einrichten [#handmatig-instellen]

<Steps>
<Step>

### Token in Tillor erzeugen [#token-maken-in-tillor]

1. Gehen Sie zu **Support > Einstellungen** und wählen Sie **Gruppen**
2. Oben steht **Microsoft Entra**. Ist die Verknüpfung schon eingerichtet, klicken Sie auf **Verbindung**
3. Kopieren Sie die **Mandanten-URL**. Sie sieht so aus: `https://…/api/orgs/<organisatie>/scim/v2`
4. Klicken Sie auf **Token erzeugen** und kopieren Sie das Token, das erscheint

<Callout type="warn">
Das Token wird nur ein einziges Mal angezeigt. Fügen Sie es sofort in Entra ein. Haben Sie es verloren, klicken Sie auf **Token ersetzen** und verwenden Sie das neue Token.
</Callout>

</Step>
<Step>

### Eine App in Entra anlegen [#een-app-maken-in-entra]

1. Öffnen Sie das [Microsoft Entra Admin Center](https://entra.microsoft.com)
2. Gehen Sie zu **Identity > Applications > Enterprise applications** und klicken Sie auf **New application**
3. Klicken Sie auf **Create your own application**
4. Geben Sie der App einen Namen, zum Beispiel **Tillor**, wählen Sie **Integrate any other application you don't find in the gallery (Non-gallery)** und klicken Sie auf **Create**

Haben Sie bereits eine Enterprise Application für Tillor, können Sie auch diese verwenden.

</Step>
<Step>

### Provisioning verknüpfen [#provisioning-koppelen]

1. Öffnen Sie in der App **Provisioning** und klicken Sie auf **Get started** (oder **New configuration**)
2. Setzen Sie **Provisioning Mode** auf **Automatic**
3. Tragen Sie unter **Admin Credentials** ein:
   - **Tenant URL**: die Mandanten-URL aus Tillor
   - **Secret Token**: das Token aus Tillor
4. Klicken Sie auf **Test Connection**. Entra muss melden, dass die Verbindung geklappt hat
5. Klicken Sie auf **Save**

</Step>
<Step>

### Attribute prüfen [#attributen-controleren]

Öffnen Sie unter **Mappings** die Zeile **Provision Microsoft Entra ID Users**:

- Setzen Sie **externalId** auf **objectId** (standardmäßig steht dort **mailNickname**). Dann erkennt Tillor jemanden an seinem Microsoft-Konto, auch wenn die E-Mail-Adresse abweicht
- Lassen Sie **userName** (← **userPrincipalName**), **active** und **emails[type eq "work"].value** (← **mail**) stehen

Lassen Sie **Provision Microsoft Entra ID Groups** eingeschaltet. Die Standardeinstellungen (**displayName**, **externalId** ← **objectId**, **members**) sind richtig.

Möchten Sie in Tillor sehen, um was für eine Gruppe es sich handelt, fügen Sie bei den Gruppen diese Attribute hinzu. Wählen Sie unter **Show advanced options** zuerst **Edit attribute list for customappsso** und fügen Sie die Zielattribute hinzu, danach pro Zeile **Add New Mapping**:

| Quelle in Entra | Zielattribut | Typ |
|---|---|---|
| Ausdruck `Join(",", [groupTypes])` | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:groupTypes` | String |
| **securityEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:securityEnabled` | Boolean |
| **mailEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:mailEnabled` | Boolean |
| **onPremisesSyncEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:onPremisesSyncEnabled` | Boolean |
| **mail** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:mail` | String |
| **description** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:description` | String |

Fehlt eine Quelle in der Liste von Entra, überspringen Sie diese Zeile. Ob zu einer Gruppe ein Team gehört, kann Entra so nicht weitergeben; das sieht Tillor nur über **Mit Microsoft einrichten**.

Andere Attribute dürfen Sie stehen lassen. Tillor speichert sie nicht.

</Step>
<Step>

### Gruppen zuweisen [#groepen-toewijzen]

1. Öffnen Sie in der App **Users and groups** und klicken Sie auf **Add user/group**
2. Wählen Sie die Gruppen, die Tillor erhalten soll, zum Beispiel **Rezeption**, und klicken Sie auf **Assign**
3. Prüfen Sie unter **Provisioning > Settings**, dass **Scope** auf **Sync only assigned users and groups** steht

Entra sendet eine Gruppe zusammen mit ihren Mitgliedern. Sie müssen die Mitglieder nicht separat zuweisen.

</Step>
<Step>

### Provisioning starten [#provisioning-starten]

Setzen Sie unter **Provisioning** den **Provisioning Status** auf **On** und klicken Sie auf **Save**.

Die erste Runde kann je nach Anzahl der Benutzer etwas dauern. Danach sendet Entra etwa alle 40 Minuten die Änderungen. Möchten Sie eine einzelne Person sofort aktualisieren, verwenden Sie **Provision on demand** in Entra.

</Step>
<Step>

### Gruppen in Tillor verknüpfen [#groepen-koppelen-in-tillor]

Aktualisieren Sie **Einstellungen > Gruppen**. Oben steht die Zeile **Microsoft Entra** mit der letzten Synchronisierung und der Anzahl verknüpfter Gruppen. Unter Ihren Tillor-Gruppen steht **Entra-Gruppen nicht verknüpft** mit den gesendeten Gruppen, die noch nichts bewirken. Klicken Sie auf **Anzeigen**, wenn die Liste zugeklappt ist, und verwenden Sie das Suchfeld, um eine Gruppe zu finden. Wählen Sie pro Gruppe bei **Verknüpfen mit…**, was geschehen soll, und klicken Sie danach auf **Speichern**. Mit **Zurücksetzen** verwerfen Sie Ihre Auswahl. Eine Tillor-Gruppe kann nur an einer Entra-Gruppe hängen; Gruppen, die bereits verknüpft sind, können Sie nicht noch einmal wählen.

| Auswahl | Was passiert |
|---|---|
| **Neu anlegen** | Tillor legt eine Gruppe mit dem Namen aus Entra an und füllt sie mit den erkannten Mitgliedern |
| Eine bestehende Gruppe | Die Mitglieder dieser Gruppe werden durch die erkannten Mitglieder aus Entra ersetzt. Hat Entra die Mitglieder dieser Gruppe noch nicht gesendet, bleiben die aktuellen Mitglieder stehen, bis die Synchronisierung sie liefert |

Ab jetzt aktualisiert Entra die Mitglieder bei jeder Synchronisierung. Die verknüpfte Gruppe verschwindet aus der Liste, und in Ihren Tillor-Gruppen steht unter der Gruppe **Entra · [Name]** mit dem Gruppentyp.

Verknüpft wird nur über **Entra-Gruppen nicht verknüpft**. Eine Tillor-Gruppe, die Sie von Hand verwalten, zum Beispiel IT, verknüpfen Sie nicht von der Gruppe selbst aus.

Hinter jedem Gruppennamen steht, um was für eine Gruppe es sich in Entra handelt. Mit den Schaltflächen über der Liste zeigen Sie nur eine Art an.

| Label | Was es ist |
|---|---|
| **Sicherheit** | Eine gewöhnliche Sicherheitsgruppe, oft die Gruppe, die Sie verknüpfen möchten |
| **E-Mail-aktivierte Sicherheit** | Eine Sicherheitsgruppe mit eigener E-Mail-Adresse |
| **Verteilerliste** | Nur eine E-Mail-Liste |
| **Microsoft 365** | Eine Gruppe mit gemeinsamem Postfach und einer SharePoint-Website, manchmal mit einem Team |
| **Windows Server AD** | Stammt aus Ihrem lokalen Active Directory (hybrid) und wird dort verwaltet |
| **Dynamisch** | Entra bestimmt die Mitglieder selbst mit einer Regel |
| **Teams** | Es gehört ein Team dazu |
| **Typ unbekannt** | Tillor kennt den Typ noch nicht. Durchlaufen Sie **Mit Microsoft einrichten** erneut |

SharePoint-Websitegruppen, wie **Besitzer**, **Mitglieder** und **Besucher** einer Website, sind keine Entra-Gruppen. Sie gelangen nie nach Tillor. Was Sie dagegen sehen, ist die Microsoft-365-Gruppe hinter der Website.

</Step>
</Steps>

## Wie Tillor Personen erkennt [#hoe-tillor-mensen-herkent]

Für jeden Benutzer, den Entra sendet, sucht Tillor ein bestehendes Mitglied Ihrer Organisation:

1. Zuerst über das **Microsoft-Konto**, mit dem sich die Person in Tillor anmeldet (die Entra-Objekt-ID, wenn Sie **externalId** auf **objectId** setzen)
2. Sonst über die **E-Mail-Adresse**: die Arbeitsadresse aus Entra oder der **userPrincipalName**, wenn dieser eine E-Mail-Adresse ist

Findet Tillor niemanden oder ist der Benutzer in Entra deaktiviert, zählt er in der Gruppe nicht mit. Sobald die Person Mitglied der Organisation wird, zählt sie sofort mit. Schalten Sie sie in Entra wieder ein, zählt sie bei der nächsten Synchronisierung mit.

## Was bei Änderungen in Entra passiert [#wat-er-gebeurt-bij-wijzigingen-in-entra]

| In Entra | In Tillor |
|---|---|
| Mitglied zu einer verknüpften Gruppe hinzugefügt | Kommt in die Tillor-Gruppe (wenn es Mitglied der Organisation ist) |
| Mitglied aus der Gruppe entfernt | Verlässt die Tillor-Gruppe |
| Benutzer deaktiviert (**Account enabled** aus) | Verlässt alle verknüpften Tillor-Gruppen. Sein Tillor-Konto bleibt bestehen |
| Benutzer oder Gruppe nicht mehr der App zugewiesen | Entra sendet eine Deaktivierung oder Entfernung, mit demselben Effekt |
| Gruppe gelöscht | Unter der Tillor-Gruppe steht **In Entra entfernt. Die Mitglieder bleiben erhalten.** Die Tillor-Gruppe bleibt mit ihren letzten Mitgliedern bestehen und wird nicht mehr aktualisiert |

Jemanden ganz aus Ihrer Organisation zu entfernen, tun Sie in Tillor, unter [Organisation](/gebruikers/organisaties). Entra verwaltet nur die Gruppenmitglieder.

## Was Sie im Aktivitätsprotokoll wiederfinden [#wat-je-terugziet-in-het-activiteitenlog]

Im [Aktivitätsprotokoll](/activiteitenlog) sehen Sie:

- Jede Änderung an den Mitgliedern einer Tillor-Gruppe, die Entra durchführt, mit wer hinzukam oder ging. Sie steht auf den Namen des Systems, nicht eines Benutzers
- Jede Synchronisierungsrunde von Entra, eine Zeile pro Runde. Eine Runde, in der Entra nichts sendet, sehen Sie nicht
- Wer eine Entra-Gruppe mit einer Tillor-Gruppe verknüpft oder getrennt hat und wer das Token ersetzt hat

## Verknüpfung ändern oder beenden [#koppeling-wijzigen-of-stoppen]

- **Trennen**: Klicken Sie bei der Tillor-Gruppe auf **Trennen**. Die Tillor-Gruppe bleibt, wie sie ist, und Sie verwalten sie wieder von Hand. Die Entra-Gruppe erscheint wieder unter **Entra-Gruppen nicht verknüpft**
- **Andere Tillor-Gruppe**: Trennen Sie und verknüpfen Sie die Entra-Gruppe danach unter **Entra-Gruppen nicht verknüpft** mit einer anderen Gruppe. Die vorherige Gruppe behält ihre Mitglieder, wird aber nicht mehr aktualisiert
- **Ganz beenden**: Setzen Sie in Entra den **Provisioning Status** auf **Off** oder löschen Sie die Enterprise Application

## Token ersetzen [#token-vervangen]

Klicken Sie in der Zeile **Microsoft Entra** auf **Verbindung** und danach auf **Token ersetzen**, wenn das Token offengelegt wurde oder Sie es erneut brauchen. Das alte Token funktioniert sofort nicht mehr. Fügen Sie das neue Token in Entra unter **Provisioning > Admin Credentials > Secret Token** ein und klicken Sie auf **Save**. Bis Sie das tun, schlägt die Synchronisierung in Entra fehl.

## Probleme lösen [#problemen-oplossen]

**Mit Microsoft einrichten bricht bei einem Schritt ab**

Beim Schritt steht die Meldung von Microsoft. Meist fehlt Ihrem Konto die Administratorrolle oder die Zustimmung. Prüfen Sie die Rollen unter [Bevor Sie beginnen](#voordat-je-begint) und klicken Sie auf **Erneut versuchen**. Tillor verwendet die App und das Provisioning wieder, die bereits angelegt waren.

**Test Connection schlägt fehl**

Prüfen Sie, dass die Mandanten-URL vollständig übernommen wurde, einschließlich `/scim/v2`, und dass das Token das zuletzt erzeugte ist. Nach **Token ersetzen** funktioniert ein altes Token nicht mehr.

**Eine Gruppe steht nicht in der Liste**

Warten Sie, bis die erste Synchronisierung durch ist, und aktualisieren Sie die Seite. Haben Sie die Verknüpfung von Hand eingerichtet, sendet Entra nur Gruppen, die der App zugewiesen sind: Prüfen Sie **Users and groups** in der App und warten Sie die nächste Runde ab, oder verwenden Sie **Provision on demand**.

**Jemand fehlt in der Tillor-Gruppe**

- Ist die Person Mitglied Ihrer Tillor-Organisation? Entra legt keine Konten an
- Stimmt die E-Mail-Adresse in Entra mit der in Tillor überein? Setzen Sie sonst **externalId** auf **objectId**, damit Tillor die Person an ihrem Microsoft-Konto erkennt. Das funktioniert nur, wenn sie sich schon einmal mit Microsoft in Tillor angemeldet hat
- Ist der Benutzer in Entra eingeschaltet?
- Ist er direktes Mitglied der Gruppe und nicht über eine verschachtelte Gruppe?

**Meine manuelle Änderung verschwindet**

Bei einer verknüpften Gruppe ist Entra die Quelle. Passen Sie die Mitglieder in Entra an oder trennen Sie die Gruppe.

**Mehr Details zu einer fehlgeschlagenen Runde**

Öffnen Sie in Entra **Provisioning > Provisioning logs**. Dort sehen Sie pro Benutzer und Gruppe, was Entra versucht hat und welche Antwort Tillor gegeben hat.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Gruppen" href="/gebruikers/groepen" description="Gruppen anlegen und verwenden" />
  <Card title="Ansichten" href="/taken/weergaven" description="Eine Aufgabenansicht mit einer Gruppe teilen" />
  <Card title="Anmelden" href="/inloggen" description="Mit Microsoft anmelden" />
</Cards>


# Organisation (/de-DE/gebruikers/organisaties)

Auf der Seite **Einstellungen** (unten im Hauptmenü, <UIPath>Support > Einstellungen</UIPath>) verwalten Sie die Einstellungen Ihrer Organisation. Links wechseln Sie zwischen den Bereichen. Welche Bereiche Sie sehen, hängt von Ihren Berechtigungen ab.

| Bereich | Wofür |
|---|---|
| **Allgemein** | Organisationsprofil, Zeitzone, Standardland und Hausfarben. Siehe [Allgemein](#algemeen) |
| **Öffnungszeiten** | Wochenplan, Saisons, Ausnahmen und Feiertage. Siehe [Öffnungszeiten](#openingsuren) |
| **Rechnungsstellung** | PDF, Zahlungsfrist und MwSt.-Sätze. Siehe [Einstellungen für Rechnungsstellung](/gebruikers/instellingen-facturatie) |
| **Druck** | Drucker und Druckzeitpunkte. Siehe [Drucken](#afdrukken) |
| **Zahlungen** | Zahlungsmethode Sonstige und Absenderadresse. Siehe [Einstellungen für Zahlungen](/gebruikers/instellingen-betalingen) |
| **Mietperioden** | Mietrhythmen für Belegungen. Siehe [Mietperioden einstellen](/gebruikers/instellingen-huurperiodes) |
| **Platztarif** | Die Formel für den berechneten Tarif. Siehe [Tarifformel](/terreinen#tariefformule) |
| **Zugangskontrolle** | Ausfahren mit einem abgelaufenen Kennzeichen. Siehe [Einstellungen für Zugangskontrolle](/gebruikers/instellingen-toegangscontrole) |
| **Karte** | Kartenmittelpunkt und Kartenausrichtung. Siehe [Kartenstandard einstellen](/kaart#kaartstandaard-instellen) |
| **Terrain-Typen** | Typen für Gelände. Siehe [Geländetypen](/terreinen#terreintypes) |
| **Aufgabenlabels** | Labels für Aufgaben. Siehe [Labels](/taken/labels) |
| **Gruppen** | Kolleginnen und Kollegen bündeln. Siehe [Gruppen](/gebruikers/groepen) |
| **Eigene Felder** | Zusätzliche Felder bei Kunden, Gelände und mehr. Siehe [Eigene Felder](/eigen-velden) |
| **Apple Wallet** | Pass-Hintergrund und Zugangspunkt. Siehe [Apple Wallet](#apple-wallet) |
| **Tablets & Kioske** | Tablets und Kioske. Siehe [Tablets und Kioske](/mobiele-app/tablets-en-kiosken) |
| **Integrationen** | Verknüpfungen mit anderen Diensten. Siehe [Integrationen](#integraties) |
| **Benutzer** | Mitglieder, Einladungen und Berechtigungen. Siehe [Benutzerberechtigungen verwalten](#gebruikersrechten-beheren) |

<Callout type="info" title="Gut zu wissen">
- Welche Bereiche Sie sehen, hängt von Ihren Berechtigungen ab. Änderungen speichern Sie unten mit **Einstellungen speichern**
- Etwa eine Woche vor einem gesetzlichen Feiertag schreibt Tillor an die Support-Adresse, wenn die Öffnungszeiten dieses Tages noch leer sind
- Nach dem Speichern der Wallet-Einstellungen sendet Tillor alle aktiven Wallet-Pässe neu. Besucher sehen das meist nach dem Öffnen des Passes
- Sobald Ihre Organisation Rechnungen oder Zahlungen hat, kann die Währung nicht mehr geändert werden
</Callout>

<Callout type="info">
Firmendaten auf Rechnungen (Name, Adresse, USt-IdNr., IBAN, Logo) werden beim Onboarding eingestellt. Wenden Sie sich an den Tillor-Support, wenn Sie sie ändern möchten.
</Callout>

## Integrationen [#integraties]

Wählen Sie **Integrationen**, um verfügbare Verknüpfungen anzusehen, zum Beispiel Voys-Telefonie, Bankkonten, Mollie oder Buchhaltungssoftware (z. B. Admisol). Unter **Integrationen** im linken Menü stehen Kategorien (Kommunikation, Zahlungen, Buchhaltung, Zähler). Klicken Sie in der Liste auf eine Integration, um die Detailseite zu öffnen. Dort installieren Sie die Verknüpfung oder passen die Einstellungen an (kein separates Dialogfenster). Siehe auch die [Übersicht der Integrationen](/integraties).

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Einstellungen - Integrationsübersicht" />

## Allgemein [#algemeen]

Unter **Allgemein** stellen Sie das Organisationsprofil, die Zeitzone, das Standardland und die Hausfarben ein. Sie brauchen die Berechtigung **Einstellungen bearbeiten**, um Änderungen zu speichern.

## Öffnungszeiten [#openingsuren]

Unter **Öffnungszeiten** bearbeiten Sie einen Wochenplan. Mit den farbigen Optionen wechseln Sie zu **Saisonzeiträumen** (zum Beispiel 1. Juli bis 31. August) oder einer **Ausnahme** (ein einzelnes Datum oder ein Zeitraum wie 24. bis 26. Dezember). **Gesetzliche Feiertage** der kommenden 12 Monate stehen schon dort: Wählen Sie einen Feiertag und tragen Sie die Zeiten ein (oder lassen Sie sie leer, wenn Sie an diesem Tag geschlossen haben). Lassen Sie einen Wochentag leer, wenn Sie an diesem Tag geschlossen haben. Die Inbox-KI verwendet diese Zeiten als Bürozeiten. Etwa eine Woche vor einem gesetzlichen Feiertag sendet Tillor eine Erinnerungs-E-Mail an die **Support-Adresse** der Organisation (oder die allgemeine E-Mail-Adresse, wenn es keine Support-Adresse gibt), wenn die Zeiten für diesen Feiertag noch nicht ausgefüllt sind. Nutzen Sie Partoo, werden die Öffnungszeiten automatisch synchronisiert. Siehe [Partoo](/integraties/partoo). Eine Website kann die aufgelösten Zeiten (einschließlich Saisonbezeichnungen wie Sommer oder Winter) und kommende Feiertage über die [Öffnungszeiten-API](/ontwikkelaars/voorbeelden/opening-hours) abrufen.

## Drucken [#afdrukken]

Unter **Druck** stellen Sie PDF-Ausdrucke, Drucker-IP-Adressen und den **Druckzeitenplan** ein. Fügen Sie pro Wochentag einen oder mehrere Zeitpunkte hinzu (oder lassen Sie den Tag leer). Online-, Mandats- und Überweisungszahlungen warten auf den nächsten Zeitpunkt dieses Tages, bevor die Rechnung in die Druckwarteschlange geht.

## Apple Wallet [#apple-wallet]

Unter **Apple Wallet** stellen Sie zwei Dinge nebeneinander ein: links den **Pass-Hintergrund**, rechts den **Standort Zugangspunkt**.

**Pass-Hintergrund** (links): optionales randloses Foto für das Poster-Generic-Layout auf dem iPhone mit **iOS 27**. Laden Sie JPEG, PNG oder WebP hoch; große Dateien werden automatisch verkleinert. Ziehen Sie in der Vorschau, um zu wählen, welcher Teil des Fotos hinter dem QR-Code sichtbar bleibt. Die Vorschau zeigt Ihre Wahl sofort; erst nach **Speichern** unten bei **Einstellungen** geht das Foto (oder das Entfernen) live und Tillor sendet den Fokus an Zugangspässe mit.

Auf dem iPhone mit **iOS 26 oder älter** verwendet der Pass das klassische Generic-Layout mit denselben Daten (Status, Name des Besuchers, Gültigkeit, QR-Code). Ohne eigenes Bild erhalten alle Pässe den Tillor-Standardverlauf als Hintergrund. Mit einem eigenen Foto steht oben das **Organisationslogo** aus Ihren Firmendaten, farbig auf dem Foto. Beim Standardverlauf ist das Logo weiß auf dem dunklen Verlauf.

Auf Poster-Generic-Pässen (iOS 27) ist der QR-Code **quadratisch**; auf älteren Geräten rechteckig, wie bei einem klassischen Generic-Pass.

**Standort Zugangspunkt** (rechts): Klicken Sie auf die Karte oder ziehen Sie die Markierung, um den GPS-Punkt des Haupt-Zugangspunkts zu setzen. **Apple Wallet** und **Google Wallet** verwenden diesen Standort auf dem Zugangspass. Auf dem iPhone kann iOS den Pass auf dem Sperrbildschirm vorschlagen, wenn ein Besucher in der Nähe ist. Wählen Sie **Mitte der Parkkarte verwenden**, um die Markierung zu entfernen und den Mittelpunkt der Parkkarte zu verwenden.

Nach dem Speichern der **Einstellungen** sendet Tillor alle aktiven Wallet-Pässe in der Organisation neu (Apple per stiller Push-Nachricht, Google per Objekt-Sync). Gäste sehen die Aktualisierung meist nach dem Öffnen des Passes in der Wallet; manchmal ist noch ein manuelles Aktualisieren in der Wallet-App nötig. Die Vorschau in Tillor zeigt denselben Zuschnitt wie auf dem Pass: Ziehen Sie das Bild so, dass der Mittelpunkt an der gewünschten Stelle liegt.

<DocScreenshot src="/screenshots/gebruikers/settings-wallet-barrier-map.png" alt="Einstellungen > Apple Wallet mit Pass-Hintergrund und Zugangspunkt auf der Karte" />

Auf der Rückseite des Wallet-Passes stehen die Telefonnummer und die E-Mail-Adresse der Organisation (Support-E-Mail, falls eingestellt, sonst die allgemeine Adresse). Bei gesperrten, abgelaufenen oder zurückgezogenen Pässen erscheinen diese Daten auch hinter dem Rezeptionstext auf dem Sperrbildschirm (Apple) oder in Google Wallet.

<DocScreenshot src="/screenshots/gebruikers/settings-dialog.png" alt="Einstellungen > Allgemein" />

## Benutzerberechtigungen verwalten [#gebruikersrechten-beheren]

Unter **Benutzer** sehen Sie die **Mitglieder** Ihrer Organisation und die **Ausstehende Einladungen**. Wie Sie Kolleginnen und Kollegen einladen, entfernen und ihre Benachrichtigungen einstellen, steht unter [Benutzer einladen und Berechtigungen vergeben](/gebruikers/gebruikers-en-rechten).

### Berechtigungen bearbeiten [#rechten-bewerken]

Klicken Sie bei einem Benutzer auf **Berechtigungen bearbeiten**. Die gesamte Erklärung, auch zu Gruppen und gesperrten Berechtigungen, steht unter [Berechtigungen bearbeiten](/gebruikers/gebruikers-en-rechten#rechten-bewerken). Nachfolgend stehen die Berechtigungen, die oft Fragen aufwerfen.

### Bankkonten [#bankrekeningen]

| Berechtigung | Was darf der Benutzer? |
|---|---|
| **Banktransaktionen anzeigen** | Seite **Verwaltung > Banktransaktionen** und der Block **Bankkonto-Transaktionen** unter **Verwaltung > Zahlungsberichte** |
| **Banktransaktionen synchronisieren** | Schaltfläche **Bankkonto synchronisieren** (manueller Import) |

Die Berechtigungen stehen im Berechtigungsdialog unter der Gruppe **Banktransaktionen**.

Siehe auch [Bankkonten](/boekhouden/betalingsrapporten/betaalmethodes/ponto) für die Verknüpfung mit Open Banking.

### Zahlung zuweisen [#betaling-koppelen]

| Berechtigung | Was darf der Benutzer? |
|---|---|
| **Zahlung zuweisen** | **Zahlung zuweisen** bei einer gebuchten Rechnung, **Zuordnen** bei Zahlungsgruppen und **Rechnung zuordnen** bei Banktransaktionen (ohne Berechtigung nicht sichtbar) |

Die Berechtigung steht im Berechtigungsdialog unter der Gruppe **Zahlungen**.

### OAuth-Apps [#oauth-apps]

| Berechtigung | Was darf der Benutzer? |
|---|---|
| **OAuth-Apps autorisieren** | Dritten (z. B. Cursor, Claude, ChatGPT) per OAuth die Erlaubnis geben und bestehende OAuth-Tokens weiter verwenden |

Bestehende Benutzer behalten die Berechtigung nach der Migration. Neue Benutzer erhalten sie nicht automatisch. Haken Sie sie im Berechtigungsdialog des Benutzers an. Schalten Sie sie aus, um zu verhindern, dass dieser Benutzer neue OAuth-Apps verknüpft; bestehende Tokens dieses Benutzers enden dann ebenfalls. Benutzer mit dieser Berechtigung in mindestens einer Organisation dürfen autorisieren.

Siehe auch [MCP](/ontwikkelaars/mcp).

## Auftragsverarbeitungsvertrag [#verwerkersovereenkomst]

Erscheint statt Tillor ein Bildschirm **Auftragsverarbeitungsvertrag erforderlich**, muss Ihre Organisation den aktuellen Auftragsverarbeitungsvertrag (AVV) unterzeichnen, bevor Sie weitermachen können. Sie können das Dokument zuerst mit **AVV-Dokument herunterladen** herunterladen. Danach fordern Sie einen Verifizierungscode an. Er geht per SMS an die Telefonnummer der verantwortlichen Person. Geben Sie den Code ein und klicken Sie auf **AVV akzeptieren**.

## Daten auf Rechnungen [#gegevens-op-facturen]

Firmendaten wie Name, Adresse, USt-IdNr. und IBAN erscheinen automatisch auf Rechnungen. Sie werden beim Onboarding eingestellt. Wenden Sie sich an den Tillor-Support, um sie zu ändern.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Benutzer" href="/gebruikers" description="Kontozugang verwalten" />
  <Card title="Gruppen" href="/gebruikers/groepen" description="Kolleginnen und Kollegen bündeln, auch mit Gruppenberechtigungen" />
  <Card title="Rechnungen" href="/facturen" description="Rechnungen erstellen und versenden" />
</Cards>


# Nachweis und Gültigkeit (/de-DE/handtekeningen/bewijs-en-geldigheid)

Tillor hält bei jeder Unterzeichnung fest, wer wann und wie unterschrieben hat, und versiegelt das PDF, damit eine spätere Änderung sichtbar wird. Das Ergebnis ist eine einfache elektronische Unterschrift, geeignet für Mietverträge, Hausordnungen, Haftungsverzichte und Bedingungen. Für Dokumente, für die das Gesetz eine stärkere Unterschrift verlangt, ist Tillor nicht der richtige Ort.

## Was steht auf den Nachweisseiten? [#wat-staat-er-op-de-bewijspaginas]

Das unterschriebene PDF bekommt am Ende eine oder mehrere Seiten **Signaturnachweis**. Darauf stehen:

- der Titel des Dokuments, der Anfrage, deine Organisation, die Seitenzahl und wann die Anfrage erstellt, gesendet und abgeschlossen wurde
- zwei Fingerabdrücke der Datei: vom PDF, wie du es hochgeladen hast, und von den unterschriebenen Seiten, bevor die Nachweisseiten hinzugefügt wurden. Ändert sich ein einziges Zeichen in der Datei, stimmt der Fingerabdruck nicht mehr
- pro Unterzeichner: Name, Rolle, Art, E-Mail-Adresse, Telefonnummer und Sprache, wann der Link verschickt wurde und wann die Person die Seite zum ersten Mal geöffnet hat, den Zeitpunkt der Unterschrift, die IP-Adresse und das Gerät
- wie der Unterzeichner bestätigt wurde: mit einem Einmalcode, an welchen Kanal der Code ging und wann, oder bei Mitarbeitern als in Tillor angemeldet
- der Satz, mit dem der Unterzeichner zugestimmt hat, genau so, wie er auf dem Bildschirm stand
- was der Unterzeichner ausgefüllt hat: jedes Text-, Datums- und Ankreuzfeld mit seinem Wert, auch was leer geblieben ist
- die Unterschrift und die Paraphe, wie sie gezeichnet wurden, und auf welchen Seiten sie stehen. Eine getippte Unterschrift steht dort als Bild des getippten Namens, genau wie eine gezeichnete
- wie unterschrieben wurde: auf der Unterschriftsseite über den Link, in Tillor durch einen angemeldeten Mitarbeiter oder am Tablet an der Rezeption (mit Code oder mit einer von einem Mitarbeiter bestätigten Identität)
- der **Audit-Trail**: jeder Schritt mit Zeitpunkt, wer ihn ausgeführt hat und von welcher IP-Adresse und welchem Gerät aus. Zum Beispiel *Unterschriftslink gesendet*, *Unterschriftsseite geöffnet*, *Bestätigungscode gesendet*, *Falscher Code eingegeben*, *Unterschrieben* und *Abgeschlossen und versiegelt*

Die Zeitangaben stehen in der Zeitzone deiner Organisation, daneben die UTC-Zeit (die weltweite Standardzeit). IP-Adressen und Geräte speichert Tillor verschlüsselt. Du siehst sie in Tillor und auf den Nachweisseiten. Die Unterschriften und ausgefüllten Werte stehen im Dokument an den Stellen, die du gewählt hast. Dein ursprünglicher Upload bleibt getrennt gespeichert und ändert sich nie.

Dieselben Schritte siehst du auch auf der Seite der Anfrage unter **Verlauf** und beim Kunden unter **Ereignisse**.

<Callout type="info" title="Für technisch Interessierte">
Die beiden Fingerabdrücke sind SHA-256-Prüfsummen. Ein SHA-256-Fingerabdruck ändert sich vollständig, sobald sich nur ein Byte einer Datei ändert, deshalb beweist er, dass die Datei nicht verändert wurde. Auf der Nachweisseite steht auch der Fingerabdruck des Siegelzertifikats (siehe unten).
</Callout>

## Siegel und Zeitstempel [#zegel-en-tijdstempel]

Das unterschriebene PDF wird als letzter Schritt mit einer digitalen Signatur deiner Organisation **versiegelt**, erstellt von Tillor. Öffnest du es in Adobe Reader oder einem anderen PDF-Programm, siehst du ein Signaturfenster. Ändert sich nach dem Versiegeln etwas an der Datei, meldet das Programm das.

Das Programm nennt den Unterzeichner unter Umständen **unbekannt** oder **nicht vertrauenswürdig**. Das ist normal: Das Zertifikat stammt von Tillor und nicht von einer kostenpflichtigen Zertifizierungsstelle. Welches Zertifikat es ist, steht mit seinem Fingerabdruck auf der Nachweisseite.

Das Siegel bekommt außerdem einen **Zeitstempel** von einem unabhängigen, kostenlosen Zeitstempeldienst (FreeTSA, oder DigiCert, wenn dieser nicht antwortet). Das beweist unabhängig von Tillor, wann die Datei in genau dieser Form existierte. Der Zeitpunkt steht auf der Seite der Anfrage unter **Zeitstempel**.

## Welche Art von Unterschrift [#welk-soort-handtekening]

Dies ist eine **einfache elektronische Unterschrift** nach den europäischen eIDAS-Regeln. Tillor prüft die E-Mail-Adresse oder Telefonnummer mit einem Code, hält die Zeichnung fest und bewahrt den Nachweis auf. Das passt zu Mietverträgen, Hausordnungen, Haftungsverzichten und Bedingungen.

Eine **qualifizierte** Unterschrift, zum Beispiel mit itsme oder einer eID-Karte, ist nicht möglich. Hast du ein Dokument, für das das Gesetz sie verlangt, lass es außerhalb von Tillor unterschreiben.

## Was passiert mit dem Nachweis? [#wat-gebeurt-er-met-het-bewijs]

- Das ursprüngliche PDF und das unterschriebene PDF bleiben bei den Dokumenten des Kunden. Du kannst sie archivieren, aber nicht löschen.
- Der Nachweis ist Teil des unterschriebenen PDFs. Wer eine Kopie erhalten hat, hat also auch die Nachweisseiten.
- Der Audit-Trail bleibt auf der Seite der Anfrage stehen, auch wenn die Anfrage abgelehnt, storniert oder abgelaufen ist.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Mein PDF-Programm sagt, die Unterschrift sei nicht vertrauenswürdig">
Das stimmt und ist normal. Das Siegel stammt von Tillor, nicht von einer kostenpflichtigen Zertifizierungsstelle. Wichtig ist, dass das Programm keine Änderung nach dem Versiegeln meldet. Das Zertifikat steht mit seinem Fingerabdruck auf der Nachweisseite.
</Accordion>
<Accordion title="Mein PDF-Programm meldet, das Dokument wurde nach dem Unterschreiben geändert">
Die Datei wurde nach dem Versiegeln verändert, zum Beispiel durch erneutes Speichern oder Bearbeiten. Lade das unterschriebene PDF noch einmal über die Detailseite der Anfrage oder bei den Dokumenten des Kunden herunter. Diese Datei ist unverändert.
</Accordion>
<Accordion title="Ein Kunde möchte eine qualifizierte Unterschrift mit itsme oder eID">
Das geht in Tillor nicht. Lass dieses Dokument außerhalb von Tillor unterschreiben.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="So unterschreibt jemand" href="/handtekeningen/ondertekenen" />
  <Card title="Eine Anfrage nachverfolgen" href="/handtekeningen/opvolgen" />
  <Card title="Alle Begriffe" href="/begrippen" />
</Cards>


# Unterschriften anfragen (/de-DE/handtekeningen/handtekening-vragen)

Mit einer Signaturanfrage lässt du ein PDF von einer oder mehreren Personen online unterschreiben. Du erstellst sie in zwei Teilen: Zuerst wählst du den Kunden und das PDF, danach legst du im Editor die Unterzeichner und Felder fest. Wie du danach verfolgst, wer unterschrieben hat, steht unter [Eine Anfrage nachverfolgen](/handtekeningen/opvolgen).

<Requires permission="Unterschriftsanfragen verwalten" />

Bevor du beginnst:

- Du brauchst die Berechtigung **Unterschriftsanfragen verwalten**. Hast du sie nicht, ist die Schaltfläche **Unterschriften anfragen** ausgegraut.
- Die Datei muss ein PDF sein, bis 250 MB. Einen anderen Dateityp lehnt Tillor ab mit **Das ist kein PDF. Wählen Sie eine PDF-Datei.**
- Jeder Unterzeichner braucht eine E-Mail-Adresse oder Telefonnummer, um den Link oder Code zu erhalten. Bei einem Kunden oder Kontakt trägst du diese zuerst in deren Daten ein.
- Jeder Unterzeichner braucht mindestens ein Unterschrifts- oder Paraphenfeld.

## Eine Signaturanfrage erstellen [#een-ondertekenverzoek-maken]

<Steps>
<Step>
### Starte die Anfrage [#start-het-verzoek]
Wähle, wo du beginnst.

<Tabs items={["Über Unterschriften", "Über den Kunden"]}>
<Tab value="Über Unterschriften">
Gehe zu <UIPath>Verwaltung > Unterschriften</UIPath> und klicke auf **Unterschriften anfragen**. Wähle den **Kunden**.
</Tab>
<Tab value="Über den Kunden">
Öffne den Tab **Dokumente** des Kunden und klicke auf **Unterschriften anfragen**. Der Kunde ist dann schon ausgefüllt.
</Tab>
</Tabs>

Wähle bei **Dokument** ein PDF, das schon beim Kunden liegt, oder lass **Neues PDF hochladen** stehen und ziehe das PDF in das Feld (oder klicke auf **PDF wählen**). Gib einen **Titel** ein, zum Beispiel *Mietvertrag 2027*. Lässt du ihn leer, übernimmt Tillor den Namen des Dokuments. Klicke danach auf **Weiter**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-create-dialog.png" alt="Dialog Unterschriften anfragen mit Kunde, Titel und Dokument" />

Ein hochgeladenes PDF landet bei den Dokumenten des Kunden. Tillor verändert es nie: Die Unterschriften kommen in eine separate Kopie.
</Step>
<Step>
### Füge Unterzeichner hinzu [#voeg-ondertekenaars-toe]
Klicke bei **Unterzeichner** auf **Unterzeichner hinzufügen** und wähle:

- **Kunde: [Name]**
- **Kontakt des Kunden**
- **Mitarbeiter**
- **Externe Partei**: Gib **Name**, **E-Mail-Adresse** und/oder **Handynummer** und **Sprache** ein. Mindestens eine der beiden Kontaktangaben ist nötig. Ohne E-Mail-Adresse erhält die Person den Link per SMS.

<DocScreenshot src="/screenshots/handtekeningen/signatures-add-signer-menu.png" alt="Menü Unterzeichner hinzufügen" />

<DocScreenshot src="/screenshots/handtekeningen/signatures-external-dialog.png" alt="Dialog Externe Partei hinzufügen" />

Du kannst höchstens 10 Unterzeichner hinzufügen. Sie unterschreiben von oben nach unten, und der Nächste erhält den Link erst, wenn der Vorherige unterschrieben hat. Mit **Früher unterschreiben** und **Später unterschreiben** (den Pfeilen) änderst du die Reihenfolge, mit dem Papierkorb entfernst du jemanden. Im Feld unter dem Namen trägst du optional eine **Rolle** ein, zum Beispiel *Mieter* oder *Bürge*.

Jeder Unterzeichner bekommt eine eigene Farbe. Diese Farbe siehst du bei seinen Feldern im Dokument wieder.
</Step>
<Step>
### Platziere die Felder [#plaats-de-velden]
Wähle bei **Felder für** den Unterzeichner, für den du Felder platzierst. Wähle dann die Art des Felds und tippe oder ziehe auf eine Seite des Dokuments. Ziehe ein Feld, um es zu verschieben, und ziehe die Ecke, um es größer oder kleiner zu machen.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor.png" alt="Editor mit Unterzeichnern, Felder für und den Feldarten" />

| Feld | Was der Unterzeichner tut |
| --- | --- |
| **Unterschrift** | Setzt die gezeichnete Unterschrift, indem er auf das Feld tippt |
| **Paraphe** | Setzt die gezeichnete Paraphe, indem er auf das Feld tippt |
| **Name** | Nichts: Tillor trägt den Namen des Unterzeichners ein |
| **Unterschriftsdatum** | Nichts: Tillor trägt den Tag der Unterschrift ein |
| **Text** | Tippt eine Zeile, bis 200 Zeichen, zum Beispiel ein Kennzeichen |
| **Langer Text** | Tippt einige Zeilen, bis 2.000 Zeichen, zum Beispiel eine Bemerkung |
| **Kontrollkästchen** | Hakt eine Bedingung an |
| **Datum** | Wählt ein Datum, zum Beispiel einen Anreisetag |

Klicke auf ein platziertes Feld, um es auszuwählen. Unter den Schaltflächen siehst du dann:

- **Unterzeichner**: Setzt das Feld auf den Namen eines anderen Unterzeichners, ohne es neu zu zeichnen.
- Bei **Text**, **Langer Text**, **Kontrollkästchen** und **Datum** außerdem eine **Frage oder Bezeichnung** (die sieht der Unterzeichner beim Ausfüllfeld) und **Pflichtfeld**. Ein Feld, das kein Pflichtfeld ist, darf leer bleiben.
- Das Kreuz am Feld entfernt es.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor-fields.png" alt="Letzte Seite mit den Feldern von Mieter, Mitmieter und Vermieter in ihrer jeweiligen Farbe" />

Braucht jemand auf jeder Seite eine Paraphe, nutze **Paraphe auf jeder Seite**. Tillor setzt dann auf allen Seiten ein Paraphenfeld für diesen Unterzeichner. Solange ein Unterzeichner kein Unterschrifts- oder Paraphenfeld hat, siehst du bei dieser Person **Noch kein Signaturfeld**.
</Step>
<Step>
### Lege Nachricht und Frist fest [#stel-bericht-en-termijn-in]
Unter **Anfrage** trägst du ein:

- **Titel**: so, wie die Unterzeichner ihn sehen.
- **Nachricht an die Unterzeichner**: optional, sie steht in der E-Mail und auf der Unterschriftsseite.
- **Unterschreiben bis**: das späteste Datum. Standardmäßig sind das 14 Tage nach dem Erstellen. Bis zum Ende dieses Tages kann unterschrieben werden.
- **Erinnerung nach**: nach wie vielen Tagen (1 bis 14) ein Unterzeichner, der an der Reihe ist, eine Erinnerung erhält. Standardmäßig 3 Tage.
</Step>
<Step>
### Sende die Anfrage [#verstuur-het-verzoek]
Klicke auf **Senden** und bestätige. Der erste Unterzeichner erhält den Link.

<DocScreenshot src="/screenshots/handtekeningen/signatures-send-dialog.png" alt="Bestätigung Anfrage senden?" />

Möchtest du später weitermachen, klicke auf **Entwurf speichern**. Mit dem Papierkorb daneben (**Entwurf löschen**) wirfst du die Anfrage nach Bestätigung weg. Das PDF bleibt bei den Dokumenten des Kunden.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Anfrage erhält den Status <Status tone="info">In Bearbeitung</Status>. Du findest sie beim Kunden unter **Dokumente** und unter <UIPath>Verwaltung > Unterschriften</UIPath>. Tillor meldet **An den ersten Unterzeichner gesendet**.
- Der erste Unterzeichner erhält eine E-Mail mit einem persönlichen Link oder eine SMS, wenn es nur eine Telefonnummer gibt. Jeder weitere Unterzeichner erhält den Link, sobald der Vorherige unterschrieben hat.
- Ein Unterzeichner, der an der Reihe ist und nicht reagiert, erhält nach der Anzahl Tage bei **Erinnerung nach** automatisch eine Erinnerung, höchstens 2 Mal. Selbst eine Erinnerung zu senden ist jederzeit möglich, siehe [Eine Anfrage nachverfolgen](/handtekeningen/opvolgen#een-herinnering-sturen).
- Sobald alle unterschrieben haben, wird die Anfrage <Status tone="success">Abgeschlossen</Status> und das unterschriebene PDF liegt beim Kunden.
- Ist die Frist abgelaufen, ohne dass alle unterschrieben haben, wird die Anfrage <Status tone="warning">Abgelaufen</Status>.

Möchtest du noch etwas ändern, solange noch niemand unterschrieben hat oder nur du selbst, klicke auf **Wieder bearbeiten**. Die Anfrage wird wieder ein Entwurf: Die gesendeten Links funktionieren nicht mehr, und alle unterschreiben erneut, sobald du sie wieder sendest. Hat schon jemand anderes unterschrieben, storniere die Anfrage und erstelle eine neue.

Möchtest du, dass eine Automatisierung auf eine abgeschlossene Anfrage reagiert, zum Beispiel mit einer Aufgabe? Nutze dann den Trigger **Signaturanfrage abgeschlossen**, siehe [Trigger](/automatiseringen/triggers).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Schaltfläche Unterschriften anfragen ist ausgegraut">
Dir fehlt die Berechtigung **Unterschriftsanfragen verwalten**. Bitte einen Administrator, sie unter <UIPath>Einstellungen > Benutzer</UIPath> hinzuzufügen.
</Accordion>
<Accordion title="Tillor sagt: Das ist kein PDF. Wählen Sie eine PDF-Datei.">
Du hast einen anderen Dateityp gewählt, zum Beispiel Word. Speichere das Dokument zuerst als PDF und wähle diese Datei.
</Accordion>
<Accordion title="Tillor sagt: Wählen Sie einen Kunden, oder: Laden Sie ein PDF hoch oder wählen Sie ein Dokument des Kunden">
Im ersten Bildschirm ist **Kunde** oder **Dokument** leer. Fülle beides aus und klicke erneut auf **Weiter**.
</Accordion>
<Accordion title="Ich kann nicht senden">
Tillor prüft die Anfrage, bevor sie rausgeht, und sagt, was fehlt:

- **Fügen Sie vor dem Senden mindestens einen Unterzeichner hinzu.**
- Ein Unterzeichner hat noch kein Unterschrifts- oder Paraphenfeld. Tillor wählt diese Person aus. Ziehe dann im Dokument, um ein Feld zu platzieren.
- Ein Unterzeichner hat keine E-Mail-Adresse oder Telefonnummer und kann daher keinen Link oder Code erhalten. Das gilt auch für einen Kunden oder Kontakt: Trage zuerst eine E-Mail-Adresse oder Telefonnummer in deren Daten ein. In der Liste steht bei so jemandem **Keine E-Mail-Adresse oder Telefonnummer**.
- **Geben Sie der Anfrage einen Titel.**
</Accordion>
<Accordion title="Tillor sagt: Die Anfrage konnte nicht gesendet werden">
Die Anfrage wurde möglicherweise nicht verschickt. Lade die Seite neu. Steht die Anfrage noch als <Status>Entwurf</Status>, klicke erneut auf **Senden**.
</Accordion>
<Accordion title="Tillor sagt: Der Entwurf konnte nicht gespeichert werden">
Deine Änderungen wurden nicht gespeichert. Lade die Seite neu und prüfe, was noch da ist, bevor du weitermachst.
</Accordion>
<Accordion title="Das Dokument lädt nicht im Editor">
Lade die Seite neu. Klappt es immer noch nicht, prüfe, ob die Datei ein gültiges PDF ist.
</Accordion>
<Accordion title="Ich habe ein Feld bei der falschen Person platziert">
Klicke auf das Feld und wähle bei **Unterzeichner** die richtige Person. Das Feld bleibt an seinem Platz.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Anfrage nachverfolgen" href="/handtekeningen/opvolgen" />
  <Card title="So unterschreibt jemand" href="/handtekeningen/ondertekenen" />
  <Card title="Nachweis und Gültigkeit" href="/handtekeningen/bewijs-en-geldigheid" />
</Cards>


# Übersicht (/de-DE/handtekeningen)

Mit **Unterschriften** lässt du ein PDF wie einen Mietvertrag, eine Hausordnung, einen Haftungsverzicht oder eine Bürgschaft online unterschreiben. Die Unterzeichner unterschreiben nacheinander, und du bestimmst, wo auf den Seiten jede Unterschrift, Paraphe oder jedes Ausfüllfeld steht. Wie du dabei vorgehst, steht unter [Unterschriften anfragen](/handtekeningen/handtekening-vragen).

Wenn alle unterschrieben haben, erstellt Tillor ein unterschriebenes PDF mit Nachweisseiten am Ende. Es steht danach bei den **Dokumenten** des Kunden, und jeder Unterzeichner erhält eine Kopie. Dein ursprüngliches PDF bleibt unverändert gespeichert.

<Requires permission="Unterschriftsanfragen verwalten" />

Signaturanfragen vorbereiten, senden, erinnern, zurücknehmen und stornieren erfordert die Berechtigung **Unterschriftsanfragen verwalten**, in der Gruppe **Unterschriften** unter <UIPath>Einstellungen > Benutzer</UIPath>. Hast du diese Berechtigung nicht, sind die Schaltflächen ausgegraut. Alle Benutzer deiner Organisation können Anfragen ansehen und selbst unterschreiben, wenn sie an der Reihe sind.

<Callout type="info" title="Gut zu wissen">
- Eine Anfrage hat höchstens 10 Unterzeichner und nur PDF-Dateien, bis 250 MB.
- Standardmäßig kann 14 Tage lang unterschrieben werden, bis zum Ende des letzten Tages. Du wählst selbst ein anderes Datum.
- Ein Unterzeichner, der an der Reihe ist, erhält standardmäßig nach 3 Tagen eine Erinnerung (du kannst 1 bis 14 Tage wählen), höchstens 2 automatische Erinnerungen. Diese gehen bei der täglichen Prüfung von Tillor mit raus.
- Beim Unterschreiben bestätigt der Unterzeichner mit einem 6-stelligen Code. Der Code ist 10 Minuten gültig, und nach 2 Minuten kann ein neuer angefordert werden.
- Dein ursprüngliches PDF ändert sich nie. Das Original und das unterschriebene PDF kannst du archivieren, aber nicht löschen, weil sie der Nachweis sind.
- Die Anfrage erhält den Status Abgelaufen bei der täglichen Prüfung, nicht genau in dem Moment, in dem die Frist endet.
</Callout>

## Wo findest du es [#waar-vind-je-het]

- <UIPath>Verwaltung > Unterschriften</UIPath> zeigt alle Signaturanfragen mit ihrem Status und wie viele Unterschriften schon vorhanden sind.
- Im Profil eines Kunden steht auf dem Tab **Dokumente** die Schaltfläche **Unterschriften anfragen**, darunter die **Signaturanfragen** dieses Kunden.

<DocScreenshot src="/screenshots/handtekeningen/signatures-list.png" alt="Liste der Signaturanfragen unter Verwaltung > Unterschriften" />

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Signaturanfrage gehört immer zu genau einem Kunden und einem PDF. Die Unterzeichner müssen nicht der Kunde selbst sein: Auch ein Kontakt, ein Kollege oder ein externer Partner kann unterschreiben.

```mermaid
flowchart LR
  A[PDF beim Kunden] --> B[Signaturanfrage mit Unterzeichnern und Feldern]
  B --> C[Unterzeichner 1 unterschreibt]
  C --> D[Unterzeichner 2 unterschreibt]
  D --> E[Unterschriebenes PDF mit Nachweisseiten]
  E --> F[Dokumente des Kunden]
  E --> G[Kopie für jeden Unterzeichner]
```

## Wie eine Anfrage abläuft [#hoe-een-verzoek-verloopt]

```mermaid
flowchart LR
  A[Entwurf] -->|Senden| B[In Bearbeitung]
  B -->|alle haben unterschrieben| C[Abgeschlossen]
  B -->|Unterzeichner lehnt ab| D[Abgelehnt]
  B -->|Anfrage stornieren| E[Storniert]
  B -->|Frist abgelaufen| F[Abgelaufen]
  B -->|Wieder bearbeiten| A
```

## Status [#statussen]

| Status | Bedeutung |
|---|---|
| <Status>Entwurf</Status> | Du bereitest die Anfrage noch vor. Es wurde noch nichts gesendet. |
| <Status tone="info">In Bearbeitung</Status> | Die Anfrage wurde gesendet und es wird unterschrieben. |
| <Status tone="success">Abgeschlossen</Status> | Alle haben unterschrieben und das unterschriebene PDF liegt beim Kunden. |
| <Status tone="error">Abgelehnt</Status> | Ein Unterzeichner hat abgelehnt. Die Anfrage wurde beendet. |
| <Status>Storniert</Status> | Du oder ein Kollege hat die Anfrage zurückgezogen. |
| <Status tone="warning">Abgelaufen</Status> | Es wurde nicht rechtzeitig unterschrieben. |

Pro Unterzeichner siehst du **Wartet** (noch nicht an der Reihe), **Link gesendet** (an der Reihe), **Unterschrieben** oder **Abgelehnt**.

## Wer kann unterschreiben [#wie-kan-ondertekenen]

| Art | Wie diese Person unterschreibt |
|---|---|
| **Kunde** | Über einen persönlichen Link per E-Mail oder per SMS, wenn es nur eine Telefonnummer gibt |
| **Kontakt** | Wie der Kunde, für einen Kontakt dieses Kunden |
| **Mitarbeiter** | In Tillor selbst, ohne Code |
| **Externe Partei** | Wie der Kunde, mit einem Namen und einer E-Mail-Adresse oder Telefonnummer, die du selbst einträgst |

Ein Kunde, Kontakt oder eine externe Partei kann auch am Empfang unterschreiben, auf einem Tablet mit der Tillor-App. Siehe [Am Tablet an der Rezeption](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Automatisieren [#automatiseren]

Eine Signaturanfrage kann eine [Automatisierung](/automatiseringen/triggers) starten. Mit **Signaturanfrage abgeschlossen** legst du zum Beispiel eine Aufgabe an, sobald ein Mietvertrag unterschrieben ist, mit **Signaturanfrage geändert** reagierst du auf jede Statusänderung. Dieselben Ereignisse kannst du als [Webhook](/ontwikkelaars/webhooks) an dein eigenes System senden.

<Cards>
  <Card title="Unterschriften anfragen" href="/handtekeningen/handtekening-vragen" />
  <Card title="Eine Anfrage nachverfolgen" href="/handtekeningen/opvolgen" />
  <Card title="So unterschreibt jemand" href="/handtekeningen/ondertekenen" />
  <Card title="Nachweis und Gültigkeit" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Einen Saisonkunden gewinnen" href="/praktijk/seizoensklant-binnenhalen" description="Mietvertrag unterschreiben lassen" />
</Cards>

## Begriffe [#begrippen]

- **Signaturanfrage**: der Auftrag, ein PDF unterschreiben zu lassen, mit Unterzeichnern, Feldern und einer Frist. Siehe [Signaturanfrage](/begrippen#ondertekenverzoek).
- **Unterzeichner**: jemand, der unterschreiben muss. Ein Kunde, Kontakt, Mitarbeiter oder eine externe Partei.
- **Feld**: eine Stelle im PDF, an der ein Unterzeichner unterschreibt, eine Paraphe setzt oder etwas ausfüllt.
- **Entwurf**: eine Anfrage, die du noch vorbereitest. Es wurde noch nichts gesendet.
- **Nachweisseiten**: die Seiten am Ende des unterschriebenen PDFs, auf denen steht, wer wann und wie unterschrieben hat. Siehe [Nachweisseite](/begrippen#bewijspagina).
- **Siegel**: die digitale Signatur deiner Organisation, mit der das unterschriebene PDF abgeschlossen wird. Siehe [Siegel](/begrippen#zegel).


# So unterschreibt jemand (/de-DE/handtekeningen/ondertekenen)

Diese Seite zeigt, was deine Unterzeichner erleben, damit du Fragen beantworten kannst, und wie du jemanden am Empfang auf dem Tablet unterschreiben lässt. Eine Anfrage sendest du selbst über [Unterschriften anfragen](/handtekeningen/handtekening-vragen).

Bevor du beginnst:

- Die Anfrage muss den Status <Status tone="info">In Bearbeitung</Status> haben und der Unterzeichner muss an der Reihe sein. Ist noch niemand an der Reihe, steht dort **Noch nicht an der Reihe**.
- Für das Tablet brauchst du die Berechtigung **Unterschriftsanfragen verwalten**, und die Tillor-App muss auf einem Gerät deiner Organisation online sein.
- Der Unterzeichner braucht eine Telefonnummer oder E-Mail-Adresse, denn dorthin geht der Code. Nur ein Mitarbeiter unterschreibt ohne Code.

## Am Tablet an der Rezeption [#op-de-tablet-aan-de-receptie]

Steht jemand vor dir, muss die Person den Link nicht selbst öffnen. Das geht bei einem Kunden, Kontakt oder einer externen Partei, die an der Reihe ist.

<Steps>
<Step>
### Öffne die Anfrage [#open-het-verzoek]
Gehe zu <UIPath>Verwaltung > Unterschriften</UIPath> und öffne die Anfrage, oder öffne sie über den Tab **Dokumente** des Kunden.
</Step>
<Step>
### Klicke auf Am Tablet signieren [#klik-op-op-tablet-tekenen]
Klicke bei dem Unterzeichner, der an der Reihe ist, auf **Am Tablet signieren** und wähle, wie die Identität bestätigt wird:

- **Mit Code**: Der Unterzeichner bestätigt am Tablet mit dem Code, der per SMS oder E-Mail eingeht, wie über den Link.
- **Ohne Code**: Du hast die Identität am Empfang geprüft, zum Beispiel mit einem Personalausweis. Es wird kein Code verlangt. Auf dem Nachweisblatt steht, dass die Identität von einem Mitarbeiter bestätigt wurde, und im Verlauf, wer das war.

Tillor meldet **Auf dem Tablet geöffnet**.
</Step>
<Step>
### Lass die Person unterschreiben [#laat-de-persoon-tekenen]
Das Dokument öffnet sich in der App auf dem Tablet, oben in großen Buchstaben mit dem Namen des Unterzeichners. Prüfe diesen Namen gemeinsam mit der Person vor dir. Die Schritte sind dieselben wie über den Link, siehe unten. Kurz nach dem Senden kann das Tablet noch einen Moment **Dokument wird vorbereitet** anzeigen.
</Step>
</Steps>

Nach dem Unterschreiben oder Ablehnen kehrt das Tablet nach einigen Sekunden zum Startbildschirm zurück. Bei mehreren Unterzeichnern schickst du jeden einzeln ans Tablet, sobald er an der Reihe ist. Auf dem Nachweisblatt steht, dass die Unterschrift am Tablet gesetzt wurde.

## Was tut der Unterzeichner? [#wat-doet-de-ondertekenaar]

<Tabs items={["Über den Link", "Am Tablet"]}>
<Tab value="Über den Link">
Der Unterzeichner erhält eine E-Mail oder eine SMS, wenn es nur eine Telefonnummer gibt. Sie enthält einen persönlichen Link zur Unterschriftsseite, mit deiner Nachricht und dem Namen deiner Organisation. Die Seite funktioniert auf Telefon, Tablet und Computer, in der Sprache des Unterzeichners.
</Tab>
<Tab value="Am Tablet">
Der Unterzeichner sieht das Dokument direkt in der App, nachdem du **Am Tablet signieren** gewählt hast. Es ist kein Link und keine E-Mail nötig. Wer am Tablet mit Code unterschreibt, erhält den Code auf dem eigenen Telefon oder per E-Mail.
</Tab>
</Tabs>

Danach sind die Schritte gleich.

<Steps>
<Step>
### Beginnen [#beginnen]
Auf der ersten Karte steht, wer sonst noch unterschreibt, die Position in der Reihe (zum Beispiel *Unterzeichner 2 von 3*) und die Schritte. Rechts steht das Dokument, mit den Unterschriften früherer Unterzeichner schon an ihrem Platz. Mit **Mit dem Unterschreiben beginnen** startet der Unterzeichner. Jeder Schritt hat eine Zurück-Schaltfläche. Auch die Zurück-Taste des Telefons funktioniert.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-start.png" alt="Unterschriftsseite für den Bürgen mit der Startkarte und dem Dokument" />
</Step>
<Step>
### Unterschrift zeichnen [#teken-je-handtekening]
Der Unterzeichner zeichnet eine **Unterschrift** mit dem Finger oder der Maus oder wählt **Tippen** und tippt seinen vollständigen Namen. Tillor setzt diesen getippten Namen dann in eine handschriftliche Schrift. Gibt es Paraphenfelder, folgt auf dieselbe Weise eine **Paraphe** (gezeichnete oder getippte Initialen). Mit **Löschen** beginnt der Unterzeichner von vorn. Der Wechsel zwischen **Zeichnen** und **Tippen** leert das Feld.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-type.png" alt="Schritt Unterschrift zeichnen mit gewähltem Tippen" />
</Step>
<Step>
### Unterschrift platzieren [#plaats-je-handtekening]
Der Unterzeichner tippt im Dokument auf jedes markierte Feld (**Zum Unterschreiben klicken** oder **Zum Paraphieren klicken**). **Nächstes Feld** springt zum nächsten leeren Feld. Mit **Vorheriges Feld** und **Nächstes Feld** geht der Unterzeichner alle Felder durch. Ein zweites Tippen auf ein gefülltes Feld bewirkt nichts.
</Step>
<Step>
### Angaben ausfüllen [#vul-je-gegevens-in]
Nur wenn du Ausfüllfelder platziert hast: Text, Datum oder ein Häkchen. Bei jedem Feld steht **Pflicht** oder **optional**. Ein leeres Pflichtfeld hält den Schritt auf. Was getippt wird, erscheint sofort im Dokument. Name und Unterschriftsdatum trägt Tillor selbst ein.
</Step>
<Step>
### Bestätigen und unterschreiben [#bevestig-en-onderteken]
Der Unterzeichner hakt an, das Dokument gelesen zu haben. Fehlt noch etwas, steht dort eine Liste mit Schaltflächen, die zu diesem Schritt führen.

Erst wenn alles fertig ist, lässt der Unterzeichner mit **Bestätigungscode senden** einen 6-stelligen Code schicken: per SMS, wenn es eine Telefonnummer gibt, sonst per E-Mail. Der Code ist 10 Minuten gültig. Kommt er nicht an, kann nach 2 Minuten **Code erneut senden** gewählt werden. Danach klickt der Unterzeichner selbst auf **Unterschreiben**. Es wird nie von selbst unterschrieben.
</Step>
</Steps>

## Was siehst du danach? [#wat-zie-je-daarna]

- Ist noch niemand an der Reihe, steht dort **Noch nicht an der Reihe**, und eine Nachricht folgt, sobald es soweit ist.
- Wer schon unterschrieben hat, sieht **Sie haben unterschrieben**, bis die anderen fertig sind.
- Sobald alle unterschrieben haben, kann jeder Unterzeichner über denselben Link das unterschriebene PDF herunterladen (**Von allen unterschrieben**).
- Bei einer zurückgezogenen Anfrage sieht der Unterzeichner **Anfrage zurückgezogen**, bei einer abgelaufenen **Frist abgelaufen** und bei einer abgelehnten **Unterzeichnung gestoppt**.
- Ein Mitarbeiter unterschreibt in Tillor, über die Schaltfläche **Jetzt unterschreiben** auf der Detailseite oder über den Link in der Nachricht. Ein Code ist nicht nötig, weil diese Person schon angemeldet ist. Auch hier kann die Unterschrift gezeichnet oder getippt werden.

## Ablehnen [#weigeren]

Mit **Unterschrift ablehnen** kann ein Unterzeichner die Anfrage ablehnen und optional einen Grund angeben (bis 500 Zeichen). Die Anfrage wird dann beendet, niemand sonst wird mehr gefragt, und wer die Anfrage erstellt hat, erhält eine Nachricht. Siehe [Eine Anfrage nachverfolgen](/handtekeningen/opvolgen#wat-gebeurt-er-daarna).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Schaltfläche Am Tablet signieren fehlt">
Die Schaltfläche erscheint nur, wenn die Tillor-App auf einem Gerät deiner Organisation in den letzten Minuten Kontakt mit Tillor hatte, und nur bei einem Kunden, Kontakt oder einer externen Partei, die an der Reihe ist. Öffne die App auf dem Tablet, warte kurz und lade die Seite neu. Prüfe außerdem, dass **Belege und Dokumente anzeigen** in den [Geräteeinstellungen](/mobiele-app/toestelinstellingen#kassabonnen-en-geluid) eingeschaltet ist. Siehe auch [Tablets und Kioske](/mobiele-app/tablets-en-kiosken).
</Accordion>
<Accordion title="Tillor sagt: Konnte auf dem Tablet nicht geöffnet werden">
Tillor konnte kein Tablet erreichen, das Dokumente anzeigt. Prüfe, ob die App geöffnet ist und das Gerät eine Verbindung hat, und versuche es erneut.
</Accordion>
<Accordion title="Der Unterzeichner erhält keinen Code">
Der Code geht an die Telefonnummer, oder an die E-Mail-Adresse, wenn es keine Telefonnummer gibt. Lass den Unterzeichner den Spam-Ordner prüfen und nach 2 Minuten **Code erneut senden** nutzen. Stimmt die Nummer oder Adresse nicht, ändere sie beim Kunden oder Kontakt und sende eine Erinnerung. Bei einer externen Partei stornierst du die Anfrage und erstellst eine neue mit den richtigen Angaben.
</Accordion>
<Accordion title="Tillor sagt: Der Code konnte nicht geprüft werden">
Der eingegebene Code stimmt nicht oder ist abgelaufen. Ein Code ist 10 Minuten gültig. Der Unterzeichner fordert mit **Code erneut senden** einen neuen an und gibt ihn ein. Jeder falsche Versuch steht im Verlauf als **Falscher Code eingegeben**.
</Accordion>
<Accordion title="Der Unterzeichner kann nicht auf Unterschreiben klicken">
Es fehlt noch etwas. Unter **Noch zu tun, bevor Sie unterschreiben können** steht, was noch fehlt: die Unterschrift oder Paraphe zeichnen, noch auf ein Feld tippen oder ein Pflichtfeld ausfüllen. Auch das Häkchen, dass das Dokument gelesen wurde, muss gesetzt sein.
</Accordion>
<Accordion title="Der Link funktioniert nicht mehr">
Wurde die Anfrage auf Entwurf zurückgesetzt, storniert oder ist sie abgelaufen, funktioniert der alte Link nicht mehr. Nach erneutem Senden erhält der Unterzeichner einen neuen Link. Bei einer stornierten oder abgelaufenen Anfrage musst du eine neue erstellen.
</Accordion>
<Accordion title="Der Unterzeichner sieht: Diese Anfrage hat sich inzwischen geändert">
Die Seite war schon geöffnet, während sich die Anfrage änderte, zum Beispiel weil sie schon unterschrieben ist. Die Seite zeigt jetzt den aktuellen Stand. Es ist nichts schiefgegangen.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Anfrage nachverfolgen" href="/handtekeningen/opvolgen" />
  <Card title="Nachweis und Gültigkeit" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Tablets und Kioske" href="/mobiele-app/tablets-en-kiosken" />
</Cards>


# Eine Anfrage nachverfolgen (/de-DE/handtekeningen/opvolgen)

Nach dem Senden verfolgst du eine Signaturanfrage auf der Detailseite: wer schon unterschrieben hat, wer an der Reihe ist und was du noch tun kannst. Hier sendest du auch eine Erinnerung, stornierst eine Anfrage und lädst das unterschriebene PDF herunter.

Bevor du beginnst:

- Ansehen kann jeder. Erinnern, stornieren, zurücksetzen und ans Tablet schicken erfordert die Berechtigung **Unterschriftsanfragen verwalten**. Ohne diese Berechtigung sind die Schaltflächen ausgegraut.
- Die Anfrage muss gesendet sein. Einen <Status>Entwurf</Status> bearbeitest du im Editor, siehe [Unterschriften anfragen](/handtekeningen/handtekening-vragen).

## Die Anfrage öffnen [#het-verzoek-openen]

Öffne <UIPath>Verwaltung > Unterschriften</UIPath>. Die Liste zeigt pro Anfrage den **Titel**, den **Kunden**, den **Status**, wie viele schon **Unterschrieben** haben, wann sie **Erstellt** wurde und bis wann unterschrieben werden darf (**Unterschreiben bis**). Suche nach Titel oder Kundenname, oder filtere mit **Status** zum Beispiel nur die Anfragen, die noch in Bearbeitung sind. Klicke auf eine Anfrage, um sie zu öffnen.

Dieselben Anfragen stehen auch beim Kunden, auf dem Tab **Dokumente** unter **Signaturanfragen**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-customer-documents.png" alt="Tab Dokumente eines Kunden mit dem unterschriebenen PDF und den Signaturanfragen" />

## Die Detailseite [#de-detailpagina]

Links siehst du die Daten der Anfrage, die Unterzeichner in Reihenfolge und den **Verlauf**. Rechts steht das Dokument, mit den Unterschriften, die schon gesetzt wurden. Oben steht, auf wen die Anfrage wartet, zum Beispiel *Wartet auf die Unterschrift von Marc Janssens.*

Pro Unterzeichner siehst du, ob er noch warten muss (**Wartet**), den Link erhalten hat (**Link gesendet**), **Unterschrieben** oder **Abgelehnt** hat, mit dem Zeitpunkt. Die Seite aktualisiert sich selbst, wenn jemand unterschreibt.

### Vorher und nachher: von In Bearbeitung zu Abgeschlossen [#voor-en-na-van-bezig-naar-afgerond]

So sieht dieselbe Art von Anfrage beim Unterschreiben und danach aus. Zuerst steht sie auf <Status tone="info">In Bearbeitung</Status>: Der Mieter hat unterschrieben und der Bürge ist an der Reihe.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-in-progress.png" alt="Vorher: Anfrage in Bearbeitung, der Mieter hat unterschrieben und der Bürge ist an der Reihe" />

Sobald der letzte Unterzeichner unterschrieben hat, steht sie auf <Status tone="success">Abgeschlossen</Status>. Alle Unterschriften stehen im Dokument, der Verlauf ist ergänzt und oben steht die Schaltfläche zum Herunterladen des unterschriebenen PDFs.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-completed.png" alt="Nachher: abgeschlossene Anfrage mit den Unterschriften im Dokument und dem Verlauf" />

## Eine Erinnerung senden [#een-herinnering-sturen]

Klicke bei einem Unterzeichner, der an der Reihe ist, auf **Erinnerung senden**. Diese Person erhält denselben Link noch einmal, und Tillor meldet **Der Link wurde erneut gesendet**. Der Link aus der ersten Nachricht funktioniert ebenfalls weiter. Die Schaltfläche steht nicht bei Mitarbeitern, die in Tillor unterschreiben, und auch nicht bei Unterzeichnern, die noch warten müssen.

Außerdem sendet Tillor selbst Erinnerungen. Ein Unterzeichner, der an der Reihe ist, erhält nach der Anzahl Tage, die du bei **Erinnerung nach** eingestellt hast (standardmäßig 3), eine Erinnerung, gezählt ab der ersten Nachricht oder der vorherigen Erinnerung. Das geschieht höchstens 2 Mal pro Unterzeichner und bei der täglichen Prüfung von Tillor. Eine Erinnerung kann also bis zu einen Tag später ankommen als die Anzahl Tage, die du eingestellt hast.

## Am Tablet unterschreiben lassen [#laten-tekenen-op-de-tablet]

Steht der Unterzeichner am Empfang, klickst du bei dieser Person auf **Am Tablet signieren**. Wie das funktioniert und warum die Schaltfläche manchmal fehlt, liest du unter [Am Tablet an der Rezeption](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Selbst als Mitarbeiter unterschreiben [#zelf-ondertekenen-als-medewerker]

Ist ein Kollege oder du selbst an der Reihe, erhält diese Person eine Nachricht mit einem Link zu Tillor. Auf der Detailseite steht dann die Schaltfläche **Jetzt unterschreiben**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-staff-turn.png" alt="Anfrage, bei der der Mitarbeiter an der Reihe ist, mit der Schaltfläche Jetzt unterschreiben" />

## Eine Anfrage stornieren [#een-verzoek-annuleren]

Klicke auf **Anfrage stornieren** und bestätige. Die Unterschriftslinks funktionieren dann nicht mehr, und bereits gesetzte Unterschriften werden nicht verwendet. Möchtest du doch weitermachen, klicke auf **Behalten**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-cancel-dialog.png" alt="Bestätigung Diese Anfrage stornieren?" />

Stornieren geht nur, solange die Anfrage <Status tone="info">In Bearbeitung</Status> ist. Eine abgeschlossene, abgelehnte oder abgelaufene Anfrage steht fest.

## Wieder bearbeiten [#terug-naar-bewerken]

Hat noch niemand unterschrieben, oder nur du selbst, steht auf der Detailseite **Wieder bearbeiten**. Die Anfrage wird wieder ein Entwurf, gesendete Links funktionieren nicht mehr und alle unterschreiben nach dem Senden erneut. Hat ein anderer schon unterschrieben, fehlt die Schaltfläche. Storniere dann die Anfrage und erstelle eine neue.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- **Jemand unterschreibt**: Der Unterzeichner erhält den Status **Unterschrieben** und der Nächste erhält den Link. Die Seite aktualisiert sich von selbst.
- **Alle haben unterschrieben**: Du siehst kurz *Alle haben unterschrieben. Das unterschriebene PDF wird erstellt.* Die Anfrage wird <Status tone="success">Abgeschlossen</Status>. Das unterschriebene PDF steht als **[Titel] (unterschrieben)** bei den **Dokumenten** des Kunden, mit demselben Dokumenttyp wie das ursprüngliche PDF. Hatte dieses keinen Typ, erhält es den Typ **Unterschriebene Vereinbarung**. Jeder Unterzeichner erhält eine Kopie.
- **Jemand lehnt ab**: Die Anfrage wird mit dem Status <Status tone="error">Abgelehnt</Status> beendet. Wer die Anfrage erstellt hat, erhält eine Meldung, und die übrigen Unterzeichner werden nicht mehr gefragt. Beim Unterzeichner steht der Grund, wenn er angegeben wurde.
- **Du stornierst**: Die Anfrage erhält den Status <Status>Storniert</Status> und die Links funktionieren nicht mehr.
- **Die Frist ist abgelaufen**: Nach dem Tag bei **Unterschreiben bis** kann niemand mehr unterschreiben. Tillor setzt die Anfrage bei der täglichen Prüfung auf <Status tone="warning">Abgelaufen</Status>. Bis zu dieser Prüfung siehst du auf der Detailseite, dass die Frist abgelaufen ist. Möchtest du, dass noch jemand unterschreibt, erstelle eine neue Anfrage.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-declined.png" alt="Abgelehnte Anfrage mit dem Grund des Kunden" />

## Das unterschriebene PDF [#de-ondertekende-pdf]

Auf der Detailseite lädst du das PDF mit **Unterschriebenes PDF herunterladen** herunter, unter dem Verlauf. Dort steht auch der **Zeitstempel**, siehe [Nachweis und Gültigkeit](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

Per E-Mail hängt das PDF als Anhang an der Nachricht an den Unterzeichner. Klappt das nicht, steht dort eine Schaltfläche zum Herunterladen. Wer nur eine Telefonnummer hat, erhält eine SMS mit einem Link.

Das unterschriebene PDF und das ursprüngliche PDF sind der Nachweis der Unterzeichnung. Du kannst sie deshalb nicht löschen, aber archivieren.

## Verlauf und Ereignisse [#verloop-en-gebeurtenissen]

Unter **Verlauf** steht jeder Schritt mit Zeitpunkt und wer ihn ausgeführt hat: erstellt, gesendet, Link gesendet, Seite geöffnet, Code gesendet, falscher Code, unterschrieben, abgelehnt, zurückgesetzt, storniert, abgelaufen und abgeschlossen. Dieselbe Zeile steht beim Kunden auf dem Tab **Ereignisse** und im [Aktivitätsprotokoll](/activiteitenlog).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe die Schaltfläche Erinnerung senden nicht">
Die Schaltfläche steht nur bei einem Unterzeichner mit dem Status **Link gesendet**, also bei dem, der an der Reihe ist. Bei einem Mitarbeiter steht sie nie, denn der unterschreibt in Tillor. Steht sie da, ist aber ausgegraut, fehlt dir die Berechtigung **Unterschriftsanfragen verwalten**.
</Accordion>
<Accordion title="Tillor sagt: Die Erinnerung konnte nicht gesendet werden">
Versuche es erneut. Bleibt es erfolglos, prüfe die E-Mail-Adresse und Telefonnummer des Unterzeichners. Bei einem Kunden oder Kontakt passt du diese in deren Daten an. Bei einer externen Partei stornierst du die Anfrage und erstellst eine neue mit den richtigen Angaben.
</Accordion>
<Accordion title="Die Schaltfläche Wieder bearbeiten fehlt">
Es hat schon jemand anderes als du selbst unterschrieben. Dann kann die Anfrage nicht mehr zu einem Entwurf zurück. Storniere die Anfrage mit **Anfrage stornieren** und erstelle eine neue.
</Accordion>
<Accordion title="Tillor sagt: Die Anfrage konnte nicht storniert werden">
Stornieren geht nur bei einer Anfrage, die <Status tone="info">In Bearbeitung</Status> ist. Lade die Seite neu und sieh nach, welchen Status sie jetzt hat. Eine abgeschlossene, abgelehnte oder abgelaufene Anfrage kannst du nicht mehr stornieren.
</Accordion>
<Accordion title="Die Anfrage steht noch auf In Bearbeitung, aber die Frist ist abgelaufen">
Du siehst *Die Frist ist abgelaufen; die Anfrage läuft bei der nächsten täglichen Prüfung ab.* Niemand kann jetzt noch unterschreiben. Sobald die Prüfung gelaufen ist, steht die Anfrage auf <Status tone="warning">Abgelaufen</Status>.
</Accordion>
<Accordion title="Ich sehe Alle haben unterschrieben, aber noch kein unterschriebenes PDF">
Tillor erstellt das PDF noch. Lade die Seite nach einigen Minuten neu. Sobald es fertig ist, liegt es bei den Dokumenten des Kunden und **Unterschriebenes PDF herunterladen** erscheint. Ist es nach einer Viertelstunde noch nicht fertig, versucht Tillor es bei der nächsten täglichen Prüfung erneut.
</Accordion>
<Accordion title="Ich kann das Dokument oder das unterschriebene PDF nicht löschen">
Das ist so gewollt. Das ursprüngliche PDF und das unterschriebene PDF sind der Nachweis. Du kannst sie aber archivieren.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="So unterschreibt jemand" href="/handtekeningen/ondertekenen" />
  <Card title="Nachweis und Gültigkeit" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Dokumente" href="/documenten" />
</Cards>


# Identitätsscans (/de-DE/identiteitsscans)

Mit einem Ausweisleser scannst du Reisepässe, Personalausweise, Führerscheine, Visa und Aufenthaltsdokumente. Tillor erkennt den Dokumenttyp, liest die Daten aus und legt damit schnell einen Kunden an, ohne dass du alles abtippst. Der Leser sendet den Scan über den [Tillor-Connector](/connector) in deinem lokalen Netzwerk an deine Organisation. Wie du danach einen Kunden anlegst, steht unter [Kunden aus einem Scan anlegen](#klant-aanmaken-vanuit-een-scan).

<Callout type="info" title="Gut zu wissen">
- Einen Scan ohne zugeordneten Kunden löscht Tillor automatisch nach 7 Tagen, zusammen mit den zugehörigen Dateien.
- Ein zugeordneter Scan bleibt gespeichert, bis du ihn trennst oder löschst. Die Aufbewahrungsfrist bestimmst du.
- Einen Kunden auf Basis eines Scans anzulegen erfordert mindestens einen Vornamen im Scan.
- Gibt es schon einen Kunden mit derselben Nationalregisternummer, ordnest du den Scan diesem Kunden zu, statt einen doppelten anzulegen.
- Scandateien werden verschlüsselt gespeichert. Auf den Seitenbildern steht ein Wasserzeichen **Not valid as ID**. Das Porträt bleibt ohne Wasserzeichen.
- Der Connector lauscht standardmäßig auf Port 8765.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  subgraph lokaal[Lokales Netzwerk]
    R[Ausweisleser]
    C[Tillor-Connector]
  end
  T[Ausstehender Scan in Tillor]
  K[Kunde oder Kontakt]
  R --> C
  C --> T
  T -->|Kunde anlegen oder zuordnen| K
  T -->|Nach 7 Tagen nicht zugeordnet| X[Automatisch gelöscht]
```

Ein Scan beginnt als ausstehender Scan. Ordnest du ihn einem Kunden oder Kontakt zu, bleibt er bei diesem Kunden gespeichert.

## Kunden aus einem Scan anlegen [#klant-aanmaken-vanuit-een-scan]

Bevor du beginnst:

- Der Scan muss in Tillor als ausstehender Scan stehen. Steht er nicht dort, siehe Probleme am Ende.
- Der Scan braucht einen Vornamen.

<Steps>
<Step>
### Öffne die Kundenliste [#open-de-klantenlijst]
Gehe zu <UIPath>Kunden > Übersicht</UIPath> und klicke auf **Neuen Kunden anlegen**. Solange es ausstehende Scans gibt, zeigt die Schaltfläche ein Menü: Wähle **Manuell** oder einen Scan aus der Liste.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Neuen Kunden anlegen - Menü mit ausstehendem Identitätsscan" />
</Step>
<Step>
### Prüfe den Scan [#controleer-de-scan]
Nach der Wahl eines Scans öffnet sich eine Bestätigung mit einer Vorschau des Dokuments und den Daten aus der maschinenlesbaren Zone. Klicke auf **Kunden anlegen**.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Bestätigung nach Wahl eines ausstehenden Scans mit Dokumentvorschau" />
</Step>
</Steps>

Derselbe Weg funktioniert über **Reservierung starten** (**Neuer Kunde…**) und über das Feld unten rechts mit **Kunden auf Basis dieses Scans anlegen**.

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Feld unten rechts - ausstehender Identitätsscan mit Dokumentvorschau" />

### Was passiert danach? [#wat-gebeurt-er-daarna]

- Tillor legt den Kunden an, ordnet den Scan zu und füllt, wo möglich, Vorname, Nachname, Geburtsdatum, Adresse und weitere Felder aus.
- Du landest im neuen Kundenprofil.
- Der Scan steht nicht mehr in der Warteschlange und bleibt beim Kunden gespeichert.
- Die Zuordnung steht auf dem Tab **Ereignisse** des Kunden.

## Einem bestehenden Kunden oder Kontakt zuordnen [#koppelen-aan-een-bestaande-klant-of-contactpersoon]

Neben einem neuen Kunden kannst du einen Scan auch einem bestehenden Kunden oder Kontakt zuordnen.

<Tabs items={["Einem Kunden", "Einem Kontakt"]}>
<Tab value="Einem Kunden">
Im Kundenprofil erscheint eine gestrichelte Karte **Ausstehenden Identitätsscan zuordnen**, solange es passende ausstehende Scans gibt. Wähle einen Scan mit **Scan wählen…** und klicke auf **Diesem Kunden zuordnen**.
</Tab>
<Tab value="Einem Kontakt">
Auf der Karte eines Kontakts kannst du einen Scan zuordnen, der noch keinen Kontakt hat und mindestens einen Vornamen enthält, mit **Mit Kontakt verknüpfen**. Du kannst auch einen neuen Kontakt anlegen lassen mit **Kontakt aus Scan anlegen**.
</Tab>
</Tabs>

Nach dem Zuordnen ergänzt Tillor die Daten des Kunden oder Kontakts, wo möglich. Als Vorname übernimmt Tillor nur den ersten Vornamensteil, zum Beispiel `Andy` aus `Andy Adhemar R`. Auf dem Scan bleiben alle Vornamen sichtbar.

## Einen Scan trennen, exportieren oder löschen [#een-scan-ontkoppelen-exporteren-of-verwijderen]

Bei einem zugeordneten Scan gibt es die Aktionen **Herunterladen**, **PDF exportieren**, **Scan entkoppeln** und **Scan löschen**. Löschen entfernt den Scan und alle verschlüsselten Dateien dauerhaft und kann nicht rückgängig gemacht werden.

## Aufbewahrungsfrist und deine Verantwortung [#bewaartermijn-en-jouw-verantwoordelijkheid]

<Callout type="warn" title="7 Tage für ausstehende Scans">
Scans, die noch keinem Kunden zugeordnet sind, löscht Tillor automatisch nach 7 Tagen (den Scan und die zugehörigen Dateien). Ordne ausstehende Scans rechtzeitig zu oder verarbeite sie über **Neuen Kunden anlegen**, das Feld unten rechts oder die gestrichelte Karte in einem Kundenprofil.
</Callout>

Für zugeordnete Scans gilt eine andere Regel: Sie bleiben gespeichert, bis deine Organisation sie trennt oder löscht. Du bestimmst, ob, wann und auf welcher Rechtsgrundlage Ausweisdokumente gescannt werden und wie lange zugeordnete Scans nötig sind. Tillor verarbeitet die Scans als Auftragsverarbeiter nach deiner Weisung. Die Einhaltung des Datenschutzrechts, die Aufbewahrungsfristen für zugeordnete Scans und das rechtzeitige Löschen, wenn die Speicherung nicht mehr nötig ist, liegen in deiner Verantwortung als Verantwortlicher.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Es kommt kein Scan in Tillor an">
Prüfe am Leser die IP-Adresse des Connectors und Port 8765 und ob der Connector läuft. Siehe [Connector](/connector).
</Accordion>
<Accordion title="Der Scan steht nicht im Menü oder im Feld">
Nur Scans ohne zugeordneten Kunden zählen als ausstehend. Ist der Scan schon zugeordnet oder älter als 7 Tage und damit gelöscht, steht er nicht mehr dort.
</Accordion>
<Accordion title="Kunden auf Basis dieses Scans anlegen ist ausgegraut">
Beim Scan steht der Grund. Hat der Scan keinen Vornamen, steht dort *trage ihn am Scanner ein oder ordne diesen Scan manuell zu*. Ist das Dokument noch gültig und gibt es schon einen Kunden mit dieser Nationalregisternummer, öffne den vorgeschlagenen Kunden oben auf der Karte oder ordne den Scan diesem Kunden zu.
</Accordion>
<Accordion title="Tillor sagt: Kunde konnte aus diesem Scan nicht angelegt werden">
Der Kunde wurde nicht angelegt und der Scan bleibt ausstehend. Versuche es erneut. Klappt es nicht, lege den Kunden manuell an und ordne den Scan mit **Kunde zuordnen** zu.
</Accordion>
<Accordion title="Tillor sagt: Scan konnte nicht mit dem Kunden verknüpft werden">
Versuche es erneut, oder nutze das Feld unten rechts.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Identitätsscan**: die gelesenen Daten und Bilder eines Ausweisdokuments.
- **Ausstehender Scan**: ein Scan, der noch keinem Kunden zugeordnet ist und nach 7 Tagen verschwindet.
- **Maschinenlesbare Zone (MRZ)**: die Zeilen mit Buchstaben und Ziffern am unteren Rand des Dokuments, die der Leser ausliest.
- **Connector**: das Kästchen in deinem lokalen Netzwerk, das Scans an Tillor weiterleitet. Siehe [Connector](/begrippen#connector).
- **Kunde**: der Datensatz in Tillor. Siehe [Kunde](/begrippen#klant).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Kunden anlegen, einschließlich des Wegs über einen Scan" />
  <Card title="Connector" href="/connector" description="Das Connector-Kästchen in deinem Park" />
  <Card title="Praxisbeispiele" href="/praktijk" />
</Cards>


# Gespräche lesen und beantworten (/de-DE/inbox/gesprekken)

Im Posteingang stehen alle Gespräche Ihrer verbundenen Kanäle beisammen. Hier lesen Sie sie, antworten und räumen auf. Wie Sie einen Kanal verbinden, steht unter [Posteingang](/inbox).

Bevor Sie beginnen:

- Sie benötigen die Berechtigung **Posteingang anzeigen**, um Gespräche zu lesen, und **Posteingang verwalten**, um zu antworten oder zu archivieren. Ohne **Posteingang anzeigen** erscheint der Posteingang nicht in der Seitenleiste.
- Mindestens ein Kanal muss verbunden sein. Sonst sehen Sie einen Link zu <UIPath>Einstellungen > Integrationen</UIPath>.

<Requires permission="Inbox bekijken" />

## Den Posteingang öffnen [#de-inbox-openen]

<Steps>
<Step>
### Zum Posteingang gehen [#ga-naar-de-inbox]
Wählen Sie in der Seitenleiste unter **Support** den Eintrag **Posteingang** (Markierung **1** im Screenshot). Ist noch kein Kanal verbunden, zeigt Tillor einen Link zu <UIPath>Einstellungen > Integrationen</UIPath>.
</Step>
<Step>
### Ein Gespräch auswählen [#kies-een-gesprek]
Links steht die Liste **Gespräche** mit den Threads aller Kanäle. Mit **Offen** und **Archiviert** wechseln Sie zwischen aktiven und erledigten Gesprächen. Klicken Sie ein Gespräch an, um es rechts zu öffnen.
</Step>
</Steps>

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-overview.png" alt="Posteingang - Gesprächsliste mit Demo-Gesprächen und leerer Detailspalte" />

Ein geöffnetes Gespräch zeigt die Nachrichten der Reihe nach mit Name und Uhrzeit. Unten steht das Antwortfeld (Markierung **2** im Beispiel).

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-whatsapp.png" alt="Posteingang - WhatsApp-Gespräch mit Antwortfeld" />

Der Hintergrund eines Gesprächs folgt dem Kanal: beige für WhatsApp, blaue Sprechblasen für Messenger, rosa für Instagram und hellgrau für Website-Chat.

## Eine Antwort senden [#een-antwoord-sturen]

<Requires permission="Inbox beheren" />

<Steps>
<Step>
### Das Gespräch öffnen [#open-het-gesprek]
Klicken Sie das Gespräch in der Liste an.
</Step>
<Step>
### Ihre Antwort eingeben [#typ-je-antwoord]
Tippen Sie unten in das Antwortfeld.
</Step>
<Step>
### Senden [#verstuur]
Klicken Sie auf **Senden** oder drücken Sie **Strg+Enter**.
</Step>
</Steps>

Bei Ihren eigenen Nachrichten steht neben der Uhrzeit ein Haken für gesendet, ein doppelter Haken für zugestellt und ein blauer doppelter Haken für gelesen. Antworten, die Sie über die WhatsApp-Business-App oder die Messenger-App senden, erscheinen ebenfalls im Gespräch, solange die Integration aktiv ist.

Eine Nachricht, die Sie selbst gesendet haben, können Sie nicht bearbeiten. Die Kanäle bieten dafür keine Möglichkeit. Bei Messenger und Instagram steht neben einer eigenen Textnachricht eine Löschen-Schaltfläche. Sie blendet die Nachricht nur in Tillor aus; der Kunde behält die Nachricht in seiner eigenen App.

Eingehende Messenger-Fotos werden gespeichert und im Gespräch angezeigt; in der Liste steht dann ein Foto-Symbol statt Text. Emoji-Reaktionen auf Messenger-Nachrichten erscheinen als Zähler unter der Nachricht.

### WhatsApp und das 24-Stunden-Antwortfenster [#whatsapp-en-het-antwoordvenster-van-24-uur]

Ein Kunde, der Ihnen auf WhatsApp eine Nachricht schickt, öffnet ein kostenloses Antwortfenster von 24 Stunden. Tillor zeigt **Kostenloses Antwortfenster offen** mit einem Countdown. Ist das Fenster geschlossen, erscheint **24-Stunden-Fenster geschlossen** und Ihre Antwort geht als kostenpflichtige WhatsApp-Vorlage hinaus, bis der Kunde wieder schreibt.

- Ist für Ihr WhatsApp-Business-Konto im Meta WhatsApp Manager keine Zahlungsmethode hinterlegt, blockiert Tillor kostenpflichtige Antworten. Kostenlose Antworten innerhalb des Fensters sind weiterhin möglich.
- Hat Meta die Vorlage in der Sprache Ihrer Organisation noch nicht freigegeben, wartet Ihre Antwort. Das dauert meist einige Minuten und kann bis zu 48 Stunden dauern.

## Wie geht es danach weiter? [#wat-gebeurt-er-daarna]

- Ihre Antwort steht im Gespräch mit einem Haken: gesendet, zugestellt oder gelesen. Gelingt die Zustellung nicht, steht dort **Nicht zugestellt**.
- Ein archiviertes Gespräch verschwindet aus **Offen**. Schreibt der Kunde erneut, erscheint das Gespräch wieder.
- Das Gespräch steht auch beim Kunden, unter <UIPath>Kunden > Kunde > Kommunikation</UIPath>.

## Gespräche wiederfinden und aufräumen [#gesprekken-terugvinden-en-opruimen]

- **Suchen**: Filtern Sie Threads nach Name oder Telefonnummer, innerhalb von **Offen** oder **Archiviert**.
- **Ungelesen**: In **Offen** stehen ungelesene Gespräche fett, mit einem roten Punkt. Klicken Sie oben in der Liste auf **Alle als gelesen markieren**, um alle auf einmal als gelesen zu setzen.
- **Archivieren**: Klicken Sie bei einem erledigten Gespräch in **Offen** auf **Archivieren**.
- **Wiederherstellen**: Öffnen Sie ein Gespräch in **Archiviert** und klicken Sie auf **Wiederherstellen**, um es zurückzuholen und wieder antworten zu können.
- **Kontextmenü**: Rechtsklick oder langes Drücken auf ein Gespräch für **Als gelesen markieren**, **Als ungelesen markieren**, **Gespräch anheften** oder **Anheftung aufheben**, **Archivieren** und **Wiederherstellen**.

Die Zahl bei **Posteingang** in der Seitenleiste zählt offene Gespräche, deren letzte Nachricht vom Kunden stammt und noch auf eine Antwort wartet. Neue Nachrichten erscheinen live; die Zahl aktualisiert sich selbst.

## Tags [#tags]

Mit Tags kennzeichnen Sie Gespräche für Ihr ganzes Team.

1. Öffnen Sie ein Gespräch und nutzen Sie in der Seitenleiste den Block **Tags**.
2. Erstellen Sie einen Tag mit **Neuer Tag** oder wählen Sie einen vorhandenen. Über das Tag-Menü bearbeiten oder löschen Sie Tags.
3. Filtern Sie die Liste mit dem Tag-Symbol neben dem Plattformfilter.

Tags mit **KI darf anwenden** kann Tillie nach einer automatischen Antwort selbst hinzufügen. Tags, die Ihr Team bereits gesetzt hat, bleiben bestehen.

## Benachrichtigungen [#meldingen]

Benutzer mit **Posteingang-Benachrichtigungen** erhalten bei jeder neuen Kundennachricht eine Push-Benachrichtigung. Ihre eigenen Antworten lösen keine Benachrichtigung aus.

Mit **Posteingang anzeigen** sehen Sie bei einer neuen Nachricht außerdem eine Meldung unten rechts, im selben Dock wie offene Identitätsscans und aktive Telefongespräche. Dort stehen Absender, Kanal und ein Ausschnitt des Textes. Klicken Sie darauf, um das Gespräch zu öffnen. Die Meldung verschwindet nach etwa zehn Sekunden, es sei denn, Sie bleiben mit der Maus darüber. Ist das Gespräch bereits geöffnet, erscheint keine Meldung.

## Gespräche und Kunden [#gesprekken-en-klanten]

Tillor verknüpft ein Gespräch nach Möglichkeit mit einem Kunden:

- WhatsApp über die Telefonnummer.
- Messenger über einen übereinstimmenden Namen oder über eine Telefonnummer oder E-Mail-Adresse, die der Kunde selbst im Gespräch teilt.
- Instagram über einen übereinstimmenden Namen oder `@`-Benutzernamen.

Meta übermittelt über Messenger und Instagram weder E-Mail-Adresse noch Telefonnummer. Offene Gespräche eines Kunden stehen auch unter <UIPath>Kunden > Kunde > Kommunikation</UIPath>.

Die Seitenleiste rechts zeigt pro Kanal die Daten des Teilnehmers, etwa die WhatsApp-Nummer, den Instagram-Benutzernamen mit Profillink oder die Seite beim Website-Chat. Mit dem Panel-Symbol über dem Gespräch blenden Sie das Panel aus oder ein.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe den Posteingang nicht in der Seitenleiste">
Sie benötigen die Berechtigung **Posteingang anzeigen**. Bitten Sie einen Administrator, sie Ihnen unter <UIPath>Einstellungen > Benutzer</UIPath> zu erteilen, mit **Berechtigungen bearbeiten** bei Ihrem Namen.
</Accordion>
<Accordion title="Ich kann keine Antwort senden">
Für Antworten benötigen Sie **Posteingang verwalten**. In einem archivierten Gespräch können Sie ebenfalls nicht antworten: Klicken Sie zuerst auf **Wiederherstellen**.
</Accordion>
<Accordion title="Tillor meldet Nachricht senden fehlgeschlagen">
Prüfen Sie, ob das Gespräch geöffnet ist und ob Sie **Posteingang verwalten** haben. Bei WhatsApp kann auch das geschlossene Antwortfenster die Ursache sein, siehe oben. Versuchen Sie es danach erneut.
</Accordion>
<Accordion title="Bei meiner Nachricht steht Nicht zugestellt">
Der Kanal konnte die Nachricht nicht zustellen. Bei WhatsApp liegt das meist am geschlossenen 24-Stunden-Fenster oder an einer fehlenden Zahlungsmethode bei Meta.
</Accordion>
<Accordion title="Der Posteingang ist leer">
Es ist noch kein Kanal verbunden, oder es sind noch keine Nachrichten eingegangen. Verbinden Sie einen Kanal unter <UIPath>Einstellungen > Integrationen</UIPath>.
</Accordion>
<Accordion title="Ein Kunde hat eine Nachricht bearbeitet oder gelöscht">
Tillor passt das Gespräch automatisch an, wenn ein Kunde eine Nachricht bei Messenger oder Instagram bearbeitet oder zurückzieht oder bei WhatsApp bearbeitet (innerhalb von 15 Minuten).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Übersicht" href="/inbox" description="Kanäle und Berechtigungen" />
  <Card title="Gespräche über Website-Chat" href="/inbox/website-chat-gesprekken" description="Zusätzliches zum Chat auf Ihrer Website" />
  <Card title="Posteingangs-KI-Assistent" href="/inbox/inbox-ai-assistant" description="Tillie auf allen Kanälen" />
</Cards>


# Posteingangs-KI-Assistent (Tillie) (/de-DE/inbox/inbox-ai-assistant)

**Tillie** ist der Standardname des KI-Assistenten im [Tillor-Posteingang](/inbox). Sie beantwortet häufige Fragen, sammelt Angaben für Reservierungs- oder Verkaufsanfragen und übergibt das Gespräch an Ihr Team, wenn ein Kollege nötig ist. Tillie arbeitet auf **allen Posteingangskanälen**: [Website-Chat](/inbox/website-chat), [WhatsApp Business](/inbox/whatsapp-business-inbox), [Messenger](/inbox/messenger) und [Instagram Direct](/inbox/instagram).

<Callout type="info" title="Unabhängig vom Website-Chat">
Installieren Sie den **Posteingangs-KI-Assistenten** separat unter **Einstellungen > Integrationen**. Der Assistent gehört zum Posteingang, nicht nur zum Website-Widget.
</Callout>

## Integration installieren [#integratie-installeren]

1. Gehen Sie zu **Einstellungen > Integrationen** (Seitenleiste unter **Support**)
2. Öffnen Sie **Posteingangs-KI-Assistent** in der Liste
3. Klicken Sie auf **Installieren**
4. Legen Sie unter **Einstellungen** fest, was Tillie tun darf (siehe die Felder unten)

| Feld | Was bewirkt es? |
|------|----------------|
| **Posteingangs-KI aktiviert** | Hauptschalter für alle KI-Funktionen im Posteingang. Ausschalten, um zu stoppen, ohne zu deinstallieren |
| **Automatische Antworten senden** | Ist es aus: Tillie sendet keine Nachrichten an Besucher. Übersetzungen, Spracherkennung und Entwurfsantworten für das Team können separat aktiv bleiben |
| **KI für neue Gespräche automatisch aktivieren** | Gilt nur, wenn automatische Antworten an sind. Ist es aus: Jedes neue Gespräch startet ohne KI; Sie schalten die KI pro Gespräch in der Seitenleiste ein. Ist es an: Neue Posteingangsgespräche auf allen Kanälen erhalten sofort KI (mit 30 Minuten Pause nach einer Teamnachricht) |
| **Entwurfsantworten fürs Team erzeugen** | Lässt Kollegen im Antwortfeld einen KI-Entwurf erzeugen. Dieser Entwurf wird nie automatisch gesendet |
| **Nachrichten übersetzen** | Übersetzt eingehende Nachrichten in die Sprache der Organisation und Teamantworten in die Sprache des Kontakts. Teamantworten erhalten außerdem saubere Zeichensetzung, Großschreibung und ausgeschriebene Chat-Abkürzungen (auch wenn nicht übersetzt werden muss) |
| **Sprache des Kontakts erkennen** | Nutzt KI, um die Sprache des Besuchers zu erkennen, wenn sie noch nicht bekannt ist, und speichert sie am Gespräch |
| **Name des KI-Assistenten** | Name in Antworten und Prompts (Standard **Tillie**) |
| **MCP-Server (JSON)** | Optional. Schreibgeschützte MCP-Verbindungen (URL und Header) |
| **MCP-Tools** | Nach dem Speichern: **Tools laden**, schreibgeschützte Tools auflisten und pro Tool ein- oder ausschalten |

<Callout type="info" title="Nur übersetzen, keine automatischen Antworten">
Schalten Sie **Posteingangs-KI aktiviert** an, **Nachrichten übersetzen** (und ggf. **Sprache des Kontakts erkennen**) an und **Automatische Antworten senden** aus. Tillie übersetzt dann, sendet aber nichts an Besucher.
</Callout>

### MCP-Tools (optional) [#mcp-tools-optioneel]

Hat Ihr Park einen MCP-Server mit schreibgeschützten Verbindungen, kann Tillor während eines Gesprächs **Live-Parkdaten** abrufen. Denken Sie an Aktivitäten, zum Verkauf stehende Wohnwagen oder andere Daten, die Ihr Server bereitstellt.

Tillor hat **keine feste Liste von Toolnamen**. Welche Tools es gibt, sehen Sie nach **Tools laden** in den Integrationseinstellungen. Sie können nur Tools aktivieren, die Ihr MCP-Server als schreibgeschützt markiert.

1. Füllen Sie **MCP-Server (JSON)** aus (URL und Header).
2. Speichern Sie und klicken Sie auf **Tools laden**.
3. Aktivieren Sie die Tools, die zu Ihrem Park passen.

Je nach KI-Konfiguration Ihrer Umgebung wählt Tillie selbst, welches aktivierte Tool passt, anhand der Toolbeschreibung Ihres Servers. Sie ruft nie Tools auf, die Sie nicht aktiviert haben.

Ergebnisse aus MCP fließen in Tillies Antwort ein. Sie ersetzen die Wissensdatenbank nicht: Preise, Verfügbarkeit und Regeln erfindet sie weiterhin nicht, wenn sie aus keiner Quelle stammen.

<Callout type="info" title="Keine Reaktion von Tillie?">
Tillie nutzt ein KI-Modell, das Tillor für Ihre Umgebung einrichtet. Antwortet der Assistent nicht, wenden Sie sich an den Tillor-Support.
</Callout>

## Was Tillie nach einer Besucher-Nachricht tut [#wat-tillie-doet-na-een-bezoekersbericht]

Nach jeder neuen eingehenden Nachricht in einem Gespräch, in dem die KI aktiv ist:

1. Tillor zeigt auf dem Kanal einen **Tipp-Indikator**, während die Antwort erzeugt wird
2. Tillor bestimmt die Absicht: **Reservierung**, **Verkauf** oder **Sonstiges** (Organisationen mit Mietwohnwagen-Ablauf auch **Mietwohnwagen**)
3. Tillie antwortet in der Sprache des Besuchers; danach verschwindet der Tipp-Indikator

Tillie entscheidet anhand ihrer Anweisungen selbst, wann sie antwortet und wann sie schweigt. Auf eine Begrüßung („hi“, „hey“, „hallo“) antwortet sie mit einem kurzen Willkommen und der Frage, wobei sie helfen kann. Nach einem abschließenden Dank reagiert sie auf ein kurzes „danke“, „ok“ oder „nein“ des Besuchers nicht erneut, damit keine Dankes-Schleife entsteht.

| Absicht | Verhalten |
|-----------|--------|
| **Reservierung** | Fragt fehlende Angaben ab: Anreise, Abreise, Typ (Zelt, Mobilheim, Reisewohnwagen), Hunde ja/nein (und wie viele), Personenzahl, Kinder und Alter, danach Name, E-Mail und Telefonnummer, und optional das Kennzeichen für den Check-in (darf übersprungen werden). Angaben, die Tillor schon kennt (z. B. aus dem Website-Widget oder WhatsApp), werden ausgefüllt; nur fehlende Felder werden abgefragt. Bei einem Wochentag („Montag“) stellt Tillie zuerst eine Bestätigungsfrage („Meinen Sie …?“), bevor sie weitermacht. Jede Antwort endet mit einer Frage. Beantwortet kurze Richtlinienfragen aus der Wissensdatenbank (z. B. Reservierung später ändern) und sammelt danach weiter. Ist alles vollständig, fasst Tillie die **Anfrage** zusammen und übergibt das Gespräch an einen Kollegen - es gibt noch keine endgültige Reservierung |
| **Mietwohnwagen** | Sammelt Name, E-Mail, Adresse, Land und Aufenthaltsgrund (auf Anfrage), danach Übergabe an Ihr Team |
| **Verkauf** | Erklärt, dass der Besucher für eine Besichtigung oder einen Kauf im Büro vorbeikommen muss, und gibt es an Ihr Team weiter |
| **Sonstiges** | Antwortet nur, wenn die Antwort in der Wissensdatenbank steht. Sonst sagt Tillie ehrlich, dass sie es nicht weiß, bietet an, die Frage an einen Kollegen weiterzugeben, und übergibt das Gespräch |

Tillie **erfindet keine Preise, Verfügbarkeit oder Regeln**. Nur was in der Wissensdatenbank steht, darf als Fakt genannt werden.

### Buchungsformular auf Ihrer Website [#boekingsformulier-op-je-website]

Verbinden Sie ein eigenes Formular mit dem [Website-Chat](/inbox/website-chat)? Dann können Sie Tillie nur bestätigen und sofort übergeben lassen, ohne Aufnahmefragen. Das passt zu einem Formular, dessen Tab sich danach schließt. Siehe [Website-Chat-API - Metadaten](/ontwikkelaars/website-chat#metadata-boekingsformulier).

## Pro Gespräch: Automatisch, An oder Aus [#per-gesprek-automatisch-aan-of-uit]

In den Gesprächsdetails in der Seitenleiste wählen Sie pro Thread:

| Stand | Verhalten |
|-------|--------|
| **Automatisch** | Tillie antwortet, pausiert aber **30 Minuten** nach jeder Nachricht Ihres Teams |
| **An** | Tillie antwortet immer, auch direkt nach einer Teamnachricht |
| **Aus** | Tillie antwortet nicht auf dieses Gespräch |

Während der Pause sehen Sie in der Seitenleiste einen Countdown.

## Tags nach einer KI-Antwort [#tags-na-een-ai-antwoord]

Im Seitenbereich können Sie organisationsweite **Tags** anlegen und vergeben (Berechtigung **Posteingang verwalten**). Mit **Neuer Tag** legen Sie einen Tag an. Öffnen Sie das Tag-Menü an einem Gespräch, um Tags zu vergeben; Bearbeiten und Löschen pro Tag finden Sie im selben Menü. Haken Sie **KI darf anwenden** an, wenn Tillie diesen Tag nach einer automatischen Antwort hinzufügen darf. Tillie wählt dann selbst null oder mehr dieser Tags anhand des Gesprächs; Tags, die Ihr Team bereits gesetzt hat, bleiben bestehen.

Typische Tags sind zum Beispiel **Verkauf**, **Buchung** und **Dringend**. Tillie erkennt diese Namen und verknüpft sie mit dem, was sie im Gespräch bereits festgestellt hat:

| Tillie-Absicht | Passt zu Tag-Namen wie |
|---|---|
| Verkauf | Verkoop, Sale |
| Reservierung | Boeking, Reservatie, Booking |
| Mietwohnwagen | Caravan, Verhuur |
| Dringende Übergabe | Urgent, Spoed, Dringend |

Der Tag-Name muss nicht exakt passen: **Boeking aanvragen** zählt ebenfalls als Buchungs-Tag. Nur Tags mit **KI darf anwenden** kommen in Betracht.

## Sprache, Ton und Kontaktdaten [#taal-toon-en-contactgegevens]

Antworten folgen der Sprache des Besuchers - nicht nur den vier Widget-Sprachen (`en`, `nl`, `de`, `fr`), sondern jeder Sprache, in der Tillie antworten kann (z. B. Spanisch, Polnisch, Türkisch). Bittet jemand ausdrücklich um eine andere Sprache, wechselt Tillie und speichert die gewählte Sprache am Gespräch.

**Übergabe-Zusammenfassungen** (nur für Ihr Team sichtbar) folgen immer der **Organisationssprache** aus Tillor, bei jeder Übergabe (Reservierung, Mietwohnwagen, Verkauf, offene Frage, ausdrückliche Bitte um einen Kollegen), unabhängig von der Sprache des Gesprächs. Tillie erhält diese Organisationssprache in jedem Prompt.

Nachrichten an Besucher (KI und Team) sind immer **reiner Text**, kein Markdown, weil WhatsApp, Instagram, Messenger und das Widget das nicht unterstützen. Auf WhatsApp darf Tillie unter eine kurze Antwort bis zu drei Antwortschaltflächen setzen, wenn ein Tippen eine Wahl ist, die die Nachricht selbst schon nennt. Die Nachricht bleibt lesbar, wenn der Kunde tippt statt zu antippen. Außerhalb des 24-Stunden-Fensters geht die Antwort als Vorlage ohne Schaltflächen hinaus.

Tillie bleibt ruhig und professionell, spricht nicht über Konkurrenten und ignoriert keine Sicherheitsregeln, wenn ein Besucher verlangt, Anweisungen zu ignorieren. Kontaktdaten für Weiterverweise stammen aus Ihrem **Tillor-Organisationsprofil** (Name, Adresse, Telefon, E-Mail, Website). **Büro-Öffnungszeiten** stellen Sie unter **Einstellungen > Öffnungszeiten** ein (Wochenzeiten, Saisonzeiträume, Feiertage und Ausnahmen); Tillie nutzt diese Zeiten, um zu sagen, wann ein Kollege antworten kann. Halten Sie diese Felder aktuell. Etwa eine Woche vor einem gesetzlichen Feiertag erinnert Tillor die Support-Adresse per E-Mail, wenn die Zeiten für diesen Tag noch nicht ausgefüllt sind.

## Ereignisse im Gespräch (nur für Ihr Team) [#gebeurtenissen-in-het-gesprek-alleen-voor-je-team]

Bei der Reservierungsaufnahme aktualisiert Tillie Name, E-Mail und Telefon, sobald der Besucher sie angibt. Im Posteingang erscheint dann ein Ereignis **KI-Daten aktualisiert** (von → nach), nur für Ihr Team sichtbar.

Bei einer Übergabe erscheint ein Ereignis **KI-Übergabe**: eine auffällige Karte mit Zusammenfassung (Tabelle für Reservierungs- oder Mietwohnwagen-Daten, plus Notizen für offene Fragen). Die Zusammenfassung steht immer in der **Sprache Ihrer Organisation** (nl, en, de oder fr), auch wenn der Besucher in einer anderen Sprache chattet. Der Besucher sieht diese Karte nicht.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Posteingang - Website-Chat mit KI-Übergabe und Gesprächsdetails" />

## Wissensdatenbank: Fakten, die Tillie verwenden darf [#kennisbank-feiten-die-tillie-mag-gebruiken]

Tillie beantwortet Fragen anhand einer **Wissensdatenbank**: kurze Artikel mit geprüften Fakten zu Ihrem Park, zum Beispiel Öffnungszeiten, Haustierregeln, das Schwimmbad, Ladesäulen oder wie eine Reservierung später geändert wird.

Manche Artikel gelten für alle Tillor-Organisationen, andere sind speziell für Ihren Park. Tillie verwendet in einem Gespräch nur die allgemeinen Artikel plus die Artikel, die für Ihre Organisation hinzugefügt wurden.

Möchten Sie Themen hinzufügen, anpassen oder entfernen lassen? Geben Sie das an den Tillor-Support weiter. Wir füllen und pflegen die Wissensdatenbank gemeinsam mit Ihnen, abgestimmt darauf, was Ihre Rezeption beantworten können soll.

## Gesprächsabläufe: Drehbuch pro Absicht [#gespreksflows-draaiboek-per-bedoeling]

Neben der Wissensdatenbank folgt Tillie **Gesprächsabläufen**: Vereinbarungen darüber, welche Angaben sie abfragt, in welcher Reihenfolge und wann sie das Gespräch an Ihr Team übergibt. Jede Absicht (Reservierung, Mietwohnwagen, Verkauf, Sonstiges - siehe die Tabelle oben) hat so einen Ablauf.

Die Abläufe sind standardmäßig eingestellt, aber Tillor stimmt sie gemeinsam mit Ihnen auf Ihren Park ab. Möchten Sie zum Beispiel andere Angaben bei einer Reservierungsanfrage abfragen lassen oder Tillie schneller übergeben lassen? Geben Sie das an den Tillor-Support weiter.

<Callout type="warn" title="Erste Version">
Prüfen Sie KI-Antworten im Posteingang, bevor Sie sie Besuchern anvertrauen. Eine Reservierung per Chat bleibt eine **Anfrage** - keine endgültige Buchung.
</Callout>

## Wie geht es danach weiter? [#wat-gebeurt-er-daarna]

- Ein Gespräch, das Tillie übergibt, steht im Posteingang mit einem Block **Tillie hat dieses Gespräch an Ihr Team übergeben** und den gesammelten Angaben.
- Ihr Team erhält eine Benachrichtigung. Bei einer dringenden Übergabe geschieht das über die Benachrichtigung **Dringende KI-Übergabe**. Siehe [Benachrichtigungstypen](/communicatie/notificatietypes).
- Antwortet ein Kollege, pausiert Tillie 30 Minuten im Stand **Automatisch**.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillie antwortet nicht">
Prüfen Sie, ob **Posteingangs-KI aktiviert** und **Automatische Antworten senden** unter <UIPath>Einstellungen > Integrationen > Posteingangs-KI-Assistent</UIPath> an sind. Schauen Sie danach in der Seitenleiste des Gesprächs, ob der Stand nicht auf **Aus** steht oder ob nach einer Nachricht Ihres Teams ein Countdown läuft.
</Accordion>
<Accordion title="Neue Gespräche starten ohne Tillie">
**KI für neue Gespräche automatisch aktivieren** ist aus. Schalten Sie den Schalter an, oder wählen Sie pro Gespräch **An**.
</Accordion>
<Accordion title="Tillie sagt, dass sie etwas nicht weiß">
Tillie verwendet nur, was in der Wissensdatenbank steht, und erfindet keine Preise, Verfügbarkeit oder Regeln. Ergänzen Sie die Wissensdatenbank.
</Accordion>
</Accordions>

## Verwandt [#gerelateerd]

<Cards>
  <Card title="Posteingang" href="/inbox" description="Gespräche lesen und beantworten" />
  <Card title="Website-Chat" href="/inbox/website-chat" description="Live-Chat auf Ihrer eigenen Website" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="WhatsApp im Posteingang" />
  <Card title="Messenger" href="/inbox/messenger" description="Facebook Messenger verbinden" />
  <Card title="Instagram" href="/inbox/instagram" description="Instagram Direct verbinden" />
</Cards>


# Übersicht (/de-DE/inbox)

Im Posteingang lesen und beantworten Sie Nachrichten von Kunden und Besuchern, die über WhatsApp, Messenger, Instagram oder den Chat auf Ihrer Website eingehen, alles an einem Ort. Sie finden ihn in der Seitenleiste unter **Support > Posteingang**. Zuerst verbinden Sie die gewünschten Kanäle, danach arbeiten Sie täglich in [Gespräche lesen und beantworten](/inbox/gesprekken).

<Callout type="info" title="Nicht für automatische Benachrichtigungen">
Der Posteingang ist für den Austausch in beide Richtungen mit Kunden gedacht. Automatische WhatsApp-Benachrichtigungen, zum Beispiel bei niedrigem NFC-Guthaben, laufen über Twilio und nicht über diese Integrationen.
</Callout>

<Callout type="info" title="Gut zu wissen">
- Eine neue Nachricht erscheint als Karte unten rechts und verschwindet nach etwa zehn Sekunden. Die Zahl bei **Posteingang** zählt offene Gespräche, die auf eine Antwort warten
- Der KI-Assistent Tillie pausiert 30 Minuten, nachdem ein Kollege geantwortet hat
- Eine Chat-Nachricht auf der Website kann höchstens 4096 Zeichen enthalten, ohne Bilder oder Dateien
- Ein Kunde kann eine WhatsApp-Nachricht bis zu 15 Minuten nach dem Senden bearbeiten, und das sehen Sie im Gespräch
- Die E-Mail-Erinnerung an einen Websitebesucher geht nach etwa 5 Minuten Inaktivität hinaus. Der Link funktioniert 30 Tage
- Eine eigene Nachricht, die Sie in Tillor löschen (Messenger und Instagram), verschwindet nur in Tillor, nicht beim Kunden

</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Jeden Kanal installieren Sie separat. Alle Gespräche landen danach in derselben Liste, und Tillor verknüpft sie nach Möglichkeit mit einem Kunden.

```mermaid
flowchart LR
  W[WhatsApp] --> I[Inbox]
  M[Messenger] --> I
  G[Instagram] --> I
  C[Chat auf Ihrer Website] --> I
  I --> K[Verknüpfter Kunde über Telefonnummer oder Name]
  I --> A[Tillie antwortet oder übergibt]
  A --> T[Ihr Team]
  I --> T
  T -->|Antwort| W
  T -->|Antwort| M
  T -->|Antwort| G
  T -->|Antwort| C
```

- Ihr Team antwortet in Tillor. Die Antwort geht über denselben Kanal zurück an den Kunden.
- Tillie, der KI-Assistent, kann antworten und ein Gespräch an Ihr Team übergeben. Das legen Sie pro Gespräch fest.
- Antworten, die Sie außerhalb von Tillor senden, zum Beispiel in der WhatsApp-Business-App, erscheinen ebenfalls im Gespräch.

## Kanäle verbinden [#kanalen-koppelen]

Installieren Sie pro Kanal eine Integration unter <UIPath>Einstellungen > Integrationen</UIPath>.

<Cards>
  <Card title="Website-Chat" href="/inbox/website-chat" description="Chat-Schaltfläche auf Ihrer eigenen Seite, ohne externes Konto" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="WhatsApp-Nummer über Meta verbinden" />
  <Card title="Messenger" href="/inbox/messenger" description="Facebook-Seite über Meta verbinden" />
  <Card title="Instagram" href="/inbox/instagram" description="Instagram Direct über Meta verbinden" />
  <Card title="Posteingangs-KI-Assistent" href="/inbox/inbox-ai-assistant" description="Tillie antwortet und übergibt auf allen Kanälen" />
</Cards>

Bei Messenger holt Tillor beim Verbinden die bestehenden Gespräche der Seite ab. Ist Messenger bereits verbunden, können Sie diese Synchronisierung auch manuell aus dem Posteingang starten.

## Täglich arbeiten [#dagelijks-werken]

<Cards>
  <Card title="Gespräche lesen und beantworten" href="/inbox/gesprekken" description="Antworten, archivieren, Tags und Benachrichtigungen" />
  <Card title="Gespräche über Website-Chat" href="/inbox/website-chat-gesprekken" description="Was Sie bei einem Websitebesucher sehen" />
</Cards>

## Berechtigungen [#rechten]

| Berechtigung | Was darf der Benutzer? |
|-----------|------------------------|
| **Posteingang anzeigen** | Den Posteingang öffnen und Gespräche lesen |
| **Posteingang verwalten** | Antworten senden, Gespräche archivieren, wiederherstellen und anheften, als ungelesen markieren und eigene Nachrichten in Tillor löschen (Messenger und Instagram) |
| **Posteingang-Benachrichtigungen** | Push-Benachrichtigungen bei neuen Kundennachrichten erhalten |

Berechtigungen stellen Sie unter <UIPath>Einstellungen > Benutzer</UIPath> ein.

## Begriffe [#begrippen]

- **Gespräch oder Thread**: alle Nachrichten mit einem Kunden oder Besucher auf einem Kanal.
- **Offen und Archiviert**: die zwei Tabs der Gesprächsliste. Archivieren nimmt ein Gespräch aus **Offen**, Wiederherstellen setzt es zurück.
- **Tillie**: der Standardname des KI-Assistenten im Posteingang. Sie können den Namen anpassen.


Weitere Begriffe stehen im [Glossar](/begrippen).


# Instagram (/de-DE/inbox/instagram)

Mit **Instagram** empfangen Sie Instagram-Direct-Nachrichten im [Tillor-Posteingang](/inbox). Die Integration nutzt eine verbundene **Facebook-Seite** mit einem **Instagram-Professional-Konto** in der Meta Business Suite.

Bevor Sie beginnen:

- Sie benötigen die Berechtigung **Integrationen verwalten**.
- Ihr Instagram-Konto ist ein Professional-Konto (Business oder Creator), verbunden mit einer Facebook-Seite.

## Integration installieren [#integratie-installeren]

1. Gehen Sie zu **Einstellungen** (Seitenleiste unter **Support**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-nav.png" alt="Navigation zu Einstellungen" />

2. Wählen Sie **Integrationen** und öffnen Sie **Instagram** in der Liste (Markierung **2**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-instagram.png" alt="Einstellungen > Integrationen - Instagram in der Liste" />

3. Klicken Sie auf **Installieren** (Markierung **1**) und schließen Sie den Meta-OAuth-Ablauf ab (Instagram-Messaging-Berechtigungen)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/instagram-install.png" alt="Instagram-Details - Installieren" />

4. Wählen Sie die **Facebook-Seite**, die mit Ihrem Instagram-Professional-Konto verbunden ist
5. Prüfen Sie das Feld **Instagram-Benutzername** unter der Seitenauswahl (Tillor zeigt das verbundene Konto, zum Beispiel `@uwaccount`)
6. Speichern Sie die Einstellungen

Ohne verbundenes Instagram-Professional-Konto auf der gewählten Seite kann Tillor die Integration nicht abschließen.

## Wie geht es danach weiter? [#wat-gebeurt-er-daarna]

- Nach der Installation landen eingehende Instagram-Direct-Nachrichten automatisch im [Posteingang](/inbox).
- Antworten über die Instagram-App erscheinen ebenfalls im Posteingang. Nachrichten, die Sie über Tillor senden, werden nicht doppelt angezeigt.
- Kommen trotzdem keine Nachrichten an, wenden Sie sich an den Tillor-Support. Die Instagram-Verbindung mit Meta muss für die gesamte Plattform eingerichtet sein.
- Messenger und Instagram sind getrennte Integrationen. Möchten Sie beide Kanäle im Posteingang, installieren Sie beide.

## Probleme? [#problemen]

### Verbinden fehlgeschlagen oder kein Instagram auf der Seite [#koppelen-mislukt-of-geen-instagram-op-de-pagina]

Wenn die Installation mit *Die App konnte nicht verbunden werden* oder *Kein Instagram-Professional-Konto* abbricht, prüfen Sie in Meta:

1. **Instagram Professional** - Ihr Instagram-Konto muss Business oder Creator sein (kein persönliches Konto).
2. **Seite verbinden** - verbinden Sie in der [Meta Business Suite](https://business.facebook.com/) oder in den Business-Einstellungen das Instagram-Konto mit der **Facebook-Seite**, mit der Sie sich anmelden.
3. **Nachrichtenzugriff** - in der Instagram-App: **Einstellungen** > **Nachrichten und Story-Antworten** > **Verbundene Tools** > erlauben Sie den Zugriff auf Nachrichten (erforderlich für Direct in Posteingangs-Apps).
4. **Richtiges Meta-Login** - verwenden Sie ein Konto, das **Administrator** der Facebook-Seite ist und Messaging-Rechte hat.


Tillor sucht bei der Installation alle Facebook-Seiten Ihres Kontos und wählt die erste Seite mit einem verbundenen Instagram-Professional-Konto. Haben Sie mehrere Seiten, können Sie nach der Installation in den Integrationseinstellungen eine andere Seite wählen.

<Callout type="info" title="Für technisch Interessierte">
Tillor fordert bei der Installation immer die Berechtigungen `instagram_basic`, `instagram_manage_messages` und `pages_read_engagement` an. Setzen Sie diese zuerst auf **Ready for testing** unter **Use cases** (Messenger/Instagram) in der Meta Developer Console. **Invalid Scopes** bedeutet, dass sie noch nicht in der Meta-App stehen. Die Berechtigungen `instagram_business_*` gehören zu einer anderen Anmeldemethode und sind nicht für Tillor.
</Callout>

## Verwandt [#gerelateerd]

<Cards>
  <Card title="Posteingang" href="/inbox" description="Gespräche lesen und beantworten" />
  <Card
    title="Messenger"
    href="/inbox/messenger"
    description="Facebook Messenger für den Posteingang verbinden"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="WhatsApp-Nummer für den Posteingang verbinden"
  />
</Cards>


# Messenger (/de-DE/inbox/messenger)

Mit **Messenger** empfangen Sie Nachrichten von Kunden über eine verbundene Facebook-Seite im [Tillor-Posteingang](/inbox).

Bevor Sie beginnen:

- Sie benötigen die Berechtigung **Integrationen verwalten**.
- Sie melden sich bei Meta mit einem Konto an, das Administrator der Facebook-Seite ist.

## Integration installieren [#integratie-installeren]

1. Gehen Sie zu **Einstellungen** (Seitenleiste unter **Support**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-nav.png" alt="Navigation zu Einstellungen" />

2. Wählen Sie **Integrationen** und öffnen Sie **Messenger** in der Liste (Markierung **2**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-messenger.png" alt="Einstellungen > Integrationen - Messenger in der Liste" />

3. Klicken Sie auf **Installieren** (Markierung **1**) und schließen Sie den Meta-OAuth-Ablauf ab

<DocScreenshot src="/screenshots/communicatie/providers/messenger/messenger-install.png" alt="Messenger-Details - Installieren" />

4. Wählen Sie auf der Detailseite, welche **Facebook-Seite** Messenger-Nachrichten empfängt
5. Speichern Sie die Einstellungen

Tillor zeigt die verbundene Seite unter **Einstellungen** auf der Detailseite. Nach der Installation empfängt Tillor eingehende Messenger-Nachrichten automatisch. Antworten, die Sie auch über die Messenger-App senden, erscheinen im Posteingang. Nachrichten, die Sie über Tillor senden, werden nicht doppelt angezeigt.

Für **Instagram Direct** installieren Sie die separate Integration [Instagram](/inbox/instagram).

## Wie geht es danach weiter? [#wat-gebeurt-er-daarna]

- Tillor holt die bestehenden Gespräche der Seite ab. Diese Synchronisierung können Sie später auch selbst aus dem Posteingang starten.
- Neue Nachrichten landen automatisch im [Posteingang](/inbox). Tillor verknüpft sie mit einem Kunden mit demselben Namen oder über eine Telefonnummer oder E-Mail-Adresse, die der Kunde im Gespräch teilt.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Es kommen keine Nachrichten an">
Prüfen Sie unter <UIPath>Einstellungen > Integrationen > Messenger</UIPath>, ob die richtige **Facebook-Seite** gewählt ist und ob die Einstellungen gespeichert wurden.
</Accordion>
<Accordion title="Ein Gespräch ist keinem Kunden zugeordnet">
Meta übermittelt über Messenger weder E-Mail-Adresse noch Telefonnummer. Tillor verknüpft nur über einen übereinstimmenden Namen oder über Angaben, die der Kunde selbst teilt.
</Accordion>
</Accordions>

## Verwandt [#gerelateerd]

<Cards>
  <Card title="Posteingang" href="/inbox" description="Gespräche lesen und beantworten" />
  <Card
    title="Instagram"
    href="/inbox/instagram"
    description="Instagram Direct für den Posteingang verbinden"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="WhatsApp-Nummer für den Posteingang verbinden"
  />
</Cards>


# Gespräche über Website-Chat (/de-DE/inbox/website-chat-gesprekken)

Ein Gespräch erscheint im Posteingang, sobald der Besucher seine erste Nachricht sendet, mit dem Kanal **Website-Chat**. Wie Sie reagieren, steht unter [Gespräche lesen und beantworten](/inbox/gesprekken). Diese Seite erklärt, was beim Website-Chat zusätzlich zu sehen ist.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Posteingang - Website-Chat mit Gesprächsdetails" />

In der Seitenleiste rechts steht eine Schaltfläche **Auf Website öffnen** mit der Seite, auf der der Besucher zuletzt aktiv war, sowie Besucher- und Sitzungsdaten. Zusätzliche Felder aus dem Besucherformular stehen dort ebenfalls.

## Wer ist der Besucher? [#wie-is-de-bezoeker]

- Tillor erkennt einen Besucher an seinem Browser. Derselbe Browser auf demselben Gerät öffnet also dasselbe Gespräch.
- Name, E-Mail und Telefon aus dem Besucherformular werden nach der ersten Nachricht in diesem Browser gespeichert. Kommt der Besucher später zurück, muss er nichts erneut ausfüllen.
- Ist dieser Speicher leer, zum Beispiel in einem anderen Browser oder nach dem Löschen, ergänzt das Widget die Daten aus dem bestehenden Gespräch.
- Nachrichten sind Text mit bis zu 4096 Zeichen. Bilder und Dateien werden nicht unterstützt.

## Tippen und Anwesenheit [#typen-en-aanwezigheid]

| Was | Wer sieht es | Wo |
|-----|--------------|------|
| **Tippt…**, während der Besucher schreibt | Ihr Team | Unter dem Gespräch im Posteingang, auch vor der ersten Nachricht |
| **Tippt…**, während ein Kollege schreibt | Der Besucher | Im Widget |
| **Online** (grüner Punkt) oder **Zuletzt gesehen** mit einer Uhrzeit | Ihr Team | Über dem Gespräch |

Der Besucher gilt als online, solange der Tab sichtbar ist. Das Widget sendet ungefähr alle 20 Sekunden ein Lebenszeichen. Nachrichten abrufen, tippen und lesen zählen ebenfalls als Aktivität.

## Haken [#vinkjes]

Besucher sehen Haken bei ihren eigenen Nachrichten:

| Haken | Bedeutung |
|---------|-----------|
| Einer | Gesendet |
| Zwei graue | Ihr Team hat das Gespräch geöffnet und die Nachrichten geladen |
| Zwei blaue | Ihr Team hat das Gespräch als gelesen markiert |

Im Posteingang sehen Sie Haken bei Ihren eigenen Antworten:

| Haken | Bedeutung |
|---------|-----------|
| Einer | Gesendet |
| Zwei graue | Der Besucher ist auf der Seite und hat die Nachrichten abgerufen, auch bei geschlossenem Chat |
| Zwei blaue | Der Besucher hat das Chatfenster geöffnet |

Antworten aus dem Posteingang erscheinen automatisch im Widget, auch wenn der Besucher das Fenster erst später öffnet.

## Besucheraktivität im Gespräch [#bezoekersactiviteit-in-het-gesprek]

Nach der ersten Nachricht sieht Ihr Team grauen Infotext im Gespräch. Der Besucher sieht ihn nicht. Diese Zeilen erhöhen keinen Ungelesen-Zähler und lösen keine Push-Benachrichtigung aus.

| Ereignis | Text im Posteingang |
|-------------|-------------------|
| Chat geschlossen | Benutzer hat den Chat geschlossen |
| Anderer Tab oder Fenster minimiert | Benutzer hat den Tab gewechselt oder den Browser minimiert |
| Andere Seite geöffnet | Benutzer hat zur Seiten-URL navigiert |

Navigation wird auch auf Seiten erkannt, die intern die Seite wechseln, ohne neu zu laden. Das Widget meldet die aktuelle Seite ungefähr alle 20 Sekunden, sodass die Seitenleiste die zuletzt aktive Seite zeigt.

## Tillie im Website-Chat [#tillie-op-website-chat]

Tillie, der KI-Assistent, arbeitet auch im Widget. Installieren Sie dafür den **Posteingangs-KI-Assistenten** separat. Installation, Wissensdatenbank und Verhalten stehen unter [Posteingangs-KI-Assistent (Tillie)](/inbox/inbox-ai-assistant). Nachrichten von Tillie erhalten im Widget ein Roboter-Symbol statt des Organisationslogos.

<Callout type="info" title="Die erste Nachricht">
Sobald der Besucher tippt, kann Ihr Team **Tippt…** sehen. Die erste Nachricht geht erst bei **Senden** hinaus, zusammen mit den ausgefüllten Kontaktdaten.
</Callout>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Gespräche lesen und beantworten" href="/inbox/gesprekken" description="Antworten, archivieren, Tags" />
  <Card title="Einstellungen des Website-Chats" href="/inbox/website-chat-instellingen" description="Widget und Besucherformular" />
  <Card title="Website-Chat-API" href="/ontwikkelaars/website-chat" description="Eigene Chat-Oberfläche bauen" />
</Cards>


# Einstellungen des Website-Chats (/de-DE/inbox/website-chat-instellingen)

Sie finden die Einstellungen unter <UIPath>Einstellungen > Integrationen > Website-Chat</UIPath>. Installieren und das Snippet einfügen steht unter [Den Chat auf Ihre Website bringen](/inbox/website-chat).

## Widget [#widget]

| Feld | Was bewirkt es? |
|------|---------------|
| **Widget aktiviert** | Blendet den Chat überall aus, ohne die Integration zu entfernen. Standardmäßig an |
| **Auf öffentlichen Tillor-Seiten anzeigen** | Zeigt die Chat-Schaltfläche auf öffentlichen Tillor-Seiten wie Zugangspass, offene Rechnung und öffentliche Karte. Ihre eigene Seite nutzt das Snippet. Standardmäßig an |
| **Willkommensnachricht** | Text in der Chat-Kopfzeile und vor der ersten Nachricht des Besuchers. Höchstens 500 Zeichen. Leer lassen ergibt einen Standardtext in der Sprache des Widgets |
| **Launcher-Tooltip** | Beschriftung für die schwebende Schaltfläche, gedacht für Screenreader. Höchstens 80 Zeichen |
| **Nachricht „Antwort folgt“** | Zeile unter dem Organisationsnamen in der Chat-Kopfzeile, zum Beispiel „Wir antworten meist schnell“ |
| **Launcher-Symbol** | Symbol auf der Chat-Schaltfläche: **Sprechblase**, **Abgerundeter Chat**, **Fragezeichen**, **Suche** oder **Person** |
| **Akzentfarbe** | Farbe der Chat-Schaltfläche und der Nachrichten des Besuchers. Wählen Sie eine Farbe oder geben Sie einen Hex-Wert ein, zum Beispiel `#2563eb` |
| **Erlaubte Domains** | Durch Komma getrennte Hostnamen, die den Chat laden dürfen. Leer bedeutet: jede Domain |
| **Besucher über ungelesene Antworten per E-Mail benachrichtigen** | Siehe [unten](#herinnering-per-e-mail). Standardmäßig an |

Die Chat-Kopfzeile zeigt automatisch das Logo Ihrer Organisation. Nachrichten des KI-Assistenten erhalten ein Roboter-Symbol statt dieses Logos. Beides lässt sich unter Website-Chat nicht einstellen.

<Callout type="info" title="Welche Sprache bekommt der Besucher?">
Setzen Sie keine **Willkommensnachricht**, keinen **Launcher-Tooltip** und keine **Nachricht „Antwort folgt“**, verwendet das Widget einen Standardtext in seiner eigenen Sprache. Diese Sprache stellen Sie im Snippet mit `data-locale` ein (siehe [Optionen im Snippet](#opties-op-het-snippet)).
</Callout>

## Besucherformular [#bezoekersformulier]

Hier legen Sie fest, was ein Besucher vor der ersten Nachricht ausfüllt. Gibt es Pflichtfelder, stehen sie zusammen mit dem Nachrichtenfeld auf einem Bildschirm. Der Besucher füllt alles aus und klickt auf **Senden**, ohne separaten Zwischenschritt.

### Standardfelder [#standaardvelden]

| Feld | Was bewirkt es? |
|------|---------------|
| **Name erforderlich** | Besucher geben ihren Namen ein. Der Name wird am Gespräch gespeichert |
| **E-Mail erforderlich** | Besucher geben ihre E-Mail-Adresse ein. Die Adresse wird am Gespräch gespeichert |
| **Telefon erforderlich** | Besucher geben eine Telefonnummer ein. Tillor wandelt sie in ein festes Format um und nutzt sie, um das Gespräch mit Anrufen und Kunden zu verknüpfen |

Jedes Feld ist einzeln an oder aus. Ist nur Telefon an, sieht der Besucher nur das Telefonfeld.

### Zusätzliche Felder [#extra-velden]

Klicken Sie auf **Feld hinzufügen** für eigene Fragen. Sie können höchstens 8 zusätzliche Felder hinzufügen. Entfernen Sie ein Feld mit **Feld entfernen**.

| Option | Erklärung |
|-------|--------|
| **Feldbezeichnung** | Was der Besucher im Widget sieht. Höchstens 80 Zeichen |
| **Feldschlüssel** | Interner Name des Feldes. Beginnen Sie mit einem Kleinbuchstaben und verwenden Sie nur Kleinbuchstaben, Ziffern und `_` (höchstens 32 Zeichen) |
| **Feldtyp** | **Text** oder **E-Mail** |
| **Pflichtfeld** | Der Besucher muss das Feld ausfüllen, bevor er chatten kann. Ein neues Feld ist standardmäßig Pflicht |
| **Platzhalter** | Hinweis im Eingabefeld. Höchstens 120 Zeichen |

Die Antworten auf zusätzliche Felder stehen im Posteingang beim Gespräch, neben Kanal und Besucher-ID.

## Erinnerung per E-Mail [#herinnering-per-e-mail]

Besucher schließen die Seite oft, bevor Ihr Team oder Tillie antwortet. Mit **Besucher über ungelesene Antworten per E-Mail benachrichtigen** erhält der Besucher eine E-Mail mit der Schaltfläche **Gespräch fortsetzen**, sobald eine Antwort bereitliegt, die er nicht gelesen hat.

- Der Besucher muss eine E-Mail-Adresse angegeben haben, über das Besucherformular oder vorausgefüllt. Ohne Adresse passiert nichts.
- Die E-Mail geht erst hinaus, wenn der Besucher etwa 5 Minuten nicht mehr aktiv war. Pro Reihe ungelesener Antworten erhält er eine E-Mail.
- Die Schaltfläche öffnet den Chat und setzt das Gespräch fort, auch auf einem anderen Gerät oder in einem anderen Browser. Der Link funktioniert 30 Tage.
- Der Besucher kann auch direkt auf die E-Mail antworten. Diese Antwort erscheint im selben Gespräch im Posteingang, mit einem kleinen Umschlag-Symbol bei der Nachricht.
- Antworten von Tillie zählen mit, ebenso wie Antworten Ihres Teams.

## Optionen im Snippet [#opties-op-het-snippet]

Neben `data-org-id` und `data-widget-key` können Sie optionale Attribute auf das Script setzen. Das ist für diejenigen gedacht, die das Snippet auf der Website einfügen.

| Attribut | Was bewirkt es? |
|-----------|---------------|
| `data-locale` | Sprache des Widgets: `en`, `nl`, `de`, `fr`, `pt` oder `ro`, ggf. mit Region wie `nl-BE`. Standard `en`; eine andere Sprache fällt auf Englisch zurück. Die Region bestimmt das Datums- und Zeitformat |
| `data-accent-color` | Akzentfarbe für diese Seite als 6-stelliger Hex-Wert. Hat Vorrang vor der Farbe unter **Einstellungen** |
| `data-messages` | JSON-Objekt, um einzelne Texte anzupassen, zum Beispiel `{"send":"Versturen","messagePlaceholder":"Typ uw bericht…"}` |
| `data-sounds` | `false` schaltet Töne bei neuen Teamantworten und beim Senden aus. Standardmäßig an |
| `data-launcher` | `false` blendet die schwebende Chat-Schaltfläche aus. Den Chat öffnen Sie dann mit Ihrer eigenen Schaltfläche über [das Widget-SDK](/ontwikkelaars/website-chat#widget-sdk) |
| `data-visitor` | JSON-Objekt, um Name, E-Mail und Telefon vorauszufüllen, zum Beispiel `{"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"}` |
| `data-visitor-name`, `data-visitor-email`, `data-visitor-phone` | Füllt eines dieser Felder vor |
| `data-debug` | `true` zeigt Logzeilen in der Browserkonsole |

Attribute ergänzen nur leere Felder. Hat der Besucher in diesem Browser bereits Daten eingegeben, bleiben sie bestehen.

Ein Beispiel mit niederländischen Texten:

```html
<script
  src="https://tillor.eu/inbox-widget.js"
  data-org-id="org_abc123"
  data-widget-key="iwk_xxx"
  data-locale="nl"
  async
  defer
></script>
```

Debug lässt sich auch ohne Änderung des Snippets einschalten: Führen Sie in der Browserkonsole `localStorage.setItem('tillor-inbox-debug', '1')` aus und laden Sie die Seite neu.

## Spam-Schutz [#spambeveiliging]

Das Widget verwendet kein Captcha. Tillor schützt das Senden mit dem Widget-Schlüssel und mit **Erlaubte Domains**. Hat Ihr Kontaktformular ein eigenes Captcha, darf es als zusätzliche Schicht bestehen bleiben.

## Bedingungen für Besucher [#voorwaarden-voor-bezoekers]

Unter dem Nachrichtenfeld steht ein kurzer Hinweis, dass der Besucher mit dem Senden den [Website-Chat-Bedingungen](https://tillor.eu/chat-terms) zustimmt. Der Link öffnet sich in einem neuen Tab und folgt der Sprache von `data-locale`.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Den Chat auf Ihre Website bringen" href="/inbox/website-chat" description="Installieren und das Snippet einfügen" />
  <Card title="Gespräche über Website-Chat" href="/inbox/website-chat-gesprekken" description="Was Sie und der Besucher sehen" />
  <Card title="Website-Chat-API" href="/ontwikkelaars/website-chat" description="Widget-SDK und eigene Chat-Oberfläche" />
</Cards>


# Den Chat auf Ihre Website bringen (/de-DE/inbox/website-chat)

Mit der Website-Chat-Integration erhält Ihre Seite eine Chat-Schaltfläche. Nachrichten von Besuchern landen im [Posteingang](/inbox), neben WhatsApp, Messenger und Instagram.

<Requires permission="Integraties beheren" />

<Steps>
<Step>
### Die Integration installieren [#installeer-de-integratie]
Gehen Sie zu <UIPath>Einstellungen > Integrationen</UIPath> und öffnen Sie **Website-Chat**. Klicken Sie auf **Installieren**. Eine Verbindung mit einem externen Konto ist nicht nötig; Tillor erstellt den Widget-Schlüssel selbst.
</Step>
<Step>
### Das Widget einstellen [#stel-de-widget-in]
Füllen Sie unter **Einstellungen** auf derselben Seite mindestens die **Willkommensnachricht** und die **Akzentfarbe** aus. Füllen Sie auch **Erlaubte Domains** aus, damit nur Ihre Seite den Chat laden darf. Alle Optionen stehen unter [Einstellungen des Website-Chats](/inbox/website-chat-instellingen).
</Step>
<Step>
### Das Snippet kopieren [#kopieer-het-snippet]
Klicken Sie unter **Auf Ihrer Website einbinden** auf **Snippet kopieren**. Steht der Block nicht da, speichern Sie die Einstellungen und laden Sie die Seite neu.
</Step>
<Step>
### Das Snippet auf Ihrer Seite einfügen [#plak-het-snippet-op-je-site]
Fügen Sie das Snippet vor dem schließenden `</body>`-Tag auf jeder Seite ein, auf der die Chat-Schaltfläche erscheinen soll. Bei einer Website mit gemeinsamer Vorlage oder Footer setzen Sie es einmal in diese Vorlage.
</Step>
</Steps>

## Was sehen Sie danach? [#wat-zie-je-daarna]

Öffnen Sie Ihre Website. Unten rechts steht eine Chat-Schaltfläche. Senden Sie selbst eine Testnachricht: Das Gespräch erscheint im Posteingang mit dem Kanal **Website-Chat**. Erklärungen dazu, was Sie und der Besucher zu sehen bekommen, stehen unter [Gespräche über Website-Chat](/inbox/website-chat-gesprekken).

<Callout type="info" title="Der Widget-Schlüssel ist öffentlich">
Der Schlüssel steht lesbar im Snippet, wie bei anderen Chat-Produkten. Begrenzen Sie Missbrauch mit **Erlaubte Domains** (durch Komma getrennte Hostnamen, zum Beispiel `recreatiepark-het-meer.be, www.recreatiepark-het-meer.be`). Lassen Sie das Feld leer, funktioniert der Chat auf jeder Domain, auf der das Snippet steht.
</Callout>

## Chat auf öffentlichen Tillor-Seiten [#chat-op-publieke-tillor-paginas]

Ist **Website-Chat** installiert, **Widget aktiviert** an und **Auf öffentlichen Tillor-Seiten anzeigen** an, erscheint die Chat-Schaltfläche auch auf den öffentlichen Seiten Ihrer Organisation. Dort müssen Sie kein Snippet einfügen. Dazu gehören unter anderem die Seiten für einen Zugangspass, eine offene Rechnung, einen NFC-Tag, die Organisationsdaten und die öffentliche Karte.

- Auf diesen Seiten verwendet Tillor die **Akzentfarbe** aus den Einstellungen.
- **Erlaubte Domains** gilt nur für Ihre eigene Website, nicht für die Tillor-Seiten.
- Schalten Sie **Widget aktiviert** aus, verschwindet die Schaltfläche überall. Schalten Sie nur **Auf öffentlichen Tillor-Seiten anzeigen** aus, funktioniert der Chat auf Ihrer eigenen Seite weiter.

## Den Chat vorübergehend ausschalten [#de-chat-tijdelijk-uitzetten]

Schalten Sie **Widget aktiviert** aus unter <UIPath>Einstellungen > Integrationen > Website-Chat</UIPath>. Die Integration bleibt installiert und Ihr Widget-Schlüssel ändert sich nicht. Schalten Sie den Schalter wieder an, um den Chat zurückzubringen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Chat-Schaltfläche erscheint nicht auf meiner Website">
Prüfen Sie zuerst, ob **Widget aktiviert** an ist. Steht bei **Erlaubte Domains** eine Liste, schauen Sie, ob der Hostname der Seite darin steht, inklusive `www.`, wenn Ihre Seite damit funktioniert. Prüfen Sie auch, ob das Snippet wirklich auf dieser Seite steht und nicht nur in einer Vorlage, die diese Seite nicht verwendet.
</Accordion>
<Accordion title="Das Einbettungs-Snippet lädt in den Einstellungen nicht">
Tillor zeigt dann die Meldung, dass das Snippet nicht geladen werden konnte. Speichern Sie die Einstellungen und laden Sie die Seite neu.
</Accordion>
<Accordion title="Der Chat steht auf Tillor-Seiten, aber nicht auf meiner Website">
Auf Tillor-Seiten ist kein Snippet nötig. Ihre eigene Seite zeigt den Chat nur mit dem Snippet aus Schritt 3.
</Accordion>
<Accordion title="Ich möchte ein eigenes Kontaktformular verbinden oder die Schaltfläche ersetzen">
Das erledigt ein Entwickler mit dem Widget-SDK. Siehe [Website-Chat-API](/ontwikkelaars/website-chat).
</Accordion>
<Accordion title="Ein Besucher sieht Du hast in kurzer Zeit viele Nachrichten gesendet">
Tillor begrenzt, wie viel ein Besucher über den Chat sendet, damit ein Skript deinen Posteingang und die Antworten von Tillie nicht überfluten kann: 10 Nachrichten pro Minute und 200 pro Tag pro Besucher sowie 30 pro Minute und 600 pro Tag für alle im selben Netzwerk zusammen (etwa das WLAN deines Campingplatzes). Anhänge: 10 pro Stunde pro Besucher und 50 pro Stunde pro Netzwerk. Nach einer Minute kann der Besucher weitermachen; bereits gesendete Nachrichten gehen nicht verloren.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Einstellungen des Website-Chats" href="/inbox/website-chat-instellingen" description="Alle Felder und Einbettungsoptionen" />
  <Card title="Gespräche über Website-Chat" href="/inbox/website-chat-gesprekken" description="Was Sie und der Besucher sehen" />
  <Card title="Website-Chat-API" href="/ontwikkelaars/website-chat" description="Eigenes Formular oder eigene Chat-Oberfläche verbinden" />
  <Card title="Posteingangs-KI-Assistent" href="/inbox/inbox-ai-assistant" description="Tillie antworten lassen" />
</Cards>


# WhatsApp Business (/de-DE/inbox/whatsapp-business-inbox)

Mit **WhatsApp Business** empfangen und beantworten Sie Kundennachrichten über WhatsApp im [Tillor-Posteingang](/inbox). Das ist **nicht** dasselbe wie WhatsApp-Benachrichtigungen über Twilio.

<Callout type="info">
Für automatische WhatsApp-Nachrichten (Benachrichtigungen) siehe [Twilio](/communicatie/providers/twilio). Die Marketplace-App **WhatsApp Business** ist nur für Posteingangsgespräche.
</Callout>

Bevor Sie beginnen:

- Sie benötigen die Berechtigung **Integrationen verwalten**.
- Sie haben ein WhatsApp-Business-Konto bei Meta und melden sich mit einem Konto an, das es verwaltet.

## Integration installieren [#integratie-installeren]

1. Gehen Sie zu **Einstellungen > Integrationen**
2. Öffnen Sie **WhatsApp Business** in der Liste (Markierung **2**)

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/marketplace-whatsapp.png" alt="Einstellungen > Integrationen - WhatsApp Business in der Liste" />

3. Klicken Sie auf **Installieren** (Markierung **1**) und schließen Sie den Meta-OAuth-Ablauf ab

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/whatsapp-install.png" alt="WhatsApp-Business-Details - Installieren" />

4. Wählen Sie, welche **WhatsApp-Nummer** Posteingangsnachrichten empfängt
5. Speichern Sie die Einstellungen

Nach der Installation empfängt Tillor eingehende Nachrichten automatisch. Antworten, die Sie auch über die WhatsApp-Business-App oder ein verbundenes Gerät senden, erscheinen im Posteingang. Nachrichten, die Sie über Tillor senden, werden nicht doppelt angezeigt.

## Wie geht es danach weiter? [#wat-gebeurt-er-daarna]

- Eingehende Nachrichten erscheinen automatisch im [Posteingang](/inbox), verknüpft mit dem Kunden mit derselben Telefonnummer.
- Antworten senden Sie in Tillor. Außerhalb des 24-Stunden-Fensters gehen sie als kostenpflichtige Vorlage hinaus, siehe [Gespräche lesen und beantworten](/inbox/gesprekken#whatsapp-en-het-antwoordvenster-van-24-uur).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Es kommen keine Nachrichten an">
Prüfen Sie unter <UIPath>Einstellungen > Integrationen > WhatsApp Business</UIPath>, ob die richtige **WhatsApp-Nummer** gewählt ist und ob die Einstellungen gespeichert wurden.
</Accordion>
<Accordion title="Meine Antworten gehen außerhalb des Antwortfensters nicht hinaus">
Fügen Sie im Meta WhatsApp Manager eine Zahlungsmethode für Ihr WhatsApp-Business-Konto hinzu. Ohne Zahlungsmethode blockiert Tillor kostenpflichtige Antworten.
</Accordion>
</Accordions>

## Verwandt [#gerelateerd]

<Cards>
  <Card title="Posteingang" href="/inbox" description="Gespräche lesen und beantworten" />
  <Card title="Messenger" href="/inbox/messenger" description="Facebook Messenger für den Posteingang" />
</Cards>


# Übersicht (/de-DE/integraties)

Eine Integration verbindet Tillor mit einem anderen Dienst, zum Beispiel für Zahlungen, Buchhaltung, Telefonie, Kameras oder Ihren Google-Eintrag. Sie verwalten alle unter <UIPath>Einstellungen > Integrationen</UIPath>. Wie Sie eine installieren, steht unter [Eine Integration installieren](/integraties/integratie-installeren).

<Requires permission="Integraties bekijken" />

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Integration gehört zu Ihrer ganzen Organisation, nicht zu einem einzelnen Benutzer. Nach der Installation wirkt die Verbindung dort, wo sie gebraucht wird: die Kameraverbindung bei Zugangspunkten, die E-Mail-Verbindung im Kundenprofil, die Zahlungsverbindung bei Rechnungen. Manche Verbindungen laufen über den Connector, ein kleines Programm auf einem Computer in Ihrem eigenen Netzwerk. Dieser muss dann online sein.

```mermaid
flowchart LR
  A[Einstellungen > Integrationen] --> B[Integration installieren]
  B --> C[Zahlungen und Rechnungen]
  B --> D[Kundenprofil und Posteingang]
  B --> E[Zugangspunkte und Kameras]
  E -. über .-> F[Connector in Ihrem Netzwerk]
```

<Callout type="info" title="Gut zu wissen">
- Ansehen ist mit der Berechtigung **Integrationen anzeigen** möglich. Installieren, anpassen und deinstallieren erfordert **Integrationen verwalten**.
- Deinstallieren lässt sich nicht rückgängig machen. Sie installieren die Integration danach neu und füllen die Daten erneut aus.
- Partoo erhält Ihre Öffnungszeiten der nächsten 90 Tage und jede Nacht ein Update. Siehe [Partoo](/integraties/partoo).
- Zahlungen, die länger als 24 Stunden zurückliegen, erhalten kein Kamera-Overlay mehr. Siehe [UniFi Protect](/integraties/unifi-protect).
- Welche Integrationen Sie sehen, hängt von Ihrer Organisation ab. Fehlt eine? Fragen Sie Ihren Tillor-Administrator oder den Support.
</Callout>

## Verfügbare Integrationen [#beschikbare-integraties]

| Integration | Wofür | Erklärung |
|---|---|---|
| Mollie | Online- und Kartenzahlungen, SEPA-Lastschrift | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) |
| Bankkonten | Banktransaktionen importieren und mit Rechnungen verknüpfen | [Ponto und Bankkonten](/boekhouden/betalingsrapporten/betaalmethodes/ponto) |
| Admisol | Zahlungsberichte an Ihre Buchhaltung senden | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) |
| Odoo | Kunden und Rechnungen nach Odoo exportieren | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) |
| ICY | Zähler auslesen | [Zählerverwaltung](/meterbeheer) |
| Voys | Telefongespräche mit Kunden verknüpfen | [Voys](/communicatie/providers/voys) |
| WhatsApp Business | WhatsApp-Nachrichten im Posteingang | [WhatsApp Business](/inbox/whatsapp-business-inbox) |
| Messenger | Facebook-Messenger-Gespräche im Posteingang | [Messenger](/inbox/messenger) |
| Instagram | Instagram-Direct-Gespräche im Posteingang | [Instagram](/inbox/instagram) |
| Website-Chat | Live-Chat auf Ihrer Website | [Website-Chat](/inbox/website-chat) |
| Posteingangs-KI-Assistent | Häufige Fragen automatisch beantworten | [Posteingangs-KI-Assistent](/inbox/inbox-ai-assistant) |
| UniFi Protect | Kameras mit Zugangspunkten und Zahlungen verbinden | [UniFi Protect](/integraties/unifi-protect) |
| Partoo | Öffnungszeiten auf Google und in anderen Einträgen angleichen | [Partoo](/integraties/partoo) |
| Outlook | E-Mails eines Kunden im Kundenprofil ansehen | [Outlook](/integraties/outlook) |

## Begriffe [#begrippen]

- **Integration**: eine Verbindung zwischen Tillor und einem externen Dienst.
- **Connector**: das Programm in Ihrem Netzwerk, das Geräte wie Kameras und Drucker mit Tillor verbindet. Siehe [Connector](/connector).
- **Installieren und deinstallieren**: eine Verbindung einschalten oder entfernen. Entfernen lässt sich nicht rückgängig machen.
- **API-Schlüssel**: ein geheimer Code, mit dem Tillor in einem anderen Dienst arbeiten darf.
- **Overlay**: Text, der über Kamerabilder läuft, zum Beispiel eine Zahlung.

Weitere Erklärungen stehen im [Glossar](/begrippen).

<Cards>
  <Card title="Eine Integration installieren" href="/integraties/integratie-installeren" description="Suchen, ausfüllen und verbinden" />
  <Card title="UniFi Protect" href="/integraties/unifi-protect" description="Kamerabilder bei Zugang und Zahlungen" />
  <Card title="Partoo" href="/integraties/partoo" description="Öffnungszeiten automatisch weiterleiten" />
  <Card title="Outlook" href="/integraties/outlook" description="Kunden-E-Mails im Kundenprofil" />
</Cards>


# Eine Integration installieren (/de-DE/integraties/integratie-installeren)

Eine Integration installieren Sie unter <UIPath>Einstellungen > Integrationen</UIPath>. Sie suchen sie, tragen die Daten des externen Dienstes ein und klicken auf **Installieren**. Danach passen Sie sie im Block **Einstellungen** an oder entfernen sie mit **Deinstallieren**. Was verfügbar ist, steht in der [Übersicht](/integraties).

<Requires permission="Integrationen verwalten" />

Bevor Sie beginnen:

- Mit dem Recht **Integrationen anzeigen** allein sehen Sie die Liste und die Einstellungen, können aber nichts ändern.
- Halten Sie die Zugangsdaten oder Schlüssel des externen Dienstes bereit. Bei Outlook werden Sie weitergeleitet, um sich dort selbst anzumelden.
- Bei einer Verbindung, die über den Connector läuft, zum Beispiel UniFi Protect, muss der Connector online sein.

## Eine Integration installieren [#een-integratie-installeren]

<Steps>
<Step>
### Integration suchen [#zoek-de-integratie]
Nutzen Sie die Suchleiste oder wählen Sie links unter **Integrationen** eine Kategorie: **Kommunikation**, **Überwachung**, **Zahlungen**, **Buchhaltung** oder **Zähler**. **Alle Integrationen** zeigt alles. Eine Integration, die bereits verbunden ist, trägt das Label **Verbunden**.

<DocScreenshot src="/screenshots/integraties/integrations-overview.png" alt="Einstellungen > Integrationen mit der Liste der Integrationen" />
</Step>
<Step>
### Integration öffnen [#open-de-integratie]
Klicken Sie darauf. Manche Seiten haben oben den Link **Dokumentation ansehen**.
</Step>
<Step>
### Daten eintragen und auf Installieren klicken [#vul-de-gegevens-in-en-klik-op-installeren]
Was Sie eintragen, hängt vom Dienst ab. Bei Outlook werden Sie zum Dienst selbst weitergeleitet, um sich anzumelden.
</Step>
</Steps>

## Anpassen oder entfernen [#aanpassen-of-verwijderen]

Nach der Installation steht auf derselben Seite ein Block **Einstellungen**. Passen Sie dort die Verbindung an und speichern Sie. Mit **Deinstallieren** entfernen Sie die Verbindung. Das lässt sich nicht rückgängig machen.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Verbindung gilt sofort für Ihre gesamte Organisation.
- Was die Verbindung tut, sehen Sie an der Stelle, wo sie hingehört, zum Beispiel im Kundenprofil oder an einem Zugangspunkt.
- Nach **Deinstallieren** stoppt die Verbindung. Was bereits im anderen Dienst steht, bleibt dort stehen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe Keine Integrationen gefunden">
Es gibt keine Integration, die zu Ihrem Suchbegriff oder Ihrer Kategorie passt. Probieren Sie einen anderen Suchbegriff oder wählen Sie **Alle Integrationen**. Fehlt eine Integration, die Sie erwarten, ist sie für Ihre Organisation nicht freigeschaltet. Fragen Sie den Support.
</Accordion>
<Accordion title="Die Schaltfläche Installieren ist grau oder fehlt">
Sie haben das Recht **Integrationen verwalten** nicht. Fragen Sie Ihren Administrator.
</Accordion>
<Accordion title="Tillor meldet Verbindung fehlgeschlagen">
Die Integration konnte nicht verbunden werden. Prüfen Sie die eingetragenen Daten und versuchen Sie es erneut.
</Accordion>
<Accordion title="Tillor meldet Trennung fehlgeschlagen">
Versuchen Sie es erneut. Klappt es nicht, schreiben Sie an support@tillor.eu.
</Accordion>
<Accordion title="Tillor meldet App-Einstellungen konnten nicht aktualisiert werden">
Ihre Änderung wurde nicht gespeichert. Versuchen Sie erneut zu speichern.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Übersicht der Integrationen" href="/integraties" description="Alle verfügbaren Verbindungen" />
  <Card title="Connector" href="/connector" description="Das Programm in Ihrem Netzwerk" />
</Cards>


# Outlook verbinden (/de-DE/integraties/outlook)

Mit der Outlook-Verbindung sehen Sie im Kundenprofil die E-Mails, die Ihre Organisation mit diesem Kunden ausgetauscht hat. Tillor ruft sie live aus Outlook ab und speichert sie nicht selbst.

<Requires permission="Integrationen verwalten" />

Bevor Sie beginnen:

- Sie benötigen ein Microsoft-Konto, dessen E-Mails Tillor lesen darf.
- Um die E-Mails im Kundenprofil zu sehen, benötigen Sie das Recht **Posteingang anzeigen**. Ohne dieses Recht fehlt der Tab **Outlook**.

## Installieren [#installeren]

<Steps>
<Step>
### Integration öffnen [#open-de-integratie]
Gehen Sie zu <UIPath>Einstellungen > Integrationen > Outlook</UIPath>.
</Step>
<Step>
### Auf Installieren klicken [#klik-op-installeren]
Sie werden zu Microsoft weitergeleitet.
</Step>
<Step>
### Anmelden und Zustimmung geben [#log-in-en-geef-toestemming]
Melden Sie sich mit dem Konto an, dessen E-Mails Tillor lesen darf.

<DocScreenshot src="/screenshots/integraties/integrations-outlook.png" alt="Outlook installieren" />
</Step>
</Steps>

Nach dem Verbinden sehen Sie unter **Einstellungen** den Namen, die E-Mail-Adresse und den Benutzernamen des verbundenen Kontos sowie das Datum, bis zu dem die Verbindung aktiv ist.

## Postfächer wählen [#mailboxen-kiezen]

Standardmäßig sucht Tillor nur im Postfach des verbundenen Kontos. Unter **Postfächer** wählen Sie zusätzliche Postfächer, zum Beispiel ein gemeinsames Postfach der Rezeption.

- **Persönlich** ist das Postfach des verbundenen Kontos.
- **Freigegeben** sind gemeinsame Postfächer, die dieses Konto öffnen kann. Tillor sucht sie selbst.
- **Manuell hinzugefügt** sind Adressen, die Sie selbst eintippen. Tippen Sie die Adresse ein und wählen Sie **[Adresse] hinzufügen**.

## E-Mails im Kundenprofil [#mail-op-het-klantprofiel]

Im Kundenprofil erscheint ein Tab **Outlook**, zwischen **Kommunikation** und **Ereignisse**. Der Tab ist nur da, wenn Outlook verbunden ist und Sie das Recht **Posteingang anzeigen** haben.

- Oben stehen die Anzahl der Nachrichten und die Postfächer, in denen gesucht wurde. Mit **Aktualisieren** rufen Sie die neuesten E-Mails ab.
- Tillor sucht nach der E-Mail-Adresse des Kunden und seiner Kontakte. Hat niemand eine E-Mail-Adresse, steht dort, dass es nichts zu suchen gibt.
- Jede Nachricht zeigt Betreff, ob sie **Empfangen** oder **Gesendet** wurde, von wem an wen, und eine Büroklammer bei Anhängen. Klicken Sie auf eine Nachricht, um den Text und die Anhänge zu öffnen. Mit **In Outlook öffnen** gehen Sie zur Nachricht in Outlook selbst.
- Dieselbe E-Mail in mehreren Postfächern steht nur einmal in der Liste.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Tillor liest die E-Mails nur mit und speichert nichts. Entfernen Sie die Verbindung, verschwindet der Tab **Outlook** aus dem Kundenprofil.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Kontodaten nicht verfügbar">
Tillor konnte das verbundene Microsoft-Konto nicht abrufen. Laden Sie die Seite neu oder verbinden Sie Outlook erneut über **Installieren**.
</Accordion>
<Accordion title="Neu verbinden, um freigegebene Postfächer zu finden">
Outlook wurde verbunden, bevor Tillor freigegebene Postfächer suchen konnte. Klicken Sie auf **Outlook neu verbinden** oder tippen Sie die Adresse des freigegebenen Postfachs selbst ein.
</Accordion>
<Accordion title="Freigegebene Postfächer konnten nicht geladen werden">
Sie können weiterhin manuell eine Postfachadresse unter **Manuell hinzugefügt** eintippen.
</Accordion>
<Accordion title="Outlook-Mail nicht verfügbar">
Tillor konnte keine E-Mails aus Outlook laden. Versuchen Sie es erneut mit **Aktualisieren** oder prüfen Sie die Verbindung.
</Accordion>
<Accordion title="Einige Postfächer konnten nicht durchsucht werden">
Das verbundene Konto hat keinen Zugriff auf dieses Postfach. Prüfen Sie die Postfachberechtigungen in Outlook.
</Accordion>
<Accordion title="Ich sehe keinen Tab Outlook im Kundenprofil">
Outlook ist nicht verbunden, oder Ihnen fehlt das Recht **Posteingang anzeigen**.
</Accordion>
<Accordion title="Diese Nachricht konnte nicht geladen werden">
Versuchen Sie, die Nachricht noch einmal zu öffnen. Hilft das nicht, gehen Sie mit **In Outlook öffnen** zur Nachricht selbst.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Das Kundenprofil und seine Tabs" />
  <Card title="Integrationen" href="/integraties" description="Alle verfügbaren Verbindungen" />
</Cards>


# Partoo verbinden (/de-DE/integraties/partoo)

Partoo verwaltet Ihre Einträge bei Google und auf anderen Seiten. Mit dieser Verbindung sendet Tillor Ihre Öffnungszeiten an Ihren Partoo-Standort, sodass Sie sie nicht an zwei Stellen pflegen müssen. Die Zeiten selbst verwalten Sie in Tillor, siehe [Organisationseinstellungen](/gebruikers/organisaties#openingsuren).

<Requires permission="Integrationen verwalten" />

Bevor Sie beginnen:

- Legen Sie in Partoo einen eigenen Benutzer für Tillor an, ohne zweistufige Anmeldung. Bei einer zweistufigen Anmeldung kann sich Tillor nicht anmelden.
- Tragen Sie Ihre Öffnungszeiten in Tillor ein, siehe den Abschnitt Öffnungszeiten bei den Organisationseinstellungen.

## Installieren [#installeren]

<Steps>
<Step>
### Integration öffnen [#open-de-integratie]
Gehen Sie zu <UIPath>Einstellungen > Integrationen > Partoo</UIPath>.
</Step>
<Step>
### Daten des Partoo-Benutzers eintragen [#vul-de-gegevens-van-de-partoo-gebruiker-in]
Tragen Sie **E-Mail** und **Passwort** dieses Benutzers ein.
</Step>
<Step>
### Standort wählen [#kies-je-vestiging]
Die Liste der Standorte erscheint erst, nachdem E-Mail und Passwort eingetragen sind. Wählen Sie bei **Standort** Ihren Standort. Zum Suchen tippen Sie bei **Standorte suchen…**.
</Step>
<Step>
### Auf Installieren klicken [#klik-op-installeren]

<DocScreenshot src="/screenshots/integraties/integrations-partoo.png" alt="Partoo installieren" />
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

Tillor sendet Ihre Wochenzeiten, Saisons und Ausnahmetage aus den [Öffnungszeiten Ihrer Organisation](/gebruikers/organisaties#openingsuren):

- Die Wochenzeiten sind die der aktuellen Woche. Partoo kennt keine Saisons, daher sendet Tillor die Zeiten der Saison, die gerade gilt.
- Tage in den kommenden 90 Tagen, deren Zeiten abweichen, etwa wegen einer anderen Saison, eines Feiertags oder einer Ausnahme, werden als eigene Daten mitgesendet. Ein geschlossener Zeitraum wird zu einem Zeitraum.
- Tillor sendet dies jede Nacht und direkt nach jeder Änderung an den Öffnungszeiten, der Zeitzone, dem Standardland oder der Verbindung selbst. Es wird nur angepasst, was sich von Partoo unterscheidet.

## Anpassen oder entfernen [#aanpassen-of-verwijderen]

Passen Sie E-Mail, Passwort oder Standort im Block **Einstellungen** an. Lassen Sie das Passwort leer, um das aktuelle zu behalten. Mit **Deinstallieren** stoppt die Weiterleitung. Was bereits in Partoo steht, bleibt dort stehen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Partoo hat diese E-Mail oder dieses Passwort abgelehnt">
Prüfen Sie die Daten des Partoo-Benutzers. Hat dieser Benutzer die zweistufige Anmeldung aktiviert, schalten Sie sie aus oder legen Sie einen eigenen Benutzer an.
</Accordion>
<Accordion title="Dieser Partoo-Benutzer sieht keinen Standort">
Geben Sie dem Partoo-Benutzer in Partoo Zugriff auf Ihren Standort und schauen Sie dann erneut nach.
</Accordion>
<Accordion title="Die Standorte konnten nicht aus Partoo geladen werden">
Versuchen Sie es gleich noch einmal. Bleibt das Problem bestehen, schreiben Sie an support@tillor.eu.
</Accordion>
<Accordion title="Die Zeiten bei Google stimmen nicht">
Prüfen Sie zuerst die Öffnungszeiten in Tillor, die Zeitzone und das Standardland. Nach einer Änderung sendet Tillor sie sofort weiter, und jede Nacht noch einmal.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Organisationseinstellungen" href="/gebruikers/organisaties" description="Öffnungszeiten, Saisons und Ausnahmen" />
  <Card title="Integrationen" href="/integraties" description="Alle verfügbaren Verbindungen" />
</Cards>


# UniFi Protect verbinden (/de-DE/integraties/unifi-protect)

Mit der UniFi-Protect-Verbindung gelangen Sie von einem Zugangsversuch oder einem Zugangspunkt-Ereignis mit einem Klick zur Aufzeichnung der zugehörigen Kamera. Bar- und Kartenzahlungen können außerdem als Text über den Bildern einer Kamera laufen, sodass Sie bei einer Kassendifferenz zurückschauen können. Die Installation ist dieselbe wie bei jeder Integration, siehe [Eine Integration installieren](/integraties/integratie-installeren).

<Requires permission="Integrationen verwalten" />

Bevor Sie beginnen:

- Die Kameras werden über den [Connector](/connector) in Ihrem Park ausgelesen. Er muss online sein. Ist er es nicht, meldet Tillor **Der Tillor-Connector ist offline oder nicht erreichbar.**
- Sie benötigen die Daten Ihrer UniFi-OS-Konsole. Das ist das Kästchen oder der Server, auf dem UniFi Protect läuft.
- Für die Verbindung mit Zugangspunkten müssen diese Zugangspunkte existieren, siehe [Zugangskontrolle](/toegangscontrole).

## Installieren [#installeren]

<Steps>
<Step>
### Integration öffnen [#open-de-integratie]
Gehen Sie zu <UIPath>Einstellungen > Integrationen > UniFi Protect</UIPath>.
</Step>
<Step>
### Konsole eintragen [#vul-de-console-in]
- **Konsolen-Host**: die lokale IP-Adresse oder der Hostname Ihrer UniFi-OS-Konsole.
- **API-Schlüssel**: ein geheimer Code, den Sie in der Konsole anlegen und mit dem Tillor Kameras auslesen darf.
- **Cloud-Konsolen-ID**: die lange ID nach `/consoles/` in der unifi.ui.com-URL Ihrer Konsole.
</Step>
<Step>
### Zahlungskameras wählen [#kies-de-betaalcameras]
Wählen Sie bei **Kamera Bargeldzahlungen** und **Kamera POS-Zahlungen** eine Kamera, oder lassen Sie **Nicht registrieren** stehen. POS ist das Kartenterminal.
</Step>
<Step>
### Auf Installieren klicken [#klik-op-installeren]
Sobald Host und API-Schlüssel eingetragen sind, lädt Tillor die Kameras der Konsole.

<DocScreenshot src="/screenshots/integraties/integrations-unifi-protect.png" alt="UniFi Protect installieren" />
</Step>
</Steps>

## Kameras mit Zugangspunkten verbinden [#cameras-koppelen-aan-toegangspunten]

Nach der Installation steht im Block **Einstellungen** die Tabelle **Kameras pro Zugangspunkt**. Ordnen Sie jedem **Zugangspunkt** eine **Kamera** zu. Ist die Liste leer, fügen Sie zuerst Zugangspunkte hinzu.

Danach steht in den Details eines Zugangsversuchs und eines Zugangspunkt-Ereignisses der Link **In UniFi Protect öffnen**. Er öffnet die Aufzeichnung rund um diesen Zeitpunkt in UniFi Protect, in einem neuen Tab.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Haben Sie bei **Kamera Bargeldzahlungen** oder **Kamera POS-Zahlungen** eine Kamera gewählt, sendet Tillor jede Zahlung, die auf **Bezahlt** wechselt, an diese Kamera. Barzahlungen gehen an die Barkamera, Kartenzahlungen an einem Terminal an die POS-Kamera.
- Zahlungen, die vor mehr als 24 Stunden bezahlt wurden, erhalten keinen Text mehr über den Bildern.
- Zahlungen über Mollie zählen nur mit, wenn sie zum Hauptprofil von Mollie gehören.
- Ändern Sie die Daten, speichern Sie. Lassen Sie den **API-Schlüssel** leer, bleibt der bestehende Schlüssel gültig. Mit **Deinstallieren** entfernen Sie die Verbindung.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Keine Kameras auf dieser UniFi Protect-Konsole gefunden">
Die Konsole hat keine Kameras, oder der API-Schlüssel hat keinen Zugriff darauf. Prüfen Sie den Schlüssel und ob die Kameras in UniFi Protect sichtbar sind.
</Accordion>
<Accordion title="Kameras von UniFi Protect konnten nicht geladen werden">
Prüfen Sie den Host, den API-Schlüssel und ob der Connector online ist. Tillor meldet: **Prüfen Sie Host, API-Schlüssel und Connector.**
</Accordion>
<Accordion title="Der Tillor-Connector ist offline oder nicht erreichbar">
Kameras werden über den Connector in Ihrem lokalen Netzwerk geladen. Starten Sie den Connector oder stellen Sie die Verbindung wieder her, siehe [Connector](/connector).
</Accordion>
<Accordion title="Ich sehe In UniFi Protect öffnen bei einem Zugangsversuch nicht">
Diesem Zugangspunkt ist keine Kamera zugeordnet. Ordnen Sie in der Tabelle **Kameras pro Zugangspunkt** eine zu.
</Accordion>
<Accordion title="Die Zahlung steht nicht über den Bildern">
Prüfen Sie, ob die Kamera bei **Kamera Bargeldzahlungen** oder **Kamera POS-Zahlungen** nicht auf **Nicht registrieren** steht. Eine Zahlung, die vor mehr als 24 Stunden bezahlt wurde, erhält kein Overlay mehr. Eine Mollie-Zahlung zählt nur beim Hauptprofil mit.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zugangskontrolle" href="/toegangscontrole" description="Zugangsprotokoll und Zugangspunkte" />
  <Card title="Connector" href="/connector" description="Die Verbindung zu Ihrem lokalen Netzwerk" />
  <Card title="Integrationen" href="/integraties" description="Alle verfügbaren Verbindungen" />
</Cards>


# Karte (/de-DE/kaart)

Auf dem Lageplan sehen Sie auf einen Blick, welche Parzellen frei, reserviert oder belegt sind, für jeden Tag, den Sie wählen. Hier zeichnen Sie auch die Grenzen Ihrer Parzellen ein, damit Tillor ihre Fläche kennt, und messen Entfernungen. Ihre Parzellen selbst verwalten Sie unter [Parzellen](/terreinen).

<Callout type="info" title="Gut zu wissen">
- Die Karte öffnet immer auf heute. Ihr Stil, die Labels und die Ebenen bleiben dagegen gespeichert.
- Ausgecheckte und stornierte Reservierungen zählen nicht für Farbe, Abreise-Label oder Doppelbuchung.
- Die Labels mit Nächten und Abreise verschwinden unterhalb der Zoomstufe 17,5. Der Parzellenname bleibt stehen.
- Eine Parzelle ohne eingezeichnete Grenze steht nicht auf der Karte. Zeichnen geht nur bei eingeschaltetem **Bearbeitungsmodus**.
- Die Karte öffnet auf dem Kartenzentrum, das Sie unter **Einstellungen > Karte** festlegen. Derselbe Punkt bestimmt auch das Wetter.
</Callout>

## Die Karte öffnen [#de-kaart-openen]

Gehen Sie zu <UIPath>Park > Karte</UIPath>. Sie sehen sofort alle Parzellen mit ihrem Belegungsstatus.


<DocScreenshot src="/screenshots/park/map-overview.png" alt="Lageplan mit eingezeichneter Parzelle 12" />

- **Grüne Fläche** - buchbare Parzelle ist frei
- **Graue Fläche** - Parzelle ist **nicht buchbar** und hat am gewählten Datum keinen aktiven Aufenthalt (keine Reservierung oder Belegung); die Labels für Nächte und Abreise fehlen
- **Cyanfarbene Fläche** - Reservierung **gebucht**, noch nicht eingecheckt (auch an späteren Tagen des Aufenthaltszeitraums, solange nicht eingecheckt ist)
- **Blaue Fläche** - Reservierung **eingecheckt** (aktiver Aufenthalt am gewählten Datum)
- **Gelbe Fläche** - die Parzelle hat eine aktive Belegung (Dauermiete; gilt an jedem gewählten Datum, solange die Belegung läuft)
- **Rote Fläche** (leichtes Overlay, roter Rand) - Doppelbuchung: überlappende Reservierungszeiträume auf derselben Parzelle

Klicken Sie auf eine Parzelle auf der Karte, um ein Pop-up mit dem Namen, den Reservierungen, einer eventuellen aktiven Belegung (Gast) und Verknüpfungen zu öffnen.

## Datum wählen [#datum-kiezen]

Rechts neben **Karteneinstellungen** wählen Sie ein **Datum** (standardmäßig heute). Die Karte zeigt dann, wie die Parzellen an diesem Tag aussehen. Nach einem Neuladen der Seite steht das Datum wieder auf **heute**; nur die übrigen Karteneinstellungen (Stil, Labels, Ebenen) bleiben gespeichert. **Ausgecheckte** und **stornierte** Reservierungen zählen nicht für Farbe, Abreise-Label oder Doppelbuchung (sie erscheinen auch nicht im Pop-up auf der Karte). Bei freien Plätzen steht unter dem Parzellennamen ein Label mit Mond-Symbol und der Anzahl der Nächte bis zum nächsten Check-in. Bei einer Reservierung oder Belegung mit Abreisedatum steht ein Label mit Abreise-Symbol und der Anzahl der Nächte bis zum Check-out (0 = heute). Bewegen Sie die Maus über ein Label für den vollständigen Text. Bei einer **Doppelbuchung** (zwei oder mehr Reservierungen mit überlappenden Aufenthaltszeiträumen auf derselben Parzelle) erhält die Parzelle einen roten Rand und ein leichtes rotes Overlay; vor der Parzellennummer steht ein rotes Dreieck-Symbol. Im Pop-up sehen Sie eine Warnung mit den betroffenen Reservierungen. Unterhalb der Zoomstufe **17,5** blendet die Karte die Labels für Nächte und Abreise automatisch aus; der Parzellenname bleibt sichtbar. Zoomen Sie auf mindestens **17,5** hinein (oder schalten Sie **Nächte und Abreise** in den Karteneinstellungen aus), um diese Labels zu sehen. Beim Herauszoomen werden Parzellennamen kleiner angezeigt, damit sie sich weniger überlappen.

## Ebenen und Farben [#lagen-en-kleuren]

Unten links stehen drei Schaltflächen: **Ebenen**, **Als PDF exportieren** und **Karteneinstellungen**, rechts daneben die Datumsauswahl. Mit **Ebenen** bestimmen Sie, was Sie sehen und wie die Parzellen eingefärbt sind.

<DocScreenshot src="/screenshots/instellingen/map-layers.png" alt="Lageplan mit dem Bereich Ebenen" />

- Bei **Farben** wählen Sie **Belegung** oder **Parzellentyp**. Bei **Belegung** werden die Parzellen eingefärbt wie oben beschrieben. Bei **Parzellentyp** erhält jede Parzelle die **Kartenfarbe** ihres Typs, siehe [Parzellentypen](/terreinen#terreintypes).
- Bei **Belegung** steht unter **Parzellenebenen** ein Häkchen pro Art: **Frei**, **Reserviert**, **Eingecheckt**, **Belegt**, **Nicht buchbar** und **Doppelbuchung**. Entfernen Sie ein Häkchen, um diese Parzellen auszublenden.
- Unter **Terrain-Typen** wählen Sie, welche Typen auf der Karte erscheinen. **Kein Typ** gehört zu Parzellen ohne Typ.

Mit **Als PDF exportieren** laden Sie ein PDF mit den Parzellen herunter, die jetzt auf der Karte stehen: Name, Fläche, Gas und berechneter Preis, am gewählten Datum.

## Karteneinstellungen [#kaartinstellingen]

Mit **Karteneinstellungen** passen Sie die Darstellung an.

<DocScreenshot src="/screenshots/instellingen/map-settings.png" alt="Lageplan mit dem Bereich Karteneinstellungen" />

| Einstellung | Beschreibung |
|------------|--------------|
| **Stil** | **Satellit**, **Hybrid** oder **Straßen** |
| **Bearbeitungsmodus** | Zeigt die Werkzeuge zum Zeichnen und Bearbeiten von Parzellengrenzen |
| **Parzellennamen** | Zeigt Parzellennamen auf der Karte. Funktioniert nur, wenn mindestens eine Ebene aktiv ist |
| **Nächte und Abreise** | Zeigt bei den Parzellennamen, wie viele Nächte frei sind und wann ein Aufenthalt endet. Funktioniert nur, wenn **Parzellennamen** aktiv ist |

Ihre Einstellungen werden automatisch gespeichert.

## Kartenstandard festlegen [#kaartstandaard-instellen]

<Requires permission="Einstellungen bearbeiten" />

Unter <UIPath>Support > Einstellungen > Karte</UIPath> legen Sie fest, wo die Karte öffnet und wie sie gedreht ist.

<DocScreenshot src="/screenshots/instellingen/settings-map.png" alt="Einstellungen > Karte" />

| Einstellung | Beschreibung |
|---|---|
| **Kartenzentrum** | Klicken Sie auf die Karte oder ziehen Sie die Stecknadel in die Mitte Ihres Parks. Darunter stehen die Koordinaten. |
| **Kartenausrichtung** | Die Kompassrichtung in Grad (0-360), mit der der Lageplan öffnet. |

Das Kartenzentrum zählt auch außerhalb der Karte. Es ist der Ort, für den das Wetter unter <UIPath>Park > Wetter</UIPath> abgerufen wird, und Adressvorschläge beim Eintragen einer Adresse bevorzugen Orte in der Nähe. Haben Sie bei **Apple Wallet** keinen **Standort Zugangspunkt** gesetzt, verwenden Apple Wallet und Google Wallet das Kartenzentrum für den Zugangspass. Siehe [Organisation](/gebruikers/organisaties#apple-wallet). Steht das Zentrum an der falschen Stelle, stimmt also auch das Wetter nicht.

## Parzellengrenzen einzeichnen [#terreingrenzen-intekenen]

Mit dem Bearbeitungsmodus legen Sie die exakte Grenze einer Parzelle auf der Karte fest. Tillor berechnet daraus die Fläche in m², und die verwendet die Tarifformel.

1. Gehen Sie zu **Park > Karte**
2. Klicken Sie unten links auf **Karteneinstellungen**
3. Schalten Sie den **Bearbeitungsmodus** ein
4. Klicken Sie auf die gewünschten Punkte auf der Karte, um ein Polygon zu zeichnen
5. Schließen Sie das Polygon, indem Sie auf den Startpunkt klicken
6. Wählen Sie im Dialogfenster die Parzelle, die Sie verknüpfen möchten

<DocScreenshot src="/screenshots/park/map-terrain-select-dialog.png" alt="Dialog zur Parzellenverknüpfung nach dem Zeichnen eines Polygons" />

7. Klicken Sie auf **"Aktualisieren"**

Die Parzelle erscheint nun als farbige Fläche auf dem Lageplan.

<Callout type="info">
Parzellen ohne eingezeichneten Standort stehen oben in der Auswahlliste, damit Sie sie leicht finden und verknüpfen können.
</Callout>

## Entfernungen messen [#afstanden-meten]

Mit der Messfunktion messen Sie schnell Entfernungen und Flächen auf der Karte - praktisch bei der Aufteilung des Geländes oder beim Abschätzen von Entfernungen zwischen Orten.

1. Klicken Sie links oben auf der Karte auf **Entfernung messen** oder **Fläche messen**
2. Setzen Sie Punkte auf der Karte (eine Fläche schließen Sie ab, indem Sie auf den Startpunkt klicken)
3. Die Messung wird auf der Karte angezeigt; mit **Messungen löschen** beginnen Sie von vorn

## Eine Parzelle von der Karte aus öffnen [#een-terrein-openen-vanaf-de-kaart]

Über die Karte gelangen Sie schnell zu einer Parzelle:

1. Klicken Sie auf eine Parzelle auf der Karte
2. Das Pop-up zeigt den Namen, den Belegungsstatus, aktive Reservierungen und bei einer Belegung den Gast
3. Klicken Sie auf **"Details anzeigen"**, um zur Detailseite zu gehen
4. Solange es keine aktive Belegung gibt, können Sie **"Reservierung erstellen"** starten

## Was passiert nach dem Einzeichnen? [#wat-gebeurt-er-na-het-intekenen]

- Die Parzelle erhält eine Farbe auf der Karte, und Tillor trägt die **Fläche** auf der Parzellenseite ein.
- Der **Berechnete Tarif** wird neu berechnet, denn die Fläche zählt mit. Siehe [Parzellen](/terreinen#hoe-het-tarief-tot-stand-komt).
- Die **Gesamtfläche** oben in der Parzellenliste zählt die Parzelle ab sofort mit.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Meine Parzelle steht nicht auf der Karte">
Die Parzelle hat noch keine eingezeichnete Grenze. Schalten Sie den **Bearbeitungsmodus** ein, zeichnen Sie die Parzelle und wählen Sie sie im Dialogfenster. Parzellen ohne Standort stehen oben in der Auswahlliste. Steht die Parzelle doch dort, prüfen Sie bei **Ebenen**, ob die Ebene ihres Status aktiv ist.
</Accordion>
<Accordion title="Die Labels mit Nächten und Abreise fehlen">
Zoomen Sie auf mindestens Stufe 17,5 hinein und prüfen Sie in den **Karteneinstellungen**, ob sowohl **Parzellennamen** als auch **Nächte und Abreise** aktiv sind. Graue, nicht buchbare Parzellen ohne Aufenthalt haben nie ein solches Label.
</Accordion>
<Accordion title="Die Karte öffnet an der falschen Stelle oder zeigt das falsche Wetter">
Das Kartenzentrum steht falsch. Verschieben Sie die Stecknadel unter <UIPath>Support > Einstellungen > Karte</UIPath>.
</Accordion>
<Accordion title="Ich sehe Reservierung erstellen nicht im Pop-up">
Diese Auswahl gibt es nur, wenn die Parzelle keine aktive Belegung hat.
</Accordion>
<Accordion title="Die Karte zeigt das heutige Datum, auch nach meiner Auswahl">
Das gewählte Datum wird nicht gespeichert. Nach einem Neuladen steht die Karte wieder auf heute.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Parzellen" href="/terreinen" description="Parzellen anlegen, Tarif und Zähler" />
  <Card title="Reservierungen" href="/reserveringen" description="Aufenthalte planen und verwalten" />
  <Card title="Park" href="/park" description="Übersicht der Parkverwaltung" />
</Cards>


# Kundenverwaltung (/de-DE/klantenbeheer)

Ein Kunde ist der Ort in Tillor, an dem alles über eine Person oder ein Unternehmen zusammenläuft: Daten, Kontaktpersonen, Rechnungen, Belegungen, Reservierungen, Dokumente und Zugang. Sie legen einen Kunden an, finden ihn in der Liste wieder und aktualisieren seine Daten im Kundenprofil. Beginnen Sie bei [Einen neuen Kunden hinzufügen](#een-nieuwe-klant-toevoegen).

<Callout type="info" title="Gut zu wissen">
- Beim Anlegen ist nur der **Vorname** Pflicht. Alle anderen Daten ergänzen Sie später im Kundenprofil.
- Tillor warnt bei einem **möglichen Doppelkunden**, wenn Vor- und Nachname zusammen, die E-Mail-Adresse oder die Telefonnummer bereits bei einem anderen Kunden stehen. Eine E-Mail-Adresse oder Telefonnummer zählt ab 4 Zeichen.
- Adressvorschläge erscheinen ab 3 getippten Zeichen im Feld **Straße**.
- Scans von Ausweisen ohne verknüpften Kunden löscht Tillor nach 7 Tagen.
- Das Löschen eines Kunden entfernt auch alle zugehörigen Daten und lässt sich nicht rückgängig machen.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Alles, was Sie in Tillor erfassen, hängt an einem Kunden. Eine Belegung verknüpft den Kunden mit einer Parzelle und damit auch mit den Zählern auf dieser Parzelle. Der Verbrauch dieser Zähler kommt auf die Rechnung des Kunden.

```mermaid
flowchart LR
  K[Kunde] --> C[Kontaktpersonen]
  K --> R[Reservierungen]
  K --> B[Belegungen]
  B --> T[Parzelle]
  T --> M[Zähler]
  M --> V[Verbrauch]
  V --> F[Rechnungen]
  K --> F
  F --> P[Zahlungen]
  K --> D[Dokumente und Unterschriftsanfragen]
  K --> O[Kommentare und Aufgaben]
```

## Einen neuen Kunden hinzufügen [#een-nieuwe-klant-toevoegen]

Bevor Sie beginnen:

- Ein Identitätsscan, wenn Sie den Kunden damit anlegen möchten. Steht kein Scan in der Warteschlange, wählen Sie einfach die manuelle Eingabe.
- Sie sind nicht sicher, ob der Kunde schon existiert? Suchen Sie ihn zuerst in der Liste, siehe [Kunden suchen und filtern](#klanten-zoeken-en-filteren).

<Steps>
<Step>
### Kundenliste öffnen [#open-de-klantenlijst]
Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath> und klicken Sie rechts oben auf **Neuen Kunden anlegen**. Solange offene Identitätsscans vorhanden sind, zeigt die Schaltfläche ein Menü mit **Manuell** und den Scans aus der Warteschlange.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Neuen Kunden anlegen mit dem Menü für einen offenen Identitätsscan" />
</Step>
<Step>
### Wählen, wie Sie den Kunden anlegen [#kies-hoe-je-de-klant-aanmaakt]
<Tabs items={["Von Hand", "Aus einem Identitätsscan"]}>
<Tab value="Von Hand">
Wählen Sie **Manuell**. Es öffnet sich ein Formular mit **Vorname**, **Nachname**, **E-Mail-Adresse** und **Telefonnummer**. Tragen Sie ein, was Sie wissen, und klicken Sie auf **Kunde anlegen**. Existiert möglicherweise schon ein Kunde mit ähnlichen Daten, erscheint unten ein gelber Hinweis mit einem Link zu diesem Kunden.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Dialog Neuen Kunden anlegen (Manuell)" />
</Tab>
<Tab value="Aus einem Identitätsscan">
Wählen Sie einen Scan aus dem Menü, zum Beispiel **Lotte Peeters**. In der Bestätigung sehen Sie eine Vorschau des Dokuments (Vorderseite, Rückseite, Porträt) und die Daten aus der maschinenlesbaren Zone. Klicken Sie auf **Kunde anlegen**. Tillor legt den Kunden an, verknüpft den Scan und füllt die Daten aus dem Dokument ein.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Bestätigung nach der Wahl eines offenen Identitätsscans" />

Offene Scans stehen auch im Bereich rechts unten, mit **Kunden auf Basis dieses Scans anlegen**. Mehr zu Scans steht unter [Identitätsscans](/identiteitsscans).

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Bereich rechts unten mit einem offenen Identitätsscan" />
</Tab>
</Tabs>
</Step>
<Step>
### Auf einen Doppelkunden prüfen [#controleer-op-een-dubbele-klant]
Existiert möglicherweise schon ein Kunde mit demselben Namen, derselben E-Mail-Adresse oder Telefonnummer, zeigt Tillor **Möglicher Doppelkunde** mit dem Namen und der Kundennummer. Klicken Sie auf **Diesen Kunden verwenden**, um diesen Kunden zu öffnen, oder auf **Trotzdem anlegen**, wenn es wirklich eine andere Person ist.
</Step>
</Steps>

<Callout type="warn" title="Aufbewahrungsfrist und Verantwortung">
Scans ohne verknüpften Kunden löscht Tillor **automatisch nach 7 Tagen**. Verarbeiten Sie sie rechtzeitig.

Für **verknüpfte** Scans bestimmt **Ihre Organisation** die Aufbewahrungsfrist und die Rechtsgrundlage. Tillor bewahrt sie auf, bis Sie sie entknüpfen oder löschen. Die Einhaltung des Datenschutzrechts und angemessene Aufbewahrungsfristen liegen in **Ihrer Verantwortung** als Verantwortlicher.
</Callout>

### Was passiert danach? [#wat-gebeurt-er-daarna]

- Sie landen im neuen Kundenprofil, wo Sie den Rest eintragen: Adresse, USt-IdNr., Kontaktpersonen und eigene Felder.
- Wurde der Kunde aus einem Scan angelegt, gehört der Scan zum Kunden und steht nicht mehr in der Warteschlange.
- Das Anlegen steht als erste Zeile im Tab **Ereignisse** des Kunden.
- Soll bei einem neuen Kunden sofort etwas passieren, zum Beispiel eine Willkommens-E-Mail, nutzen Sie eine [Automatisierung](/automatiseringen).

## Eine USt-IdNr. prüfen [#een-btw-nummer-controleren]

Im Tab **Übersicht**, im Block **Kundendetails**, tragen Sie die **USt-IdNr.** ein. Tillor prüft die Nummer im europäischen Register VIES, sobald auch **Land** ausgefüllt und die Nummer lang genug ist.

- Ist die Nummer gültig, sehen Sie ein grünes Häkchen und ein Fenster mit dem offiziellen Firmennamen und der Adresse aus VIES. Klicken Sie auf **Firmenadresse übernehmen**, um diese Adresse ins Formular zu übernehmen.
- Ist die Nummer ungültig, sehen Sie ein rotes Symbol und eine Fehlermeldung.

## Das Kundenprofil [#het-klantprofiel]

Wenn Sie auf einen Kunden klicken, sehen Sie das Kundenprofil. Oben stehen zusammenfassende Kundendaten, darunter die angehefteten Kommentare. Über die Tabs gelangen Sie zum Rest.

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Kundenprofil - Block Kundendetails" />

| Tab | Was Sie dort finden |
|---|---|
| **Übersicht** | Kundendaten (bearbeitbares Formular), aktuelle Kommunikation, Rechnungen, Zählerstände, Kommentare, Belegungen und Benachrichtigungen |
| **Rechnungen** | Alle Rechnungen dieses Kunden und der [Saldo pro Sachkonto](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken) |
| **Zugangskontrolle** | Zugangsrechte und Kennzeichen |
| **Kontakte** | Zusätzliche Kontaktpersonen |
| **NFC-Tags** | Verknüpfte NFC-Tags |
| **Reservierungen** | Alle Reservierungen |
| **Kommunikation** | Nachrichten und Kommunikationsverlauf |
| **Outlook** | E-Mails von und an den Kunden aus Ihren Outlook-Postfächern. Dieser Tab erscheint nur, wenn [Outlook](/integraties/outlook) verbunden ist und Sie **Posteingang anzeigen** dürfen |
| **Ereignisse** | Zeitleiste mit Änderungen, einschließlich Anlegen von Kunde oder Kontakt, Zuweisen oder Entknüpfen eines Ausweises, und Vorher/Nachher bei Aktualisierungen von Kunde, Kontakt, Rechnungseinstellung und Zugangsmethode |
| **Dokumente** | Gespeicherte Dateien und Anhänge sowie die [Unterschriftsanfragen](/handtekeningen) |
| **Aufgaben** | Aufgaben, die mit diesem Kunden verknüpft sind |

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Kundenprofil - Tab Zugangskontrolle mit Zugangsmethoden" />

### Auf einen Blick [#in-één-oogopslag]

Im Tab **Übersicht** steht links oben die Karte **Auf einen Blick**. Sie zeigt nur, was gerade Aufmerksamkeit braucht, und klappt zu, wenn es nichts zu zeigen gibt:

- **Aktive Reservierungen** und **Kommende Reservierungen**, mit einer Schaltfläche **Reservierung ansehen**
- **Aktive Zähler mit Alarmen**
- **Offene Aufgaben** dieses Kunden
- **Ausweisscans** dieses Kunden

<DocScreenshot src="/screenshots/klanten/customer-key-info.png" alt="Kundenprofil - Karte Auf einen Blick" />

Dieselben Daten sehen Sie in der Karte eines eingehenden Gesprächs. Ein Kommentar, den Sie anheften, steht direkt unter den Kundendaten oben im Profil. Siehe [Kommentare](/notities#opmerking-vastzetten).

### Geburtstage [#verjaardagen]

Hat der Kunde oder sein Partner heute Geburtstag, steht oben im Kundenprofil ein grüner Block **Heute Geburtstag** mit dem Namen und dem Alter, und Konfetti fällt über die Seite. Beim Kunden stammt das Datum aus dem Feld **Geburtstag**. Der Partner ist der Kontakt mit der Beziehung **Ehepartner**. Ein Geburtsdatum am 29. Februar zählt in Jahren ohne Schalttag am 28. Februar.

## Kundendaten bearbeiten [#klantgegevens-bewerken]

Im Tab **Übersicht**, im Block **Kundendetails**, passen Sie Felder an. Unten im Formular stehen **Abbrechen** und **Speichern**. Jede Änderung erscheint im Tab **Ereignisse**, mit einer **Vorher / nachher**-Übersicht pro Feld, sodass Sie genau sehen, was geändert wurde.

Hat Ihre Organisation [eigene Felder](/eigen-velden) für Kunden angelegt, stehen sie als zusätzliche Felder im selben Block.

### Adresse eintragen [#adres-invullen]

Die Adresse besteht aus **Straße**, **Nr.** und **Zusatz**, gefolgt von **Postleitzahl**, **Stadt** und **Land**.

<DocScreenshot src="/screenshots/klanten/customer-address-input.png" alt="Adressfeld mit Straße, Nummer und Zusatz" />

- Tippen Sie mindestens drei Zeichen der Straße, schlägt Tillor Adressen vor. Wählen Sie eine: Dann werden Straße, Nummer, Postleitzahl, Stadt und Land ausgefüllt. Die Vorschläge stammen von OpenStreetMap, einer kostenlosen Kartendatenbank.
- Tippen Sie **Kerkstraat 5** ins Feld **Straße**, springt die Ziffer weiter zu **Nr.**. Ein Leerzeichen nach der Nummer bringt Sie zu **Zusatz**. Fügen Sie eine vollständige Adresse ein, wird sie ebenfalls aufgeteilt. In Ländern, in denen die Nummer vor der Straße steht, wird die Nummer nicht automatisch verschoben.
- Sind Postleitzahl oder Stadt bereits ausgefüllt, prüft Tillor die Adresse. Ein grünes Häkchen mit **Adresse gefunden** bedeutet, dass die Adresse existiert. Ein gelbes Symbol mit **Vorgeschlagene Schreibweise** zeigt die übliche Schreibweise. Klicken Sie auf **Adresse aktualisieren**, um sie zu übernehmen.
- Die Adresse wird als eine Zeile gespeichert, zum Beispiel auf Rechnungen und in Exporten.

Vorschläge sind eine Hilfe, keine Pflicht. Sie können immer selbst etwas eintragen.

## Kunden suchen und filtern [#klanten-zoeken-en-filteren]

Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath>. Oben steht eine Suchleiste.

<DocScreenshot src="/screenshots/klanten/customers-list.png" alt="Kundenliste mit Suchleiste" />

- Tippen Sie einen Namen, eine E-Mail-Adresse, eine Telefonnummer oder eine Kundennummer.
- Die Ergebnisse werden beim Tippen aktualisiert, mit einer kurzen Verzögerung.
- Sie können auch nach **Erstellt** (Datumsbereich), **Status** und **Typ** filtern.

## Einen Kunden löschen [#een-klant-verwijderen]

Nutzen Sie **Kunde löschen** im Menü oben im Kundenprofil. Tillor fragt **Sind Sie sicher, dass Sie diesen Kunden löschen möchten?** Bestätigen Sie, verschwinden auch alle zugehörigen Daten. Das lässt sich nicht rückgängig machen.

## Häufige Szenarien [#veelvoorkomende-scenarios]

### Ein neuer Kunde bucht zum ersten Mal [#een-nieuwe-klant-boekt-voor-het-eerst]

1. Der Kunde ruft an oder bucht online.
2. Sie fügen den Kunden mit **Neuen Kunden anlegen** hinzu.
3. Sie tragen Adresse und weitere Daten im Kundenprofil ein (Tab **Übersicht** > **Kundendetails**).
4. Sie legen eine Belegung auf der gewünschten Parzelle an, siehe [Belegungen](/bezettingen#een-bezetting-aanmaken).
5. Den Verbrauch der verknüpften Zähler erfasst Tillor automatisch. Sie sehen ihn unter **Zählerstände** auf **Übersicht**.

### Kundendaten ändern [#klantgegevens-wijzigen]

Öffnen Sie das Kundenprofil, passen Sie die Adresse im Formular an und klicken Sie auf **Speichern**.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet: Kunde nicht erstellt">
Die Meldung lautet **Der Kunde konnte nicht erstellt werden.** Prüfen Sie, ob **Vorname** ausgefüllt ist und ob die E-Mail-Adresse gültig ist, mit einem At-Zeichen und einer Domain. Versuchen Sie es danach erneut.
</Accordion>
<Accordion title="Tillor meldet: Möglicher Doppelkunde">
Es gibt bereits einen Kunden mit demselben Vor- und Nachnamen, derselben E-Mail-Adresse oder derselben Telefonnummer. Klicken Sie auf **Diesen Kunden verwenden**, wenn es dieselbe Person ist, oder auf **Trotzdem anlegen**, wenn es eine andere Person ist.
</Accordion>
<Accordion title="Tillor meldet: Etwas ist schiefgelaufen. Der Kunde konnte nicht aktualisiert werden">
Ihre Änderungen wurden nicht gespeichert. Prüfen Sie das Formular auf eine ungültige E-Mail-Adresse oder ein leeres Pflichtfeld und klicken Sie erneut auf **Speichern**.
</Accordion>
<Accordion title="Der Scan steht nicht im Menü von Neuen Kunden anlegen">
Nur Scans ohne verknüpften Kunden gelten als offen. Ist der Scan bereits mit einem Kunden verknüpft oder älter als 7 Tage, steht er dort nicht mehr. Siehe [Identitätsscans](/identiteitsscans).
</Accordion>
<Accordion title="Kunden auf Basis dieses Scans anlegen ist grau">
Beim Scan steht der Grund. Meist hat der Scan keinen Vornamen: *tragen Sie ihn im Scanner ein oder verknüpfen Sie diesen Scan manuell*. Oder es existiert bereits ein Kunde mit derselben Nationalregisternummer. Öffnen Sie dann diesen Kunden und verknüpfen Sie den Scan damit.
</Accordion>
<Accordion title="Tillor meldet: Ungültige USt-IdNr.">
Die Nummer ist nicht gültig oder nicht in VIES registriert. Prüfen Sie, ob das **Land** stimmt und die Nummer vollständig ist. Tillor meldet auch **USt-IdNr. muss mindestens ... Zeichen haben**, wenn die Nummer für das gewählte Land zu kurz ist, und verlangt sowohl eine Nummer als auch ein Land, wenn eines von beiden fehlt.
</Accordion>
<Accordion title="Ich sehe den Tab Outlook nicht">
Der Tab erscheint nur, wenn [Outlook](/integraties/outlook) verbunden ist und Sie das Recht **Posteingang anzeigen** haben.
</Accordion>
<Accordion title="Es erscheinen keine Adressvorschläge">
Tippen Sie mindestens drei Zeichen ins Feld **Straße**. Bleiben die Vorschläge aus, tragen Sie die Adresse einfach selbst ein.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Kunde**: der Datensatz in Tillor einer Person oder eines Unternehmens. Siehe [Kunde](/begrippen#klant).
- **Kontaktperson**: eine zusätzliche Person bei einem Kunden, zum Beispiel ein Partner oder Notfallkontakt.
- **Belegung**: ein Kunde auf einer Parzelle für einen Zeitraum. Siehe [Belegung](/begrippen#bezetting).
- **Reservierung**: eine Buchung für einen Aufenthalt. Siehe [Reservierung](/begrippen#reservering).
- **Ereignisse**: die Zeitleiste mit allen Änderungen bei einem Kunden. Siehe [Ereignis](/begrippen#gebeurtenis).
- **VIES**: das europäische Register, in dem Tillor eine USt-IdNr. prüft.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Identitätsscans" href="/identiteitsscans" description="Kunden aus einem Scan anlegen, Aufbewahrungsfrist und Connector" />
  <Card title="Belegungen" href="/bezettingen" />
  <Card title="Reservierungen" href="/reserveringen" />
  <Card title="Rechnungen" href="/facturen" />
  <Card title="Parzellen" href="/terreinen" />
  <Card title="Einen Saisonkunden gewinnen" href="/praktijk/seizoensklant-binnenhalen" />
</Cards>


# Alarme und Zählerstatus (/de-DE/meterbeheer/alarmen-en-status)

Ein Zähler löst einen Alarm aus, wenn er eine Abweichung meldet, etwa ein Verbindungsproblem oder eine technische Störung. Hier lesen Sie, wo Sie das sehen, was die Statusanzeige bedeutet und wie Sie einen Alarm löschen.

## Einem Alarm nachgehen [#een-alarm-opvolgen]

<Steps>
<Step>
### Den Zähler mit einem Alarm finden [#zoek-de-meter-met-een-alarm]
Gehen Sie zu <UIPath>Park > Zähler</UIPath>. Ein Zähler mit aktivem Alarm hat ein Dreieck.
</Step>
<Step>
### Den Zähler öffnen und den Alarm lesen [#open-de-meter-en-lees-het-alarm]
In der Liste der Alarme sehen Sie pro Alarm die Meldung, **Begonnen am** und ob er Aktiv oder Behoben ist. Die Meldung hängt vom Zählertyp und vom Anbieter ab.
</Step>
<Step>
### Das Problem beheben [#los-het-probleem-op]
Prüfen Sie die Batterie und das Signal in den Zählerdetails und gehen Sie bei Bedarf zum Zähler.
</Step>
<Step>
### Den Alarm löschen [#wis-het-alarm]
Wählen Sie im Aktionsmenü des Zählers **Alarme löschen**.
</Step>
</Steps>

## Was der Status bedeutet [#wat-de-status-betekent]

- **Statusanzeige**: Intelligente Zähler (ICY und Tillor Hydrodigit) zeigen, ob sie kürzlich kommuniziert haben und ob es Alarme gibt. Die Anzeige ändert die Farbe bei einem aktiven Alarm oder wenn der Zähler seit mehr als einem Tag nichts gesendet hat.
- **Batteriestand** und **Signalqualität**: als Prozentwert in den Zählerdetails, bei Zählern, die das melden.

## ICY-Controller [#icy-controllers]

Die ICY-Module auf den Stellplätzen kommunizieren über einen Controller im Zählerschrank. Fällt ein Controller aus, sendet kein Zähler hinter diesem Controller mehr etwas.

Hat Ihr Park ICY-Zähler, steht unter <UIPath>Park > Zähler</UIPath> über der Liste die Karte **ICY-Controller**. Sie sagt, wie viele Controller es gibt, bei wie vielen ICY in der letzten Stunde nichts mehr gesehen hat und wie viele Alarme auf Controllern offen sind. Klicken Sie auf **Anzeigen** für die Tabelle:

- **Controller**: der Name des Zählerschranks, in dem die meisten Zähler des Controllers hängen, mit einem grünen oder roten Punkt. Weicht der Name bei ICY davon ab, steht er grau daneben. Hängen die Zähler in keinem Zählerschrank, sehen Sie nur den Namen von ICY.
- **Zähler**: wie viele Ihrer Zähler über diesen Controller kommunizieren. Bei einem Zähler selbst steht dieser Name bei **Controller** in der Karte **Informationen**.
- **Alarme**: die Alarme, die ICY auf dem Controller selbst meldet, mit dem Zeitpunkt, seit dem sie bestehen. Ein Alarm verschwindet aus der Liste, sobald ICY ihn nicht mehr meldet; Sie müssen ihn nicht löschen. Ein Alarm, den Tillor noch nicht mit Namen kennt, steht dort als **Unbekannter Alarm** mit dem Code von ICY. Wer Push-Nachrichten für Zähleralarme erhält, bekommt auch eine Meldung bei einem neuen und bei einem behobenen Alarm auf einem Controller.
- **Zuletzt gesehen**: wann ICY den Controller zuletzt gesehen hat. Ist das mehr als eine Stunde her, steht die Zeit in Rot.

Ein Controller mit einem Alarm oder einem Controller, der mehr als eine Stunde still ist, steht oben, und die Karte öffnet sich dann von selbst.
Tillor aktualisiert die Liste jedes Mal, wenn die ICY-Zähler ausgelesen werden.

## Wenn alle Ihre Zähler gleichzeitig ausfallen [#als-al-je-meters-tegelijk-stilvallen]

Tillor-Hydrodigit- und Tillor-EM300-Zähler senden ihren Stand über einen Empfänger, das LoRa-Gateway, an Tillor. Normalerweise senden sie etwa zweimal am Tag eine Messung. Hat jeder kürzlich aktive LoRa-Zähler Ihrer Organisation seit mehr als 24 Stunden nichts gesendet, liegt es wahrscheinlich am Gateway oder an der Verbindung zu Tillor und nicht an den Zählern. Ein einzelner stiller Zähler löst diese Meldung nicht aus: Es sind mindestens zwei aktive Zähler nötig.

Dann erhalten die Tillor-Administratoren eine Meldung, mit der zuletzt empfangenen Messung und den betroffenen Zählern. Diese Zähler stehen dann nicht zusätzlich einzeln als Zähler, der Aufmerksamkeit braucht. Sie müssen nichts einstellen. Sehen Sie bei Ihren Zählern einen gemeinsamen, alten **Letzten Stand**, wenden Sie sich an den Support.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein gelöschter Alarm steht nicht mehr als aktiv in der Liste. Das Dreieck beim Zähler unter <UIPath>Park > Zähler</UIPath> gehört nur zu aktiven Alarmen.
- Meldet der Zähler das Problem erneut, erhalten Sie einen neuen Alarm.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Alarm kommt immer wieder">
Die Ursache besteht noch. Prüfen Sie Batterie, Signal und den Standort des Zählers und rufen Sie bei Bedarf den Support an.
</Accordion>
<Accordion title="Mehrere Zähler haben keine aktuelle Messung">
Prüfen Sie, ob alle einen alten **Letzten Stand** haben. Dann sind das Gateway oder die Verbindung die Ursache. Wenden Sie sich an den Support.
</Accordion>
<Accordion title="Eine Gruppe ICY-Zähler sendet gleichzeitig nichts mehr">
Prüfen Sie in der Karte **ICY-Controller**, ob ein Controller einen Alarm hat oder rot steht. Dann liegt es an diesem Controller oder seiner Verbindung und nicht an den Zählern. Prüfen Sie Strom und Netzwerk des Zählerschranks und wenden Sie sich bei Bedarf an ICY.
</Accordion>
<Accordion title="Ein Zähler sendet nichts mehr, aber es kommt keine Meldung">
Die Gateway-Meldung verlangt mindestens zwei aktive Zähler. Prüfen Sie selbst den Status, die Batterie und das Signal dieses Zählers.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zählerstände und Trends ansehen" href="/meterbeheer/meterstanden-en-trends" />
  <Card title="Verbrauch abrechnen" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Verbrauchsperioden (/de-DE/meterbeheer/consumptie-batches)

Diese Seite erklärt, wie Tillor den Verbrauch eines Kunden in Perioden unterteilt, damit Sie wissen, warum ein Betrag so aussieht. Eine **Verbrauchsperiode** (Consumption-Batch) ist ein Zeitraum mit Zählerverbrauch für einen Kunden und einen Zähler. Tillor hält automatisch fest, wann eine Periode beginnt, wann sie endet und ob sie bereits abgerechnet ist. Wenn Sie nur abrechnen möchten, gehen Sie zu [Verbrauch abrechnen](/meterbeheer/verbruik-factureren).

## Lebenszyklus einer Periode [#levenscyclus-van-een-batch]

```mermaid
flowchart TD
  A[Angelegt<br/>nur Startstand] -- Ablesungen --> B[Offen<br/>Start- und Endstand]
  B -- schließen --> C[Geschlossen<br/>festgeschrieben]
  C -- abrechnen --> D[Abgerechnet<br/>abgeschlossen]
```

### Status [#statussen]

| Status | Beschreibung |
|--------|--------------|
| **Offen** | Neue Ablesungen werden automatisch zur Periode hinzugefügt |
| **Geschlossen** | Die Periode ist abgeschlossen und wartet auf die Abrechnung |
| **Abgerechnet** | Der Verbrauch ist in eine Rechnung eingeflossen |

## Wann wird eine Periode angelegt? [#wanneer-wordt-een-batch-aangemaakt]

- **Bei Belegung**: Wenn Sie einen Kunden mit einer Parzelle mit Zählern verknüpfen und einen Startstand angeben
- **Bei manueller Ablesung**: Wenn Sie einen Zählerstand für einen Zähler auf einer Parzelle mit aktiver Belegung eingeben und für diese Kunde-Zähler-Kombination noch keine offene Periode existiert

## Wann wird eine Periode geschlossen? [#wanneer-wordt-een-batch-gesloten]

- **Bei Beendigung der Belegung**: Wenn der Kunde die Parzelle verlässt (die Belegung wird entfernt)
- **Bei Zählerkorrektur oder Zurücksetzen**: Wenn der Zählerstand sinkt (z. B. Zähler ersetzt oder korrigiert), schließt das System die vorherige Periode, legt eine geschlossene "Sprung"-Periode mit negativem Verbrauch an (z. B. -90 bei 100→10), und die nächste Ablesung startet eine neue offene Periode
- **Bei neuer Belegung**: Wenn ein anderer Kunde (oder derselbe Kunde erneut) mit ausdrücklichen Startständen verknüpft wird

<Callout type="info" title="Zählerstand sinkt">
Wenn ein Zählerstand sinkt (Korrektur, Zurücksetzen oder Austausch), schließt Tillor automatisch die laufende Periode, legt eine geschlossene "Sprung"-Periode mit negativem Verbrauch an und öffnet sofort eine neue Periode beim neuen Stand. Die Sprung-Periode ist leicht zu erkennen und lässt sich als bezahlt markieren. Die nächste Ablesung wird der neuen Periode hinzugefügt.
</Callout>

## Beispiele [#voorbeelden]

<Accordions type="multiple">
  <Accordion title="Normale Belegung (Idealfall)">
    Der Kunde bezieht eine Parzelle, verbraucht und reist wieder ab. Das häufigste Szenario.

    ```
    1. Bezetting aangemaakt met startstand 100 m³ (15 jan)
       → Batch: start 100 m³, open

    2. Uitlezingen: 150 m³ (20 jan), 200 m³ (25 jan)
       → Batch: start 100 m³, eind 200 m³, verbruik 100 m³

    3. Bezetting beëindigd met eindstand 250 m³
       → Batch gesloten: verbruik 150 m³, wacht op facturering

    4. Factureer verbruik
       → Batch gefactureerd, klaar
    ```
  </Accordion>

  <Accordion title="Fortlaufende Abrechnung (Idealfall)">
    Die Belegung läuft weiter, Sie rechnen pro Periode ab, ohne die Periode zu schließen.

    ```
    1. Batch: 0 → 50 m³ (open)
    2. Markeer als gefactureerd
       → Batch 1 gesloten, Batch 2 automatisch aangemaakt: 50 → (open)
    3. Nieuwe uitlezingen: 75, 100 m³
       → Batch 2: 50 → 100 m³, verbruik 50 m³
    4. Markeer weer als gefactureerd
       → Batch 2 gesloten, Batch 3: 100 → (open)
    ```
  </Accordion>

  <Accordion title="Zählerstand sinkt, einfach (100 → 10)">
    Nur ein Startstand, danach eine Korrektur. Sprung-Periode mit Verbrauch -90 m³, danach eine neue offene Periode.

    ```
    1. Batch: start 100 m³ (15 jan), nog geen eindstand
    2. Uitlezing op 16 jan: 10 m³ (meter gecorrigeerd)
       → Batch 1 gesloten (verbruik 0)
       → Sprong-batch: start 100 m³, eind 10 m³ (verbruik -90 m³) - gesloten
       → Nieuwe open batch: start 10 m³
    3. Volgende uitlezing: 20 m³ → batch: 10 → 20 m³, verbruik 10 m³
    ```
  </Accordion>

  <Accordion title="Zählerstand sinkt, mit Verbrauch (100 → 150 → 10)">
    Zuerst normaler Verbrauch, danach wird der Zähler ersetzt. Sprung-Periode mit Verbrauch -140 m³, danach eine neue offene Periode.

    ```
    1. Batch: start 100 m³ (15 jan), eind 150 m³ (20 jan) → verbruik 50 m³
    2. Uitlezing op 25 jan: 10 m³ (meter vervangen)
       → Batch 1 gesloten met eind 150 m³ (verbruik 50 m³)
       → Sprong-batch: start 150 m³, eind 10 m³ (verbruik -140 m³) - gesloten
       → Nieuwe open batch: start 10 m³
    3. Volgende uitlezing: 20 m³ → batch: 10 → 20 m³, verbruik 10 m³
    ```
  </Accordion>

  <Accordion title="Periode ohne Verbrauch">
    Eine Ablesung mit demselben Stand wie der Start. Tillor passt das Startdatum an.

    ```
    1. Batch: start 982 m³ (1 dec), open
    2. Uitlezing 5 jan: 982 m³ (zelfde stand)
       → Start automatisch aangepast naar 5 jan
       → Periode toont "5 jan → ..." in plaats van "1 dec → ..."
    3. Uitlezing 5 jan (later): 990 m³
       → Verbruik 8 m³, periode "5 jan → 5 jan"
    ```
  </Accordion>

  <Accordion title="Kunde kommt zurück">
    Der Kunde verlässt die Parzelle und kommt später zurück. Neue Periode, nicht mit der vorherigen verknüpft.

    ```
    1. Klant A: batch 0 → 50 m³, bezetting beëindigd
    2. Klant B: batch 55 → 100 m³, bezetting beëindigd
    3. Klant A keert terug met startstand 110 m³
       → Nieuwe batch: start 110 m³ (niet 50 m³)
       → Geen koppeling met vorige periode
    ```
  </Accordion>

  <Accordion title="Entwurfsrechnung gelöscht, Fortsetzung wird wieder eine Periode">
    Sie hatten Verbrauch abgerechnet, während die Belegung weiterlief, und löschen danach die Entwurfsrechnung.

    ```
    1. Open batch: 100 m³ (1 feb) → 200 m³ (7 mrt), bezetting loopt door
    2. Factureer verbruik (conceptfactuur)
       → Batch A: 100 → 200 m³, gekoppeld aan factuur, afgesloten voor die factuur
       → Batch B automatisch: start 200 m³ (zelfde uitlezing als eind van A), open
    3. Nieuwe uitlezing: 250 m³ (15 mrt)
       → Batch B: 200 → 250 m³
    4. Conceptfactuur verwijderen
       → Batch A: niet meer gekoppeld aan factuur, niet gefactureerd
       → Batch B (start nog steeds op 200 m³) wordt samengevoegd in A
       → Resultaat: één open batch 100 m³ → 250 m³, klaar om opnieuw te factureren
    ```
  </Accordion>

  <Accordion title="Entwurfsrechnung gelöscht, keine Zusammenführung (anderer Start)">
    Zwei getrennte Perioden am selben Zähler: Die zweite Periode startet **nicht** beim Endstand der ersten. Tillor führt sie **nicht** zusammen.

    ```
    1. Batch A: 12,49 m³ → 13,21 m³ (eindstand = uitlezing X)
    2. Later een andere periode / sprong op de meter
    3. Batch B: 0,10 m³ → 0,77 m³ (start = uitlezing Y, Y ≠ X)
    4. Zelfde of andere factuur - maakt niet uit voor dit voorbeeld
    5. Als je een factuur verwijdert die alleen bij A hoorde:
       → A wordt weer vrijgegeven voor facturering
       → Batch B blijft bestaan; wordt niet in A getrokken (start Y is niet hetzelfde als eind X)
    ```
  </Accordion>

  <Accordion title="Entwurfsrechnung gelöscht, Fortsetzung bereits erneut abgerechnet">
    Die erste Rechnung deckt den Zeitraum bis Stand X ab, danach folgen neue Ablesungen und eine **zweite** Rechnung für die Fortsetzung. Das Löschen der ersten Rechnung ändert die zweite nicht.

    ```
    1. Factuur 1: batch A 0 → 50 m³ → na facturering batch B: start 50 m³, open
    2. Uitlezingen: 60, 75 m³ op batch B
    3. Factuur 2: batch B gefactureerd → batch C: start 75 m³
    4. Factuur 1 verwijderen
       → A weer vrijgegeven
       → B hoort nog bij factuur 2 → wordt niet als "open voortzetting van A" gezien
       → Geen samenvoeging van A met B; C blijft de actieve voortzetting na factuur 2
    ```
  </Accordion>
</Accordions>

## Abrechnung [#facturering]

### Weg 1: Über die Rechnungsschaltfläche (neue Rechnung) [#manier-1-via-factuurknop-nieuwe-factuur]

1. Gehen Sie zu **Kunden** > Kunde > Tab **Übersicht** (Karte **Zählerstände**)
2. Klicken Sie auf **Verbrauch abrechnen**
3. Das System erstellt eine Rechnung mit dem Verbrauch als Zeile oder fügt ihn einer bestehenden Entwurfsrechnung hinzu
4. Die Perioden werden als abgerechnet markiert und mit der Rechnung verknüpft

### Weg 2: Manuell als abgerechnet markieren [#manier-2-handmatig-als-gefactureerd-markeren]

Wenn Sie den Verbrauch außerhalb von Tillor abgerechnet haben:

1. Öffnen Sie die Periode in der Karte **Zählerstände** (Kundenprofil) oder **Verbrauch** (**Park** > **Zähler** > Zähler)
2. Klicken Sie auf das Warnsymbol neben der Periode
3. Bestätigen Sie mit **Ja, als abgerechnet markieren**
4. Die Periode wird ohne Rechnungsverknüpfung abgeschlossen

<Callout type="warn" title="Achtung">
Nur manuell markierte Perioden lassen sich wieder "zurücksetzen". Perioden, die mit einer echten Rechnung verknüpft sind, lassen sich nicht rückgängig machen. Die Rechnung muss zuerst gelöscht werden.
</Callout>

### Automatische neue Periode [#automatische-nieuwe-batch]

Wenn Sie eine Periode als abgerechnet markieren (und die Belegung noch läuft), legt Tillor automatisch eine **neue offene Periode** an, die beim Endstand der vorherigen startet. So läuft der Verbrauch ohne Lücken weiter.

```
Batch 1: 0 → 50 m³ (gefactureerd)
         ↓
Batch 2: 50 → (open, klaar voor nieuwe uitlezingen)
```

## Rechnung löschen [#factuur-verwijderen]

Wenn Sie eine **Entwurfsrechnung** löschen, mit der Verbrauch verknüpft war, passt Tillor die Verbrauchsperioden automatisch an.

### Was passiert immer? [#wat-gebeurt-er-altijd]

- Die Verknüpfung mit dieser Rechnung verschwindet.
- Die Periode gilt wieder als **nicht abgerechnet** und kann erneut auf einer Rechnung landen.

### Wann werden zwei Perioden wieder eine? [#wanneer-worden-twee-batches-weer-één]

Manchmal hatte Tillor nach der Abrechnung automatisch eine **neue offene Periode** beim **Endstand** des abgerechneten Zeitraums gestartet. Wenn Sie diese Rechnung löschen, sucht das System nach einer solchen Fortsetzung:

| Bedingung | Folge |
|------------|--------|
| Es gibt eine andere Periode mit **demselben Startstand** wie der **Endstand** der abgerechneten Periode (dieselbe Ablesung als Verbindungspunkt) | Diese Fortsetzung wird in die ursprüngliche Periode **zusammengeführt**. Sie haben wieder **eine** durchlaufende Periode. |
| Die Fortsetzung ist **noch nicht abgerechnet** (keine Rechnung darauf) | Zusammenführen ist **erlaubt**. |
| Die Fortsetzung **beginnt bei einer anderen Ablesung** als dem Endstand der abgerechneten Periode | **Keine** Zusammenführung: Es sind zwei getrennte Perioden. |
| Die Fortsetzung ist **bereits erneut abgerechnet** (andere Rechnung) | **Keine** Zusammenführung: Diese Periode bleibt auf der anderen Rechnung. |

### Endstand nach dem Zusammenführen [#eindstand-na-samenvoegen]

Nach dem Zusammenführen sollte die Periode wieder **offen** sein (wenn die Fortsetzung offen war), und der **Endstand** ist der aktuelle Endstand dieser Fortsetzung, also einschließlich der Ablesungen, die **nach** der Rechnung eingegangen sind. Falls die Fortsetzung technisch keinen Endstand hatte, es aber neuere Ablesungen am Zähler gibt, ergänzt Tillor den Endstand mit der **jüngsten Ablesung nach dem Verbindungspunkt** (dieselbe Logik wie beim Anlegen einer Periode).

<Callout type="info" title="Manuell als abgerechnet markiert">
Nur Perioden **ohne** Rechnungsverknüpfung können Sie über das Symbol zum Zurücksetzen (unter **Park** > **Zähler** > Zähler, bei abgerechneten Perioden) manuell wieder auf "nicht abgerechnet" setzen. Für Perioden, die an einer echten Rechnung hängen, gelten die obigen Regeln erst, **nachdem** Sie diese Rechnung gelöscht haben.
</Callout>

## Besondere Situationen [#specifieke-situaties]

### Periode ohne Verbrauch [#periode-zonder-verbruik]

Wenn eine Ablesung mit demselben Stand wie der Start eingeht (Verbrauch = 0), passt Tillor das Startdatum automatisch an. Die angezeigte Periode zeigt nur den Zeitraum, in dem tatsächlich Verbrauch stattgefunden hat.

### Kunde kommt zurück [#klant-keert-terug]

Wenn ein Kunde nach einem früheren Abgang erneut eine Parzelle bezieht:

- Es wird eine **völlig neue Periode** angelegt
- Die Periode startet nicht dort, wo die vorherige geendet hat
- Sie wählen erneut einen Startstand (oder den Zählerstand zu diesem Zeitpunkt)

### Zähler mit mehreren Kunden verknüpft [#meter-gekoppeld-aan-meerdere-klanten]

Jede Kunde-Zähler-Kombination hat ihre eigenen Perioden. Dieselbe Parzelle kann mehrere Belegungen haben (z. B. verschiedene Zeiträume), jede mit eigenen Verbrauchsperioden.

## Übersicht in der Anwendung [#overzicht-in-de-applicatie]

Wo Sie Perioden sehen:

- **Kunden** > Kunde > Tab **Übersicht** > Karte **Zählerstände**: pro Zähler nur **offene** Perioden (orange Akzent) mit der Schaltfläche **Verbrauch abrechnen** oben.
- **Park** > **Zähler** > Zähler > Karte **Verbrauch**: pro Kunde zuerst offene Perioden (orange), darunter abgerechnete Perioden (grün bei Rechnungsverknüpfung, grau bei manueller Markierung).
- **Kunden** > **Offener Verbrauch**: Tabelle mit Kunden, deren Verbrauch noch abgerechnet werden muss.


<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Kunden > Offener Verbrauch" />

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zählerverwaltung" href="/meterbeheer" description="Zurück zur Übersicht" />
  <Card title="Verbrauch abrechnen" href="/meterbeheer/verbruik-factureren" description="Schritt für Schritt abrechnen" />
  <Card title="Rechnungen" href="/facturen" description="Entwurfsrechnungen und Abrechnung" />
  <Card title="Kundenverwaltung" href="/klantenbeheer" />
</Cards>


# Übersicht (/de-DE/meterbeheer)

Mit der Zählerverwaltung lesen Sie die Zähler Ihres Parks aus der Ferne ab und sehen, wer was verbraucht, ohne dass jemand die Zählerschränke abgehen muss. Sie sehen die Zählerstände, den Verbrauch pro Periode und die Alarme, und Sie rechnen den Verbrauch mit dem Kunden ab, der zu diesem Zeitpunkt auf der Parzelle steht. Ihre Zähler finden Sie unter <UIPath>Park > Zähler</UIPath>.

<DocScreenshot src="/screenshots/park/meters-list.png" alt="Park > Zähler mit allen Zählern des Parks" />

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Ein Zähler gehört nie direkt zu einem Kunden. Der Zähler hängt an einer **Parzelle**, und der Kunde hängt über eine **Belegung** an dieser Parzelle. Wer jetzt eine Belegung auf der Parzelle hat, bekommt den Verbrauch der Zähler auf dieser Parzelle.

```mermaid
flowchart LR
  M[Zähler] -->|verknüpfen Sie mit| T[Parzelle]
  K[Kunde] -->|erhält eine Belegung auf| T
  T --> V[Verbrauch des Kunden]
  V --> F[Rechnung]
```

Das hat drei Folgen, die oft überraschen:

- Es gibt keine Schaltfläche, um einen Zähler mit einem Kunden zu verknüpfen. Das geht in zwei Schritten: Zähler an Parzelle, Kunde an Parzelle. Siehe [Einen Zähler mit einem Kunden verknüpfen](/meterbeheer/meter-koppelen).
- Zieht ein Kunde um, ziehen Sie nicht den Zähler um. Die Belegung endet, und der nächste Kunde erhält den Verbrauch ab seinem eigenen Startstand.
- Gibt es auf der Parzelle keine Belegung, gehört der Verbrauch niemandem, und Sie können ihn auch nicht abrechnen.

<Callout type="info" title="Gut zu wissen">
- Eine Parzelle hat höchstens eine aktive Belegung gleichzeitig. Eine Parzelle mit Belegung steht nicht in der Auswahlliste von **Belegung erstellen**.
- Zähler in einem gemeinsamen LoRa-Netzwerk senden etwa zweimal pro Tag eine Messung. Siehe den Kasten unten.
- Tillor meldet eine mögliche Störung am Empfänger (dem Gateway), wenn alle Ihre kürzlich aktiven LoRa-Zähler mehr als 24 Stunden nichts gesendet haben, und nur bei mindestens zwei aktiven Zählern.
- Möchten Sie den Verbrauch eines Kunden abrechnen und der offene Betrag liegt unter dem Mindestbetrag, wartet Tillor bis zum nächsten Rechnungstag.
- Bei automatischer Abrechnung hält Tillor eine Rechnung zurück, wenn der Strom- oder Wasserverbrauch mindestens das Doppelte dessen beträgt, was der Kunde gewöhnlich verbraucht.
- Einen gelöschten Zähler können Sie nicht wiederherstellen, samt allen Zählerständen und Verbrauchsperioden.
</Callout>

<Callout type="info" title="Für technisch Interessierte">
LoRa ist eine drahtlose Verbindung mit großer Reichweite und niedrigem Stromverbrauch. Der Zähler sendet seinen Stand an einen Empfänger auf oder bei Ihrem Park, das Gateway, und dieses leitet ihn an Tillor weiter. Die Dev EUI ist die eindeutige Nummer eines LoRa-Zählers, 16 Zeichen lang (Ziffern 0-9 und Buchstaben a-f). Diese Nummer tragen Sie beim Anlegen des Zählers ein. ICY-Zähler erkennen Sie an ihrer Seriennummer.
</Callout>

## Was möchten Sie tun? [#wat-wil-je-doen]

<Cards>
  <Card title="Einen Zähler mit einem Kunden verknüpfen" href="/meterbeheer/meter-koppelen" description="Zähler an Parzelle, Kunde an Parzelle" />
  <Card title="Zählerstände und Trends ansehen" href="/meterbeheer/meterstanden-en-trends" description="Stand, Verbrauch pro Tag oder Stunde, Vergleich mit der Vorwoche" />
  <Card title="Verbrauch abrechnen" href="/meterbeheer/verbruik-factureren" description="Manuell oder automatisch, mit einem Mindestbetrag" />
  <Card title="Alarme und Zählerstatus" href="/meterbeheer/alarmen-en-status" description="Keine Ablesung, Batterie, Signal und Störungen" />
  <Card title="Einen Zähler löschen" href="/meterbeheer/meter-verwijderen" description="In drei Schritten, nicht rückgängig zu machen" />
  <Card title="Verbrauchsperioden" href="/meterbeheer/consumptie-batches" description="Wie Verbrauchsperioden laufen, schließen und zusammengehen" />
</Cards>

## Wie kommen die Zählerstände herein? [#hoe-komen-de-meterstanden-binnen]

Intelligente Zähler senden ihren Stand selbst, meistens täglich oder wöchentlich. Sie müssen nichts tun: Neue Stände erscheinen automatisch beim Zähler und bei dem Kunden, der auf der Parzelle steht. Hängt ein Zähler nicht an einer intelligenten Verbindung, geben Sie den Stand selbst ein.

## Begriffe [#begrippen]

- **Zähler**: ein Wasser-, Gas- oder Stromzähler. Siehe [Begriffe](/begrippen#meter).
- **Parzelle**: der Ort, an dem der Zähler hängt und an dem ein Kunde steht. Siehe [Begriffe](/begrippen#terrein).
- **Belegung**: ein Kunde auf einer Parzelle für einen Zeitraum. Siehe [Begriffe](/begrippen#bezetting).
- **Verbrauchsperiode** (Consumption-Batch): der Verbrauch eines Kunden an einem Zähler, von einem Startstand bis zu einem Endstand.
- **Offener Verbrauch**: Verbrauch, der noch nicht abgerechnet ist.
- **Startstand**: der Zählerstand, mit dem ein Kunde seine Belegung beginnt.


# Einen Zähler mit einem Kunden verknüpfen (/de-DE/meterbeheer/meter-koppelen)

Einen Zähler verknüpfen Sie nicht mit dem Kunden selbst. Sie hängen den Zähler an eine Parzelle und geben dem Kunden eine Belegung auf dieser Parzelle. Danach läuft der Verbrauch automatisch zum Kunden. Die Grafik dazu finden Sie unter [Wie hängt das zusammen?](/meterbeheer#hoe-hangt-dit-samen).

<Requires permission="Zähler bearbeiten" />

Bevor Sie beginnen:

- Der Zähler ist bereits unter <UIPath>Park > Zähler</UIPath> vorhanden. Ein Zähler, der bereits an einer Parzelle hängt, erscheint nicht in der Auswahlliste.
- Die Parzelle existiert und hat noch keine aktive Belegung. Ist die Parzelle belegt, erscheint sie nicht in der Auswahlliste von **Belegung erstellen**. Steht dort **Keine verfügbaren Parzellen gefunden.**, sind alle belegt.
- Der Kunde existiert.

## Schritt 1: den Zähler an die Parzelle hängen [#stap-1-de-meter-aan-het-terrein-hangen]

<Steps>
<Step>
### Die Parzelle öffnen [#open-het-terrein]
Gehen Sie zu <UIPath>Park > Parzellen</UIPath> und klicken Sie auf die Parzelle.
</Step>
<Step>
### Auf Zähler hinzufügen klicken [#klik-op-meter-toevoegen]
Unten in der Karte **Zähler** steht **Zähler hinzufügen**. Wählen Sie den Zähler aus der Liste.
</Step>
<Step>
### Mit Zähler zuweisen bestätigen [#bevestig-met-meter-toekennen]
Der Zähler steht jetzt in der Karte **Zähler** der Parzelle.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Parzellendetail mit der Karte Zähler" />

## Schritt 2: den Kunden auf die Parzelle setzen [#stap-2-de-klant-op-het-terrein-zetten]

<Steps>
<Step>
### Den Kunden öffnen [#open-de-klant]
Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath> und öffnen Sie den Kunden. Auf dem Tab **Übersicht** finden Sie die Karte **Belegungen**.
</Step>
<Step>
### Auf Belegung erstellen klicken [#klik-op-bezetting-aanmaken]
Wählen Sie die Parzelle. Stehen Zähler auf der Parzelle, können Sie pro Zähler einen **Startstand** eintragen. Dafür wählen Sie eine vorhandene Ablesung oder tippen einen Wert ein. Stehen dort keine Zähler, sehen Sie **Keine Zähler verknüpft**.
</Step>
<Step>
### Bestätigen [#bevestig]
Klicken Sie erneut auf **Belegung erstellen**.
</Step>
</Steps>

## Einen Zähler trennen [#een-meter-loskoppelen]

Öffnen Sie die Parzelle, gehen Sie zur Karte **Zähler** und wählen Sie im Menü (...) beim Zähler **Von Parzelle trennen**. Der Zähler bleibt bestehen, und Sie können ihn an eine andere Parzelle hängen. Diese Option gibt es nur auf der Parzellenseite, nicht im Menü des Zählers selbst.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Tillor startet für jeden Zähler auf der Parzelle eine Verbrauchsperiode für diesen Kunden, ab dem Startstand. Siehe [Verbrauchsperioden](/meterbeheer/consumptie-batches).
- Neue Zählerstände kommen zu dieser Periode. Sie sehen sie beim Kunden in der Karte **Zählerstände** und beim Zähler in der Karte **Verbrauch**.
- Endet die Belegung, schließt Tillor die Periode. Danach können Sie den Verbrauch abrechnen, siehe [Verbrauch abrechnen](/meterbeheer/verbruik-factureren).
- Hängen Sie später einen zusätzlichen Zähler an eine Parzelle mit laufender Belegung, beginnt für diesen Zähler eine Verbrauchsperiode, sobald Sie einen Zählerstand eingeben.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe den Zähler nicht in der Liste bei Zähler hinzufügen">
Die Liste zeigt nur Zähler ohne Parzelle. Hängt der Zähler bereits an einer anderen Parzelle, gehen Sie zu dieser Parzelle und wählen **Von Parzelle trennen**.
</Accordion>
<Accordion title="Es wurden keine verfügbaren Parzellen gefunden">
Alle Parzellen haben bereits eine aktive Belegung. Beenden Sie zuerst die Belegung auf der Parzelle, die Sie verwenden möchten, oder legen Sie eine neue Parzelle an.
</Accordion>
<Accordion title="Von Parzelle trennen steht nicht im Menü des Zählers">
Diese Option steht nur im Menü (...) auf der Seite der Parzelle, in der Karte **Zähler**. Tillor meldet **Trennen fehlgeschlagen**, wenn es nicht geklappt hat. Versuchen Sie es dann noch einmal.
</Accordion>
<Accordion title="Der Kunde sieht keinen Verbrauch des Zählers">
Prüfen Sie drei Dinge: Hängt der Zähler an der Parzelle, hat der Kunde auf dieser Parzelle eine aktive Belegung, und ist nach dem Start ein Zählerstand eingegangen? Ohne Belegung gehört der Verbrauch niemandem.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Verbrauch abrechnen" href="/meterbeheer/verbruik-factureren" />
  <Card title="Parzellen" href="/terreinen" />
  <Card title="Belegungen" href="/bezettingen" />
</Cards>


# Einen Zähler löschen (/de-DE/meterbeheer/meter-verwijderen)

Einen Zähler, der nicht mehr existiert, löschen Sie in drei Schritten. Das lässt sich nicht rückgängig machen. Wenn Sie den Zähler nur von einer Parzelle entfernen möchten, trennen Sie ihn, siehe [Einen Zähler mit einem Kunden verknüpfen](/meterbeheer/meter-koppelen#een-meter-loskoppelen).

<Requires permission="Zähler bearbeiten" />

<Steps>
<Step>
### Das Aktionsmenü öffnen [#open-het-actiemenu]
Klicken Sie auf die drei Punkte beim Zähler, in der Liste oder auf der Zählerseite, und wählen Sie **Zähler löschen**.

<DocScreenshot src="/screenshots/meterbeheer/meter-actions-menu.png" alt="Aktionsmenü eines Zählers mit Zähler löschen" />
</Step>
<Step>
### Schritt 1 von 3: Weiter [#stap-1-van-3-doorgaan]
Sie lesen, dass der Zähler für alle in Ihrer Organisation verschwindet. Klicken Sie auf **Weiter**, oder auf **Abbrechen**, um aufzuhören.

<DocScreenshot src="/screenshots/meterbeheer/meter-delete-dialog.png" alt="Schritt 1 beim Löschen eines Zählers" />
</Step>
<Step>
### Schritt 2 von 3: ansehen, was verschwindet [#stap-2-van-3-bekijk-wat-verdwijnt]
Sie sehen alle Zählerstände mit Fotos, die Bemerkungen, Alarme und Abweichungen sowie die Anzahl der Verbrauchsperioden. Verbrauchsperioden, die noch nicht abgerechnet sind, stehen in Rot. Hängt der Zähler noch an einer Parzelle, steht das ebenfalls dort. Klicken Sie auf **Weiter**.
</Step>
<Step>
### Schritt 3 von 3: den Namen eintippen [#stap-3-van-3-typ-de-naam]
Tippen Sie den Namen des Zählers ein. Erst dann wird **Endgültig löschen** aktiv.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Der Zähler, seine Zählerstände, Fotos, Bemerkungen und Alarme sind weg, auch für Ihre Kollegen.
- Verbrauchsperioden, die noch nicht abgerechnet waren, können Sie nicht mehr abrechnen. Rechnen Sie sie also zuerst ab oder markieren Sie sie, siehe [Verbrauch abrechnen](/meterbeheer/verbruik-factureren).
- Löschen Sie den Zähler auf seiner eigenen Seite, gelangen Sie danach zurück zur Liste der Zähler.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Schaltfläche Endgültig löschen ist grau">
Sie müssen den Namen des Zählers genau abtippen. Prüfen Sie Groß- und Kleinschreibung sowie Leerzeichen.
</Accordion>
<Accordion title="Tillor meldet Zähler konnte nicht gelöscht werden">
Der Zähler wurde nicht gelöscht. Versuchen Sie es erneut. Bleibt es bei der Fehlermeldung, wenden Sie sich an den Support.
</Accordion>
<Accordion title="Ich sehe Zähler löschen nicht im Menü">
Sie benötigen das Recht **Zähler bearbeiten**. Bitten Sie Ihren Administrator darum.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Einen Zähler mit einem Kunden verknüpfen" href="/meterbeheer/meter-koppelen" />
  <Card title="Verbrauch abrechnen" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Zählerstände und Trends ansehen (/de-DE/meterbeheer/meterstanden-en-trends)

Auf der Seite eines Zählers sehen Sie den letzten Stand, wer den Zähler aktuell nutzt und wie sich der Verbrauch entwickelt. So erkennen Sie schnell, ob ein Zähler tut, was er soll, und ob etwas Ungewöhnliches vorliegt. Wenn Sie den Verbrauch abrechnen möchten, gehen Sie zu [Verbrauch abrechnen](/meterbeheer/verbruik-factureren).

## Einen Zähler öffnen [#een-meter-openen]

<Steps>
<Step>
### Zu Park > Zähler gehen [#ga-naar-park--meters]
Sie sehen alle Zähler mit **Name**, **Typ** (Wasser, Strom oder Gas), **Anbieter**, **Modul** (Campère oder PRM, nur bei ICY-Zählern), **Parzelle** und dem **Letzten Stand** mit Datum. Zähler mit einem aktiven Alarm haben ein Dreieck.
</Step>
<Step>
### Auf den Zähler klicken [#klik-op-de-meter]
Oben sehen Sie die Daten des Zählers und unter anderem die Karten **Informationen**, **Verbrauch**, **Verbrauch & Trends**, die Alarme und die Aktivität.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Zählerdetail mit der Karte Verbrauch" />

Was wo steht:

- **Informationen**: Seriennummer, Typ, Parzelle, letzte Messung und, wenn der Zähler es meldet, der Batteriestand. Bei einem ICY-Zähler steht außerdem, welches **Modul** am Stellplatz hängt (Campère oder PRM), über welchen **Controller** dieses Modul kommuniziert (mit dem Namen des Zählerschranks dieses Controllers), die bei ICY eingestellte **Abschaltzeit** und, wenn ICY sie kennt, die **Seriennummer des Moduls**.
- **Kunde** in der Kopfzeile: der Kunde mit einer aktiven Belegung auf der Parzelle des Zählers. Steht dort **Kein Kunde**, ist die Parzelle nicht belegt oder der Zähler hängt nirgends.
- **Verbrauch**: pro Kunde der offene und der abgerechnete Verbrauch.
- **Aktivität**: unter der Karte **Verbrauch** die Zeitleiste mit dem Anlegen des Zählers, Änderungen und manuell eingegebenen, geänderten oder gelöschten Zählerständen. Änderungen, die Tillor bei ICY feststellt, etwa eine andere Seriennummer oder eine andere Abschaltzeit des Moduls, stehen ebenfalls darin.

## Verbrauch und Trends lesen [#verbruik-en-trends-lezen]

Oben in der Karte **Verbrauch & Trends** stehen der Verbrauch **Diese Woche** und **Letzte Woche**, die Differenz **ggü. Vorwoche** und der Durchschnitt pro Woche (**Ø / Woche**). Hat der Zähler noch zu wenig Verlauf, steht dort **Nicht genug Verlauf**.

<DocScreenshot src="/screenshots/meterbeheer/meter-consumption-trends.png" alt="Verbrauch & Trends eines Zählers" />

Unter dem Diagramm stehen **Erkenntnisse**: die Prognose für die kommenden 30 Tage, die Summe im gewählten Zeitraum, ein Spitzentag, Tage ohne Verbrauch und der Verlauf. Liegt der Verbrauch der letzten 7 Tage deutlich über dem Normalen, steht dort **Erhöhter Verbrauch**, mit dem Wetter dieser Tage. Siehe [Wetter](/weer).

<Tabs items={["Per dag of per uur", "Een periode kiezen"]}>
<Tab value="Per dag of per uur">
Mit den Schaltflächen oben rechts in der Karte wechseln Sie die **Einteilung** zwischen **Pro Tag** und **Pro Stunde** sowie den **Diagrammtyp** zwischen Fläche und Balken. Pro Stunde zeigt die Stundenverbräuche als Balken. Eine Stunde, die noch läuft, erhält den Hinweis **läuft noch**.

- Wählen Sie einen Zeitraum von zwei Tagen oder weniger, etwa **Heute** oder **Gestern**, zeigt das Diagramm automatisch Balken pro Stunde.
- Bei einem längeren Zeitraum zeigt **Pro Stunde** die letzten 31 Tage.
</Tab>
<Tab value="Een periode kiezen">
Klicken Sie oben rechts auf die Kalenderschaltfläche. Links wählen Sie einen schnellen Zeitraum: **Heute**, **Gestern**, **Letzte 7 Tage**, **Letzter Monat**, **Letzte 3 Monate** oder **Alle**. Rechts wählen Sie im Kalender ein **Startdatum** und **Enddatum** und bestätigen mit **Anwenden**. Ein einzelner Klick auf einen Tag zeigt nur diesen Tag. Sie können auch die Start- und Endzeit anpassen.

<DocScreenshot src="/screenshots/meterbeheer/meter-period-picker.png" alt="Zeitraumauswahl mit schnellen Zeiträumen und Kalender" />
</Tab>
</Tabs>

## Schaltbare Zähler [#schakelbare-meters]

Bei Zählern, die Sie aus der Ferne ein- oder ausschalten können, etwa ICY, zeigt das Verlaufsdiagramm auch den Ein/Aus-Zustand. Eine grüne Linie bedeutet, dass der Zähler eingeschaltet war. Eine rote Linie mit gestrichelten Markierungen bedeutet aus. Hat eine Ablesung keine Ein/Aus-Angabe, zählt sie als ein.

Bei einem ICY-Zähler wählen Sie im Aktionsmenü unter **Stromstärke**, wie viel Ampere der Stellplatz bekommt. Sie sehen nur die Werte bis zum Maximum, das bei ICY für das Modul an diesem Stellplatz eingestellt ist: Sind das 16 A, stehen 20 A und 25 A nicht in der Liste.

## Was passiert danach? [#wat-gebeurt-er-daarna]

An Ihren Daten ändert sich nichts: Das sind nur Ansichten. Die Trends und das Wetter werden aktualisiert, sobald neue Zählerstände eingehen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Es steht Nicht genug Verlauf">
Der Zähler hat noch nicht genug Tage mit Messungen für einen Vergleich mit der Vorwoche. Schauen Sie später wieder vorbei.
</Accordion>
<Accordion title="Das Diagramm ist leer und es steht Kein Verbrauch verfügbar">
Für den gewählten Zeitraum gibt es keinen Verbrauch. Wählen Sie einen längeren Zeitraum, zum Beispiel **Alle**.
</Accordion>
<Accordion title="Der letzte Stand ist alt">
Prüfen Sie unter [Alarme und Zählerstatus](/meterbeheer/alarmen-en-status), ob ein Alarm oder eine Störung am Empfänger vorliegt.
</Accordion>
<Accordion title="Bei Stromstärke steht der gewünschte Wert nicht in der Liste">
Tillor bietet keinen Wert über dem Maximum an, das bei ICY für das Modul an diesem Stellplatz eingestellt ist. Stimmt dieses Maximum nicht, wenden Sie sich an ICY.
</Accordion>
<Accordion title="Bei Kunde steht Kein Kunde">
Auf der Parzelle des Zählers gibt es keine aktive Belegung, oder der Zähler hängt an keiner Parzelle (**Keine Parzelle**). Siehe [Einen Zähler mit einem Kunden verknüpfen](/meterbeheer/meter-koppelen).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Alarme und Zählerstatus" href="/meterbeheer/alarmen-en-status" />
  <Card title="Wetter" href="/weer" />
  <Card title="Verbrauch abrechnen" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Verbrauch abrechnen (/de-DE/meterbeheer/verbruik-factureren)

Der Verbrauch eines Kunden ist abrechnungsbereit, sobald es eine Verbrauchsperiode mit Verbrauch gibt. Sie setzen ihn mit einem Klick auf eine Rechnung, oder Sie lassen Tillor an einem festen Tag automatisch abrechnen. Wie eine Periode entsteht und schließt, lesen Sie unter [Verbrauchsperioden](/meterbeheer/consumptie-batches).

Bevor Sie beginnen:

- Der Kunde hat oder hatte eine Belegung auf einer Parzelle mit Zählern. Ohne Belegung gibt es keinen Verbrauch zum Abrechnen, siehe [Einen Zähler mit einem Kunden verknüpfen](/meterbeheer/meter-koppelen).
- Es gibt offenen Verbrauch. Sehen Sie **Keine Zähler mit offenem Verbrauch gefunden.**, gibt es nichts abzurechnen.

## Verbrauch abrechnen [#verbruik-factureren]

<Tabs items={["Vanaf de klant", "Van alle klanten", "Buiten Tillor gefactureerd"]}>
<Tab value="Vanaf de klant">
<Steps>
<Step>
### Den Kunden öffnen [#open-de-klant]
Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath>, öffnen Sie den Kunden und schauen Sie in die Karte **Zählerstände**. Dort stehen pro Zähler die offenen Perioden.
</Step>
<Step>
### Auf Verbrauch abrechnen klicken [#klik-op-factureer-verbruik]
Tillor setzt pro Periode eine Hauptzeile mit dem Betrag auf eine Rechnung, darunter eine Infozeile mit den Daten und Zählerständen. Gibt es bereits eine passende Entwurfsrechnung, fügt Tillor die Zeilen dort hinzu.
</Step>
<Step>
### Selbst wählen, welche Zähler und welche Rechnung [#kies-zelf-welke-meters-en-welke-factuur]
Öffnen Sie den Pfeil neben der Schaltfläche und wählen Sie **Mit Auswahl hinzufügen...**. Unter **Erweiterte Abrechnung** wählen Sie unter **Rechnung (optional)** eine bestehende Entwurfsrechnung, oder lassen das Feld leer für eine neue Rechnung. Unter **Zähler auswählen** haken Sie an, welche Zähler mitgehen.
</Step>
</Steps>
</Tab>
<Tab value="Van alle klanten">
Gehen Sie zu <UIPath>Kunden > Offener Verbrauch</UIPath>. Sie sehen die Kunden mit Verbrauch, der noch abgerechnet werden muss, mit dem Gesamtbetrag pro Kunde. Standardmäßig stehen hier nur Kunden ohne automatische Abrechnung. Rechnen Sie direkt aus der Zeile ab.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Kunden > Offener Verbrauch" />
</Tab>
<Tab value="Buiten Tillor gefactureerd">
Haben Sie den Verbrauch anderswo abgerechnet, markieren Sie ihn ohne Rechnung:

1. Öffnen Sie die Periode in der Karte **Zählerstände** (Kundenprofil) oder **Verbrauch** (<UIPath>Park > Zähler</UIPath> > Zähler).
2. Klicken Sie auf das Warnsymbol neben der Periode.
3. Bestätigen Sie mit **Ja, als abgerechnet markieren**.

<Callout type="warn" title="Achtung">
Tillor erstellt dabei keine Rechnung. Nur Perioden, die Sie so markiert haben, setzen Sie mit dem Symbol zum Zurücksetzen bei den abgerechneten Perioden wieder zurück. Eine Periode, die an einer echten Rechnung hängt, wird erst frei, wenn Sie diese Rechnung löschen.
</Callout>
</Tab>
</Tabs>

## Automatisch abrechnen [#automatisch-factureren]

Ist beim Kunden die automatische Abrechnung von Verbrauchskosten eingeschaltet, erstellt Tillor am gewählten Tag selbst die Rechnung und versendet sie. Das stellen Sie im Kundenprofil ein.

Zwei Regeln bestimmen, ob diese Rechnung auch tatsächlich erstellt wird:

- **Mindestbetrag.** Liegt der offene Betrag darunter, wartet Tillor bis zu einem späteren Rechnungstag. Das Minimum für alle Kunden steht unter **Einstellungen > Rechnungsstellung** als **Mindestbetrag für automatische Verbrauchsrechnungen**. Im Kundenprofil können Sie bei den Rechnungseinstellungen einen eigenen **Mindestbetrag** setzen, der für diesen Kunden Vorrang hat. Lassen Sie beide leer, wird jeder Betrag abgerechnet.
- **Verbrauch deutlich über dem Üblichen.** Beträgt der offene Strom- oder Wasserverbrauch mindestens das Doppelte dessen, was der Kunde gewöhnlich verbraucht, erstellt Tillor die Rechnung nicht. Sie erhalten eine E-Mail an die Support-Adresse Ihrer Organisation, und die Rechnung bleibt aus, bis jemand sie geprüft hat.

Tillor vergleicht jeden Typ mit sich selbst: Strom mit früherem Strom, Wasser mit früherem Wasser. Der übliche Verbrauch ist der mittlere Wert der letzten Rechnungen dieses Typs. Es gibt keine feste Grenze in m³ oder kWh. Hat der Kunde noch keine frühere Rechnung für diesen Typ, geht die Rechnung automatisch hinaus.

Stimmt der Zählerstand nach der Prüfung, rechnen Sie den Verbrauch selbst über das Kundenprofil oder über **Kunden > Offener Verbrauch** ab. Stellen Sie dort den Filter **Automatische Abrechnung** auf **Mit Datum**, um die zurückgehaltenen Kunden zu sehen.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Perioden wechseln von offen zu abgerechnet. Ist die Belegung noch aktiv, öffnet Tillor sofort eine neue Periode ab dem Endstand, sodass keine Lücke entsteht.
- Die Zeilen stehen auf einer Entwurfsrechnung. Buchen und versenden Sie diese wie jede andere Rechnung, siehe [Rechnungen](/facturen).
- Löschen Sie die Entwurfsrechnung wieder, wird der Verbrauch erneut verfügbar. Siehe [Rechnung löschen](/meterbeheer/consumptie-batches#factuur-verwijderen).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet Fehler bei der Abrechnung">
Der Verbrauch konnte nicht auf die Rechnung gesetzt werden. Versuchen Sie es erneut. Klappt es nicht mit einer gewählten Entwurfsrechnung, wählen Sie **Neue Rechnung erstellen**.
</Accordion>
<Accordion title="Die automatische Rechnung wurde nicht erstellt und ich habe eine E-Mail bekommen">
Der Verbrauch lag mindestens doppelt so hoch wie üblich. Prüfen Sie den Zählerstand und rechnen Sie selbst ab, wenn alles stimmt.
</Accordion>
<Accordion title="Der Kunde steht nicht in Offener Verbrauch">
Die Liste zeigt standardmäßig nur Kunden ohne automatische Abrechnung. Stellen Sie den Filter **Automatische Abrechnung** auf **Mit Datum**, um die anderen Kunden zu sehen. Steht der Kunde dann immer noch nicht da, gibt es keinen offenen Verbrauch.
</Accordion>
<Accordion title="Es gibt nichts abzurechnen, obwohl der Kunde Wasser verbraucht hat">
Prüfen Sie, ob der Kunde eine aktive Belegung auf der Parzelle hat, an der der Zähler hängt, und ob nach dem Startstand ein Zählerstand eingegangen ist. Eine Periode ohne Verbrauch ergibt keinen Betrag.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Verbrauchsperioden" href="/meterbeheer/consumptie-batches" />
  <Card title="Rechnungen" href="/facturen" />
  <Card title="Kundenverwaltung" href="/klantenbeheer" />
</Cards>


# Übersicht (/de-DE/nfc)

Ein NFC-Tag ist eine Karte, ein Armband, ein Schlüsselanhänger oder ein Aufkleber, den ein Kunde an ein Lesegerät hält, wie beim kontaktlosen Bezahlen. Damit nimmt er eine Dusche, öffnet eine Tür oder lädt sein Auto. Auf dieser Seite sehen Sie, wie ein Tag, ein Kunde und ein Guthaben zusammengehören. Die Schritte zum Verknüpfen oder Aufladen eines Tags stehen unter [Tags verwalten](/nfc/nfc-tags).

Alle Tags Ihrer Organisation finden Sie auf der Seite **Controller**, in der Karte **NFC-Tags**.

<DocScreenshot src="/screenshots/nfc/nfc-tags-list.png" alt="Die Karte NFC-Tags auf der Seite Controller" />

<Callout type="info" title="Gut zu wissen">
- Ein Tag erscheint automatisch in Tillor, sobald er zum ersten Mal vor ein Lesegerät gehalten wurde. Sie legen ihn nicht selbst an.
- Ein Tag gehört zu höchstens einem Kunden und hat den Status **Aktiv**, **Inaktiv** oder **Blockiert**.
- Das Guthaben steht in Euro auf dem Tag. Jede Guthabenänderung wird immer als Transaktion gespeichert und kann nicht bearbeitet oder gelöscht werden.
- Eine Zahlung, die noch auf den Tag geschrieben werden muss, bleibt 2 Minuten offen. Danach verfällt sie.
- Ein blockierter Tag funktioniert an den Lesegeräten nicht mehr.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Der Tag selbst weiß nichts. Tillor merkt sich, wer ihn hat, wie hoch das Guthaben ist und wohin er darf. Das Lesegerät fragt das bei Tillor an, sobald der Kunde den Tag davorhält.

```mermaid
flowchart TD
  K[Kunde] --> T[NFC-Tag]
  T --> G[Zugriffsgruppen<br/>wohin darf der Tag?]
  T --> S[Guthaben<br/>wie viel Guthaben ist drauf?]
  L[Lesegerät an Dusche, Tür oder Ladesäule] -->|Kunde hält den Tag daran| T
  L --> TR[Transaktion<br/>Betrag, Grund und Lesegerät]
  S --> TR
```

- Ohne Kunde lehnt das Lesegerät den Tag ab. Auf dem Display steht dann **Tag nicht verknüpft**.
- Ohne die richtige Zugriffsgruppe lehnt das Lesegerät den Tag mit **Kein Zugriff** ab.
- Bei zu wenig Guthaben steht dort **Guthaben reicht nicht**. Alle Displaymeldungen stehen unter [Displaymeldungen](/controllers/troubleshooting/scherm).
- Jede Abbuchung oder Aufladung erscheint als Zeile in den [Transaktionen](/nfc/nfc-transacties).
- Ein Tag ist auch eine Zugangsmethode. Sie fügen ihn einem Kunden unter [Zutrittskontrolle](/toegangscontrole#een-toegangsmethode-toevoegen) hinzu.

## Bestandteile [#onderdelen]

<Cards>
  <Card title="Tags verwalten" href="/nfc/nfc-tags" description="Tags mit Kunden verknüpfen und Guthaben bearbeiten" />
  <Card title="Transaktionen" href="/nfc/nfc-transacties" description="Alle Nutzungen und Guthabenänderungen" />
  <Card title="Controller" href="/controllers" description="Die Lesegeräte, an die Kunden ihren Tag halten" />
</Cards>

## Begriffe [#begrippen]

- **Tag**: die Karte, das Armband, der Aufkleber oder der Schlüsselanhänger.
- **UID**: die eindeutige Nummer des Tags.
- **Guthaben**: das Guthaben auf dem Tag.
- **Zugriffsgruppe**: legt fest, für welche Lesegeräte ein Tag gilt.
- **Transaktion**: eine Abbuchung oder Aufladung des Guthabens.

Weitere Erklärungen finden Sie im [Glossar](/begrippen).


# Tags verwalten (/de-DE/nfc/nfc-tags)

Ein NFC-Tag ist erst nutzbar, wenn er an einem Kunden hängt. Dann kann dieser Kunde damit duschen, eine Tür öffnen oder laden, und Sie können das Guthaben im Blick behalten. Alle Schritte unten erledigen Sie im Kundenprofil. Was bei jedem Scan passiert, lesen Sie unter [Transaktionen](/nfc/nfc-transacties).

Bevor Sie beginnen:

- Der Tag muss bereits in Tillor stehen. Das geschieht automatisch, sobald er zum ersten Mal vor ein Lesegerät gehalten wurde.
- Der Tag darf noch an keinem anderen Kunden hängen. Sonst steht er nicht in der Liste.
- Gibt es keinen freien Tag, steht in der Liste **Keine verfügbaren Tags gefunden**.

## Einen Tag mit einem Kunden verknüpfen [#een-tag-koppelen-aan-een-klant]

<Steps>
<Step>
### Den Tab NFC-Tags öffnen [#open-het-tabblad-nfc-tags]
Gehen Sie zu <UIPath>Kunden > Kunde > NFC-Tags</UIPath>. Sie sehen alle Tags dieses Kunden. Über der Tabelle filtern Sie nach **UID** und **Typ** (**Karte**, **Armband**, **Aufkleber** oder **Schlüsselanhänger**).
</Step>
<Step>
### Den Tag wählen [#kies-de-tag]
Klicken Sie auf **Karte auswählen** und wählen Sie den Tag. Sie können in der Liste suchen.
</Step>
<Step>
### Auf Zuweisen klicken [#klik-op-toewijzen]
Tillor meldet **Karte dem Kunden zugewiesen**, und der Tag steht in der Tabelle.
</Step>
</Steps>

In der Tabelle sehen Sie pro Tag die **UID** (das Symbol zeigt den Typ), den **Status**, das **Guthaben**, wann er **Zuletzt verwendet** wurde und die **Zugriffsgruppen**.

## Was können Sie mit einem Tag tun? [#wat-kun-je-met-een-tag-doen]

Öffnen Sie das Aktionsmenü (drei Punkte) hinter dem Tag.

<DocScreenshot src="/screenshots/nfc/nfc-tag-actions-menu.png" alt="Aktionsmenü eines NFC-Tags" />

| Aktion | Was sie bewirkt |
|---|---|
| **Guthaben bearbeiten** | Fügt einen Betrag hinzu oder legt das Guthaben fest, siehe unten. |
| **Sperren** / **Entsperren** | Setzt den Status auf **Blockiert** oder wieder zurück. |
| **Zugriffsgruppen** | Legt fest, für welche Zugriffsgruppen der Tag gilt. |
| **Niedriges-Guthaben-Benachrichtigung senden** | Schickt dem Kunden eine Meldung, dass das Guthaben niedrig ist. |
| **Persönliche URL kopieren** | Kopiert den Link zur eigenen Seite des Tags. |
| **Vom Kunden entfernen** | Löst den Tag vom Kunden. |
| **Details anzeigen** | Öffnet die Detailseite mit Transaktionen und Aktivität. |

### Das Guthaben anpassen [#het-saldo-aanpassen]

<Steps>
<Step>
### Guthaben bearbeiten wählen [#kies-saldo-bewerken]
Öffnen Sie das Aktionsmenü und wählen Sie **Guthaben bearbeiten**.
</Step>
<Step>
### Wählen, wie Sie das Guthaben ändern [#kies-hoe-je-het-saldo-wijzigt]
<DocScreenshot src="/screenshots/nfc/nfc-tag-topup-dialog.png" alt="Dialog Guthaben bearbeiten" />

Wählen Sie bei **Option** entweder **Guthaben hinzufügen** (ein Betrag kommt dazu) oder **Guthaben festlegen** (ein exakter Betrag). Unten sehen Sie das Ergebnis, zum Beispiel **Aktuell: ... → Neu: ...**.
</Step>
<Step>
### Bestätigen [#bevestig]
Tragen Sie den Betrag ein und klicken Sie auf **Hinzufügen** oder **Festlegen**. Der Betrag muss positiv sein. Tillor meldet **Guthaben aktualisiert** oder **Guthaben festgelegt**.
</Step>
</Steps>

### Einen Tag sperren [#een-tag-blokkeren]

Einen verlorenen oder gestohlenen Tag sperren Sie über **Sperren**. Der Status wird **Blockiert**, und der Tag funktioniert an den Lesegeräten nicht mehr. Mit **Entsperren** im selben Menü heben Sie die Sperre auf. Der Kunde kann seinen Tag auch selbst auf der persönlichen Seite sperren.

### Zugriffsgruppen wählen [#toegangsgroepen-kiezen]

Wählen Sie **Zugriffsgruppen** und haken Sie die Gruppen an oder ab. Die Änderung gilt sofort. Sehen Sie **Keine Zugriffsgruppen verfügbar**, sind für Ihre Organisation noch keine Gruppen eingerichtet.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein verknüpfter Tag erscheint in der Tabelle und beim Kunden. Hält der Kunde ihn vor ein Lesegerät, fragt das Lesegerät bei Tillor an, ob das erlaubt ist.
- Jede Guthabenänderung wird zu einer [Transaktion](/nfc/nfc-transacties), auch wenn Sie das Guthaben manuell anpassen. Der Grund lautet dann **Manuell angepasst**.
- Unter **Aktivität** auf der Detailseite sehen Sie Vorher und Nachher jeder Änderung (Guthaben, Sperre, Kundenverknüpfung).
- Bei **Vom Kunden entfernen** bleibt der Tag bestehen. Er ist wieder frei und kann einem anderen Kunden gegeben werden. Die Transaktionen bleiben erhalten.
- Über **Persönliche URL kopieren** erhält der Kunde eine eigene Seite. Dort kann er seine Karte sperren und, wenn Sie Online-Zahlungen eingerichtet haben, selbst aufladen. Das ergibt eine Rechnung für den Kunden.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Liste mit Tags ist leer">
Tillor sagt **Keine verfügbaren Tags gefunden**. Nur Tags, die noch niemandem gehören, stehen darin. Lösen Sie den Tag mit **Vom Kunden entfernen** vom anderen Kunden, oder halten Sie einen neuen Tag vor ein Lesegerät, damit er in Tillor erscheint.
</Accordion>
<Accordion title="Tillor sagt: Aktualisierung fehlgeschlagen">
Das Guthaben oder die Zugriffsgruppen konnten nicht gespeichert werden. Versuchen Sie es erneut. Klappt es nicht, laden Sie die Seite neu und prüfen Sie, ob der Tag noch am Kunden hängt.
</Accordion>
<Accordion title="Der Kunde wird am Lesegerät abgewiesen">
Lesen Sie den Grund auf dem Display des Controllers, siehe [Displaymeldungen](/controllers/troubleshooting/scherm). Meistens ist der Tag **Blockiert**, hängt an keinem Kunden, die richtige Zugriffsgruppe ist nicht eingeschaltet oder das Guthaben ist zu niedrig.
</Accordion>
<Accordion title="Tillor sagt: Betrag muss positiv sein">
Der Betrag muss ausgefüllt und größer als null sein. Sonst meldet Tillor **Betrag ist erforderlich**, **Ungültiger Betrag** oder **Betrag muss positiv sein**.
</Accordion>
<Accordion title="Der Kunde kann nicht selbst aufladen">
Das Aufladen über die persönliche Seite funktioniert nur, wenn Ihre Organisation Online-Zahlungen eingerichtet hat und der Tag an einem Kunden hängt. Siehe [Zahlungsabwicklung](/betalingsverwerking).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Transaktionen" href="/nfc/nfc-transacties" description="Transaktionsverlauf ansehen" />
  <Card title="Zutrittskontrolle" href="/toegangscontrole" description="Schranken und Zugangsmethoden" />
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Kundenprofile verwalten" />
</Cards>


# Transaktionen (/de-DE/nfc/nfc-transacties)

Jede Guthabenänderung an einem NFC-Tag wird als Transaktion festgehalten, auch eine manuelle Anpassung. So sehen Sie genau, wann und wodurch sich das Guthaben geändert hat. Transaktionen können nicht bearbeitet oder gelöscht werden.

## Transaktionen ansehen [#transacties-bekijken]

<Steps>
<Step>
### Den Tag öffnen [#open-de-tag]
Gehen Sie zu <UIPath>Kunden > Kunde > NFC-Tags</UIPath>, öffnen Sie das Aktionsmenü (drei Punkte) hinter dem Tag und wählen Sie **Details anzeigen**.
</Step>
<Step>
### Bei Transaktionen nachsehen [#kijk-bij-transacties]
Die Karte **Transaktionen** steht auf der Detailseite. Die neueste steht oben. Bei mehr als fünf Transaktionen blättern Sie unten.

<DocScreenshot src="/screenshots/nfc/nfc-tag-detail.png" alt="Detailseite eines NFC-Tags mit Transaktionen" />
</Step>
</Steps>

Über der Tabelle stehen Filter für **Datum**, **Status**, **Herkunft** und **Stornogrund**. Standardmäßig sind **Ausstehend** und **Verarbeitet** eingeschaltet. Möchten Sie auch stornierte und abgelaufene Transaktionen sehen, klicken Sie auf **Filter löschen**.

## Spalten [#kolommen]

| Spalte | Bedeutung |
|---|---|
| **Betrag** | Die Guthabenänderung. Positiv beim Aufladen, negativ bei der Nutzung. |
| **Grund** | Der Anlass, zum Beispiel **Duschnutzung bei** einem Controller, **POS-Abbuchung**, **POS-Aufladung**, **Manuell angepasst** oder **Hinzugefügt, weil Rechnung ... bezahlt wurde**. |
| **Controller** | Der Controller, der die Transaktion ausgelöst hat. Steht dort **System**, gab es keinen Controller: eine manuelle Änderung, die Rezeptions-App oder eine bezahlte Rechnung. |
| **Datum** | Datum und Uhrzeit. |
| **Status** | Siehe unten. |
| **Herkunft** | **Online** oder **Offline**. |
| **Beschreibung**, **Stornogrund** | Zusätzliche Erläuterung und bei einer stornierten Transaktion der Grund. |

## Status [#statussen]

| Status | Bedeutung |
|---|---|
| <Status tone="info">Ausstehend</Status> | Die Abbuchung ist reserviert und muss noch auf den Tag geschrieben werden. |
| <Status tone="success">Verarbeitet</Status> | Die Transaktion ist abgeschlossen und das Guthaben wurde angepasst. |
| <Status tone="error">Storniert</Status> | Die Transaktion wurde nicht durchgeführt. Der Grund steht in **Stornogrund**. |
| <Status>Abgelaufen</Status> | Der Tag wurde nicht rechtzeitig an das Lesegerät gehalten. Eine Reservierung bleibt 2 Minuten offen. |

Mögliche Stornogründe sind **Guthaben reicht nicht**, **Nicht autorisiert**, **Schreiben auf die Karte fehlgeschlagen** und **Abgelaufen**.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Eine ausstehende Transaktion wird <Status tone="success">Verarbeitet</Status>, sobald der Tag das neue Guthaben erhalten hat. Gelingt das nicht innerhalb von 2 Minuten, wird sie <Status>Abgelaufen</Status> und das Guthaben ändert sich nicht.
- Bei **Herkunft** steht **Offline**, wenn die Transaktion nicht live über Tillor abgelaufen ist.
- Ein Mitarbeiter an der Rezeption kann in der Tillor-App dieselbe Abbuchung oder Aufladung vornehmen. Das Guthaben wird dann nur in Tillor aktualisiert. Das steht als **POS-Abbuchung** oder **POS-Aufladung**, ohne Controller.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Das Guthaben stimmt nicht mit dem überein, was der Kunde erwartet">
Öffnen Sie die Transaktionen und schauen Sie auf Grund und Datum der letzten Zeilen. Eine Zeile mit **Manuell angepasst** wurde von einem Kollegen eingegeben. Sehen Sie Transaktionen mit **Abgelaufen** oder **Storniert**, wurde dafür nichts abgebucht.
</Accordion>
<Accordion title="Eine Transaktion steht auf Ausstehend und verschwindet nicht">
Warten Sie, bis die 2 Minuten vorbei sind. Die Transaktion wird dann <Status>Abgelaufen</Status>. Lassen Sie den Kunden den Tag erneut an das Lesegerät halten.
</Accordion>
<Accordion title="Die Karte Transaktionen ist leer">
Der Tag wurde noch nicht benutzt und das Guthaben wurde nicht angepasst. Dann gibt es nichts anzuzeigen.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Tags verwalten" href="/nfc/nfc-tags" description="Karten verknüpfen und Guthaben bearbeiten" />
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Kundenprofile ansehen" />
</Cards>


# Benachrichtigungen (/de-DE/notificaties)

Die Benachrichtigungsübersicht zeigt jede Nachricht, die Tillor an Kunden und Kollegen gesendet hat, per E-Mail, SMS, Post, WhatsApp oder Push. Sie sehen auf einen Blick, welche Nachrichten angekommen sind, welche noch unterwegs sind und welche fehlgeschlagen sind. Wie Sie selbst eine Rechnungsnachricht versenden, steht unter [Eine Rechnung oder Mahnung versenden](/communicatie/e-mails).

Sie öffnen die Übersicht über <UIPath>Kommunikation > Benachrichtigungen</UIPath>.

<Callout type="info" title="Gut zu wissen">
- Bleibt eine Nachricht länger als 5 Minuten hängen, ohne weitergegeben worden zu sein, versucht Tillor es automatisch erneut
- Hat nach 2 Tagen noch kein Versand stattgefunden, setzt Tillor die Nachricht auf **Fehlgeschlagen**. Das gilt auch für eine SMS, die so lange auf **Ausstehend** stehen bleibt
- Die Liste **Letzte Kommunikation** zeigt standardmäßig 50 Nachrichten pro Seite
- Ein Klick auf einen Link in einer E-Mail oder SMS zählt erst, wenn er mindestens etwa anderthalb Sekunden nach dem Versand erfolgt. So zählen Mailprogramme, die Links vorab abrufen, nicht als Klick
- Rechnungsnachrichten gehen nicht von selbst raus, wenn Sie eine Rechnung buchen. Sie starten den Versand
- Eine Karte mit einer neuen Benachrichtigung in Tillor verschwindet nach einigen Sekunden. Die Benachrichtigung bleibt in der Glocke stehen, bis Sie sie lesen
- Benachrichtigungen, die immer versendet werden, können Sie nicht ausschalten
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Nachricht beginnt mit einem Anlass. Danach wählt Tillor den Kanal und speichert das Ergebnis in der Übersicht.

```mermaid
flowchart LR
  A[Jij klikt op Verstuur notificatie] --> D[Bericht]
  B[Er gebeurt iets, zoals een meteralarm] --> D
  C[Een automatisering stuurt een bericht] --> D
  D --> E{Voor wie?}
  E -- Klant --> F[E-mail, sms, post of WhatsApp]
  E -- Collega --> G[Push, e-mail of telefoon, naar zijn voorkeuren]
  F --> H[Notificaties: status per kanaal]
  G --> H
  G --> I[Bel in Tillor]
  H --> J[Ook zichtbaar bij de klant en op de factuur]
```

- **An einen Kunden** wählen Sie den Kanal meist selbst, zum Beispiel im Fenster **Benachrichtigung senden** auf einer Rechnung. Auch eine [Automatisierung](/begrippen#automatisering) kann eine Nachricht an einen Kunden senden.
- **An einen Kollegen** legt dieser Kollege selbst fest, wie Tillor ihn erreicht, pro Art der Benachrichtigung. Siehe [Benachrichtigungen in der App](#meldingen-in-de-app).
- **Das Ergebnis** sehen Sie hier, außerdem beim Kunden und auf der Rechnung, zu der die Nachricht gehört. Die Spalte **Herkunft** führt Sie direkt dorthin.

## Benachrichtigungen ansehen [#notificaties-bekijken]

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Benachrichtigungsübersicht mit Statistiken und Listen" />

Oben stehen vier Statistiken:

- **Benachrichtigungen gesamt**: alle Versandversuche
- **Gesendete Benachrichtigungen**: Nachrichten, die zugestellt wurden
- **Fehlgeschlagene Benachrichtigungen**: Nachrichten, die nicht zugestellt werden konnten
- **Zurückgewiesene Benachrichtigungen**: Nachrichten, die zurückgekommen sind, vor allem E-Mails

Darunter stehen vier Listen: **Zurückgewiesene Benachrichtigungen**, **Ausstehende Benachrichtigungen** (noch in der Warteschlange oder unterwegs), **Letzte Kommunikation** (alle Status) und **Fehlgeschlagene Benachrichtigungen**. Mit den Filtern **Art** und **Kanal** über jeder Liste schränken Sie ein, was Sie sehen. Welche Arten es gibt, steht unter [Benachrichtigungsarten](/communicatie/notificatietypes).

Jede Zeile zeigt:

| Spalte | Was Sie sehen |
|---|---|
| **Art** | Um welche Nachricht es sich handelt, zum Beispiel Neue Rechnung oder Alarm an Zähler oder Controller |
| **Herkunft** | Die Rechnung, der Kunde oder die Zahlung, zu der die Nachricht gehört |
| **Kanal** | E-Mail, SMS, Post, WhatsApp oder Push |
| **Status** | Der Zustellstatus |
| **Empfänger** | Die E-Mail-Adresse, Telefonnummer, Postadresse oder der Benutzer |
| **Datum** | Wann der Versandversuch angelegt wurde |

### Zustellungsdetails ansehen [#leveringsdetails-bekijken]

Klicken Sie in einer Zeile auf den Kanal, um zu sehen, was genau versendet wurde und was passiert ist.

<DocScreenshot src="/screenshots/notificaties/notifications-delivery-detail.png" alt="Zustellungsdetails der E-Mail Neue Rechnung" />

Das Fenster zeigt den Zustellstatus, eine eventuelle Fehlermeldung, den Empfänger (**An**), die Absenderadresse (**Von**) und bei E-Mail den **Betreff**. Außerdem sehen Sie, wann die Nachricht bereitstand (**Erstellt am**) und wann sie wirklich abgeschickt wurde (**Gesendet am**). **Gesendet von** zeigt den Benutzer, der den Versand gestartet hat, oder **System**, wenn es automatisch geschah. Unten stehen der **Inhalt** und eventuelle **Anhänge**.

Bei E-Mail und WhatsApp sehen Sie auch **Gelesen am**, und in der Liste ein Augensymbol bei gelesenen Nachrichten. Bei E-Mail und SMS steht **Geklickt am**, wenn der Kunde auf einen Link geklickt hat.

Bei Post gibt es zusätzliche Felder: **Referenz des Versanddienstleisters**, **Tracking-Status** und **Letzte Tracking-Aktualisierung** (das letzte Ereignis des Postdienstes), **Portokosten** zum Zeitpunkt des Versands und, bei einer Einschreibensendung, das Label **Einschreiben** mit den Zusatzkosten und einer Erläuterung zur Weiterberechnung.

<DocScreenshot src="/screenshots/notificaties/notifications-post-registered-detail.png" alt="Zustellungsdetails einer Mahnung per Einschreiben" />

### Status [#statussen]

| Status | Bedeutung |
|---|---|
| <Status tone="info">Ausstehend</Status> | Die Nachricht wird verarbeitet oder steht in der Warteschlange |
| <Status tone="success">Gesendet</Status> | Die Nachricht wurde zugestellt |
| <Status tone="error">Fehlgeschlagen</Status> | Die Zustellung ist fehlgeschlagen |
| <Status>Übersprungen</Status> | Die Nachricht wurde nicht (mehr) versendet, zum Beispiel weil Push nicht verfügbar war oder weil ein Brief beim Postdienst storniert wurde |
| <Status tone="info">Verzögert</Status> | Die Nachricht ist geplant und geht später raus |
| <Status tone="warning">Zurückgewiesen</Status> | Die Nachricht konnte die E-Mail-Adresse oder Nummer nicht erreichen |
| <Status tone="error">Beschwert</Status> | Der Empfänger hat die Nachricht als Spam markiert |

Ein Brief per Post startet auf **Ausstehend**. Sobald der Postdienst bestätigt, dass der Brief unterwegs oder zugestellt ist, wird daraus **Gesendet**. Unzustellbare Post wird **Fehlgeschlagen**. Ein stornierter Brief wird **Übersprungen**. Diese Zeile finden Sie vor allem unter **Letzte Kommunikation**.

## Benachrichtigungen in der App [#meldingen-in-de-app]

Alles, was Tillor Ihnen als Kollegen sendet, etwa eine zugewiesene Aufgabe, eine Erwähnung in einem Kommentar oder ein Zähleralarm, finden Sie auch in Tillor selbst. Jede Benachrichtigung steht dort nur einmal, auch wenn sie per E-Mail und Push verschickt wurde. Dafür müssen Sie nichts einstellen.

- **Glocke**: oben rechts in der Leiste und links unten im Menü (**Benachrichtigungen**) steht eine Glocke mit der Anzahl ungelesener Benachrichtigungen. Klicken Sie darauf, um Ihre neuesten Benachrichtigungen zu sehen. Mit **Alle als gelesen markieren** aktualisieren Sie die Liste in einem Schritt
- **E-Mail ansehen**: Klicken Sie auf eine Benachrichtigung, um die E-Mail zu öffnen, die Sie dazu erhalten haben, mit einer Schaltfläche zur zugehörigen Seite oben (zum Beispiel **Aufgabe öffnen**). Eine Benachrichtigung ohne E-Mail führt Sie direkt zu dieser Seite. Die Benachrichtigung gilt danach als gelesen
- **Karte unten rechts**: Kommt eine Benachrichtigung herein, während Tillor geöffnet ist, erscheint sie als Karte unten rechts, an derselben Stelle wie ein eingehendes Gespräch. Klicken Sie auf die Karte oder schließen Sie sie mit dem Kreuz. Eine geschlossene Karte bleibt in der Glocke ungelesen stehen. Befinden Sie sich schon auf der Seite, um die es in der Benachrichtigung geht, erscheint keine Karte
- **Bleibt stehen**: Benachrichtigungen, für die Sie auch angerufen werden, etwa ein Connector, der nicht mehr erreichbar ist, bleiben stehen, bis Sie sie schließen
- **Posteingang**: Neue Nachrichten im Posteingang behalten ihre eigene Karte und ihren eigenen Zähler bei **Posteingang**. In der Glocke stehen sie sofort als gelesen. Das gilt auch für die tägliche Übersicht der Zähler, die Aufmerksamkeit brauchen
- **Pro Tag**: In der Liste stehen Ihre Benachrichtigungen pro Tag, mit der Kategorie dabei. Mit den Schaltflächen oben zeigen Sie eine Kategorie an

Benachrichtigungen sind persönlich: Sie sehen nur Ihre eigenen, pro Organisation.

In einer [Automatisierung](/begrippen#automatisering) legen Sie beim Schritt **Kollegen benachrichtigen** mit **In Tillor anzeigen** fest, ob die Benachrichtigung eine Karte und einen Ungelesen-Zähler bekommt. Ist das ausgeschaltet, steht sie in der Liste als gelesen.

### Benachrichtigungen ausschalten [#meldingen-uitzetten]

<Steps>
<Step>
### Öffnen Sie Ihr Konto [#open-je-account]
Klicken Sie im Menü auf Ihren Namen und wählen Sie **Konto**.
</Step>
<Step>
### Gehen Sie zu Benachrichtigungen [#ga-naar-meldingen]
Schalten Sie pro Art der Benachrichtigung die Kanäle ein oder aus. In der Zeile **Alle Benachrichtigungen** schalten Sie einen Kanal für alles auf einmal aus.
</Step>
</Steps>

Ein Kanal, den Sie bei **Alle Benachrichtigungen** ausschalten, bleibt für jede darunter liegende Benachrichtigung aus, außer für die Benachrichtigungen, die immer versendet werden. Eine Art, bei der Sie alle Kanäle ausschalten, erscheint auch nicht mehr in der App. Für einen Kollegen regeln Sie das unter <UIPath>Einstellungen > Benutzer</UIPath>, siehe [Benachrichtigungen eines Kollegen einstellen](/gebruikers/gebruikers-en-rechten#meldingen-van-een-collega-instellen).

## Externe Benachrichtigungen [#externe-notificaties]

Ein angebundenes externes System, zum Beispiel Ihre Newsletter- oder Buchungssoftware, kann E-Mails, die es selbst an einen Kunden gesendet hat, in Tillor registrieren lassen. Sie finden sie beim Kunden, auf der Rechnung und unter **Letzte Kommunikation**, zwischen den Nachrichten von Tillor. Sie erkennen sie am Label **Extern** mit dem Namen des Systems.

- Tillor hat die Nachricht nicht versendet und kann den Status nicht prüfen. Der Status kommt vom externen System
- Externe Benachrichtigungen zählen nicht in den Statistiken oben mit und stehen nicht in den Listen **Zurückgewiesene Benachrichtigungen**, **Ausstehende Benachrichtigungen** und **Fehlgeschlagene Benachrichtigungen**
- Im Detailfenster sind Bilder standardmäßig blockiert. So bemerkt der Absender nicht, dass Sie die Nachricht öffnen. Klicken Sie auf **Bilder laden**, um sie trotzdem anzuzeigen
- Das externe System kann seine eigenen Benachrichtigungen später aktualisieren oder löschen. Das sehen Sie im [Aktivitätslog](/activiteitenlog) des Kunden oder der Rechnung

Wer externe Benachrichtigungen registrieren darf, regeln Sie mit den Berechtigungen **Externe Benachrichtigungen registrieren** und **Externe Benachrichtigungen anderer verwalten**. Die technische Erläuterung für Integratoren steht unter [Entwickler > Externe Benachrichtigungen](/ontwikkelaars/externe-notificaties).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Eine Nachricht steht auf Zurückgewiesen">
Die E-Mail-Adresse oder Nummer des Kunden existiert nicht oder kann keine Nachrichten empfangen. Öffnen Sie die Nachricht über die Liste **Zurückgewiesene Benachrichtigungen** und lesen Sie die Fehlermeldung. Gehen Sie über die Spalte **Herkunft** zum Kundenprofil, korrigieren Sie die E-Mail-Adresse und senden Sie die Nachricht mit **Benachrichtigung senden** auf der Rechnung erneut.
</Accordion>
<Accordion title="Eine SMS oder WhatsApp-Nachricht ist fehlgeschlagen">
Öffnen Sie die Nachricht über **Fehlgeschlagene Benachrichtigungen** und lesen Sie die Fehlermeldung. Meistens stimmt die Telefonnummer nicht oder die Landesvorwahl fehlt. Passen Sie die Nummer im Kundenprofil an und senden Sie erneut.
</Accordion>
<Accordion title="Eine SMS bleibt auf Ausstehend stehen">
Der Mobilfunkanbieter meldet die Zustellung manchmal mit Verzögerung zurück. Nach 2 Tagen setzt Tillor die SMS automatisch auf **Fehlgeschlagen**. Öffnen Sie das Detailfenster für die Fehlermeldung und prüfen Sie die Nummer.
</Accordion>
<Accordion title="Ein Brief per Post ist fehlgeschlagen oder unzustellbar">
Öffnen Sie die Nachricht über **Ausstehende Benachrichtigungen** oder **Fehlgeschlagene Benachrichtigungen**. Prüfen Sie die Postadresse im Kundenprofil (Straße, Postleitzahl und Ort) und senden Sie den Brief mit **Benachrichtigung senden** oder **Erinnerung senden** auf der Rechnung erneut.
</Accordion>
<Accordion title="Ein Brief steht auf Übersprungen">
Der Brief wurde beim Postdienst storniert. Suchen Sie die Sendung unter **Letzte Kommunikation** und sehen Sie bei **Tracking-Status** nach, was passiert ist. Senden Sie nur erneut, wenn der Kunde den Brief noch erhalten soll.
</Accordion>
<Accordion title="Ich sehe die Schaltfläche Benachrichtigung senden auf einer Rechnung nicht">
Die Schaltfläche steht nur auf einer gebuchten Rechnung, und nur, wenn der Kunde eine E-Mail-Adresse, eine Telefonnummer oder eine vollständige Postadresse hat. Ergänzen Sie eine dieser Angaben im Kundenprofil.
</Accordion>
<Accordion title="Ich erhalte keine Benachrichtigung mehr in Tillor">
Prüfen Sie unter **Konto** bei **Benachrichtigungen**, ob Sie alle Kanäle für diese Art ausgeschaltet haben. Eine Art ohne Kanäle erscheint auch nicht mehr in der Glocke.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **[Benachrichtigung](/begrippen#notificatie)**: eine Nachricht, die Tillor an einen Kunden oder Kollegen sendet, per E-Mail, SMS, Post, WhatsApp oder Push.
- **Kanal**: der Weg, auf dem eine Nachricht rausgeht. Eine Benachrichtigung kann über mehrere Kanäle laufen.
- **Zustellung**: ein Versandversuch über einen Kanal, mit eigenem Status.
- **Zurückgewiesen**: die Nachricht kam zurück, weil die Adresse oder Nummer nicht existiert.
- **Meldung**: eine Benachrichtigung für einen [Benutzer](/begrippen#gebruiker) von Tillor, sichtbar in der Glocke.
- **Extern**: eine Nachricht, die ein angebundenes System selbst gesendet hat und die nur in Tillor registriert ist.

Weitere Begriffe finden Sie im [Glossar](/begrippen).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Eine Rechnung oder Mahnung versenden" href="/communicatie/e-mails" description="Selbst eine Nachricht von einer Rechnung aus versenden" />
  <Card title="Benachrichtigungsarten" href="/communicatie/notificatietypes" description="Alle Arten von Nachrichten und wann sie rausgehen" />
  <Card title="Eine Rechnung versenden" href="/facturen/versturen" description="Rechnungen und Mahnbriefe per Post" />
  <Card title="Automatisierungen" href="/automatiseringen" description="Nachrichten durch eine Automatisierung versenden lassen" />
</Cards>


# Kommentare (/de-DE/notities)

Mit Kommentaren arbeiten Kollegen rund um Kunden, Rechnungen, Reservierungen und andere Datensätze zusammen, ohne dass der Kunde etwas sieht. Sie schreiben einen Kommentar auf der Detailseite des Datensatzes, erwähnen einen Kollegen mit @ und heften wichtige Kommentare an. Beginnen Sie bei [Einen Kommentar hinzufügen](#een-opmerking-toevoegen).

<Callout type="info" title="Gut zu wissen">
- Kommentare sind immer intern. Sie werden für Kunden nie sichtbar, auch nicht auf Rechnungen oder in E-Mails.
- Ein Kollege, den Sie mit @ erwähnen, erhält eine Benachrichtigung.
- Einen gelösten Kommentar können Sie nicht mehr bearbeiten oder anheften.
- Das Lösen eines Kommentars löst einen angehefteten Kommentar automatisch.
- Das Löschen eines Kommentars kann nicht rückgängig gemacht werden.
- Ein angehefteter Kommentar bleibt oben im Datensatz sichtbar, ohne dass Sie zur Karte **Kommentare** scrollen müssen.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  R[Record: klant, factuur, reservering...] --> O[Opmerking]
  O -->|@ vermelding| M[Melding voor de collega]
  O -->|Vastzetten| P[Bovenaan het record]
  O -->|Herinnering| T[Taak om op te volgen]
  O -->|Oplossen| X[Opgelost en ingeklapt]
```

Alle Kommentare Ihrer Organisation stehen auch gesammelt unter <UIPath>Kommunikation > Kommentare</UIPath>, mit einem Verweis auf den Datensatz, zu dem sie gehören.

## Wo finden Sie Kommentare? [#waar-vind-je-opmerkingen]

Auf Detailseiten gibt es eine Karte **Kommentare**. Je nach Datensatz:

- <UIPath>Kunden > Übersicht</UIPath> oder <UIPath>Kunden > Kommunikation</UIPath>: im Kundenprofil
- <UIPath>Verwaltung > Rechnungen</UIPath>: auf der Rechnungsdetailseite
- <UIPath>Kunden > Reservierungen</UIPath>: auf der Reservierungsdetailseite
- <UIPath>Park > Parzellen</UIPath>: auf der Parzellendetailseite
- <UIPath>Park > Zähler</UIPath>: auf der Zählerdetailseite
- <UIPath>Verwaltung > Zahlungsberichte</UIPath>: auf dem Zahlungsbericht

## Einen Kommentar hinzufügen [#een-opmerking-toevoegen]

<Steps>
<Step>
### Öffnen Sie den Datensatz [#open-het-record]
Öffnen Sie zum Beispiel ein Kundenprofil oder eine Rechnung und gehen Sie zur Karte **Kommentare**.

<DocScreenshot src="/screenshots/notities/invoice-comments.png" alt="Kommentarkarte auf der Rechnungsdetailseite" />
</Step>
<Step>
### Klicken Sie auf Kommentar hinzufügen [#klik-op-reactie-toevoegen]
Tippen Sie Ihren Kommentar in das Textfeld **Kommentar schreiben...**.

- Tippen Sie **@** und wählen Sie einen Kollegen aus der Liste, um ihn zu erwähnen. Er erhält eine Benachrichtigung.
- Tippen Sie **/**, um einen Kunden, eine Rechnung, einen Zähler, eine Parzelle oder einen anderen Datensatz zu verlinken.
- Fügen Sie über **Datei anhängen** einen Anhang hinzu, durch Einfügen oder indem Sie Dateien hineinziehen.
</Step>
<Step>
### Klicken Sie auf Absenden [#klik-op-verzenden]
Ihr Kommentar steht nun auf der Karte. Mit **Antworten** bei einem bestehenden Kommentar starten Sie eine Diskussion.
</Step>
</Steps>

### Was passiert danach? [#wat-gebeurt-er-daarna]

- Der Kommentar steht im Datensatz und in der zentralen Übersicht.
- Ein erwähnter Kollege erhält eine Benachrichtigung.
- Wenn Sie sichergehen wollen, dass jemand reagiert, klicken Sie auf die Uhr beim Kommentar (**Erinnerung zur Nachverfolgung setzen**). Tillor legt dann eine Aufgabe an, damit Sie später prüfen können, ob er aufgegriffen wurde.

## Kommentare verwalten [#opmerkingen-beheren]

Bei jedem Kommentar stehen oben rechts Aktionsschaltflächen, soweit Sie die Berechtigungen haben.

### Kommentar bearbeiten oder löschen [#opmerking-bewerken-of-verwijderen]

- **Bearbeiten**: Passen Sie den Text an. Das geht bei Ihren eigenen Kommentaren, nicht bei gelösten Kommentaren.
- **Löschen**: Löschen Sie den Kommentar, nach Bestätigung. Das kann nicht rückgängig gemacht werden.

### Kommentar anheften [#opmerking-vastzetten]

Möchten Sie einen wichtigen Kommentar oben sichtbar halten?

1. Klicken Sie auf das Pin-Symbol (**Anheften**).
2. Der Kommentar erhält das Label **Angeheftet** und steht oben in der Liste.
3. Klicken Sie erneut auf das Pin-Symbol, um ihn zu lösen (**Lösen**).

Gelöste Kommentare können nicht angeheftet werden.

#### Wo steht ein angehefteter Kommentar [#waar-staat-een-vastgezette-opmerking]

- Im Kundenprofil steht er direkt unter den Kundendaten ganz oben, über den Registerkarten.
- Bei einer Rechnung, Reservierung, Parzelle oder einem Zähler steht er in der Karte **Auf einen Blick** oben, zusammen mit den offenen Aufgaben. Diese Karte klappt zu, wenn nichts darin steht.

### Kommentar als gelöst markieren [#opmerking-als-opgelost-markeren]

Bei Diskussionen, die abgeschlossen sind:

1. Klicken Sie auf den Haken (**Lösen**).
2. Der Kommentar wird als **Gelöst** markiert und verschwindet aus der offenen Liste.
3. Auf einer Detailseite stehen gelöste Kommentare unten in einem einklappbaren Bereich.
4. Klicken Sie erneut auf den Haken, um das rückgängig zu machen (**Wieder öffnen**).

### Kommentare als PDF herunterladen [#opmerkingen-als-pdf-downloaden]

Mit dem Drucksymbol laden Sie alle Kommentare eines Datensatzes als PDF herunter (**Alle Kommentare als PDF herunterladen**) oder eine Diskussion (**Diesen Kommentar-Thread als PDF herunterladen**).

## Übersicht aller Kommentare [#overzicht-van-alle-opmerkingen]

Gehen Sie zu <UIPath>Kommunikation > Kommentare</UIPath> für eine zentrale Übersicht. Oben sehen Sie Statistiken (gesamt, offen, gelöst und angeheftet). Darunter:

<DocScreenshot src="/screenshots/notities/comments-overview.png" alt="Zentrale Kommentarübersicht - Offene Kommentare" />

- **Offene Kommentare**: Kommentare, die noch offen sind.
- **Gelöste Kommentare**: abgeschlossene Kommentare zur Referenz.

Jeder Kommentar zeigt die **Herkunft** (zum Beispiel Kunde oder Rechnung), sodass Sie direkt zum Datensatz gelangen.

### Filtern [#filteren]

- **Letzte Woche**, **Letzter Monat** oder **Alle**: nach Erstellungsdatum filtern.
- **Nur Erwähnungen anzeigen**: nur Kommentare, in denen Sie erwähnt sind.
- Suchen Sie mit **Kommentare durchsuchen...**, oder filtern Sie nach Autor, Erwähnt, Erledigt, Angeheftet und Hauptkommentar oder Antwort.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor sagt: Kommentar konnte nicht erstellt werden">
Ihr Kommentar wurde nicht gespeichert. Prüfen Sie, dass das Textfeld nicht leer ist, und versuchen Sie **Absenden** erneut.
</Accordion>
<Accordion title="Ich sehe beim Tippen von @ keinen Kollegen">
Steht dort **Keine Benutzer gefunden**, versuchen Sie einen anderen Namen oder eine E-Mail-Adresse. Nur Benutzer Ihrer Organisation erscheinen in der Liste.
</Accordion>
<Accordion title="Ich kann einen Kommentar nicht bearbeiten oder anheften">
Ein gelöster Kommentar ist gesperrt. Klicken Sie zuerst auf den Haken, um ihn wieder zu öffnen (**Wieder öffnen**). Bearbeiten ist nur bei Ihren eigenen Kommentaren möglich.
</Accordion>
<Accordion title="Der angeheftete Kommentar ist verschwunden">
Das Lösen eines Kommentars löst auch die Anheftung. Öffnen Sie ihn mit dem Haken wieder und heften Sie ihn danach erneut an.
</Accordion>
<Accordion title="Tillor sagt: Kommentar konnte nicht angeheftet/gelöst werden oder Kommentar konnte nicht gelöst/geöffnet werden">
Die Änderung wurde nicht übernommen. Laden Sie die Seite neu und versuchen Sie es erneut.
</Accordion>
<Accordion title="Tillor sagt: PDF konnte nicht erstellt werden">
Versuchen Sie es erneut. Erscheint das PDF nicht, blockiert Ihr Browser ein Pop-up. Erlauben Sie Pop-ups für diese Seite.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Kommentar**: ein interner Text in einem Datensatz, gegebenenfalls mit Anhängen. Siehe [Kommentar](/begrippen#opmerking).
- **Erwähnung**: ein Kollege, den Sie mit @ nennen. Er erhält eine Benachrichtigung.
- **Anheften**: einen Kommentar oben im Datensatz halten.
- **Gelöst**: ein abgeschlossener Kommentar, der aus der offenen Liste verschwindet.
- **Herkunft**: der Datensatz, zu dem ein Kommentar gehört.
- **Aufgabe**: eine To-do, die aus einer Erinnerung bei einem Kommentar entstehen kann. Siehe [Aufgabe](/begrippen#taak).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Kundenverwaltung" href="/klantenbeheer" description="Kundenprofile verwalten" />
  <Card title="Rechnungen" href="/facturen" description="Rechnungen verwalten" />
</Cards>


# Park (/de-DE/park)

Unter **Park** steht alles, was zum physischen Ort gehört: die Karte mit der heutigen Belegung, die Liste der Parzellen, die Zähler und Zählerschränke und das Wetter. Beginnen Sie bei den [Parzellen](/terreinen), denn eine Belegung, ein Zähler und ein Tarif hängen alle daran.

## Was finden Sie wo? [#wat-vind-je-waar]

| Menü | Wofür | Erläuterung |
|---|---|---|
| <UIPath>Park > Karte</UIPath> | Die Karte Ihres Parks, pro Tag nach Belegung eingefärbt | [Karte](/kaart) |
| <UIPath>Park > Parzellen</UIPath> | Alle Parzellen, ihr Tarif und die Zähler darauf | [Parzellen](/terreinen) |
| <UIPath>Park > Zähler</UIPath> | Alle Wasser-, Gas- und Stromzähler | [Zählerverwaltung](/meterbeheer) |
| <UIPath>Park > Zählerschränke</UIPath> | Die Schränke, in denen Zähler hängen, und welche Zähler darin sind | Verwalten Sie Ihre Zählerschränke und ihre zugewiesenen Zähler |
| <UIPath>Park > Wetter</UIPath> | Das Wetter pro Tag am Standort Ihres Parks | [Wetter](/weer) |

<DocScreenshot src="/screenshots/park/map-overview.png" alt="Karte des Parks mit eingefärbten Parzellen" />

## Zählerschränke [#meterkasten]

Unter <UIPath>Park > Zählerschränke</UIPath> verwalten Sie die Zählerschränke und die Zähler, die ihnen zugewiesen sind. Mit **Neuer Zählerschrank** fügen Sie einen Schrank hinzu, mit Name und Beschreibung.

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Die **Parzelle** ist der Ankerpunkt. An eine Parzelle hängen Sie die Zähler. Ein Kunde kommt durch eine **Belegung** auf eine Parzelle, ein Gast für einen kurzen Aufenthalt durch eine **Reservierung**. Der Verbrauch der Zähler auf der Parzelle geht an den Kunden mit der aktiven Belegung.

```mermaid
flowchart LR
  M[Meters] --> T[Terrein]
  T --> K[Plattegrond]
  B[Bezetting<br/>klant voor langere tijd] --> T
  R[Reservering<br/>verblijf met in- en uitcheckdatum] --> T
  T --> V[Tarief en verbruik op de factuur]
```

Eine Parzelle bekommt erst eine Farbe auf der Karte, wenn Sie ihre Grenze eingezeichnet haben. Siehe [Parzellengrenzen einzeichnen](/kaart#terreingrenzen-intekenen).

<Callout type="info" title="Gut zu wissen">
- Eine Parzelle hat höchstens eine aktive Belegung gleichzeitig.
- Eine neue Parzelle ist standardmäßig nicht buchbar. Setzen Sie bei **Buchbar** ein Häkchen, wenn Kunden sie online reservieren dürfen.
- Die Fläche können Sie nicht eintippen. Tillor berechnet sie, sobald Sie die Parzelle auf der Karte einzeichnen, und nutzt sie für den Tarif.
- Die Karte öffnet immer auf heute. Ihre anderen Karteneinstellungen (Stil, Labels, Ebenen) bleiben gespeichert.
- Die Labels mit Nächten und Abreise erscheinen erst ab Zoomstufe 17,5.
- Das Wetter wird jede Nacht für das Kartenzentrum Ihrer Organisation abgerufen.
</Callout>

## Begriffe [#begrippen]

- **Parzelle**: ein Platz in Ihrem Park mit Name, Tarif und gegebenenfalls Zählern. Siehe [Begriffe](/begrippen#terrein).
- **Karte**: die interaktive Karte unter Park.
- **Zählerschrank**: ein Schrank mit Zählern. Siehe [Begriffe](/begrippen#meterkast).
- **Belegung**: ein Kunde auf einer Parzelle für einen Zeitraum. Siehe [Begriffe](/begrippen#bezetting).
- **Buchbar**: eine Parzelle, die Kunden online reservieren dürfen.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Parzellen" href="/terreinen" description="Parzellen anlegen, Tarif und Zähler" />
  <Card title="Karte" href="/kaart" description="Karte, Ebenen und Parzellengrenzen" />
  <Card title="Zählerverwaltung" href="/meterbeheer" />
  <Card title="Wetter" href="/weer" />
</Cards>


# Druckeinstellungen (/de-DE/printer/afdrukinstellingen)

Dies ist die Liste aller Einstellungen unter <UIPath>Einstellungen > Druck</UIPath>. Die Einstellungen gelten für Ihre gesamte Organisation. Die Einrichtung Schritt für Schritt steht unter [Drucker einrichten](/printer/printers-instellen).

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Einstellungen > Druck" />

| Einstellung | Bedeutung |
| ---------- | --------- |
| **PDF-Druck** | Schaltet das Drucken von Rechnungen und Dokumenten auf physischen Druckern ein. Ohne diese Einstellung druckt Tillor nichts. |
| **Rechnung bei Zahlung automatisch drucken** | Bezahlte Rechnungen gehen automatisch in die Druckwarteschlange. Pro Zahlungsart wählen Sie, ob das sofort geschieht, zum nächsten Zeitpunkt oder gar nicht. |
| **Ausweisdokument beim Verknüpfen automatisch drucken** | Verknüpfen Sie einen Ausweisscan mit einem Kunden oder Kontakt (auch beim Anlegen eines Kunden aus einem Scan), geht die Zusammenfassung als PDF an den A4-Drucker. Voraussetzung: **PDF-Druck** ist eingeschaltet und **PDF-Drucker IP** ist ausgefüllt. |
| **PDF-Drucker IP** | Netzwerkadresse des A4-Druckers für Rechnungen und Dokumente, zum Beispiel `192.168.1.100`. |
| **Thermodrucker IP** | Netzwerkadresse des Belegdruckers, zum Beispiel `192.168.1.101`. |
| **Papierbreite Thermodrucker** | Breite der Bonrolle: **80 mm** (Standard) oder **58 mm**. Tillor passt Zeilenlänge und Logo des Belegs daran an. |
| **Etikettendrucker IP** | Netzwerkadresse des Etikettendruckers, zum Beispiel `192.168.1.102`. |
| **Druckzeitplan** | Pro Wochentag ein oder mehrere Zeitpunkte auf die Minute genau, zum Beispiel 09:00 und 13:30. Leer bedeutet, dass es an diesem Tag keine Druckzeitpunkte gibt. |
| **Druckzeitpunkt pro Zahlungsart** | Pro Kanal (Terminal/Theke, manuell, online, Mandat, Überweisung): **Sofort drucken**, **Nächster Zeitpunkt** oder **Nicht automatisch drucken**. Standardmäßig drucken Terminal und manuell sofort. Online, Mandat und Überweisung warten auf den nächsten Zeitpunkt. |
| **Druck pausieren bis** | Hält die Druckwarteschlange bis zum gewählten Zeitpunkt an. **Pause löschen** entfernt die Pause. Sie können auch aus der [Druckwarteschlange](/printer/printwachtrij) pausieren. |

Klicken Sie unten auf **Einstellungen speichern**, um Ihre Änderungen zu übernehmen. Sie gelten sofort.

<Callout type="info">
Drucker müssen im selben Netzwerk stehen wie der Connector und eine feste IP-Adresse haben. Weisen Sie dem Drucker in Ihrem Router eine feste Adresse zu, sonst kann sich die Adresse ändern.
</Callout>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Drucker einrichten" href="/printer/printers-instellen" description="Die Schritte für den Anfang" />
  <Card title="Dokumente drucken" href="/printer/documenten-afdrukken" description="Eine Rechnung oder einen Beleg drucken" />
  <Card title="Connector" href="/connector" description="Das Programm, das den Drucker ansteuert" />
</Cards>


# Eine Rechnung oder einen Beleg drucken (/de-DE/printer/documenten-afdrukken)

Sie drucken eine Rechnung von der Rechnungsseite aus, auf dem A4-Drucker oder auf dem Belegdrucker. Bei Zahlungen kann Tillor Belege auch selbst drucken. Sie können eine Rechnung auch auf dem Tablet anzeigen, ohne zu drucken.

<Requires permission="Einstellungen bearbeiten" />

Bevor Sie beginnen:

- Die Drucker sind eingerichtet, siehe [Drucker einrichten](/printer/printers-instellen).
- Für Ihre Organisation ist ein Connector aktiv. Ohne ihn stehen die Optionen **An A4-Drucker senden** und **An Belegdrucker senden** nicht im Menü.

## Eine Rechnung drucken [#een-factuur-afdrukken]

<Steps>
<Step>
### Öffnen Sie die Rechnung [#open-de-factuur]
Gehen Sie zu <UIPath>Verwaltung > Rechnungen</UIPath> und öffnen Sie die Rechnung.
</Step>
<Step>
### Wählen Sie, wie Sie drucken [#kies-hoe-je-afdrukt]
<Tabs items={["Auf Papier über den Browser", "An einen Drucker im Netzwerk"]}>
<Tab value="Auf Papier über den Browser">
Klicken Sie auf **Drucken**. Ihr Browser öffnet sein eigenes Druckfenster.
</Tab>
<Tab value="An einen Drucker im Netzwerk">
Klicken Sie auf den Pfeil neben **Drucken** und wählen Sie **An A4-Drucker senden** oder **An Belegdrucker senden**. Tillor legt einen Auftrag in der Druckwarteschlange ab.
</Tab>
</Tabs>

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Rechnungsdetail - Druck- und Zahlungsaktionen" />
</Step>
</Steps>

## Belege nach einer Zahlung [#bonnen-na-een-betaling]

Schalten Sie unter <UIPath>Einstellungen > Druck</UIPath> **Rechnung bei Zahlung automatisch drucken** ein. Bezahlte Rechnungen gehen dann an den A4-Drucker und gegebenenfalls den Belegdrucker, sofort oder zum nächsten Zeitpunkt, abhängig vom Zahlungskanal.

Pro Produkt können Sie außerdem **Thermodruck** und **A4-Druck** einschalten und die Anzahl der Kopien auf der Produktseite festlegen. Diese Kopien kommen zusätzlich heraus, sobald das Produkt auf einer bezahlten Rechnung steht.

## Eine Rechnung auf dem Tablet anzeigen [#een-factuur-op-de-tablet-tonen]

Möchten Sie eine Rechnung zeigen, ohne zu drucken? Wählen Sie im Menü mit den drei Punkten bei der Rechnung **Vorschau auf iPad**, oder klicken Sie im Zahlungsfenster einer Barzahlung auf **Vorschau auf iPad**. Das PDF erscheint auf dem verbundenen Tablet und Tillor meldet **PDF an iPad gesendet**. Siehe [Tablets und Kioske](/mobiele-app/tablets-en-kiosken).

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein Auftrag an einen Drucker steht mit einem Status in der [Druckwarteschlange](/printer/printwachtrij). Zum Druckzeitpunkt geht er an den Drucker.
- Schlägt das Drucken fehl, versucht Tillor es in den meisten Fällen automatisch erneut. Danach steht der Auftrag auf **Fehlgeschlagen**, bis Sie ihn erneut versuchen oder stornieren.
- Die Rechnung selbst ändert sich nicht: Drucken bucht oder versendet nichts.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe An A4-Drucker senden nicht">
Für Ihre Organisation ist kein aktiver Connector vorhanden, oder **PDF-Druck** ist ausgeschaltet. Siehe [Drucker einrichten](/printer/printers-instellen).
</Accordion>
<Accordion title="Tillor sagt Druck fehlgeschlagen">
Die Meldung lautet **Das Dokument konnte nicht an den Drucker gesendet werden.** Öffnen Sie die [Druckwarteschlange](/printer/printwachtrij) für den Grund unter **Letzter Fehler**, zum Beispiel ein Drucker, der offline ist oder kein Papier hat.
</Accordion>
<Accordion title="Tillor sagt Download fehlgeschlagen">
Das PDF konnte nicht heruntergeladen werden. Versuchen Sie es erneut.
</Accordion>
<Accordion title="Tillor sagt PDF nicht gesendet">
Das PDF konnte nicht an das Tablet gesendet werden. Dann ist kein Tablet erreichbar. Öffnen Sie die Tillor-App auf dem Tablet und prüfen Sie unter <UIPath>Einstellungen > Tablets & Kioske</UIPath>, ob es **Verbunden** ist.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Die Druckwarteschlange verwalten" href="/printer/printwachtrij" description="Aufträge verfolgen und erneut versuchen" />
  <Card title="Rechnungen" href="/facturen" description="Rechnungen verwalten und versenden" />
  <Card title="Produkte" href="/producten" description="Kopien pro Produkt einstellen" />
</Cards>


# Übersicht (/de-DE/printer)

Mit der Druckeranbindung drucken Sie Rechnungen, Belege und Etiketten direkt aus Tillor auf einem Drucker in Ihrem Park, ohne das Dokument vorher herunterzuladen. Sie richten die Drucker einmal unter [Drucker einrichten](/printer/printers-instellen) ein und drucken danach mit einem Klick oder lassen Tillor es bei einer Zahlung erledigen.

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Tillor schickt einen Druckauftrag nicht direkt an Ihren Drucker. Der Auftrag kommt zuerst in die Druckwarteschlange. Zum Druckzeitpunkt gibt Tillor ihn an den Connector weiter, ein kleines Programm auf einem Computer in Ihrem Netzwerk, und der lässt den Drucker drucken.

```mermaid
flowchart LR
  A[Je print een factuur of<br/>een betaling komt binnen] --> B[Printwachtrij in Tillor]
  B -- meteen of op het afdrukmoment --> C[Connector in je netwerk]
  C --> D[Printer]
  B -- mislukt --> E[Tillor probeert opnieuw]
```

Darum muss der Connector online und der Drucker im selben Netzwerk erreichbar sein. Ohne aktiven Connector sehen Sie die Optionen zum Senden an einen Drucker nicht. Siehe [Connector](/connector).

<Callout type="info" title="Gut zu wissen">
- Es gibt drei Arten von Druckern: einen A4-Drucker für Rechnungen und Dokumente, einen Thermodrucker für Kassenbelege und einen Etikettendrucker.
- Die Breite der Bonrolle beträgt 80 mm (Standard) oder 58 mm.
- Einen fehlgeschlagenen Auftrag versucht Tillor automatisch erneut nach 10 Sekunden, 5 Minuten und 15 Minuten. Danach steht er auf **Fehlgeschlagen**. Ist das Papier leer oder der Drucker offline, steht er sofort auf **Fehlgeschlagen**.
- Jeden Montagmorgen versucht Tillor alle Aufträge, die auf **Fehlgeschlagen** stehen, noch einmal.
- Das Drucken lässt sich für 15 Minuten, 1 Stunde, 4 Stunden, 6 Stunden, 1 Tag oder bis Sie es selbst fortsetzen pausieren.
- Standardmäßig drucken Terminalzahlungen und manuelle Zahlungen sofort. Onlinezahlungen, Mandate und Überweisungen warten auf den nächsten Druckzeitpunkt.
</Callout>

## Was möchten Sie tun? [#wat-wil-je-doen]

<Cards>
  <Card title="Drucker einrichten" href="/printer/printers-instellen" description="Netzwerkadressen eintragen und Druckzeitpunkte wählen" />
  <Card title="Dokumente drucken" href="/printer/documenten-afdrukken" description="Eine Rechnung drucken oder Belege nach Zahlung" />
  <Card title="Die Druckwarteschlange verwalten" href="/printer/printwachtrij" description="Aufträge pausieren, erneut versuchen oder stornieren" />
  <Card title="Druckeinstellungen" href="/printer/afdrukinstellingen" description="Alle Einstellungen im Überblick" />
</Cards>

## Begriffe [#begrippen]

- **Druckwarteschlange**: die Liste der Druckaufträge, die Tillor noch senden muss.
- **Druckzeitpunkt**: ein fester Zeitpunkt an einem Wochentag, zu dem Tillor gebündelte Aufträge sendet, auch Stichzeit genannt.
- **Thermodrucker**: der Drucker für Kassenbelege.
- **Connector**: das Programm in Ihrem Netzwerk, das den Drucker ansteuert. Siehe [Connector](/connector).
- **IP-Adresse**: die Netzwerkadresse eines Druckers, zum Beispiel `192.168.1.100`.

Mehr Erläuterungen finden Sie im [Glossar](/begrippen).


# Drucker einrichten (/de-DE/printer/printers-instellen)

Damit Tillor drucken kann, muss es wissen, welche Drucker Sie haben und wo sie in Ihrem Netzwerk stehen. Das stellen Sie einmalig für Ihre gesamte Organisation ein. Danach können Sie [Dokumente drucken](/printer/documenten-afdrukken). Jede Einstellung mit Erläuterung steht unter [Druckeinstellungen](/printer/afdrukinstellingen).

<Requires permission="Einstellungen bearbeiten" />

Bevor Sie beginnen:

- Der Connector läuft auf einem Computer im selben Netzwerk wie die Drucker. Siehe [Connector](/connector). Ist er nicht aktiv, sehen Sie später keine Optionen zum Senden an einen Drucker.
- Sie kennen die IP-Adresse jedes Druckers, das ist die Netzwerkadresse, zum Beispiel `192.168.1.100`. Weisen Sie dem Drucker in Ihrem Router eine feste Adresse zu, sonst kann sich die Adresse ändern und das Drucken stoppt.

## Einen Drucker hinzufügen [#een-printer-toevoegen]

<Steps>
<Step>
### Öffnen Sie Druck [#open-afdrukken]
Gehen Sie zu <UIPath>Einstellungen > Druck</UIPath>.

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Einstellungen > Druck" />
</Step>
<Step>
### Schalten Sie PDF-Druck ein [#zet-pdf-afdrukken-aan]
Ohne diesen Schalter druckt Tillor nichts.
</Step>
<Step>
### Tragen Sie die Druckeradressen ein [#vul-de-printeradressen-in]
Tragen Sie unter **Drucker-IP-Adressen** die Adresse für **PDF-Drucker IP** (A4), **Thermodrucker IP** (Belege) und **Etikettendrucker IP** ein. Lassen Sie leer, was Sie nicht haben. Wählen Sie bei **Papierbreite Thermodrucker** 80 mm oder 58 mm, passend zu Ihrer Bonrolle.
</Step>
<Step>
### Wählen Sie, wann gedruckt wird [#kies-wanneer-er-afgedrukt-wordt]
Legen Sie bei **Druckzeitplan** pro Wochentag einen oder mehrere Zeitpunkte fest (zum Beispiel 09:00 und 13:30). Wählen Sie bei **Druckzeitpunkt pro Zahlungsart** für jeden Zahlungskanal: **Sofort drucken**, **Nächster Zeitpunkt** oder **Nicht automatisch drucken**.
</Step>
<Step>
### Klicken Sie auf Einstellungen speichern [#klik-op-instellingen-opslaan]
Die Einstellungen gelten sofort für Ihre gesamte Organisation.
</Step>
</Steps>

## Automatisch drucken bei Zahlung [#automatisch-afdrukken-bij-betaling]

Möchten Sie, dass eine bezahlte Rechnung ohne Zutun auf Papier kommt, schalten Sie **Rechnung bei Zahlung automatisch drucken** ein. Pro Zahlungskanal legen Sie mit dem Druckzeitpunkt oben fest, ob das sofort geschieht oder zum nächsten Zeitpunkt.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Bei jedem Druck legt Tillor einen Auftrag in der [Druckwarteschlange](/printer/printwachtrij) ab, den der Connector an den Drucker weitergibt.
- Bezahlte Rechnungen gehen automatisch an den A4-Drucker und gegebenenfalls den Belegdrucker, wenn Sie das eingeschaltet haben.
- Wählen Sie bei einem Kanal einen Zeitpunkt, bündelt Tillor die Aufträge bis dahin. Steht für diesen Tag kein Druckzeitpunkt, gibt es keinen Stichzeitpunkt.
- Probieren Sie es mit einer Rechnung aus, siehe [Dokumente drucken](/printer/documenten-afdrukken).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe bei einer Rechnung kein An A4-Drucker senden">
Die Optionen erscheinen nur, wenn **PDF-Druck** eingeschaltet ist und für Ihre Organisation ein Connector aktiv ist. Prüfen Sie beides.
</Accordion>
<Accordion title="Tillor sagt Der Drucker ist offline oder antwortet nicht">
Der Drucker ist aus, hat keine Netzwerkverbindung oder die IP-Adresse stimmt nicht mehr. Prüfen Sie die Adresse unter <UIPath>Einstellungen > Druck</UIPath> und ob der Connector online ist.
</Accordion>
<Accordion title="Tillor sagt Papier, Toner oder Tinte ist leer">
Füllen Sie den Drucker nach und versuchen Sie den Auftrag erneut aus der Druckwarteschlange.
</Accordion>
<Accordion title="Tillor sagt Der Drucker hat nicht rechtzeitig geantwortet">
Der Connector hat keine Antwort vom Drucker erhalten. Prüfen Sie, ob der Connector läuft und der Drucker erreichbar ist. Sehen Sie in der Druckwarteschlange nach, ob der Auftrag erneut versucht wurde.
</Accordion>
<Accordion title="Die Belege kommen nicht sofort">
Prüfen Sie bei **Druckzeitpunkt pro Zahlungsart**, ob dieser Kanal auf **Nächster Zeitpunkt** steht. Dann wartet der Beleg bis zu dem Zeitpunkt, den Sie bei **Druckzeitplan** gewählt haben. Haben Sie das Drucken pausiert, sehen Sie in der [Druckwarteschlange](/printer/printwachtrij) nach.
</Accordion>
<Accordion title="Der Beleg passt nicht aufs Papier">
Prüfen Sie die **Papierbreite Thermodrucker**: 80 mm oder 58 mm.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Druckeinstellungen" href="/printer/afdrukinstellingen" description="Alle Einstellungen im Überblick" />
  <Card title="Connector" href="/connector" description="Das Programm, das den Drucker ansteuert" />
  <Card title="Die Druckwarteschlange verwalten" href="/printer/printwachtrij" description="Aufträge pausieren oder erneut versuchen" />
</Cards>


# Die Druckwarteschlange verwalten (/de-DE/printer/printwachtrij)

In der Druckwarteschlange sehen Sie, welche Druckaufträge warten, laufen oder fehlgeschlagen sind. Hier pausieren Sie das Drucken, setzen Aufträge fort und beheben Aufträge, die nicht geklappt haben. Die Liste aktualisiert sich von selbst, sobald ein Auftrag den Status wechselt.

<Requires permission="Einstellungen bearbeiten" />

Bevor Sie beginnen: Die Drucker sind eingerichtet, siehe [Drucker einrichten](/printer/printers-instellen).

## Die Warteschlange ansehen [#de-wachtrij-bekijken]

Gehen Sie zu <UIPath>Verwaltung > Druckwarteschlange</UIPath>. Die Listen sind:

- **Ausstehend, geplant und in Bearbeitung**: Aufträge, die noch verarbeitet werden. Ein Auftrag mit dem Status **Später geplant** wartet auf seinen **Geplant**-Zeitpunkt und wird dann von selbst gedruckt, es sei denn, das Drucken ist pausiert.
- **Fehlgeschlagen**: Aufträge, die endgültig fehlgeschlagen sind, mit dem Grund unter **Letzter Fehler**.
- **Alle Druckaufträge**.

## Das Drucken pausieren [#het-afdrukken-pauzeren]

<Steps>
<Step>
### Wählen Sie Drucken pausieren [#kies-afdrukken-pauzeren]
Klicken Sie auf **Drucken pausieren** und wählen Sie eine Dauer: 15 Minuten, 1 Stunde, 4 Stunden, 6 Stunden, 1 Tag oder **Bis wir wieder aktivieren**.

<DocScreenshot src="/screenshots/printer/print-pause-menu.png" alt="Menü mit der Dauer der Pause" />
</Step>
<Step>
### Setzen Sie fort, wenn Sie so weit sind [#hervat-wanneer-je-klaar-bent]
Klicken Sie auf **Drucken fortsetzen**. Sonst wird nach der gewählten Dauer von selbst fortgesetzt.
</Step>
</Steps>

Während der Pause warten sowohl direkte als auch geplante Aufträge. Neue Aufträge bleiben in der Warteschlange stehen. Beim Pausensymbol steht, bis wann sie dauert. Sie können die Pause auch bei **Druck pausieren bis** unter <UIPath>Einstellungen > Druck</UIPath> festlegen.

## Aufträge fortsetzen oder wiederherstellen [#opdrachten-doorzetten-of-herstellen]

<Tabs items={["Aufträge bleiben hängen", "Ein Auftrag ist fehlgeschlagen"]}>
<Tab value="Aufträge bleiben hängen">
Klicken Sie in der Symbolleiste der Liste auf **Warteschlange starten**. Geplante Aufträge werden dann sofort verarbeitet. Die Schaltfläche ist grau, solange das Drucken pausiert ist, mit dem Hinweis **Setzen Sie den Druck fort, um die Warteschlange zu verarbeiten**.
</Tab>
<Tab value="Ein Auftrag ist fehlgeschlagen">
Öffnen Sie das Menü mit den drei Punkten in der Zeile und wählen Sie **Erneut versuchen**, um ihn noch einmal zu senden, oder **Stornieren**. Ein stornierter Auftrag erhält den Status **Storniert** und wird nicht mehr gedruckt.
</Tab>
</Tabs>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Einen fehlgeschlagenen Auftrag versucht Tillor selbst erneut nach 10 Sekunden, danach nach 5 Minuten und danach nach 15 Minuten. Klappt es dann noch nicht, steht er auf **Fehlgeschlagen**.
- Fehler, die ein neuer Versuch nicht löst, versucht Tillor nicht erneut: Papier, Toner oder Tinte leer, ein Drucker, der offline oder pausiert ist, oder eine deaktivierte Druckerwarteschlange. Diese stehen sofort auf **Fehlgeschlagen**.
- Jeden Montagmorgen stellt Tillor alle Aufträge, die auf **Fehlgeschlagen** stehen, noch einmal bereit.
- Ein Auftrag, der auf **Fehlgeschlagen** stehen bleibt, tut nichts, bis Sie ihn erneut versuchen oder stornieren.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Auftrag steht auf Fehlgeschlagen mit Der Drucker ist offline oder antwortet nicht">
Schalten Sie den Drucker ein, prüfen Sie die Netzwerkverbindung und ob der Connector online ist. Wählen Sie danach **Erneut versuchen**.
</Accordion>
<Accordion title="Der Auftrag meldet Papier, Toner oder Tinte ist leer">
Füllen Sie den Drucker nach und wählen Sie **Erneut versuchen**.
</Accordion>
<Accordion title="Der Auftrag meldet Drucken ist pausiert. Papier, Toner oder Tinte prüfen.">
Der Drucker selbst ist pausiert, zum Beispiel durch einen Papierstau. Beheben Sie das am Drucker und versuchen Sie es erneut.
</Accordion>
<Accordion title="Der Auftrag meldet Der Druckauftrag ging verloren oder wurde auf dem Drucker nicht abgeschlossen">
Der Auftrag wurde an den Drucker gesendet, aber nicht abgeschlossen. Prüfen Sie, ob schon etwas herausgekommen ist, bevor Sie es erneut versuchen, sonst kommt es doppelt heraus.
</Accordion>
<Accordion title="Der Auftrag meldet Die Druckerwarteschlange ist deaktiviert">
Die Warteschlange am Drucker selbst ist aus. Schalten Sie sie am Drucker ein und versuchen Sie es erneut.
</Accordion>
<Accordion title="Warteschlange starten ist grau">
Das Drucken ist pausiert. Wählen Sie **Drucken fortsetzen**.
</Accordion>
<Accordion title="Tillor sagt Druckwarteschlange konnte nicht gestartet werden">
Die Warteschlange konnte nicht fortgesetzt werden. Versuchen Sie es noch einmal. Klappt es dann nicht, prüfen Sie, ob der Connector online ist.
</Accordion>
<Accordion title="Tillor sagt Druckauftrag konnte nicht erneut versucht werden">
Versuchen Sie es erneut, oder stornieren Sie den Auftrag und drucken Sie das Dokument noch einmal von der Rechnung aus.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Drucker einrichten" href="/printer/printers-instellen" description="Netzwerkadressen und Druckzeitpunkte" />
  <Card title="Eine Rechnung oder einen Beleg drucken" href="/printer/documenten-afdrukken" description="Aufträge erstellen" />
</Cards>


# Aktionen mit einem Produkt verknüpfen (/de-DE/producten/acties-instellen)

Mit Aktionen automatisieren Sie, was nach dem Buchen oder Bezahlen einer Rechnung passiert: ein NFC-Tag aufladen, eine Belegung verlängern, einen Beleg drucken oder eine Zugangsmethode erstellen. Ein Produkt kann mehrere Aktionen gleichzeitig haben.

<Requires permission="Produkte bearbeiten" />

Bevor Sie beginnen: Das Produkt existiert bereits. Siehe [Ein Produkt anlegen](/producten/product-aanmaken). Ein Schema, was Tillor wann tut, steht unter [Wie hängt das zusammen?](/producten#hoe-hangt-dit-samen).

<Steps>
<Step>
### Öffnen Sie das Produkt [#open-het-product]

Gehen Sie zu <UIPath>Verwaltung > Produkte</UIPath> und öffnen Sie das Produkt.
</Step>
<Step>
### Haken Sie die Aktionen an [#vink-de-acties-aan]

Suchen Sie rechts die Karte **Aktionen auf Rechnungsposition**. Haken Sie die gewünschten Aktionen an. Bei manchen Aktionen erscheinen danach zusätzliche Felder. Was jede Aktion tut und welche Felder dazugehören, lesen Sie unter [Produktaktionen](/producten/productacties).

Lassen Sie alle Kästchen leer für einen normalen Tarif ohne Folgeaktion.
</Step>
<Step>
### Speichern Sie [#sla-op]

Klicken Sie unten in der Karte **Zusätzliche Rechnungspositionen** auf **Speichern**. Die Aktionen stehen nun am Produkt und werden bei neuen Rechnungspositionen übernommen.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

Wenn Sie das Produkt in einer Rechnungsposition wählen, übernimmt Tillor die Aktionen mit den eingestellten Werten in diese Position. Welche Aktion wann etwas tut, hängt vom Typ ab. Manche Aktionen laufen beim Buchen der Rechnung, die meisten bei der Zahlung.

| Zeitpunkt | Aktionen |
|--------|--------|
| Beim Buchen | **Belegung verlängern** (passt **Fakturiert bis** an), **Kontaktdaten abfragen** (Buchen geht erst, wenn die Pflichtfelder ausgefüllt sind), Reservierung anlegen bei **Periode** mit **Stellplatz abfragen** |
| Beim Bezahlen | **NFC-Tag aufladen**, **Periode**, **Belegung verlängern** (passt **Bezahlt bis** an), **Zugangsmethode verlängern**, **Zugangsmethode erstellen**, **Thermodruck** und **A4-Druck** |
| Keine Nebenwirkung | **Zählerverbrauch** (bestimmt den Tarif), **Hinweis anzeigen** (zeigt einen Text) |
| Blockiert das Buchen | **Buchung verhindern** |

In der Produktliste sehen Sie in der Spalte **Aktion**, welche Aktionen an einem Produkt hängen.

<Callout type="info">
Eine Änderung an den Aktionen eines Produkts gilt für Rechnungspositionen, die Sie danach hinzufügen.
</Callout>

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe das gesuchte Feld nicht">
Zusätzliche Felder erscheinen erst, nachdem Sie die zugehörige Aktion angehakt haben. **Beim Buchen einchecken** und **Beim Bezahlen einchecken** sehen Sie nur, wenn **Stellplatz abfragen** eingeschaltet ist.
</Accordion>
<Accordion title="Die Aktion geschieht nicht bei der Zahlung">
Prüfen Sie, ob die Aktion in der Rechnungsposition selbst ausgefüllt ist. Bei **Zugangsmethode erstellen** muss zum Beispiel ein Typ gewählt sein. Ohne Typ legt Tillor nichts an, und bei einer Position, die nicht optional ist, können Sie die Rechnung nicht buchen.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Produktaktionen" href="/producten/productacties" description="Alle Aktionen und ihre Einstellungen" />
  <Card title="Zusätzliche Rechnungspositionen einstellen" href="/producten/bundel-instellen" />
</Cards>


# Zusätzliche Rechnungspositionen einstellen (/de-DE/producten/bundel-instellen)

Manche Produkte sind mehr als eine Zeile auf einer Rechnung: Stellplatzgebühr mit Zuschlägen, eine Erläuterung, Zählermiete oder NFC-Tags. Dafür stellen Sie am Hauptprodukt ein Bundle zusätzlicher Zeilen ein. Wählt jemand dieses Produkt als Hauptzeile auf einer Rechnung im Entwurf, fügt Tillor die Unterzeilen unter dieser Hauptzeile ein, in der Reihenfolge, die Sie festlegen.

```mermaid
flowchart TD
  hoofd[Hoofdregel: product met bundel] --> stap1[Stap 1 in bundel]
  stap1 --> kind1[Kindregel op factuur]
  hoofd --> stap2[Stap 2 in bundel]
  stap2 --> kind2[Kindregel op factuur]
```

<Requires permission="Produkte bearbeiten" />

## Ein Bundle anlegen oder bearbeiten [#een-bundel-aanmaken-of-bewerken]

<Steps>
<Step>
### Öffnen Sie das Hauptprodukt [#open-het-hoofdproduct]

Gehen Sie zu <UIPath>Verwaltung > Produkte</UIPath> und öffnen Sie das Produkt, zum Beispiel Stellplatzgebühr.
</Step>
<Step>
### Starten Sie das Bundle [#start-de-bundel]

Suchen Sie die Karte **Zusätzliche Rechnungspositionen** unter **Allgemein**. Hat das Produkt noch kein Bundle, klicken Sie auf **Bundle konfigurieren**.
</Step>
<Step>
### Fügen Sie Schritte hinzu [#voeg-stappen-toe]

Klicken Sie auf **Produktschritt** für eine Zeile mit Produkt und Betrag, oder auf **Info-Schritt** für eine Zeile mit nur Text. Füllen Sie die Felder pro Schritt aus. Was jedes Feld tut, steht unter [Bundle-Schritte](/producten/bundel-velden).
</Step>
<Step>
### Bringen Sie die Schritte in die richtige Reihenfolge [#zet-de-stappen-in-de-juiste-volgorde]

Mit den Pfeilen **Schritt nach oben** und **Schritt nach unten** legen Sie die Reihenfolge auf der Rechnung fest. **Schritt entfernen** nimmt einen Schritt weg.
</Step>
<Step>
### Speichern Sie [#sla-op]

Klicken Sie unten in der Karte auf **Speichern**.
</Step>
</Steps>

<Callout type="info">
**Speichern** unter **Zusätzliche Rechnungspositionen** speichert die gesamte Produktseite, auch Änderungen unter **Allgemein** und **Aktionen auf Rechnungsposition**. Jeder Produktschritt muss ein Produkt haben und jeder Info-Schritt einen Text. Sonst speichert Tillor das Bundle nicht.
</Callout>

Mit **Gesamtes Bundle entfernen** schalten Sie das Bundle aus. Ein Bundle kann höchstens 40 Schritte haben.

## Beispiel: ein Stellplatzgebühr-Bundle [#voorbeeld-een-staangeld-bundel]

Ein typisches Bundle für die Stellplatzgebühr besteht aus fünf Schritten. Bei den Schritten mit Formel fügen Sie die Formel aus [Bundle-Schritte](/producten/bundel-velden#voorbeelden) in das Feld **Formel** ein.

<Steps>
<Step>
### Erläuterung [#toelichting]

Ein **Info-Schritt** mit dem Text "Inklusive Touristen-, Gemeinde- und Provinzsteuern".
</Step>
<Step>
### Erstes NFC inbegriffen [#eerste-nfc-inbegrepen]

Ein **Produktschritt** mit dem NFC-Zuschlagsprodukt und einer Formel, die das erste aktive NFC-Tag des Kunden mit Menge 0 und Preis 0 zurückgibt. Schalten Sie **Mit Hauptzeilenmenge multiplizieren** und **Einmal pro Rechnung** ein, wählen Sie bei **Zeilenstil** **INFO** und tragen Sie bei **Zusätzliche Tage nach Ende der Hauptzeile (Zugangsmethoden)** zum Beispiel `20` ein.
</Step>
<Step>
### Zusätzliche NFC-Tags [#extra-nfc-tags]

Derselbe Produktschritt mit einer Formel, die das zweite, dritte usw. aktive NFC-Tag zum Produkttarif zurückgibt, mit denselben Skalierungs- und Verlängerungsoptionen. Schalten Sie auch hier **Einmal pro Rechnung** ein.
</Step>
<Step>
### Zählermiete [#meterhuur]

Ein **Produktschritt** mit dem Zählermietprodukt und einer Formel, die aus `{meters}` die Zähler auswählt, die mitzählen, zum Beispiel nur ICY-Stromzähler mit eingeschaltetem Supply, und pro Zähler eine Zeile mit dem Zählernamen in der Beschreibung zurückgibt.
</Step>
<Step>
### Hunde [#honden]

Ein **Produktschritt** mit dem Hundeprodukt und einer Formel, die die Anzahl der Hunde aus einem eigenen Feld des Kunden liest und eine Zeile mit dieser Anzahl zurückgibt, oder keine Zeile ohne Hunde.
</Step>
</Steps>

## NFC über das Bundle verlängern [#nfc-verlengen-via-de-bundel]

Für die Stellplatzgebühr mit NFC-Tags gehören drei Dinge zusammen:

1. Am Hauptprodukt steht die Aktion **Belegung verlängern**, und in der Rechnungsposition ist ein Stellplatz gewählt.
2. Im Bundle steht mindestens ein Schritt mit ausgefülltem **Zusätzliche Tage nach Ende der Hauptzeile (Zugangsmethoden)**, zum Beispiel die NFC-Schritte aus dem Beispiel oben.
3. Am Hauptprodukt steht die Aktion **Zugangsmethode verlängern** mit den gewünschten Typen, Status und gegebenenfalls einem End-Wochentag und einer Uhrzeit.

Bei Zahlung einer Zeile eines solchen Schritts setzt Tillor die Gültigkeit der Zugangsmethoden des Kunden auf das Enddatum der Hauptzeile der Stellplatzgebühr plus die zusätzlichen Tage. Standardmäßig läuft sie bis 23:59 in der Zeitzone der Organisation, oder bis zu dem Wochentag und der Uhrzeit, die Sie bei **Zugangsmethode verlängern** eingestellt haben. Hat die Hauptzeile kein Enddatum, verlängert Tillor nichts.

<Callout type="warn" title="Achtung">
**Zusätzliche Tage nach Ende der Hauptzeile (Zugangsmethoden)** funktioniert nur, wenn das Produkt **Belegung verlängern** als Aktion hat. Steht unter dem Feld der Hinweis, dass dies nötig ist, haken Sie rechts bei **Aktionen auf Rechnungsposition** **Belegung verlängern** an.
</Callout>

## Was passiert auf einer Rechnung im Entwurf? [#wat-gebeurt-er-op-een-conceptfactuur]

- Unterzeilen erscheinen erst unter der Hauptzeile, nachdem Sie bei **Belegung verlängern** einen Stellplatz gewählt haben.
- Tillor baut die Unterzeilen neu auf, wenn Sie in der Hauptzeile das Produkt, die Menge oder den Stellplatz ändern. In anderen Fällen bleiben manuell angepasste Unterzeilen stehen. Entfernen Sie zum Beispiel eine Zählerzeile, kommt sie nicht von selbst zurück.
- Im Rechnungseditor sehen Sie eine Vorschau der Unterzeilen, einschließlich der Wirkung von **Einmal pro Rechnung**, sodass es mit dem übereinstimmt, was nach dem Speichern dasteht.
- Eine Hauptzeile verschieben Sie mit den Pfeilen nur als ganzen Block. Unterzeilen schieben Sie nur innerhalb ihres Bundles. Löschen Sie die Hauptzeile, verschwinden die Unterzeilen mit.
- Im PDF erhalten normale Unterzeilen oft ein **↳** vor der Beschreibung. Infozeilen stehen als graue Zeilen ohne Beträge.
- Schritte ohne gewähltes Produkt überspringt Tillor. Ein Produkt, das inzwischen gelöscht wurde oder fehlt, ergibt also keine Zeile.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die Unterzeilen erscheinen nicht unter der Hauptzeile">
Bei einem Hauptprodukt mit **Belegung verlängern** müssen Sie zuerst in der Hauptzeile einen Stellplatz wählen. Für die NFC-Verlängerung bei Zahlung braucht die Hauptzeile außerdem ein Enddatum.
</Accordion>
<Accordion title="Derselbe Zuschlag steht doppelt auf der Rechnung">
Stehen zwei oder mehr Hauptzeilen mit einem Bundle auf einer Rechnung, erhält jede Hauptzeile die Bundle-Zeilen. Schalten Sie **Einmal pro Rechnung** bei den Schritten ein, die nur einmal vorkommen dürfen. Der Schritt gehört dann nur zur ersten Hauptzeile in Rechnungsreihenfolge.
</Accordion>
<Accordion title="Das Bundle wird nicht gespeichert">
Prüfen Sie, ob jeder Produktschritt ein **Produkt** hat und jeder Info-Schritt einen **Text der Infozeile**.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Bundle-Schritte" href="/producten/bundel-velden" description="Felder, dynamische Schlüssel und Platzhalter" />
  <Card title="Bundle-JSON" href="/producten/bundel-json" />
  <Card title="Produktaktionen" href="/producten/productacties" />
</Cards>


# Bundle-JSON (/de-DE/producten/bundel-json)

Die Karte **Zusätzliche Rechnungspositionen** speichert ein Bundle als JSON am Produkt, unter dem Schlüssel `invoiceBundle`. Für Importe verwenden Sie dieselbe Struktur. Für den normalen Gebrauch brauchen Sie diese Seite nicht: Die Felder und ihre Erklärung finden Sie unter [Bundle-Schritte](/producten/bundel-velden).

## Struktur [#structuur]

| Feld | Bedeutung |
|------|-----------|
| `invoiceBundle.version` | Fest `1` |
| `invoiceBundle.steps` | Liste mit Schritten, höchstens 40. Die Reihenfolge ist die Reihenfolge der Unterpositionen auf der Rechnung |

Jeder Schritt ist ein Produktschritt oder ein Infozeilenschritt.

### Produktschritt [#productstap]

| Feld | Bedeutung |
|------|-----------|
| `productId` | Ein bestehendes Produkt in Ihrer Organisation. Pflichtfeld |
| `quantity` | Zahl größer als 0, Standard `1`. Die Menge der Position ohne Formel oder wenn die Formel `true` zurückgibt |
| `quantityScale` | Optional. `"anchor_line_quantity"` multipliziert jede berechnete Menge mit der Menge der Hauptposition |
| `description` | Optional. Text für die Rechnungsposition anstelle des Produktnamens; eine Formel kann pro Position eine eigene `description` mitgeben |
| `style` | Optional. `DEFAULT` oder `INFO` |
| `billOncePerInvoice` | Optional. `true` ordnet den Schritt bei mehreren Hauptpositionen auf einer Rechnung nur der ersten Hauptposition zu |
| `extendAccessMethod` | Optional. `{ "daysAfterPeriodEnd": <ganze Zahl, 0 bis 3660> }`, siehe [NFC-Verlängerung](#nfc-verlenging) |
| `formula` | Optional. TypeScript, das bestimmt, welche Positionen der Schritt liefert, siehe [Formel](#formule) |

### Infozeilenschritt [#inforestap]

```json
{
  "stepKind": "info",
  "description": "Inclusief toeristen-, gemeente- en provincietaksen"
}
```

`description` ist Pflicht, und ein Infozeilenschritt hat keine `productId`. Mit `style` (`DEFAULT` oder `INFO`) wählen Sie den Zeilenstil, standardmäßig ist das `INFO`. Eine `formula`, die `false` zurückgibt, lässt die Infozeile weg.

## Formel [#formule]

`formula` ist TypeScript, das beim Speichern einer Rechnung `true` (eine Position mit `quantity`), `false` (keine Position), eine Zahl (die Menge) oder eine Liste von Positionen `{ "quantity", "description", "unitPrice", "accessMethodValue" }` zurückgibt. Welche Felder und Listen Sie lesen können und was jede Form bewirkt, steht unter [Formel pro Schritt](/producten/bundel-velden#formule-per-stap). Eine Formel, die nicht kompiliert, wird beim Speichern des Produkts abgelehnt. In JSON steht die Formel als ein String mit `\n` für Zeilenumbrüche.

```json
"formula": "return {customer.customFields.exemptFromSurcharges} !== true;"
```

## NFC-Verlängerung [#nfc-verlenging]

Nur sinnvoll, wenn das Hauptprodukt **Belegung verlängern** als Aktion hat.

```json
"extendAccessMethod": { "daysAfterPeriodEnd": 20 }
```

Wird eine Position eines solchen Schritts bezahlt, setzt Tillor die Gültigkeit der Zugangsmethoden des Kunden auf das Enddatum der Hauptposition plus `daysAfterPeriodEnd` Kalendertage. Standardmäßig läuft sie bis 23:59 Uhr in der Zeitzone der Organisation, oder bis zum Wochentag und zur Uhrzeit von **Zugangsmethode verlängern** am Hauptprodukt. Welche Typen und Status berücksichtigt werden, stellen Sie dort ebenfalls ein. Ohne Enddatum an der Hauptposition passiert nichts. Ist **Bei Verlängerung nicht verkürzen** eingeschaltet, überspringt Tillor Methoden, deren Gültigkeit bereits am oder nach dem neuen Datum liegt. Ein `accessMethodValue` an der Position benennt die Methode dieser Position; die Verlängerung selbst folgt den Einstellungen des Hauptprodukts.

Nach einer erfolgreichen Verlängerung steht in der Zeitleiste der Rechnung eine Zeile, die auf die Zahlung verweist.

## Beispiel: Hinweis, NFC-Zuschlag, Zählermiete und Hunde [#voorbeeld-toelichting-nfc-toeslag-meterhuur-en-honden]

```json
{
  "invoiceBundle": {
    "version": 1,
    "steps": [
      {
        "stepKind": "info",
        "description": "Inclusief toeristen-, gemeente- en provincietaksen"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "style": "INFO",
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(0, 1).map((a) => ({ quantity: 0, unitPrice: 0, accessMethodValue: a.value, description: `Toegangsmethode inclusief: ${a.label}` }));"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(1).map((a) => ({ quantity: 1, accessMethodValue: a.value, description: `Toeslag extra toegangsmethode: ${a.label}` }));"
      },
      {
        "productId": "prd_meterhuur",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "formula": "return {meters}.filter((m) => m.provider === \"ICY\" && m.type === \"ELECTRICITY\" && m.icyMetadata?.switchState === true).map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));"
      },
      {
        "productId": "prd_hond",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "billOncePerInvoice": true,
        "formula": "const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));\nreturn dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];"
      }
    ]
  }
}
```

<Callout type="warn" title="Achtung">
Prüfen Sie, dass alle `productId`-Werte der Produktschritte in Ihrem Katalog existieren. Schritte mit einem unbekannten Produkt überspringt Tillor.
</Callout>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Bundle-Schritte" href="/producten/bundel-velden" />
  <Card title="Zusätzliche Rechnungspositionen einrichten" href="/producten/bundel-instellen" />
</Cards>


# Bundle-Schritte (/de-DE/producten/bundel-velden)

Diese Seite beschreibt die Felder in der Karte **Zusätzliche Rechnungspositionen** auf der Produktseite. Wie Sie ein Bundle aufbauen, steht unter [Zusätzliche Rechnungspositionen einrichten](/producten/bundel-instellen).

## Produktschritt [#productstap]

Tillor macht aus einem Produktschritt null, eine oder mehrere Rechnungspositionen mit diesem Produkt. Ohne Formel ist das eine Position mit der eingestellten Menge; mit einer [Formel](#formule-per-stap) bestimmen Sie selbst, ob, wie viele und welche Positionen entstehen.

| Feld | Was es bewirkt |
|------|----------------|
| **Produkt** | Das Produkt, das auf der Unterposition erscheint, zum Beispiel ein NFC-Zuschlag oder Zählermiete. Pflichtfeld |
| **Menge** | Die Menge der Position, wenn der Schritt keine Formel hat oder wenn die Formel `true` zurückgibt. Größer als 0 |
| **Mit Hauptzeilenmenge multiplizieren** | Multipliziert jede berechnete Menge mit der Menge der Hauptposition, zum Beispiel 0,5 bei einem halben Jahr Stellplatzgebühr. Das Ergebnis wird auf zwei Dezimalstellen gerundet. Positionen, die dadurch auf 0 kommen, lässt Tillor weg; eine Position, die die Formel selbst mit der Menge 0 zurückgibt, bleibt bestehen |
| **Beschreibung (optional)** | Ersetzt den Produktnamen auf der Rechnungsposition. Eine Formel, die Positionen zurückgibt, kann jeder Position eine eigene Beschreibung geben |
| **Zeilenstil** | **Standard (Produkt)**, **DEFAULT** oder **INFO**. Mit **INFO** wird die Unterposition im PDF und im Editor zu einem grauen Hinweis |
| **Einmal pro Rechnung** | Nur relevant, wenn zwei oder mehr Hauptpositionen mit einem Bundle auf derselben Rechnung stehen. Der Schritt gehört dann nur zur ersten Hauptposition in Rechnungsreihenfolge |
| **Zusätzliche Tage nach Ende der Hauptzeile (Zugangsmethoden)** | Nur sinnvoll, wenn das Hauptprodukt **Belegung verlängern** als Aktion hat. Wird eine Position dieses Schritts bezahlt, verlängert Tillor die Zugangsmethoden des Kunden bis zum Enddatum der Hauptposition plus diese Anzahl Tage; Typen und Status stammen von **Zugangsmethode verlängern** am Hauptprodukt, siehe [NFC über das Bundle verlängern](/producten/bundel-instellen#nfc-verlengen-via-de-bundel) |
| **Formel** | Optional. TypeScript, das bestimmt, ob der Schritt auf die Rechnung kommt, mit welcher Menge oder welche Positionen genau, siehe [Formel pro Schritt](#formule-per-stap) |

## Infozeilenschritt [#inforestap]

Ein Infozeilenschritt ist nur Text, ohne Produkt und Betrag. Tillor zeigt ihn als Hinweiszeile.

| Feld | Was es bewirkt |
|------|----------------|
| **Text der Infozeile** | Der sichtbare Text, zum Beispiel "Inclusief toeristen-, gemeente- en provincietaksen". Pflichtfeld |
| **Zeilenstil** | Standard **INFO**. Sie können **DEFAULT** wählen, wenn die Zeile als normale Position erscheinen soll |
| **Formel** | Optional. Gibt die Formel `false` zurück, bleibt die Infozeile weg |

Steht ein Infozeilenschritt unter einer Hauptposition, setzt das PDF automatisch **↳** vor den Text.

## Formel pro Schritt [#formule-per-stap]

Jeder Schritt kann eine **Formel** haben: TypeScript, wie bei der [Tarifformel](/terreinen#tariefformule), das Tillor beim Speichern einer Rechnung mit diesem Bundle ausführt. So hängt ein Schritt vom Kunden, der Belegung, der Parzelle, den Zählern oder den Zugangsmethoden ab, zum Beispiel über ein [eigenes Feld](/eigen-velden), in dem Sie eine Ausnahme festhalten.

### Was die Formel zurückgibt [#wat-de-formule-teruggeeft]

| Zurückgegebener Wert | Wirkung |
|----------------------|---------|
| `true` | Eine Position mit der eingestellten **Menge** |
| `false` oder `null` | Keine Position |
| Eine Zahl größer als 0 | Eine Position mit dieser Zahl als Menge |
| Eine Liste von Positionen | Genau diese Positionen, in dieser Reihenfolge. Eine leere Liste bedeutet keine Position |

Eine Position in einer solchen Liste ist ein Objekt mit diesen Feldern:

| Feld | Bedeutung |
|------|-----------|
| `quantity` | Pflicht. Die Menge, 0 oder mehr. Eine Position mit 0 bleibt bestehen, auch bei **Mit Hauptzeilenmenge multiplizieren** |
| `description` | Optional. Die Beschreibung dieser Position; sonst die **Beschreibung** des Schritts, sonst der Produktname |
| `unitPrice` | Optional. Einzelpreis inkl. MwSt., wie der Produkttarif; sonst der Produkttarif. `0` ergibt eine kostenlose Position |
| `accessMethodValue` | Optional. Der Wert der Zugangsmethode, um die es in dieser Position geht (die UID des NFC-Tags), für die Verlängerung bei Zahlung |

### Was die Formel lesen kann [#wat-de-formule-kan-lezen]

Felder lesen Sie mit geschweiften Klammern, wie bei Automatisierungen. Das Menü **Variable** am Feld zeigt alles, was verfügbar ist, einschließlich Ihrer eigenen Felder.

| Variable | Was es ist |
|----------|------------|
| `{customer.…}` | Der Kunde auf der Rechnung, zum Beispiel `{customer.createdAt}` oder `{customer.customFields.meterhuurVrijgesteld}` |
| `{occupation.…}` | Die Belegung der Hauptposition. Steht das Hauptprodukt nicht auf **Belegung verlängern**, dann die einzige Belegung des Kunden; leer (`null`), wenn der Kunde mehrere Parzellen belegt |
| `{terrain.…}` | Die Parzelle dieser Belegung |
| `{anchor.…}` | Die Hauptposition: `{anchor.quantity}` (zum Beispiel 0,5 bei einem halben Jahr), `{anchor.terrainId}`, `{anchor.occupationId}` und `{anchor.endDate}` |
| `{meters}` | Die Liste der Zähler im Geltungsbereich: auf der Parzelle der Hauptposition bei **Belegung verlängern**, sonst auf allen Parzellen, die der Kunde belegt. Jeder Zähler hat `name`, `provider` (zum Beispiel `ICY`), `type` (zum Beispiel `ELECTRICITY`, `GAS`), die Metadaten seines Anbieters (zum Beispiel `icyMetadata.switchState` für Versorgung an), seine `terrain` und `customFields` |
| `{accessMethods}` | Die Liste der Zugangsmethoden des Kunden, älteste zuerst, von jedem Typ und jedem Status. Jede Methode hat `type` (zum Beispiel `NFC`), `status` (zum Beispiel `ACTIVE`), `value`, ein lesbares `label` (der bekannte Name des NFC-Tags, sonst der Wert) und `customFields` |

Die Listen `{meters}` und `{accessMethods}` lädt Tillor nur, wenn die Formel sie verwendet.

### Beispiele [#voorbeelden]

Einen Schritt für befreite Kunden überspringen:

```ts
if ({customer.customFields.exemptFromSurcharges} === true) return false;
return true;
```

Eine Position pro ICY-Stromzähler mit Versorgung an, und für Kunden seit 2026 auch mit Versorgung aus:

```ts
const newCustomer = new Date({customer.createdAt} ?? 0) >= new Date("2026-01-01T00:00:00+01:00");
return {meters}
  .filter((m) => m.provider === "ICY" && m.type === "ELECTRICITY")
  .filter((m) => m.icyMetadata?.switchState === true || newCustomer)
  .map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));
```

Den ersten NFC-Tag kostenlos als Hinweis, jeden weiteren zum Produkttarif (zwei Schritte mit demselben Produkt, oder ein Schritt, der beide Arten von Positionen zurückgibt):

```ts
const nfc = {accessMethods}.filter((a) => a.type === "NFC" && a.status === "ACTIVE");
return nfc.map((a, i) => ({
  quantity: i === 0 ? 0 : 1,
  unitPrice: i === 0 ? 0 : undefined,
  accessMethodValue: a.value,
  description: i === 0 ? `Toegangsmethode inclusief: ${a.label}` : `Toeslag extra toegangsmethode: ${a.label}`,
}));
```

Eine Position mit der Anzahl Hunde aus einem eigenen Feld des Kunden, keine Position ohne Hunde:

```ts
const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));
return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];
```

Mit **Beispiel einfügen** unter dem Feld erhalten Sie einen Ausgangspunkt mit diesen Formen als Kommentar.

### Fehler [#fouten]

Eine Formel, die nicht kompiliert, können Sie nicht speichern; die Meldung unter dem Feld sagt, was nicht stimmt. Bleibt eine Formel beim Speichern einer Rechnung hängen oder gibt sie etwas anderes zurück als `true`, `false`, eine Zahl oder gültige Positionen, dann schlägt das Speichern fehl, mit dem Namen des Schritts in der Fehlermeldung, sodass eine fehlerhafte Formel nie stillschweigend eine Position hinzufügt oder weglässt.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zusätzliche Rechnungspositionen einrichten" href="/producten/bundel-instellen" />
  <Card title="Bundle-JSON" href="/producten/bundel-json" />
  <Card title="Zählerverwaltung" href="/meterbeheer" />
</Cards>


# Übersicht (/de-DE/producten)

Ein Produkt ist ein Tarif oder eine Dienstleistung, die Sie auf eine Rechnungsposition setzen: eine Nacht auf einer Parzelle, ein Monatsabonnement, ein NFC-Tag oder eine kWh Strom. Jedes Produkt hat einen Preis inklusive MwSt. Sie können daran auch Aktionen hängen, die Tillor automatisch ausführt, etwa eine Belegung verlängern oder einen Bon drucken. Benutzer mit dem Recht **Produkte bearbeiten** können Produkte anlegen und anpassen.

Alle Produkte finden Sie unter <UIPath>Verwaltung > Produkte</UIPath>.

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Produktübersicht mit einem Demoprodukt für eine Nacht" />

<Callout type="info" title="Gut zu wissen">
- Der Preis ist immer inklusive MwSt. Sie wählen 0 %, 6 %, 9 %, 12 % oder 21 %.
- Eine Änderung an Preis, Konto oder Aktionen gilt für Positionen, die Sie danach hinzufügen. Bestehende Rechnungen ändern sich nicht.
- Einen neuen Preis können Sie ab heute oder einem späteren Tag planen, nicht für die Vergangenheit.
- Ein deaktiviertes Produkt können Sie auf Rechnungen nicht mehr auswählen, es bleibt aber auf bestehenden Rechnungen stehen.
- Ein gelöschtes Produkt lässt sich nicht wiederherstellen. Deaktivieren Sie es lieber.
- Pro Kombination aus Kundentyp und Zählertyp gibt es nur ein Produkt mit der Aktion **Zählerverbrauch**.
- Ein **Hinweis anzeigen** darf höchstens 4000 Zeichen enthalten.
- Pro Drucker stellen Sie beim automatischen Drucken höchstens 10 Kopien ein.
- Bei **Zugangsmethode verlängern** zählen Sie höchstens 3660 Tage nach dem Enddatum.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Ein Produkt tut nichts, solange es nicht auf einer Rechnung steht. Hat das Produkt Aktionen, übernimmt Tillor sie auf die Rechnungsposition. Buchen und Bezahlen lösen diese Aktionen aus, und so landet das Ergebnis bei der Belegung, dem Tag oder dem Drucker.

```mermaid
flowchart TD
  P[Produkt mit Aktionen] --> R[Rechnungsposition auf einer Entwurfsrechnung]
  R -- Buchen --> G[Gebuchte Rechnung]
  G --> G1[Belegung: Fakturiert bis rückt vor]
  G --> G2[Reservierung angelegt bei Stellplatz abfragen]
  G --> G3[Buchen gesperrt oder Kontaktdaten abgefragt]
  G -- Bezahlen --> B[Bezahlte Rechnung]
  B --> B1[Belegung: Bezahlt bis rückt vor]
  B --> B2[NFC-Tag aufgeladen]
  B --> B3[Zugangsmethode angelegt oder verlängert]
  B --> B4[Bon oder A4 gedruckt]
```

Ein Beispiel mit **Belegung verlängern**: Sie stellen einem Kunden die Monatsmiete in Rechnung. Beim Buchen steht die Belegung bis zum Monatsende als fakturiert. Sobald der Kunde bezahlt, rückt **Bezahlt bis** nach. So sehen Sie an der Belegung, was bereits fakturiert und was bereits bezahlt ist. Mehr dazu unter [Belegungen](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).

Eine Gutschrift dreht das zurück: Buchen setzt **Fakturiert bis** auf den Beginn der Position zurück, Bezahlen setzt **Bezahlt bis** zurück. Siehe [Interne Umbuchung](/betalingsverwerking/interne-overboeking) für den Fall, dass eine Gutschrift nur mit der ursprünglichen Rechnung verrechnet wird.

## Was Sie in der Liste sehen [#wat-je-in-de-lijst-ziet]

| Spalte | Inhalt |
|--------|--------|
| **Name** und **Beschreibung** | Name und Erläuterung, wie Sie sie am Produkt eingetragen haben |
| **Info** | Kundentyp und Zählertyp, nur bei Produkten mit der Aktion **Zählerverbrauch** |
| **Aktion** | Die Aktionen am Produkt. Bei mehreren Aktionen zeigt die Spalte eine Zusammenfassung |
| **Preis (inkl. MwSt.)** | Preis pro Einheit |
| **MwSt. %** | Der MwSt.-Satz |
| **Konto** | Die Kontonummer, wenn Sie eine eingetragen haben |

In der Zeile finden Sie ein Stiftsymbol zum Öffnen des Produkts und ein Papierkorbsymbol zum Löschen. Beide sind deaktiviert, wenn Sie das Recht **Produkte bearbeiten** nicht haben.

### Suchen und filtern [#zoeken-en-filteren]

Tippen Sie in die Suchleiste, um die Liste sofort zu filtern. Außerdem können Sie nach **MwSt.**, **Kundentyp**, **Zählertyp**, **Aktionstyp**, **Status** (<Status tone="success">Aktiv</Status> oder <Status>Deaktiviert</Status>) und **Konto** filtern. Mit **Zurücksetzen** löschen Sie alle Filter auf einmal.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Ein Produkt anlegen" href="/producten/product-aanmaken" description="Name, Preis, MwSt. und Konto einstellen" />
  <Card title="Ein Produkt bearbeiten oder löschen" href="/producten/product-bewerken" description="Daten anpassen, deaktivieren oder löschen" />
  <Card title="Eine Preisänderung planen" href="/producten/prijzen-plannen" description="Ein neuer Preis ab einem Datum und der MwSt.-Rechner" />
  <Card title="Aktionen mit einem Produkt verknüpfen" href="/producten/acties-instellen" description="Tillor beim Buchen oder Bezahlen etwas tun lassen" />
  <Card title="Produktaktionen" href="/producten/productacties" description="Alle Aktionen und ihre Einstellungen" />
  <Card title="Zusätzliche Rechnungspositionen einrichten" href="/producten/bundel-instellen" description="Zuschläge und Hinweise automatisch unter eine Hauptposition setzen" />
  <Card title="Bundle-Schritte" href="/producten/bundel-velden" description="Felder, dynamische Schlüssel und Platzhalter" />
  <Card title="Bundle-JSON" href="/producten/bundel-json" description="Die Bundle-Struktur für Importe" />
  <Card title="Praxisbeispiele" href="/praktijk" description="Ausgearbeitete Beispiele aus der Praxis" />
</Cards>

## Begriffe [#begrippen]

- **Produkt**: ein Preis und eine Beschreibung, die auf einer Rechnungsposition stehen können.
- **Aktion**: etwas, das Tillor automatisch tut, wenn eine Rechnungsposition mit diesem Produkt gebucht oder bezahlt wird.
- **Bundle**: eine Reihe zusätzlicher Rechnungspositionen, die Tillor unter eine Hauptposition setzt, zum Beispiel Zuschläge bei der Stellplatzgebühr.
- **Hauptposition und Unterposition**: die Hauptposition ist die Position mit dem Bundle-Produkt, die Unterpositionen sind die Positionen, die Tillor darunter hinzufügt.
- **Fakturiert bis** und **Bezahlt bis**: bis wann eine Belegung fakturiert beziehungsweise bezahlt ist. Siehe [Belegung](/begrippen#bezetting).
- **Konto**: die Kontonummer in Ihrer Buchhaltung, auf die ein Produkt bucht.


# Eine Preisänderung planen (/de-DE/producten/prijzen-plannen)

Ändert sich der Preis eines Produkts ab einem bestimmten Tag, planen Sie das im Voraus. An diesem Tag passt Tillor den Preis des Produkts selbst an. Bestehende Rechnungen behalten ihre Preise.

<Requires permission="Produkte bearbeiten" />

## Einen Preis planen [#een-prijs-plannen]

<Steps>
<Step>
### Das Produkt öffnen [#open-het-product]
Gehen Sie zu <UIPath>Verwaltung > Produkte</UIPath> und öffnen Sie das Produkt. Unten auf der Seite steht die Karte **Geplante Preise**.

<DocScreenshot src="/screenshots/producten/product-price-changes.png" alt="Karte Geplante Preise mit einem geplanten und einem angewendeten Preis" />
</Step>
<Step>
### Das Datum wählen [#kies-de-datum]
Wählen Sie bei **Gültig ab** den Tag, an dem der neue Preis gilt. Heute ist möglich, ein Tag in der Vergangenheit nicht.
</Step>
<Step>
### Den Preis eintragen [#vul-de-prijs-in]
Geben Sie den **Neuer Preis (inkl. MwSt.)** ein. Bei **MwSt.-Satz** lassen Sie **Aktueller MwSt.-Satz** stehen oder wählen einen anderen Satz, der ab diesem Tag gilt. Sie können auch ein [Regime ohne MwSt.](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) wählen, etwa **Reverse-Charge (EU-Dienstleistungen)**; das Produkt steht dann ab diesem Tag unter diesem Regime auf 0 %.
</Step>
<Step>
### Den Preis planen [#plan-de-prijs]
Klicken Sie auf **Preis planen**. Der Preis erscheint in der Liste mit dem Status <Status tone="info">Geplant</Status>.
</Step>
</Steps>

Wählen Sie heute als Datum, gilt der neue Preis sofort. Bei einem späteren Datum gilt der Preis ab Beginn dieses Tages. Tillor rechnet dabei mit der Zeitzone Ihrer Organisation.

## Was passiert danach? [#wat-gebeurt-er-daarna]

Das Produkt erhält den neuen Preis und gegebenenfalls den neuen MwSt.-Satz. Die Zeile in der Liste erhält den Status <Status tone="success">Angewendet</Status>. Tillor sendet eine E-Mail an die Support-Adresse Ihrer Organisation oder, falls diese fehlt, an die allgemeine E-Mail-Adresse. Die Benachrichtigung heißt **Geplanter Produktpreis angewendet** und zeigt den alten und den neuen Preis. Siehe auch [Benachrichtigungen](/notificaties).

Bereits bestehende Rechnungen ändern sich nicht. Nur Positionen, die Sie danach hinzufügen, erhalten den neuen Preis.

## Einen geplanten Preis ändern oder löschen [#een-geplande-prijs-wijzigen-of-verwijderen]

- Planen Sie für denselben Tag erneut einen Preis, solange noch ein geplanter Preis besteht, ersetzt der neue den alten.
- Klicken Sie auf das Papierkorbsymbol hinter einem geplanten Preis und bestätigen Sie mit **Geplanten Preis entfernen**. Das Produkt behält an diesem Datum seinen aktuellen Preis.
- Ein Preis mit dem Status <Status tone="success">Angewendet</Status> bleibt als Historie stehen und lässt sich nicht löschen.

## Der MwSt.-Rechner [#de-btw-calculator]

Neben dem Preisfeld, sowohl bei **Neuer Preis (inkl. MwSt.)** als auch bei **Preis (inkl. MwSt.)** in **Allgemein**, steht ein kleiner Taschenrechner. Damit öffnen Sie den **MwSt.-Rechner**.

<DocScreenshot src="/screenshots/producten/product-vat-calculator.png" alt="MwSt.-Rechner mit MwSt.-Satz, Betrag exkl. und inkl. MwSt. und Preis anpassen um Prozent" />

Im Rechner können Sie:

- den Betrag **Exkl. MwSt.** oder **Inkl. MwSt.** eingeben. Der andere Betrag und die MwSt. werden sofort berechnet.
- einen anderen **MwSt.-Satz** wählen. Der Preis inkl. MwSt. wird dann aus dem Betrag exkl. MwSt. neu berechnet.
- bei **Preis ändern um %** einen Prozentsatz eingeben, zum Beispiel 5 für fünf Prozent mehr oder -5 für fünf Prozent weniger, und auf **Anwenden** klicken.

Klicken Sie auf **Diesen Preis übernehmen**, um den Preis und den MwSt.-Satz ins Formular zu übernehmen. Danach müssen Sie noch speichern oder den Preis planen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann kein Datum in der Vergangenheit wählen">
Ein Preis kann nur ab heute oder später gelten. Möchten Sie einen Preis rückwirkend anpassen, passen Sie die Rechnungen selbst an.
</Accordion>
<Accordion title="Preis planen ist grau">
Dafür benötigen Sie das Recht **Produkte bearbeiten**.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Ein Produkt bearbeiten oder löschen" href="/producten/product-bewerken" />
  <Card title="Benachrichtigungen" href="/notificaties" />
</Cards>


# Ein Produkt anlegen (/de-DE/producten/product-aanmaken)

Ein neues Produkt steht sofort auf Rechnungen zur Verfügung. Aktionen und zusätzliche Rechnungspositionen stellen Sie danach auf der Produktseite ein.

<Requires permission="Produkte bearbeiten" />

<Steps>
<Step>
### Den Dialog öffnen [#open-het-dialoogvenster]

Gehen Sie zu <UIPath>Verwaltung > Produkte</UIPath> und klicken Sie oben rechts auf **Neues Produkt**.
</Step>
<Step>
### Die Basisdaten eintragen [#vul-de-basisgegevens-in]

<DocScreenshot src="/screenshots/producten/product-create-dialog.png" alt="Dialog Produkt anlegen mit Basisfeldern" />

| Feld | Was Sie eintragen |
|------|-------------------|
| **Name** (Pflicht) | Der Name, wie er auf Rechnungen erscheint |
| **Beschreibung** | Eine kurze Erläuterung (optional) |
| **Preis (inkl. MwSt.)** | Der Betrag pro Einheit, inklusive MwSt. |
| **MwSt. %** | Wählen Sie 0 %, 6 %, 9 %, 12 % oder 21 %, oder ein Regime ohne MwSt. wie **Reverse-Charge (EU-Dienstleistungen)**. Siehe [Reverse-Charge und andere Regime](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) |
| **Konto** | Die Kontonummer für Ihre Buchhaltung (optional) |
| **Kundensaldo auf diesem Konto überwachen** | Für Kautionen: lehnt Rechnungen ab, die den Saldo des Kunden unter null bringen. Siehe [Den Saldo des Kunden überwachen](#het-saldo-van-de-klant-bewaken) |
</Step>
<Step>
### Das Produkt anlegen [#maak-het-product-aan]

Klicken Sie auf **Erstellen**. Tillor öffnet die Produktseite, auf der Sie Aktionen und zusätzliche Rechnungspositionen hinzufügen können.
</Step>
</Steps>

<Callout type="info">
Der Preis ist immer inklusive MwSt. Tillor berechnet den MwSt.-Betrag mit dem gewählten Prozentsatz und zeigt ihn getrennt auf der Rechnung.
</Callout>

## Kontonummer [#grootboeknummer]

Mit der Kontonummer verknüpfen Sie ein Produkt mit einem Konto in Ihrer Buchhaltung. Die Nummer wird beim Export in die Buchhaltungssoftware verwendet. Lassen Sie das Feld leer, wenn Sie das Produkt nicht mit einem eigenen Konto verknüpfen möchten.

Eine Änderung der Kontonummer gilt für neue Rechnungspositionen. Gebuchte Rechnungen ändern sich nicht.

## Den Saldo des Kunden überwachen [#het-saldo-van-de-klant-bewaken]

Für Kautionen haken Sie **Kundensaldo auf diesem Konto überwachen** an. Tillor addiert dann pro Kunde alle gebuchten Rechnungspositionen auf diesem Konto und lehnt jede Rechnung ab, die diesen Saldo unter null bringen würde. So können Sie eine Kaution nicht versehentlich zweimal zurückzahlen. Diese Option erfordert eine Kontonummer.

Auf der Rechnung sehen Sie unter der Position den Saldo des Kunden auf diesem Konto und was er nach dieser Rechnung wird. Entwürfe zählen nicht mit. Auch eine gebuchte Kautionsrechnung in den Entwurf zurücksetzen oder zu einem anderen Kunden verschieben ist nicht möglich, wenn der Saldo dadurch unter null ginge.

Auf dem Reiter **Rechnungen** eines Kunden steht unter **Rechnungen** die Tabelle **Konten**: jedes Konto, auf dem für diesen Kunden etwas gebucht wurde oder ein [Anfangssaldo](#beginsaldi-van-voor-tillor) steht, mit dem Saldo. Auch ein Konto, das netto auf null steht, bleibt sichtbar. Ein überwachtes Konto, auf dem für den Kunden noch nichts gebucht wurde, steht nicht dabei.

Überwacht mindestens ein Produkt ein Konto, steht der Filter **Sicherung** standardmäßig auf **Ein** und Sie sehen nur die überwachten Konten. Löschen Sie den Filter, um auch die anderen Konten zu sehen, etwa Ihre Erlöskonten. Ohne überwachte Produkte ist der Filter aus und Sie sehen sofort alle Konten. Mit dem Filter **Saldo** behalten Sie nur die Konten, die nicht auf null stehen. Ein Schild neben der Nummer zeigt, welche Konten überwacht werden.

Klappen Sie ein Konto auf, sehen Sie die gebuchten Rechnungen mit einer Position auf diesem Konto, von alt nach neu, mit dem Betrag und dem **Laufender Saldo**: dem Saldo nach dieser Rechnung. Stehen mehr als 100 Rechnungen auf dem Konto, sehen Sie die letzten 100. Der laufende Saldo berücksichtigt die älteren Rechnungen trotzdem.

Mit dem Recht **Kontosaldo übersteuern** können Sie trotzdem buchen. Sie geben dann eine Begründung an, die in die Zeitleiste der Rechnung kommt. Ohne dieses Recht bleibt **Buchen** grau, solange der Saldo unter null gehen würde.

<Requires permission="Kontosaldo übersteuern" />

## Anfangssalden aus der Zeit vor Tillor [#beginsaldi-van-voor-tillor]

Eine Kaution, die der Kunde zahlte, bevor Sie mit Tillor begannen, steht auf keiner Rechnung in Tillor. Tragen Sie einen solchen Betrag als **Anfangssaldo** auf dem Konto des Kunden ein. Er zählt im Saldo und in der Überwachung mit, sodass Sie diese Kaution später ganz normal zurückzahlen, ohne Begründung. Ein Anfangssaldo ist keine Rechnung: Er erhält keine Nummer und keine MwSt., und er geht nicht an Ihre Buchhaltung, denn Ihre alte Buchhaltung hat ihn bereits.

**Ein Kunde:** Öffnen Sie den Kunden, Reiter **Rechnungen**, Karte **Konten**, und klicken Sie auf **Anfangssaldo**. Tragen Sie das Konto (z. B. 428002), den Betrag, das Datum des alten Saldos und eine Referenz ein, zum Beispiel den Beleg aus Ihrem alten System. Ein negativer Betrag ist ein Betrag, den der Kunde noch schuldet. Klappen Sie das Konto auf, sehen Sie den Anfangssaldo ganz oben im laufenden Saldo, mit Schaltflächen zum Ändern oder Löschen. Unter dem Saldo steht, wie viel davon Anfangssaldo ist.

**Alle Kunden auf einmal:** Gehen Sie zu <UIPath>Verwaltung > Rechnungen</UIPath> und klicken Sie auf **Anfangssalden importieren**. Fügen Sie die Zeilen aus einer Tabelle ein oder wählen Sie eine CSV-Datei, mit einer Kopfzeile und den Spalten Kunde (die Tillor-Kundennummer), Konto, Betrag, Datum, Referenz und gegebenenfalls Notiz. Klicken Sie auf **Prüfen**: Sie sehen, welche Zeilen neu sind, welche Tillor aktualisiert und welche Kunden nicht gefunden wurden, plus die Summe pro Konto. Vergleichen Sie diese Summe mit der Bilanz Ihrer alten Buchhaltung und klicken Sie dann auf **Importieren**. Eine Zeile mit einer Referenz, die der Kunde auf diesem Konto bereits hat, aktualisiert diesen Anfangssaldo, statt ihn doppelt hinzuzufügen, Sie können einen Import also unbedenklich wiederholen.

Einen Anfangssaldo, der bereits zurückgezahlt wurde, können Sie normalerweise nicht mehr löschen oder verringern: Der Saldo ginge dann unter null. Haben Sie das Recht **Kontosaldo übersteuern**, fragt Tillor in diesem Fall nach einer Begründung und führt die Änderung trotzdem aus, zum Beispiel um einen alten, zusammengeführten Anfangssaldo bei einem Kunden zu entfernen, der seine Kaution in Tillor bereits zurückerhielt. Das gilt auch für einen Import, der einen Saldo unter null bringt. Jede Änderung kommt in die Zeitleiste des Kunden, mit Ihrer Begründung, wenn Sie die Überwachung übersteuert haben.

<Requires permission="Anfangssalden verwalten" />

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Produkt steht sofort in der Liste und Sie können es auf Entwurfsrechnungen auswählen.
- Auf der Produktseite stellen Sie danach [Aktionen](/producten/acties-instellen), [zusätzliche Rechnungspositionen](/producten/bundel-instellen) und [geplante Preise](/producten/prijzen-plannen) ein.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann kein Produkt anlegen oder ändern">
Anlegen und Ändern erfordert das Recht **Produkte bearbeiten**. Bitten Sie einen Administrator Ihrer Organisation, dieses Recht Ihrer Rolle hinzuzufügen.
</Accordion>
<Accordion title="Mir fehlt ein MwSt.-Satz">
Sie können nur zwischen 0 %, 6 %, 9 %, 12 % und 21 % wählen. Andere Sätze lassen sich nicht einstellen.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Ein Produkt bearbeiten oder löschen" href="/producten/product-bewerken" />
  <Card title="Aktionen mit einem Produkt verknüpfen" href="/producten/acties-instellen" />
  <Card title="MwSt. und Steuern" href="/boekhouden/belasting" />
</Cards>


# Ein Produkt bearbeiten oder löschen (/de-DE/producten/product-bewerken)

Auf der Produktseite passen Sie alles an einem Produkt an. Änderungen wirken sich auf neue Rechnungspositionen aus.

<Requires permission="Produkte bearbeiten" />

## Ein Produkt bearbeiten [#een-product-bewerken]

<Steps>
<Step>
### Das Produkt öffnen [#open-het-product]

Gehen Sie zu <UIPath>Verwaltung > Produkte</UIPath> und klicken Sie auf den Produktnamen oder auf das Stiftsymbol in der Zeile.
</Step>
<Step>
### Die Daten anpassen [#pas-de-gegevens-aan]

<DocScreenshot src="/screenshots/producten/product-detail.png" alt="Produktdetailseite mit Allgemein, Zusätzliche Rechnungspositionen, Aktionen auf Rechnungsposition und Ereignisse" />

Links finden Sie die Karten **Allgemein** und **Zusätzliche Rechnungspositionen**. Rechts stehen **Aktionen auf Rechnungsposition** und **Ereignisse**. In **Allgemein** stehen dieselben Felder wie beim Anlegen, plus die Option **Produkt deaktivieren**.
</Step>
<Step>
### Speichern [#sla-op]

Klicken Sie unten in der Karte **Zusätzliche Rechnungspositionen** auf **Speichern**. Diese Schaltfläche speichert alle Änderungen auf der Seite, auch die in **Allgemein** und **Aktionen auf Rechnungsposition**. Die Schaltfläche ist erst aktiv, wenn Sie etwas geändert haben.
</Step>
</Steps>

Soll ein neuer Preis erst ab einem späteren Datum gelten, verwenden Sie die Karte **Geplante Preise**. Siehe [Eine Preisänderung planen](/producten/prijzen-plannen).

Unter **Ereignisse** sehen Sie eine Zeitleiste der Änderungen am Produkt, etwa Preis, Konto und Aktionen. Pro Änderung stehen der Zeitpunkt, der Benutzer und, wo möglich, der Unterschied zwischen vorher und nachher.

## Ein Produkt deaktivieren [#een-product-uitschakelen]

Haken Sie **Produkt deaktivieren** an und speichern Sie. Ein deaktiviertes Produkt können Sie auf Rechnungen nicht mehr auswählen, es bleibt aber in der Liste und auf bestehenden Rechnungen stehen. In der Liste und auf der Produktseite sehen Sie es als <Status>Deaktiviert</Status>. So behalten Sie die Historie, ohne das Produkt weiter zu verwenden.

## Ein Produkt löschen [#een-product-verwijderen]

<Steps>
<Step>
### Löschen wählen [#kies-verwijderen]

Klicken Sie in der Liste auf das Papierkorbsymbol neben dem Produkt. Auf der Produktseite öffnen Sie das Menü mit den drei Punkten in der Kopfzeile und wählen **Produkt löschen**.
</Step>
<Step>
### Bestätigen [#bevestig]

<DocScreenshot src="/screenshots/producten/product-delete-dialog.png" alt="Bestätigungsdialog Produkt löschen" />

Klicken Sie im Dialog auf **Löschen**.
</Step>
</Steps>

<Callout type="warn" title="Achtung">
Löschen kann nicht rückgängig gemacht werden. Rechnungen, auf denen das Produkt bereits steht, bleiben unverändert. Steht das Produkt als Schritt im Bundle eines anderen Produkts, überspringt Tillor diesen Schritt künftig. Möchten Sie das Produkt nur nicht mehr verwenden, deaktivieren Sie es lieber.
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein neuer Preis, ein anderes Konto oder eine andere Aktion gilt für Positionen, die Sie danach hinzufügen. Bestehende Rechnungen bleiben, wie sie waren.
- Ein deaktiviertes Produkt verschwindet aus der Auswahlliste auf Rechnungen, bleibt aber in der Produktliste sichtbar.
- Jede Änderung kommt in die Zeitleiste **Ereignisse** des Produkts, mit Benutzer und Zeitpunkt.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Speichern ist grau">
Die Schaltfläche funktioniert erst, nachdem Sie etwas geändert haben, und nur mit dem Recht **Produkte bearbeiten**.
</Accordion>
<Accordion title="Das Bundle wird nicht gespeichert">
Jeder Produktschritt im Bundle muss ein Produkt haben und jeder Infozeilenschritt einen Text. Ergänzen Sie das und speichern Sie erneut. Siehe [Zusätzliche Rechnungspositionen einrichten](/producten/bundel-instellen).
</Accordion>
<Accordion title="Speichern gelingt nicht bei einem Produkt mit Zählerverbrauch">
Pro Kombination aus Kundentyp und Zählertyp kann nur ein Produkt mit der Aktion **Zählerverbrauch** existieren. Steht diese Kombination bereits bei einem anderen Produkt, wird das Speichern abgelehnt. Passen Sie das andere Produkt an oder wählen Sie eine andere Kombination.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Aktionen mit einem Produkt verknüpfen" href="/producten/acties-instellen" />
  <Card title="Eine Preisänderung planen" href="/producten/prijzen-plannen" />
  <Card title="Zusätzliche Rechnungspositionen einrichten" href="/producten/bundel-instellen" />
</Cards>


# Produktaktionen (/de-DE/producten/productacties)

Aktionen schalten Sie auf der Produktseite in der Karte **Aktionen auf Rechnungsposition** ein. Wie das geht, steht unter [Aktionen mit einem Produkt verknüpfen](/producten/acties-instellen). Diese Seite beschreibt jede Aktion. Wie die Aktionen beim Buchen und Bezahlen mit Belegungen, Tags und Druckern zusammenhängen, sehen Sie unter [Wie hängt das zusammen?](/producten#hoe-hangt-dit-samen).

## NFC Tag Opladen [#nfc-tag-opladen]

Wird eine Rechnung mit diesem Produkt bezahlt, lädt Tillor automatisch einen NFC-Tag auf. Verwenden Sie das für Produkte, mit denen Kunden Guthaben oder Zugang auf einem Tag erhalten. Es gibt keine zusätzlichen Felder am Produkt.

## Periode [#periode]

Das Produkt steht für eine Dienstleistung über einen Zeitraum, etwa einen Tagespreis, ein Wochenabonnement oder einen Monatstarif.

| Feld | Bedeutung |
|------|-----------|
| **Pro Einheit** | Anzahl Einheiten pro Periode, mindestens 1 |
| **Periodeneinheit** | **Tag**, **Woche** oder **Monat** |
| **Zugangsmethoden automatisch verlängern** | Bei Zahlung verlängert Tillor alle Zugangsmethoden des Kunden bis zum Enddatum der Periode |
| **Stellplatz abfragen** | Auf der Rechnungsposition wählen Sie eine Parzelle. Beim Buchen legt Tillor eine Reservierung für diesen Aufenthalt an |
| **Beim Buchen einchecken** | Nur mit **Stellplatz abfragen**. Sobald die Rechnung gebucht ist, setzt Tillor die Reservierung auf <Status tone="success">Eingecheckt</Status> |
| **Beim Bezahlen einchecken** | Nur mit **Stellplatz abfragen**. Sobald die Rechnung bezahlt ist, setzt Tillor die Reservierung auf <Status tone="success">Eingecheckt</Status> |
| **Enthaltene Erwachsene** | Nur mit **Stellplatz abfragen**. Anzahl Erwachsener in der Reservierung, standardmäßig 2. Sie können 0 bis 99 eintragen |

### Reservierungen bei Stellplatz abfragen [#reserveringen-bij-terrein-vragen]

- Die Reservierung erhält dieselbe Ankunft und Abreise wie die Rechnungsposition und die gewählte Parzelle als Präferenz. Die Reisegruppe passen Sie danach in der Reservierung selbst an.
- Setzen Sie die Rechnung in den Entwurf zurück und passen die Daten oder die Parzelle an, aktualisiert Tillor beim erneuten Buchen dieselbe Reservierung.
- Entfernen Sie die Parzelle oder schalten **Stellplatz abfragen** aus, wird die Reservierung storniert. Eine Reservierung, die bereits ausgecheckt ist, bleibt bestehen.
- Eine Gutschrift storniert die Reservierung der ursprünglichen Rechnung.
- Ohne Einchecken bleibt die Reservierung auf <Status tone="info">Gebucht</Status>. So funktioniert eine Reservierungsanzahlung: eine Parzelle und Daten in der Zukunft, ohne Ankunft.
- Sind beide Check-in-Optionen eingeschaltet, zählt Buchen.
- Ist die Rechnung beim erneuten Buchen bereits bezahlt, checkt Tillor erneut ein.

In der Zeitleiste der Rechnung und der Reservierung sehen Sie das Anlegen, Ändern, Stornieren und Einchecken, mit einem Verweis auf das jeweils andere.

## Belegung verlängern [#bezetting-verlengen]

Mit dieser Aktion verlängert eine Rechnung die Belegung eines Kunden auf einer Parzelle, zum Beispiel für die Stellplatzgebühr.

- Beim **Buchen** passt Tillor **Fakturiert bis** der Belegung an.
- Bei der **Zahlung** passt Tillor **Bezahlt bis** an.

Auf der Rechnungsposition wählen Sie eine Parzelle. Tillor verknüpft beim Buchen und Bezahlen die aktive Belegung des Kunden auf dieser Parzelle. Tillor speichert außerdem eine Kopie dieser Belegung an der Position, sodass Sie nachträglich sehen, welche Belegung gemeint war, auch wenn sie später gelöscht wurde. Mit **Auf nächste Periodengrenze runden** an der Rechnungsposition richten Sie Kunden bei Ratenzahlung auf denselben Zyklus aus, gemäß dem **Mietrhythmus** der Belegung.

Wählen Sie eine Parzelle, auf der der Kunde noch keine Belegung hat, erstellen Sie ein Angebot. Eine solche Position können Sie erst buchen, wenn der Kunde die Parzelle belegt.

| Feld | Bedeutung |
|------|-----------|
| **Fälligkeit ab Belegungsbeginn** | Beim Buchen setzt Tillor das Fälligkeitsdatum auf der Stellplatzgebühr-Position auf das Startdatum des Belegungszeitraums, statt auf die Standardzahlungsfrist oder die Frist im Buchungsdialog. Beim erneuten Buchen bleibt das ursprüngliche Fälligkeitsdatum |

Hat das Produkt zusätzliche Rechnungspositionen, fügt Tillor Unterpositionen unter der Hauptposition hinzu. Siehe [Zusätzliche Rechnungspositionen einrichten](/producten/bundel-instellen).

## Zugangsmethode verlängern [#toegangsmethode-verlengen]

Mit dieser Aktion verlängert die Zahlung einer Rechnung die Gültigkeit von Zugangsmethoden des Kunden. Das funktioniert auf zwei Arten:

- **Zusammen mit Periode** auf derselben Position, zum Beispiel Monatsmiete. Tillor verlängert die gewählten Methoden bis zum Enddatum der Periode.
- **Über ein Bundle** mit einer Stellplatzgebühr-Hauptposition und NFC-Schritten. Das Enddatum der Stellplatzgebühr-Hauptposition ist dann die Basis. Die Einstellungen unten stammen vom Hauptprodukt, nicht vom Zuschlagsprodukt des NFC-Schritts. Siehe [NFC über das Bundle verlängern](/producten/bundel-instellen#nfc-verlengen-via-de-bundel).

| Feld | Bedeutung |
|------|-----------|
| **Tage nach Enddatum** | Kalendertage über das Enddatum hinaus. 0 bedeutet das Enddatum selbst, höchstens 3660. Bei Bundles stellen Sie dies pro NFC-Schritt ein |
| **Wochentag** | Optional. Die Gültigkeit endet am nächstgelegenen Vorkommen dieses Wochentags um das Zieldatum. Standard **Jeden Tag** |
| **Uhrzeit** | Optional. Uhrzeit in der Zeitzone der Organisation. Leer bedeutet 23:59 |
| **Zugangsmethoden-Typen** | Wählen Sie mindestens einen Typ aus NFC, QR-Code, Kennzeichenerkennung und PIN-Code. Sie sehen nur die Typen, die für Ihre Organisation aktiviert sind |
| **Status** | Nur Methoden mit einem dieser Status werden verlängert: <Status tone="success">Aktiv</Status> oder <Status tone="warning">Weich gesperrt</Status>. Standardmäßig nur **Aktiv** |
| **Bei Verlängerung nicht verkürzen** | Methoden, deren **Gültig bis** bereits am oder nach dem neuen Datum liegt, werden übersprungen. Beim Zurückdrehen über eine Gutschrift setzt Tillor immer das berechnete Datum |

Unter dem Feld steht eine Zeile **Ergebnis**, die erklärt, zu welchem Zeitpunkt die Gültigkeit endet, zum Beispiel "nächster Dienstag um Enddatum + 10 Tage, um 13:00".

Das ist nicht dasselbe wie **Zugangsmethoden automatisch verlängern** bei **Periode**. Dieser Schalter verlängert bei Zahlung eines Produkts mit nur **Periode**, ohne die separate Aktion **Zugangsmethode verlängern**.

## Zugangsmethode anlegen [#toegangsmethode-aanmaken]

Bei Zahlung der Rechnung legt Tillor eine neue Zugangsmethode für den Kunden an. Die Kassenkraft wählt auf der Rechnungsposition den Typ. Hat die Position auch die Aktion **Periode**, wird der Zeitraum zur Gültigkeit der Zugangsmethode.

| Feld | Bedeutung |
|------|-----------|
| **Zugangsmethoden-Typen** | Typen, aus denen die Kassenkraft wählt: QR-Code, Kennzeichenerkennung oder PIN-Code. Bei nur einem Typ wählt Tillor ihn automatisch |
| **Zugangsmethode ist optional** | Buchen wird durch diese Position nie blockiert. Ohne gewählten Typ legt Tillor nichts an |
| **Standard-Zugangsmethode** | Nur bei mehreren Typen. Dieser Typ ist auf neuen Rechnungspositionen standardmäßig ausgewählt, pro Position anpassbar. **Kein Standard (pro Position wählen)** lässt die Wahl offen |
| **QR-Code automatisch drucken** | Nur mit QR-Code. Tillor druckt das QR-Zugangsticket auf dem Bondrucker, sobald es angelegt wird |
| **Codes automatisch in Kennzeichen umwandeln** | Neue QR- und PIN-Codes werden durch das erkannte Kennzeichen ersetzt, wenn sie an einer Schranke mit Kamera verwendet werden. Pro Position anpassbar |

Eine Position lässt sich erst buchen, wenn ein Typ gewählt ist, es sei denn, die Aktion ist optional. Bei Kennzeichenerkennung muss auch das Kennzeichen eingetragen sein.

## Kontaktdaten abfragen [#contactgegevens-vragen]

Auf der Rechnungsposition erscheinen Felder für E-Mail-Adresse und Telefonnummer. Tillor fragt sie beim Buchen ab.

| Feld | Bedeutung |
|------|-----------|
| **Nach E-Mail-Adresse fragen** | Zeigt ein E-Mail-Feld auf der Rechnungsposition |
| **E-Mail-Adresse erforderlich** | Nur, wenn Sie nach einer E-Mail-Adresse fragen. Buchen ist gesperrt, bis das Feld ausgefüllt ist |
| **Nach Telefonnummer fragen** | Zeigt ein Telefonfeld auf der Rechnungsposition |
| **Telefonnummer erforderlich** | Nur, wenn Sie nach einer Telefonnummer fragen. Buchen ist gesperrt, bis das Feld ausgefüllt ist |

## Buchen blockieren [#boeken-blokkeren]

Verwenden Sie dies für Produkte, die nur auf Entwurfsrechnungen gehören. Steht eine solche Position auf einer Entwurfsrechnung, können Sie die Rechnung nicht endgültig machen. Es gibt kein zusätzliches Feld. Tillor blockiert das Buchen, solange die Position vorhanden ist.

## Hinweis anzeigen [#melding-tonen]

Zeigt einen Hinweis unter der Rechnungsposition, zum Beispiel "Achtung: nur für Tagesgäste verwenden". Beim Buchen oder Bezahlen passiert nichts.

| Feld | Bedeutung |
|------|-----------|
| **Hinweistyp** | **Hinweis**, **Warnung**, **Fehler**, **Erfolg** oder **Neutral** |
| **Hinweistext** | Der Text, höchstens 4000 Zeichen. Markdown wird unterstützt (fett, Listen, Links) |

Unter dem Text sehen Sie sofort eine Vorschau des Hinweises. Der Text wird auf die Rechnungsposition kopiert. Spätere Änderungen am Produkt ändern bestehende Rechnungen nicht.

## Zählerverbrauch [#meterverbruik]

Mit dieser Aktion wird das Produkt zum Tarif für Zählerverbrauch. Tillor verwendet es bei offenem Verbrauch und bei der automatischen Abrechnung von Zählerständen. Sie wählen zwei Felder.

| Feld | Optionen |
|------|----------|
| **Kundentyp** | **Standard**, **Worker Mietwohnwagen**, **Worker Zugwohnwagen** |
| **Zählertyp** | **Strom**, **Wasser**, **Gas** |

Pro Kombination aus Kundentyp und Zählertyp kann nur ein Produkt existieren. In der Liste stehen beide Werte in der Spalte **Info**. Hat ein Kunde kein eigenes Produkt für seinen Kundentyp, verwendet Tillor das Produkt für **Standard** mit demselben Zählertyp.

## Thermodruck und A4-Druck [#thermisch-printen-en-a4-printen]

Haken Sie **Thermodruck** und **A4-Druck** getrennt an. Sobald mindestens eines der beiden eingeschaltet ist, erscheint der Block **Automatisch drucken**. Dort stellen Sie pro Drucker ein, was bei Zahlung der Rechnung gedruckt wird.

| Feld | Bedeutung |
|------|-----------|
| **Thermische Druckkopien** | Anzahl Exemplare auf dem Thermodrucker (Bondrucker). 0 schaltet diesen Drucker aus |
| **A4-Druckkopien** | Anzahl Exemplare auf dem A4-Drucker. 0 schaltet A4 aus |
| **Druckzeitpunkt** | **Einstellungen verwenden (je Zahlungsart)** (Standard), **Sofort drucken** oder **Nächster Zeitpunkt** |

Sie können pro Drucker höchstens 10 Kopien einstellen. Bei **Einstellungen verwenden (je Zahlungsart)** gilt die Einstellung Ihrer Organisation pro Zahlungsart.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Aktionen mit einem Produkt verknüpfen" href="/producten/acties-instellen" />
  <Card title="Zusätzliche Rechnungspositionen einrichten" href="/producten/bundel-instellen" />
  <Card title="Zählerverwaltung" href="/meterbeheer" />
  <Card title="NFC" href="/nfc" />
</Cards>


# Reservierungen (/de-DE/reserveringen)

Mit Reservierungen behalten Sie die Aufenthalte auf Ihrem Park im Blick: wer wann kommt, auf welcher Parzelle und mit wie vielen Gästen. Von einer Reservierung aus wickeln Sie auch Check-in und Check-out ab. Alle Reservierungen sehen Sie auf einer Zeitleiste unter **Reservierungen** und pro Kunde auf dem Reiter **Reservierungen**. Beginnen Sie mit [Eine Reservierung anlegen](#een-reservering-aanmaken).

<Callout type="info" title="Gut zu wissen">
- Jede Reservierung gehört zu einem Kunden und erhält automatisch eine eindeutige **Reservierungsnummer**. Diese Nummer lässt sich nicht ändern.
- Das Check-out-Datum muss nach dem Check-in-Datum liegen. Denselben Tag oder früher lehnt Tillor ab.
- Ein Kennzeichen besteht aus Buchstaben und Ziffern, höchstens 10 Zeichen, ohne Leerzeichen oder Bindestriche.
- Einchecken und Stornieren sind nur aus dem Status **Gebucht** möglich. Stornieren geht nach dem Einchecken nicht mehr.
- Eine Reservierung ist nicht dasselbe wie eine Belegung: Eine Reservierung ist eine Buchung für einen Aufenthalt, eine Belegung verknüpft einen Kunden für einen Zeitraum mit einer Parzelle, siehe [Belegungen](/bezettingen).
- Notizen zu einer Reservierung sind intern und werden nie mit dem Kunden geteilt.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Kunde] --> R[Reservierung]
  R -->|Einchecken| I[Gast auf der Parzelle]
  I -->|Auschecken| U[Aufenthalt abgeschlossen]
  R -->|Reservierung stornieren| A[Storniert]
  R --> F[Rechnungen des Kunden]
```

Die Rechnungen des Kunden finden Sie im Kundenprofil unter **Rechnungen**.

## Die Zeitleiste [#de-tijdlijn]

Gehen Sie im Hauptmenü zu **Reservierungen**. Die Zeitleiste zeigt die Reservierungen pro Parzelle über einen Kalender. Mit der Ansicht wählen Sie Tag, Woche, Monat, Quartal oder Jahr, und mit **Zum Datum** springen Sie zu einem Datum.

<DocScreenshot src="/screenshots/reserveringen/reservations-list.png" alt="Zeitleiste der Reservierungen" />

- Klicken oder ziehen Sie auf einen freien Bereich, um eine Reservierung hinzuzufügen. Oben rechts steht auch **Neue Reservierung**.
- Ziehen Sie eine Reservierung auf andere Daten, fragt Tillor **Reservierungsdaten ändern?** Erst nach Ihrer Bestätigung ändert sich die Reservierung.
- Das Kontextmenü einer Reservierung hat **Reservierung ansehen**, **Link kopieren** und **Reservierung stornieren**.

## Eine Reservierung anlegen [#een-reservering-aanmaken]

Bevor Sie beginnen:

- Sie brauchen einen Kunden. Existiert er noch nicht, legen Sie ihn beim Starten an, siehe [Kundenverwaltung](/klantenbeheer).
- Wissen Sie, welche Parzelle der Gast möchte? Dann wählen Sie sie. Andernfalls lassen Sie das Feld leer.

<Steps>
<Step>
### Die Reservierung starten [#start-de-reservering]
<Tabs items={["Über Reservierungen", "Über das Kundenprofil"]}>
<Tab value="Via Reserveringen">
Klicken Sie oben rechts auf **Neue Reservierung**. Wählen Sie einen bestehenden Kunden oder legen Sie einen neuen Kunden an.
</Tab>
<Tab value="Via het klantprofiel">
Öffnen Sie den Kunden über **Kunden**, gehen Sie zum Reiter **Reservierungen** und klicken Sie auf **Neue Reservierung**.
</Tab>
</Tabs>
</Step>
<Step>
### Das Formular ausfüllen [#vul-het-formulier-in]
Siehe [Das Reservierungsformular](#het-reserveringsformulier) unten für alle Felder.
</Step>
<Step>
### Die Reservierung anlegen [#maak-de-reservering-aan]
Klicken Sie auf **Reservierung anlegen**.
</Step>
</Steps>

### Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Reservierung erhält den Status <Status tone="info">Gebucht</Status> und eine Reservierungsnummer.
- Ist **Automatische Bestätigungs-E-Mail** eingeschaltet, erhält der Kunde eine Bestätigung.
- Sie finden die Reservierung auf der Zeitleiste und auf dem Reiter **Reservierungen** des Kunden.
- Soll eine Automatisierung auf eine neue oder geänderte Reservierung reagieren, verwenden Sie einen Trigger, siehe [Trigger](/automatiseringen/triggers).

## Das Reservierungsformular [#het-reserveringsformulier]

### Daten und Aufenthaltsdauer [#datums-en-verblijfsduur]

- **Check-in**: Wählen Sie das Ankunftsdatum.
- **Check-out**: Wählen Sie das Abreisedatum. Nach dem Check-in-Datum öffnet sich die Check-out-Auswahl von selbst. Das Abreisedatum muss nach dem Ankunftsdatum liegen.
- **Anzahl der Nächte**: Tillor berechnet dies selbst.

### Anzahl und Tiere [#aantallen-en-dieren]

Geben Sie die Anzahl **Erwachsene** (mindestens 1), **Kinder**, **Kleinkinder** und **Tiere** mit den Plus- und Minus-Schaltflächen an.

### Parzelle [#terrein]

- **Parzelle**: Wählen Sie eine Parzelle, wenn der Gast eine Präferenz hat. Die Liste zeigt nur buchbare Parzellen ohne aktive Belegung, die im gewählten Zeitraum frei sind. Überlappende aktive Reservierungen auf derselben Parzelle schließt Tillor aus. Passen Sie die Daten an, aktualisiert sich die Liste. Keine Präferenz? Lassen Sie das Feld leer.
- **Nicht buchbare Parzellen einbeziehen**: Zeigt auch Parzellen, die nicht online reservierbar sind, zum Beispiel feste Jahresplätze. Steht die Reservierung bereits auf einer solchen Parzelle, ist dieses Häkchen von selbst gesetzt.
- **Belegte Parzellen einbeziehen**: Zeigt auch Parzellen, die bereits eine Belegung haben.

### Kennzeichen [#nummerplaten]

Tippen Sie ein Kennzeichen, drücken Sie **Enter** und wiederholen Sie das für jedes Kennzeichen. Ein Kreuz am Kennzeichen entfernt es. Kennzeichen dürfen nur Buchstaben und Ziffern enthalten, höchstens 10 Zeichen.

Die Kennzeichen einer Reservierung sind über die Suche auffindbar. Den Zugang an der Schranke regeln Sie separat, beim Kunden auf dem Reiter **Zugangskontrolle**, siehe [Zugangskontrolle](/toegangscontrole).

### Notizen [#notities]

Verwenden Sie das Notizfeld für interne Anmerkungen, etwa besondere Wünsche oder Absprachen.

### Kommunikationspräferenzen [#communicatievoorkeuren]

- **Automatische Bestätigungs-E-Mail**: Sendet nach dem Anlegen eine Bestätigung.
- **Online-Zahlung**: Erlaubt dem Kunden, die Reservierung online zu bezahlen.

## Eine Reservierung ansehen und bearbeiten [#een-reservering-bekijken-en-bewerken]

Klicken Sie auf eine Reservierung auf der Zeitleiste oder im Kundenprofil, um die Detailseite zu öffnen.

<DocScreenshot src="/screenshots/reserveringen/reservation-detail.png" alt="Detailseite einer Reservierung" />

- **Reservierungsdetails** (links): das vollständige Formular. Ändern Sie, was Sie möchten, und klicken Sie auf **Speichern**. Mit **Abbrechen** stellen Sie die ursprünglichen Werte wieder her. Neben dem Titel steht **Reservierungslink kopieren**, praktisch, um einen anklickbaren Link in ein Dokument einzufügen.
- **Aktionen für die Reservierung** (rechts): die Schaltflächen unten.
- **Anmerkungen** (rechts): interne Diskussion zu dieser Reservierung.
- **Aktivität** (rechts): eine Zeitleiste mit Anlegen, Einchecken, Auschecken, Stornieren, Zurückdrehen und geänderten Daten, mit Zeitpunkt und Benutzer. Bei einer Änderung sehen Sie, welche Felder angepasst wurden (vorher / nachher).

## Einchecken, auschecken und stornieren [#inchecken-uitchecken-en-annuleren]

Auf der Detailseite stehen die Aktionen unter **Aktionen für die Reservierung**. Jede Aktion verlangt eine Bestätigung.

| Aktion | Möglich, wenn | Ergebnis |
|---|---|---|
| **Einchecken** | Status <Status tone="info">Gebucht</Status> | Status <Status tone="success">Eingecheckt</Status> |
| **Auschecken** | Status <Status tone="success">Eingecheckt</Status> | Status <Status>Ausgecheckt</Status> |
| **Reservierung stornieren** | Nur vor dem Einchecken | Status <Status>Storniert</Status> |
| **Stornierung rückgängig machen** | Nur vor dem Einchecken | Zurück zu <Status tone="info">Gebucht</Status> |
| **Check-in rückgängig** | Bei einem versehentlichen Einchecken. War der Gast bereits ausgecheckt, drehen Sie zuerst das Auschecken zurück | Zurück zu <Status tone="info">Gebucht</Status> |
| **Check-out rückgängig** | Bei einem versehentlichen Auschecken | Zurück zu <Status tone="success">Eingecheckt</Status> |

Außerdem gibt es **Bestätigungsformular per SMS an Kundin/Kunden senden** und **Aufgabe erstellen**. Mit Letzterem machen Sie aus dieser Reservierung eine Aufgabe.

Eine stornierte Reservierung können Sie nicht einchecken oder auschecken. Machen Sie zuerst die Stornierung rückgängig.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor sagt: Reservatie niet aangemaakt">
Die Meldung lautet **Die Reservierung konnte nicht erstellt werden.** Prüfen Sie, ob ein Kunde gewählt ist und ob das Check-out-Datum nach dem Check-in-Datum liegt. Derselbe Tag oder früher wird abgelehnt.
</Accordion>
<Accordion title="Tillor sagt: Reservatie niet bijgewerkt">
Ihre Änderungen wurden nicht gespeichert. Prüfen Sie die Daten (Check-out muss nach Check-in liegen), die Kennzeichen und die Anzahl Erwachsener, und klicken Sie erneut auf **Speichern**.
</Accordion>
<Accordion title="Tillor sagt: Inchecken mislukt">
Die Reservierung muss den Status Gebucht haben. Ist sie bereits eingecheckt, ausgecheckt oder storniert, ist Einchecken nicht möglich. Laden Sie die Seite neu und prüfen Sie den aktuellen Status. Ist sie storniert, wählen Sie zuerst **Stornierung rückgängig machen**.
</Accordion>
<Accordion title="Tillor sagt: Uitchecken mislukt">
Auschecken ist nur bei einer eingecheckten Reservierung möglich. Ist der Gast noch nicht eingecheckt oder bereits ausgecheckt, funktioniert es nicht.
</Accordion>
<Accordion title="Tillor sagt: Annuleren mislukt">
Stornieren ist nur vor dem Einchecken möglich. Ist der Gast bereits eingecheckt, drehen Sie zuerst **Check-in rückgängig** zurück und stornieren danach.
</Accordion>
<Accordion title="Die Parzelle steht nicht in der Liste">
Die Liste zeigt nur buchbare Parzellen ohne Belegung, die im gewählten Zeitraum frei sind. Prüfen Sie die Daten. Haken Sie **Nicht buchbare Parzellen einbeziehen** oder **Belegte Parzellen einbeziehen** an, wenn Sie eine solche Parzelle meinen.
</Accordion>
<Accordion title="Ein Kennzeichen wird nicht hinzugefügt">
Ein Kennzeichen darf nur Buchstaben und Ziffern enthalten und höchstens 10 Zeichen lang sein. Entfernen Sie Leerzeichen und Bindestriche.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Reservierung**: eine Buchung für einen Aufenthalt. Siehe [Reservierung](/begrippen#reservering).
- **Gebucht, Eingecheckt, Ausgecheckt, Storniert**: die vier Status einer Reservierung.
- **Reservierungsnummer**: die automatische Nummer, mit der Sie eine Reservierung wiederfinden.
- **Belegung**: ein Kunde auf einer Parzelle für einen Zeitraum, unabhängig von einer Reservierung. Siehe [Belegung](/begrippen#bezetting).
- **Zeitleiste**: die Übersicht der Reservierungen pro Parzelle über einen Kalender.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Kundenverwaltung" href="/klantenbeheer" />
  <Card title="Belegungen" href="/bezettingen" />
  <Card title="Zugangskontrolle" href="/toegangscontrole" />
  <Card title="Zahlungsabwicklung" href="/betalingsverwerking" />
  <Card title="Praxisbeispiele" href="/praktijk" />
</Cards>


# Aufgaben teilen (/de-DE/taken/delen)

Möchtest du Aufgaben jemandem zeigen, der nicht in Tillor arbeitet, oder sie in deinem eigenen Kalender sehen? Dann erstellst du einen Freigabelink. Es gibt zwei Arten.

| Art | Was es ist |
|---|---|
| **Teilbare Seite** | Ein schreibgeschütztes Board mit dem, was zu tun ist. Es folgt den Aufgaben, Änderungen in Tillor siehst du also dort wieder |
| **Kalender (ICS)** | Ein Kalenderabo, zum Beispiel für Google Kalender, Outlook oder den Apple Kalender |

## Einen Link erstellen [#een-link-maken]

1. Klicke auf der Aufgabenseite oben rechts auf das Teilen-Symbol (Tooltip **Diese Ansicht teilen**). Dasselbe Symbol findest du auch auf der Dashboard-Karte **Aufgaben für dich**
2. Wähle bei **Art des Links** eine **Teilbare Seite** oder **Kalender (ICS)**
3. Wähle bei **Inhalt**, was du teilst: **Meine zugewiesenen Aufgaben** oder eine deiner Ansichten. Öffnest du das Fenster aus einer Ansicht heraus, ist diese schon ausgewählt
4. Schränke den Inhalt bei Bedarf mit **Filter** ein: **Status**, **Priorität**, **Zugewiesen an**, **Label**, **Ansicht**, **Verknüpft mit** und **Blockiert**. Die Filter werden am Link gespeichert und verengen nur, was die Quelle ohnehin zeigt
5. Klicke auf **Link erstellen**

<DocScreenshot src="/screenshots/taken/task-share-dialog.png" alt="Dialog Aufgaben teilen mit Art des Links, Inhalt und Filtern" />

Unter **Frühere Links** stehen alle Links, die du für diese Quelle erstellt hast. Pro Link kannst du:

- **Link kopieren**
- Bei einem Kalenderlink **Zum Kalender hinzufügen**, wodurch das Abo sofort in deiner Kalender-App geöffnet wird
- **Ungültig machen** (nach Bestätigung). Der Link funktioniert dann nicht mehr. Andere Links bleiben gültig. Ein ungültiger Link bleibt in der Liste stehen, gekennzeichnet mit **Ungültig**

<Callout type="warn">
Ein Freigabelink ist privat, aber jeder, der den Link hat, kann die Aufgaben sehen, auch ohne Anmeldung. Teile ihn nur mit Personen, die das dürfen, und mache ihn ungültig, sobald du ihn nicht mehr brauchst.
</Callout>

## Die teilbare Seite [#de-deelbare-pagina]

Die Seite zeigt die Aufgaben pro Gruppe, bei jeder Aufgabe mit Name, Status, Priorität, Fälligkeitsdatum, Labels und den Namen der zugewiesenen Kolleginnen und Kollegen. Es gibt keine Schaltflächen, um etwas zu ändern. Bei einer großen Gruppe siehst du **[Anzahl] von [Gesamt]** Aufgaben.

Standardmäßig stehen dort nur offene Aufgaben, es sei denn, du stellst selbst einen Statusfilter ein oder teilst eine Ansicht. Gibt es nichts zu tun, siehst du **Gerade gibt es nichts zu tun.**

## Der Kalender [#de-agenda]

Im Kalender erscheinen Aufgaben mit einem **Fälligkeitsdatum** oder einer **Erinnerung**. Aufgaben ohne Datum stehen nicht darin.

- Wiederkehrende Erinnerungen erscheinen als Serie, und du bekommst bei jeder Erinnerung eine Benachrichtigung
- Ohne Erinnerung bekommst du eine Stunde vor dem Fälligkeitsdatum eine Benachrichtigung
- Abgeschlossene Aufgaben bleiben noch zwei Wochen sichtbar, als abgeschlossen, und fallen danach weg
- Bei einer Ansicht folgt der Kalender der Ansicht, unabhängig davon, wem die Aufgaben zugewiesen sind. Kann die Person, die den Link erstellt hat, die Ansicht nicht mehr sehen, funktioniert der Link nicht mehr

<Callout type="info">
In Google Kalender musst du für einen abonnierten Kalender auch die Standardbenachrichtigungen aktivieren, sonst kommen die Benachrichtigungen nicht an.
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Der Link funktioniert sofort und bleibt gültig, bis du ihn ungültig machst. Jeder mit dem Link kann die Aufgaben sehen, auch ohne Anmeldung.
- Eine teilbare Seite folgt den Aufgaben: Änderungen in Tillor siehst du dort wieder.
- Ein Kalenderabo aktualisiert sich selbst in deiner Kalender-App und benachrichtigt dich eine Stunde vor dem Fälligkeitsdatum oder bei jeder Erinnerung.
- Machst du einen Link ungültig, endet nur dieser Link. Andere Links bleiben gültig, und der ungültige Link bleibt in der Liste stehen, gekennzeichnet mit **Ungültig**.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet Link konnte nicht erstellt werden">
Der Link wurde nicht erstellt. Prüfe, ob du bei **Inhalt** eine Quelle gewählt hast, und versuche es erneut. Die Meldung **Links konnten nicht geladen werden.** bedeutet, dass sich die Liste der früheren Links nicht geöffnet hat. Öffne das Fenster erneut.
</Accordion>
<Accordion title="Die Seite zeigt Gerade gibt es nichts zu tun">
Es gibt keine Aufgaben, die zur Quelle und zu den Filtern passen. Eine teilbare Seite zeigt standardmäßig nur offene Aufgaben.
</Accordion>
<Accordion title="Der Kalender zeigt meine Aufgaben nicht">
Nur Aufgaben mit einem Fälligkeitsdatum oder einer Erinnerung stehen im Kalender. Kann die Person, die den Link erstellt hat, die Ansicht nicht mehr sehen, funktioniert der Link ebenfalls nicht mehr.
</Accordion>
<Accordion title="Ich bekomme keine Benachrichtigungen in Google Kalender">
Schalte in Google Kalender für den abonnierten Kalender auch die Standardbenachrichtigungen ein.
</Accordion>
<Accordion title="Ich möchte den Link nicht mehr funktionieren lassen">
Wähle beim Link **Ungültig machen** und bestätige bei **Diesen Link ungültig machen?**. Schlägt das fehl, steht dort **Link konnte nicht ungültig gemacht werden**: Versuche es erneut.
</Accordion>
</Accordions>


# Filtern (/de-DE/taken/filteren)

Über den Aufgaben steht eine Suchleiste mit den Filterschaltflächen daneben. Filter gehören zur Ansicht: Speicherst du sie, bestimmen sie, welche Aufgaben die Ansicht zeigt. Bei einer gefilterten Ansicht sind das die Aufgaben, die zu den Filtern passen. Bei einer Liste sind es die manuell hinzugefügten Aufgaben, die auch zu den Filtern passen.

<DocScreenshot src="/screenshots/taken/task-filter-status.png" alt="Der Statusfilter mit den Optionen Einschließen und Ausschließen und den vier Status" />

## Immer sichtbare Filter [#altijd-zichtbare-filters]

| Filter | Was du wählst |
|---|---|
| **Status** | Einen oder mehrere Status |
| **Priorität** | Eine oder mehrere Prioritäten |
| **Zugewiesen an** | Eine oder mehrere Kolleginnen und Kollegen, oder **Ich** für dich selbst |
| **Label** | Ein oder mehrere Labels |
| **Ansicht** | Aufgaben, die in einer anderen (manuellen) Ansicht stehen |
| **Blockiert** | **Blockiert** oder **Nicht blockiert** |
| **Verknüpft mit** | Die Art des Datensatzes, an dem die Aufgabe hängt, etwa ein Kunde, ein Stellplatz, eine Rechnung oder eine Reservierung |
| **Text** | Wörter, die der Name oder die Beschreibung enthält oder gerade nicht enthält, siehe unten |
| **Fälligkeit** | Ein Zeitraum, siehe unten |

Bei den Filtern mit einer Liste wählst du oben **Einschließen** (Aufgaben mit den gewählten Werten) oder **Ausschließen** (Aufgaben ohne diese Werte). Bei **Verknüpft mit** wählst du die Art des Elements: **Kunde**, **Rechnung**, **Reservierung**, **Zähler**, **Stellplatz**, **Kommentar**, **Unterhaltung**, **Telefonanruf**, **Banktransaktion** oder **Produkt**.

## Nach Text filtern [#filteren-op-tekst]

Mit **Text** zeigst du nur Aufgaben, deren Name oder Beschreibung ein Stück Text enthält oder gerade nicht enthält. Groß- und Kleinschreibung spielen keine Rolle.

1. Klicke auf **Text**
2. Wähle **Enthält** oder **Enthält nicht**
3. Tippe den Text in **Text in Name oder Beschreibung** ein, zum Beispiel `Verzekering vervallen:`
4. Klicke auf **Hinzufügen** oder drücke Enter

Wiederhole das für jeden Text, den du hinzufügen möchtest. Jeder Text ist ein eigener Filter, du kannst also **Enthält** und **Enthält nicht** kombinieren: zum Beispiel `caravan`, aber nicht `Verzekering vervallen:`. Mit dem Kreuz neben einem Text entfernst du ihn. Auf der Schaltfläche steht der Text selbst oder, wenn es mehrere sind, die Anzahl der Texte.

<Callout>
Ob eine Aufgabe **allen** Texten entsprechen muss oder **einem** davon, hängt von der Wahl bei [Mehrere Filter kombinieren](#meerdere-filters-combineren) ab. Möchtest du mehrere Texte ausschließen, lass die Auswahl auf **Alle Filter erfüllen** stehen.
</Callout>

## Nach Datum filtern [#filteren-op-datum]

**Fälligkeit** arbeitet mit festen Auswahlmöglichkeiten, die mit dem Tag mitwandern, oder mit einem eigenen Zeitraum.

- **Überfällig**, **Heute**, **Morgen**, **Diese Woche**, **Nächste Woche**, **Diesen Monat**
- **Ohne Datum** (Aufgaben ohne Fälligkeitsdatum) und **Mit Datum**
- **Eigener Zeitraum**: Wähle im Kalender ein Start- und ein Enddatum und klicke auf **Zeitraum anwenden**. Der Endtag zählt vollständig mit

<DocScreenshot src="/screenshots/taken/task-filter-deadline.png" alt="Der Fälligkeitsfilter mit festen Optionen und einem Kalender für einen eigenen Zeitraum" />

Klickst du eine gewählte Option noch einmal an, verschwindet der Filter wieder.

## Mehrere Filter kombinieren [#meerdere-filters-combineren]

Sobald du zwei oder mehr Filter hast, erscheint ein Auswahlmenü:

- **Alle Filter erfüllen** - eine Aufgabe muss zu jedem Filter passen
- **Einen Filter erfüllen** - es genügt, dass eine Aufgabe zu einem der Filter passt

Mit **Filter löschen** entfernst du alle Filter auf einmal.

## Beispiele [#voorbeelden]

- *Alles, was heute fertig sein muss und noch offen ist*: Filtere **Fälligkeit** auf **Heute** und **Status** auf alles außer **Abgeschlossen**
- *Aufgaben, auf die ich warten muss*: Filtere **Status** auf **Wartet auf Antwort** und **Zugewiesen an** auf **Ich**
- *Alles außer den Meldungen über abgelaufene Versicherungen*: Filtere **Text** auf **Enthält nicht** `Verzekering vervallen:`
- *Alles rund um einen Kunden*: Öffne den Kunden. Auf dem Tab **Aufgaben** der Kundenseite stehen alle Aufgaben, die mit diesem Kunden verknüpft sind

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Filter auf deinem Bildschirm verengen, was du siehst. Erst wenn du sie mit **Ansicht speichern** speicherst, gehören sie zur Ansicht, und Kolleginnen und Kollegen sehen dieselbe Auswahl.
- Auch in der eingebauten Ansicht **Alle** kannst du Filter speichern. Sie gelten dann für alle in deiner Organisation. Dafür brauchst du das Recht **Labels und geteilte Ansichten verwalten**.
- Bei einer gefilterten Ansicht erscheinen und verschwinden Aufgaben von selbst, je nachdem, ob sie zu den Filtern passen.
- Die Suchleiste wird nie gespeichert.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe keine Aufgaben mehr">
Prüfe, ob ein Filter aktiv ist, etwa ein Statusfilter, der **Abgeschlossen** ausschließt, oder **Alle Filter erfüllen**, obwohl du einen der Filter gemeint hast. Mit **Filter löschen** beginnst du von vorn.
</Accordion>
<Accordion title="Der Filter ist nach dem Aktualisieren weg">
Du hattest ihn nicht gespeichert. Wähle **Ansicht speichern** in der Leiste **Nicht gespeicherte Änderungen**.
</Accordion>
<Accordion title="Ich kann die Filter in Alle nicht speichern">
**Ansicht speichern** ist ausgegraut, wenn du das Recht **Labels und geteilte Ansichten verwalten** nicht hast, weil **Alle** für die ganze Organisation gilt. Frag eine Administratorin oder einen Administrator danach, oder erstelle eine eigene Ansicht mit denselben Filtern.
</Accordion>
<Accordion title="Eine Aufgabe einer Kollegin oder eines Kollegen fehlt">
Du siehst nur Aufgaben, die du sehen darfst. Eine Aufgabe in einer persönlichen Ansicht einer Kollegin oder eines Kollegen ist für dich unsichtbar. Siehe [Private Aufgaben](/taken/prive-taken).
</Accordion>
<Accordion title="Der Filter Fälligkeit zeigt bei einem eigenen Zeitraum nichts an">
Klicke nach der Wahl eines Start- und Enddatums auf **Zeitraum anwenden**.
</Accordion>
</Accordions>


# Tabelle, Board und Kalender (/de-DE/taken/indelingen)

Dieselben Aufgaben kannst du auf drei Arten ansehen. Oben rechts öffnest du **Anzeige**, um zu wählen:

- **Layout** - **Tabelle**, **Board** oder **Kalender**. Diese Auswahl gibt es nur bei gespeicherten Ansichten, nicht bei **Alle**
- **Gruppieren nach** - wie Aufgaben in Gruppen oder Spalten aufgeteilt werden
- **Sortieren nach** und **Reihenfolge** - **Aufsteigend** oder **Absteigend**
- **Art** - ob die Ansicht eine **Liste** oder eine **Gefilterte Ansicht** ist, siehe [Ansichten](/taken/weergaven#twee-soorten-weergaven). Auch das gibt es nur bei gespeicherten Ansichten
- **Erledigt** - wie lange abgeschlossene Aufgaben sichtbar bleiben

<DocScreenshot src="/screenshots/taken/task-view-display-options.png" alt="Das Menü Anzeige mit Layout, Art, Gruppieren, Sortieren und abgeschlossenen Aufgaben" />

Änderungen bleiben ein Vorschlag, bis du sie speicherst, siehe [Änderungen speichern oder verwerfen](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

## Abgeschlossene Aufgaben ausblenden [#voltooide-taken-verbergen]

Bei **Erledigt** im Menü **Anzeige** bestimmst du, wie lange eine abgeschlossene Aufgabe in der Ansicht stehen bleibt:

| Auswahl | Was du siehst |
|---|---|
| **Alle anzeigen** | Alle abgeschlossenen Aufgaben (Standard) |
| **Ausblenden** | Keine abgeschlossenen Aufgaben |
| **Letzter Tag** | Aufgaben, die am letzten Tag abgeschlossen wurden |
| **Letzte Woche** | Aufgaben, die in der letzten Woche abgeschlossen wurden |
| **Letzter Monat** | Aufgaben, die im letzten Monat abgeschlossen wurden |

Gezählt wird ab dem Moment, in dem die Aufgabe auf **Abgeschlossen** gesetzt wurde. Ein Kommentar oder ein neuer Name ändert das nicht. Öffnest du eine Aufgabe wieder, steht sie sofort wieder in der Ansicht. Hat die Ansicht schon einen Statusfilter, der abgeschlossene Aufgaben ausschließt, bleibt dieser Filter bestehen.

## Gruppieren [#groeperen]

| Gruppierung | Ergebnis |
|---|---|
| **Keine Gruppierung** | Alle Aufgaben in einer Liste |
| **Status** | Eine Gruppe pro Status |
| **Priorität** | Eine Gruppe pro Priorität |
| **Zugewiesen an** | Eine Gruppe pro Kollegin oder Kollege |
| **Label** | Eine Gruppe pro Label |
| **Kunde** | Eine Gruppe pro Kunde |
| **Fälligkeit** | Gruppen wie **Überfällig**, **Heute**, **Diese Woche**, **Später** und **Keine Fälligkeit** |
| **Eigene Spalten** | Spalten, die du selbst erstellst, nur bei gespeicherten Ansichten |

Eine Aufgabe mit mehreren zugewiesenen Kolleginnen und Kollegen oder Labels steht in der Gruppe von jedem von ihnen.

## Sortieren [#sorteren]

Du kannst nach **Manuell**, **Fälligkeit**, **Priorität**, **Status**, **Name**, **Erstellt** oder **Aktualisiert** sortieren. Bei **Manuell** bestimmst du die Reihenfolge selbst, indem du Karten verschiebst. Bei den anderen Optionen bestimmt das Feld die Reihenfolge, und Verschieben innerhalb einer Spalte hat keine Wirkung, außer bei eigenen Spalten.

## Tabelle [#tabel]

Die Tabelle zeigt eine Zeile pro Aufgabe. Bei einer Gruppierung bekommst du einen Block pro Gruppe. Unter **Spalten** im Anzeigemenü schaltest du Spalten ein oder aus: **Aufgabe**, **Status**, **Priorität**, **Fälligkeit**, **Ansichten**, **Zugewiesen an**, **Verknüpft** und **Label**. Die Spalte **Verknüpft** zeigt alle Elemente, an denen die Aufgabe hängt. Die Spalte **Aufgabe** bleibt immer sichtbar.

Bei vielen Aufgaben lädt Tillor zuerst einen Teil. Scrolle nach unten oder klicke auf **Mehr laden** für den Rest.

## Board [#bord]

Das Board zeigt jede Gruppe als Spalte, im Kanban-Stil. Klicke oben in einer Spalte auf **Neue Aufgabe**, um dort eine Aufgabe zu erstellen. Sie bekommt automatisch den Wert der Spalte, etwa den Status oder die zugewiesene Kollegin oder den zugewiesenen Kollegen.

Ziehe eine Aufgabenkarte in eine andere Spalte, und die Aufgabe übernimmt den Wert dieser Spalte:

- bei einem Board nach **Status** ändert sich der Status
- bei **Priorität** ändert sich die Priorität
- bei **Zugewiesen an** ändert sich die zugewiesene Kollegin oder der zugewiesene Kollege
- bei **Label** und **Kunde** ändert sich das Label oder der Kunde
- bei **Eigene Spalten** wandert die Aufgabe in diese Spalte

Bei einem Board nach **Fälligkeit** kannst du Karten nicht in eine andere Spalte ziehen, denn dabei müsste ein Fälligkeitsdatum erfunden werden. Passe das Fälligkeitsdatum in der Aufgabe selbst an.

Gibt es in einer Spalte mehr Aufgaben, als angezeigt werden, steht unten **[Anzahl] weitere**. Eine Karte, die blockiert ist oder andere Aufgaben blockiert, zeigt das ebenfalls, zum Beispiel **Blockiert durch 1 Aufgabe**.

### Eigene Spalten [#eigen-kolommen]

Bei **Eigene Spalten** erstellst du die Spalten selbst, etwa *Zu planen*, *Bestellt* und *Fertig*:

1. Wähle in **Anzeige** bei **Gruppieren nach** die Option **Eigene Spalten** (oder wähle sie schon beim Erstellen)
2. Klicke rechts auf dem Board auf **Neue Spalte** und gib der Spalte einen Namen
3. Über das Menü einer Spalte wählst du **Bearbeiten**, um den Namen zu ändern, oder **Löschen**
4. Ziehe Spalten an ihrem Titel, um die Reihenfolge zu ändern

<DocScreenshot src="/screenshots/taken/task-view-own-columns.png" alt="Board mit den eigenen Spalten Zu planen, Bestellt und Fertig, plus Neue Spalte" />

Neue eigene Spalten starten leer. Jede Aufgabe in der Ansicht steht dann zunächst in **Keine Spalte**, bis du sie einteilst. Bei einer Liste kannst du diese Aufgaben mit dem Häkchen **Aufgaben ohne Spalte anzeigen** ausblenden. Bei einer gefilterten Ansicht bleiben sie sichtbar, sonst könntest du sie nie einteilen.

<Callout type="warn">
Wechselst du von **Eigene Spalten** auf eine andere Gruppierung und speicherst das, werden die eigenen Spalten dieser Ansicht gelöscht, samt der Position jeder Aufgabe darin. Das kann nicht rückgängig gemacht werden. Tillor zeigt dazu vorher eine Warnung.
</Callout>

### Aufgaben einer Liste zuweisen [#taken-toewijzen-aan-een-lijst]

Bei einem Board einer Liste erscheint, solange es Aufgaben gibt, die noch nicht darin stehen, die Schaltfläche **Aufgaben zuweisen**. Damit öffnet sich eine zusätzliche Spalte **Nicht in dieser Ansicht** mit den Aufgaben, die zu den Filtern der Ansicht passen, aber noch nicht darin stehen. Suche mit **Aufgaben filtern...** und ziehe eine Aufgabe in eine Spalte, um sie der Ansicht hinzuzufügen. Klicke die Schaltfläche noch einmal an, um die Spalte zu schließen.

## Kalender [#kalender]

Der Kalender zeigt ein Monatsraster mit Aufgaben an ihrem **Fälligkeitsdatum**. Die Woche beginnt am Montag, und die Tage folgen der Zeitzone deiner Organisation. Aufgaben ohne Fälligkeitsdatum stehen nicht im Kalender.

- Mit den Pfeilen gehst du zum vorigen oder nächsten Monat, mit **Heute** springst du zurück zum aktuellen Monat
- Pro Tag siehst du höchstens drei Aufgaben. Klicke auf **+[Anzahl] weitere**, um den Rest des Tages zu sehen
- Klicke auf eine Aufgabe, um die Details zu öffnen
- Ziehe eine Aufgabe auf einen anderen Tag, um das Fälligkeitsdatum zu verschieben. Die Uhrzeit bleibt gleich, nur der Tag ändert sich
- Abgeschlossene Aufgaben sind durchgestrichen, stehen unter den offenen Aufgaben dieses Tages und lassen sich nicht ziehen

Die Gruppierung hat im Kalender keinen Einfluss: Alle Aufgaben stehen im selben Raster.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Deine Änderungen in **Anzeige** sind zunächst ein Vorschlag auf deinem Bildschirm. Erst nach **Ansicht speichern** gelten sie für alle, die die Ansicht sehen.
- Ziehst du eine Karte in eine andere Spalte, passt sich die Aufgabe selbst an. Bei einem Board nach **Status** ändert sich der Status, und Kolleginnen und Kollegen sehen das sofort.
- Eine Karte im Kalender zu ziehen verschiebt das Fälligkeitsdatum auf diesen Tag. Die Uhrzeit bleibt gleich.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich kann keine Karte in eine andere Spalte ziehen">
Bei einem Board nach **Fälligkeit** geht das nicht, denn dabei müsste Tillor ein Fälligkeitsdatum erfinden. Passe das Fälligkeitsdatum in der Aufgabe an. Aufgaben in einem Kalender ziehst du auf einen anderen Tag, außer abgeschlossene Aufgaben.
</Accordion>
<Accordion title="Tillor meldet, dass die Aufgabe nicht verschoben werden konnte">
Du siehst **Aufgabe konnte nicht verschoben werden**. Die Karte springt zurück an die alte Stelle. Versuche es erneut.
</Accordion>
<Accordion title="Die Auswahl Layout oder Art fehlt">
Die gibt es nur bei gespeicherten Ansichten, nicht bei **Alle**.
</Accordion>
<Accordion title="Eine Aufgabe steht nicht im Kalender">
Der Kalender zeigt Aufgaben an ihrem Fälligkeitsdatum. Eine Aufgabe ohne Fälligkeitsdatum steht nicht darin.
</Accordion>
<Accordion title="Meine Aufgaben stehen in Keine Spalte">
Bei neuen eigenen Spalten starten alle Aufgaben in **Keine Spalte**, bis du sie einteilst. Ziehe sie in die richtige Spalte.
</Accordion>
<Accordion title="Meine eigenen Spalten sind weg">
Du bist auf eine andere Gruppierung gewechselt und hast das gespeichert. Dabei löscht Tillor die eigenen Spalten, und das kann nicht rückgängig gemacht werden. Tillor warnt vorher davor.
</Accordion>
</Accordions>


# Überblick (/de-DE/taken)

Mit dem Aufgabensystem behältst du im Blick, was in deinem Park erledigt werden muss und von wem. Eine Aufgabe kann ein Fälligkeitsdatum, eine Erinnerung, eine oder mehrere zugewiesene Kolleginnen, Kollegen oder Gruppen, Labels, Anhänge, Unteraufgaben, aufgewendete Zeit und verknüpfte Kunden, Stellplätze, Rechnungen, Reservierungen, Zähler, Unterhaltungen oder Banktransaktionen haben.

Du siehst Aufgaben über **Ansichten**. Eine Ansicht ist eine gespeicherte Art, deine Aufgaben zu betrachten, zum Beispiel *Offene Aufgaben*, *Meine Aufgaben* oder *Wartung*. Jede Ansicht steht als Tab oben auf der Seite.

## Wo du Aufgaben findest [#waar-vind-je-taken]

- **Aufgaben** im Seitenmenü: die Hauptseite mit allen deinen Ansichten
- **Dashboard**: Die Karte **Aufgaben für dich** zeigt die Aufgaben, die dir zugewiesen sind, oder deine Lieblingsansicht
- **Kunden > [Kunde] > Aufgaben**: alle Aufgaben, die mit einem Kunden verknüpft sind
- **Offene Aufgaben**: ein Block auf der Seite eines Kunden, einer Reservierung, einer Rechnung, eines Stellplatzes und eines Zählers

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Aufgabenseite mit Tabs pro Ansicht und einem Board nach Status" />

Oben stehen die Ansichten als Tabs. Darunter stehen die Suchleiste und die Filter, und rechts die Schaltflächen **Anzeige**, **Folgen** und Teilen. Darunter siehst du die Aufgaben, hier als Board nach Status. Bewege die Maus über die ℹ-Markierungen für Erklärungen.

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Aufgabe ist eine einzelne Sache, und Ansichten sind Arten, Aufgaben zu betrachten. Aufgaben entstehen durch Kolleginnen und Kollegen oder durch Automatisierungen. Eine Automatisierung kann auch auf eine Aufgabe warten.

```mermaid
flowchart LR
  A["Eine Kollegin oder ein Kollege erstellt eine Aufgabe<br/>auf der Aufgabenseite oder aus einem Kunden, einer Rechnung oder einem Zähler"] --> T["Aufgabe"]
  B["Eine Automatisierung erstellt eine Aufgabe<br/>Schritt Aufgabe erstellen, im Namen von Workflow"] --> T
  T --> L["Liste<br/>zeigt nur Aufgaben, die du selbst hinzufügst"]
  T --> G["Gefilterte Ansicht<br/>zeigt jede Aufgabe, die zu den Filtern passt"]
  L --> Z["Die Sichtbarkeit der Ansicht<br/>bestimmt, wer die Aufgabe sieht"]
  T -- "Eine Kollegin oder ein Kollege wählt eine Schaltfläche an der Aufgabe" --> W["Die Automatisierung wartet nicht mehr<br/>und läuft weiter"]
  T -- "Status oder Zuweisung ändert sich" --> S["Eine Automatisierung kann daraufhin starten"]
```

- Setzt du eine Aufgabe in eine Ansicht, ändert sich an der Aufgabe selbst nichts. Nur die Ansicht bekommt sie dazu.
- Eine gefilterte Ansicht nimmt keine Aufgaben heraus: Sie erscheinen oder verschwinden von selbst, je nachdem, ob sie zu den Filtern passen.
- Eine Aufgabe, die eine Automatisierung erstellt, ist eine gewöhnliche Aufgabe. Hat sie Auswahlschaltflächen (Schritt **Um eine Entscheidung bitten**), wartet die Automatisierung, bis jemand eine Schaltfläche wählt. Siehe [Aufgaben mit Auswahlschaltflächen](/taken/taakdetails#taken-met-keuzeknoppen) und [Aufgaben in Automatisierungen](/automatiseringen/acties/taken).

## Schnell loslegen [#snel-aan-de-slag]

1. Öffne **Aufgaben** im Seitenmenü
2. Klicke auf **Neue Ansicht**. Gib einen **Name** ein und wähle bei **Sichtbarkeit**, **Inhalt**, **Spalten** und **Beginnen mit**, was du möchtest. Klicke danach unten im Dialog auf **Neue Ansicht**
3. Klicke oben in einer Spalte auf **Neue Aufgabe**, gib der Aufgabe einen Namen und klicke auf **Erstellen**
4. Klicke auf eine Aufgabe, um die Details zu öffnen: Status, Priorität, Fälligkeitsdatum, zugewiesene Kolleginnen und Kollegen und mehr
5. Hake das Kästchen links von einer Aufgabe ab, sobald sie fertig ist

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Dialog Neue Ansicht mit Name, Sichtbarkeit, Inhalt, Spalten und Startfilter" />

Ohne eigene Ansichten kannst du immer auf die eingebaute Ansicht **Alle** zurückgreifen, die alle Aufgaben zeigt, die du sehen darfst. Filter, die in **Alle** gespeichert sind, gelten für die ganze Organisation.

## Status [#statussen]

| Status | Bedeutung |
|---|---|
| **Ausstehend** | Die Aufgabe ist eingeplant, aber es wurde noch nicht damit begonnen |
| **In Bearbeitung** | Es wird aktiv an der Aufgabe gearbeitet |
| **Wartet auf Antwort** | Du kannst erst weitermachen, wenn jemand anderes, etwa ein Kunde oder Lieferant, etwas getan oder geantwortet hat |
| **Abgeschlossen** | Die Aufgabe ist erledigt |

So sieht dieselbe Art Aufgabe vor und nach dem Abhaken aus. Oben steht eine offene Aufgabe, darunter eine abgeschlossene: Der Titel ist durchgestrichen und der Status ist **Abgeschlossen**.

<DocScreenshot src="/screenshots/taken/task-card-open.png" alt="Vorher: eine offene Aufgabe mit dem Status In Bearbeitung" />

<DocScreenshot src="/screenshots/taken/task-card-done.png" alt="Nachher: eine abgeschlossene Aufgabe mit durchgestrichenem Titel und dem Status Abgeschlossen" />

Eine abgeschlossene Aufgabe rutscht in einer manuell sortierten Liste oder Spalte nach unten. Setzt du eine übergeordnete Aufgabe auf **Abgeschlossen**, werden auch die offenen Unteraufgaben abgeschlossen. Öffnest du die Aufgabe danach wieder, bleiben die Unteraufgaben abgeschlossen.

Eine Ansicht kann abgeschlossene Aufgaben nach einiger Zeit ausblenden, siehe [Abgeschlossene Aufgaben ausblenden](/taken/indelingen#voltooide-taken-verbergen).

## Prioritäten [#prioriteiten]

Eine Aufgabe hat die Priorität **Niedrig**, **Mittel**, **Hoch** oder **Dringend**.

## Bestandteile [#onderdelen]

<Cards>
  <Card
    title="Ansichten"
    href="/taken/weergaven"
    description="Listen und gefilterte Ansichten erstellen, teilen, duplizieren und folgen"
  />
  <Card
    title="Tabelle, Board und Kalender"
    href="/taken/indelingen"
    description="Wähle, wie deine Aufgaben angezeigt werden, gruppiere und sortiere"
  />
  <Card
    title="Filtern"
    href="/taken/filteren"
    description="Aufgaben nach Status, Fälligkeit, Kunde, verknüpftem Element und mehr finden"
  />
  <Card
    title="Aufgabendetails"
    href="/taken/taakdetails"
    description="Alles, was du in einer Aufgabe festhalten kannst, von Unteraufgaben und aufgewendeter Zeit bis zum Drucken"
  />
  <Card
    title="Private Aufgaben"
    href="/taken/prive-taken"
    description="Wer eine Aufgabe sieht, hängt von den Ansichten ab, in denen sie steht"
  />
  <Card
    title="Labels"
    href="/taken/labels"
    description="Labels verwalten und automatisch eine Fälligkeit setzen lassen"
  />
  <Card
    title="Benachrichtigungen"
    href="/taken/meldingen"
    description="Erinnerungen, Fälligkeiten und die tägliche Zusammenfassung einer Ansicht"
  />
  <Card
    title="Aufgaben teilen"
    href="/taken/delen"
    description="Eine schreibgeschützte Seite oder ein Kalenderabo erstellen"
  />
  <Card
    title="Aufgaben auf anderen Seiten"
    href="/taken/taken-op-andere-paginas"
    description="Aufgaben aus Kunden, Rechnungen, Unterhaltungen und mehr erstellen"
  />
</Cards>

<Callout type="info" title="Gut zu wissen">
- Es gibt keine eigenen Berechtigungen für Aufgaben. Wer in Tillor arbeitet, kann Aufgaben erstellen und bearbeiten. Welche Aufgaben du zu sehen bekommst, hängt von den Ansichten ab, in denen sie stehen. Siehe [Private Aufgaben](/taken/prive-taken)
- Eine neue Aufgabe kann bis zu 50 Unteraufgaben bekommen. Unteraufgaben haben nur eine Ebene
- Setzt du eine Aufgabe auf **Abgeschlossen**, werden die offenen Unteraufgaben ebenfalls abgeschlossen
- Wer einer Ansicht folgt, bekommt jeden Morgen um 07:00 Uhr eine Zusammenfassung, mit höchstens 15 Aufgaben pro Liste
- Ein laufender Timer pausiert nach zehn Minuten ohne Maus oder Tastatur
- Ein Label mit einem **Fristziel (Tage)** gibt Aufgaben ohne Fälligkeitsdatum automatisch ein Fälligkeitsdatum
- Eine Aufgabe, die du löschst, kannst du nicht wiederherstellen
</Callout>

## Begriffe [#begrippen]

- **Aufgabe**: eine Arbeit, die du verfolgst, mit Status, Priorität, Fälligkeitsdatum und gegebenenfalls zugewiesenen Kolleginnen und Kollegen
- **Ansicht**: ein Tab auf der Aufgabenseite mit einer eigenen Art, Aufgaben zu zeigen, siehe [Ansichten](/taken/weergaven)
- **Liste**: eine Ansicht, die nur Aufgaben zeigt, die du selbst hinzufügst
- **Gefilterte Ansicht**: eine Ansicht, die jede Aufgabe zeigt, die zu den Filtern passt
- **Unteraufgabe**: ein Teil einer Aufgabe, als Checkliste
- **Blockade**: eine Aufgabe, die zuerst fertig sein muss, bevor eine andere starten kann
- **Workflow**: der Benutzer, in dessen Namen eine [Automatisierung](/begrippen#automatisering) Aufgaben erstellt

Weitere Begriffe stehen im [Glossar](/begrippen).


# Labels (/de-DE/taken/labels)

Mit Labels gibst du Aufgaben eine Kategorie, zum Beispiel *Wartung*, *Beschwerden* oder *Saison*. Du kannst nach Labels filtern und gruppieren. Ein Label hat einen Namen, eine Farbe und optional eine Beschreibung.

## Labels verwalten [#labels-beheren]

Gehe zu <UIPath>Einstellungen > Aufgabenlabels</UIPath>. Du siehst diese Seite, wenn du die allgemeinen Einstellungen deiner Organisation ansehen oder bearbeiten darfst. Die Übersicht hat die Spalten **Label**, **Beschreibung** und **Aufgaben** (die Anzahl der Aufgaben mit diesem Label).

<DocScreenshot src="/screenshots/taken/task-labels-settings.png" alt="Einstellungen, Seite Aufgabenlabels mit den Labels Verwaltung, Wartung und Rezeption" />

- **Neues Label** erstellt ein Label mit einem **Name**, einer **Beschreibung**, einer **Farbe** und optional einem **Fristziel (Tage)**
- **Label bearbeiten** ändert diese Angaben später
- **Label löschen** entfernt das Label und zeigt vorher, auf wie vielen Aufgaben es steht. Das Label verschwindet von all diesen Aufgaben

Du kannst ein Label auch erstellen, während du eine Aufgabe bearbeitest: Tippe den Namen in das Feld **Labels** und wähle **[Name] erstellen**.

## Eine Fälligkeit automatisch setzen [#een-deadline-automatisch-instellen]

<DocScreenshot src="/screenshots/taken/task-label-dialog.png" alt="Dialog Label erstellen mit Name, Beschreibung, Farbe und Fristziel" />

Bei einem Label kannst du das **Fristziel (Tage)** ausfüllen, zum Beispiel *7*. Eine Aufgabe ohne Fälligkeitsdatum, die dieses Label bekommt, erhält dann selbst ein Fälligkeitsdatum: so viele Tage später, gerechnet ab dem Moment, in dem die Aufgabe erstellt oder das Label hinzugefügt wurde.

- Das geschieht beim Erstellen einer Aufgabe mit dem Label oder wenn du das Label später hinzufügst
- Hat die Aufgabe schon ein Fälligkeitsdatum, bleibt es, wie es ist
- Hat eine Aufgabe mehrere Labels mit einem Ziel, gilt die kürzeste Anzahl Tage
- Lässt du das Feld leer, setzt das Label keine Fälligkeit

Das ist praktisch für Labels wie *Beschwerde* (innerhalb von 2 Tagen) oder *Angebot nachverfolgen* (innerhalb von 7 Tagen).

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein neues Label kannst du sofort Aufgaben geben, in der Aufgabe selbst und im Schnellmenü.
- Ein Label mit einem **Fristziel (Tage)** gibt Aufgaben ohne Fälligkeitsdatum ab diesem Moment automatisch ein Fälligkeitsdatum.
- Löschst du ein Label, verschwindet es von allen Aufgaben, auf denen es stand. Die Aufgaben bleiben bestehen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe die Seite Aufgabenlabels nicht">
Du darfst die allgemeinen Einstellungen deiner Organisation nicht ansehen. Bitte eine Administratorin oder einen Administrator, deine Berechtigungen anzupassen.
</Accordion>
<Accordion title="Tillor meldet Label konnte nicht erstellt werden">
Gib einen **Name** ein (höchstens 50 Zeichen) und versuche es erneut. Beim Bearbeiten und Löschen lauten die Meldungen **Label konnte nicht aktualisiert werden** und **Label konnte nicht gelöscht werden**.
</Accordion>
<Accordion title="Meine Aufgabe hat vom Label keine Fälligkeit bekommen">
Ein Fälligkeitsdatum vom Label kommt nur auf Aufgaben ohne Fälligkeitsdatum. Hat die Aufgabe schon eins, bleibt es bestehen. Bei mehreren Labels mit einem Ziel gilt die kürzeste Anzahl Tage.
</Accordion>
</Accordions>


# Benachrichtigungen (/de-DE/taken/meldingen)

Tillor hält dich über Aufgaben per E-Mail und Push-Benachrichtigungen auf dem Laufenden.

## Erinnerungen und Fälligkeiten [#herinneringen-en-deadlines]

Hat eine Aufgabe eine **Erinnerung** oder ein **Fälligkeitsdatum**, wählst du im Detailfenster bei **Benachrichtigungen**, ob du **E-Mail** und/oder **Push-Benachrichtigung** möchtest. Beide sind standardmäßig an. Schaltest du beide aus, bekommt niemand eine Benachrichtigung für diese Aufgabe.

- Eine Erinnerung wird zum eingestellten Zeitpunkt ausgelöst, mit dem Titel *Aufgaben-Erinnerung*
- Eine Fälligkeitsbenachrichtigung wird ausgelöst, sobald das Fälligkeitsdatum erreicht ist und die Aufgabe noch nicht abgeschlossen ist
- Abgeschlossene Aufgaben lösen keine Erinnerung oder Fälligkeitsbenachrichtigung mehr aus
- Eine wiederkehrende Erinnerung wird bei jeder Wiederholung ausgelöst, bis die Aufgabe abgeschlossen ist oder der Zeitplan endet

Die Benachrichtigung geht an die zugewiesenen Kolleginnen und Kollegen, auch an die Mitglieder einer zugewiesenen Gruppe. Ist niemand zugewiesen, geht sie an die Person, die die Aufgabe erstellt hat. Die E-Mail zeigt eine Vorschau der Aufgabe, mit dem Status und einer Schaltfläche, um sie zu öffnen.

## Zuweisen, entziehen und abschließen [#toewijzen-ontkoppelen-en-voltooien]

- Wird dir eine Aufgabe zugewiesen, auch über eine Gruppe, in der du bist, bekommst du eine Benachrichtigung (**Neue Aufgabe zugewiesen**). Weist du dir selbst eine Aufgabe zu, bekommst du keine Benachrichtigung
- Nimmt dich jemand von einer Aufgabe herunter, bekommst du eine Benachrichtigung, dass dir die Aufgabe entzogen wurde (**Aufgabe entzogen**)
- Wird eine Aufgabe abgeschlossen, bekommen die zugewiesenen Kolleginnen und Kollegen und die Person, die sie erstellt hat, eine Benachrichtigung, außer der Person, die die Aufgabe abgeschlossen hat. Die Benachrichtigung wird etwa eine Minute verzögert verschickt. Öffnet jemand die Aufgabe innerhalb dieser Zeit wieder, wird sie nicht mehr verschickt

## Eine Ansicht folgen [#een-weergave-volgen]

Mit **Folgen** (oben rechts bei einer gespeicherten Ansicht) bekommst du jeden Morgen um 07:00 Uhr eine E-Mail mit einer Zusammenfassung dieser Ansicht. Die E-Mail hat den Betreff *Tägliche Zusammenfassung* mit dem Namen der Ansicht und enthält drei Listen:

- **Überfällig** - offene Aufgaben, deren Fälligkeitsdatum verstrichen ist
- **Heute fällig** - offene Aufgaben, die heute fertig sein müssen
- **Seit der letzten Zusammenfassung geändert** - offene Aufgaben, die seit deiner letzten Zusammenfassung angepasst wurden

Jede Liste zeigt höchstens 15 Aufgaben mit dem Fälligkeitsdatum. Unten steht die Schaltfläche **Ansicht öffnen**, die direkt zur Ansicht springt.

- Steht in allen drei Listen nichts, bekommst du an diesem Tag keine E-Mail
- Die Schaltfläche ändert sich in **Gefolgt**. Klicke darauf, um nicht mehr zu folgen. Du kannst jede Ansicht folgen, die du sehen kannst, auch die Ansichten von Kolleginnen und Kollegen
- Verlierst du den Zugriff auf die Ansicht, etwa weil die Eigentümerin oder der Eigentümer sie nur für sich selbst macht oder löschst, folgst du automatisch nicht mehr
- Du siehst nur Aufgaben, die du selbst auch sehen darfst

<Callout type="info">
Der eingebauten Ansicht **Alle** kannst du nicht folgen, weil sie keine gespeicherte Ansicht ist.
</Callout>

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich bekomme keine Erinnerung oder Fälligkeitsbenachrichtigung">
Prüfe in der Aufgabe bei **Benachrichtigungen**, ob **E-Mail** oder **Push-Benachrichtigung** an ist. Eine Benachrichtigung geht an die zugewiesenen Kolleginnen und Kollegen, oder an die Person, die die Aufgabe erstellt hat, wenn niemand zugewiesen ist. Abgeschlossene Aufgaben lösen keine Benachrichtigung mehr aus.
</Accordion>
<Accordion title="Ich bekomme keine Benachrichtigung, wenn ich mir selbst eine Aufgabe zuweise">
Das stimmt. Eine Benachrichtigung **Neue Aufgabe zugewiesen** bekommst du nur, wenn jemand anderes dir die Aufgabe zuweist.
</Accordion>
<Accordion title="Ich bekomme die tägliche Zusammenfassung nicht">
Du folgst der Ansicht nicht (die Schaltfläche **Folgen** muss **Gefolgt** zeigen), oder es steht nichts in **Überfällig**, **Heute fällig** und **Seit der letzten Zusammenfassung geändert**. Dann schicken wir an diesem Tag keine E-Mail. Du folgst auch automatisch nicht mehr, wenn du die Ansicht nicht mehr sehen darfst.
</Accordion>
<Accordion title="Tillor meldet Folgen konnte nicht aktualisiert werden">
Die Änderung wurde nicht gespeichert. Klicke erneut auf **Folgen**.
</Accordion>
</Accordions>


# Private Aufgaben (/de-DE/taken/prive-taken)

Eine Aufgabe ist privat, wenn sie nur in persönlichen Ansichten steht. Du musst dafür nichts einstellen: Die Ansichten, in denen eine Aufgabe steht, bestimmen, wer sie sieht.

## Die Regeln [#de-regels]

| Wo steht die Aufgabe | Wer sieht sie |
|---|---|
| In keiner Ansicht | Alle Benutzer der Organisation |
| In mindestens einer Ansicht, die **Öffentlich** ist | Alle Benutzer der Organisation |
| Nur in persönlichen Ansichten (**Nur Sie** oder **Geteilt**) | Die Person, die die Aufgabe erstellt hat, die zugewiesenen Kolleginnen, Kollegen und Gruppen sowie die Eigentümerin oder der Eigentümer und die gewählten Personen und Gruppen dieser Ansichten |

Unteraufgaben folgen ihrer übergeordneten Aufgabe. Eine Aufgabe, die du nicht sehen darfst, erscheint nirgends: nicht in Listen, Suchergebnissen, Filtern, im Dashboard, bei einem Kunden, im Kalender oder in Benachrichtigungen, und du kannst sie auch nicht über einen Link öffnen.

## Beispiel [#voorbeeld]

Jan erstellt die persönliche Ansicht *Meine Ideen* mit der Sichtbarkeit **Nur Sie**. Er fügt die Aufgabe *Angebot für neue Schranke anfragen* zu dieser Liste hinzu.

- Nur Jan sieht die Aufgabe. Seine Kolleginnen und Kollegen sehen sie nirgends
- Jan weist die Aufgabe Piet zu. Jetzt sieht Piet die Aufgabe auch, obwohl er die Ansicht von Jan nie gesehen hat
- Jan teilt *Meine Ideen* mit Els (**Geteilt**). Jetzt sieht Els die Aufgabe auch
- Jan fügt die Aufgabe der Ansicht *Wartung* hinzu, die **Öffentlich** ist. Ab jetzt sieht das ganze Team die Aufgabe
- Nimmt Jan die Aufgabe wieder aus *Wartung* heraus und steht sie sonst in keiner öffentlichen Ansicht, ist sie wieder privat

Hätte Jan die Aufgabe in keine Ansicht gestellt, hätten alle sie gesehen.

## Wer die Sichtbarkeit einer Ansicht bestimmt [#wie-bepaalt-de-zichtbaarheid-van-een-weergave]

Nur die Eigentümerin oder der Eigentümer einer persönlichen Ansicht kann ändern, mit wem die Ansicht geteilt ist, oder sie **Öffentlich** machen. Eine Kollegin oder ein Kollege, mit der oder dem du die Ansicht teilst, kann Aufgaben in der Ansicht bearbeiten, aber weder die Sichtbarkeit ändern noch die Ansicht löschen. Siehe [Ansichten](/taken/weergaven#wie-ziet-een-weergave).

<Callout type="warn">
Eine private Aufgabe zu einer öffentlichen Ansicht hinzuzufügen macht sie für alle sichtbar. Tillor bittet dich, das zuerst mit **Diese Aufgabe öffentlich machen?** zu bestätigen. Du kannst dann **Privat lassen** oder **Öffentlich machen** wählen. Dieselbe Frage erscheint, wenn du die Aufgabe aus ihrer letzten öffentlichen Ansicht herausnimmst. Machst du eine persönliche Ansicht, die Aufgaben enthält, **Öffentlich**, werden diese Aufgaben ohne gesonderte Frage für alle sichtbar.
</Callout>

## Tipps [#tips]

- Möchtest du eine private Aufgabe übergeben, weise sie einer Kollegin oder einem Kollegen zu oder teile die Ansicht mit dieser Person
- Eine Aufgabe zählt als „in einer Ansicht“, sobald du sie zu einer Liste hinzufügst oder in eine eigene Spalte der Ansicht setzt. Sie nur über einen Filter anzuzeigen sorgt nicht dafür, dass sie in der Ansicht steht
- Benachrichtigungen über eine private Aufgabe, etwa zu einem Fälligkeitsdatum, gehen nur an Personen, die die Aufgabe sehen dürfen

## Probleme? [#problemen]

<Accordions>
<Accordion title="Eine Kollegin oder ein Kollege sieht meine Aufgabe nicht">
Die Aufgabe steht nur in persönlichen Ansichten. Weise sie der Kollegin oder dem Kollegen zu, teile die Ansicht mit ihr oder ihm, oder setze die Aufgabe in eine öffentliche Ansicht.
</Accordion>
<Accordion title="Tillor fragt Diese Aufgabe öffentlich machen?">
Du fügst eine private Aufgabe zu einer öffentlichen Ansicht hinzu oder nimmst sie aus ihrer letzten öffentlichen Ansicht heraus. Wähle **Privat lassen** oder **Öffentlich machen**.
</Accordion>
<Accordion title="Ich sehe eine Aufgabe nicht mehr, die ich gestern noch hatte">
Vielleicht ist die Aufgabe mit einer anderen Ansicht verknüpft, oder die Ansicht, in der sie stand, ist für dich nicht mehr sichtbar. Frage die Person, die die Aufgabe erstellt hat, oder die Eigentümerin oder den Eigentümer der Ansicht.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Ansichten" href="/taken/weergaven" />
  <Card title="Aufgabendetails" href="/taken/taakdetails" />
</Cards>


# Aufgabendetails (/de-DE/taken/taakdetails)

Im Detailfenster einer Aufgabe hältst du alles fest: wer sie erledigt, bis wann sie fertig sein muss, wie viel Zeit darin steckt und womit sie verknüpft ist. Klicke auf eine Aufgabe, um das Fenster zu öffnen. Links stehen der Name, die Beschreibung und Bestandteile wie Unteraufgaben und Kommentare. Rechts stehen die Eigenschaften wie Status, Priorität und Fälligkeit. Änderungen an einer bestehenden Aufgabe werden sofort gespeichert. Nur die Beschreibung speicherst du selbst mit **Speichern**.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Aufgabenfenster mit Beschreibung, Unteraufgaben, Kommentaren und rechts den Eigenschaften, eigenen Feldern, verknüpften Elementen und Anhängen" />

Du kannst eine Aufgabe auch direkt über einen Link öffnen. Kopiere ihn über das Menü mit den drei Punkten oben rechts im Fenster, siehe [Das Menü der Aufgabe](#het-menu-van-de-taak).

## Eine Aufgabe erstellen [#een-taak-aanmaken]

Aufgaben erstellst du an verschiedenen Stellen: oben in einer Spalte eines Boards (**Neue Aufgabe**), in der Karte **Aufgaben für dich** auf dem Dashboard, auf der Kundenseite oder aus einer Unterhaltung, Rechnung oder einem anderen Element heraus, siehe [Aufgaben auf anderen Seiten](/taken/taken-op-andere-paginas).

1. Klicke auf **Neue Aufgabe**
2. Gib einen **Name** ein. Alles andere ist optional
3. Füge bei Bedarf Unteraufgaben bei **Unteraufgabe hinzufügen** hinzu: Tippe einen Namen und drücke die Eingabetaste. Du kannst bis zu 50 mitgeben
4. Klicke auf **Erstellen**, oder drücke Cmd oder Strg zusammen mit der Eingabetaste

<DocScreenshot src="/screenshots/taken/task-create-dialog.png" alt="Dialog Neue Aufgabe mit einem Namen und zwei Unteraufgaben" />

Oben im Fenster steht die Ansicht, in der die Aufgabe landet. Erstellst du die Aufgabe aus einer Spalte eines Boards, bekommt sie automatisch diese Ansicht und Spalte. Du kannst eine andere wählen oder die Ansicht entfernen.

Du bist selbst als zugewiesene Person eingetragen. Entfernst du dich und wählst niemanden, hat die Aufgabe keine zugewiesene Person. Blockaden und aufgewendete Zeit fügst du hinzu, nachdem die Aufgabe erstellt wurde.

## Eigenschaften [#eigenschappen]

- **Status** und **Priorität** - siehe die [Übersicht](/taken#statussen)
- **Zugewiesen an** - ein oder mehrere Kolleginnen und Kollegen oder [Gruppen](/gebruikers/groepen). Suche mit **Personen oder Gruppen suchen...**. Weist du eine Gruppe zu, gilt die Aufgabe für alle, die in diesem Moment in der Gruppe sind
- **Kunden** - verknüpfe einen oder mehrere Kunden mit **Kunden hinzufügen**
- **Labels** - siehe [Labels](/taken/labels). Ein fehlendes Label legst du direkt an, indem du den Namen tippst und **[Name] erstellen** wählst
- **Fälligkeitsdatum** - das späteste Datum, mit Uhrzeit. Ist die Fälligkeit überschritten, wird die relative Zeit rot
- **Erinnerung** - ein Datum und eine Uhrzeit, zu der du eine Benachrichtigung möchtest, auf Wunsch wiederkehrend
- **Benachrichtigungen** - sobald eine Erinnerung oder Fälligkeit gesetzt ist, wählst du, ob du eine **E-Mail** und/oder **Push-Benachrichtigung** möchtest. Beide sind standardmäßig an
- **Erstellt von** - wer die Aufgabe angelegt hat
- **Eigene Felder** - Felder, die deine Organisation selbst zu Aufgaben hinzugefügt hat. Änderungen werden sofort gespeichert. Siehe [Eigene Felder](/eigen-velden)
- **Ansicht** - klicke links oben auf den Namen der Ansicht, um zu wählen, in welchen Listen die Aufgabe steht und in welcher Spalte. Bei einer gefilterten Ansicht wählst du nur eine Spalte
- **Privat** - steht dort ein Schloss mit **Privat**, erscheint die Aufgabe nur in persönlichen Ansichten, siehe [Private Aufgaben](/taken/prive-taken)

Eine Aufgabe kann außerdem eine **Beschreibung** haben. Sie unterstützt Markdown für die Formatierung.

## Wiederkehrende Erinnerungen [#herhalende-herinneringen]

Eine Erinnerung kann sich wiederholen, bis die Aufgabe abgeschlossen ist:

1. Setze zuerst eine **Erinnerung** (Datum und Uhrzeit)
2. Klicke auf das Wiederholungsfeld darunter (standardmäßig **Wird nicht wiederholt**)
3. Wähle **Täglich**, **Jeden Werktag (Mo – Fr)**, **Wöchentlich**, **Monatlich**, **Jährlich** oder **Benutzerdefiniert…**

Mit **Benutzerdefiniert…** stellst du einen eigenen Zeitplan zusammen:

- **Wiederholen alle** - eine Anzahl Tage, Wochen, Monate oder Jahre
- **Wiederholen am** - bei einem wöchentlichen Zeitplan die Wochentage, an denen die Erinnerung kommen darf
- **Endet** - **Nie**, **Am Datum** oder **Nach** einer Anzahl Wiederholungen

Fällt eine Erinnerung auf einen Tag, den du ausgeschlossen hast, rückt sie ohne Benachrichtigung auf den nächsten erlaubten Tag vor. Die Wiederholung endet, sobald die Aufgabe auf **Abgeschlossen** steht oder der Zeitplan abläuft.

## Verknüpfte Elemente [#gekoppelde-items]

Unter **Verknüpfte Elemente** siehst du, woran die Aufgabe hängt. Du kannst von jeder Art mehrere verknüpfen: Parzellen, Rechnungen, Reservierungen, Zähler, Telefonanrufe, Banktransaktionen, Produkte und Unterhaltungen aus der Inbox. Eine Aufgabe kann auch mit einem Kommentar verknüpft sein. Eine Aufgabe zu einer Banktransaktion erstellst du über das Menü der Transaktion unter **Banktransaktionen** mit **Aufgabe erstellen**. Eine Aufgabe zu einem Produkt, zum Beispiel das Prüfen des Sachkontos, erstellst du auf der Produktseite über das Menü **⋯** mit **Aufgabe erstellen**; die offenen Aufgaben des Produkts stehen oben auf dieser Seite.

Ein weiteres Element verknüpfst du mit dem Plus bei **Verknüpfte Elemente** (Tooltip **Element verknüpfen**). Suche nach einem Kunden, einer Parzelle, einem Zähler, einer Rechnung, einer Reservierung oder einem Produkt. Gehört das gewählte Element zu einem Kunden, fragt Tillor **[Kunde] auch verknüpfen?**:

- **Beide verknüpfen** - die Aufgabe erscheint auch beim Kunden
- **Nur diesen Eintrag** - der Kunde wird nicht mit der Aufgabe verknüpft

Mit **Verknüpfung aufheben** entfernst du eine Verknüpfung wieder. Verknüpfte Aufgaben, die noch offen sind, erscheinen auf der Seite des Elements unter **Offene Aufgaben**.

## Anhänge [#bijlagen]

Unter **Anhänge** fügst du der Aufgabe Dateien hinzu. Klicke auf das Plus, oder füge eine Datei mit Cmd oder Strg und V irgendwo im Fenster ein.

## Unteraufgaben [#subtaken]

Eine Aufgabe kann Unteraufgaben haben, eine Checkliste im Detailfenster. Es gibt nur eine Ebene: Eine Unteraufgabe kann selbst keine Unteraufgaben haben.

1. Öffne die übergeordnete Aufgabe, oder fülle sie schon beim Erstellen einer Aufgabe aus
2. Tippe bei **Unteraufgabe hinzufügen** einen Namen und drücke die Eingabetaste
3. Hake eine Unteraufgabe ab, um sie auf **Abgeschlossen** zu setzen. Hake sie erneut an, um sie zurückzusetzen
4. Klicke auf den Namen, um sie umzubenennen, oder auf den Papierkorb, um sie zu löschen
5. Ziehe eine Unteraufgabe am Griff, um die Reihenfolge zu ändern. Mit **Beschreibung hinzufügen** gibst du einer Unteraufgabe auch eine Beschreibung

Bei einer neuen Aufgabe werden die Unteraufgaben zusammen mit der Aufgabe erstellt, in der Reihenfolge, in der du sie eingegeben hast. Unteraufgaben erscheinen nicht als eigene Karte auf Boards, in Tabellen oder im Kalender. Auf der Aufgabe siehst du einen Zähler wie **2/5**. Setzt du die übergeordnete Aufgabe auf **Abgeschlossen**, werden alle offenen Unteraufgaben mit abgeschlossen. Umgekehrt ist das nicht nötig: Du kannst die übergeordnete Aufgabe abschließen, während noch Unteraufgaben offen sind.

## Blockaden und Abhängigkeiten [#blokkades-en-afhankelijkheden]

Manchmal kann eine Aufgabe erst starten oder abgeschlossen werden, wenn eine andere fertig ist. Im Detailfenster hältst du das fest:

- **Blockiert durch** - Aufgaben, die zuerst fertig sein müssen. Füge sie mit **Blockierende Aufgabe hinzufügen** hinzu
- **Blockiert andere Aufgaben** - Aufgaben, die auf diese Aufgabe warten. Füge sie mit **Blockierte Aufgabe hinzufügen** hinzu

Bei jeder Gruppe siehst du, wie viele Aufgaben noch offen sind (zum Beispiel **2 noch offen**). Suche Aufgaben mit **Aufgaben suchen...** und entferne eine Verknüpfung mit **Verknüpfung entfernen**. Auf der Aufgabenkarte steht unter dem Namen eine Zeile wie **Blockiert durch 1 Aufgabe**. Du kannst nach blockierten Aufgaben filtern, siehe [Filtern](/taken/filteren).

Eine Blockade hält dich nicht auf. Versuchst du, eine blockierte Aufgabe abzuhaken, fragt Tillor **Blockierte Aufgabe abschließen?** und schließt sie erst ab, wenn du **Trotzdem abschließen** wählst.

Eine Blockade fügst du auch über das Menü mit den drei Punkten oben rechts im Fenster hinzu, mit **Blockierende Aufgabe hinzufügen** und **Blockierte Aufgabe hinzufügen**.

## Aufgewendete Zeit [#bestede-tijd]

Neben **Aufgewendete Zeit** im Detailfenster steht die Gesamtzeit. Klicke darauf, um Zeit zu erfassen.

<DocScreenshot src="/screenshots/taken/task-time-popover.png" alt="Aufgewendete Zeit mit der Schaltfläche Starten, einem Eingabefeld für eine manuelle Erfassung und den Einträgen der Kolleginnen und Kollegen" />

Du hast zwei Möglichkeiten:

- Einen **Timer**. Klicke auf **Starten**, arbeite an der Aufgabe und klicke auf die Stopp-Schaltfläche, wenn du fertig bist. Die Zeit wird mit den Sekunden auf die Aufgabe gebucht
- **Nachträglich eintragen**. Gib die Dauer ein, zum Beispiel **1:30**, **90** (Minuten), **1u 30m** oder **1.5h**. Alle vier bedeuten anderthalb Stunden. Füge bei Bedarf eine Notiz bei **Was hast du gemacht? (optional)** hinzu und klicke auf **Erfassen**

Die Zeit wird für den heutigen Tag erfasst. In der Liste siehst du pro Eintrag, wer sie erfasst hat, das Datum, die Notiz und die Dauer. Kolleginnen und Kollegen sehen gegenseitig ihre Einträge, aber du kannst nur deine eigenen Einträge löschen, über den Papierkorb, der erscheint, wenn du mit der Maus über die Zeile fährst.

### Der Timer [#de-timer]

- Ein laufender Timer läuft weiter, wenn du zu einer anderen Seite gehst. Er erscheint dann als kleine Karte unten rechts, mit Schaltflächen zum Pausieren (**Pausieren**), Fortsetzen (**Fortsetzen**), **Zwischenstand** und Beenden (**Beenden**). Klicke auf den Namen der Aufgabe, um zurückzukehren
- Mit **Zwischenstand** speicherst du den Abschnitt bis jetzt, mit einer kurzen Notiz dazu, woran du gearbeitet hast, und der Timer läuft danach weiter
- Du kannst nur bei einer Aufgabe gleichzeitig Zeit erfassen. Solange dein Timer läuft, ist **Starten** bei anderen Aufgaben ausgegraut
- Benutzt du zehn Minuten lang weder Maus noch Tastatur, pausiert der Timer zum letzten Zeitpunkt, an dem du aktiv warst
- Kolleginnen und Kollegen sehen im Fenster der Aufgabe, dass du arbeitest (**Läuft**) oder pausierst (**Pausiert**). Diese Zeit zählt erst zur Gesamtzeit, sobald sie gespeichert ist

## Kommentare und Aktivität [#opmerkingen-en-activiteit]

Unten im Fenster steht der Bereich **Kommentare**. Mit **Kommentar hinzufügen** schreibst du einen Kommentar. Du kannst Kolleginnen und Kollegen in einem Kommentar erwähnen, damit sie eine Benachrichtigung bekommen. Darunter steht die **Aktivität**: eine Zeitleiste mit dem Erstellen und den Änderungen, bei einer Änderung mit dem Stand davor und danach.

## Das Menü der Aufgabe [#het-menu-van-de-taak]

Oben rechts im Fenster steht ein Menü mit drei Punkten.

<DocScreenshot src="/screenshots/taken/task-dialog-menu.png" alt="Menü der Aufgabe mit Blockaden hinzufügen, Drucken, Link kopieren und Löschen" />

- **Blockierende Aufgabe hinzufügen** und **Blockierte Aufgabe hinzufügen** legen eine Abhängigkeit fest
- **Drucken** hat drei Möglichkeiten. **Drucken (A4)** öffnet den Druckdialog deines Browsers mit einer PDF der Aufgabe. **An A4-Drucker senden** und **An Thermodrucker senden (POS)** schicken die Aufgabe an deinen Drucker, zum Beispiel einen Bondrucker. Diese beiden kannst du nur wählen, wenn deine Organisation einen [Connector](/connector) mit Drucker hat, siehe [Drucker](/printer)
- **Link kopieren** kopiert einen Link, der die Aufgabe direkt öffnet. Wer den Link öffnet, muss die Aufgabe sehen dürfen
- **Löschen** steht ganz unten, siehe [Eine Aufgabe löschen](#een-taak-verwijderen)

Der Ausdruck zeigt Name, Status, Priorität, Fälligkeit und Beschreibung, und unter **Verknüpfte Elemente** die Kunden, Rechnungen, Reservierungen, Parzellen und Zähler, an denen die Aufgabe hängt. Hat die Aufgabe Blockaden, stehen auch die Aufgaben dabei, die sie blockieren, und die Aufgaben, die sie selbst blockiert. Eine Gruppe ohne Elemente wird weggelassen.

## Aufgaben mit Auswahlschaltflächen [#taken-met-keuzeknoppen]

Manche Aufgaben, zum Beispiel aus einer [Automatisierung mit dem Schritt Um eine Entscheidung bitten](/automatiseringen/logica#vraag-om-een-beslissing), verlangen eine Entscheidung. Statt eines Häkchens stehen Schaltflächen an der Aufgabe, darüber **Wähle eine Aktion, um diese Aufgabe abzuschließen**. Du klickst auf eine Schaltfläche, und die Aufgabe ist abgeschlossen.

- Verlangt die Auswahl eine Begründung, öffnet Tillor zuerst ein Fenster mit **Warum diese Wahl?**, in dem du eine Notiz eingibst
- Verlangt die Auswahl eine Bestätigung, zeigt Tillor zuerst ein Fenster. Eine getroffene Auswahl kannst du von der Aufgabe aus nicht mehr rückgängig machen
- Danach steht an der Aufgabe, welche Auswahl getroffen wurde und von wem
- Wählen kann, wer der Aufgabe zugewiesen ist, und ein Administrator. Ist niemand zugewiesen, kann jeder wählen, der die Aufgabe sieht

So hängen Aufgabe und Automatisierung zusammen:

```mermaid
flowchart TD
  A["Die Automatisierung erreicht den Schritt<br/>Um eine Entscheidung bitten"] --> B["Tillor erstellt eine Aufgabe mit deinen Schaltflächen<br/>und die Automatisierung wartet"]
  B --> C{"Ein Kollege wählt eine Schaltfläche"}
  C -- "Eine Option" --> D["Die Aufgabe steht auf Abgeschlossen<br/>die Automatisierung läuft über diese Option weiter"]
  C -- "Niemand wählt innerhalb der Wartezeit" --> E["Die Automatisierung läuft über Abgelaufen weiter<br/>die Aufgabe bleibt bestehen"]
  C -- "Die Aufgabe wird gelöscht" --> E
```

Eine Aufgabe, die von einer Automatisierung erstellt wurde und nur vom Flow abgeschlossen werden kann, zeigt statt eines Häkchens den Text **Wird von der Automatisierung abgeschlossen**. Du kannst sie dann nicht abschließen, und im Menü gibt es kein **Löschen**.

## Status schnell ändern und abhaken [#status-snel-wijzigen-en-afvinken]

Ohne das Fenster zu öffnen kannst du:

- Das Kästchen links vom Aufgabennamen abhaken, um die Aufgabe auf **Abgeschlossen** zu setzen. Entfernst du den Haken, geht sie zurück auf **In Bearbeitung**
- Auf der Aufgabenkarte auf die drei Punkte klicken, oder mit der rechten Maustaste auf die Karte, für ein Schnellmenü mit **Bearbeiten**, **Status**, **Priorität**, **Erinnerung**, **Fälligkeitsdatum**, **Labels**, **Ansichten** und **Löschen**. **Labels** erscheint nur, wenn es Labels gibt, und **Ansichten** nur, wenn es Listen gibt, zu denen du selbst Aufgaben hinzufügst

<DocScreenshot src="/screenshots/taken/task-actions-menu.png" alt="Schnellmenü einer Aufgabenkarte" />

## Eine Aufgabe löschen [#een-taak-verwijderen]

Wähle **Löschen** im Schnellmenü der Aufgabe oder im Menü mit den drei Punkten im Aufgabenfenster und bestätige. Das lässt sich nicht rückgängig machen, und eventuelle Unteraufgaben verschwinden mit. Das Löschen wird im [Aktivitätenprotokoll](/activiteitenlog) festgehalten.

Bei einer Aufgabe, die nur eine Automatisierung abschließen darf, steht **Löschen** nicht im Menü. Wird eine solche Aufgabe doch auf anderem Weg gelöscht, schlägt die Automatisierung fehl, die auf den Abschluss wartete.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Änderungen an einer bestehenden Aufgabe sind sofort gespeichert. Nur die Beschreibung speicherst du selbst mit **Speichern**.
- Weist du die Aufgabe zu, bekommt dieser Kollege (oder die Mitglieder der Gruppe) eine Benachrichtigung. Siehe [Benachrichtigungen](/taken/meldingen).
- Setzt du die Aufgabe auf <Status tone="success">Abgeschlossen</Status>, werden offene Unteraufgaben ebenfalls abgeschlossen, und die zugewiesenen Kolleginnen und Kollegen sowie die erstellende Person bekommen eine Benachrichtigung, außer du selbst. Die Aufgabe rutscht in einer manuell sortierten Liste nach unten.
- Eine Erinnerung oder Fälligkeit löst eine Benachrichtigung aus, bis die Aufgabe abgeschlossen ist.
- Eine Aufgabe, die von einer [Automatisierung](/automatiseringen/acties/taken) erstellt wurde, kann selbst auch eine Automatisierung starten, zum Beispiel bei einer Statusänderung oder wenn jemand eine Auswahlschaltfläche wählt.
- Löschen lässt sich nicht rückgängig machen. Das Löschen steht im [Aktivitätenprotokoll](/activiteitenlog).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor fragt Blockierte Aufgabe abschließen?">
Die Aufgabe wartet noch auf eine oder mehrere nicht abgeschlossene Aufgaben (siehe **Blockiert durch**). Schließe zuerst diese Aufgaben ab, oder wähle **Trotzdem abschließen**.
</Accordion>
<Accordion title="Ich sehe einen Text statt eines Häkchens">
Bei **Wird von der Automatisierung abgeschlossen** kannst du die Aufgabe nicht selbst abschließen. Die Automatisierung schließt sie ab. Hat die Aufgabe Schaltflächen unter **Wählen Sie eine Aktion, um diese Aufgabe abzuschließen**, klickst du auf eine Schaltfläche.
</Accordion>
<Accordion title="Ich kann die Schaltflächen an einer Aufgabe nicht benutzen">
Wählen kann, wer der Aufgabe zugewiesen ist, und ein Administrator. Ist niemand zugewiesen, kann jeder wählen, der die Aufgabe sieht. Bei der Fehlermeldung **Auswahl konnte nicht gespeichert werden** versuchst du es erneut.
</Accordion>
<Accordion title="Die Schaltfläche Starten des Timers ist grau">
Dein Timer läuft schon bei einer anderen Aufgabe. Du kannst nur bei einer Aufgabe gleichzeitig Zeit erfassen. Beende zuerst diesen Timer.
</Accordion>
<Accordion title="Mein Timer stand still, obwohl ich gearbeitet habe">
Nach zehn Minuten ohne Maus oder Tastatur pausiert der Timer zum letzten Zeitpunkt, an dem du aktiv warst. Mit **Fortsetzen** machst du weiter.
</Accordion>
<Accordion title="Zeit erfassen schlägt fehl">
Gib eine Dauer ein, die Tillor versteht, wie **1:30**, **90**, **1u 30m** oder **1.5h**. Klappt es trotzdem nicht, siehst du die Meldung **Zeit konnte nicht erfasst werden**, und du versuchst es erneut. Du kannst nur deine eigenen Einträge löschen.
</Accordion>
<Accordion title="Drucken auf den Drucker geht nicht">
**An A4-Drucker senden** und **An Thermodrucker senden (POS)** kannst du nur wählen, wenn deine Organisation einen Connector mit Drucker hat. **Drucken (A4)** funktioniert immer. Geht etwas schief, siehst du die Meldung **Aufgaben-PDF konnte nicht erstellt werden**.
</Accordion>
<Accordion title="Tillor meldet Aufgabe konnte nicht aktualisiert werden">
Die Änderung wurde nicht gespeichert. Versuche es erneut oder lade die Seite neu.
</Accordion>
<Accordion title="Ich kann eine Aufgabe nicht löschen">
Bei einer Aufgabe, die nur eine Automatisierung abschließen darf, steht **Löschen** nicht im Menü. Sonst kann jede Kollegin und jeder Kollege, die oder der die Aufgabe sieht, sie löschen.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Ansichten" href="/taken/weergaven" />
  <Card title="Labels" href="/taken/labels" />
  <Card title="Aufgaben in Automatisierungen" href="/automatiseringen/acties/taken" />
</Cards>


# Aufgaben auf anderen Seiten (/de-DE/taken/taken-op-andere-paginas)

Aufgaben stehen nicht für sich allein. Du erstellst sie aus dem Element, um das es geht, und siehst sie dort auch wieder.

## Eine Aufgabe aus einem anderen Element erstellen [#een-taak-maken-vanuit-een-ander-item]

Die Aufgabe wird automatisch mit dem Element verknüpft. Ist ein Kunde beteiligt, kannst du ihn ebenfalls verknüpfen. Die Aufgabe wird standardmäßig dir selbst zugewiesen.

| Wo | Schaltfläche |
|---|---|
| Kundenseite | **Aufgabe erstellen** im Aktionsmenü des Kunden |
| Rechnung | **Aufgabe erstellen** im Aktionsmenü |
| Zähler | **Aufgabe erstellen** im Aktionsmenü |
| Reservierung | **Aufgabe erstellen** |
| Parzelle | **Aufgabe erstellen** |
| Unterhaltung in der Inbox | **Aufgabe erstellen** |
| Telefonanruf | **Aufgabe erstellen** |
| Kommentar | Das Aufgaben-Symbol am Kommentar (Tooltip **Aufgabe aus diesem Kommentar erstellen**) |
| Banktransaktion | **Aufgabe erstellen** im Aktionsmenü der Transaktion unter <UIPath>Verwaltung > Banktransaktionen</UIPath> |

## Eine Nachfass-Erinnerung an einem Kommentar [#een-opvolgherinnering-bij-een-opmerking]

An einem Kommentar steht auch eine Uhr, um dich selbst (oder die genannten Kolleginnen und Kollegen) daran zu erinnern, den Kommentar nachzuverfolgen. Damit erstellst du eine Aufgabe wie *Diesen Kommentar nachverfolgen* oder *Prüfen, ob [Name] das mitbekommen hat*. Markierst du den Kommentar später als erledigt, wird diese Nachfass-Aufgabe automatisch abgeschlossen.

## Offene Aufgaben an einem Element [#openstaande-taken-bij-een-item]

Auf der Seite eines Kunden, einer Reservierung, Rechnung, Parzelle und eines Zählers steht ein Block **Offene Aufgaben** mit den noch nicht abgeschlossenen Aufgaben, die an diesem Element hängen. Gibt es keine offenen Aufgaben, erscheint der Block nicht.

Auf der Seite <UIPath>Kunden > [Kunde] > Aufgaben</UIPath> stehen alle Aufgaben des Kunden. Du öffnest sie über den Tab **Aufgaben** auf der Kundenseite. Abgeschlossene Aufgaben stehen eingeklappt unter **Abgeschlossene Aufgaben**, mit der Anzahl dahinter.

<DocScreenshot src="/screenshots/taken/customer-tasks.png" alt="Tab Aufgaben auf einer Kundenseite mit Neue Aufgabe und den Aufgaben des Kunden" />

## Auf dem Dashboard [#op-het-dashboard]

Die Karte **Aufgaben für dich** zeigt dir zugewiesene Aufgaben. Mit dem Stern wählst du eine Lieblingsansicht, die du dort stattdessen sehen möchtest, siehe [Ansichten](/taken/weergaven#een-favoriete-weergave-voor-het-dashboard). Du kannst dort auch direkt eine Aufgabe erstellen oder die Aufgaben teilen.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Aufgabe hängt an dem Element, aus dem du sie erstellt hast. Du siehst sie in der Aufgabe bei **Verknüpfte Elemente**.
- Solange die Aufgabe nicht abgeschlossen ist, steht sie im Block **Offene Aufgaben** auf der Seite dieses Elements und des verknüpften Kunden.
- Eine Nachfass-Aufgabe an einem Kommentar wird von selbst abgeschlossen, wenn du den Kommentar als erledigt markierst.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe kein Aufgabe erstellen">
Auf manchen Seiten steht die Schaltfläche im Aktionsmenü, etwa bei einem Kunden, einer Rechnung oder einem Zähler. Suche dort nach den drei Punkten.
</Accordion>
<Accordion title="Der Block Offene Aufgaben fehlt">
Der Block erscheint nur, wenn noch nicht abgeschlossene Aufgaben am Element hängen.
</Accordion>
<Accordion title="Tillor meldet Aufgabe konnte nicht erstellt werden">
Die Aufgabe wurde nicht gespeichert. Gib einen Namen ein und versuche es erneut.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Aufgabendetails" href="/taken/taakdetails" />
  <Card title="Ansichten" href="/taken/weergaven" />
</Cards>


# Ansichten (/de-DE/taken/weergaven)

Oben auf der Seite **Aufgaben** steht eine Reihe von Tabs. Jeder Tab ist eine Ansicht. Der erste Tab, **Alle**, ist eingebaut: Er zeigt jede Aufgabe, und du kannst ihn nicht bearbeiten, verschieben oder löschen. Du kannst darin aber Filter und Ansichtseinstellungen für die ganze Organisation speichern. Alle anderen Ansichten erstellst du selbst.

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Tabs mit Ansichten oben auf der Aufgabenseite" />

## Zwei Arten von Ansichten [#twee-soorten-weergaven]

Beim Erstellen wählst du bei **Inhalt** die Art der Ansicht.

| Art | Was sie tut |
|---|---|
| **Gefilterte Ansicht** | Zeigt jede Aufgabe, die den Filtern entspricht, wie eine gespeicherte Suche. Neue passende Aufgaben erscheinen von selbst |
| **Liste** | Zeigt nur die Aufgaben, die du selbst hinzufügst |

Eine Liste ist praktisch für eine feste Sammlung, zum Beispiel *Saisonvorbereitung*. Eine gefilterte Ansicht ist praktisch für alles, was einer Regel entspricht, zum Beispiel *Alle dringenden Aufgaben, die auf den Kunden warten*.

Die Art kannst du später in **Ansicht** (oben rechts) bei **Art** ändern. Bei **Alle** geht das nicht. Wandelst du eine Liste in eine gefilterte Ansicht um, werden die Aufgaben, die du von Hand hinzugefügt hast, davon gelöst. Tillor bittet dich vorher um Bestätigung, denn das lässt sich nicht rückgängig machen.

## Eine Ansicht erstellen [#een-weergave-aanmaken]

1. Klicke auf **Neue Ansicht**, rechts neben den Tabs
2. Gib einen **Name** und bei Bedarf eine **Beschreibung** ein
3. Wähle bei **Sichtbarkeit**, wer die Ansicht sieht: **Öffentlich**, **Nur Sie** oder **Geteilt**. Bei **Geteilt** wählst du bei **Teilen mit** die Kolleginnen, Kollegen und Gruppen
4. Wähle bei **Inhalt** eine **Gefilterte Ansicht** oder eine **Liste**
5. Wähle bei **Spalten**, wie die Aufgaben eingeteilt werden: **Eigene Spalten**, **Status**, **Zugewiesen an** oder **Keine Gruppierung**
6. Wähle bei **Beginnen mit** einen Startfilter: **Alle Aufgaben**, **Offene Aufgaben** oder **Meine Aufgaben**
7. Klicke unten im Dialog auf **Neue Ansicht**

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Dialog Neue Ansicht" />

Vorab steht die Ansicht auf **Öffentlich**, **Gefilterte Ansicht**, **Status** und **Offene Aufgaben**. Wählst du **Keine Gruppierung**, bekommst du eine Tabelle. Bei den anderen Optionen beginnst du mit einem Board. Das passt du später an, siehe [Tabelle, Board und Kalender](/taken/indelingen).

Eine gefilterte Ansicht, die als Tabelle eingestellt ist, sieht so aus. Die Filter stehen über der Tabelle und sind hier schon gespeichert.

<DocScreenshot src="/screenshots/taken/task-view-filtered.png" alt="Gefilterte Ansicht Dringende Aufgaben als Tabelle, mit Filtern auf Priorität und Status" />

## Wer eine Ansicht sieht [#wie-ziet-een-weergave]

| Auswahl | Wer die Ansicht sieht |
|---|---|
| **Öffentlich** | Alle Benutzer der Organisation (eine Organisationsansicht) |
| **Nur Sie** | Nur du (eine persönliche Ansicht). Am Tab steht ein Schloss |
| **Geteilt** | Du und die Kolleginnen, Kollegen und Gruppen, die du bei **Teilen mit** wählst. Am Tab steht ein Symbol mit mehreren Personen |

Bei **Teilen mit** wählst du Personen und Gruppen aus derselben Liste. Eine [Gruppe](/gebruikers/groepen) zählt so, wie sie in diesem Moment zusammengesetzt ist: Wer später in die Gruppe kommt, sieht die Ansicht ebenfalls, und wer die Gruppe verlässt, sieht sie nicht mehr.

Nur die Eigentümerin oder der Eigentümer einer persönlichen Ansicht kann ändern, mit wem sie geteilt ist, oder sie für alle sichtbar machen. Kolleginnen und Kollegen, mit denen du die Ansicht teilst, können darin arbeiten, aber nicht bestimmen, wer sie sonst noch sieht, und sie auch nicht löschen. Machst du eine Ansicht **Öffentlich**, entfällt die Liste der gewählten Personen und Gruppen.

<Callout type="warn">
Die Sichtbarkeit einer Ansicht bestimmt auch, wer die Aufgaben in dieser Ansicht sieht. Lies [Private Aufgaben](/taken/prive-taken), bevor du Aufgaben in eine persönliche Ansicht legst.
</Callout>

## Eine Ansicht bearbeiten, duplizieren oder löschen [#een-weergave-bewerken-dupliceren-of-verwijderen]

Klicke mit der rechten Maustaste auf den Tab der Ansicht und wähle:

- **Bearbeiten** - passe Name, Beschreibung, Sichtbarkeit und Spalten an. Filter, Sortierung und Layout bleiben so, wie sie gespeichert waren. **Inhalt** und **Beginnen mit** wählst du nur beim Erstellen; die Art änderst du später in **Ansicht**
- **Duplizieren** - erstellt eine Kopie mit dem Namen *[Name] (Kopie)* und öffnet sie sofort
- **Löschen** - nach Bestätigung verschwindet die Ansicht. Die Aufgaben selbst bleiben bestehen und verlieren nur diese Ansicht

Ziehe die Tabs, um die Reihenfolge anzupassen. Die neue Reihenfolge wird sofort gespeichert.

## Änderungen speichern oder verwerfen [#wijzigingen-opslaan-of-verwerpen]

Passt du Filter oder Ansichtseinstellungen an, stehen sie zunächst nur auf deinem Bildschirm. Oben rechts erscheint eine Leiste mit **Nicht gespeicherte Änderungen** und zwei Schaltflächen:

- **Ansicht speichern** sichert die Änderungen in der Ansicht
- **Verwerfen** setzt alles auf die gespeicherte Version zurück

In der eingebauten Ansicht **Alle** speicherst du die Änderungen für alle in deiner Organisation, wie bei einer öffentlichen Ansicht. Dafür brauchst du das Recht **Labels und geteilte Ansichten verwalten**. Ohne dieses Recht kannst du die Änderungen in **Alle** nur **Verwerfen**.

Die Suchleiste (**Aufgaben suchen...**) wird nie mit der Ansicht gespeichert: Sie schränkt nur ein, was du gerade siehst.

## Eine Lieblingsansicht für das Dashboard [#een-favoriete-weergave-voor-het-dashboard]

<DocScreenshot src="/screenshots/taken/dashboard-tasks-card.png" alt="Dashboard-Karte Aufgaben für dich mit den Schaltflächen für Lieblingsansicht und Teilen" />

Auf dem Dashboard zeigt die Karte **Aufgaben für dich** standardmäßig die Aufgaben, die dir zugewiesen sind. Du kannst stattdessen eine Ansicht verknüpfen:

1. Klicke auf den Stern oben rechts in der Karte
2. Wähle eine Ansicht aus der Liste. Wähle **Aufgaben für dich**, um wieder zu deinen eigenen zugewiesenen Aufgaben zurückzukehren

Du kannst jeweils eine Lieblingsansicht haben, und sie gilt nur für dich. Wurde die Ansicht später gelöscht oder ist sie für dich nicht mehr sichtbar, zeigt das Dashboard wieder deine eigenen Aufgaben.

## Einer Ansicht folgen [#een-weergave-volgen]

Mit der Schaltfläche **Folgen** oben rechts bekommst du jeden Morgen eine E-Mail mit dem, was in dieser Ansicht Aufmerksamkeit braucht. Wie das funktioniert, steht unter [Benachrichtigungen](/taken/meldingen#een-weergave-volgen).

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die neue Ansicht erscheint als Tab oben auf der Aufgabenseite. Eine gefilterte Ansicht zeigt sofort alle passenden Aufgaben, und neue passende Aufgaben kommen von selbst dazu.
- Bei **Öffentlich** sehen alle Benutzer deiner Organisation die Ansicht. Bei **Nur Sie** siehst nur du sie, und bei **Geteilt** du und die gewählten Kolleginnen, Kollegen und Gruppen.
- Löschst du eine Ansicht, bleiben die Aufgaben bestehen. Sie verlieren nur diese Ansicht.
- Wandelst du eine Liste in eine gefilterte Ansicht um, werden die Aufgaben, die du von Hand hinzugefügt hast, gelöst.
- Eine Ansicht, der du folgst, schickt dir jeden Morgen eine Zusammenfassung. Siehe [Benachrichtigungen](/taken/meldingen#een-weergave-volgen).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet, dass die Ansicht nicht erstellt werden konnte">
Du siehst **Ansicht konnte nicht erstellt werden**. Prüfe, ob du einen **Name** eingegeben hast, und versuche es erneut. Klappt es immer noch nicht, prüfe deine Internetverbindung. Beim Duplizieren heißt die Meldung **Ansicht konnte nicht dupliziert werden**, und es gilt dasselbe.
</Accordion>
<Accordion title="Ich kann den Tab Alle nicht bearbeiten oder löschen">
**Alle** ist eingebaut und zeigt jede Aufgabe, die du sehen darfst. Name, Position und Sichtbarkeit stehen fest. Filter und Ansichtseinstellungen kannst du darin aber speichern, für die ganze Organisation. Erstelle eine eigene Ansicht, wenn du eine Auswahl nur für dich möchtest.
</Accordion>
<Accordion title="Ein Kollege kann die Ansicht nicht öffentlich machen oder löschen">
Nur die Eigentümerin oder der Eigentümer einer persönlichen Ansicht bestimmt, mit wem sie geteilt ist, und kann sie öffentlich machen oder löschen. Kolleginnen und Kollegen, mit denen du sie teilst, können darin aber Aufgaben bearbeiten.
</Accordion>
<Accordion title="Ich sehe die Leiste Nicht gespeicherte Änderungen">
Du hast Filter oder Ansichtseinstellungen angepasst, und sie stehen noch nur auf deinem Bildschirm. Wähle **Ansicht speichern**, um sie zu behalten, oder **Verwerfen**, um zurückzugehen. Bei **Alle** brauchst du dafür das Recht **Labels und geteilte Ansichten verwalten**; ohne dieses Recht kannst du dort nur verwerfen.
</Accordion>
<Accordion title="Eine Aufgabe steht nicht in meiner Liste">
Eine Liste zeigt nur Aufgaben, die du selbst hinzufügst. Möchtest du, dass alles, was einer Regel entspricht, von selbst hineinkommt, wähle bei **Art** eine gefilterte Ansicht.
</Accordion>
<Accordion title="Die Reihenfolge der Tabs wird nicht gespeichert">
Dann siehst du in Tillor **Ansichten konnten nicht neu geordnet werden**. Ziehe die Tabs noch einmal.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Tabelle, Board und Kalender" href="/taken/indelingen" />
  <Card title="Filtern" href="/taken/filteren" />
  <Card title="Private Aufgaben" href="/taken/prive-taken" />
</Cards>


# Parzellen (/de-DE/terreinen)

Eine Parzelle ist ein Platz in deinem Park: ein Grundstück, Chalet, Wohnmobilstellplatz oder fester Platz. Hier legst du deine Parzellen an, gibst ihnen einen Typ und einen Tarif und hängst Zähler daran. Danach setzt du Kunden darauf, mit einer [Belegung](/bezettingen) oder einer [Reservierung](/reserveringen). Du findest sie unter <UIPath>Park > Parzellen</UIPath>.

<DocScreenshot src="/screenshots/park/terrains-list.png" alt="Parzellenübersicht mit Demo-Parzelle 12" />

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  T[Parzelle] --> M[Zähler]
  T --> Tar[Berechneter Tarif]
  K[Kunde] -->|Belegung| T
  Tar --> F[Rechnungen]
  M --> V[Verbrauch des Kunden]
  V --> F
```

An einer Parzelle hängt alles, was zu diesem Platz gehört. Der Tarif ergibt sich aus der Fläche und den eigenen Feldern der Parzelle. Die Zähler an der Parzelle liefern den Verbrauch, und dieser Verbrauch geht an den Kunden mit einer aktiven Belegung. Siehe auch [Zählerverwaltung](/meterbeheer#hoe-hangt-dit-samen).

<Callout type="info" title="Gut zu wissen">
- Der Name ist Pflicht und darf höchstens 255 Zeichen haben.
- **Buchbar** ist bei einer neuen Parzelle standardmäßig aus.
- Die Fläche berechnet Tillor, sobald du die Parzelle auf der Karte einzeichnest. Du tippst sie nicht selbst ein.
- **Kürzliche Parzellen** zählt die Parzellen der letzten 7 Tage.
- Eine Parzelle hat höchstens eine aktive Belegung gleichzeitig.
- Der berechnete Tarif wird neu berechnet, sobald du eine Parzelle speicherst, und für alle Parzellen, sobald du die Tarifformel speicherst.
- Löschst du einen Parzellentyp, bleiben die Parzellen bestehen, haben dann aber keinen Typ mehr.
</Callout>

## Eine neue Parzelle erstellen [#een-nieuw-terrein-aanmaken]

Bevor du anfängst: Brauchst du Parzellentypen (wie **Stellplatz** oder **Chalet**) oder eigene Felder, lege sie zuerst an. Siehe [Parzellentypen](#terreintypes) und [Eigene Felder](/eigen-velden).

<Steps>
<Step>
### Klicke auf Neues Grundstück erstellen [#klik-op-nieuw-terrein-aanmaken]
Die Schaltfläche findest du oben rechts auf <UIPath>Park > Parzellen</UIPath>.

<DocScreenshot src="/screenshots/park/terrain-create-dialog.png" alt="Dialog Parzelle erstellen" />
</Step>
<Step>
### Gib die Daten ein [#vul-de-gegevens-in]
Nur der **Name** ist Pflicht. Außerdem kannst du ausfüllen:

- **Beschreibung**, eine Erläuterung.
- **Terrain-Typ**, oder lass **Kein Typ** stehen.
- **Eigene Felder**, die deine Organisation selbst hinzugefügt hat, wie einen Zuschlag oder eine Gaszählernummer.
- **Buchbar**, wenn Kunden die Parzelle online reservieren dürfen.
- **Standort**, um die Parzelle gleich auf der Karte zu markieren.
</Step>
<Step>
### Klicke auf Parzelle erstellen [#klik-op-terrein-aanmaken]
Die Parzelle steht in der Liste. Hast du den Standort nicht eingezeichnet, tust du das später auf dem Lageplan, siehe [Karte](/kaart#terreingrenzen-intekenen).
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Parzelle erscheint in der Liste und in den Statistiken oben: **Parzellen gesamt**, **Kürzliche Parzellen**, **Buchbare Parzellen**, **Nicht buchbare Parzellen** und **Gesamtfläche** (nur von Parzellen mit eingezeichnetem Standort).
- Tillor berechnet den **Berechneten Tarif** aus der Tarifformel deiner Organisation.
- Auf der Detailseite kannst du Zähler verknüpfen, Kommentare hinzufügen und den Verlauf sehen.

## Eine Parzelle ansehen und bearbeiten [#een-terrein-bekijken-en-bewerken]

Klicke in der Liste auf eine Parzelle. Oben stehen der Name, die Beschreibung, die Fläche, die Anzahl der Zähler, ob sie buchbar ist, der **Kunde** mit einer aktiven Belegung sowie das Erstell- und Änderungsdatum. Im Formular **Grundstück aktualisieren** passt du an:

- **Name**, **Terrain-Typ**, **Beschreibung**, **Buchbar** und die **Eigenen Felder**.
- **Fläche** und **Berechneter Tarif** sind nur lesbar.

Speichere mit **Grundstück aktualisieren**. Neben dem Formular stehen **Standort**, **Zähler** und **Belegungshistorie**. Darunter stehen **Kommentare** (nur für deine Kolleginnen und Kollegen sichtbar), **Ereignisse** mit einer Vorher-nachher-Übersicht pro geändertem Feld und **Reservierungen**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Parzellendetail mit verknüpften Zählern" />

## Zähler an eine Parzelle hängen [#meters-aan-een-terrein-hangen]

In der Karte **Zähler** wählst du **Zähler hinzufügen** und danach **Zähler zuweisen**. Nur Zähler ohne Parzelle stehen in der Liste. Pro Zähler siehst du den Typ, eine Statusanzeige und den letzten Stand. Mit dem Menü (...) wählst du **Von Parzelle trennen**; diese Auswahl gibt es nur hier. Den ganzen Weg zum Kunden findest du unter [Einen Zähler mit einem Kunden verknüpfen](/meterbeheer/meter-koppelen).

## Parzellentypen [#terreintypes]

Mit Parzellentypen teilst du Parzellen ein, zum Beispiel **Stellplatz**, **Chalet** oder **Wohnmobilstellplatz**. Den Typ siehst du in der Parzellenliste (Spalte **Typ**, mit einem Filter), du kannst die Karte danach einfärben, und er steht im Export. Du verwaltest sie unter <UIPath>Support > Einstellungen > Terrain-Typen</UIPath>.

<Requires permission="Einstellungen bearbeiten" />

<DocScreenshot src="/screenshots/instellingen/settings-terrain-types.png" alt="Einstellungen > Terrain-Typen" />

Die Tabelle **Alle Terrain-Typen** zeigt pro Typ den **Name**, die **Kartenfarbe**, die **Beschreibung** und die Anzahl der **Parzellen**. Suche mit **Terrain-Typen suchen...**. Mit dem Stift bearbeitest du einen Typ, mit dem Papierkorb löschst du ihn.

<Steps>
<Step>
### Klicke auf Neuer Terrain-Typ [#klik-op-nieuw-terreintype]
</Step>
<Step>
### Gib die Daten ein [#vul-de-gegevens-in-1]
Gib einen **Name** ein, bei Bedarf eine **Beschreibung**, und wähle eine **Kartenfarbe**. Blau ist vorausgewählt.
</Step>
<Step>
### Klicke auf Erstellen [#klik-op-aanmaken]
</Step>
</Steps>

<DocScreenshot src="/screenshots/instellingen/terrain-type-create-dialog.png" alt="Dialog Terrain-Typ erstellen" />

Einen Typ verknüpfst du über das Feld **Terrain-Typ** mit einer Parzelle. Die Kartenfarbe siehst du auf dem Lageplan, wenn du bei **Ebenen** die Farben auf **Terrain-Typ** stellst, siehe [Karte](/kaart#lagen-en-kleuren).

## Parzellen exportieren [#terreinen-exporteren]

Klicke auf **Alle Terrains exportieren** (oben rechts), um eine Excel-Datei herunterzuladen. Sie enthält pro Parzelle die Basisdaten, den Parzellentyp, die eigenen Felder und die Tarifberechnung (Zwischensumme, Zuschläge und Gesamtbetrag). Nutze sie zum Beispiel für die jährliche Tarifkontrolle.

## Wie der Tarif zustande kommt [#hoe-het-tarief-tot-stand-komt]

Der **Berechnete Tarif** ergibt sich aus der Tarifformel deiner Organisation. Die Formel rechnet mit der Fläche und mit den eigenen Feldern der Parzelle. Welche eigenen Felder das sind, bestimmst du selbst. Die Standardformel verwendet die Felder mit den Schlüsseln `locationSurcharge`, `gasMeterNumber`, `electricityMeterSurcharge` und `staticPrice`. Hast du sie unter <UIPath>Support > Einstellungen > Eigene Felder</UIPath> angelegt, funktionieren sie so:

1. **Fläche**: die eingezeichnete Fläche, in Staffeln pro m².
2. **Gaszählerzuschlag**: kommt dazu, wenn das Feld mit der Gaszählernummer ausgefüllt ist.
3. **Lagezuschlag**: der Betrag, den du eingibst.
4. **Stromzuschlag**: der Betrag, den du eingibst.
5. **Statischer Preis**: Ist dieses Feld ausgefüllt, ersetzt dieser Betrag den berechneten Tarif, und Tillor überspringt die Formel.

Möchtest du den Tarif eines Jahres ändern, passe die eigenen Felder an, prüfe bei **Berechneter Tarif**, ob er stimmt, und speichere mit **Grundstück aktualisieren**.

### Tarifformel [#tariefformule]

<Requires permission="Platztarif-Formel bearbeiten" />

Unter <UIPath>Einstellungen > Platztarif</UIPath> bestimmst du selbst, wie der Tarif berechnet wird. Wer die Einstellungen schon bearbeiten durfte, hat das Recht **Platztarif-Formel bearbeiten** bekommen. Die Formel ist ein Stück TypeScript (eine Programmiersprache), das den Jahrestarif in Euro zurückgibt, oder benannte Teile, die zusammen den Tarif bilden, wie `Subtotaal` und `Toeslag gasmeter`. Jeder Teil bekommt eine eigene Spalte im Export.

- Felder der Parzelle liest du mit `{terrain.veld}`, wie `{terrain.surfaceArea}` oder `{terrain.customFields.locationSurcharge}`. Über die Schaltfläche **Variable** oder indem du `{` tippst, wählst du aus allen Feldern, auch deinen eigenen.
- Rechts neben der Formel probierst du sie gleich an einer deiner Parzellen aus. Einen Fehler siehst du dort mit der Zeilennummer. Eine Formel, die nicht funktioniert, kannst du nicht speichern.
- Mit **Auf Standard zurücksetzen** gehst du zurück zur Formel, mit der jede Organisation begonnen hat.
- In Automatisierungen liest du den Tarif als `{terrain.calculatedTariff.total}`.

<Callout type="warn" title="Achtung">
Die Formel läuft abgeschirmt: Sie kann nur mit den Feldern der Parzelle rechnen, ohne andere Daten oder Internet. Eine Formel, die zu lange rechnet, wird abgebrochen und liefert dann keinen Tarif.
</Callout>

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet Parzelle nicht erstellt">
Die Parzelle wurde nicht gespeichert. Prüfe, ob der **Name** ausgefüllt und nicht länger als 255 Zeichen ist, und versuche es erneut.
</Accordion>
<Accordion title="Die Fläche ist leer oder 0">
Die Fläche stammt nur aus dem Standort auf der Karte. Zeichne die Parzelle über <UIPath>Park > Karte</UIPath> ein, siehe [Karte](/kaart#terreingrenzen-intekenen). Parzellen ohne Standort zählen nicht zur **Gesamtfläche**.
</Accordion>
<Accordion title="Der Berechnete Tarif stimmt nicht">
Prüfe die eigenen Felder der Parzelle (Zuschläge und Gaszählernummer). Ist ein **Statischer Preis** ausgefüllt, ersetzt er den berechneten Tarif. Wurde die Formel angepasst, prüfe unter Platztarif, ob der Test an dieser Parzelle stimmt.
</Accordion>
<Accordion title="Ich sehe Platztarif nicht in den Einstellungen">
Du brauchst das Recht **Platztarif-Formel bearbeiten**. Bitte deine Administratorin oder deinen Administrator darum.
</Accordion>
<Accordion title="Der Zähler steht nicht in der Liste bei Zähler hinzufügen">
Dieser Zähler hängt schon an einer anderen Parzelle. Trenne ihn dort zuerst.
</Accordion>
<Accordion title="Ich kann auf dieser Parzelle keine Belegung anlegen">
Eine Parzelle mit einer aktiven Belegung steht nicht in der Auswahlliste. Beende zuerst die laufende Belegung.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Parzelle**: ein Platz in deinem Park. Siehe [Begriffe](/begrippen#terrein).
- **Parzellentyp**: eine Einteilung wie **Stellplatz** oder **Chalet**, mit einer Kartenfarbe.
- **Buchbar**: Kunden dürfen die Parzelle online reservieren.
- **Berechneter Tarif**: der Tarif, den Tillor aus der Formel berechnet.
- **Eigenes Feld**: ein Feld, das deine Organisation selbst hinzufügt. Siehe [Begriffe](/begrippen#eigen-veld).
- **Belegung**: ein Kunde auf einer Parzelle für einen Zeitraum. Siehe [Begriffe](/begrippen#bezetting).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zählerverwaltung" href="/meterbeheer" description="Zähler mit Parzellen verknüpfen und Verbrauch abrechnen" />
  <Card title="Belegungen" href="/bezettingen" description="Kunden auf eine Parzelle setzen" />
  <Card title="Karte" href="/kaart" description="Parzellengrenzen einzeichnen" />
</Cards>


# Zugangskontrolle (/de-DE/toegangscontrole)

Mit der Zugangskontrolle legen Sie fest, wer in Ihren Park darf, und behalten im Blick, wer sich darin aufhält. Sie geben einem Kunden eine Zugriffsmethode (Kennzeichen, NFC-Tag, QR-Code oder PIN-Code), bedienen Schranken von Ihrem Bildschirm aus und lesen nach, wer wann durch welchen Zugangspunkt gekommen ist. Eine Zugriffsmethode legen Sie am Kundenprofil an, siehe [Eine Zugriffsmethode hinzufügen](#een-toegangsmethode-toevoegen).

<DocScreenshot src="/screenshots/toegangscontrole/stats-overview.png" alt="Zugangskontrolle mit Statistiken am oberen Rand" />

Die Zahlen oben zählen alle Zugänge, die letzten 24 Stunden, die erlaubten und blockierten Versuche und Ihre aktiven Zugangspunkte. Darunter stehen die Schnellaktionen, die Fahrzeuge im Park, das Zugangsprotokoll und die Controller-Operationen.

<Callout type="info" title="Gut zu wissen">
- Ein Fahrzeug wird zum **Geisterfahrzeug**, wenn es 7 Tage lang an keinem Zugangspunkt gesehen wurde, obwohl es als **Im Park** geführt wurde.
- Eine QR-Zugriffsmethode legen Sie in einem Schritt bis zu 100 Mal an, jeweils mit eigenem Code.
- Ein PIN-Code besteht aus 4 bis 8 Ziffern und muss innerhalb Ihrer Organisation eindeutig sein.
- Jedes Kennzeichen, jeder NFC-Tag und jeder QR-Code darf in Ihrer Organisation nur einmal vorkommen.
- Eine Zugriffsmethode, die nicht in den Zeitraum zwischen **Von Datum** und **Bis Datum** fällt, gewährt keinen Zugang.
- Ein Kennzeichen mit dem Status **Weich blockiert** ist nur während der Öffnungszeiten der Rezeption blockiert.
- Ein abgelaufenes Kennzeichen darf standardmäßig noch 2 Tage außerhalb der Öffnungszeiten ausfahren (höchstens 30). Siehe [Einstellungen für die Zugangskontrolle](/gebruikers/instellingen-toegangscontrole).
- Ein Fahrzeug erscheint am Kundenprofil über ein registriertes Kennzeichen oder über den NFC-Tag oder QR-Code, mit dem der Kunde hereingefahren ist.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Eine Zugriffsmethode ist der Schlüssel eines Kunden. Der Zugangspunkt (die Schranke oder das Tor) ist die Tür. Dazwischen befindet sich Technik in Ihrem Park: eine Kamera, die Kennzeichen liest, oder ein Kästchen, das Tags und QR-Codes liest (ein Zugangscontroller), und der [Connector](/connector). Der Connector ist das Kästchen, das Tillor mit den Geräten in Ihrem Park verbindet.

```mermaid
flowchart TD
  K[Klant] --> M[Toegangsmethode<br/>kenteken, NFC-tag, QR-code of pincode]
  M -->|Tillor stuurt de lijst door| C[Connector in je park]
  C --> L[Camera of kaartlezer<br/>bij de ingang]
  L -->|toegestaan| P[Toegangspunt gaat open]
  L -->|geweigerd| W[Toegangspunt blijft dicht]
  L -->|elke poging wordt gemeld| LOG[Toegangslogboek in Tillor]
```

Was das für Sie bedeutet:

- Ändern oder löschen Sie eine Zugriffsmethode in Tillor, leitet Tillor das über den Connector an die Geräte weiter. Das Ergebnis sehen Sie unter **Controller-Operationen**.
- Ist der Connector offline, bleiben neue oder geänderte Zugriffsmethoden auf **Ausstehend**, bis er wieder verbunden ist.
- Auch eine Schranke, die Sie aus Tillor öffnen, erhält ihren Befehl in der Regel über den Connector. Ist dieser offline, öffnet sich die Schranke nicht.

Der Bereich Controller im Hauptmenü ist etwas anderes: die kleinen Displays mit Tag-Leser bei Duschen, Türen und Ladepunkten. Siehe [Controller](/controllers). Die Technik an den Schranken richtet der Tillor-Support bei der Inbetriebnahme ein.

## Zugangspunkte bedienen [#toegangspunten-bedienen]

Unter **Schnellaktionen** steht für jeden aktiven Zugangspunkt eine Schaltfläche. Diesen Block sehen Sie nur, wenn mindestens ein Zugangspunkt oder Zugangscontroller eingerichtet ist.

<DocScreenshot src="/screenshots/toegangscontrole/quick-actions.png" alt="Schnellaktionen mit Zugangspunkten und Verwaltungsschaltflächen" />

<Steps>
<Step>
### Klicken Sie auf die Schaltfläche des Zugangspunkts [#klik-op-de-knop-van-het-toegangspunt]
Die Beschriftung lautet **[Name] öffnen**.
</Step>
<Step>
### Bestätigen Sie [#bevestig]
Es öffnet sich ein Dialog mit der Frage, ob Sie den Zugangspunkt wirklich öffnen möchten. Klicken Sie auf **Ja, [Name] öffnen**.

<DocScreenshot src="/screenshots/toegangscontrole/barrier-confirm-dialog.png" alt="Bestätigung zum Öffnen eines Zugangspunkts" />
</Step>
</Steps>

Tillor meldet **Zugangspunkt geöffnet**. Schließen ist nur möglich, wenn der Zugangspunkt das unterstützt. Dann steht neben der Öffnen-Schaltfläche ein Pfeil nach unten: Wählen Sie dort **[Name] schließen** und bestätigen Sie mit **Ja, [Name] schließen**.

### Verwaltungsschaltflächen in den Schnellaktionen [#beheerknoppen-in-snelle-acties]

Neben den Zugangspunkten stehen, abhängig von Ihrer Technik, Schaltflächen für die Wartung. Nutzen Sie sie nur, wenn etwas nicht stimmt.

| Schaltfläche | Was sie tut | Wann |
|---|---|---|
| **APB zurücksetzen** | Löscht den Speicher darüber, wer zuletzt hinein- oder hinausgegangen ist, je Typ: **Für NFC-Ausweise…** oder **Für QR-Codes…**. | Personen kommen nicht mehr durch, weil das Tor glaubt, sie seien schon drinnen (oder draußen). APB steht für Anti-Passback. |
| **Gerätelogs synchronisieren** | Lässt den Connector alle neuen Zeilen der Zugangscontroller abrufen. | Aktuelle Durchgänge fehlen im Zugangsprotokoll. |
| **Connector-Cache zurücksetzen** | Der Connector löscht seine lokalen Daten und holt alles erneut von Tillor. | Die Geräte verhalten sich anders als die Zugriffsmethoden in Tillor. |
| **ANPR-Ausschuss aufräumen** | Entfernt nur gefahrlos löschbare Geisterzeilen aus der Kennzeichenliste. Registrierte und verknüpfte Kennzeichen bleiben erhalten. | In der Liste stehen Kennzeichen, die zu nichts gehören. |

## Zugriffsmethoden über das Kundenprofil verwalten [#toegangsmethoden-beheren-via-het-klantprofiel]

Zugriffsmethoden fügen Sie auf dem Profil des Kunden hinzu, ändern und löschen sie dort.

### Eine Zugriffsmethode hinzufügen [#een-toegangsmethode-toevoegen]

Eine Zugriffsmethode gehört zu einem Kunden und gibt diesem Kunden Zugang zum Park. Sie verwalten sie auf dem Kundenprofil.

Bevor Sie beginnen:

- Der Kunde existiert in Tillor.
- Für NFC benötigen Sie einen Tag, der noch niemandem gehört. Ist kein freier Tag vorhanden, steht in der Liste **Keine verfügbaren NFC-Karten gefunden, alle Karten sind bereits zugewiesen.**
- Der Typ **PIN-Code** steht nur in der Liste, wenn er für Ihre Organisation aktiviert ist.

<Steps>
<Step>
### Öffnen Sie den Tab Zugangskontrolle [#open-het-tabblad-toegangscontrole]
Gehen Sie zu <UIPath>Kunden > Kunde > Zugangskontrolle</UIPath>. Oben steht die Tabelle **Zugriffsmethoden** (Markierung **1** auf dem Screenshot unten).

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Kundenprofil Zugangskontrolle mit der Tabelle Zugriffsmethoden und dem Kennzeichen 1-DOC-2026" />
</Step>
<Step>
### Klicken Sie auf Hinzufügen und wählen Sie den Typ [#klik-op-toevoegen-en-kies-het-type]
<DocScreenshot src="/screenshots/toegangscontrole/access-method-create-dialog.png" alt="Dialog für eine neue Zugriffsmethode" />

Den Typ können Sie nachträglich nicht mehr ändern. Brauchen Sie einen anderen Typ, fügen Sie eine neue Zugriffsmethode hinzu.
</Step>
<Step>
### Füllen Sie die Daten aus [#vul-de-gegevens-in]
Was Sie eintragen, hängt vom Typ ab:
</Step>
</Steps>

<Tabs items={["Kennzeichen", "NFC", "QR-Code", "PIN-Code"]}>
<Tab value="Kennzeichen">
Tragen Sie bei **Kennzeichen** das Kennzeichen ein. Tillor wandelt es in Großbuchstaben um. Marke, Modell und Farbe sind optional.
</Tab>
<Tab value="NFC">
Wählen Sie bei **NFC-Karten** einen freien Tag aus der Liste. Sie können nach der Nummer des Tags suchen.
</Tab>
<Tab value="QR-Code">
Den Code erstellt Tillor selbst. Mit **Anzahl** legen Sie bis zu 100 separate QR-Zugriffsmethoden auf einmal an, jeweils mit eigenem Code. Aktivieren Sie **Thermoticket sofort drucken**, um jeden neuen QR-Code sofort als Eintrittsticket an den Thermodrucker zu senden. Die Adresse des Druckers stellen Sie in den Organisationseinstellungen ein. Auf dem Ticket stehen **Gültig von** und **Gültig bis** in der Zeitzone Ihrer Organisation.
</Tab>
<Tab value="PIN-Code">
Tragen Sie 4 bis 8 Ziffern ein oder klicken Sie auf **Generieren**. Der PIN-Code muss innerhalb Ihrer Organisation eindeutig sein. Bei einem PIN-Code fehlt die Aktion **Mit Zugangssystem synchronisieren**.
</Tab>
</Tabs>

Für jeden Typ können Sie zusätzlich ausfüllen:

| Feld | Bedeutung |
|---|---|
| **Von Datum**, **Bis Datum** | Der Zeitraum, in dem die Zugriffsmethode funktioniert. Leer bedeutet keine Grenze. |
| **Status** | **Aktiv**, **Inaktiv**, **Blockiert** oder **Weich blockiert** (siehe [Status](#statussen-van-toegangsmethoden)). |
| **Automatisch in Kennzeichen umwandeln** | Nur bei QR-Code und PIN-Code. Nutzt jemand den Code an einem Tor mit Kamera, ersetzt Tillor den Code durch das gelesene Kennzeichen. Standardmäßig aus. |
| **Nicht automatisch verlängern** | Das Enddatum bleibt unverändert, wenn eine Rechnung mit automatischer Verlängerung bezahlt wird. |
| **Anmerkungen** | Interne Notizen. |

Klicken Sie danach auf **Hinzufügen**, um zu speichern.

#### Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Zugriffsmethode steht in der Tabelle und Tillor sendet sie über den Connector an die Geräte. Das verfolgen Sie unter **Controller-Operationen**, mit dem Status <Status tone="info">Ausstehend</Status>, <Status tone="warning">Verarbeitung</Status>, <Status tone="success">Abgeschlossen</Status> oder <Status tone="error">Fehlgeschlagen</Status>.
- Eine geänderte oder gelöschte Zugriffsmethode wird auf dieselbe Weise weitergegeben.
- Jeder Versuch hereinzukommen erscheint im Zugangsprotokoll, auch die abgelehnten.
- Ein Fahrzeug wird dem Kunden über ein registriertes Kennzeichen zugeordnet oder dadurch, dass der Kunde mit einem NFC-Tag oder QR-Code hereingefahren ist, während die Kamera das Kennzeichen mitlas. Letzteres funktioniert auch, wenn das Kennzeichen nicht registriert ist.

#### Eine Zugriffsmethode bearbeiten, versenden oder löschen [#een-toegangsmethode-bewerken-versturen-of-verwijderen]

Klicken Sie auf die drei Punkte rechts neben der Zugriffsmethode.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-actions-menu.png" alt="Aktionsmenü einer Zugriffsmethode" />

| Aktion | Wofür |
|---|---|
| **Bearbeiten** | Zeitraum, Status oder Fahrzeugdaten anpassen. |
| **Mit Zugangssystem synchronisieren** | Erneut an die Geräte senden. Tillor meldet **Synchronisation angefordert**. Nicht bei einem PIN-Code. |
| **Benachrichtigung senden** | Schickt dem Kunden den persönlichen QR-Link per E-Mail, SMS oder WhatsApp (Dialog **QR-Code senden**). |
| **Persönliche URL kopieren** | Kopiert den Link zum Pass des Kunden, siehe [Digitale Wallet](#digitale-wallet-qr-code). |
| **QR-Code herunterladen**, **Thermisch-Ticket drucken** | Nur bei einem QR-Code. |
| **Entfernen** | Entfernt die Zugriffsmethode. Das kann nicht rückgängig gemacht werden. Mit den Häkchen in der Tabelle entfernen Sie mehrere gleichzeitig. |

#### Status von Zugriffsmethoden [#statussen-van-toegangsmethoden]

| Status | Bedeutung |
|---|---|
| <Status tone="success">Aktiv</Status> | Gewährt Zugang, solange der Zeitraum stimmt. |
| <Status>Inaktiv</Status> | Gewährt keinen Zugang. Wirkt wie Blockiert, mit klarerem Namen. |
| <Status tone="error">Blockiert</Status> | Gewährt keinen Zugang. |
| <Status tone="warning">Weich blockiert</Status> | Bei einem Kennzeichen nur während der Öffnungszeiten der Rezeption blockiert. Außerhalb davon kann das Fahrzeug noch ein- und ausfahren. |

## Digitale Wallet (QR-Code) [#digitale-wallet-qr-code]

Bei einer QR-Zugriffsmethode kopieren Sie einen persönlichen Link für den Gast. Er öffnet die Seite **Zugangspass** mit dem QR-Code. Sind Apple Wallet oder Google Wallet für Ihre Umgebung eingerichtet, stehen dort auch Schaltflächen, um den Pass zu speichern.

<Steps>
<Step>
### Kopieren Sie den Link [#kopieer-de-link]
Öffnen Sie die drei Punkte bei der QR-Zugriffsmethode und klicken Sie auf **Persönliche URL kopieren**. Tillor meldet **Link kopiert**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-personal-url-menu.png" alt="Aktionsmenü einer QR-Zugriffsmethode mit Persönliche URL kopieren" />
</Step>
<Step>
### Senden Sie den Link an den Gast [#stuur-de-link-naar-de-gast]
Der Gast sieht den QR-Code, die Gültigkeit und, falls verfügbar, **Zu Apple Wallet hinzufügen** und **Zu Google Wallet hinzufügen**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-public-view-wallet.png" alt="Gastseite Zugangspass mit QR-Code und Wallet-Schaltflächen" />
</Step>
</Steps>

Der Wallet-Pass nutzt denselben QR-Code, dieselbe Gültigkeit und denselben Status wie in Tillor. Auf einem iPhone mit iOS 27 erscheint der Pass als Poster Generic, optional mit eigenem Hintergrund und einem quadratischen QR-Code. Ältere iPhones zeigen das klassische Layout. Unter iOS 27 gibt es auf dem Pass außerdem Verknüpfungen: **Routenbeschreibung** öffnet Apple Maps zum Standort des Zugangspunkts (oder zur Mitte der Parkkarte), und wenn Sie bei Ihren Firmendaten eine Website hinterlegt haben, kommt eine Schaltfläche zu dieser Seite hinzu. Hintergrund und Standort stellen Sie unter **Einstellungen** ein, siehe [Organisation](/gebruikers/organisaties). Auf einem iPhone kann der Pass auf dem Sperrbildschirm erscheinen, wenn der Gast in der Nähe ist. Auf Android speichert der Gast den Pass in Google Wallet.

### Sehen, wo der Pass gespeichert ist [#zien-waar-de-pas-is-opgeslagen]

Hat ein Gast den Pass hinzugefügt, steht neben dem QR-Wert ein kleines Wallet-Symbol, bei mehr als einem Gerät mit einer Anzahl. Halten Sie die Maus darüber, um zu sehen:

- ob der Pass in **Apple Wallet auf dem iPhone** oder **Google Wallet auf Android** liegt und auf wie vielen Geräten
- wann der Pass **Zuletzt hinzugefügt** und **Pass aktualisiert** wurde, bei Apple auch **Zuletzt synchronisiert**
- ob der Pass **Ausgestellt über** einen **Mitarbeiter** oder einen **Persönlicher Link** wurde

Google meldet nicht, wenn ein Gast den Pass entfernt. Bei Google Wallet bleibt der Pass daher als gespeichert stehen.

### Einen Wallet-Pass erneut senden [#een-wallet-pas-opnieuw-versturen]

Ändert sich ein QR-Pass, zum Beispiel die Gültigkeit, sendet Tillor das Update selbst an die Wallets. Steht trotzdem noch eine alte Version, wählen Sie im Menü **Wallet-Pass synchronisieren**. Tillor meldet, wie viele Geräte das Update erhalten haben. Ist der Pass noch nirgends registriert, sehen Sie **Noch kein Gerät für Updates registriert.** Der Menüeintrag erscheint erst, wenn der Pass einer Wallet hinzugefügt wurde.

## Fahrzeuge im Park [#voertuigen-in-het-park]

Die Tabelle **Fahrzeuge im Park** hält je Kennzeichen fest, ob ein Fahrzeug im Park ist. Eine Lesung an einer Einfahrt setzt das Fahrzeug auf **Im Park**, eine Lesung an einer Ausfahrt auf **Ausgefahren**.

Jede Zeile zeigt das Kennzeichen, den Status, den Kunden, den Zeitpunkt der Einfahrt, den letzten Zeitpunkt, zu dem das Fahrzeug an einem Zugangspunkt gesehen wurde, und diesen Zugangspunkt. Die Tabelle zeigt standardmäßig die Fahrzeuge, die **Im Park** sind oder **Geisterfahrzeug**. Über die Filter zeigen Sie auch ausgefahrene Fahrzeuge an, filtern nach Zugangspunkt oder suchen nach Kennzeichen oder Kundenname.

| Status | Bedeutung |
|---|---|
| <Status tone="success">Im Park</Status> | Über eine Einfahrt hereingekommen und noch nicht wieder ausgefahren. |
| <Status tone="warning">Geisterfahrzeug</Status> | War auf Im Park, wurde aber seit 7 Tagen an keinem Zugangspunkt mehr gesehen. |
| <Status>Ausgefahren</Status> | Über eine Ausfahrt nach draußen gefahren. |

Ein Geisterfahrzeug entsteht meist, weil die Kamera das Kennzeichen bei der Ausfahrt nicht gelesen hat oder bei der Einfahrt falsch. Wird das Kennzeichen später erneut an einer Einfahrt gesehen, steht es wieder auf **Im Park**.

### Parkbelegung [#parkbezetting]

Die Karte **Parkbelegung** zeigt, wie viele Fahrzeuge im Park sind: **Aktuell im Park**, die **Spitze** im gewählten Zeitraum sowie die Anzahl der **Einfahrten** und **Ausfahrten**. Das erste Diagramm zeigt den Verlauf, pro Stunde bis einschließlich einer Woche und pro Tag bei einem längeren Zeitraum. **Beliebte Stunden** zeigt je Stunde des Tages die durchschnittliche Zahl der Fahrzeuge und Ankünfte. So sehen Sie zum Beispiel, wann genug los ist, um die Gastronomie zu öffnen. Mit der Zeitraumauswahl oben rechts wählen Sie heute, 7 Tage, 30 Tage, 90 Tage, alles oder einen eigenen Bereich.

## Zugangsprotokoll [#toegangslogboek]

Das Zugangsprotokoll zeigt jeden Versuch hereinzukommen, mit Datum, Zugriffsmethode, Kunde (sofern bekannt), Zugangspunkt und Status.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Zugangsprotokoll mit Kennzeichen, Kunde und Status" />

Filtern und suchen Sie nach Kennzeichen oder Wert (bei NFC auch nach Kartenbezeichnung), Datumsbereich, Status, Typ der Zugriffsmethode, Zugangspunkt oder Kunde. Mit **Exportieren** rechts in der Werkzeugleiste laden Sie das Protokoll als Excel-Datei herunter.

| Status | Bedeutung |
|---|---|
| Erlaubt | Der Zugang wurde gewährt. |
| Blockiert | Der Zugang wurde verweigert. |
| Inaktiv | Die Zugriffsmethode ist inaktiv. |
| Abgelaufen | Die Zugriffsmethode ist abgelaufen. |
| Ungültig | Die Zugriffsmethode ist ungültig. |
| Abgelehnt | Der Zugang wurde aktiv abgelehnt. |
| Weich blockiert | Der Zugang ist weich blockiert. |
| Gerätefehler | Es gab ein Problem mit dem Gerät. |
| Kein Auto | Es wurde kein Auto erkannt. |
| APB - Richtungskonflikt | Das Tor blockiert den Durchgang, weil die Richtung nicht stimmt (Anti-Passback). |
| Unbekannt | Der Status konnte nicht ermittelt werden. |
| Systemnachricht | Eine Nachricht des Systems selbst. |

## Torstatus-Verlauf [#hekstatusgeschiedenis]

Unter dem Zugangsprotokoll steht außerdem der **Torstatus-Verlauf**: wann ein Zugangspunkt **Geöffnet**, **Geschlossen** oder **In Bewegung** war, mit der **Quelle** der Meldung. Ist der Zustand nicht bekannt, steht dort **Unbekannt**. Filtern Sie nach Status oder Zugangspunkt. Ist die Liste leer, wurden noch keine Zustandsmeldungen empfangen.

## Controller-Operationen [#controller-operaties]

Darunter steht **Controller-Operationen**. Das sind die Befehle, die Tillor an die Zugangscontroller sendet, wie **Erstellen**, **Aktualisieren**, **Entfernen** und **Synchronisieren**. So sehen Sie, wann ein Pass oder QR-Code am Zugangspunkt angekommen ist.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Controller-Operationen mit Befehlen und ihrem Status" />

Ein Befehl steht auf <Status tone="info">Ausstehend</Status>, <Status tone="warning">Verarbeitung</Status>, <Status tone="success">Abgeschlossen</Status> oder <Status tone="error">Fehlgeschlagen</Status>. Mit dem Augen-Symbol rechts in der Zeile öffnen Sie die Details.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Block Schnellaktionen fehlt">
Der Block erscheint nur, wenn ein Zugangspunkt oder Zugangscontroller eingerichtet ist. Steht dort nichts, hat der Tillor-Support die Technik noch nicht verbunden.
</Accordion>
<Accordion title="Tillor meldet: Zugangspunkt konnte nicht geöffnet werden">
Der Zugangspunkt hat nicht reagiert. Meist ist der Connector offline oder das Gerät nicht erreichbar. Prüfen Sie den Connector, siehe [Connector nicht verbunden](/connector#problemen), und versuchen Sie es erneut.
</Accordion>
<Accordion title="Tillor meldet: Dieser Wert wird bereits verwendet">
Jedes Kennzeichen, jeder NFC-Tag und QR-Code darf in Ihrer Organisation nur einmal vorkommen. Bei einem Kennzeichen sagt Tillor, bei welchem Kunden es bereits steht. Entfernen oder ändern Sie zuerst diese Zugriffsmethode.
</Accordion>
<Accordion title="Ein Kunde kommt mit einem gültigen Kennzeichen nicht herein">
Sehen Sie im Zugangsprotokoll nach, welchen Status der Versuch erhielt. **Abgelaufen** oder **Inaktiv**: Prüfen Sie **Von Datum**, **Bis Datum** und **Status** der Zugriffsmethode. **Weich blockiert**: Das Kennzeichen ist während der Öffnungszeiten der Rezeption blockiert. **Gerätefehler** oder **Kein Auto**: Die Kamera hat nichts gelesen, prüfen Sie die Technik. Ist die Zugriffsmethode in Ordnung, das Tor weist aber trotzdem ab, sehen Sie unter **Controller-Operationen** nach, ob die letzte Änderung **Abgeschlossen** ist.
</Accordion>
<Accordion title="Eine neue Zugriffsmethode funktioniert am Tor noch nicht">
Sehen Sie unter **Controller-Operationen** nach, ob der Befehl <Status tone="success">Abgeschlossen</Status> ist. Steht er auf **Ausstehend**, ist der Connector wahrscheinlich offline. Steht er auf **Fehlgeschlagen**, wählen Sie bei der Zugriffsmethode **Mit Zugangssystem synchronisieren**.
</Accordion>
<Accordion title="Personen werden mit APB - Richtungskonflikt abgewiesen">
Das Tor glaubt, sie seien schon drinnen (oder draußen). Klicken Sie in den Schnellaktionen auf **APB zurücksetzen** und wählen Sie **Für NFC-Ausweise…** oder **Für QR-Codes…**. Bestätigen Sie mit **Zurücksetzen**.
</Accordion>
<Accordion title="Die Liste der NFC-Tags ist leer">
In der Liste stehen nur Tags, die noch niemandem gehören. Entfernen Sie einen Tag zuerst beim anderen Kunden, siehe [Tags verwalten](/nfc/nfc-tags#wat-kun-je-met-een-tag-doen).
</Accordion>
<Accordion title="Ein Fahrzeug steht als Geisterfahrzeug da">
Das Fahrzeug wurde seit 7 Tagen nicht gesehen. Meist ist es weg, ohne dass die Kamera es erfasst hat. Es steht von selbst wieder auf **Im Park**, wenn das Kennzeichen erneut an einer Einfahrt gelesen wird.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Zugriffsmethode**: der Schlüssel eines Kunden, ein Kennzeichen, NFC-Tag, QR-Code oder PIN-Code.
- **Zugangspunkt**: die Schranke, das Tor oder die Tür, die sich öffnet.
- **Zugangscontroller**: das Kästchen am Zugangspunkt, das Tags und QR-Codes liest.
- **Connector**: das Kästchen in Ihrem Park, das Tillor mit den Geräten verbindet. Siehe [Connector](/connector).
- **APB (Anti-Passback)**: die Regel, dass man nicht zweimal in dieselbe Richtung durch ein Tor kommt.
- **Geisterfahrzeug**: ein Fahrzeug, das als im Park geführt wird, aber seit 7 Tagen nicht gesehen wurde.

Mehr Erklärungen finden Sie im [Glossar](/begrippen).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Connector" href="/connector" description="Das Kästchen, das Tillor mit Ihren Geräten verbindet" />
  <Card title="NFC" href="/nfc" description="Tags verknüpfen und Guthaben verwalten" />
  <Card title="Einstellungen für die Zugangskontrolle" href="/gebruikers/instellingen-toegangscontrole" description="Kulanz für abgelaufene Kennzeichen" />
  <Card title="Kundenverwaltung" href="/klantenbeheer" />
</Cards>


# Wetter (/de-DE/weer)

Auf der Seite **Wetter** sehen Sie pro Tag das Wetter am Standort Ihres Parks, damit Sie eine Spitze bei Verbrauch oder Andrang neben das Wetter legen können. Tillor verwendet diese Daten auch bei den Zählern und Reservierungen.

<Callout type="info" title="Gut zu wissen">
- Das Wetter gehört zum Kartenzentrum Ihrer Organisation. Steht dieses falsch, stimmt das Wetter nicht.
- Tillor ruft das Wetter jede Nacht ab und ergänzt fehlende Tage aus der Vergangenheit.
- Standardmäßig sehen Sie die letzten 14 Tage.
- Ein Tag mit **Archiv** ist endgültig. Ein Tag mit **Prognose** kann sich noch ändern.
</Callout>

## Die Seite öffnen [#de-pagina-openen]

Gehen Sie zu <UIPath>Park > Wetter</UIPath>.

<DocScreenshot src="/screenshots/weer/weather-overview.png" alt="Park > Wetter mit der Tagesvorhersage" />

Unter **Tagesvorhersage** steht der Standort, zum Beispiel **Kartenmittelpunkt: 50.8503, 4.3517**. Das ist das Kartenzentrum Ihres Parks. Sie stellen es unter <UIPath>Einstellungen > Karte</UIPath> ein. Verschieben Sie es, folgt das Wetter dem neuen Ort. Siehe [Karte](/kaart).

Sie sehen:

- eine große Karte für den jüngsten Tag mit Temperatur, Wetterlage, Höchst- und Tiefsttemperatur und der Regenmenge. Neben dem Tag steht **Archiv** für einen bereits endgültigen Tag oder **Prognose** für einen Tag, der noch aktualisiert werden kann
- darunter eine Karte pro Tag, mit der Wetterlage wie **Klar**, **Teilweise bewölkt**, **Bewölkt**, **Nebel**, **Nieselregen**, **Regen**, **Schauer**, **Schnee** oder **Gewitter**, der Höchst- und Tiefsttemperatur und dem Regen in mm. Heute hat einen farbigen Rand
- **Keine Daten für diesen Tag** an einem Tag, zu dem Tillor nichts hat

## Einen anderen Zeitraum wählen [#een-andere-periode-kiezen]

Standardmäßig sehen Sie die letzten 14 Tage. Klicken Sie oben rechts auf **Zeitraum auswählen**, um einen anderen Zeitraum zu wählen: **Heute**, **Gestern**, **Letzte 7 Tage**, **Letzter Monat**, **Letzte 3 Monate**, **Alle** oder einen **Benutzerdefinierter Bereich** im Kalender. Bestätigen Sie einen eigenen Bereich mit **Anwenden**.

## Noch keine Wetterdaten [#nog-geen-weergegevens]

Steht dort **Noch keine Wetterdaten**, wurde das Wetter noch nicht abgerufen. Tillor ruft es jede Nacht für das Kartenzentrum Ihrer Organisation ab und ergänzt auch fehlende Tage aus der Vergangenheit. Versuchen Sie einen anderen Zeitraum oder schauen Sie am nächsten Tag wieder vorbei. Prüfen Sie auch, ob das Kartenzentrum stimmt.

## Wo sehen Sie das Wetter noch [#waar-zie-je-het-weer-nog-meer]

- Auf der Zählerseite, bei **Verbrauch & Trends**: Bei einem Spitzentag steht die Temperatur und bei erhöhtem Verbrauch eine Zusammenfassung der letzten 7 Tage. Siehe [Zählerverwaltung](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).
- Auf der Zeitleiste der Reservierungen und in den Diagrammen der Fahrzeuge im Park, beim Wetter des jeweiligen Tages.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Es steht Noch keine Wetterdaten da">
Das Wetter wurde noch nicht abgerufen. Versuchen Sie einen anderen Zeitraum oder schauen Sie am nächsten Tag wieder vorbei, und prüfen Sie, ob das Kartenzentrum stimmt.
</Accordion>
<Accordion title="Das Wetter passt nicht zu meinem Park">
Das Kartenzentrum liegt an einem anderen Ort. Verschieben Sie es unter <UIPath>Einstellungen > Karte</UIPath>, siehe [Karte](/kaart#kaartstandaard-instellen). Das Wetter folgt dem neuen Ort.
</Accordion>
<Accordion title="Bei einem Tag steht Keine Daten für diesen Tag">
Für diesen Tag hat Tillor nichts. Es wird von selbst ergänzt, sobald die Daten verfügbar sind.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Karte" href="/kaart" description="Das Kartenzentrum Ihres Parks einstellen" />
  <Card title="Zählerverwaltung" href="/meterbeheer" description="Verbrauch und Trends pro Zähler" />
</Cards>


# Übersicht (/de-DE/api-referentie)

Diese Referenz wird direkt aus der Tillor-API generiert. Jeder Endpoint hat eine eigene Seite mit Parametern, Request-Body, möglichen Responses und Codebeispielen. In der Seitenleiste sind die Endpoints nach Thema gruppiert.

## Einen Request senden [#een-request-versturen]

Jeder Request benötigt Ihren API-Schlüssel im Header `x-api-key`. Endpoints unter `/orgs/{organizationId}` arbeiten innerhalb einer Organisation.

```http
GET https://api.tillor.eu/orgs/org_abc123/customers
x-api-key: tkn_xxx
```

Einen API-Schlüssel erstellen Sie in der App, unter Ihrem Konto. Wie das funktioniert, welche Rate Limits gelten und wie Sie Schlüssel sicher aufbewahren, lesen Sie unter [HTTP API](/ontwikkelaars/http).

## Wer einen Endpunkt aufrufen darf [#wie-mag-een-endpoint-aanroepen]

Jede Endpunktseite zeigt oben unter **Zugriff**, wer den Endpunkt aufrufen darf. Bei den meisten Endpunkten ist das ein Mitglied der Organisation mit einer bestimmten Berechtigung, etwa `customers:read`. Ein API-Schlüssel arbeitet mit den Berechtigungen der Person, die ihn erstellt hat; hat der Schlüssel Scopes, muss die Berechtigung auch darin stehen. Sonst antwortet die API mit `403`.

In der Spezifikation steht dieselbe Information pro Endpunkt in `x-tillor-access`, mit `access` (wer) und `permissions` (eine davon genügt).

## In der Playground ausprobieren [#uitproberen-in-de-playground]

Auf jeder Endpoint-Seite können Sie den Request sofort senden. Sind Sie im selben Browser bei Tillor angemeldet, verwendet die Playground Ihre Sitzung und Sie brauchen keinen API-Schlüssel. Andernfalls tragen Sie Ihren API-Schlüssel bei **Authorization** ein. Passen Sie die Parameter an und klicken Sie auf **Send**.

Die Playground spricht mit der echten API Ihrer Organisation: Ein `POST`, `PUT` oder `DELETE` ändert also echte Daten.

<Callout type="warn" title="Verwenden Sie eine Testorganisation">
Probieren Sie schreibende Endpoints in einer Testorganisation aus, nicht in Ihrem Park im Echtbetrieb.
</Callout>

## Spezifikation herunterladen [#specificatie-downloaden]

Die vollständige Spezifikation steht als OpenAPI 3.1 unter [tillor.eu/api/openapi.json](https://tillor.eu/api/openapi.json). Importieren Sie sie in Postman oder Insomnia oder generieren Sie damit einen Client.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="HTTP API" description="Authentifizierung, Rate Limits und Konventionen" href="/ontwikkelaars/http" />
  <Card title="Webhooks" description="Events an Ihrer eigenen URL empfangen" href="/ontwikkelaars/webhooks" />
</Cards>


# Einen Controller verwalten (/de-DE/controllers/controller-beheren)

Auf der Seite eines Controllers passen Sie seine Daten an und führen Wartung durch. Einstellungen wie ACL, Netzwerk und Updates stehen getrennt unter [Controller-Einstellungen](/controllers/settings).

Bevor Sie beginnen:

- Der Controller ist genehmigt, siehe [Einen Controller verbinden](/controllers/controller-koppelen).

## Namen, Typ und Gruppe ändern [#naam-type-en-groep-wijzigen]

<Steps>
<Step>
### Öffnen Sie den Controller [#open-de-controller]
Gehen Sie zu <UIPath>Controller > Übersicht</UIPath> und klicken Sie auf den Controller.
</Step>
<Step>
### Passen Sie das Formular an [#pas-het-formulier-aan]
Unter **Controller-Einstellungen** wählen Sie den **Name**, den **Typ** (**Dusche**, **Zugang** oder **Ladestation**) und die **Gruppe**.
</Step>
<Step>
### Klicken Sie auf Speichern [#klik-op-opslaan]
Tillor meldet **Controller aktualisiert** und sendet die Einstellungen an den Controller.
</Step>
</Steps>

## Einen Controller neu starten [#een-controller-herstarten]

Reagiert ein Controller nicht richtig, starten Sie ihn aus Tillor neu.

<Tabs items={["Auf der Detailseite", "In der Übersicht"]}>
<Tab value="Auf der Detailseite">
Öffnen Sie das Aktionsmenü (die drei Punkte) und wählen Sie **Controller neu starten**.

<DocScreenshot src="/screenshots/controllers/controller-actions-menu.png" alt="Aktionsmenü eines Controllers mit Controller neu starten" />
</Tab>
<Tab value="In der Übersicht">
Klicken Sie auf das Neustart-Symbol in der Zeile des Controllers.
</Tab>
</Tabs>

Das Display zeigt **Neustart** und der Controller verbindet sich danach erneut.

Das Aktionsmenü hat außerdem **Logs in Grafana anzeigen**. Das öffnet die Protokolle des Controllers in einem anderen Programm, gedacht für den Support. Auf der Controller-Seite selbst stehen die aktuellen Logs in der Karte **Konsole**.

## Auf eine neue Version aktualisieren [#bijwerken-naar-een-nieuwe-versie]

Steht neben der Versionsnummer ein Pfeil nach oben, ist eine neuere <Term term="firmware">Firmware</Term> (Software) verfügbar. Fahren Sie mit der Maus darüber, um die Version zu sehen (**Update verfügbar**), und klicken Sie darauf, um das Update zu starten. Tillor meldet **OTA-Update gestartet**. Wann Controller selbst aktualisieren, lesen Sie unter [Firmware-Updates](/controllers/updates).

## Einen Controller löschen [#een-controller-verwijderen]

Wählen Sie im Aktionsmenü **Controller löschen** und bestätigen Sie bei **Controller löschen**. Der Controller verschwindet aus Ihrer Liste. Er kann danach erneut eine Adoption anfragen.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Nach einem Neustart verbindet sich der Controller erneut mit Tillor. Das dauert einen Moment.
- Nach dem Aktualisieren startet der Controller selbst neu. Lassen Sie den Strom an, während das Display **Aktualisieren** mit einem Prozentwert zeigt.
- Ein gelöschter Controller gewährt keinen Zugang mehr.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet: Neustart fehlgeschlagen">
Der Controller konnte nicht neu gestartet werden, meist weil er offline ist. Prüfen Sie Strom und Netzwerk, siehe [Verbindungsprobleme](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="Tillor meldet: OTA-Update fehlgeschlagen">
Das Update konnte nicht gestartet werden. Prüfen Sie, ob der Controller online ist und ob **OTA-Updates überspringen** auf **Nein** steht, siehe [Firmware-Updates](/controllers/updates).
</Accordion>
<Accordion title="Tillor meldet: Aktualisierung fehlgeschlagen">
Das Formular konnte nicht gespeichert werden. Versuchen Sie es noch einmal und prüfen Sie, ob der Name ausgefüllt ist.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Controller-Einstellungen" href="/controllers/settings" description="ACL, Netzwerk, Updates und Relais" />
  <Card title="Firmware-Updates" href="/controllers/updates" description="Update-Zeitfenster und Häufigkeit" />
</Cards>


# Einen Controller verbinden (/de-DE/controllers/controller-koppelen)

Ein neuer Controller funktioniert für Ihre Organisation erst, nachdem Sie ihn genehmigt haben. Das heißt Adoption: Sie sagen in Tillor, dass dieses Kästchen zu Ihrem Park gehört. Danach können Sie ihm einen Typ und eine Gruppe geben, siehe [Einen Controller verwalten](/controllers/controller-beheren).

Bevor Sie beginnen:

- Sie haben Strom und ein Netzwerk (Kabel oder WLAN) an der Stelle, an der der Controller montiert wird.
- Nutzen Sie WLAN, haben Sie den Netzwerknamen und das Passwort zur Hand.
- Öffnen Sie Tillor am besten im selben Netzwerk wie der Controller. Sonst sehen Sie seine Anfrage manchmal nicht.

## Den Controller anschließen und genehmigen [#de-controller-aansluiten-en-goedkeuren]

<Steps>
<Step>
### Schließen Sie den Controller an [#sluit-de-controller-aan]
Stecken Sie den Strom ein. Das Display zeigt **Verbinden...** und danach, was noch fehlt.
</Step>
<Step>
### Geben Sie ihm ein Netzwerk [#geef-hem-een-netwerk]
<Tabs items={["Netzwerkkabel", "WLAN"]}>
<Tab value="Netzwerkkabel">
Stecken Sie das Netzwerkkabel ein. Der Controller verbindet sich von selbst, Sie müssen nichts einstellen.
</Tab>
<Tab value="WLAN">
Tippen Sie auf dem Display auf **WLAN einrichten**, wählen Sie Ihr Netzwerk, geben Sie das Passwort ein und bestätigen Sie. Das Display zeigt **Verbunden**. Siehe [WLAN auf dem Display einrichten](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).
</Tab>
</Tabs>
</Step>
<Step>
### Öffnen Sie Controller in Tillor [#open-controllers-in-tillor]
Gehen Sie zu <UIPath>Controller > Übersicht</UIPath>. Sobald der Controller eine Verbindung hat, steht er in der Liste mit dem Hinweis **Wartet auf Genehmigung**. Das Display des Controllers zeigt **Controller aktivieren** mit der Nummer des Geräts. Diese Nummer ist die <Term term="eFuse ID">eFuse ID</Term>, die Seriennummer des Kästchens. Prüfen Sie, dass sie in der Liste dieselbe ist.
</Step>
<Step>
### Klicken Sie auf Genehmigen [#klik-op-goedkeuren]
Klicken Sie in der Zeile auf das Häkchen (**Genehmigen**). Tillor meldet **Genehmigt** und der Controller ist Ihrer Organisation hinzugefügt.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Display des Controllers zeigt **QR scannen** und **Scannen Sie Ihren Tag**. Er ist einsatzbereit.
- Tillor sendet die Verbindungsdaten und Einstellungen automatisch an den Controller. Sie müssen nichts eintragen.
- Sein erster Scan legt den Tag in Tillor an, falls er dort noch nicht stand.
- Mit dem Kreuz (**Ablehnen**) lehnen Sie eine Anfrage ab. Dann erhält der Controller keinen Zugang zu Ihrer Organisation.
- Bauen Sie einen Controller später ab oder ersetzen ihn, löschen Sie ihn, siehe [Einen Controller verwalten](/controllers/controller-beheren#een-controller-verwijderen). Er kann danach erneut eine Anfrage stellen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Controller steht nicht in der Liste">
Das Display muss **Controller aktivieren** zeigen, bevor er erscheint. Steht dort noch **WLAN einrichten** oder **Verbinden...**, ist er noch nicht online. Öffnen Sie Tillor auch einmal im selben Netzwerk wie der Controller und laden Sie die Seite neu. Weitere Schritte finden Sie unter [Controller erscheint nicht in Tillor](/controllers/troubleshooting/verbinding#controller-verschijnt-niet-in-tillor).
</Accordion>
<Accordion title="Tillor meldet: Genehmigung fehlgeschlagen">
Die Adoption konnte nicht genehmigt werden. Versuchen Sie es noch einmal. Schlägt es weiter fehl, prüfen Sie, ob die Uhr des Controllers stimmt, und wenden Sie sich an den Support. Siehe [Adoption fehlgeschlagen](/controllers/troubleshooting/verbinding#adoptie-mislukt-of-credentials-worden-geweigerd).
</Accordion>
<Accordion title="Das Display bleibt auf Verbinden... stehen">
Warten Sie 1 bis 2 Minuten. Bleibt es so, prüfen Sie das Kabel oder das WLAN-Signal. Siehe [Display bleibt auf Verbinden...](/controllers/troubleshooting/verbinding#scherm-blijft-op-verbinden).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Einen Controller verwalten" href="/controllers/controller-beheren" description="Name, Gruppe, Neustart und Löschen" />
  <Card title="Displaymeldungen" href="/controllers/troubleshooting/scherm" description="Was der Controller anzeigt" />
</Cards>


# Übersicht (/de-DE/controllers)

Ein Controller ist ein kleines Kästchen mit rundem Touchscreen in Ihrem Park, an einer Dusche, Tür oder Ladestelle. Ein Gast hält einen <Term term="NFC">NFC</Term>-Tag daran oder scannt den QR-Code auf dem Display, und Tillor entscheidet, ob es erlaubt ist. Hier lesen Sie, was ein Controller tut und wie er mit Kunden und Guthaben zusammenhängt. Einen neuen Controller nehmen Sie über [Einen Controller verbinden](/controllers/controller-koppelen) in Betrieb.

Die Controller stehen im Hauptmenü unter **Controller**. Die Schranken und Zugangscontroller an Ihrem Tor gehören nicht dazu, siehe [Zugangskontrolle](/toegangscontrole).

<Callout type="info" title="Gut zu wissen">
- Ein Controller meldet sich alle 15 Sekunden bei Tillor. Nach etwa 35 Sekunden ohne Kontakt zeigt Tillor ihn als offline an.
- Nach 5 Minuten ohne Kontakt erhält das Tillor-Team eine Meldung.
- Ein Controller merkt sich höchstens 8 WLAN-Netzwerke.
- Die Zugangskontrolle über den Controller (ACL) ist standardmäßig aus. Aktivieren Sie **ACL aktiviert** in den [Einstellungen](/controllers/settings), damit Tags geprüft werden.
- Standardmäßig prüft er täglich auf eine neue Softwareversion. Ein Update startet nur innerhalb des Update-Zeitfensters, wenn Sie eines eingestellt haben.
- Standardmäßig wartet er 1000 Millisekunden (1 Sekunde) auf Tillor, bevor er umschaltet, bei der Einstellung **API-ACL-Timeout**.
- Bei einer kurzen Unterbrechung funktioniert das Bezahlen mit einem Tag weiter. Das Bezahlen über den QR-Code funktioniert dann kurz nicht.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Der Controller entscheidet nicht selbst, wer hindurch darf. Er liest den Tag und fragt Tillor. Dort steht, zu welchem Kunden der Tag gehört, für welche Zugangsgruppen er gilt und wie viel Guthaben darauf ist.

```mermaid
flowchart TD
  G[Gast houdt tag tegen het scherm] --> C[Controller]
  C -->|vraagt of het mag| T[Tillor]
  T --> K[Klant van de tag]
  T --> A[Toegangsgroepen en saldo]
  T -->|toestaan of weigeren| C
  C -->|toont het resultaat| G
  T --> TR[Transactie in de tag-geschiedenis]
```

- Jeder Controller hat einen **Typ** (**Dusche**, **Zugang** oder **Ladestation**) und gegebenenfalls eine **Gruppe**. Welche Tags hier erlaubt sind, regeln Sie mit den Zugangsgruppen des Tags, siehe [Tags verwalten](/nfc/nfc-tags).
- Kann der Controller Tillor kurz nicht erreichen, nutzt er mit **Lokal zuerst** die Daten, die er sich selbst gemerkt hat, siehe [Einstellungen](/controllers/settings).
- Ein Tag, der noch nicht in Tillor steht, wird angelegt, sobald er zum ersten Mal an einen Controller gehalten wird.

## Was sehen Sie in Tillor? [#wat-zie-je-in-tillor]

- **Controller-Übersicht**: alle Controller mit ihrer Version, Typ, Gruppe, Nutzung und dem Zeitpunkt, an dem sie **Zuletzt gesehen** wurden. Controller, die verbunden werden wollen, stehen auf **Wartet auf Genehmigung**.
- **Controller-Detail**: Status, Netzwerk, wie stark der Controller belastet ist, die WLAN-Netzwerke, die Ereignisse und die Karte **Konsole** mit den Logs.
- **Verwaltung**: Neustart, Aktualisieren und Löschen, siehe [Einen Controller verwalten](/controllers/controller-beheren).

## Bestandteile [#onderdelen]

<Cards>
  <Card title="Einen Controller verbinden" href="/controllers/controller-koppelen" description="Anschließen und genehmigen" />
  <Card title="Einen Controller verwalten" href="/controllers/controller-beheren" description="Name, Gruppe, Neustart und Löschen" />
  <Card title="WLAN-Netzwerke einrichten" href="/controllers/wifi-netwerken" description="Bis zu 8 Netzwerke nach Priorität geordnet" />
  <Card title="Controller-Einstellungen" href="/controllers/settings" description="ACL, Netzwerk, Updates und Relais" />
  <Card title="Firmware-Updates" href="/controllers/updates" description="Update-Zeitfenster und Häufigkeit" />
  <Card title="Displaymeldungen" href="/controllers/troubleshooting/scherm" description="Was bedeutet die Meldung auf dem Display?" />
  <Card title="Verbindungsprobleme" href="/controllers/troubleshooting/verbinding" description="WLAN, Tillor-Verbindung und Adoption" />
  <Card title="Glossar" href="/controllers/lexicon" description="Begriffe wie OTA, Adoption und ACL" />
</Cards>

## Begriffe [#begrippen]

- **Controller**: das Kästchen mit Display und Tag-Leser.
- **Tag**: die Karte, das Armband oder der Schlüsselanhänger eines Gastes. Siehe [NFC](/nfc).
- **Adoption**: Sie verbinden einen neuen Controller mit Ihrer Organisation.
- **ACL**: die Liste, die bestimmt, ob ein Tag erlaubt ist. Siehe [das Glossar](/controllers/lexicon).
- **Firmware**: die Software im Kästchen.

Mehr Erklärungen finden Sie im [Glossar](/begrippen).


# Glossar (/de-DE/controllers/lexicon)

Eine Übersicht der Begriffe, die Ihnen bei der Arbeit mit Controllern begegnen. Bei jedem Begriff steht eine Erklärung und, in einem Blockzitat, was wir damit in einfachen Worten meinen.

## A [#a]

<LexiconList>
<LexiconEntry
  term="ACL"
  termAlt="(Access Control List)"
  definition="Zugangskontrolle über den Controller. Bei eingeschalteter ACL prüft er, ob eine NFC-Karte erlaubt ist; bei ausgeschalteter ACL werden Karten zwar gescannt, aber nicht validiert. Die ACL-Priorität bestimmt, ob er zuerst lokal nachsieht oder Tillor online befragt."
  simple="Der Controller schaut in einer Liste nach, ob Ihre Karte erlaubt ist. Diese Liste heißt ACL."
/>
<LexiconEntry
  term="Adoption"
  definition="Das Verbinden eines Controllers mit Ihrer Organisation in Tillor. Nach der Adoption erhält der Controller die richtigen Einstellungen und kann sich mit Tillor verbinden."
  simple="Sie sagen in Tillor: 'Dieser Controller gehört uns.' Danach kennt der Controller Ihre Organisation und arbeitet mit."
/>
<LexiconEntry
  term="API"
  definition="Das Online-Befragen von Tillor bei der Zugangskontrolle. Bei API zuerst fragt der Controller immer Tillor; bei Lokal zuerst tut er das erst, wenn die Karte lokal nicht vorhanden ist."
  simple="Der Controller fragt Tillor online, ob eine Karte erlaubt ist. Dieses Online-Fragen nennen wir die API."
/>
</LexiconList>

## C [#c]

<LexiconList>
<LexiconEntry
  term="Controller"
  definition="Das physische Kästchen in Ihrem Park. Der Controller liest NFC-Karten, prüft den Zugang und kommuniziert mit Tillor."
  simple="Das Kästchen an der Dusche oder Tür, an das Sie Ihren Tag halten."
/>
<LexiconEntry
  term="Credentials"
  definition="Anmelde- oder Verbindungsdaten. Nach der Adoption erhält der Controller automatisch die richtigen Credentials, um sich mit Tillor zu verbinden."
  simple="Die Anmeldedaten, mit denen sich der Controller nach der Adoption sicher mit Tillor verbindet. Er bekommt sie automatisch - Sie müssen nichts eintragen."
/>
</LexiconList>

## E [#e]

<LexiconList>
<LexiconEntry
  term="eFuse ID"
  termAlt="(Electronic Fuse ID)"
  definition="Eine eindeutige Kennnummer, die in der Hardware des Controllers gespeichert ist. Jeder Controller hat eine andere eFuse ID - daran erkennt Tillor, welches Kästchen es ist."
  simple="Die Fingerabdruck-Nummer des Kästchens. Wie eine Seriennummer, aber fest im Chip eingebrannt."
/>
</LexiconList>

## F [#f]

<LexiconList>
<LexiconEntry
  term="Firmware"
  definition="Die Software, die auf dem Controller läuft. Über Firmware-Updates erhält der Controller neue Funktionen und Verbesserungen."
  simple="Das Programm im Kästchen. Wie bei Ihrem Telefon, das ein Update bekommt."
/>
</LexiconList>

## N [#n]

<LexiconList>
<LexiconEntry
  term="NFC"
  definition="Near Field Communication - die Technik, mit der der Controller Karten, Armbänder und Schlüsselanhänger liest. Sie halten den Tag zum Scannen an das Display."
  simple="So liest der Controller Ihren Tag. Sie halten den Tag daran - kein Strichcode oder PIN-Code."
/>
</LexiconList>

## O [#o]

<LexiconList>
<LexiconEntry
  term="OTA"
  termAlt="(Over-The-Air)"
  definition="Updates über das Internet, ohne dass Sie etwas anschließen müssen. Der Controller lädt neue Firmware automatisch herunter und installiert sie."
  simple="Das Kästchen holt sich neue Software selbst über das Internet. Sie müssen nichts tun - es passiert von selbst."
/>
</LexiconList>

## R [#r]

<LexiconList>
<LexiconEntry
  term="Relais"
  definition="Ein Schalter im Controller, mit dem Sie einen Zugangspunkt oder ein anderes Gerät ansteuern können."
  simple="Ein Schalter im Kästchen, der Ihren Zugangspunkt öffnen oder schließen kann."
/>
</LexiconList>

## S [#s]

<LexiconList>
<LexiconEntry
  term="Display"
  definition="Der runde Touchscreen des Controllers. Er zeigt den Status in einfacher Sprache (bereit, bezahlt, abgelehnt, keine Verbindung), den QR-Code zum Online-Bezahlen, und Sie richten dort das WLAN ein. Der Tag-Leser sitzt hinter dem Display."
  simple="Das runde Display, an das Sie Ihren Tag halten. Es sagt, was gerade passiert."
/>
</LexiconList>

## T [#t]

<LexiconList>
<LexiconEntry
  term="Tag"
  definition="Der NFC-Träger, den ein Gast erhält: eine Karte, ein Armband, ein Schlüsselanhänger oder ein Aufkleber. Der Tag ist in Tillor mit einem Kunden verknüpft und kann ein Guthaben haben."
  simple="Die Karte, das Armband oder der Schlüsselanhänger, mit dem Sie duschen oder hereinkommen."
/>
<LexiconEntry
  term="Tillor"
  definition="Die Parkverwaltungsplattform. Der Controller verbindet sich mit Tillor, um den Zugang zu prüfen und Daten auszutauschen."
  simple="Das Programm, in dem Sie arbeiten - auf Ihrem Computer oder Tablet. Der Controller spricht damit."
/>
</LexiconList>

## U [#u]

<LexiconList>
<LexiconEntry
  term="Update-Zeitfenster"
  definition="Das Zeitfenster, in dem der Controller aktualisieren darf (z. B. zwischen 02:00 und 04:00). Außerhalb dieses Fensters werden keine Updates ausgeführt."
  simple="Sie wählen selbst, wann das Kästchen aktualisieren darf. Zum Beispiel nur nachts, damit tagsüber niemand etwas davon merkt."
/>
</LexiconList>


# Controller-Einstellungen (/de-DE/controllers/settings)

Dies ist eine Nachschlageseite zu den Einstellungen eines Controllers. Sie finden sie unter <UIPath>Controller > Übersicht > [Name des Controllers]</UIPath>, im Formular unter der Kopfzeile. Klicken Sie auf **Speichern**, um Änderungen zu übernehmen. Tillor sendet die Einstellungen danach an den Controller. Name, Typ und Gruppe ändern Sie unter [Einen Controller verwalten](/controllers/controller-beheren).

## ACL-Konfiguration [#acl-configuratie]

Die <Term term="ACL">ACL</Term> (Access Control List) bestimmt, wie der Controller den Zugang prüft. *Anders gesagt: wie das Kästchen prüft, ob eine Karte erlaubt ist.*

| Einstellung | Bedeutung |
| ---------- | --------- |
| **ACL aktiviert** | Stellen Sie auf **Ja**, um die Zugangskontrolle über den Controller zu nutzen. Bei **Nein** werden Karten zwar gescannt, aber nicht validiert. Standardmäßig steht dies auf **Nein**. |
| **ACL-Priorität** | **Lokal zuerst**: Der Controller prüft zuerst seinen eigenen Speicher, danach Tillor. *Praktisch, wenn das Internet kurz ausfällt.* **API zuerst**: immer direkt Tillor fragen. Standard ist **Lokal zuerst**. |
| **<Term term="API">API</Term>-ACL-Timeout** | Wie lange (in Millisekunden) der Controller auf Tillor wartet, bevor er umschaltet. Standard 1000 ms (1 Sekunde). |

<Callout type="info" title="Wann Lokal zuerst?">
Wählen Sie **Lokal zuerst**, wenn der Controller auch bei vorübergehenden Internetstörungen funktionieren soll. Der Controller speichert Zugangsrechte lokal.
</Callout>

## Internet-Konfiguration [#internetconfiguratie]

| Einstellung | Bedeutung |
| ---------- | --------- |
| **Primäre Netzwerkverbindung** | **WiFi** oder **Ethernet** (Netzwerkkabel). Das ist die Verbindung, die der Controller zuerst versucht. Standard ist **WiFi**. |
| **WLAN-Netzwerke** | Die Liste der WLAN-Netzwerke, die der Controller kennt, mit einem Maximum von 8. Siehe [WLAN-Netzwerke einrichten](/controllers/wifi-netwerken). |

## Update-Konfiguration [#updateconfiguratie]

Unter [<Term term="firmware">Firmware</Term>-Updates](/controllers/updates) finden Sie eine ausführliche Erklärung zu Update-Häufigkeit, Update-Zeitfenster und dem Überspringen von OTA-Updates.

| Einstellung | Bedeutung |
| ---------- | --------- |
| **Update-Häufigkeit** | Wie oft das Kästchen nach einer neuen Version sucht: **Stündlich**, **Täglich** oder **Wöchentlich**. |
| **Update-Zeitraum von/bis** | *Wann darf das Kästchen aktualisieren?* Z. B. 02:00-04:00 = nur nachts. |
| **<Term term="OTA">OTA</Term>-Updates überspringen** | Stellen Sie auf **Ja**, wenn das Kästchen keine Updates mehr abrufen darf. *Vorübergehend praktisch, normalerweise lassen Sie dies auf Nein.* |

## Relaissteuerung [#relais-aansturing]

Das <Term term="relais">Relais</Term> ist ein Schalter im Kästchen. *Sie können damit zum Beispiel einen Zugangspunkt öffnen oder schließen.*

| Einstellung | Bedeutung |
| ---------- | --------- |
| **Relaistyp** | Derzeit wird nur **Intern** unterstützt. |
| **Relais-Port** | Portnummer des Relais. Standard 1. |

## Siehe auch [#zie-ook]

<Cards>
  <Card title="WLAN-Netzwerke einrichten" href="/controllers/wifi-netwerken" description="Netzwerke und Priorität" />
  <Card title="Firmware-Updates" href="/controllers/updates" description="Update-Zeitfenster und OTA-Einstellungen" />
  <Card title="Displaymeldungen" href="/controllers/troubleshooting/scherm" description="Was das Display des Controllers anzeigt" />
</Cards>


# Displaymeldungen (/de-DE/controllers/troubleshooting/scherm)

Der Controller hat einen runden <Term term="scherm">Touchscreen</Term>. Er zeigt in einfacher Sprache, was der Controller tut: einen Titel, darunter eine Zeile Erklärung und einen farbigen Rand. *Sie müssen sich also keine Farben mehr merken: Es steht einfach da.* Unten finden Sie jede Meldung und was Sie damit tun.

## Einsatzbereit [#klaar-voor-gebruik]

| Auf dem Display | Bedeutung |
| ------------- | --------- |
| **QR scannen** und **Scannen Sie Ihren Tag**, mit **Zu bezahlen** und einem Betrag | Der Controller ist bereit. Der Gast hält einen Tag an das Display oder scannt den QR-Code mit dem Handy. |
| QR-Code grau und durchgestrichen | Der Controller hat vorübergehend keine Verbindung zu Tillor. Das Bezahlen mit einem Tag funktioniert weiter, das Online-Bezahlen über den QR-Code kurz nicht. |

## Einen Tag scannen [#een-tag-scannen]

Einen <Term term="NFC">NFC</Term>-Tag scannen Sie, indem Sie ihn kurz an das Display halten, wie beim kontaktlosen Bezahlen.

| Auf dem Display | Bedeutung |
| ------------- | --------- |
| **Einen Moment** - Zahlung wird verarbeitet | Der Tag wurde gelesen, der Controller fragt Tillor, ob es erlaubt ist. Halten Sie den Tag noch kurz an das Display. |
| **Zahlung erfolgreich!** mit dem abgebuchten Betrag und dem Guthaben | Bezahlt. Die Dusche oder das Gerät startet. |
| **Willkommen** mit dem Namen des Gastes | Zugang gewährt, bei einer Tür oder Einrichtung ohne Bezahlung. |

Wird ein Tag abgelehnt, steht der Grund auf dem Display:

| Auf dem Display | Was ist los | Was tun Sie |
| ------------- | --------------------- | ---------- |
| **Tag nicht erkannt** - Dieser Tag gehört nicht hierher | Der Tag gehört nicht zu Ihrem Park. | Geben Sie dem Gast einen Tag des Parks. |
| **Tag nicht erkannt** - Dies ist kein gültiger Tag | Der Controller kann diese Art von Tag nicht lesen. | Verwenden Sie einen Tag, den Sie über Tillor erhalten haben. |
| **Scan fehlgeschlagen** - Tag nicht richtig gelesen | Der Tag wurde zu schnell weggenommen. | Halten Sie den Tag erneut an das Display, etwas länger. |
| **Zahlung abgelehnt** - Kein Zugang | Der Tag darf diesen Controller nicht benutzen. | Prüfen Sie in Tillor die Zugangsgruppe des Tags. |
| **Zahlung abgelehnt** - Tag nicht verknüpft | Der Tag ist noch keinem Kunden zugeordnet. | Verknüpfen Sie den Tag in Tillor mit dem Kunden. |
| **Zahlung abgelehnt** - Guthaben nicht ausreichend | Auf dem Tag ist zu wenig. Das Guthaben steht dabei. | Laden Sie den Tag an der Rezeption auf. |
| **Server nicht erreichbar** | Die Zahlung konnte nicht verarbeitet werden. | Versuchen Sie es später erneut; siehe [Verbindungsprobleme](/controllers/troubleshooting/verbinding). |
| **Tag aktualisieren fehlgeschlagen** | Das Guthaben konnte nicht auf dem Tag gespeichert werden. | Halten Sie den Tag erneut an das Display und lassen Sie ihn liegen, bis die Meldung verschwindet. |

<Callout type="info" title="Ein Scan pro Vorhalten">
Den Tag am Display liegen zu lassen bringt nichts: Jedes Vorhalten zählt als ein Scan. Wollen Sie erneut scannen, nehmen Sie den Tag weg und halten ihn erneut an das Display.
</Callout>

## Starten und verbinden [#opstarten-en-verbinden]

| Auf dem Display | Rand | Bedeutung | Was tun Sie |
| ------------- | ---- | --------- | ---------- |
| **Verbinden...** | Blau | Der Controller startet und sucht eine Verbindung zum Internet und zu Tillor. | Warten Sie 1-2 Minuten. |
| **WLAN einrichten** - Wählen Sie ein WLAN-Netzwerk auf dem Display | Violett | Der Controller hat noch kein Netzwerk. | Tippen Sie auf **WLAN einrichten** und wählen Sie Ihr Netzwerk; siehe [WLAN auf dem Display einrichten](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). |
| **WLAN einrichten** - WLAN-Daten abgelehnt | Violett | Das Passwort stimmt nicht (mehr). | Geben Sie das Passwort erneut auf dem Display ein. |
| **Controller aktivieren** - Aktivieren Sie das Gerät … in Tillor | Violett | Der Controller wartet auf die <Term term="adoptie">Adoption</Term>. | Gehen Sie in Tillor zu **Controller** und klicken Sie auf **Genehmigen** (✓). |
| **Verbindung unterbrochen** - erneuter Versuch | Rot | Die Internetverbindung ist weg. Der Controller versucht es selbst erneut. | Siehe [Verbindungsprobleme](/controllers/troubleshooting/verbinding#verbinding-verbroken). |
| **Verbindung unterbrochen** - Zu lange offline | Rot | Der Controller ist zu lange ohne Verbindung. Zahlungen sind aus, bis die Verbindung zurück ist. | Stellen Sie die Netzwerkverbindung wieder her. |

## Updates und Neustart [#updates-en-herstarten]

| Auf dem Display | Rand | Bedeutung |
| ------------- | ---- | --------- |
| **Aktualisieren** mit einem Prozentwert | Bernstein | Ein <Term term="firmware">Firmware</Term>-Update wird heruntergeladen und installiert. Lassen Sie den Strom an. |
| **Neustart** | Gelb | Der Controller startet neu, nach einem Update oder weil Sie in Tillor auf **Controller neu starten** geklickt haben. |

## Störungen [#storingen]

| Auf dem Display | Bedeutung | Was tun Sie |
| ------------- | --------- | ---------- |
| **Tag-Leser nicht verfügbar** | Der Tag-Leser startet nicht. Der Controller versucht, ihn selbst wiederherzustellen. | Warten Sie eine Minute. Bleibt die Meldung stehen, [starten Sie den Controller neu](/controllers/controller-beheren#een-controller-herstarten). |
| **Keine Verbindung** - Verbindung zum Controller | Das Display erhält kein Signal vom Rest des Controllers. | Starten Sie den Controller neu. Bleibt es so, wenden Sie sich an den Tillor-Support. |
| Display bleibt schwarz | Der Controller hat keinen Strom. | Prüfen Sie das Netzteil und die Verkabelung. |

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Verbindungsprobleme" href="/controllers/troubleshooting/verbinding" description="WLAN, Tillor-Verbindung und Adoption" />
  <Card title="Controller-Einstellungen" href="/controllers/settings" description="ACL, Netzwerk, Updates und Relais" />
</Cards>


# Verbindungsprobleme (/de-DE/controllers/troubleshooting/verbinding)

Verbindet sich der Controller nicht richtig, zeigt sein <Term term="scherm">Bildschirm</Term> an, wo es hakt. Unten steht pro Meldung, was los ist und was Sie tun. Alle Meldungen finden Sie unter [Bildschirmmeldungen](/controllers/troubleshooting/scherm).

## WLAN am Bildschirm einrichten [#wifi-instellen-op-het-scherm]

Steht auf dem Bildschirm **WLAN einrichten**, hat der Controller noch kein Netzwerk. Mit einem Netzwerkkabel (Ethernet) müssen Sie nichts tun; für WLAN richten Sie das Netzwerk am Controller selbst ein:

1. Tippen Sie auf **WLAN einrichten**
2. Wählen Sie Ihr Netzwerk in der Liste. Bei jedem Netzwerk steht die Signalstärke: Grün ist gut, Orange mittelmäßig, Rot schwach
3. Geben Sie das Passwort über die Tastatur auf dem Bildschirm ein und bestätigen Sie
4. Der Bildschirm zeigt **Verbunden** - das WLAN ist eingerichtet

Steht Ihr Netzwerk nicht in der Liste, tippen Sie auf erneut suchen. Möchten Sie das Netzwerk später ändern, halten Sie den Finger lange auf den Bildschirm, solange der Controller bereit ist, oder passen Sie es in den [Einstellungen](/controllers/settings#internetconfiguratie) in Tillor an.

| Meldung | Lösung |
| ------- | --------- |
| **Verbindung fehlgeschlagen** - Passwort prüfen | Geben Sie das Passwort erneut ein; achten Sie auf Groß- und Kleinschreibung. |
| **Verbindung fehlgeschlagen** - Netzwerk nicht gefunden | Stellen Sie den Controller näher an den Access Point oder wählen Sie ein anderes Netzwerk. |
| **Verbindung fehlgeschlagen** - Netzwerksuche fehlgeschlagen | Tippen Sie auf erneut suchen. Bleibt es dabei, starten Sie den Controller neu. |
| **WLAN einrichten** - WLAN-Zugangsdaten abgelehnt | Das gespeicherte Passwort stimmt nicht mehr. Geben Sie es am Bildschirm erneut ein. |

## Controller aktivieren [#controller-activeren]

**Bedeutung:** Der Controller wartet auf die <Term term="adoptie">Adoption</Term> - er ist noch nicht mit Tillor verbunden. *Das Kästchen ist bereit, weiß aber noch nicht, zu welcher Organisation es gehört.* Auf dem Bildschirm steht **Controller aktivieren** mit der Nummer des Geräts.

**Lösung:**
1. Gehen Sie in Tillor zu **Controller**
2. Suchen Sie die Zeile **Wartet auf Genehmigung** mit derselben Nummer (die <Term term="eFuse ID">eFuse ID</Term>)
3. Klicken Sie auf **Genehmigen** (✓), um den Controller mit Ihrer Organisation zu verknüpfen

## Verbindung getrennt [#verbinding-verbroken]

**Bedeutung:** Die Internetverbindung ist weg. Der Controller versucht automatisch, sich neu zu verbinden. *Das Kästchen hat den Kontakt zu Tillor verloren und versucht, ihn wiederherzustellen.*

Solange die Unterbrechung kurz ist, können Gäste weiter mit ihrem Tag bezahlen; der QR-Code ist dann grau und durchgestrichen. Steht dort **Zu lange offline**, sind Zahlungen ausgeschaltet, bis die Verbindung wieder da ist.

In Tillor gilt der Controller nach etwa 35 Sekunden ohne Kontakt als offline. Nach 5 Minuten erhält das Tillor-Team eine Meldung.

**Mögliche Ursachen:**
- **Das WLAN ist ausgefallen** - prüfen Sie, ob das WLAN-Netzwerk erreichbar ist
- **Internetstörung** - der Controller kann Tillor nicht erreichen
- **Tillor ist vorübergehend nicht erreichbar**

**Lösung:**
- Warten Sie einige Minuten - der Controller versucht von selbst, sich neu zu verbinden
- Prüfen Sie, ob andere Geräte im selben Netzwerk Internet haben
- Prüfen Sie die [WLAN-Einstellungen](/controllers/settings) des Controllers (Netzwerkname, Passwort)
- Sorgen Sie dafür, dass der Controller in Reichweite des WLAN-Access-Points steht, oder verwenden Sie ein Netzwerkkabel

## Bildschirm bleibt bei Verbinden... [#scherm-blijft-op-verbinden]

**Bedeutung:** Der Controller startet noch oder verbindet sich noch. Unter dem Titel steht der Schritt, in dem er sich befindet, zum Beispiel *Internetverbindung wird aufgebaut* oder *Nach Updates suchen*.

**Lösung:**
- Warten Sie 1-2 Minuten - beim Start dauert es einen Moment
- Bleibt er bei *Internetverbindung wird aufgebaut* stehen: Prüfen Sie das Netzwerkkabel oder [richten Sie das WLAN erneut ein](#wifi-instellen-op-het-scherm)
- Prüfen Sie, ob das WLAN-Signal stark genug ist

## Controller erscheint nicht in Tillor [#controller-verschijnt-niet-in-tillor]

**Bedeutung:** Der Controller ist für die Adoption noch nicht sichtbar.

**Mögliche Ursachen:**
- Der Controller hat keine Internetverbindung (kann Tillor nicht erreichen)
- Der Controller startet noch
- Sie öffnen Tillor von einem anderen Netzwerk als dem, an dem der Controller angeschlossen ist - Adoptionsanfragen sind dann manchmal nicht sichtbar

**Lösung:**
1. Prüfen Sie, ob der Controller Strom hat und der Bildschirm an ist
2. Sehen Sie, was der Bildschirm zeigt: Bei **WLAN einrichten** oder **Verbinden...** ist er noch nicht online
3. Warten Sie, bis der Bildschirm **Controller aktivieren** zeigt und die Zeile **Wartet auf Genehmigung** in der Liste erscheint - das kann etwas dauern
4. Öffnen Sie Tillor vom selben Netzwerk wie der Controller, oder wenden Sie sich an den Support
5. Aktualisieren Sie die Controller-Seite in Tillor (neue Anfragen erscheinen auch automatisch)

## Adoption fehlgeschlagen oder Credentials werden abgelehnt [#adoptie-mislukt-of-credentials-worden-geweigerd]

Die <Term term="adoptie">Adoption</Term> ist das Verknüpfen des Controllers mit Ihrer Organisation; <Term term="credentials">Credentials</Term> sind die dazugehörigen Verbindungsdaten.

**Bedeutung:** Die Verknüpfung mit Tillor hat nicht geklappt. *Das Kästchen konnte nicht mit Ihrer Organisation verknüpft werden.*

**Lösung:**
- Prüfen Sie, ob die Uhr des Controllers stimmt (eine große Zeitabweichung kann die Verknüpfung blockieren)
- Nach einem Firmware-Flash oder einem neuen Schlüssel muss der Controller erneut genehmigt werden
- Versuchen Sie die Adoption erneut über **Genehmigen** (✓)
- Wenden Sie sich an den Support, wenn das Problem bestehen bleibt - dort hat man Zugriff auf die Logs

## OTA-Update bleibt hängen oder schlägt fehl [#ota-update-blijft-hangen-of-faalt]

Ein <Term term="OTA">OTA</Term>-Update ist ein <Term term="firmware">Firmware</Term>-Update über das Internet. Während eines Updates zeigt der Bildschirm **Aktualisieren** mit einem Prozentwert.

**Bedeutung:** Das Firmware-Update wurde nicht abgeschlossen. *Das Kästchen wollte neue Software installieren, aber das ist nicht gut gegangen.*

**Lösung:**
- Warten Sie, bis das [<Term term="updatevenster">Updatefenster</Term>](/controllers/updates) aktiv ist - Updates finden nur innerhalb dieses Fensters statt
- Prüfen Sie, ob der Controller eine stabile Internetverbindung hat
- Schalten Sie vorübergehend [OTA-Updates überspringen](/controllers/updates#ota-updates-overslaan) ein, wenn Sie den Controller zuerst stabil bekommen möchten

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Bildschirmmeldungen" href="/controllers/troubleshooting/scherm" description="Was bedeutet die Meldung auf dem Bildschirm?" />
  <Card title="Controller-Einstellungen" href="/controllers/settings" description="WLAN und Netzwerk konfigurieren" />
</Cards>


# Firmware-Updates (/de-DE/controllers/updates)

Ein Controller holt neue Software selbst über das Internet, genau wie Ihr Telefon. Diese Software heißt <Term term="firmware">Firmware</Term>. Sie bestimmen, **wann** und **wie oft** er das darf. Standardmäßig prüft er täglich, ob es etwas Neues gibt. Möchten Sie ein Update sofort starten, tun Sie das auf der Controller-Seite, siehe [Einen Controller verwalten](/controllers/controller-beheren#bijwerken-naar-een-nieuwe-versie).

## Update-Häufigkeit [#updatefrequentie]

Der Controller prüft regelmäßig, ob eine neue Firmware-Version verfügbar ist:

| Option | Bedeutung |
| ----- | --------- |
| **Stündlich** | Prüft jede Stunde auf Updates. |
| **Täglich** | Prüft einmal pro Tag (Standard). |
| **Wöchentlich** | Prüft einmal pro Woche. |

Nach der Prüfung wird ein Update nur ausgeführt, wenn es eine neuere Version gibt. Haben Sie ein Updatefenster festgelegt, muss der aktuelle Zeitpunkt außerdem in diesem Fenster liegen. *Also: Das Kästchen schaut zwar nach, ob es etwas Neues gibt, installiert es aber nur zu den Zeiten, die Sie festgelegt haben.*

## Updatefenster [#updatevenster]

Das Updatefenster ist der Zeitraum, in dem der Controller sich aktualisieren darf. Haben Sie **Update-Zeitraum von** und **Update-Zeitraum bis** ausgefüllt, werden Updates nur innerhalb dieser Zeiten ausgeführt. *Einfach gesagt: Sie wählen selbst, wann das Kästchen sich aktualisieren darf - zum Beispiel nur nachts.*

**Beispiel:** Setzen Sie **Update-Zeitraum von** auf 02:00 und **Update-Zeitraum bis** auf 04:00, findet ein Update nur zwischen 02:00 und 04:00 Uhr statt. So verhindern Sie, dass der Controller mitten am Tag zu Stoßzeiten neu startet.

### Einrichten [#instellen]

1. Gehen Sie zu <UIPath>Controller > Übersicht > [Name des Controllers]</UIPath>
2. Scrollen Sie zu **Update-Konfiguration**
3. Wählen Sie **Update-Häufigkeit** (Stündlich, Täglich oder Wöchentlich)
4. Füllen Sie **Update-Zeitraum von** aus (z. B. 02:00)
5. Füllen Sie **Update-Zeitraum bis** aus (z. B. 04:00)
6. Klicken Sie auf **Speichern**

## OTA-Updates überspringen [#ota-updates-overslaan]

<Term term="OTA">OTA</Term> steht für Over-The-Air: Updates über das Internet. Setzen Sie **OTA-Updates überspringen** auf **Ja**, installiert der Controller keine neue Firmware mehr. Der Controller bleibt auf der aktuellen Version. *Anders gesagt: Das Kästchen aktualisiert sich nicht mehr per OTA.*

**Wann nutzen?**

- Vorübergehend, wenn Sie in einer geschäftigen Zeit keine Änderungen möchten
- Für Test- oder Demo-Controller, die auf einer festen Version bleiben müssen

<Callout type="info" title="Empfehlung">
Lassen Sie **OTA-Updates überspringen** standardmäßig auf **Nein**. Updates enthalten oft Verbesserungen und Sicherheitskorrekturen.
</Callout>

## Was passiert während eines Updates? [#wat-gebeurt-er-tijdens-een-update]

1. Der Controller erkennt eine neue <Term term="firmware">Firmware</Term>-Version
2. Die Firmware wird heruntergeladen
3. Der Bildschirm zeigt **Aktualisieren** mit einem Prozentwert - der Controller wird aktualisiert
4. Der Controller startet automatisch neu; der Bildschirm zeigt **Neustart**
5. Nach dem Neustart ist die neue Version aktiv

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Ein Update startet nur, wenn es eine neuere Version gibt und der Zeitpunkt in Ihrem Updatefenster liegt.
- Während des Aktualisierens und Neustarts zeigt der Bildschirm **Aktualisieren** und **Neustart**. Legen Sie das Fenster daher auf die Nacht.
- Setzen Sie **OTA-Updates überspringen** auf **Ja**, bleibt der Controller auf seiner aktuellen Version, bis Sie es wieder zurücksetzen.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Controller aktualisiert sich nicht">
Prüfen Sie, ob **OTA-Updates überspringen** auf **Nein** steht und der Zeitpunkt in Ihrem Updatefenster liegt. Prüfen Sie auch die Internetverbindung des Controllers. Mehr dazu unter [OTA-Update bleibt hängen oder schlägt fehl](/controllers/troubleshooting/verbinding#ota-update-blijft-hangen-of-faalt).
</Accordion>
<Accordion title="Der Bildschirm bleibt bei Aktualisieren stehen">
Lassen Sie den Strom an und warten Sie einige Minuten. Bleibt es dabei, starten Sie den Controller neu und wenden Sie sich an den Support.
</Accordion>
<Accordion title="Tillor meldet: OTA-Update fehlgeschlagen">
Das Update konnte nicht gestartet werden. Prüfen Sie, ob der Controller online ist, und versuchen Sie es erneut.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Controller-Einstellungen" href="/controllers/settings" description="Übersicht aller Einstellungen" />
  <Card title="Bildschirmmeldungen" href="/controllers/troubleshooting/scherm" description="Aktualisieren und Neustart" />
</Cards>


# WLAN-Netzwerke einrichten (/de-DE/controllers/wifi-netwerken)

Ein Controller kann mehrere WLAN-Netzwerke kennen und wechselt selbst zum besten. Das ist praktisch, wenn Ihr Park an verschiedenen Stellen einen eigenen Access Point hat. Sie richten sie auf der Seite des Controllers ein. Hat der Controller noch kein Netzwerk, richten Sie das WLAN besser am Bildschirm selbst ein, siehe [WLAN am Bildschirm einrichten](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).

Bevor Sie beginnen:

- Der Controller ist genehmigt, siehe [Einen Controller verknüpfen](/controllers/controller-koppelen).
- Sie kennen pro Netzwerk den Namen (SSID) und das Passwort. Ein offenes Netzwerk hat kein Passwort.

## Netzwerke hinzufügen [#netwerken-toevoegen]

<Steps>
<Step>
### Den Controller öffnen [#open-de-controller]
Gehen Sie zu <UIPath>Controller > Übersicht</UIPath> und klicken Sie auf den Controller. Scrollen Sie zu **WLAN-Netzwerke**.
</Step>
<Step>
### Ein Netzwerk hinzufügen [#voeg-een-netwerk-toe]
Klicken Sie auf **Netzwerk hinzufügen** und füllen Sie den **Netzwerkname (SSID)** und das **Passwort** aus. Lassen Sie das Passwort bei einem offenen Netzwerk leer. Wiederholen Sie das für jedes Netzwerk.
</Step>
<Step>
### In Reihenfolge bringen [#zet-ze-in-volgorde]
Ziehen Sie eine Zeile am Griff links. Die Reihenfolge ist die Priorität: Der Controller probiert die Netzwerke in seiner Reichweite von oben nach unten.

<DocScreenshot src="/screenshots/controllers/controller-wifi-networks.png" alt="WLAN-Netzwerke mit zwei Netzwerken in Reihenfolge der Priorität" />
</Step>
<Step>
### Auf Speichern klicken [#klik-op-opslaan]
Die Schaltfläche **Speichern** steht unten im Formular. Tillor schickt die Liste danach an den Controller.
</Step>
</Steps>

Ein Netzwerk entfernen Sie mit der Minus-Schaltfläche (**Netzwerk entfernen**).

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Der Controller prüft jedes Netzwerk einzeln. Fällt das erste Netzwerk weg oder stimmt das Passwort nicht, nutzt er das nächste.
- Auf der Detailseite steht unter **Bekannte WLAN-Netzwerke, nach Priorität**, wie es pro Netzwerk läuft:

| Status | Bedeutung |
|---|---|
| <Status tone="success">Verbunden</Status> | Der Controller nutzt dieses Netzwerk gerade. |
| <Status>Geprüft</Status> | Das Netzwerk funktioniert, aber der Controller nutzt gerade ein anderes Netzwerk. |
| <Status tone="info">Noch nicht geprüft</Status> | Der Controller konnte dieses Netzwerk noch nicht testen. |
| <Status tone="warning">Fehlgeschlagen</Status> | Das Netzwerk funktioniert nicht. Der Grund steht dabei, zum Beispiel ein falsches Passwort, Netzwerk nicht gefunden oder kein Internetzugang. |

- Pro Netzwerk steht, ob es **in Reichweite** oder **nicht in Reichweite** ist, manchmal mit der Signalstärke in dBm. Netzwerke, die am Bildschirm eingegeben wurden, tragen den Hinweis **am Display hinzugefügt**.
- Ist die Liste leer, sind in Tillor keine Netzwerke eingerichtet. Netzwerke, die jemand am Bildschirm hinzugefügt hat, bleiben auf dem Controller gespeichert.
- Ältere Controller, die nur ein Netzwerk kennen, zeigen stattdessen eine einzelne Meldung zur letzten Änderung, etwa **WLAN-Änderung noch nicht bestätigt** oder **WLAN-Zugangsdaten abgelehnt**. Der Controller bleibt dann mit dem vorherigen Netzwerk verbunden.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Netzwerk hinzufügen ist ausgegraut">
Ein Controller merkt sich höchstens 8 Netzwerke. Tillor sagt das mit **Ein Controller merkt sich höchstens 8 Netzwerke.** Entfernen Sie zuerst ein Netzwerk, das Sie nicht mehr brauchen.
</Accordion>
<Accordion title="Tillor meldet: Geben Sie einen Netzwerknamen ein">
Eine Zeile hat keinen Netzwerknamen. Füllen Sie den Namen aus oder entfernen Sie die Zeile.
</Accordion>
<Accordion title="Tillor meldet: Dieses Netzwerk steht bereits in der Liste">
Jeder Netzwerkname darf nur einmal vorkommen. Entfernen Sie die doppelte Zeile.
</Accordion>
<Accordion title="Ein Netzwerk steht auf Fehlgeschlagen">
Lesen Sie den Grund beim Netzwerk. Prüfen Sie den Namen und das Passwort. Der Controller versucht es von selbst erneut, und die anderen Netzwerke funktionieren weiter.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Verbindungsprobleme" href="/controllers/troubleshooting/verbinding" description="WLAN und Tillor-Verbindung" />
  <Card title="Controller-Einstellungen" href="/controllers/settings" description="Netzwerkpräferenz und andere Einstellungen" />
</Cards>


# Tillor Handbuch (/de-DE)

<HomeHero title="Wie geht das in Tillor?">
  Anleitungen pro Aufgabe für die Rezeption, die Verwaltung und den technischen Dienst. Suchen Sie, was Sie tun möchten, oder beginnen Sie bei Ihrer Rolle.
</HomeHero>

<HomeSection title="Woran arbeiten Sie?" description="Pro Rolle die Aufgaben, die am häufigsten vorkommen.">

<RoleCard title="Rezeption" description="Gäste empfangen, einchecken und Fragen beantworten." href="/reserveringen" icon={<ConciergeBellIcon />}>

- [Einen Kunden suchen oder anlegen](/klantenbeheer)
- [Eine Reservierung erstellen](/reserveringen)
- [Einen Gast mit einer Belegung einchecken](/bezettingen#een-bezetting-aanmaken)
- [Nachrichten in der Inbox beantworten](/inbox)

</RoleCard>

<RoleCard title="Verwaltung" description="Rechnungen, Zahlungen und die Anbindung an Ihre Buchhaltung." href="/facturen" icon={<LandmarkIcon />}>

- [Eine Rechnung erstellen und buchen](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken)
- [Eine Zahlung erfassen](/facturen/betalingen-registreren)
- [Eine Belegung per Rechnung verlängern](/bezettingen#facturatie-bezetting-verlengen)
- [Zahlungsberichte an Ihre Buchhaltung](/boekhouden/betalingsrapporten)

</RoleCard>

<RoleCard title="Technischer Dienst" description="Schranken, Zähler, Controller und Tablets auf dem Gelände." href="/controllers" icon={<CpuIcon />}>

- [Einen Zugangspunkt öffnen oder schließen](/toegangscontrole#toegangspunten-bedienen)
- [Einen Zähler mit einem Stellplatz verknüpfen](/meterbeheer/meter-koppelen)
- [Was bedeutet die Meldung auf dem Bildschirm?](/controllers/troubleshooting/scherm)
- [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten)

</RoleCard>

<RoleCard title="Entwickler" description="Tillor mit Ihren eigenen Systemen oder Ihrer Website verbinden." href="/ontwikkelaars" icon={<BracesIcon />}>

- [Einen API-Schlüssel erstellen](/ontwikkelaars/http)
- [Webhooks empfangen](/ontwikkelaars/webhooks)
- [Echtzeit-Events über SSE](/ontwikkelaars/sse)
- [KI-Tools mit MCP verbinden](/ontwikkelaars/mcp)

</RoleCard>

</HomeSection>

<HomeSection title="Weiteres">

<HomeLink title="Neu bei Tillor?" description="Anmelden, sich zurechtfinden und Ihren Park einrichten." href="/aan-de-slag" icon={<RocketIcon />} />

<HomeLink title="In der Praxis" description="Vier ausgearbeitete Beispiele, die mehrere Module kombinieren." href="/praktijk" icon={<RouteIcon />} />

<HomeLink title="Begriffe" description="Die Wörter, denen Sie in Tillor begegnen, kurz erklärt." href="/begrippen" icon={<RocketIcon />} />

<HomeLink title="Was ist neu" description="Aktuelle Änderungen in Tillor, pro Monat." href="/wat-is-nieuw" icon={<SparklesIcon />} />

<HomeLink title="Tablets und Kioske" description="Die Tillor-App auf Tablets an der Rezeption oder draußen." href="/mobiele-app" icon={<TabletSmartphoneIcon />} />

<HomeLink title="Systemstatus" description="Läuft alles? Sehen Sie Störungen und Wartungsarbeiten." href="https://status.tillor.eu" icon={<ActivityIcon />} />

</HomeSection>


# Einen Befehl an ein Tablet senden (/de-DE/mobiele-app/acties-op-afstand)

Rechts auf der Geräteseite steht das Panel **Fernaktionen**, egal welchen Tab Sie geöffnet haben. Dort senden Sie einen Befehl an das Gerät und fordern ein Bildschirmfoto an. Was das Gerät selbst meldet, lesen Sie unter [Diagnose und Verlauf](/mobiele-app/diagnose-en-geschiedenis).

<Requires permission="Einstellungen bearbeiten" />

Bevor Sie beginnen:

- Das Gerät muss verbunden sein. Ein Befehl läuft über die Live-Verbindung zur App. Ist das Gerät offline, sagt das Panel **Das Gerät ist offline: Befehle kommen erst an, wenn es wieder verbunden ist.** Tillor meldet dann zwar, dass der Befehl gesendet wurde, aber das Tablet sieht ihn nicht.
- **Gerät neu starten** funktioniert nur, wenn Tillor Eigentümer des Tablets ist. Siehe [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten).

## Einen Befehl senden [#een-opdracht-versturen]

<Steps>
<Step>
### Das Gerät öffnen [#open-het-toestel]
Gehen Sie zu <UIPath>Einstellungen > Tablets & Kioske</UIPath> und klicken Sie auf die Zeile des Geräts.
</Step>
<Step>
### Den Befehl wählen [#kies-de-opdracht]
Klicken Sie im Panel **Fernaktionen** auf den Befehl. Sie erhalten die Meldung **An das Gerät gesendet**, oder **Gerät konnte nicht erreicht werden**, wenn er nicht gesendet werden konnte.

<DocScreenshot src="/screenshots/tablets/remote-actions.png" alt="Fernaktionen und der Block Bildschirmfoto" />
</Step>
</Steps>

Die Befehle:

- **Namen auf dem Bildschirm anzeigen** blendet den Namen des Geräts kurz groß ein. Praktisch, wenn zwei Tablets nebeneinander stehen und Sie wissen möchten, welches Sie geöffnet haben.
- **Testton abspielen** spielt den Benachrichtigungston ab, in der Lautstärke aus dem Tab **Belege und Ton**.
- **Bildschirm aufwecken** holt das Gerät aus der Nachtruhe oder aus **Bildschirm in den Ruhezustand versetzen**.
- **Bildschirm in den Ruhezustand versetzen** schaltet den Bildschirm schwarz, auch außerhalb der Nachtruhe.
- **30 Sekunden schlafen** tut dasselbe und weckt danach von selbst. Damit prüfen Sie, ob der Bildschirm wieder angeht, ohne bis zum Morgen zu warten.
- **Gerät neu starten** startet das Tablet neu. Auf einem Tablet, dessen Eigentümer Tillor nicht ist, bleibt die Schaltfläche grau.
- **Update installieren** installiert ein App-Update, das schon bereitsteht.
- **App neu starten** startet nur die Tillor-App, nicht das Tablet.

## Ein Bildschirmfoto anfordern [#een-schermafbeelding-opvragen]

<Steps>
<Step>
### Auf Bildschirmfoto anfordern klicken [#klik-op-schermafbeelding-opvragen]
Im Block **Bildschirmfoto** sendet das die Anfrage an das Tablet.
</Step>
<Step>
### Auf das Bild warten [#wacht-op-het-beeld]
Tillor wartet kurz und aktualisiert das Bild, sobald das Tablet es hochgeladen hat. Unter dem Foto steht, wann es aufgenommen wurde.
</Step>
</Steps>

Das Bild zeigt, was die App in diesem Moment anzeigt: Startbildschirm, Diashow, Beleg oder den Ruhebildschirm. Es ist kein Live-Video.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Tablet führt den Befehl sofort aus. Jeder Befehl außer den Schlafbefehlen weckt auch den Bildschirm.
- Jeder Befehl landet im [Verlauf des Geräts](/mobiele-app/diagnose-en-geschiedenis#geschiedenis).
- Ein Bildschirmfoto bleibt im Panel stehen, bis Sie ein neues anfordern.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Tillor meldet Gerät konnte nicht erreicht werden">
Der Befehl konnte nicht zum Gerät. Meist ist es offline. Warten Sie, bis der Status wieder **Verbunden** ist, und senden Sie ihn erneut.
</Accordion>
<Accordion title="Die Schaltfläche Gerät neu starten ist grau">
Tillor ist nicht Eigentümer des Tablets. Richten Sie es zuerst ein, wie unter [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten) beschrieben. Bis dahin können Sie nur **App neu starten** verwenden.
</Accordion>
<Accordion title="Es kommt kein Bildschirmfoto">
Das Gerät ist offline oder die App ist zu alt. Im letzteren Fall sagt Tillor es vorher: **Die App auf diesem Gerät ist zu alt für Bildschirmfotos.** Installieren Sie eine neuere Version. Solange Sie noch nie ein Bild angefordert haben, steht dort **Noch kein Bildschirmfoto angefordert.**
</Accordion>
<Accordion title="Der Bildschirm bleibt nach Bildschirm aufwecken schwarz">
Das Aufwecken aus der Ferne klappt nur, wenn die App auch in der Akku-Ausnahme steht. Siehe [Akku](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Diagnose und Verlauf" href="/mobiele-app/diagnose-en-geschiedenis" description="Was das Gerät selbst meldet" />
  <Card title="Ein Tablet oder einen Kiosk verwalten" href="/mobiele-app/tablets-en-kiosken" description="Einstellungen senden" />
</Cards>


# Diagnose und Verlauf (/de-DE/mobiele-app/diagnose-en-geschiedenis)

Unter dem Panel **Fernaktionen** stehen zwei Blöcke, die Ihnen helfen, ein Tablet zu kontrollieren: **Diagnose** (was das Gerät zuletzt gemeldet hat) und **Verlauf** (das Protokoll). Einen Befehl senden können Sie im selben Panel, siehe [Einen Befehl an ein Tablet senden](/mobiele-app/acties-op-afstand).

<DocScreenshot src="/screenshots/tablets/diagnostics.png" alt="Diagnose und Verlauf auf der Geräteseite" />

## Diagnose [#diagnose]

**Diagnose** ist die letzte Meldung des Geräts, keine Live-Messung. Ein Strich bedeutet, dass die App diese Angabe nicht gesendet hat.

| Angabe | Bedeutung |
|---|---|
| **Zuletzt gesehen** | Wann das Gerät zuletzt Kontakt hatte |
| **Verbindung** | WLAN oder Mobilfunk |
| **Bildschirm** | **An** oder **Im Ruhezustand** |
| **Freier Speicher** | Freier Platz auf dem Tablet, in GB |
| **Gerätesprache** und **Zeitzone** | Die Sprache und Zeitzone von Android oder iOS. Das ist nicht die Sprache, die Sie im Tab **Gerät** für die App gewählt haben |
| **Build**, **Runtime-Version** | Welche Version der App auf dem Tablet steht |
| **Letztes App-Update** und **Letzte Update-Prüfung** | Wann die App zuletzt aktualisiert oder geprüft wurde |
| **Update-Fehler** | Erscheint, wenn die letzte Prüfung oder Installation fehlgeschlagen ist |
| **Registriert** | Wann dieses Gerät zum ersten Mal in der Liste erschien |

## Verlauf [#geschiedenis]

**Verlauf** zeigt pro Gerät:

- wann sich das Gerät angemeldet hat
- wann Sie Einstellungen oder einen Befehl gesendet haben
- wann die App aktualisiert wurde
- wann das Gerät offline ging und wann es wieder online kam

Das Protokoll aktualisiert sich von selbst. **Noch keine Ereignisse.** bedeutet, dass noch nichts erfasst wurde.

## Benachrichtigungen [#meldingen]

Eine Offline-Benachrichtigung oder eine Akku-Benachrichtigung kommt nur, wenn **Benachrichtigungen** im Tab **Gerät** an ist, und nicht während der Nachtruhe.

- Offline-Benachrichtigung: Das Gerät hat 10 Minuten lang nichts gemeldet.
- Akku-Benachrichtigung: unter 15 % ohne Ladegerät. Tillor sendet sie nicht erneut, bis das Gerät wieder am Ladegerät hing oder deutlich nachgeladen wurde.

Die Benachrichtigung geht an die Personen, die die Einstellungen verwalten. Siehe [Benachrichtigungen](/notificaties).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Einen Befehl an ein Tablet senden" href="/mobiele-app/acties-op-afstand" description="Aufwecken, Neustarten und ein Bildschirmfoto" />
  <Card title="Geräteeinstellungen" href="/mobiele-app/toestelinstellingen" description="Der Tab Gerät mit Benachrichtigungen" />
</Cards>


# Übersicht (/de-DE/mobiele-app)

Die Tillor-App läuft auf einem Tablet, Kiosk oder Telefon in Ihrem Park, für **iOS** und **Android**. Gäste und Kollegen sehen darauf den Startbildschirm, Belege und Unterschriftsanfragen. Von Tillor in Ihrem Browser aus senden Sie Einstellungen und Befehle an diese Geräte. Ein Tablet, das als Kiosk stehen bleiben soll, richten Sie über [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten) ein.

<Callout type="warn" title="Keine vollständige Web-App">
Die App ersetzt Tillor in Ihrem Browser nicht. Reservierungen verwalten, Rechnungen erstellen oder Zahlungen erfassen tun Sie im Browser.
</Callout>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

Ein Gerät erscheint von selbst in Tillor, sobald jemand die App öffnet und sich anmeldet. Was Sie danach in Tillor einstellen, geht über die Live-Verbindung an das Gerät. Umgekehrt meldet sich das Gerät regelmäßig bei Tillor, sodass Sie sehen, ob es noch verbunden ist.

```mermaid
flowchart LR
  A[Jemand öffnet die App<br/>und meldet sich an] --> B[Das Gerät steht in<br/>Einstellungen > Tablets und Kioske]
  B --> C[Sie wählen Einstellungen<br/>und klicken Speichern und senden]
  C --> D[Das Tablet wendet sie an]
  E[Sie senden einen Beleg,<br/>ein PDF oder eine Unterschriftsanfrage] --> D
  D --> F[Das Gerät meldet Akku,<br/>Verbindung und Version zurück]
  F --> B
```

Ist ein Gerät offline, kommen Einstellungen und Befehle erst an, wenn es wieder verbunden ist. Siehe [Tablets und Kioske](/mobiele-app/tablets-en-kiosken).

<Callout type="info" title="Gut zu wissen">
- Ein neues Gerät steht innerhalb einer Minute in der Liste, nachdem sich jemand angemeldet hat.
- Tillor meldet ein Gerät nach 10 Minuten ohne Nachricht als offline. Das geschieht nur, wenn **Benachrichtigungen** an ist, und nicht während der Nachtruhe.
- Die Akku-Benachrichtigung kommt unter 15 % ohne Ladegerät.
- Eine Diashow hat höchstens 20 Fotos. Sie können sechs zusätzliche Schaltflächen auf den Startbildschirm setzen.
- Es gibt kein eigenes App-Passwort. Sie melden sich an wie im Browser, mit Microsoft, Google oder Apple.
</Callout>

## Die App installieren und anmelden [#de-app-installeren-en-inloggen]

Ihre Organisation stellt die Installationsdatei oder den Link bereit (interner Build, TestFlight oder der App Store, je nach Ihrem Rollout). Haben Sie noch keinen Zugang, fragen Sie Ihren Administrator oder den Tillor-Support.

1. Öffnen Sie die App nach der Installation.
2. Melden Sie sich mit **Microsoft**, **Google** oder **Apple** an. Es ist dasselbe Konto wie im Browser, siehe [Anmelden](/inloggen).
3. Wählen Sie Ihre Organisation, wenn Sie mehr als eine haben.

## Was die App kann [#wat-de-app-kan]

- **PDFs und Bilder anzeigen**: direkt auf dem Startbildschirm, sobald Tillor ein Dokument an das Gerät sendet.
- **Prepaid-Karten scannen**: eine NFC-Karte auslesen und die Karten- und Kundendaten ansehen.
- **Zahlungen hörbar machen**: ein Signalton bei einer bezahlten Rechnung.
- **Kiosk**: den Bildschirm an lassen, die Helligkeit regeln und das Logo Ihrer Organisation zeigen.

## Was Tillor vom Gerät sieht [#wat-tillor-van-het-toestel-ziet]

Die App sendet regelmäßig den Namen, das Modell, das Betriebssystem, die App-Version, den Akku und die Netzwerkverbindung (WLAN oder Mobilfunk) an Tillor. Sie sehen das in der Liste der Geräte und auf der Geräteseite. Unter **Konto** > **Aktive Sitzungen** finden Sie dieselben Geräte als App-Sitzungen, mit **App-Metadaten**. Dort beenden Sie auch eine Sitzung.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Die App stellt keine Verbindung her">
Prüfen Sie das WLAN oder das Mobilfunknetz und ob Sie bei der richtigen Organisation angemeldet sind. Aktualisieren Sie die App auf die neueste Version. Hilft das nicht, melden Sie sich ab und wieder an. Geht es weiterhin schief, wenden Sie sich an Ihren Administrator.
</Accordion>
<Accordion title="Das Gerät steht nicht in der Liste">
Öffnen Sie die App, melden Sie sich an und wählen Sie die richtige Organisation. Das Gerät erscheint innerhalb einer Minute unter **Einstellungen** > **Tablets & Kioske**. Sehen Sie dort **Noch keine Geräte**, hat sich noch kein Gerät angemeldet.
</Accordion>
</Accordions>

## Begriffe [#begrippen]

- **Tablet**: ein Tablet mit der Tillor-App, zum Beispiel an der Rezeption.
- **Kiosk**: ein Tablet, das auf die Tillor-App festgesetzt ist, sodass Gäste sie nicht verlassen können.
- **Gerät**: jede Installation der App, die in Tillor steht, egal welcher Art.
- **Nachtruhe**: die Stunden, in denen der Bildschirm aus oder schwarz ist.
- **Bildschirmsperre**: ein Muster oder eine PIN auf dem Tablet selbst, etwas anderes als die Kiosksperre.

Mehr Erklärungen finden Sie im [Begriffsverzeichnis](/begrippen).

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Tablets und Kioske" href="/mobiele-app/tablets-en-kiosken" description="Geräte in der Liste, Einstellungen speichern und senden" />
  <Card title="Einen Kiosk einrichten" href="/mobiele-app/kiosk-inrichten" description="Ein Android-Tablet festsetzen" />
  <Card title="Geräteeinstellungen" href="/mobiele-app/toestelinstellingen" description="Alle Einstellungen pro Tab" />
  <Card title="Fernaktionen" href="/mobiele-app/acties-op-afstand" description="Aufwecken, Neustarten und ein Bildschirmfoto" />
  <Card title="Anmelden" href="/inloggen" description="Kontozugang über Microsoft, Google oder Apple" />
  <Card title="Controller" href="/controllers" description="Hardware in Ihrem Park" />
</Cards>


# Einen Kiosk einrichten (/de-DE/mobiele-app/kiosk-inrichten)

Mit einem Kiosk setzen Sie ein Android-Tablet auf die Tillor-App fest. Gäste sehen den Startbildschirm, eine Diashow oder einen Beleg und kommen nicht in die Einstellungen von Android. Nach einem Stromausfall startet das Tablet wieder in Tillor. Diese Seite führt durch die einmalige Einrichtung. Die Schalter, die Sie danach setzen, stehen unter [Geräteeinstellungen](/mobiele-app/toestelinstellingen#kiosk).

Ohne die folgenden Schritte können Sie **App sperren** zwar einschalten, aber dann nutzt Android nur das Anheften des Bildschirms. Das verlangt eine Bestätigung am Tablet, und ein Gast kann es verlassen. Der Status im Tab **Kiosk** sagt dann **Bildschirm anheften. Dieses Tablet ist kein eingerichteter Kiosk.**

Die vollständige Sperre gilt erst, wenn Tillor Eigentümer des Geräts ist. Im Tab **Kiosk** lesen Sie das als **Eingerichteter Kiosk: die Sperre ist vollständig.**

<Callout type="warn">
Das funktioniert auf Android. Auf iOS können Sie die App zwar als Kiosk für Belege und den Startbildschirm nutzen, aber nicht als Eigentümer des Geräts einrichten. Die Schaltflächen unter **Android-Verwaltung** bleiben dann geschlossen, mit der Meldung **Verfügbar, sobald dieses Tablet als Kiosk eingerichtet ist.**
</Callout>

## Bevor Sie beginnen [#voor-je-begint]

Sie brauchen einen Computer mit `adb`. Das ist ein kostenloses Programm von Google, mit dem Sie ein Android-Tablet über ein USB-Kabel bedienen. Es ist eine einmalige Aufgabe pro Tablet, gedacht für technisch Versierte. Klappt es nicht, wenden Sie sich an den Tillor-Support.

Bevor Sie beginnen:

- Setzen Sie das Tablet auf Werkseinstellungen zurück oder nutzen Sie ein Tablet, auf dem noch kein zusätzliches Google-Konto eingerichtet ist. Android verweigert eine App als Eigentümer, sobald schon ein Konto auf dem Gerät ist.
- Die Tillor-App muss installiert und bei Ihrer Organisation angemeldet sein.
- Schalten Sie in den Android-Einstellungen **USB-Debugging** ein (Entwickleroptionen).
- Verbinden Sie das Tablet per Kabel mit dem Computer. `adb devices` muss das Tablet als `device` anzeigen, nicht als `unauthorized`.

## Tillor als Eigentümer des Tablets [#tillor-als-eigenaar-van-de-tablet]

Der Eigentümer eines Android-Geräts darf Dinge, die eine normale App nicht darf, zum Beispiel das Tablet wirklich festsetzen. Geben Sie Tillor diese Rolle mit diesem Befehl auf dem Computer:

```bash
adb shell dpm set-device-owner eu.tillor.app/expo.modules.tillorkiosk.KioskAdminReceiver
```

Gelingt der Befehl, antwortet Android, dass der Eigentümer gesetzt wurde. Schlägt er mit einer Meldung über Konten fehl, löschen Sie die Konten oder beginnen Sie neu mit einem Werksreset. Diesen Befehl können Sie nur einmal setzen. Ein anderer Eigentümer erfordert erneut einen Reset.

Öffnen Sie danach in Tillor **Einstellungen** > **Tablets & Kioske**, setzen Sie die Art auf **Kiosk** und speichern Sie. Im Tab **Kiosk** sollte die Kachel **Kioskgerät** jetzt grün sein. Die anderen beiden Kacheln folgen, sobald Sie **App als Startbildschirm** und **Bildschirmsperre entfernen** gesendet haben. Eine Erklärung dieser Kacheln steht unter [Kiosk](/mobiele-app/toestelinstellingen#kiosk).

## Akku: die App nicht einschlafen lassen [#batterij-de-app-niet-laten-inslapen]

Android, und erst recht Xiaomi mit HyperOS, trennt die Verbindung einer App, die laut System "schläft". Der Kiosk fällt dann mitten in der Nacht offline, auch wenn der Bildschirm wegen der Nachtruhe aus sein soll.

Ist Tillor Eigentümer, bittet die App selbst darum, die Akku-Optimierung auszuschalten. Auf den meisten Tablets ist das ein Fenster, in dem Sie auf **Erlauben** tippen. Auf Xiaomi öffnet HyperOS stattdessen die Akku-Seite von Tillor: Wählen Sie dort **Keine Einschränkungen**. Überspringen Sie es, fragt die App nach dem nächsten Neustart erneut, und die Verbindung bleibt nachts unzuverlässig.

Keine App kann diese Ausnahme selbst setzen, auch nicht als Eigentümer des Geräts. Es bleibt also ein Tippen pro Tablet, oder der Befehl unten.

Kommt dieses Fenster nicht, setzen Sie die Ausnahme während der Einrichtung vom Computer aus:

```bash
adb shell dumpsys deviceidle whitelist +eu.tillor.app
```

Danach sollte die App im Hintergrund weiter mit Tillor sprechen, auch wenn der Bildschirm aus ist.

## Bildschirmsperre entfernen [#schermvergrendeling-weghalen]

Ein Muster oder eine PIN auf dem Tablet bedeutet, dass Android nach jedem Neustart auf dem Sperrbildschirm wartet. Der Kiosk bleibt dann schwarz, bis jemand vorbeikommt. Die Kachel **Bildschirmsperre** warnt davor: **Es ist ein Muster oder eine PIN festgelegt.**

1. Öffnen Sie den Tab **Kiosk**.
2. Setzen Sie unter **Android-Verwaltung** **Bildschirmsperre entfernen** auf **An**.
3. Wählen Sie **Speichern und senden**.

Das Tablet fragt nicht selbst danach. Die Sperre verschwindet, das nächste Mal wenn jemand das Muster oder die PIN eingibt, zum Beispiel nach einem Neustart. Danach endet ein Neustart in Tillor.

Möchten Sie nicht warten, entfernen Sie das Muster selbst in den Android-Einstellungen des Tablets. Die Kachel wird zu **Kein Muster und keine PIN: Ein Neustart endet in Tillor.**

<Callout type="info" title="Xiaomi: Navigationsschaltflächen">
Solange Tillor der Startbildschirm ist, schaltet HyperOS die Navigation von Gesten auf Schaltflächen um. Tillor blendet diese Leiste aus, bis jemand dreimal auf den Startbildschirm tippt. Wählen Sie in der App **Vorübergehend entsperren**, kommen Sie zurück auf den Startbildschirm von Xiaomi. Möchten Sie dort wieder Gesten, stellen Sie diese in den Android-Einstellungen ein.
</Callout>

## Was Sie danach einschalten [#wat-je-daarna-aanzet]

Für ein Tablet in einem Gehäuse an der Rezeption oder am Eingang ist dies ein brauchbares Set. Alles steht im Tab **Kiosk**, sofern nicht anders angegeben.

| Einstellung | Stand | Warum |
| --- | --- | --- |
| **App als Startbildschirm** | An | Die Home-Taste öffnet Tillor. Uhr und Akku bleiben sichtbar. |
| **App sperren** | An | Gäste können die App nicht verlassen. |
| **Systemoberfläche ausblenden** | An | Keine Benachrichtigungen, keine letzten Apps, kein Ein/Aus-Menü. |
| **Gerät absichern** | An | Kein Werksreset, kein abgesicherter Modus, keine USB-Übertragung, kein Deinstallieren. |
| **Beim Laden an lassen** | An | Der Bildschirm bleibt während der Öffnungszeiten an, solange das Ladegerät steckt. Die Nachtruhe hat Vorrang. |
| **Automatische Uhrzeit** | An | Die Nachtruhe folgt der Uhr der Organisation, nicht einer falsch gehenden Tabletuhr. |
| **Bildschirmausrichtung** | Hochformat oder Querformat | Unter **Bildschirm und Ruhe**, passend zum Gehäuse. **Standard** ist automatisches Drehen. |

**Lautstärke sperren** hält die Lautstärke aus dem Tab **Belege und Ton** fest, sodass ein Gast die Tasten an der Seite nicht nutzen kann.

Speichern Sie und prüfen Sie die drei Kacheln oben im Tab **Kiosk**. Grün bedeutet, dass das Tablet es so meldet. Eine Warnung bedeutet, dass dieser Schritt noch nicht gelungen ist.

## Eine neue App-Version über USB [#een-nieuwe-app-versie-over-usb]

**Gerät absichern** schaltet USB-Debugging und Dateiübertragung aus. **App sperren** hält das Tablet in der App, wodurch ein Installationsfenster nicht bestätigt werden kann.

Bevor Sie einen Build über das Kabel installieren:

1. Setzen Sie **App sperren** auf **Aus**.
2. Setzen Sie **Gerät absichern** auf **Aus**.
3. Wählen Sie **Speichern und senden** und warten Sie, bis das Tablet die Sperre loslässt.
4. Installieren Sie die neue Version. Auf Xiaomi fragt HyperOS am Tablet nach der Bestätigung der Installation über USB: Tippen Sie auf **Installieren**.
5. Setzen Sie beide Einstellungen wieder auf **An** und speichern Sie erneut.

Lassen Sie **Gerät absichern** an, sieht `adb` das Tablet nicht mehr. Die Akku-Ausnahme und das Eigentümerrecht bleiben bei einem normalen Update erhalten. Bei einem Werksreset nicht: Dann beginnen Sie wieder beim `dpm`-Befehl.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Tablet startet nach einem Neustart oder Stromausfall wieder in Tillor, auf dem Startbildschirm.
- Gäste können die App nicht verlassen und sehen keine Benachrichtigungen oder letzten Apps.
- Die drei Kacheln oben im Tab **Kiosk** zeigen, was das Tablet selbst meldet. Nach einer Änderung kann es etwas dauern, bis die Kacheln grün werden, denn das Tablet meldet sich alle 30 bis 60 Sekunden.
- Ein normales App-Update behält das Eigentümerrecht und die Akku-Ausnahme. Ein Werksreset nicht.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Befehl sagt, dass schon Konten auf dem Gerät sind">
Android verweigert einen Eigentümer, sobald ein Konto auf dem Tablet ist. Entfernen Sie die Konten oder beginnen Sie neu mit einem Werksreset.
</Accordion>
<Accordion title="adb devices zeigt unauthorized oder nichts">
Bestätigen Sie am Tablet das Fenster, das um Erlaubnis für den Computer bittet, und prüfen Sie, ob **USB-Debugging** an ist. Ist **Gerät absichern** an, sieht `adb` das Tablet nicht mehr: Schalten Sie es aus, wie beim USB-Update oben.
</Accordion>
<Accordion title="Der Tab Kiosk sagt Bildschirm anheften. Dieses Tablet ist kein eingerichteter Kiosk.">
Tillor ist noch nicht Eigentümer des Tablets, daher nutzt Android nur das Anheften des Bildschirms. Führen Sie den Eigentümerbefehl aus und wählen Sie danach **Speichern und senden**.
</Accordion>
<Accordion title="Die Schaltflächen unter Android-Verwaltung sind geschlossen">
Dabei steht die Meldung **Verfügbar, sobald dieses Tablet als Kiosk eingerichtet ist.** Richten Sie das Tablet wie oben ein oder nutzen Sie ein Android-Tablet: Auf iOS geht das nicht.
</Accordion>
<Accordion title="Der Kiosk ist nach einem Neustart schwarz">
Auf dem Tablet ist ein Muster oder eine PIN eingestellt. Schalten Sie **Bildschirmsperre entfernen** ein und geben Sie das Muster oder die PIN einmalig ein, oder entfernen Sie die Sperre in den Android-Einstellungen.
</Accordion>
<Accordion title="Der Kiosk fällt nachts offline">
Android hat die App einschlafen lassen. Schalten Sie die Akku-Optimierung für Tillor aus, wie unter der Überschrift Akku oben.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Geräteeinstellungen" href="/mobiele-app/toestelinstellingen#kiosk" description="Die Schalter im Tab Kiosk" />
  <Card title="Eine Nachtruhe für den Bildschirm einrichten" href="/mobiele-app/nachtrust-instellen" description="Den Bildschirm nachts ausschalten" />
  <Card title="Ein Tablet oder einen Kiosk verwalten" href="/mobiele-app/tablets-en-kiosken" description="Einstellungen senden" />
</Cards>


# Eine Nachtruhe für den Bildschirm einrichten (/de-DE/mobiele-app/nachtrust-instellen)

Ein Tablet, das die ganze Nacht an ist, verbraucht Strom und kann den Bildschirm einbrennen. Mit einer Nachtruhe geht der Bildschirm in den Stunden, in denen der Park geschlossen ist, aus oder wird schwarz. Die übrigen Bildschirmoptionen, etwa Dimmen, stehen unter [Geräteeinstellungen](/mobiele-app/toestelinstellingen#scherm-en-slaap).

<Requires permission="Einstellungen bearbeiten" />

Bevor Sie beginnen:

- Soll der Bildschirm wirklich ausgehen und sich aus der Ferne wieder wecken lassen, richten Sie das Tablet zuerst als Kiosk ein und setzen Sie die App in die Akku-Ausnahme. Siehe [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten).
- Wählen Sie die Öffnungszeiten Ihrer Organisation, tragen Sie diese zuerst ein. Siehe [Organisation](/gebruikers/organisaties#openingsuren).

## Die Nachtruhe einrichten [#de-nachtrust-instellen]

<Steps>
<Step>
### Den Tab Bildschirm und Ruhe öffnen [#open-het-tabblad-scherm-en-slaap]
Öffnen Sie das Gerät über <UIPath>Einstellungen > Tablets & Kioske</UIPath> und klicken Sie auf die Kachel **Bildschirm und Ruhe**. Suchen Sie die Gruppe **Nachtruhe**.
</Step>
<Step>
### Den Nachtmodus wählen [#kies-de-nachtstand]
<Tabs items={["Feste Zeiten", "Wenn die Organisation geschlossen ist"]}>
<Tab value="Feste Zeiten">
Wählen Sie **Feste Zeiten** und füllen Sie **Von** und **Bis** aus. Ein Zeitplan über Mitternacht, etwa 22:00 bis 07:00, ist erlaubt.
</Tab>
<Tab value="Wenn die Organisation geschlossen ist">
Der Bildschirm folgt den Öffnungszeiten Ihrer Organisation. Sie ändern diese an einer einzigen Stelle, und alle Geräte folgen.
</Tab>
</Tabs>
Mit **Aus** plant Tillor keine Ruhe.
</Step>
<Step>
### Den Schlafstil wählen [#kies-de-slaapstijl]
**Schwarze Fläche** legt eine schwarze Fläche über das Bild, und ein Tippen weckt es sofort. **Bildschirm aus** schaltet das Panel wirklich aus.
</Step>
<Step>
### Auf Speichern und senden klicken [#klik-op-opslaan-en-versturen]
Oben rechts in der Gruppe steht, wann die nächste Ruhe ansteht.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Tab Bildschirm und Ruhe, Nachtruhe von 22:00 bis 07:00" />

## Was passiert danach? [#wat-gebeurt-er-daarna]

- In der Nachtruhe geht der Bildschirm aus oder wird schwarz, auch wenn **Bildschirm eingeschaltet lassen** an ist. Die Nachtruhe hat Vorrang.
- Eine Berührung weckt den Bildschirm kurz auf.
- Am Ende des Zeitplans wird der Bildschirm wieder normal.
- Während der Nachtruhe sendet Tillor keine Benachrichtigung, dass das Gerät offline ist.
- Möchten Sie den Bildschirm außerhalb des Zeitplans wecken oder schlafen legen, nutzen Sie [Fernaktionen](/mobiele-app/acties-op-afstand).

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Bildschirm wird nachts nicht über Bildschirm aufwecken wach">
**Bildschirm aus** funktioniert vollständig auf einem Tablet, das als Kiosk eingerichtet ist. Das Aufwecken aus der Ferne klappt nur, wenn die App auch in der Akku-Ausnahme steht. Siehe [Akku](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
<Accordion title="Das Tablet geht zu früh oder zu spät aus">
Eine falsch gehende Uhr auf dem Tablet verschiebt den Zeitplan. Schalten Sie im Tab **Kiosk** **Automatische Uhrzeit** ein, damit das Tablet der Uhr der Organisation folgt.
</Accordion>
<Accordion title="Das Tablet ist nachts offline">
Android lässt die App einschlafen. Schalten Sie die Akku-Optimierung für Tillor aus, siehe [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Einen Kiosk einrichten" href="/mobiele-app/kiosk-inrichten" description="Eigentümer des Geräts und Akku" />
  <Card title="Fernaktionen" href="/mobiele-app/acties-op-afstand" description="Den Bildschirm wecken oder schlafen legen" />
</Cards>


# Den Startbildschirm und eine Diashow einrichten (/de-DE/mobiele-app/startscherm-en-diavoorstelling)

Der Startbildschirm ist das, was Gäste sehen, wenn kein Beleg auf dem Bildschirm steht: ein Begrüßungstext, Ihr Logo, Schaltflächen und gegebenenfalls eine Diashow mit Plakaten oder Fotos des Parks. Hier richten Sie das ein. Jede einzelne Einstellung mit ihren Grenzen steht unter [Geräteeinstellungen](/mobiele-app/toestelinstellingen#startscherm).

<Requires permission="Einstellungen bearbeiten" />

Bevor Sie beginnen:

- Das Gerät steht unter <UIPath>Einstellungen > Tablets & Kioske</UIPath>, siehe [Ein Tablet oder einen Kiosk verwalten](/mobiele-app/tablets-en-kiosken).
- Fotos sind JPEG-, PNG- oder WebP-Dateien oder ein `https`-Link auf ein Bild.

## Den Begrüßungstext anpassen [#de-welkomsttekst-aanpassen]

<Steps>
<Step>
### Den Tab Startbildschirm öffnen [#open-het-tabblad-startscherm]
Öffnen Sie das Gerät und klicken Sie auf die Kachel **Startbildschirm**. Das Feld **Willkommenstitel** (höchstens 60 Zeichen) und **Willkommensuntertitel** (höchstens 120) stehen oben.
</Step>
<Step>
### Den Text eintragen und senden [#vul-de-tekst-in-en-verstuur]
Lassen Sie ein Feld leer, wenn die App ihren eigenen Text behalten soll. Klicken Sie auf **Speichern und senden**.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Tab Startbildschirm, mit Aussehen und Schaltflächen markiert" />

## Eine Diashow hinzufügen [#een-diavoorstelling-toevoegen]

<Steps>
<Step>
### Den Tab Diashow und Schaltflächen öffnen [#open-het-tabblad-diavoorstelling-en-knoppen]
Klicken Sie auf diese Kachel. Bei **Anzeige** wählen Sie, wie die Fotos erscheinen.
</Step>
<Step>
### Die Anzeige wählen [#kies-de-weergave]
<Tabs items={["Als Hintergrund", "Vollbild bei Inaktivität"]}>
<Tab value="Als Hintergrund">
Die Fotos wechseln hinter dem Logo und den Schaltflächen, anstelle des Hintergrunds Ihrer Organisation. Gäste können dabei gleichzeitig auf die Schaltflächen tippen.
</Tab>
<Tab value="Vollbild bei Inaktivität">
Die Fotos übernehmen den ganzen Bildschirm, sobald niemand ihn berührt. Eine Berührung bringt den Startbildschirm zurück. Wie lange das Warten dauert, stellen Sie bei **Starten nach** ein.
</Tab>
</Tabs>
</Step>
<Step>
### Fotos hinzufügen [#voeg-fotos-toe]
Klicken Sie auf **Foto hochladen** oder fügen Sie über **Link hinzufügen** eine `https`-Adresse ein. Sie können bis zu 20 Fotos hinzufügen. Setzen Sie bei einem Foto gegebenenfalls eine Bildunterschrift von höchstens 80 Zeichen.
</Step>
<Step>
### Das Timing einstellen [#stel-de-timing-in]
**Zeit pro Foto** reicht von 3 bis 600 Sekunden. **Starten nach** von 10 bis 3600 Sekunden. Bei **Anpassung** wählen Sie **Bildschirm füllen** (die Ränder werden beschnitten) oder **Ganzes Foto zeigen** (mit schwarzen Rändern).
</Step>
<Step>
### Auf Speichern und senden klicken [#klik-op-opslaan-en-versturen]
Das Tablet zeigt die Diashow, sobald es die Einstellungen hat.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Tab Diashow und Schaltflächen, mit der Anzeige und zwei zusätzlichen Schaltflächen" />

## Zusätzliche Schaltflächen hinzufügen [#extra-knoppen-toevoegen]

Zusätzliche Schaltflächen sind Verknüpfungen auf dem Startbildschirm, zum Beispiel zu einem Lageplan oder zum Gästenetzwerk. Sie können sechs haben.

<Steps>
<Step>
### Auf Schaltfläche hinzufügen klicken [#klik-op-knop-toevoegen]
Es erscheint eine leere Zeile.
</Step>
<Step>
### Die Schaltfläche ausfüllen [#vul-de-knop-in]
Geben Sie einen Text, eine kurze Beschreibung und eine Webadresse (nur `https`) an. Wählen Sie ein Symbol aus der Reihe und bei **Anzeigen**, ob die Schaltfläche immer sichtbar ist oder erst nach einem Tippen.
</Step>
<Step>
### Auf Speichern und senden klicken [#klik-op-opslaan-en-versturen-1]
</Step>
</Steps>

Das Papierkorb-Symbol entfernt eine Schaltfläche. **Gerät entscheiden lassen** verwirft die Liste aus Tillor, sodass das Tablet seine eigenen Schaltflächen nutzt.

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Das Tablet passt den Startbildschirm an, sobald die Einstellungen eingetroffen sind. Ein Tablet, das offline ist, tut das, sobald es wieder verbunden ist.
- Haben Sie **Prepaid-Schaltfläche** oder **Einstellungen-Schaltfläche** auf **Nach Antippen** gesetzt, verschwindet die Schaltfläche nach der Anzahl Sekunden, die Sie bei **Ausblenden nach** eingetragen haben.
- Ein Beleg, Dokument oder eine Unterschriftsanfrage, die Tillor an das Tablet sendet, erscheint über dem Startbildschirm und verschwindet wieder.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Foto hochladen funktioniert nicht und Tillor meldet Hochladen fehlgeschlagen">
Die Datei ist kein JPEG, PNG oder WebP, oder der Upload wurde abgebrochen. Versuchen Sie ein anderes Foto oder nutzen Sie **Link hinzufügen** mit der Adresse des Bildes.
</Accordion>
<Accordion title="Ich kann keine Fotos hinzufügen">
Die Schaltflächen erscheinen erst, wenn **Anzeige** nicht auf **Aus** steht. Steht die Liste bei 20 Fotos, entfernen Sie zuerst eines mit **Foto entfernen**.
</Accordion>
<Accordion title="Die Diashow startet nicht">
Bei **Vollbild bei Inaktivität** startet sie erst nach der Anzahl Sekunden bei **Starten nach** ohne Berührung. Der Standard für eine neue Diashow sind 60 Sekunden. Prüfen Sie auch, ob das Tablet die neuen Einstellungen schon hat.
</Accordion>
<Accordion title="Meine Schaltfläche öffnet nichts">
Die Adresse muss mit `https` beginnen. Prüfen Sie, ob der Link in einem Browser funktioniert.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Geräteeinstellungen" href="/mobiele-app/toestelinstellingen" description="Alle Einstellungen und Grenzen" />
  <Card title="Ein Tablet oder einen Kiosk verwalten" href="/mobiele-app/tablets-en-kiosken" description="Einstellungen senden" />
</Cards>


# Ein Tablet oder einen Kiosk verwalten (/de-DE/mobiele-app/tablets-en-kiosken)

Jedes Tablet, jeder Kiosk und jedes Telefon, auf dem jemand die Tillor-App öffnet und eine Organisation wählt, erscheint in Tillor. Von dort aus sehen Sie, ob das Gerät noch verbunden ist, und senden ihm den Startbildschirm, den Ton und die Kiosksperre. Was Sie einstellen können, steht pro Tab unter [Geräteeinstellungen](/mobiele-app/toestelinstellingen).

<Requires permission="Instellingen bewerken" />

Bevor Sie beginnen:

- Das Gerät muss die Tillor-App haben, und jemand muss bei Ihrer Organisation angemeldet sein. Ist das nicht der Fall, sehen Sie **Noch keine Geräte**.
- Einstellungen senden dürfen Sie nur mit dem Recht **Einstellungen bearbeiten**.

## Einstellungen an ein Gerät senden [#instellingen-naar-een-toestel-sturen]

<Steps>
<Step>
### Die Liste öffnen [#open-de-lijst]
Gehen Sie zu <UIPath>Einstellungen > Tablets & Kioske</UIPath>. Jede Zeile ist eine Installation der App. Sie sehen den Namen, die Art (**Tablet**, **Kiosk** oder **Telefon**), das Modell, die App-Version, den Akkustand und ob das Gerät verbunden ist. **Zuletzt gesehen** bedeutet, dass die App seit einiger Zeit nichts gemeldet hat.

<DocScreenshot src="/screenshots/tablets/devices-list.png" alt="Einstellungen > Tablets und Kioske mit dem Kiosk Zelfbedieningskiosk" />
</Step>
<Step>
### Das Gerät öffnen [#open-het-toestel]
Klicken Sie auf die Zeile des Geräts. Oben stehen der Name und der Status. Darunter folgen ein Suchfeld und eine Reihe von Kacheln, eine pro Tab.

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Geräteseite von Zelfbedieningskiosk mit Tab-Kacheln und der Speichern-Leiste" />

Auf einer Kachel steht, wie viele Einstellungen aus Tillor kommen. **Alles am Gerät** bedeutet, dass Sie auf diesem Tab noch nichts festgelegt haben. Rechts bleibt das Panel **Fernaktionen** stehen, siehe [Fernaktionen](/mobiele-app/acties-op-afstand).
</Step>
<Step>
### Die Einstellungen anpassen [#pas-de-instellingen-aan]
Wählen Sie einen Tab und ändern Sie, was Sie möchten. Fast jeder Schalter hat drei Stellungen: **Gerät entscheidet**, **Ein** und **Aus**. **Gerät entscheidet** belässt die Wahl, die am Tablet selbst getroffen wurde. **Ein** und **Aus** überschreiben diese Wahl, sobald Sie speichern. Unter der Beschreibung steht, was die App tut, wenn niemand etwas gewählt hat, zum Beispiel **Voreinstellung: Ein**.
</Step>
<Step>
### Auf Speichern und senden klicken [#klik-op-opslaan-en-versturen]
Nichts geht an das Gerät, solange Sie hier nicht klicken. Solange etwas geändert ist, steht in der Leiste **Nicht gesendete Änderungen**, und der Tab hat einen grünen Punkt. **Änderungen verwerfen** setzt das Formular auf das zurück, was aktuell auf dem Gerät steht.

Vor und nach einer Änderung, die Sie noch nicht gesendet haben:

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Vorher: Geräteseite ohne Änderungen" />

<DocScreenshot src="/screenshots/tablets/device-page-unsaved.png" alt="Nachher: eine geänderte Einstellung mit Nicht gesendete Änderungen und einem grünen Punkt auf dem Tab" />
</Step>
</Steps>

## Dasselbe für alle Geräte [#hetzelfde-voor-alle-toestellen]

Haben Sie mehrere Geräte derselben Art, müssen Sie nicht jedes einzeln einstellen.

<Tabs items={["Ein Gerät", "Alle Geräte dieser Art"]}>
<Tab value="Eén toestel">
Klicken Sie auf **Speichern und senden**. Nur dieses Gerät erhält die Einstellungen.
</Tab>
<Tab value="Alle toestellen van dit soort">
Klicken Sie auf **Auf alle Kioske anwenden** (oder **Tablets**, oder **Telefone**, je nach Art). Tillor kopiert die Einstellungen dieses Geräts auf die anderen Geräte derselben Art und sendet sie sofort, mit der Meldung **Einstellungen auf die anderen Geräte kopiert**. Der Name, die Art und die Benachrichtigungen bleiben bei jedem Gerät eigen. Die Sprache wird dagegen mitgenommen.
</Tab>
</Tabs>

## In allen Tabs suchen [#zoeken-over-alle-tabbladen]

Wissen Sie nicht, auf welchem Tab eine Einstellung steht? Das Feld **Einstellungen suchen** durchsucht alle Tabs gleichzeitig. Die Kacheln bleiben stehen, darunter erscheint eine Trefferliste, nach Tab gruppiert.

<DocScreenshot src="/screenshots/tablets/device-search.png" alt="Suche nach Helligkeit, mit den Treffern von Bildschirm und Ruhe" />

Eine Suche wie `helderheid` zeigt die Helligkeitszeilen von **Bildschirm und Ruhe** und darunter andere Tabs, die das Wort ebenfalls enthalten. **Tab öffnen** schließt die Suche und öffnet diesen Tab, sodass Sie auch den Rest der Gruppe sehen. Finden Sie nichts, steht dort **Keine Einstellungen für** Ihren Suchbegriff **gefunden**.

## Ein Gerät vergessen [#een-toestel-vergeten]

Das Menü mit den drei Punkten oben rechts auf der Geräteseite enthält **Gerät vergessen**. Nutzen Sie das für ein Tablet, das nicht mehr im Einsatz ist.

<DocScreenshot src="/screenshots/tablets/device-menu.png" alt="Menü mit Gerät vergessen" />

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Tillor meldet **Einstellungen gesendet**. Das Tablet wendet sie sofort an, wenn es verbunden ist. Ist es offline, erhält es sie, sobald es wieder Kontakt zu Tillor hat. Die App meldet sich alle 30 bis 60 Sekunden.
- Auf der Geräteseite und in der Liste steht, ob das Gerät verbunden ist. Das Gerät meldet auch Akku, App-Version und Verbindung zurück, siehe [Diagnose und Verlauf](/mobiele-app/diagnose-en-geschiedenis).
- Jede Änderung landet im Verlauf des Geräts und im [Aktivitätsprotokoll](/activiteitenlog) Ihrer Organisation.
- Ein vergessenes Gerät verschwindet aus der Liste, und die gesendeten Einstellungen gehen mit. Läuft die App noch darauf und ist jemand angemeldet, kommt es innerhalb einer Minute zurück, ohne diese Einstellungen. Sie müssen sie dann neu festlegen.
- Schalten Sie **Benachrichtigungen** auf dem Tab **Gerät** ein, erhalten die Personen, die die Einstellungen verwalten, eine Nachricht, wenn das Gerät 10 Minuten offline ist oder der Akku ohne Ladegerät unter 15 % fällt.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Ich sehe Noch keine Geräte">
Es hat sich noch kein Tablet angemeldet. Öffnen Sie die Tillor-App auf dem Tablet, melden Sie sich an und wählen Sie die richtige Organisation. Das Gerät erscheint innerhalb einer Minute.
</Accordion>
<Accordion title="Tillor meldet Einstellungen konnten nicht gespeichert werden">
Das Speichern hat nicht geklappt, oft wegen einer instabilen Verbindung oder weil Ihnen das Recht **Einstellungen bearbeiten** fehlt. Versuchen Sie es erneut. Klappt es dann immer noch nicht, bitten Sie Ihren Administrator um das Recht.
</Accordion>
<Accordion title="Tillor meldet Einstellungen konnten nicht kopiert werden">
**Auf alle Kioske anwenden** hat nicht geklappt. Klicken Sie noch einmal. Funktioniert es nicht, speichern Sie das Gerät mit **Speichern und senden** und öffnen Sie die anderen Geräte nacheinander.
</Accordion>
<Accordion title="Das Tablet tut nichts mit meiner Änderung">
Prüfen Sie, ob das Gerät **Verbunden** ist. Ist es offline, wendet es die Einstellungen an, sobald es wieder Kontakt hat. Steht der Schalter auf **Gerät entscheidet**, entscheidet das Tablet selbst. Wählen Sie **Ein** oder **Aus**, um das zu überstimmen.
</Accordion>
<Accordion title="Das Gerät ist nach Gerät vergessen zurück">
Die App läuft noch und jemand ist angemeldet, also meldet sie sich erneut an. Melden Sie sich am Tablet ab, wenn Sie das Gerät wirklich loswerden möchten. Unter **Konto** > **Aktive Sitzungen** können Sie die App-Sitzung beenden.
</Accordion>
<Accordion title="Tillor meldet 4 bis 6 Ziffern verwenden">
Der **Code für Einstellungen** auf dem Tab **Startbildschirm** muss aus 4 bis 6 Ziffern bestehen oder leer sein. Erst dann können Sie speichern.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Geräteeinstellungen" href="/mobiele-app/toestelinstellingen" description="Was auf jedem Tab steht" />
  <Card title="Einen Kiosk einrichten" href="/mobiele-app/kiosk-inrichten" description="Android-Tablet sperren, sodass Gäste nicht herauskommen" />
  <Card title="Fernaktionen" href="/mobiele-app/acties-op-afstand" description="Bildschirm wecken, neu starten und ein Screenshot" />
</Cards>


# Geräteeinstellungen (/de-DE/mobiele-app/toestelinstellingen)

Hier finden Sie alle Einstellungen eines Geräts, pro Tab, mit ihren Voreinstellungen und Grenzen. Es sind sechs, jeweils eine Kachel über den Formularen. Wie Sie dorthin kommen, wie die Suche funktioniert und wann etwas an das Gerät gesendet wird, steht unter [Ein Tablet oder einen Kiosk verwalten](/mobiele-app/tablets-en-kiosken). Den Startbildschirm beschreiben wir Schritt für Schritt unter [Den Startbildschirm und eine Diashow einrichten](/mobiele-app/startscherm-en-diavoorstelling) und die Nachtruhe unter [Eine Nachtruhe für den Bildschirm einrichten](/mobiele-app/nachtrust-instellen).

Jede Zeile hat ein Symbol, eine kurze Erklärung und, wo das sinnvoll ist, die Voreinstellung der App. Wählen Sie **Gerät** (oder lassen Sie eine Zahl auf **Voreinstellung** leer), wenn das Tablet seine eigene Wahl behalten darf. **Ein** und **Aus** überschreiben diese Wahl.

Zeilen, die nur auf einem eingerichteten Kiosk funktionieren, zeigen eine Warnung, solange das Tablet das noch nicht ist: **Verfügbar, sobald dieses Tablet als Kiosk eingerichtet ist.** Diese Schritte stehen unter [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten).

## Startbildschirm [#startscherm]

Begrüßungstext, Hintergrund und die Schaltflächen, die Gäste sehen, wenn kein Beleg auf dem Bildschirm steht.

### Begrüßungstext [#welkomsttekst]

**Willkommenstitel** (höchstens 60 Zeichen) und **Willkommensuntertitel** (höchstens 120) stehen oben auf dem Startbildschirm. Lassen Sie ein Feld leer, wenn die App ihren eigenen Text behalten darf.

### Aussehen [#uiterlijk]

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Tab Startbildschirm, mit Aussehen und Schaltflächen markiert" />

**Aussehen** (Markierung **1**):

- **Hintergrundfoto** zeigt den Hintergrund der Organisation hinter dem Logo. Standardmäßig an.
- **Hintergrund abdunkeln** ist ein Prozentwert von 0 bis 90. Standardmäßig 45, damit Logo und Schaltflächen auf einem hellen Foto lesbar bleiben.
- **Logostil** ist **Weiße Silhouette** (die Voreinstellung) oder **In Farbe auf einer Karte**.

### Schaltflächen [#knoppen]

**Schaltflächen** (Markierung **2**):

- **Prepaid-Schaltfläche** öffnet Guthaben, Aufladen und Bezahlen mit einer NFC-Karte. Standardmäßig an.
- **Einstellungen-Schaltfläche** zeigt eine Schaltfläche zu den Einstellungen auf dem Gerät selbst. Ist sie aus, kommen Sie dorthin, indem Sie dreimal auf den Startbildschirm tippen.
- **Anzeigen** ist **Immer** oder **Nach Antippen**. Bei **Nach Antippen** füllen Sie **Ausblenden nach** in Sekunden aus. Danach verschwindet die Schaltfläche wieder, bis jemand den Bildschirm antippt.
- **Code für Einstellungen** besteht aus 4 bis 6 Ziffern. Das Gerät fragt diesen Code ab, bevor sich seine eigenen Einstellungen öffnen. Leer bedeutet kein Code. Etwas anderes als 4 bis 6 Ziffern können Sie nicht speichern.

## Diashow und Schaltflächen [#diavoorstelling-en-knoppen]

Fotos, die der Startbildschirm abwechselnd zeigt, und zusätzliche Schaltflächen zu einer Webseite.

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Tab Diashow und Schaltflächen, mit der Anzeige und zwei zusätzlichen Schaltflächen" />

### Diashow [#diavoorstelling]

**Anzeige** (Markierung **1**) hat drei Stellungen:

- **Aus** zeigt keine Fotos.
- **Als Hintergrund** wechselt die Fotos hinter dem Logo und den Schaltflächen, anstelle des Organisationshintergrunds.
- **Vollbild bei Inaktivität** übernimmt den ganzen Bildschirm, sobald niemand den Bildschirm berührt.

Sobald die Anzeige nicht auf **Aus** steht, können Sie bis zu 20 Fotos hinzufügen. **Foto hochladen** akzeptiert JPEG, PNG oder WebP. **Link hinzufügen** fügt eine `https`-Adresse eines Bildes ein. Pro Foto können Sie eine Bildunterschrift mit höchstens 80 Zeichen setzen.

- **Zeit pro Foto** ist, wie lange jedes Foto bleibt, von 3 bis 600 Sekunden. Eine neue Diashow beginnt bei 10.
- **Starten nach** gilt nur für das Vollbild: Sekunden ohne Berührung, bevor die Diashow startet, von 10 bis 3600. Eine neue Diashow beginnt bei 60.
- **Anpassung**: **Bildschirm füllen** schneidet die Ränder ab, **Ganzes Foto zeigen** behält das ganze Foto mit schwarzen Balken. Eine neue Diashow beginnt bei **Ganzes Foto zeigen**.

Eine Berührung während einer Vollbild-Diashow bringt den Startbildschirm zurück.

### Zusätzliche Schaltflächen [#extra-knoppen]

**Zusätzliche Schaltflächen** (Markierung **2**) sind Verknüpfungen auf dem Startbildschirm, zum Beispiel eine Karte oder das Gästenetzwerk. Sie können sechs davon haben.

Pro Schaltfläche geben Sie den Text der Schaltfläche, eine kurze Beschreibung, die Webadresse und ein Symbol an. Das Symbol wählen Sie aus der Reihe: Karte, Webseite, Informationen, Kalender, Essen und Trinken, WLAN, Telefon oder Eintrittskarten. **Anzeigen** funktioniert wie bei der Prepaid-Schaltfläche: immer, oder erst nach einem Antippen und danach wieder ausblenden.

**Schaltfläche hinzufügen** erstellt eine leere Zeile. Das Papierkorb-Symbol entfernt die Schaltfläche. **Gerät entscheiden lassen** verwirft die Liste aus Tillor, sodass das Tablet seine eigenen Schaltflächen verwendet. Solange Sie noch keine Schaltflächen gespeichert haben, steht dieser Satz ebenfalls dort: Aus Tillor sind keine Schaltflächen festgelegt.

## Bildschirm und Ruhe [#scherm-en-slaap]

Helligkeit, Ausrichtung, Farben und wann der Bildschirm nachts ausgeht.

### Helligkeit [#helderheid]

Suchen Sie eine Einstellung, versuchen Sie `helderheid` im Suchfeld, siehe [In allen Tabs suchen](/mobiele-app/tablets-en-kiosken#zoeken-over-alle-tabbladen).

- **Kioskmodus** hält den Bildschirm an, mit Belegen, Unterschriften und Helligkeitsregelung. Auf einem Tablet oder Kiosk standardmäßig an, auf einem Telefon aus.
- **Bildschirm eingeschaltet lassen** verhindert, dass der Bildschirm in den Ruhezustand geht. Standardmäßig an, auf einem Telefon aus.
- **Bei Inaktivität dimmen** geht bei einer Berührung auf volle Helligkeit und dimmt danach. Standardmäßig an, auf einem Telefon aus.
- **Dimmen nach** ist die Anzahl der Sekunden ohne Berührung, von 5 bis 3600. Standardmäßig 15.
- **Gedimmte Helligkeit** ist der Prozentwert in diesem gedimmten Zustand, von 0 bis 100. Standardmäßig 0,5 %.

Die Nachtruhe weiter unten geht vor **Bildschirm eingeschaltet lassen**: In den Ruhestunden geht der Bildschirm trotzdem aus oder wird schwarz.

### Darstellung [#weergave]

- **Bildschirmausrichtung** ist **Automatisch drehen** (die Voreinstellung), **Hochformat** oder **Querformat**. Legen Sie einen Kiosk im Gehäuse fest, sonst dreht sich das Bild, wenn jemand das Tablet schief hält.
- **Darstellung** ist **Dem Gerät folgen**, **Hell** oder **Dunkel**.

### Nachtruhe [#nachtrust]

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Tab Bildschirm und Ruhe, Nachtruhe von 22:00 bis 07:00" />

**Nachtmodus** (Markierung **1**) hat drei Stellungen:

- **Aus** plant keinen Schlaf.
- **Feste Zeiten** nutzt **Von** und **Bis**. Ein Zeitplan, der über Mitternacht läuft, etwa 22:00 bis 07:00, ist erlaubt. Der Bildschirm geht in diesem Block aus, auch wenn er den Rest des Tages an bleiben soll. Eine Berührung weckt ihn kurz.
- **Wenn die Organisation geschlossen ist** folgt den Öffnungszeiten der Organisation.

Oben rechts in der Gruppe steht, wann der nächste Schlaf ansteht.

**Schlafstil**:

- **Schwarze Fläche** legt eine schwarze Fläche über das Bild. Der Bildschirm bleibt berührbar, ein Tippen weckt ihn also sofort.
- **Bildschirm aus** schaltet das Panel wirklich aus. Es wacht am Ende des Zeitplans wieder auf, oder über **Bildschirm aufwecken** bei [Fernaktionen](/mobiele-app/acties-op-afstand). Das funktioniert vollständig auf einem Tablet, das als Kioskgerät eingerichtet ist. Das Aufwecken aus der Ferne gelingt nur, wenn die App auch in der Akku-Ausnahme steht, siehe [Akku](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).

## Belege und Ton [#kassabonnen-en-geluid]

Was das Tablet tut, wenn Tillor ein Dokument sendet, und welche Töne es abspielt.

<DocScreenshot src="/screenshots/tablets/tab-sound.png" alt="Tab Belege und Ton" />

### Belege und Dokumente [#kassabonnen-en-documenten]

Markierung **1**:

- **Belege und Dokumente anzeigen** zeigt PDFs, Bilder und Unterschriftsanfragen auf diesem Gerät. Standardmäßig an, auf einem Telefon aus. Schalten Sie es auf einem Tablet aus, das nur ein Startbildschirm sein und keine Belege zeigen soll.
- **Ausblenden nach** ist die Anzahl der Sekunden, die ein Beleg stehen bleibt, bevor das Gerät ihn selbst entfernt, von 5 bis 900. Lassen Sie es leer, um zu warten, bis Tillor den Bildschirm löscht.

### Ton [#geluid]

Markierung **2**. Alles hier steht standardmäßig an, Lautstärke auf 100 %.

- **Ton beim Start** wird abgespielt, wenn die App startet oder neu startet.
- **Ton bei Belegen und Dokumenten** wird abgespielt, wenn ein Beleg, ein Bild oder eine Unterschriftsanfrage eintrifft.
- **Ton bei Online-Zahlungen** wird abgespielt, wenn eine Rechnung online oder per automatischer Überweisung bezahlt wurde.
- **Ton bei schwachem Akku** spielt eine Warnung, wenn der Akku fast leer ist und das Ladegerät nicht angeschlossen ist.
- **Lautstärke** ist 0 bis 100. Auf einem Kiosk können Sie sie mit **Lautstärke sperren** auf dem Tab **Kiosk** festhalten.

**Testton abspielen** steht bei [Fernaktionen](/mobiele-app/acties-op-afstand), nicht auf diesem Tab.

## Kiosk [#kiosk]

Nur auf Android sinnvoll. Die Einrichtung (Eigentümer des Geräts, Akku, USB) steht unter [Einen Kiosk einrichten](/mobiele-app/kiosk-inrichten). Auf diesem Tab setzen Sie danach die Schalter.

<DocScreenshot src="/screenshots/tablets/tab-kiosk.png" alt="Tab Kiosk mit Statuskacheln und Sperre" />

### Status [#status]

Drei Kacheln (Markierung **1**) zeigen, was das Tablet bei seiner letzten Meldung gesagt hat. Sie sind keine Einstellungen.

- **Kioskgerät** ist grün bei **Eingerichteter Kiosk: die Sperre ist vollständig.** Eine Warnung bedeutet Bildschirm anheften (die App ist nicht der Eigentümer) oder dass die App gar nicht gesperrt ist. Ein Strich bedeutet, dass diese App-Version den Status noch nicht übermittelt.
- **Startbildschirm** ist grün, wenn Tillor der Startbildschirm ist. Sonst steht dort, dass Tillor es noch nicht ist, oder dass die App es noch nicht gemeldet hat.
- **Bildschirmsperre** warnt, wenn auf dem Tablet ein Muster oder eine PIN eingerichtet ist. Nach einem Neustart wartet das Gerät dann auf dem Sperrbildschirm. Grün bedeutet, dass ein Neustart in Tillor endet.

### Sperre [#vergrendeling]

Markierung **2**. Diese drei stehen standardmäßig auf aus, bis Sie sie selbst einschalten.

- **App als Startbildschirm** macht Tillor zum Startbildschirm. Uhr und Akku bleiben sichtbar. Nur Android, und nur mit einem App-Build, der das kann.
- **App sperren** hält das Tablet in der Tillor-App. Auf einem eingerichteten Kiosk kommt ein Gast nicht heraus. Ohne diese Einrichtung fällt Android auf Bildschirm anheften zurück: Jemand am Tablet muss das bestätigen, und man kann es verlassen.
- **Systemoberfläche ausblenden** entfernt Benachrichtigungen, letzte Apps und das Ein/Aus-Menü. Uhr und Akku bleiben. Das funktioniert erst, wenn das Tablet als Kioskgerät eingerichtet ist.

### Android-Verwaltung [#android-beheer]

<DocScreenshot src="/screenshots/tablets/tab-kiosk-android.png" alt="Android-Verwaltung auf dem Tab Kiosk" />

Alles in dieser Gruppe (Markierung **1**) gilt nur für einen eingerichteten Kiosk. Auf einem anderen Gerät sehen Sie bei jeder Zeile die Warnung, und die Schalter sind aus. Standardmäßig stehen die Schalter auf aus. Die beiden Zahlen sind leer: Das Tablet behält dann seine eigene Helligkeit und sein eigenes Timeout.

- **Gerät absichern** blockiert Werksreset, abgesicherten Modus, neue Nutzer, USB-Übertragung, Deinstallation und Beenden erzwingen. Schalten Sie das aus, bevor Sie ein Update über USB installieren.
- **Bildschirmsperre entfernen** entfernt das Muster oder die PIN. Es wird wirksam, sobald dieses Muster oder diese PIN noch einmal eingegeben wurde.
- **Beim Laden an lassen** hält den Bildschirm während der Öffnungszeiten an, solange das Ladegerät angeschlossen ist. Die Nachtruhe schaltet ihn trotzdem aus.
- **Lautstärke sperren** hält die Lautstärke aus **Ton** fest.
- **Updates im Schlaf** installiert Systemupdates, während der Bildschirm schläft, und hält sie zurück, solange das Tablet benutzt wird.
- **Automatische Uhrzeit** verlangt automatisches Datum, Uhrzeit und Zeitzone, damit der Schlaf den Öffnungszeiten folgt.
- **Bildschirmhelligkeit** ist eine feste Helligkeit des Tablets selbst, von 1 bis 100, bei ausgeschalteter automatischer Helligkeit. Leer lassen behält die Einstellung des Tablets.
- **Bildschirm-Timeout** ist die Anzahl der Sekunden (15 bis 3600), nach der Android den Bildschirm ausschaltet, wenn die App ihn nicht eingeschaltet hält. Leer lassen behält die Einstellung des Tablets.

## Gerät [#toestel]

Name, Art, Sprache und Benachrichtigungen. **Auf alle Kioske anwenden** nimmt die Sprache auf die anderen Geräte derselben Art mit und lässt Name, Art und Benachrichtigungen stehen.

<DocScreenshot src="/screenshots/tablets/tab-general.png" alt="Tab Gerät mit Name, Art, Sprache und Benachrichtigungen" />

Markierung **1**:

- **Name** ist das, was Sie in der Liste und auf dem Gerät sehen, zum Beispiel `Zelfbedieningskiosk`. Höchstens 80 Zeichen.
- **Art** ist **Tablet**, **Kiosk** oder **Telefon**. Die Art bestimmt den Text auf **Auf alle … anwenden** und ein paar Voreinstellungen: Auf einem Telefon beginnen Kioskmodus, Belege, Bildschirm eingeschaltet lassen und Dimmen auf aus.
- **Sprache** ist die einzige Liste, die zuklappt, weil es mehr Optionen gibt, als in eine Schaltflächenreihe passen. **Voreinstellung** folgt der Sprache des Tablets. Sonst wählen Sie eine Sprache der Tillor-App. Die Namen stehen in der jeweiligen Sprache selbst.
- **Benachrichtigungen** benachrichtigt die Personen, die die Einstellungen verwalten, wenn dieses Gerät 10 Minuten offline ist oder der Akku ohne Ladegerät unter 15 % fällt. Während der Nachtruhe kommt keine Offline-Meldung. Standardmäßig aus.

<Callout type="info">
Die Sprache hier ist die Sprache der App auf dem Tablet. Die Sprache des Android-Systems sehen Sie bei **Diagnose**, als **Gerätesprache**.
</Callout>


# Automatisierungen (/de-DE/ontwikkelaars/automatiseringen)

Automatisierungen lassen Tillor selbst Aktionen ausführen, etwa Aufgaben anlegen oder Ihr System aufrufen. Die Anleitung für Anwender steht unter [Automatisierungen](/automatiseringen). Diese Seite beschreibt, was ein Integrator sieht: die Nachricht des Schritts **Webhook senden**, die **API-Anfrage** an eine eigene URL oder an die Tillor API, und wie ein Flow aufgebaut ist, wenn Sie ihn über die API verwalten.

## Webhook senden [#webhook-versturen]

Der Schritt **Webhook senden** liefert eine eigene Nachricht an einen der [Webhooks](/ontwikkelaars/webhooks) der Organisation aus. Es ist dieselbe Zustellung wie bei gewöhnlichen Webhook-Events, mit derselben Signatur.

### Die Nachricht [#het-bericht]

Der Schritt sendet einen `POST` mit `Content-Type: application/json` und diesen Headern:

| Header | Inhalt |
|---|---|
| `X-Webhook-Event-ID` | Eine eindeutige ID für diese Zustellung. Bei neuen Versuchen bleibt der Wert gleich, Sie können also darüber deduplizieren |
| `X-Webhook-Signature` | `sha256=<hex>`, der HMAC-SHA256 des Bodys mit dem Signing Secret des Webhooks |

Der Body hat denselben Umschlag wie die Webhook-Payload:

```json
{
  "event": "automation.invoice_unpaid",
  "data": {
    "invoice": "2026-0042",
    "amountOutstanding": 125.5
  },
  "timestamp": 1735689600000,
  "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d",
  "triggeredBy": null
}
```

| Feld | Beschreibung |
|---|---|
| `event` | Der **Ereignisname**, den Sie im Schritt eingetragen haben. Jeder Text ist erlaubt, der Name muss nicht in der Liste der Event-Keys stehen |
| `data` | Die **Payload** aus dem Schritt, nachdem die Variablen eingesetzt wurden, als JSON |
| `timestamp` | Unix-Zeit in Millisekunden der Zustellung |
| `traceId` | Eine zufällige UUID pro Zustellung. Anders als bei Events aus dem System ist dies keine Trace-ID einer Tillor-Aktion |
| `triggeredBy` | Immer `null` |

Es gibt keine `spanId`. Der Webhook muss auf keinen Event-Key abonniert sein: Eine Nachricht aus einer Automatisierung wird immer am gewählten Endpunkt zugestellt, solange dieser existiert und aktiviert ist.

Wie Sie die Signatur prüfen, steht unter [Signatur verifizieren](/ontwikkelaars/webhooks#handtekening-verifiëren).

### Versuche und Ergebnis [#pogingen-en-uitkomst]

Tillor macht innerhalb des Schritts bis zu 5 Versuche, mit 1, 2, 4 und 8 Sekunden Wartezeit dazwischen. Ein Versuch gilt als erfolgreich bei einem 2xx-Status. Auch ein blockiertes Ziel, zum Beispiel eine interne Adresse, zählt als fehlgeschlagener Versuch.

- Gelingt einer der Versuche, läuft der Flow über den Ausgang **Erfolgreich** weiter
- Scheitern alle fünf, läuft der Flow über **Fehlgeschlagen** weiter. Die Nachricht wird danach im Hintergrund noch einmal versucht, nach dem Schema unter [Zustellverhalten und Retries](/ontwikkelaars/webhooks#leveringsgedrag-en-retries). Gelingt ein solcher späterer Versuch, taucht das nicht mehr in der Ausführung auf, denn diese ist dann bereits weitergelaufen

Existiert der Webhook nicht mehr oder ist er deaktiviert, läuft der Schritt nicht über **Fehlgeschlagen**. Die Ausführung stoppt dann mit dem Status **Fehlgeschlagen**.

## API-Anfrage an eine eigene URL [#api-verzoek-naar-een-eigen-url]

Mit **API-Anfrage** und **Senden an** auf **Eigene URL** sendet eine Automatisierung eine HTTP-Anfrage an Ihren Server.

| Bestandteil | Verhalten |
|---|---|
| Methode | `GET`, `POST`, `PUT`, `PATCH` oder `DELETE` |
| URL | Muss mit `https://` beginnen. Variablen werden kodiert eingesetzt |
| Body | JSON. Wird bei `GET` und `DELETE` nicht mitgesendet. Mit Body setzt Tillor `Content-Type: application/json` |
| Header | Frei wählbar. Die Werte dürfen Variablen enthalten. `Host`, `Content-Length`, `Transfer-Encoding` und `Connection` werden ignoriert |
| Ziel | Private und interne Adressen werden abgelehnt, auch wenn ein gewöhnlicher Domainname darauf verweist |
| Weiterleitungen | Werden nicht verfolgt. Eine 3xx-Antwort gilt als fehlgeschlagen |
| Timeout | 15 Sekunden |

<Callout type="warn" title="Keine Signatur">
Anders als bei **Webhook senden** signiert Tillor diese Anfrage nicht. Möchten Sie prüfen, dass eine Anfrage von Ihrer Automatisierung stammt, setzen Sie ein Geheimnis in einen Header und prüfen Sie es auf Ihrer Seite. Header werden verschlüsselt gespeichert, ein Schlüssel oder Token darin ist also sicher.
</Callout>

Eine Antwort mit einem 2xx-Status läuft über **Erfolgreich** weiter, jeder andere Status über **Fehlgeschlagen**. Ist der Server nicht erreichbar oder überschreitet er das Timeout, stoppt die Ausführung mit dem Status **Fehlgeschlagen**.

## API-Anfrage an die Tillor API [#api-verzoek-naar-de-tillor-api]

Mit **Senden an** auf **Tillor API** ruft die Automatisierung die API der eigenen Organisation auf. Sie geben nur einen Pfad an, zum Beispiel `/tasks`, und Tillor setzt diesen hinter `/api/orgs/{orgId}`. Ihre API-Referenz finden Sie unter [OpenAPI](https://tillor.eu/api/openapi.json).

- **Identität**: Die Anfrage wird als Workflow-Benutzer der Organisation ausgeführt. Dieser hat alle Berechtigungen innerhalb dieser Organisation und nirgendwo sonst. Änderungen stehen also auf den Namen **Workflow**
- **Kein Schlüssel nötig**: Tillor führt den Aufruf selbst aus, ohne API-Schlüssel und ohne über das Internet zu gehen
- **Pfad**: Muss mit einem einzelnen `/` beginnen. `//`, `..` und `\` sind nicht erlaubt. Ein Query-String ist erlaubt, zum Beispiel `/tasks?terrainId=…&limit=1`. Variablen im Pfad werden kodiert eingesetzt
- **Blockiert**: Die Pfade `/automations` und `/automation-runs` werden abgelehnt, auch mit Query-String, Großbuchstaben, einem abschließenden `/` oder Prozent-Kodierung. Eine Automatisierung kann keine Automatisierungen verwalten
- **Body**: JSON, für `POST`, `PUT` und `PATCH`. Bei `GET` und `DELETE` wird er nicht mitgesendet
- **Auswahlmenü**: Im Editor steht **API-Endpunkt auswählen** mit den Operationen aus der OpenAPI-Spezifikation. Interne Operationen sind nicht dabei. Wählen Sie eine aus, trägt Tillor Methode, Pfad und einen Beispiel-Body ein
- **Fehlschlagen**: Eine 2xx-Antwort läuft über **Erfolgreich** weiter. Ein Fehlerstatus, auch ein 404 für einen nicht vorhandenen Pfad, läuft über **Fehlgeschlagen**

### Die Antwort in späteren Schritten [#het-antwoord-in-latere-stappen]

Nach der Anfrage stehen diese Variablen zur Verfügung:

| Variable | Inhalt |
|---|---|
| `{response.status}` | Der HTTP-Statuscode |
| `{response.body}` | Die ersten 4000 Zeichen der Antwort als Text |
| `{response.data}` | Die Antwort als JSON. `null`, wenn es kein JSON ist oder länger als 100.000 Zeichen. Listen sprechen Sie mit einem Index an, zum Beispiel `{response.data.items.0.id}` |

Eine zweite API-Anfrage im selben Flow ersetzt `response`. Die Variablen funktionieren wie bei [Variablen und Vorlagen](/automatiseringen/variabelen).

## Der Aufbau eines Flows [#de-opbouw-van-een-flow]

Sie können Automatisierungen auch über die API anlegen und ändern. Die Operationen stehen in [OpenAPI](https://tillor.eu/api/openapi.json) unter dem Tag `automations`. Lesen erfordert die Berechtigung `automations:read`, Anlegen und Ändern `automations:write` (oder alle Berechtigungen). Der Workflow-Benutzer selbst kann sie nie aufrufen. Es kann praktischer sein, einen Flow im Editor zu bauen und ihn als Beispiel zu lesen.

Eine neue Automatisierung ist immer deaktiviert. Das Aktivieren über `enabled` gelingt nicht, solange der Flow offene Probleme hat, und einen aktivierten Flow können Sie nicht mit Problemen speichern.

Die `definition` besteht aus Schritten (`nodes`), Linien (`edges`) und optional Anmerkungen (`notes`). Höchstens 100 Schritte, 200 Linien und 50 Anmerkungen.

```json
{
  "nodes": [
    {
      "id": "trigger",
      "type": "trigger",
      "label": "",
      "position": { "x": 0, "y": 0 },
      "config": { "source": "event", "eventKey": "occupation:ended" }
    },
    {
      "id": "task",
      "type": "taskCreate",
      "label": "",
      "position": { "x": 0, "y": 190 },
      "config": { "title": "Controleer {occupation.terrain.name}", "priority": "HIGH" }
    }
  ],
  "edges": [
    { "id": "trigger:out:task", "source": "trigger", "target": "task", "sourceHandle": "out" }
  ],
  "notes": [
    {
      "id": "note_1",
      "text": "Maakt na elk vertrek een controletaak.",
      "position": { "x": 340, "y": 0 },
      "width": 240,
      "height": 140
    }
  ]
}
```

Eine Anmerkung (`notes`) ist eine Erklärung auf der Arbeitsfläche. Sie wird nie ausgeführt und hat keine Linien. `text` hat höchstens 2000 Zeichen, `width` und `height` sind in Pixeln.

Eine Linie hat einen `sourceHandle`: den Ausgang des Schritts, von dem sie ausgeht.

| Schritt (`type`) | Ausgänge (`sourceHandle`) |
|---|---|
| `trigger`, `delay`, `waitUntilOpen`, `waitUntilClosed`, `taskCreate`, `taskSetStatus`, `taskSetPriority`, `taskUpdate`, `invoiceReminderSend`, `invoiceSend`, `invoicePrint`, `occupationExtendInvoice`, `staffNotify`, `commentCreate`, `inboxReply`, `inboxTag`, `customerUpdate`, `accessMethodCreate`, `accessMethodUpdate`, `accessMethodSendQr`, `accessPointControl`, `meterSwitch`, `nfcTagUpdate`, `deviceCommand`, `deviceDisplay`, `deviceSlideshow`, `controllerRelay`, `controllerCommand` | `out` |
| `customerMessageSend`, `reservationSetStatus`, `invoiceBook`, `paymentLinkCreate`, `mandateRequest`, `mandateCollect`, `consumptionInvoice` | `out`, `skipped` |
| `condition` | `yes`, `no` |
| `switch` | Die `id` jedes Zweigs, plus `default` |
| `openingHours` | `open`, `closed` |
| `throttle` | `pass`, `blocked` |
| `taskFind`, `documentFind`, `recordLookup` | `found`, `notFound` |
| `forEach` | `each`, `done` |
| `waitUntil` | `met`, `timeout` |
| `waitForEvent` | `received`, `timeout` |
| `approval` | `approved`, `rejected`, `timeout` |
| `webhookSend`, `httpRequest` | `success`, `failed` |

Jede Aktion außer `webhookSend` und `httpRequest` erhält einen zusätzlichen Ausgang `error`, sobald `continueOnError` in der `config` auf `true` steht. Ohne diese Einstellung stoppt eine fehlgeschlagene Aktion die Ausführung. Mit dieser Einstellung läuft der Flow über `error` weiter, mit `{error.message}` und `{error.step}` als Variablen für die folgenden Schritte. Der Ausgang `skipped` wird verwendet, wenn ein Schritt nichts zu tun hatte, und `out` ist dann der gewöhnliche Ausgang.

Bei `forEach` startet der Ausgang `each` pro Element eine eigene Ausführung für die folgenden Schritte, und der Ausgang `done` ist der gewöhnliche Fortsetzungsweg des Flows selbst.

Ein Ausgang darf zu mehreren Schritten führen. Die Ausführung läuft selbst mit der ersten Linie weiter und startet für jede weitere Linie eine eigene Ausführung mit denselben Daten, die parallel läuft (wie der Ausgang `each` von `forEach`). Linien, die einen Kreis bilden, werden im Editor abgelehnt. Ein Flow hat genau einen `trigger`.

### Einstellungen pro Schritt [#instellingen-per-stap]

Die Felder unter `config` sind die Felder aus dem Editor. Textfelder akzeptieren Variablen in geschweiften Klammern.

| Schritt | Felder in `config` |
|---|---|
| `trigger` | `source` (`event`, `webhook`, `invoiceOverdue`, `dateReached`, `daily` oder `cron`), `webhookVersion` (bei `webhook`: Text, erhöhen Sie ihn, um die Adresse zu ersetzen), `eventKey`, `date` (bei `dateReached`: ein Pfad `record.veld` zu einer `DateTime`-Spalte eines Modells, das ein Ereignis vollständig mitsendet, wie `reservation.checkIn` oder `contact.birthday`, oder zu einem deklarierten Datumsschlüssel in einer JSON-Spalte, wie `document.userMetadata.insuranceExpiryDate`; alte Namen wie `reservationCheckIn` funktionieren weiter), `dateOffset` (`{ "amount", "unit" }`), `dateDirection` (`before` oder `after`), `dateTime` (`exact`: die Uhrzeit im Datum, oder `fixed`: der Kalendertag des Datums in der Zeitzone der Organisation, um `dateHour` und `dateMinute`, Text wie `"9"` und `"0"`; die Verschiebung zählt auf der Uhr, also über Sommer- und Winterzeit hinweg), `repeatYearly` (boolean: nur Tag und Monat zählen, jedes Jahr), `hour` und `minute` (Text, zum Beispiel `"8"` und `"0"`, Minute 0 bis einschließlich 59), `cron` (fünf Felder; der Wochentag darf `1#2` oder `1L` sein, ein sechstes Feld `W2:2026-10-05` wiederholt alle zwei Wochen), `conditions`, `oncePerRecord` (boolean) |
| `condition` | `conditions` |
| `switch` | `field` (ein Variablenpfad ohne geschweifte Klammern), `cases`: eine Liste von `{ "id", "key", "value" }` mit `key` als Name des Zweigs und `value` als Wert, dem das Feld gleich sein muss. Höchstens 8 Zweige |
| `delay` | `mode` (`duration` oder `untilDate`), `duration` und `offset` als `{ "amount", "unit" }` mit `unit` ist `seconds`, `minutes`, `hours`, `days` oder `weeks`, `dateField` (Variablenpfad), `direction` (`before` oder `after`) |
| `taskCreate` | `title`, `description`, `assigneeIds`, `labelIds`, `assignActor`, `priority` (`LOW`, `MEDIUM`, `HIGH` oder `URGENT`), `viewId`, `laneId`, `subtasks` (eine pro Zeile), `dueIn` (`{ "amount", "unit" }`), `linkRecords` |
| `taskSetStatus` | `taskId`, `status` (`PENDING`, `IN_PROGRESS`, `WAITING` oder `COMPLETED`) |
| `taskFind` | `title` (exakter Titel), `linkedToRecords`, `onlyOpen`, `onlyTopLevel` (booleans) |
| `documentFind` | `customerId` (Template), `documentType` (`INSURANCE_POLICY`, `INSURANCE_PAYMENT_PROOF`, `IDENTITY_CARD`, `SEPA_MANDATE`, `OTHER` oder leer), `onlyActive`, `onlyValid` (booleans). Ergebnis unter `foundDocument` |
| `documentUpdate` | `documentId` (Template), `documentType` (leer behält den Typ), `status` (`ACTIVE`, `ARCHIVED` oder leer) |
| `taskSetPriority` | `taskId`, `mode` (`raise`, `lower` oder `set`), `priority` (bei `set`), `maxPriority` (bei `raise`) |
| `taskUpdate` | `taskId`, `title`, `assigneeIds`, `assignActor`, `assigneeMode` (`add` oder `replace`), `labelIds`, `dueIn` (`{ "amount", "unit" }` mit `unit` ist `minutes`, `hours`, `days` oder `weeks`) |
| `invoiceReminderSend`, `invoiceSend`, `invoiceBook` | `invoiceId` |
| `invoicePrint` | `invoiceId`, `printer` (`a4`, `pos` oder `tablet`) |
| `paymentLinkCreate` | `invoiceId`, `method` (`any`, `BANCONTACT`, `IDEAL`, `CREDITCARD` oder `PAYCONIQ`) |
| `mandateRequest` | `customerId`, `mode` (`request` oder `reminder`) |
| `mandateCollect` | `invoiceId`, `delayDays` (Text, Standard `"0"`, höchstens 7) |
| `consumptionInvoice` | `customerId`, `sendEmail`, `sendSms` |
| `occupationExtendInvoice` | `occupationId`, `includeConsumption` |
| `customerMessageSend` | `customerId`, `subject`, `body`, `sendEmail`, `sendSms`, `sendWhatsApp` |
| `staffNotify` | `userIds`, `notifyActor`, `title`, `body`, `sendPush`, `sendEmail` |
| `commentCreate` | `content`, `target` (`event` oder `task`), `taskId` (bei `task`) |
| `inboxReply` | `threadId`, `body`, `keepAssistant` |
| `inboxTag` | `threadId`, `tagIds`, `archive` |
| `customerUpdate` | `customerId`, `status` (`keep`, `DEFAULT`, `PREFERRED`, `VIP`, `WARNING` oder `BLACKLISTED`), `notes` |
| `reservationSetStatus` | `reservationId`, `action` (`checkIn`, `checkOut` oder `cancel`) |
| `accessMethodCreate` | `customerId`, `type` (`QR_CODE`, `LPR`, `PIN_CODE` oder `NFC`), `value`, `periodFrom`, `periodTo` (Variablen mit einem Datum, leer ist keine Grenze) |
| `accessMethodUpdate` | `scope` (`one` oder `customer`), `accessMethodId` (bei `one`), `customerId` (bei `customer`), `status` (`keep`, `ACTIVE`, `SOFT_BLOCKED`, `BLOCKED` oder `INACTIVE`), `periodTo` |
| `accessMethodSendQr` | `accessMethodId`, `sendEmail`, `sendSms`, `sendWhatsApp`, `print` (`none`, `label` oder `thermal`) |
| `accessPointControl` | `accessPointId`, `action` (`open` oder `close`) |
| `meterSwitch` | `target` (`terrain` oder `meter`), `terrainId` (bei `terrain`), `meterId` (bei `meter`), `state` (`on` oder `off`) |
| `nfcTagUpdate` | `customerId`, `action` (`block`, `unblock`, `topUp` oder `lowBalance`), `amount` (bei `topUp`, in Euro pro Tag) |
| `deviceCommand` | `deviceId`, `command` (`wake`, `sleep`, `reload`, `identify`, `testSound` oder `playSound`), `url` (bei `playSound`: der Pfad eines hochgeladenen Tons, wie der Editor ihn einträgt, oder ein https-Link zu einer mp3-, wav- oder m4a-Datei) |
| `deviceDisplay` | `kind` (`pdf` oder `image`), `url` (https-Link). Erscheint auf jedem Tablet, das als Display eingerichtet ist, etwa ein Rechnungs-PDF |
| `controllerRelay` | `target` (`controller` oder `event`: der Controller des Ereignisses `controller:input:changed`, das den Flow gestartet hat), `controllerId` (bei `controller`), `relay` (Text `"1"` bis `"6"`), `action` (`pulse`, `on` oder `off`), `durationSeconds` (bei `pulse`, Text, 0.001 bis 3600 mit Dezimalen wie `"0.5"`; das Relais fällt von selbst wieder ab) |
| `controllerCommand` | `target` und `controllerId` wie bei `controllerRelay`, `command` (`reboot`, `rebootExtension`, `otaUpdate`, `forceOtaUpdate`, `extensionOtaUpdate` oder `refreshSettings`) |
| `deviceSlideshow` | `scope` (`displays` oder `device`), `mode` (`screensaver` oder `background`), `source` (`feed` oder `urls`). Bei `feed`: `itemsPath`, `imageField`, optional Filter- und Sortierfelder |
| `openingHours`, `waitUntilOpen`, `waitUntilClosed` | Keine Felder |
| `throttle` | `window` (`{ "amount", "unit" }` mit `unit` ist `minutes`, `hours`, `days` oder `weeks`), `key` (leer ist pro Datensatz, der den Flow gestartet hat) |
| `recordLookup` | `model` (`Customer`, `Reservation`, `Occupation`, `Invoice`, `Payment`, `Terrain`, `Task`, `Document`, `AccessMethod`, `NfcTag`, `Meter`, `InboxThread` oder `InboxMessage`), `recordId`. Das Ergebnis steht unter `found` plus dem Modell, wie `foundCustomer` |
| `forEach` | `source` (`customerAccessMethods`, `customerNfcTags`, `customerOpenInvoices`, `customerUpcomingReservations`, `customerOccupations`, `customerDocuments` (nur `ACTIVE`) oder `terrainMeters`), `parentId` (ID des Kunden oder des Geländes). Höchstens 100 Elemente, das Element steht unter `item` |
| `waitUntil` | `conditions`, `interval` und `timeout` (`{ "amount", "unit" }` mit `unit` ist `minutes`, `hours`, `days` oder `weeks`; das Intervall beträgt mindestens 5 Minuten) |
| `waitForEvent` | `eventKey`, `sameRecord` (boolean), `timeout` (`{ "amount", "unit" }`) |
| `approval` | `title`, `description`, `assigneeIds`, `timeout` (`{ "amount", "unit" }`). Die Aufgabe steht unter `approvalTask.id` |
| Jede Aktion außer `webhookSend` und `httpRequest` | `continueOnError` (boolean) |
| `webhookSend` | `webhookId`, `event`, `payload` (JSON als Text) |
| `httpRequest` | `target` (`tillor` oder `custom`), `method`, `path` (bei `tillor`), `url` (bei `custom`), `headers` (Liste von `{ "id", "key", "value" }`), `body` (JSON als Text) |

`conditions` hat die Form `{ "match": "all" oder "any", "rules": [...] }`. Jede Regel ist `{ "id", "field", "operator", "value", "values" }`. `operator` ist `is`, `isNot`, `contains`, `greaterThan`, `lessThan`, `isOneOf`, `isEmpty` oder `isNotEmpty`. `values` verwenden Sie nur bei `isOneOf`. Eine leere Liste von Regeln lässt alles durch.

## Eine Automatisierung mit einem Webhook starten [#een-automatisering-starten-met-een-webhook]

Eine Automatisierung mit dem Trigger `webhook` startet bei einem `POST` an ihre eigene Adresse:

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/automation-hooks/aut_xxx/<token>?bron=website" \
  -H "Content-Type: application/json" \
  -d '{"email":"jan@voorbeeld.nl","aankomst":"2026-07-14"}'
```

- Die vollständige Adresse steht im Editor beim Trigger, oder über `GET /automations/{id}/webhook-url` (mit `automations:read`). Das Token ist das Geheimnis; ein Header zur Authentifizierung ist nicht nötig
- Der JSON-Body wird zur Variable `body`, der Query-String zu `query` und der Zeitpunkt zu `receivedAt`
- Antwort `200` mit `{ "accepted": true }`, sobald die Ausführung gestartet ist. Eine falsche, ersetzte oder deaktivierte Adresse ergibt `404`, ein Body über 100 KB ergibt `400`
- Viele Aufrufe kurz hintereinander werden nicht abgelehnt: Jeder gültige Aufruf startet eine Ausführung. Verwenden Sie **Wiederholungen ignorieren** beim Trigger, wenn derselbe Aufruf zweimal eintreffen kann, siehe [Wiederholungen ignorieren](/automatiseringen/triggers#herhalingen-negeren)

Eine Automatisierung kann ihren eigenen Webhook nicht über eine **API-Anfrage** an die Tillor API aufrufen.

## Eine Entscheidung über die API treffen [#een-beslissing-kiezen-via-de-api]

Die Aufgabe eines Schritts **Um eine Entscheidung bitten** hat eine Aktion pro Option, die Sie im Schritt eingestellt haben. Rufen Sie die Aufgabe ab, um die `actions` mit ihrer `id` zu sehen, und wählen Sie eine mit `POST /tasks/{id}/actions/{actionId}/choose`. Verlangt die Option eine Notiz, senden Sie diese als `{ "note": "..." }` mit. Die Wahl ist endgültig: Sie schließt die Aufgabe ab und setzt die Automatisierung über den Ausgang dieser Option fort. Zugewiesene Kollegen (auch über eine Gruppe) und Administratoren dürfen wählen. Details finden Sie in der [OpenAPI](https://tillor.eu/api/openapi.json).

## Weiterlesen [#meer-lezen]

- [Webhooks](/ontwikkelaars/webhooks) für Signatur, Retries und die Liste der Events
- [HTTP API](/ontwikkelaars/http) für Authentifizierung und den Organisationskontext
- [Variablen und Vorlagen](/automatiseringen/variabelen) für die Anleitung für Anwender


# Event-index (/de-DE/ontwikkelaars/events)

{/* Gegenereerd door bun run --cwd apps/next generate:registry uit de realtime.ts-bestanden. Niet met de hand aanpassen. */}

Deze pagina wordt automatisch opgebouwd uit de code: elk event dat Tillor via [SSE](/ontwikkelaars/sse) of [webhooks](/ontwikkelaars/webhooks) verstuurt, staat hier. In de payload hieronder zie je alleen `event` en `data`; `timestamp`, `traceId` en de andere velden van de [envelop](/ontwikkelaars/webhooks#webhook-payload) komen er altijd bij.

De voorbeeldwaarden zijn verzonnen. De velden en hun types komen rechtstreeks uit het datamodel; een event kan extra relaties meesturen die hier niet staan.

Je ontvangt een event alleen als je organisatielid één van de genoemde permissies heeft. Events met "geen webhook" komen te vaak voor om als webhook te versturen; je kunt ze alleen via SSE volgen.

## Overzicht [#overzicht]

| Event | Beschrijving | Permissie | Levering |
|-------|--------------|-----------|----------|
| `*` | Alle events | volledige toegang (`*`) | SSE + webhook |
| [`accessLogEntry:coupled`](#accesslogentry-coupled) | Toegangslogregel gekoppeld | `access-control:read` | SSE + webhook |
| [`accessLogEntry:processed`](#accesslogentry-processed) | Toegangslogregel verwerkt | `access-control:read` | SSE + webhook |
| [`accessMethod:created`](#accessmethod-created) | Toegangsmethode aangemaakt | `access-control:read` | SSE + webhook |
| [`accessMethod:deleted`](#accessmethod-deleted) | Toegangsmethode verwijderd | `access-control:read` | SSE + webhook |
| [`accessMethod:updated`](#accessmethod-updated) | Toegangsmethode gewijzigd | `access-control:read` | SSE + webhook |
| [`accessMethodOperation:created`](#accessmethodoperation-created) | Bewerking op toegangsmethode gestart | `access-control:read` | SSE + webhook |
| [`accessMethodOperation:updated`](#accessmethodoperation-updated) | Bewerking op toegangsmethode gewijzigd | `access-control:read` | SSE + webhook |
| [`accessPoint:created`](#accesspoint-created) | Toegangspunt aangemaakt | `access-control:read` | SSE + webhook |
| [`accessPoint:deleted`](#accesspoint-deleted) | Toegangspunt verwijderd | `access-control:read` | SSE + webhook |
| [`accessPoint:openTooLong`](#accesspoint-opentoolong) | Toegangspunt te lang open | `access-control:access-point-open:alert` | SSE + webhook |
| [`accessPoint:physicalStateChanged`](#accesspoint-physicalstatechanged) |  | `access-control:read` | SSE, geen webhook |
| [`accessPoint:updated`](#accesspoint-updated) | Toegangspunt gewijzigd | `access-control:read` | SSE + webhook |
| [`bankAccountTransaction:imported`](#bankaccounttransaction-imported) | Banktransactie geïmporteerd | `bank-transactions:read` of `bank-transactions:sync` | SSE + webhook |
| [`call:created`](#call-created) | Telefoongesprek gestart | `calls:read` | SSE + webhook |
| [`call:updated`](#call-updated) | Telefoongesprek gewijzigd | `calls:read` | SSE + webhook |
| [`comment:created`](#comment-created) | Opmerking toegevoegd | `comments:read` | SSE + webhook |
| [`comment:deleted`](#comment-deleted) | Opmerking verwijderd | `comments:read` | SSE + webhook |
| [`comment:mentioned`](#comment-mentioned) | Iemand genoemd in een opmerking | `comments:read` | SSE + webhook |
| [`comment:pinned`](#comment-pinned) | Opmerking vastgezet | `comments:read` | SSE + webhook |
| [`comment:resolved`](#comment-resolved) | Opmerking opgelost | `comments:read` | SSE + webhook |
| [`comment:unresolved`](#comment-unresolved) | Opmerking heropend | `comments:read` | SSE + webhook |
| [`comment:updated`](#comment-updated) | Opmerking bewerkt | `comments:read` | SSE + webhook |
| [`controller:adoption:approved`](#controller-adoption-approved) | Adoptie van besturingseenheid goedgekeurd | `controllers:read` | SSE + webhook |
| [`controller:adoption:rejected`](#controller-adoption-rejected) | Adoptie van besturingseenheid afgewezen | `controllers:read` | SSE + webhook |
| [`controller:adoption:requested`](#controller-adoption-requested) | Besturingseenheid vraagt om adoptie | `controllers:read` | SSE + webhook |
| [`controller:created`](#controller-created) | Besturingseenheid aangemaakt | `controllers:read` | SSE + webhook |
| [`controller:deleted`](#controller-deleted) | Besturingseenheid verwijderd | `controllers:read` | SSE + webhook |
| [`controller:input:changed`](#controller-input-changed) | Ingang van controller veranderd | `controllers:read` | SSE + webhook |
| [`controller:io:changed`](#controller-io-changed) |  | `controllers:read` | SSE (`?channel=controller-io`), geen webhook |
| [`controller:logs:submitted`](#controller-logs-submitted) |  | `controllers:logs` | SSE (`?channel=controller-logs`), geen webhook |
| [`controller:updated`](#controller-updated) | Besturingseenheid gewijzigd | `controllers:read` | SSE + webhook |
| [`customEnum:created`](#customenum-created) |  | elk lid | SSE, geen webhook |
| [`customEnum:deleted`](#customenum-deleted) |  | elk lid | SSE, geen webhook |
| [`customEnum:updated`](#customenum-updated) |  | elk lid | SSE, geen webhook |
| [`customer:contact:created`](#customer-contact-created) | Contactpersoon toegevoegd aan een klant | `customers:read` | SSE + webhook |
| [`customer:contact:deleted`](#customer-contact-deleted) | Contactpersoon verwijderd bij een klant | `customers:read` | SSE + webhook |
| [`customer:contact:updated`](#customer-contact-updated) | Contactpersoon van klant gewijzigd | `customers:read` | SSE + webhook |
| [`customer:created`](#customer-created) | Klant aangemaakt | `customers:read` | SSE + webhook |
| [`customer:deleted`](#customer-deleted) | Klant verwijderd | `customers:read` | SSE + webhook |
| [`customer:updated`](#customer-updated) | Klant gewijzigd | `customers:read` | SSE + webhook |
| [`customFieldDefinition:created`](#customfielddefinition-created) |  | elk lid | SSE, geen webhook |
| [`customFieldDefinition:deleted`](#customfielddefinition-deleted) |  | elk lid | SSE, geen webhook |
| [`customFieldDefinition:updated`](#customfielddefinition-updated) |  | elk lid | SSE, geen webhook |
| [`document:created`](#document-created) | Document ontvangen | `documents:read` | SSE + webhook |
| [`document:deleted`](#document-deleted) | Document verwijderd | `documents:read` | SSE + webhook |
| [`document:updated`](#document-updated) | Document gewijzigd | `documents:read` | SSE + webhook |
| [`event-log:created`](#event-log-created) | Gebeurtenis gelogd | `audit-logs:read` | SSE + webhook |
| [`identityDocumentScan:completed`](#identitydocumentscan-completed) | ID-scan voltooid | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:deleted`](#identitydocumentscan-deleted) | ID-scan verwijderd | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:linked`](#identitydocumentscan-linked) | ID-scan gekoppeld aan een klant | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:pendingQueueChanged`](#identitydocumentscan-pendingqueuechanged) | Wachtrij voor ID-scans gewijzigd | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:unlinked`](#identitydocumentscan-unlinked) | ID-scan ontkoppeld | `identity-document-scans:read` | SSE + webhook |
| [`img:clear-tablet`](#img-clear-tablet) | Afbeelding gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`img:to-tablet`](#img-to-tablet) | Afbeelding naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`inbox:message-created`](#inbox-message-created) | Bericht ontvangen in de inbox | `inbox:read` | SSE + webhook |
| [`inbox:participant-reaction`](#inbox-participant-reaction) | Reactie op een inboxbericht | `inbox:read` | SSE + webhook |
| [`inbox:thread-updated`](#inbox-thread-updated) | Inboxgesprek gewijzigd | `inbox:read` | SSE + webhook |
| [`inbox:typing-changed`](#inbox-typing-changed) |  | `inbox:read` | SSE, geen webhook |
| [`inbox:urgent-handoff`](#inbox-urgent-handoff) | Dringende overdracht door de assistent | `inbox:read` | SSE + webhook |
| [`integration-alarm:created`](#integration-alarm-created) | Meteralarm afgegaan | `meters:read` | SSE + webhook |
| [`integration-alarm:resolved`](#integration-alarm-resolved) | Meteralarm opgelost | `meters:read` | SSE + webhook |
| [`invoice:created`](#invoice-created) | Factuur aangemaakt | `invoices:read` | SSE + webhook |
| [`invoice:deleted`](#invoice-deleted) | Factuur verwijderd | `invoices:read` | SSE + webhook |
| [`invoice:moved-to-customer`](#invoice-moved-to-customer) | Factuur naar een andere klant verplaatst | `invoices:read` | SSE + webhook |
| [`invoice:paid`](#invoice-paid) | Factuur betaald | `invoices:read` | SSE + webhook |
| [`invoice:updated`](#invoice-updated) | Factuur gewijzigd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:created`](#ledgeropeningbalance-created) | Beginsaldo toegevoegd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:deleted`](#ledgeropeningbalance-deleted) | Beginsaldo verwijderd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:updated`](#ledgeropeningbalance-updated) | Beginsaldo gewijzigd | `invoices:read` | SSE + webhook |
| [`mandate-agreement:activated`](#mandate-agreement-activated) | Mandaat actief | `payments:read` | SSE + webhook |
| [`mandate-agreement:expired`](#mandate-agreement-expired) | Mandaataanvraag verlopen | `payments:read` | SSE + webhook |
| [`mandate-agreement:failed`](#mandate-agreement-failed) | Mandaat geweigerd | `payments:read` | SSE + webhook |
| [`mandate-agreement:signed`](#mandate-agreement-signed) | Mandaat ondertekend | `payments:read` | SSE + webhook |
| [`mandate-agreement:updated`](#mandate-agreement-updated) | Mandaataanvraag gewijzigd | `payments:read` | SSE + webhook |
| [`mandate:created`](#mandate-created) | Mandaat aangemaakt | `payments:read` | SSE + webhook |
| [`mandate:deleted`](#mandate-deleted) | Mandaat verwijderd | `payments:read` | SSE + webhook |
| [`mandate:updated`](#mandate-updated) | Mandaat gewijzigd | `payments:read` | SSE + webhook |
| [`meter:created`](#meter-created) | Meter aangemaakt | `meters:read` | SSE + webhook |
| [`meter:updated`](#meter-updated) | Meter gewijzigd | `meters:read` | SSE + webhook |
| [`meterAnomaly:detected`](#meteranomaly-detected) | Meterafwijking vastgesteld | `meters:read` | SSE + webhook |
| [`meterAnomaly:resolved`](#meteranomaly-resolved) | Meterafwijking opgelost | `meters:read` | SSE + webhook |
| [`meterConsumptionBatch:created`](#meterconsumptionbatch-created) | Verbruiksperiode gestart | `meters:read` | SSE + webhook |
| [`meterConsumptionBatch:updated`](#meterconsumptionbatch-updated) | Verbruiksperiode gewijzigd | `meters:read` | SSE + webhook |
| [`meterReading:created`](#meterreading-created) | Meterstand ingevoerd | `meters:read` | SSE + webhook |
| [`meterReading:deleted`](#meterreading-deleted) | Meterstand verwijderd | `meters:read` | SSE + webhook |
| [`meterReading:synced`](#meterreading-synced) | Meterstand gesynchroniseerd | `meters:read` | SSE + webhook |
| [`meterReading:updated`](#meterreading-updated) | Meterstand gewijzigd | `meters:read` | SSE + webhook |
| [`nativeDevice:command`](#nativedevice-command) |  | `native-devices:read` | SSE, geen webhook |
| [`nativeDevice:config`](#nativedevice-config) |  | `native-devices:read` | SSE, geen webhook |
| [`nativeDevice:deleted`](#nativedevice-deleted) | Tablet of kiosk verwijderd | `native-devices:read` | SSE + webhook |
| [`nfc-tag-transaction:changed`](#nfc-tag-transaction-changed) | NFC-tagtransactie gewijzigd | `nfc-tag-transactions:read` | SSE + webhook |
| [`nfc-tag:blocked`](#nfc-tag-blocked) | NFC-tag geblokkeerd | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:presented`](#nfc-tag-presented) | NFC-tag aangeboden | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:unblocked`](#nfc-tag-unblocked) | NFC-tag gedeblokkeerd | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:updated`](#nfc-tag-updated) | NFC-tag gewijzigd | `nfc-tags:read` | SSE + webhook |
| [`notification-delivery:deleted`](#notification-delivery-deleted) | Melding verwijderd | `notifications:deliveries:read` | SSE + webhook |
| [`notification-delivery:updated`](#notification-delivery-updated) | Status van melding gewijzigd | `notifications:deliveries:read` | SSE + webhook |
| [`notificationInbox:created`](#notificationinbox-created) |  | elk lid | SSE, geen webhook |
| [`notificationInbox:read`](#notificationinbox-read) |  | elk lid | SSE, geen webhook |
| [`occupation:ended`](#occupation-ended) | Bezetting beëindigd | `terrains:read` | SSE + webhook |
| [`organizationSettings:updated`](#organizationsettings-updated) | Instellingen gewijzigd | `organization:settings:read` of `organization:settings:write` | SSE + webhook |
| [`payment-group:assigned-to-invoice`](#payment-group-assigned-to-invoice) | Betalingsgroep gekoppeld aan een factuur | `payments:read` | SSE + webhook |
| [`payment-group:created`](#payment-group-created) | Betalingsgroep aangemaakt | `payments:read` | SSE + webhook |
| [`payment-group:deleted`](#payment-group-deleted) | Betalingsgroep verwijderd | `payments:read` | SSE + webhook |
| [`payment-group:payments-added`](#payment-group-payments-added) | Betalingen toegevoegd aan een groep | `payments:read` | SSE + webhook |
| [`payment-group:payments-removed`](#payment-group-payments-removed) | Betalingen verwijderd uit een groep | `payments:read` | SSE + webhook |
| [`payment-group:unassigned-from-invoice`](#payment-group-unassigned-from-invoice) | Betalingsgroep ontkoppeld van een factuur | `payments:read` | SSE + webhook |
| [`payment-group:updated`](#payment-group-updated) | Betalingsgroep gewijzigd | `payments:read` | SSE + webhook |
| [`payment-report:created`](#payment-report-created) | Betalingsrapport aangemaakt | `payment-reports:read` | SSE + webhook |
| [`payment-report:updated`](#payment-report-updated) | Betalingsrapport gewijzigd | `payment-reports:read` | SSE + webhook |
| [`payment:created`](#payment-created) | Betaling aangemaakt | `payments:read` | SSE + webhook |
| [`payment:deleted`](#payment-deleted) | Betaling verwijderd | `payments:read` | SSE + webhook |
| [`payment:updated`](#payment-updated) | Betaling gewijzigd | `payments:read` | SSE + webhook |
| [`pdf:clear-tablet`](#pdf-clear-tablet) | Pdf gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`pdf:to-tablet`](#pdf-to-tablet) | Pdf naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`print-queue-job:updated`](#print-queue-job-updated) | Printopdracht gewijzigd | `printing:read` | SSE + webhook |
| [`product:created`](#product-created) | Product aangemaakt | `products:read` | SSE + webhook |
| [`product:deleted`](#product-deleted) | Product verwijderd | `products:read` | SSE + webhook |
| [`product:updated`](#product-updated) | Product gewijzigd | `products:read` | SSE + webhook |
| [`productPriceChange:applied`](#productpricechange-applied) | Geplande productprijs toegepast | `products:read` | SSE + webhook |
| [`productPriceChange:created`](#productpricechange-created) | Productprijs gepland | `products:read` | SSE + webhook |
| [`productPriceChange:deleted`](#productpricechange-deleted) | Geplande productprijs verwijderd | `products:read` | SSE + webhook |
| [`reservation:created`](#reservation-created) | Reservering aangemaakt | `reservations:read` | SSE + webhook |
| [`reservation:updated`](#reservation-updated) | Reservering gewijzigd | `reservations:read` | SSE + webhook |
| [`sign:clear-tablet`](#sign-clear-tablet) | Ondertekening gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`sign:to-tablet`](#sign-to-tablet) | Ondertekening naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`signatureRequest:completed`](#signaturerequest-completed) | Ondertekenverzoek afgerond | `signature-requests:read` | SSE + webhook |
| [`signatureRequest:deleted`](#signaturerequest-deleted) | Ondertekenverzoek verwijderd | `signature-requests:read` | SSE + webhook |
| [`signatureRequest:updated`](#signaturerequest-updated) | Ondertekenverzoek gewijzigd | `signature-requests:read` | SSE + webhook |
| [`task-time-tracker:changed`](#task-time-tracker-changed) |  | `tasks:read` | SSE, geen webhook |
| [`task-view:created`](#task-view-created) | Takenweergave aangemaakt | `tasks:read` | SSE + webhook |
| [`task-view:deleted`](#task-view-deleted) | Takenweergave verwijderd | `tasks:read` | SSE + webhook |
| [`task-view:membership-changed`](#task-view-membership-changed) | Taken in een weergave gewijzigd | `tasks:read` | SSE + webhook |
| [`task-view:updated`](#task-view-updated) | Takenweergave gewijzigd | `tasks:read` | SSE + webhook |
| [`task:action-chosen`](#task-action-chosen) | Taakactie gekozen | `tasks:read` | SSE + webhook |
| [`task:assigned`](#task-assigned) | Taak toegewezen | `tasks:read` | SSE + webhook |
| [`task:created`](#task-created) | Taak aangemaakt | `tasks:read` | SSE + webhook |
| [`task:deleted`](#task-deleted) | Taak verwijderd | `tasks:read` | SSE + webhook |
| [`task:status-changed`](#task-status-changed) | Taakstatus gewijzigd | `tasks:read` | SSE + webhook |
| [`task:unassigned`](#task-unassigned) | Taaktoewijzing opgeheven | `tasks:read` | SSE + webhook |
| [`task:updated`](#task-updated) | Taak gewijzigd | `tasks:read` | SSE + webhook |
| [`terrain:updated`](#terrain-updated) | Terrein gewijzigd | `terrains:read` | SSE + webhook |
| [`vehiclePresence:updated`](#vehiclepresence-updated) |  | `access-control:read` | SSE, geen webhook |

## accessLogEntry [#accesslogentry]

### `accessLogEntry:coupled` [#accesslogentry-coupled]

Toegangslogregel gekoppeld.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessLogEntry:coupled",
  "data": {
    "nfcQrEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lprEntryId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `accessLogEntry:processed` [#accesslogentry-processed]

Toegangslogregel verwerkt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessLogEntry:processed",
  "data": {
    "organizationId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## accessMethod [#accessmethod]

### `accessMethod:created` [#accessmethod-created]

Toegangsmethode aangemaakt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessMethod:deleted` [#accessmethod-deleted]

Toegangsmethode verwijderd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessMethod:updated` [#accessmethod-updated]

Toegangsmethode gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## accessMethodOperation [#accessmethodoperation]

### `accessMethodOperation:created` [#accessmethodoperation-created]

Bewerking op toegangsmethode gestart.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `accessMethodOperation:updated` [#accessmethodoperation-updated]

Bewerking op toegangsmethode gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethodOperation:updated",
  "data": {
    "operationId": "cm4k7x2pq0001abcd1234efgh",
    "status": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

## accessPoint [#accesspoint]

### `accessPoint:created` [#accesspoint-created]

Toegangspunt aangemaakt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:deleted` [#accesspoint-deleted]

Toegangspunt verwijderd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:openTooLong` [#accesspoint-opentoolong]

Toegangspunt te lang open.

- **Permissie:** `access-control:access-point-open:alert`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:openTooLong",
  "data": {
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "accessPointName": "Voorbeeld",
    "openSince": "2026-01-15T09:30:00.000Z",
    "afterMinutes": 12.5
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:physicalStateChanged` [#accesspoint-physicalstatechanged]

- **Permissie:** `access-control:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:physicalStateChanged",
  "data": {
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "state": "OPEN",
    "previousState": "OPEN",
    "changedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:updated` [#accesspoint-updated]

Toegangspunt gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## bankAccountTransaction [#bankaccounttransaction]

### `bankAccountTransaction:imported` [#bankaccounttransaction-imported]

Banktransactie geïmporteerd.

- **Permissie:** `bank-transactions:read` of `bank-transactions:sync`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "bankAccountTransaction:imported",
  "data": {
    "transactionsProcessed": 12.5,
    "accountsProcessed": 12.5
  }
}
```

</Accordion>
</Accordions>

## call [#call]

### `call:created` [#call-created]

Telefoongesprek gestart.

- **Permissie:** `calls:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "call:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "to": "Voorbeeld",
    "from": "Voorbeeld",
    "state": "CREATED",
    "direction": "INBOUND",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "duration": 1,
    "recordingS3Path": "Voorbeeld",
    "recordingStatus": "PENDING",
    "maybeCallerName": "Voorbeeld",
    "currentTranscriptionId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `call:updated` [#call-updated]

Telefoongesprek gewijzigd.

- **Permissie:** `calls:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "call:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "to": "Voorbeeld",
    "from": "Voorbeeld",
    "state": "CREATED",
    "direction": "INBOUND",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "duration": 1,
    "recordingS3Path": "Voorbeeld",
    "recordingStatus": "PENDING",
    "maybeCallerName": "Voorbeeld",
    "currentTranscriptionId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## comment [#comment]

### `comment:created` [#comment-created]

Opmerking toegevoegd.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:deleted` [#comment-deleted]

Opmerking verwijderd.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:mentioned` [#comment-mentioned]

Iemand genoemd in een opmerking.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:mentioned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:pinned` [#comment-pinned]

Opmerking vastgezet.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:pinned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:resolved` [#comment-resolved]

Opmerking opgelost.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:resolved",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:unresolved` [#comment-unresolved]

Opmerking heropend.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:unresolved",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:updated` [#comment-updated]

Opmerking bewerkt.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## controller [#controller]

### `controller:adoption:approved` [#controller-adoption-approved]

Adoptie van besturingseenheid goedgekeurd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:approved",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "controllerId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "organizationId": "cm4k7x2pq0001abcd1234efgh",
    "takeover": false
  }
}
```

</Accordion>
</Accordions>

### `controller:adoption:rejected` [#controller-adoption-rejected]

Adoptie van besturingseenheid afgewezen.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:rejected",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:adoption:requested` [#controller-adoption-requested]

Besturingseenheid vraagt om adoptie.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:requested",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "requestedFromIp": "Voorbeeld",
    "isNew": false
  }
}
```

</Accordion>
</Accordions>

### `controller:created` [#controller-created]

Besturingseenheid aangemaakt.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "publicKeyPem": "Voorbeeld",
    "model": "Voorbeeld",
    "type": "ACCESS",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "lastSeenAt": "2026-01-15T09:30:00.000Z",
    "lastSyncAt": "2026-01-15T09:30:00.000Z",
    "version": "Voorbeeld",
    "metadata": {},
    "commandManifest": {},
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:deleted` [#controller-deleted]

Besturingseenheid verwijderd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:input:changed` [#controller-input-changed]

Ingang van controller veranderd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:input:changed",
  "data": {
    "controller": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "efuseId": "cm4k7x2pq0001abcd1234efgh",
      "publicKeyPem": "Voorbeeld",
      "model": "Voorbeeld",
      "type": "ACCESS",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "lastSeenAt": "2026-01-15T09:30:00.000Z",
      "lastSyncAt": "2026-01-15T09:30:00.000Z",
      "version": "Voorbeeld",
      "metadata": {},
      "commandManifest": {},
      "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
      "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
    },
    "input": 12.5,
    "active": false
  }
}
```

</Accordion>
</Accordions>

### `controller:io:changed` [#controller-io-changed]

- **Permissie:** `controllers:read`
- **Levering:** SSE (`?channel=controller-io`), geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:io:changed",
  "data": {
    "controllerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:logs:submitted` [#controller-logs-submitted]

- **Permissie:** `controllers:logs`
- **Levering:** SSE (`?channel=controller-logs`), geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:logs:submitted",
  "data": {
    "controllerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:updated` [#controller-updated]

Besturingseenheid gewijzigd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "publicKeyPem": "Voorbeeld",
    "model": "Voorbeeld",
    "type": "ACCESS",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "lastSeenAt": "2026-01-15T09:30:00.000Z",
    "lastSyncAt": "2026-01-15T09:30:00.000Z",
    "version": "Voorbeeld",
    "metadata": {},
    "commandManifest": {},
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## customEnum [#customenum]

### `customEnum:created` [#customenum-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customEnum:deleted` [#customenum-deleted]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customEnum:updated` [#customenum-updated]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## customer [#customer]

### `customer:contact:created` [#customer-contact-created]

Contactpersoon toegevoegd aan een klant.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:contact:deleted` [#customer-contact-deleted]

Contactpersoon verwijderd bij een klant.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:contact:updated` [#customer-contact-updated]

Contactpersoon van klant gewijzigd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:created` [#customer-created]

Klant aangemaakt.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

### `customer:deleted` [#customer-deleted]

Klant verwijderd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

### `customer:updated` [#customer-updated]

Klant gewijzigd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

## customFieldDefinition [#customfielddefinition]

### `customFieldDefinition:created` [#customfielddefinition-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customFieldDefinition:deleted` [#customfielddefinition-deleted]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customFieldDefinition:updated` [#customfielddefinition-updated]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## document [#document]

### `document:created` [#document-created]

Document ontvangen.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

### `document:deleted` [#document-deleted]

Document verwijderd.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

### `document:updated` [#document-updated]

Document gewijzigd.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

## event-log [#event-log]

### `event-log:created` [#event-log-created]

Gebeurtenis gelogd.

- **Permissie:** `audit-logs:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "event-log:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "type": "INVOICE_CREATED",
    "metadata": {},
    "translationKey": "Voorbeeld",
    "translationData": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredById": "cm4k7x2pq0001abcd1234efgh",
    "userId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "occupationId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "meterReadingId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "organizationSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "organizationMembershipId": "cm4k7x2pq0001abcd1234efgh",
    "nativeDeviceId": "cm4k7x2pq0001abcd1234efgh",
    "oauthClientId": "cm4k7x2pq0001abcd1234efgh",
    "oauthConsentId": "cm4k7x2pq0001abcd1234efgh",
    "accessMethodId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "customerInvoicingSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "nfcTagId": "cm4k7x2pq0001abcd1234efgh",
    "identityDocumentScanId": "cm4k7x2pq0001abcd1234efgh",
    "documentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "signatureRequestId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerId": "cm4k7x2pq0001abcd1234efgh",
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "accessControllerId": "cm4k7x2pq0001abcd1234efgh",
    "organizationId": "cm4k7x2pq0001abcd1234efgh",
    "organizationInvitationId": "cm4k7x2pq0001abcd1234efgh",
    "apiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "integrationInstallationId": "cm4k7x2pq0001abcd1234efgh",
    "dpaAcceptanceId": "cm4k7x2pq0001abcd1234efgh",
    "webhookId": "cm4k7x2pq0001abcd1234efgh",
    "automationId": "cm4k7x2pq0001abcd1234efgh",
    "staffGroupId": "cm4k7x2pq0001abcd1234efgh",
    "terrainTypeId": "cm4k7x2pq0001abcd1234efgh",
    "meterCabinetId": "cm4k7x2pq0001abcd1234efgh",
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "customFieldDefinitionId": "cm4k7x2pq0001abcd1234efgh",
    "customEnumId": "cm4k7x2pq0001abcd1234efgh",
    "customerCommunicationSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "taskLabelId": "cm4k7x2pq0001abcd1234efgh",
    "inboxTagId": "cm4k7x2pq0001abcd1234efgh",
    "taskViewId": "cm4k7x2pq0001abcd1234efgh",
    "customerLedgerOpeningBalanceId": "cm4k7x2pq0001abcd1234efgh",
    "auditLogId": "cm4k7x2pq0001abcd1234efgh",
    "actorKind": "USER",
    "actorApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "actorOauthClientId": "cm4k7x2pq0001abcd1234efgh",
    "actorImpersonatedById": "cm4k7x2pq0001abcd1234efgh",
    "originKind": "Voorbeeld",
    "originId": "cm4k7x2pq0001abcd1234efgh",
    "ipAddress": "Voorbeeld",
    "userAgent": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## identityDocumentScan [#identitydocumentscan]

### `identityDocumentScan:completed` [#identitydocumentscan-completed]

ID-scan voltooid.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `identityDocumentScan:deleted` [#identitydocumentscan-deleted]

ID-scan verwijderd.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:deleted",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `identityDocumentScan:linked` [#identitydocumentscan-linked]

ID-scan gekoppeld aan een klant.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:linked",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `identityDocumentScan:pendingQueueChanged` [#identitydocumentscan-pendingqueuechanged]

Wachtrij voor ID-scans gewijzigd.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `identityDocumentScan:unlinked` [#identitydocumentscan-unlinked]

ID-scan ontkoppeld.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:unlinked",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## img [#img]

### `img:clear-tablet` [#img-clear-tablet]

Afbeelding gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `img:to-tablet` [#img-to-tablet]

Afbeelding naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "img:to-tablet",
  "data": {
    "imageUrl": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

## inbox [#inbox]

### `inbox:message-created` [#inbox-message-created]

Bericht ontvangen in de inbox.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:message-created",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "messageId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `inbox:participant-reaction` [#inbox-participant-reaction]

Reactie op een inboxbericht.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:participant-reaction",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "emoji": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `inbox:thread-updated` [#inbox-thread-updated]

Inboxgesprek gewijzigd.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:thread-updated",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `inbox:typing-changed` [#inbox-typing-changed]

- **Permissie:** `inbox:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:typing-changed",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "participantTyping": false,
    "staffTyping": false
  }
}
```

</Accordion>
</Accordions>

### `inbox:urgent-handoff` [#inbox-urgent-handoff]

Dringende overdracht door de assistent.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:urgent-handoff",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## integration-alarm [#integration-alarm]

### `integration-alarm:created` [#integration-alarm-created]

Meteralarm afgegaan.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "integration-alarm:created",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "alarm": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "externalId": "cm4k7x2pq0001abcd1234efgh",
      "message": "Voorbeeld",
      "startedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "metadata": {},
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "icyControllerId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `integration-alarm:resolved` [#integration-alarm-resolved]

Meteralarm opgelost.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "integration-alarm:resolved",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "alarm": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "externalId": "cm4k7x2pq0001abcd1234efgh",
      "message": "Voorbeeld",
      "startedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "metadata": {},
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "icyControllerId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

## invoice [#invoice]

### `invoice:created` [#invoice-created]

Factuur aangemaakt.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `invoice:deleted` [#invoice-deleted]

Factuur verwijderd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `invoice:moved-to-customer` [#invoice-moved-to-customer]

Factuur naar een andere klant verplaatst.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:moved-to-customer",
  "data": {
    "invoice": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "displayId": "2026-00123",
      "status": "DRAFT",
      "type": "INVOICE",
      "paymentStatus": "UNPAID",
      "invoiceDate": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "paidDate": "2026-01-15T09:30:00.000Z",
      "amountSubtotal": 12.5,
      "amountTax": 12.5,
      "amountPaid": 12.5,
      "amountTotal": 12.5,
      "amountOutstanding": 12.5,
      "note": "Voorbeeld",
      "internalNote": "Voorbeeld",
      "currency": "EUR",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "structuredCommunication": "Voorbeeld",
      "originalDisplayId": "2026-00123",
      "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
      "bookedById": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
      "excludeFromAutomatedReminders": false,
      "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
      "peppolProvider": "SCRADA",
      "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
      "peppolUblFolder": "Voorbeeld",
      "peppolUblKey": "Voorbeeld"
    },
    "priorCustomerId": "cm4k7x2pq0001abcd1234efgh",
    "targetCustomerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `invoice:paid` [#invoice-paid]

Factuur betaald.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "displayId": "2026-00123",
      "status": "DRAFT",
      "type": "INVOICE",
      "paymentStatus": "UNPAID",
      "invoiceDate": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "paidDate": "2026-01-15T09:30:00.000Z",
      "amountSubtotal": 12.5,
      "amountTax": 12.5,
      "amountPaid": 12.5,
      "amountTotal": 12.5,
      "amountOutstanding": 12.5,
      "note": "Voorbeeld",
      "internalNote": "Voorbeeld",
      "currency": "EUR",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "structuredCommunication": "Voorbeeld",
      "originalDisplayId": "2026-00123",
      "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
      "bookedById": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
      "excludeFromAutomatedReminders": false,
      "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
      "peppolProvider": "SCRADA",
      "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
      "peppolUblFolder": "Voorbeeld",
      "peppolUblKey": "Voorbeeld"
    },
    "payment": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "amount": 12.5,
      "amountRefunded": 12.5,
      "amountRemaining": 12.5,
      "currency": "EUR",
      "description": "Voorbeeld",
      "reference": "Voorbeeld",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "expiresAt": "2026-01-15T09:30:00.000Z",
      "paidAt": "2026-01-15T09:30:00.000Z",
      "delayUntil": "2026-01-15T09:30:00.000Z",
      "errorMessage": "Voorbeeld",
      "errorMessageTranslationKey": "Voorbeeld",
      "status": "PENDING",
      "method": "UNKNOWN",
      "channel": "MANUAL",
      "provider": "MOLLIE",
      "channelInfo": {},
      "accountingSoftwareProvider": "ADMISOL",
      "accountingSoftwareMetadata": {},
      "createdById": "cm4k7x2pq0001abcd1234efgh",
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
      "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
    }
  }
}
```

</Accordion>
</Accordions>

### `invoice:updated` [#invoice-updated]

Factuur gewijzigd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

## ledgerOpeningBalance [#ledgeropeningbalance]

### `ledgerOpeningBalance:created` [#ledgeropeningbalance-created]

Beginsaldo toegevoegd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

### `ledgerOpeningBalance:deleted` [#ledgeropeningbalance-deleted]

Beginsaldo verwijderd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

### `ledgerOpeningBalance:updated` [#ledgeropeningbalance-updated]

Beginsaldo gewijzigd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

## mandate-agreement [#mandate-agreement]

### `mandate-agreement:activated` [#mandate-agreement-activated]

Mandaat actief.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:activated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:expired` [#mandate-agreement-expired]

Mandaataanvraag verlopen.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:expired",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:failed` [#mandate-agreement-failed]

Mandaat geweigerd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:failed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:signed` [#mandate-agreement-signed]

Mandaat ondertekend.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:signed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:updated` [#mandate-agreement-updated]

Mandaataanvraag gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## mandate [#mandate]

### `mandate:created` [#mandate-created]

Mandaat aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `mandate:deleted` [#mandate-deleted]

Mandaat verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `mandate:updated` [#mandate-updated]

Mandaat gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## meter [#meter]

### `meter:created` [#meter-created]

Meter aangemaakt.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `meter:updated` [#meter-updated]

Meter gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## meterAnomaly [#meteranomaly]

### `meterAnomaly:detected` [#meteranomaly-detected]

Meterafwijking vastgesteld.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterAnomaly:detected",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "anomaly": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "kind": "FLAT_WHILE_PRESENT",
      "detectedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "flatSince": "2026-01-15T09:30:00.000Z",
      "lastReadingAt": "2026-01-15T09:30:00.000Z",
      "lastReadingValue": 12.5,
      "presenceDays": 1,
      "expectedConsumption": 12.5,
      "observedConsumption": 12.5,
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `meterAnomaly:resolved` [#meteranomaly-resolved]

Meterafwijking opgelost.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterAnomaly:resolved",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "anomaly": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "kind": "FLAT_WHILE_PRESENT",
      "detectedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "flatSince": "2026-01-15T09:30:00.000Z",
      "lastReadingAt": "2026-01-15T09:30:00.000Z",
      "lastReadingValue": 12.5,
      "presenceDays": 1,
      "expectedConsumption": 12.5,
      "observedConsumption": 12.5,
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

## meterConsumptionBatch [#meterconsumptionbatch]

### `meterConsumptionBatch:created` [#meterconsumptionbatch-created]

Verbruiksperiode gestart.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterConsumptionBatch:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "startReadingId": "cm4k7x2pq0001abcd1234efgh",
    "endReadingId": "cm4k7x2pq0001abcd1234efgh",
    "consumption": 12.5,
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "closed": false,
    "invoiced": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `meterConsumptionBatch:updated` [#meterconsumptionbatch-updated]

Verbruiksperiode gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterConsumptionBatch:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "startReadingId": "cm4k7x2pq0001abcd1234efgh",
    "endReadingId": "cm4k7x2pq0001abcd1234efgh",
    "consumption": 12.5,
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "closed": false,
    "invoiced": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## meterReading [#meterreading]

### `meterReading:created` [#meterreading-created]

Meterstand ingevoerd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:deleted` [#meterreading-deleted]

Meterstand verwijderd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:synced` [#meterreading-synced]

Meterstand gesynchroniseerd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:synced",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:updated` [#meterreading-updated]

Meterstand gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## nativeDevice [#nativedevice]

### `nativeDevice:command` [#nativedevice-command]

- **Permissie:** `native-devices:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nativeDevice:command",
  "data": {
    "installationId": "cm4k7x2pq0001abcd1234efgh",
    "url": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

### `nativeDevice:config` [#nativedevice-config]

- **Permissie:** `native-devices:read`
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `nativeDevice:deleted` [#nativedevice-deleted]

Tablet of kiosk verwijderd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nativeDevice:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## nfc-tag-transaction [#nfc-tag-transaction]

### `nfc-tag-transaction:changed` [#nfc-tag-transaction-changed]

NFC-tagtransactie gewijzigd.

- **Permissie:** `nfc-tag-transactions:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag-transaction:changed",
  "data": {
    "transactionId": "cm4k7x2pq0001abcd1234efgh",
    "nfcTagId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING"
  }
}
```

</Accordion>
</Accordions>

## nfc-tag [#nfc-tag]

### `nfc-tag:blocked` [#nfc-tag-blocked]

NFC-tag geblokkeerd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:blocked",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:presented` [#nfc-tag-presented]

NFC-tag aangeboden.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:presented",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:unblocked` [#nfc-tag-unblocked]

NFC-tag gedeblokkeerd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:unblocked",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:updated` [#nfc-tag-updated]

NFC-tag gewijzigd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## notification-delivery [#notification-delivery]

### `notification-delivery:deleted` [#notification-delivery-deleted]

Melding verwijderd.

- **Permissie:** `notifications:deliveries:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notification-delivery:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "notificationName": "Voorbeeld",
    "metadata": {},
    "source": "INTERNAL",
    "externalSource": "Voorbeeld",
    "externalReference": "Voorbeeld",
    "createdByApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "createdByApiKeyName": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredByUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientReadAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `notification-delivery:updated` [#notification-delivery-updated]

Status van melding gewijzigd.

- **Permissie:** `notifications:deliveries:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notification-delivery:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "notificationName": "Voorbeeld",
    "metadata": {},
    "source": "INTERNAL",
    "externalSource": "Voorbeeld",
    "externalReference": "Voorbeeld",
    "createdByApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "createdByApiKeyName": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredByUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientReadAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## notificationInbox [#notificationinbox]

### `notificationInbox:created` [#notificationinbox-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notificationInbox:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "title": "Voorbeeld",
    "body": "Voorbeeld",
    "url": "https://example.com",
    "urgent": false,
    "hasEmail": false,
    "readAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `notificationInbox:read` [#notificationinbox-read]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notificationInbox:read",
  "data": {
    "readAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## occupation [#occupation]

### `occupation:ended` [#occupation-ended]

Bezetting beëindigd.

- **Permissie:** `terrains:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "occupation:ended",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "occupationType": "OWN_ACCOMMODATION",
    "rentPeriod": {},
    "price": 12.5,
    "description": "Voorbeeld",
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "invoicedUntil": "2026-01-15T09:30:00.000Z",
    "customFields": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## organizationSettings [#organizationsettings]

### `organizationSettings:updated` [#organizationsettings-updated]

Instellingen gewijzigd.

- **Permissie:** `organization:settings:read` of `organization:settings:write`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": false
  }
}
```

</Accordion>
</Accordions>

## payment-group [#payment-group]

### `payment-group:assigned-to-invoice` [#payment-group-assigned-to-invoice]

Betalingsgroep gekoppeld aan een factuur.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:assigned-to-invoice",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    },
    "invoiceId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:created` [#payment-group-created]

Betalingsgroep aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "OPEN",
    "metadata": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "assignedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:deleted` [#payment-group-deleted]

Betalingsgroep verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:payments-added` [#payment-group-payments-added]

Betalingen toegevoegd aan een groep.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:payments-added",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `payment-group:payments-removed` [#payment-group-payments-removed]

Betalingen verwijderd uit een groep.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:payments-removed",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `payment-group:unassigned-from-invoice` [#payment-group-unassigned-from-invoice]

Betalingsgroep ontkoppeld van een factuur.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:unassigned-from-invoice",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    },
    "previousInvoiceId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:updated` [#payment-group-updated]

Betalingsgroep gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "OPEN",
    "metadata": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "assignedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## payment-report [#payment-report]

### `payment-report:created` [#payment-report-created]

Betalingsrapport aangemaakt.

- **Permissie:** `payment-reports:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-report:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "reportDate": "2026-01-15T09:30:00.000Z",
    "status": "CONCEPT",
    "totalAmount": 12.5,
    "paymentCount": 1,
    "mollieSettlementId": "cm4k7x2pq0001abcd1234efgh",
    "mollieSettlement": {},
    "metadata": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `payment-report:updated` [#payment-report-updated]

Betalingsrapport gewijzigd.

- **Permissie:** `payment-reports:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-report:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "reportDate": "2026-01-15T09:30:00.000Z",
    "status": "CONCEPT",
    "totalAmount": 12.5,
    "paymentCount": 1,
    "mollieSettlementId": "cm4k7x2pq0001abcd1234efgh",
    "mollieSettlement": {},
    "metadata": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## payment [#payment]

### `payment:created` [#payment-created]

Betaling aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment:deleted` [#payment-deleted]

Betaling verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment:updated` [#payment-updated]

Betaling gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## pdf [#pdf]

### `pdf:clear-tablet` [#pdf-clear-tablet]

Pdf gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `pdf:to-tablet` [#pdf-to-tablet]

Pdf naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "pdf:to-tablet",
  "data": {
    "pdfUrl": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

## print-queue-job [#print-queue-job]

### `print-queue-job:updated` [#print-queue-job-updated]

Printopdracht gewijzigd.

- **Permissie:** `printing:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "print-queue-job:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "type": "INVOICE_A4",
    "referenceId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "accessMethodId": "cm4k7x2pq0001abcd1234efgh",
    "identityDocumentScanId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "documentId": "cm4k7x2pq0001abcd1234efgh",
    "pdfUrl": "https://example.com",
    "scheduledAt": "2026-01-15T09:30:00.000Z",
    "attemptCount": 1,
    "lastError": "Voorbeeld",
    "claimedAt": "2026-01-15T09:30:00.000Z",
    "finishedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## product [#product]

### `product:created` [#product-created]

Product aangemaakt.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `product:deleted` [#product-deleted]

Product verwijderd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `product:updated` [#product-updated]

Product gewijzigd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## productPriceChange [#productpricechange]

### `productPriceChange:applied` [#productpricechange-applied]

Geplande productprijs toegepast.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:applied",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `productPriceChange:created` [#productpricechange-created]

Productprijs gepland.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `productPriceChange:deleted` [#productpricechange-deleted]

Geplande productprijs verwijderd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## reservation [#reservation]

### `reservation:created` [#reservation-created]

Reservering aangemaakt.

- **Permissie:** `reservations:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "reservation:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "BOOKED",
    "note": "Voorbeeld",
    "checkIn": "2026-01-15T09:30:00.000Z",
    "checkOut": "2026-01-15T09:30:00.000Z",
    "checkedInAt": "2026-01-15T09:30:00.000Z",
    "checkedOutAt": "2026-01-15T09:30:00.000Z",
    "canceledAt": "2026-01-15T09:30:00.000Z",
    "numberOfToddlers": 1,
    "numberOfChildren": 1,
    "numberOfAdults": 1,
    "numberOfAnimals": 1,
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "preferredTerrainId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "customFields": {},
    "allowOnlinePayments": false,
    "sendConfirmationEmails": false
  }
}
```

</Accordion>
</Accordions>

### `reservation:updated` [#reservation-updated]

Reservering gewijzigd.

- **Permissie:** `reservations:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "reservation:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "BOOKED",
    "note": "Voorbeeld",
    "checkIn": "2026-01-15T09:30:00.000Z",
    "checkOut": "2026-01-15T09:30:00.000Z",
    "checkedInAt": "2026-01-15T09:30:00.000Z",
    "checkedOutAt": "2026-01-15T09:30:00.000Z",
    "canceledAt": "2026-01-15T09:30:00.000Z",
    "numberOfToddlers": 1,
    "numberOfChildren": 1,
    "numberOfAdults": 1,
    "numberOfAnimals": 1,
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "preferredTerrainId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "customFields": {},
    "allowOnlinePayments": false,
    "sendConfirmationEmails": false
  }
}
```

</Accordion>
</Accordions>

## sign [#sign]

### `sign:clear-tablet` [#sign-clear-tablet]

Ondertekening gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `sign:to-tablet` [#sign-to-tablet]

Ondertekening naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## signatureRequest [#signaturerequest]

### `signatureRequest:completed` [#signaturerequest-completed]

Ondertekenverzoek afgerond.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:completed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `signatureRequest:deleted` [#signaturerequest-deleted]

Ondertekenverzoek verwijderd.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `signatureRequest:updated` [#signaturerequest-updated]

Ondertekenverzoek gewijzigd.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task-time-tracker [#task-time-tracker]

### `task-time-tracker:changed` [#task-time-tracker-changed]

- **Permissie:** `tasks:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-time-tracker:changed",
  "data": {
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "previousTaskId": "cm4k7x2pq0001abcd1234efgh",
    "cleared": false,
    "id": "cm4k7x2pq0001abcd1234efgh",
    "userId": "cm4k7x2pq0001abcd1234efgh",
    "note": "Voorbeeld",
    "accumulatedMs": 12.5,
    "runningSince": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task-view [#task-view]

### `task-view:created` [#task-view-created]

Takenweergave aangemaakt.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `task-view:deleted` [#task-view-deleted]

Takenweergave verwijderd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `task-view:membership-changed` [#task-view-membership-changed]

Taken in een weergave gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:membership-changed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task-view:updated` [#task-view-updated]

Takenweergave gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task [#task]

### `task:action-chosen` [#task-action-chosen]

Taakactie gekozen.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:action-chosen",
  "data": {
    "task": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "PENDING",
      "priority": "LOW",
      "sortOrder": 1,
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "completedAt": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "remindAt": "2026-01-15T09:30:00.000Z",
      "reminderSentAt": "2026-01-15T09:30:00.000Z",
      "remindByEmail": false,
      "remindByPush": false,
      "remindRrule": "Voorbeeld",
      "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
      "commentId": "cm4k7x2pq0001abcd1234efgh",
      "parentId": "cm4k7x2pq0001abcd1234efgh",
      "metadata": {},
      "customFields": {},
      "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
      "actionChosenAt": "2026-01-15T09:30:00.000Z",
      "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
      "actionNote": "Voorbeeld",
      "completionLocked": false,
      "createdById": "cm4k7x2pq0001abcd1234efgh"
    },
    "action": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "taskId": "cm4k7x2pq0001abcd1234efgh",
      "label": "Voorbeeld",
      "color": "Voorbeeld",
      "icon": "Voorbeeld",
      "position": 1,
      "key": "Voorbeeld",
      "requiresNote": false,
      "requiresConfirmation": false,
      "confirmTitle": "Voorbeeld",
      "confirmDescription": "Voorbeeld",
      "confirmLevel": "Voorbeeld",
      "automationId": "cm4k7x2pq0001abcd1234efgh"
    },
    "note": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `task:assigned` [#task-assigned]

Taak toegewezen.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:assigned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:created` [#task-created]

Taak aangemaakt.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:deleted` [#task-deleted]

Taak verwijderd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:status-changed` [#task-status-changed]

Taakstatus gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:status-changed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:unassigned` [#task-unassigned]

Taaktoewijzing opgeheven.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:unassigned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:updated` [#task-updated]

Taak gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## terrain [#terrain]

### `terrain:updated` [#terrain-updated]

Terrein gewijzigd.

- **Permissie:** `terrains:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "terrain:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "bookable": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "geoJson": {},
    "surfaceArea": 12.5,
    "metadata": {},
    "customFields": {},
    "calculatedTariff": {},
    "terrainTypeId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## vehiclePresence [#vehiclepresence]

### `vehiclePresence:updated` [#vehiclepresence-updated]

- **Permissie:** `access-control:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "vehiclePresence:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "plate": "Voorbeeld",
    "status": "INSIDE",
    "lastSeenAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>


# Externe Benachrichtigungen (/de-DE/ontwikkelaars/externe-notificaties)

Versendet Ihr System selbst E-Mails an Kunden (Newsletter, Buchungsbestätigung, Erinnerung)? Registrieren Sie sie dann in Tillor. Mitarbeitende sehen sie beim Kunden, auf der Rechnung und in der Übersicht **Benachrichtigungen**, neben den Benachrichtigungen, die Tillor selbst versendet.

Tillor **versendet nichts**: Sie registrieren eine Nachricht, die bereits gesendet wurde. Externe Benachrichtigungen tragen in der App immer das Label **Extern** mit Ihrem Quellennamen, sodass sie nie für eine Tillor-Benachrichtigung gehalten werden.

## Zugriff [#toegang]

Der Benutzer hinter dem [API-Schlüssel](/ontwikkelaars/http) benötigt in der Organisation eine dieser Berechtigungen. Ein Administrator vergibt sie bei den Benutzerberechtigungen der Organisation, in der Gruppe **Benachrichtigungen** (**Externe Benachrichtigungen registrieren** und **Externe Benachrichtigungen anderer verwalten**).

| Berechtigung | Was Sie dürfen |
|-----------|------------|
| `notifications:external:write` | Benachrichtigungen registrieren und Ihre **eigenen** Registrierungen aktualisieren oder löschen |
| `notifications:external:manage-others` | Auch Registrierungen anderer Benutzer oder Integrationen aktualisieren oder löschen |

<Callout type="info" title="Ein Benutzer pro Integration">
Die Eigentümerschaft hängt am Benutzer des API-Schlüssels. Verwenden Sie pro Integration einen eigenen (Service-)Benutzer, dann kann eine Integration nie die Benachrichtigungen einer anderen ändern.
</Callout>

## Endpunkte [#endpoints]

Alle Pfade stehen unter `/api/orgs/:orgId`. Genaue Schemas: [OpenAPI](https://tillor.eu/api/openapi.json), Tag `notifications`.

| Methode | Pfad | Beschreibung |
|--------|-----|--------------|
| POST | `/notifications/external` | Benachrichtigung registrieren |
| PATCH | `/notifications/external/{id}` | Status, Zeitpunkte oder Inhalt aktualisieren |
| DELETE | `/notifications/external/{id}` | Endgültig löschen |
| GET | `/notifications?source=EXTERNAL` | Registrierte Benachrichtigungen auflisten (filtern Sie auch nach `externalSource`, `externalReference`, `customerId`, `invoiceId`) |
| GET | `/notifications/{id}` | Eine Benachrichtigung abrufen |

Benachrichtigungen, die Tillor selbst versendet hat, können Sie über diese Endpunkte nicht ändern oder löschen; sie ergeben `404`.

## Registrieren [#registreren]

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/notifications/external" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "externalSource": "mailchimp",
    "externalReference": "campaign-42:member-9f3a",
    "name": "Boekingsbevestiging",
    "customerId": "clx789...",
    "channel": "EMAIL",
    "status": "SENT",
    "sentAt": "2026-09-19T08:15:00Z",
    "email": {
      "to": "jan@voorbeeld.nl",
      "from": "Recreatiepark Het Meer <info@recreatiepark-het-meer.be>",
      "subject": "Je boeking is bevestigd",
      "htmlBody": "<p>Dag Jan, ...</p>",
      "attachments": [{ "filename": "bevestiging.pdf", "contentType": "application/pdf", "size": 48211 }]
    }
  }'
```

Alle Felder und Grenzwerte stehen in [OpenAPI](https://tillor.eu/api/openapi.json). Für diese Felder gelten Regeln, die Sie vorab kennen sollten:

| Feld | Regel |
|------|-------|
| `externalSource` | Name Ihres Systems in Kleinbuchstaben, Ziffern, `.`, `_` oder `-` (z. B. `mailchimp`). Mitarbeitende sehen diesen Namen bei der Benachrichtigung |
| `externalReference` | Ihre eigene ID für diese Nachricht, eindeutig innerhalb von `externalSource` |
| `name` | Kurzes Label für Mitarbeitende (z. B. „Boekingsbevestiging“). Danach kann gesucht werden |
| `customerId` / `invoiceId` | Mindestens eines von beiden. Bestimmt, wo die Benachrichtigung erscheint. Senden Sie nur `invoiceId`, verknüpft Tillor auch den Kunden dieser Rechnung. Eine unbekannte ID oder eine Rechnung eines anderen Kunden ergibt `400` |
| `status` | `SENT`, `FAILED`, `BOUNCED` oder `COMPLAINED`. Ohne `sentAt` bei `SENT` verwendet Tillor den Zeitpunkt der Registrierung |
| `sentAt`, `readAt`, `clickedAt` | ISO 8601 mit Zeitzone, z. B. `2026-09-19T08:15:00Z`. Andere Werte werden abgelehnt |
| `email.attachments` | Nur Metadaten (`filename`, `contentType`, `size`). Die Dateien selbst werden nicht gespeichert |

### Sicher erneut versuchen [#veilig-opnieuw-proberen]

`POST` ist idempotent auf `externalSource` + `externalReference`. Senden Sie dieselbe Kombination erneut (zum Beispiel nach einem Timeout), erhalten Sie die **bestehende** Benachrichtigung zurück, und es wird nichts geändert. Möchten Sie etwas anpassen, verwenden Sie `PATCH`.

<Callout type="warn" title="Keine personenbezogenen Daten in externalReference oder name">
`externalSource`, `externalReference` und `name` werden unverschlüsselt gespeichert, weil danach gesucht wird. Verwenden Sie eine technische ID, keine E-Mail-Adresse und keinen Namen. Eine `externalReference` mit `@` wird abgelehnt. Empfänger, Betreff, Inhalt und Anhänge werden dagegen verschlüsselt gespeichert.
</Callout>

## Aktualisieren und löschen [#bijwerken-en-verwijderen]

Senden Sie bei `PATCH` nur die Felder, die sich ändern, zum Beispiel wenn eine E-Mail nachträglich zurückgewiesen wird:

```bash
curl -X PATCH "https://tillor.eu/api/orgs/org_abc123/notifications/external/NOTIFICATION_ID" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "status": "BOUNCED", "errorMessage": "Mailbox bestaat niet" }'
```

`DELETE` löscht die Benachrichtigung endgültig, einschließlich Inhalt. Nutzen Sie dies auch, um einer Löschanfrage (DSGVO) nachzukommen.

Ein `PATCH`, der nichts ändert, tut nichts: keine Änderung, kein Event. Ändern Sie den Inhalt (Label, Empfänger, Absender, Betreff, Text, HTML oder Anhänge) oder löschen Sie eine Benachrichtigung, steht das im Aktivitätsprotokoll des Kunden oder der Rechnung, mit dem Benutzer, der es getan hat. Aktualisierungen von Status, `readAt` oder `clickedAt` erscheinen dort nicht, damit Sie Öffnungen und Klicks weiter synchronisieren können.

## HTML und Datenschutz [#html-en-privacy]

Tillor zeigt das HTML den Mitarbeitenden so, wie der Kunde es erhalten hat, behandelt es aber als nicht vertrauenswürdigen Inhalt:

- Beim Speichern werden Skripte, Formulare, iframes, Embeds und Event-Attribute (`onclick`, ...) entfernt. Links öffnen sich in einem neuen Tab
- Die Vorschau läuft in einem abgeschirmten Frame ohne Skripte und ohne Zugriff auf die Tillor-Sitzung
- Externe Bilder und Schriftarten werden **nicht automatisch** geladen, damit das Öffnen einer Benachrichtigung kein Tracking-Pixel auslöst. Der Mitarbeitende kann Bilder pro Benachrichtigung nachladen

Rechnen Sie also nicht damit, dass das „Geöffnet“-Tracking in Ihrem System anschlägt, wenn ein Mitarbeitender die Benachrichtigung ansieht.

## Was Tillor mit externen Benachrichtigungen nicht tut [#wat-tillor-niet-doet-met-externe-notificaties]

- Nicht (erneut) versenden oder automatisch erneut versuchen
- Keine Statusupdates bei Ihrem Mailanbieter abfragen: Sie halten den Status mit `PATCH` aktuell
- Nicht mitzählen in den Listen **Fehlgeschlagene Benachrichtigungen**, **Zurückgewiesene Benachrichtigungen** und **Ausstehende Benachrichtigungen** oder in den Zählern oben in der Benachrichtigungsübersicht, weil Tillor Ihren Status nicht verifizieren kann. Sie stehen aber unter **Letzte Kommunikation**

## Webhooks und SSE [#webhooks-en-sse]

| Event | Wann |
|-------|---------|
| `notification-delivery:updated` | Bei der Registrierung und bei jedem `PATCH`, der etwas ändert. Enthält die vollständige Benachrichtigung |
| `notification-delivery:deleted` | Bei `DELETE`. Enthält nur `id`, `source`, `externalSource`, `externalReference`, `customerId` und `invoiceId` |

Das Feld `source` ist `EXTERNAL` für Ihre Registrierungen und `INTERNAL` für Benachrichtigungen von Tillor. Filtern Sie danach, wenn Sie Ihre eigenen Events überspringen möchten. Siehe [Webhooks](/ontwikkelaars/webhooks) und [SSE](/ontwikkelaars/sse).

## Verwandt [#gerelateerd]

- [HTTP API](/ontwikkelaars/http) - API-Schlüssel, Header und Rate Limits
- [Webhooks](/ontwikkelaars/webhooks) - Events per HTTP POST empfangen
- [OpenAPI](https://tillor.eu/api/openapi.json) - Vollständige Schemas


# HTTP API (/de-DE/ontwikkelaars/http)

Die Tillor API ist eine REST API. Authentifizieren Sie sich mit einem API-Schlüssel und senden Sie bei jeder Anfrage die richtigen Header. API-Schlüssel gelten **pro Konto** - ein Schlüssel funktioniert für alle Organisationen, auf die Sie Zugriff haben.

## API-Referenz und OpenAPI [#api-referentie-en-openapi]

- **[API-Referenz](/api-referentie)** - Jeder Endpunkt mit Parametern und Beispielen; probieren Sie Anfragen direkt im Browser aus
- **[OpenAPI-Spezifikation](https://tillor.eu/api/openapi.json)** - Vollständige API-Dokumentation im JSON-Format für Codegenerierung oder den Import in Postman/Insomnia

---

## API-Schlüssel [#api-sleutels]

### Anlegen [#aanmaken]

API-Schlüssel legen Sie in der Tillor-App über das Benutzermenü unter **Konto > API-Schlüssel** an (Markierung **1** = Menü, Markierung **2** = API-Schlüssel im Screenshot). Sie können sie auch über die API mit einer angemeldeten Sitzung (ohne API-Schlüssel) anlegen. Siehe die [OpenAPI-Spezifikation](https://tillor.eu/api/openapi.json) unter dem Tag `api-keys` für Pfade sowie Request- und Response-Schemas.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="API-Schlüssel in den Kontoeinstellungen" />

Der Rohschlüssel wird **einmalig** beim Anlegen oder Neugenerieren zurückgegeben. Bewahren Sie ihn sicher auf; Sie können ihn danach nicht mehr abrufen.

### Berechtigungen beschränken [#rechten-beperken]

Standardmäßig kann ein Schlüssel alles, was Sie selbst dürfen, in jeder Organisation, in der Sie Mitglied sind. Schalten Sie im Schlüsselfenster **Auf ausgewählte Berechtigungen beschränken** ein und wählen Sie die Berechtigungen, die die Anbindung braucht, zum Beispiel nur Rechnungen lesen. Ein beschränkter Schlüssel erhält in jeder Organisation die Schnittmenge seiner Berechtigungen und Ihrer dortigen Mitgliedschaft: Ein Schlüssel kann nie mehr als Sie. Ein Aufruf außerhalb der gewählten Berechtigungen erhält `403 Forbidden`, genau wie ein Benutzer ohne dieses Recht. Eine Änderung der Berechtigungen gilt innerhalb einer Minute. Über die API: `scopes` (Liste von Berechtigungs-IDs wie `invoices:read`, oder `null` für alles) beim Anlegen und Aktualisieren eines Schlüssels.

### Verwendung [#gebruik]

Senden Sie den API-Schlüssel im Header `x-api-key`:

```http
x-api-key: tkn_xxx
```

Schlüssel verwenden das Präfix `tkn_`. Bei Organisations-Endpunkten steht die Organisations-ID im Pfad (`/orgs/org_abc123/...`); ein separater Header ist nicht nötig.

### Rate Limits [#rate-limits]

- **Standard:** 5000 Anfragen pro 60 Sekunden pro Schlüssel
- Bei Überschreitung: `429 Too Many Requests` mit `Retry-After`
- Jede Antwort auf einen API-Schlüssel enthält IETF-`RateLimit-*`-Header:

```http
RateLimit-Limit: 5000
RateLimit-Remaining: 4999
RateLimit-Reset: 58
RateLimit-Policy: 5000;w=60
```

`RateLimit-Reset` ist die Anzahl der Sekunden, bis das aktuelle Zeitfenster neu beginnt. Browser-Clients können diese Header über CORS lesen (`Access-Control-Expose-Headers`).

### Sicherheit [#beveiliging]

<Callout type="warn" title="Achtung">
- **Nie** API-Schlüssel in clientseitigem Code oder öffentlichen Repositories offenlegen
- Generieren Sie Schlüssel regelmäßig über **Neu generieren** in der App neu (OpenAPI: `POST /api/api-keys/:id/renew`)
- Löschen Sie ungenutzte Schlüssel mit `DELETE /api/api-keys/:id`
</Callout>

---

## Base URL und Organisationskontext [#base-url-en-organisatie-context]

**Base URL:** `https://tillor.eu` (oder Ihre Deployment-URL; OpenAPI nennt `{APP_URL}/api`)

**Organisationspfade:** Fügen Sie die Organisations-ID in den Pfad ein:

```
/api/orgs/:orgId/...
```

**Beispiel:**

```
GET https://tillor.eu/api/orgs/org_abc123/customers
```

**Erforderlicher Header für Organisations-Endpunkte:** `x-api-key: tkn_xxx`. Die Organisations-ID steht im Pfad.

---

## Beispiel: cURL [#voorbeeld-curl]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/customers" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json"
```

---

## Integrationen (Marketplace) [#integraties-marketplace]

Organisations-Integrationen (früher „Apps“ in der API) verwenden pro Typ eine Ressource unter `/api/orgs/:orgId/integrations/{integrationType}`. Erforderliche Berechtigungen sind `organization:integrations:read` und `organization:integrations:write` (ersetzt `organization:apps:*`).

| Methode | Pfad | Beschreibung |
|--------|------|-------------|
| GET | `/integrations/{integrationType}` | Status (`installed`, `available`) und geschwärzte `settings` |
| POST | `/integrations/{integrationType}` | Installieren (optional `settings` im Body; OAuth kann `redirectUrl` zurückgeben) |
| PUT | `/integrations/{integrationType}` | Einstellungen aktualisieren (`settings` im Body) |
| DELETE | `/integrations/{integrationType}` | Deinstallieren |

Bei `GET` und nach `PUT` enthält `settings` nur **öffentliche** Felder plus pro geheimem Feld `{ configured: true }`. Passwörter, API-Keys und OAuth-Tokens kommen nicht zurück. Lassen Sie geheime Felder bei `PUT` leer, um den bestehenden Wert zu behalten.

Genaue Schemas finden Sie in der [OpenAPI-Spezifikation](https://tillor.eu/api/openapi.json) (Tag `integrations`).

---

## Verwandt [#gerelateerd]

- [API-Referenz](/api-referentie) - Jeder Endpunkt, im Browser ausprobierbar
- [OpenAPI](https://tillor.eu/api/openapi.json) - API-Spezifikation (JSON)
- [MCP](/ontwikkelaars/mcp) - Cursor, Claude, ChatGPT oder Gemini über OAuth anbinden
- [Externe Benachrichtigungen](/ontwikkelaars/externe-notificaties) - E-Mails registrieren, die Ihr eigenes System versendet hat
- [Webhooks](/ontwikkelaars/webhooks) - Events per HTTP POST empfangen
- [Eingehender Webhook einer Automatisierung](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - Eine Automatisierung mit einem POST starten, ohne API-Schlüssel
- [SSE](/ontwikkelaars/sse) - Events per Server-Sent Events streamen
- [Beispiele](/ontwikkelaars/voorbeelden) - Code- und Payload-Beispiele


# Übersicht (/de-DE/ontwikkelaars)

Die Tillor API bietet programmatischen Zugriff auf Ihre Organisationsdaten. Verwenden Sie API-Schlüssel zur Authentifizierung, Webhooks für ausgehende Events, SSE oder MQTT für Echtzeit-Streaming oder MCP, um KI-Tools wie Cursor, Claude, ChatGPT und Gemini mit Tillor zu verbinden.

## Was können Sie bauen? [#wat-kun-je-bouwen]

- **Integrationen** - Verbinden Sie Tillor über die REST API mit Ihren eigenen Systemen
- **Webhooks** - Empfangen Sie HTTP-POST-Nachrichten, wenn Events eintreten (Rechnung bezahlt, Kunde angelegt usw.)
- **Automatisierungen starten** - Starten Sie eine Automatisierung aus Ihrem eigenen System mit einem POST an ihren [eingehenden Webhook](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook)
- **Echtzeit-Dashboards** - Streamen Sie Events über SSE oder MQTT für Live-Updates in Ihrer Anwendung
- **KI-Tools** - Lassen Sie Cursor, Claude, ChatGPT oder Gemini die API über [MCP](/ontwikkelaars/mcp) aufrufen (`https://mcp.tillor.dev`)

## Schnellstart [#snel-aan-de-slag]

1. **Legen Sie einen API-Schlüssel an** in Tillor unter *Konto > API-Schlüssel*
2. **Senden Sie den Schlüssel** im Header `x-api-key` bei jeder Anfrage
3. **Setzen Sie Ihre Organisations-ID in den Pfad** von Organisations-Endpunkten: `/orgs/org_abc123/...`

<Callout type="info" title="Dieselben Events">
Webhooks und SSE liefern exakt dieselben Events. Der Unterschied: Webhooks senden HTTP POST an Ihre URL; SSE ist eine dauerhafte Verbindung, über die Sie Events empfangen.
</Callout>

**Nützliche Links:** [API-Referenz](/api-referentie) - [OpenAPI](https://tillor.eu/api/openapi.json)

**Geltungsbereich:** API-Schlüssel gelten pro Konto (alle Organisationen); Webhooks gelten pro Organisation.

<Callout type="idea" title="Dokumentation für KI-Tools">
Sie können diese Seite auch als Text für KI-Tools verwenden: [`/llms.txt`](/llms.txt) (Index), [`/llms-full.txt`](/llms-full.txt) (alle Seiten zusammen), und pro Seite, indem Sie `.mdx` hinter den Pfad setzen (zum Beispiel [`/ontwikkelaars/http.mdx`](/ontwikkelaars/http.mdx)). **KI fragen (lokal)** im Doc-Layout lädt diesen vollständigen Export (`/llms-full.txt`) in die in Chrome eingebaute KI, sodass Sie nicht auf einer bestimmten Seite sein müssen.
</Callout>

## Siehe auch [#zie-ook]

<Cards>
  <Card
    title="HTTP API"
    href="/ontwikkelaars/http"
    description="API-Schlüssel, Authentifizierung, Base URL und Organisationskontext"
  />
  <Card
    title="MCP"
    href="/ontwikkelaars/mcp"
    description="Cursor, Claude, ChatGPT oder Gemini über OAuth mit Tillor verbinden"
  />
  <Card
    title="Externe Benachrichtigungen"
    href="/ontwikkelaars/externe-notificaties"
    description="E-Mails registrieren, die Ihr eigenes System an Kunden gesendet hat"
  />
  <Card
    title="Webhooks"
    href="/ontwikkelaars/webhooks"
    description="Events per HTTP POST an Ihren Endpunkt empfangen"
  />
  <Card
    title="Automatisierungen"
    href="/ontwikkelaars/automatiseringen"
    description="Die Webhook-Nachricht, die API-Anfrage, eingehende Webhooks und der Aufbau eines Flows"
  />
  <Card
    title="SSE"
    href="/ontwikkelaars/sse"
    description="Echtzeit-Events per Server-Sent Events streamen"
  />
  <Card
    title="MQTT"
    href="/ontwikkelaars/mqtt"
    description="Pub/Sub über MQTT mit strengem Topic-Zugriff und JWT oder statischen Zugangsdaten"
  />
  <Card
    title="Mollie-Metadaten"
    href="/ontwikkelaars/mollie-metadata"
    description="tillor-Namespace auf Mollie-Zahlungen"
  />
  <Card
    title="Website-Chat-API"
    href="/ontwikkelaars/website-chat"
    description="Eigene Chat-Oberfläche über REST und SSE"
  />
  <Card
    title="Beispiele"
    href="/ontwikkelaars/voorbeelden"
    description="Code- und Payload-Beispiele für HTTP, Webhooks und SSE"
  />
</Cards>


# MCP (/de-DE/ontwikkelaars/mcp)

Mit MCP (Model Context Protocol) lassen Tools wie Cursor, Claude, ChatGPT und Gemini die Tillor API für Sie aufrufen. Sie melden sich einmal über OAuth an; in Ihrer Konfiguration muss kein API-Schlüssel stehen.

**URL:** `https://mcp.tillor.dev`

## Was Sie damit tun können [#wat-je-ermee-kunt]

Nach dem Verbinden können Sie im KI-Tool:

1. API-Kategorien und Endpunkte ansehen (aus der OpenAPI-Spezifikation)
2. Endpunkte mit Ihren Berechtigungen in der gewählten Organisation aufrufen

Das läuft über dieselbe REST API wie die [HTTP API](/ontwikkelaars/http). Was Sie tun dürfen, hängt von Ihrem Tillor-Konto und Ihren Berechtigungen in dieser Organisation ab. Das Verbinden über OAuth erfordert die Berechtigung **OAuth-Apps autorisieren** (`oauth:consent`) in mindestens einer Organisation. Ohne diese Berechtigung scheitert die Zustimmung, und bestehende OAuth-Tokens funktionieren nicht mehr.

## Authentifizierung [#authenticatie]

1. Das Tool verbindet sich ohne Token mit `https://mcp.tillor.dev`
2. OAuth-Discovery und Registrierung laufen über den MCP-Host; Login und Zustimmung bei Tillor
3. Sie genehmigen den Zugriff im Browser
4. Das Tool sendet danach bei MCP-Aufrufen ein Bearer-Token mit

Senden Sie Ihre Organisation als Header mit, wenn das Tool das unterstützt (Cursor, Gemini CLI):

```http
X-Tillor-Org-Id: org_abc123
```

Ohne diesen Header (ChatGPT, Gemini-App, Claude) übergeben Sie `organizationId` bei `call_api_endpoint`. Organisationsrouten liegen unter `/orgs/{organizationId}`; die API füllt den Header dann selbst aus.

<Callout type="info" title="Kein API-Schlüssel nötig">
Für den gehosteten MCP-Server verwenden Sie OAuth (Connect / Authorize im Tool). Für Skripte und eigene Integrationen verwenden Sie weiterhin [API-Schlüssel](/ontwikkelaars/http).
</Callout>

## Verbinden [#koppelen]

Wählen Sie Ihr Tool:

<McpProviderGuide />

Oder öffnen Sie die [Installationsauswahl](https://install.apicommons.org/?config=eyJuYW1lIjoiVGlsbG9yIiwiZGVzY3JpcHRpb24iOiJUaWxsb3IgUkVTVCBBUEkgdmlhIE9BdXRoIiwicmVtb3RlIjp7InR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudGlsbG9yLmRldi9tY3AiLCJoZWFkZXJzIjp7IlgtVGlsbG9yLU9yZy1JZCI6Ijxvcmdhbml6YXRpb25JZD4ifX19) für Cline, Zed, Warp, Codex und alle anderen.

## Tools [#tools]

| Tool | Zweck |
|------|------|
| `list_api_categories` | Listet API-Kategorien auf |
| `list_api_endpoints` | Endpunkte einer Kategorie, mit Eingabeschema |
| `get_api_endpoint_schema` | Schema eines einzelnen Endpunkts anhand des Namens |
| `call_api_endpoint` | Ruft einen Endpunkt auf |

Endpunktnamen sind keine eigenen Tools: Verwenden Sie `call_api_endpoint`.

Die vollständige REST-Referenz bleibt [OpenAPI](https://tillor.eu/api/openapi.json). MCP ist eine Schicht darüber, keine eigene Produkt-API.

## Verwandt [#gerelateerd]

- [HTTP API](/ontwikkelaars/http) - API-Schlüssel, Header und Base-URL
- [OpenAPI](https://tillor.eu/api/openapi.json) - Vollständige API-Spezifikation
- [API-Referenz](/api-referentie) - Jeder Endpunkt, im Browser ausprobierbar


# Mollie-Metadaten (/de-DE/ontwikkelaars/mollie-metadata)

Mollie speichert Metadaten zu jeder Zahlung. Tillor liest und schreibt Felder im `tillor`-Namespace. Verknüpfung in der App: [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).

Es gibt drei Arten:

1. **Verknüpfungsmetadaten** - Tillor schreibt sie zurück an Mollie, damit die Zahlung erkennbar ist
2. **Ingestion-Hinweise** - Sie setzen sie beim Anlegen der Mollie-Zahlung
3. **Direkte Buchhaltungsmetadaten** - Umgehung von Tillor Richtung Buchhaltung

## Verknüpfungsmetadaten [#koppelingsmetadata]

```json
{
  "tillor": {
    "paymentId": "clx123...",
    "invoiceId": "clx456...",
    "customerId": "clx789...",
    "paymentGroupId": "clxgrp..."
  }
}
```

Tillor schreibt `paymentId`, `invoiceId`, `customerId` und `paymentGroupId` an Mollie zurück, sobald eine Zahlung an einer Rechnung, einem Kunden oder einer [Zahlungsgruppe](/betalingsverwerking/groepen) hängt. Bestehende Nicht-Tillor-Metadaten bleiben erhalten.

| Feld | Beschreibung |
|------|---------------|
| `paymentId` | Tillor-Zahlung |
| `invoiceId` | Tillor-Rechnung |
| `customerId` | Tillor-Kunde |
| `paymentGroupId` | Zahlungsgruppe, auch wenn diese Gruppe noch an keiner Rechnung hängt |

## Ingestion-Hinweis: `descriptionSuffix` [#ingestie-hint-descriptionsuffix]

Sie setzen ihn selbst beim Anlegen der Mollie-Zahlung. Tillor verwendet ihn für die Zahlungsbeschreibung, sobald eine Rechnungsverknüpfung besteht.

```json
{
  "tillor": {
    "descriptionSuffix": "Parkeerplaats P1"
  }
}
```

Format in Tillor: `INV/XXXX/XXXX - {suffix}`.

## Ingestion-Hinweise für Zahlungsgruppen [#ingestie-hints-voor-betalingsgroepen]

Praktisch für POS-Schichten oder Aktivitäten: Mehrere Zahlungen bündeln, bevor Sie eine Rechnung buchen.

```json
{
  "tillor": {
    "paymentGroupName": "Yoga sunrise - Lake Como",
    "paymentGroupExternalId": "act_42"
  }
}
```

Eines der beiden Felder genügt. Beide zusammen sind besser, wenn sich die Bezeichnung ändern kann, die ID aber stabil bleibt.

| Feld | Beschreibung |
|------|---------------|
| `paymentGroupName` | Sichtbare Bezeichnung in Tillor. Passt auf bestehende offene Gruppen per Name oder wird die Bezeichnung einer neuen Gruppe |
| `paymentGroupExternalId` | Stabiler Schlüssel aus Ihrem System. Tillor ordnet darüber statt über den Namen zu; die Bezeichnung folgt `paymentGroupName` |

1. Tillor sucht eine **offene** Gruppe mit dieser externen ID (oder, ohne ID, mit diesem Namen).
2. Kein Treffer? Neue offene Gruppe. Der Name ist `paymentGroupName`, sonst `paymentGroupExternalId`.
3. Die Zahlung kommt in die Gruppe, sobald sie in Tillor **bezahlt** ist.
4. Gruppen, die bereits an einer Rechnung hängen, werden nicht wiederverwendet.

Waren die Hinweise noch nicht an der Mollie-Zahlung gesetzt, als Tillor die Zahlung zum ersten Mal sah? Dann wird die Gruppe trotzdem noch befüllt, sobald die Zahlung **bezahlt** ist, **nicht** an einer Rechnung hängt und **noch** in keiner Gruppe ist. Das geschieht bei der nächsten Synchronisierung oder bei einer eingehenden Mollie-Benachrichtigung.

<Callout type="info" title="Wann verwenden?">
Versehen Sie jede Mollie-Zahlung aus Ihrem POS vorab mit den Hinweisen. Die Gruppe erscheint unter *Verwaltung > Zahlungen*, Abschnitt *Zahlungsgruppen*.
</Callout>

<Callout type="warn" title="Nicht mit invoiceId kombinieren">
Eine gruppierte Zahlung kann nicht einzeln an einer Rechnung hängen. Senden Sie sowohl Gruppenhinweise als auch `invoiceId`, gewinnt die Gruppe.
</Callout>

## Direkte Buchhaltungsmetadaten (`tillor.bookkeeping`) [#directe-boekhoudmetadata-tillorbookkeeping]

Unbekannte Mollie-Zahlungen gehen standardmäßig auf das Wartekonto **499000**. Mit `tillor.bookkeeping` bucht Tillor sie auf den angegebenen Kunden:

```json
{
  "tillor": {
    "bookkeeping": {
      "customerCode": "100001",
      "documentType": "INV",
      "department": "a",
      "fiscalYear": "2026",
      "documentNumber": "00042"
    }
  }
}
```

| Feld | Beschreibung |
|------|---------------|
| `customerCode` | Kundencode in der Buchhaltung - Pflichtfeld |
| `documentType` | Z. B. INV, UF |
| `department` | Abteilung |
| `fiscalYear` | Geschäftsjahr |
| `documentNumber` | Belegnummer |

Wenn `bookkeeping` vorhanden ist, kommt die Zahlung **nicht** als gewöhnliche Tillor-Zahlung herein. Die Metadaten werden beim Erstellen des Buchhaltungsberichts verwendet.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Mollie (App)" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Zahlungsgruppen" href="/betalingsverwerking/groepen" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
</Cards>


# MQTT (/de-DE/ontwikkelaars/mqtt)

MQTT-Zugangsdaten geben Integrationen Pub/Sub-Zugriff innerhalb des Topic-Namespace Ihrer Organisation. Die Zugangsdaten legen Sie in Tillor unter **Konto > Entwickler** an (pro Organisation). Der Zugriff auf Topics ist auf `tillor/{env}/{orgId}/integration` und Untertopics beschränkt (`{env}` = `prod`, `staging` oder `local`), es sei denn, eine statische Zugangsdaten-Kombination hat `topicPrefix: null`.

Für dieselben Echtzeit-Events wie bei [Webhooks](/ontwikkelaars/webhooks) und [SSE](/ontwikkelaars/sse) verwenden Sie diese Kanäle, nicht MQTT.

## Verwaltung [#beheer]

| Methode | Pfad | Beschreibung |
|--------|------|---------------|
| POST | `/api/orgs/:orgId/mqtt/credentials` | JWT-Zugangsdaten erzeugen (temporär) |
| GET | `/api/orgs/:orgId/mqtt/static-credentials` | Statische Zugangsdaten abrufen |
| POST | `/api/orgs/:orgId/mqtt/static-credentials` | Statische Zugangsdaten anlegen |
| DELETE | `/api/orgs/:orgId/mqtt/static-credentials/:id` | Statische Zugangsdaten löschen |

Authentifizierung: `x-api-key`, mit der Organisations-ID im Pfad (wie bei der [HTTP API](/ontwikkelaars/http)). Die vollständigen Request- und Response-Schemas finden Sie in der [OpenAPI-Spezifikation](https://tillor.eu/api/openapi.json).

## Zugangsdaten [#credentials]

Es gibt zwei Varianten:

### JWT (temporär) [#jwt-tijdelijk]

- **Verwendung:** Kurze Sitzungen, temporärer Zugriff
- **Ablauf:** Standardmäßig 1 Stunde; über `expiresInSeconds` von 1 Minute bis 24 Stunden einstellbar
- **Ideal für:** Tests, temporäre Verbindungen oder wenn Sie Tokens dynamisch abrufen
- **Anlegen:** In Tillor unter **Konto > Entwickler**, oder über `POST /api/orgs/:orgId/mqtt/credentials` mit optional `{ "clientId": "...", "expiresInSeconds": 3600 }`
- **Response:** `token` (als MQTT-Passwort verwenden), `clientId`, `brokerUrl`, `topicPrefix`, `expiresAt`
- **Benutzername:** Beim Verbinden leer lassen; die JWT-Authentifizierung verwendet nur das Token als Passwort.
- **Client-ID:** Verwenden Sie beim Verbinden genau die `clientId` aus der Response (einschließlich des Umgebungspräfixes, z. B. `prod-`).

Eine Verbindung zum Broker über **mqtts** prüft das Serverzertifikat. Verwenden Sie ein **privates** CA-Zertifikat (nicht die standardmäßige öffentliche Kette), legen Sie die PEM dieser CA in Ihrer Client-Umgebung ab.

### Statische Zugangsdaten [#statische-credentials]

- **Verwendung:** Langlaufende Integrationen, dauerhafte Verbindungen
- **Form:** Fester userName, clientId und password
- **Ideal für:** Produktiv-Integrationen, die dauerhaft verbunden bleiben
- **Anlegen:** In Tillor unter **Konto > Entwickler**, oder über `POST /api/orgs/:orgId/mqtt/static-credentials` mit optional `{ "name": "mijn-integratie", "topicPrefix": null }`
- **Response:** `userName`, `clientId`, `password` (einmalig), `topicPrefix` (`null` = kein Präfix, ACL `#`), optional `brokerUrl`
- **Achtung:** Das Passwort wird nur einmal in der Response angezeigt und kann danach nicht mehr abgerufen werden

---

## Topic-Zugriff [#topic-toegang]

Topic-Subscriptions sind **streng beschränkt**, es sei denn, `topicPrefix` ist `null` (ACL `#`). Standardmäßig können Sie nur auf `tillor/{env}/{orgId}/integration` und `tillor/{env}/{orgId}/integration/#` publizieren und abonnieren.

- **Erlaubte Topics** - Nur `tillor/{env}/{orgId}/integration` und Untertopics (z. B. `tillor/{env}/{orgId}/integration/connector/access-point-operation`)
- **Keine Wildcard-Umgehung** - Auch mit `#` oder `+` erhalten Sie nur Zugriff auf den Namespace Ihrer Organisation
- **Pro Organisation** - Zugangsdaten gelten pro Organisation; Sie haben keinen Zugriff auf Topics anderer Organisationen

---

## Verwandt [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Vollständige API-Spezifikation
- [HTTP API](/ontwikkelaars/http) - REST API und API-Schlüssel
- [Webhooks](/ontwikkelaars/webhooks) - Dieselben Events über HTTP POST
- [SSE](/ontwikkelaars/sse) - Events als Stream über Server-Sent Events


# OAuth-clients (/de-DE/ontwikkelaars/oauth-clients)

Met een OAuth-client meldt een andere applicatie mensen aan met hun Tillor-account. Tillor is daarbij de OpenID Connect-provider: de applicatie stuurt de gebruiker naar Tillor, de gebruiker meldt zich aan en geeft toestemming, en de applicatie krijgt te horen wie het is. Je gebruikt dat voor een eigen applicatie, of voor single sign-on bij een externe dienst die aanmelden via een eigen identiteitsprovider ondersteunt.

Standaard kan elk Tillor-account zich via een client aanmelden. Voor single sign-on bij een externe dienst wil je dat bijna nooit: beperk de client dan tot mensen van je organisatie.

## Wat je nodig hebt [#wat-je-nodig-hebt]

- De **redirect-URI** die de applicatie of dienst opgeeft.
- Wie zich aanmeldt, heeft het recht **OAuth-apps autoriseren** nodig. Zie [OAuth-apps](/gebruikers/organisaties#oauth-apps).
- Om een client tot je organisatie te beperken: het recht **Integraties beheren** in die organisatie.

## Een client aanmaken [#een-client-aanmaken]

<Steps>
<Step>

Klik in de sidebar op je naam en kies <UIPath>Account > OAuth-clients</UIPath>. Klik op **OAuth-client aanmaken**.

</Step>
<Step>

Vul de **Applicatienaam** in en zet elke **Redirect-URI** op een eigen regel. Vink **Publieke client** alleen aan voor een applicatie die geen geheim kan bewaren, zoals een mobiele app.

</Step>
<Step>

Kies wie zich mag aanmelden. Zie [Beperken wie zich mag aanmelden](#beperken-wie-zich-mag-aanmelden).

</Step>
<Step>

Sla op. Tillor toont de **Client-ID** en het **Clientgeheim**. Het geheim zie je alleen nu: kopieer het en bewaar het veilig.

</Step>
</Steps>

In de applicatie of dienst vul je de client-ID, het clientgeheim en het adres van Tillor als provider in: `https://tillor.eu/api/auth`. De meeste diensten lezen de rest zelf uit `https://tillor.eu/api/auth/.well-known/openid-configuration`.

## Beperken wie zich mag aanmelden [#beperken-wie-zich-mag-aanmelden]

Vink **Alleen mensen van (je organisatie) kunnen aanmelden** aan in het venster van de client. De beperking geldt voor de organisatie waarin je op dat moment werkt. Daarna kan je ze verder vernauwen:

| Voorwaarde | Wie voldoet |
|---|---|
| Organisatie (altijd) | Wie lid is van de organisatie |
| **Groepen** (nul of meer) | Wie in **minstens één** van de gekozen [groepen](/gebruikers/groepen) zit |
| **Permissies** (nul of meer) | Wie **alle** gekozen rechten heeft in de organisatie, met de rechten uit groepen meegerekend |

De voorwaarden gelden samen: iemand moet lid zijn, **en** in een van de groepen zitten, **en** alle rechten hebben. Een lege lijst groepen of permissies telt niet mee. Kies je dus geen groepen en geen permissies, dan mag elk lid van de organisatie zich aanmelden.

Een voorbeeld: je kiest de groep "Boekhouding" en het recht om betalingen te bekijken. Alleen wie lid is van je organisatie, in "Boekhouding" zit en betalingen mag bekijken, komt binnen.

De kolom **Wie kan aanmelden** in de lijst van clients toont de beperking van elke client.

<Callout type="info" title="Goed om te weten">
- Kies bij voorkeur **groepen**. Een groep is van jou: je bepaalt zelf wie erin zit. De betekenis van een recht kan in een latere versie van Tillor veranderen, en dan verandert mee wie zich bij de externe dienst kan aanmelden.
- Tillor controleert de voorwaarden bij elke aanmelding en telkens wanneer de applicatie de sessie vernieuwt. Wie de organisatie of de groep verlaat of een recht verliest, krijgt geen nieuwe toegang meer. Toegang die al was uitgereikt, vervalt binnen het uur.
- Voor een beheerder van Tillor zelf gelden dezelfde voorwaarden. Zo iemand is lid van elke organisatie: kies een groep als alleen je eigen mensen binnen mogen.
- Je wijzigt of verwijdert de beperking vanuit de organisatie waarvoor ze geldt. Werk je in een andere organisatie, dan toont het venster alleen voor welke organisatie de client beperkt is.
- Elke wijziging van de beperking en elke geweigerde aanmelding staat in de [activiteitenlog](/activiteitenlog) van de organisatie.
</Callout>

## Problemen? [#problemen]

**Iemand krijgt bij de externe dienst de fout `access_denied`.**
Die persoon voldoet niet aan de voorwaarden van de client. Kijk in de activiteitenlog naar de regel **Toegang geweigerd**: de reden zegt of het om het lidmaatschap, de groep of een recht gaat.

**Iemand ziet op het toestemmingsscherm "Niet beschikbaar voor uw account".**
Zelfde oorzaak: de client is beperkt en dit account voldoet niet. Voeg de persoon toe aan de juiste groep of geef het ontbrekende recht.

**Bij een groep staat "Verwijderde groep".**
De groep bestaat niet meer, en niemand kan er nog in zitten. Was het de enige gekozen groep, dan kan niemand zich aanmelden. Vink ze uit of kies een andere groep.

**Het vakje om te beperken is grijs.**
Je mist het recht **Integraties beheren** in deze organisatie. Vraag het aan een beheerder.

**Na het verlies van een recht blijft iemand nog even aangemeld bij de externe dienst.**
De externe dienst houdt zijn eigen sessie bij. Tillor weigert de volgende vernieuwing; hoe snel de dienst de persoon afmeldt, hangt van die dienst af.


# Server-Sent Events (SSE) (/de-DE/ontwikkelaars/sse)

SSE bietet einen langlaufenden Stream derselben Events, die [Webhooks](/ontwikkelaars/webhooks) erhalten. Verwenden Sie SSE, wenn Sie eine dauerhafte Verbindung HTTP-Callbacks vorziehen.

## Endpunkt [#endpoint]

```
GET /api/orgs/:orgId/realtime/subscribe
```

## Authentifizierung [#authenticatie]

SSE verwendet dieselbe Authentifizierung wie die anderen API-Endpunkte:

- **x-api-key** - Ihr API-Schlüssel

Die Organisations-ID steht im Pfad der URL.

## Event-Filterung [#event-filtering]

Verwenden Sie den Query-Parameter `events`, um nach Event-Typ zu filtern:

```
GET /api/orgs/:orgId/realtime/subscribe?events=invoice:created&events=invoice:paid
```

Verwenden Sie `events=*`, um alle Events zu erhalten (wie wenn Sie den Parameter weglassen).

Alle Events, die Berechtigung pro Event und eine Beispiel-Payload finden Sie im [Event-Index](/ontwikkelaars/events).

Einige Events liegen auf einem eigenen Kanal (Controller-Logs und Controller-I/O). Diese erhalten Sie nur mit `?channel=controller-logs` oder `?channel=controller-io`; der Event-Index nennt den Kanal.

Tillor liefert nur Events, für die das angemeldete Organisationsmitglied die Berechtigung hat. Ohne `bank-transactions:read` (oder Sync) erhalten Sie zum Beispiel keine `bankAccountTransaction:*`-Events, auch nicht, wenn Sie keinen `events`-Filter mitsenden.

Verknüpfte Daten aus einem anderen Bereich folgen denselben Regeln wie die API: Ohne `customers:read` kommt ein `reservation:updated` mit `customer: null` an, ohne `payments:read` ein `invoice:paid` mit `payment: null`. Eine Liste wird dann zu `[]`.

---

## Event-Format [#event-formaat]

Die Payload hat dieselbe Struktur wie [Webhook-Zustellungen](/ontwikkelaars/webhooks#webhook-payload):

| Feld | Typ | Beschreibung |
|------|------|--------------|
| `event` | string | Event-Key (z. B. `invoice:created`) |
| `data` | object | Eventspezifische Payload |
| `timestamp` | number | Unix-Timestamp (ms), zu dem das Event gesendet wurde |
| `traceId` | string | OpenTelemetry-Trace-ID der Tillor-Aktion, die dieses Event ausgelöst hat (wie bei [Webhooks](/ontwikkelaars/webhooks#webhook-payload)) |
| `spanId` | string (optional) | Span innerhalb dieses Traces |

Im SSE-Stream steht dieses JSON-Objekt auf der `data:`-Zeile; der Event-Key steht auch auf der `event:`-Zeile. Ein Beispiel auf Protokollebene finden Sie unter [SSE-Beispiele](/ontwikkelaars/voorbeelden/sse).

---

## Beispiel: Node.js [#voorbeeld-nodejs]

```javascript
const orgId = "org_abc123";
const apiKey = "tkn_xxx";

const url = `https://app.tillor.eu/api/orgs/${orgId}/realtime/subscribe?events=invoice:created&events=customer:updated`;

const response = await fetch(url, {
  headers: {
    "x-api-key": apiKey,
    "Accept": "text/event-stream",
  },
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value, { stream: true });
  for (const line of chunk.split("\n")) {
    if (line.startsWith("data: ")) {
      const payload = JSON.parse(line.slice(6));
      console.log(payload.event, payload.data);
    }
  }
}
```

---

## Beispiel: cURL [#voorbeeld-curl]

```bash
curl -N -H "x-api-key: tkn_xxx" \
     -H "Accept: text/event-stream" \
     "https://app.tillor.eu/api/orgs/org_abc123/realtime/subscribe"
```

---

## Wiederverbinden [#herverbinding]

Wenn die Verbindung abbricht, verbinden Sie sich mit derselben URL und denselben Headern erneut. Der Stream unterstützt kein Wiederaufsetzen; nach dem Wiederverbinden erhalten Sie nur neue Events.

---

## Verwandt [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Vollständige API-Spezifikation
- [HTTP API](/ontwikkelaars/http) - API-Schlüssel und Authentifizierung
- [Webhooks](/ontwikkelaars/webhooks) - Dieselben Events über HTTP POST
- [Beispiele](/ontwikkelaars/voorbeelden) - Code- und Payload-Beispiele


# HTTP-Beispiele (/de-DE/ontwikkelaars/voorbeelden/http)

Öffnungszeiten und Feiertage für eine öffentliche Website: [Öffnungszeiten-API](/ontwikkelaars/voorbeelden/opening-hours).

## API-Request mit cURL [#api-request-met-curl]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/customers" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json"
```

## API-Schlüssel anlegen [#api-sleutel-aanmaken]

```bash
curl -X POST "https://tillor.eu/api/api-keys" \
  -H "Cookie: session=..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Mijn integratie", "description": "Optionele beschrijving"}'
```

## Webhook anlegen [#webhook-aanmaken]

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/webhooks" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://jouw-server.com/webhooks/tillor",
    "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"],
    "enabled": true
  }'
```


# Übersicht (/de-DE/ontwikkelaars/voorbeelden)

Fertige Beispiele für den Einstieg. Jedes Beispiel verwendet die Platzhalter `org_abc123` und `tkn_xxx`; ersetzen Sie sie durch Ihre eigene Organisations-ID und Ihren eigenen API-Schlüssel.

<Cards>
  <Card
    title="HTTP-Beispiele"
    href="/ontwikkelaars/voorbeelden/http"
    description="cURL- und Request-Beispiele für die Tillor API"
  />
  <Card
    title="Öffnungszeiten-API"
    href="/ontwikkelaars/voorbeelden/opening-hours"
    description="Aufgelöste Öffnungszeiten und kommende Feiertage für eine Website abrufen"
  />
  <Card
    title="Webhook-Beispiele"
    href="/ontwikkelaars/voorbeelden/webhooks"
    description="Event-Payloads und Webhook-POST-Beispiele"
  />
  <Card
    title="SSE-Beispiele"
    href="/ontwikkelaars/voorbeelden/sse"
    description="Node.js und cURL für Server-Sent Events"
  />
</Cards>


# Öffnungszeiten-API (/de-DE/ontwikkelaars/voorbeelden/opening-hours)

Verwenden Sie die API für **aufgelöste** Öffnungszeiten, wenn Sie auf einer öffentlichen Website Saisonzeiten (zum Beispiel **Sommer** / **Winter**) oder kommende **Feiertage** anzeigen. Tillor wendet Ausnahmen, Saisonzeiträume und den gewöhnlichen Wochenplan bereits an und fügt gesetzliche Feiertage im angefragten Bereich hinzu. Das müssen Sie nicht selbst nachbauen.

**Berechtigung:** `organization:settings:read` oder `organization:settings:write`

<Callout type="warn" title="API-Schlüssel bleibt serverseitig">
Rufen Sie Tillor nur von einem Server aus auf (Next.js Route Handler, Server Component oder Backend). Legen Sie den Schlüssel in Umgebungsvariablen ab. Senden Sie ihn nie an den Browser.
</Callout>

Authentifizierung: siehe [HTTP API](/ontwikkelaars/http). Probieren Sie den Endpunkt in der [API-Referenz](/api-referentie) oder über [OpenAPI](https://tillor.eu/api/openapi.json) aus (Tag `organization-settings`).

## Endpunkt [#endpoint]

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours
```

Header:

```http
x-api-key: tkn_xxx
```

Ersetzen Sie `org_abc123` durch Ihre Organisations-ID.

### Query-Parameter [#queryparameters]

Verwenden Sie **entweder** `date` **oder** `from`/`to`. Kombinieren Sie sie nicht.

| Parameter | Bedeutung |
|-----------|-----------|
| *(keiner)* | Heute in der Zeitzone der Organisation |
| `date` | Ein Kalendertag (`YYYY-MM-DD`) |
| `from` | Starttag (einschließlich). Ohne `to`: nur dieser Tag |
| `to` | Endtag (einschließlich). Erfordert `from`. Höchstens **366** Tage |
| `languageIsoCode` | Sprache für Feiertagsnamen (`NL`, `FR`, …). Standard: Locale der Organisation |

## Response [#response]

Jedes Element ist ein Kalendertag, bereits aufgelöst:

| Feld | Bedeutung |
|------|-----------|
| `timeZone` | IANA-Zeitzone der Organisation |
| `from` / `to` | Angefragter Bereich |
| `holidays` | Gesetzliche Feiertage, die sich mit `from`–`to` überschneiden |
| `items[].date` | Kalendertag `YYYY-MM-DD` |
| `items[].weekday` | `monday` … `sunday` |
| `items[].source` | `exception`, `period` oder `regular` |
| `items[].periodLabel` | Nur bei `source: "period"`: die Bezeichnung aus Tillor, zum Beispiel `"Zomer"` oder `"Winter"` |
| `items[].holiday` | Nur wenn dieser Tag ein gesetzlicher Feiertag ist: `{ id, name, startDate, endDate }` |
| `items[].blocks` | Zeitfenster in Minuten ab Mitternacht |
| `items[].closed` | `true`, wenn `blocks` leer ist |

Priorität: **Ausnahme** (Feiertag oder benutzerdefinierter Bereich) → letzter passender **Saisonzeitraum** → **gewöhnlicher** Wochenplan.

Saisonbezeichnungen stammen aus *Einstellungen > Öffnungszeiten*. Zeiträume dürfen über den Jahreswechsel laufen (zum Beispiel 1. November bis 31. März). Tage außerhalb jedes Zeitraums fallen auf den gewöhnlichen Wochenplan zurück (`source: "regular"`, kein `periodLabel`).

### Minuten in Uhrzeit [#minuten-naar-kloktijd]

`startMinutes` / `endMinutes` sind Minuten ab 00:00.

| Minuten | Uhrzeit |
|--------:|------|
| 540 | 09:00 |
| 600 | 10:00 |
| 720 | 12:00 |
| 780 | 13:00 |
| 1020 | 17:00 |
| 1140 | 19:00 |

```ts
function formatMinutes(minutes: number): string {
  const hour = Math.floor(minutes / 60);
  const minute = minutes % 60;
  return `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
}
```

## Beispiele [#voorbeelden]

### Tag in einem Saisonzeitraum [#dag-in-een-seizoensperiode]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?date=2026-07-15" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-07-15",
  "to": "2026-07-15",
  "holidays": [],
  "items": [
    {
      "date": "2026-07-15",
      "weekday": "wednesday",
      "source": "period",
      "periodLabel": "Zomer",
      "blocks": [{ "startMinutes": 540, "endMinutes": 720 }],
      "closed": false
    }
  ]
}
```

09:00–12:00, Sommerzeiten.

### Tag außerhalb der Saisonzeiträume [#dag-buiten-seizoensperiodes]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?date=2026-01-15" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-01-15",
  "to": "2026-01-15",
  "holidays": [],
  "items": [
    {
      "date": "2026-01-15",
      "weekday": "thursday",
      "source": "regular",
      "blocks": [
        { "startMinutes": 540, "endMinutes": 720 },
        { "startMinutes": 780, "endMinutes": 1020 }
      ],
      "closed": false
    }
  ]
}
```

09:00–12:00 und 13:00–17:00.

### Bereich über eine Zeitraumgrenze [#range-over-een-periodegrens]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?from=2026-03-30&to=2026-04-02" \
  -H "x-api-key: tkn_xxx"
```

| Datum | `source` | `periodLabel` |
|-------|----------|---------------|
| 2026-03-30 | `regular` | - |
| 2026-03-31 | `regular` | - |
| 2026-04-01 | `period` | `Zomer` |
| 2026-04-02 | `period` | `Zomer` |

## Kommende Feiertage [#komende-feestdagen]

Gesetzliche Feiertage sind in derselben Response enthalten: `holidays` für eine Liste (Name + Daten), `items[].holiday`, wenn dieser Kalendertag ein Feiertag ist. Die Zeiten bleiben der aufgelöste Plan; ein Feiertag ohne eingetragene Ausnahme in Tillor folgt dem Saison- oder Wochenplan (`source` ist dann nicht `"exception"`).

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?from=2026-08-27&to=2026-12-31&languageIsoCode=NL" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-08-27",
  "to": "2026-12-31",
  "holidays": [
    {
      "id": "0fad0035-6b77-404a-953d-c66dac014483",
      "name": "Allerheiligen",
      "startDate": "2026-11-01",
      "endDate": "2026-11-01"
    },
    {
      "id": "d90e5f53-bc92-4860-bdae-f7e75935848d",
      "name": "Kerstmis",
      "startDate": "2026-12-25",
      "endDate": "2026-12-25"
    }
  ],
  "items": [
    {
      "date": "2026-11-01",
      "weekday": "sunday",
      "source": "regular",
      "holiday": {
        "id": "0fad0035-6b77-404a-953d-c66dac014483",
        "name": "Allerheiligen",
        "startDate": "2026-11-01",
        "endDate": "2026-11-01"
      },
      "blocks": [],
      "closed": true
    }
  ]
}
```

Das `items`-Beispiel oben ist gekürzt; die echte Response enthält jeden Tag im Bereich. Schulferien sind in diesem Endpunkt nicht enthalten; dafür bleibt `GET /holidays?kind=school`.

## Next.js (Server) [#nextjs-server]

Für ein Wochen-Widget oder „jetzt geöffnet“ auf einer öffentlichen Website:

```ts
const TILLOR_API_URL = "https://tillor.eu";
const ORGANIZATION_ID = process.env.TILLOR_ORG_ID ?? "";

type OpeningHoursBlock = {
  startMinutes: number;
  endMinutes: number;
};

type OpeningHoursHoliday = {
  id: string;
  name: string;
  startDate: string;
  endDate: string;
};

type OpeningHoursItem = {
  date: string;
  weekday: string;
  source: "exception" | "period" | "regular";
  periodLabel?: string;
  holiday?: OpeningHoursHoliday;
  blocks: OpeningHoursBlock[];
  closed: boolean;
};

type OpeningHoursResponse = {
  timeZone: string;
  from: string;
  to: string;
  holidays: OpeningHoursHoliday[];
  items: OpeningHoursItem[];
};

export async function getOpeningHours(
  from: string,
  to: string,
): Promise<OpeningHoursResponse> {
  const url = new URL(
    `${TILLOR_API_URL}/api/orgs/${ORGANIZATION_ID}/organization-settings/opening-hours`,
  );
  url.searchParams.set("from", from);
  url.searchParams.set("to", to);
  url.searchParams.set("languageIsoCode", "NL");

  const response = await fetch(url, {
    headers: {
      "x-api-key": process.env.TILLOR_API_KEY ?? "",
    },
    next: { tags: ["opening-hours"], revalidate: 3600 },
  });

  if (!response.ok) {
    throw new Error(`Tillor opening hours ${response.status}`);
  }

  return response.json() as Promise<OpeningHoursResponse>;
}
```

`holidays` ist die Liste für einen Block „Kommende Feiertage“. `items[].holiday` ist in einem Wochenkalender praktisch. `items[].periodLabel` ist der Saisontext (zum Beispiel `"Zomer"` oder `"Winter"`). Ein Cache von 1 Stunde reicht meistens aus.

## Cache ungültig machen (Webhook) [#cache-ongeldig-maken-webhook]

Bei jeder Änderung der Organisationseinstellungen sendet Tillor `organizationSettings:updated` (Webhook und SSE). Abonnieren Sie es und rufen Sie die Öffnungszeiten erneut ab. Die Payload ist absichtlich klein (keine Drucker-IPs oder der vollständige Plan):

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

`openingHoursChanged` ist `true`, wenn sich der Öffnungszeitenplan, die Zeitzone oder das Standardland ändert - das beeinflusst `GET .../opening-hours`. Bei `false` können Sie den Öffnungszeiten-Cache stehen lassen.

Beispiel Next.js Route Handler:

```ts
import { revalidateTag } from "next/cache";

export async function POST(request: Request) {
  const body = (await request.json()) as {
    event?: string;
    data?: { openingHoursChanged?: boolean };
  };
  if (body.event === "organizationSettings:updated" && body.data?.openingHoursChanged) {
    await revalidateTag("opening-hours");
  }
  return new Response(null, { status: 204 });
}
```

Webhook anlegen: siehe [Webhooks](/ontwikkelaars/webhooks). Event-Key: `organizationSettings:updated` (Berechtigung `organization:settings:read` oder `organization:settings:write`).

## Vollständiger Plan (optional) [#volledig-rooster-optioneel]

Nur nötig, wenn Sie den Saisonkalender selbst anzeigen möchten (Bezeichnungen + `fromMonth`/`untilDay`), ohne pro Tag aufzulösen:

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings
```

Lesen Sie `openingHoursSchedule.periods` (Bezeichnungen wie `"Zomer"`) und `openingHoursSchedule.weekdays` (gewöhnlicher Plan). Für die Website selbst bleibt `GET .../opening-hours` die einfachste Quelle.

## MCP [#mcp]

In Cursor oder Claude: Endpunkt `organizationSettings_listOpeningHours` (Kategorie `organizationSettings`), Argumente `organizationId`, optional `date` oder `from`/`to`, optional `languageIsoCode`.

## Verwandt [#gerelateerd]

- [HTTP API](/ontwikkelaars/http) - Authentifizierung und Header
- [HTTP-Beispiele](/ontwikkelaars/voorbeelden/http) - Allgemeine cURL-Beispiele
- [Webhooks](/ontwikkelaars/webhooks) - `organizationSettings:updated` zur Cache-Revalidierung
- [Organisationseinstellungen](/gebruikers/organisaties) - Öffnungszeiten in Tillor einstellen


# SSE-Beispiele (/de-DE/ontwikkelaars/voorbeelden/sse)

## cURL [#curl]

```bash
curl -N -H "x-api-key: tkn_xxx" \
     "https://app.tillor.eu/api/orgs/org_abc123/realtime/subscribe"
```

## Node.js [#nodejs]

```javascript
const orgId = "org_abc123";
const apiKey = "tkn_xxx";

const url = `https://app.tillor.eu/api/orgs/${orgId}/realtime/subscribe?events=invoice:created&events=customer:updated`;

const response = await fetch(url, {
  headers: {
    "x-api-key": apiKey,
    "Accept": "text/event-stream",
  },
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value, { stream: true });
  for (const line of chunk.split("\n")) {
    if (line.startsWith("data: ")) {
      const payload = JSON.parse(line.slice(6));
      console.log(payload.event, payload.data);
    }
  }
}
```

## SSE-Nachricht [#sse-bericht]

Eine SSE-Nachricht (`text/event-stream`) sieht so aus:

```
event: message
data: {"event":"invoice:paid","data":{"invoice":{"id":"inv_def456uvw","displayId":"2025-00123","status":"BOOKED","paymentStatus":"PAID","amountTotal":200,"paidDate":"2025-03-09T12:15:00.000Z","customerId":"cust_abc123xyz"},"payment":{"id":"pay_ghi789rst","amount":200,"status":"PAID","method":"BANCONTACT","provider":"MOLLIE","paidAt":"2025-03-09T12:15:00.000Z"}},"timestamp":1735811700000}

```

Die SSE-`event`-Zeile lautet `message`. Parsen Sie die `data`-Zeile als JSON: Darin stehen das Tillor-Event (`event`), die Payload (`data`) und `timestamp` (ms). Dasselbe JSON-Objekt erhalten Sie über [Webhooks](/ontwikkelaars/webhooks).


# Webhook-Beispiele (/de-DE/ontwikkelaars/voorbeelden/webhooks)

Dieselben Events wie bei [SSE](/ontwikkelaars/voorbeelden/sse). Die Payload-Struktur ist identisch.

## Wrapper-Struktur [#wrapper-structuur]

```json
{
  "event": "entity:action",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

`traceId` gehört zur Tillor-Aktion, die das Event ausgelöst hat (z. B. ein API-Aufruf oder eine interne Verarbeitung), nicht zu einem späteren Webhook-Retry.

## Webhook-POST-Beispiel [#webhook-post-voorbeeld]

Ein vollständiger Webhook-POST-Request sieht so aus:

```http
POST /webhooks/tillor HTTP/1.1
Host: your-server.com
Content-Type: application/json

{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "inv_def456uvw",
      "displayId": "2025-00123",
      "status": "BOOKED",
      "paymentStatus": "PAID",
      "amountTotal": 200.0,
      "paidDate": "2025-03-09T12:15:00.000Z",
      "customerId": "cust_abc123xyz"
    },
    "payment": {
      "id": "pay_ghi789rst",
      "amount": 200.0,
      "status": "PAID",
      "method": "BANCONTACT",
      "channel": "ONLINE",
      "provider": "MOLLIE",
      "paidAt": "2025-03-09T12:15:00.000Z"
    }
  },
  "timestamp": 1735811700000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

## Event-Payloads [#event-payloads]

### customer:created [#customercreated]

```json
{
  "event": "customer:created",
  "data": {
    "id": "cust_abc123xyz",
    "displayId": 1042,
    "firstName": "Jan",
    "lastName": "Jansen",
    "email": "jan.jansen@voorbeeld.nl",
    "phone": "+31612345678",
    "address": "Hoofdstraat 42",
    "city": "Amsterdam",
    "zipCode": "1012 AB",
    "country": "NL",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "createdAt": "2025-03-09T10:30:00.000Z",
    "updatedAt": "2025-03-09T10:30:00.000Z"
  },
  "timestamp": 1735806600000
}
```

### invoice:paid [#invoicepaid]

```json
{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "inv_def456uvw",
      "displayId": "2025-00123",
      "status": "BOOKED",
      "paymentStatus": "PAID",
      "amountTotal": 200.0,
      "paidDate": "2025-03-09T12:15:00.000Z",
      "customerId": "cust_abc123xyz"
    },
    "payment": {
      "id": "pay_ghi789rst",
      "amount": 200.0,
      "status": "PAID",
      "method": "BANCONTACT",
      "channel": "ONLINE",
      "provider": "MOLLIE",
      "paidAt": "2025-03-09T12:15:00.000Z"
    }
  },
  "timestamp": 1735811700000
}
```

### controller:adoption:requested [#controlleradoptionrequested]

```json
{
  "event": "controller:adoption:requested",
  "data": {
    "adoptionId": "adopt_jkl012mno",
    "efuseId": "a1b2c3d4e5f6",
    "requestedFromIp": "192.168.1.42",
    "isNew": true
  },
  "timestamp": 1735809000000
}
```

### nfc-tag:presented [#nfc-tagpresented]

```json
{
  "event": "nfc-tag:presented",
  "data": {
    "id": "nfc_123abc456",
    "uid": "04A1B2C3D4E5F6",
    "type": "CARD",
    "balance": 25.5,
    "blockedAt": null,
    "customerId": "cust_abc123xyz"
  },
  "timestamp": 1735807500000
}
```

### organizationSettings:updated [#organizationsettingsupdated]

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

Unter [Öffnungszeiten-API](/ontwikkelaars/voorbeelden/opening-hours) finden Sie die Cache-Revalidierung auf einer öffentlichen Website.

## Enums [#enums]

| Entity | Enum | Werte |
|--------|------|---------|
| Customer | `customerType` | `STANDARD`, `WORKER_RENTAL_CARAVAN`, `WORKER_TOWING_CARAVAN` |
| Invoice | `status` | `DRAFT`, `BOOKED` |
| Invoice | `paymentStatus` | `UNPAID`, `PARTIALLY_PAID`, `PENDING`, `PAID` |
| Payment | `status` | `PENDING`, `AUTHORIZED`, `PAID`, `CANCELED`, `FAILED`, `EXPIRED`, `REFUNDED`, `PARTIALLY_REFUNDED`, `CHARGED_BACK` |
| Payment | `method` | `UNKNOWN`, `BANCONTACT`, `IDEAL`, `CREDITCARD`, `CASH`, … (vollständige Liste in OpenAPI) |
| Payment | `channel` | `MANUAL`, `BANK_TRANSFER`, `TERMINAL`, `ONLINE`, `MANDATE` |
| Payment | `provider` | `MOLLIE`, `MANUAL`, `PONTO` |
| Controller | `type` | `ACCESS`, `SHOWER`, `CHARGE_POINT` |
| NfcTag | `type` | `CARD`, `BRACELET`, `STICKER`, `KEY_FOB` |


# Webhooks (/de-DE/ontwikkelaars/webhooks)

Webhooks erhalten Echtzeit-Events per HTTP POST an eine von Ihnen konfigurierte URL. Dieselben Events sind auch über [SSE](/ontwikkelaars/sse) verfügbar. Webhooks werden **pro Organisation** konfiguriert - jede Organisation hat ihre eigenen Webhooks.

## Verwaltung [#beheer]

Die vollständigen Request- und Response-Schemas finden Sie in der [OpenAPI-Spezifikation](https://tillor.eu/api/openapi.json).

| Methode | Pfad | Beschreibung |
|--------|------|-------------|
| GET | `/api/orgs/:orgId/webhooks` | Webhooks abrufen |
| GET | `/api/orgs/:orgId/webhooks/delivery-stats` | Zustellungsstatistiken abrufen |
| POST | `/api/orgs/:orgId/webhooks/retry-deliveries` | Zustellungen erneut versuchen. Body: `mode` (`failed` oder `force`) und optional `id` für einen einzelnen Webhook. `failed`: nur endgültig fehlgeschlagene Zustellungen, sofort. `force`: wartende und endgültig fehlgeschlagene Zustellungen im Hintergrund, ignoriert Wartezeiten. |
| GET | `/api/orgs/:orgId/webhooks/:id` | Webhook anhand der ID abrufen |
| POST | `/api/orgs/:orgId/webhooks` | Webhook anlegen |
| PATCH | `/api/orgs/:orgId/webhooks/:id` | Webhook aktualisieren |
| DELETE | `/api/orgs/:orgId/webhooks/:id` | Webhook löschen |

## Webhook anlegen [#webhook-aanmaken]

```http
POST /api/orgs/org_abc123/webhooks
Content-Type: application/json
x-api-key: tkn_xxx
```

```json
{
  "url": "https://jouw-server.com/webhooks/tillor",
  "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"],
  "enabled": true
}
```

- **url** - HTTPS-Endpunkt, der POST-Requests akzeptiert
- **subscribedEventKeys** - Array von Event-Keys oder `["*"]` für alle Events. Die vollständige Liste finden Sie in Tillor unter **Profilmenü → Entwickler** bei **Webhook hinzufügen** → **Abonnierte Ereignisse**.

Einige Events kommen so häufig vor, dass Sie sie nicht auswählen können und dass sie auch nicht über `*` ankommen, etwa der physische Zustand von Schranken, das Tippen im Posteingang, Controller-Logs und Fahrzeuganwesenheit. Diese stehen nicht in der Liste unten. Welche Events Sie auswählen können, hängt auch von Ihren Berechtigungen ab.
- **enabled** - `true`, um die Zustellung einzuschalten

Sie dürfen nur Events auswählen, für die Ihr Organisationsmitglied die passende Berechtigung hat (z. B. Banktransaktionen für `bankAccountTransaction:*`). Der Wildcard `*` ist nur für Mitglieder mit vollem Zugriff (`*`) verfügbar. Bei einer ungültigen Kombination gibt die API eine Fehlermeldung zurück. Ein Webhook leitet die vollständige Payload weiter, mit den verknüpften Daten (wie dem Kunden bei einer Reservierung). Daher müssen Sie auch diese Bereiche lesen dürfen, um einen Webhook anzulegen, die URL oder Events zu ändern oder ihn wieder einzuschalten.

---

## Webhook-Payload [#webhook-payload]

Jede Webhook-Zustellung ist ein POST mit:

**Header:**
- `Content-Type: application/json`
- `X-Webhook-Event-ID` - stabile eindeutige ID dieser logischen Zustellung (gleicher Wert bei Retries)
- `X-Webhook-Signature` - HMAC-SHA256-Signatur des Body, Format `sha256=<hex>` (siehe [Signatur verifizieren](#handtekening-verifiëren))

**Body:**

```json
{
  "event": "invoice:created",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7",
  "triggeredBy": {
    "id": "usr_63x8jp68is",
    "name": "Niels"
  }
}
```

| Feld | Typ | Beschreibung |
|------|------|--------------|
| `event` | string | Event-Key (z. B. `invoice:created`) |
| `data` | object | Eventspezifische Payload |
| `timestamp` | number | Unix-Timestamp (ms), zu dem das Event gesendet wurde |
| `traceId` | string | OpenTelemetry-Trace-ID der Tillor-Aktion, die dieses Event ausgelöst hat. Geben Sie sie beim Support an; sie ist kein Geheimnis. |
| `spanId` | string (optional) | Span innerhalb dieses Traces |
| `triggeredBy` | object \| null | Benutzer, der die Aktion ausgeführt hat (`id`, `name`). `null` bei Systemaktionen (Cron, Bank-Sync, …) |

Vollständige Payload-Beispiele finden Sie unter [Beispiele](/ontwikkelaars/voorbeelden).

---

## Signatur verifizieren [#handtekening-verifiëren]

Jeder Webhook hat ein eigenes **Signing Secret** (64 Hex-Zeichen, in der Webhook-Tabelle über **Signaturgeheimnis anzeigen** unter *Profilmenü → Entwickler* sichtbar). Tillor signiert jeden POST mit diesem Secret, damit Sie prüfen können, dass die Anfrage wirklich von Tillor kommt und der Body nicht verändert wurde.

**So signiert Tillor:**

1. Berechnen Sie `HMAC-SHA256(signingSecret, raw_request_body)` (Hex in Kleinbuchstaben).
2. Senden Sie das als `X-Webhook-Signature: sha256=<hex>`.

**So verifizieren Sie:**

1. Lesen Sie den **rohen** Request-Body (vor dem JSON-Parsen - sonst passt der Hash nicht).
2. Berechnen Sie selbst `HMAC-SHA256(signingSecret, raw_body)` in Hex.
3. Vergleichen Sie mit dem Wert hinter `sha256=` aus dem Header `X-Webhook-Signature` mit einem **Constant-Time**-Vergleich.

```js
import crypto from "node:crypto";

function verifyTillorWebhook(rawBody, headerSignature, signingSecret) {
  const expected = crypto.createHmac("sha256", signingSecret).update(rawBody).digest("hex");
  const received = headerSignature.replace(/^sha256=/, "");
  const a = Buffer.from(expected, "hex");
  const b = Buffer.from(received, "hex");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}
```

<Callout type="warn" title="Behandeln Sie das Secret wie ein Passwort">
Das Signing Secret können Sie in Tillor in der Webhook-Tabelle über **Signaturgeheimnis anzeigen** einblenden. Speichern Sie es als Secret (Umgebungsvariable, Vault) und protokollieren Sie es nie. Vermuten Sie ein Leck? Löschen Sie den Webhook und legen Sie einen neuen an; damit erhalten Sie ein neues Secret.
</Callout>

---

## Zustellverhalten und Retries [#leveringsgedrag-en-retries]

- Antworten Sie mit einem **2xx-Status**, um den Erfolg zu bestätigen.
- Bei einer fehlgeschlagenen Zustellung (nicht-2xx, Netzwerkfehler oder blockiertes Ziel) versucht Tillor die Zustellung automatisch erneut, mit immer längeren Abständen. Jeder Versuch verwendet dieselbe Payload, dieselbe Signatur und dieselbe Event-ID (idempotent).

| Versuch | Wartezeit seit dem vorigen Versuch |
|---|---|
| 1 | sofort |
| 2 | 1 Sekunde |
| 3 | 2 Sekunden |
| 4 | 4 Sekunden |
| 5 | 8 Sekunden |
| 6 | 5 Minuten |
| 7 | 30 Minuten |
| 8 | 2 Stunden |
| 9 | 6 Stunden |
| 10 | 24 Stunden |

- Gelingt einer der Versuche (2xx) → die Zustellung ist abgeschlossen.
- Gelingt auch Versuch 10 (nach 24 Std.) nicht → die Zustellung wird **endgültig als fehlgeschlagen markiert** und nicht weiter versucht.
- Wird der Webhook zwischenzeitlich **ausgeschaltet**, hört Tillor mit den erneuten Versuchen auf.

```mermaid
flowchart TD
  A[Event gesendet] --> B[Zustellung an Ihren Endpunkt]
  B -- 2xx --> Z[Abgeschlossen]
  B -- fehlgeschlagen --> C[Erneut versucht<br/>1s, 2s, 4s, 8s,<br/>5m, 30m, 2h, 6h, 24h]
  C -- 2xx --> Z
  C -- alle Versuche fehlgeschlagen --> F[Endgültig fehlgeschlagen]
```

<Callout type="info" title="Idempotenz">
Jeder Retry verwendet dieselbe `X-Webhook-Event-ID` und dieselbe `X-Webhook-Signature`. Deduplizieren Sie auf Ihrer Seite anhand dieses Headers, damit ein erfolgreicher Retry nach einem langsamen 200 keine doppelte Verarbeitung auslöst.
</Callout>

### Benachrichtigungen bei anhaltenden Fehlern [#meldingen-bij-aanhoudende-fouten]

Schlagen Zustellungen an einen Webhook-Endpunkt weiter fehl, sendet Tillor **höchstens zwei Benachrichtigungen pro Vorfall** (pro Endpunkt):

1. **Nach 5 Minuten anhaltender Fehler** - E-Mail an die E-Mail-Adresse der Organisation (`supportEmail`, sonst `email`) und an Organisationsmitglieder mit Rechten zum Ändern der Organisationseinstellungen, plus Push (falls aktiviert) für diese Mitglieder. Die E-Mail nennt, seit wann die Zustellungen fehlschlagen. Datumsangaben in der E-Mail verwenden die **Zeitzone** aus *Einstellungen > Allgemein* (Standard `Europe/Brussels`).
2. **Bei endgültigem Fehlschlag** - dieselben Empfänger erhalten eine Benachrichtigung, wenn das erste Event in diesem Vorfall nach allen Versuchen endgültig als fehlgeschlagen markiert wurde.

Sie erhalten **keine** Benachrichtigung pro fehlgeschlagenem Event. Sobald alle fehlgeschlagenen Zustellungen für einen Endpunkt behoben sind (erfolgreich zugestellt), beginnt ein nächster Vorfall erneut mit denselben Regeln.

Unter **Profilmenü → Entwickler** zeigt die Webhook-Tabelle pro Endpunkt einen kompakten Zustellstatus (Anzahl wartend auf erneuten Versuch und endgültig fehlgeschlagen). Klicken Sie auf das **ℹ**-Symbol für Details, einschließlich der vollständigen Fehlermeldung und der Payload des letzten Versuchs.

- **Fehlgeschlagene erneut versuchen** (↻): nur endgültig fehlgeschlagene Zustellungen für diesen Webhook.
- **Erneuten Versuch erzwingen** (⚡): alle wartenden und endgültig fehlgeschlagenen Zustellungen für diesen Webhook, unabhängig von geplanten Wartezeiten. Tillor startet dies im Hintergrund, damit große Warteschlangen (z. B. Tausende Events) sicher verarbeitet werden.
- **Alle erzwingen** oben rechts neben **Webhook hinzufügen**: dasselbe für alle eingeschalteten Webhooks der Organisation.

---

## Event-Typen [#event-types]

Event-Keys verwenden das Format `entity:action` oder `entity:subresource:action`. Die vollständige Liste, mit der Berechtigung pro Event und einer Beispiel-Payload, steht im [Event-Index](/ontwikkelaars/events). Diese Seite wird aus dem Code generiert und ist daher immer vollständig. Dieselben Keys stehen in Tillor unter [Profilmenü → Entwickler](https://tillor.eu/orgs/org_abc123/developers) bei **Webhook hinzufügen** → **Abonnierte Ereignisse**.


---

## Webhooks vs. SSE [#webhooks-vs-sse]

| Anwendungsfall | Empfehlung |
|----------|-------------|
| Serverseitige Integration | **Webhooks** - Ihr Server empfängt POSTs |
| Einfaches Logging | **Webhooks** - Minimaler Aufbau |
| Echtzeit-Dashboard, Live-Updates in der App | [SSE](/ontwikkelaars/sse) - Eine Verbindung, geringe Latenz. |
| Viele Event-Typen, clientseitig filtern | [SSE](/ontwikkelaars/sse) - Verwenden Sie den Query-Parameter `events`, um den Verkehr zu begrenzen. |

---

## Verwandt [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Vollständige API-Spezifikation
- [HTTP API](/ontwikkelaars/http) - REST API und API-Schlüssel
- [SSE](/ontwikkelaars/sse) - Dieselben Events über Server-Sent Events
- [Automatisierungen](/ontwikkelaars/automatiseringen) - Eigene Nachrichten aus einer Automatisierung versenden


# Website-Chat-API (/de-DE/ontwikkelaars/website-chat)

Das offizielle Widget installieren Sie in der App: siehe [Den Chat auf Ihrer Website einbinden](/inbox/website-chat). Die Optionen des Snippets stehen unter [Einstellungen des Website-Chats](/inbox/website-chat-instellingen). Diese Seite richtet sich an Entwickler: das Widget-SDK für ein eigenes Formular und die REST-Schicht für eine **eigene Chat-Oberfläche**. Siehe [OpenAPI](https://tillor.eu/api/openapi.json), Tag `inbox`.

## Widget-SDK [#widget-sdk]

Nach dem Laden des Widget-Skripts steht `window.TillorInbox` bereit. Damit übergeben Sie Kontaktdaten aus Ihrem eigenen Formular (Kontaktseite, Verkaufsdetail, Angebotsanfrage). Alle Methoden warten, bis die Widget-Konfiguration geladen ist.

| Methode | Beschreibung |
|---------|--------------|
| `ready()` | Promise, die erfüllt ist, sobald das Widget geladen ist |
| `getVisitor()` | Liest gespeicherte Kontaktdaten aus `localStorage` und ausgefüllte Widget-Felder; synchron, kein Netzwerk |
| `setVisitor({ name?, firstName?, lastName?, email?, phone?, message?, customFields? }, options?)` | Füllt Chat-Felder aus, ohne zu senden |
| `open()` | Öffnet das Chatfenster |
| `close()` | Schließt das Chatfenster |
| `toggle()` | Öffnet oder schließt das Chatfenster |
| `send({ body, name?, firstName?, lastName?, email?, phone?, message?, customFields?, open?, silent?, markSubmitted?, metadata? })` | Sendet eine Nachricht mit Kontaktdaten |

`getVisitor()` gibt dieses Objekt zurück:

| Feld | Beschreibung |
|------|--------------|
| `visitorId` | ID dieses Besuchers in diesem Browser (`localStorage`) |
| `name` | Vollständiger Name (ein Feld im Widget) |
| `firstName` / `lastName` | Abgeleitet aus `name` (erstes Wort / Rest) |
| `email`, `phone` | Kontaktdaten |
| `customFields` | Zusätzliche Felder aus den Widget-Einstellungen |
| `message` | Entwurf im Nachrichtenfeld |
| `detailsSubmitted` | Ob das Besucherformular als ausgefüllt gilt |

Verwenden Sie `getVisitor()`, um ein eigenes Formular aus `localStorage` vorab auszufüllen (gleicher Browser, auch nach einem Neuladen der Seite).

Optionen für `setVisitor` (zweites Argument):

| Option | Standard | Erklärung |
|-------|-----------|--------|
| `open` | `false` | Chatfenster sofort öffnen |
| `markSubmitted` | `false` | Besucherformular ausblenden, wenn alle Pflichtfelder ausgefüllt sind |
| `onlyEmpty` | `false` | Nur leere Felder überschreiben |
| `persist` | `false` | Daten in `localStorage` speichern (gleicher Browser, auch nach einem neuen Tab) |

Optionen für `send`:

| Option | Standard | Erklärung |
|-------|-----------|--------|
| `open` | `false` | Chatfenster vor dem Senden öffnen |
| `silent` | `true`, wenn `open` false ist | Kein Ton, keine Fehlermeldung im Widget; verwenden Sie die Promise für Erfolg oder Fehler |
| `markSubmitted` | `true` | Kontaktdaten müssen danach nicht erneut im Widget eingegeben werden |
| `metadata` | - | Optionale Hinweise für Tillie (im Chatfenster nicht sichtbar); siehe [metadata](#metadata-boekingsformulier) |

Mit `open: false` (Standard) bleibt die Chat-Schaltfläche geschlossen. Die Nachricht geht trotzdem an Tillor; Ihr eigenes Formular kann sich bedanken oder einen Fehler anzeigen. Mit `open: true` öffnet sich das Chatfenster, und der Besucher sieht das normale Sendeverhalten (Ton, Häkchen, eventuelle Widget-Fehler).

Möchten Sie statt der schwebenden Chat-Schaltfläche eine eigene Schaltfläche verwenden? Setzen Sie `data-launcher="false"` auf das Snippet und rufen Sie `TillorInbox.open()` auf.

### `metadata` (Buchungsformular) [#metadata-boekingsformulier]

Verwenden Sie `metadata`, wenn Sie ein eigenes Formular auf der Website haben und Tillie **nur eine Bestätigung** senden soll, ohne Rückfragen (zum Beispiel, weil der Tab danach schließt).

| Schlüssel | Typ | Erklärung |
|---------|------|--------|
| `forceHandover` | `boolean` | Bestätigungsnachricht und Übergabe an einen Kollegen, ohne Aufnahmefragen. Ignoriert auch die KI-Pause nach einer Teamnachricht (siehe `ignoreAiPause`) |
| `ignoreAiPause` | `boolean` | Tillie antwortet auch dann, wenn sie im Modus **Automatisch** nach einer Teamnachricht pausiert ist (30 Minuten). Praktisch für stilles Absenden von Formularen; kombinieren Sie es mit `forceHandover` oder lassen Sie Tillie normal die Aufnahme machen |
| `handoverIntent` | `"reservation"` \| `"caravan_rental"` \| `"sale"` \| `"other"` | Optional: Ablauf für die Übergabe (Standard: automatisch aus der Nachricht ableiten) |
| `source` | `string` | Optionale Integrationsbezeichnung für Ihr Team (Kleinbuchstaben, Ziffern, `-`, `_`; max. 64 Zeichen) |

```javascript
await TillorInbox.send({
  name: "Jan Janssens",
  email: "jan@voorbeeld.be",
  phone: "+32 3 779 81 64",
  body: structuredBookingMessage,
  silent: true,
  metadata: {
    forceHandover: true,
    handoverIntent: "reservation",
    source: "website_booking_form",
  },
});
```

### Kontaktformular ersetzen (stilles Senden) [#contactformulier-vervangen-stille-verzending]

Verwenden Sie dies, wenn Sie das bestehende Kontaktformular behalten, die Nachrichten aber über Tillor laufen lassen möchten, ohne das Chatfenster zu öffnen.

```html
<form id="site-contact-form">
  <input name="name" type="text" required />
  <input name="email" type="email" required />
  <input name="phone" type="tel" />
  <textarea name="message" required></textarea>
  <button type="submit">Verstuur</button>
  <p id="contact-status" hidden></p>
</form>

<script>
  document.getElementById("site-contact-form").addEventListener("submit", async (event) => {
    event.preventDefault();
    const form = event.currentTarget;
    const status = document.getElementById("contact-status");
    const data = new FormData(form);

    try {
      await TillorInbox.send({
        name: String(data.get("name") ?? ""),
        email: String(data.get("email") ?? ""),
        phone: String(data.get("phone") ?? ""),
        body: String(data.get("message") ?? ""),
      });
      status.textContent = "Bedankt, we nemen snel contact op.";
      status.hidden = false;
      form.reset();
    } catch (error) {
      status.textContent = error instanceof Error ? error.message : "Versturen mislukt.";
      status.hidden = false;
    }
  });
</script>
```

`open` und `silent` müssen Sie nicht setzen: Ohne `open: true` bleibt das Fenster geschlossen, und Tillor behandelt den Aufruf als stilles Senden.

### Kontaktformular verbinden (Chat öffnen) [#contactformulier-koppelen-chat-openen]

Felder übergeben und das Chatfenster öffnen, damit der Besucher das Gespräch sieht:

```html
<form id="site-contact-form">
  <input name="name" type="text" required />
  <input name="email" type="email" required />
  <input name="phone" type="tel" />
  <textarea name="message" required></textarea>
  <button type="submit">Verstuur</button>
</form>

<script>
  document.getElementById("site-contact-form").addEventListener("submit", (event) => {
    event.preventDefault();
    const form = event.currentTarget;
    const data = new FormData(form);
    void TillorInbox.send({
      name: String(data.get("name") ?? ""),
      email: String(data.get("email") ?? ""),
      phone: String(data.get("phone") ?? ""),
      body: String(data.get("message") ?? ""),
      open: true,
    });
  });
</script>
```

Oder nur Felder ausfüllen und das Fenster öffnen, ohne sofort zu senden:

```javascript
void TillorInbox.setVisitor(
  {
    name: "Jan Janssens",
    email: "jan@voorbeeld.be",
    phone: "+32 3 779 81 64",
    message: "Ik heb een vraag over de stacaravan te koop.",
  },
  { markSubmitted: true, open: true },
);
```

Eine Verkaufsseite mit sofortigem Senden und Öffnen des Chats:

```javascript
void TillorInbox.send({
  name: "Jan Janssens",
  email: "jan@voorbeeld.be",
  phone: "+32 3 779 81 64",
  body: "Ik heb interesse in deze stacaravan.",
  open: true,
});
```

Live synchronisieren, während jemand tippt:

```javascript
const form = document.getElementById("site-contact-form");
form.addEventListener("input", () => {
  void TillorInbox.setVisitor({
    name: form.name.value,
    email: form.email.value,
    phone: form.phone.value,
    message: form.message.value,
  });
});
```

### Früh aufrufen (vor dem Widget-Skript) [#vroeg-aanroepen-vóór-het-widget-script]

Rufen Sie eine Methode auf, bevor das Skript geladen ist, stellen Sie den Aufruf in die Warteschlange:

```html
<script>
  window.TillorInbox = window.TillorInbox || { q: [] };
  window.TillorInbox.q.push([
    "setVisitor",
    { name: "Jan", email: "jan@voorbeeld.be" },
    { open: true },
  ]);
</script>
<script src="https://tillor.eu/inbox-widget.js" data-org-id="org_abc123" data-widget-key="iwk_xxx" async defer></script>
```

## Eigene Chat-Oberfläche [#eigen-chat-ui]

Bauen Sie eine eigene Chat-Oberfläche statt des Widgets, verwenden Sie die REST-Schicht unten.

Authentifizierung: Header `X-Tillor-Inbox-Widget-Key` (Wert aus *Einstellungen > Integrationen > Website-Chat*).

### Tippen [#typen]

```http
POST /api/orgs/{orgId}/inbox/website/typing
X-Tillor-Inbox-Widget-Key: iwk_xxx
Content-Type: application/json

{
  "visitorId": "vis_…",
  "active": true,
  "visitorName": "Jan",
  "visitorEmail": "jan@voorbeeld.nl",
  "visitorPhone": "+32470123456"
}
```

- `active: true`, wenn der Besucher tippt; `false`, wenn das Feld leer ist oder der Besucher aufhört (das Widget sendet `false` nach etwa 4 Sekunden ohne Eingabe)
- `visitorName` / `visitorEmail` / `visitorPhone` sind optional
- Verwenden Sie dieselbe `visitorId` wie bei `POST …/inbox/website/messages` und `GET …/inbox/website/messages`

### Echtzeit (SSE) [#realtime-sse]

```http
GET /api/orgs/{orgId}/inbox/website/subscribe?visitorId=vis_…
X-Tillor-Inbox-Widget-Key: iwk_xxx
Accept: text/event-stream
```

| Event | Wann |
|-------|---------|
| `inbox:website:message-created` | Neue Team- oder KI-Nachricht |
| `inbox:website:message-updated` | Team- oder KI-Nachricht geändert oder gelöscht |
| `inbox:website:typing-changed` | `data.staffTyping` oder `data.staffOutboundSenderType` ändert sich |

Die Payload-Form ist dieselbe wie bei [Org-SSE](/ontwikkelaars/sse#event-formaat) (`event`, `data`, `timestamp`). Verbinden Sie sich nach einem Abbruch neu; es gibt kein Wiederaufsetzen.

Das offizielle Widget verwendet SSE als primäre Schicht und ruft `GET …/messages` alle **5 Sekunden** erneut ab, als Fallback (alle **1 Sekunde** bei geöffnetem Panel, wenn SSE kurz ausfällt). Dadurch werden Antworten als **zugestellt** markiert, solange der Besucher auf der Seite ist.

### Besucheraktivität [#bezoekersactiviteit]

```http
POST /api/orgs/{orgId}/inbox/website/events
X-Tillor-Inbox-Widget-Key: iwk_xxx
Content-Type: application/json
```

`event`: `chat_closed`, `tab_hidden` oder `navigation` (bei Navigation auch `url`). Ihr Team sieht diese Ereignisse als grauen Infotext im Gespräch, siehe [Gespräche über den Website-Chat](/inbox/website-chat-gesprekken).

### Limits [#limieten]

`POST …/inbox/website/messages` und `POST …/inbox/website/attachments/upload` antworten mit `429`, wenn ein Besucher oder ein Netzwerk zu viel sendet. Der Body enthält `data.reason` = `INBOX_WIDGET_RATE_LIMITED` und `data.retryAfterSeconds`. Limits pro Organisation:

| Route | Pro Besucher (`visitorId`) | Pro Netzwerk (IP-Adresse) |
|-------|----------------------------|---------------------------|
| `messages` | 10 pro Minute, 200 pro Tag | 30 pro Minute, 600 pro Tag |
| `attachments/upload` | 10 pro Stunde | 50 pro Stunde |

Warte `retryAfterSeconds`, bevor du es erneut versuchst, und zeig dem Besucher eine Meldung, statt automatisch zu wiederholen.

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Website-Chat (App)" href="/inbox/website-chat" />
  <Card title="Einstellungen des Website-Chats" href="/inbox/website-chat-instellingen" />
  <Card title="SSE" href="/ontwikkelaars/sse" />
  <Card title="OpenAPI" href="https://tillor.eu/api/openapi.json" />
</Cards>


# Ein Gast an der Schranke (/de-DE/praktijk/gast-aan-de-slagboom)

Ein Gast kommt an der Schranke von Recreatiepark Het Meer an und muss ohne Hilfe der Rezeption hindurchkommen. Dieses Beispiel begleitet Jonas Maes von der Einrichtung seiner Zugangsmethode bis zu dem, was passiert, wenn sie nicht (mehr) funktioniert. Sie sehen, wie eine Zugangsmethode, ein Controller und ein Zugangspunkt zusammenarbeiten.

```mermaid
flowchart LR
  A[Zugangsmethode beim Kunden] --> B[Gast am Zugangspunkt]
  B --> C{Controller und Tillor prüfen}
  C -->|gültig| D[Erlaubt, Schranke öffnet sich]
  C -->|abgelaufen oder blockiert| E[Verweigert, im Protokoll sichtbar]
```

Bevor Sie beginnen:

- Ihr Park hat mindestens einen Zugangspunkt, der mit Tillor verbunden ist. Er steht unter **Schnellaktionen** auf der Seite **Zugangskontrolle** mit einer Schaltfläche **[Name des Zugangspunkts] öffnen**.
- Der Controller an der Schranke ist mit Ihrer Organisation verbunden. Ein neuer Controller erscheint unter **Controller** mit **Wartet auf Genehmigung**, bis Sie auf **Genehmigen** klicken. Siehe [Controller](/controllers).
- Für einen NFC-Tag: Der Tag muss bereits in Tillor stehen. Das geschieht von selbst, sobald er zum ersten Mal vor einen Leser gehalten wurde.

## Die Route Schritt für Schritt [#de-route-stap-voor-stap]

<Steps>
<Step>
### Zugangsmethode hinzufügen [#voeg-een-toegangsmethode-toe]
Gehen Sie zu <UIPath>Kunden > Jonas Maes > Zugangskontrolle</UIPath> und klicken Sie auf **Hinzufügen**. Wählen Sie die **Art** und tragen Sie optional ein **Von Datum** und **Bis Datum** ein. Dieser Zeitraum bestimmt, wann die Methode funktioniert.

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Tab Zugangskontrolle mit der Tabelle der Zugangsmethoden" />

<Tabs items={["Kennzeichen", "QR-Code", "NFC-Tag"]}>
<Tab value="Kennzeichen">
Wählen Sie **Kennzeichenerkennung** und tragen Sie das **Kennzeichen** ein. Die Kamera am Zugangspunkt liest das Kennzeichen, und Tillor ordnet den passenden Kunden zu.
</Tab>
<Tab value="QR-Code">
Wählen Sie **QR-Code**. Tillor erzeugt den Code selbst. Kopieren Sie im Menü bei der Methode die **Persönliche URL** und senden Sie sie an Jonas. Er öffnet die Seite **Zugangspass** und kann den Pass zu Apple Wallet oder Google Wallet hinzufügen, sofern das für Ihre Umgebung eingerichtet ist.
</Tab>
<Tab value="NFC-Tag">
Wählen Sie **NFC** und wählen Sie eine verfügbare NFC-Karte aus der Auswahlliste. Ist die Liste leer, halten Sie zuerst den Tag vor einen Leser. Siehe [Tags verwalten](/nfc/nfc-tags).
</Tab>
</Tabs>

Siehe [Zugangskontrolle](/toegangscontrole).
</Step>
<Step>
### Controller und Zugangspunkt prüfen [#controleer-controller-en-toegangspunt]
Der Controller oder die Kamera am Zugangspunkt erhält die Liste der gültigen Methoden von Tillor. Unter **Controller-Operationen** auf der Seite **Zugangskontrolle** sehen Sie, wann ein Pass oder QR-Code an den Zugangspunkt weitergeleitet wurde. Steht der Vorgang dort noch nicht, läuft die Synchronisierung noch.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Controller-Operationen mit Synchronisierung und Whitelist-Aktionen" />
</Step>
<Step>
### Verfolgen, was an der Schranke passiert [#volg-wat-er-aan-de-slagboom-gebeurt]
Der Block **Zugangsprotokoll** zeigt jeden Versuch mit Datum, Methode, Kunde, Zugangspunkt und Status. Ein Gast, der hereinfährt, steht in der Tabelle **Fahrzeuge im Park** mit dem Status **Im Park**. Fährt er weg, wird daraus **Ausgefahren**.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Zugangsprotokoll mit Kennzeichen, Kunde und Status" />
</Step>
<Step>
### Schranke bei Bedarf selbst öffnen [#open-de-slagboom-zelf-als-het-nodig-is]
Klicken Sie bei **Schnellaktionen** auf **[Name des Zugangspunkts] öffnen** und bestätigen Sie mit **Ja, [Name des Zugangspunkts] öffnen**. Schließen ist nur möglich, wenn der Zugangspunkt das unterstützt.
</Step>
</Steps>

## Was passiert bei einer abgelaufenen Methode? [#wat-gebeurt-er-bij-een-verlopen-methode]

Liegt das **Bis Datum** in der Vergangenheit, gewährt die Methode keinen Zugang mehr, und der Versuch steht im Protokoll mit dem Status **Abgelaufen**. Weitere Status, denen Sie begegnen, sind **Blockiert**, **Inaktiv** und **Verweigert**.

Für Kennzeichen gibt es eine Kulanzfrist, damit Gäste nachts nicht vor einer geschlossenen Ausfahrt stehen. Ist **Abgelaufene Kennzeichen ausfahren lassen** eingeschaltet (Standard), öffnet sich die Ausfahrtschranke während der Kulanzfrist noch. Diese dauert standardmäßig 2 Tage und höchstens 30. Sie gilt nur außerhalb der Öffnungszeiten. Ist die Rezeption geöffnet, wickelt das Personal das Fahrzeug am Schalter ab. Ein blockiertes oder inaktives Kennzeichen erhält nie eine Kulanzfrist, und NFC-Tags und QR-Codes haben keine. Sie stellen das unter <UIPath>Support > Einstellungen > Zugangskontrolle</UIPath> ein, siehe [Einstellungen für die Zugangskontrolle](/gebruikers/instellingen-toegangscontrole).

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Jeder Versuch bleibt im Zugangsprotokoll stehen. Sie können nach Kunde, Status und Zugangspunkt filtern und nach Excel exportieren.
- Ein Fahrzeug, das 7 Tage an keinem Zugangspunkt gesehen wurde, erhält den Status **Geisterfahrzeug**. Wird das Kennzeichen später wieder an einer Einfahrt gesehen, steht es wieder auf **Im Park**.
- Verlängern Sie das **Bis Datum** der Methode, funktioniert sie nach der nächsten Synchronisierung mit dem Zugangspunkt wieder.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Gast steht vor einer geschlossenen Schranke">
Suchen Sie den Versuch im Zugangsprotokoll und lesen Sie den Status. **Abgelaufen** bedeutet, dass das **Bis Datum** vorbei ist, **Blockiert** oder **Inaktiv**, dass die Methode ausgeschaltet ist. Passt die Methode, prüfen Sie **Controller-Operationen**. Lässt es sich nicht schnell lösen, öffnen Sie die Schranke über **Schnellaktionen**.
</Accordion>
<Accordion title="Im Protokoll steht kein Versuch">
Dann hat Tillor nichts empfangen. Prüfen Sie, ob der Controller online ist und ob der Bildschirm eine Meldung zeigt. Siehe [Bildschirmmeldungen](/controllers/troubleshooting/scherm) und [Verbindungsprobleme](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="Das Kennzeichen wird nicht erkannt">
Prüfen Sie, ob das Kennzeichen ohne Leerzeichen oder Tippfehler eingetragen ist. Ein falsch gelesenes Kennzeichen kann ein Fahrzeug auch als **Geisterfahrzeug** stehen lassen.
</Accordion>
<Accordion title="Ich sehe keine NFC-Karte in der Auswahlliste">
Der Tag ist in Tillor noch nicht bekannt oder hängt bereits an einem anderen Kunden. Halten Sie ihn zuerst vor einen Leser, oder lösen Sie ihn beim anderen Kunden.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zugangskontrolle" href="/toegangscontrole" />
  <Card title="Controller" href="/controllers" />
  <Card title="NFC" href="/nfc" />
  <Card title="Einstellungen für die Zugangskontrolle" href="/gebruikers/instellingen-toegangscontrole" />
</Cards>


# Übersicht (/de-DE/praktijk)

Bei den meisten Aufgaben berühren Sie mehr als ein Modul: Aus einem neuen Kunden werden eine Belegung, ein Vertrag, eine Rechnung und eine Zahlung. Diese Beispiele gehen eine solche Route von Anfang bis Ende durch. Sie verwenden die Demo-Organisation Recreatiepark Het Meer, mit dem Kunden Jonas Maes und Stellplatz 12. Jeder Schritt verweist auf die Seite mit der vollständigen Erklärung.

<Cards>
  <Card title="Einen Saisonkunden gewinnen" href="/praktijk/seizoensklant-binnenhalen" description="Kunde, Belegung, Mietvertrag, Rechnung, Zahlung und Zahlungsbericht" />
  <Card title="Verbrauch abrechnen" href="/praktijk/verbruik-aanrekenen" description="Vom Zähler am Stellplatz bis zur automatischen Nebenkostenrechnung" />
  <Card title="Ein Dauercaravan wird frei" href="/praktijk/stacaravan-komt-vrij" description="Belegung beenden, Nachfolgeaufgabe und Kaution zurück" />
  <Card title="Ein Gast an der Schranke" href="/praktijk/gast-aan-de-slagboom" description="Zugangsmethode, Controller, Zugangspunkt und was bei Ablauf passiert" />
</Cards>

## Wie hängt das zusammen? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Kunde] --> B[Belegung]
  T[Stellplatz] --> B
  M[Zähler] --> T
  B --> V[Verbrauch]
  K --> O[Unterschriftsanfrage]
  B --> F[Rechnung]
  V --> F
  F --> P[Zahlung]
  P --> R[Zahlungsbericht]
  K --> TM[Zugangsmethode]
  TM --> TP[Zugangspunkt]
  B -->|endet| A[Automatisierung]
  A --> TK[Aufgabe]
```

Lesen Sie die Beispiele als Route: Sie können an jeder Stelle einsteigen. Wenn Sie die Begriffe noch einmal nachlesen möchten, schauen Sie bei [Begriffe](/begrippen).

## Begriffe [#begrippen]

- **Belegung**: ein Kunde auf einem Stellplatz für einen längeren Zeitraum. Siehe [Belegung](/begrippen#bezetting).
- **Stellplatz**: ein Platz in Ihrem Park. Siehe [Stellplatz](/begrippen#terrein).
- **Unterschriftsanfrage**: ein PDF, das online unterschrieben wird. Siehe [Unterschriftsanfrage](/begrippen#ondertekenverzoek).
- **Automatisierung**: eine Regel, die Tillor selbst ausführt. Siehe [Automatisierung](/begrippen#automatisering).


# Einen Saisonkunden gewinnen (/de-DE/praktijk/seizoensklant-binnenhalen)

Einen Saisonkunden zu gewinnen bedeutet in Tillor: den Kunden anlegen, ihm eine Parzelle geben, den Mietvertrag unterschreiben lassen, die Stellplatzgebühr in Rechnung stellen und dafür sorgen, dass die Zahlung in Ihrer Buchhaltung ankommt. Dieses Beispiel geht die Route für Jonas Maes durch, der beim Erholungspark Het Meer die Parzelle 12 für die Saison mietet. Jeder Schritt verweist auf die Seite mit der ausführlichen Erklärung.

```mermaid
flowchart LR
  A[Kunden anlegen] --> B[Belegung auf Parzelle 12]
  B --> C[Mietvertrag unterschreiben]
  C --> D[Stellplatzgebühr in Rechnung stellen]
  D --> E[Zahlung]
  E --> F[Zahlungsbericht]
```

Bevor Sie beginnen:

- Parzelle 12 existiert und hat keine aktive Belegung. Hat sie schon eine, erscheint sie nicht in der Auswahlliste bei **Belegung erstellen**.
- Es gibt ein Produkt mit der Aktion **Belegung verlängern**, oft Stellplatzgebühr. Siehe [Aktionen mit einem Produkt verknüpfen](/producten/acties-instellen).
- Sie haben den Mietvertrag als PDF bereit.
- Sie haben das Recht **Unterschriftsanfragen verwalten**, um den Vertrag unterschreiben zu lassen.
- Für die Unterschrift aus der Ferne braucht der Kunde eine E-Mail-Adresse oder eine Telefonnummer. Für ein SEPA-Mandat ist eine E-Mail-Adresse nötig.

## Die Route Schritt für Schritt [#de-route-stap-voor-stap]

<Steps>
<Step>
### Legen Sie den Kunden an [#maak-de-klant-aan]
Gehen Sie zu <UIPath>Kunden > Übersicht</UIPath> und klicken Sie auf **Neuen Kunden anlegen**. Liegt ein Ausweisscan in der Warteschlange, wählen Sie diesen Scan im Auswahlmenü: Tillor füllt die Daten aus dem Dokument aus. Andernfalls wählen Sie **Manuell** und füllen **Vorname**, **Nachname**, **E-Mail-Adresse** und **Telefonnummer** aus.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Dialog Neuen Kunden anlegen" />

Nach dem Anlegen landen Sie im Profil von Jonas. Ergänzen Sie dort die Adresse. Mehr steht unter [Kundenverwaltung](/klantenbeheer) und [Ausweisscans](/identiteitsscans).
</Step>
<Step>
### Geben Sie Jonas die Parzelle 12 [#geef-jonas-terrein-12]
Öffnen Sie in seinem Profil den Tab **Übersicht**, gehen Sie zur Karte **Belegungen** und klicken Sie auf **Belegung erstellen**. Wählen Sie bei **Parzelle** die Parzelle 12. Füllen Sie bei Bedarf **Bezahlt bis**, die **Art** und den **Mietrhythmus** aus. Der Preis kommt standardmäßig von der Parzelle.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Karte Belegungen im Kundenprofil" />

Hat Parzelle 12 Zähler, können Sie jetzt auch die **Start-Zählerstände** eintragen. Siehe [Belegungen](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Lassen Sie den Mietvertrag unterschreiben [#laat-het-huurcontract-tekenen]
Gehen Sie zu <UIPath>Verwaltung > Unterschriften</UIPath> und klicken Sie auf **Unterschriften anfragen**. Wählen Sie Jonas Maes als **Kunde**, laden Sie den Vertrag hoch, fügen Sie Jonas als Unterzeichner mit **Kunde: Jonas Maes** hinzu und setzen Sie ein Unterschriftsfeld. Fügen Sie bei Bedarf einen Mitarbeiter als zweiten Unterzeichner hinzu.

<Tabs items={["Aus der Ferne", "An der Rezeption"]}>
<Tab value="Aus der Ferne">
Klicken Sie auf **Senden**. Jonas erhält eine E-Mail mit einem persönlichen Link, oder eine SMS, wenn nur eine Telefonnummer vorhanden ist. Er unterschreibt auf seinem eigenen Gerät und bestätigt mit einem 6-stelligen Code.
</Tab>
<Tab value="An der Rezeption">
Klicken Sie auf **Senden**, öffnen Sie die Anfrage und klicken Sie bei Jonas auf **Am Tablet signieren**. Wählen Sie **Mit Code**, oder **Ohne Code**, wenn Sie seine Identität am Empfang geprüft haben. Der Vertrag öffnet sich auf dem Tablet, mit seinem Namen in großen Buchstaben.
</Tab>
</Tabs>

Alle Details stehen unter [Unterschriften anfragen](/handtekeningen/handtekening-vragen) und [So unterschreibt jemand](/handtekeningen/ondertekenen).
</Step>
<Step>
### Buchen Sie die Stellplatzgebühr [#boek-het-staangeld]
Gehen Sie zurück zur Karte **Belegungen** im Profil von Jonas, öffnen Sie das Menü bei der Belegung und wählen Sie **Belegung verlängern (Rechnung)**. Klicken Sie auf **Rechnungsentwurf erstellen**. Tillor erstellt einen Rechnungsentwurf mit dem Produkt mit der Aktion **Belegung verlängern**. Prüfen Sie den Zeitraum auf der Rechnung und klicken Sie auf **Rechnung buchen**.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Rechnungsentwurf mit der Schaltfläche Rechnung buchen" />

Die Rechnung erhält eine Rechnungsnummer und den Status <Status tone="success">Gebucht</Status>. Siehe [Eine Rechnung buchen](/facturen/boeken) und [Belegung verlängern](/bezettingen#facturatie-bezetting-verlengen).
</Step>
<Step>
### Wählen Sie, wie Jonas bezahlt [#kies-hoe-jonas-betaalt]
Das Buchen verschickt nichts an den Kunden. Sie wählen jetzt, wie das Geld eingeht.

<Tabs items={["Zahlungslink", "Lastschrift mit Mandat", "An der Rezeption"]}>
<Tab value="Zahlungslink">
Klicken Sie auf **Benachrichtigung senden** und wählen Sie einen Kanal wie **E-Mail**. Jonas erhält die Schaltfläche **Rechnung ansehen und bezahlen** und schließt die Zahlung zum Beispiel mit iDEAL oder Bancontact ab. Soll er zunächst nur einen Teil bezahlen, erstellen Sie einen [Link für eine Teilzahlung](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). Siehe [Online bezahlen](/betalingsverwerking/online).
</Tab>
<Tab value="Lastschrift mit Mandat">
Beantragen Sie zuerst ein Mandat über <UIPath>Kunden > Jonas Maes > Rechnungen</UIPath> und **Mandat erstellen**. Sobald der Status <Status tone="success">Aktiv</Status> ist, wählen Sie auf der Rechnung bei **Lastschriftmandat** dieses Mandat. Tillor zieht den Betrag dann zwei Tage nach dem Buchen ein, oder zwei Tage nach der Verknüpfung, wenn die Rechnung schon gebucht war. Siehe [Ein SEPA-Mandat unterschreiben lassen](/betalingsverwerking/mandaat) und [Eine Rechnung einziehen](/betalingsverwerking/incasso).
</Tab>
<Tab value="An der Rezeption">
Klicken Sie auf **Zahlung vornehmen** und wählen Sie **Terminal**, **Bar** oder **Überweisung**. Siehe [Eine Zahlung erfassen](/betalingsverwerking/betaling-registreren).
</Tab>
</Tabs>
</Step>
<Step>
### Sehen Sie die Zahlung eingehen [#zie-de-betaling-binnenkomen]
Unter <UIPath>Verwaltung > Zahlungen</UIPath> steht die Zahlung. Eine Online-Zahlung erscheint, sobald Mollie sie bestätigt. Eine Lastschrift hat zunächst den Status <Status tone="warning">In Bearbeitung</Status> und wird nach einigen Tagen <Status tone="success">Bezahlt</Status>. Ist alles eingegangen, steht die Rechnung auf <Status tone="success">Bezahlt</Status>.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Übersicht aller Zahlungen" />

Mehr steht unter [Zahlungen wiederfinden](/betalingsverwerking/betalingen-bekijken).
</Step>
<Step>
### Sehen Sie die Zahlung im Zahlungsbericht [#zie-de-betaling-in-het-betalingsrapport]
Gehen Sie zu <UIPath>Verwaltung > Zahlungsberichte</UIPath>. Die Zahlungen von heute stehen auf dem Bericht mit dem Status **Entwurf**. Tillor schließt den Bericht bei der nächsten täglichen Kontrolle ab, an Werktagen um 09:00 Uhr. Ist Ihre Buchhaltungsanbindung aktiv, leitet Tillor den Bericht selbst weiter.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Liste der Zahlungsberichte" />

Siehe [Zahlungsberichte](/boekhouden/betalingsrapporten).
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Belegung von Jonas läuft. Parzelle 12 ist für andere Kunden nicht mehr verfügbar, und der Verbrauch der Zähler auf der Parzelle geht an Jonas.
- Sobald alle unterschrieben haben, steht die Anfrage auf <Status tone="success">Abgeschlossen</Status>. Die unterschriebene PDF mit den Nachweisseiten steht bei seinen **Dokumenten**. Soll danach eine Automatisierung etwas tun, zum Beispiel eine Aufgabe anlegen, verwenden Sie den Trigger **Signaturanfrage abgeschlossen**.
- Beim Buchen der Rechnung setzt Tillor **Fakturiert bis** auf das Ende der Rechnungszeile. Nach der Zahlung rückt **Bezahlt bis** vor. Siehe [Bezahlt bis, Art, Mietrhythmus und Preis](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).
- Nächste Saison verlängern Sie dieselbe Belegung erneut mit **Belegung verlängern (Rechnung)**, oder für alle Belegungen eines Kunden gleichzeitig mit **Alle verlängern**.
- Mollie-Zahlungen stehen auf dem Entwurfsbericht als Vorschuss auf Mollie, bis die Auszahlung bekannt ist.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Parzelle 12 steht nicht in der Liste bei Belegung erstellen">
Eine Parzelle kann immer nur mit einem Kunden verknüpft sein. Gibt es schon eine aktive Belegung, steht sie nicht in der Liste. Beenden Sie diese Belegung zuerst, siehe [Eine Belegung beenden](/bezettingen#een-bezetting-beëindigen).
</Accordion>
<Accordion title="Ich kann die Unterschriftsanfrage nicht senden">
Tillor prüft die Anfrage und sagt, was fehlt: ein Unterzeichner ohne Unterschriftsfeld, ein Unterzeichner ohne E-Mail-Adresse oder Telefonnummer, oder ein leerer Titel. Beheben Sie das und versuchen Sie es erneut. Siehe [Unterschriften anfragen](/handtekeningen/handtekening-vragen#problemen).
</Accordion>
<Accordion title="Die Schaltfläche Rechnung buchen ist grau">
Fahren Sie mit der Maus über die Schaltfläche, Tillor zeigt den Grund. Oft fehlt bei einer Zeile mit einer Belegung ein Start- oder Enddatum, oder der Betrag liegt über dem Höchstbetrag des verknüpften Mandats. Siehe [Wenn das Buchen nicht klappt](/facturen/boeken#problemen).
</Accordion>
<Accordion title="Belegung verlängern (Rechnung) liefert keine brauchbare Rechnung">
Es muss mindestens ein Produkt mit der Aktion **Belegung verlängern** existieren. Ohne ein solches Produkt kann Tillor die Zeile nicht aufbauen. Legen Sie das Produkt an oder fügen Sie die Aktion hinzu, siehe [Aktionen mit einem Produkt verknüpfen](/producten/acties-instellen).
</Accordion>
<Accordion title="SEPA-Mandat ist grau bei Zahlung vornehmen">
Jonas hat kein Mandat mit dem Status <Status tone="success">Aktiv</Status>, dessen Höchstbetrag hoch genug ist. Prüfen Sie die Karte **Mandate** in seinem Tab **Rechnungen**.
</Accordion>
<Accordion title="Die Rechnung steht auf In Bearbeitung">
Die Zahlung ist gestartet, aber das Geld ist noch nicht endgültig eingegangen. Das ist bei einer Lastschrift normal. Sobald die Zahlung verarbeitet ist, springt der Status auf **Bezahlt**. Siehe [Status](/facturen/statussen).
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Verbrauch abrechnen" href="/praktijk/verbruik-aanrekenen" description="Die Fortsetzung: was Jonas an Wasser und Strom verbraucht" />
  <Card title="Belegungen" href="/bezettingen" />
  <Card title="Unterschriften" href="/handtekeningen" />
  <Card title="Rechnungen" href="/facturen" />
  <Card title="Zahlungsabwicklung" href="/betalingsverwerking" />
</Cards>


# Ein Wohnwagen wird frei (/de-DE/praktijk/stacaravan-komt-vrij)

Wenn ein Kunde einen Wohnwagen verlässt, gibt es Arbeit: Der Wohnwagen muss kontrolliert werden, und die Kaution muss an den Kunden zurück. Dieses Beispiel zeigt, wie Tillor das zusammenbringt. Sie beenden die Belegung, eine Automatisierung legt eine Kontrollaufgabe an, ein Kollege arbeitet die Aufgabe ab, und danach regeln Sie die Kaution. Als Beispiel dienen Jonas Maes und Parzelle 12 des Erholungsparks Het Meer, diesmal als Mieter eines Wohnwagens.

```mermaid
flowchart LR
  A[Belegung beenden] --> B[Automatisierung]
  B --> C[Kontrollaufgabe mit Unteraufgaben]
  C --> D[Kollege schließt ab]
  D --> E[Kaution zurück per Gutschrift]
```

Bevor Sie beginnen:

- Parzelle 12 hat den Parzellentyp **Wohnwagen**, und Jonas hat dort eine aktive Belegung. Siehe [Parzellentypen](/terreinen#terreintypes).
- Es gibt eine Automatisierung, die beim Ende einer Belegung eine Aufgabe anlegt. Wie Sie sie bauen, steht unter [Beispiel: Mietwohnwagen kontrollieren](/automatiseringen/voorbeeld-nalopen). In Demo-Umgebungen ist sie unter dem Namen **Mietwohnwagen kontrollieren** schon vorhanden, pausiert, bis Sie den Schalter **Aktiv** einschalten.
- Für die Kaution: Beim Kautionsprodukt ist die Option **Kundensaldo auf diesem Konto überwachen** eingeschaltet. Siehe [Den Kundensaldo überwachen](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

## Die Route Schritt für Schritt [#de-route-stap-voor-stap]

<Steps>
<Step>
### Beenden Sie die Belegung [#stop-de-bezetting]
Öffnen Sie das Profil von Jonas, gehen Sie im Tab **Übersicht** zur Karte **Belegungen**, öffnen Sie das Menü bei der Belegung und wählen Sie **Löschen**. Wählen Sie bei **Datum** den Tag, an dem er abreist. Hat die Parzelle Zähler, tragen Sie die **End-Zählerstände** ein. Klicken Sie auf **Löschen**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Aktionsmenü bei einer Belegung" />

Parzelle 12 ist danach wieder frei für eine neue Belegung. Siehe [Eine Belegung beenden](/bezettingen#een-bezetting-beëindigen).
</Step>
<Step>
### Lassen Sie die Automatisierung die Kontrollaufgabe anlegen [#laat-de-automatisering-de-nalooptaak-maken]
Sie müssen nichts tun. Die Automatisierung startet, sobald die Belegung endet, und prüft zuerst, ob die Parzelle den Parzellentyp **Wohnwagen** hat. Danach sucht sie, ob es für diese Parzelle schon eine offene Aufgabe **Kontrollieren** gibt.

- Gibt es noch keine offene Aufgabe, legt sie eine Aufgabe **Parzelle 12 kontrollieren** mit fünf Unteraufgaben an (**Reinigen**, **Inventar**, **Internet + TV**, **Rahmen QR-Code** und **Auf Arbeiten prüfen**) und einer Frist nach 7 Tagen. Die Aufgabe geht auch an den Kollegen, der die Belegung beendet hat.
- Gibt es schon eine offene Aufgabe, zum Beispiel weil der Wohnwagen zweimal kurz hintereinander frei wurde, legt sie keine zweite an. Die Priorität der bestehenden Aufgabe steigt eine Stufe, bis **Hoch**.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Schritt Kontrollaufgabe anlegen in der Automatisierung" />

Was die Automatisierung getan hat, verfolgen Sie unter [Tests und Ausführungen](/automatiseringen/testen-en-uitvoeringen).
</Step>
<Step>
### Arbeiten Sie die Aufgabe ab [#werk-de-taak-af]
Der Kollege findet die Aufgabe in der Karte **Aufgaben für dich** auf dem Dashboard, im Tab **Aufgaben** von Jonas oder in einer Ansicht unter **Aufgaben**. Die Aufgabe ist mit Parzelle 12 und mit Jonas verknüpft.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Aufgabenfenster mit Beschreibung, Unteraufgaben und Eigenschaften" />

<Tabs items={["Mit Unteraufgaben", "Mit Auswahlschaltflächen"]}>
<Tab value="Mit Unteraufgaben">
Öffnen Sie die Aufgabe und haken Sie jede Unteraufgabe ab, sobald sie erledigt ist. Neben der Aufgabe steht ein Zähler wie **2/5**. Sind alle Unteraufgaben fertig, setzen Sie den Status auf **Abgeschlossen**. Setzen Sie die Hauptaufgabe auf **Abgeschlossen**, werden die offenen Unteraufgaben mit abgeschlossen.
</Tab>
<Tab value="Mit Auswahlschaltflächen">
Haben Sie die Automatisierung um den Schritt **Um eine Entscheidung bitten** erweitert, zum Beispiel um zu entscheiden, ob die Kaution vollständig zurückgezahlt wird, stehen auf der Aufgabe Schaltflächen unter **Wählen Sie eine Aktion, um diese Aufgabe abzuschließen**. Ein Klick schließt die Aufgabe ab. Verlangt die Wahl eine Begründung, öffnet sich **Warum diese Wahl?**. Eine getroffene Wahl lässt sich danach nicht mehr rückgängig machen. Siehe [Aufgaben mit Auswahlschaltflächen](/taken/taakdetails#taken-met-keuzeknoppen) und [Um eine Entscheidung bitten](/automatiseringen/logica#vraag-om-een-beslissing).
</Tab>
</Tabs>
</Step>
<Step>
### Prüfen Sie den Kautionssaldo [#controleer-het-saldo-van-de-waarborg]
Öffnen Sie das Profil von Jonas und gehen Sie zum Tab **Rechnungen**. In der Tabelle **Konten** sehen Sie pro Konto den Saldo. Das Kautionskonto zeigt, was Jonas noch zu Gute hat.
</Step>
<Step>
### Erstellen Sie die Gutschrift für die Kaution [#maak-de-creditnota-voor-de-waarborg]
Öffnen Sie die Kautionsrechnung von Jonas, klicken Sie oben rechts auf die drei Punkte und wählen Sie **Rechnung stornieren**. Tillor erstellt einen Rechnungsentwurf mit denselben Zeilen in negativen Beträgen. Behalten Sie einen Teil ein, zum Beispiel für Schäden, passen Sie den Betrag an. Klicken Sie auf **Rechnung buchen**. Die Rechnung wird eine **Gutschrift**.

Tillor lehnt eine Rechnung ab, die den Saldo des Kautionskontos unter null bringt. So kann eine Kaution nicht zweimal zurückgezahlt werden. Siehe [Eine Rechnung stornieren](/facturen/corrigeren#een-factuur-omkeren).
</Step>
<Step>
### Verrechnen Sie den Betrag [#verreken-het-bedrag]
Steht noch eine offene Rechnung von Jonas aus, zum Beispiel für den letzten Verbrauch, können Sie den Betrag mit der Zahlungsmethode **Interne Überweisung** verrechnen. Siehe [Eine interne Überweisung erstellen](/betalingsverwerking/interne-overboeking).
</Step>
</Steps>

<Callout type="info" title="Geld zurücküberweisen">
Tillor hält die Gutschrift und die Verrechnung fest. Den Betrag selbst auf das Bankkonto des Kunden zurückzuüberweisen, erledigen Sie über Ihre Bank.
</Callout>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die Parzelle ist wieder frei. Ein neuer Kunde kann dort eine Belegung übernehmen oder eine Reservierung erhalten.
- Die offenen Verbrauchszeiträume von Jonas sind abgeschlossen, mit den Endständen, die Sie eingetragen haben. Der Verbrauch bis zum Enddatum bleibt erhalten, und Sie können ihn noch abrechnen. Siehe [Verbrauch abrechnen](/praktijk/verbruik-aanrekenen).
- Die Aufgabe und die Aktionen darauf stehen in der Zeitleiste der Aufgabe und im Profil von Jonas. Änderungen an der Belegung stehen in seinem Tab **Ereignisse**.
- Die Gutschrift geht wie jede andere Rechnung in die Buchhaltung.

## Probleme? [#problemen]

<Accordions>
<Accordion title="Es wurde keine Kontrollaufgabe angelegt">
Prüfen Sie drei Dinge. Ist der Schalter **Aktiv** der Automatisierung eingeschaltet? Ist der Parzellentyp von Parzelle 12 **Wohnwagen**? Sehen Sie unter [Tests und Ausführungen](/automatiseringen/testen-en-uitvoeringen) nach, ob die Automatisierung gestartet ist und wo sie angehalten hat.
</Accordion>
<Accordion title="Es gibt zwei Kontrollaufgaben, oder nur eine">
Die Automatisierung sucht eine offene Aufgabe mit genau demselben Titel, **Kontrollieren** gefolgt vom Parzellennamen, für dieselbe Parzelle, denselben Kunden oder dieselbe Reservierung. Passt der Titel nicht, findet sie die bestehende Aufgabe nicht und legt eine neue an. Eine offene Aufgabe erhält nur eine höhere Priorität, keine zweite Aufgabe.
</Accordion>
<Accordion title="Ich kann die Aufgabe nicht abschließen">
Steht dort **Wird von der Automatisierung abgeschlossen**, kann nur die Automatisierung die Aufgabe abschließen, und die Aufgabe hat kein **Löschen**. Siehe [Aufgabendetails](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
<Accordion title="Ich sehe die Auswahlschaltflächen nicht">
Wählen kann, wer der Aufgabe zugewiesen ist, sowie ein Administrator. Ist niemand zugewiesen, kann jeder wählen, der die Aufgabe sieht. Steht statt Schaltflächen ein Häkchen, stammt die Aufgabe nicht aus einem Schritt **Um eine Entscheidung bitten**.
</Accordion>
<Accordion title="Rechnung buchen ist grau bei der Gutschrift der Kaution">
Der Saldo des Kautionskontos würde unter null fallen. Prüfen Sie die Tabelle **Konten** und den Betrag auf der Rechnung. Mit dem Recht **Kontosaldo übersteuern** können Sie trotzdem buchen, mit einer Begründung, die in der Zeitleiste der Rechnung erscheint.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Beispiel: Mietwohnwagen kontrollieren" href="/automatiseringen/voorbeeld-nalopen" description="So bauen Sie die Automatisierung selbst" />
  <Card title="Aufgaben" href="/taken" />
  <Card title="Eine Rechnung korrigieren" href="/facturen/corrigeren" />
  <Card title="Belegungen" href="/bezettingen" />
</Cards>


# Verbrauch abrechnen (/de-DE/praktijk/verbruik-aanrekenen)

Verbrauch abrechnen funktioniert in Tillor über die Parzelle: Ein Zähler gehört zu einer Parzelle, ein Kunde kommt über eine Belegung auf die Parzelle, und der Verbrauch des Zählers geht an diesen Kunden. Dieses Beispiel folgt dem Stromzähler auf Parzelle 12 des Erholungsparks Het Meer, von der Verknüpfung bis zur Rechnung von Jonas Maes. Am Ende steht, wie Tillor diese Rechnung auch selbst erstellen und versenden kann.

```mermaid
flowchart LR
  A[Zähler] -->|verknüpfen| B[Parzelle 12]
  B --- C[Belegung von Jonas]
  A -->|Zählerstände| D[Verbrauch von Jonas]
  D --> E[Offener Verbrauch]
  E --> F[Rechnung]
  F -.->|automatisch| G[Verbrauchsrechnung an einem festen Tag]
```

Bevor Sie beginnen:

- Der Zähler existiert schon unter <UIPath>Park > Zähler</UIPath> und ist noch keiner Parzelle zugeordnet. Ein Zähler, der schon an einer Parzelle hängt, steht nicht in der Auswahlliste.
- Jonas hat eine aktive Belegung auf Parzelle 12. Siehe [Einen Saisonkunden gewinnen](/praktijk/seizoensklant-binnenhalen). Ohne Belegung weiß Tillor nicht, wem der Verbrauch gehört.
- Für die automatische Rechnung braucht Jonas eine E-Mail-Adresse oder Telefonnummer, und für das automatische Einziehen ein aktives Mandat.

## Die Route Schritt für Schritt [#de-route-stap-voor-stap]

<Steps>
<Step>
### Verknüpfen Sie den Zähler mit Parzelle 12 [#koppel-de-meter-aan-terrein-12]
Gehen Sie zu <UIPath>Park > Parzellen</UIPath>, öffnen Sie Parzelle 12 und scrollen Sie zur Karte **Zähler**. Klicken Sie auf **Zähler hinzufügen**, wählen Sie den Zähler und klicken Sie auf **Zähler zuweisen**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Detailseite von Parzelle 12 mit der Karte Zähler" />

Siehe [Zählerverwaltung](/meterbeheer/meter-koppelen) und [Parzellen](/terreinen).
</Step>
<Step>
### Erfassen Sie den Anfangsstand [#leg-de-beginstand-vast]
Ist Jonas schon auf Parzelle 12 eingetragen, tragen Sie den Anfangsstand bei der Belegung ein. Legen Sie die Belegung erst an, füllen Sie **Start-Zählerstände** aus. Lassen Sie das Feld leer, übernimmt Tillor den letzten bekannten Stand. So startet der erste Verbrauchsabschnitt sofort beim richtigen Stand. Siehe [Belegungen](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Verfolgen Sie die Zählerstände [#volg-de-meterstanden]
Intelligente Zähler senden ihren Stand selbst, meist täglich oder wöchentlich. Einen manuellen Zähler lesen Sie selbst ab und tragen ihn selbst ein. Siehe [Zählerverwaltung](/meterbeheer).

Den Verbrauch sehen Sie an zwei Stellen. Auf der Zählerseite unter <UIPath>Park > Zähler</UIPath> steht die Karte **Verbrauch** mit dem offenen und abgerechneten Verbrauch pro Kunde. Im Profil von Jonas steht die Karte **Zählerstände**, mit allen Zählern auf seinen Parzellen.

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Zählerseite mit der Karte Verbrauch" />

Trägt jemand einen Stand ein, der niedriger ist als der vorherige, warnt Tillor. Stimmt der Stand trotzdem (der Zähler wurde ersetzt), schließt Tillor den laufenden Zeitraum ab und beginnt einen neuen. Siehe [Verbrauchsabschnitte](/meterbeheer/consumptie-batches).
</Step>
<Step>
### Sehen Sie, was offen ist [#bekijk-wat-openstaat]
Gehen Sie zu <UIPath>Kunden > Offener Verbrauch</UIPath>. Sie sehen pro Kunde den Gesamtbetrag, die **Letzte Verbrauchsrechnung** und die Anzahl der Zähler. Jonas steht darin, sobald es Verbrauch gibt, der noch nicht auf einer Rechnung steht.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Übersicht Kunden mit offenem Verbrauch" />
</Step>
<Step>
### Erstellen Sie die Rechnung [#maak-de-factuur]
Sie haben zwei Wege.

<Tabs items={["Aus der Liste", "Aus dem Kundenprofil"]}>
<Tab value="Aus der Liste">
Klicken Sie am Ende der Zeile von Jonas auf das Versandsymbol. Das Fenster **Rechnung erstellen** zeigt den Gesamtbetrag, die Aufteilung nach Art und die Anzahl der Zähler. Haken Sie die Kanäle an, über die Tillor die Rechnung sofort versendet, und klicken Sie auf **Rechnung erstellen**. Tillor erstellt die Rechnung, bucht sie und versendet sie. Hat Jonas ein Mandat für Verbrauchsrechnungen, ist es bei **Per Mandat einziehen** vorab gewählt.
</Tab>
<Tab value="Aus dem Kundenprofil">
Öffnen Sie das Profil von Jonas und klicken Sie in der Karte **Zählerstände** auf **Verbrauch abrechnen**. Tillor setzt pro Verbrauchszeitraum eine Hauptzeile mit darunter einer Infozeile mit dem Datum und den Zählerständen. Gibt es schon einen passenden Rechnungsentwurf, kommen die Zeilen dorthin. Prüfen Sie die Rechnung, buchen und versenden Sie sie selbst. Siehe [Eine Rechnung buchen](/facturen/boeken) und [Eine Rechnung versenden](/facturen/versturen).
</Tab>
</Tabs>
</Step>
<Step>
### Lassen Sie Tillor es selbst erledigen [#laat-tillor-het-zelf-doen]
Öffnen Sie das Profil von Jonas, gehen Sie zu <UIPath>Kunden > Jonas Maes > Rechnungen</UIPath> und öffnen Sie die Karte **Rechnungseinstellungen**. Dort stellen Sie ein:

- **Automatische Verbrauchsabrechnung**: ein Tag des Monats. Wählen Sie den 31. und hat der Monat keine 31 Tage, geht die Rechnung am letzten Tag des Monats raus.
- **Mandat**: das Mandat, mit dem Tillor die Verbrauchsrechnung einzieht. Siehe [Eine Rechnung einziehen](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
- **Mindestbetrag**: eine eigene Untergrenze für Jonas. Lassen Sie das Feld leer, gilt das Minimum der Organisation unter <UIPath>Support > Einstellungen > Rechnungsstellung</UIPath>.

Am gewählten Tag erstellt Tillor die Rechnung selbst und versendet sie. Liegt der offene Betrag unter dem Minimum, wartet Tillor bis zu einem späteren Rechnungstag.
</Step>
</Steps>

## Was passiert danach? [#wat-gebeurt-er-daarna]

- Die abgerechneten Verbrauchszeiträume sind abgeschlossen. Läuft die Belegung weiter, startet Tillor einen neuen Zeitraum beim Endstand des vorherigen, sodass keine Lücke entsteht.
- Ist die Rechnung gebucht, läuft sie wie jede andere Rechnung weiter: Zahlung, Mahnung und Zahlungsbericht. Siehe [Einen Saisonkunden gewinnen](/praktijk/seizoensklant-binnenhalen).
- Beim Ende der Belegung schließt Tillor die offenen Zeiträume ab. Der Verbrauch bis zum Enddatum bleibt erhalten, und Sie können ihn noch abrechnen.
- Löschen Sie einen Rechnungsentwurf mit Verbrauch, kommt der Verbrauch zurück in **Offener Verbrauch**.

<Callout type="info" title="Verbrauch deutlich über dem Üblichen">
Beträgt der offene Strom- oder Wasserverbrauch mindestens das Doppelte dessen, was Jonas üblicherweise verbraucht, erstellt Tillor die automatische Rechnung nicht. Sie erhalten eine E-Mail an die Support-Adresse der Organisation. Prüfen Sie den Zählerstand und rechnen Sie den Verbrauch selbst ab, wenn alles stimmt.
</Callout>

## Probleme? [#problemen]

<Accordions>
<Accordion title="Der Zähler steht nicht in der Liste bei Zähler hinzufügen">
Die Liste zeigt nur Zähler ohne Parzelle. Hängt der Zähler schon an einer anderen Parzelle, trennen Sie ihn zuerst über das Menü beim Zähler auf dieser Parzelle mit **Von Parzelle trennen**.
</Accordion>
<Accordion title="Jonas hat keinen Verbrauch beim Zähler von Parzelle 12">
Der Verbrauch geht an den Kunden mit einer aktiven Belegung auf der Parzelle. Prüfen Sie, ob Jonas eine Belegung auf Parzelle 12 hat und ob der Zähler an der Parzelle hängt.
</Accordion>
<Accordion title="Jonas steht nicht in Offener Verbrauch">
Die Liste zeigt standardmäßig nur Kunden ohne automatische Abrechnung. Stellen Sie den Filter **Automatische Abrechnung** auf **Mit Datum**, um Kunden mit einem automatischen Rechnungstag zu sehen.
</Accordion>
<Accordion title="Die automatische Rechnung wurde nicht erstellt">
Es gibt zwei häufige Gründe. Der offene Betrag liegt unter dem Minimum, dann wartet Tillor auf einen späteren Rechnungstag. Oder der Verbrauch liegt deutlich über dem Üblichen, dann erhalten Sie eine E-Mail an die Support-Adresse, und die Rechnung bleibt aus, bis jemand sie geprüft hat. Siehe [Zählerverwaltung](/meterbeheer/verbruik-factureren#automatisch-factureren).
</Accordion>
<Accordion title="Ich habe den Verbrauch schon außerhalb von Tillor abgerechnet">
Öffnen Sie den Zeitraum in der Karte **Zählerstände** oder **Verbrauch**, klicken Sie auf das Warnsymbol neben dem Zeitraum und bestätigen Sie mit **Ja, als abgerechnet markieren**. Der Zeitraum wird dann ohne Rechnung abgeschlossen. Das lässt sich nur für Zeiträume ohne Rechnungsverknüpfung rückgängig machen.
</Accordion>
</Accordions>

## Siehe auch [#zie-ook]

<Cards>
  <Card title="Zählerverwaltung" href="/meterbeheer" />
  <Card title="Verbrauchsabschnitte" href="/meterbeheer/consumptie-batches" description="Wie Verbrauchszeiträume geführt und abgerechnet werden" />
  <Card title="Eine Rechnung einziehen" href="/betalingsverwerking/incasso" />
  <Card title="Einstellungen für die Rechnungsstellung" href="/gebruikers/instellingen-facturatie" />
</Cards>