external:pro_bonus:10_probonus_api:03_dictionaries

ProBonus API: Справочники

Группы счетов, составные скидки, типы идентификаторов, рестораны, теги и группы тегов, товарные купоны.

Общие правила (адрес, авторизация, форматы, коды ошибок) — на странице ProBonus API. Справочник методов.

Метод Адрес Назначение
POST /api/v0/account_groups/delete Удаление элемента справочника "Группы счетов" по заданному id
GET /api/v0/account_groups/get Чтение элемента справочника "Группы счетов" по заданному id
POST /api/v0/account_groups/insert Добавление нового элемента справочника "Группы счетов"
GET /api/v0/account_groups/list Чтение списка элементов справочника "Группы счетов"
POST /api/v0/account_groups/update Обновление элемента справочника "Группы счетов" по заданному id
POST /api/v0/discounts/delete Удаление элемента справочника "Составные скидки/бонусы" по заданному id
GET /api/v0/discounts/get Чтение элемента справочника "Составные скидки/бонусы" по заданному id
POST /api/v0/discounts/insert Добавление нового элемента справочника "Составные скидки/бонусы"
GET /api/v0/discounts/list Чтение списка элементов справочника "Составные скидки/бонусы"
POST /api/v0/discounts/update Обновление параметров элемента справочника "Составные скидки/бонусы" по заданному id
POST /api/v0/identifier_types/delete Удаление элемента спрвавочника "Типы идентификаторов" по заданному id
GET /api/v0/identifier_types/get Чтение элемента справочника "Типы идентификаторов" по заданному id
POST /api/v0/identifier_types/insert Добавление нового элемента справочника "Типы идентификаторов"
GET /api/v0/identifier_types/list Чтение списка элементов справочника "Типы Идентификаторов"
POST /api/v0/identifier_types/update Обновлене элемента справочника "Типы идентификаторов" по заданному id
POST /api/v0/restaurants/delete Удаление элемента справочника "Рестораны" по заданному id
GET /api/v0/restaurants/get Чтение элемента справочника "Рестораны" по заданному id
POST /api/v0/restaurants/insert Добавление нового элемента справочника "Рестораны"
GET /api/v0/restaurants/list Чтение списка элементов справочника "Рестораны"
GET /api/v0/restaurants/list_last_visited_by_account_id Рестораны, которые недавно посещал гость
POST /api/v0/restaurants/restore Востановление элемента справочника "Рестораны" по заданному id
POST /api/v0/restaurants/update Обновление элемента справочника "Рестораны" по заданному id
POST /api/v0/tags/delete Удаление элемента справочника "Теги гостей" по заданному id
GET /api/v0/tags/get Чтение элемента справочника "Теги гостей" по заданному id
POST /api/v0/tags/groups/delete Удаление элемента справочника "Группы тегов" по заданному id
GET /api/v0/tags/groups/get Чтение элемента справочника "Группы тегов" по заданному id
POST /api/v0/tags/groups/insert Добавление элемента справочника "Группы тегов"
GET /api/v0/tags/groups/list Чтение списка элементов справочника "Группы тегов"
POST /api/v0/tags/groups/restore Восстановление удаленного элемента справочника "Группы тегов" по заданному id
POST /api/v0/tags/groups/update Обновление элемента справочника "Группы тегов"
POST /api/v0/tags/insert Добавление элемента справочника "Теги гостей"
GET /api/v0/tags/list Чтение списка элементов справочника "Теги гостей"
POST /api/v0/tags/restore Восстановление удаленного элемента справочника "Теги гостей" по заданному id
POST /api/v0/tags/update Обновление элемента справочника "Теги гостей"
GET /api/v0/coupons_dish/get Чтение элемента справочника "Товарные купоны" по указанному id
POST /api/v0/coupons_dish/insert Добавление элемента справочника "Товарные купоны" по указанному id
GET /api/v0/coupons_dish/list Чтение списка элементов справочника "Товарные купоны"
POST /api/v0/coupons_dish/update Обновление элемента справочника "Товарные купоны" по указанному id

POST /api/v0/account_groups/delete

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer да Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

