NAV Navbar
cURL

Аудит

Аудит

Сервис МойСклад накапливает сведения о всех событиях в системе. Эта часть сервиса называется аудит, а накопленные сведения - событиями аудита. Изменения по конкретной сущности доступны пользователям при наличии прав на просмотр, подробная информация о всех изменениях доступна только пользователям с правами администратора.

Основными сущностями в аудите JSON API являются контексты и события. События содержат подробную информацию о произошедших изменениях конкретной сущности или операции, например, изменение значения поля. Контекстом называются одно или несколько связанных событий, например, массовое обновление товаров. События отражают конкретные произошедшие изменения, связанные с одной сущностью, контекст же содержит только общую информацию событий, относящихся к нему.

Пользователь может получить подробную информацию об изменениях в системе через JSON API двумя способами:

Для просмотра общей ленты аудита через JSON API пользователь может запросить список контекстов, которые будут содержать общую информацию об изменениях, произошедших в системе, а также ссылку на связные с ними события. Для просмотра подробной информации по отдельному контексту, необходимо запросить события по конкретному контексту. В ответе пользователю будет содержаться детальная информация об изменениях сущности, произошедших в рамках данного обновления в системе, в специальном формате diff

Для того, чтобы получить события, связанные с конкретной сущностью, необходимо воспользоваться запросом событий по сущности. Ответ будет содержать список событий, относящихся к данной сущности или операции, где в специальном поле diff будут отражены подробные изменения полей сущности или операции.

Контексты

В аудите под контекстом подразумевается одно или несколько связанных событий, например, массовое обновление товаров. События отражают конкретные произошедшие изменения, например, изменение значения поля. Контекст же содержит только общую информацию событий, относящихся к нему.

Атрибуты сущности

Возможные значение параметра source преставлены ниже:

Значение параметра source Описание
app Все действия
copy Копирование
combine Объединение
import Импорт
importAlfabank Импорт из Альфа-Банка
importModulebank Импорт из Модульбанка
importTochkabank Импорт из Точка Банка
importTinkoffbank Импорт из Тинькофф Банка
import1c Импорт из 1С
restapi REST API
remap-1.0 JSON API 1.0
remap-1.1 JSON API 1.1
remap-1.2 JSON API 1.2
posapi POS API
retail Точка продаж
connectors Синхронизация с ИМ
evotor Синхронизация с Эвотор
clearrecyclebin Автоматическая очистка корзины
loginlogout Вход или выход из МоегоСклада
emailsend Отправка сообщения
export Экспорт
phone-1.0 Phone API

Возможные значение параметров eventType и entityType приведены в разделе Фильтры

Получить Контексты

Запрос всех изменений. Результат: Объект JSON, включающий в себя поля:

Параметры

Параметр Описание
limit number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000.
offset number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей.
filter string (optional) Example: source=jsonapi Подробное описание параметра в разделе Фильтрация выборки с помощью параметра filter Атрибуты фильтрации для Контекстов аудита представлены в разделе Фильтры

Получить Контексты

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Изменений.

СвернутьПоказать

Получить Контексты c фильтрацией

Параметры

Параметр Описание
filter string (optional) Example: filter=entityType=customerorder фильтр по типу сущности

Пример запроса с фильтрацией контекстов по типу "заказ покупателя" https://online.moysklad.ru/api/remap/1.2/audit?filter=entityType=customerorder

Получить Контексты c фильтрацией

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление списка событий аудита.

СвернутьПоказать

События

События аудита содержат подробную информацию о произошедших изменениях, например, изменение значения поля.

Типы Событий

События делятся на несколько типов, начиная от аудита создания сущности и заканчивая аудитом печати, и состоят из сведений о времени события и произошедших во время этого события изменениях. Различные типы событий отличаются друг от друга форматом поля diff, подробнее о котором ниже.

Атрибуты сущности

Формат поля diff

В данном поле отображены изменения полей сущности, произошедшие в Событии.

