Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 10 additions & 6 deletions poscreators/middleware-doc/digital-receipt/receive-receipts.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,14 +37,18 @@ The merchants PosDealer can participate by means of placing orders and intermedi

![give-away](./images/sequenze_diagramm_instore_app.png)

This sequence diagram describes the process of generating a digital receipt with the InStore App. The participants in the process are the merchant, fiskaltrust, consumer and the InStore App.
The following diagram describes the process of generating a digital receipt with the InStore App. The participants in the process are the merchant, fiskaltrust, the consumer and the InStore App.

The InStore App offers three options: scan QR-Code to receive digital receipt on mobile phone, accept button to manually acknowledge received receipt and print receipt on thermal paper.
The InStore App offers five options: scanning the QR code to receive the digital receipt on a mobile phone, tapping the OK button to manually acknowledge receipt, printing the receipt on thermal paper, sending the receipt via email, or sending it via SMS.

In store, the merchant collects items and processes the payment or checkout. Then the merchant sends a sign message to fiskaltrust for fiscalization purposes.
In-store, the merchant collects items and processes the payment or checkout. The merchant then sends a sign message to fiskaltrust for fiscalization purposes.

**Scan QR-Code:** The InStore App constantly listening to the fiskaltrust receipt backend, if there is an receipt push command. Once the InStore App received an https receipt link, the QR-Code gets visualized on the InStore App device. The consumer scans the QR-Code with his mobile phone. He receives the https receipt link, the InStore App sends an log that the receipt got scanned by consumer. The fiskaltrust backend renders the receipt, the QR-Code display on the InStore App device closes. The consumer can now accesses the HTML receipt document. The consumer can then provide feedback regarding the receipt.
- **Scan QR code:** The InStore App continuously listens to the fiskaltrust receipt backend for incoming receipt push events. When an HTTPS receipt link is received, it displays a QR code on the device screen. The consumer scans the QR code with their mobile phone and receives the HTTPS receipt link. The InStore app sends a log to the fiskaltrust backend indicating that the receipt was scanned by the consumer. The fiskaltrust backend renders the receipt, and the QR code display on the InStore App device is closed. The consumer can now accesses the HTML receipt document and provide feedback regarding the receipt.

**Acknowledge:** The consumer manually accepts the he received the receipt, by pressing the accept button on the InStore App. The InStore App send to fiskaltrust backend and log, that the receipt got acknowledged manually. The InStore App gets a response from fiskaltrust, to close the display.
- **Acknowledge:** The consumer manually acknowledges receipt by tapping the OK button in the InStore App. The InStore app sends a log to the fiskaltrust backend indicating that the receipt was acknowledged manually. The InStore app receives a response from the fiskaltrust backend to close the display.

**Print receipt:** Consumers can manually initiate paper receipt printing on the InStore App device by clicking the print button. Additionally, in the absence of user interaction, a paper receipt will be automatically printed after a default countdown of 15 seconds. Once the receipt is printed, the display will close and the print command will be logged.
- **Print receipt:** Consumers can manually initiate paper receipt printing on the InStore App device by tapping the Print button. Additionally, if there is no user interaction, a paper receipt is automatically printed after a default countdown of 15 seconds. Once the receipt is printed, the display closes and the print command is logged.

- **Send receipt via email:** Consumers can choose to receive the digital receipt via email by tapping the Send per Mail button on the InStore App device. A screen will then be displayed where the consumer can enter their email address.

- **Send receipt via SMS:** Consumers can choose to receive the digital receipt via SMS by tapping the Send per SMS button on the InStore App device. A screen will then be displayed where the consumer can enter their phone number.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
107 changes: 40 additions & 67 deletions poscreators/middleware-doc/instore-app/Setup-guide/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,117 +5,90 @@ title: Getting Started

# Getting Started

This guide explains how to install the Fiskaltrust app and connect it to your cash register.
Please follow the steps below in the given order.
To install the fiskaltrust InStore App and connect it to your cash register, complete the following steps.

**1. Install the app**
## Step 1: Install the app

Please check our [installation guides](../installation-guides/installation-guides.md) for details.
Refer to the [installation guides](../installation-guides/installation-guides.md) for detailed intructions.

**2. Start the App and Grant Permissions**
## Step2: Start the app and grant permissions

- Once installed, launch the app.
- If prompted, enable the option **"Display over other apps"** (this allows the app to stay in the foreground while you work in other apps).
- _Tip:_ If this option is disabled, a prompt will appear asking you to enable it.
Please confirm this setting.
* Once installed, launch the app.
* If prompted, enable the **Display over other apps** option (this allows the app to stay in the foreground while you work in other apps).<br/>![DisplayOverApps](./images/DisplayOverApps.png)

![DisplayOverApps](./images/DisplayOverApps.png)
:::tip

**3. Access the Fiskaltrust Portal**
If this option is disabled, a prompt appears asking you to enable it. Confirm the setting.