Дополнительные коды ответа: 401 — Unauthorized.

GET /api/v0/account_groups/get

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer да Идентификатор объекта

Ответ 200 — объект AccountGroupDto:

Поле Тип Обяз. Описание
id integer да Идентификатор группы
name string(100) да Наименование группы
template AccountTemplateDto Шаблон

Дополнительные коды ответа: 401 — Unauthorized.

POST /api/v0/account_groups/insert

Авторизация: требуется

Тело запроса — объект AccountGroupInsDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
template AccountTemplateBaseDto Шаблон

Ответ 200 — объект AccountGroupDto:

Поле Тип Обяз. Описание
id integer да Идентификатор группы
name string(100) да Наименование группы
template AccountTemplateDto Шаблон

Дополнительные коды ответа: 401 — Unauthorized.

GET /api/v0/account_groups/list

Авторизация: требуется

Ответ 200 — массив объектов AccountGroupListItemDto:

Поле Тип Обяз. Описание
id integer да Идентификатор группы
name string(100) да Наименование группы
haveTemplate boolean да

Дополнительные коды ответа: 401 — Unauthorized.

POST /api/v0/account_groups/update

Авторизация: требуется

Тело запроса — объект AccountGroupUpdDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
template AccountTemplateBaseDto Шаблон
id integer Идентификатор

Ответ 200 — объект AccountGroupDto:

Поле Тип Обяз. Описание
id integer да Идентификатор группы
name string(100) да Наименование группы
template AccountTemplateDto Шаблон

Дополнительные коды ответа: 401 — Unauthorized.

POST /api/v0/discounts/delete

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200 — объект DiscountDto (discount):

Поле Тип Обяз. Описание
name string(50) да Наименование
limitPeriodInDays integer Период накопления суммы потрат, дней (NULL — за всё время)
discountLevels массив DiscountLevelDto да Уровни составной скидки
id integer да Идентификатор

GET /api/v0/discounts/get

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200 — объект DiscountDto (discount):

Поле Тип Обяз. Описание
name string(50) да Наименование
limitPeriodInDays integer Период накопления суммы потрат, дней (NULL — за всё время)
discountLevels массив DiscountLevelDto да Уровни составной скидки
id integer да Идентификатор

POST /api/v0/discounts/insert

Авторизация: требуется

Тело запроса — объект DiscountBaseDto:

Поле Тип Обяз. Описание
name string(50) да Наименование
limitPeriodInDays integer Период накопления суммы потрат, дней (NULL — за всё время)
discountLevels массив DiscountLevelDto да Уровни составной скидки

Ответ 200 — объект DiscountDto (discount):

Поле Тип Обяз. Описание
name string(50) да Наименование
limitPeriodInDays integer Период накопления суммы потрат, дней (NULL — за всё время)
discountLevels массив DiscountLevelDto да Уровни составной скидки
id integer да Идентификатор

GET /api/v0/discounts/list

Авторизация: требуется

Ответ 200 — массив объектов DiscountDto (discount):

Поле Тип Обяз. Описание
name string(50) да Наименование
limitPeriodInDays integer Период накопления суммы потрат, дней (NULL — за всё время)
discountLevels массив DiscountLevelDto да Уровни составной скидки
id integer да Идентификатор

POST /api/v0/discounts/update

Авторизация: требуется

Тело запроса — объект DiscountDto (discount):

Поле Тип Обяз. Описание
name string(50) да Наименование
limitPeriodInDays integer Период накопления суммы потрат, дней (NULL — за всё время)
discountLevels массив DiscountLevelDto да Уровни составной скидки
id integer да Идентификатор

Ответ 200 — объект DiscountDto (discount):

Поле Тип Обяз. Описание
name string(50) да Наименование
limitPeriodInDays integer Период накопления суммы потрат, дней (NULL — за всё время)
discountLevels массив DiscountLevelDto да Уровни составной скидки
id integer да Идентификатор

POST /api/v0/identifier_types/delete

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer да Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

GET /api/v0/identifier_types/get

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200 — объект IdentifierTypeDto:

