Skip to main content

Departments

A department in Sailplay terminology is any logical or physical part of a business that can be separately accounted for, analyzed, or used to personalize interactions with clients.

What can be a department?Examples
Physical point of saleStore, warehouse, kiosk
Online channelWebsite, app
Geographic regionCity, region
Part of business processesCheckout, sales department

Each created department has a unique numeric identifier — store_department_id. It is used to link all actions, client data, sales, and accruals to a specific department.

Why Departments are Needed​

Using departments in Sailplay allows you to:

  • Segment and personalize promotions and communications by regions, stores, or channels.
  • Conduct analytics on sales and client behavior by points and channels.
  • Manage points of sale — enable and disable departments.
  • Scale business structure without changing the logic of the loyalty program.

Department Characteristics​

Additional characteristics can be set for each department.

Unit (unit_id)​

A group of departments used to simplify promotion settings.
When creating a department via the API, the unit_id parameter is mandatory. The use of one unit for all departments is allowed.

Internal Identifier (origin_id)​

An arbitrary department identifier from your system. Simplifies synchronization and searching.

Timezone (timezone)​

Used for correctly fixing purchase times and synchronous launch of promotions.

{"timezones":["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", ...]}
warning

The timezone must comply with the IANA standard (tz database).

Additional Attributes​

Arbitrary string attributes can be assigned to departments, for example:

  • store format
  • brand
  • point type
  • region

This data is used for segmentation, promotions, and analytics.

Managing Departments via the Interface​

  1. Open the Settings section
  2. Go to Departments
  3. Create a department and specify the mandatory parameters
  4. Add additional attributes in the department card

API Method Map​

Units​

  • Create unit — /partners/units/create/
  • Get list of units — /partners/units/list/

Departments​

  • Create department — /partners/departments/create/
  • Edit department — /partners/departments/edit/
  • Get list of departments — /partners/departments/list/

Characteristic Categories​

  • Create category — /partners/departments/tags/category/create/
  • Delete category — /partners/departments/tags/category/delete/
  • Get list of categories — /partners/departments/tags/category/list/

Characteristic Values​

  • Create value — /partners/departments/tags/create/
  • Delete value — /partners/departments/tags/delete/
  • Get list of values — /partners/departments/tags/list/

Value Assignment​

  • Assign value to department — /partners/departments/tags/add/
  • Remove value from department — /partners/departments/tags/remove/

Typical Usage Scenarios​

Initial Network Load​

  1. Create units by sales channels.
  2. Create departments with unit_id, origin_id, timezone.
  3. Create attribute categories (e.g., "Region", "Format").
  4. Add values and assign them to departments.

Daily Synchronization​

  • Add new points of sale.
  • Update characteristics upon changes.
  • Deactivate closed or temporarily unavailable departments.