Сведения об изменениях в полях сущностей отображаются по всем полям, включая те, к которым нет доступа через JSON API. Для полей, используемых в JSON API для сущностей и документов, название атрибута сущности будет совпадать с названием соответствующего поля, описанного в разделе для данной сущности или документа.

Ниже приведены возможные форматы поля diff для разных типов Событий. Для событий создания сущности поле diff будет отсутствовать.

События публикации документов

События отправки писем

События удаления сущностей

События обновления сущностей, перемещения/восстановления из корзины, перемещение/восстановление из архива

Получить События по Контексту

Запрос на получение событий Контекста с указанным id. Результат: Объект JSON, включающий в себя поля:

Параметры

Параметр Описание
id string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Контекста.

Получить События по Контексту

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление списка событий.

СвернутьПоказать

Получить События по Сущности

Запрос на получение событий по сущности с указанным id. Результат: Объект JSON, включающий в себя поля:

Параметры

Параметр Описание
type string (required) Example: product тип сущности.
id string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id сущности.

Получить События по Сущности

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление списка событий.

СвернутьПоказать

Фильтры

В JSON API сервиса МойСклад предусмотрена возможность фильтрации Контекстов аудита с помощью url параметр filter. Подробнее про данный параметр можно посмотреть в разделе Фильтрация выборки с помощью параметра filter Фильтрация может осуществляться по полям, описанным ниже.

Атрибуты сущности

Допустимые операторы для фильтрации по атрибуту moment : ['>=', '<=']

Формат строки : ГГГГ-ММ-ДД ЧЧ:ММ:СС[.ммм], Часовой пояс: MSK (Московское время)

Формат строки : href

Значение параметра eventType Описание
create Создание сущностей
update Изменение сущностей
delete Удаление сущностей
puttorecyclebin Помещение в корзину
restorefromrecyclebin Извлечение из корзины
puttoarchive Помещение в архив
restorefromarchive Извлечение из архива
print Печать документа
openpublication Создание публикации
closepublication Удаление публикации
sendemailfromentity Отправка письма
bulkoperation Массовая операция
replacetoken Смена токена для Точки продаж
Значение параметра source Описание
copy Копирование
combine Объединение
import Импорт
restapi REST API
jsonapi JSON API
posapi POS API
retail Точка продаж
connectors Синхронизация с ИМ
evotor Синхронизация с Эвотор
clearrecyclebin Автоматическая очистка корзины
loginlogout Вход или выход из МоегоСклада
emailsend Отправка сообщения
export Экспорт
phone-1.0 Phone API
scriptor Работа со сценариями
Значение параметра entityType Описание
processingplanfolder Группа тех.карт
amiroconnectorsettings Настройка синхронизации (Amiro)
cmlconnectorsettings Настройка синхронизации (CML)
ecwidconnectorsettings Настройка синхронизации (Ecwid)
smartwebconnectorsettings Настройка синхронизации (SmartWeb)
ymlconnectorsettings Настройка синхронизации (YML)
vkconnectorsettings Настройка синхронизации (Вконтакте)
yandexconnectorsettings Настройка синхронизации (Яндекс.Маркет)
evotorsetting Настройка обмена с Эвотор
usersettings Настройки пользователя
user Пользователь
accountrole Роль
entitysettings Настройки сущностей
statesettings Настройки статусов
templatesettings Настройки шаблонов
scripttemplate Сценарий
crptdemand Отгрузка маркированной продукции
crptcancellation Списание кодов маркировки
crptpackagecreation Формирование упаковки
crptpackageitemremoval Изъятие из упаковки
crptpackagedisaggregation Расформирование упаковки

Также можно отфильтровать контексты аудита по пользовательскому справочнику. Для этого в качестве параметра entityType необходимо передать href пользовательского справочника. Пример: https://online.moysklad.ru/api/remap/1.2/entity/customentity/eaacabaf-2655-11e6-8a84-bae500000045

Получить Фильтры

