# Tocco

## Allgemein

Tocco ist eine cloudbasierte, modulare ERP-Lösung aus der Schweiz, die speziell auf die Bedürfnisse von Bildungseinrichtungen, Verbänden, Fundraising-Organisationen und Non-Profit-Organisationen zugeschnitten ist.

Die Software beinhaltet unter anderem CRM-Funktionen, Veranstaltungs- und Kursmanagement, Ressourcenplanung, Rechnungsstellung und Dokumentenverwaltung.

Durch die Integration von Payrexx können sich Nutzer bei Tocco für eine Veranstaltung registrieren und direkt über die Zahlungslösung von Payrexx bezahlen.

### Links

* Webseite von [Tocco](https://www.tocco.ch/)

### Funktionen

* Anmeldung für Veranstaltungen
* Bezahlung der Gebühren für Veranstaltungen

## Integration

In den nächsten Kapiteln erfährst Du, wie Du die Zahlungslösung von Payrexx in Tocco integrierst.

### 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 %}

#### Erstellen eines API-Schlüssels

* 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="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FLuGgWYbJWxQiDQzvAcwj%2Fimage.png?alt=media&#x26;token=1bd4a4f8-3ad8-4ddb-b7eb-ef3ad88c15f2" alt=""><figcaption><p>Hinzufügen eines API-Schlüssels in Payrexx</p></figcaption></figure></div>

* Gib der Integration einen beliebigen Namen, zum Beispiel "Tocco".
* Klicke auf die Schaltfläche "Hinzufügen", um den API-Schlüssel zu erstellen:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FByKFR692moLjIzQyyLFy%2Fimage.png?alt=media&#x26;token=dc344ed7-697d-4346-b395-6021286367ff" alt="" width="563"><figcaption><p>Erstellen eines API-Schlüssels in Payrexx</p></figcaption></figure></div>

* Kopiere den API-Schlüssel in die Zwischenablage. Du benötigst ihn später bei der [Konfiguration von Tocco](#konfiguration-von-tocco):

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FEvkaMyhfwSrX7vdlhleR%2Fimage.png?alt=media&#x26;token=c9260b45-9ad8-4925-b8f3-966f444d59b7" alt=""><figcaption><p>Kopieren des API-Schlüssels in die Zwischenablage</p></figcaption></figure></div>

### Konfiguration von Tocco

#### Erstellen des Payrexx-Datensatzes

* Logge Dich in Dein Konto bei Tocco ein.
* Öffne das Datenobjekt "Payrexx-Konto":

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FkKGwtLjFp7dZPSkfjco7%2Fimage.png?alt=media&#x26;token=5d48c3b9-ea3a-444e-8791-a1b6cf6eac08" alt=""><figcaption><p>Öffnen des Datenobjekts "Payrexx-Konto" in Tocco</p></figcaption></figure></div>

* Erstelle einen neuen Datensatz und konfiguriere ihn wie folgt:
  * **Kürzel:** Wähle ein beliebiges Kürzel.
  * **Bezeichnung:** Wähle eine beliebige Bezeichnung für die Anzeige im System und erfasse sie in den verschiedenen Sprachen.
  * **Sortierung:** Lege die Sortierung für die Anzeige im System fest.
  * **Konto:** Wähle das buchhalterische Konto, das bei den Zahlungseingangs-Belegen dieses Payrexx-Kontos als Sollkonto verwendet werden soll.
  * **Standard:** Wenn Du die Checkbox aktivierst, wird das Payrexx-Konto als Standard-Konto markiert. Dieses wird dann verwendet, wenn in den E-Payment-Einstellungen kein anderes Konto konfiguriert ist.

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2FnsF4lIkmqYDgsizYsUmt%2Fimage.png?alt=media&#x26;token=b2cb2877-3540-47e2-8110-6238226f1634" alt=""><figcaption><p>Konfiguration des Datensatzes in Tocco</p></figcaption></figure></div>

* Klicke auf "Erstellen", um das Payrexx-Konto anzulegen.
  \\

#### Herstellen der Verbindung zu Payrexx

* Wähle die Aktion "Payrexx-Logindaten setzen".
* Erfasse den Instanznamen Deines Payrexx-Kontos im Feld "Payrexx-Instanz". Der Instanzname entspricht dem ersten Teil Deiner Payrexx-URL. Wenn die URL *beispiel*.payrexx.com ist, so lautet der Instanzname *beispiel*.
* Füge den zuvor in die Zwischenablage kopierten API-Schlüssel ins Feld "API-Key" ein:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2Fow6lmHoCSuG7LCP64eYI%2Fimage.png?alt=media&#x26;token=6793e37d-f838-4687-a540-5a611f271ab2" alt=""><figcaption><p>Eingabe von Instanznamen und API-Schlüssel in Tocco</p></figcaption></figure></div>

{% hint style="info" %}
Es wird geprüft, ob die eingegebenen Daten korrekt sind. Falls ja, wird die Verbindung aktiviert. Falls nein, wird eine Fehlermeldung angezeigt.
{% endhint %}

* Wähle in der Liste das gewünschte Konto aus (Mehrfachauswahl möglich) und klicke auf "Zahlungsarten importieren".

{% hint style="info" %}
Wenn in Payrexx neue Zahlungsarten dazukommen, kannst Du sie erneut importieren. Die Aktion löscht allerdings keine bestehenden Daten. Stehen Zahlungsarten in Payrexx nicht mehr zur Verfügung, musst Du sie in Tocco manuell deaktivieren oder löschen.
{% endhint %}

#### Kopieren der Webhook-URL

Damit die Zahlungseingänge von Payrexx an Tocco übermittelt werden können, muss ein Webhook eingerichtet werden:

* Kopiere hierfür im Datensatz "Payrexx-Konto" den Wert des Feldes "Webhook-URL" in die Zwischenablage.&#x20;

### Konfiguration von Payrexx

Melde Dich nun wieder in Deinem Payrexx-Konto an, um den Webhook zu erstellen.

#### Erstellen des Webhooks

* Navigiere im Hauptmenü Deines Payrexx-Kontos zu **Webhooks**.
* Klicke auf "Webhook hinzufügen".
* Konfiguriere den Webhook anhand der folgenden Einstellungen:

<div align="left"><figure><img src="https://3244062149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-543259558%2Fuploads%2F0Tvx2p7F8Hsoaskqc5dQ%2Fimage.png?alt=media&#x26;token=72637fca-8e08-4beb-a2ed-8b48e68c5c1b" alt=""><figcaption><p>Konfiguration des Webhooks in Payrexx</p></figcaption></figure></div>

1. **Name:** Vergib einen Namen für den Webhook, zum Beispiel "Tocco" (optional).
2. **Webhook URL:** Füge die URL des Webhooks ein, die Du zuvor in [Tocco](#kopieren-der-webhook-url) in die Zwischenablage kopiert hast.
3. **Ereignisse:** Aktiviere die Checkbox bei "Transaction".
4. **Webhook Inhaltstyp:** Wähle die Option "JSON" aus.
5. **Webhook-Version:** Wähle 2023-11-14 oder ein aktuelleres Datum.

Klicke auf "Hinzufügen", um den Webhook zu erstellen.

{% hint style="success" %}
Die Integration von Payrexx in Tocco ist abgeschlossen.
{% endhint %}


---

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