> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://az.help.clopos.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Integration of Caspos Cashbox with Clopos

### Importance of Cashbox and Clopos Integration
Sending receipts from the Clopos system to the **cashbox** is an important step to ensure compliance with modern tax requirements. This integration automatically transmits every sales transaction and payment to the tax system, making the preparation of tax declarations more accurate and timely. The connection with the **cashbox** enables the provision of precise and transparent data to tax authorities, simplifies accounting processes, and minimizes human errors. As a result, it ensures proper fulfillment of tax obligations and facilitates efficient financial management of the business.

## ${color}[#000000](Starting the Integration Process on the Caspos Device)
* Make sure that the **Caspos device** and the **Clopos terminal** are connected to the same network.
* Click the **three dots** in the top-right corner and copy the device’s connected **IP address (IPv4)** from the **Advanced** section.

|| 💡 To prevent future issues, it is recommended to assign a static IP address to the device or reserve the IP address on the router/modem. This ensures that the IP address does not change and that the device maintains a stable network connection, which is critical for system continuity and proper operation.

* Open the **Caspos** application on the Caspos device, go to the **Cash Register** section, and click **“Start integration process”** in the **Settings** section.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/image_l2p7pq.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/image_fbc7yh.png)
* In the code field, enter **“password”** followed by the **last 4 digits of the device’s serial number (S/N)** shown on the back of the device.

|| 💡 When the integration process starts successfully, only “Stop integration process” will be displayed on the screen. This indicates that the process has started correctly.


||| 💡 If you want to exit the Caspos application and access Android system settings, press and hold the power button and click “Exit Kiosk” in the top-right corner.
(On newer devices, system settings can be accessed without performing this action.)

## ${color}[#000000](Activating the Caspos Module in the Clopos Back Office)
* Go to the **Applications** section in the Clopos back office.
* From the **All** tab, select the **Caspos module**.
* Activating the module requires a **10 AZN fee**, which will be added to your monthly subscription.
* Once activated, the module will appear in the **Applications** section.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/caspos1_nnx788.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/caspos-2_19dunns.png)
* Enable the **Status** option.
* When **Show on Terminal** is enabled, the **Cashbox** section becomes visible under **Devices** on the terminal.
When disabled, this section will not be displayed.
* When **Send Automatically** is enabled, the **Print with Tax** option is automatically activated for closed receipts.
This option can be disabled if desired.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/caspos-3_1lajjdt.png)

## Entering Caspos System Details and Integration
* **IP Address:** `192.168.1.166:5544`
*(Note: only `192.168.1.166` can be modified; `5544` must remain unchanged.)*
* **Username:** username
* **Password:** password
* **Default Tax Name:** You may assign a name to your tax here.
In the **Default Tax Rate** field, enter the tax percentage you are required to pay.
This tax rate **must match** the tax rate defined in the Caspos system.
If you encounter the error **“VAT type is incorrect”**, you should contact Caspos support and request correction of the VAT rate.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/image_1zf9j.png)

## Integrating Multiple Cashboxes Simultaneously
* It is possible to integrate multiple **cashboxes** at the same time.
* Each **cashbox** can be used with **only one terminal**.
* On a terminal, you must keep other cashboxes in **offline status** and activate only the one you wish to use.
* If the cashboxes belong to the **same operator**, you must contact the **Clopos support team** for assistance.

## Testing the Cashbox Integration
* Go to **Terminal → Control Panel → Devices**.
* Open the **Cashbox** section and click **Check**.
* If a **Success** message appears, this confirms that the Caspos system has been successfully integrated.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/caspos-4_10ogqcz.png =1017xauto)
![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/caspos-5_1wnz7lb.png =1017xauto)
![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/caspos-6_1vnjl79.png =801xauto)

![](https://storage.crisp.chat/users/helpdesk/website/-/7/4/0/e/740e20bde3bec000/image_1yppei.png)
## ${color}[#000000](Opening a Shift)
Before starting work, the cashier or operator must officially open a shift. This ensures that all financial transactions are properly recorded in the system.
After logging into the system, the user confirms the start of the shift by clicking the **Open Shift** button. This action automatically records the shift start time and activates transaction tracking for the cashier.

## ${color}[#000000](Closing a Shift)
At the end of the working day or before the shift ends, the shift must be officially closed. This process finalizes all transactions and ensures secure storage of financial data.
When the **Close Shift** button is clicked, the system records the shift end time and generates a final report of all transactions performed during the shift.
If the shift is not closed, discrepancies may occur in transactions and reports; therefore, this step is critical.

## ${color}[#000000](X-Report)
The **X-Report** is an interim financial report that can be generated by the cashier or operator at any time during the working day. It displays information about transactions, sales, cash, and non-cash payments without affecting the daily closing.
The X-Report only reflects transactions up to the current time and does **not** close the cashbox.

|| 💡 If a shift remains open for 24 hours, the system automatically sends an error notification indicating that the shift has not been closed. To avoid technical inconsistencies, shifts must be closed on time.


## ${color}[#000000](Canceling a Tax-Reported Receipt)
### Fiscal Cancellation
You can locate the receipt in the **Archived Receipts** section and cancel it by clicking **Fiscal Cancel**.
Fiscal cancellation must be performed **within the same shift**.
### Reopening a Receipt
[A receipt can be reopened](https://az.help.clopos.com/en/article/reopening-closed-receipts-tsqrda/) **only until the cashbox opening time**.
Within the same shift, the receipt can be canceled from the tax system.