Запрос всех фильтров аудита, доступных пользователю. Результат: Объект JSON, включающий в себя поля:

Получить Фильтры

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Фильтров аудита.

СвернутьПоказать

Уведомления

Лента уведомлений

Общие атрибуты уведомлений

Получить ленту Уведомлений

Запрос на получение ленты Уведомлений. Результат: Объект JSON, включающий в себя поля:

Параметры

Параметр Описание
limit number (optional) Default: 1000 Example: 1000 Максимальное количество сущностей для извлечения.Допустимые значения 1 - 1000.
offset number (optional) Default: 0 Example: 40 Отступ в выдаваемом списке сущностей.

Получить ленту уведомлений

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление списка Уведомлений.

СвернутьПоказать

Уведомление

Получить Уведомление

Параметры

Параметр Описание
id string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Удалить Уведомление

Запрос на удаление Уведомления. Возможно удаление только Уведомлений текущего пользователя.

Параметры

Параметр Описание
id string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Уведомления.

Запрос на удаление Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешное удаление Уведомления.

Отметить Уведомление как прочитанное

Отметить конкретное уведомление, как прочитанное. Можно отмечать только Уведомления текущего пользователя.

Параметры

Параметр Описание
id string (required) Example: 7944ef04-f831-11e5-7a69-971500188b19 id Уведомления.

Отметить конкретное уведомление, как прочитанное.

СвернутьПоказать

Response 200 (application/json) Успешное проставление признака "прочитано".

Отметить все Уведомления как прочитанные

Отметить все Уведомления текущего пользователя как прочитанные.

Отметить все Уведомления текущего пользователя как прочитанные

СвернутьПоказать

Response 200 (application/json) Успешное проставление признака "прочитано" всем непрочитанным Уведомлениям.

Типы уведомлений

Форматы полей

Формат измененного поля

Формат измененного поля содержит в себе старое и новое значение: + oldValue - Старое значение + newValue - Новое значение

Формат oldValue и newValue совпадает с форматом поля, изменение которого отображается. Одно из полей может быть не заполнено.

Возможные значения типа экспорта

Возможные значения типа импорта

Сводная таблица типов уведомлений

Тип уведомления Группа О чем уведомление
NotificationOrderNew Заказ покупателя Новый заказа покупателя
NotificationOrderOverdue Заказ покупателя Просрочен заказ
NotificationInvoiceOutOverdue Счет Просрочен счёт, который не оплатил или не полностью оплатил покупатель
NotificationGoodCountTooLow Остатки Снижение количества товара до неснижаемого остатка
NotificationTaskAssigned Задача Задача назначена
NotificationTaskUnassigned Задача Задача снята
NotificationTaskOverdue Задача Задача просрочена
NotificationTaskCompleted Задача Задача выполнена
NotificationTaskReopened Задача Задача переоткрыта
NotificationTaskNewComment Задача У задачи появился новый комментарий
NotificationTaskChanged Задача Задача поменялась
NotificationTaskDeleted Задача Задача удалена
NotificationTaskCommentDeleted Задача Комментарий у задачи был удален
NotificationTaskCommentChanged Задача Комментарий у задачи был изменен
NotificationImportCompleted Обмен данными Импорт выполнен
NotificationExportCompleted Обмен данными Экспорт выполнен
NotificationSubscribeExpired Биллинг Окончание подписки
NotificationSubscribeTermsExpired Биллинг Истекают условия подписки
NotificationRetailShiftOpened Розничная торговля Открыта смена
NotificationRetailShiftClosed Розничная торговля Закрыта смена

Подробное описание типов уведомлений

Завершение экспорта

Тип уведомления

NotificationExportCompleted - завершение экспорта

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 02950e3c-35f2-11e9-9ff4-34e8000799c0 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Завершение импорта

Тип уведомления

NotificationImportCompleted - завершение импорта

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 02950e31-35f2-11e9-9ff4-34e8000799c0 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Снижение остатка товара ниже неснижаемого

Тип уведомления

