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.
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.
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