Всего точек
0
активных торговых точек
УТ
Управление товарами
Панель контроля
Панель контроля
Сводка по акционным настройкам торговых точек
Сеть
0
сетевых торговых точек
Франшиза
0
франчайзинговых точек
Ролл месяца
0
точек с назначенным роллом
Лови волна
0
точек с включенной акцией
Не назначено
0
точек без ролла месяца
Торговые точки
0 точекID
Город
Наименование
Юрлицо
Чейн
Франшиза
Работает
Ролл месяца
Лови волну
Загрузка...
Запросы
Последние заявки, которые сервисы отправили в акционный брокер
| Запрос | Сервис | Точка | Ролл месяца | Лови волну | Статус | Обновление |
|---|---|---|---|---|---|---|
Тут пока нет информации. | ||||||
Источники
Сервисы-отправители и контур id ролла месяца, который они используют
| Сервис | Контур id | Запросов | Успешно | Ошибки | Последний запрос | Обновление |
|---|---|---|---|---|---|---|
Тут пока нет информации. | ||||||
Алерты
Ошибки и конфликты, которые нужно разобрать вручную
| Сервис | Статус | Ошибка | Параметры | Создание | |
|---|---|---|---|---|---|
Тут пока нет информации. | |||||
FAQ
Памятка по подключению сервисов к акционному брокеру
01
Общее
Брокер принимает изменения промо-настроек от сервисов и применяет их в таблицы торговых точек.
Что делает акционный брокер?
Он принимает заявку от сервиса, проверяет Bearer-токен, кладет заявку в очередь, агрегирует изменения по точке и записывает итог в две таблицы: старый и новый контур акций.
Что хранится в базе дополнительно?
Успешные заявки отдельно не сохраняются. В базе остаются только итоговые значения в `NTT_Акционка` / `NTT_Акции_Назначения` и проблемные события в `ALERT_Акционный_Брокер`.
02
API
Минимум для интеграции: endpoint, токен и JSON с `update_promotion`.
Куда отправлять запрос?
POST /api/v1/promotions
Authorization: Bearer <BROKER_MESSAGE_TOKEN>
Content-Type: application/jsonКак выглядит минимальный запрос?
{
"service": "roll_service",
"method": "update_promotion",
"recipient": {
"type": "point",
"id": 188888
},
"payload": {
"roll_month": {
"enabled": true,
"product_id": 3743,
"product_id_kind": "legacy"
},
"catch_wave": {
"enabled": true
}
}
}Как выключить ролл месяца или Лови волну?
Для выключения передай нужный блок с `enabled: false`. Если сервис меняет только один признак, второй блок можно не передавать.
03
Роллы и контуры
Сервисы могут присылать старый или новый id товара, но должны явно назвать контур.
Что такое `product_id_kind`?
legacy- старый id из `NK_Номенклатура_Словарь_Ручной`, пишется в `NTT_Акционка`.ai- новый id из `NK_AI_Товары`, пишется в `NTT_Акции_Назначения`.
Брокер пишет в одну таблицу или в две?
В две. Он сопоставляет второй id ролла месяца и в одной транзакции обновляет `NTT_Акционка` и `NTT_Акции_Назначения`.
Что будет, если id не сопоставился?
Заявка не применится, получит статус `failed`, а причина попадет в алерты.
04
Статусы и ошибки
Статус заявки живет в памяти процесса, алерты хранятся в базе.
Как проверить статус запроса?
GET /api/v1/promotions/{request_id}
Authorization: Bearer <BROKER_MESSAGE_TOKEN>Какие бывают статусы?
queued- заявка принята и ждет обработки.processing- батчер взял заявку в работу.sent- изменения записаны.failed- заявка не применена, смотри `last_error` и алерты.
Где смотреть ошибки?
В разделе «Алерты». В базе это `public."ALERT_Акционный_Брокер"` с колонками `Сервис`, `Параметры_запроса`, `Ошибка`, `Статус`, `Создание`.