Комментарии хранят договорённости с покупателем и заметки для коллег, а история изменений отвечает на вопрос «кто и когда правил заказ». Вместе это восстанавливает контекст любой сделки — от первого звонка до отгрузки.
Два типа комментариев в заказе
В карточке заказа RetailCRM есть два принципиально разных поля для текста, и путать их нельзя. Комментарий клиента (customerComment) — это то, что покупатель написал сам: в форме сайта, в чате, при оформлении в один клик. Комментарий менеджера (managerComment) — внутренняя заметка оператора, которую клиент не видит.
| Параметр | Комментарий клиента | Комментарий менеджера |
|---|---|---|
| Поле API | customerComment | managerComment |
| Источник | сайт, чат, маркетплейс | оператор вручную |
| Видит клиент | да (это его текст) | нет |
| Назначение | пожелания к заказу | служебные пометки |
Где в карточке заказа искать комментарии и историю
Оба комментария выведены прямо в карточке заказа, обычно в правой информационной колонке рядом с блоком клиента и доставки. История же живёт на отдельной вкладке.
- Блок «Комментарии» — два текстовых поля, редактируются на лету, без отдельного сохранения формы.
- Вкладка «История» (или «Журнал изменений») внутри заказа — хронологическая лента правок по данному заказу.
- Раздел «Задачи» — если по заказу нужно не просто заметить, а поручить действие с дедлайном, комментарий лучше оформить задачей.
Список заказов тоже помогает: в фильтре можно искать по подстроке в комментарии, а в настройках таблицы — вывести колонку с комментарием клиента, чтобы видеть пожелания, не открывая каждую карточку.
История изменений: что фиксируется
RetailCRM ведёт журнал по каждому заказу автоматически. Каждая запись содержит три ключевых элемента: что изменилось (поле и его старое/новое значение), кто изменил (оператор, клиент, триггер, API или интеграция) и когда (дата и время).
В историю попадают, в частности:
- смена статуса и группы статусов;
- изменение ответственного менеджера;
- добавление, удаление и изменение количества товаров;
- правки оплаты и доставки — сумм, типов, адреса, даты;
- изменения контактных данных и пользовательских полей.
Аудит изменений через API истории
Для сквозного аудита по всем заказам используется метод истории изменений заказов. Он отдаёт плоский поток правок с момента времени и удобен для внешних отчётов и контроля.
Базовый запрос выглядит так:
GET /api/v5/orders/history?filter[sinceId]=0&limit=100&apiKey=КЛЮЧ
В ответе по каждой записи приходят поле field (что менялось), oldValue и newValue, createdAt, а также блок source и данные оператора. Для инкрементальной выгрузки листайте по sinceId — берёте максимальный id из предыдущей порции и подставляете в следующий запрос.
| Параметр фильтра | Назначение |
|---|---|
sinceId | получить записи новее указанного id |
startDate / endDate | ограничить период правок |
orderType | только заказы нужного типа |
sinceId: он гарантирует, что ни одна правка не потеряется и не задвоится между выгрузками.Как понять, кто и что менял
Типовые вопросы к истории — «почему сумма заказа изменилась» или «кто снял оплату». Порядок разбора простой.
- Откройте вкладку «История» в заказе и найдите запись с интересующим полем.
- Посмотрите источник: человек, триггер, API или интеграция.
- Сверьте время правки со сменой статуса — часто изменения связаны причинно.
- Если правил триггер — проверьте его условия в разделе
Настройки → Триггеры, возможно, сработал незапланированный сценарий.
Отдельный сигнал — массовые однотипные изменения в один момент времени: почти всегда это групповое редактирование или импорт, а не действие конкретного оператора вручную.
Права доступа и автоматизация комментариев
Комментарий менеджера — внутреннее поле, но по умолчанию его видят все операторы с доступом к заказу. Разграничить доступ помогают группы прав в Администрирование → Пользователи → Группы, где настраивается видимость заказов по магазинам и ответственным.
Комментарии можно вписывать в автоматику:
- Триггеры — добавить служебную пометку при переходе в статус, например «ожидает предоплату».
- Шаблоны и быстрые ответы — типовые формулировки, чтобы менеджеры не писали одно и то же руками.
- Уведомления — на основе комментария клиента можно строить условия информирования.
Итог
Комментарий клиента и комментарий менеджера решают разные задачи: первый хранит пожелания покупателя, второй — служебные заметки команды. История изменений закрывает вопрос прозрачности: по каждому заказу видно, кто, что и когда правил, а API истории даёт основу для внешнего аудита и отчётности. Дисциплина здесь простая — не смешивать поля, важное дублировать в структурные данные и опираться на источник записи при разборе.
Если нужно навести порядок в статусной модели, правах операторов и автоматических пометках или выстроить контроль изменений заказов — мы настраиваем RetailCRM под процессы конкретного магазина: от базовой конфигурации до триггеров и интеграций.
Частые вопросы
Чем отличается комментарий клиента от комментария менеджера?
Комментарий клиента — это текст, который покупатель написал сам при оформлении, поле customerComment. Комментарий менеджера — внутренняя заметка оператора в поле managerComment, клиент её не видит.
Где посмотреть, кто менял заказ?
Внутри карточки заказа есть вкладка «История» с хронологией правок. По каждой записи видно изменённое поле, старое и новое значение, автора и время.
Почему в истории написано «изменено пользователем API»?
Это значит, что заказ правила интеграция, а не человек: сайт, 1С, маркетплейс или внешний сервис через API. Ищите причину не среди операторов, а в подключённых системах.
Как выгрузить историю изменений всех заказов?
Используйте метод GET /api/v5/orders/history с пагинацией по параметру sinceId. Он отдаёт поток правок с полями field, oldValue, newValue и временем.
Можно ли скрыть комментарий менеджера от части операторов?
Прямого флага «приватности» у поля нет, но доступ к заказам ограничивается группами прав в администрировании — по магазинам и ответственным. Так лишние сотрудники не увидят заказ целиком.
Сохраняется ли история, если удалить товар из заказа?
Да. Добавление, удаление и изменение количества товаров фиксируется в журнале заказа с указанием автора и времени, даже если позиции уже нет в текущем составе.
Как автоматически добавлять комментарий при смене статуса?
Настройте триггер в разделе «Настройки → Триггеры»: по условию перехода в нужный статус он может вписать служебную пометку в комментарий менеджера.
Комментарий клиента с сайта не затрёт мою заметку?
Комментарий клиента и комментарий менеджера — разные поля, поэтому синхронизация с сайтом не тронет заметку оператора. Опасно лишь писать служебное в поле клиента.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.