> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/finanzen/zahlungen.md).

# Zahlungen

Erzeuge Zahlungsläufe und freie Überweisungen, prüfe die Zahlungsaufträge und übergib sie an Deine Bank.

Mit Zahlungsläufen bereitest Du offene Verbindlichkeiten für Überweisungen an Lieferanten und andere Zahlungsempfänger vor. Du wählst passende Offene Posten aus, prüfst Zahlungsaufträge, führst den Lauf durch und übergibst Aufträge einzeln.

Für Kundeneinzüge nutze [Lastschriften](https://help.vario-software.de/vario-cloud-handbuch/finanzen/lastschriften.md).

### Beispiel: Zwei freigegebene Lieferantenrechnungen bezahlen

Du möchtest zwei fällige Lieferantenrechnungen bezahlen. Beide sind freigegeben und haben die Zahlungsart **Überweisung**. Eine weitere Rechnung hat eine **Zahlungssperre** und gehört deshalb nicht zur Zahlungsselektion.

Du markierst die beiden freigegebenen OPs, prüfst Bankkonto und Vorlage und startest **»Zahlungen tätigen«** mit **Nur markierte verarbeiten**. VARIO legt den Lauf mit den Zahlungsdatensätzen für diese Rechnungen an.

Öffne den Lauf und kontrolliere Empfänger, Bankverbindungen und Beträge. Mit **»Zahllauf«** verarbeitest Du den Lauf. Anschließend übergibst Du die gewünschten Zahlungsaufträge gesondert an die Bank oder Banking-App. Erforderliche Freigaben erledigst Du beim Zahlungsanbieter und prüfst danach den Zahlungsstatus.

So kannst Du Auswahl, Zahlungsdaten und Bankübergabe jeweils nachvollziehen.

### Voraussetzungen

Vor einem Zahlungslauf benötigst Du:

1. Eine Bank mit mindestens einem Bankkonto.
2. Eine Zahlungsart vom Typ Überweisung oder Echtzeit-Überweisung.
3. Eine passende Zahlungsträgervorlage.
4. Eine aktive Bankverbindung am Lieferanten oder Zahlungsempfänger.
5. Offene Verbindlichkeiten ohne Zahlungssperre oder aktiven Zahlungsvorgang.

Die sichtbaren Aktionen hängen von Deinen Berechtigungen ab. Fehlt eine Aktion, prüfe Deine Rechte für **Banken** und **Zahlungen**.

{% hint style="info" %}

#### Um Zahlungen zu tätigen, musst Du vorab einige Grundeinstellungen vornehmen (z. B. Bankverbindungen, Zahlungsträgervorlagen oder Bankverbindung in der Adresse anlegen). Siehe dazu die Einstellungen unter [Lastschriften](https://help.vario-software.de/vario-cloud-handbuch/finanzen/lastschriften.md).

{% endhint %}

#### Eigene Bank und Bankkonto einrichten

Öffne **Einstellungen → Finanzen →** [**Onlinebanking**](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-finanzen/onlinebanking.md).

#### Zahlungsarten anlegen

Öffne Einstellungen → Finanzen → Zahlungsmodalitäten → Zahlungsarten. Lege dort die Zahlungsarten für Adressen und Belege an.

| Typ                  | Verwendung                              |
| -------------------- | --------------------------------------- |
| Überweisung          | Verbindlichkeiten im Bereich Zahlungen. |
| Echtzeit-Überweisung | Verbindlichkeiten im Bereich Zahlungen. |

Die Typen **Zur Verrechnung**, **Zur Verrechnung mit Vorbeleg** und **Sonstiges** werden nicht in Zahlungsläufe aufgenommen.

| Element               | Beschreibung                                                                               |
| --------------------- | ------------------------------------------------------------------------------------------ |
| „Kürzel“              | Eindeutige Kurzbezeichnung der Zahlungsart.                                                |
| „Beschreibung“        | Bezeichnung der Zahlungsart.                                                               |
| »Mahnbar«             | Kennzeichnet die Zahlungsart für das Mahnwesen.                                            |
| „Typ“                 | Legt die Verwendung für Überweisung, Lastschrift, Verrechnung oder sonstige Vorgänge fest. |
| „Geschäftsvorfall“    | Erforderlich, wenn OPs automatisch abgeschlossen werden sollen.                            |
| „Externe Zahlungsart“ | Optionale externe Kennung.                                                                 |
| „Druckbeschreibung“   | Text für den Belegausdruck mit Platzhaltern.                                               |
| Übersetzungen         | Sprach- und belegabhängige Drucktexte.                                                     |

Wenn Du Optionen zum automatischen Abschließen verwendest, steuerst Du diese nach OP-Art oder Buchungskontoart. Beide Varianten schließen sich gegenseitig aus. Dafür muss ein Geschäftsvorfall hinterlegt sein.

#### Zahlungsart in Adresse und Beleg prüfen

In einer Adresse legst Du im Bereich Lieferant die Zahlungsart für Einkaufsvorgänge fest. Im Beleg steht die Zahlungsart ebenfalls in den Zahlungsangaben.

Der daraus entstehende Offene Posten übernimmt die verwendete Zahlungsart. Die Zahlungsart bestimmt, ob der OP für den Zahlungslauf geeignet ist.

#### Bankverbindung an der Adresse hinterlegen

Öffne die gewünschte Adresse und wechsle zu Bankverbindungen. Lege dort die Bankverbindung des Lieferanten oder Zahlungsempfängers an.

#### Zahlungsträgervorlage anlegen

Öffne Einstellungen → Finanzen → Onlinebanking. Scrolle zu Zahlungsträgervorlagen und klicke auf **»+ Zahlungsträgervorlage«**.

### Zahlungslauf erzeugen

#### Bereich öffnen

Öffne Finanzen → Zahlungen und wechsle in den Reiter »Selektion«.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FRsXxXgi8MwT9FdXW5GKg%2Fimage.png?alt=media&amp;token=2e3ad652-c3b1-4176-9062-6f976ae02f25" alt=""><figcaption></figcaption></figure>

#### Summen und Bankkonto prüfen

Oberhalb der Liste siehst Du die relevanten Werte:

| Feld                 | Beschreibung                                                    |
| -------------------- | --------------------------------------------------------------- |
| Kontosaldo           | Aktueller Kontostand des ausgewählten Kontos, soweit verfügbar. |
| Kontokorrent-Betrag  | Zusätzlicher, am Bankkonto hinterlegter Betrag.                 |
| Zahlung (ausgewählt) | Summe der markierten Offenen Posten.                            |
| Zahlung (gesamt)     | Summe aller Offenen Posten der aktuellen Selektion.             |
| Bankkonto            | Eigenes Konto für den Lauf.                                     |
| Vorlage              | Zahlungsträgervorlage für den Lauf.                             |

Vorausgewählt sind das aktive Bankkonto mit der Einstellung **»Standard«** und die Zahlungsträgervorlage mit **»Standard für Zahlungsvorlagentyp«**.

Kontosaldo und Kontokorrent-Betrag erscheinen in der Währung des Bankkontos. VARIO Cloud bildet die Summen je Währung, ohne Beträge umzurechnen. Enthält die Selektion mehrere Währungen, zeigt das Summenfeld die Summe in der Kontowährung. Gibt es diese Währung nicht, zeigt es die erste Währung in alphabetischer Reihenfolge. Ein Münzsymbol mit „+“ und der Anzahl weist auf weitere Währungen hin. Fährst Du mit der Maus darüber, siehst Du die Summen aller Währungen.

Für die währungsrichtige Zuordnung **markierter OPs** muss Deine Tabellenvoreinstellung die **OP-Währung** enthalten. Fehlt diese Angabe, ordnet VARIO Cloud die markierten Beträge der Firmenwährung zu. Im Bestätigungsdialog erscheinen bei einer Markierung die Summen aller markierten Währungen nebeneinander.

Drei farbige Summen zeigen Beträge im Skontozeitraum, innerhalb der Nettofrist und nach Ablauf der Nettofrist:

* Grün: im Skontozeitraum.
* Gelb: Skontozeitraum abgelaufen, aber innerhalb der Nettofrist.
* Braun: Nettofrist abgelaufen.

Einfärbung, Restsaldo-Tooltip und Überziehungswarnung beziehen sich ausschließlich auf die **markierten Beträge in Kontowährung**. Andere Währungen werden dabei nicht einbezogen oder umgerechnet. Bei **»Markierte ignorieren«** und bei einem Lauf **ohne Markierung** wird die tatsächlich zu verarbeitende Summe für diese Warnung nicht ermittelt. Eine fehlende Warnung bestätigt deshalb keine ausreichende Kontodeckung für den Lauf. Die Warnung verhindert das Fortfahren nicht. Ohne bekannten Kontosaldo entfallen Einfärbung und Warnung.

#### Offene Posten auswählen

Du kannst einen Lauf auf drei Arten zusammenstellen:

1. Markiere gewünschte OPs und wähle Nur markierte verarbeiten.
2. Markiere auszuschließende OPs und wähle Markierte ignorieren.
3. Markiere nichts. VARIO Cloud verarbeitet alle OPs der aktuellen Filterung.

Ein Klick auf eine Zeile schaltet ihre Markierung um. In der Tabellenansicht markierst Du die erste Zeile und klickst bei gedrückter Umschalttaste auf eine freie Stelle der letzten Zeile des gewünschten Bereichs. Die Auswahl umfasst die dazwischenliegenden, bereits geladenen Zeilen. Über die Links öffnest Du OP, Adresse oder Beleg in einem neuen Tab. Du kannst auch die zuletzt abgelegte Beleg-PDF öffnen.

#### Wertstellungsdatum festlegen

Ist in der Vorlage »Wertstellungsdatum manuell setzen« aktiv, zeigt der Bestätigungsdialog das Pflichtfeld „Wertstellungsdatum“. Das System schlägt ein Datum zwei Tage in der Zukunft vor. Du kannst ein heutiges oder zukünftiges Datum wählen.

Ohne manuelle Vorgabe setzt das System den aktuellen Tag.

#### Lauf starten

1. Prüfe Bankkonto, Vorlage und Filterung.
2. Markiere bei Bedarf einzelne Offene Posten.
3. Klicke auf **»Zahlungen tätigen«**.
4. Wähle bei einer Markierung den Verarbeitungsmodus.
5. Trage bei Bedarf das Wertstellungsdatum ein.
6. Bestätige mit **»Ja«**. Mit **»Nein«** schließt Du den Dialog, ohne einen Lauf zu starten.

VARIO Cloud erstellt den Lauf als Hintergrundtask. Nach dem erfolgreichen Start erscheint die Meldung „Überweisungslauf wurde gestartet. Er läuft im Hintergrund, die Liste aktualisiert sich nach Abschluss.“ Nach der erfolgreichen Erstellung aktualisiert sich die Selektionsliste. Verarbeitete OPs verschwinden daraus.

Die Meldung „Zahllauf erstellt.“ enthält die Aktion »Zahllauf öffnen«. Wurden keine geeigneten OPs gefunden, erscheint „Keine offenen Posten für Zahllauf gefunden.“.

### Was erzeugt ein Zahlungslauf?

VARIO Cloud fasst Offene Posten nach dem **Typ** ihrer Zahlungsart (**Überweisung** oder **Echtzeit-Überweisung**) und dem Wertstellungsdatum zu Zahlungsaufträgen zusammen. Ist in der Vorlage **»Sammelauftrag möglich«** aktiv, ist im Auftrag **»Sammelüberweisung«** eingeschaltet.

Jeder Zahlungsauftrag enthält mindestens einen Zahlungsdatensatz. Dieser verweist in der Regel auf den zugehörigen Offenen Posten.

| Wert             | Quelle oder Berechnung                                                                                                     |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Name             | Abweichender Kontoinhaber, sonst Name der Standardadresse, sonst Anzeigename der Adresse.                                  |
| IBAN und BIC     | Hauptbankverbindung oder einzige Bankverbindung der Adresse.                                                               |
| Betrag           | Offener Betrag abzüglich des zum Wertstellungsdatum gültigen Skontos. Bei OPs mit Zahlungsplan wird kein Skonto abgezogen. |
| Verwendungszweck | Feldvorlage „Verwendungszweck“; ohne Vorlage die Belegnummer.                                                              |

### Erzeugte Zahlungsaufträge prüfen

Wechsle in den zweiten Reiter »Zahlungen«. Die Liste zeigt die erzeugten Aufträge. Klappe einen Eintrag auf, um Zahlungsdatensätze zu sehen. Öffne ihn, um Details zu bearbeiten.

#### Status eines Zahlungsauftrags

| Status                    | Bedeutung im Arbeitsablauf                                                                    |
| ------------------------- | --------------------------------------------------------------------------------------------- |
| Zur Übergabe bereit       | Der Auftrag hat keine bekannten Validierungsfehler.                                           |
| Bei der Bank zur Freigabe | Der Zahlungsanbieter hat den Auftrag vorbereitet. Eine externe Aktion kann erforderlich sein. |
| Verschickt                | Der Auftrag wurde an den Zahlungsanbieter übergeben.                                          |
| Abgebrochen               | Der Auftrag wurde abgebrochen und kann erneut angestoßen werden.                              |
| Fehlerhaft                | Mindestens ein Zahlungsdatensatz enthält einen Validierungsfehler.                            |
| Unbekannt                 | Der Zahlungsanbieter lieferte einen nicht aufgelösten Status.                                 |

#### Fehlerhafte Aufträge korrigieren

Öffne einen Auftrag mit dem Status Fehlerhaft. In der Übersicht siehst Du Datensatzanzahl, Gesamtbetrag, Wertstellungsdatum und Bankkonto.

Fehlerhafte Datensätze sind hervorgehoben und zeigen die Meldungen direkt an.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FJNhKlIrM6vLCkSyTuEG3%2Fimage.png?alt=media&amp;token=511c8471-4513-42c1-9ac3-1ae6f7419377" alt=""><figcaption></figcaption></figure>

Du kannst den Auftrag im Formular- oder Tabellenmodus anzeigen:

* Im Formularmodus bearbeitest Du alle Felder des Auftrags und seiner Datensätze.
* Im Tabellenmodus werden Datensätze nach Empfänger oder Adresse gruppiert.
* Im Tabellenmodus kannst Du die Bankverbindung wechseln, Datensätze ergänzen oder löschen.

| Feld           | Bearbeitung und Prüfung                                             |
| -------------- | ------------------------------------------------------------------- |
| Empfänger      | Darf nicht leer sein.                                               |
| IBAN           | Außerhalb von Banking-Apps erforderlich und auf Gültigkeit geprüft. |
| BIC            | Kann bearbeitet werden.                                             |
| Betrag         | Muss größer als 0 sein.                                             |
| Zweck          | Darf nicht leer sein.                                               |
| Offener Posten | Verknüpfter OP, der aus dem Datensatz geöffnet werden kann.         |

Änderst Du einen Betrag, warnt VARIO Cloud vor einer Unter- oder Überzahlung. Die Warnung verhindert das Speichern nicht.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2Fp6McvGvwIsf1w9gZDIRt%2Fimage.png?alt=media&amp;token=3632ce73-d97b-4aca-bac5-f5732d26dcd5" alt=""><figcaption></figcaption></figure>

#### Auftrag oder Datensatz neu prüfen

Klicke nach Korrekturen auf **»Neu prüfen«**. VARIO Cloud ergänzt fehlende Werte aus der Adresse des zugehörigen OPs. Danach prüft das System alle Datensätze erneut. Bereits gefüllte Werte bleiben erhalten.

Ein Auftrag wechselt erst von Fehlerhaft zu Zur Übergabe bereit, wenn kein Validierungsfehler mehr vorliegt.

#### Felder, die nach dem Anlegen feststehen

Bei einer bestehenden Zahlung kannst Du eigenes Bankkonto und Zahlungstyp nicht ändern.

Aufträge können nur im Status Zur Übergabe bereit oder Fehlerhaft bearbeitet und geprüft werden. Aufträge bei der Bank zur Freigabe sowie verschickte, abgebrochene oder unbekannte Aufträge lassen sich im normalen Formular nicht ändern.

### Zahlungslauf durchführen

Bei einem geöffneten Lauf stehen in der Kopfzeile die Aktionen **»Zahllauf«** und **»Zahllauf stornieren«** zur Verfügung.

1. Korrigiere alle fehlerhaften Aufträge, die verarbeitet werden sollen.
2. Klicke auf **»Zahllauf«**.
3. VARIO Cloud berücksichtigt alle Aufträge, die nicht Fehlerhaft oder Verschickt sind.

Der Lauf wird verarbeitet, sobald mindestens ein Auftrag berücksichtigt werden konnte. Fehlerhafte Aufträge werden ausgelassen. Sind alle Aufträge fehlerhaft, bleibt der Lauf unverarbeitet.

{% hint style="info" %}
**Wichtig**

Die Aktion **»Zahllauf«** versendet keine Aufträge. Übergib jeden gewünschten Auftrag anschließend an die Bank oder Banking-App.
{% endhint %}

### Freie Überweisung anlegen

Eine freie Überweisung ist ein Zahlungsauftrag, den Du ohne Zahlungslauf und ohne Offenen Posten erfasst.

1. Wechsle in den Reiter »Zahlungen«.
2. Klicke auf **»Freie Überweisung (Beta)«**.
3. Wähle den **Typ**: **Überweisung** oder **Echtzeit-Überweisung**.
4. Prüfe das **Bankkonto**. Vorausgewählt ist das Standard-Konto.
5. Trage das **Wertstellungsdatum** ein.
6. Erfasse **Empfänger**, **IBAN**, **BIC**, **Betrag** und **Zweck**. Über **»Empfänger hinzufügen«** ergänzt Du weitere Empfänger.
7. Speichere den Auftrag.

Beim Speichern prüft VARIO Cloud die Datensätze wie bei einem Zahlungslauf. Danach öffnet sich der neue Auftrag. Du übergibst ihn wie jeden anderen Auftrag an die Bank.

### Zahlungsauftrag an die Bank übergeben

In der Liste der Zahlungen findest Du rechts am Auftrag die Übergabeaktion.

#### Übergabe über eine Bankschnittstelle

Bei Zur Übergabe bereit oder Abgebrochen startet die Aktion die Übergabe. Benötigt der Anbieter eine Weboberfläche, öffnet VARIO Cloud diese in einem neuen Fenster. Anschließend wird der Status regelmäßig geprüft.

Für die Übergabe muss Dein eigener [Bankschnittstellenbenutzer](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-finanzen/onlinebanking.md#bankschnittstellenbenutzer) mit dem Bankkonto verbunden sein. Liegt das Wertstellungsdatum bei der Übergabe in der Vergangenheit, setzt VARIO Cloud es auf den aktuellen Zeitpunkt.

Hat der Auftrag den Status Bei der Bank zur Freigabe, ruft VARIO Cloud die ausstehende Aktion des Anbieters ab und öffnet dessen Weboberfläche.

Sobald Du einen Auftrag über ein Webformular der Bank übergeben hast, hat er den Status **Bei der Bank zur Freigabe** und bleibt dort, bis das Webformular abgeschlossen, abgebrochen oder abgelaufen ist. Solange der Auftrag diesen Status hat, kannst Du ihn nicht erneut übergeben. So landet derselbe Auftrag nicht doppelt bei der Bank.

* Hast Du das Webformular noch nicht abgeschlossen, bietet Dir die Aktion **„Bestätige Deinen Auftrag bei der Bank“** an, das offene Webformular erneut zu öffnen. Die Aktion siehst nur Du als der Benutzer, der den Auftrag übergeben hat.
* Schließt Du das Webformular bei der Bank ab, wechselt der Auftrag auf **Verschickt**.
* Brichst Du das Webformular ab oder läuft es ab, wechselt der Auftrag auf **Abgebrochen**. Die zugehörigen Offenen Posten sind wieder für einen neuen Zahlungsvorgang frei, und Du kannst den Auftrag erneut übergeben.

VARIO Cloud prüft den Status von Aufträgen mit dem Status Bei der Bank zur Freigabe, die in der letzten Stunde übergeben wurden, jede Minute automatisch. Schließt Du das Webformular erst später ab oder hast Du den Browser geschlossen, aktualisierst Du den Status über **»Zahlungsstatus prüfen«**.

{% hint style="info" %}
Erscheint beim Übergeben die Meldung **„Der Benutzer hat keine Verbindung zu Bankkonto …“**, fehlt Deinem Cloud-Benutzer die Verbindung zum verwendeten Bankkonto. Eine Verbindung eines anderen Mitarbeiters genügt nicht. Wie Du Deine eigene Verbindung herstellst, findest Du unter Onlinebanking: [Verbindung zum Bankkonto herstellen](https://help.vario-software.de/vario-cloud-handbuch/einstellungen/einstellungen-finanzen/onlinebanking.md#weitere-benutzer-mit-einer-vorhandenen-bank-verbinden).
{% endhint %}

#### Übergabe über eine Banking-App

Ist das Bankkonto mit einer Banking-App verknüpft, öffnet die Aktion den Dialog der passenden installierten App. Die weiteren Schritte hängen von der App ab.

Bei **dateibasiertem Banking** erzeugst Du eine PAIN-Datei und reichst sie anschließend selbst bei Deiner Bank ein. Der Status **Verschickt** bestätigt hier keine Annahme oder Ausführung durch die Bank. Die Schritte und Voraussetzungen findest Du unter [Dateibasiertes Banking](https://help.vario-software.de/vario-cloud-handbuch/finanzen/dateibasiertes-banking.md#pain-dateien-fur-zahlungsauftrage-erstellen).

#### Zahlungsstatus aktualisieren

Öffne das Kontextmenü eines Zahlungsauftrags und wähle »Zahlungsstatus prüfen«. VARIO Cloud fragt den Status beim Zahlungsanbieter ab und aktualisiert die Liste.

### Zahlungslauf stornieren

Ein unverarbeiteter und nicht stornierter Lauf kann über **»Zahllauf stornieren«** aufgelöst werden:

1. Öffne den betreffenden Lauf.
2. Klicke auf **»Zahllauf stornieren«**.
3. Bestätige den Dialog.

VARIO Cloud setzt alle nicht verschickten Aufträge des Laufs auf Abgebrochen. Alle verknüpften Offenen Posten werden für neue Zahlungsvorgänge freigegeben. Das gilt auch für OPs eines verschickten Auftrags. Der Auftrag selbst bleibt Verschickt.

{% hint style="info" %}
**Wichtig**

Storniere einen Lauf nicht, wenn Aufträge bereits übergeben wurden. Prüfe zuerst den tatsächlichen Bankstatus.
{% endhint %}

Nach einem verarbeiteten oder stornierten Lauf sind beide Laufaktionen gesperrt.

### Zahlungsauftrag oder Datensatz löschen

Mit der passenden Löschberechtigung kannst Du einen Zahlungsauftrag, Empfängerblock oder einzelnen Zahlungsdatensatz löschen.

Löschst Du einen mit einem OP verknüpften Datensatz, wird der OP wieder für einen neuen Zahlungsvorgang freigegeben. Enthält der Auftrag danach keinen Datensatz mehr, wird auch der Auftrag gelöscht.

{% hint style="info" %}
**Wichtig**

Prüfe vor dem Löschen den tatsächlichen Stand beim Zahlungsanbieter. Die Löschfunktion setzt die interne Zahlungszuordnung des Offenen Postens zurück.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.vario-software.de/vario-cloud-handbuch/finanzen/zahlungen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