Поле Тип Обяз. Описание
name string(100) да Наименование типа
id integer да Идентификатор типа
system boolean Системный тип (нельзя удалить); по умолчанию false
systemType string Код системного типа (см. описание таблицы)
temporary boolean Временный идентификатор (имеет срок действия); по умолчанию false
frontVisible boolean Отображать в веб-интерфейсе; по умолчанию true
frontEditable boolean Разрешено редактировать в веб-интерфейсе; по умолчанию true

POST /api/v0/identifier_types/insert

Авторизация: требуется

Тело запроса — объект IdentifierTypeBaseDto:

Поле Тип Обяз. Описание
name string(100) да Наименование типа

Ответ 200 — объект IdentifierTypeUpdate:

Поле Тип Обяз. Описание
name string(100) да Наименование типа
id integer да Идентификатор типа

GET /api/v0/identifier_types/list

Авторизация: требуется

Ответ 200 — массив объектов IdentifierTypeDto:

Поле Тип Обяз. Описание
name string(100) да Наименование типа
id integer да Идентификатор типа
system boolean Системный тип (нельзя удалить); по умолчанию false
systemType string Код системного типа (см. описание таблицы)
temporary boolean Временный идентификатор (имеет срок действия); по умолчанию false
frontVisible boolean Отображать в веб-интерфейсе; по умолчанию true
frontEditable boolean Разрешено редактировать в веб-интерфейсе; по умолчанию true

POST /api/v0/identifier_types/update

Авторизация: требуется

Тело запроса — объект IdentifierTypeUpdate:

Поле Тип Обяз. Описание
name string(100) да Наименование типа
id integer да Идентификатор типа

Ответ 200 — объект IdentifierTypeUpdate:

Поле Тип Обяз. Описание
name string(100) да Наименование типа
id integer да Идентификатор типа

POST /api/v0/restaurants/delete

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer да Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

GET /api/v0/restaurants/get

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer да Идентификатор объекта

Ответ 200 — объект RestaurantDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
code string да код ресторана 9 цифр
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор ресторана

POST /api/v0/restaurants/insert

Авторизация: требуется

Тело запроса — объект RestaurantBaseDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
code string да код ресторана 9 цифр
isDeleted boolean Признак удаления; по умолчанию false

Ответ 200 — объект RestaurantDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
code string да код ресторана 9 цифр
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор ресторана

GET /api/v0/restaurants/list

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
show_deleted строка запроса boolean Показывать удалённые элементы

Ответ 200 — массив объектов RestaurantListItemDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
code string да код ресторана 9 цифр
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор ресторана
licSlot integer

GET /api/v0/restaurants/list_last_visited_by_account_id

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
account_id строка запроса integer да Идентификатор счёта
limit строка запроса integer Максимальное количество записей в ответе; по умолчанию 3

Ответ 200 — массив объектов RestaurantDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
code string да код ресторана 9 цифр
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор ресторана

POST /api/v0/restaurants/restore

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer да Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

POST /api/v0/restaurants/update

Авторизация: требуется

Тело запроса — объект RestaurantDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
code string да код ресторана 9 цифр
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор ресторана

Ответ 200 — объект RestaurantDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
code string да код ресторана 9 цифр
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор ресторана

POST /api/v0/tags/delete

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

GET /api/v0/tags/get

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200 — объект TagDto:

Поле Тип Обяз. Описание
name string(100) да Наименование тега
isDeleted boolean Признак удаления; по умолчанию false
groupId integer да ID группы тега
id integer да Идентификатор тега

POST /api/v0/tags/groups/delete

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

GET /api/v0/tags/groups/get

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200 — объект TagGroupDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор группы тегов
usageCount integer Количество использований; по умолчанию 0

POST /api/v0/tags/groups/insert

Авторизация: требуется

Тело запроса — объект TagGroupBaseDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
isDeleted boolean Признак удаления; по умолчанию false

Ответ 200 — объект TagGroupDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор группы тегов
usageCount integer Количество использований; по умолчанию 0

GET /api/v0/tags/groups/list

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
show_deleted строка запроса boolean Показывать удалённые элементы

