> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dema.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sitoo POS

> This guide outlines the process of integrating the Sitoo Point of Sale (POS) system with our platform to synchronize in-store sales and return data.

export const HistoricalDataNote = () => <Tip>
    <strong>Historical data recommendation</strong> — For accurate forecasting, marketing-mix modeling, and cohort analytics, we recommend providing data going back to at least two years. Our default start date for data ingestion is <strong>January 1, 2023</strong>. The more historical data available, the better our ML models perform.
  </Tip>;

### Supported data types

<CardGroup cols={2}>
  <Card title="Orders" icon="file-invoice-dollar">
    In-store transactions
  </Card>

  <Card title="Returns" icon="rotate-left">
    Return details
  </Card>

  <Card title="Inventory" icon="boxes-stacked">
    Stock levels & product data
  </Card>

  <Card title="Product Attributes" icon="tags">
    Product metadata & descriptions
  </Card>
</CardGroup>

## Prerequisites

<HistoricalDataNote />

* Administrative access to your Sitoo POS backoffice system

## Step-by-step integration guide

<Steps>
  <Step title="Request API credentials">
    1. Reach out to Sitoo support or your Sitoo Customer Success Manager to request API credentials for an integration.
    2. Sitoo will provide you with the following information:
       * Account ID
       * API ID
       * E-shop ID (site/store identifier)
  </Step>

  <Step title="Get API credentials">
    1. Log in to your Sitoo Administration portal
    2. Navigate to the "Settings" and select "Sitoo REST API"
    3. Find the API user you got from the previous step
    4. Click on "create new password" next to the API user
    5. Store these credentials securely as they will be needed for the integration
       * **API ID** (`apiId`): The unique identifier for your API user
       * **Password**: The secret password for authentication
  </Step>
</Steps>

## Submit your credentials

Once you have gathered all the necessary credentials, please package them as shown below and send them to your Customer Success Manager:

```json theme={null}
{
  "apiId": "123456-123",
  "password": "api_user_password",
  "accountId": "123456",
  "eshopId": "1"
}
```

* **accountId** — The numeric identifier for your Sitoo account (typically matches the first part of the API ID).
* **eshopId** — The site/e-shop identifier within your account. Ask Sitoo support if you are unsure which value to use.

<Note>For security reasons, ensure you send this information through a secure channel as recommended by the Customer Success Team.</Note>

## Data synchronization process

After the integration is set up, our platform will:

1. **Initial data load**: Perform a full data sync of historical orders and returns
2. **Ongoing synchronization**: Update data daily through API polling

## Troubleshooting and support

If you encounter any issues during this process or have questions, please reach out to our support team for assistance.

## Additional resources

For more information on managing your Sitoo account and understanding the API, visit the following links:

* [Sitoo API Documentation](https://developer.sitoo.com/api-reference/overview)