- If you want to **test** your setup in the **Sandbox environment** , open the **Fiskaltrust Sandbox Portal** for your country in your web browser:
- [**Open Fiskaltrust Sandbox Portal**](https://portal-sandbox.fiskaltrust.at/)
- If you’re ready to go live in **production** , make sure to use the **production link** for your country:
- [**Open Fiskaltrust Production Portal**](https://portal.fiskaltrust.at/Account/Login?returnUrl=%2fCashBox#/)
:::

Make sure to select the correct country within the portal to match your region.
## Step 3: Access the fiskaltrust Portal

**4. Select Your Cashbox**
* If you want to test your setup in the Sandbox environment, open the fiskaltrust [Sandbox Portal](https://portal-sandbox.fiskaltrust.at/) for your country in your web browser.
* If you’re ready to go live in Production, use the [Production Portal](https://portal.fiskaltrust.at/Account/Login?returnUrl=%2fCashBox#/) for your country.

- Once in the portal, select your **Cashbox**. This is the virtual cash register you will connect to the app.

![Cashbox](./images/Cashbox.png)

**5. Copy the PAIR CODE**
Make sure to select the correct country in the portal to match your region.

- In the Cashbox overview, you will find your **PAIR CODE**. This code is used to pair your app with the Cashbox.
- **Example PAIR CODE:** 8639
Copy this code.

![PIN for InStore App](./images/PINforInstoreApp.png)
## Step 4: Select your Cashbox

**6. Enter the PAIR CODE in the App**

- Now, open the Fiskaltrust app on your device and paste the previously copied **PAIR CODE** into the designated field.
- Click **"Pair"** to connect the app with your Cashbox.
In the portal, navigate to **Configuration** > **CashBox** and select your Cashbox. This is the virtual cash register you will connect to the app.

![PairDevice](./images/PairDevice.png)

---

**You Are Ready to Go!**


Once the pairing is successful, your app is now connected to your Cashbox, and you can
start using it. If you need further assistance, please do not hesitate to contact us.

---

![Cashbox](./images/Cashbox.png)

If you have any questions or encounter issues during installation, please first check the
FAQ section for possible solutions. If you still need assistance, feel free to reach out to
our support team.
## Step 5: Copy the PIN for InStore App

---
In the CashBox overview, you will find your **PIN for InStore App**. This PIN is used to pair your app with the Cashbox. Example pairing PIN: 8639. Copy this code.

**Fiskaltrust Team**
![PIN for InStore App](./images/PINforInstoreApp.png)

[Support Website](https://www.fiskaltrust.at/support)
## Step 6: Enter the PIN code in the app

---
* Open the InStore App on your device and enter the previously copied pairing PIN into the designated field.
* Click **Pair** to connect the app to your CashBox.<br/>![PairDevice](./images/PairDevice.png)

Once the pairing is successful, your app is connected to your CashBox and ready to use.

If you have any questions or encounter issues during installation, first check the following FAQ section for possible solutions. If you still need assistance, contact our support team at [email protected].

**Frequently Asked Questions (FAQ)**
## Frequently Asked Questions (FAQ)

**Q: The printer is not showing up. What should I do?**

- **A:** Please ensure that **Bluetooth** is enabled on your device. The app requires
- **A:** Ensure that **Bluetooth** is enabled on your device. The app requires
Bluetooth to connect to the printer. You can check the Bluetooth settings in your
devices settings menu.
device's settings menu.

**Q: How can I reconnect the app to my Cashbox?**

- **A:** If the connection between the app and the Cashbox is lost, simply open the
Fiskaltrust Portal again, copy the **PAIR CODE** , and re-enter it in the app. This will
- **A:** If the connection between the app and the Cashbox is lost, open the
fiskaltrust Portal again, copy the **pairing PIN** , and re-enter it in the app. This will
re-establish the connection.

**Q: The app isn't opening after installation. What do I do?**
**Q: The app isn't opening after installation. What should I do?**

- **A:** Make sure that your device has sufficient storage and that all necessary
permissions (e.g., storage access, Bluetooth access) are granted. Try restarting
permissions (e.g., storage access and Bluetooth access) are granted. Try restarting
your device and reinstalling the app if necessary.

**Q: I received an error message when pairing. What does it mean?**

- **A:** This could indicate an issue with the PAIR CODE. Please double-check the
PAIR CODE you entered to ensure it is correct. You can also try copying and
pasting the code again from the Fiskaltrust Portal.
- **A:** This may indicate an issue with the pairing PIN. Double-check the
code you entered. You can also try copying it again from the fiskaltrust Portal.

**Q: How can I update the Fiskaltrust app?**
**Q: How can I update the fiskaltrust InStore App?**

- **A:** To ensure you have the latest version of the app, revisit the **download page**
and download the newest version. The app will automatically update when a new
- **A:** To ensure you have the latest version, revisit the download page
and install the newest version. The app will automatically update when a new
version is available.

**Q: Can I use the app without an internet connection?**

- **A:** The app requires an internet connection for initial setup and communication
with the Fiskaltrust portal. However, once set up, the app can function offline for
day-to-day use, provided it was previously paired with the Cashbox.
with the fiskaltrust Portal. However, once set up, the app can function offline for
day-to-day use, provided it has been previously paired with the CashBox.

**Q: The app is not responding or freezing. What should I do?**

- **A:** If the app freezes or becomes unresponsive, try restarting the app or your
- **A:** If the app freezes or becomes unresponsive, try restarting the app on your
device. If the issue persists, check for available updates or reinstall the app to
ensure it's running the latest version.
ensure you are running the latest version.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a problem with the white background
Image

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image fixed.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading