Kilbil

https://docs.kilbil.ru
Admin
Kilbil is a Russian loyalty program API platform that provides customer loyalty management, rewards...
Tokens:33,618
Snippets:187
Trust Score:8.1
Update:5 months ago
Show doc for...
Tokens:
Raw
### Get Actions List

Source: https://docs.kilbil.ru/

Retrieves a list of actions for price changes and discount applications for specified goods.

```APIDOC
## POST /load/getactionslist

### Description
Retrieves a list of actions for price changes and discount applications for specified goods.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getactionslist

### Parameters
#### Request Body
- **trade_object_id** (integer or null) - Required - The ID of the trade network if goods are stored by networks, or the trade point ID if stored by trade points. Pass null if stored by firms.
- **goods** (Array of strings) - Required - An array of product codes for which to get action information, or an array of product SKUs if searching by SKU is used in the general settings of the personal account -> product identification parameters.

### Request Example
```json
{
  "trade_object_id": 123,
  "goods": [
    "4369",
    "5712"
  ]
}
```

### Response
#### Success Response (200)
- Description of the returned result.

#### Error Response (403)
- 403 Forbidden - access denied, may contain a body.
```

--------------------------------

### Get Actions List

Source: https://docs.kilbil.ru/

Retrieve a list of promotions for price changes and discounts for specified products. Requires the trade object ID and a list of goods.

```json
{
  "trade_object_id": 123,
  "goods": [
    "4369",
    "5712"
  ]
}
```

--------------------------------

### Exchange POS Settings

Source: https://docs.kilbil.ru/

Sends information about the installed POS software and retrieves main settings from the loyalty system.

```APIDOC
## POST /load/exchangepossettings

### Description
Send information about the installed POS software and retrieve main settings from the loyalty system.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/exchangepossettings

### Parameters
#### Request Body
- **pos_program** (string) - Required - Name of the POS software.
- **version** (string) - Required - Version of the script, application, or modification.
- **autoupdate** (integer) - Optional - Default: 0. Enum: 0, 1. Automatic script update (parameter should only be passed for Frontol with a standard script; 0 - disabled, 1 - enabled).

### Request Example
```json
{
  "pos_program": "Frontol",
  "version": "12.0.5",
  "autoupdate": 1
}
```

### Response
#### Success Response (200)
- **result_code** (string) - The result code.
- **registration_fields** (object) - Fields for registration.
  - **last_name** (integer) - Indicates if last name is required.
  - **first_name** (integer) - Indicates if first name is required.
  - **middle_name** (integer) - Indicates if middle name is required.
  - **sex** (integer) - Indicates if sex is required.
  - **birth_date** (integer) - Indicates if birth date is required.
  - **email** (integer) - Indicates if email is required.
  - **referal** (integer) - Indicates if referral is required.
  - **description** (integer) - Indicates if description is required.
  - **sending_promo_msg** (integer) - Indicates if sending promotional messages is required.
- **save_nonbonus_moves** (string) - Indicates if non-bonus moves are saved.
- **osmi_cards_are_used** (string) - Indicates if OSMI cards are used.

#### Response Example
```json
{
  "result_code": "0",
  "registration_fields": {
    "last_name": 1,
    "first_name": 2,
    "middle_name": 0,
    "sex": 1,
    "birth_date": 1,
    "email": 1,
    "referal": 0,
    "description": 1,
    "sending_promo_msg": 0
  },
  "save_nonbonus_moves": "0",
  "osmi_cards_are_used": "0"
}
```
```

--------------------------------

### GET /load/getprogramgiftcard

Source: https://docs.kilbil.ru/

Retrieves a list of available gift card programs.

```APIDOC
## GET /load/getprogramgiftcard

### Description
Retrieves a list of available gift card programs.

### Method
GET

### Endpoint
https://bonus.kilbil.ru/load/getprogramgiftcard

### Response
#### Success Response (200)
- **result_code** (string) - Result code of the operation.
- **data** (array) - An array of gift card program objects.
  - **id** (integer) - The ID of the gift card program.
  - **aname** (string) - The name of the gift card program.
  - **description** (string) - A description of the gift card program.
  - **generate_gift_card** (boolean) - Indicates if gift cards can be generated for this program.
```

--------------------------------

### Get Wallet Link for Client

Source: https://docs.kilbil.ru/

Retrieve a wallet link for a specific client. Requires the client ID.

```json
{
  "client_id": 4004565
}
```

```json
{
  "result_code": "0",
  "result_text": "Клиент найден",
  "wallet_link": "https://card.kilbil.ru/kilbil/cards/load/aOtD1ke-d-fMaz6A9xdic.pkpass"
}
```

--------------------------------

### Search Client Payload Example

Source: https://docs.kilbil.ru/

This JSON payload is used to search for a client in the loyalty system. It supports various search modes and includes optional parameters for goods data, promo codes, and additional client information.

```json
{
  "search_mode": 0,
  "search_value": "79129999999",
  "goods_data": [
    {
      "code": "2137",
      "barcode": "2400000005926",
      "vendor_code": "2137",
      "name": "Товар 1",
      "variant": "Синий, 39",
      "price": 130,
      "quantity": 2,
      "total": 260,
      "minPrice": 0,
      "maxDiscount": 100,
      "discounted_price": 129.99,
      "discounted_total": 259.98,
      "parent_code": "2082",
      "parent_vendor_code": "",
      "good_promo": [
        "mrk6709876",
        "sale10"
]
    },
    {
      "code": "3957",
      "barcode": "4870001723859",
      "vendor_code": "3957",
      "name": "Товар 2",
      "price": 68.32,
      "quantity": 1,
      "total": 68.32,
      "minPrice": 0,
      "maxDiscount": 100,
      "discounted_price": 68.32,
      "discounted_total": 68.32,
      "parent_code": "4085",
      "parent_vendor_code": ""
}
],
  "promo_codes": {
    "coupons": [
      {
        "coupon": "promo2022"
}
]
},
  "card_apply_dt": "09.11.2020 17:28:23",
  "full_data": true,
  "pos_discounts_are_used": 1

}
```

--------------------------------

### Get Client Full Balance

Source: https://docs.kilbil.ru/

Retrieves the client's balance, including information about bonus expirations.

```APIDOC
## POST /load/getclientfullbalance

### Description
Retrieves the client's balance, which is returned as a set of values depending on bonus expiration.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getclientfullbalance

### Parameters
#### Request Body
- **client_id** (integer) - Required - ID of the client in the loyalty system.

### Request Example
```json
{
  "client_id": 4004565
}
```

### Response
#### Success Response (200)
- **balance** (string) - The balance amount.
- **begin_dt** (string) - The start date for the balance period.
- **expire_dt** (string) - The expiration date for the balance.

#### Response Example
```json
[
  {
    "balance": "229.00",
    "begin_dt": null,
    "expire_dt": "2024-12-19 00:00:00"
  },
  {
    "balance": "579.00",
    "begin_dt": null,
    "expire_dt": null
  }
]
```
```

--------------------------------

### Get Client Cards

Source: https://docs.kilbil.ru/

Retrieves information about the client's existing cards.

```APIDOC
## POST /load/getclientcards

### Description
Retrieves information about the client's existing cards. If `outer_systems_interface_type` is not provided, all active cards for the client will be returned.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getclientcards

### Parameters
#### Request Body
- **client_id** (integer) - Required - ID of the client in the loyalty system.
- **outer_systems_interface_type** (integer) - Optional - Type of the card interface. Enum: 0, 1, 2, 3, 4, 5, 10. (0 - cardPr, 1 - IQOS, 2 - OneDelivery, 3 - OSMI, 4 - CardsMobile (Wallet), 5 - Custom application (External application), 10 - Virtual card).

### Request Example
```json
{
  "client_id": 4004565,
  "outer_systems_interface_type": 10
}
```

### Response
#### Success Response (200)
- **result_code** (string) - The result code of the operation.
- **cards** (array) - A list of card objects.
  - **code** (string) - The card code.
  - **barcode** (string) - The card barcode.
  - **card_id** (integer) - The unique ID of the card.
  - **outer_systems_interface_name** (string) - The name of the outer systems interface.
  - **outer_systems_interface_type** (integer) - The type of the outer systems interface.

#### Response Example
```json
{
  "result_code": "0",
  "cards": [
    {
      "code": "0061",
      "barcode": "300061",
      "card_id": 10963328,
      "outer_systems_interface_name": "Виртуальная карта",
      "outer_systems_interface_type": 10
    }
  ]
}
```
```

--------------------------------

### Get Legal Information Response Sample

Source: https://docs.kilbil.ru/

This JSON structure represents a successful response (200 OK) containing URLs for various legal documents of the loyalty program. Ensure the API returns this format when requesting legal information.

```json
{
  "personal_data_policy_url": "https://lk.kilbil.ru/legalinfo/1606/politic",
  "program_rules_url": "https://lk.kilbil.ru/legalinfo/1606/program",
  "agreement_url": "https://lk.kilbil.ru/legalinfo/1606/agreement"
}
```

--------------------------------

### Get Wallet Link

Source: https://docs.kilbil.ru/

Retrieves a wallet link for a given client ID.

```APIDOC
## POST /load/getwalletlink

### Description
Get a wallet link for a client.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getwalletlink

### Parameters
#### Request Body
- **client_id** (integer) - Required - ID of the client in the loyalty system.

### Request Example
```json
{
  "client_id": 4004565
}
```

### Response
#### Success Response (200)
- **result_code** (string) - Description of the result code.
- **result_text** (string) - Textual description of the result.
- **wallet_link** (string) - The generated wallet link.

#### Response Example
```json
{
  "result_code": "0",
  "result_text": "Клиент найден",
  "wallet_link": "https://card.kilbil.ru/kilbil/cards/load/aOtD1ke-d-fMaz6A9xdic.pkpass"
}
```
```

--------------------------------

### Get Loyalty Programs

Source: https://docs.kilbil.ru/

Retrieves a list of available loyalty programs. Supports POST requests with an empty JSON object or no body.

```APIDOC
## POST /load/getprograms

### Description
Retrieves a list of available loyalty programs.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getprograms

### Request Body
- **(empty)** - Optional - An empty JSON object `{}` can be sent, or no body at all.

### Request Example
```json
{ }
```

### Response
#### Success Response (200)
- **result_code** (string) - Indicates the result of the operation, '0' for success.
- **data** (array) - An array of loyalty program objects.
  - **id** (string) - The unique identifier for the loyalty program.
  - **name** (string) - The name of the loyalty program.
  - **type** (string) - The type of loyalty program (e.g., 'Дисконтно-бонусная', 'Дисконтная', 'Бонусная').
  - **bonus_percent** (string) - The bonus percentage.
  - **bonus_pay_percent** (string) - The percentage of bonus that can be paid.
  - **discount_percent** (string) - The discount percentage.
  - **begin_date** (string/null) - The start date of the program.
  - **is_default** (string) - Indicates if this is the default program ('t' for true, 'f' for false).

#### Response Example (200)
```json
{
  "result_code": "0",
  "data": [
    {
      "id": "976",
      "name": "Дисконтно-бонусная 10%",
      "type": "Дисконтно-бонусная",
      "bonus_percent": "5.00",
      "bonus_pay_percent": "50.00",
      "discount_percent": "5.00",
      "begin_date": null,
      "is_default": "f"
    }
  ]
}
```

#### Error Response (403)
- **(body)** - May contain a response body indicating forbidden access.
```

--------------------------------

### POST /push

Source: https://docs.kilbil.ru/?path=webhook_v1

Sends a webhook about a new push notification, for example, for loyalty program mailings.

```APIDOC
## POST /push

### Description
Sends a webhook about a new push notification (e.g., for loyalty program mailings).

### Method
POST

### Endpoint
https://your-domain.example/push

### Parameters
#### Path Parameters
- **_token_** - Authorization token.

#### Request Body
- **phone** (string or null) - Required - client phone number, if available
- **message** (string) - Required - message text
- **client_id** (string) - Required - client ID in loyalty
- **mailing_name** (string or null) - Required - specified mailing name, if available

### Response
#### Success Response (200)
Description of the returned result.

#### Response Example
(No example provided in source)
```

--------------------------------

### Operation Request Payload Example

Source: https://docs.kilbil.ru/?path=webhook_v1

This JSON payload represents a sample request for the operations endpoint, detailing a sale transaction with associated discounts, bonuses, and goods.

```json
{
  "move_data": "23.12.2020 11:02:50",
  "move_id": "20201223-123",
  "move_asumm": "820.65",
  "move_actions": [
    {
      "action_id": 123,
      "action_name": "Название акции"
}
],
  "move_bonuses": [
    {
      "bonus_in": 82.07,
      "expire_date": null,
      "bonus_in_date": "2020.12.23 11:02:50"
}
],
  "bonus_presents": [
    {
      "bonus_in": 100,
      "action_id": 3872,
      "action_name": "Подарок",
      "expire_date": "2021.01.23 23:59:59",
      "bonus_in_date": "2020.12.23 11:02:50"
}
],
  "discount": "18.75",
  "bonus_in": "82.07",
  "bonus_out": "0",
  "client_id": "4004565",
  "oper_type": "0",
  "oper_description": "Продажа",
  "program_nm": "Бонусная 10%",
  "fiscal_sign": null,
  "trade_object": "Тестовая ТТ",
  "goods": [
    {
      "code": "5375",
      "name": "Товар 1",
      "price": 209.85,
      "total": 820.65,
      "actions": [
        {
          "action_id": 456,
          "action_name": "Название акции для позиции"
}
],
      "barcode": "2400000011125",
      "bonus_in": 82.07,
      "bonus_out": 0,
      "discounted_price": 205.16,
      "discounted_total": 820.65
}
],
  "discount_percent": "0",
  "bonus_percent": "10",
  "phone": "79129999999",
  "client_balance": "555"
}
```

--------------------------------

### Webhook Request Payload Example

Source: https://docs.kilbil.ru/?path=webhook_v1

This is a sample JSON payload for sending a webhook request. Ensure all required fields like 'phone', 'message', and 'client_id' are correctly formatted.

```json
{
  "phone": "79129999999",
  "message": "Это тестовый текст сообщения",
  "client_id": "string",
  "mailing_name": null
}
```

--------------------------------

### Get Program Gift Card Response

Source: https://docs.kilbil.ru/

This JSON response contains details about gift card programs, including their ID, name, description, and generation availability.

```json
{
  "result_code": "0",
  "data": [
    {
      "id": 70,
      "aname": "Подарочные сертификаты",
      "description": "Основная программа ПС",
      "generate_gift_card": true
}
]

}
```

--------------------------------

### Get Client Cards Response

Source: https://docs.kilbil.ru/

Response containing client card information, including card code, barcode, and interface details. 'outer_systems_interface_type' specifies the card type.

```json
{
  "result_code": "0",
  "cards": [
    {
      "code": "0061",
      "barcode": "300061",
      "card_id": 10963328,
      "outer_systems_interface_name": "Виртуальная карта",
      "outer_systems_interface_type": 10
}
]

}
```

--------------------------------

### Get Legal Information

Source: https://docs.kilbil.ru/

Retrieves URLs for the loyalty program's legal information, such as program rules, personal data policy, and consent to process personal data.

```APIDOC
## GET /load/legal_info

### Description
Returns links to legal information configured in the loyalty system.

### Method
GET

### Endpoint
https://bonus.kilbil.ru/load/legal_info

### Responses
#### Success Response (200)
- **personal_data_policy_url** (string) - URL for the personal data policy.
- **program_rules_url** (string) - URL for the loyalty program rules.
- **agreement_url** (string) - URL for the consent to process and transfer personal data.

#### Response Example (200)
```json
{
  "personal_data_policy_url": "https://lk.kilbil.ru/legalinfo/1606/politic",
  "program_rules_url": "https://lk.kilbil.ru/legalinfo/1606/program",
  "agreement_url": "https://lk.kilbil.ru/legalinfo/1606/agreement"
}
```

#### Error Response (403)
- Description: 403 Forbidden - access denied, may contain a body.
```

--------------------------------

### Get Client Operations Response

Source: https://docs.kilbil.ru/

This response contains a list of client operations, including details such as bonus amounts, dates, and descriptions. The result_code indicates the success of the operation.

```json
{
  "result_code": "0",
  "client_moves": [
    {
      "id": 9350350,
      "move_id": null,
      "bonus_in": 100,
      "discount": 0,
      "bonus_out": 0,
      "move_asum": 0,
      "move_date": "10.07.2019 16:47:37",
      "oper_type": 3,
      "rows_count": 0,
      "trade_object": null,
      "bonus_in_date": "10.07.2019 00:00:00",
      "bonus_term_date": "11.07.2019 00:00:00",
      "oper_description": "Ручное начисление",
      "manualadd_description": "Начислили подарочный бонус с розыгрыша 2021"
    },
    {
      "id": 4158157,
      "move_id": "32668",
      "bonus_in": 3,
      "discount": 0,
      "bonus_out": 50,
      "move_asum": 121.5,
      "move_date": "02.04.2019 12:38:32",
      "oper_type": 0,
      "rows_count": 0,
      "trade_object": "ТЕСТОВЫЙ2",
      "bonus_in_date": "02.04.2019 12:38:32",
      "bonus_term_date": null,
      "oper_description": "Продажа",
      "manualadd_description": ""
    },
    {
      "id": 4157665,
      "move_id": "32659",
      "bonus_in": 5,
      "discount": 0,
      "bonus_out": 0,
      "move_asum": 100,
      "move_date": "02.04.2019 12:06:30",
      "oper_type": 0,
      "rows_count": 2,
      "trade_object": "ТЕСТОВЫЙ2",
      "bonus_in_date": "02.04.2019 12:06:31",
      "bonus_term_date": null,
      "oper_description": "Продажа",
      "manualadd_description": ""
    },
    {
      "id": 4157650,
      "move_id": "32658",
      "bonus_in": -5,
      "discount": 0,
      "bonus_out": 0,
      "move_asum": -100,
      "move_date": "02.04.2019 12:05:36",
      "oper_type": 1,
      "rows_count": 1,
      "trade_object": "ТЕСТОВЫЙ2",
      "bonus_in_date": "02.04.2019 12:05:36",
      "bonus_term_date": null,
      "oper_description": "Возврат",
      "manualadd_description": ""
    },
    {
      "id": 4157647,
      "move_id": "32657",
      "bonus_in": 5,
      "discount": 0,
      "bonus_out": 0,
      "move_asum": 100,
      "move_date": "02.04.2019 12:05:16",
      "oper_type": 0,
      "rows_count": 1,
      "trade_object": "ТЕСТОВЫЙ2",
      "bonus_in_date": "02.04.2019 12:05:16",
      "bonus_term_date": null,
      "oper_description": "Продажа",
      "manualadd_description": ""
    }
  ]
}
```

--------------------------------

### Response Sample: Successful Operation

Source: https://docs.kilbil.ru/

This is a sample JSON response indicating a successful operation with detailed move information.

```json
{
  "result_code": "0",
  "result_text": "текст результата",
  "move_info": {
    "id": 155912975,
    "move_id": "frl-050422-180306-79365",
    "bonus_in": 218.85,
    "discount": 50,
    "bonus_out": 0,
    "client_id": 4004565,
    "move_asum": 2188.4,
    "move_date": "05.04.2022 18:03:43",
    "oper_type": 0,
    "move_total": 2238.4,
    "is_reserved": false,
    "promo_codes": [
      "20220224001"
],
    "is_confirmed": true,
    "move_actions": [
      {
        "action_id": 123,
        "action_name": "Название акции"
}
],
    "shift_number": 552,
    "cash_discount": 0,
    "bonus_presents": [
      {
        "bonus_in": 100,
        "action_id": 3872,
        "action_name": "Подарок",
        "expire_date": "05.04.2022 18:03:43",
        "bonus_in_date": "05.04.2022 18:03:43"
}
],
    "bonus_in_detail": [
      {
        "bonus_in": 218.85,
        "expire_date": null,
        "bonus_in_date": "05.04.2022 18:03:43"
}
]
},
  "move_detail": [
    {
      "code": "5375",
      "name": "Товар 1",
      "price": 209.85,
      "total": 839.4,
      "actions": [
        {
          "action_id": 5117,
          "action_name": "Товары с коэффициентами"
}
],
      "barcode": "2400000011125",
      "bonus_in": 82.07,
      "discount": 18.75,
      "quantity": 4,
      "bonus_out": 0,
      "cash_discount": 0,
      "discounted_price": 205.16,
      "discounted_total": 820.65
},
    {
      "code": "5374",
      "name": "Товар 2",
      "price": 139.9,
      "total": 1399,
      "actions": [
        {
          "action_id": 5117,
          "action_name": "Товары с коэффициентами"
}
],
      "barcode": "2400000011118",
      "bonus_in": 136.78,
      "discount": 31.25,
      "quantity": 10,
      "bonus_out": 0,
      "cash_discount": 0,
      "discounted_price": 136.78,
      "discounted_total": 1367.75
}
]

}
```

--------------------------------

### Get Client Operations

Source: https://docs.kilbil.ru/

Retrieves a list of operations for a specific client.

```APIDOC
## POST /load/getmovesbyclient

### Description
Retrieves a list of operations for a specific client.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getmovesbyclient

### Parameters
#### Request Body
- **client_id** (integer) - Required - The ID of the client.

### Request Example
```json
{
  "client_id": 4004565
}
```

### Response
#### Success Response (200)
- **result_code** (string) - The result code of the operation.
- **client_moves** (array) - A list of client operations.
  - **id** (integer) - The ID of the move.
  - **move_id** (string) - The external move ID.
  - **bonus_in** (integer) - Bonus added.
  - **discount** (integer) - Discount amount.
  - **bonus_out** (integer) - Bonus deducted.
  - **move_asum** (number) - The sum of the move.
  - **move_date** (string) - The date and time of the move.
  - **oper_type** (integer) - The operation type.
  - **rows_count** (integer) - The number of rows.
  - **trade_object** (string) - The trade object.
  - **bonus_in_date** (string) - The date bonus was added.
  - **bonus_term_date** (string) - The bonus term date.
  - **oper_description** (string) - The operation description.
  - **manualadd_description** (string) - Manual addition description.

#### Response Example
```json
{
  "result_code": "0",
  "client_moves": [
    {
      "id": 9350350,
      "move_id": null,
      "bonus_in": 100,
      "discount": 0,
      "bonus_out": 0,
      "move_asum": 0,
      "move_date": "10.07.2019 16:47:37",
      "oper_type": 3,
      "rows_count": 0,
      "trade_object": null,
      "bonus_in_date": "10.07.2019 00:00:00",
      "bonus_term_date": "11.07.2019 00:00:00",
      "oper_description": "Ручное начисление",
      "manualadd_description": "Начислили подарочный бонус с розыгрыша 2021"
    }
  ]
}
```
```

--------------------------------

### Search Promo Code Response Sample

Source: https://docs.kilbil.ru/

This is a sample JSON response indicating that a promo code was found. 'result_code' 0 signifies success.

```json
{
  "result_code": "0",
  "result_text": "Промокод найден"

}
```

--------------------------------

### Request Sample for Loyalty Programs

Source: https://docs.kilbil.ru/

An empty JSON object is used as a request payload to retrieve a list of loyalty programs. This endpoint requires authorization.

```json
{ }
```

--------------------------------

### Response Sample for Loyalty Programs

Source: https://docs.kilbil.ru/

This JSON structure represents a successful response (200) for retrieving loyalty programs, detailing their types, discount percentages, and other attributes.

```json
{
  "result_code": "0",
  "data": [
    {
      "id": "976",
      "name": "Дисконтно-бонусная 10%",
      "type": "Дисконтно-бонусная",
      "bonus_percent": "5.00",
      "bonus_pay_percent": "50.00",
      "discount_percent": "5.00",
      "begin_date": null,
      "is_default": "f"
},
    {
      "id": "171",
      "name": "Дисконтная 20%",
      "type": "Дисконтная",
      "bonus_percent": "0.00",
      "bonus_pay_percent": "0.00",
      "discount_percent": "20.00",
      "begin_date": null,
      "is_default": "f"
},
    {
      "id": "25",
      "name": "Бонусная 10%",
      "type": "Бонусная",
      "bonus_percent": "10.00",
      "bonus_pay_percent": "100.00",
      "discount_percent": "0.00",
      "begin_date": null,
      "is_default": "t"
}
]

}
```

--------------------------------

### Get Sales Indicator Slides

Source: https://docs.kilbil.ru/

Retrieves slides configured for display at the checkout in the plan-fact section of the loyalty system.

```APIDOC
## POST /load/getsalesindicesslides

### Description
Get slides configured for display at the checkout in the plan-fact section of the loyalty system.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getsalesindicesslides

### Parameters
#### Request Body
- **date** (string) - Required - The current date, for automatic substitution of the date in the <DateOfBirth18Years> variable of the **info** block.

### Request Example
```json
{
  "date": "15.05.2021"
}
```

### Response
#### Success Response (200)
- **result_code** (integer) - The result code.
- **slides** (array of strings) - An array of strings, each representing a slide.
- **info** (string) - Additional information.

#### Response Example
```json
{
  "result_code": 0,
  "slides": [
    "Выручка: 91.47 руб.\r\nСредний чек: 91.47 руб.",
    "Продажи с картой 100 %"
  ],
  "info": "Алкоголь можно если старше 15.05.2003"
}
```
```

--------------------------------

### JSON Response Sample for Loading Goods (Success)

Source: https://docs.kilbil.ru/

A successful response from the `post/load/goods` endpoint, indicating the operation was successful with a result code of '0'.

```json
{
  "success": 1,
  "result_code": "0"
}
```

--------------------------------

### Get Client Balance Request

Source: https://docs.kilbil.ru/

Payload to request a client's balance. Requires the client's ID.

```json
{
  "client_id": 4004565

}
```

--------------------------------

### POST /load/goodsxml (Category Loading)

Source: https://docs.kilbil.ru/

Loads category data in JSON format. This endpoint is used to upload category information, which can then be used for setting up promotions and other functionalities. Products will only appear in a category if they were previously uploaded using the 'goods' or 'goodsxml' functions.

```APIDOC
## POST /load/goodsxml (Category Loading)

### Description
Loads category data in JSON format. This endpoint is used to upload category information, which can then be used for setting up promotions and other functionalities. Products will only appear in a category if they were previously uploaded using the 'goods' or 'goodsxml' functions.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/goodsxml

### Query Parameters
- **id** (integer) - Optional - The ID of the retail chain or store, depending on the nomenclature storage settings. This parameter is not needed if storing by company.

### Request Body
- **Content-Type**: application/json
- **ID** (integer) - Required - The ID of the category in the loyalty system, taken from a previously created category.
- **inside** (array of objects) - Required - An array of objects containing nomenclature items.
```

--------------------------------

### Get Client Cards Request

Source: https://docs.kilbil.ru/

Request payload to retrieve a client's cards. Optionally filter by interface type.

```json
{
  "client_id": 4004565,
  "outer_systems_interface_type": 10

}
```

--------------------------------

### POST /load/goodslistxml

Source: https://docs.kilbil.ru/

Loads a list of goods using an XML file. The XML content should adhere to a specific structure that is then processed as JSON.

```APIDOC
## POST /load/goodslistxml

### Description
Loads a list of goods using an XML file. The XML content should adhere to a specific structure that is then processed as JSON. This is used for further configuration of promotions and other functionalities.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/goodslistxml

### Query Parameters
- **id** (integer) - Optional - id торговой сети или торговой точки в зависимости от настроек хранения номенклатуры. При хранении по фирме параметр не нужен.

### Request Body schema
application/xml

### Request Example
```xml
<?xml version="1.0" encoding="windows-1251"?>
<goodslist>
    <goodlist>
        <ID>393</ID>
        <inside>
            <goodlist>
                <code>704</code>
                <variant>Синий, 39</variant>
                 <K>2</K>
            </goodlist>
            <goodlist>
                <code>608</code>
                <K>1</K>
            </goodlist>
            <goodlist>
                <code>610</code>
                <K>3</K>
            </goodlist>
        </inside>
    </goodlist>
</goodslist>
```

### Response
#### Success Response (200)
- **success** (integer) - Indicates success status.
- **result_code** (string) - Result code of the operation.
```

--------------------------------

### post/load/addclienttags

Source: https://docs.kilbil.ru/

Adds one or more tags to a client in the loyalty system.

```APIDOC
## POST /load/addclienttags

### Description
Adds specified tags to a client in the loyalty system. The tag IDs can be obtained from the `getlisttags` request.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/addclienttags

### Request Body
#### Request Body schema: application/json
- **client_id** (integer) - Required - The ID of the client in the loyalty system.
- **tags** (array of integers) - Required - An array of tag IDs to add to the client.

### Request Example
```json
{
  "client_id": 4004565,
  "tags": [
    2651
  ]
}
```

### Response
#### Success Response (200)
- **result_code** (string) - Indicates the result of the operation.
- **result_text** (string) - Textual description of the result.

#### Response Example
```json
{
  "result_code": "0",
  "result_text": "текст результата"
}
```

#### Error Response (403)
- 403 Forbidden - Access denied.
```

--------------------------------

### Get Operation Detailing by Move

Source: https://docs.kilbil.ru/

Retrieves detailed information about a specific operation using its ID, move ID, or move date.

```APIDOC
## POST /load/getdetailingbymove

### Description
Retrieves detailed information about a specific operation.

### Method
POST

### Endpoint
https://bonus.kilbil.ru/load/getdetailingbymove

### Parameters
#### Request Body
- **id** (integer) - Optional - The ID of the operation in the loyalty system.
- **move_id** (string) - Optional - The external operation ID from the cash register. Can be used instead of 'id'.
- **move_date** (string) - Optional - The date of the operation. For unconfirmed operations, it's the document open date (**doc_open_dt** from **processsale**). For confirmed operations, it's the document close date (**doc_dt** from **confirmsale**).

### Request Example
```json
{
  "id": 155912975,
  "move_id": "frl-050422-180306-79365",
  "move_date": "05.04.2022 18:03:43"
}
```
```

--------------------------------

### Response Sample for Actions

Source: https://docs.kilbil.ru/

This JSON structure represents a successful response (200) for an action-related API call, detailing various promotional actions and their configurations.

```json
{
  "result_code": "0",
  "result_text": "Выполнено успешно",
  "goods": {
    "3957": [
      {
        "action": 20461,
        "respond": 91813
},
      {
        "action": 4613,
        "respond": 21479
},
      {
        "action": 19504,
        "respond": 87469
}
],
    "4369": [
      {
        "action": 20461,
        "respond": 91813
},
      {
        "action": 19504,
        "respond": 87469
}
]
},
  "actions": [
    {
      "id": 20461,
      "action": "Акция цена",
      "responds": [
        {
          "id": 91813,
          "value": 89,
          "do_type": "Цена",
          "unit_type": "%",
          "work_type": "Применить и ограничить"
}
],
      "auth_type": "Все",
      "week_days": [
        1,
        2,
        3,
        4,
        5,
        6,
        7
],
      "action_end": null,
      "action_begin": "28.12.2022",
      "trade_objects": [
        "ТЕСТОВЫЙ МАГАЗИН"
],
      "time_limit_end": 86399,
      "run_count_limit": null,
      "actions_programs": null,
      "time_limit_begin": "00:00:00",
      "run_count_limit_client": 0
},
    {
      "id": 4613,
      "action": "Тестовая скидка",
      "responds": [
        {
          "id": 21479,
          "value": 5,
          "do_type": "Скидка",
          "unit_type": "%",
          "work_type": "Применить"
}
],
      "auth_type": "Авторизованные",
      "week_days": [
        1,
        2,
        3,
        4,
        5,
        6,
        7
],
      "action_end": null,
      "action_begin": "26.10.2020",
      "trade_objects": [
        "1С Касса",
        "ТЕСТОВЫЙ2 (Артикс)",
        "ТЕСТОВЫЙ3 (Фронтол)",
        "Магазин Демо",
        "Тестовый3",
        "Магазин"
],
      "time_limit_end": 86399,
      "run_count_limit": null,
      "actions_programs": null,
      "time_limit_begin": "00:00:00",
      "run_count_limit_client": 0
},
    {
      "id": 19504,
      "action": "Расчет покупки (тест)",
      "responds": [
        {
          "id": 87469,
          "value": 5,
          "do_type": "Скидка",
          "unit_type": "%",
          "work_type": "Применить"
}
],
      "auth_type": "Все",
      "week_days": [
        1,
        2,
        3,
        4,
        5,
        6,
        7
],
      "action_end": null,
      "action_begin": "08.12.2022",
      "trade_objects": [
        "1С Касса"
],
      "time_limit_end": 86340,
      "run_count_limit": null,
      "actions_programs": null,
      "time_limit_begin": "00:00:00",
      "run_count_limit_client": 0
}
]

}
```

--------------------------------

### Get Sales Indicator Slides

Source: https://docs.kilbil.ru/

Retrieve sales indicator slides for a given date. This is used for displaying information in the 'plan-fact' section of the loyalty system.

```json
{
  "date": "15.05.2021"
}
```

```json
{
  "result_code": 0,
  "slides": [
    "Выручка: 91.47 руб.\r\nСредний чек: 91.47 руб.",
    "Продажи с картой 100 %"
  ],
  "info": "Алкоголь можно если старше 15.05.2003"
}
```
Tokens:
Raw