Ответ 200 — массив объектов TagGroupListItemDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор группы тегов
usageCount integer Количество использований; по умолчанию 0
tagsCount integer по умолчанию 0

POST /api/v0/tags/groups/restore

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

POST /api/v0/tags/groups/update

Авторизация: требуется

Тело запроса — объект TagGroupDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор группы тегов
usageCount integer Количество использований; по умолчанию 0

Ответ 200 — объект TagGroupDto:

Поле Тип Обяз. Описание
name string(100) да Наименование
isDeleted boolean Признак удаления; по умолчанию false
id integer да Идентификатор группы тегов
usageCount integer Количество использований; по умолчанию 0

POST /api/v0/tags/insert

Авторизация: требуется

Тело запроса — объект TagBaseDto:

Поле Тип Обяз. Описание
name string(100) да Наименование тега
isDeleted boolean Признак удаления; по умолчанию false
groupId integer да ID группы тега

Ответ 200 — объект TagDto:

Поле Тип Обяз. Описание
name string(100) да Наименование тега
isDeleted boolean Признак удаления; по умолчанию false
groupId integer да ID группы тега
id integer да Идентификатор тега

GET /api/v0/tags/list

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
show_deleted строка запроса boolean Показывать удалённые элементы

Ответ 200 — массив объектов TagListItemDto:

Поле Тип Обяз. Описание
name string(100) да Наименование тега
isDeleted boolean Признак удаления; по умолчанию false
groupId integer да ID группы тега
id integer да Идентификатор тега
usageCount integer Количество использований; по умолчанию 0

POST /api/v0/tags/restore

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer Идентификатор объекта

Ответ 200: JSON (структура в схеме не описана).

POST /api/v0/tags/update

Авторизация: требуется

Тело запроса — объект TagDto:

Поле Тип Обяз. Описание
name string(100) да Наименование тега
isDeleted boolean Признак удаления; по умолчанию false
groupId integer да ID группы тега
id integer да Идентификатор тега

Ответ 200 — объект TagDto:

Поле Тип Обяз. Описание
name string(100) да Наименование тега
isDeleted boolean Признак удаления; по умолчанию false
groupId integer да ID группы тега
id integer да Идентификатор тега

GET /api/v0/coupons_dish/get

Авторизация: требуется

Параметры запроса:

Параметр Где Тип Обяз. Описание
id строка запроса integer да Идентификатор объекта

Ответ 200 — объект CouponDishDto:

Поле Тип Обяз. Описание
name string да Наименование
discountCode integer да Код скидки r_keeper (уникальный для купона)
dishCode integer да Код блюда r_keeper
id integer да Идентификатор купона

Дополнительные коды ответа: 401 — Unauthorized.

POST /api/v0/coupons_dish/insert

Авторизация: требуется

Тело запроса — объект CouponDishBaseDto:

Поле Тип Обяз. Описание
name string да Наименование
discountCode integer да Код скидки r_keeper (уникальный для купона)
dishCode integer да Код блюда r_keeper

Ответ 200 — объект CouponDishDto:

Поле Тип Обяз. Описание
name string да Наименование
discountCode integer да Код скидки r_keeper (уникальный для купона)
dishCode integer да Код блюда r_keeper
id integer да Идентификатор купона

Дополнительные коды ответа: 401 — Unauthorized.

GET /api/v0/coupons_dish/list

Авторизация: требуется

Ответ 200 — массив объектов CouponDishListItemDto:

Поле Тип Обяз. Описание
name string да Наименование
discountCode integer да Код скидки r_keeper (уникальный для купона)
dishCode integer да Код блюда r_keeper
id integer да Идентификатор купона

Дополнительные коды ответа: 401 — Unauthorized.

POST /api/v0/coupons_dish/update

Авторизация: требуется

Тело запроса — объект CouponDishDto:

Поле Тип Обяз. Описание
name string да Наименование
discountCode integer да Код скидки r_keeper (уникальный для купона)
dishCode integer да Код блюда r_keeper
id integer да Идентификатор купона

