Sitoo integration

The Sitoo POS integration connects your point-of-sale system with Bloomreach, giving you a unified customer view across online and offline channels. Customer profiles are stored in Bloomreach and accessed on demand by Sitoo POS. Order events, such as purchases and refunds, are sent to Bloomreach to power segmentation, campaigns, and analytics.

How it works

Bloomreach acts as the customer data platform. Sitoo POS retrieves and updates customer profiles via CRM SPI calls. Order events are sent asynchronously via webhook and stored as customer events in Bloomreach.

Customer data isn't continuously synchronized between systems—operations only happen when Sitoo POS initiates them.

• Customer data: Rretrieved and updated by Sitoo POS on demand; stored and managed in Bloomreach.
• Order data: Order Create and Order Refund events sent via webhook, queued for processing, and associated with customer profiles using the configured hard ID.

Prerequisites

Before you start, make sure you have the following:

Set up the integration

1. Add the integration

1. Go to Data & Assets > Integrations.
2. Click + Add new integration.
3. Search for Sitoo and click + Add integration.
4. Fill in your company and market details and click Save integration.

2. Authenticate the integration

1. In the integration settings, enter your Bloomreach API URL.
2. Enter your Project token—find this in Settings > Project settings > Access management > API.
3. Enter your API username (Key ID) and API password (Secret Key).
4. Click Save.

3. Configure customer matching

Define the hard ID used to identify customers across both systems. Email is the most common choice.

1. In the integration settings, go to Customer matching.
2. Select or enter your hard ID field—typically email.

4. Configure property mapping

Map Sitoo customer fields to Bloomreach customer properties and IDs.

The integration supports standard customer properties using the properties.* namespace, soft IDs using the ids.* namespace, and one hard ID for primary customer identification.

Common soft ID examples: email → ids.email_id, phone → ids.phone_id

5. Configure consents

Define the customer consent types you want to manage through Sitoo POS — for example, newsletter or SMS marketing — and set default values for each.

6. Set up webhooks in Sitoo

Configure Sitoo to send Order Create and Order Refund events to Bloomreach via webhook.

For full setup instructions, see the Sitoo Events SPI documentation.

1. In Sitoo, go to your webhook settings.
2. Set the endpoint to your Bloomreach integration URL.
3. Use your Sitoo webhook token for authentication. Webhook calls use HTTP basic authentication—don't use your Sitoo API credentials for this endpoint.

7. Validate the setup

Before going live, confirm the following are working:

• Customer creation
• Customer lookup
• Order event tracking

Limitations

• No historical data migration: Only data created after setup is processed.
• No continuous sync: Customer data isn't synchronized automatically. Operations only happen when initiated from Sitoo POS.
• One project per tenant: Only one Bloomreach project is supported per Sitoo tenant.
• One hard ID: Only one hard ID is supported across the integration.
• Phone number handling: Sitoo displays one phone number. If a customer has multiple numbers in Bloomreach, Sitoo uses the first one returned. Updates from POS append to existing numbers rather than replacing them.