NotificationGoodCountTooLow - снижение остатка товара ниже неснижаемого

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 9338c8bd-56e5-11e9-c0a8-100b00000023 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Просрочен счет покупателя

Тип уведомления

NotificationInvoiceOutOverdue - просрочен счет покупателя

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 572d1dd9-56fc-11e9-c0a8-100b00000006 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Новый заказ

Тип уведомления

NotificationOrderNew - новый заказ

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: c6082a9e-56e1-11e9-c0a8-100b00000011 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Просроченный заказ

Тип уведомления

NotificationOrderOverdue - просроченный заказ

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: c6082a9e-56e1-11e9-c0a8-100b00000011 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Окончание подписки

Тип уведомления

NotificationSubscribeExpired - окончание подписки

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: c2582a9e-56e1-11e9-c0a8-100b00000123 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Условия подписки истекают

Тип уведомления

NotificationSubscribeTermsExpired - условия подписки истекают

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: c2582a9e-56e1-11e9-c0a8-100b00000125 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Задача назначена

Тип уведомления

NotificationTaskAssigned - задача назначена

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: bcd815b9-56ca-11e9-c0a8-100b00000001 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Задача снята

Тип уведомления

NotificationTaskUnassigned - задача снята

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 80c8a58b-56cb-11e9-c0a8-100b00000009 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Задача изменена

Тип уведомления

NotificationTaskChanged - задача изменена

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: bd0dbccf-56ca-11e9-c0a8-100b00000003 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Задача выполнена

Тип уведомления

NotificationTaskCompleted - задача выполнена

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 7945a089-56fd-11e9-c0a8-100b00000008 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Задача удалена

Тип уведомления

NotificationTaskDeleted - задача удалена

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 8d07388c-56cb-11e9-c0a8-100b0000000d id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Задача просрочена

Тип уведомления

NotificationTaskOverdue - задача просрочена

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 51a5b0a3-56e4-11e9-c0a8-100b00000014 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Задача переоткрыта

Тип уведомления

NotificationTaskReopened - задача переоткрыта

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: df0c3e22-56fd-11e9-c0a8-100b0000000a id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Новый комментарий к задаче

Тип уведомления

NotificationTaskNewComment - новый комментарий к задаче

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 240706df-5704-11e9-c0a8-100b00000003 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Изменен комментарий к задаче

Тип уведомления

NotificationTaskCommentChanged - изменен комментарий к задаче

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 3d3423ee-5704-11e9-c0a8-100b00000007 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Удален комментарий к задаче

Тип уведомления

NotificationTaskCommentDeleted - удален комментарий к задаче

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 3d2abf0f-5704-11e9-c0a8-100b00000005 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Смена открыта

Тип уведомления

NotificationRetailShiftOpened - смена открыта

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 8002409b-351d-11e9-9ff4-34e80002a126 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Смена закрыта

Тип уведомления

NotificationRetailShiftClosed - смена закрыта

Атрибуты уведомления

Параметры

Параметр Описание
id string (required) Example: 3929d717-351c-11e9-9ff4-34e800029ad4 id Уведомления.

Запрос на получение Уведомления с указанным id.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. Результат - JSON представление Уведомления.

СвернутьПоказать

Настройки уведомлений

Атрибуты сущности

Значения кода группы уведомлений.

Код группы уведомлений Описание
customer_order Заказы покупателей
invoice Счета покупателей
stock Складские остатки
retail Розничная торговля
task Задачи
data_exchange Обмен данными

Получить настройки уведомлений

Запрос настроек Уведомлений текущего пользователя.

Запрос настроек Уведомлений текущего пользователя.

СвернутьПоказать

Response 200 (application/json) Успешный запрос. JSON представление настроек уведомлений.

СвернутьПоказать

Изменить настройки уведомлений

Изменение настроек Уведомлений текущего пользователя.

Изменение настроек Уведомлений текущего пользователя.

СвернутьПоказать

Response 200 (application/json) Успешное изменение настроек уведомлений.