> For the complete documentation index, see [llms.txt](https://helpcenter.etron.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.etron.info/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/kasse/integrationen.md).

# ⚙️ Integrationen

> *Einstellungen -> Kasse -> Integrationen*

## cituro

{% hint style="success" %}
*Modul: cituro*
{% endhint %}

cituro ist ein leistungsstarker und benutzerfreundlicher Terminkalender, der bei der effizienten Verwaltung von Terminen und Zeitplänen hilft. Er ermöglicht die einfache Organisation von Kundenbuchungen, das Einrichten automatischer Erinnerungen und die Übersicht über alle anstehenden Termine.

{% hint style="info" %}
*Verwendung der Terminbuchung innerhalb der Kasse:* [cituro Terminbuchung](/kasse/verkaufsoberflache/cituro-terminbuchung.md)
{% endhint %}

{% hint style="info" %}
*Im Helpcenter von cituro finden sich weitere Informationen, z.B. wie ein cituro Account eingerichtet wird :* [*https://www.cituro.com/help/*](https://www.cituro.com/help/)

*Erste Schritte:* [*https://www.cituro.com/help/erste-schritte-mit-cituro*](https://www.cituro.com/help/erste-schritte-mit-cituro)
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/ixV136RZ6TWKoEkmScRZ" alt=""><figcaption><p>ETRON onRetail -> Einstellungen -> Kasse -> Integrationen -> cituro</p></figcaption></figure></div>

In den Einstellungen von ETRON onRetail können die Daten von cituro für die Anzeige der Terminbuchung in der Kasse eingetragen werden.

Dadurch lassen sich cituro-Buchungen in der Kasse aufrufen. Wurde eine Buchung bereits über cituro gezahlt, ist das bei der Terminbuchung ebenso ersichtlich.&#x20;

### API Schlüssel / API Key

<div data-with-frame="true"><figure><img src="/files/NS26klJi4rtbFRZ8XDsD" alt=""><figcaption></figcaption></figure></div>

Der benötigte API Schlüssel zum Verbinden von ETRON onRetail und cituro befindet sich in der cituro-Oberfläche unter **Einstellungen -> Sicherheit -> API Keys.**

<figure><img src="/files/dyBewF4DOsIltYPDXfJX" alt=""><figcaption><p>cituro -> Einstellungen -> Sicherheit -> API Keys</p></figcaption></figure>

#### API Schlüssel anlegen

Um einen neuen API Schlüssel zu erstellen, muss ![](/files/nfgKJxkF2oAGDf7eJzQR) ausgewählt werden. Dadurch wird ein Fenster geöffnet, welches eine Bezeichnung und bevorzugte Rolle anfordert. Für die Anbindung zu ETRON onRetail soll die Rolle "Administrator" ausgewöhlt werden.

<figure><img src="/files/djCcv0LDCJgpLJgGC8nz" alt=""><figcaption><p>cituro -> Einstellungen -> Sicherheit -> API Keys -> Button: API-Schlüssel hinzufügen</p></figcaption></figure>

#### API Schlüssel einsehen

<figure><img src="/files/mW5G9xbSGitGGACFDsn0" alt=""><figcaption><p>cituro -> Einstellungen -> Sicherheit -> API Keys -> Erweiterte Optionen -> Fokus auf "API Key aktualisieren"</p></figcaption></figure>

Nach der Erstellung des API Keys kann über die Option "\</> API Key aktualisieren" der Schlüssel eingesehen und für die Einbindung in ETRON onRetail kopiert werden.

<figure><img src="/files/34SWckf92mkZNEIQ4m2F" alt=""><figcaption><p>Anzeigefenster bei Auswahl von "API Key aktualisieren" und Möglichkeit zum Kopieren des API-Schlüssels</p></figcaption></figure>

### Modus

<div data-with-frame="true"><figure><img src="/files/dgpfZWayxfo8VJTrJAaX" alt=""><figcaption></figcaption></figure></div>

Bei der Einstellung ***Modus*** gibt es folgende Möglichkeiten:

* Live (Liveumgebung, Server von cituro)
* Test (Testumgebung, Testserver)

Die Verbindung kann über den Button  ![](/files/RlLpVtacfaGLMQKLdU3G) getestet werden.

### Produkt

<div data-with-frame="true"><figure><img src="/files/YMGbxaiFlh5XLcaQAttm" alt=""><figcaption></figcaption></figure></div>

Hier muss ein cituro-Produkt in ETRON onRetail angelegt und ausgewählt werden. Es wird als Stammdatenprodukt angelegt. Dieses Produkt wird im Verkauf verwendet, wenn das Produkt in cituro nicht mit einem Produkt in ETRON onRetail verknüpft ist. Wie eine Produktverknüpfung zwischen cituro und ETRON erfolgt, wird im nächsten Abschnitt erläutert.

### Bezahlmittel (cituro-Onlinezahlung)

<div align="left" data-with-frame="true"><figure><img src="/files/qhdBmMPjvnjsY65xedtB" alt=""><figcaption></figcaption></figure></div>

Bereits über die [cituro Terminbuchung](/kasse/verkaufsoberflache/cituro-terminbuchung.md) vorgenommene Zahlungen werden in der Kasse erkannt. Für die Abrechnung und Berücksichtigung von cituro Zahlungen in dem Umsätzen, muss eine Zahlungsmethode für cituro hinterlegt werden. Diese kann z.B. "cituro online" genannt werden. Als Journal für die Zahlungsmethode wird "cituro-Online" ausgewählt.&#x20;

{% hint style="warning" %}
***Die Zahlungsmethode für cituro muss  in den Kasseneinstellungen im Feld "Bezahlmittel" und unter*** [***Zahlung -> Zahlungsmethoden***](/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/kasse/zahlung.md#zahlungsmethoden) ***hinterlegt werden.***&#x20;

![](/files/gOfBMgq3JHhU0hbRvp0r)
{% endhint %}

{% hint style="info" %}
*Um von cituro-Onlinezahlungen die Steuern richtig abrechnen zu können, müssen alle Steuersätze, die bei Produkten in der cituro-Oberfläche hinterlegt sind, auch in der Verwaltungsoberfläche unter* [*Konfiguration -> Fibu Daten -> Steuern*](/verwaltungsoberflache/konfiguration/fibu-daten/steuern.md#steuersatz-ubersicht) *existieren.*&#x20;

![](/files/8ZHgTkHZnjzDVJVbqsb3)
{% endhint %}

#### Produktverlinkung zwischen ETRON und cituro

Um die Zusammenarbeit von cituro und ETRON onRetail optimal zu nutzen, empfiehlt es sich die Produkte von cituro mit ETRON onRetail zu verbinden.

Wenn die Produkte/Dienstleistungen in cituro angelegt wurden, erhalten diese eine Service ID.

<figure><img src="/files/Zkz5MxMZuBb9faGuoBZD" alt=""><figcaption></figcaption></figure>

Mit einem Klick auf Service ID wird diese in die Zwischenablage kopiert. Diese ID wird unter „Stammdaten -> Produkte -> Produkte“ direkt im Stammblatt des gleichen Artikels in ETRON onRetail ím Feld "Interne Referenz" hinterlegt. Wenn im Feld bereits etwas hinterlegt wurde, muss dies mit der Service ID überschrieben werden.

Produkte die verbunden sind, werden automatisch bei der Terminübernahme im Warenkorb erkannt und die Umsätze auf die Produkte in ETRON onRetail gebucht. Produkte die nicht verbunden oder bekannt sind, werden auf das [cituro Produkt](#produkt) gebucht, der Name der Leistung/des Produkts und der Preis werden festgehalten.

#### Mitarbeiterverlinkung

Der Mitarbeiter muss in ETRON onRetail genauso benannt werden wie in cituro, damit der Kassenmitarbeiter seinen Kalender einsehen kann.

#### **Kundendaten**

Ist bei einem cituro-Termin ein Kunde hinterlegt, wird der Kunde nach dem Abrechnen des Termins in der Kasse in ETRON onRetail angelegt und wird bei weiteren Terminbuchungen automatisch dem Verkauf zugeordnet.

## Planet

{% hint style="success" %}
*Modul: Planet*
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/Y2edDOlVqEPA6lL5yXKH" alt=""><figcaption><p>Einstellungen > Kasse > Integrationen > Planet</p></figcaption></figure></div>

{% hint style="info" %}
*Für die Verwendung von Planet muss bei den* [*Unternehmensdaten*](/verwaltungsoberflache/einstellungen/benutzer-und-unternehmen/unternehmen.md) *die USt-IdNr. (Tax-ID) hinterlegt sein.*
{% endhint %}

### Planet Modus

Für die Benutzung von Planet kann zwischen dem **Live-Modus** (reale Umgebung) und dem **Test-Modus** gewählt werden.

### Händler ID / Aktivierungscode

Wenn ein Vertrag mit der Firma Planet Payment zum Abwickeln von steuerfreien Rechnungen vorliegt, können hier pro Kassenplatz die Vertragsdaten von Planet eingetragen werden.&#x20;

### Produkt

Für die Benutzung von Planet muss ein Produkt angelegt und eingestellt werden (Verwendung bei Buchungen, Rechnungen), dieses kann z.B.  "Planet TaxFree" genannt werden.

<mark style="color:$info;">**Weitere Informationen:**</mark> \
[TaxFree / Planet](/kasse/verkaufsoberflache/tax-free-planet.md)


---

# 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 dynamically by asking a question.

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

```
GET https://helpcenter.etron.info/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/kasse/integrationen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.