# aforms

## Allgemein

aforms ist ein Unternehmen spezialisiert auf die Erstellung und Verwaltung von digitalen
\
Formularen für E-Government und E-Business. Mit der Software AFS können Behörden und Unternehmen mehrsprachige, barrierefreie und standardkonforme Formulare ohne
\
Programmierkenntnisse erstellen – online, mobil oder als PDF.

### Links

* [Webseite](https://www.aforms.com/) von aforms
* [Formularerstellung](https://www.aforms.com/produkte/designer-formserver/) mit aforms

## Integration

Die folgende Anleitung zeigt Dir, wie Du Payrexx im AFS-Designer von aforms solutions & services einbindest.

{% hint style="info" %}
Bitte beachte, dass die Integration in aforms nur in den Preisplänen Standard und Premium verfügbar ist. [Weitere Informationen](https://payrexx.com/de-ch/preise)
{% endhint %}

### Konfiguration von Payrexx

{% hint style="info" %}
Bitte beachte, dass Du bei Payrexx [eingeloggt](https://login.payrexx.com/de) sein musst, bevor Du beginnst. Falls Du noch kein Konto hast, [registriere](https://signup.payrexx.com/de/email-validation/) Dich bitte bei Payrexx.
{% endhint %}

* Navigiere im Hauptmenü Deiner Händler-Administration zu **API und Integrationen**.
* Scrolle hinunter zu "API-Integration hinzufügen" und klicke auf "API-Schlüssel hinzufügen":

<div align="left"><figure><img src="/files/gb5soqkuJRuwqHFaFBOQ" alt=""><figcaption><p>Hinzufügen eines API-Schlüssels für die Integration von aforms</p></figcaption></figure></div>

* Gib der Integration einen beliebigen Namen, zum Beispiel "aforms".
* Klicke auf "Hinzufügen":

<div align="left"><figure><img src="/files/Ro9PAjtgLdNndZA8fwLL" alt="" width="563"><figcaption><p>Klick auf "Hinzufügen", um den API-Schlüssel zu generieren</p></figcaption></figure></div>

* Du findest den neuen API-Schlüssel nun unter "Aktive Integrationen".
* Klicke auf "Kopieren", um den API-Schlüssel in die Zwischenablage zu kopieren. Du wirst ihn in einem späteren Schritt benötigen:

<div align="left"><figure><img src="/files/G6Q7XxubT0dvpTGlACZj" alt=""><figcaption><p>Kopieren des API-Schlüssels in die Zwischenablage für die spätere Verwendung in aforms</p></figcaption></figure></div>

### Konfiguration von aforms

#### Formserver Property

* Navigiere im AFS-Designer zu **Administration > Ressourcen**:

<figure><img src="/files/DXs725ZNqgJiAooxpzIm" alt=""><figcaption><p>Start der Konfiguration im AFS-Designer</p></figcaption></figure>

* Suche in der Ressourcenliste eine Formserver-Property oder erstelle mit dem Plus-Symbol eine neue:

<div align="left"><figure><img src="/files/Ci9AapJm5p7m7kRiuCWE" alt=""><figcaption><p>Erstellen einer Formserver-Property</p></figcaption></figure></div>

* Trage deine Properties ein und speichere mit dem Haken-Symbol:

<div align="left"><figure><img src="/files/gCmgU63OEj8ZuaJ49hvc" alt=""><figcaption><p>Eintragen der Properties</p></figcaption></figure></div>

Beispiele Formserver-Property:

```
# Payrexx-URLcom.anecon.afs.common.extender.payrexx.url=
```

Erster Teil (bis zum ersten Punkt) der URL der Payrexx-Administration:

```
https://aforms2web.payment...com.anecon.afs.common.extender.payrexx.instanceId=xxx
```

Default API-Key aus der Payrexx-Administration:

```
com.anecon.afs.common.extender.payrexx.secret=xxx
```

{% hint style="info" %}
Ersetze "xxx" mit dem API-Schlüssel, den Du während der Konfiguration von Payrexx in die Zwischenablage kopiert hast.
{% endhint %}

Währung:

```
com.anecon.afs.common.extender.payrexx.currency=xxx
```

#### Formular, Seite und Block

* Navigiere im Menü zu **Formulare** und erstelle über das Plus-Symbol ein neues Formular:

<div align="left"><figure><img src="/files/Kgge65uSfQXqMY5CFH5g" alt=""><figcaption><p>Erstellen eines neuen Formulars</p></figcaption></figure></div>

* Gib den Formularnamen, die General-ID und die Beschreibung des Formulars ein:

<div align="left"><figure><img src="/files/UAqQ8WX4Ei6TFM453xTx" alt=""><figcaption><p>Konfiguration des Formulars</p></figcaption></figure></div>

* Lege eine neue Formularseite an, fülle die entsprechenden Felder aus und speichere Deine Einstellungen:

<div align="left"><figure><img src="/files/xam6y2a6J6G3OWVSp8Ye" alt=""><figcaption><p>Konfiguration der neuen Formularseite</p></figcaption></figure></div>

* Erstelle innerhalb der angelegten Formularseite einen neuen Block:

<div align="left"><figure><img src="/files/l0nTEZJ515Fdl56De8Ya" alt=""><figcaption><p>Erstellen eines neuen Blocks</p></figcaption></figure></div>

* Füge dem neu erstellen Block die erforderlichen Felder hinzu:

<div align="left"><figure><img src="/files/UuDzcKmyxI58w0rfv6jZ" alt=""><figcaption><p>Konfiguration des Blocks</p></figcaption></figure></div>

* Erstelle das Layout des Blocks automatisch per Klick auf das Tabellen-Symbol, benenne die Feldnamen und Leittexte für das Layout und speichere den Block:

<div align="left"><figure><img src="/files/xLZHGWQFi1VuCK6e9AjM" alt=""><figcaption><p>Erstellen des Layouts für den Block</p></figcaption></figure></div>

* So sieht der angelegte Block aus:

<div align="left"><figure><img src="/files/STcKnDdsbZGaD56JWRag" alt=""><figcaption><p>Anzeigen des Blocks</p></figcaption></figure></div>

* Platziere den neu erstellten Block auf der ersten Seite des Formulars:

<div align="left"><figure><img src="/files/N94oLH7G6gJMfsOpeU9C" alt=""><figcaption><p>Platzieren des Blocks</p></figcaption></figure></div>

* Speichere die Seiten- und Formulardetails per Klick auf das Haken-Symbol. Formular, Seite und Block sind nun bereit für die Anbindung an Payrexx.

#### Erstellen und Konfigurieren des Extenders

{% hint style="info" %}
Mit dem Payrexx-Extender kannst Du den Nutzern des Formulars die Möglichkeit bieten, direkt beim Absenden eine Zahlung vorzunehmen. Die Kommunikation zwischen AFS und Payrexx erfolgt über REST-Webservices. Diese Funktion steht Dir auf Formularebene zur Verfügung.
{% endhint %}

* Erstelle mittels Klick auf das Plus-Symbol einen neuen Extender auf Formularebene:

<div align="left"><figure><img src="/files/gka6TcFxN8EanvVdMq3K" alt=""><figcaption><p>Erstellen eines Extenders</p></figcaption></figure></div>

* Wähle in der Auswahl der Extender die Option "Formular: Payrexx":

<div align="left"><figure><img src="/files/rcLktExTvUR9OVwbA7uJ" alt=""><figcaption><p>Erstellen eines Extenders vom Typ "Formular: Payrexx"</p></figcaption></figure></div>

* Konfiguriere den Extender gemäss Deinen Anforderungen und speichere ihn per Klick auf das Haken-Symbol:

<div align="left"><figure><img src="/files/Ej9ow44PIuhFOYll0izh" alt=""><figcaption><p>Konfiguration des Extenders</p></figcaption></figure></div>

* Mittels der Bedingung =#V1=="1" (SpeL-Ausdruck) wird der Extender nur ausgeführt, wenn im Formular die Zahlungsmethode "Kreditkarte" gewählt wurde:

<div align="left"><figure><img src="/files/yqnAuZiRytpaJCXXv9m6" alt=""><figcaption><p>Ausführung des Extenders auf Bezahlart "Kreditkarte" beschränken</p></figcaption></figure></div>

* So sieht die Auswahl der Zahlungsmethode im Formular aus:

<div align="left"><figure><img src="/files/AMOSsBrH7XhlQATdrAPt" alt="" width="231"><figcaption><p>Auswahl der Zahlungsart</p></figcaption></figure></div>

{% hint style="info" %}
Bitte beachte, dass die Zahlungsart "Kauf auf Rechnung" immer angezeigt wird.
{% endhint %}

* Über den Formularbaum können die Felder im Extender zugeteilt werden:

<div align="left"><figure><img src="/files/zMXU6AjxH55uWauajUNY" alt=""><figcaption><p>Zuteilung der Felder im Extender</p></figcaption></figure></div>

**Verwendung der Felder:**

* **Zahlungsvermerk:** Der Zahlungsvermerk setzt sich aus der Reference-ID und dem Formulartitel zusammen und dient der Identifikation der Zahlung in der Inbox/APF.
* **Reference-ID:** Die Reference-ID ist eine Unique ID, über die die Zahlung identifiziert werden kann.
* **Betrag:** Transaktionsbetrag
* **Vorname:** Vorname des Antragstellers
* **Nachname**: Nachname des Antragstellers
* **E-Mail-Adresse für Zahlungsbestätigung:** An diese E-Mail-Adresse werden die Rechnung und die Zahlungsbestätigung versandt.

**Verwendungszweck in der Rechnung (Produktbeschreibung):**

<div align="left"><figure><img src="/files/sByD62zzx9D4nwIL8Sk3" alt=""><figcaption><p>Rechnung mit Verwendungszweck (Produktbeschreibung)</p></figcaption></figure></div>

#### Formularsammlung übertragen

* Mit einem Klick auf das Pfeilsymbol wird die Formularsammlung an den Formserver übermittelt und dadurch online verfügbar gemacht:

<div align="left"><figure><img src="/files/V3Hps9oOYUrMlYwCp67v" alt=""><figcaption><p>Übermittlung der Formularsammlung an den Formserver</p></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payrexx.com/merchant/integration/unternehmenssoftware/aforms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.