# Anleitung für das Taler Merchant Portal

## Anmeldung im Taler Merchant Portal

Um sich im Taler Merchant Portal anzumelden, öffnen Sie [my.taler-ops.ch](my.taler-ops.ch) in Ihrem Browser.

![](../images/merchant/my_taler_ops_ch_qr.svg)

Geben Sie den Benutzernamen und das Passwort ein, das Sie bei der Registrierung verwendet haben.

Wählen Sie aus, wie Sie Ihre Anmeldung bestätigen möchten: durch den Erhalt eines Codes per E-Mail oder per SMS. 
Nachdem Sie den Code erhalten haben, geben Sie ihn in das Feld ein und klicken Sie auf **Prüfen**.

## Bestellverwaltung

Wenn eine Kundin oder ein Kunde den Zahlungs-QR-Code scannt und die Bestellung bezahlt, erscheint eine neue Bestellung im Taler Merchant Portal. Um Bestellungen anzuzeigen, wählen Sie im Menü **Bestellungen** aus.

Im Reiter **Neu** sehen Sie alle Bestellungen, die auf Zahlung warten.

![](../images/merchant/new-order-de.png)

\newpage

Wenn eine Bestellung bezahlt wurde, wird sie in den Reiter **Bezahlt** verschoben.

Sie können auf die Bestellung klicken, um ihre Details anzuzeigen.

![](../images/merchant/paid-order-de.png)


## Kategorien hinzufügen

Kategorien werden verwendet, um Produkte in der Point-of-Sale-Anwendung zu gruppieren. Wenn Sie nicht planen, 
die Point-of-Sale-Anwendung oder die Bestandsverwaltung zu verwenden, können Sie diesen Schritt überspringen.

Wählen Sie im Menü **Kategorien** aus.

![](../images/merchant/category-page-de.png)

\newpage

Um eine neue Kategorie hinzuzufügen, klicken Sie auf die Schaltfläche **+**.

![](../images/merchant/category-page-2-de.png)

Eine neue Seite wird geöffnet. Geben Sie einen Namen für die neue Kategorie ein und klicken Sie auf **Eingeben**.

## Produkte zum Bestand hinzufügen

Wählen Sie im Menü **Lagerbestand** aus.

![](../images/merchant/inventory-page-de.png)

\newpage

Um ein neues Produkt hinzuzufügen, klicken Sie auf die Schaltfläche **+**.

![](../images/merchant/inventory-page-2-de.png)

Eine neue Seite wird geöffnet. Füllen Sie die folgenden Felder aus:

1. **ID** *(obligatorisch)* – eine eindeutige Kennung für das Produkt. Sie kann aus einer beliebigen Zeichenfolge bestehen, muss jedoch für jedes Produkt eindeutig sein.
2. **Bild** – das Produktbild. Dieses wird in der Point-of-Sale-Anwendung verwendet.
3. **Name** *(obligatorisch)* – der Produktname.
4. **Beschreibung** *(obligatorisch)* – die Produktbeschreibung, zum Beispiel Informationen zu Zutaten bei Lebensmitteln.
5. **Art der Mengeneinheit** *(obligatorisch)* – die Einheit zur Messung des Produkts, zum Beispiel „Stück“, „kg“, „Liter“ usw.
6. **Price pro Mengeneinheit** *(obligatorisch)* – der Preis für eine Einheit des Produkts.
7. **Bestand** – die Anzahl der Einheiten, die derzeit auf Lager sind. Lassen Sie dieses Feld leer, wenn Sie den Bestand nicht über das Taler Merchant Portal verwalten möchten.
8. **Kategorien** – weist ein Produkt einer oder mehreren bestimmten Kategorien zu. Kategorien helfen dabei, Produkte in der Point-of-Sale-Anwendung zu organisieren.

![](../images/merchant/new-product-de.png)

## Zahlungs-QR-Code erstellen

Sie können einen Zahlungs-QR-Code erstellen und ihn entweder selbst ausdrucken oder bei uns einen QR-Code-Aufkleber 
anfordern. Kundinnen und Kunden können diesen QR-Code scannen, um ihre Bestellungen zu bezahlen, selbst wenn Ihr 
Händlergerät keine Internetverbindung hat. Der QR-Code ist wiederverwendbar: Jedes Mal, wenn eine Kundin oder ein Kunde 
den QR-Code scannt, wird eine neue Bestellung erstellt.

Wählen Sie im Menü **Vorlagen** aus.

![](../images/merchant/template-page-de.png)

Um eine neue Vorlage hinzuzufügen, klicken Sie auf die Schaltfläche **+**.

![](../images/merchant/template-page-2-de.png)

Eine neue Seite wird geöffnet. Füllen Sie die folgenden Felder aus:

1. **Eindeutige Kennung** *(obligatorisch)* – eine eindeutige Kennung für die Vorlage. Sie kann aus einer beliebigen Zeichenfolge bestehen, muss jedoch für jede Vorlage eindeutig sein.
2. **Name der Vorlage** *(obligatorisch)* – der Name der Vorlage. Nur Sie sehen diesen Namen.
3. **Zusammenfassung der Bestellung** – der Text, der der Kundin oder dem Kunden nach dem Scannen des QR-Codes angezeigt wird. Dieser Text wird auch mit der Bestellung im Taler Merchant Portal verknüpft.
4. **Die Zusammenfassung kann umgeschrieben werden** – wenn diese Option aktiviert ist, kann die Kundin oder der Kunde die Bestellzusammenfassung nach dem Scannen des QR-Codes bearbeiten. Wenn sie deaktiviert ist, kann die Kundin oder der Kunde die Bestellzusammenfassung nicht bearbeiten, und der Text bleibt unverändert wie in der Vorlage.
5. **Betrag** – der Geldbetrag, der der Kundin oder dem Kunden berechnet wird.
6. **Der Betrag lässt sich verändern** – wenn diese Option aktiviert ist, kann die Kundin oder der Kunde den Betrag nach dem Scannen des QR-Codes bearbeiten. Wenn sie deaktiviert ist, kann die Kundin oder der Kunde den Betrag nicht bearbeiten, und der Betrag bleibt unverändert wie in der Vorlage.

