OneTrace.pro Справка

Магазины и офлайн-продажи

Покупки в ваших магазинах можно передавать в 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 обновляется. Нужно право «Загрузка и удаление товаров».

Загрузка файла чеков

  1. В разделе Данные → Магазины нажмите Выбрать файл в блоке Загрузить файл чеков. Подходит CSV до 50 МБ или Excel (.xlsx, .xls, первый лист) до 10 МБ. В первой строке — названия колонок.
  2. Укажите, что в каждой колонке: дата и время чека (обязательно), телефон, карта лояльности, email или id покупателя (хотя бы одна колонка), магазин, номер чека, сумма, товары. Колонки с похожими названиями сопоставляются сами. Ненужные колонки пропустите, остальные можно сохранить свойствами чека.
  3. Нажмите Загрузить чеки. Ход загрузки и ошибки строк видны на странице. Последние загрузки показаны под формой.

Загрузка файла чеков: назначение колонок

  • Время без часового пояса, например 2026-10-28 18:42 или 28.10.2026 18:42, считается временем проекта: касса обычно пишет местное время.
  • Товары в одной ячейке разделяются ;, , или |.
  • Каждая строка становится чеком по правилу офлайн-покупки. Строка без покупателя пропускается с ошибкой.
  • Загрузка доступна ролям с правом изменять профили. Загруженные чеки учитываются в месячной квоте событий тарифа.

Справочник магазинов

Справочник даёт точкам продаж понятные названия в отчёте ROPO вместо id из чеков. У магазина есть Id магазина (значение store_id в чеках), Название, Город и Адрес. Добавить магазин можно кнопкой Добавить магазин, через API или расширением для 1С.

Блок Чеки за 30 дней показывает, сколько чеков и покупателей было в каждой точке и когда пришёл последний чек. Точка, которой нет в справочнике, отмечается «Нет в справочнике» — кнопка Назвать добавляет её. Если удалить магазин, его чеки останутся, а в отчёте вместо названия будет id.

Сегменты и цепочки

  • Условие сегмента Офлайн-покупка отбирает покупателей магазинов за последние N дней. Поле «Онлайн-касания перед чеком»: «Любые» — все покупатели, «После онлайн-касания» или «Без онлайн-касаний». Можно выбрать окно касаний, их виды и магазин. См. Сегменты.
  • Триггер цепочки Офлайн-покупка запускает цепочку на каждый чек из магазина. Можно ограничить магазин и минимальную сумму, например чтобы попросить оценку магазина или предложить товары к покупке. См. Цепочки.