Магазины и офлайн-продажи
Покупки в ваших магазинах можно передавать в OneTrace.pro вместе с онлайн-данными. Чек из кассы попадает в профиль покупателя рядом с его визитами на сайт, просмотрами товаров и письмами. Отсюда отчёт ROPO: сколько продаж в магазинах сделали покупатели, которые перед этим изучали товар онлайн. Покупки в магазинах доступны сегментам и цепочкам.
Раздел — Данные → Магазины. Смотреть его могут роли с правом на просмотр товаров, менять правило и справочник — с правом на изменение товаров.

Как отличить покупку в магазине
Чек из магазина — это то же событие покупки, что заказ на сайте, например order_completed с суммой и товарами. Чтобы OneTrace.pro отличал его от онлайн-заказа, у чека есть отдельное свойство. Правило задаётся в блоке Как отличать покупку в магазине:
- Свойство события покупки (по умолчанию) — чек отправляется событием покупки со свойством
channelи значениемoffline. Свойство и значение можно поменять. Событие покупки берётся из настроек прогнозов. - Отдельное событие — если чеки уже приходят своим событием, например
store_purchase, выберите его. - Свойство с id магазина (по умолчанию
store_id) связывает чек с точкой продаж из справочника.
Правило действует сразу на всё: отчёт ROPO, условие сегмента, триггер цепочки и загрузку файла чеков.
Как передавать чеки
Покупатель чека определяется по телефону, email или номеру карты лояльности. Если профиля с ними ещё нет, создаётся новый. Когда покупатель оставит тот же телефон или email на сайте, профили склеятся, и его онлайн-история соединится с покупками в магазине, см. Склейка профилей. Чек без телефона, email и карты не связать с онлайн-историей, поэтому для отчёта он бесполезен.
Есть четыре способа:
| Способ | Когда подходит |
|---|---|
| Расширение для 1С | чеки из 1С:Розницы, УНФ или Управления торговлей — автоматически каждые 15 минут |
| API | своя касса или учётная система, которая может отправлять запросы |
| Источник данных с шаблоном Офлайн-чеки | выгрузка чеков, которую система каждую ночь выкладывает файлом, см. Источники данных |
| Загрузка файла | разовая загрузка чеков за прошлый период, например чтобы посмотреть отчёт до подключения кассы |
Какой бы способ вы ни выбрали, повторная отправка того же чека в течение суток не создаёт дубля.
Расширение для 1С
Расширение конфигурации для 1С:Розницы 2.3 и 3.0, 1С:Управления нашей фирмой 1.6 и 3.0 и 1С:Управления торговлей 11, платформа 1С:Предприятие 8.3.21 и новее. Конфигурация не меняется: всё находится в расширении.
- Каждые 15 минут отправляет новые проведённые чеки ККМ: дату, номер, магазин, сумму и товары. Покупатель — телефон, email и карта лояльности из чека.
- Раз в сутки отправляет справочник магазинов.
- Чек без покупателя пропускается и записывается в журнал регистрации с причиной. Остальные чеки уходят.
- Если OneTrace.pro недоступен или ключ неверный, чеки не теряются: они уйдут при следующем запуске.
Если в блоке Загрузить файл чеков есть ссылка расширение для 1С, по ней — расширение и инструкция по установке и настройке. Для расширения нужен секретный API-ключ с правом «Загрузка и удаление товаров»: это право нужно для справочника магазинов. В обработке настройки расширения укажите адрес OneTrace.pro и ключ, проверьте подключение и сохраните настройки.
Товар в чеке передаётся артикулом номенклатуры, кодом или уникальным идентификатором — выберите в настройках то, что совпадает с id товаров в каталоге. Иначе отчёт ROPO не найдёт товары, которые покупатель смотрел на сайте.
API
Отправляйте чек событием track с секретным ключом. Покупатель передаётся в context.traits, userId не нужен:
{
"event": "order_completed",
"messageId": "check-ber01-000123",
"timestamp": "2026-10-29T15:04:00+01:00",
"properties": {
"channel": "offline",
"store_id": "BER-01",
"order_id": "000123",
"amount": 89.90,
"products": [{ "product_id": "SKU-1", "price": 89.90, "quantity": 1 }]
},
"context": { "traits": { "phone": "+49 151 2345 6789", "loyalty_card": "2770 0001 5002" } }
}
- Запрос —
POST /api/v1/track, пачкой —POST /api/v1/batch, см. Серверная интеграция. - По
context.traitsпокупателя находят только запросы с секретным ключом. С ключом записи сайта так нельзя: иначе посетитель мог бы назваться чужим телефоном. messageId— постоянный id чека, например магазин и номер чека. Повтор с тем жеmessageIdотбрасывается.- Если клиент на сайте вошёл в личный кабинет, а касса знает его id, передайте и
userId.
Магазины передаются в справочник запросом POST /api/v1/stores с телом {"items": [{"id": "BER-01", "name": "Berlin Mitte", "city": "Berlin", "address": "…"}]} — до 1000 точек за раз, точка с тем же id обновляется. Нужно право «Загрузка и удаление товаров».
Загрузка файла чеков
- В разделе Данные → Магазины нажмите Выбрать файл в блоке Загрузить файл чеков. Подходит CSV до 50 МБ или Excel (.xlsx, .xls, первый лист) до 10 МБ. В первой строке — названия колонок.
- Укажите, что в каждой колонке: дата и время чека (обязательно), телефон, карта лояльности, email или id покупателя (хотя бы одна колонка), магазин, номер чека, сумма, товары. Колонки с похожими названиями сопоставляются сами. Ненужные колонки пропустите, остальные можно сохранить свойствами чека.
- Нажмите Загрузить чеки. Ход загрузки и ошибки строк видны на странице. Последние загрузки показаны под формой.

- Время без часового пояса, например
2026-10-28 18:42или28.10.2026 18:42, считается временем проекта: касса обычно пишет местное время. - Товары в одной ячейке разделяются
;,,или|. - Каждая строка становится чеком по правилу офлайн-покупки. Строка без покупателя пропускается с ошибкой.
- Загрузка доступна ролям с правом изменять профили. Загруженные чеки учитываются в месячной квоте событий тарифа.
Справочник магазинов
Справочник даёт точкам продаж понятные названия в отчёте ROPO вместо id из чеков. У магазина есть Id магазина (значение store_id в чеках), Название, Город и Адрес. Добавить магазин можно кнопкой Добавить магазин, через API или расширением для 1С.
Блок Чеки за 30 дней показывает, сколько чеков и покупателей было в каждой точке и когда пришёл последний чек. Точка, которой нет в справочнике, отмечается «Нет в справочнике» — кнопка Назвать добавляет её. Если удалить магазин, его чеки останутся, а в отчёте вместо названия будет id.
Сегменты и цепочки
- Условие сегмента Офлайн-покупка отбирает покупателей магазинов за последние N дней. Поле «Онлайн-касания перед чеком»: «Любые» — все покупатели, «После онлайн-касания» или «Без онлайн-касаний». Можно выбрать окно касаний, их виды и магазин. См. Сегменты.
- Триггер цепочки Офлайн-покупка запускает цепочку на каждый чек из магазина. Можно ограничить магазин и минимальную сумму, например чтобы попросить оценку магазина или предложить товары к покупке. См. Цепочки.