![](../images/merchant/new-template-de.png)

Um den QR-Code auszudrucken, klicken Sie auf der Seite **Vorlagen** auf die Schaltfläche **QR-code anzeigen**.

![](../images/merchant/show-template-de.png)

Sie können den QR-Code auch per E-Mail an die Taler Operation AG senden ([print@taler-ops.ch](mailto:print@taler-ops.ch)), wenn Sie möchten, 
dass wir Aufkleber mit Zahlungs-QR-Codes für Sie drucken und liefern.

\newpage

# Anleitung zur Point-of-Sale-Anwendung

Sie können die Point-of-Sale-Anwendung herunterladen, indem Sie den untenstehenden QR-Code scannen.

```{=latex}
\begin{center}
    \includegraphics[width=0.2\textwidth]{../images/merchant/pos-android.png}
    \hspace{0.05\textwidth}
    \includegraphics[width=0.2\textwidth]{../images/merchant/pos-android.png}
\end{center}
```

Öffnen Sie die Verkaufsstellen-Anwendung (POS) und geben Sie den Benutzernamen und das Passwort ein, die Sie bei der Registrierung auf [my.taler-ops.ch](my.taler-ops.ch) verwendet haben.

Wählen Sie aus, wie Sie Ihre Anmeldung bestätigen möchten: durch den Erhalt eines Codes per E-Mail oder SMS. Nachdem Sie den Code erhalten haben, geben Sie ihn in das Feld ein und klicken Sie auf **OK**.

## Bestellung erstellen

Es gibt zwei Möglichkeiten, eine Bestellung zu erstellen:

1. Nach Betrag
2. Durch Auswahl von Produkten aus dem Inventar

Sie können zwischen den beiden Modi wechseln, indem Sie auf das Burger-Menü-Symbol in der oberen linken Ecke klicken und die entsprechende Option im Menü auswählen.

### Bestellung nach Betrag

Um eine Bestellung nach Betrag zu erstellen, geben Sie den Betrag ein und klicken Sie auf die Schaltfläche **Bestellung erstellen (Betrag berechnen)**.

Lassen Sie den Kunden den Zahlungs-QR-Code scannen und die Bestellung bezahlen. Sobald die Bestellung bezahlt wurde, wird der Bestätigungsbildschirm angezeigt.
```{=latex}
\begin{center}
    \includegraphics[width=0.8\textwidth]{../images/merchant/pos-payment-success-de.png}
\end{center}
```

\newpage

### Bestellung aus dem Inventar

Diese Option ist nur sinnvoll, wenn Sie über das Taler Merchant Portal auf [my.taler-ops.ch](my.taler-ops.ch) Produkte zum Inventar hinzugefügt haben.

In der Mitte des Bildschirms sehen Sie die Produkte.

1. Kategorien zur einfacheren Navigation im Inventar
2. Zur Bestellung hinzugefügte Produkte, einschliesslich Menge und Preis
3. Schaltfläche zum Hinzufügen eines benutzerdefinierten Produkts zur Bestellung, z. B. Trinkgeld

**Schaltflächen in der oberen rechten Ecke:**

* Die Schaltfläche **"Leeren"** löscht die aktuelle Bestellung.
* Die Schaltflächen **"Vorherige"** und **"Nächste"** dienen zur Navigation zwischen nicht abgeschlossenen Bestellungen.
* Die Schaltfläche **"Inventar neu laden"** aktualisiert das Inventar mit den neuesten Änderungen aus dem Taler Merchant Portal.

Wenn die Bestellung abgeschlossen ist, klicken Sie auf die Schaltfläche **"Abrechnung"**. Der Zahlungs-QR-Code wird angezeigt, den Sie dem Kunden zeigen müssen.

![](../images/merchant/pos-order-inventory-de.png)

\newpage

## Bestellverlauf

Um den Bestellverlauf anzuzeigen, klicken Sie auf das Burger-Menü-Symbol in der oberen linken Ecke und wählen Sie im Menü **Verlauf**.

Hier sehen Sie alle Bestellungen, die Sie erstellt haben. Es gibt drei Arten von Bestellungen:

1. **Unbezahlt**: Der Kunde hat die Zahlung noch nicht abgeschlossen. Das Scannen des QR-Codes allein reicht nicht aus — der Kunde muss die Zahlung auch in seiner Taler Wallet prüfen und bestätigen. Wenn die Bestellung weiterhin als **Unbezahlt** angezeigt wird, bitten Sie den Kunden, seine Wallet zu öffnen, zu prüfen, ob die Zahlung noch aussteht, und **Bezahlen** zu drücken. Durch Klicken auf die Schaltfläche **„Zahlung anzeigen“** können Sie den Zahlungs-QR-Code erneut anzeigen, falls der Kunde den QR-Code noch nicht gescannt hat. Andernfalls sehen Sie den Bildschirm „Zahlung ausstehend“.
2. **Bezahlt**: Der Kunde hat die Bestellung bezahlt. Durch Klicken auf die Schaltfläche **"Rückerstattung"** können Sie eine Rückerstattung einleiten. Um die Rückerstattung zu erhalten, muss der Kunde den generierten Rückerstattungs-QR-Code scannen.
3. **Rückerstattet**: Der Kunde hat eine Rückerstattung für die Bestellung erhalten.

![](../images/merchant/pos-history-de.png)