Ответ 200 — объект CouponDishDto:

Поле Тип Обяз. Описание
name string да Наименование
discountCode integer да Код скидки r_keeper (уникальный для купона)
dishCode integer да Код блюда r_keeper
id integer да Идентификатор купона

Дополнительные коды ответа: 401 — Unauthorized.

Вложенные объекты и перечисления, на которые ссылаются методы этого раздела.

Поле Тип Обяз. Описание
sum number Сумма, руб.; мин. 0; макс. 999999999.99
lifetime integer Срок жизни начисленных бонусов, дней; мин. 1
Поле Тип Обяз. Описание
payLimitPeriod integer Период лимита суммы оплат со счёта
payLimitAmount number Лимит суммы оплат со счёта; мин. 0; макс. 999999999.99
payUseLimitPeriod integer Период лимита количества оплат
payUseLimitCount integer Лимит количества оплат
discountLimitPeriod integer Период лимита суммы скидок/бонусов
discountLimitAmount number Лимит суммы скидок/бонусов; мин. 0; макс. 999999999.99
discountUseLimitPeriod integer Период лимита количества применений
discountUseLimitCount integer Лимит количества применений
accountGroup IdDto Группа счетов
messageToScreen string Сообщение для экрана по умолчанию
messageOnCheck string Сообщение для печати по умолчанию
discount IdDto Скидка
rkCode integer Код скидки (бонуса) в r_keeper
rkBonusTypeCode integer Код типа бонуса в r_keeper
bonusLifetime integer Срок жизни начисляемых бонусов, дней; мин. 1
bonusDelayedDays integer Отложенное начисление бонусов, дней; мин. 1
notAwardBonusesIfPaidWithBonuses boolean Не начислять бонусы, если чек оплачен бонусами; по умолчанию false
startingBalance AccountStartingBalance да Стартовый (приветственный) баланс нового счёта
Поле Тип Обяз. Описание
payLimitPeriod integer Период лимита суммы оплат со счёта
payLimitAmount number Лимит суммы оплат со счёта; мин. 0; макс. 999999999.99
payUseLimitPeriod integer Период лимита количества оплат
payUseLimitCount integer Лимит количества оплат
discountLimitPeriod integer Период лимита суммы скидок/бонусов
discountLimitAmount number Лимит суммы скидок/бонусов; мин. 0; макс. 999999999.99
discountUseLimitPeriod integer Период лимита количества применений
discountUseLimitCount integer Лимит количества применений
accountGroup IdDto Группа счетов
messageToScreen string Сообщение для экрана по умолчанию
messageOnCheck string Сообщение для печати по умолчанию
discount IdDto Скидка
rkCode integer Код скидки (бонуса) в r_keeper
rkBonusTypeCode integer Код типа бонуса в r_keeper
bonusLifetime integer Срок жизни начисляемых бонусов, дней; мин. 1
bonusDelayedDays integer Отложенное начисление бонусов, дней; мин. 1
notAwardBonusesIfPaidWithBonuses boolean Не начислять бонусы, если чек оплачен бонусами; по умолчанию false
startingBalance AccountStartingBalance да Стартовый (приветственный) баланс нового счёта
isRkCodeBonus boolean Код r_keeper является бонусом (а не скидкой)
isCompositeDiscountBonus boolean Составная скидка начисляет бонусы; по умолчанию false
isBonusLifetime boolean У бонусов есть срок жизни; по умолчанию false
isBonusDelayed boolean Отложенное начисление бонусов; по умолчанию false
Поле Тип Обяз. Описание
rkCode integer да Код скидки (бонуса) r_keeper для уровня
levelAmount number да Порог суммы потрат для перехода на уровень; мин. 0; макс. 999999999.99
rkBonusTypeCode integer Код типа бонуса r_keeper
levelName string Название уровня
isBonus boolean Бонус (а не скидка); по умолчанию false
Поле Тип Обяз. Описание
id integer да Идентификатор
  • external/pro_bonus/10_probonus_api/03_dictionaries.txt
  • Последнее изменение: 2026/10/20 14:19
  • — Алексей Коробов