Описание True API

Версия 25.0
На 409 листах
 Содержание
История изменений....................................................................................................................................... 9
1. Назначение и условия применения True API ....................................................................................... 24
1.1. Электронное взаимодействие УОТ и Оператора ГИС МТ .......................................................... 24
1.2. Требования к файлам обмена ......................................................................................................... 25
1.3. Экранирование ................................................................................................................................. 26
1.4. Тип возвращаемого методами API контента ................................................................................ 27
1.5. Единая аутентификация .................................................................................................................. 28
1.5.1. Запрос авторизации при единой аутентификации................................................................. 28
1.5.2. Получение ключа сессии при единой аутентификации ........................................................ 28
1.6. Типы приватности методов True API в зависимости от аутентификационного токена ........... 30
2. Рекомендации по работе с методами True API .................................................................................... 31
2.1. Процесс регистрации УОТ.............................................................................................................. 31
2.1.1. Шаг 1: вызов метода создания заявки на регистрацию УОТ ............................................... 31
2.1.2. Шаг 2: проверка статуса заявки на регистрацию по ID заявки ............................................ 31
2.1.3. Шаг 3: получение сведений по черновикам договоров между УОТ и ГИС МТ ................ 31
2.1.4. Шаг 4: получение (выгрузка) черновиков договоров для подписания УОТ ...................... 31
2.1.5. Шаг 5: подписание договоров ................................................................................................. 32
2.1.6. Шаг 6: выгрузка подписанных договоров .............................................................................. 32
2.2. Агрегация и ввод товаров в оборот................................................................................................ 32
2.2.1. Шаг 1: получение информации о статусе КИ ........................................................................ 33
2.2.2. Шаг 2: агрегация товаров с использованием "Единого метода создания документов" .... 33
2.2.3. Шаг 3: проверка формирования документа об агрегации .................................................... 33
2.2.4. Шаг 4: проверка значения КИ агрегата .................................................................................. 33
2.2.5. Ввод в оборот ............................................................................................................................ 33
2.3. Отгрузка и приёмка товара ............................................................................................................. 34
2.3.1. Подача сведений в документе "Отгрузка" ............................................................................. 34
2.3.2. Приёмка товара ......................................................................................................................... 34
2.3.2.1. Шаг 1: получение сведений о новых документах, загруженных в ГИС МТ ............... 34
2.3.2.2. Шаг 2: получение сведений о содержимом документа по идентификатору ............... 35
2.3.2.3. Шаг 3: подача сведений о приёмке .................................................................................. 35
2.3.2.4. Шаг 4: просмотр статуса отправленного документа "Приемка" .................................. 35
2.4. Вывод товара из оборота................................................................................................................. 35
2.5. Возврат в оборот .............................................................................................................................. 35
3. Обращение к True API ............................................................................................................................ 37
2
 3.1. Регистрация УОТ ............................................................................................................................. 37
3.1.1. Метод создания заявки на регистрацию УОТ........................................................................ 37
3.1.2. Метод проверки статуса заявки УОТ на регистрацию по ID заявки ................................... 45
3.2. Метод проверки регистрации УОТ по ИНН в системе ГИС МТ ................................................ 46
3.3. Работа со счетами и договорами на оплату................................................................................... 48
3.3.1. Получение сведений по черновикам заключённых договоров между УОТ и Оператором
ГИС МТ ............................................................................................................................................... 48
3.3.2. Получение сведений по заключённым договорам между УОТ и ГИС МТ ........................ 51
3.3.3. Подписание договоров ............................................................................................................. 52
3.3.4. Получение статуса заключения договора .............................................................................. 53
3.3.5. Получение сведений о заключенных договорах между УОТ и Оператором ГИС МТ ..... 55
3.3.6. Получение счёта на оплату ...................................................................................................... 56
3.4. Проверка баланса денежных средств УОТ по товарным группам ............................................. 57
3.4.1. Получение информации о балансе денежных средств по всем товарным группам .......... 57
3.4.2. Получение информации о балансе денежных средств по одной товарной группе............ 59
3.5. Запрос списка контрагентов УОТ (ТГ "Табачная продукция" и "Альтернативная табачная
продукция") ............................................................................................................................................. 60
3.5.1. Запрос списка контрагентов .................................................................................................... 60
3.5.2. Запрос списка контрагентов УОТ (для ФОИВ, Оператора, Администратора) .................. 61
4. Подача сведений в систему ГИС МТ через "Единый метод создания документов" ....................... 63
4.1. Единый метод создания документов ............................................................................................. 63
4.2. Типы документов для подачи сведений в ГИС МТ ..................................................................... 64
4.2.1. Описание остатков .................................................................................................................... 64
4.2.2. Агрегирование........................................................................................................................... 66
4.2.2.1. Агрегация ........................................................................................................................... 66
4.2.2.2. Трансформация .................................................................................................................. 68
4.2.2.3. Расформирование............................................................................................................... 70
4.2.3. Формирование наборов ............................................................................................................ 71
4.2.4. Операции с АТК........................................................................................................................ 73
4.2.4.1. Формирование АТК ........................................................................................................... 73
4.2.4.2. Трансформация АТК ......................................................................................................... 74
4.2.4.3. Расформирование АТК...................................................................................................... 76
4.2.5. Ввод в оборот ............................................................................................................................ 77
4.2.5.1. Ввод в оборот. Производство РФ ..................................................................................... 77
4.2.5.2. Ввод в оборот. Полученных от физических лиц ............................................................ 80

3
 4.2.5.3. Ввод в оборот. Производство вне ЕАЭС ......................................................................... 81
4.2.5.4. Ввод в оборот. Трансграничная торговля ....................................................................... 84
4.2.5.5. Ввод в оборот. На территории стран ЕАЭС (контрактное производство)................... 87
4.2.5.6. Ввод в оборот. Маркировка остатков .............................................................................. 90
4.2.5.7. Ввод в оборот. Контрактное производство РФ .............................................................. 92
4.2.5.8. Ввод в оборот. Импорт с ФТС .......................................................................................... 94
4.2.5.8.1. Декларация на товары ................................................................................................ 99
4.2.6. Возврат в оборот ..................................................................................................................... 111
4.2.7. Отгрузка ................................................................................................................................... 114
4.2.7.1. Отгрузка с выводом из оборота...................................................................................... 117
4.2.7.2. Отгрузка при трансграничной торговле ........................................................................ 119
4.2.7.3. Отмена отгрузки .............................................................................................................. 121
4.2.7.4. Отмена отгрузки при трансграничной торговле ........................................................... 121
4.2.8. Приемка ................................................................................................................................... 122
4.2.9. Вывод из оборота .................................................................................................................... 129
4.2.10. Списание КИ ......................................................................................................................... 133
4.2.10.1. Списание не нанесенных КИ с/без СИ ........................................................................ 133
4.2.10.2. Списание нанесенных КИ с СИ.................................................................................... 135
4.2.11. Перемаркировка .................................................................................................................... 137
4.2.12. Агрегирование (ТГ "Табачная продукция", "Альтернативная табачная продукция" и
"Никотиносодержащая продукция")............................................................................................... 144
4.2.13. Выбытие (ТГ "Табачная продукция", "Альтернативная табачная продукция" и
"Никотиносодержащая продукция")............................................................................................... 148
5. Методы получения сведений о КИ и маркированных товарах ........................................................ 153
5.1. Получение данных о КИ ............................................................................................................... 153
5.1.1. Метод получения краткой информации о списке КИ по заданному фильтру ................. 153
5.1.2. Метод получения подробной информации о списке КИ товаров по заданному фильтру
............................................................................................................................................................ 157
5.1.3. Метод получения общедоступной информации о КИ по списку ...................................... 164
5.1.4. Метод получения краткой общедоступной информации о КИ по списку ........................ 171
5.2. Метод получения истории движения КИ .................................................................................... 174
5.2.1. Метод получения карточки товара по КИ ............................................................................ 177
5.2.2. Получение вложенной структуры агрегированных КИ ...................................................... 185
5.2.2.1. Запрос списка агрегированных КИ (GET) .................................................................... 185
5.2.2.2. Запрос списка агрегированных КИ (POST) .................................................................. 188

4
 5.3. Метод получения списка десятизначных кодов ТН ВЭД .......................................................... 191
5.4. Получение информации о карточках товара УОТ ..................................................................... 192
5.4.1. Метод получения информации о товаре по GTIN товара .................................................. 192
5.4.2. Метод получения списка кодов товаров (GTIN) УОТ по ИНН ......................................... 197
5.5. Метод получения кода товарной группы по КИ товара (GTIN) ............................................... 201
5.6. Работа с согласием о предоставлении информации участникам оборота товаров ГИС МТ . 203
5.6.1. Метод создания документа согласия о предоставлении сведений о КИ .......................... 203
5.6.2. Метод получения информации о КИ по списку КИ при наличии согласия о
предоставлении информации .......................................................................................................... 205
5.6.3. Метод аннулирования подписанного согласия о предоставлении информации ............. 208
5.6.4. Метод отображения списка документов согласия о предоставлении информации ........ 210
5.6.5. Метод получения тела документа согласия или документа аннулирования согласия .... 215
5.6.6. Метод подписания документа согласия или документа аннулирования согласия о
предоставлении информации .......................................................................................................... 216
5.6.7. Метод получения списка ИНН доверенных участников оборота товаров ....................... 218
5.6.8. Метод проверки ИНН доверенного участника оборота товаров ....................................... 219
5.6.9. Метод получения списка ИНН по идентификатору документа согласия о предоставлении
информации ....................................................................................................................................... 221
5.7. Метод регистрация табачной продукции от производителя/импортёра .................................. 222
5.8. Метод получения истории движения КИ ТГ "Табачная продукция" ....................................... 225
5.9. Метод проверки КИ ТГ "Табачная продукция" на вхождение в "Серую зону" ...................... 228
6. Работа с документами и чеками в ГИС МТ ....................................................................................... 230
6.1. Метод получения списка загруженных документов в ГИС МТ ............................................... 230
6.2. Метод получения списка загруженных чеков ККТ в ГИС МТ ................................................. 234
6.3. Метод поиска содержимого документа по идентификатору документа.................................. 236
6.4. Метод получения содержимого документа по идентификатору .............................................. 237
6.5. Метод получения содержимого чека ККТ по идентификатору ................................................ 242
6.6. Метод отправки документа ЭДО на повторную обработку ...................................................... 243
6.7. Метод подачи УПД на предварительную проверку ................................................................... 245
6.8. Метод получения статуса обработки документа ........................................................................ 247
6.9. Метод получения списка КИ по номеру документа................................................................... 249
6.10. Метод получения списка кодов идентификации и GTIN по номеру документа................... 250
7. Метод получения квитанций результата обработки документов .................................................... 253
7.1. Метод получения квитанций результата обработки универсального документа по
идентификатору документа ................................................................................................................. 253

5
 7.2. Метод получения квитанции результата обработки документа по идентификатору чека .... 258
7.3. Описание кодов возвращаемых ошибок при обработке документов ....................................... 262
8. Методы формирования выгрузок данных из ГИС МТ ..................................................................... 268
8.1. Метод создания нового задания на выгрузку ............................................................................. 268
8.1.1. Получение сведений по кодам идентификации и агрегатам .............................................. 269
8.1.2. Получение ошибок по результатам обработки документов ............................................... 270
8.1.3. Получение списка кодов идентификации УОТ по заданному фильтру ............................ 270
8.1.4. Пример ответа для всех формируемых запросов на выгрузку ........................................... 272
8.2. Метод получения статуса задания на выгрузку по ID выгрузки .............................................. 274
8.3. Метод получения результирующих ID выгрузок данных ......................................................... 275
8.4. Метод получения ZIP файла выгрузки ........................................................................................ 277
8.4.1. Метод получения CSV ошибок по результатам обработки документов........................... 277
8.4.2. Метод получения CSV по кодам идентификации и агрегатам .......................................... 281
8.4.3. Метод получения CSV по списку кодов идентификации УОТ по заданному фильтру .. 283
9. Взаимодействие с провайдером ЭДО Lite.......................................................................................... 286
9.1. Публичный метод получения идентификатора абонента в ЭДО Lite ...................................... 286
9.2. Метод загрузки титулов ................................................................................................................ 288
9.3. Метод загрузки квитанций с уведомлением об уточнении ....................................................... 289
9.4. Метод загрузки квитанций с предложением об аннулирования............................................... 290
9.5. Метод аннулирования документа ................................................................................................ 292
9.6. Метод загрузки квитанций c предложением отклонения аннулирования ............................... 293
9.7. Метод получения ZIP-архива документа ЭДО с подписями и квитанциями из ЭДО Lite..... 294
10. Методы Национального каталога ..................................................................................................... 296
10.1. Универсальные параметры запроса ........................................................................................... 296
10.2. Метод получения списка атрибутов как публичных, так и приватных для запрашивающего
аккаунта ................................................................................................................................................. 296
10.3. Метод получения списка торговых марок ................................................................................ 300
10.4. Метод получения списка субаккаунтов компании ................................................................... 302
10.5. Метод подписи предоставления или отзыва разрешения на использование КИ .................. 303
10.6. Метод получения файла в формате XML для управления доступами субаккаунтов ........... 305
10.7. Метод получения дерева категорий, корень дерева не возвращается .................................... 308
10.8. Метод получения полной информации о товаре ...................................................................... 309
10.9. Метод получения краткой информации о товаре ..................................................................... 328
10.10. Метод получения карточки товара, в том числе неопубликованной карточки ................... 337
10.11. Метод подписи карточки товара .............................................................................................. 349
6
 10.12. Метод получения XML товаров по массиву ID товаров или коду товара ........................... 351
10.13. Метод получения массива ID прошедших валидацию товаров ............................................ 353
10.14. Метод получения списка всех принадлежащих одному владельцу товаров ....................... 355
10.15. Метод изменения размера изображения с заполнением недостающих полей белым цветом
................................................................................................................................................................ 357
10.16. Метод генерации черновиков кодов товаров .......................................................................... 358
10.17. Метод создания и обновления товаров.................................................................................... 360
10.18. Метод получения статуса фида по ID фида от его заказчика ............................................... 369
10.19. Метод отправки на модерацию карточки товаров в статусе "Черновик" ............................ 377
10.20. Метод определения кода принадлежности товара к маркируемым товарным группам .... 378
11. Методы "Станции управления заказами" ......................................................................................... 382
11.1. Метод получения токена аутентификации в СУЗ .................................................................... 382
Список сокращений, условных обозначений и терминов .................................................................... 384
Приложение 1. Справочники ................................................................................................................... 387
Справочник "Список поддерживаемых товарных групп" .................................................................... 388
Справочник "Типы документов" ......................................................................................................... 388
Справочник "Статусы проверок УПД" ............................................................................................... 392
Справочник "Типы договоров" ........................................................................................................... 392
Справочник "Типы эмиссии КИ" ........................................................................................................ 393
Справочник "Статусы КИ" .................................................................................................................. 393
Актуальные статусы ......................................................................................................................... 393
Актуальные особые состояния ........................................................................................................ 393
Справочник "Типы производства" ...................................................................................................... 395
Справочник "Типы упаковки" ............................................................................................................. 395
Справочник "Статусы заказов" ........................................................................................................... 396
Справочник "Статусы документов" .................................................................................................... 396
Справочник "Причины вывода из оборота" ....................................................................................... 397
Справочник "Статусы ответов" ........................................................................................................... 397
Справочник "Типы организаций" ....................................................................................................... 399
Справочник "Статусы УОТ" ................................................................................................................ 400
Справочник "Статусы заявки на регистрацию УОТ"........................................................................ 400
Справочник "Статусы документа в жизненном цикле SD" .............................................................. 400
Справочник "Статусная модель" ......................................................................................................... 400
Справочник "Дополнительные параметры в ответе в зависимости от товарных групп" .............. 401

7
 Дополнительные параметры для ТГ "Альтернативная табачная продукция" и "Табачная
продукция" ........................................................................................................................................ 401
Дополнительные параметры для ТГ "Обувные товары" .............................................................. 402
Дополнительные параметры для ТГ "Предметы одежды, бельё постельное, столовое, туалетное
и кухонное"........................................................................................................................................ 402
Дополнительные параметры для ТГ "Фотокамеры (кроме кинокамер), фотовспышки и лампы-
вспышки" ........................................................................................................................................... 403
Дополнительные параметры для ТГ "Велосипеды и велосипедные рамы"................................ 403
Дополнительные параметры для ТГ "Кресла-коляски" ................................................................ 404
Дополнительные параметры для ТГ "Духи и туалетная вода" .................................................... 404
Дополнительные параметры для ТГ "Шины и покрышки пневматические резиновые новые"405
Дополнительные параметры для ТГ "Молочная продукция" ...................................................... 405
Дополнительные параметры для ТГ "Упакованная вода" ............................................................ 406
Дополнительные параметры для ТГ "Товары из натурального меха" ........................................ 406
Приложение 2. Примеры аутентификации по УКЭП / Подписание документов .............................. 407
Пример получения токена при авторизации с прикрепленной подписью / подписание документов
с открепленной подписью на 1С ......................................................................................................... 407
Пример получения токена при авторизации REACT JS ................................................................... 408
Пример получения токена при авторизации с помощью прикрепленной подписи / подписание
документов с помощью открепленной подписи на Java ................................................................... 408
Описание методов плагина .................................................................................................................. 409

8
История изменений
Версия
Дата документа Изменения
20.02.2021 25.0 Добавлено описание типов документов "Ввод в оборот. Импорт с ФТС", "Формирование
АТК", "Расформирование АТК", "Трансформация АТК" для товарной группы "Молочная
продукция"
18.05.2021 24.0 Скорректирован тип документа "Вывод из оборота"; Актуализирован "Справочник "Статусы
документов";
Актуализирован "Метод получения информации о товаре по GTIN товара";
Актуализирован"Метод получения списка кодов товаров (GTIN) УОТ по ИНН":
рекомендуется использовать версию v4, версия v3 в дальнейшем будет отключена.
17.05.2021 23.0 В документе "Приемка" длина значения параметра "exporter_taxpayer_id" ("УНП экспортёра")
должно соответствовать 8/9/10/12/14 символов;
Расширено описание параметра "document_type" ("Тип первичного документа") типа
документа "Вывод из оборота";
Для типов документов "Ввод в оборот. Производство РФ", "Приемка", "Ввод в оборот.
Производство вне ЕАЭС", "Ввод в оборот. Контрактное производство РФ", "Ввод в оборот.
Трансграничная торговля", "Ввод в оборот. На территории стран ЕАЭС (контрактное
производство)" добавлено описание ФЛК по обработке значения параметра "vsd_number"
("Номер ВСД");
Добавлен код "GROUP" ("Групповая упаковка") в "Справочник "Типы упаковки""
11.05.2021 22.0 Типы документов "Отгрузка", "Отгрузка с выводом из оборота", "Отмена отгрузки",
"Приемка" в формате * .xml недоступны для товарной группы "Молочная продукция";
В тип документа "Вывод из оборота" добавлен параметр "withdrawal_type_other" ("Другая
причина") в связи с реализацией функциональности вывода из оборота по причине "Другое"
для всех товарных групп, кроме товарных групп "Альтернативная табачная продукция",
"Никотиносодержащая продукция" и "Табачная продукция";
Актуализирован "Справочник "Причины вывода из оборота"";
Актуализирован справочник "Актуальные особые состояния"
06.05.2021 21.0 Добавлена рекомендация по использованию методов "Метод поиска содержимого документа
по идентификатору документа" и "Метод получения общедоступной информации о КИ по
списку" при наличии в документе "Отгрузка" 10000 КИ и более в разделе "Подача сведений в
документе "Отгрузка"";
Заменён рекомендуемый метод для использования при наличии в документе "Приемка" 10000
КИ и более на "Метод поиска содержимого документа по идентификатору документа" в
разделе "Шаг 2: получение сведений о содержимом документа по идентификатору";
Актуализирован пример запроса в разделе "Метод поиска содержимого документа по
идентификатору документа";
Актуализирован URL в разделе "Метод получения содержимого документа по
идентификатору"; Тип документов "Ввод в оборот. Маркировка остатков" недоступен для
товарной группы "Предметы одежды, бельё постельное, столовое, туалетное и кухонное";
В разделе скорректирован "Метод получения списка ИНН доверенных участников оборота
товаров" URL и пример запроса, удалены параметры запроса "filter" ("Фильтр поиска
доверенных участников") и "pg" ("Товарная группа"), добавлено примечание: "В запросе
должен быть указан параметр "ownerInn" ("ИНН доверителя"), иначе в ответе возвращается
ошибка 400 "Bad request" ("Ошибка в параметрах запроса");
В разделе "Метод получения статуса обработки документа" для параметра "cis" расширено
описание: "КИ/КИН/КИТУ/КИГУ/КИТУ", актуализирована обязательность и добавлен
комментарий: "Проверка вложений в КИН/КИТ/КИГУ/КИТУ не осуществляется.
Возвращаются КИ/КИН/КИТ/КИГУ/КИТУ (без указания вложений), по которым выявлены
ошибки";

9
 Версия
Дата документа Изменения
В раздел "Метод получения статуса обработки документа" добавлена информация об
ограничении по количеству возвращаемых ошибок по документу: 1000;
Добавлено примечание: "При отсутствии вложений в агрегате, в ответе возвращается пустой
массив КИ в квадратных скобках "[]" в раздел "Запрос списка агрегированных КИ (POST)"";
Добавлен параметр запроса "pg" ("Товарная группа") в "Метод получения содержимого
документа по идентификатору". Указание данного параметра обязательно при установке
параметра "limit";
В описании раздела "Метод получения списка загруженных документов в ГИС МТ" удалён
параметр ответа "externalId" ("ID документа во внешней системе ЭДО");
Добавлены параметры ответа "additionalProp" ("Контент документа") и "additionalProp"
("Список ошибок обработки документа") в "Метод получения списка загруженных документов
в ГИС МТ", "Метод получения содержимого документа по идентификатору"
22.04.2021 20.1 Актуализирован успешный ответ на запрос в разделе "Метод получения общедоступной
информации о КИ по списку";
Тип документа "Ввод в оборот. Маркировка остатков" доступен для единиц товаров товарной
группы "Обувные товары", описанных в КМТ по полному атрибутивному составу. В текущей
реализации заполнение параметра "kitu" ("КИТУ") для товарной группы "Обувные товары"
недоступно в документе "Ввод в оборот. Маркировка остатков". Плановый срок отключения
возможности создания документа для товарной группы "Обувные товары" - 16.06.2021;
Для документа "Ввод в оборот. Маркировка остатков" параметр "products_list" ("Список
сведений о товарах") обязательный для заполнения
16.04.2021 20.0 Расширено описание параметра "cis" документа "Ввод в оборот. Импорт с ФТС";
Актуализирован "Справочник "Список поддерживаемых товарных групп"";
Добавлено уточнение для методов "Получение сведений по кодам идентификации и агрегатам"
и "Получение списка кодов идентификации УОТ по заданному фильтру" выполнением
проверки наличия договора по всем товарным группам, по КИ которых запрашивается
выгрузка; Дополнено ограничение на использование значений для параметра "withdrawal_type"
("Причина вывода из оборота") в документе "Отгрузка с выводом из оборота" для товарной
группы "Молочная продукция";
В документе "Возврат в оборот" удалено значение RECEIPT_RETURN ("Чек возврата")
параметра "return_type"
05.04.2021 19.0 Дополнено описание параметров документ "Ввод в оборот. Импорт с ФТС";
Актуализирован состав параметров документа "Декларация на товары";
Актуализирован "Справочник "Дополнительные параметры в ответе в зависимости от
товарных групп"";

01.04.2021 18.0 Добавлена ТГ "Никотиносодержащая продукция" в "Справочник "Список поддерживаемых

товарных групп"";
Документы "Описание остатков", "Агрегирование (ТГ "Табачная продукция", "Альтернативная
табачная продукция" и "Никотиносодержащая продукция")", "Выбытие (ТГ "Табачная
продукция", "Альтернативная табачная продукция" и "Никотиносодержащая продукция")"
доступны для товарной группы "Никотиносодержащая продукция";
В "Справочник "Список поддерживаемых товарных групп"" добавлена товарная группа "Пиво,
напитки, изготавливаемые на основе пива, слабоалкогольные напитки";
Типы документов "Агрегация", "Возврат в оборот", "Вывод из оборота", "Трансформация",
"Расформирование", "Списание не нанесенных КИ с/без СИ" доступны для товарной группы
"Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки";
В ответе метода "Метод получения краткой общедоступной информации о КИ по списку"
добавлен параметр "maxRetailPrice" ("Максимальная цена розничной продажи");
Методы получения квитанций результата обработки документов сгруппированы в раздел

10
 Версия
Дата документа Изменения
"Метод получения квитанций результата обработки документов"
26.03.2021 17.3 Добавлен "Метод получения квитанции результата обработки документа по идентификатору
чека" Актуализирован "Справочник "Дополнительные параметры в ответе в зависимости от
товарных групп"";
Актуализировано описание в разделе "Метод получения информации о товаре по GTIN
товара";
Дополнено описание параметров типов документов в формате * .json "Агрегирование (ТГ
"Табачная продукция" и "Альтернативная табачная продукция")" и "Выбытие (ТГ "Табачная
продукция" и "Альтернативная табачная продукция")";
Изменён тип параметра "partialSaleInfo" (Объект параметров частичного выбытия);
Для документа "Ввод в оборот. Импорт с ФТС" дополнено описание параметра "cis" (КИ);
Актуализирован перечень товарных групп, для которых доступен документ "Ввод в оборот.
Производство вне ЕАЭС";
Добавлен "Справочник "Причины вывода из оборота (списание)"
19.03.2021 17.2 Скорректировано описание параметров метода "Выбытие (ТГ "Табачная продукция" и
"Альтернативная табачная продукция")"; "Метод получения информации о товаре по КИ
товара" переименован в "Метод получения информации о товаре по GTIN товара";
Тип документа "Ввод в оборот. Маркировка остатков" доступен для единиц товаров товарной
группы "Предметы одежды, бельё постельное, столовое, туалетное и кухонное", описанных в
КМТ по полному атрибутивному составу. Плановый срок отключения возможности создания
документа для товарной группы "Предметы одежды, бельё постельное, столовое, туалетное и
кухонное" - 01.05.2021. В текущей реализации заполнение параметра "kitu" для товарной
группы "Предметы одежды, бельё постельное, столовое, туалетное и кухонное" недоступно в
документе "Ввод в оборот. Маркировка остатков"
15.03.2021 17.1 Скорректировано описание для параметра "packType" документа "Ввод в оборот. Импорт с
ФТС"
12.03.2021 17.0 В разделе "Формирование наборов" добавлено примечание по расформированию набора с
ошибочно добавленными КИ;
Актуализировано описание параметров и примеры документа "Приемка" в формате * .json;
Актуализирован документ "Отгрузка при трансграничной торговле";
Актуализирована информация о стендах в разделе "Электронное взаимодействие УОТ и
Оператора ГИС МТ";
Скорректировано описание формата даты в параметрах документа "Отгрузка";
Скорректировано описание в разделе "Метод получения информации о товаре по КИ товара";
Добавлен формат * .json для типов документов "Агрегирование (ТГ "Табачная продукция" и
"Альтернативная табачная продукция")" и "Выбытие (ТГ "Табачная продукция" и
"Альтернативная табачная продукция")"; Добавлен метод "Метод получения истории
движения КИ";
Добавлена информация о необходимости наличия согласия в раздел "Работа с согласием о
предоставлении информации участникам оборота товаров ГИС МТ";
Актуализировано описание метода "Метод получения истории движения КИ ТГ "Табачная
продукция"";
Добавлен "Метод поиска содержимого документа по идентификатору документа";
Внесены корректировки в запросы и ответы методов "Национального каталога маркированных
товаров":
- "Метод подписи карточки товара"; - "Метод подписи предоставления или отзыва разрешения
на использование КИ"; - "Метод получения файла в формате XML для управления доступами
субаккаунтов" * "Метод получения списка субаккаунтов компании"; * "Метод подписи
карточки товара"; * "Метод получения списка субаккаунтов компании"; * "Метод получения

11
 Версия
Дата документа Изменения
файла в формате XML для управления доступами субаккаунтов"; * "Метод подписи
предоставления или отзыва разрешения на использование КИ";
04.03.2021 16.0 Реализована версия 4 (v4) метода GET /edo/inn/{inn} ("Публичный метод получения
идентификатора абонента в ЭДО Lite"). Версия 3 метода будет поддерживаться для
сохранения обратной совместимости. Плановая дата отключения: 03.08.2021;

В разделе "Метод получения информации о товаре по КИ товара" добавлена версия метода 4

(v4), актуализированы примеры запроса и ответа;

Расширены параметры ответа в методах:

"Метод получения информации о товаре по КИ товара";
"Метод получения списка КИ по номеру документа";

Изменены параметры запроса и ответа для следующих методов:

"Метод получения списка всех принадлежащих одному владельцу товаров";
Метод получения списка всех принадлежащих одному владельцу товаров";
"Метод определения кода принадлежности товара к маркируемым товарным группам";

Добавлены методы "Национального каталога":

"Метод подписи карточки товара";
"Метод получения списка субаккаунтов компании";
"Метод получения файла в формате XML для управления доступами субаккаунтов";
"Метод подписи предоставления или отзыва разрешения на использование КИ";

Добавлен новый раздел "Методы "Станции управления заказами"" и "Метод получения токена
аутентификации в СУЗ"
01.03.2021 15.2 Добавлен комментарий к ошибке 107 в разделе "Описание кодов возвращаемых ошибок при
обработке документов";
Тип документа "Описание остатков" недоступен для ТГ "Шины и покрышки пневматические
резиновые новые" с 01.03.2021
24.02.2021 15.1 В "Метод получения списка загруженных документов в ГИС МТ" добавлена возможность
указывать в запросе значение "empty" в параметре "pg", если товарная группа в документе не
определена;
Актуализировано примечание для документа "Агрегация";
Добавлен "Метод получения тела документа согласия или документа аннулирования
согласия";
Для методов раздела скорректирован формат даты параметра "expirationDate" ("Дата
окончания срока действия согласия");

Актуализированы примеры curl методов:

"Метод получения списка загруженных документов в ГИС МТ";

"Метод получения списка загруженных чеков ККТ в ГИС МТ";
"Метод получения содержимого документа по идентификатору";
"Метод получения общедоступной информации о КИ по списку";
"Метод получения краткой общедоступной информации о КИ по списку";
"Запрос списка агрегированных КИ (GET)";

12
 Версия
Дата документа Изменения
"Запрос списка агрегированных КИ (POST)";
"Метод получения списка десятизначных кодов ТН ВЭД";
"Метод получения информации о товаре по КИ товара";
"Метод отправки документа ЭДО на повторную обработку";
Расширены параметры запроса в разделе "Метод отправки документа ЭДО на повторную
обработку"
17.02.2021 15.0 В документе "Ввод в оборот. Полученных от физических лиц" скорректировано примечание;
Актуализированы примеры ответа в разделах "Метод получения общедоступной информации
о КИ по списку", "Метод получения краткой общедоступной информации о КИ по списку",
"Метод получения истории движения КИ ТГ "Табачная продукция"" и "Метод получения
информации о КИ по списку КИ при наличии согласия о предоставлении информации" в
рамках реализации функциональности по частичному выбытию для товарных групп
"Альтернативная табачная продукция" и "Духи и туалетная вода"
11.02.2021 14.0 В разделе "Метод отправки документа ЭДО на повторную обработку" изменилось описание
ошибок; "Метод получения квитанций результата обработки универсального документа по
идентификатору документа" позволяет получить квитанцию результата обработки
предложения об аннулировании УД;
Актуализировано описание кода "CANCELLED" в разделе Справочник "Статусы документов";
Добавлены описания методов "Метод подачи УПД на предварительную проверку" и "Метод
получения статуса обработки документа" в раздел "Взаимодействие с провайдером ЭДО Lite";
Изменилась структура по запрашиваемому массиву ИНН участников оборота товаров в
разделе "Метод проверки регистрации УОТ по ИНН в системе ГИС МТ"
10.02.2021 13.4 В "Метод получения общедоступной информации о КИ по списку" и "Метод получения
краткой общедоступной информации о КИ по списку" добавлен необязательный параметр
ответа "ИНН агента" ("agentInn")
09.02.2021 13.3 Актуализирована обязательность параметров типа документа "Отгрузка при трансграничной
торговле";
Актуализированы обязательность и описание параметров типа документа "Приемка";
В методе "Выбытие (ТГ "Табачная продукция" и "Альтернативная табачная продукция")"
изменена обязательность параметра "КодыИдентификации"; Актуализированы методы раздела
"Работа с согласием о предоставлении информации участникам оборота товаров ГИС МТ"
04.02.2021 13.2 В разделе "Получение списка кодов идентификации УОТ по заданному фильтру" расширен
комментарий параметра запроса "emissionDateFrom" ("Дата эмиссии от");
В раздел "Метод получения краткой информации о списке КИ по заданному фильтру"
добавлен параметр запроса "remarkHistory" ("Фильтрация по истории перемаркировки КИ");
В разделе "Метод получения содержимого документа по идентификатору" расширен
комментарий параметра запроса "limit" ("Значение устанавливает количество записей в
ответе");
В разделе "Метод получения подробной информации о списке КИ товаров по заданному
фильтру" добавлен фильтр по типу упаковки;
Внесены изменения в "Метод получения CSV ошибок по результатам обработки документов";
Дополнено описание назначения метода "Получение списка кодов идентификации УОТ по
заданному фильтру"
01.02.2021 13.1 Типы документов "Ввод в оборот. Маркировка остатков" и "Описание остатков" недоступны
для ТГ "Предметы одежды, бельё постельное, столовое, туалетное и кухонное" с 01.02.2021;
Актуализирована примеры документа "Описание остатков" в формате *.json и *.xml.
29.01.2021 13.0 Добавлены методы формирование выгрузок данных из ГИС МТ: метод "Получение списка
кодов идентификации УОТ по заданному фильтру" и "Метод получения CSV по списку кодов

13
 Версия
Дата документа Изменения
идентификации УОТ по заданному фильтру";
В справочник "Актуальные статусы" добавлен статус "Возвращён в оборот"
(INTRODUCED_RETURNED) для ТГ "Табачная продукция" и "Альтернативная табачная
продукция";
Для документа "Ввод в оборот. Полученных от физических лиц" тип выпуска КИ должен быть
только COMMISSION ("Принят от физических лиц"). Тип выпуска КИ LOCAL ("Производство
РФ") для данного документа больше недоступен;
Актуализированы параметры документа "Приемка" для товарной группы "Молочная
продукция"
22.01.2021 12.0 Для метода "Метод получения списка загруженных документов в ГИС МТ" в параметре
запроса не указывается массив для "pg" - запрос осуществляется по одной товарной группе;
На демонстрационном стенде для товарной группы "Молочная продукция" добавлен
параметр "vsd_number" ("Номер ВСД") в документ "Приемка" в формате * .json -
функциональность на текущий момент находится в тестировании;
Дополнено описание типа документа "Перемаркировка" в связи с реализацией
функциональности перемаркировки наборов;
Дополнено описание параметра "uit" ("Уникальный КИ") и актуализирован пример *.xml для
типов документов в разделе "Списание не нанесенных КИ с/без СИ" и "Списание нанесенных
КИ с СИ"
20.01.2021 11.7 Добавлены следующие разделы:
Метод загрузки титулов;
Метод загрузки квитанций с уведомлением об уточнении;
Метод загрузки квитанций с предложением об аннулирования;
Метод аннулирования документа;
Метод загрузки квитанций c предложением отклонения аннулирования.

18.01.2021 11.6 Изменена схема ответа для следующих методов формирования выгрузки данных:
"Метод получения статуса задания на выгрузку по ID выгрузки";
"Метод получения результирующих ID выгрузок данных";
"Пример ответа для всех формируемых запросов на выгрузку".
Для указанных методов сокращён состав возвращаемых параметров в ответе.
15.01.2021 11.5 Скорректирован URL в разделе "Метод подписания документа согласия или документа
аннулирования согласия";
Изменён тип приватности в разделе "Метод получения общедоступной информации о КИ по
списку" для товарных групп "Табачная продукция " и "Альтернативная табачная продукция";
Для типа документа "Перемаркировка" в формате CSV сохраняется использование причин
перемаркировки с названием, отличным от используемого в личном кабинете ГИС МТ при
создании документа: "Возврат товаров с поврежденным СИ/без СИ при розничной
реализации" (в ЛК ГИС МТ "Возврат от розничного покупателя" (RETAIL_RETURN)) и
Возврат товаров с поврежденным СИ/без СИ при дистанционном способе продажи (в ЛК ГИС
МТ "Возврат в случае дистанционной продажи" (REMOTE_SALE_RETURN)).
13.01.2021 11.4 Актуализирован пример тела документа "Декларация на товары";
Добавлен код "COMMISSION" ("Принят на комиссию от физического лица") в "Справочник
"Типы эмиссии КИ"";
Расширено описание параметра "uit" для типа документа "Ввод в оборот. Полученных от
физических лиц";
Добавлена рекомендация по заполнению документа "Ввод в оборот. Трансграничная
торговля".

14
 Версия
Дата документа Изменения
25.12.2020 11.3 Актуализирован пример документа "Отгрузка" в формате XML; Актуализирован тип
приватности в разделе "Метод проверки КИ ТГ "Табачная продукция" на вхождение в "Серую
зону"";
Уточнён пример запроса и исключён параметр "ID" из таблицы параметров запроса в методе
"Получение сведений по заключённым договорам между УОТ и ГИС МТ";
Расширен комментарий для параметра "ki" в документе "Трансформация АТК";
Актуализировано описание документа "Трансформация АТК";
Актуализированы значения параметра запроса "orderColumn" в разделе "Метод получения
списка загруженных документов в ГИС МТ";
Актуализированы формат параметра "certificate_document_date" в документе
"Перемаркировка".
18.12.2020 11.2 Изменена обязательность параметра "turnover_type" в документе "Приемка" и скорректировано
описание параметров в типах документов "Ввод в оборот. Производство РФ" и "Ввод в оборот.
Контрактное производство РФ";
Актуализирован "Метод отправки документа ЭДО на повторную обработку";
Тип документа "Ввод в оборот. Маркировка остатков" будет открыт для ТГ «Духи и туалетная
вода».

10.12.2020 11.1 Добавлен "Метод получения списка ИНН по идентификатору документа согласия";
Актуализирована таблица "Коды ошибок общих проверок для УД" в разделе "Метод
получения CSV ошибок по результатам обработки документов"; Изменение ФЛК документов
"Приемка" и "Отгрузка": значение "turnover_type" документа "Приемка" должно совпадать со
значением "turnover_type" документа "Отгрузка".
07.12.2020 11.0 Документ "Формирование наборов" доступен для товарной группы "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное";
Актуализирована обязательность параметров документа "Приемка"; Актуализирован пример
CSV типа документа "Ввод в оборот. Импорт с ФТС"; Добавлен "Метод отправки документа
ЭДО на повторную обработку";
Актуализирована таблица "Коды и текст ошибок для УД" в разделе "Метод получения CSV
ошибок по результатам обработки документов"
03.12.2020 10.0 Актуализировано описание типа документа "Перемаркировка"; Документ "Ввод в оборот.
Импорт с ФТС" и типы документов раздела "Операции с АТК" доступны для ТГ "Предметы
одежды, бельё постельное, столовое, туалетное и кухонное" c 01.12.2020. Актуализировано
описание раздела "Метод получения содержимого документа по идентификатору";
Добавлен тип документа "Декларация на товары", поступающий в ГИС МТ от ФТС России.
30.11.2020 9.4 Создание документа "Описание остатков" недоступно для ТГ "Табачная продукция" и ТГ
"Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки" с 01.12.2020;
Скорректировано описание типа документа "Ввод в оборот. Производство РФ";
Актуализирован "Метод получения квитанций результата обработки универсального
документа по идентификатору документа".
25.11.2020 9.3 Актуализирован "Метод получения списка КИ товаров (GTIN) УОТ по ИНН";
Актуализирован тип документа "Перемаркировка".
17.11.2020 9.1 Уточнен пример ответа и параметры ответа в разделе "Метод получения информации о товаре
по КИ товара";
Уточнено наименование раздела "Метод получения списка кодов товаров (GTIN) УОТ по
ИНН";
Уточнен пример тела документа в формате XML в разделе "Отгрузка";
Уточнено описание типа документа в разделе "Ввод в оборот. На территории стран ЕАЭС

15
 Версия
Дата документа Изменения
(контрактное производство)";
Удалён тип документа "Оприходование излишков": доступность подачи документа через API
ограничена и предоставляется отдельным УОТ по запросу.

06.11.2020 9.0 Актуализирован "Метод проверки регистрации УОТ по ИНН в системе ГИС МТ";
Добавлено примечание в раздел "Метод получения квитанций результата обработки
универсального документа по идентификатору документа";
Уточнён пример запроса в методе "Получение сведений по заключённым договорам между
УОТ и ГИС МТ";
Уточнён комментарий для параметра "guid" в методе "Получение сведений по заключённым
договорам между УОТ и ГИС МТ";
Добавлен пример запроса в раздел "Метод получения истории движения КИ ТГ "Табачная
продукция"";
Уточнён пример запроса в методе "Запрос списка агрегированных КИ (GET)";
Уточнено описание параметра "edo_operator_name" в разделе "Метод создания заявки на
регистрацию УОТ";
Актуализирован пример ответа в случае ошибки с кодом 404 в разделе "Метод получения
общедоступной информации о КИ по списку";
Актуализирован пример запроса, в таблицу параметров запроса добавлен параметр "pg" в
разделе"Метод получения статуса задания на выгрузку по ID выгрузки";
Удален параметр "filter" из таблицы параметров запроса в разделе "Метод получения
подробной информации о списке КИ товаров по заданному фильтру";
Уточнен комментарий для параметра "declaration_date" и "certificate_document_date" в разделе
"Ввод в оборот. Производство вне ЕАЭС"; Для предварительной интеграции УОТ добавлено
описание новой версии типа документа "Перемаркировка";
Для типов документов "Отгрузка" указана доступность создания документа в зависимости от
товарной группы;
Актуализированы форматы документа (JSON, CSV XML) для типа документа "Ввод в оборот.
Трансграничная торговля";
Для документов "Агрегирование (ТГ "Табачная продукция" и "Альтернативная табачная
продукция")" и "Выбытие (ТГ "Табачная продукция" и "Альтернативная табачная
продукция")" реализовано возвращение в ответе "id";

09.11.2020 8.3 Актуализировано описание метода"Получение сведений по кодам идентификации и

агрегатам";
Скорректировано примечание по подаче сведений в документе "Приемка";
Для предварительной интеграции УОТ добавлен тип документа "[Оприходование излишков]"
для ТГ "Табачная продукция" и "Альтернативная табачная продукция". См. также раздел
"Планируемые изменения в True API" и раздел "Оприходование излишков";
В документе "Возврат в оборот" изменена обязательность параметра "ki" (КИ/КИН);
02.11.2020 8.2 Изменена структура документа и наименования разделов;
Скорректирован комментарий к документу "Приемка";
Актуализирован раздел "Метод получения содержимого документа по идентификатору";
Уточнено указание КИН при подаче сведений в документах;
Удалён устаревший метод "Получения списка кодов идентификации" (/cises/my);
Актуализировано наименование системного поля, указываемого в методе формирования
выгрузок данных из ГИС МТ "Получение ошибок по результатам обработки документов";
Добавлен тип документа "[Оприходование излишков]" для ТГ "Табачная продукция" и
"Альтернативная табачная продукция".

16
 Версия
Дата документа Изменения
26.10.2020 8.1 Уточнён тип приватности для метода "Метод получения краткой общедоступной информации
о КИ по списку";
Для типа документа "Перемаркировка" скорректировано описание для параметров "last_uin" и
"new_uin";
В раздел "Список сокращений и условных обозначений" добавлены расшифровки аббревиатур
"КИГУ", "КИН", "КИК";
Для метода "Получение сведений по заключённым договорам между УОТ и ГИС МТ"
расширен состав параметров запроса;
Актуализирован пример запроса в разделе "Метод получения списка десятизначных кодов ТН
ВЭД";
Для метода "Ввод в оборот. Импорт с ФТС" обновлено описание параметра "cis";
Для метода "Метод получения краткой общедоступной информации о КИ по списку" уточнено
описание параметра запроса "values";
Изменена логика проверки указываемого формата значения КИТУ: увеличено количество и
изменён формат вводимых символов (см. "Список сокращений и условных обозначений")";
"Метод получения информации о товаре по КИ товара" также используется для ТГ "Табачная
продукция" и "Альтернативная табачная продукция";
Для документа Описание остатков при подаче товарными группами "Табачная продукция" и
"Альтернативная табачная продукция" уточнены адреса стендов при текущей реализации
функционала;
В справочнике и в документе "Формирование наборов" указано, что код идентификации
набора (КИН) указывается по аналогии с КИ (кодом идентификации);
Уточнено описание параметра "sntins" документа "Формирование наборов";
Метод "Запрос карточки продукта по одному уникальному идентификатору товара"
переименован в "Метод получения карточки товара по КИ";
Удалён устаревший URL: /cises/{code}/history "Метод получения истории движения КИ ТГ
"Табачная продукция"": в текущей реализации использовать URL: /cises/history.
Актуализировано описание метода;
Актуализировано описание метода: Получение информации о балансе денежных средств по
всем товарным группам;
Добавлен параметр "uuid" в параметры ответа методов: "Агрегирование (ТГ "Табачная
продукция" и "Альтернативная табачная продукция")" и "Выбытие (ТГ "Табачная продукция"
и "Альтернативная табачная продукция")";
Добавлено уточнение использованию АТК в документе "Формирование АТК";
Добавлены кодовые наименования типов документов "Агрегирование (ТГ "Табачная
продукция" и "Альтернативная табачная продукция")" и "Выбытие (ТГ "Табачная продукция"
и "Альтернативная табачная продукция")";
Указана доступность создания документов через "Единый метод создания документов" для
товарных групп;
Дополнено описания параметров "packs" и "cisPackageType";
Актуализированы примеры документов "Ввод в оборот. Контрактное производство РФ", "Ввод
в оборот. Трансграничная торговля", "Ввод в оборот. На территории стран ЕАЭС (контрактное
производство)", "Ввод в оборот. Производство РФ", "Ввод в оборот. Производство вне ЕАЭС"
В "Список сокращений и условных обозначений" добавлено уточнение по указанию КИН при
подаче сведений в документах
06.10.2020 8.0 Добавлен "Метод подписания документа согласия или документа аннулирования согласия";
Детализировано описание ответа в случае успеха для "Агрегирование (ТГ "Табачная
продукция" и "Альтернативная табачная продукция")" и "Выбытие (ТГ "Табачная продукция"
и "Альтернативная табачная продукция")";
Актуализирован раздел "Планируемые изменения в True API";
28.09.2020 7.0 Добавлен тип документа «Формирование наборов» для товарных групп «Предметы одежды,

17
 Версия
Дата документа Изменения
бельё постельное, столовое, туалетное и кухонное», «Духи и туалетная вода», «Фотокамеры
(кроме кинокамер), фотовспышки и лампы вспышки»;
В «Справочник "Типы документов"» добавлен тип документа «Формирование наборов»;
В «Справочник "Типы упаковки"» добавлен тип упаковки «Набор» (SET);
Актуализировано описание запроса и ответа в разделе «Метод получения общедоступной
информации о кодах идентификации по списку»;
Раздел "Нетабачные методы" переименован в "Методы создания документов" Реализована
возможность подачи документа Ввод в оборот. Импорт с ФТС, для товарных групп:
"Предметы одежды, белье постельное, столовое, туалетное и кухонное", "Духи и туалетная
вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки", "Шины и
покрышки пневматические резиновые новые";
Определены плановые даты отключения подачи документа Ввод в оборот. Производство вне
ЕАЭС для товарных групп "Предметы одежды, белье постельное, столовое, туалетное и
кухонное", "Духи и туалетная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-
вспышки", "Шины и покрышки пневматические резиновые новые";
Эндпоинт /api/v3/true-api/cises/{code}/history "Запрос цепочки движения кода идентификации"
является устаревшим, в дальнейшем рекомендуется использовать /api/v3/true-api/cises/history;
Для документа "Описание остатков" уточнено ограничение по созданию в зависимости от
товарной группы;
Метод "Запрос карточки продукта по одному уникальному идентификатору товара
/products/{cis} (метод устарел)" устаревший, удалён из документации.
14.09.2020 6.4 Дополнено описание параметров документа "Приемка";
Скорректирована XML схема для типа документа "Вывод из оборота";
Изменена структура справочника "Справочник "Статусы КИ";
Добавлены коды ошибок документа в раздел "Метод получения CSV ошибок по результатам
обработки документов";
Для параметра "document_type" типа документа "Вывод из оборота" изменено название
первичного документа "DESTRUCTION" на "DESTRUCTION_ACT";
Для метода "Запрос цепочки движения кода идентификации" расширен состав параметров
ответа;
Для метода "Ввод в оборот. Импорт с ФТС" изменилась логика проверки даты декларации;
В разделе "Метод получения содержимого документа" изменён пример запроса;
"Метод формирования согласия на предоставление сведений о кодах идентификации для
невладельцев", "Метод аннулирования документа на основании текущего опубликованного
документа согласия", "Метод получения информации о КИ по списку КИ при наличии
согласия" перенесены в раздел "Работа с согласием на предоставление сведений о своих КИ и
агрегатах другим участникам";
В методе "Создание заявки на регистрацию УОТ" изменено описание шагов по созданию
ключа;
В методе "Получение сведений по черновикам договоров между УОТ и ГИС МТ" удалена
обязательность для параметров: "edoStatus", "edoDocumentId", дополнено описание. Для
параметра "doctype" добавлена ссылка на Справочник "Типы договоров". Для параметра
"signtype" добавлено описание статусной модели.
Добавлен раздел "[Регистрация участников оборота товаров в ГИС МТ]";
В разделе "Метод получения общедоступной информации о кодах идентификации по списку"
скорректировано описание общедоступной информации. Для параметров "ownerInn" и
"ownerName" удалён комментарий;
Изменено наименование метода "Запрос карточки продукта по одному уникальному
идентификатору товара /products/{cis}" на "Запрос карточки продукта по одному уникальному
идентификатору товара /products/{cis} (метод устарел)";
Для метода "Метод получения подробной информации о кодах идентификации по списку"
добавлен новый параметр "cisChildren" и обновлен пример ответа;

18
 Версия
Дата документа Изменения
Для метода "Запрос карточки продукта по одному уникальному идентификатору товара
/products/info" обновлены параметры и пример ответа;
По тексту документа код маркировки заменен на код идентификации;
Для метода "Ввод в оборот. Производство вне ЕАЭС" уточнена предварительная дата
отключения для товарных групп;
"Ввод в оборот. Маркировка остатков" недоступен для ТГ «Обувные товары»;
Для метода "Ввод в оборот. Импорт с ФТС" изменено описание параметров "color" и
"productSize";
Для метода "Описание остатков" уточнена обязательность параметров в зависимости от
значения кода товарной номенклатуры;
Добавлен "Метод приема документа списания";
В разделе "Справочник "Типы упаковки"" уточнено использование типа упаковки "Комплект"
(BUNDLE) в зависимости от товарной группы;
Внесены дополнения в раздел "Метод подачи сведения по агрегированию";
Изменён пример ответа в разделе "Метод проверки КИ ТГ "Табачная продукция" на
вхождение в "Серую зону"";
"Метод получения квитанций результата обработки универсального документа по
идентификатору документа" перенесён в раздел "Данные о документах";
Добавлен раздел "Планируемые изменения в True API" с целью предварительного
уведомления об изменениях принципов работы существующих методов;
Изменены параметры запроса и ответа раздела "Метод получения списка загруженных чеков
ККТ в ГИС МТ";
Для метода "Запрос данных о списке кодов идентификации по cis (POST)" уточнено значение
количества, указываемых КИ в URL запроса;
Уточнены значения справочника "Актуальные статусы" для КИ;
Для типа документа "Описание остатков" расширен состав параметров для ТГ "Табачная
продукция" и "Альтернативная табачная продукция";
Для документа "Ввод в оборот. Импорт с ФТС" скорректировано описание для параметра
запроса "cis".
30.07.2020 6.3 Добавлены методы:
"Методы формирования выгрузок данных из ГИС МТ".
Для метода "Запрос данных о списке кодов идентификации по cis (POST)" описаны параметры
ответов.
Удалены разделы "Перечень возможных параметров ответов методов получения данных о
кодах идентификации" и "Перечень возможных параметров ответов методов получения списка
контрагентов УОТ".
Для методов "Получение состава агрегата" и "Метод получения общедоступной информации о
кодах идентификации по списку" удалены ТГ "Табачная продукция" и "Альтернативная
табачная продукция" из обязательных товарных групп в запросе.
Добавлены примечания по логике работы методов Ввод в оборот. Производство вне ЕАЭС и
Ввод в оборот. Импорт с ФТС.
ТГ "Питьевая вода" переименована в "Упакованная вода".
Для метода "Ввод в оборот. Импорт с ФТС" в JSON обновлено описание параметра cis
(Указывается КИ или КИТУ или АТК).
Для метода "Метод получения статуса фида по ID фида от его заказчика" добавлен параметр
apikey заказчика (supplier_key).
Для метода "Ввод в оборот. На территории стран ЕАЭС (контрактное производство)" удалены
параметры "Сумма НДС" и "Цена за единицу".
Для метода "Метод проверки КИ ТГ "Табачная продукция" на вхождение в "Серую зону""
обновлено описание для параметров ответа:
• inGrayZone – фактическая принадлежность кода к серой зоне, заполняется только для

19
 Версия
Дата документа Изменения
пачек/блоков;
• containsGrayCodes – наличие расчетных серых кодов в составе агрегата;
• gzPacks – количество расчетных серых пачек в составе агрегат;
• gzBlocks – количество расчетных серых блоков в составе агрегата
В методе "Метод получения списка товаров по заданному фильтру" изменены значения для
параметра "Дополнительный статус товара" (statusExt).
Для метода "Формирование АТК" добавлено ограничения для параметра КИ (ki) "Указывается
только номера КИ. Указание в данном поле номера КИТУ или КИ, уже входящих в КИТУ или
другой АТК, не допускается".
Удален параметр "Атрибуты ответа" (documentDataDTO).
Изменены возможные принимаемые значения для параметра "Причина вывода из оборота"
(withdrawReason).
Для метода "Запрос цепочки движения кода идентификации" добавлен параметр "Номер
документа смены статуса" (docId).
Для метода "Метод получения списка товаров по заданному фильтру" в параметрах запроса
для параметра "Статус товара/КИ" (cisStatus) удалены значения: "Эмитирован. Выпущен"
(EMITTED); "Эмитирован. Получен" (APPLIED); "В обороте" (INTRODUCED); "Выбыл"
(RETIRED); "КИ списан" (WRITTEN_OFF); "Расформирован" (DISAGGREGATION).
Для метода "Метод получения содержимого документа" в запрос добавлен необязательный
параметр "Товарная группа" (pg).
Для метода "Метод проверки КИ ТГ "Табачная продукция" на вхождение в "Серую зону""
добавлено описание параметров "gzPacks" и "gzBlock".
В методе "Метод получения общедоступной информации о кодах идентификации по списку"
из тела запроса удален параметр "codes", в запросе передается массив кодов идентификации.
Для метода "Ввод в оборот. Полученных от физических лиц" изменен JSON, удален параметр
"Тип документа".
Изменено наименование метода "Метод получения ZIP-архива документа с подписью и
квитанциями" на "Метод получения ZIP-архива документа ЭДО с подписями и квитанциями
из ЭДО Lite"
22.07.2020 6.2 Добавлен метод "Метод получения квитанций результата обработки универсального
документа по идентификатору документа"
06.07.2020 6.1 Добавлен метод:
"Метод проверки КИ ТГ "Табачная продукция" на вхождение в "Серую зону"".
Для методов "Запрос карточки продукта по одному уникальному идентификатору товара
/products/info" и "Запрос карточки продукта по одному уникальному идентификатору товара
/products/{cis}".
Обновлены параметры ответов для МОТП.
Для типа документа Ввод в оборот. Производство вне ЕАЭС изменено описание, для каких ТГ
метод является устаревшим.
Для методов "Получение состава агрегата" изменено описание, ответ возвращает только
первый слой.
Для статуса КИ удален ошибочный параметр "WAIT_FOR_CONTINUATION".
Для типа документа "Ввод в оборот. На территории стран ЕАЭС (контрактное производство)"
добавлено описание, что только для ТГ "Молочная продукция".
Для типа документа "Приемка" добавлено обязательное поле "Номер отгрузки";
Для параметра статус добавлен параметр "WITHDRAWN – выбыл, только для ТГ "Табачная
продукция"".
23.06.2020 6.0 Изменено описание для параметров "childrenPage" и "childrenLimit".

20
 Версия
Дата документа Изменения
Удалены атрибуты 2502 и 2503 для методов НК.
Для методов "Запрос списка агрегированных кодов идентификации по списку родительских
кодов идентификации (GET)" и "Запрос списка агрегированных кодов идентификации по
списку родительских кодов идентификации (POST)" изменена приватность на публичную.
Изменено создание документа "Приемка".
Добавлены методы:

- "Ввод в оборот. Импорт с ФТС";

- "Формирование АТК";
- "Расформирование АТК";
- "Трансформация АТК";
- "Запрос карточки продукта по одному уникальному идентификатору товара /products/info";
- "Отмена отгрузки при трансграничной торговле";
- "Метод подачи сведения по агрегированию".
Для типа документа "Перемаркировка" добавлена возможность возврата товаров с
поврежденным СИ/без СИ при розничном и дистанционном способе продажи.
Добавлены ограничения по товарным группам и удален параметр тип товарооборота для
метода "Отгрузка при трансграничной торговле".
Добавлены ограничения по товарным группам для метода "Ввод в оборот. Трансграничная
торговля".
Для параметра "status" добавлено значение "Списан" (WRITTEN_OFF).
Параметр "Максимальное количество записей" (limit) для общих методов не может
использоваться без указания товарной группы.
Обновлен справочник "Справочник "Типы документов"".
Метод "Запрос данных о списке кодов идентификации по cis (POST)" перенесен в общие
методы.
Документ "Вывод товара из оборота при реализации конечному потребителю" переименован в
"Вывод из оборота".
Метод "Запрос карточки продукта по одному уникальному идентификатору товара
/products/{cis}" считать устаревшим, используется метод "Запрос карточки продукта по
одному уникальному идентификатору товара /products/info".
Изменено описание для параметров "childrenPage" и "childrenLimit".
Добавлено описание для параметра "orderedColumnValue".
Для методов "Запрос карточки продукта по одному уникальному идентификатору товара
/products/info" и "Запрос карточки продукта по одному уникальному идентификатору товара
/products/{cis}" обновлены параметры ответов для МОТП.
Для метода "Метод получения подробной информации о кодах идентификации по списку"
добавлены параметры дял ТГ "Молочная продукция" agentName и expireDate.
Для методов "Запрос списка агрегированных кодов идентификации по списку родительских
кодов идентификации (POST)" и "Запрос списка агрегированных кодов идентификации по
списку родительских кодов идентификации (GET)" в запрос добавлен параметр "Товарная
группа" Для общих методов параметру "Товарная группа" добавлены товарные группы
"Табачная продукция" и "Альтернативная табачная продукция".
Для параметра "orderColumn" допустимое значение заменено с "docDate" на "receivedAt".
Метод "Ввод в оборот. Производство вне ЕАЭС" считать устаревшим, будет поддерживаться в
течении трёх месяцев.
Вместо устаревшего "Ввод в оборот. Производство вне ЕАЭС" работает метод "Ввод в оборот.
Импорт с ФТС".
В методе "Ввод в оборот. Импорт с ФТС" поля цвет (color) и размер (productSize) изменены на
необязательные.
Обновлен "Список сокращений и аббревиатур, используемых в документации"

21
 Версия
Дата документа Изменения
05.06.2020 5.1 Наименование метода изменено: "Получение содержимого документа" на "Метод получения
содержимого документа".
Обновлен метод "Метод получения содержимого документа" добавлены параметры.
Изменены параметры ответа для метода "Запрос информации об участнике оборота товаров по
ИНН".
Изменены параметры ответа для метода "Метод получения списка загруженных документов в
ГИС МТ".
Обновлены все методы в разделе "Методы Национального каталога".
Обновлены ендпоинты во всех методах, удалена часть api/v3/true-api. Ссылка содержится в url
стенда.
Добавлен параметр ответа "response" для метода "Метод получения счёта на оплату".
Удален параметр "owner_name" для метода "Метод получения информации о КИ по списку КИ
при наличии согласия".
Обновлен json и обязательность параметров для метода создания документа "Вывод товара из
оборота при реализации конечному потребителю".
Добавлены параметры запроса "childrenLimit" и "childrenPage" для методов:
"Метод получения списка товаров по заданному фильтру";
"Запрос списка агрегированных кодов идентификации по списку родительских кодов
идентификации (GET)";
"Запрос списка агрегированных кодов идентификации по списку родительских кодов
идентификации (POST)";
"Запрос карточки продукта по одному уникальному идентификатору товара".
Обновил описание параметров ответов для метода "Запрос карточки продукта по одному
уникальному идентификатору товара".
Обновлены параметры ответа для метода "Метод получения информации о товаре по Коду
товара".
Добавлены параметры для массива "childs" метода "Метод получения информации о КИ по
списку КИ при наличии согласия".
"Запрос информации о чеке по его идентификатору" перемещен в раздел "Общие методы для
табачной и нетабачной товарной группы".
Переименован метод "Получение подробной информации о кодах идентификации по списку" в
"Метод получения общедоступной информации о кодах идентификации по списку"
26.05.2020 5.0 Добавлены методы: "Отгрузка при трансграничной торговле"
"Метод получения списка загруженных документов в ГИС МТ";
"Метод получения списка загруженных чеков в ГИС МТ";
"Метод формирования согласия на предоставление сведений о кодах идентификации для
невладельцев";
"Метод аннулирования документа на основании текущего опубликованного документа
согласия";
"Метод получения информации о КИ по списку КИ при наличии согласия";
"Запрос информации об участнике оборота товаров по ИНН" В "Общие положения" добавлено
примечание "ВНИМАНИЕ: При выводе данных о нерезидентах, вместо ИНН будет
возвращаться его аналог в стране ЕАЭС."
Добавлен параметр name для типа документа "Трансформация".
Для типа документа "Перемаркировка" добавлено ограничение для ТГ.
Изменены параметры запроса для "Метода получения списка товаров по заданному фильтру"
(products/listV2).
Для "Перечня возможных параметров ответов методов получения данных о кодах
идентификации" добавлены параметры prVetDocument, maxRetailPrice и brand.
Добавлен параметр запроса pg и описание ошибок в ответе для метода "Получение подробной
информации о кодах идентификации по списку" (cises/info).
Удалён параметр error_message для метода "Получение товарных групп по кодам товаров".

22
 Версия
Дата документа Изменения
Метод "Запрос информации об участнике оборота товаров по ИНН" перенесен в общие
методы.
Для метода "Создание заявки на регистрацию УОТ" для параметра code изменен тип с number
на string и описание.
Изменены параметры ответа для метода "Проверка статуса заявки на регистрацию УОТ по ID
заявки" (status/{documentId} ).
Изменен метод "Подписание договоров".
Для "Метода получения счёта на оплату" в запрос добавлен обязательный параметр
"contractId" и добавлено описание для параметра "amount".
Заменены gtin на код товара в описаниях.
В Справочник "Типы документов" добавлены универсальные документы.
В Справочник "Статусы ответов" добавлен код ошибки 504.
Для параметра childrenMap удалена рекурсия.
Для методов с описанием трансграничной торговли добавлено описание "Метод доступен
только операторам ЕАЭС." Добавлен комментарий "Табачные коды по блокам можно
указывать в запросах как со скобками, так и без. В ответе код всегда будет со скобками" для
следующих методов: "Получение подробной информации о кодах идентификации по списку";
"Запрос списка агрегированных кодов идентификации по списку родительских кодов
идентификации (GET)";
"Запрос списка агрегированных кодов идентификации по списку родительских кодов
идентификации (POST)";
"Запрос данных о списке кодов идентификации по cis (POST)"
06.11.2019 1.0 Начальная версия

23
1. Назначение и условия применения True API
1.1. Электронное взаимодействие УОТ и Оператора ГИС МТ
Взаимодействие участников оборота товара (далее – УОТ) и Оператора Государственной
информационной системы мониторинга за оборотом товаров (далее – ГИС МТ) осуществляется в
электронном виде. Обмен документами на бумажном носителе не предусмотрен.
Электронное взаимодействие осуществляется по одному из двух вариантов:
1. Предоставление сведений, т.е. обмен электронными документами, на основании которых могут
вноситься изменения в реестры ГИС МТ. Предоставление сведений является обязательством
УОТ.
2. Запрос сведений, т.е. обмен, при котором сведения из реестров ГИС МТ предоставляются
участникам в соответствии с установленными разрешениями на получение сведений. При этом
изменения в реестры не вносятся. Запрос и последующее представление сведений из ГИС МТ
инициируется участником по своему усмотрению и применяется, например, для проверки
статусов КИ или статуса регистрации участника.
Электронное взаимодействие осуществляется путем обмена электронными документами в
соответствии с определенным порядком. Для юридически значимых электронных документов
применяется усиленная квалифицированная электронная подпись (УКЭП).Электронное
взаимодействие осуществляется с применением программных интерфейсов взаимодействия (API)
ГИС МТ и информационных систем участников.
При взаимодействии через API выполняются следующие требования:
1. Аутентификация и авторизация участника (определение полномочий на осуществление
электронного взаимодействия) осуществляется при помощи УКЭП.
2. При предоставлении и запросе сведений защита передаваемых данных выполняется TLS/HTTPS
(ГОСТ 28147-89) шифрованием канала передачи данных в адрес Оператора
сертифицированными РФ СКЗИ (ГОСТ Р 34.10-2012).
Информация о стендах:
URL (демонстрационный стенд): https://int01.gismt.crpt.tech/api/v3/true-api
URL (промышленный стенд доступен по двум адресам): https://ismotp.crptech.ru/api/v3/true-api (ТГ
"Табачная продукция" и "Альтернативная табачная продукция"); https://markirovka.crpt.ru/api/v3/true-
api
При указании запросов обратить внимание на следующее:
• в некоторых запросах рекомендуется указывать товарную группу (см. "Справочник "Список
поддерживаемых товарных групп"");
• новые методы могут быть реализованы с указанием версии, которая отличается от "v3" (версии
3), первоначально указываемой в документации API. В таком случае в URL стендов необходимо

24
 произвести замену версии на новую. Старая версия поддерживается в течение полугода для
сохранения обратной совместимости.
Информация об ошибках при запросах API методов имеет следующий формат:
(подробнее: см. Справочник "Статусы ответов")
Status code: 400
{
"error_message": "<текст сообщения об ошибке>"
}

Status code: 401

информация об ошибке возвращается в формате xml
Методы Национального каталога возвращают сообщения об ошибках, которые могут быть как в xml,
так и в json форматах в зависимости от выбранного формата запроса
Информация о вложенности параметров
Вложенные параметры помечены "*".
Пример вложенности:

Параметр Описание
results:
agentInn
*children:
**brand

Читать как: параметр "results" содержит параметры "agentInn" и "children", а "children" содержит
параметр "brand".
Информация о кодах стран:
Коды стран представлены в соответствии с ISO 3166.
ВНИМАНИЕ: при выводе данных о нерезидентах, вместо ИНН будет возвращаться его аналог в
стране ЕАЭС.

1.2. Требования к файлам обмена

Файл обмена должен подписываться УКЭП лица, имеющего право действовать от имени УОТ, и
соответствовать следующим требованиям:
1. Файл формата JSON:
– для обмена с ГИС МТ используется json стандарта RFC 7159
(https://tools.ietf.org/html/rfc7159);

25
 – использует кодировку UTF-8;
– в результирующем JSON также может содержаться набор полей, специфичных для
конкретного товара.
2. Файл обмена формата CSV:
– соответствует стандарту RFC 4180;
– использует кодировку UTF-8
– содержит символ "," в контенте файла в качестве разделителя.
3. Файл обмена формата XML:
– xml формат описан в xsd схемах. Актуальные xsd схемы можно найти в разделе
«Помощь» в Личном кабинете ГИС МТ;
– содержит единственный экземпляр электронного документа;
– использует кодировку UTF-8;
– содержит первую строку вида <?xml version="1.0" encoding="utf-8"?>;
– определяет стандартные типы данных в соответствии со стандартом ISO (см. описание
стандарта ISO https://www.w3schools.com/xml/schema_dtypes_date.asp);
– проверяется на корректность на основании XSD-схемы - логической модели для обмена
информацией, описывающей логические элементы и атрибуты XML-файлов.
ВНИМАНИЕ: В примерах сurl запросы выполнены и проверены на UNIX системах, в других
операционных системах, экранирование отдельных символов может отличаться
Максимальный размер документа, передаваемого по API, не должен превышать 30 мегабайт.
Все значения атрибутов в форматах json и csv, выражаемые в деньгах (цены, налоги, и т.п), задаются
в копейках без разделителей.

1.3. Экранирование
Экранирование - замена в тексте управляющих символов на соответствующие текстовые
подстановки. Экранирование используется для отделения текста от кода и управляющих символов.
Экранирование применяется при передаче параметров запросов API методов согласно следующим
стандартам:
• при передаче параметров в едином указателе ресурса (Uniform Resource Locator, URL), т.е. в URL
запроса, должно применяться экранирование согласно стандарту RFC 3986 (см. описание
стандарта в п. 2.1 https://www.protocols.ru/WP/rfc3986/);
• при передаче параметров в JSON-строке тела запроса URL должно применяться экранирование
согласно стандарту RFC 8259 (см. описание стандарта в п. 7
https://www.protocols.ru/WP/rfc8259/);

26
• при загрузке сведения в ГИС МТ посредством файла формата CSV с использованием в
загружаемом файле КИ со специальными символами необходимо всю строку КИ экранировать
двойными кавычками (");
• при передаче параметров в XML-строке тела запроса URL должно применяться экранирование
согласно стандарту W3C (см. описание стандарта в https://www.w3.org/TR/xml/).
Пример:
• экранирование для JSON по стандарту RFC 8259:
0104650117240408211dmfcZNcM"4=>
0104650117240408211dmfcZNcM\"4

• экранирование для URL по стандарту RFC 3986:

:../cises/aggregated/list?codes=0104650117240408211dmfcZNcM"4 =>
./cises/aggregated/list?codes=0104650117240408211dmfcZNcM%224

• экранирование для CSV по стандарту RFC 4180:

"010481097886269421""LLRY<%"JZTVZ"

• экранирование для XML по стандарту W3C:

<cis>0104650117240408211dmfcZNcM<4</cis>
<cis>0104650117240408211dmfcZNcM&lt;4</cis>

1.4. Тип возвращаемого методами API контента

Методы True API преимущественно возвращают ответы в формате JSON, т.е. MIME-type
application/json. Некоторые методы в корректном ответе возвращают двоичное содержимое
(например, документы в ZIP) MIME-type application/zip или application/octet-stream, а в случае ошибки
- описание этой самой ошибки в JSON. Таким образом, один и тот же метод в зависимости от
ситуации может вернуть разные типы содержимого (контента).
Для корректной работы методов True API параметр Accept заголовка запроса должен быть установлен
так, чтобы учитывались все возможные ответы сервера, т.е. и application/zip, и application/json. Самый
простой вариант - использовать универсальный шаблон:
Accept: /
Для ограничения набора возвращаемых типов контента можно указывать несколько заголовков
запроса методов True API:
Accept: application/octet-stream
Accept: application/json
Если в перечне заголовков запроса методов True API не окажется ни одного подходящего под
сгенерированный сервером ответ, то True API вернется ответ c кодом = 406 (Not Acceptable) с пустым
телом ответа.

27
1.5. Единая аутентификация
Для работы с интерфейсом True API необходимо зарегистрироваться в ЛК ГИС:
https://markirovka.crpt.ru/ - необходимо иметь ЛК с подключенной товарной группой, по которой
планируется передача сведений по КИ.
После успешной аутентификации пользователь сможет работать с методами API и оперировать
данными исключительно в рамках зарегистрированной им в ГИС МТ товарной группы.

1.5.1. Запрос авторизации при единой аутентификации

Метод используется для получения аутентификационного токена по УКЭП:
1. получение пары "uuid - data", где "uuid" - идентификатор текущей аутентификации, data - строка
на подпись пользователю;
2. отправка в ГИС МТ данных в том же виде, в котором данные были получены (пара "uuid - data"),
только теперь "data" - это подписанная УКЭП строка;
3. сервер отвечает на запрос сообщением с кодом 200 (ОК) и возвращает токен, либо сообщением
об ошибке.
URL: /auth/key
Метод: GET
Пример строки запроса:
<url стенда>/auth/key

Параметры ответа:

Параметр Тип Обяз. Описание

uuid string + Уникальный идентификатор сгенерированных случайных данных
data string + Случайная строка данных

Пример ответа:
{
"uuid":"a63ff582-b723-4da7-958b-453da27a6c62",
"data":"GNUFBAZBMPIUUMLXNMIOGSHTGFXZMT"
}

1.5.2. Получение ключа сессии при единой аутентификации

URL: /auth/simpleSignIn
Метод: POST
Content-Type: application/json

28
Пример запроса:
POST <url стенда>/auth/simpleSignIn
Content-Type: application/json; charset=utf-8
cache-control: no-cache

{
"uuid":"string",
"data":"string"
}

Параметры тела запроса:

Параметр Тип Обяз. Описание

uuid string + Уникальный идентификатор подписанных случайных данных
data string + Подписанные УКЭП зарегистрированного УОТ случайные данные в base64 (присоединённая
ЭП)

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

token string - Аутентификационный токен Параметр указывается в случае успешного ответа
code string - Код ошибки Параметр указывается в случае не успешного ответа
error_message string - Сообщение об ошибке
description string - Описание ошибки

"token" - токен аутентиикации, полученный в результате работы метода получения токена

аутентификации. Срок действия полученного токена не более 10 часов с момента получения.
Пример ответа:
1.В случае успеха:
{
"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e.........mk6qe0lB12w9zEs"
}

2 В случае ошибки:
2.1 Код 401:
{
"error_message":"В запросе отсутствует идентификатор авторизации (UUID)"
}

2.2. Код 400 При некорректной структуре в теле запроса:

{
"error_message":"В запросе отсутствует идентификатор авторизации (UUID)"
}

29
1.6. Типы приватности методов True API в зависимости от аутентификационного
токена
Существуют следующие типы приватности методов в зависимости от используемого
аутентификационного токена:
1. Приватный - только для владельца КИ либо для автора запроса;
2. Производитель продукции;
3. Покупатель продукции (оптовик, розница);
4. Оператор;
5. ФОИВ;
6. Администратор;
7. Публичный - для всех пользователей с токеном;
8. Без токена - для всех пользователей без токена.
Для методов с типами приватности №1-7 обязательно наличие аутентификационного токена (см.
Единая аутентификация и [Примеры аутентификации по УКЭП / Подписание документов]).

30
2. Рекомендации по работе с методами True API
При использовании приватных методов True API (см. "[Методы]") обязательно наличие
аутентификационного токена (см. Единая аутентификация и "[Примеры аутентификации по УКЭП /
Подписание документов]").

2.1. Процесс регистрации УОТ

2.1.1. Шаг 1: вызов метода создания заявки на регистрацию УОТ

URL: /elk/registration
Метод: POST
Подробное описание метода см. в разделе "Метод создания заявки на регистрацию УОТ".

2.1.2. Шаг 2: проверка статуса заявки на регистрацию по ID заявки

URL: /elk/documents/status/{documentId}
Метод: GET
Подробное описание метода см. в разделе "Метод проверки статуса заявки УОТ на регистрацию по
ID заявки".

2.1.3. Шаг 3: получение сведений по черновикам договоров между УОТ и ГИС МТ

URL: /elk/crm-api/documents
Метод: GET
Подробное описание метода см. в разделе "Получение сведений по черновикам заключённых
договоров между УОТ и Оператором ГИС МТ". После обработки заявки на регистрацию для начала
работы с товарными группами, указанными в заявке на регистрацию, УОТ должен подписать
соответствующие договора. Если запрос успешно обработан, в ответ вернётся структура JSON,
содержащая перечень данных по договорам, которые УОТ должен подписать. Все договора, которые
УОТ заключает с ГИС МТ в рамках маркировки товаров, являются исходящими от УОТ и должны
быть подписаны.

2.1.4. Шаг 4: получение (выгрузка) черновиков договоров для подписания УОТ

URL: /elk/crm-api/document?guid={id}
Метод: GET
Подробное описание метода см. в разделе "Получение сведений по заключённым договорам между
УОТ и ГИС МТ".
Наименование для файла договора необходимо брать из поля "Content-Disposition" после
"filename="UTF-8"" заголовка ответа метода. Имя файла необходимо декодировать.

31
Пример:
Content-Disposition: attachment; filename=" _00691_20.pdf"; filename*=UTF-
8''%D0%9C%D0%9F_00691_20.pdf
%D0%9C%D0%9F_00691_20.pdf -> МП_00691_20.pdf

После выгрузки и сохранения договора необходимо перейти к шагу 5.

2.1.5. Шаг 5: подписание договоров

URL: /elk/outgoing-documents/{id}/signature
Метод: POST
Подробное описание метода см. в разделе "Подписание договоров".
УОТ должен подписать загруженный договор УКЭП. Шаги 4 и 5 необходимо повторить для всех
договоров, информация о которых возвращается на шаге 3. В случае обработки договоров со стороны
Оператора, которые были подписаны УОТ, при вызове метода на шаге 3, в поле "status" у договоров
будет возвращаться код "2" ("Оформлен\Подписан"). Статусы документов в системе ЭДО,
соответственно, будут следующими:
• "2 – Доставлен (подпись не требуется)" для документов, у которых "signtype" – 2;
• "4 – Подписан" для документов, у которых "signtype" – 1.

2.1.6. Шаг 6: выгрузка подписанных договоров

URL: /elk/outgoing-documents/{edoDocumentId}
Метод: GET
Подробное описание метода см. в разделе "Метод получения ZIP-архива документа ЭДО с подписями
и квитанциями из ЭДО Lite".
Данный метод используется при необходимости получения ZIP архива подписанных входящих либо
исходящих документов ЭДО и подписанными квитанциями обмена. После регистрации УОТ
использует API СУЗ для создания заказа на эмиссию кодов маркировки (далее - КМ).

2.2. Агрегация и ввод товаров в оборот

Агрегирование представляет собой объединение в транспортную упаковку товаров первого уровня
либо транспортных упаковок первого уровня в транспортную упаковку последующего уровня с
сохранением информации о взаимосвязи КИ каждого вложенного товара, потребительской или
транспортной упаковки товаров с КИ создаваемой транспортной упаковки и нанесением
соответствующего КИТУ на создаваемую в результате объединения транспортную упаковку для
обеспечения прослеживаемости движения товаров по товаропроводящей цепи без необходимости
вскрытия создаваемой транспортной упаковки.

32
2.2.1. Шаг 1: получение информации о статусе КИ
Для получения информации о статусе КИ используется "Метод получения общедоступной
информации о КИ по списку" (/cises/info).
Агрегация осуществляется до или после ввода товара в оборот, при этом КИ должны быть в статусе
"APPLIED" или "INTRODUCED" (См. Справочник "Статусы КИ").

2.2.2. Шаг 2: агрегация товаров с использованием "Единого метода создания документов"

Тип документа «Агрегация» используется для подачи сведений в ГИС МТ при агрегации готовых
товаров. Для подачи сведений необходимо тело документа в формате * .json заполнить значениями
параметров в соответствии с описанием в таблице (см. "Единый метод создания документов").
Параметр «product_document» должен быть заполнен телом документа «Агрегация» со всеми
указанными параметрами, закодированным в base64. Далее тело незакодированного документа в
формате * .json требуется подписать откреплённой УКЭП в кодировке base64 и заполнить
полученным значением параметр «signature». В случае успеха в ответе возвращается уникальный
идентификатор документа. В случае успеха в ответе возвращается уникальный идентификатор
документа.

2.2.3. Шаг 3: проверка формирования документа об агрегации

Для проверки информации о сформированном документе "Агрегация" используется "Метод
получения содержимого документа по идентификатору" (/documents/{document_id}/info).

2.2.4. Шаг 4: проверка значения КИ агрегата

"Метод получения общедоступной информации о КИ по списку" (/cises/info) возвращает информацию
о КИ агрегата и вложений с выводом в ответе дополнительных параметров.
Метод "Запрос списка агрегированных КИ (GET)" (/cises/aggregated/list) возвращает информацию о
вложенных КИ без вывода в ответе дополнительных параметров. Если в ответе в значении параметра
"parent" указан идентификатор созданного агрегата, то агрегат успешно сформирован. КИ агрегата
возвращается в ответе в том случае, если верхнеуровневый агрегат не расформирован. Для КИ
агрегата, указанного в параметре "child", возвращается массив вложенных КИ.

2.2.5. Ввод в оборот

Тип документа "Ввод в оборот" используется для подачи сведений в ГИС МТ при вводе в оборот
готовых товаров. Для подачи сведений необходимо тело документа в формате JSON "Единого метода
создания документов" заполнить значениями параметров в соответствии с описанием в таблице (см.
"Единый метод создания документов"). Параметр "product_document" должен быть телом документа
"Ввод в оборот" со всеми указанными параметрами, закодированным в Base64. Далее тело
незакодированного документа в формате JSON требуется подписать открепленной УКЭП в кодировке
Base64 и заполнить полученным значением параметр "signature". Сформированную УКЭП
необходимо открыть в любом доступном текстовом редакторе и удалить символы переноса строк.
В случае успеха в ответе приходит уникальный идентификатор документа.

33
Выбор способа ввода в оборот осуществляется по типу эмиссии КИ (см."Ввод в оборот"). Например:
если тип эмиссии КИ = LOCAL (производство в РФ), то подача сведений в ГИС МТ осуществляется с
использованием типа документа "Ввод в оборот. Производство РФ", "Ввод в оборот. Полученных от
физических лиц" или "Ввод в оборот. Контрактное производство РФ".
Для участников оборота товаров, использующих контрактное производство за пределами РФ,
параметр «product_document» «Единого метода создания документов» заполняется телом документа
"Ввод в оборот. Импорт с ФТС" или "Ввод в оборот. На территории стран ЕАЭС (контрактное
производство)" в зависимости от товарной группы.
Для участников оборота товарной группы «Молочная продукция», использующих контрактное
производство, доступны только типы документов "Ввод в оборот. Трансграничная торговля" и "Ввод
в оборот. На территории стран ЕАЭС (контрактное производство)".

2.3. Отгрузка и приёмка товара

2.3.1. Подача сведений в документе "Отгрузка"

Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания
документов" заполнить значениями параметров в соответствии с описанием в таблице (см. "Единый
метод создания документов"). Параметр "product_document" должен быть телом документа
"Отгрузка" со всеми указанными параметрами, закодированным в Base64. Далее тело
незакодированного документа в формате JSON требуется подписать открепленной УКЭП в кодировке
Base64 и заполнить полученным значением параметр "signature". Сформированную УКЭП
необходимо открыть в любом доступном текстовом редакторе и удалить символы переноса строк.
В случае успеха в ответе приходит уникальный идентификатор документа.
При наличии в документе "Отгрузка" 10000 КИ и более, рекомендуется использовать "Метод поиска
содержимого документа по идентификатору документа" и, после получения содержимого документа,
использовать "Метод получения общедоступной информации о КИ по списку".

2.3.2. Приёмка товара

2.3.2.1. Шаг 1: получение сведений о новых документах, загруженных в ГИС МТ
Для получения сведений о новых документах типа "Приемка" используется "Метод получения списка
загруженных документов в ГИС МТ".
Параметр "inputFormat" для УОТ, осуществляющего приёмку, принимает значение "true" -
"входящий". Параметр "documentType" может принимать значения LP_SHIP_GOODS,
LP_SHIP_GOODS_CSV, LP_SHIP_GOODS_XML (см."Справочник "Типы документов"" и тип
документа "Отгрузка"). Так как документ на отгрузку может быть подан в любом из перечисленных
форматов, рекомендуется выполнять запрос поочередно с каждым из перечисленных значений. В
ответе на запрос сведений о документе "Приёмка" выводится параметр "doc_Id" (идентификатор
документа).

34
2.3.2.2. Шаг 2: получение сведений о содержимом документа по идентификатору
Для получения информации о содержимом агрегатов в документе "Приемка" используется "Метод
получения содержимого документа по идентификатору", параметром запроса в котором является
идентификатор документа, полученный в шаге 1. При наличии в документе "Приемка" 10000 КИ и
более, рекомендуется использовать "Метод поиска содержимого документа по идентификатору
документа".
2.3.2.3. Шаг 3: подача сведений о приёмке
Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания
документов" заполнить значениями параметров в соответствии с описанием в таблице (см. "Единый
метод создания документов"). Параметр "product_document" должен быть телом документа "Приемка"
со всеми указанными параметрами, закодированным в Base64. Далее тело незакодированного
документа в формате JSON требуется подписать открепленной УКЭП в кодировке Base64 и
заполнить полученным значением параметр "signature". Сформированную УКЭП необходимо
открыть в любом доступном текстовом редакторе и удалить символы переноса строк.
В случае успеха в ответе приходит уникальный идентификатор документа.
2.3.2.4. Шаг 4: просмотр статуса отправленного документа "Приемка"
Уникальный идентификатор документа, полученный на этапе "Шаг 3: подача сведений о приёмке",
указывается в запросе "Метод получения содержимого документа по идентификатору" для получения
информации о статусе документа "Приемка", поданного в ГИС МТ. В случае успеха параметр "status"
в ответе примет значение "CHECKED_OK".

2.4. Вывод товара из оборота

Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания
документов" заполнить значениями параметров в соответствии с описанием в таблице (см. "Единый
метод создания документов"). Параметр "product_document" должен быть телом документа "Вывод из
оборота" со всеми указанными параметрами, закодированным в Base64. Далее тело
незакодированного документа в формате JSON требуется подписать открепленной УКЭП в кодировке
Base64 и заполнить полученным значением параметр "signature". Сформированную УКЭП
необходимо открыть в любом доступном текстовом редакторе и удалить символы переноса строк.
В случае успеха в ответе приходит уникальный идентификатор документа.
После вывода из оборота товара статус КИ меняет тип на RETIRED (Выведен из оборота) или
WRITTEN_OFF ("Списан") (см."Справочник "Статусы КИ"").

2.5. Возврат в оборот

Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания
документов" заполнить значениями параметров в соответствии с описанием в таблице (см. "Единый
метод создания документов"). Параметр "product_document" должен быть телом документа "Возврат в
оборот" со всеми указанными параметрами, закодированным в Base64. Далее тело незакодированного
документа в формате JSON требуется подписать открепленной УКЭП в кодировке Base64 и

35
заполнить полученным значением параметр "signature". Сформированную УКЭП необходимо
открыть в любом доступном текстовом редакторе и удалить символы переноса строк.
В случае успеха в ответе приходит уникальный идентификатор документа.
После возврата товара в оборот КИ меняет тип на - "INTRODUCED" - Введен в оборот" -
(см."Справочник "Статусы КИ"").

36
3. Обращение к True API
3.1. Регистрация УОТ

3.1.1. Метод создания заявки на регистрацию УОТ

Для создания заявки на регистрацию УОТ необходимы данные сертификата УОТ, а также значения
параметров "e-mail (адрес электронной почты УОТ)" и "Телефон (контактный телефон УОТ)". При
этом должность руководителя организации УОТ должна быть указана в сертификате, и её значение
должно совпадать со значением указанного параметра в ЕГРЮЛ.
Партнер, который помог сформировать и отправить УОТ заявку на регистрацию в ГИС МТ,
направляет в REST API заявку на регистрацию, подписанную будущим УОТ.
Запрос осуществляется только при наличии JWT-токена.
Для создания ключа, позволяющего выполнить данный метод, участнику требуется выполнить
следующие действия:
1. Сгенерировать две пары ключей (одна пара для интеграционного стенда, вторая – для
промышленного) с помощью следующих команд:
– openssl genrsa -out private.pem 1024
– openssl rsa -inprivate.pem -outform PEM -pubout -out public.pem
2. Отправить письмо на адрес [email protected] с темой «Файлы открытых ключей для метода
создания заявки на регистрацию УОТ», где предоставить следующую информацию:
– ИНН;
– полное наименование организации;
– веб-сайт организации;
– файлы открытых ключей для добавления в список Партнёров на соответствующие
стенды:
• public_int.pem (для интеграционного стенда);
• public_prod.pem (для промышленного стенда).
3. Перед добавлением открытого ключа выполнить проверку открытого ключа (открытый ключ
должен быть 1024) с помощью команды:
– $openssl rsa -inform PEM -pubin -in 6663003127.pem -text
– Public-Key: (1024 bit)
4. Сгенерировать токен в соответствии с JWT RFC-7519, используя алгоритм RS512. При этом
токен должен удовлетворять следующим требованиям:

37
 a. Токен должен состоять из трёх частей:
• заголовок;
• тело;
• подпись.
b. Заголовок и тело токена должны содержать JSON, закодированный̆ в BASE64.
c. Подпись токена в формате BASE64 должна содержать подпись, полученную при
подписании тела токена с применением закрытого ключа Партнёра.
d. Токен должен содержать следующие параметры:

Параметр Тип Обяз. Описание Пример

alg string + Алгоритм RS512 "RS512"
inn string + ИНН Партнёра "1234567890"
full_name string - Полное наименование организации "Общество с ограниченной
Партнёра ответственностью"
date Long + Дата создания токена в секундах 1546342656 (01.01.2019 11:37:36 GMT)
[signature] string + Подпись

e. Тело токена может содержать дополнительные поля, но они будут игнорироваться ГИС МТ.
f. Пример состава токена:
{
"alg":"RS512"
}{
"inn":"1234567890",
"full_name":"Общество с ограниченной ответственностью",
"date":1546342656
}[
"signature"
]

6. Проверить на https://jwt.io сгенерированный токен с подписью (токен генерирует Партнёр).

7. Токен считается валидным, если для него выполняются следующие условия:
Подпись токена успешно проверена при помощи открытого ключа Партнёра. Открытый ключ
каждого Партнёра должен быть заранее предоставлен оператору системы для настройки авторизации
оператора Партнёра на сервере ГИС МТ.
Данные, полученные из подписи токена, соответствуют телу токена (тот же состав полей + inn из
токена должен быть равен inn из запроса).
Дата создания токена валидна, то есть она меньше текущей даты сервера (UTC 0) в момент запроса и
не старше, чем установленное время жизни токена.

38
Тип приватности: публичный.
URL: /elk/registration
Метод: POST
Content-Type: application/json
Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

document_format string + Код формата данных с параметрами Возможные значения:
сертификата УОТ "MANUAL" (документ формата
JSON);
"XML" (документ формата XML)
product_document string + Закодированная в base64 заявка на добавление Кодируемый json должен быть в
организации кодировке utf-8
signature string + Откреплённая УКЭП в кодировке base64

Структура данных параметра product_document:

Обяз
Параметр Тип Описание . Комментарий
organisation object Параметры +
организации
*inn string ИНН + При подаче заявки на регистрацию УОТ
организации осуществляется следующая проверка значения
данного параметра: ИНН из загруженной УКЭП
= ИНН данной организации в следующем
реестре:
ЕГРЮЛ (Единый государственный реестр
юридических лиц) для ЮЛ РФ;
ЕГРИП (Единый государственный реестр
индивидуальных предпринимателей) для ИП;
РАФП (Реестр аккредитованных филиалов,
представительств иностранных юридических
лиц) для ЮЛ не из РФ.
*ogrn string ОГРН\ОГРНИП - Значением данного параметра является основной
государственный регистрационный номер,
который должен удовлетворять следующим
требованиям:
Для ЮЛ:
длина значения параметра = 13 знаков,
обязательно к заполнению;
Для ИП:
длина значения параметра = 15 знаков,
необязательно к заполнению.
*organisation_name string Наименование + При подаче заявки на регистрацию УОТ

39
 Обяз
Параметр Тип Описание . Комментарий
организации осуществляется следующая проверка значения
УОТ либо ИП данного параметра: наименование организации
Ф.И.О. из загруженной УКЭП = наименованию данной
организации в следующем реестре:
ЕГРЮЛ (Единый государственный реестр
юридических лиц) для ЮЛ РФ;
ЕГРИП (Единый государственный реестр
индивидуальных предпринимателей) для ИП.
*email string E-mail + Значением данного параметра является адрес
электронной почты УОТ, на который будет
осуществляться рассылка уведомлений от ГИС
МТ.
Значение данного параметра должно быть
уникально в ГИС МТ, т.е. не допускается
указание одного и того же адреса электронной
почты для регистрации различных УОТ.
*ifns string Код ИФНС + Значение данного параметра длиной 4 знака
берётся из сведений о налоговом органе, в
котором УОТ числится на учёте.
*phone string Контактный + Значением данного параметра является номер
номер УОТ телефон УОТ.
*kpp string КПП - Значением данного параметра длиной 9 знаков
является код причины постановки УОТ на учёт.
Данный параметр для ИП не заполняется.
*address string Адрес + Значением данного параметра является
юридический адрес регистрации организации,
например, "125362, МОКВА Г, СВОБОДЫ УЛ,
ДОМ 17, ПОДВАЛ ПОМЕЩЕНИЕ I -
КОМНАТА 5".
*gs1_list array Список пар -
номеров
GCP+GLN
*gcp number(9) Номер GCP + Значением данного параметра является
глобальный префикс предприятия - GCP (Global
Company Prefix) - международный
регистрационный номер предприятия в системе
GS1.
Значение данного параметра запрашивается в
каталоге GS46 (если УОТ не является членом
ассоциации GS1, то в Национальном Каталоге в
разделе
«https://account.integrators.nk.crpt.tech/profile[Про
филь]» предусмотрена возможность подачи
«Заявления на вступление в ассоциацию»).
*glns number(13 Номер GLN + Значением данного параметра является
) глобальный идентификационный номер - GLN

40
 Обяз
Параметр Тип Описание . Комментарий
(Global Location Number), т.е. цифровой код,
предназначенный для идентификации
предприятий, функциональных подразделений,
физических местоположений - в системе GS1.
Значение данного параметра запрашивается в
каталоге GS46 (если УОТ не является членом
ассоциации GS1, то в Национальном Каталоге в
разделе
«https://account.integrators.nk.crpt.tech/profile[Про
филь]» предусмотрена возможность подачи
«Заявления на вступление в ассоциацию»).
product_group array Список ТГ УОТ +
*code string ТГ УОТ + Товарная группа:
lp – Предметы одежды, белье постельное,
столовое, туалетное и кухонное;
shoes – Обувные товары;
tobacco – Табачная продукция;
perfumery – Духи и туалетная вода;
tires – Шины и покрышки пневматические
резиновые новые;
electronics – Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки;
pharma – Лекарственные препараты для
медицинского применения;
milk – Молочная продукция;
bicycle – Велосипеды и велосипедные рамы;
wheelchairs – Кресла-коляски;
water - Упакованная вода;
otp - Альтернативная табачная продукция
*types array[strin Тип участника + Варианты значений:
g] для ТГ "PRODUCER" (производитель);
"IMPORTER" (импортёр товара);
"WHOLESALER" (оптовая торговля);
"RETAIL" (розничная торговля)
user object Пользователь +
*finger_print string Отпечаток + Пример значения данного параметра:
сертификата dd5c1ba2e7bb1a260e69797d0f4511093ca0d3b5
УКЭП
*last_name string Фамилия + При подаче заявки на регистрацию УОТ
осуществляется следующая проверка: значения
параметров "<Фамилия> <Имя и Отчество>" из
загруженной УКЭП = Ф.И.О. в следующем
реестре:
ЕГРЮЛ (Единый государственный реестр
юридических лиц) для ЮЛ РФ;
ЕГРИП (Единый государственный реестр
индивидуальных предпринимателей) для ИП;
РАФП (Реестр аккредитованных филиалов,

41
 Обяз
Параметр Тип Описание . Комментарий
представительств иностранных юридических
лиц) для ЮЛ не из РФ
*name string Имя и Отчество +
management_company object Управляющая - Заполняется при наличии управляющей
компания компании
*contract string Реквизиты + Значение параметра формата "Договор №
договора на <number> от <date>"
управление
*inn string ИНН +
Управляющей
организации/ИП
production_place array Производственн - Обязательно для (если product_group.code
ые площадки = "tobacco" и product_group.types
= "PRODUCER")
*production_place_name string Наименование +
производственн
ой площадки
*production_country_numeric_ string Код страны +
code производства
*production_address string Адрес +
производства
*production_kpp string КПП -
*production_lines array[strin Список +
g] наименований
производственн
ых линий
edo_operators array Список + Необходимо указать стороннего оператора ЭДО
операторов ЭДО
*edo_operator_name string Наименование +
оператора ЭДО
по ЕГРЮЛ
*edo_participant_id string ID участника + Идентификатор УОТ в системе ЭДО оператора
is_main_operator boolean Оператор + Значение "true" может принимать только один
является оператор ЭДО
основным
оператором
ЭДО для УОТ
*edo_operator_inn string ИНН оператора +
ЭДО
bank_details object Банковские + Обязательно для всех видов организаций, кроме
реквизиты ИП
*bic string БИК Банка +

42
 Обяз
Параметр Тип Описание . Комментарий
*account string Расчетный счет +
*sf_required boolean Признак счета- + В параметре указывается, необходимо ли УОТ
фактуры предоставлять счет-фактуру на аванс.
Возможные значения:
true - организация работает по ОСН;
false - организация не работает по ОСН.
type string Тип - Всегда = "EXTERNAL"
заполняемой
заявки

Пример JSON-формата параметра product_document:

{
"organisation": {
"inn": "7743000100",
"ogrn": "1037700020001",
"organisation_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ\"РОМАШКА\"",
"email": "[email protected]",
"ifns": "7743",
"phone": "9999999999",
"kpp": "774301001",
"address": "197022, САНКТ-ПЕТЕРБУРГ ГОРОД, УЛИЦА ПРОФЕССОРА ПОПОВА, ДОМ 47, ЛИТЕРА
А, ПОМЕЩЕНИЕ 36"
},
"bank_details": {
"bic": "044525000",
"account": "40702810000000010002",
"sf_required": true
},
"product_group": [
{
"code": "shoes",
"types": [
"RETAIL",
"WHOLESALER"
]
},
{
"code": "shoes",
"types": [
"RETAIL",
"WHOLESALER"
]
}
],
"user": {
"last_name": "ИВАНОВ",
"name": "ИВАН ИВАНОВИЧ",
"finger_print": "fefb734345296b7c292923428db57b3a7876da69"
},
"edo_operators": [

43
 {
"edo_operator_name": "ОПЕРАТОР",
"edo_participant_id": "deeb9214-aa33-4f3c-8027-3aeaf8563574",
"is_main_operator": true
}
]
}

Параметры ответа:

Параметр Обяз. Тип Описание Комментарий

registrationRequestDocId - number Номер заявки на добавление При успешном создании в ГИС
организации МТ

Пример запроса:
POST <url стенда>/elk/registration
Accept: application/json;charset=UTF-8
Content-Type: application/json
Authorization: Bearer <ТОКЕН>
{
"document_format": "MANUAL",
"product_document": "<Документ JSON, закодированный в base64>",
"signature": "<Тело JSON, подписанное откреплённой УКЭП и закодированное
в base64>"
}

Пример ответа: 1 В случае успеха:

{
"registrationRequestDocId":1095
}

2 В случае ошибок:
2.1. Код 403 Если не указан аутентификационный токен, то возвращается пустой ответ:
{}

2.2. Код 400 При неверной структуре JSON в теле запроса:

{
"error_message": "JSON parse error: Cannot deserialize value of type
`ru.crpt.lk.doc.api.dto.FileType` from string \"MANUL\": value not one
of declared Enum instance names: [UPD, CSV, XML, MANUAL]; nested
exception is com.fasterxml.jackson.databind.exc.InvalidFormatException:
Cannot deserialize value of type `ru.crpt.lk.doc.api.dto.FileType` from
string \"MANUL\": value not one of declared Enum instance names: [UPD,
CSV, XML, MANUAL]\n at [Source: (PushbackInputStream); line: 2, column:
24] (through reference chain:
ru.crpt.trueapi.dto.lp.documents.InputDocumentDto[\"document_format\"])"
}

44
3.1.2. Метод проверки статуса заявки УОТ на регистрацию по ID заявки
Метод предназначен для получения результата обработки заявки на регистрацию УОТ в ГИС МТ.
При отправке ID заявки на регистрацию УОТ, полученного на этапе создания заявки на регистрацию
УОТ, в ответе возвращается статус регистрации заявки:
• если заявка не прошла проверку ГИС МТ (код статуса ≠ "CHECKED_OK"), то УОТ недоступна
авторизация и дальнейшие действия в ГИС МТ;
• если заявка успешно прошла проверку ГИС МТ (код статуса = "CHECKED_OK"), то УОТ
доступны дальнейшие действия в ГИС МТ.
Тип приватности: без токена.
URL: /elk/documents/status/{documentId}
Метод: GET
Параметры тела запроса:

Параметр Обяз. Тип Описание

documentId + number Номер заявки на добавление организации

Параметры ответа:

Параметр Обяз. Тип Описание Комментарий

registrationRequestStatus + string Код статуса заявки на добавление см. Справочник "Статусы заявки на
организации регистрацию УОТ"
documentType + string Тип документа
errors - string Ошибки
*message - string Сообщение об ошибке
*internalError - string Сообщение о внутренней ошибке
(обычно стектрейс)

Пример запроса:
<url стенда>/elk/documents/status/1095

Пример ответа:
1 В случае успеха:
{
"registrationRequestStatus":"CHECKED_OK"
}

2 В случае ошибок:
2.1. Код 400:

45
{
"error_message": "[OPEN API] Отсутствует провайдер статуса для типа заявки
LK_REGISTRATION"
}

3.2. Метод проверки регистрации УОТ по ИНН в системе ГИС МТ

В результате успешного выполнения запроса по одному или нескольким (до 1000) ИНН УОТ в ответе
возвращается информация о запрашиваемых УОТ.
Тип приватности:
1. Публичный (данный тип приватности сохранён для обратной совместимости с предыдущими
релизами True API);
2. Без токена (в связи с расширением общедоступной информации для ТГ "Табачная продукция" и
"Альтернативная табачная продукция"): в ответе возвращается краткая информация о
запрашиваемом участнике;
3. С токеном: в ответе возвращается расширенная информация о запрашиваемом участнике, если
ИНН запрашивающего равен ИНН УОТ).
URL: /participants/{inn}
Метод: GET
Пример строки запроса для одного ИНН УОТ: (публичный тип приватности)
<url стенда>/participants/0000000000
Authorization: Bearer <ТОКЕН>

Пример строки запроса для нескольких ИНН УОТ: (публичный тип приватности)
<url стенда>/participants?inns=0000000000&inns=0000000001
Authorization: Bearer <ТОКЕН>

Примечание: в одном запросе может быть указано не более 1000 ИНН УОТ.
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

inn string + Один запрашиваемый ИНН При запросе нескольких ИНН необходимо вместо "inn"
УОТ использовать "inns"

Параметры базового ответа (ИНН запрашивающего не соответствует ИНН УОТ или не указан
токен аутентификации):

Параметр Тип Обяз. Описание Комментарий

inn string + ИНН УОТ
status string + Текущий статус УОТ Возможные значения:

46
Параметр Тип Обяз. Описание Комментарий
Зарегистрирован;
Не зарегистрирован;
Удалён;
Восстановлен;
Заблокирован
is_registered boolean + Признак true - текущий статус УОТ в ГИС МТ принимает возможные
регистрации в ГИС значения: "Зарегистрирован", "Восстановлен" и "Заблокирован;
МТ false - в остальных случаях

Параметры расширенного ответа: ИНН запрашивающего соответствует ИНН УОТ:

Параметр Тип Обяз. Описание Комментарий

inn string + ИНН УОТ
name string - Наименование УОТ
statusInn string - Статус регистрации УОТ См. Справочник "Статусы УОТ"
status string + Текущий статус УОТ Возможные значения:
Зарегистрирован;
Не зарегистрирован;
Удалён;
Восстановлен;
Заблокирован
chief array[string] - Список Ф.И.О.
руководителей
role array[string] - Список кодов типов См. Справочник "Типы организаций"
организации УОТ
is_registered boolean + Признак регистрации в true - статус УОТ в ГИС МТ равен: "Зарегистрирован",
ГИС МТ "Восстановлен" и "Заблокирован;
false - в остальных случаях

Пример базового ответа:

1.В случае успеха:
{
"inn": "0000000000",
"status_inn": "Зарегистрирован",
"is_registered": true
}

Пример расширенного ответа:

2.В случае успеха:
[
{
"inn": "7705442156",
"error_code": "400",

47
 "error_message": "ИНН некорректен"
},
{
"inn": "2356048827",
"status": "Зарегистрирован",
"is_registered": true
}
]

3.В случае ошибок. 3.1 При некорректном ИНН возвращается ответ с кодом ошибки 404 "УОТ не
найден":
{
"error_message":"УОТ не найден"
}

3.2 При запросе информации по нескольким ИНН и некорректности хотя бы одного из них
возвращается ответ с кодом ошибки 400 "ИНН некорректен (один или более)"
{
"error_message":"ИНН некорректен (один или более)"
}

3.3. Работа со счетами и договорами на оплату

3.3.1. Получение сведений по черновикам заключённых договоров между УОТ и Оператором

ГИС МТ
В результате выполнения запроса возвращаются метаданные договоров между УОТ и ГИС МТ.
Идентификатор УОТ (ParticipantId) берётся из токена.
Тип приватности: приватный.
URL: /elk/crm-api/documents
Метод: GET
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

status string + Код статуса обработки запроса см. Справочник "Статусы ответов"
response array - Список договоров При наличии договора в ГИС МТ
*guid number + ID черновика договора
*lcstage number - Статус документа в жизненном См. Справочник "Статусы документа в
цикле SD жизненном цикле SD"
*inn number + Порядковый номер из
идентификатора
*createtime string + Дата и время создания договора
в CRM/SD

48
Параметр Тип Обяз. Описание Комментарий
*fileSize number + Размер файла договора в байтах
*document number + ID документа
*name string + Наименование файла договора
без расширения
*signdate string - Дата подписания договора yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-time)
*fileName string + Наименование файла договора с
расширением
*position string + Наименование должности
руководителя организации УОТ
*fullname string + Ф.И.О. руководителя
организации УОТ
*edoStatus number - Статус договора в ЭДО см. Справочник "Статусная модель"
Данное поле возвращается только после
подписания документа со стороны УОТ
*edoDocumentId string - ID договора в ЭДО Данное поле возвращается только после
подписания документа со стороны УОТ
*docid string + ID документа формата
"<name>/<год создания>"
*link array + Список команд заголовка
запроса
*href string + URL получения документа по
guid
*action string + Метод запроса
*types string + Тип контента
*status number + Статус заключения документа Возможны следующие статусы:
0 - на проверке/обрабатывается;
1 - ожидает подписания со стороны УОТ;
2 - оформлен/подписан (зависит от signtype).
*doctype number + Тип документа см. Справочник "Типы договоров"
*signtype number + Тип подписи документа Возможны следующие статусы:
1 - требует подписания обеих сторон,
2 - требует подписания только со стороны
УОТ,
3 - требует подписания только со стороны
Оператора-ЦРПТ,
4 - подписание не требуется.

Пример запроса:
<url стенда>/elk/crm-api/documents
Authorization: Bearer <ТОКЕН>

Пример ответа:

49
1 В случае успеха:
{
"status": "200",
"response": [
{
"guid": 215,
"lcstage": 40,
"inn": 23499,
"createtime": "2019-07-09T19:53:37.835+03:00",
"fileSize": 46406,
"document": 220,
"name": "РЭ_Т_00026_19",
"fileName": "РЭ_Т_00026_19.pdf",
"position": "Владыкич",
"fullname": "Колдамасова Светлана Николаевна",
"edoDocumentId": "5b7f19e8-db96-463a-9735-2ef1a73abf9b",
"docid": "РЭ_Т_00026/19",
"link":
"{'href':'https://sdtest.crpt.ru/rest/1.0/sdcrpt/rpc/document?guid=220'}",
"action": "GET",
"types": [
"text/xml",
"application/json"
]
},
{
"status": 1,
"doctype":-11,
"signtype" : 2
},
{
"guid": 214,
"lcstage": 40,
"inn": 23499,
"createtime": "2019-07-09T19:53:37.799+03:00",
"fileSize": 46119,
"document": 219,
"name": "КМ_Т_00134_19",
"fileName": "КМ_Т_00134_19.pdf",
"position": "Владыкич",
"fullname": "Колдамасова Светлана Николаевна",
"edoDocumentId": "t2yu19e8-db96-463a-9735-2ef1a73akli8y",
"docid": "КМ_Т_00134/19",
"link":
"{'href':'https://sdtest.crpt.ru/rest/1.0/sdcrpt/rpc/document?guid=219'}",
"action": "GET",
"types": [
"text/xml",
"application/json"
]
},
{
"status": 1,
"doctype" : -4,
"signtype": 1
}

50
 ]
}

2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

3.3.2. Получение сведений по заключённым договорам между УОТ и ГИС МТ

В результате выполнения запроса возвращаются метаданные договоров между УОТ и ГИС МТ.
Идентификатор УОТ (ParticipantId) берётся из токена.
Тип приватности: приватный.
URL: /elk/crm-api/document
Метод: GET
Пример запроса:
<url стенда>/elk/crm-api/document?guid=8725
Authorization: Bearer <ТОКЕН>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

guid number + ID черновика Значение параметра "guid" в ответе метода "Получение сведений по
договора черновикам заключённых договоров между УОТ и Оператором ГИС МТ"
(elk/crm-api/documents)

Пример ответа:
1 В случае успеха:
"string"

В ответ приходит ссылка на документ в формате pdf

Параметры ответа:
В ответ придут номера договоров
2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:

51
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

3.3.3. Подписание договоров

Метод предназначен для подписания УОТ договоров с ГИС МТ с помощью УКЭП.
В результате передачи в запросе ЭП к договору с указываемым идентификатором на выходе
возвращается статус обработки запроса и информация об ошибке (при её наличии).
Тип приватности: приватный
URL: /elk/outgoing-documents/{documentId}/signature
Метод: POST
Content-Type: application/json
Параметры URL запроса:

Параметр Тип Обяз. Описание

documentId string + Идентификатор документа в системе ЭДО оператора. Можно найти по методу /elk/crm-
api/documents в ответе которого будет нужный параметр edoDocumentId

Параметры тела запроса:

Параметр Тип Обяз. Описание

signature string + Открепленная подпись под документом в base64

Параметры ответа:

Параметр Обяз. Тип Описание Комментарий

id + string id документа по ЭДО Лайт

Пример запроса:
curl --location --request POST '<url стенда>/elk/outgoing-documents/4958/signature' \
--header 'Accept: application/json, text/plain' \
--header 'Authorization: Bearer <ТОКЕН>
--header 'Content-Type: text/plain' \
--data-raw 'signature'

Пример ответа:
1 В случае успеха:

52
{
"id":"string"
}

2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен (ответ удаленной системы):
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2. Код 401 В случае, если не указан токен (ответ True API):
{
"error_message": "Для доступа к этому ресурсу требуется полная
аутентификация"
}

3.3.4. Получение статуса заключения договора

Метод предназначен для получения информации о статусе заключения всех договоров между ГИС
МТ и УОТ.
В результате передачи в токене запроса идентификатора УОТ (ParticipantId) возвращается массив
статусов обработки договоров УОТ.
Существуют следующие статусы:
• общий статус УОТ в backend ЕЛК (зависит от статусов заключения всех договоров УОТ с ГИС
МТ);
• расширенный статус договоров (зависит от результата заключения данного договора с ГИС МТ).
Если подписана только часть договоров, то УОТ не может быть полностью активен в ГИС МТ
(общий статус УОТ не валиден в Системе).
Если требуется подписание договора со стороны УОТ, то статус входящего документа = "Черновик".
Если требуется подписание договора со стороны Оператора, то статус входящего документа =
"Доставлен (ожидается подпись)", статус исходящего документа = "Требуется подпись".
Если обе стороны подписали документ, то статус входящего и исходящего документа = "Подписан".
Тип приватности: приватный.
URL:

Тип документов URL

Для исходящих документов /elk/outgoing-documents

53
Тип документов URL
Для входящих документов /elk/incoming-documents

Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

limit string - Количество возвращаемых документов Значение по умолчанию = 10
offset string - Смещение Значение по умолчанию = 0

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

count number + Число возвращённых
документов
items array - Список договоров с ГИС При наличии договора в ГИС МТ
МТ
*id string + Идентификатор документа
в системе ЭДО оператора
*status number + Статус заключения см. Справочник "Статусная модель"
черновика договора либо
Если status = 4, то договор считается подписанным обеими
договора
сторонами. Иначе при любом другом значении status договор
считается неподписанным обеими сторонами.

Пример запроса:
<url стенда>/elk/outgoing-documents?limit=10&offset=0
Authorization: Bearer <ТОКЕН>

Пример ответа:
1 В случае успеха:
{
"count": 4,
"items": [
{
"id": "5b7f19e8-db96-463a-9735-2ef1a73abf9b",
"status": 2
},
{
"id": "02e88283-5793-42fd-bdba-1b5176fe912c",
"status": 4
},
{
"id": "0268d1c9-b601-4866-9ed1-3595e34387bc",

54
 "status": 0
},
{
"id": "057fbd84-a933-4eee-b5a4-0f4b9579f901",
"status": 1
}
]
}

2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

3.3.5. Получение сведений о заключенных договорах между УОТ и Оператором ГИС МТ

Тип приватности: приватный.
URL:

Тип документа URL

Для исходящих документов /elk/outgoing-documents/{documentId}/content
Для входящих документов /elk/incoming-documents/{documentId}/content

Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание

documentId string + Идентификатор документа в системе ЭДО оператора

Параметры ответа:
запрашиваемый файл
Пример запроса:
<url стенда>/elk/outgoing-documents/f2aab44e-9cc3-4b37-a4ff-c8edf0b6e57b/content
Authorization: Bearer <ТОКЕН>
Accept: */*

Пример ответа:
1 В случае успеха:
запрашиваемый файл.

55
2 В случае ошибок:
2.1 Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2 Код 404 В случае, если указан невалидный {documentId} в параметре URL запроса:
{
"error_message": "Документ не найден"
}

3.3.6. Получение счёта на оплату

При успешном выполнении запроса на указанный в запросе e-mail отправляется файл со счётом на
оплату.
Тип приватности: приватный.
URL: /elk/crm-api/prequests
Метод: POST
Content-Type: application/json
Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

contractId string + Идентификатор договора
УОТ с ГИС МТ
amount string + Сумма счёта на оплату с Значение данного параметра будет указано в счёте на оплату.
учетом НДС Указывается в рублях с разделителем ". "(точка) для указания
копеек.
sendto string + e-mail УОТ На данный e-mail будет отправлен счёт на оплату

Параметры ответа:

Параметр Обяз. Тип Описание Комментарий

status + string Код статуса обработки запроса на получение см. Справочник "Статусы ответов"
счёта на оплату
response + integer Идентификатор созданного счета на оплату
error_message - string Текст сообщения об ошибке при обработке Параметр возвращается при наличии
запроса ошибки

Пример запроса:

56
POST <url стенда>/crm-api/prequests'
--header 'Authorization: Bearer <ТОКЕН>
--header 'Content-Type: text/plain'
--data-raw '{contractId: 1003518, sendto: "[email protected]", amount: "150.50"}'

Пример ответа:
1 В случае успеха:
{
"status": 200
}

2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

3.4. Проверка баланса денежных средств УОТ по товарным группам

3.4.1. Получение информации о балансе денежных средств по всем товарным группам

Метод предназначен для получения значения баланса лицевых счетов, запрашиваемого УОТ по
каждой товарной группе. Выполнить запрос можно только для получения собственного баланса
денежных средств.
Тип приватности: приватный.
URL: /elk/product-groups/balance/all
Метод: GET
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

balance number - Значение баланса в копейках
contractId number - Идентификатор договора УОТ с ГИС МТ
на подключенную ТГ
organisationId number + ID УОТ Идентификатор организации УОТ в ГИС
МТ
productGroupId number + Идентификатор товарной группы УОТ см. Справочник "Список
поддерживаемых товарных групп"

Пример запроса:

57
<url стенда>/elk/product-groups/balance/all
Authorization: Bearer:<ТОКЕН>

Пример ответа:
1 В случае успеха:
[
{
"organisationId": 572286704,
"productGroupId": 3
},
{
"balance": 120000000,
"organisationId": 600000749,
"productGroupId": 8
},
{
"balance": 120000000,
"organisationId": 600000749,
"productGroupId": 5
},
{
"balance": 120000000,
"organisationId": 600000749,
"productGroupId": 6
},
{
"balance": 119999880,
"organisationId": 600000749,
"productGroupId": 1
},
{
"organisationId": 600000749,
"productGroupId": 10
},
{
"balance": 120000000,
"organisationId": 600000749,
"productGroupId": 4
},
{
"organisationId": 600000749,
"productGroupId": 9
},
{
"balance": 11990340,
"contractId": 1000005356,
"organisationId": 600000749,
"productGroupId": 2
}
]

2 В случае ошибок:
2.1. Код 401 В случае, если в запросе не указан токен:

58
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2. Код 404 В случае, если в токене отсутствует pid:

{
"error_message": "В токене указано некорректное значение параметра pid либо в
Системе ГИС МТ нет пользователя с данным идентификатором, либо у пользователя нет
лицевого счёта в Системе ГИС МТ"
}

3.4.2. Получение информации о балансе денежных средств по одной товарной группе

Метод предназначен для получения значения баланса лицевого счета, запрашиваемого УОТ по одной
товарной группы. Выполнить запрос можно только для получения информации о собственном
балансе денежных средств.
Тип приватности: приватный.
URL: /elk/product-groups/balance
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

productGroupId number + Идентификатор товарной группы см. Справочник "Список поддерживаемых
УОТ товарных групп"

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

balance number - Значение баланса в копейках
contractId number - Идентификатор договора УОТ с
ГИС МТ
organisationId number + ID УОТ Идентификатор организации УОТ в ГИС МТ
productGroupId number + Идентификатор товарной группы см. Справочник "Список поддерживаемых
УОТ товарных групп"

Пример запроса:
<url стенда>/elk/product-groups/balance?productGroupId=1
Authorization: Bearer:<ТОКЕН>;

Пример ответа:

59
1 В случае успеха:
{
"balance": 120000000,
"organisationId": 600000749,
"productGroupId": 8
}

2 В случае ошибок: 2.1. Код 404 В случае, если в ответе вернулся пустой массив, означающий
указание в запросе некорректного/несуществующего в Системе ГИС МТ ID УОТ либо отсутствие у
УОТ лицевого счёта в Системе ГИС МТ:
{
"error_message": "В токене указано некорректное значение параметра pid либо в Системе
ГИС МТ нет пользователя с идентификаторами {0} нет лицевого счёта в Системе ГИС МТ",
где {0} это pid берется из tokena"
}

2.2. Код 401 В случае, если в запросе не указан токен:

<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.3. Код 404 В случае, если в токене отсутствует pid:

{
"error_message": "В токене отсутствует свойство pid"
}

3.5. Запрос списка контрагентов УОТ (ТГ "Табачная продукция" и

"Альтернативная табачная продукция")

3.5.1. Запрос списка контрагентов

В результате успешного выполнения запроса в ответе возвращается список ИНН контрагентов
участника оборота товаров (УОТ), выполнившего запрос. Идентификация УОТ осуществляется по
токену.
Тип приватности: приватный
Ограничение:
УОТ может запросить список только своих контрагентов.
URL: /partner/
Метод: GET
Параметры ответа:

60
Параметр Тип Обяз. Описание Комментарий
result array[string] - Список ИНН контрагентов УОТ При наличии УОТ в ГИС МТ

Пример запроса:
<url стенда>/partner/
Authorization: Bearer <ТОКЕН>

Пример ответа: 1 В случае успеха:

[
"7718239655",
"5032212790",
"7804064663",
"7707329152",
"7727707701",
"7725519413",
"7813411433",
"7731369928",
"8613005161"
]

2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

3.5.2. Запрос списка контрагентов УОТ (для ФОИВ, Оператора, Администратора)

В результате успешного выполнения запроса в ответе возвращается список ИНН контрагентов УОТ,
указанного в запросе. Идентификация УОТ осуществляется по указанному в запросе ИНН.
Тип приватности:
1. Оператор;
2. ФОИВ;
3. Администратор.
URL: /partner/{inn}
Метод: GET
Параметры запроса:

61
Параметр Тип Обяз. Описание
inn string + ИНН УОТ

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

result array[string] - Список ИНН контрагентов УОТ При наличии УОТ в ГИС МТ

Пример запроса:
<url стенда>/partner/7718239655
Authorization: Bearer <ТОКЕН>

Пример ответа:
1 В случае успеха:
[
"5032212790",
"7804064663",
"7707329152",
"7727707701",
"7725519413",
"7813411433",
"7731369928",
"8613005161"
]

2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2. Код 500 При некорректном ИНН возвращается ответ удалённой системы с пустым телом.

62
4. Подача сведений в систему ГИС МТ через "Единый метод создания
документов"
4.1. Единый метод создания документов
URL: /lk/documents/create
Метод: POST
Тип приватности: приватный
Пример запроса:
POST <url стенда>/lk/documents/create?pg=lp
Authorization: Bearer <ТОКЕН>
Content-Type: application/json
{
"document_format": "string",
"product_document": "<Документ в формате base64>",
"type": "string",
"signature": "<Открепленная УКЭП формата Base64>"
}

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

pg string + Товарная Cм. Справочник "Список поддерживаемых товарных групп". В параметре
группа указывается значение товарной группы (наименование)

Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

document_format string + Тип документа Значения:
MANUAL – формат JSON;
XML – формат XML;
CSV – формат CSV
product_document string + Тело формируемого документа, переведённое в
base64
signature string + Откреплённая подпись (УКЭП) в формате base64
type string + Код типа документа См. Справочник "Типы
документов"

Пример ответа:
1 Код 200, 201. В случае успешного создания документа в ответ приходит уникальный
идентификатор документа в ГИС МТ:
9abd3d41-76bc-4542-a88e-b1f7be8130b5

63
2 В случае ошибок:
2.1. Код 401, если не указан токен:
{
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>
}

2.2. Код 400 При неверной структуре JSON в теле запроса:

{
"error_message": "JSON parse error: Cannot deserialize value of type"
}

2.3. Код 400 При отсутствии поля document_format в теле запроса:

{
"error_message": "Не указан тип документа: MANUAL, CSV, XML"
}

2.4. Код 403 При недоступности функционала ТГ, когда есть тело ответа от ЛП-компонента:
{
"error_message": "Перемаркировка недоступна для товарной группы <Наименование ТГ>"
}

2.5. Код 403 При недоступности функционала ТГ, когда нет тела ответа от компонента ТГ:
{
"error_message": "Отсутствует доступ к ресурсу"
}

2.6. Код 400 При параметре URL запроса "pg" = "tobacco":

{
"error_message": "Метод не работает с товарной группой табак"
}

Примечание: единый метод создания документов используется для товарных групп "Табачная
продукция" и "Альтернативная табачная продукция" только для создания документа "Описание
остатков".

4.2. Типы документов для подачи сведений в ГИС МТ

4.2.1. Описание остатков

Создание документа "Описание остатков" товара приведено по сокращённому атрибутивному составу
и доступно для ТГ "Альтернативная табачная продукция".

64
Создание документа "Описание остатков" для ТГ "Обувные товары" недоступно с 01.08.2020, для ТГ
"Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки" и "Табачная продукция" - с
01.12.2020, для ТГ "Предметы одежды, бельё постельное, столовое, туалетное и кухонное" - с
01.02.2021, для ТГ "Шины и покрышки пневматические резиновые новые" - с 01.03.2021.
В текущей реализации при формировании документа "Описание остатков" для товарной
группы "Альтернативная табачная продукция" необходимо при подаче документа указывать
адрес https://int01.gismt.crpt.tech/ для демонстрационного стенда и https://ismotp.crptech.ru/ или
https://markirovka.crpt.ru для промышленного стенда.
Тип документа:

Тип Описание
OST_DESCRIPTION Описание остатков товара. JSON (MANUAL)
OST_DESCRIPTION_CSV Описание остатков товара. CSV
OST_DESCRIPTION_XML Описание остатков товара. XML

Пример тела документа в формате JSON:

{
"trade_participant_inn": "000000000000",
"products_list": [
{
"tnved_code_4" : "0001",
"name": "Наименование товара",
"brand": "Торговая марка",
"product_group": "OTP"
},
{
"tnved_code_4" : "0002",
"name": "Наименование товара",
"brand": "Торговая марка",
"product_group": "OTP"
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

trade_participant_inn string + ИНН УОТ
products_list array + Список сведений о Указываются сведения минимум об одном товаре
товарах
*tnved_code_4 string + Код товарной . Возможные значения:
номенклатуры 2402, 2403 "Альтернативная табачная продукция". Код ТН
(4 знака) ВЭД изменяется для каждого добавляемого товара
*name string - Наименование Параметр не входит в справочник (ввод значения вручную).
товара Минимальный состав сведений – наименование вида
продукции. Максимальная длина указываемого значения - до

65
Параметр Тип Обяз. Описание Комментарий
200 символов
*brand string - Торговая марка При отсутствии значения данного параметра указывается
значение "Отсутствует". Максимальная длина указываемого
значения - до 70 символов
*product_group string - Товарная группа Возможные значения:
"OTP" - Альтернативная табачная продукция (значение
указывается в верхнем регистре);

Пример тела документа в формате CSV:

ИНН участника оборота,Версия
111111111111,4
Список товаров,,,,,,
Код товарной номенклатуры (2 знака),Товарный знак,Наименование
товара,Целевой пол,Способ ввода товара в оборот,Возраст
потребителя,Модель / артикул производителя,Код товарной номенклатуры (4 знака),Товарная
группа
,"Наименование товара" \"Product name",,,,,0000,OTP
,"Наименование товара" \"Product name",,,,,0000,OTP

Пример тела документа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<ost_description version="3">
<trade_participant_inn>000000000000</trade_participant_inn>
<products_list>
<product>
<tnved_code_4>0000</tnved_code_4>
<brand>trademark</brand>
<name>product_name</name>
<product_group>OTP</product_group>
</product>
<product>
<tnved_code_4>0000</tnved_code_4>
<brand>trademark</brand>
<name>product_name</name>
<product_group>OTP</product_group>
</product>
</products_list>
</ost_description>

4.2.2. Агрегирование
4.2.2.1. Агрегация
Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Молочная продукция", "Обувные товары", "Пиво, напитки, изготавливаемые на
основе пива, слабоалкогольные напитки", "Предметы одежды, белье постельное, столовое, туалетное
и кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-
вспышки", "Шины и покрышки пневматические резиновые новые".

66
Тип документа:

Тип Описание
AGGREGATION_DOCUMENT Агрегирование JSON (MANUAL)
AGGREGATION_DOCUMENT_CSV Агрегирование CSV
AGGREGATION_DOCUMENT_XML Агрегирование XML

Пример тела документа в формате JSON

{
"participantId": "string",
"aggregationUnits": [
{
"unitSerialNumber": "string",
"aggregationType": "string",
"sntins": [
"string"
]
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participantId string + ИНН участника
оборота товаров
aggregationUnits array + Список
формируемых
агрегатов
*unitSerialNumber string + Код идентификации КИ может содержать от 18 до 74 символов
агрегата включительно: цифры, буквы латинского алфавита,
спецсимволы (A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ?
!)
*aggregationType string + Код типа агрегации Значение может быть только "AGGREGATION"
*sntins array[string] + Список КИ, Статусы КИ, входящих в агрегат, должны быть
входящих в агрегат идентичны

Примечание:
1. агрегация может осуществляться как до ввода в оборот, так и после ввода в оборот. Если
агрегация была до ввода в оборот, то в документе ввода в оборот необходимо указывать
агрегаты, а не КИ, иначе агрегаты будут расформированы;
2. при агрегировании набор не должен быть пустой: если агрегируемые наборы находятся в составе
КИТУ, то набор должен иметь вложения и быть в статусе "В обороте" или "Эмитирован.
Получен".

67
Пример тела документа в формате CSV:
Тип документа,ИНН участника оборота товаров,Версия
Документ на агрегацию,5834052090,2
Параметры товаров
УИТУ,Вложеннный УИТ/УИТУ
000000000000000002,000000000000000005
000000000000000002,00000000000000000000000000000000000000
000000000000000000,00000000000000000000000000000000000001
000000000000000001,00000000000000000000000000000000000002
000000000000000000,"010466007901460321&%*^$!?""'()*+-=/,;.:<>_1"
000000000000000002,"010466007901460321&%*^$!?""'()*+-=/,;.:<>_2"
000000000000000001,000000000000000002

Пример тела документа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<unit_pack document_id="unit_pack_7FFF90D5-4785-7EC9-899E-534A7BAA2B71" VerForm="1.03"
file_date_time="2019-04-12T11:07:45+03:00" VerProg="VerProg1">
<Document operation_date_time="2019-06-05T14:28:14+03:00" document_number="157743-
20199">
<organisation>
<id_info>
<LP_info org_name="ООО ТорМаг" LP_TIN="5834052090" RRC="504801001" />
</id_info>
<Address>
<location_address country_code="643" text_address="142305" />
</Address>
<contacts phone_number="123456789" email="[email protected]" />
</organisation>
<pack_content>
<pack_code>000000000000000000</pack_code>
<cis>00000000000000000000000000000000000000</cis>
<cis>00000000000000000000000000000000000001</cis>
<cis>00000000000000000000000000000000000002</cis>
<cis>00000000000000000000000000000000000003</cis>
<cis>00000000000000000000000000000000000004</cis>
</pack_content>
<pack_content>
<pack_code>010464004346008721Wll2KePM3hlHCrXDM-+B</pack_code>
<cis>00000000000000000000000000000000000005</cis>
</pack_content>
</Document>
</unit_pack>

4.2.2.2. Трансформация
Тип документа:

Тип Описание
REAGGREGATION_DOCUMENT Трансформация. JSON (MANUAL)
REAGGREGATION_DOCUMENT_CSV Трансформация CSV
REAGGREGATION_DOCUMENT_XML Трансформация XML

68
Пример тела документа в формате JSON
{
"participant_inn": "string" ,
"reaggregation_type": "string" ,
"uit_uitu_list": [
{
"uit_uitu": "string",
"name": "string"
}
] ,
"uitu": "string"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participant_inn string + ИНН участника оборота товара
reaggregation_type string + Код типа операции Возможные значения:
REMOVING – изъятие;
ADDING – добавление
uitu string + Код модифицируемого агрегата
uit_uitu_list array + Список агрегатов для добавления/изъятия
*uit_uitu string + КИ/КИН для добавления/изъятия
*name string - Наименование товара

Пример тела документа в формате CSV:

ИНН участника оборота,Тип трансформации,Код идентификации трансформируемой транспортной
упаковки(КИТУ),Версия
0000000000,Изъятие,000000000000000000,2
Список транспортных упаковок или товаров
КИ,КИТУ
"00000000000000000000000000000000000000",
"11111111111111111111111111111111111111",
,"222222222222222222"

Пример тела документа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<reaggregation action_id="32" version="2">
<trade_participant_inn>0000000000</trade_participant_inn>
<reaggregation_type>REMOVING</reaggregation_type>
<reaggregating_kitu>000000000000000000</reaggregating_kitu>
<product_list>
<packing_product>
<kit>00000000000000000000000000000000000000</kit>
</packing_product>
<packing_product>
<kit>11111111111111111111111111111111111111</kit>
</packing_product>

69
 <packing_product>
<kitu>222222222222222222</kitu>
</packing_product>
</product_list>
</reaggregation>

4.2.2.3. Расформирование
Автоматическое расформирование агрегата происходит при любых действиях с КИ в составе КИТУ,
за исключением случаем подачи сведений о цвете и размере в документе ввода в оборот импортного
товара при взаимодействии с ФТС (Ввод в оборот. Импорт с ФТС)."
Тип документа:

Тип Описание
DISAGGREGATION_DOCUMENT Расформирование. JSON (MANUAL)
DISAGGREGATION_DOCUMENT_CSV Расформирование CSV
DISAGGREGATION_DOCUMENT_XML Расформирование XML

Пример тела документа в формате JSON:

{
"participant_inn": "string",
"products_list": [
{
"uitu": "string"
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participant_inn string + ИНН участника оборота товара
products_list array + Список сведений о товарах
*uitu string - Код расформировываемого агрегата Указание КИН в данном поле недопустимо

Пример тела документа в формате CSV

ИНН участника оборота,Версия
0000000000,2
Список транспортных упаковок
"000000000000000000"
"111111111111111111"
"222222222222222222"

Пример тела документа в формате XML

<disaggregation action_id="31" version="2">
<trade_participant_inn>0000000000</trade_participant_inn>

70
 <packings_list>
<packing>
<kitu>000000000000000000</kitu>
</packing>
<packing>
<kitu>111111111111111111</kitu>
</packing>
<packing>
<kitu>222222222222222222</kitu>
</packing>
<packing>
<kitu>222222222222222222</kitu>
</packing>
<packing>
<kitu>222222222222222222</kitu>
</packing>
</packings_list>
</disaggregation>

4.2.3. Формирование наборов

Создание документа «Формирование наборов» доступно для ТГ «Духи и туалетная вода», «Предметы
одежды, бельё постельное, столовое, туалетное и кухонное», «Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки».
Тип документа:

Тип Описание
SETS_AGGREGATION Формирование наборов JSON (MANUAL)
SETS_AGGREGATION_CSV Формирование наборов CSV
SETS_AGGREGATION_XML Формирование наборов XML

Пример тела документа в формате JSON

{
"participantId": "5834052090",
"aggregationUnits": [
{
"unitSerialNumber": "000000000000000000",
"aggregationType": "SETS_AGGREGATION",
"sntins": [
"000000000000000001"
]
}
]
}

Параметры документа:

71
Параметр Тип Обяз. Описание Комментарий
participantId string + ИНН участника
оборота товаров
aggregationUnits array + Список Набор не может содержать агрегат или другой набор
формируемых
наборов
*unitSerialNumber string + Код КИ может содержать от 18 до 74 символов включительно:
идентификации цифры, буквы латинского алфавита, спецсимволы (A-Z a-z
набора 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !)
*aggregationType string + Код типа Значение может быть только "SETS_AGGREGATION"
агрегации
*sntins array[string] + Список КИ, Если у входящих в набор КИ статус "В обороте"
входящих в (INTRODUCED), то у товара может быть любой способ
набор ввода в оборот. Если у входящих в набор КИ статус
"Эмитирован. Получен" (APPLIED), то у набора не может
быть способ ввода в оборот "Перемаркировка" (REMARK),
при этом способы ввода в оборот КИ и КИН должны быть
одинаковыми.
Если при формировании набора, все КИ, входящие в него,
имеют статус "В обороте", то набор автоматически
вводится в оборот.
Возможные статусы КИ в составе набора:
APPLIED - Эмитирован. Получен;
INTRODUCED - Введён в оборот.
КИ в составе набора может быть выпущен только с типом
упаковки упаковки:
UNIT - Товарная упаковка (единица товара);
BUNDLE - Комплект.

Примечание: чтобы расформировать набор с ошибочно добавленными КИ, необходимо создать

документ «Расформирование». Загрузка документа доступна в форматах *.json, *.xml и *.csv. После
расформирования набора с ошибочно добавленными КИ набор можно сформировать повторно.
При заполнении файла CSV в поле "УИТУ" указывается КИ набора. В поле "Вложенный УИТ/УИТУ"
указывается КИ, входящий в набор. Если несколько КИ входят в один набор, то КИ набора
дублируется в следующей строке с указанием нового КИ товара, вложенного в этот набор.
Пример тела документа в формате CSV:
Тип документа,ИНН участника оборота товаров
Документ на формирование наборов,0101010101
УИТУ,Вложеннный УИТ/УИТУ
"010464004346008721?k+""""slCt/;XBJ-qa-bjO",010464004346009421oEyImWqXq;Lex'Li6-)L
010464004346008721hcpPtfseNdA&oUeZsY:A,010464004346009421SyFOHTMHt6OQ6/nAUS4F
"010464004346008721O>bA5F:aheNT-xWVLI'<","010101010101001021cP_+eTv+Y*BEe9DGTkbf"

Пример тела документа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<unit_pack document_id="unit_pack_7FFF90D5-4785-7EC9-899E-534A7BAA2B71" VerForm="1.03"
file_date_time="2019-04-12T11:07:45+03:00" VerProg="VerProg1" action_id="30"

72
version="1">
<Document operation_date_time="2019-06-05T14:28:14+03:00" document_number="157743-
20199">
<organisation>
<id_info>
<LP_info org_name="ООО ТорМаг" LP_TIN="5834052090" RRC="504801001" />
</id_info>
<Address>
<location_address country_code="643" text_address="142305" />
</Address>
<contacts phone_number="123456789" email="[email protected]" />
</organisation>
<pack_content>
<pack_code>000000000000000000</pack_code>
<cis>00000000000000000000000000000000000000</cis>
</pack_content>
<pack_content>
<pack_code>010464004346008721Wll2KePM3hlHCrXDM-+B</pack_code>
<cis>00000000000000000000000000000000000000</cis>
</pack_content>
</Document>
</unit_pack>

4.2.4. Операции с АТК

4.2.4.1. Формирование АТК
Создание документа доступно для ТГ "Духи и туалетная вода", "Молочная продукция", "Обувные
товары", "Предметы одежды, бельё постельное, столовое, туалетное и кухонное", "Фотокамеры
(кроме кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки пневматические
резиновые новые".
Указание АТК в документе "Ввод в оборот. Импорт с ФТС" будет возможно после внесения
изменений в Решение Комиссии Таможенного союза "О форме декларации на товары и порядке её
заполнения" от 20.05.2010 №257 (ред. от 17.12.2019).
Тип документа:

Тип Описание
ATK_AGGREGATION Формирование АТК. JSON (MANUAL)
ATK_AGGREGATION_CSV Формирование АТК. CSV
ATK_AGGREGATION_XML Формирование АТК. XML

Пример тела документа в формате JSON

{
"trade_participant_inn": "1111111111",
"products_list": [
{
"ki": "11111111111111111111111111111111111111"
},
{

73
 "ki": "22222222222222222222222222222222222222"
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

trade_participant_inn string + ИНН участника оборота
товара
products_list array + Массив, содержащий
список агрегируемых в
АТК КИ
*ki string + КИ Указываются только КИ. Указание в данном
полеКИТУ, КИН или КИ, входящих в состав КИТУ
или другой АТК, не допускается

Пример тела документа в формате CSV:

ИНН участника оборота,Версия
1111111111,1
Параметры товаров
КИ
11111111111111111111111111111111111111
22222222222222222222222222222222222222

Пример тела документа в формате xml:

<atk_aggregation version="1">
<trade_participant_inn>1111111111</trade_participant_inn>
<product_list>
<packing_product>
<ki>11111111111111111111111111111111111111</ki>
</packing_product>
<packing_product>
<ki>22222222222222222222222222222222222222</ki>
</packing_product>
</product_list>
</atk_aggregation>

4.2.4.2. Трансформация АТК

Создание документа доступно для товарных групп "Духи и туалетная вода", "Молочная продукция",
"Обувные товары", "Предметы одежды, бельё постельное, столовое, туалетное и кухонное",
"Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки
пневматические резиновые новые".
Трансформация АТК возможна при следующих актуальных статусах и особом состоянии (см.
"Справочник "Статусы КИ""):
• status=EMITTED ("Эмитирован. Выпущен") \ statusEx=null (особое состояние отсутствует);

74
• status=EMITTED \ statusEx=FTS_RESPOND_NOT_OK ("Отрицательное решение ФТС") ;
• status=EMITTED \ statusEx=FTS_CONTROL ("На контроле ФТС").
Для получения актуальных статусов и особых состояний АТК используется "Метод получения
общедоступной информации о КИ по списку". Создание документа доступно для АТК, не введённых
в оборот. Трансформация введённых в оборот АТК не допускается.
Тип документа:

Тип Описание
ATK_TRANSFORMATION Трансформация АТК. JSON (MANUAL)
ATK_TRANSFORMATION_CSV Трансформация АТК. CSV
ATK_TRANSFORMATION_XML Трансформация АТК. XML

Пример тела документа в формате JSON

{
"trade_participant_inn": "1111111111",
"atk": "1111111111111111111111111",
"transformation_type": "REMOVING",
"products_list": [
{
"ki": "22222222222222222222222222222222222222"
},
{
"ki": "33333333333333333333333333333333333333"
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

trade_participant_inn string + ИНН участника оборота
товара (отправителя)
atk string + Трансформируемый АТК В составе АТК может быть только единица товара
(UNIT) или комплект (BUNDLE)
transformation_type string + Тип трансформации Возможные значения:
REMOVING - изъятие;
ADDING - добавление
products_list array + Массив, содержащий
список перемещаемых КИ
*ki string + КИ Указание значения КИН в данном параметре
недоступно. КИ должен находиться в статусе
"APPLIED" ("Эмитирован. Получен") (см.
"Справочник "Статусы КИ"")

75
Пример тела документа в формате CSV:
ИНН участника оборота,Тип трансформации,Агрегированный таможенный код,Версия
1111111111,Изъятие,1111111111111111111111111,2
Список товаров
КИ
22222222222222222222222222222222222222
33333333333333333333333333333333333333

Пример тела документа в формате xml:

<atk_transformation version="1">
<trade_participant_inn>1111111111</trade_participant_inn>
<transformation_type>REMOVING</transformation_type>
<atk>1111111111111111111111111</atk>
<product_list>
<product>
<ki>22222222222222222222222222222222222222</ki>
</product>
<product>
<ki>33333333333333333333333333333333333333</ki>
</product>
</product_list>
</atk_transformation>

4.2.4.3. Расформирование АТК

Создание документа доступно для товарных групп "Духи и туалетная вода", "Молочная продукция",
"Обувные товары", ТГ "Предметы одежды, бельё постельное, столовое, туалетное и кухонное",
"Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки
пневматические резиновые новые".
Тип документа:

Тип Описание
ATK_DISAGGREGATION Расформирование АТК. JSON (MANUAL)
ATK_DISAGGREGATION_CSV Расформирование АТК. CSV
ATK_DISAGGREGATION_XML Расформирование АТК. XML

Пример тела документа в формате JSON:

{
"trade_participant_inn": "1111111111",
"products_list": [
{
"atk": "1111111111111111111111111"
},
{
"atk": "2222222222222222222222222"
}
]
}

76
Параметры документа:

Параметр Тип Обяз. Описание Комментарий

trade_participant_inn string + ИНН отправителя
products_list array + Массив, содержащий список
расформировываемых АТК
atk string - АТК В составе АТК может быть только единица
товара (UNIT) или комплект (BUNDLE)

Пример тела документа в формате CSV

ИНН участника оборота,Версия
1111111111,2
Список транспортных упаковок
1111111111111111111111111
2222222222222222222222222

Пример тела документа в формате XML

<atk_disaggregation version="1">
<trade_participant_inn>1111111111</trade_participant_inn>
<product_list>
<product>
<atk>1111111111111111111111111</atk>
</product>
<product>
<atk>2222222222222222222222222</atk>
</product>
</product_list>
</atk_disaggregation>

4.2.5. Ввод в оборот

4.2.5.1. Ввод в оборот. Производство РФ
Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Молочная продукция", "Обувные товары", "Предметы одежды, белье постельное,
столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
LP_INTRODUCE_GOODS Ввод в оборот. Производство РФ. JSON (MANUAL)
LP_INTRODUCE_GOODS_CSV Ввод в оборот. Производство РФ. CSV
LP_INTRODUCE_GOODS_XML Ввод в оборот. Производство РФ. XML

Пример тела документа в формате JSON:

77
{
"participant_inn": "1111111111",
"production_date": "2019-01-01",
"producer_inn": "2222222222",
"owner_inn": "3333333333",
"production_type": "OWN_PRODUCTION",
"products": [
{
"production_date": "2019-01-01" ,
"uit_code": "0104630033880100211AREwAwLETM7g240ffd0",
"uitu_code": 111111111111111111,
"tnved_code": "6401921000",
"certificate_document": "CONFORMITY_CERTIFICATE",
"certificate_document_number": "123",
"certificate_document_date": "2019-01-01",
"vsd_number": "9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091"
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participant_inn string + ИНН участника,
осуществившего
эмиссию КИ
production_date string + Дата производства Задаётся в формате yyyy-MM-dd. Диапазон
товара допустимых значений: от даты создания
документа минус пять лет по дату создания
документа
producer_inn string + ИНН производителя
товара
owner_inn string + ИНН собственника
товара
production_type string + Тип Возможные значения:
производственного OWN_PRODUCTION – Собственное
заказа производство
products [string] + Перечень товаров
*production_date string + Дата производства Задаётся в формате yyyy-MM-dd. Диапазон
товара из общих допустимых значений: от даты создания
сведениях о вводе документа минус пять лет по дату создания
товаров в оборот документа. Параметр указывается, если его
значение отличается от значения параметра
"production_date".
*uit_code string + Уникальный КИ При агрегации, осуществлённой до ввода в
оборот, необходимо указывать КИ агрегатов.
КИГУ и КИН не вводятся в оборот без
вложений
*uitu_code string - Уникальный Обязательный, если не указан "uit_code"
идентификатор

78
Параметр Тип Обяз. Описание Комментарий
транспортной
упаковки
*tnved_code string + Код товарной
номенклатуры (10
знаков)
*certificate_document string - Код вида документа Возможный значения:
обязательной CONFORMITY_CERTIFICATE – сертификат
сертификации соответствия;
CONFORMITY_DECLARATION – декларация
соответствия
*certificate_document_number string - Номер документа
обязательной
сертификации
*certificate_document_date string - Дата документа Задается в формате yyyy-MM-dd. Диапазон
обязательной даты, начиная с 2000-01-01 по дату создания
сертификации документа
*vsd_number string - Номер ВСД Указывается для ТГ "Молочная продукция",
обязательный, если в карточке НК
"veterinaryControl" = true. Номер ВСД,
указанный для КИ агрегата, передаётся всем
вложениям КИ агрегата

Пример тела документа в формате CSV

ИНН участника оборота,ИНН производителя,ИНН собственника,Дата производства,Тип
производственного заказа,Версия
1111111111,2222222222,3333333333,2019-01-01,Собственное производство,4
Параметры товаров
КИ,КИТУ,Дата производства,Код ТН ВЭД ЕАС товара,Вид документа подтверждающего
соответствие,Номер документа подтверждающего соответствие,Дата документа
подтверждающего соответствие,Идентификатор ВСД
"11111111111111111111111111111111111111",,2019-01-01,0000000000,Сертификат
соответствия,123,2019-01-01,1234-5678-910A-BDDE-FGHIJ-123A-45BC-1234

Пример тела документа в формате XML

<introduce_rf version="6">
<trade_participant_inn>1111111111</trade_participant_inn>
<producer_inn>2222222222</producer_inn>
<owner_inn>3333333333</owner_inn>
<production_date>2019-01-01</production_date>
<production_order>OWN_PRODUCTION</production_order>
<products_list>
<product>
<ki>0104630033880100211AREwAwLETM7g240ffd0</ki>
<production_date>2019-01-01</production_date>
<tnved_code>6401921000</tnved_code>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>2019-01-01</certificate_date>

79
 <vsd_number>9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091</vsd_number>
</product>
</products_list>
</introduce_rf>

4.2.5.2. Ввод в оборот. Полученных от физических лиц

Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Обувные товары", "Предметы одежды, белье постельное, столовое, туалетное и
кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
LK_INDI_COMMISSIONING Ввод в оборот. Полученных от физических лиц. JSON (MANUAL)
LK_INDI_COMMISSIONING_CSV Ввод в оборот. Полученных от физических лиц. CSV
LK_INDI_COMMISSIONING_XML Ввод в оборот. Полученных от физических лиц. XML

Пример тела документа в формате JSON:

{
"participant_inn": "1111111111",
"product_receiving_date": "2019-04-19T21:00:00.000Z",
"products_list": [
{
"uit": "12345678912345678912345678912345678912",
"product_receiving_date": "2019-04-19T21:00:00.000Z",
"productName": "test product name"
}, {
"uitu": "1111",
"children": [
{
"uit": "222"
}
]
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participant_inn string + ИНН участника,
осуществившего
эмиссию КИ
product_receiving_date string - Дата получения Задается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date- товара
time)
products_list array + Список товаров на

80
Параметр Тип Обяз. Описание Комментарий
ввод в оборот
*uit string - Уникальный КИ Обязательный, если не указан "uitu". КИ/КИН должны
быть со способом ввода в оборот "Принят на
комиссию от физического лица", см. "Справочник
"Типы эмиссии КИ"". КИГУ и КИН не вводятся в
оборот без вложений
*uitu string - Уникальный Обязательный, если не указан "uit"
идентификатор
транспортной
упаковки
*product_receiving_date date - Дата получения Параметр присутствует в запросе, если его значение
товара отличается от значения параметра
"product_receiving_date". Задается в формате yyyy-
MM-ddTHH:mm:ss.SSS’Z
productName string - Наименование товара

Примечание: вводимые в оборот КИ должны быть только с типом выпуска COMMISSION ("Принят
от физических лиц"), если pg = lp/shoes, если pg = perfumery/tires/electronics/bicycle/wheelchair, то тип
выпуска должен быть LOCAL ("Производство РФ").
Пример тела документа в формате CSV:
ИНН участника оборота,Дата получения товара,Версия
1111111111,12.04.2019,2
Параметры товаров
КИ,КИТУ,Дата получения товара
"000000000000000000000000000000000",,12.04.2019

Пример тела документа в формате XML:

<vvod_individuals action_id="5.3" version="3">
<trade_participant_inn>7731376812</trade_participant_inn>
<!-- Optional: -->
<product_receiving_date>25.12.2020</product_receiving_date>
<products_list>
<!-- 1 or more repetitions: -->
<product>
<!-- Optional: -->
<kit>00000000000000000000000000000</kit>
<product_receiving_date>25.12.2020</product_receiving_date>
</product>
</products_list>
</vvod_individuals>

4.2.5.3. Ввод в оборот. Производство вне ЕАЭС

Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Кресла-
коляски","Молочная продукция", "Предметы одежды, белье постельное, столовое, туалетное и
кухонное", "Упакованная вода".

81
При подаче сведений по документу "Ввод в оборот. Производство вне ЕАЭС" (LP_GOODS_IMPORT)
проверяется дата декларации на товары.
Документ обрабатывается через "Ввод в оборот. Производство вне ЕАЭС" (LP_GOODS_IMPORT) и
"Ввод в оборот. Импорт с ФТС" (LP_FTS_INTRODUCE), если дата декларации на товары в
документе "Ввод в оборот. Производство вне ЕАЭС" для: ТГ "Обувные товары" > = 2020-08-01; ТГ
"Духи и туалетная вода" > = 2020-10-01; ТГ "Фотокамеры (кроме кинокамер), фотовспышки и лампы-
вспышки" > = 2020-02-01; ТГ "Шины и покрышки пневматические резиновые и новые" > = 2020-03-
15;
Если дата декларации ранее указанной,то документ обрабатывается через "Ввод в оборот.
Производство вне ЕАЭС" (LP_GOODS_IMPORT).
Предварительная плановая дата перехода на документ Ввод в оборот. Импорт с ФТС
(LP_FTS_INTRODUCE) для ТГ "Предметы одежды, белье постельное, столовое, туалетное и
кухонное" - 1 мая 2021 года
Тип документа:

Тип Описание
LP_GOODS_IMPORT Ввод в оборот. Импорт. JSON (MANUAL)
LP_GOODS_IMPORT_CSV Ввод в оборот. Импорт. CSV
LP_GOODS_IMPORT_XML Ввод в оборот. Импорт. XML

Пример тела документа в формате JSON:

{
"participant_inn": "1111111111",
"declaration_date": "2019-01-01",
"declaration_number": "12345678/123456/1234567",
"customs_code": "12345678",
"decision_code": 10,
"products": [
{
"uit_code": "0104630033880100211AREwAwLETM7g240ffd0",
"tnved_code": "6401921000",
"certificate_document": "CONFORMITY_CERTIFICATE",
"certificate_document_number": "123",
"certificate_document_date": "2019-01-01",
"vsd_number": "9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091"
}
],
"pdfFile": "pdfContent"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participant_inn string + ИНН участника,
осуществившего

82
Параметр Тип Обяз. Описание Комментарий
эмиссию КИ
declaration_date string + Дата регистрации ДТ Задается в формате "yyyy.mm.dd"
declaration_number string + Регистрационный
номер ДТ
customs_code string + Код таможенного
органа
decision_code string + Код принятого Может принимать значения:
решения 10 - выпуск товаров разрешен;
11 - выпуск товаров при условии обеспечения
исполнения обязанности по уплате таможенных
пошлин;
12 - выпуск товаров с особенностями,
предусмотренными статьёй 121 ТК ЕАЭС;
13 - выпуск товаров с особенностями,
предусмотренными статьёй 122 ТК ЕАЭС;
14 - выпуск товаров с особенностями,
предусмотренными статьёй 123 ТК ЕАЭС;
20 - условный выпуск товаров
pdfFile string - Прикрепленный PDF
файл. В base64
products array + Список данных о КИ
для ввода в оборот
*certificate_document string - Код вида документа Возможный значения:
обязательной CONFORMITY_CERTIFICATE – сертификат
сертификации соответствия;
CONFORMITY_DECLARATION – декларация
соответствия
*certificate_document_number string - Номер документа
обязательной
сертификации
*certificate_document_date string - Дата документа Задается в формате "yyyy.mm.dd"
обязательной
сертификации
*tnved_code string + Код товарной
номенклатуры (10
знаков)
*uit_code string - Уникальный Обязательный, если не указан "uitu_code"
КИ/КИН
*uitu_code string - Уникальный Обязательный, если не указан "uit_code"
идентификатор
транспортной
упаковки
vsd_number string - Номер ВСД Указывается для ТГ "Молочная продукция",
обязательный, если в карточке НК
"veterinaryControl" = true). Номер ВСД, указанный
для КИ агрегата, передаётся всем вложениям КИ

83
Параметр Тип Обяз. Описание Комментарий
агрегата

Пример тела документа в формате CSV:

ИНН участника оборота,Дата регистрации ДТ,Регистрационный номер ДТ,Код таможенного
органа,Код принятого решения,Версия
1111111111,2019-01-01,12345678/123456/1234567,12345678,10,4
Параметры товаров
КИ,КИТУ,Вид документа подтверждающего соответствие,Номер документа подтверждающего
соответствие,Дата документа подтверждающего соответствие,Код ТН ВЭД ЕАС
товара,Идентификатор ВСД
"11111111111111111111111111111111111111",,Сертификат соответствия,123,2019-01-
01,1234567890,1234-5678-910A-BDDE-FGHIJ-123A-45BC-1234

Пример тела документа в формате XML:

<introduce_import version="4">
<trade_participant_inn>1111111111</trade_participant_inn>
<declaration_date>2019-01-01</declaration_date>
<declaration_number>12345678/123456/1234567</declaration_number>
<customs_code>12345678</customs_code>
<decision_code>10</decision_code>
<products_list>
<product>
<ki>0104630033880100211AREwAwLETM7g240ffd0</ki>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>2019-01-01</certificate_date>
<tnved_code>6401921000</tnved_code>
<vsd_number>9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091</vsd_number>
</product>
</products_list>
</introduce_import>

4.2.5.4. Ввод в оборот. Трансграничная торговля

Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Молочная продукция", "Обувные товары", "Предметы одежды, белье постельное,
столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
CROSSBORDER Ввод в оборот. Трансграничная торговля. JSON (MANUAL)
CROSSBORDER_CSV Ввод в оборот. Трансграничная торговля. CSV
CROSSBORDER_XML Ввод в оборот. Трансграничная торговля. XML

Пример тела документа в формате JSON:

84
{
"country_oksm": "112",
"exporter_name": "ООО Стильные шляпы",
"import_date": "2019-01-01",
"primary_document_date": "2019-01-01",
"primary_document_number": "123",
"products_list": [
{
"ki": "0104630033880100211AREwAwLETM7g240ffd0",
"certificate_date": "2019-01-01",
"certificate_number": "123",
"certificate_type": "CONFORMITY_CERTIFICATE",
"tnved_code": "6401921000",
"cost": 1000,
"vat_value": 0,
"vsd_number": "9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091"
}
],
"sender_tax_number": "2222222222",
"trade_participant_inn": "1111111111"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

country_oksm string + Код страны экспортера Числовой код длиной 3 символа из ОКСМ:
112 – Белоруссия;
417 – Киргизия;
398 – Казахстан;
051 – Армения
exporter_name string + Наименование
экспортёра
import_date string + Дата импорта Задаётся в формате yyyy-mm-dd
primary_document_date string + Дата первичного Задается в формате yyyy-MM-dd
документа,
подтверждающего
перемещение товара
primary_document_number string + Номер первичного
документа,
подтверждающего
перемещение товара
products_list array + Список сведений о
товарах
*certificate_date string - Дата документа, Задается в формате yyyy-mm-dd. Диапазон даты,
(date) подтверждающего начиная с 2000-01-01 по дату создания
соответствие документа
*certificate_number string - Номер документа
обязательной
сертификации

85
Параметр Тип Обяз. Описание Комментарий
*certificate_type string - Тип документа, Возможные значения:
подтверждающего CONFORMITY_CERTIFICATE – сертификат
соответствие соответствия;
CONFORMITY_DECLARATION – декларация
соответствия
*cost integer - Цена за единицу Стоимость указывается в копейках
*ki string - Уникальный КИ Обязательный, если не указан "kitu". КИГУ и
КИН не вводятся в оборот без вложений
*kitu string - Уникальный Обязательный, если не указан "ki"
идентификатор
транспортной упаковки
*tnved_code string + Код товарной
номенклатуры (10
знаков)
*vat_value integer - Сумма НДС Стоимость указывается в копейках
*vsd_number string - Номер ВСД Указывается для ТГ "Молочная продукция",
обязательный, если в карточке НК
"veterinaryControl" = true. Номер ВСД, указанный
для КИ агрегата, передаётся всем вложениям КИ
агрегата
sender_tax_number string + Номер
налогоплательщика
отправителя
trade_participant_inn string + ИНН участника,
осуществившего
эмиссию КИ

Пример тела документа в формате CSV:

ИНН участника оборота,Номер налогоплательщика отправителя,Наименование экспортера,Код
страны,Дата импорта,Номер первичного документа подтверждающего перемещение товара,Дата
первичного документа подтверждающего перемещение товара,Идентификатор ВСД,Версия
1111111111,2222222222,ООО XXX,112,2020-12-12,123,2020-12-03,,3
Параметры товаров
КИ,КИТУ,Код ТН ВЭД ЕАС товара,Цена за единицу,Сумма НДС,Вид документа подтверждающего
соответствие,Номер документа подтверждающего соответствие,Дата документа
подтверждающего соответствие,Идентификатор ВСД
"010464004346182421F-JBQyiMcgRS,",,0000000000,,,,,,

При заполнении документа в формате CSV поле "Идентификатор ВСД" в первой строке должно
оставаться незаполненным (правило действует для всех товарных групп).
Пример тела документа в формате XML:
<introduce_crossborder version="3">
<trade_participant_inn>1111111111</trade_participant_inn>
<sender_tax_number>2222222222</sender_tax_number>
<exporter_name>ООО Стильные шляпы</exporter_name>

86
 <country_oksm>112</country_oksm>
<import_date>2019-01-01</import_date>
<primary_document_number>123</primary_document_number>
<primary_document_date>2019-01-01</primary_document_date>
<products_list>
<product>
<ki>0104630033880100211AREwAwLETM7g240ffd0</ki>
<tnved_code>6401921000</tnved_code>
<cost>1000</cost>
<vat_value>0</vat_value>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>2019-01-01</certificate_date>
<vsd_number>9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091</vsd_number>
</product>
</products_list>
</introduce_crossborder>

4.2.5.5. Ввод в оборот. На территории стран ЕАЭС (контрактное производство)

Создание документа доступно только для ТГ «Молочная продукция». Создание документа доступно
только для КИ с типом эмиссии FOREIGN (ввезен в РФ) и CROSSBORDER (ввезен в РФ из стран
ЕАЭС).
Тип документа:

Тип Описание
LP_INTRODUCE_GOODS_CROSSBORDER_CSD Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). JSON (MANUAL)
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_CSV Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). CSV
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_XML Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). XML

Пример тела документа в формате JSON:

{
"country_oksm": "112",
"exporter_name": "ООО Стильные шляпы",
"import_date": "2019-01-01",
"primary_document_date": "2019-01-01",
"primary_document_number": "123",
"vsd_number": "9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1092",
"products_list": [
{
"ki": "0104630033880100211AREwAwLETM7g240ffd0",
"certificate_date": "2019-01-01",
"certificate_number": "123",
"certificate_type": "CONFORMITY_CERTIFICATE",
"tnved_code": "6401921000",
"cost": 1000,
"vat_value": 0,
"vsd_number": "9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091"

87
 }
],
"sender_tax_number": "2222222222",
"trade_participant_inn": "1111111111"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

country_oksm string + Код страны экспортера Числовой код длиной 3 символа из ОКСМ:
112 – Белоруссия;
417 – Киргизия;
398 – Казахстан;
051 – Армения
exporter_name string + Наименование
экспортёра
import_date string + Дата импорта Задаётся в формате yyyy-MM-dd
primary_document_date string + Дата первичного Задаётся в формате yyyy-MM-dd
документа,
подтверждающего
перемещение товара
primary_document_number string + Номер первичного
документа,
подтверждающего
перемещение товара
vsd_number string - Номер ВСД Указывается для ТГ "Молочная продукция",
(обязательный, если в карточке НК
"veterinaryControl" = true). Номер ВСД,
указанный для КИ агрегата, передаётся всем
вложениям КИ агрегата
products_list array + Список сведений о
товарах
*certificate_date string - Дата документа, Задаётся в формате yyyy-MM-dd
(date) подтверждающего
соответствие
*certificate_number string - Номер документа
обязательной
сертификации
*certificate_type string - Тип документа, Возможные значения:
подтверждающего CONFORMITY_CERTIFICATE – сертификат
соответствие соответствия;
CONFORMITY_DECLARATION – декларация
соответствия
*ki string - Уникальный КИ Обязательный, если не указан "kitu". КИГУ и
КИН не вводятся в оборот без вложений
*kitu string - Уникальный Обязательный, если не указан "ki"
идентификатор
транспортной упаковки

88
Параметр Тип Обяз. Описание Комментарий
*tnved_code string + Код товарной
номенклатуры (10
знаков)
*vsd_number string - Номер ВСД Указывается для ТГ "Молочная продукция",
обязательный, если в карточке НК
"veterinaryControl" = true.
sender_tax_number string + Номер
налогоплательщика
отправителя
trade_participant_inn string + ИНН участника,
осуществившего
эмиссию КИ

Пример тела документа в формате CSV:

ИНН участника оборота,Номер налогоплательщика отправителя,Наименование экспортера,Код
страны,Дата импорта,Номер первичного документа подтверждающего перемещение товара,Дата
первичного документа подтверждающего перемещение товара,Идентификатор ВСД,Версия
1111111111,2222222222,ООО Название,112,2019-01-01,123,2019-01-01,1234-5678-910A-BDDE-
FGHIJ-123A-45BC-1234,3
Параметры товаров
КИ,КИТУ,Код ТН ВЭД ЕАС товара,Цена за единицу,Сумма НДС,Вид документа подтверждающего
соответствие,Номер документа подтверждающего соответствие,Дата документа
подтверждающего соответствие,Идентификатор ВСД
"00000000000000000000000000000000000000",,1234567890,1000,0,Сертификат
соответствия,123,2019-01-01,1234-5678-910A-BDDE-FGHIJ-123A-45BC-1234

Пример тела документа в формате XML:

<introduce_crossborder version="3">
<trade_participant_inn>1111111111</trade_participant_inn>
<sender_tax_number>2222222222</sender_tax_number>
<exporter_name>ООО Название</exporter_name>
<country_oksm>112</country_oksm>
<import_date>2019-01-01</import_date>
<primary_document_number>123</primary_document_number>
<primary_document_date>2019-01-01</primary_document_date>
<vsd_number>9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091</vsd_number>
<products_list>
<product>
<ki>0000000000000000000FFFFFFFFFFFFFFFFFFF</ki>
<tnved_code>1234567890</tnved_code>
<cost>1000</cost>
<vat_value>0</vat_value>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>2019-01-01</certificate_date>
<vsd_number>9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091</vsd_number>
</product>
</products_list>
</introduce_crossborder>

89
4.2.5.6. Ввод в оборот. Маркировка остатков
Создание документа доступно для товарных групп "Духи и туалетная вода", "Обувные товары",
"Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки
пневматические резиновые новые".
Плановая дата отключения возможности создания документа для единиц товаров, описанных в КМТ
по полному атрибутивному составу для товарной группы "Обувные товары" - 16.06.2021.
Тип документа:

Тип Описание
LP_INTRODUCE_OST Ввод в оборот. Маркировка остатков. JSON (MANUAL)
LP_INTRODUCE_OST_CSV Ввод в оборот. Маркировка остатков. CSV
LP_INTRODUCE_OST_XML Ввод в оборот. Маркировка остатков. XML

Пример тела документа в формате JSON:

{
"products_list": [
{
"certificate_date": "2020-01-23",
"certificate_number": "string",
"certificate_type": "string",
"country": "string",
"declaration_date": "2020-01-23",
"declaration_number": "string",
"ki": "string",
"kitu": "string"
}
],
"trade_participant_inn": "string"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

trade_participant_inn string + ИНН участника,
осуществившего
эмиссию КИ
products_list array + Список сведений о
товарах
*certificate_date string(date) - Дата документа Формат: yyyy-MM-dd
обязательной
сертификации
*certificate_number string - Номер документа
обязательной
сертификации

90
Параметр Тип Обяз. Описание Комментарий
*certificate_type string - Тип документа, Вид документа обязательной сертификации:
подтверждающего CONFORMITY_CERTIFICATE – Сертификат
соответствие соответствия;
CONFORMITY_DECLARATION – Декларация о
соответствии
*country string - Страна производства Указывается код страны в соответствии с ОКСМ.
Например: 112 – Республика Беларусь
*declaration_date string - Дата регистрации ДТ Формат: yyyy-MM-dd. Диапазон даты начиная с 2000-
01-01 по дату создания документа
*declaration_number string - Регистрационный
номер ДТ
*ki string - КИ Обязательный, если не указан "kitu". КИГУ и КИН не
вводятся в оборот без вложений
*kitu string - КИТУ Обязательный, если не указан "ki". В текущей
реализации заполнение данного параметра для
товарных групп "Обувные товары" и "Предметы
одежды, бельё постельное, столовое, туалетное и
кухонное" недоступно

Примечание:
• количество КИ, указанных в одном документе, не должно превышать 5000;
• в текущей реализации заполнение параметра "kitu" (КИТУ) в документах недоступно для
товарных групп "Обувные товары" и "Предметы одежды, бельё постельное, столовое, туалетное
и кухонное".
Пример тела документа в формате CSV
ИНН участника оборота,Версия
1111111111,2
Параметры товаров
КИ,КИТУ,Страна производства,Дата регистрации ДТ,Регистрационный номер
ДТ,Вид документа подтверждающего соответствие,Номер документа
подтверждающего соответствие,Дата документа подтверждающего соответствие
"00000000000000000000000000000",,111,12.04.2019,123456,Сертификат
соответствия,123456,12.04.2019

Пример тела документа в формате XML

<?xml version="1.0" encoding="UTF-8"?>
<vvod_ostatky version="2" action_id="5.4">
<trade_participant_inn>1111111111</trade_participant_inn>
<products_list>
<product>
<ki>00000000000000FFFFFFFFFFFFFFF</ki>
<country>111</country>
<declaration_date>12.04.2019</declaration_date>
<declaration_number>123456</declaration_number>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>

91
 <certificate_number>123456</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
</products_list>
</vvod_ostatky>

4.2.5.7. Ввод в оборот. Контрактное производство РФ

Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Молочная продукция", "Обувные товары", "Предметы одежды, белье постельное,
столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
LK_CONTRACT_COMMISSIONING Ввод в оборот. Контрактное производство РФ. JSON (MANUAL)
LK_CONTRACT_COMMISSIONING_CSV Ввод в оборот. Контрактное производство РФ. CSV
LK_CONTRACT_COMMISSIONING_XML Ввод в оборот. Контрактное производство РФ. XML

Пример тела документа в формате JSON:

{
"producer_inn": "1111111111",
"owner_inn": "2222222222",
"production_date": "2019-01-01",
"production_order": "CONTRACT_PRODUCTION",
"products_list": [
{
"uit": "0104630033880100211AREwAwLETM7g240ffd0",
"tnved_code": "6401921000",
"production_date": "2019-01-01",
"certificate_doc_type": "CONFORMITY_CERTIFICATE",
"certificate_doc_number": "123",
"certificate_doc_date": "2019-01-01",
"vsd_number": "9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091"
}
],
"owner": true,
"producer": false
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

producer_inn string + ИНН производителя
товара
owner_inn string + ИНН собственника
товара
production_date string + Дата производства Задаётся в формате yyyy-mm-dd. Диапазон

92
Параметр Тип Обяз. Описание Комментарий
товара допустимых значений: от даты создания
документа минус пять лет по дату создания
документа
production_order string + Тип производственного CONTRACT_PRODUCTION – Производство
заказа товара по договору
owner boolean + Признак "Я Если "producer" = true, то поле = false
собственник"
producer boolean + Признак "Я Если "owner" = true, то поле = false
производитель"
products_list [string] + Список товаров для
ввода в оборот
*certificate_doc_date string - Дата документа Задаётся в формате yyyy-mm-dd. Диапазон даты,
обязательной начиная с 2000-01-01 по дату создания документа
сертификации
*certificate_doc_type string - Код типа документа Возможные значения:
обязательной CONFORMITY_CERTIFICATE – сертификат
сертификации соответствия;
CONFORMITY_DECLARATION – декларация
соответствия
*certificate_doc_number string - Номер документа
обязательной
сертификации
*production_date string + Дата производства Задаётся в формате yyyy-mm-dd. Диапазон
товара из общих допустимых значений: от даты создания
сведений о вводе документа минус пять лет по дату создания
товаров в оборот документа
*tnved_code string + Код товарной
номенклатуры (10
знаков)
*uit string - Уникальный КИ Обязательный, если не указан "uitu". КИГУ и КИН
не вводятся в оборот без вложений
*uitu string - Уникальный Обязательный, если не указан "uit"
идентификатор
транспортной упаковки
*vsd_number string - Номер ВСД Указывается для ТГ "Молочная продукция",
обязательный, если в карточке НК
"veterinaryControl" = true. Номер ВСД, указанный
для КИ агрегата, передаётся всем вложениям КИ
агрегата

Пример тела документа в формате CSV

ИНН производителя или импортера,ИНН собственника,Дата производства,Тип
производственного заказа,Версия
1111111111,2222222222,2019-01-01,Контрактное производство,3
Параметры товаров

93
КИ,КИТУ,Код ТН ВЭД ЕАЭС товара,Дата производства,Вид документа подтверждающего
соответствие,Номер документа подтверждающего соответствие,Дата документа
подтверждающего соответствие,Идентификатор ВСД
"00000000000000000000000000000000000000",,1234567890,2019-01-01,Сертификат
соответствия,123,2019-01-01,1234-5678-910A-BDDE-FGHIJ-123A-45BC-1234

Пример тела документа в формате XML

<?xml version="1.0" encoding="UTF-8"?>
<introduce_contract version="4">
<producer_inn>1111111111</producer_inn>
<owner_inn>2222222222</owner_inn>
<production_date>2019-01-01</production_date>
<production_order>CONTRACT_PRODUCTION</production_order>
<products_list>
<product>
<ki>0104630033880100211AREwAwLETM7g240ffd0</ki>
<production_date>2019-01-01</production_date>
<tnved_code>6401921000</tnved_code>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>2019-01-01</certificate_date>
<vsd_number>9DDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091</vsd_number>
</product>
</products_list>
</introduce_contract>

4.2.5.8. Ввод в оборот. Импорт с ФТС

Создание документа доступно для ТГ "Духи и туалетная вода", "Молочная продукция", "Обувные
товары", "Предметы одежды, бельё постельное, столовое, туалетное и кухонное", "Фотокамеры
(кроме кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки пневматические
резиновые новые".
При подаче сведений по документу "Ввод в оборот. Производство вне ЕАЭС" (LP_GOODS_IMPORT)
проверяется дата декларации на товары. Документ обрабатывается через "Ввод в оборот.
Производство вне ЕАЭС" (LP_GOODS_IMPORT) и "Ввод в оборот. Импорт с ФТС"
(LP_FTS_INTRODUCE), если дата декларации на товары в документе "Ввод в оборот. Производство
вне ЕАЭС" для:
ТГ "Обувные товары" >= 2020-08-01; ТГ "Духи и туалетная вода" >= 2020-10-01; ТГ "Предметы
одежды, бельё постельное, столовое, туалетное и кухонное" >= 2020-12-01
Если дата декларации ранее указанной,то документ обрабатывается через "Ввод в оборот.
Производство вне ЕАЭС" (LP_GOODS_IMPORT).
Тип документа:

Тип Описание
LP_FTS_INTRODUCE Ввод в оборот. Импорт с ФТС. JSON (MANUAL)
LP_FTS_INTRODUCE_CSV Ввод в оборот. Импорт с ФТС. CSV
LP_FTS_INTRODUCE_XML Ввод в оборот. Импорт с ФТС. XML

94
Пример тела документа в формате * .json для подачи сведений участниками оборота товара
товарной группы "Молочная продукция"
{
"trade_participant_inn":"7777777777",
"declaration_number":"80333030/130521/0000401",
"declaration_date":"2021-05-13",
"production_date":"2021-05-13",
"products_list":[
{
"ki":"0104640043460018215HdKYX",
"production_date":"2021-05-13",
"vsd_number":"5b5ff835-6da9-4b24-b9e9-3367387e408a"
},
{
"kitu":"100000000000000000000050",
"production_date":"2021-05-13",
"children":[
{
"ki":"0104640043460018215Q02Xd",
"production_date":"2021-05-13",
"vsd_number":"5b5ff835-6da9-4b24-b9e9-3367387e408a"
}
]
},
{
"atk":"00773137681221051308qltMZ",
"production_date":"2021-05-13",
"children":[
{
"ki":"01046400434600182154p3Gc",
"production_date":"2021-05-13",
"vsd_number":"5b5ff835-6da9-4b24-b9e9-3367387e408a"
}
]
}
]
}

Пример тела документа в формате * .json для подачи сведений участниками оборота товаров
других товарных групп:
{
"trade_participant_inn":"000000000",
"declaration_number":"11111111/222222/3333333",
"declaration_date":"2020-03-01",
"products_list":[
{
"cis":"0077242112882001010200001",
"packType":"UNIT",
"color":"RED",
"productSize":"20.5"
},
{
"cis":"000000000000000001",
"packType":"LEVEL1",

95
 "color":"RED",
"productSize":"20.5",
"children":[
{
"cis":"00000000000000000000000000000000000001",
"packType":"UNIT",
"color":"RED",
"productSize":"20.5"
}
]
},
{
"cis":"00000000000000000000000000000000000004",
"packType":"ATK",
"color":"RED",
"productSize":"20.5",
"children":[
{
"cis":"000000000000000001",
"packType":"UNIT",
"color":"RED",
"productSize":"20.5"
}
]
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

trade_participant_inn string + ИНН участника
оборота товаров
declaration_number string + Регистрационный Формат: XXXXXXXX/XXXXXX/XXXXXXX (23
номер ДТ числовых символа (8, 6 и 7) разделённых символом "/"
declaration_date string(9- + Дата регистрации Формат: YYYY-MM-DD. Диапазон даты: с 01.01.2000 по
14) ДТ дату создания документа. Соответствует значению
параметра "declaration_number" ("Регистрационный номер
ДТ")
production_date string - Дата производства Формат: YYYY-MM-DD. Диапазон даты: от даты
товара создания документа минус пять лет по дату создания
документа. Параметр заполняется только для товарной
группы "Молочная продукция"
products_list string + Массив,
содержащий список
кодов для ввода в
оборот
*cis string + КИ ("ki"),КИТУ При указании КИ, входящего в состав агрегата, агрегат
("kitu") или АТК автоматически расформировывается
("atk")
*packType string - Тип упаковки Возможные значения: UNIT - КИ;

96
Параметр Тип Обяз. Описание Комментарий
LEVEL1-99 - КИТУ;
АТК - агрегированный таможенный код
*color string - Цвет Указывается значение цвета, содержащее от 1 до 1024
буквенных символа на английском или русском языке.
Поле необязательное для заполнения. Параметр
заполняется только в документах для товарной группы
"Обувные товары"
*productSize string - Размер обуви Указывается значение размера обувных товаров,
содержащее от 1 до 1024 буквенных символа, на
английском или русском языке (например: 37RUS/6US).
Возможно указание одного размера, указание диапазона
размеров недоступно. Параметр заполняется только для
товарной группы "Обувные товары"
*children array - Массив, Для товарной группы "Молочная продукция" указываются
содержащий список все КИ агрегатов (КИТУ), имеющие признак
вложенных КИ подконтрольности в карточке товара КМТ
*vsd_number string - Номер ВСД Параметр заполняется только для товарной группы
"Молочная продукция". Параметр обязательный, если в
карточке товара КМТ указан признак подконтрольности
("veterinaryControl" = true).
Ввод в оборот агрегата с признаком подконтрольности
ВСД:
* признак подконтрольности = false: можно указать только
агрегат и не указывать все вложения; * признак
подконтрольности = true: обязательно указывать агрегат и
все его вложения; * признак подконтрольности
смешанный (true/false): обязательно указать агрегат и все
вложения, у которых признак подконтрольности = true
*production_date string - Дата производства Параметр заполняется только для товарной группы
товара "Молочная продукция". Формат: YYYY-MM-DD.
Диапазон даты: от даты создания документа минус пять
лет по дату создания документа. Значение данного
параметра при обработке документа имеет более высокий
приоритет, чем значение параметра "production_date"
("Дата производства товара"), указанного вне массива
"products_list" ("Массив, содержащий список кодов для
ввода в оборот")

Пример тела документа в формате * .csv для подачи сведений участниками оборота товаров
других товарных групп
ИНН участника,Регистрационный номер ДТ,Дата регистрации ДТ,Дата производства,Версия
7777777777,80333030/060521/0000407,06.05.2021,06.05.2021,2
Параметры товаров
АТК,КИ,КИТУ,Цвет,Размер,Дата производства,ВСД
,"0104640043460018215GFjKV",,,,06.05.2021,

Примечание по заполнению документов в формате * .csv и * .xml:

97
• параметры "Цвет" и "Размер" в документе в формате * .csv заполняются только для товарной
группы "Обувные товары". Параметры "Дата производства" и "ВСД" в документе в формате *
.csv заполняются только для товарной группы "Молочная продукция". При подаче сведений
участниками оборота товаров других товарных групп данные поля игнорируются (должны
оставаться незаполненными);
• для csv существует ограничение по одновременному указанию агрегата и всех вложений с
признаком подконтрольности = true: для ввода в оборот агрегата необходимо указать все
вложения (без указания агрегата).
Пример тела документа в формате * .xml для подачи сведений участниками оборота товара
товарной группы "Молочная продукция"
<?xml version="1.0" encoding="UTF-8"?>
<introduce_import_fts version="3">
<trade_participant_inn>7777777777</trade_participant_inn>
<declaration_number>80333030/120521/0000407</declaration_number>
<declaration_date>2021-05-12</declaration_date>
<production_date>2021-05-12</production_date>
<products_list>
<product>
<ki>0104640043460018215-DolY</ki>
<production_date>2021-05-12</production_date>
<vsd_number>5b5ff835-6da9-4b24-b9e9-3367387e408a</vsd_number>
</product>
<product>
<kitu>100000000000000000000028</kitu>
<children>
<product>
<ki>0104640043460018215f/KOM</ki>
<vsd_number>5b5ff835-6da9-4b24-b9e9-3367387e408a</vsd_number>
</product>
</children>
</product>
<product>
<atk>00773137681221050508OjJpR</atk>
<children>
<product>
<ki>0104640043460018215klHO*</ki>
<production_date>2021-05-12</production_date>
<vsd_number>5b5ff835-6da9-4b24-b9e9-3367387e408a</vsd_number>
</product>
</children>
</product>
</products_list>
</introduce_import_fts>

Пример тела документа в формате * .xml для подачи сведений участниками оборота товаров
других товарных групп
<introduce_import_fts version="3">
<trade_participant_inn>7777777777</trade_participant_inn>
<declaration_number>11111111/222222/3333333</declaration_number>
<declaration_date>2020-03-01</declaration_date>
<products_list>

98
 <product>
<ki>11111111111111111111111111111111111111</ki>
<color>RED</color>
<product_size>20.511111111111111111111111zzz</product_size>
</product>
<product>
<ki>22222222222222222222222222222222222222</ki>
<color>RED</color>
<product_size>20.5</product_size>
</product>
<product>
<kitu>333333333333333333</kitu>
<color>RED</color>
<product_size>20.5</product_size>
<children>
<product>
<ki>00000000000000000000000000000000000001</ki>
<color>RED</color>
<product_size>20.5</product_size>
</product>
</children>
</product>
<product>
<atk>4444444444444444444444444</atk>
<color>RED</color>
<product_size>20.5</product_size>
<children>
<product>
<ki>00000000000000000000000000000000000002</ki>
<color>RED</color>
<product_size>20.5</product_size>
</product>
</children>
</product>
</products_list>
</introduce_import_fts>

4.2.5.8.1. Декларация на товары

Документ "Декларация на товары" (ДТ) поступает в ГИС МТ от ФТС России после подачи
участником оборота товаров сведений в документах "Ввод в оборот. Импорт с ФТС" или "Ввод в
оборот. Производство вне ЕАЭС" (при взаимодействии с ФТС). Подача документа "Декларация на
товары" в ГИС МТ участником оборота товаров через API не осуществляется.
ФТС осуществляет проверку по каждому КИ (построчно): если код решения ФТС по ДТ = 00, иначе
решение принимается по всей ДТ. Код решения по КИ имеет более высокий приоритет (исключение
составляет отсутствие решения на уровне всех КИ). При положительном решении ФТС
осуществляется ввод КИ в оборот. При отрицательном решении ФТС ввод КИ в оборот не
производится.
Тип документа:

99
Тип Описание
LP_FTS_INTRODUCE_RESPONSE Декларация на товары. JSON (MANUAL)

Пример тела документа в формате JSON

{
"info": {
"requestId":"ca37055a-b2ca-4812-ad8f-c56ecd26b8cd",
"requestTimestamp": "2020-12-25T07:28:06.017Z",
"status":"MESSAGE_PROCESSED",
"direction": "TO_SMEV",
"urn": "urn://x-artefacts-ftsGoodsReleaseInfoMultipurpose/root/1.0.1",
"urnVersion": "1.0.2",
"participantId":"7724211288",
"productGroupIdList": [
2
],
"documentId":"e8b98e14-335b-45a4-8f94-71f8ea7ffc07",
"declarationNumber": "10013160/111220/0719609"
},
"content": {
"responseId":"c981ed21-3c48-432a-8001-41bc70b324f6",
"responseTimestamp": "2020-12-25T10:28:00.000Z",
"resultCode":"Ok",
"resultDetails":"Сообщение успешно обработано",
"documentModeID":"1009269E",
"direction":"ИМ",
"ftsDecisionCode": "10",
"ftsDecisionTimestamp": "2020-12-14T00:00:00.000Z",
"customsCode": "10013160",
"goodsDeclarationDate": "2020-12-13",
"goodsDeclarationRegistrationNumber": "10013160/111220/0719609",
"customsProcedureCode": "40",
"senderName": "TEMPE, S.A.",
"senderCountryCode": "ES",
"senderCountryName": "ИСПАНИЯ",
"receiverName": "АО \"X\"",
"receiverInn": "7777777777",
"declarantName": "АО \"X\"",
"declarantInn": "7777777777",
"declarantKpp": "770301001",
"declarationId":"6a1ac75c-2981-4806-882d-d3d3dbdcd9c5",
"declarationDate": "2020-12-14",
"attachment": {
"codeDocument": "001",
"fileName": "file.zip",
"originalFileName": "file.xml",
"originalFileMimeType": "text/xml",
"unstructuredFormat": false,
"zippedPacket": true
},
"markedProducts": [
{
"type": "FtsDeclarationMarkedProductDto",

100
 "grossWeight": "7.377",
"netWeight": "5.23",
"tnVed": "6403919800",
"currencyCodeInContract": "RUB",
"customsProductPrice": "20968.36",
"statisticalProductPrice": "286.77",
"productPrice": "20968.36",
"productionCountryCode": "CN",
"productAmountInExtraUnitMeasure": "0.0",
"extraUnitMeasureName": "715",
"extraUnitMeasureCode": "715",
"productNameInDeclaration": [
"ОБУВЬ, ЗАКРЫВАЮЩАЯ ЛОДЫЖКУ, С ДЛИНОЙ СТЕЛЬКИ 24 СМ И БОЛЕЕ,
ЖЕНСКАЯ НА ПОДОШВЕ ИЗ РЕЗИНЫ, ПЛАСТМАССЫ И С ВЕРХОМ ИЗ НАТУРАЛЬНОЙ КОЖИ"
],
"productNumberInDeclaration": 1,
"productAmountInDeclaration": 4,
"approvDocList": [
{
"approvementDocumentNumber": "123899",
"approvementDocumentDate": "2020-03-27"
}
],
"ftsDecisionCode": "10",
"ftsDecisionTimestamp": "2020-12-14T00:00:00.000Z",
"vat": "1159524.00",
"cisInfoList": [
{
"markingLevelType": "CIS",
"cisDtoList": [
{
"cisIntId": "00",
"cis": "010461605254305221+NtUS6M&H\"Jwu"
},
{
"cisIntId": "00",
"cis": "010462007437882121-S?IJUYN<!PC>"
},
{
"cisIntId": "00",
"cis": "010462007437880421Y58FJPH01IOXR"
},
{
"cisIntId": "00",
"cis": "010462007437869721'F1<FCUHN1GSS"
}
]
}
]
}
]
}
}

Параметры документа:

101
 Обя
Параметр Тип з. Описание Комментарий
info array + Ответ
таможенного
ораган на запрос о
предоставлении
сведений о
выпущенных
товарах
*requestId string + Уникальный
идентификатор
исходного
документа
*requestTimestamp string + Дата и время Формат: 2020-12-25T07:28:06.017Z
(date-time) запроса
*status string + Статус обработки Возможные значения (финальные статусы):
документа
ERROR - ошибка обработки запроса в СМЭВ;
MESSAGE_PROCESSED - запрос обработан
успешно.
*direction string + Направление Возможные значения:
перемещения
FROM_SMEV - запросы, полученные от СМЭВ;
документа
TO_SMEV - запросы, направленные в СМЭВ.
*participantId string + ID участника
оборота товаров,
отправителя
документа "Ввод
в оборот. Импорт
с ФТС" или "Ввод
в оборот.
Производство вне
ЕАЭС"
*productGroupIdList array[integ + Массив кодов См. "Справочник "Список поддерживаемых
er] товарных групп товарных групп""
*documentId string + ID документа в Данный параметр заполняется ID документа
ГИС МТ, для "Ввод в оборот. Импорт с ФТС"
обработки
которого
необходим запрос
к ФТС
*declarationNumber string + Регистрационный Формат: 10013160/111220/0719609
номер ДТ из
документа "Ввод
в оборот. Импорт
с ФТС"
content array + Данные
декларации на
товары,
полученной от

102
 Обя
Параметр Тип з. Описание Комментарий
ФТС
*responseId string + Уникальный ID
ответа
таможенного
органа
*responseTimestamp string + Дата и время Формат: 2020-12-25T07:28:06.017Z
запроса
*resultCode string - Код обработки
запроса
*resultDetails string - Текстовое
сообщение о
результате
обработки запроса
*documentModeID string + ID вида
документа
*direction string + Направление Возможные значения:
перемещения "ИМ" - Импорт;
товара "ЭК" - Экспорт
*ftsDecisionCode string + Код решения Действие общего кода по ДТ распространяется
таможенного на все коды внутри ДТ. Код решения по ДТ
органа анализируется в следующих случаях:
* параметр "ftsDecisionCode" отсутствует в
составе массива "markedProducts" во всех
строках; * параметр "ftsDecisionCode" в составе
массива "markedProducts" = NULL; * параметр
"ftsDecisionCode" в составе массива
"markedProducts" = "".
Действие решения на уровне ДТ
распространяется на все КИ внутри ДТ. В ходе
обработки документа производится анализ и
изменение статусов только тех КИ, которые
перечисленные в документе "Ввод в оборот.
Импорт с ФТС" или "Ввод в оборот.
Производство вне ЕАЭС". Если в ДТ указаны
КИ, которые отсутствуют в документе "Ввод в
оборот. Импорт с ФТС" или "Ввод в оборот.
Производство вне ЕАЭС", то данные КИ
игнорируются.
Допустимые значения:
Код положительного решения ФТС:
10 - Выпуск товаров разрешён;
11 - Выпуск товаров при условии обеспечения
исполнения обязанности по уплате таможенных
пошлин, налогов, специальных,
антидемпинговых, компенсационных пошлин,
за исключением выпуска товаров,

103
 Обя
Параметр Тип з. Описание Комментарий
поименованного в позициях с кодами 12 и 13;
12 - Выпуск товаров с особенностями,
предусмотренными статьей 121 Таможенного
кодекса Евразийского экономического союза;
13 - Выпуск товаров с особенностями,
предусмотренными статьей 122 Таможенного
кодекса Евразийского экономического союза;
14 - Выпуск товаров с особенностями,
предусмотренными статьей 123 Таможенного
кодекса Евразийского экономического союза;
20 - Условный выпуск товаров.
Статус КИ меняется на "INTRODUCED"
("Введён в оборот"). Особое состояние КИ
сбрасывается (см. "Справочник "Статусы КИ"").
Статус документа "Ввод в оборот. Импорт с
ФТС" меняется на "CHECKED_OK"
("Обработан"). Статус документа "Декларация
на товары" меняется на "CHECKED_OK"
("Обработан").
Код отрицательного решения:
40 - Таможенная декларация отозвана до
выпуска товаров;
50 - Выпуск товаров аннулирован при отзыве
таможенной декларации в случаях,
предусмотренных пунктами 4 - 6 статьи 113 или
пунктом 9 статьи 116 Таможенного кодекса
Евразийского экономического союза;
51 - Выпуск товаров аннулирован в случае,
предусмотренном пунктом 10 статьи 116
Таможенного кодекса Евразийского
экономического союза;
52 - Выпуск товаров аннулирован по
мотивированному обращению декларанта в
случаях, определённых в соответствии с
абзацем вторым пункта 4 статьи 118
Таможенного кодекса Евразийского
экономического союза;
60 - Срок выпуска товаров приостановлен;
61 - Срок приостановления срока выпуска
товаров продлён;
62 - Приостановление срока выпуска товаров
отменено;
70 - Срок выпуска товаров продлён;
82 - Таможенная декларация считается не
поданной;
90 - Отказано в выпуске товаров;

Статус КИ не изменяется. Особое состояние КИ

меняется на "FTS_RESPOND_NOT_OK"
("Отрицательное решение ФТС") (см.

104
 Обя
Параметр Тип з. Описание Комментарий
"Справочник "Статусы КИ""). Статус документа
"Ввод в оборот. Импорт с ФТС" меняется на
"CHECKED_OK" ("Обработан"). Cтатус
документа "Декларация на товары" меняется на
"CHECKED_OK" ("Обработан").
Невалидный/отсутствует, но имеется хотя бы в
одной другой строке/не найден в
классификаторе:
92 - Иное решение, предусмотренное
законодательством государств-членов
Евразийского экономического союза;
00 - Различно по товарам; не найден в
классификаторе; NULL - отсутствует значение.
Статус КИ не изменяется. Особое состояние КИ
возвращается к первоначальному
"FTS_CONTROL"/FTS_RESPOND_NOT_OK"/N
ULL ("На контроле ФТС"/"Отрицательное
решение ФТС"/" ") (см. "Справочник "Статусы
КИ""). Статус документа "Ввод в оборот.
Импорт с ФТС" меняется на "Обработан с
ошибкой". Cтатус документа "Декларация на
товары" меняется на "Обработан с ошибкой".
Если параметр "ftsDecisionCode" ("Код
принятого решения") принимает значение "00"
("Различно по товарам"), то "ftsDecisionCode"
("Код принятого решения по каждой строке КИ
товара") принимает значение положительного
или отрицательного решения ФТС по каждому
КИ.
Если параметр "ftsDecisionCode" ("Код
принятого решения") принимает значение "63"
("Недопустимый код принятого решения в
декларации на товары. Ввод в оборот не
выполнен"), то Статус всех КИ в ДТ не
изменяется, особое состояние КИ меняется на
"FTS_CONTROL" ("На контроле ФТС") или
"NULL", статус документа "Декларация на
товары" меняется на "Обработан с ошибкой",
статус документа "Ввод в оборот" меняется на
"Обработан с ошибкой"
*ftsDecisionTimestamp string + Дата и время Формат: 2020-12-14T00:00:00.000Z
(date-time) принятого
решения
*customsCode string + Код таможенного
органа,
зарегистрировавш
его документ

105
 Обя
Параметр Тип з. Описание Комментарий
*goodsDeclarationDate string + Дата регистрации
ДТ
*goodsDeclarationRegistration string + Порядковый Формат: 10013160/111220/0719609
Number номер ДТ по
журналу
регистрации
*customsProcedureCode string + Код таможенной
процедуры
*senderName string - Наименование
организации
грузоотправителя
*senderCountryCode string - Кодовое
обозначение
страны
грузоотправителя
*senderCountryName string - Краткое название
страны
грузоотправителя
в соответствии с
классификатором
стран мира
*senderForeignCode string - ИНН организации
грузоотправителя
*receiverName string - Наименование
получателя
*receiverInn string - ИНН организации
грузополучателя
*declarantName string - Наименование
организации
декларанта
*declarantInn string - ИНН организации
декларанта
*declarantKpp string - КПП организации
декларанта
*declarationId string + Идентификатор
декларации на
товары
*declarationDate string - Дата внесения
сведений
*declaringCode string - Код особенности
декларирования
товаров
*attachment array - Блок данных,
описывающих

106
 Обя
Параметр Тип з. Описание Комментарий
параметры
вложения,
передаваемого
через файловое
хранилище
**codeDocument string + Код документа
**fileName string + Наименование
файла внутри
архива
**originalFileName string + Оригинальное
наименование
файла
**originalFileMimeType string + Оригинальное
расширение
файла
**unstructuredFormat string + Признак того,
является или нет
вложение
неструктурирован
ным
**zippedPacket string + Признак того, что
вложение
помещено в zip-
архив
*markedProducts array - Сведения о
маркированных
товарах,
указанных в ДТ
**type string + Тип документа См. "Справочник "Типы документов""
**grossWeight string - Вес брутто, кг
**netWeight string - Вес нетто, кг
**tnVed string - Код ТН ВЭД
ЕАЭС
**excisePaidTaxAmount string + Сведения об
акцизных товарах.
Сумма
уплаченного
акциза в рублях
**currencyCodeInContract string - Трёхзначный
буквенный код
валюты
цены/стоимости
товара в
соответствии с
классификатором

107
 Обя
Параметр Тип з. Описание Комментарий
валют
**customsProductPrice string - Таможенная
стоимость товара
**statisticalProductPrice string - Статистическая
стоимость товара
**productPrice string - Цена товара
(фактурная
стоимость)
**productionCountryCode string - Код страны
происхождения в
соответствии с
классификатором
стран
мира/"EU"/00
(неизвестна)
**productAmountInExtraUnitM decimal - Количество
easure товаров в
дополнительной
единице
измерения
**extraUnitMeasureName string - Условное
обозначение
единицы
измерения
**extraUnitMeasureCode string - Код единицы
измерения в
соответствии с
единицами
измерения,
применяемыми в
ТН ВЭД ЕАЭС
**productNameInDeclaration array of - Наименование
objects (коммерческое,
фирменное или
иное) товаров в
ДТ
**productNumberInDeclaration integer + Порядковый(е)
номер(а) товара в
ДТ
**productAmountInDeclaration integer - Количество Общее количество КИ, содержащихся в СИ,
товара в ДТ нанесённых на каждую единицу товара, или
товарный ярлык, или потребительскую
упаковку (первичную упаковку при отсутствии
потребительской упаковки)
**approvDocList array[strin - Сведения о
g] разрешительных

108
 Обя
Параметр Тип з. Описание Комментарий
документах
***approvementDocumentNum string - Номер
ber разрешительного
документа
***approvementDocumentDate string - Дата Формат: 2020-03-27
разрешительного
документа
*ftsDecisionCode string + Код решения Действие кода решения по строке
таможенного распространяется только на код в строке. Для
органа каждого КИ анализируется код решения,
указанный построчно.
Допустимые значения:
Код положительного решения ФТС:
10 - Выпуск товаров разрешён;
11 - Выпуск товаров при условии обеспечения
исполнения обязанности по уплате таможенных
пошлин, налогов, специальных,
антидемпинговых, компенсационных пошлин,
за исключением выпуска товаров,
поименованного в позициях с кодами 12 и 13;
12 - Выпуск товаров с особенностями,
предусмотренными статьей 121 Таможенного
кодекса Евразийского экономического союза;
13 - Выпуск товаров с особенностями,
предусмотренными статьей 122 Таможенного
кодекса Евразийского экономического союза;
14 - Выпуск товаров с особенностями,
предусмотренными статьей 123 Таможенного
кодекса Евразийского экономического союза;
20 - Условный выпуск товаров.
Статус КИ меняется на "INTRODUCED"
("Введён в оборот"). Особое состояние КИ
сбрасывается (см. "Справочник "Статусы КИ"").
Статус документа "Ввод в оборот. Импорт с
ФТС" меняется на "CHECKED_OK"
("Обработан"). Cтатус документа "Декларация
на товары" меняется на "CHECKED_OK"
("Обработан").
Код отрицательного решения:
40 - Таможенная декларация отозвана до
выпуска товаров;
50 - Выпуск товаров аннулирован при отзыве
таможенной декларации в случаях,
предусмотренных пунктами 4 - 6 статьи 113 или
пунктом 9 статьи 116 Таможенного кодекса
Евразийского экономического союза;
51 - Выпуск товаров аннулирован в случае,

109
 Обя
Параметр Тип з. Описание Комментарий
предусмотренном пунктом 10 статьи 116
Таможенного кодекса Евразийского
экономического союза;
52 - Выпуск товаров аннулирован по
мотивированному обращению декларанта в
случаях, определённых в соответствии с
абзацем вторым пункта 4 статьи 118
Таможенного кодекса Евразийского
экономического союза;
60 - Срок выпуска товаров приостановлен;
61 - Срок приостановления срока выпуска
товаров продлён;
62 - Приостановление срока выпуска товаров
отменено;
70 - Срок выпуска товаров продлён;
82 - Таможенная декларация считается не
поданной;
90 - Отказано в выпуске товаров;

Статус КИ не изменяется. Особое состояние КИ

меняется на "FTS_RESPOND_NOT_OK"
("Отрицательное решение ФТС") (см.
"Справочник "Статусы КИ""). Статус документа
"Ввод в оборот. Импорт с ФТС" меняется на
"CHECKED_OK" ("Обработан"). Cтатус
документа "Декларация на товары" меняется на
"CHECKED_OK" ("Обработан").
Невалидный/отсутствует, но имеется хотя бы в
одной другой строке/не найден в
классификаторе:
92 - Иное решение, предусмотренное
законодательством государств-членов
Евразийского экономического союза;
00 - Различно по товарам; не найден в
классификаторе; NULL - отсутствует значение.
Статус КИ не изменяется. Особое состояние КИ
возвращается к первоначальному
"FTS_CONTROL"/FTS_RESPOND_NOT_OK"/О
тсутствует ("На контроле ФТС"/"Отрицательное
решение ФТС"/NULL) (см. "Справочник
"Статусы КИ""). Статус документа "Ввод в
оборот. Импорт с ФТС" меняется на "Обработан
с ошибкой". Cтатус документа "Декларация на
товары" меняется на "Обработан с ошибкой".
*ftsDecisionTimestamp string + Дата и время Формат: 2020-12-14T00:00:00.000Z
(date-time) принятого
решения
*vat string - Сумма
уплаченного НДС

110
 Обя
Параметр Тип з. Описание Комментарий
*cisInfoList array - Перечень ID
контрольных
(идентификацион
ных) знаков
**markingLevelType string + Код уровня
маркировки в
соответствии со
справочником
уровней
маркировки
**cisDtoList array + Список КИ Символьное представление блока информации,
содержащейся в коде идентификации
***cisIntId string - Цифровой
идентификатор
применения блока
информации,
содержащейся в
КИ
***cis string + Значение блока
информации,
содержащейся в
КИ,
представленное в
виде
последовательнос
ти цифровых и
буквенных
символов

4.2.6. Возврат в оборот

Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Обувные товары", "Предметы одежды, бельё постельное, столовое туалетное и
кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые новые".
Создание документа доступно для ТГ "Пиво, напитки, изготавливаемые на основе пива,
слабоалкогольные напитки" только для чека возврата (RECEIPT_RETURN).
Тип документа:

Тип Описание
LP_RETURN Возврат в оборот. JSON (MANUAL)
LP_RETURN_CSV Возврат в оборот. CSV
LP_RETURN_XML Возврат в оборот. XML

111
Пример тела документа в формате JSON:
{
"certificate_date": "2020-01-23",
"certificate_number": "string",
"certificate_type": "string",
"paid": true,
"primary_document_custom_name": "string",
"primary_document_date": "2020-01-23",
"primary_document_number": "string",
"primary_document_type": "string",
"products_list": [
{
"certificate_date": "2020-01-23",
"certificate_number": "string",
"certificate_type": "string",
"ki": "string",
"paid": true,
"primary_document_custom_name": "string",
"primary_document_date": "2020-01-23",
"primary_document_number": "string",
"primary_document_type": "string"
}
],
"return_type": "RETAIL_RETURN",
"trade_participant_inn": "string"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

certificate_date string - Дата документа, Задаётся в формате yyyy-MM-dd. Диапазон
(date) подтверждающего даты, начиная с 2000-01-01 по дату создания
соответствие документа
certificate_number string - Номер документа,
подтверждающего
соответствие
certificate_type string - Тип документа, Возможные значения:
подтверждающего CONFORMITY_CERTIFICATE - сертификат
соответствие соответствия;
CONFORMITY_DECLARATION -
декларация соответствия.
paid boolean - Товар был оплачен Признак оплаты товара
покупателем
primary_document_date string - Дата первичного Задаётся в формате yyyy-MM-dd.
(date) документа Обязательный для видов возврата "Возврат
при розничной реализации" и "Возврат при
дистанционном способе продажи" с
"Признаком оплаты товара" = true
primary_document_number string - Номер первичного Обязательный для видов возврата "Возврат
документа при розничной реализации" и "Возврат при
дистанционном способе продажи" с

112
Параметр Тип Обяз. Описание Комментарий
"Признаком оплаты товара" = true
primary_document_type enum - Вид первичного Возможные значения:
документа RECEIPT – кассовый чек;
SALES_RECEIPT – товарный чек;
OTHER – прочее.
Обязательный для видов возврата "Возврат
при розничной реализации" и "Возврат при
дистанционном способе продажи" с
"Признаком оплаты товара" = true
primary_document_custom_name string - Наименование Обязательно, если в поле «Вид первичного
первичного документа» указано значение OTHER
документа (прочее)
products_list array + Список сведений о
товарах
*certificate_date string - Дата документа, Задаётся в формате yyyy-MM-dd
(date) подтверждающего
соответствие
*certificate_number string - Номер документа,
подтверждающего
соответствие
*certificate_type string - Тип документа, Вид документа, подтверждающего
подтверждающего соответствие:
соответствие CONFORMITY_CERTIFICATE - сертификат
соответствия;
CONFORMITY_DECLARATION -
декларация о соответствии
*ki string + КИ/КИН
*paid boolean - Товар оплачен Признак оплаты товара
*primary_document_custom_name string - Наименование Обязательный, если в поле «Вид первичного
первичного документа» значение OTHER (прочее)
документа
*primary_document_date string + Дата первичного Задаётся в формате yyyy-MM-dd
(date) документа
*primary_document_number string + Номер первичного
документа
*primary_document_type enum + Вид первичного Возможные значения:
документа RECEIPT – кассовый чек;
SALES_RECEIPT – товарный чек;
OTHER – прочее
return_type string + Вид возврат Возможные значения:
RETAIL_RETURN – возврат при розничной
реализации;
REMOTE_SALE_RETURN – возврат при
дистанционном способе продажи
trade_participant_inn string + ИНН участника

113
Параметр Тип Обяз. Описание Комментарий
оборота товара

Пример тела документа в формате CSV

ИНН участника оборота,Вид возврата,Оплачен покупателем,Тип первичного
документа,Наименование первичного документа,Номер первичного
документа,Дата первичного документа,Вид документа подтверждающего соответствие,Номер
документа подтверждающего соответствие,Дата документа
подтверждающего соответствие,Версия
00000000,Возврат при розничной реализации,Да,Кассовый чек,,12345,12.04.2019,Сертификат
соответствия,12345,12.04.2019,1
Параметры товаров,,,,,,,,,,
КИ,Оплачен покупателем,Тип первичного документа,Наименование первичного
документа,Номер первичного документа,Дата первичного документа,Вид
документа подтверждающего соответствие,Номер документа подтверждающего
соответствие,Дата документа подтверждающего соответствие,,
"00000000000000000000000000000000000000",Да,Кассовый чек,,12345,12.04.2019,Сертификат
соответствия,12345,12.04.2019,,

Пример тела документа в формате XML

<?xml version="1.0" encoding="UTF-8"?>
<return action_id="34" version="1">
<trade_participant_inn>000000000</trade_participant_inn>
<return_type>RETAIL_RETURN</return_type>
<paid>true</paid>
<primary_document_type>RECEIPT</primary_document_type>
<primary_document_custom_name>Бланк строгой
отчетности</primary_document_custom_name>
<primary_document_number>12345</primary_document_number>
<primary_document_date>12.04.2019</primary_document_date>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>12345</certificate_number>
<certificate_date>12.04.2019</certificate_date>
<products_list>
<product>
<ki>0000000000000000000FFFFFFFFFFFFFFFFFFF</ki>
<paid>true</paid>
<primary_document_type>RECEIPT</primary_document_type>
<primary_document_custom_name>custom_name</primary_document_custom_name>
<primary_document_number>12345</primary_document_number>
<primary_document_date>12.04.2019</primary_document_date>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>12345</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
</products_list>
</return>

4.2.7. Отгрузка
Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Обувные товары", "Предметы одежды, бельё постельное, столовое, туалетное и
114
кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
LP_SHIP_GOODS Отгрузка. JSON (MANUAL)
LP_SHIP_GOODS_CSV Отгрузка. CSV
LP_SHIP_GOODS_XML Отгрузка. XML

Пример тела документа в формате JSON:

{
"document_date": "2020-04-20T14:02:19.813Z",
"transfer_date": "2020-04-20T14:02:19.813Z",
"document_num": "123",
"receiver_inn": "000000000",
"turnover_type": "SELLING",
"sender_inn": "0000000000",
"to_not_participant": false,
"products": [
{
"product_description": "Остатки",
"uit_code": "00000000000000000000000",
"product_cost": 1000,
"product_tax": 200
}
]

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

document_num string + Номер первичного документа
document_date string(date- + Дата первичного документа Формат: 2020-01-14T00:00:00.000Z
time)
transfer_date array + Дата передачи Формат: 2020-01-14T00:00:00.000Z
маркированных товаров
products array + Список сведений о товарах
*uit_code string - Уникальный КИ/КИН Обязательный, если не указан "uitu_code"
*uitu_code string - Уникальный идентификатор Обязательный, если не указан "uit_code"
транспортной упаковки
*product_description string + Наименования продукта
*product_cost integer - Цена за единицу Стоимость указывается в копейках с учётом
НДС

115
Параметр Тип Обяз. Описание Комментарий
*product_tax integer - Сумма НДС Сумма НДС указывается в копейках
receiver_inn string + ИНН получателя
sender_inn string - ИНН отправителя
to_not_participant boolean - Признак отгрузки Возможные значения:
неучастнику true – отгрузка неучастнику;
false – отгрузка УОТ
turnover_type string + Код типа отгрузки Возможные значения:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент Значение поля должно
совпадать со значением поля документа
"Приемка"

Пример тела документа в формате CSV

ИНН отправителя,ИНН получателя,ИНН собственника,Дата передачи товара,Номер первичного
документа,Дата первичного документа,Вид оборота товаров,Причина вывода из оборота, Дата
вывода из оборота,Идентификатор гос.контракта,Отгрузка неучастнику,Версия
1111111111,2222222222,1111111111,25.05.2020,123,25.05.2020,Продажа,,,,Нет,4
Параметры товаров
КИ,КИТУ,Цена за единицу,Сумма НДС
"0000000000000000000000000000000",,100,10

Пример тела документа в формате XML

<?xml version="1.0" encoding="UTF-8"?>
<shipment action_id="10" version="5">
<trade_participant_inn_sender>1111111111</trade_participant_inn_sender>
<trade_participant_inn_receiver>2222222222</trade_participant_inn_receiver>
<transfer_date>13.11.2020</transfer_date>
<move_document_number>123</move_document_number>
<move_document_date>13.11.2020</move_document_date>
<turnover_type>SELLING</turnover_type>
<to_not_participant>true</to_not_participant>
<products_list>
<!-- 1 or more repetitions: -->
<product>
<kitu>00000000000000000000000000000</kitu>
<cost>330305</cost>
<vat_value>27085</vat_value>
<!-- Optional: -->
<children_products_list>
<!-- 1 or more repetitions: -->
<product>
<ki>0000000000000000000000000000000</ki>
<cost>3303</cost>
<vat_value>270</vat_value>
</product>
</children_products_list>
</product>

116
 </products_list>
</shipment>

4.2.7.1. Отгрузка с выводом из оборота

Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Обувные товары", "Предметы одежды, белье постельное, столовое, туалетное и
кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
LP_SHIP_RECEIPT Отгрузка с выводом из оборота. JSON (MANUAL)
LP_SHIP_RECEIPT _CSV Отгрузка с выводом из оборота. CSV
LP_SHIP_RECEIPT _XML Отгрузка с выводом из оборота. XML

Пример тела документа в формате JSON:

{
"document_date": "2019-01-01" ,
"document_num": "document number" ,
"products": [
{
"product_cost": 33030 ,
"product_tax": 270 ,
"uit_code": "00000000000000000000000000000000000001"
} ,
{
"product_cost": 33030 ,
"product_tax": 270 ,
"uitu_code": "111111111111111111"
}
] ,
"receiver_inn": "получатель" ,
"request_type": "SHIPMENT" ,
"transfer_date": "2019-01-01" ,
"turnover_type": "SELLING" ,
"sender_inn": "отправитель" ,
"withdrawal_type": "NO_RETAIL_USE" ,
"withdrawal_date": "2019-10-01" ,
"to_not_participant": false
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

document_num string + Номер первичного
документа
document_date string + Дата первичного Задаётся в формате yyyy-MM-dd

117
Параметр Тип Обяз. Описание Комментарий
документа
products array + Список сведений о товарах
*uit_code string - Уникальный КИ/КИН Обязательный, если не указан "uitu_code"
*uitu_code string - Уникальный Обязательный, если не указан "uit_code"
идентификатор
транспортной упаковки
*product_cost integer - Цена за единицу Стоимость указывается в копейках с учётом НДС
*product_tax integer - Сумма НДС
receiver_inn string + ИНН получателя
request_type string + Тип документа Значение параметра должно = "SHIPMENT"
transfer_date string + Дата передачи Задаётся в формате yyyy-MM-dd
маркированных товаров
turnover_type string + Код типа отгрузки Возможные значения:
SELLING – продажа Значение поля должно совпадать
со значением поля документа "Приемка"
sender_inn string - ИНН отправителя
st_contract_id string - Идентификатор Обязательно при withdrawal_type =
государственного STATE_ENTERPRISE
контракта
to_not_participant boolean - Признак отгрузки Возможные значения:
неучастнику true – отгрузка неучастнику;
false – отгрузка участнику
withdrawal_date string + Дата вывода из оборота Задаётся в формате yyyy-MM-dd
withdrawal_type enum + Причина вывода из Причина вывода из оборота:
оборота DONATION – безвозмездная передача;
STATE_ENTERPRISE – приобретение
государственным предприятием;
NO_RETAIL_USE – использование для собственных
нужд покупателем (причина недоступна для товарной
группы "Молочная продукция")

Пример тела документа в формате CSV

ИНН отправителя,ИНН получателя,Дата отгрузки,Номер первичного документа,Дата первичного
документа,Вид оборота товаров,Причина вывода из оборота,Дата вывода из
оборота,Идентификатор гос.контракта,Отгрузка неучастнику,Версия
1111111111,2222222222,06.05.2020,123,06.05.2020,Продажа,Приобретение
гос.предприятием,06.05.2020,12345678912345678912,Нет,5
Параметры товаров
КИ,КИТУ,Цена за единицу,Сумма НДС
"000000000000000000qqqqqqqqqqqqq",,10000,0

Пример тела документа в формате XML

118
<?xml version="1.0" encoding="UTF-8"?>
<shipment action_id="10" version="5">
<trade_participant_inn_sender>0000000000</trade_participant_inn_sender>
<trade_participant_inn_receiver>0000000000</trade_participant_inn_receiver>
<transfer_date>01.01.2020</transfer_date>
<move_document_number>12345678901234567890</move_document_number>
<move_document_date>01.01.2020</move_document_date>
<turnover_type>SELLING</turnover_type>
<!--Optional:-->
<withdrawal_type>STATE_ENTERPRISE</withdrawal_type>
<!--Optional:-->
<withdrawal_date>01.01.2020</withdrawal_date>
<!--Optional:-->
<st_contract_id>string</st_contract_id>
<products_list>
<!--1 or more repetitions:-->
<product>
<!--Optional:-->
<ki>00000000000000FFFFFFFFFFFFFFF</ki>
<!--Optional:-->
<cost>100000</cost>
<!--Optional:-->
<vat_value>100000</vat_value>
</product>
</products_list>
</shipment>

4.2.7.2. Отгрузка при трансграничной торговле

Создание документа доступно для товарных групп "Духи и туалетная вода", "Обувные товары",
"Предметы одежды, белье постельное, столовое, туалетное и кухонное", "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые
новые". Документ доступен только Операторам государств-членов ЕАЭС.
Тип документа:

Тип Описание
LP_SHIP_GOODS_CROSSBORDER Отгрузка при трансграничной торговле. JSON (MANUAL)

Пример тела документа в формате JSON:

{
"document_num": "784378438",
"document_date": "2020-01-14T00:00:00.000Z",
"receiver_inn": "7777777777",
"receiver": "ООО Ригла",
"sender_inn": "000000000",
"sender": "РУП Издательство Белбланкавыд",
"exporter_taxpayer_id": "7777777777",
"exporter_name": "Белобувьэкспорт",
"request_type": "SHIPMENT",
"release_method": "CROSSBORDER",
"transfer_date": "2020-01-14T00:00:00.000Z",
"products": [

119
 {
"uit_code": "010463003759131621qSyEMozA3oJjP2406401"
},
{
"uit_code": "010463003569131621eSyEMozA3oJjP2406401"
},
{
"uitu_code": "00807602215iqaOR"
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

document_num string + Номер первичного документа Длина от 1 до 255 символов
включительно
document_date string + Дата первичного документа Формат: 2020-01-
14T00:00:00.000Z
receiver_inn string + ИНН получателя Получателем является участник
оборота товаров РФ
receiver string - Наименование получателя Длина от 1 до 255 символов
включительно
sender_inn string + ИНН отправителя или его аналог в государстве- Длина 9 символов
члене ЕАЭС
sender string - Отправитель (наименование Оператора) Длина от 1 до 255 символов
включительно
exporter_taxpayer_id string + Уникальный идентификатор экспортёра в Длина от 1 до 255 символов
национальной системе учёта включительно
налогоплательщиков
exporter_name string + Наименование экспортёра Длина от 1 до 255 символов
включительно
request_type string + Тип запроса (документа) Значение параметра
"SHIPMENT"
release_method string + Способ ввода товара в оборот Параметр принимает значение
"CROSSBORDER"
transfer_date string + Дата и время отгрузки Формат: 2020-01-
14T00:00:00.000Z
products array + Массив, содержащий список передаваемых КИ
*uit_code string + Передаваемый КИ Параметр обязательный, если
не указан "uitu_code"
*uitu_code string - Передаваемый КИТУ Параметр обязательный, если
не указан "uit_code"
**children array - Массив, содержащий список дочерних КИ

120
4.2.7.3. Отмена отгрузки
Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Обувные товары", "Предметы одежды, белье постельное, столовое, туалетное и
кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
LP_CANCEL_SHIPMENT Отмена отгрузки. JSON (MANUAL)

Пример тела документа в формате JSON:

{
"participant_inn": "string",
"pdfFile": "string",
"shipment_number": "string"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participant_inn string + ИНН участника оборота товара
pdfFile string - Приложенный PDF файл в base64
shipment_number string + Номер документа на отгрузку

4.2.7.4. Отмена отгрузки при трансграничной торговле

Создание документа доступно для ТГ "Духи и туалетная вода", "Обувные товары", "Предметы
одежды, белье постельное, столовое, туалетное и кухонное", "Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые новые". Документ
доступен только Операторам стран-членов ЕАЭС.
Тип документа:

Тип Описание
LP_CANCEL_SHIPMENT_CROSSBORDER Отмена отгрузки при трансграничной торговле. JSON (MANUAL)

Пример тела документа в формате JSON:

{
"participant_inn": "0000000000",
"shipment_number": "57250cce-52cf-408b-99ef-39cc239f60f1"
}

Параметры документа:

121
Параметр Тип Обяз. Описание Комментарий
participant_inn string + ИНН участника оборота товара или его аналог в стране-члене ЕАЭС
shipment_number string + Номер документа отменяемого документа отгрузки

4.2.8. Приемка
Создание документа доступно для товарных групп "Велосипеды и велосипедные рамы", "Духи и
туалетная вода", "Кресла-коляски", "Молочная продукция" "Обувные товары", "Предметы одежды,
бельё постельное, столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые
новые".
Тип документа:

Тип Описание
LP_ACCEPT_GOODS Приемка. JSON (MANUAL)
LP_ACCEPT_GOODS_XML Приемка. XML

Пример тела документа в формате JSON для приёмки отгрузки в РФ:

{
"release_order_number": "f0633b08-fd4b-4a89-9bc8-647cfe5fe060",
"trade_sender_inn": "000000000",
"trade_recipient_inn": "0000000000",
"document_number": "0000000000",
"document_date": "2020-01-14T00:00:00.000Z",
"transfer_date": "2020-01-14T00:00:00.000Z",
"acceptance_date": "2020-01-14T00:00:00.000Z",
"turnover-type": "SELLING",
"products_list": [
{
"uit_code": "010463003759131621qSyEMozA3oJjP2406401",
"cost": "2000",
"accepted": true
},
{
"uit_code": "010463345759131621qSyEMozA3oJjP2406401",
"cost": "5000",
"accepted": true
},
{
"uit_code": "010463345759131621qSyEMozA3oJjP2406401",
"cost": "3000",
"accepted": true
}
]
}

Параметры документа в формате JSON при приёмке отгрузки в РФ::

122
Параметр Тип Обяз. Описание Комментарий
release_order_number string + Номер документа
отгрузки
document_number string + Номер
первичного
документа
document_date string + Дата первичного Формат: yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
(date- документа Диапазон: текущая дата минус 5 календарных лет ⇐ дата ⇐
time) текущая дата
accept_all boolean - Принять всё Если значение true, то параметр "product" может быть
незаполнен: принимаются все коды, перечисленные в
документе отгрузки.
Если параметр "reject_all" и "accept_all" = false, то
анализируется параметр "accepted" для каждого КИ в
документе "Приёмка".
Параметр не может быть заполнен одновременно с
параметром "reject_all"
reject_all boolean - Отклонить всё Если значение true, то параметр "product" может быть
незаполнен: отклоняются все коды, перечисленные в
документе отгрузки.
Если параметр "reject_all" и "accept_all" = false, то
анализируется параметр "accepted" для каждого КИ в
документе "Приёмка".
Параметр не может быть заполнен одновременно с
параметром "accept_all"
transfer_date string + Дата и время Формат: yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
(date- отгрузки Диапазон: текущая дата минус 5 календарных лет ⇐ дата ⇐
time) текущая дата. Значение параметра должно соответствовать
значению параметра "transfer_date" в документе "Отгрузка"
acceptance_date string + Дата и время Формат: yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
(date- приёмки товара Диапазон: текущая дата минус 5 календарных лет ⇐ дата ⇐
time) текущая дата
trade_sender_inn string + ИНН отправителя
trade_recipient_inn string + ИНН получателя
turnover_type string + Код типа Возможные значения:
отгрузки SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент
Значение параметра должно совпадать со значением
параметра "turnover_type" в документе "Отгрузка"
products_list array + Массив, Список КИ в документе "Приемка" должен полностью
содержащий соответствовать списку в документе "Отгрузки"
список
Значение параметра должно совпадать со списком КИ в
передаваемых КИ
параметре "products" в документе "Отгрузка"
(LP_SHIP_GOODS)

123
Параметр Тип Обяз. Описание Комментарий
*children array - Массив, Содержит те же параметры, что и "products_list"/"products"
содержащий
список дочерних
КИ
*cis string + Передаваемый Возвращается, если отсутствуют параметры "uit_code" и
КИ "uitu_code"
*uit_code string - Передаваемый
КИ
*uitu_code string - Передаваемый Обязательный, если не указан "uit_code"
КИТУ
*cost integer - Цена за единицу Стоимость указывается в копейках с учётом НДС (до 19
символов, 2 после запятой)
*vat_value integer - Сумма НДС До 19 символов, 2 после запятой
*accepted boolean + Признак того, что "True" - товара принят, "false" - товар не принят Параметры
товар принят или "accept_all" и "reject_all" не могут быть заполнены
не принят одновременно

Пример тела документа в формате JSON для приёмки отгрузки при трансграничной торговле:
{
"release_order_number": "f0633b08-fd4b-4a89-9bc8-647cfe5fe060",
"trade_sender_inn": "000000000",
"trade_sender_name": "РУП Издательство Белбланкавыд",
"trade_recipient_inn": "00000000",
"trade_recipient_name": "ООО Ригла",
"exporter_taxpayer_id": "7777777777",
"exporter_name": "Белобувьэкспорт",
"document_number": "784378438",
"document_date": "2020-01-14T00:00:00.000Z",
"transfer_date": "2020-01-14T00:00:00.000Z",
"acceptance_date": "2020-01-14T00:00:00.000Z",
"request_type": "ACCEPTANCE",
"release_method": "CROSSBORDER",
"products": [
{
"uit_code": "010463003759131621qSyEMozA3oJjP2406401",
"accepted": "true"
},
{
"uit_code": "010463003569131621eSyEMozA3oJjP2406401",
"accepted": "false"
},
{
"uit_code": "010469563759131621sSyEMozA3oJjP2406401",
"accepted": "true"
}
]
}

Параметры документа:

124
Параметр Тип Обяз. Описание Комментарий
release_order_number string + Номер документа
отгрузки
document_number string + Номер первичного
документа
request_type string + Тип запроса, Значение параметра = "ACCEPTANCE"
соответствующий
обрабатываемому
документу
document_date string + Дата первичного Формат: yyyy-MM-
(date- документа ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z
time)
trade_sender_name string - Наименование Длина значения: 1 - 255 символов
оператора
transfer_date string + Дата и время Формат: yyyy-MM-
(date- отгрузки ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
time)
acceptance_date string + Дата и время Формат: yyyy-MM-
(date- приёмки товара ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
time)
trade_sender_inn string + ИНН отправителя УНП
trade_recipient_inn string + ИНН получателя Получателем является участник оборота товаров РФ
trade_recipient_name string - Наименование Длина значения: 1 - 255 символов
получателя
exporter_taxpayer_id string + УНП экспортёра Длина значения: 8/9/10/12/14 символов
exporter_name string + Наименование Длина значения: 1 - 255 символов
экспортёра
release_method string + Код способа ввода Возможное значение: "CROSSBORDER".
товара в оборот (тип
эмиссии)
products array + Массив, Должен быть указан хотя бы один передаваемый КИ
содержащий список
передаваемых КИ
*uit_code string + Передаваемый КИ
*uitu_code string - Передаваемый Параметр является обязательным, если не указан
КИТУ "uit_code"
*children array + Массив, Содержит те же параметры, что и "products"
содержащий список
дочерних КИ
*vsd_number string - Номер ВСД Указывается только для ТГ "Молочная продукция" при
трансграничном перемещении товара. Параметр является
обязательным, если в карточке НК "veterinaryControl"
("Признак подконтрольности") = true. Номер ВСД,
указанный для КИ агрегата, передаётся всем вложениям

125
Параметр Тип Обяз. Описание Комментарий
КИ агрегата
*accepted boolean + Признак того, что "True" - товара принят, "false" - товар не принят.
товар принят или не Параметры "accept_all" и "reject_all" не могут быть
принят заполнены одновременно

Пример тела документа в формате JSON для приёмки отгрузки при трансграничном
перемещении для товарной группы "Молочная продукция":
{
"release_order_number": "f0633b08-fd4b-4a89-9bc8-647cfe5fe060",
"trade_sender_inn": "777777777",
"trade_sender_name": "РУП Издательство Белбланкавыд",
"trade_recipient_inn": "7777777777",
"trade_recipient_name": "ООО Ригла",
"exporter_taxpayer_id": "7777777777",
"exporter_name": "Белобувьэкспорт",
"document_number": "784378438",
"document_date": "2020-01-14T00:00:00.000Z",
"transfer_date": "2020-01-14T00:00:00.000Z",
"acceptance_date": "2020-01-14T00:00:00.000Z",
"request_type": "ACCEPTANCE",
"release_method": "CROSSBORDER",
"products": [
{
"uit_code": "010463003759131621qSyEMozA3oJjP2406401",
"vsd_number": "9CDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091",
"cost": "2000",
"certificate_type": "CONFORMITY_CERTIFICATE",
"certificate_number": "123456789",
"certificate_date": "2020-01-14T00:00:00.000Z",
"accepted": true
},
{
"uit_code": "010463345759131621qSyEMozA3oJjP2406401",
"vsd_number": "9CDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091",
"cost": "5000",
"certificate_type": "CONFORMITY_CERTIFICATE",
"certificate_number": "123456789",
"certificate_date": "2020-01-14T00:00:00.000Z",
"accepted": true
},
{
"uit_code": "010463345759131621qSyEMozA3oJjP2406401",
"vsd_number": "9CDA-5D57-FAEA-46DD-B94D-3DCC-AC70-1091",
"cost": "3000",
"certificate_type": "CONFORMITY_CERTIFICATE",
"certificate_number": "123456789",
"certificate_date": "2020-01-14T00:00:00.000Z",
"accepted": true
}
]
}

126
Условия подачи сведений в документе "Приемка" при трансграничной торговле для товарной группы
"Молочная продукция":
• параметр запроса "pg" (см. "Единый метод создания документов") = "milk";
• в значении параметра "release_order_number" указан "id" документа с кодом документа
"LP_SHIP_GOODS_CROSSBORDER" ("Отгрузка при трансграничной торговле").
Параметры документа:

Параметр Тип Обяз. Описание Комментарий

release_order_number string + Номер документа
отгрузки
trade_sender_inn string + ИНН отправителя УНП
trade_sender_name string - Наименование Длина значения: 1 - 255 символов
оператора
trade_recipient_inn string + ИНН получателя Получателем является участник оборота товаров РФ
trade_recipient_name string - Наименование Длина значения: 1 - 255 символов
получателя
exporter_taxpayer_id string + УНП экспортёра Длина значения: 1 - 255 цифровых символов
exporter_name string + Наименование Длина значения: 1 - 255 символов
экспортёра
document_number string + Номер первичного
документа
document_date string + Дата первичного Формат: yyyy-MM-
(date- документа ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z
time)
transfer_date string + Дата и время отгрузки Формат: yyyy-MM-
(date- ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
time)
acceptance_date string + Дата и время приёмки Формат: yyyy-MM-
(date- товара ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
time)
request_type string + Тип запроса, Возможное значение: "ACCEPTANCE"
соответствующий
обрабатываемому
документу
release_method string + Код способа ввода Возможное значение: "CROSSBORDER"
товара в оборот (тип
эмиссии)
products array + Массив, содержащий Должна быть заполнена хотя бы одна из записей
список передаваемых списка передаваемых КИ
КИ
*uit_code string + Передаваемый КИ
*uitu_code string - Передаваемый КИТУ Параметр является обязательным, если не указан

127
Параметр Тип Обяз. Описание Комментарий
"uit_code"
*vsd_number string - Номер ВСД Параметр является обязательным, если в карточке
НК "veterinaryControl" ("Признак
подконтрольности") = true
*cost integer + Цена за единицу Стоимость указывается в копейках с учётом НДС
(до 19 символов, 2 после запятой)
*certificate_type string - Вид документа, Возможные значения:
подтверждающего CONFORMITY_CERTIFICATE - сертификат
соответствие соответствия;
CONFORMITY_DECLARATION - декларация о
соответствии.

*certificate_number string - Номер документа,

подтверждающего
соответствие
*certificate_date boolean - Дата документа, Формат: 2020-01-14T00:00:00.000Z
подтверждающего
соответствие
*accepted boolean + Признак того, что товар "True" - товара принят, "false" - товар не принят
принят или не принят Параметры "accept_all" и "reject_all" не могут быть
заполнены одновременно

Примечание:
• в документе "Приемка" указываются все КИ, которые перечислены в документе "Отгрузка".
Пример тела документа в формате XML для приёмки отгрузки в РФ (недоступен для товарной
группы "Молочная продукция").
<?xml version="1.0" encoding="UTF-8"?>
<acceptance action_id="11" version="6">
<shipment_id>57250cce-52cf-408b-99ef-39cc239f60fd</shipment_id>
<trade_participant_inn_sender>0000000000</trade_participant_inn_sender>
<trade_participant_inn_receiver>0000000000</trade_participant_inn_receiver>
<shipment_date>2019-11-18T21:00:00.000Z</shipment_date>
<reception_date>2019-11-18T21:00:00.000Z</reception_date>
<transfer_date>12.04.2019</transfer_date>
<move_document_number>784378438</move_document_number>
<move_document_date>12.04.2019</move_document_date>
<turnover_type>SELLING</turnover_type>
<products_list>
<!--1 or more repetitions:-->
<product>
<ki>0000000000000000FFFFFFFFFFFFFFFFF</ki>
<accept_type>true</accept_type>
</product>
</products_list>
</acceptance>

128
Примечание: в текущей реализации для корректной обработки документа "Приёмка" в формате * .xml
необходимо, чтобы в документе "Отгрузка" все КИ совпадали с указанными в документе "Приёмка".
Поэтому, если в документе "Отгрузка" указан только верхний уровень КИ без вложений, то частично
принять/отклонить вложенные в агрегаты КИ в документе "Приемка" формата * .xml становится
невозможно.

4.2.9. Вывод из оборота

Создание документа доступно для товарных групп "Велосипеды и велосипедные рамы", "Духи и
туалетная вода", "Кресла-коляски", "Молочная продукция", "Обувные товары", "Пиво, напитки,
изготавливаемые на основе пива, слабоалкогольные напитки", "Предметы одежды, бельё постельное,
столовое, туалетное и кухонное", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Упакованная вода", "Шины и покрышки пневматические резиновые новые".
Тип документа:

Тип Описание
LK_RECEIPT Вывод из оборота. JSON (MANUAL)
LK_RECEIPT_CSV Вывод из оборота. CSV
LK_RECEIPT_XML Вывод из оборота. XML

Пример тела документа в формате JSON:

{
"inn": "7777777777",
"action": "OTHER",
"withdrawal_type_other": "Any text up to 255 characters",
"action_date": "2021-03-23",
"document_type": "OTHER",
"document_number": "56783",
"document_date": "2021-02-23",
"primary_document_custom_name": "Also any text up to 255 characters",
"kkt_number": "6574356597205734",
"products": [
{
"cis": "010116348336654421lBEtVuGyhA0HO",
"product_cost": 100500
},
{
"cis": "010116348336654421JUbiOuE9=NuEG",
"product_cost": 100500
},
{
"cis": "010116348336654421%IfhPcJ/fQxsS",
"product_cost": 100500
},
{
"cis": "0101163483366544210unznYOtprzN,",
"product_cost": 100500100500
}

129
 ]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

inn string + ИНН участника
оборота товаров
action_date string + Дата вывода из Формат: YYYY-MM-DD. Диапазон: не более
оборота текущей даты и не менее даты эмиссии и даты
ввода в оборот
action string + Причина вывода из Возможные значения:
оборота
RETAIL – Розничная продажа;
EEC_EXPORT – Экспорт в страны ЕАЭС;
BEYOND_EEC_EXPORT – Экспорт за пределы
стран ЕАЭС;
RETURN – Возврат физическому лицу (значение не
используется для товарной группы "Молочная
продукция");
REMOTE_SALE – Продажа по образцам,
дистанционный способ продажи;
DAMAGE_LOSS – Утрата или повреждение;
DESTRUCTION – Уничтожение;
CONFISCATION – Конфискация;
LIQUIDATION – Ликвидация предприятия;
ENTERPRISE_USE – Использование для
собственных нужд предприятия;
OTHER - Другое
withdrawal_type_other string(1- - Другая причина Параметр обязательный при "action" ("Причина
255) вывода из оборота") = OTHER ("Другая причина").
В случае указание иных причин данный параметр
недоступен
document_type string + Тип первичного Возможные значения:
документа
RECEIPT - Кассовый чек;
SALES_RECEIPT - Товарный чек;
CONSIGNMENT_NOTE - Товарная накладная;
CUSTOMS_DECLARATION - Таможенная
декларация;
UTD - Универсальный передаточный документ;
DESTRUCTION_ACT - Акт уничтожения;
OTHER - Прочее
Тип первичного документа зависит от значения
параметра "action" ("Причина вывода из оборота"):
RETAIL = RECEIPT, SALES_RECEIPT, OTHER;
REMOTE_SALE = RECEIPT, SALES_RECEIPT,
OTHER, CONSIGNMENT_NOTE, UTD;
EC_EXPORT, CONFISCATION, LIQUIDATION =
OTHER, CONSIGNMENT_NOTE, UTD;

130
Параметр Тип Обяз. Описание Комментарий
DAMAGE_LOSS, DESTRUCTION,
ENTERPRISE_USE = DESTRUCTION_ACT,
OTHER;
BEYOND_EEC_EXPORT =
CUSTOMS_DECLARATION;
RETURN, OTHER = OTHER.
См. "Справочник "Причины вывода из оборота""
document_number string(1- - Номер первичного Параметр является обязательным, если не заполнен
255) документа в массиве "products"
document_date string - Дата первичного Формат: 2020-01-14T00:00:00.000Z. Параметр
документа является обязательным, если не заполнен в массиве
"products". Диапазон: текущая дата минус 5
календарных лет ⇐ дата ⇐ текущая дата
document_custom_name string(1- - Наименование Параметр является обязательным, если
255) первичного "document_type" ("Тип первичного документа") =
документа OTHER ("Другое")
kkt_number string - Регистрационный
номер контрольно-
кассовой техники
products array of + Массив, Все КИ, указанные в массиве, должны быть
objects содержащий список выпущены для одной товарной группы. При подаче
КИ сведений должна быть заполнена хотя бы одна
запись в массиве
*cis string + КИ В текущей реализации указание КИТУ недоступно
*product_cost decimal - Цена за единицу Значение указывается в копейках с учётом НДС.
Значение включает до 19 символов и 2 символа
после запятой. Параметр не заполнен, если вывод
из оборота по причине экспорта за пределы
государств-членов ЕАЭС ("action" =
BEYOND_EEC_EXPORT)
*document_type string - Тип первичного Тип первичного документа зависит от значения
документа параметра "action" ("Причина вывода из оборота").
Возможные значения:
RECEIPT - Кассовый чек;
SALES_RECEIPT - Товарный чек;
CONSIGNMENT_NOTE - Товарная накладная;
CUSTOMS_DECLARATION - Таможенная
декларация;
UTD - Универсальный передаточный документ;
DESTRUCTION_ACT - Акт уничтожения;
OTHER - Прочее
Значение параметра имеет более высокий
приоритет перед значением параметра
"document_type" ("Тип первичного документа"),
указанного вне массива "products". При выборе
причины вывода из оборота "Другая причина"
("withdrawal_type" = OTHER) допустимо указание

131
Параметр Тип Обяз. Описание Комментарий
только значения "Прочее" (OTHER)
*document_number string(1- - Номер первичного Параметр является обязательным, если не заполнен
255) документа в массиве "products". Значение параметра имеет
более высокий приоритет перед значением
параметра "document_number", указанным вне
массива "products"
*document_date string(date) - Дата первичного Формат: 2020-01-14T00:00:00.000Z. Диапазон:
документа текущая дата минус 5 календарных лет ⇐ дата ⇐
текущая дата. Параметр является обязательным,
если не заполнен в массиве "products". Значение
параметра имеет более высокий приоритет перед
значением параметра "document_date", не
указанном в массиве "products"

Пример тела документа в формате CSV

ИНН участника оборота,Причина вывода из оборота,Другая причина вывода из оборота,Дата
вывода из оборота,Тип первичного документа,Номер первичного документа,Дата первичного
документа,Наименование первичного документа,Регистрационный номер ККТ,Идентификатор
госконтракта,Версия
7777777777,Другая причина,Описание другой причины,2021-03-23,Прочее,56783,2021-03-
23,Прочий тип первичного документа,6574356597205734,,5
Параметры товаров
КИ,Цена за единицу,Тип первичного документа,Номер первичного документа,Дата первичного
документа,Наименование первичного документа
010116348336654421lBEtVuGyhA0HO,100500,,,,
010116348336654421JUbiOuE9=NuEG,100500,,,,
010116348336654421%IfhPcJ/fQxsS,100500,,,,
0101163483366544210unznYOtprzN,100500100500,,,,

Пример тела документа в формате XML

<?xml version="1.0" encoding="UTF-8"?>
<withdrawal version="5">
<trade_participant_inn>7777777777</trade_participant_inn>
<withdrawal_type>OTHER</withdrawal_type>
<withdrawal_type_other>Any text up to 255 characters</withdrawal_type_other>
<withdrawal_date>2019-11-20</withdrawal_date>
<primary_document_type>OTHER</primary_document_type>
<primary_document_number>56783</primary_document_number>
<primary_document_date>2021-02-23</primary_document_date>
<primary_document_custom_name>Also any text up to 255
characters</primary_document_custom_name>
<kkt_number>6574356597205734</kkt_number>
<products_list>
<product>
<ki>010116348336654421lBEtVuGyhA0HO</ki>
<cost>100500</cost>
</product>
<product>
<ki>010116348336654421JUbiOuE9=NuEG</ki>
<cost>100500</cost>

132
 </product>
<product>
<ki>010116348336654421%IfhPcJ/fQxsS</ki>
<cost>100500</cost>
</product>
<product>
<ki>0101163483366544210unznYOtprzN</ki>
<cost>100500100500</cost>
</product>
</products_list>
</withdrawal>

4.2.10. Списание КИ
4.2.10.1. Списание не нанесенных КИ с/без СИ
Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Молочная продукция", "Обувные товары", "Пиво, напитки, изготавливаемые на
основе пива, слабоалкогольные напитки", "Предметы одежды, белье постельное, столовое, туалетное
и кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-
вспышки", "Шины и покрышки пневматические резиновые новые".
Применяется для КИ в статусе APPLIED (Эмитирован. Получен), когда участнику оборота товаров не
требуются полученные из СУЗ КМ и их необходимо списать в ГИС МТ.
Тип документа:

Тип Описание
LK_KM_CANCELLATION Списание не нанесённых КИ. JSON
LK_KM_CANCELLATION_XML Списание не нанесённых КИ. XML
LK_KM_CANCELLATION_CSV Списание не нанесённых КИ. CSV

Пример тела документа в формате JSON:

{
"cancellation_doc_date": "2020-01-23" ,
"cancellation_doc_number": "string" ,
"cancellation_reason": "string" ,
"km_list": [
{
"cancellation_reason": "string" ,
"uit": "string" ,
"uitu": "string"
}
] ,
"pdfFile": "string" ,
"trade_participant_inn": "string"
}

Параметры документа:

133
Параметр Тип Обяз. Описание Комментарий
cancellation_doc_date string + Дата списания Значением параметра является строка с
отформатированными датой и временем
cancellation_doc_number string + Номер первичного
документа на списание
cancellation_reason string + Причина списания Возможные значения:
KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен
km_list array + Список данных о КМ
*uit string - Уникальный КИ/КИН Обязательный, если не указан "uitu". Списание
КИН возможно только при отсутствии в нем
вложений
*uitu string - Уникальный Обязательный, если не указан "uit"
идентификатор
транспортной упаковки
*cancellation_reason string + Код причины списания Возможные значения:
KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен
pdfFile string - Приложенный PDF файл в
Base64
trade_participant_inn string + ИНН участника оборота
товара

Примечание: чтобы списать КИ в статусе EMITTED (Эмитирован. Выпущен), необходимо закрыть

заказ в СУЗ, тем самым все нанесенные КИ перейдут в статус APPLIED, а остальные спишутся
автоматически, либо дождаться, когда КИ спишутся автоматически по сроку годности
Пример тела документа в формате CSV
ИНН участника оборота,Причина списания кода маркировки,Дата документа подтверждающего
списание,Номер документа подтверждающего списание,Версия
0000000000,Испорчен,12.04.2019,123,2
Параметры кодов маркировки
КИ,КИТУ,Причина списания кода маркировки
"00000000000000000000000000000000000000",,Испорчен

Пример тела документа в формате XML

<?xml version="1.0" encoding="UTF-8"?>
<km_cancellation action_id="14" version="2">
<trade_participant_inn>7726739740</trade_participant_inn>
<cancellation_reason>KM_SPOILED</cancellation_reason>
<cancellation_document_date>20.01.2021</cancellation_document_date>
<cancellation_document_number>6742</cancellation_document_number>
<km_list>
<km>
<kit>010464004346033921(JlWKDvQDT4K*</kit>

134
 <cancellation_reason>KM_SPOILED</cancellation_reason>
</km>
</km_list>
</km_cancellation>

4.2.10.2. Списание нанесенных КИ с СИ

Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Обувные товары", "Предметы одежды, белье постельное, столовое, туалетное и
кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые новые".
Применяется для КМ в статусе INTRODUCED (В обороте), когда УОТ необходимо списать КМ,
находящийся в обороте, но не выводить тем самым из оборота. КМ получает статус (status) =
WRITTEN_OFF ("Списан") и дополнительный статус (statusEx) = WAIT_REMARK (КМ списан после
нанесения на товар (Товар ожидает перемаркировку). Следовательно, полученный КМ (statusEx =
WAIT_REMARK) можно будет потом использовать в схеме LK_REMARK с причиной
перемаркировки = причине Списания КМ в схеме LK_APPLIED_KM_CANCELLATION.
Пример тела документа в формате CSV
Тип документа:

Тип Описание
LK_APPLIED_KM_CANCELLATION Списание нанесённых КМ. JSON (MANUAL)
LK_APPLIED_KM_CANCELLATION_CSV Списание нанесённых КМ. CSV
LK_APPLIED_KM_CANCELLATION_XML Списание нанесённых КМ. XML

Пример тела документа в формате JSON:

{
"cancellation_doc_date": "2020-01-23",
"cancellation_doc_number": "string",
"cancellation_reason": "string",
"km_list": [
{
"cancellation_reason": "string",
"uit": "string",
"uitu": "string"
}
],
"pdfFile": "string",
"trade_participant_inn": "string"
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

cancellation_doc_date string + Дата списания Задаётся в формате yyyy-MM-dd

135
Параметр Тип Обяз. Описание Комментарий
cancellation_doc_number string + Номер первичного
документа на списание
cancellation_reason string + Причина списания Возможные значения:
KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен
km_list array + Список данных о КИ
*uit string - Уникальный КИ/КИН Обязательный, если не указано "uitu". Списание
КИН возможно только при отсутствии в нем
вложений
*uitu string - Уникальный идентификатор Обязательный, если не указано "uit"
транспортной упаковки
*cancellation_reason string + Код причины списания Возможные значения:
KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен
pdfFile string - Приложенный PDF файл в
Base64
trade_participant_inn string + ИНН участника оборота
товара

Примечание: чтобы списать КМ в статусе EMITTED (Эмитирован. Выпущен), необходимо закрыть

заказ в СУЗ, тем самым все нанесенные КМ перейдут в статус APPLIED, а остальные спишутся
автоматически, либо дождаться, когда КМ спишутся автоматически по сроку годности.
Пример тела документа в формате CSV:
ИНН участника оборота,Причина списания кода маркировки,Дата документа подтверждающего
списание,Номер документа подтверждающего списание,Версия
0000000000,Испорчен,12.04.2019,123,2
Параметры кодов маркировки
КИ,КИТУ,Причина списания кода маркировки
"00000000000000000000000000000000000000",,Испорчен

Пример тела документа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<km_cancellation action_id="14" version="2">
<trade_participant_inn>7777777777</trade_participant_inn>
<cancellation_reason>KM_SPOILED</cancellation_reason>
<cancellation_document_date>20.01.2021</cancellation_document_date>
<cancellation_document_number>6742</cancellation_document_number>
<km_list>
<km>
<kit>010464004346033921(JlWKDvQDT4K*</kit>
<cancellation_reason>KM_SPOILED</cancellation_reason>
</km>
</km_list>
</km_cancellation>

136
4.2.11. Перемаркировка
Создание документа доступно для ТГ "Велосипеды и велосипедные рамы", "Духи и туалетная вода",
"Кресла-коляски", "Обувные товары", "Предметы одежды, белье постельное, столовое, туалетное и
кухонное", "Упакованная вода", "Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые новые".
Краткое описание причин перемаркировки
• испорчено либо утеряно СИ с КМ (KM_SPOILED) - участник оборота товаров, являющийся
собственником товара, планирует перемаркировать товар, который находится в обороте.
Указание данной причины возможно с указанием или без указания предыдущего КИ. Указанный
предыдущий КИ должен быть в статусе "В обороте"/"Выбыл" по причине списания КИ;
• выявлены ошибки описания товара (DESCRIPTION_ERRORS) - участник оборота товаров,
являющийся собственником товара, планирует перемаркировать товар, который находится в
обороте. Указание данной причины возможно только с указанием предыдущего КИ в статусе "В
обороте"/"Выбыл" по причине списания КИ;
• возврат товаров с поврежденным СИ/без СИ при розничной реализации (в ЛК ГИС МТ "Возврат
от розничного покупателя" (RETAIL_RETURN)) - участник оборота товара, являющийся
собственником товара, планирует перемаркировать товар, возвращённый после розничной
реализации (например: чек возврата без КИ). Указание данной причины возможно с указанием
или без указания предыдущего КИ. Указанный предыдущий КИ должен быть в статусе "Выбыл"
по причине розничной реализации;
• возврат товаров с поврежденным СИ/без СИ при дистанционном способе продажи (в ЛК ГИС
МТ "Возврат в случае дистанционной продажи" (REMOTE_SALE_RETURN)) - участник оборота
товара, являющийся собственником товара, планирует перемаркировать товар, возвращённый
после дистанционного способа продажи. Указание данной причины возможно с указанием или
без указания предыдущего КИ. Указанный предыдущий КИ должен быть в статусе "Выбыл" по
причине дистанционного способа продажи;
• возврат от конечного покупателя (юр. лица/ИП) (LEGAL_RETURN) - участник оборота товара,
являющийся собственником товара, планирует перемаркировать товар, возвращённый после
реализации ЮЛ/ИП. Указание данной причины возможно как с указанием предыдущего КИ, так
и без него. Указанный предыдущий КИ должен быть в статусе "Выбыл" по причине исполнения
государственного контракта безвозмездной передачи, использования товара для собственных
нужд покупателем;
• решение о реализации товаров, приобретённых в целях, не связанных с их реализацией
(INTERNAL_RETURN) - участник оборота товара, являющийся собственником товара,
планирует перемаркировать ранее приобретённый товар с целью дальнейшей реализации.
Указание данной причины возможно как с указанием предыдущего КИ, так и без него.
Указанный предыдущий КИ должен быть в статусе "Выбыл" по причине использования товара
для собственных нужд. КИ был выведён из оборота путём отгрузки с выводом из оборота или
через УПД с выводом из оборота;

137
• возврат ранее экспортированного в ЕАЭС (EEC_EXPORT_RETURN) - участник оборота товара,
являющийся последним собственником товара, планирует перемаркировать ранее
приобретённый товар, который возвращён после экспорта в страны ЕЭАС. Указание данной
причины возможно как с указанием предыдущего КИ, так и без него. Указанный предыдущий
КИ должен быть в статусе "Выбыл" по причине экспорта в страны ЕАЭС.
Условия перемаркировки:
• новый КИ может быть только в статусе "Эмитирован. Получен" (APPLIED) с типом эмиссии
"Перемаркировка" (REMARK);
• перемаркировка осуществляется для предыдущего КИ только в статусе "В обороте"
(INTRODUCED) или "Выбыл" (RETIRED). участник оборота товаров, осуществляющий
перемаркировку, должен быть собственником предыдущего КИ. В текущей реализации
функциональности перемаркировка агентом или комиссионером не предусмотрена;
• обязательно указание предыдущего КИ в поле "last_uin" для причины перемаркировки
"Выявлены ошибки описания товара". При указании предыдущего КИ данные о цвете, размере и
стране производства берутся из указанного предыдущего КИ, даже если при формировании
документа были указаны данные, отличные от данных предыдущего КИ;
• КИ агрегата и КИ товара, входящего в состав агрегата, в параметре "new_uin" не указывается.
При указании КИ, входящего в состав агрегата в статусе "Сформирован", агрегат
расформировывается;
• причина выбытия КИ соответствует причине перемаркировки;
• тип упаковки нового КИ должен соответствовать типу упаковки предыдущего КИ.
Условия перемаркировки КИН:
• предыдущий КИН находится в статусе "В обороте" (INTRODUCED) для причины
перемаркировки "Испорчено либо утеряно СИ с КМ" (KM_SPOILED)) и в статусе "Выбыл"
(RETIRED) для причин перемаркировки "Возврат товаров с поврежденным СИ/без СИ при
розничной реализации" (RETAIL_RETURN), "Возврат товаров с поврежденным СИ/без СИ при
дистанционном способе продажи" (REMOTE_SALE_RETURN), "Возврат ранее
экспортированного в ЕАЭС" (EEC_EXPORT_RETURN), "Решение о реализации товаров,
приобретённых в целях, не связанных с их реализацией" (INTERNAL_RETURN), "Возврат от
конечного покупателя (юр. лица/ИП)" (LEGAL_RETURN));
• статус предыдущего КИН соответствует статусу вложенных КИ и должен иметь значение "В
обороте" (INTRODUCED) или "Выбыл" (RETIRED);
• GTIN предыдущего и нового КИН должны совпадать. В противном случае рекомендуется
расформировать набор и сформировать новый;
• перемаркируемый КИН должен иметь вложения. При перемаркировке старый КИН выбывает из
оборота, новый вводится в оборот;

138
• доступна перемаркировка вложений, входящих в КИН, при этом КИ и КИН должны выть в
статусе «В обороте» (INTRODUCED).
Перемаркировка КИН или КИ в составе КИН недоступна при следующих условиях (документ будет
обработан с ошибкой):
• указании значения DESCRIPTION_ERRORS ("Выявлены ошибки описания товара");
• КИ в статусе "Списан" (WRITTEN_OFF), находящийся в составе КИН;
• указание КИН и вложенных в него КИ в одном документе;
После обработки документа все вложения из предыдущего КИН переходят в новый КИН, при этом
предыдущий КИН переходит в статус "Выбыл" (RETIRED), а новый КИН переходит в статус "В
обороте" (INTRODUCED). Если статус предыдущего КИН "Выбыл" (RETIRED), то все вложения
переходят в новый КИН и вводятся в оборот вместе с КИН.
При перемаркировке КИ в статусе "В обороте" (INTRODUCED) в составе КИН со статусом "В
обороте" (INTRODUCED), КИН не расформировывается, предыдущий КИ списывается, исключается
из КИН и в состав КИН включается новый КИ, при этом GTIN нового и предыдущего КИ должны
совпадать.
При перемаркировке КИ в статусе "Выведен из оборота" (RETIRED) в составе КИН со статусом
"Выведен из оборота" (RETIRED), КИН расформировывается (DISAGGREGATION), предыдущий КИ
списывается (WRITTEN_OFF), а новый КИ вводится в оборот (INTRODUCED).
Тип документа:

Тип Описание
LK_REMARK Перемаркировка. JSON (MANUAL)
LK_REMARK_CSV Перемаркировка. CSV
LK_REMARK_XML Перемаркировка. XML

Пример тела документа в формате JSON:

{
"participant_inn": "0000000000" ,
"remarking_date": "2020-03-03T00:00:00.000Z" ,
"remarking_cause": "KM_SPOILED" ,
"products": [
{
"certificate_document": "CONFORMITY_CERTIFICATE" ,
"certificate_document_number": "cert num" ,
"certificate_document_date": "2019-01-01" ,
"last_uin": "00000000000000000000000000000000000001" ,
"new_uin": "00000000000000000000000000000000000002" ,
"remarking_date": "2020-03-03T00:00:00.000Z" ,
"remarking_cause": "KM_SPOILED" ,
"primary_document_date": "2020-12-31" ,
"primary_document_number": "primary doc num" ,
"primary_document_type": "SALES_RECEIPT" ,

139
 "primary_document_custom_name": "CUSTOM" ,
"tnved_10": "0000000000" ,
"paid": true,
"production_country": "156",
"color": "RED",
"product_size": "20.5"
}
]
}

Параметры документа:

Параметр Тип Обяз. Описание Комментарий

participant_inn string + ИНН УОТ
(10, 12)
remarking_date string + Дата Задаётся в формате 2020-03-03T00:00:00.000Z
перемаркировки
remarking_cause string + Код причины Возможные значения:
перемаркировки KM_SPOILED – испорчено либо утеряно СИ с
КМ;
DESCRIPTION_ERRORS – выявлены ошибки
описания товара ;
RETAIL_RETURN – возврат товаров с
поврежденным СИ/без СИ при розничной
реализации (возврат от розничного покупателя);
REMOTE_SALE_RETURN - возврат товаров с
поврежденным СИ/без СИ при дистанционном
способе продажи (возврат в случае
дистанционной продажи);
LEGAL_RETURN - возврат от конечного
покупателя (юр. лица/ИП);
INTERNAL_RETURN - решение о реализации
товаров, приобретённых в целях, не связанных
с их реализацией;
EEC_EXPORT_RETURN - возврат ранее
экспортированного в ЕАЭС
products array + Список сведений
о товарах
*remarking_date string + Дата Задаётся в формате 2020-03-03T00:00:00.000Z
перемаркировки
*remarking_cause string + Код причины Возможные значения:
перемаркировки KM_SPOILED – испорчено либо утеряно СИ с
КМ;
DESCRIPTION_ERRORS – выявлены ошибки
описания товара ;
RETAIL_RETURN – возврат товаров с
поврежденным СИ/без СИ при розничной
реализации (возврат от розничного покупателя);
REMOTE_SALE_RETURN - возврат товаров с
поврежденным СИ/без СИ при дистанционном
способе продажи (возврат в случае
дистанционной продажи);

140
Параметр Тип Обяз. Описание Комментарий
LEGAL_RETURN - возврат от конечного
покупателя (юр. лица/ИП);
INTERNAL_RETURN - решение о реализации
товаров, приобретённых в целях, не связанных
с их реализацией;
EEC_EXPORT_RETURN - возврат ранее
экспортированного в ЕАЭС
*certificate_document string - Код вида Возможные значения:
документа CONFORMITY_CERTIFICATE – сертификат
обязательной соответствия;
сертификации CONFORMITY_DECLARATION – декларация
соответствия
certificate_document_number string - Номер документа
обязательной
сертификации
*certificate_document_date string - Дата документа Задаётся в формате yyyy-MM-dd Диапазон
обязательной даты, начиная с 2000-01-01 по дату создания
сертификации документа
*last_uin string - Предыдущий Параметр обязателен, если "remarking_cause" =
КИ/КИК/КИН DESCRIPTION_ERRORS. Для КИН параметр
обязателен, если "remarking_cause" принимает
любое из следующих значений:
KM_SPOILED – испорчено либо утеряно СИ с
КМ;
DESCRIPTION_ERRORS – выявлены ошибки
описания товара;
RETAIL_RETURN – возврат товаров с
поврежденным СИ/без СИ при розничной
реализации (возврат от розничного покупателя);
REMOTE_SALE_RETURN - возврат товаров с
поврежденным СИ/без СИ при дистанционном
способе продажи (возврат в случае
дистанционной продажи);
LEGAL_RETURN - возврат товара от конечного
покупателя ЮЛ/ИП;
INTERNAL_RETURN - решение о реализации
приобретённого ранее товара без цели
дальнейшей реализации;
EEC_EXPORT_RETURN - экспорт в страны
ЕАЭС.
Предыдущий КИ должен быть в статусе "В
обороте" (INTRODUCED) или RETIRED
("Выбыл").

*new_uin string + Новый Повторный ввод в оборот возможен, если не

КИ/КИК/КИН указаны предыдущие КИ/КИК/КИН. Новый
КИ/КИК/КИН должен быть только в статусе
"Эмитирован. Получен" (APPLIED) с типом
эмиссии "Перемаркировка" (REMARK)

141
Параметр Тип Обяз. Описание Комментарий
*primary_document_type enum - Вид первичного Параметр не заполняется или заполняется
документа вместе с параметрами
"primary_document_number" и
"primary_document_date".
Возможные значения, если "remarking_cause" =
RETAIL_RETURN или
REMOTE_SALE_RETURN:
RECEIPT – кассовый чек;
SALES_RECEIPT – товарный чек;
OTHER – прочее.

Возможные значения, если "remarking_cause" =

LEGAL_RETURN или
EEC_EXPORT_RETURN:
CONSIGNMENT_NOTE - товарная накладная;
UTD - универсальный передаточный документ;
OTHER – прочее.
*primary_document_custom_name string - Наименование
первичного
документа
*primary_document_date string - Дата первичного Задаётся в формате yyyy-mm-dd
(date- документа
time)
*primary_document_number string - Номер
первичного
документа
*tnved_10 integer + Код товарной Не указывается для КИН
номенклатуры
(10 знаков)
*paid boolean - Товар оплачен Признак оплаты товара:
true – оплачен;
false – не оплачен.
Параметр устаревший и в дальнейшем будет
удалён
*production_country string - Страна Не заполняется для КИН. Указывается код
производства страны в соответствии с ОКСМ (например: 112
– Республика Беларусь).
Параметр не указывается для ТГ "Шины и
покрышки пневматические резиновые новые"
*color string - Цвет Не заполняется для КИН. Указывается значение
цвета, содержащее от 1 до 1024 буквенных
символа на английском или русском языке.
Параметр используется только для ТГ
"Обувные товары"
*product_size string - Размер Не заполняется для КИН. Указывается значение
размера обувных товаров, содержащее от 1 до
1024 буквенных символа, на английском или
русском языке (например: 37RUS/6US).

142
Параметр Тип Обяз. Описание Комментарий
Возможно указание одного размера, указание
диапазона размеров недоступно. Параметр
используется только для ТГ "Обувные товары"

Пример тела документа в формате CSV:

ИНН участника оборота,Дата перемаркировки,Причина перемаркировки,Версия
0000000000,01.12.2020,"Возврат ранее экспортированного в ЕАЭС",6
Параметры товаров
Предыдущий КИ,Новый КИ,Код товарной номерклатуры,Дата перемаркировки,Товар оплачен,Тип
первичного документа,Наименование первичного документа,Номер первичного документа,Дата
первичного документа,"Вид документа, подтверждающего соответствие","Номер документа,
подтверждающего соответствие","Дата документа, подтверждающего соответствие",Страна
производства, Цвет, Размер
"010464004346012421kFcUz=uwp6'+O","010290000971225721QPM9oiG<NzY'm",6106100000,01.12.20
20,,Товарная накладная,435,4526,03.12.2020,,,,156,RED,20.5
"","010290000971225721j9/IUjWbBifB1",6106100000,01.12.2020,,,,,,,,,156,RED,20.5

Пример тела документа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<remark version="6">
<trade_participant_inn>0000000000</trade_participant_inn>
<remark_date>03.12.2020</remark_date>
<remark_cause>EEC_EXPORT_RETURN</remark_cause>
<products_list>
<!--1 or more repetitions:-->
<product>
<last_ki>0104640043460650219p5w5t3Oc-Fxi</last_ki>
<new_ki>010464004346023021M,hdz?KtNz6M;</new_ki>
<tnved_code_10>6401929000</tnved_code_10>
<production_country>156</production_country>
<color>Черный</color>
<product_size>78,5</product_size>
<remark_date>03.12.2020</remark_date>
<paid>false</paid>
<primary_document_type>OTHER</primary_document_type>
<primary_document_custom_name>Товарная накладная #
35</primary_document_custom_name>
<primary_document_number>156_8878</primary_document_number>
<!-- Optional: -->
<primary_document_date>02.02.2020</primary_document_date>
<!-- Optional: -->
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<!--Optional:-->
<certificate_number>certnum</certificate_number>
<!--Optional:-->
<certificate_date>03.03.2020</certificate_date>
</product>
<product>
<!-- <last_ki>0104640043460650217cyDIM&WGeOH+</last_ki> -->
<new_ki>010464004346023021IriDDSqYN=BaM</new_ki>
<tnved_code_10>6401929000</tnved_code_10>

143
 <production_country>156</production_country>
<color>Красный</color>
<product_size>15-17</product_size>
<remark_date>03.12.2020</remark_date>
<paid>true</paid>
<primary_document_type>UTD</primary_document_type>
<primary_document_custom_name>Товарная накладная #
35</primary_document_custom_name>
<primary_document_number>156_8878</primary_document_number>
<!-- Optional: -->
<primary_document_date>02.02.2020</primary_document_date>
<!-- Optional: -->
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<!--Optional:-->
<certificate_number>certnum</certificate_number>
<!--Optional:-->
<certificate_date>03.03.2020</certificate_date>
</product>
</products_list>
</remark>

4.2.12. Агрегирование (ТГ "Табачная продукция", "Альтернативная табачная продукция" и

"Никотиносодержащая продукция")
Подача сведений в документе агрегации доступна для товарных групп "Табачная продукция",
"Альтернативная табачная продукция" и "Никотиносодержащая продукция".
Тип документа:

Тип Описание
AGGREGATION_DOCUMENT Документ агрегации. JSON
AGGREGATION_DOCUMENT Документ агрегации. XML

Тип приватности: приватный

URL: /documents/aggregation/create
Метод: POST
Пример запроса для документа в формате * .xml:
curl -X POST '<url стенда>/documents/aggregation/create'
--header 'X-Signature: <string>'
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Bearer <Токен>'
--form 'xmlFile=@"/C:/Users/79278/Desktop/XXX.xml'

Пример запроса для документа в формате * .json:

curl -X POST '<url стенда>/documents/aggregation/create'
--header 'X-Signature: <string>'
--header 'Content-Type: multipart/form-data' \

144
--header 'Authorization: Bearer <Токен>'
--form 'jsonFile=@"/C:/Users/79278/Desktop/XXX.json'

Параметры запроса:

Тип
Параметр Тип параметра Обяз. Описание
X- string + Закодированная откреплённая
Signature подпись в формате base64
xmlFile file - Параметр тела запроса в формате Прикреплённый документ подачи сведения по
xml агрегации в формате * .xml
jsonFile file - Параметр тела запроса в формате Прикреплённый документ подачи сведения по
json агрегации в формате *. json

Примечание: в запросе указывается только один из параметров: "xmlFile" или "jsonFile".

Пример xmlFile для запроса:
<Файл ИмяФайла="MTTPS-60_2018-01-31_7715253980_321239e4-c696-4ddd-a6de-6306a177cd51"
ВерсияПрограммы="string">
<Уведомление>
<СведенияОбАгрегации Дата="31.12.2019" Время="21:44:14">
<ИНН>
<!--You have a CHOICE of the next 2 items at this level-->
<!-- <ИННФЛТип>771525398012</ИННФЛТип>-->
<ИННЮЛТип>000000000</ИННЮЛТип>
</ИНН>
<!--1 or more repetitions:-->
<!-- Пачки в блок-->
<ИнформацияОбАгрегировании ТипУпаковки="Потребительская"
КодГрупповойУпаковки="0104606203099597210jagTz!">
<СписокКодовИдентификации>00606203099580F7Vulb6 00606203099580vQ.JVaQ
04606203099580F&lt;CG0a=</СписокКодовИдентификации>
</ИнформацияОбАгрегировании>
<!-- Блок в короб-->
<ИнформацияОбАгрегировании ТипУпаковки="Транспортная"
КодГрупповойУпаковки="0104606203099603222411200320107E22082040">
<СписокКодовИдентификации>0104606203099597210jagTz!
0104606203099597210jagZz!</СписокКодовИдентификации>
</ИнформацияОбАгрегировании>
<!-- Короб в паллету-->
<ИнформацияОбАгрегировании ТипУпаковки="Транспортная"
КодГрупповойУпаковки="00147600887000000010">

<СписокКодовИдентификации>0104606203099603222411200320107E22082040</СписокКодовИдентифи
кации>
</ИнформацияОбАгрегировании>
</СведенияОбАгрегации>
</Уведомление>
</Файл>

Параметры документа в формате XML

145
 Тип
Параметр значения Тип Обяз. Описание
Уведомление element + Документ уведомление, предоставленный в
информационную систему
*СведенияОбАгрегации element + Информация об агрегировании потребительских упаковок
в групповую упаковку может передаваться одновременно
с информацией об агрегировании упаковок в
транспортную упаковку до передачи агрегированной
упаковки следующему участнику оборота табачной
продукции
**Дата attribute string + Задается в формате ДД.ММ.ГГГГ (01.01.1900 - 31.12.2099)
**Время attribute string + Задается в формате чч:мм:сс
**ИНН element + ИНН
***ИННЮЛТип element string - ИНН организации
***ИННФЛТип element string - ИНН физического лица
**ИнформацияОбАгрегировании element + Описание упаковки маркируемой продукции в групповую
упаковку или транспортную упаковку. Коды указываются
списком с пробелом в качестве разделителя
***ТипУпаковки attribute string + Тип упаковки: транспортная
(Короб/Палетта)/потребительская (По умолчанию)
***КодГрупповойУпаковки attribute string + Код групповой упаковки
***СписокКодовИдентификации element string + Список КИ. Разделитель пробел

Пример документа в формате JSON:

{
"participantId": "123",
"dateDoc": 1615373054000,
"productionLineId": "-",
"aggregationUnits": [
{
"aggregationType": "AGGREGATION",
"unitSerialNumber": "(01)00000046229205(21)jM41Y5m",
"aggregatedItemsCount": 1,
"aggregationUnitCapacity": 1,
"sntins": [
"04600266008107zhae28h"
]
}
]
}

Параметры документа в формате JSON

Параметр Тип Обяз. Описание Комментарий

participantId string + ID участника оборота ID участника оборота товаров указан в

146
Параметр Тип Обяз. Описание Комментарий
товаров профиле ЛК ГИС МТ
dateDoc integer + Дата и время
формирования
документа
productionLineId string + ID производственной
линии
aggregationUnits array[string] + Список формируемых
агрегатов
*aggregationType string + Код типа агрегации Значение может быть только
"AGGREGATION"
*unitSerialNumber string + Код идентификации КИ может содержать от 18 до 74 символов
агрегата включительно: цифры, буквы латинского
алфавита, спецсимволы (A-Z a-z 0-9 % & ' " ( )
* + , - _ . / : ; < = > ? !)
*aggregatedItemsCount integer + Агрегируемое
количество КИ
*aggregationUnitCapacity integer + Ёмкость агрегата (кол-
во вложенных КИ)
*sntins array[string] + Список КИ, входящих Статусы КИ, входящих в состав агрегата,
в состав агрегат должны быть идентичны

Пример ответа:
1.Код 200. В случае успеха:
{
"id": "string"
}

2.В случае ошибок.

2.1. Код 400: "Документ {0} не прошел валидацию по XSD схеме".
{
"error_message": "Документ {0} не прошел валидацию по XSD схеме"
}

2.2. Код 400: "Должно быть заполнено одно поле xmlFile или jsonFile".
{
"error_message": "Должно быть заполнено одно поле xmlFile или jsonFile"
}

2.3. Код 422: "Ошибка проверки подписи"

{
"error_message": "Ошибка проверки подписи"
}

147
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа, прошедшего проверку
error_message string - Текст сообщения об ошибке при обработке Параметр возвращается при наличии
запроса ошибки

4.2.13. Выбытие (ТГ "Табачная продукция", "Альтернативная табачная продукция" и

"Никотиносодержащая продукция")
Приём сведений в документе выбытия доступен для ТГ "Табачная продукция", "Альтернативная
табачная продукция" и "Никотиносодержащая продукция".
Тип документа:

Тип Описание
WRITE_OFF Документ списания. XML
WRITE_OFF Документ списания. JSON

Тип приватности: приватный

URL: /documents/dropped-out/create
Метод: POST
Пример запроса для документа в формате * .xml:
curl -X POST '<url стенда>/documents/dropped-out/create'
--header 'X-Signature: <string>'
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Bearer <Токен>'
--form 'xmlFile=@/C:/Users/Desktop/XXX.xml'

Пример запроса для документа в формате * .json:

curl -X POST '<url стенда>/documents/dropped-out/create'
--header 'X-Signature: <string>'
--header 'Content-Type: multipart/form-data' \
--header 'Authorization: Bearer <Токен>'
--form 'jsonFile=@/C:/Users/Desktop/XXX.json'

Параметры запроса:

Тип
Параметр Тип параметра Обяз. Описание
X- string + Закодированная откреплённая
Signature подпись в формате base64

148
 Тип
Параметр Тип параметра Обяз. Описание
xmlFile file - Параметр тела запроса в формате xml Прикреплённый документ подачи сведения о
списании в формате * .xml
jsonFile file - Параметр тела запроса в формате json Прикреплённый документ подачи сведения о
списании в формате *. json

Примечание: в запросе указывается только один из параметров: "xmlFile" или "jsonFile".

Пример документа в формате * .xml:
<Файл ИмяФайла="MTTPS-90_2018-01-31_7715253980_321239e4-c696-4ddd-a6de-6306a177cd51"
ВерсияПрограммы="string">
<Уведомление>
<!--You have a CHOICE of the next 2 items at this level-->
<СведенияОВыбытии ПричинаВыбытия="5. Тестирование продукта"
СтоимостьВыводимойПродукции="1000.0000000000000">
<ИНН>
<ИННЮЛТип>7715253980</ИННЮЛТип>
</ИНН>
<ПервичныйДокумент Наименование="Поставка рекламы" Номер="234234"
Дата="31.12.2019" Время="10:36:28"/>
<АдресПлощадки>
<!--You have a CHOICE of the next 3 items at this level-->
<АдрРФ Индекс="string" КодРегион="st" Район="string" Город="string"
НаселПункт="string" Улица="string" Дом="string" Корпус="string" Кварт="string"/>
<!-- <АдрИнф КодСтр="str" АдрТекст="string"/>-->
<!-- <КодФИАС>8e632d08-2d65-42e2-b1de-38b435243cea</КодФИАС>-->
</АдресПлощадки>
<КодыИдентификации СписыватьВложения="true">
<Список>04606203099580vQ.JVaQ 04606203099580vQ.JVaQ
04606203099580vQ.JVaQ</Список>
</КодыИдентификации>
</СведенияОВыбытии>
</Уведомление>
</Файл>

Параметры документа в формате XML

Тип
Параметр значения Тип Обяз. Описание
Уведомление element + Документ уведомление, предоставленный в
информационную систему
*СведенияОВыбытии element + При выводе табачной продукции из оборота по
основаниям, не являющимся продажей в розницу,
участник оборота табачной продукции,
осуществляющий вывод из оборота этой продукции,
представляет в информационную систему
мониторинга уведомление о выводе табачной
продукции из оборота

149
 Тип
Параметр значения Тип Обяз. Описание
**ПричинаВыбытия attribute string + Причина вывода табачной продукции из оборота:
"0. Брак";
"1. Истек срок годности";
"2. Лабораторные образцы";
"3. Отзыв с рынка";
"4. Рекламации";
"5. Тестирование продукта";
"6. Демонстрационные образцы";
"7. Другие причины";
"9. Недостача";
"16. Уничтожение";
"17. Конфискация";
"18. Ликвидация предприятия"
**СтоимостьВыводимойПродукции attribute decimal - Стоимость в рублях. Число десятичное, содержащее
до 17 разрядов, два после запятой Содержит только
цифры. Например 10000,50 десять тысяч рублей
пятьдесят копеек
*ИНН element + ИНН
**ИННЮЛТип element string + ИНН организации
*ПервичныйДокумент element + Информация о первичном документе
**Наименование attribute string + Наименование первичного документа о выбытии
табачной продукции из оборота
**Номер attribute string + Номер первичного документа о выбытии табачной
продукции из оборота
**Дата attribute string + Дата первичного документа о выбытии табачной
продукции из оборота. Задается в формате
ДД.ММ.ГГГГ (01.01.1900 - 31.12.2099)
**Время attribute string + Время первичного документа о выбытии табачной
продукции из оборота. Задается в формате чч:мм:сс
*АдресПлощадки element + Сведения об адресе
**АдрРФ element - Адрес в Российской Федерации
***Индекс attribute string - Индекс. 6 знаков
***КодРегион attribute string - Код из Справочника субъекта Российской Федерации.
2 знака
***Район attribute string - Район
***Город attribute string - Город
***НаселПункт attribute string - Населенный пункт
***Улица attribute string - Улица
***Дом attribute string - Дом
***Корпус attribute string - Корпус

150
 Тип
Параметр значения Тип Обяз. Описание
***Кварт attribute string - Квартира
**АдрИнф element - Адрес за пределами территории Российской
Федерации
***КодСтр attribute string + Код из Общероссийского классификатора стран мира.
3 знака
***АдрТекст attribute string + Адрес
**КодФИАС element string - Уникальный номер адреса объекта адресации в
государственном адресном реестре. 36 знаков
*КодыИдентификации element + Коды идентификации табачной продукции,
выводимой из оборота. В случае кодов упаковок при
необходимости списывания без вложений,
необходимо создать дополнительный список с
атрибутом СписыватьВложения=false
**СписыватьВложения attribute boolean - Атрибут указывается для кода идентификации
**Список element string - Список КИ

Пример документа в формате JSON:

{
"address": "432008 73 Засвияжский Ульяновск Ульяновск Доватора 1 1 1",
"participantId": "780",
"sourceDocNum": "234234",
"sourceDocDate": "YYYY.MM.DD",
"dropoutReason": "string",
"withChild": true,
"sntins": [
"00000046229205cSlT5FdosB2a1636S1hBcjZI"
]
}

Параметры документа в формате JSON

Параметр Тип Обяз. Описание Комментарий

address string + Адрес Длина значения: (0-256 символов)
participantId string + ID участника оборота товаров D участника оборота товаров указан в профиле
ЛК ГИС МТ
sourceDocNum string + Номер первичного документа
sourceDocDate string + Дата первичного документа Формат: YYYY.MM.DD
dropoutReason string + Причина списания См. "Справочник "Причины вывода из оборота""
withChild boolean + Списание с дочерними
документами
sntins array[string] + Списываемые КИ

151
Пример ответа:
1.Код 200 в случае успеха:
{
"id": "string"
}

2.В случае ошибок:

2.1. Код 400: "Документ {0} не прошел валидацию по XSD схеме"
{
"error_message": "Документ {0} не прошел валидацию по XSD схеме"
}

2.2. Код 400: "Должно быть заполнено одно поле xmlFile или jsonFile"
{
"error_message": "Должно быть заполнено одно поле xmlFile или jsonFile"
}

2.3. Код 422: "Ошибка проверки подписи"

{
"error_message": "Ошибка проверки подписи"
}

2.4. Код 500: "Произошла внутренняя ошибка"

{
"error_message": "Произошла внутренняя ошибка"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа, прошедшего проверку
error_message - string Текст сообщения об ошибке при обработке Параметр возвращается при наличии
запроса ошибки

152
5. Методы получения сведений о КИ и маркированных товарах
При необходимости выгрузки сведений больших объёмов необходимо использовать методы сервиса
выгрузок, описанные в разделе "Методы формирования выгрузок данных из ГИС МТ"

5.1. Получение данных о КИ

5.1.1. Метод получения краткой информации о списке КИ по заданному фильтру

Метод недоступен для ТГ "Табачная продукция" и "Альтернативная табачная продукция".
URL: /cises/listV2
Тип приватности: приватный
Метод: GET
Пример запроса:
curl -X GET '<url стенда>/cises/listV2"
-H 'Authorization: Bearer <ТОКЕН>'

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

cis string - КИ ГИС МТ
cisStatus string - Код статуса КИ Актуальные статусы см. Справочник "Статусы КИ"
gtin string - код товара Если код товара менее 14 символов, то он дополняется
ведущими нулями
sn string - Серийный номер
кода идентификации
tnVed10 string - 10-ти значный код
ТН ВЭД
emissionDateFrom string - Дата эмиссии от Задается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z. Не
(date- допускается указание даты, превышающей текущую
time)
emissionDateTo string - Дата эмиссии до Задается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z При
(date- установке выборе дат "emissionDateFrom" и
time) "emissionDateTo" больше текущей, выводится пустой
список Запрос обрабатывается успешно при выборе
будущего значения даты "emissionDateTo"
emissionType string - Код типа Тип эмиссии:
производства LOCAL – производство РФ;
FOREIGN – ввезен в РФ;
REMAINS – маркировка остатков;
CROSSBORDER – ввезен из стран ЕАЭС.
См."Справочник "Типы эмиссии КИ"

153
Параметр Тип Обяз. Описание Комментарий
withdrawReason string - Причина вывода из Причина вывода из оборота:
оборота KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен;
DESCRIPTION_ERRORS - выявлены ошибки описания
товара;
RETAIL – розничная продажа;
EEC_EXPORT – экспорт в страны ЕАЭС;
BEYOND_EEC_EXPORT – экспорт за пределы стран
ЕАЭС;
RETURN – возврат физическому лицу;
REMOTE_SALE – продажа по образцам, дистанционный
способ продажи;
DAMAGE_LOSS – утрата или повреждение;
DESTRUCTION – уничтожение;
CONFISCATION – конфискация;
LIQUIDATION – ликвидация предприятия;
DONATION – безвозмездная передача;
STATE_ENTERPRISE – приобретение государственным
предприятием;
NO_RETAIL_USE – использование для собственных
нужд покупателем;
ENTERPRISE_USE – использование для собственных
нужд предприятия;
KM_SPOILED_OR_LOST – испорчен либо утерян СИ с
КИ;
KM_CANCELLATION – аннулирование не
преобразованных в СИ с КИ по истечении срока;
KM_CANCELLATION_BY_TERM – аннулирование не
преобразованных в СИ с КИ по истечении срока;
RETAIL_RETURN – возврат товаров с поврежденным
СИ/без СИ при розничной реализации;
REMOTE_SALE_RETURN – возврат товаров с
поврежденным СИ/без СИ при дистанционном способе
продажи
packs string - Фильтрация по Возможные значения:
единичным ALL – товары и упаковки;
товарным упаковкам UNIT – только товары (UNIT, BUNDLE);
PACK – только упаковки (LEVEL1, LEVEL2, LEVEL3,
LEVEL4, LEVEL5, ATK, SET).
См. "Справочник "Типы упаковки"".
remarkHistory string - Фильтрация по Возможные значения:
истории ALL - (вся история) - выводятся предыдущие и новые
перемаркировки КИ КИ, связанные с КИ, указанным в параметре "cis";
ENTERED - (указанный) - выводится только указанный в
параметре "cis" КИ;
ENTERED_AND_LAST (указанный и последний) -
выводится только указанный в параметре "cis" КИ и
последний в истории перемаркировки КИ.
cisAggregationState string - Состояние КИ Состояние КИ:
PACKED- в агрегате (агрегирован);
NOT_PACKED – не в агрегате (дезагрегирован);

154
Параметр Тип Обяз. Описание Комментарий
ANY – любое состояние
pg string - Товарная группа параметр обязательно указывать для товарных групп:
milk – Молочная продукция;
water – Упакованная вода
order string - Направление Направление сортировки:
сортировки ASC – по возрастанию;
DESC – по убыванию
producerInn string - ИНН Российского
производителя в
МОТП
uit string - Уникальный "точка отсчета"(запись, с которой начнется выборка), по
идентификатор которому сортируются записи. Использовать только
товара (УИТ) совместно с параметром orderedColumnValue
orderedColumnValue string - Значение столбца Значение столбца, "точки отсчета" (запись, с которой
начинается выборка), по которому сортируются записи.
Использовать только совместно с параметром uit
orderColumn string - Название столбца, по Допустимое значение emd - дата эмиссии
которому будет
производиться
сортировка.
limit integer - Максимальное Максимальное количество записей, которое вернется в
количество записей качестве ответа, не более 10000 записей. (По умолчанию
10 записей)
pageDir [string] - Выбор направления PREV – Предыдущий раздел;
NEXT – Следующий раздел

Параметры заголовка запроса: Authorization: Bearer <token>

Пример ответа:
{
"results": [
{
"cis": "string",
"gtin": "string",
"tnVedEaes": 0,
"tnVedEaesGroup": 0,
"productName": "string",
"emissionDate": "2020-04-16T09:29:01.120Z",
"receiptDate": "2020-04-16T09:29:01.120Z",
"ownerInn": "string",
"ownerName": "string",
"status": "string",
"emissionType": "string",
"countChildren": 0,
"cisChildren": [
"string"
],

155
 "packType": "string",
"parent": "string",
"prevCis": [
"string"
],
"productGroup": "string",
"expireDate": "2020-01-23T16:17:48Z",
"agentName": "string"
}
],
"total": 0
}

Параметры ответа:

Параметр Тип Обяз. Описание

total integer + Общее количество значений, подходящие под параметры фильтрации
(int64)
results: +
*cis string - КИ товара
*countChildren integer - Количество дочерних КИ
(int32)
*cisChildren [string] - Список дочерних КИ
*emissionDate string (date- - Дата эмиссии. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
*gtin string - Код товара
*ownerInn string - ИНН собственника товара
*ownerName string - Наименование собственника товара
*packType string - Тип упаковки. см. Справочник "Типы упаковки"
*parent string - Код идентификации упаковки, в которую агрегирован товар
*productName string - Название продукта
*status enum - Статус товара/КИ:
EMITTED – эмитирован. Выпущен;
APPLIED – эмитирован. Получен;
INTRODUCED – в обороте;
WRITTEN_OFF – КИ списан;
RETIRED – выбыл;
DISAGGREGATION – расформирован (только для упаковок)
*emissionType string - Тип эмиссии:
LOCAL – производство РФ;
FOREIGN – ввезен в РФ;
REMAINS – маркировка остатков;
CROSSBORDER – ввезен из стран ЕАЭС.
См."Справочник "Типы эмиссии КИ"
*prevCises [string] - Массив предыдущих КИ в случае перемаркировки товара
*receiptDate string (date- - Дата вывода из оборота. Возвращается в формате yyyy-MM-

156
Параметр Тип Обяз. Описание
time) ddTHH:mm:ss.SSS’Z
*tnVedEaes string - Код товарной номенклатуры (10 знаков)
*tnVedEaesGroup string - Код товарной позиции ТН ВЭД ЕАЭС товара
*productGroup string - Товарная группа
*expireDate string (date- - Дата истечения срока годности. В формате yyyy-MM-ddTHH:mm:ss.SSS’Z
time) (обязательный для ТГ "Молочная продукция")
*agentName string - Наименование текущего владельца товара (обязательный для ТГ "Молочная
продукция")

5.1.2. Метод получения подробной информации о списке КИ товаров по заданному фильтру

Не используется ТГ "Табачная продукция" и "Альтернативная табачная продукция".
Метод возвращает список товаров с подробной информацией, которые доступны в данный момент
времени участнику оборота товаров (ИНН организации содержится в токене), согласно заданному
фильтру.
Тип приватности: приватный
URL: /products/listV2
Метод: GET
Пример запроса:
curl -X GET
'<url
стенда>/products/listV2?cache=string&cis=string&cisAggregationState=string&cisPackageTy
pe=string&cisStatus=string"
-H "accept: */*" -H "Authorization: Bearer <Токен>

Параметры заголовка запроса: -H 'Authorization: Bearer <ТОКЕН>'

Параметры запроса:

Параметр Тип Обяз. Описание

childrenPage number - Номер страницы вложений в агрегат первого слоя. Значение по
умолчанию: 1. Не используется товарной группой "Табачная продукция"
childrenLimit number - Размер страницы вложений в агрегат первого слоя. Значение по
умолчанию: 50. Не используется товарной группой "Табачная продукция"
pg array - Товарная группа:
параметр обязательно указывать для товарных групп:
milk – Молочная продукция;
water – Упакованная вода
cache boolean - Флаг использование кэша. При включенном флаге УОТ получает в ответ

157
Параметр Тип Обяз. Описание
не более установленного лимита кода идентификации 1524
cis string - Код идентификации, используемый для фильтрации по списку КИ
cisMatchMode string - Режим фильтрации по КИ:
EQ - полностью равен;
LIKE - содержит в себе;
Start_with - начинается с
emissionDateFrom string (date- - Дата эмиссии, от. Задается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
emissionDateTo string (date- - Дата эмиссии, до. Задается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
gtin string - Код товара
producerInn string - ИНН производителя
sn string - Серийный номер кода идентификации
ownerInn string - ИНН владельца
cisPackageType enum - Тип упаковки. см. Справочник "Типы упаковки"
tnVed10 string - Код товарной номенклатуры (10 знаков)
emissionType string - Тип эмиссии:
LOCAL – производство РФ;
FOREIGN – ввезен в РФ;
REMAINS – маркировка остатков;
CROSSBORDER – ввезен из стран ЕАЭС.
См."Справочник "Типы эмиссии КИ"
pageDir string - Выбор направления:
PREV – предыдущий раздел;
NEXT – следующий раздел
uit string - Значение КИ, "точки отсчета"(запись, с которой начнется выборка), по
которому сортируются записи. Использовать только совместно с
параметром orderedColumnValue
order string - Направление сортировки:
ASC – по возрастанию;
DESC – по убыванию
orderColumn string - Название столбца, по которому будет производиться сортировка.
Допустимое значение emd - дата эмиссии
orderedColumnValue string - Значение столбца, "точки отсчета" (запись, с которой начинается выборка),
по которому сортируются записи. Использовать только совместно с
параметром uit
limit integer(int64) - Значение устанавливает количество записей в ответе, не более 10000
записей (по умолчанию 10 записей)
packageTypes string - Фильтр по типам упаковок
cisAggregationState enum - Состояние КИ:
PACKED- в агрегате (агрегирован);
NOT_PACKED – не в агрегате (дезагрегирован);

158
Параметр Тип Обяз. Описание
ANY – любое состояние
packs string - Фильтрация по единичным товарным упаковкам. Возможные значения:
ALL – товары и упаковки;
UNIT – только товары (UNIT, BUNDLE);
PACK – только упаковки (LEVEL1, LEVEL2, LEVEL3, LEVEL4, LEVEL5,
ATK, SET). См. "Справочник "Типы упаковки"".
aggregation boolean - Показывать товары и товарные упаковки только в одном статусе для
агрегации
countChildren integer(int32) - Количество единиц товаров в упаковке
tree string - Способ вывода дерева списка КИ/КИТУ:
NO_TREE – Не возвращать вложенные КИ;
ONE_LEVEL – Возвращать только первый уровень вложенности;
ALL_TREE – Возвращать все дерево
uituStatus string - Статус КИТУ
prVetDoc string - Производственный ветеринарный сопроводительный документ
(обязательный для ТГ "Молочная продукция")
docType string - см. Справочник "Типы документов"
statusExt enum - Дополнительный статус товара:
WAIT_SHIPMENT – ожидает подтверждения приемки;
WAIT_TRANSFER_TO_OWNER – ожидает передачу собственнику
(производство по контракту);
WAIT_REMARK – КИ списан после нанесения на товар (товар ожидает
перемаркировку);
WITHDRAW – вывод из оборота;
REMARK_RETIRED – перемаркирован
cisStatus string - Статус товара/КИ:
INTRODUCED – в обороте;
RETIRED – выбыл
registryType string - Тип реестра
agentInn string - ИНН текущего владельца
previousAgentInn string - ИНН предыдущего владельца
turnoverType enum - Вид товарооборота:
SELLING - продажа;
COMMISSION - комиссия;
AGENT - агент

Пример ответа:
{
"results": [
{
"agentInn": "string",
"agentName": "string",
"children": [
{

159
 "brand": "string",
"children": [
"string"
],
"childrenMap": [
null
],
"cis": "string",
"countChildren": 0,
"emissionDate": "2020-01-23T16:17:48Z",
"expireDate": "2020-01-23T16:17:48Z",
"exporterName": "string",
"exporterTaxpayerId": "string",
"sgtin": "string",
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
"packageType": "string",
"parent": "string",
"prVetDocument": "string",
"prevCises": [
"string"
],
"producedDate": "2020-01-23T16:17:48Z",
"producerName": "string",
"productName": "string",
"status": "string",
"statusEx": "string"
}
],
"cis": "string",
"countChildren": 0,
"dateChange": "2020-01-23T16:17:48Z",
"emissionDate": "2020-01-23T16:17:48Z",
"emissionType": "string",
"expireDate": "2020-01-23T16:17:48Z",
"exporterName": "string",
"exporterTaxpayerId": "string",
"gtin": "string",
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
"packType": "string",
"parent": "string",
"participantInn": "string",
"participantName": "string",
"prVetDocument": "string",
"prevCises": [
"string"

160
 ],
"producedDate": "2020-01-23T16:17:48Z",
"productName": "string",
"receiptDate": "2020-01-23T16:17:48Z",
"sgtin": "string",
"status": "string",
"statusEx": "string",
"tnVedEaes": "string",
"tnVedEaesGroup": "string",
"uit": "string",
"uitu": "string",
"withdrawReason": "string"
}
]
}

Параметры ответа:

Параметр Тип Обяз. Описание

results: +
*agentInn string - ИНН агента или комиссионера
*agentName string - Наименование агента или комиссионера
*children: - КИ в агрегате
**brand string - Бренд
**children: [string] - Все Дочерние КИ. В формате массива JSON
**childrenMap [string] - Краткая информация о дочерних КИ
**cis string + КИ товара
**countChildren integer - Количество дочерних КИ
(int32)
**emissionDate string + Дата эмиссии. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
**expireDate string - Дата истечения срока годности. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z (обязательный для ТГ "Молочная продукция")
time)
**exporterName string - Наименование экспортера
**exporterTaxpayerId string - Уникальный идентификатор экспортера в национальной системе учета
налогоплательщиков
**sgtin string - Индивидуальный идентификационный код потребительской упаковки для
прослеживаемости в (код товара + индивидуальный серийный номер
вторичной (потребительской) упаковки или первичной упаковки, в случае
отсутствия вторичной)
**introducedDate string - Дата ввода в оборот. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
**lastDocId string - Последний регистрационный номер документа, зафиксированный в ГИС МТ

161
Параметр Тип Обяз. Описание
по этому КИ
**nextCises [string] - Следующие номера КИ. В случае перемаркировки товара
**ownerInn string - ИНН собственника товара
**ownerName string - Наименование собственника товара
**packType string + Тип упаковки. Справочник "Типы упаковки"
**parent string - Код идентификации упаковки, в которую агрегирован товар
**prVetDocument string - Производственный ветеринарный сопроводительный документ (обязательный
для ТГ "Молочная продукция")
**prevCises [string] - Предыдущие КИ. В случае перемаркировки товара
**producedDate string - Дата нанесения. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
**producerName string - Производитель товара
**productName string - Название продукта
**status enum + Статус товара/КИ:
EMITTED – эмитирован. Выпущен;
APPLIED – эмитирован. Получен;
INTRODUCED – в обороте;
WRITTEN_OFF – КИ списан;
RETIRED – выбыл;
DISAGGREGATION – расформирован (только для упаковок)
**statusEx enum - Актуальные особые состояния КИ см. Справочник "Статусы КИ"
cis string + Код идентификации, используемый для фильтрации по списку КИ
countChildren integer - Количество дочерних КИ
(int32)
dateChange string - Дата внесения изменений в КИТУ. В формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
emissionDate string + Дата эмиссии КИ. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
emissionType string + Тип эмиссии:
LOCAL – производство РФ;
FOREIGN – ввезен в РФ;
REMAINS – маркировка остатков;
CROSSBORDER – ввезен из стран ЕАЭС.
См."Справочник "Типы эмиссии КИ"
expireDate string - Дата истечения срока годности. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z (обязательный для ТГ "Молочная продукция")
time)
exporterName string - Наименование экспортера

162
Параметр Тип Обяз. Описание
exporterTaxpayerId string - Уникальный идентификатор экспортера в национальной системе учета
налогоплательщиков
gtin string - Код товара
introducedDate string - Дата ввода в оборот с КИ в оборот. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
lastDocId string - Последний регистрационный номер документа, зафиксированный в ГИС МТ
по этому КИ
nextCises [string] - Следующие номера КИ при перемаркировке
ownerInn string - ИНН собственника товара
ownerName string - Наименование собственника товара
packageType string + Тип упаковки. см. Справочник "Типы упаковки"
parent string - КИТУ вышестоящего уровня
participantInn string - ИНН участника, осуществившего эмиссию КИ
participantName string - Наименование участника оборота товаров
prVetDocument string - Производственный ветеринарный сопроводительный документ (обязательный
для ТГ "Молочная продукция")
prevCises string - Предыдущие номера КИ. В случае перемаркировки товара
producedDate string - Дата ввода товара с КИ в оборот. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
productName string - Наименование товара на этикетке
receiptDate string - Дата вывода из оборота. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
sgtin string - Код товара и Серийный номер КИ
status enum + Статус товара/КИ:
EMITTED – эмитирован. Выпущен;
APPLIED – эмитирован. Получен;
INTRODUCED – в обороте;
WRITTEN_OFF – КИ списан;
RETIRED – выбыл;
DISAGGREGATION – расформирован (только для упаковок)
statusEx enum - Актуальные особые состояния КИ см. Справочник "Статусы КИ"
tnVedEaes string - Код товарной номенклатуры (10 знаков)
tnVedEaesGroup string - Код товарной позиции ТН ВЭД ЕАС товара
uit string - КИ, Обязательный, если не указан uitu
uitu string - КИТУ, Обязательный, если не указан uit
total integer - Общее количество значений, подходящие под параметры фильтрации.
Параметр является устаревшим, планируется удалить из метода.

163
5.1.3. Метод получения общедоступной информации о КИ по списку
Метод возвращает подробную информацию о запрашиваемом списке кодов идентификации товара: в
одном запросе указывается как один КИ, так и несколько КИ (не более 1000 КИ). Коды товарной
группы "Табачная продукция" и "Альтернативная табачная продукция" по блокам можно указывать в
запросах как со скобками, так и без скобок. В ответе код всегда будет со скобками.
Тип приватности:
1. c токеном авторизации
Общедоступная информация:
• информация о КИ;
• данные о производителе;
• дата и время производства;
• текущий статус в обороте;
• текущий собственник в обороте.
URL: /cises/info
Метод: POST
Пример запроса для типа приватности без токена:
POST <url стенда>/cises/info
Content-Type: application/json
["000000462106549pJu6lt", "0100000046210654214u4qrBQ"]

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

cis array[string] + Массив КИ Не более 1000 КИ в массиве
pg string - Товарная группа Параметр обязательно указывать для товарных групп:
milk – "Молочная продукция";
water – "Упакованная вода"

Пример ответа:
1.В случае успеха:
[
{
"cisInfo": {
"requestedCis": "010464004346062921NqdeWAR9u6HHr",
"cis": "010464004346062921NqdeWAR9u6HHr",
"gtin": "04640043460629",
"tnVedEaesGroup": "4011",

164
 "productName": "Шина зимняя BMW",
"productGroupId": 5,
"productGroup": "tires",
"brand": "crpt 1",
"producedDate": "2020-08-04T00:00:00.000Z",
"emissionDate": "2020-12-08T12:17:56.998Z",
"emissionType": "LOCAL",
"packageType": "UNIT",
"ownerInn": "777777777",
"ownerName": "ООО \"ОПЕРАТОР-ЦРПТ\"",
"status": "APPLIED",
"statusEx": "EMPTY",
"producerInn": "0000000000",
"producerName": "ООО \"ОПЕРАТОР-ЦРПТ\"",
"markWithdraw": false,
"certDoc": [
{
"number": "20202077",
"type": "CONFORMITY_CERTIFICATE",
"date": "2021-01-01"
},
{
"number": "20202fddfsfs077",
"type": "CONFORMITY_DECLARATION",
"date": "2022-01-01"
}
]
}
}
]

2 В случае ошибок:
2.1. Код 404 При неизвестных КИ:
[
{
"cisInfo": {
"cis": "<КИ из запроса>",
"gtin": "<GTIN>"
//если есть GTIN
},
"errorMessage1": "КИ не найден",
"errorCode1": "<код ошибки>"
},
{
"cisInfo": {
"cis": "<КИ из запроса>",
"gtin": ""
//если нет GTIN
},
"errorMessageN": "КИ не найден",
"errorCodeN": "<код ошибки>"
}
]

2.2. Код 404 при указании в запросе несуществующих КИ:

165
[
{
"cisInfo": {
"cis": "<КИ из запроса>",
"gtin": "<GTINi>"
//если есть GTINi
},
"errorMessage1": "КИ не найден",
"errorCode1": "<код ошибки>"
},
{
"cisInfo": {
"cis": "<КИ из запроса>",
"gtin": ""
//если нет GTINi
},
"errorMessageN": "КИ не найден",
"errorCodeN": "<код ошибки>"
}
]

2.3. Код 404 при указании в запросе кодов без кодов товара и кодов транспортных упаковок, не
найденных в ТГ:
[
{
"cisInfo": {
"cis": "<КИ из запроса>",
"gtin": "GTIN не найден"
//если GTINi не найден
},
"errorMessage1": "КИ не найден",
"errorCode1": "<код ошибки>"
},
{
"cisInfo": {
"cis": "<КИ из запроса>",
"gtin": ""
//если КИ транспортной упаковки
},
"errorMessageN": "КИ не найден",
"errorCodeN": "<код ошибки>"
}
]

2.4. Код 400 при пустом списке КИ в теле запроса:

{
"error_message": "В запросе не указан ни один КМ"
}

2.5. Код 400 при отсутствии тела запроса:

{
"error_message":"Required request body is missing: public
org.springframework.http.ResponseEntity

166
ru.crpt.trueapi.controller.motp.CisesController.getCisesInfoByCodeList(java.util.List<j
ava.lang.string>)"
}

2.6. Код 400 при неверной структуре JSON в теле запроса:

{
"error_message":"JSON parse error: Cannot deserialize instance of
`java.util.ArrayList` out of START_OBJECT token; nested exception is
com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot
deserialize instance of `java.util.ArrayList` out of START_OBJECT
token\n at [Source: (PushbackInputStream); line: 1, column: 1]"
}

2.7. Код 403 при не подписанном договоре, если на КИ и агрегаты вернулась ошибка 403.
{
"error_message": "отсутствует действующий договор по ТГ"
}

2.8. Код 401: авторизация не пройдена, если указан токе, но он не валиден/

{
"error_message": "Авторизация не пройден"
}

2.9. Код 422 по КИ не может быть возвращена информация, т.к. отсутствует согласие от текущего
владельца КИ
{
"error_message": "Отсутствует доступ к сведениям"
}

2.10 Код 504 в запросе несколько КИ или агрегатов - по всем КИ и агрегатам ошибка, что сервис не
вернул ответ
{
"error_message": "Отсутствует ответ системы"
}

2.11 Код 200 возвращается, если в запросе несколько КИ или агрегатов и на хотя бы один из них
вернулся успешный ответ от системы с получением сведений по КИ или агрегату или на все КИ и
агрегаты вернулись разные ошибки.
При этом, в теле ответа для каждого КИ и агрегата выводится информация с кодом ошибки в
соответствии с причинами возникновения ошибки.
[
{
"cisInfo1": {
"cis": "<КИ1 из запроса>",
"gtin": "<GTINi>"
},
"errorMessage1": "КИ не найден",
"errorCode1": "404"
},

167
 {
"cisInfo2": {
"cis": "<КИ2 из запроса>",
"gtin": "<GTINi>"
},
"errorMessage1": "Отсутствует ответ системы",
"errorCode1": "504"
}
]

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

cisInfo array - Список КИ
*requestedCis string + КИ из запроса При наличии параметра в ответе
*cis string + КИ из ответа
*gtin string + Код товара Если код товара менее 14 символов, то дополняется
ведущими нулями
*tnVedEaes string - 10-значный код ТН ВЭД
*tnVedEaesGroup string - 4-значный код ТН ВЭД
*productName string - Наименование продукции
*productGroupId number - Идентификатор товарной
группы
*productGroup string - Наименование товарной
группы
*brand string - Бренд
*producedDate string - Дата ввода товара в Возвращается в формате yyyy-MM-
(date-time) оборот (дата нанесения ddTHH:mm:ss.SSS’Z
для ТГ «Табачная
продукция» и
"Альтернативная
табачная продукция")
*emissionDate string - Дата эмиссии Возвращается в формате yyyy-MM-
(date-time) ddTHH:mm:ss.SSS’Z
*emissionType string - Тип эмиссии Возможные значения:
LOCAL – производство РФ;
FOREIGN – ввезён в РФ;
REMAINS – маркировка остатков;
CROSSBORDER – ввезён из стран ЕАЭС
*packageType string + Код типа упаковки См. Справочник "Типы упаковки"
*ownerInn string - ИНН собственника Параметр возвращается только владельцу
товара продукции, ФОИВ, Оператору-ЦРПТ и
Администратору
*ownerName string - Наименование Параметр возвращается только владельцу
собственника товара продукции, ФОИВ, Оператору-ЦРПТ и

168
Параметр Тип Обяз. Описание Комментарий
Администратору
*status string + Код статуса КИ См. Справочник "Статусы КИ"
*statusEx string - Актуальное особое Cм. Справочник "Статусы КИ". Не возвращается для
состояние КИ ТГ «Табачная продукция» и «АТП»
*producerInn string - ИНН производителя
*producerName string - Наименование
производителя
*markWithdraw boolean - Зафиксирована розничная
продажа по чеку от
невладельца КИ
*certDoc string - Документ обязательной
сертификации
*type string - Вид документа Возможные значения:
обязательной CONFORMITY_CERTIFICATE - сертификат
сертификации соответствия;
CONFORMITY_DECLARATION - декларация о
соответствии
*number string - Номер документа
обязательной
сертификации
*date string(date) - Дата выдачи документа Формат: yyyy.MM.dd
обязательной
сертификации
*child array - Дочерний КИ в агрегате
[string] при наличии (только 1
слой)
*parent string - Родительский КИ
*maxRetailPrice number - Максимальная цена Возвращается для ТГ «Табачная продукция»,
розничной продажи «Альтернативная табачная продукция» и
«Никотиносодержащая продукция» только для
пачки или блока. Если у блока или пачки
отсутствует МРЦ, то параметр не возвращается. Для
блока значение = maxRetailPrice*количество штук в
блоке. При отсутствии информации в БД выводится
значение NULL //// Если в составе КИ в запросе
присутствует МРЦ, то поиск осуществляется с
учётом МРЦ. Если МРЦ в ГИС МТ найдена и
отличается от МРЦ в составе КИ в запросе, то в
ответе будет получена ошибка "Код не найден".
Если МРЦ в ГИС МТ отсутствует, то поиск КИ
осуществляется без указания МРЦ ////
*producerInn string - ИНН производителя РФ Возвращается только для КИТУ ТГ "Табачная
для ТГ "Табачная продукция" и "АТП", для остальных ТГ не
продукция" и "АТП" возвращается вне зависимости от статуса КИТУ и
типа приватности метода

169
Параметр Тип Обяз. Описание Комментарий
*producerName string - Наименование Возвращается только для КИТУ ТГ "Табачная
производителя РФ продукция" и "АТП", для остальных ТГ не
возвращается вне зависимости от статуса КИТУ и
типа приватности метода
*agentInn string - ИНН агента Возвращается только если участник - агент или КИ
принадлежат агенту. Временное решение до
реализации агентско-комиссионной схемы в УПД
*prVetDocument string - ID производственного Обязательный параметр для ТГ "Молочная
ВСД (для продукции, продукция"
произведённой в РФ) или
ID транспортного ВСД
(для продукции,
произведённой вне РФ)
*exporterName string - Наименование
экспортёра
*expirationDate string - Дата срока годности Возвращается только для ТГ «Молочная продукция»
(date-time)
*partialSaleInfo object - Объект параметров Возвращается для ТГ "Альтернативная табачная
частичного выбытия продукция" (количество в шт) и "Духи и туалетная
вода" (наливная продукция, объем в мл)
**innerUnitCount number - Общее количество Значением параметра является количество/объём
(объем) товара в товара в потребительской упаковке/единице товара
потребительской
упаковке
**soldUnitCount number - Количество (объем) Значением параметра является число выбывших, в
выведенного из оборота том числе от невладельцев, из оборота единиц
товара по КИ употребления из всех чеков. УОТ отображается
информация только по собственным чекам. ФОИВ
доступна информация по всем чекам
**rest number - Количество (объем) Значением параметра является расчётное
товара, доступного к количество/объём оставшихся в потребительской
выводу из оборота по КИ упаковке/единице товара единиц употребления/мл
товара после продажи всеми УОТ. УОТ
отображается информация только по собственным
чекам. ФОИВ доступна информация по всем чекам
**correctRest boolean - Корректность остатка Показатель корректности остатка товара после
товара вывода товара из оборота: false - продано или
возвращено больше допустимого количества/объема
товара; true - продано или возвращено в пределах
допустимого количества/объема товара. Для
товарной группы "Духи и туалетная вода" (наливная
продукция) продажа товара в объеме,
превышающем заявленный, а также превышение
остатка товара более чем на 8% считаются
некорректными
errorMessage string - Сообщение об ошибке См. Справочник "Статусы ответов". Параметр
возвращается при наличии ошибки

170
Параметр Тип Обяз. Описание Комментарий
errorCode string - Код ошибки Параметр возвращается при наличии ошибки

5.1.4. Метод получения краткой общедоступной информации о КИ по списку

Метод возвращает информацию о списке запрашиваемых КИ: в одном запросе можно указать
несколько КИ. КИ для ТГ «Табачная продукция» и «Альтернативная табачная продукция» по блокам
можно указывать в запросах как со скобками, так и без скобок. В ответе код всегда будет
возвращаться со скобками. Запятая не является разделителем для параметров запроса, а считается
частью самого параметра.
Тип приватности:
1. по токену авторизации
Общедоступная информация:
• информация о КИ;
• данные о производителе;
• дата и время производства;
• текущий статус в обороте;
• текущий собственник в обороте – показ только владельцу, ФОИВ, Оператору-ЦРПТ и
Администратору.
URL: /cises/list
Метод: POST
Пример запроса для публичного типа приватности
curl -X POST <url
стенда>/cises/list?values=000000462106549OOv1s0XzlzIFDjtcXJjz5cB&values=00000046210654Q
uHCUeP
Content-Type: application/json
Authorization: Bearer <ТОКЕН>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

values array[string] + Список В списке может быть от 1 до 35 (демонстрационный стенд) - 50
КИ (промышленный стенд) КИ/КИТУ (без/с криптохвостом, криптохвост
перед обработкой удаляется). Список перечисления КИ имеет формат:
<URL>?values=<cis1>[&values=<cisN>]

Пример ответа:

171
1.В случае успеха:
[
{
"requestedCis": "string",
"cis": "string",
"status": "string",
"statusEx": "string",
"gtin": "string",
"productName": "string",
"productGroup": "string",
"productGroupId": 0,
"producedDate": "2021-03-29T19:37:56.693Z",
"packageType": "string",
"producerInn": "string",
"producerName": "string",
"emissionDate": "2021-03-29T19:37:56.693Z",
"emissionType": "string",
"ownerInn": "string",
"ownerName": "string",
"tnVedEaes": "string",
"tnVedEaesGroup": "string",
"parent": "string",
"agentInn": "string",
"child": [
"string"
],
"maxRetailPrice": 0,
"partialSaleInfo": {
"soldUnitCount": 0,
"rest": 0,
"correctRest": true,
"innerUnitCount": 0
}
}
]

2 В случае ошибок:
2.1. Код 404 Если указанный КИ не найден:
{
"error_message": "КИ не найдены"
}

2.2. Код 400 При отсутствии обязательного параметра:

{
"error_message": "Отсутствует обязательный параметр: values"
}

Параметры ответа:

172
Параметр Тип Обяз. Описание Комментарий
requestedCis string - КИ из запроса При наличии параметра в ответе
cis string + КИ
status string + Код статуса КИ См. Справочник "Статусы КИ"
gtin string + Код товара Если код товара менее 14 символов, то он дополняется
ведущими нулями
tnVedEaes string - 10-значный код ТН
ВЭД
productName string - Наименование
продукции
producedDate string - Дата ввода товара в Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date- оборот
time)
packageType string + Код типа упаковки См. Справочник "Типы упаковки"
producerInn string - ИНН Российского Не возвращается для агрегатов (ТГ «Табачная продукция» и
производителя «Альтернативная табачная продукция»)
producerName string - Наименование Не возвращается для агрегатов (ТГ «Табачная продукция» и
производителя «Альтернативная табачная продукция»)
ownerInn string - ИНН собственника Данный параметр возвращается только владельцу
товара продукции, ФОИВ и Оператору. Отображение данных о
владельце настраивается параметром конфигурации.
ownerName string - Наименование Данный параметр возвращается только владельцу
собственника товара продукции, ФОИВ и Оператору. Отображение данных о
владельце настраивается параметром конфигурации.
parent string - Родительский КИ
agentInn string - ИНН агента Возвращается только если участник - агент или КИ
принадлежат агенту. Временное решение до реализации
агентско-комиссионной схемы в УПД
child array - Список дочерних КИ
[string] в агрегате
productGroupId integer - Идентификатор См. Справочник "Список поддерживаемых товарных групп"
товарной группы
productGroup string - Наименование См. Справочник "Список поддерживаемых товарных групп"
товарной группы
*maxRetailPrice number - Максимальная цена Возвращается для ТГ «Табачная продукция»,
розничной продажи «Альтернативная табачная продукция» и
«Никотиносодержащая продукция» только для пачки или
блока. Если у блока или пачки отсутствует МРЦ, то
параметр не возвращается. Для блока значение =
maxRetailPrice*количество штук в блоке. При отсутствии
информации в БД выводится значение NULL //// Если в
составе КИ в запросе присутствует МРЦ, то поиск
осуществляется с учётом МРЦ. Если МРЦ в ГИС МТ
найдена и отличается от МРЦ в составе КИ в запросе, то в
ответе будет получена ошибка "Код не найден". Если МРЦ в

173
Параметр Тип Обяз. Описание Комментарий
ГИС МТ отсутствует, то поиск КИ осуществляется без
указания МРЦ ////
partialSaleInfo object - Объект параметров Возвращается для ТГ "Альтернативная табачная продукция"
частичного выбытия (количество в шт) и "Духи и туалетная вода" (наливная
продукция, объем в мл)
*innerUnitCount number - Общее количество Значением параметра является количество/объём товара в
(объем) товара в потребительской упаковке/единице товара
потребительской
упаковке
*soldUnitCount number - Количество (объем) Значением параметра является число выбывших, в том числе
выведенного из от невладельцев, из оборота единиц употребления из всех
оборота товара по КИ чеков. УОТ отображается информация только по
собственным чекам. ФОИВ доступна информация по всем
чекам
*rest number - Количество (объем) Значением параметра является расчётное количество/объём
товара, доступного к оставшихся в потребительской упаковке/единице товара
выводу из оборота по единиц употребления/мл товара после продажи всеми УОТ.
КИ УОТ отображается информация только по собственным
чекам. ФОИВ доступна информация по всем чекам
*correctRest boolean - Корректность остатка Показатель корректности остатка товара после вывода
товара товара из оборота: false - продано или возвращено больше
допустимого количества/объема товара; true - продано или
возвращено в пределах допустимого количества/объема
товара. Для товарной группы "Духи и туалетная вода"
(наливная продукция) продажа товара в объеме,
превышающем заявленный, а также превышение остатка
товара более чем на 8% считаются некорректными

5.2. Метод получения истории движения КИ

Метод возвращает информацию о движении (истории) запрашиваемых КИ (в одном запросе
указывается один КИ) по событиям, в которых УОТ принимал участие, чей токен используется при
выполнении запроса.
Каждый участник оборота товаров видит производителя продукции, своего продавца и текущего
владельца. Если данных участника оборота товаров, сформировавшего запрос, нет в цепочке
движения товара, то возвращаются только данные о производителе и текущем владельце. Если КИ
выведен из оборота, то вместо данных о текущем владельца возвращается соответствующая
информация.
Тип приватности:
1. Приватный;
2. Для производителей продукции;
3. Для покупателей продукции;

174
4. Для Оператора;
5. Для ФОИВ;
6. Для Администратора.
URL: /cises/history
Метод: POST
Пример запроса:
curl -X POST <url стенда>/cises/history?cis=(01)04600266012258(21)5n4Jh5D' \
--header 'Authorization: Bearer ' <Токен>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

cis array[string] + Код идентификации

Пример ответа:
1. Код 200 в случае успеха:
[
{
"cis": "string",
"gtin": "string",
"packageType": "string",
"ownerInn": "string",
"ownerName": "string",
"status": "string",
"child": [
"string"
],
"parent": "string",
"producerInn": "string",
"producerName": "string",
"timestamp": 0,
"operationDate": 0,
"emissionDate": 0,
"lastDocId": "string",
"partialSaleInfo": {
"soldUnitCount": 0,
"rest": 0,
"correctRest": true,
"innerUnitCount": 0
},
"turnoverType": "string",
"productGroup": "string"
}
]

2.В случае ошибок:

175
2.1. Код 401 В случае, когда указан устаревший токен:
<InvalidTokenException>
<error>invalid_token</error>
<error_description>Access token expired:
eyJhbGciOi...zSPUg</error_description>
</InvalidTokenException>

2.2. Код 404 Если указанный КИ не найден:

{
"error_message": "КМ не найдены"
}

2.3. Код 400 При неправильном формате КИ в URL:

{
"error_message": "Неверный формат КМ"
}

2.4 Код 400 Если используется КИ из другой ТГ

{
"error_message": "КМ принадлежит ТГ отличной от МОТП"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

cis string + КИ ГИС МТ
gtin string + Код товара Если код товара менее 14 символов, то он дополняется
ведущими нулями
packageType string + Код типа упаковки Тип упаковки. см. Справочник "Типы упаковки"
ownerInn string - ИНН собственника
товара
status string + Код статуса КИ См. Справочник "Статусы КИ"
child array - Список КИ в агрегате
[string]
parent string - КИ агрегата
producerInn string - ИНН Российского
производителя
timestamp string - Отметка времени Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
emissionDate string - Дата эмиссии Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
operationDate string - Дата создания Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date- документа, по которому в

176
Параметр Тип Обяз. Описание Комментарий
time) последний раз менялся
статус КИ
lastDocId string - Номер документа, по
которому в последний
раз менялся статус КИ
partialSaleInfo object - Объект параметров Возвращается для ТГ "Духи и туалетная вода" (объём в
частичного выбытия в мл.)
*innerUnitCount number - Общее количество Значением параметра является количество товара в
(объем) товара в потребительской упаковке
потребительской
упаковке
*soldUnitCount number - Количество (объём) Значением параметра является число выбывших, в том
выведенного из оборота числе от невладельцев, из оборота единиц употребления
товара по КИ из всех чеков. УОТ отображается информация только по
собственным чекам. ФОИВ доступна информация по
всем чекам
*rest number - Количество товара, Значением параметра является расчётное количество
доступного к выводу из оставшихся в потребительской упаковке единиц
оборота по КИ употребления товара после продажи всеми УОТ. УОТ
отображается информация только по собственным
чекам. ФОИВ доступна информация по всем чекам
*correctRest boolean - Корректность остатка Показатель корректности остатка товара после вывода
товара товара из оборота: false - продано или возвращено
больше допустимого количества товара; true - продано
или возвращено в пределах допустимого количества
товара
productGroup string + Товарная группа См. "Справочник "Список поддерживаемых товарных
групп""
turnoverType string - Код типа отгрузки Возможные значения:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент

5.2.1. Метод получения карточки товара по КИ

Метод возвращает информацию о запрашиваемом товаре (в одном запросе указывается "cis" ("КИ")
одной единицы товара). КИ должен быть в статусе INTRODUCED. Cпецсимволы КИ, указанных в
параметрах тела запроса, необходимо экранировать.
Тип приватности:
1. публичный;
2. без токена (для ТГ "Табачная продукция" и "Альтернативная табачная продукция" в связи с
расширением общедоступной информации).
URL: /products/info

177
Метод: GET
curl -X GET
"<url стенда>/products/info?cis=%2801%2900000046075710%2821%29aaqlpoz"
-H "accept: */*" -H "Authorization: Bearer <ТОКЕН>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

cis string + КИ
childrenPage number - Номер страницы вложений в Значение по умолчанию: 1. Не используется товарной
агрегат первого слоя группой "Табачная продукция"
childrenLimit number - Размер страницы вложений в Значение по умолчанию: 50. Не используется
агрегат первого слоя товарной группой "Табачная продукция"

Пример ответа:
1. В случае успеха:
1.1. Товарные группы "Табачная продукция" и "Альтернативная табачная продукция":
{
"results": [
{
"id": 4,
"name": "Сигареты с фильтром \"X\" mrp v2",
"gtin": "00000046075710",
"packageType": "PA",
"innerUnitCount": 20,
"inn": "1234567890",
"productGroup": 3
}
],
"total": 1
}

1.2. Другие товарные группы:

{
"cis": "string",
"gtin": "string",
"sgtin": "string",
"tnvd": "string",
"tnvedGroup": "string",
"productName": "string",
"producerName": "string",
"producerInn": "string",
"ownerName": "string",
"ownerInn": "string",
"agentName": "string",
"agentInn": "string",
"previousAgentName": "string",
"previousAgentInn": "string",

178
"turnoverType": "SELLING",
"statusEx": "EMPTY",
"docNum": "string",
"emissionDate": 0,
"producedDate": 0,
"introducedDate": 0,
"emissionType": "string",
"prodOrderType": "SELF_MADE",
"lastDocId": "string",
"name": "string",
"brand": "string",
"model": "string",
"certDoc": {
"type": "string",
"number": "string",
"date": "string"
},
"prevCises": [
"string"
],
"nextCises": [
"string"
],
"status": "EMITTED",
"remarks": [
{
"curr": "string",
"prev": "string",
"date": "string"
}
],
"cisChildren": [
"string"
],
"children": [
{
"cis": "string",
"gtin": "string",
"producerName": "string",
"status": "EMITTED",
"emissionDate": 0,
"producedDate": 0,
"packageType": "UNIT",
"ownerName": "string",
"ownerInn": "string",
"productName": "string",
"brand": "string",
"prevCises": [
"string"
],
"nextCises": [
"string"
],
"statusEx": "EMPTY",
"children": [
"string"
],

179
 "childrenMap": {},
"countChildren": 0,
"parent": "string",
"lastDocId": "string",
"expireDate": 0,
"prVetDocument": "string",
"introducedDate": 0,
"exporterName": "string",
"exporterTaxpayerId": "string",
"agentName": "string",
"agentInn": "string",
"lastStatusChangeDate": 0,
"turnoverType": "SELLING",
"productGroup": "string"
}
],
"childrenDetails": [
null
],
"countChildren": 0,
"uitu": "string",
"parent": "string",
"packType": "UNIT",
"withdrawReason": "string",
"receiptDate": 0,
"expireDate": 0,
"prVetDocument": "string",
"exporterName": "string",
"exporterTaxpayerId": "string",
"certificateType": "CONFORMITY_CERTIFICATE",
"certificateNumber": "string",
"certificateDate": "string",
"productGroup": "string"
}

2.В случае ошибок:

2.1. Код 404, если не найден товар с указанным КИ:
{
"error_message":"Продукт не найден"
}

2.2 Код 400 при некорректном формате КИ в URL:

{
"error_message":"Неизвестный GTIN"
}

Параметры ответа для товарных групп "Табачная продукция" и "Альтернативная табачная

продукция":

Параметр Тип Обяз. Описание Комментарий

results array + Результат запроса

180
Параметр Тип Обяз. Описание Комментарий
*id number + Идентификатор
*name string - Наименование товара
*gtin string + Код товара
*packageType string + Тип упаковки См. Справочник "Типы упаковки"
*innerUnitCount number + Число экземпляров товара
*inn string - ИНН
*productGroup integer - Товарная группа См. Справочник "Список поддерживаемых товарных
групп"
total number + Количество найденных
товаров
errorCode string - Код ошибки Параметр указывается при наличии ошибки

Параметры ответа для других товарных групп:

Параметр Тип Обяз. Описание

cis string + Код идентификации, используемый для фильтрации по списку КИ
gtin string - Код товара
sgtin string - Индивидуальный идентификационный код потребительской упаковки для
прослеживаемости в (код товара + индивидуальный серийный номер вторичной
(потребительской) упаковки или первичной упаковки, в случае отсутствия
вторичной)
tnvd string - Код товарной номенклатуры (10 знаков)
tnvedGroup string - Код товарной позиции ТН ВЭД ЕАЭС товара (первые 4 символа)
producerName string - Производитель товара
productName string - Название продукта
producerInn string - ИНН производителя/импортёра товара
ownerInn string - ИНН собственника товара
ownerName string - Наименование собственника товара
agentInn string - ИНН текущего владельца товара
agentName string - Наименование текущего владельца товара
previousAgentInn string - ИНН предыдущего владельца товара
previousAgentName string - Наименование предыдущего владельца товара
turnoverType enum - Вид товарооборота:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент
statusEx enum - Актуальные особые состояния КИ см. Справочник "Статусы КИ"

181
Параметр Тип Обяз. Описание
docNum string - Регистрационный номер документа
emissionDate string + Дата эмиссии КИ. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
producedDate string - Дата нанесения. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
introducedDate string - Дата ввода в оборот. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
emissionType string - Тип эмиссии:
LOCAL – производство РФ;
FOREIGN – ввезен в РФ;
REMAINS – маркировка остатков;
CROSSBORDER – ввезен из стран ЕАЭС.
См."Справочник "Типы эмиссии КИ"
prodOrderType enum - Тип производственного заказа:
SELF_MADE – собственное производство;
OPERATOR – производство товара по договору
lastDocId string - Последний регистрационный номер документа, зафиксированный в ГИС МТ по
этому КИ
name string - Наименование товара
brand string - Бренд
model string - Модель
certDoc - Сертификат
*date string - Дата сертификата. Задается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
*number string - Номер сертификата
*type string - Тип сертификата
prevCises [string] - Предыдущие номера КИ при перемаркировке
nextCises [string] - Следующие номера КИ при перемаркировке
status enum + Статус товара/КИ:
EMITTED – эмитирован. Выпущен;
APPLIED – эмитирован. Получен;
INTRODUCED – в обороте;
WRITTEN_OFF – КИ списан;
RETIRED – выбыл;
DISAGGREGATION – расформирован (только для упаковок);
WITHDRAWN – выбыл, только для ТГ "Табачная продукция
remarks - Список перемаркировок данного товара
*curr string - Текущий КИ товара
*date string - Дата перемаркировки. Задается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

182
Параметр Тип Обяз. Описание
*prev string - Предыдущие КИ товара
cisChildren [string] - Список дочерних КИ
children: array - КИ в агрегате
*cis string + КИ товара
*gtin string - Код товара
*producerName string - Производитель товара
*status enum + Статус товара/КИ:
EMITTED – эмитирован. Выпущен;
APPLIED – эмитирован. Получен;
INTRODUCED – в обороте;
WRITTEN_OFF – КИ списан;
RETIRED – выбыл;
DISAGGREGATION – расформирован (только для упаковок);
WITHDRAWN – выбыл, только для ТГ "Табачная продукция
*emissionDate string + Дата эмиссии. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
*producedDate string - Дата ввода товара с КИ в оборот. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
*packageType string + Тип упаковки. Справочник "Типы упаковки"
*ownerInn string - ИНН собственника товара
*ownerName string - Наименование собственника товара
*productName string - Наименование товара на этикетке
*brand string - Бренд
*nextCises [string] - Следующие номера КИ при перемаркировке
*prevCises string - Предыдущие номера КИ
*statusEx enum - Актуальные особые состояния КИ см. Справочник "Статусы КИ"
*children: [string] - Все КИ в агрегате. В формате массива JSON
*childrenMap [string] - Краткая информация о дочерних КИ
*countChildren integer - Количество дочерних КИ
*parent string - Код идентификации упаковки, в которую агрегирован товар
*lastDocId string - Последний регистрационный номер документа, зафиксированный в ГИС МТ по
этому КИ
*expireDate string - Дата истечения срока годности. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z (обязательный для ТГ "Молочная продукция")
time)
*prVetDocument string - Производственный ветеринарный сопроводительный документ (обязательный
для ТГ "Молочная продукция")

183
Параметр Тип Обяз. Описание
*introducedDate string - Дата ввода в оборот с КИ в оборот. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
*exporterName string - Наименование экспортера
*exporterTaxpayerId string - Уникальный идентификатор экспортера в национальной системе учета
налогоплательщиков
*agentName string - ИНН текущего владельца товара
*agentInn string - Наименование текущего владельца товара
*lastStatusChangeDate string + Дата последнего изменения статуса. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
*turnoverType string - Код типа отгрузки:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент
*productGroup string + Товарная группа. см. Справочник "Список поддерживаемых товарных групп"
childrenDetails [array] - Маркированный товар
countChildren integer - Количество дочерних КИ
(int32)
uitu string - КИТУ вышестоящего уровня
parent string - Код идентификации упаковки, в которую агрегирован товар
packType string + Тип упаковки. Справочник "Типы упаковки"
withdrawReason string - Причина вывода из оборота:
KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен;
DESCRIPTION_ERRORS - выявлены ошибки описания товара;
RETAIL – розничная продажа;
EEC_EXPORT – экспорт в страны ЕАЭС;
BEYOND_EEC_EXPORT – экспорт за пределы стран ЕАЭС;
RETURN – возврат физическому лицу;
REMOTE_SALE – продажа по образцам, дистанционный способ продажи;
DAMAGE_LOSS – утрата или повреждение;
DESTRUCTION – уничтожение;
CONFISCATION – конфискация;
LIQUIDATION – ликвидация предприятия;
DONATION – безвозмездная передача;
STATE_ENTERPRISE – приобретение государственным предприятием;
NO_RETAIL_USE – использование для собственных нужд покупателем;
ENTERPRISE_USE – использование для собственных нужд предприятия;
KM_SPOILED_OR_LOST – испорчен либо утерян СИ с КИ;
KM_CANCELLATION – аннулирование не преобразованных в СИ с КИ по
истечении срока;
KM_CANCELLATION_BY_TERM – аннулирование не преобразованных в СИ
с КИ по истечении срока;
RETAIL_RETURN – возврат товаров с поврежденным СИ/без СИ при

184
Параметр Тип Обяз. Описание
розничной реализации;
REMOTE_SALE_RETURN – возврат товаров с поврежденным СИ/без СИ при
дистанционном способе продажи
receiptDate string - Дата вывода из оборота. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
expireDate string - Дата истечения срока годности. Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z (обязательный для ТГ "Молочная продукция")
time)
prVetDocument string - Производственный ветеринарный сопроводительный документ (обязательный
для ТГ "Молочная продукция")
exporterName string - Наименование экспортера
exporterTaxpayerId string - Уникальный идентификатор экспортера в национальной системе учета
налогоплательщиков
certificateType string - Вид документа, подтверждающего соответствие:
CONFORMITY_CERTIFICATE – сертификат соответствия;
CONFORMITY_DECLARATION – декларация соответствия;
CONFORMITY_CERTIFICATE_OR_DECLARATION - сертификат или
декларация соответствия
certificateNumber string - Номер документа, подтверждающего соответствие
certificateDate string - Дата документа, подтверждающего соответствие. Возвращается в формате
(date- yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
productGroup string + Товарная группа. см. Справочник "Список поддерживаемых товарных групп"
color string - Цвет. Обязателен для ТГ "Обувные товары"
productSize string - Размер. Обязателен для ТГ "Обувные товары"

5.2.2. Получение вложенной структуры агрегированных КИ

5.2.2.1. Запрос списка агрегированных КИ (GET)
Метод возвращает дочерние КИ первого слоя агрегата. В одном запросе можно указать несколько
КИ. КИ для блоков (ТГ "Табачная продукция") можно указывать в запросе как со скобками, так и без
скобок. В ответе КИ всегда будет возвращаться со скобками. Запятая не интерпретируется как
разделитель для параметров запроса, а считается частью самого параметра. Метод возвращает все
слои для агрегата ТГ "Табачная продукция". Для блока (ТГ "Табачная продукция") метод возвращает
все пачки, для коробки - все блоки.
Тип приватности: публичный
Общедоступная информация:
• информация о КИ;
• данные о производителе;

185
• дата и время производства;
• текущий статус в обороте;
• текущий собственник в обороте – информация доступна только владельцу, ФОИВ, Оператору и
Администратору.
URL: /cises/aggregated/list
Метод: GET
Пример запроса:
curl -X GET <url
стенда>/cises/aggregated/list?childrenPage=2&childrenLimit=5&pg=3&codes=%2801%290000004
6075710%2821%29XZXxNKE&codes=%2801%2900000046075710%2821%29abaivho&codes=%2801%29000000
46075710%2821%29abjhtjg
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

codes [string] + Массив КИ Длина массива - от 1 до 1000 КИ (без/с криптохвостом, криптохвост
перед обработкой удаляется) КИ в списке перечисляются в формате
<URL>?codes=<КМ1>[&codes=<КМN>]
childrenPage number - Номер страницы Значение по умолчанию: 1. Не используется ТГ "Табачная
вложений в продукция"
агрегат первого
слоя
childrenLimit number - Размер страницы Значение по умолчанию: 50. Не используется ТГ "Табачная
вложений в продукция"
агрегат первого
слоя
pg string - Товарная группа Параметр обязательно указывать для товарных групп:
milk – "Молочная продукция";
water – "Упакованная вода"

Параметры ответа:

Параметр Тип Обяз. Описание

cis [string] + Список массивов КИ в агрегате при наличии агрегата

Пример ответа:
1. В случае успеха:
{
"(01)00000046075710(21)abjhtjg": {
"00000046075710zpaptvb": [],

186
 "00000046075710pwegzwm": [],
"00000046075710ildnswl": [],
"00000046075710ytqzpvf": [],
"00000046075710szrzjdf": [],
"00000046075710medhjjj": [],
"00000046075710qgmkhml": [],
"00000046075710cuebkgo": [],
"00000046075710xzjlkei": [],
"00000046075710wissylh": []
},
"(01)00000046075710(21)XZXxNKE": {
"000000460757109z5bdlp": [],
"00000046075710KhDTqgx": [],
"00000046075710hW89Sii": [],
"00000046075710hD4pw2D": [],
"00000046075710K0K7g2l": [],
"000000460757102lhyRic": [],
"00000046075710XLthjth": [],
"00000046075710vMsHRrU": [],
"0000004607571059Y7HHI": [],
"00000046075710yjACGvT": []
},
"(01)00000046075710(21)abaivho": {
"00000046075710gpxxads": [],
"00000046075710cgujmiu": [],
"00000046075710zwultyq": [],
"00000046075710osrfrdy": [],
"00000046075710lhttiwo": [],
"00000046075710hzsihcu": [],
"00000046075710qttrevg": [],
"00000046075710dvpuxvh": [],
"00000046075710fufsrkq": [],
"00000046075710jhigpty": []
}
}

2.В случае ошибок:

2.1. Код 401, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2. Код 404 при неизвестных КИ:

{
"error_message":"КМ не найдены"
}

2.3. Код 400, если не указан обязательный параметр "codes":

187
{
"error_message":"Отсутствует обязательный параметр: codes"
}

2.4. Код 403 при не подписанном договоре:

{
"error_message":"отсутствует действующий договор по ТГ"
}

5.2.2.2. Запрос списка агрегированных КИ (POST)

Метод возвращает дочерние КИ первого слоя агрегата. В одном запросе можно указать несколько
КИ. КИ для блоков (ТГ "Табачная продукция") можно указывать в запросе как со скобками, так и без
скобок. В ответе КИ всегда будет возвращаться со скобками. Запятая не интерпретируется как
разделитель для параметров запроса, а считается частью самого параметра. Метод возвращает все
слои для агрегата ТГ "Табачная продукция". Для блока (ТГ "Табачная продукция") метод возвращает
все пачки, для коробки - все блоки.
Тип приватности: публичный
Общедоступная информация:
• информация о КИ;
• данные о производителе;
• дата и время производства;
• текущий статус в обороте;
• текущий собственник в обороте – показ только владельцу, ФОИВ, Оператору-ЦРПТ и
Администратору.
URL: /cises/aggregated/list
Получение дочерних КИ возможно следующими запросами:
Метод: POST
Пример запроса:
curl -X POST <url стенда>/cises/aggregated/list?childrenPage=2&childrenLimit=5&pg=3
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

childrenPage number - Номер страницы вложений в Значение по умолчанию: 1. Не используется ТГ
агрегат первого слоя "Табачная продукция"
childrenLimit number - Размер страницы вложений в Значение по умолчанию: 50. Не используется ТГ

188
Параметр Тип Обяз. Описание Комментарий
агрегат первого слоя "Табачная продукция"
pg string - Товарная группа Параметр обязательно указывать для товарных
групп:
milk – "Молочная продукция";
water – "Упакованная вода"

Параметры ответа:

Параметр Тип Обяз. Описание

cis [string] + Список массивов КИ в агрегате при наличии агрегата

Примечание: При отсутствии вложений в агрегате, в ответе возвращается пустой массив КИ в

квадратных скобках "[]".
Пример ответа:
1.В случае успеха:
{
"(01)00000046075710(21)abjhtjg": {
"00000046075710zpaptvb": [],
"00000046075710pwegzwm": [],
"00000046075710ildnswl": [],
"00000046075710ytqzpvf": [],
"00000046075710szrzjdf": [],
"00000046075710medhjjj": [],
"00000046075710qgmkhml": [],
"00000046075710cuebkgo": [],
"00000046075710xzjlkei": [],
"00000046075710wissylh": []
},
"(01)00000046075710(21)XZXxNKE": {
"000000460757109z5bdlp": [],
"00000046075710KhDTqgx": [],
"00000046075710hW89Sii": [],
"00000046075710hD4pw2D": [],
"00000046075710K0K7g2l": [],
"000000460757102lhyRic": [],
"00000046075710XLthjth": [],
"00000046075710vMsHRrU": [],
"0000004607571059Y7HHI": [],
"00000046075710yjACGvT": []
},
"(01)00000046075710(21)abaivho": {
"00000046075710gpxxads": [],
"00000046075710cgujmiu": [],
"00000046075710zwultyq": [],
"00000046075710osrfrdy": [],
"00000046075710lhttiwo": [],
"00000046075710hzsihcu": [],

189
 "00000046075710qttrevg": [],
"00000046075710dvpuxvh": [],
"00000046075710fufsrkq": [],
"00000046075710jhigpty": []
}
}

2.В случае ошибок:

2.1. Код 401, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2. Код 404 при неизвестных КИ:

{
"error_message":"КМ не найдены"
}

2.3. Код 400 при пустом списке КИ в теле запроса:

{
"error_message":"В запросе не указан ни один КИ"
}

2.4. Код 400 при отсутствии тела запроса:

{
"error_message":"Required request body is missing: public
org.springframework.http.ResponseEntity
ru.crpt.trueapi.controller.motp.CisesController.getCisesInfoByCodeList(java.util.List<j
ava.lang.string>)"
}

2.5. Код 400 при некорректной структуре JSON в теле запроса:

{
"error_message":"JSON parse error: Cannot deserialize instance of
`java.util.ArrayList` out of START_OBJECT token; nested exception is
com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot
deserialize instance of `java.util.ArrayList` out of START_OBJECT
token\n at [Source: (PushbackInputStream); line: 1, column: 1]"
}

2.6. Код 403 при не подписанном договоре:

{
"error_message":"отсутствует действующий договор по ТГ"
}

190
5.3. Метод получения списка десятизначных кодов ТН ВЭД
Не используется ТГ "Табачная продукция" и "Альтернативная табачная продукция".
В результате успешного выполнения запроса на получение списка кодов ТН ВЭД с указанием
массива префиксов ТН ВЭД и параметров пагинации в ответе возвращается массив информации об
удовлетворяющих запросу кодах ТН ВЭД и общее число элементов данного массива.
URL: /facade/tnved/search
Метод: GET
Тип приватности: приватный
Пример запроса:
curl -X GET '<url
стенда>/facade/tnved/search?prefix=2401%2C%202402%2C%202403&limit=20&offset=0
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

Параметры запроса:

Параметр Тип Обяз. Описание

prefix string + Список товарных позиций, с одного из которых должны начинаться искомые коды ТН ВЭД.
Используется для фильтрации товарной группы
limit integer + Значение устанавливает количество записей в ответе (не более 10000 записей)
offset string + Смещение относительно начала списка. Значение по умолчанию = 0. При значении "offset" =
0 метод возвращает корректный ответ

Пример ответа:
{
"records":[
{
"code":"1234567890",
"description":"ТАБАК И ПРОМЫШЛЕННЫЕ ЗАМЕНИТЕЛИ ТАБАКА. ТАБАЧНОЕ СЫРЬЕ;
ТАБАЧНЫЕ ОТХОДЫ. - - светлый табак теневой сушки"
}
],
"total":1
}

Параметры ответа:

Параметр Тип Обяз. Описание

records [array] + Описание кода ТН ВЭД
*code string + 10-ти значный код ТН ВЭД
*description string + Текстовое описание кода ТН ВЭД

191
Параметр Тип Обяз. Описание
total integer (int64) + Общее количество кодов ТН ВЭД, подходящие под параметры фильтрации

5.4. Получение информации о карточках товара УОТ

5.4.1. Метод получения информации о товаре по GTIN товара

В результате успешного выполнения запроса по списку кодов товаров в ответе возвращается массив с
информацией о товарах по запрошенным КИ. В результирующем JSON также может содержаться
набор полей, специфичных для товара конкретной товарной группы (см. "Справочник
"Дополнительные параметры в ответе в зависимости от товарных групп"").
Тип приватности: приватный
URL: /product/info
Метод: GET
Пример запроса:
curl -X GET '<url стенда
v3>/product/info?gtins=00000000000001,00000000000002&includeSubaccount=true&pg=shoes
-H 'Authorization: Bearer <ТОКЕН>'
Content-Type: application/json

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

gtins [string] + Массив кодов
товаров
pg string - Товарная Cм. "Справочник "Список поддерживаемых товарных групп""
группа
includeSubaccount boolean - Признак Если значение = true, то в ответе возвращаются данные по всем
субаккаунта GTIN и принадлежащим участнику и предоставленным ему через
суббакаунт. Если значение = false, то в ответе возвращаются
данные только по GTIN, принадлежащим участнику. Значение по
умолчанию = false

Пример ответа:
1. В случае успеха:
{
"results": [
{
"id": 45775,
"name": "сигареты с фильтром \"X\"",
"gtin": "00000046173881",
"brand": "нет",

192
 "packageType": "PA",
"innerUnitCount": 20,
"inn": "1234567890",
"productGroupId": 3,
"productGroup": "tobacco"
},
{
"id": 47715,
"name": "X",
"gtin": "02900002281866",
"brand": "sdasdasd",
"packageType": "UNDEFINED",
"innerUnitCount": 1,
"inn": "1234567890",
"productGroupId": 12,
"productGroup": "otp",
"tnved": "2403"
},
{
"id": 47942,
"name": "321",
"gtin": "02900002283044",
"brand": "321",
"packageType": "UNDEFINED",
"innerUnitCount": 1,
"inn": "1234567890",
"productGroupId": 12,
"productGroup": "otp",
"tnved": "2403"
},
{
"id": 45656,
"name": "сигареты с фильтром \"X\"",
"gtin": "04600266011718",
"brand": "нет",
"packageType": "PA",
"innerUnitCount": 20,
"inn": "1234567890",
"productGroupId": 3,
"productGroup": "tobacco"
}
],
"total": 4
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

results array + Массив с информацией о
товарах по запрошенным
КИ
*id integer + ID товара
*name string + Наименование товара

193
Параметр Тип Обяз. Описание Комментарий
*gtin string + Код товара, по которому
выполняется запрос
*isGtinSubaccount boolean + Признак принадлежности Если значение = true - субаккаунту был
кода товара субаккаунту предоставлен доступ к этому коду товара.
Если значение = false - код товара
собственный
*brand string + Бренд
*packageType string + Тип упаковки См. Справочник "Типы упаковки"
*innerUnitCount number + Количество товара в
упаковке
*model string - Модель, артикул Параметр возвращается в ответе для
производителя товарных групп "Шины и покрышки
пневматические резиновые новые",
"Обувные товары", "Предметы одежды
бельё постельное столовое туалетное и
кухонное", "Фотокамеры, кроме кинокамер,
фотовспышки и лампы-вспышки", "Кресла-
коляски"
*publicationDate integer(int64) - Дата публикации кода Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z
товара
*inn string + ИНН участника оборота
товара
*exporter object - Заявитель маркируемого и
вводимого в оборот товара
**id integer(int64) - ID заявителя Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
**ncId integer(int64) - Идентификатор заявителя в Возвращается в ответе при условии
БД КМТ указания сведений в карточке товара в КМТ
**exporterName string - Наименование заявителя- Возвращается в ответе при условии
экспортёра указания сведений в карточке товара в КМТ
**exporterTaxpayerId string - ИНН заявителя или его Возвращается в ответе при условии
аналог указания сведений в карточке товара в КМТ
**kpp string - КПП или его аналог Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
**gcp string - Глобальный идентификатор Возвращается в ответе при условии
компании в GS1 указания сведений в карточке товара в КМТ
**gln string - Глобальный идентификатор Возвращается в ответе при условии
места нахождения указания сведений в карточке товара в КМТ
**manufactureAddress string - Адрес производственной Возвращается в ответе при условии
площадки указания сведений в карточке товара в КМТ
**importerAccount string - Ссылка на аккаунт Возвращается в ответе при условии
импортёра указания сведений в карточке товара в КМТ
*permittedInns [string] - Массив ИНН компаний- Возвращается в ответе при условии

194
Параметр Тип Обяз. Описание Комментарий
субаккаунтов, которым указания сведений в карточке товара в
владелец кода товара КМТ. Параметр возвращается для владельца
предоставил возможность кода товара и для Оператора
использовать данный код
товара для заказа КМ
*productGroupId integer(int64) + Идентификатор товарной См. Справочник "Список поддерживаемых
группы товарных групп". Возвращается в ответе
при условии указания сведений в карточке
товара в КМТ
*productGroup string - Наименование товарной Возвращается в ответе при условии
группы указания сведений в карточке товара в КМТ
*tnVedCode string - Группа ТН ВЭД Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
*foreignProducer object - Объект с данными о Возвращается в ответе при условии
производителе указания сведений в карточке товара в КМТ
**name string - Наименование Возвращается в ответе при условии
производителя указания сведений в карточке товара в КМТ
**inn string - ИНН производителя или Возвращается в ответе при условии
его аналог указания сведений в карточке товара в КМТ
**kpp string - КПП производителя или Возвращается в ответе при условии
его аналог указания сведений в карточке товара в КМТ
**gcp string - GCP производителя Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
**gln string - GLN производителя
**address array[string] - Массив адресов Возвращается в ответе при условии
производителя указания сведений в карточке товара в КМТ
*goodSignedFlag boolean - Признак подписания Возвращается в ответе при условии
карточки товара в КМТ указания сведений в карточке товара в КМТ
*goodMarkFlag boolean - Признак готовности к Возвращается в ответе при условии
маркировке указания сведений в карточке товара в КМТ
*goodTurnFlag boolean - Индикатор заполнения Индикатор заполнения второго слоя
второго слоя карточки в карточки в НК. Если значение = true, то
КМТ можно заказать КМ и ввести товар в оборот.
Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
*explain string - Выводимая ошибка, если Возвращается в ответе при условии
обязательные атрибуты не указания сведений в карточке товара в КМТ
заполнены или карточка
товара в КМТ не подписана
*isKit boolean - Признак "Комплект" в Возвращается в ответе при условии
карточке товара указания сведений в карточке товара в КМТ
*isTechGtin boolean - Признак Возвращается в ответе при условии
"Технологический" по указания сведений в карточке товара в КМТ
карточке товара

195
Параметр Тип Обяз. Описание Комментарий
<<<<<<< HEAD
*setDescription string - Описание набора Возвращается описание товара в составе
набора, содержащее параметры,
специфичные для конкретного товара.
Данный параметр вернётся в том случае,
если он заполнен в карточке НК (см.
"Справочник "Дополнительные параметры в
ответе в зависимости от товарных групп"").
Данный параметр вернётся только в том
случае, если он заполнен в карточке НК.
*isSet boolean - Признак "Набор" по Возвращается в ответе при условии
карточке товара в КМТ указания сведений в карточке товара в КМТ
*country string - Страна производства Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
*fts object - Данные полученные ГИС Возвращается в ответе при условии
МТ в ответе от ФТС при указания сведений в карточке товара в КМТ
вводе товара в оборот
**rds array[object] - Массив данных по РД Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
***authDocDate string - Дата разрешительного Возвращается в ответе при условии
документа указания сведений в карточке товара в КМТ
***authDocNumber string - Номер разрешительного Возвращается в ответе при условии
документа указания сведений в карточке товара в КМТ
**countries array[string] - Массив стран производства Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
**tnVedCode10 string - Массив кодов ТН ВЭД (10 Возвращается в ответе при условии
знаков) указания сведений в карточке товара в КМТ
*colors array[string] - Массив уникальных Возвращается в ответе при условии
значений цветов изделия указания сведений в карточке товара в КМТ
*setGtin array[object] - Массив кодов товара, Возвращается в ответе, если "isSet" = true
входящих в состав набора при условии указания сведений в карточке
товара в КМТ
**gtin string - Код товара, входящего в Возвращается в ответе при условии
набор указания сведений в карточке товара в КМТ
*isSet boolean - Признак "Набор" по Возвращается в ответе при условии
карточке товара в КМТ указания сведений в карточке товара в КМТ
*setGtin array[object] - Массив кодов товара, Возвращается в ответе, если "isSet" = true
входящих в состав набора при условии указания сведений в карточке
товара в КМТ
**gtin string - Код товара Возвращается в ответе при условии
указания сведений в карточке товара в КМТ
*quantity integer(int32) - Количество кодов товаров Возвращается в ответе при условии
указания сведений в карточке товара в КМТ

196
Параметр Тип Обяз. Описание Комментарий
*goodsStatus string - Cтатус карточки товара в Возвращается в ответе при условии
КМТ указания сведений в карточке товара в
КМТ. Если карточка товара выводится из
GS1, то параметр не возвращается.
Возможные значения: draft - карточка
товара в разных статусах в КМТ:
"Черновик", "На модерации", "Требует
изменений", "Ожидает подписания";
published - опубликованная карточка товара;
archived - карточка товара в архиве

5.4.2. Метод получения списка кодов товаров (GTIN) УОТ по ИНН

Метод возвращает список кодов товаров с возможностью указания параметров фильтрации в запросе.
Для товарной группы "Альтернативная табачная продукция" в ответе отсутствует информация по
кодам товаров, добавленным с помощью пользовательского интерфейса или через "Метод создания и
обновления товаров" раздела "Методы Национального каталога".
Тип приватности: приватный
URL: /product/gtin
Метод: GET
Пример строки запроса:
curl -X GET '<url стенда
v4>/product/gtin?includeSubaccount=false&limit=2&page=0&pg=tobacco
Authorization: Bearer <ТОКЕН>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

limit string - Значение Не более 10000 записей (по умолчанию 10 записей)
устанавливает
количество записей
в ответе
page string - Номер страницы
ответа, начальное
значение 0
pg string + Наименование см. Справочник "Список поддерживаемых товарных групп"
товарной группы
includeSubaccount boolean - Субаккаунт Если значение = true, то в ответе возвращаются данные по
всем GTIN и принадлежащим участнику и предоставленным
ему через суббакаунт. Если значение = false, то в ответе
возвращаются данные только по GTIN, принадлежащим
участнику. Значение по умолчанию = false

197
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

results array of object + В ответе возвращается
по тем "gtin", по
которым найдены
сведения и которые
удовлетворяют
условиям поиска
*goodStatus string Статус карточки товара в *gtin string
НК. Возможные значения:
draft - черновик, На
модерации, Требует
изменений, Ожидает
подписания; published -
опубликована; archived - в
архиве;
+ Код товара *isGtinSubaccount boolean
+ Признак принадлежности Если значение = true - *isKit boolean
кода товара субаккаунту субаккаунту был
предоставлен доступ к
этому коду товара. Если
значение = false - код товара
собственный
+ Признак "Комплект" в Возвращается в ответе при *isSet boolean
карточке товара условии указания сведений
в карточке товара в КМТ
+ Признак "Набор" по Возвращается в ответе при *permittedInns array of string
карточке товара в КМТ условии указания сведений
в карточке товара в КМТ
- Массив ИНН компаний- Возвращается в ответе при *setDescription string
субаккаунтов, которым условии указания сведений
владелец кода товара в карточке товара в КМТ и
предоставил возможность только владельцу кода
использовать данный код товара
товара для заказа КМ
- Описание состава набора *setGtin array of object -
Массив кодов **gtin string - Код товара
товаров,
входящих в
набор
**quantity integer (int64) - Количество кодов total
товаров
number + Количество найденных errorCode string
товаров

Пример ответа:

198
1.В случае успеха:
{
"results": [
{
"goodStatus": "published",
"gtin": "04640097090278",
"isGtinSubaccount": false,
"isKit": false,
"isSet": false,
"permittedInns": [
"7708268872",
"6950208618"
],
"setDescription": "BOX",
"setGtin": [
{
"gtin": "00000000000001",
"quantity": 1,
}
]
},
{
"goodStatus": "published",
"gtin": "04640097090271",
"isGtinSubaccount": false,
"isKit": false,
"isSet": false,
"permittedInns": [
"7708268872",
"6950208618"
],
"setDescription": "BOX",
"setGtin": [
{
"gtin": "00000000000002",
"quantity": 2,
}
]
},
"total": 2,
"errorCode": null
}

2.В случае ошибок:

2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2. Код 400 При неверном значении товарной группы в параметре pg:

199
{
"error_message": "Could not determine product group by name 'shoe'"
}

Рекомендуется использовать версию v4, версия v3 в дальнейшем будет отключена.

Пример запроса:
curl -X GET '<url стенда v3>/product/gtin?limit=2&page=0&pg=tobacco
Authorization: Bearer <ТОКЕН>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

limit string - Значение устанавливает количество Не более 10000 записей (По умолчанию 10
записей в ответе записей)
page string - Номер страницы ответа, начальное
значение 0
pg string + Наименование товарной группы см. Справочник "Список поддерживаемых
товарных групп"

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

errorCode string - Код ошибки Параметр указывается при наличии ошибки
gtins array - Список кодов товаров При наличии кодов товаров в ГИС МТ
*gtin string + Код товара
total number + Количество найденных товаров

Пример ответа:
1 В случае успеха:
{
"gtins": [
"04630034070029",
"00000046210654"
],
"total": 2
}

2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this

200
resource</error_description>
</UnauthorizedException>

2.2. Код 400 При неверном значении товарной группы в параметре pg:
{
"error_message": "Could not determine product group by name 'shoe'"
}

5.5. Метод получения кода товарной группы по КИ товара (GTIN)

Метод возвращает информацию о товарных группах для запрашиваемых кодов товаров (в одном
запросе указываются несколько кодов товаров).
Тип приватности:
1. Публичный (для ТГ ∈ [ЛП; МОТП], в МОТП сохранён данный тип приватности для обратной
совместимости с предыдущими релизами True API);
2. Без токена (для ТГ "Табачная продукция" и "Альтернативная табачная продукция" в связи с
расширением общедоступной информации в МОТП).
URL: /product/route/gtin
Метод: POST
Content-Type: application/json
Параметры тела запроса:

Параметр Тип Обяз. Описание

data array + список кодов товаров
gtin string + код товара

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

data string - код товара
tg-id string - Идентификатор товарной см. Справочник "Список поддерживаемых товарных групп"
группы
Параметр указывается в случае успешного выполнения
запроса
tg-name string - Наименование товарной группы
error-msg string - Сообщение об ошибке при Справочник "Статусы ответов"
обработке кода товара
Параметр указывается при наличии ошибки в обработке
кода товара при успешном выполнении запроса
error- string - Код ошибки при обработке кода
code товара

201
Пример запроса:
Для публичного типа приватности
POST <url стенда>/product/route/gtin
authorization: Bearer <ТОКЕН>
Content-Type: application/json
{"data": ["00000046210654", "04630034070029"]}

Пример ответа:
1 В случае успеха:
1.1. При успешной обработке всех кодов товара из запроса:
[
{
"data": "00000046210654",
"tg-id": "3",
"tg-name": "tobacco"
},
{
"data": "04630034070029",
"tg-id": "2",
"tg-name": "shoes"
}
]

1.2. При успешной обработке части кодов товара из запроса:

[
{
"data": "00000046210654",
"tg-id": "3",
"tg-name": "tobacco"
},
{
"data": "04630034070012",
"error-code": "401",
"error-msg": "Для доступа к этому ресурсу требуется полная аутентификация"
}
]

2 В случае ошибок:
2.1. Код 400 При неверной структуре в теле запроса:
{
"error_message": "JSON parse error: Cannot deserialize instance of
`java.util.ArrayList` out of VALUE_STRING token; nested exception is
com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot
deserialize instance of `java.util.ArrayList` out of VALUE_STRING
token\n at [Source: (PushbackInputStream); line: 1, column: 10] (through
reference chain: ru.crpt.trueapi.dto.common.GtinInfoRequest[\"data\"])"
}

202
2.2 Код 404 при отсутствии gtin в базе
{
"data": "00000046210654",
"error-code": 404,
"error-msg": "Not Found"
}

5.6. Работа с согласием о предоставлении информации участникам оборота

товаров ГИС МТ
Методы позволяют участнику оборота товаров запросить сведения о КИ, находящихся в
собственности его контрагента. Со стороны ГИС МТ при этом осуществляется проверка наличия
действующего согласие о предоставлении информации о КИ, выданное участнику оборота товаров,
запрашивающего информацию ок КИ. В ответ участник оборота товаров получает запрашиваемую
информацию, либо отказ в предоставлении запрашиваемой информации.
10 марта 2021 на демонстрационном контуре включена функциональность обязательного наличия
согласия о предоставлении о КИ и вложенности в агрегаты, подписанного со стороны участников
оборота товаров. Планируемый срок включения ограничения на промышленном контуре - 1 июня
2021. Включение обязательности согласия будет выполнено для товарных групп "Табачная
продукция", "Альтернативная табачная продукция", "Обувные товары", "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное ", "Шины и покрышки пневматические резиновые новые
", для которых обязательна подача сведений в ГИС МТ об отгрузке/приёмке/передаче КИ в оптово-
розничном звене."
Работа со следующими методами без наличия подписанного согласия участниками оборота товаров
будет ограничена: "Метод получения общедоступной информации о КИ по списку" (/cises/info),
"Метод получения краткой общедоступной информации о КИ по списку" (/cises/list), "Получение
сведений по кодам идентификации и агрегатам".

5.6.1. Метод создания документа согласия о предоставлении сведений о КИ

Метод формирует черновик, который подписывается УКЭП генерального директора в личном
кабинете ГИС МТ. В ГИС МТ может находиться только один действующий документ согласия о
предоставлении сведений.
Тип приватности: приватный.
URL: /agreement-registry/agreement
Метод: POST
Пример строки запроса:
curl -X POST '<url стенда>/agreement-registry/agreement" -H "accept: */*" -H "Content-
Type:
application/json" -d
"{\"trustedInns\":[\"string\"],\"everyonePermitted\":true,\"expirationDate\":yyyy-MM-
ddTHH:mm:ss.SSS'Z}'

Пример тела запроса:

203
{
"trustedInns": [
"string"
],
"everyonePermitted": true,
"expirationDate": "string"
}

Параметры запроса

Параметр Тип Обяз. Описание Комментарий

trustedInns [string] - Список доверенных
ИНН контрагентов
everyonePermitted boolean - Признак При необходимости подписания согласия для всех
предоставления контрагентов значение параметра должно быть "true", при
согласия для всех этом параметр "trustedInn" должен быть пустым. Заполнение
контрагентов обоих параметров одновременно недопустимо. При
передаче списка ИНН доверенных контрагентов в
параметре "trustedInn" параметр "everyonePermitted" должен
быть либо пустым, либо иметь значение "false". Параметр
"everyonePermitted" автоматически принимает значение
"false" при передаче пустого значения
expirationDate string + Дата окончания Формат: yyyy-MM-ddTHH:mm:ss.SS’Z. Значение не может
(date- срока действия превышать дату окончания срока действия используемой
time) согласия УКЭП. Значение устанавливаемой даты не может быть
меньше текущей даты создания документа согласия о
предоставлении сведений

Пример ответа:
1.В случае успеха 201 "Документ успешно создан".
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

2.В случае ошибки 400 (документ не прошёл валидацию);

[
{
"message":"Для опубликованной ревизии согласия существует документ аннулирования
в статусе 'На подготовке'",
"object":[

]
},
{
"message":"Срок действия документа не должен заканчиваться позже даты окончания
действия сертификата",
"object":[

]
},

204
 {
"message":"ИНН не зарегистрированы в системе",
"object":[
"string"
]
},
{
"message":"ИНН организации, создающей документ согласия, не может находиться в
списке доверенных ИНН",
"object":[
"string"
]
},
{
"message":"Срок действия документа не должен заканчиваться раньше текущей даты",
"object":[
"string"
]
},
{
"message":"У УОТа уже есть актуальная ревизия согласия",
"object":[
"string"
]
},
{
"message":"Список доверенных ИНН пустой",
"object":[
"string"
]
}
]

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа согласия о предоставлении
информации
message string - Сообщение об ошибке Возвращается только в случае
ошибки

5.6.2. Метод получения информации о КИ по списку КИ при наличии согласия о

предоставлении информации
Данный метод используется для запроса информации о КИ, владельцем которого является другой
участник оборота товаров при наличии согласия о предоставлении информации.
Тип приватности:
1. Приватный.
2. Оператор.

205
URL: /km-owner-api/cises
Метод: POST
Пример строки запроса:
curl -X GET "<url стенда>/km-owner-api/cises" -H "accept: application/json" -H
"Content-Type:
application/json" -d "{\"ownerInn\":\"string\",\"cises\":[\"string\"]}"

Пример запроса в формате JSON:

{
"ownerInn": "string",
"cises": [
"string"
]
}

Параметры запроса

Параметр Тип Обяз. Описание Комментарий

ownerInn string + ИНН предполагаемого владельца КИ
cises [string] + Список КИ, по которым запрашивается информация

Пример ответа:
1.В случае успеха 200.
{
"responses": [
{
"cis": "string",
"owner": true,
"gtin": "string",
"productGroup": "string",
"producerInn": "string",
"status": "string",
"parent": "string",
"childs": [
null
],
"partialSaleInfo": {
"innerUnitCount": 20,
"soldUnitCount": 10,
"rest": 10,
"correctRest": true
}
}
],
"errors": [
{
"cises": [
"string"

206
 ]
}
]
}

2.В случае ошибки 403 "Не найден подписанный документ согласия для ИНН или ваша организация
отсутствует в списке доверенных контрагентов".
{
"message": "Не найден подписанный документ согласия для ИНН или ваша организация
отсутствует в списке доверенных контрагентов"
}

Параметры ответа

Параметр Тип Обяз. Описание Комментарий

responses object + Сведения о КИ
*cis string + КИ
*owner boolean + Признак Если параметр "owner" = false, то в ответе вернётся только
принадлежности КИ "cis"
*gtin string - Код товара Параметр не возвращается для КИТУ
*productGroup string + Товарная группа См. Справочник "Список поддерживаемых товарных
групп"
*producerInn string - ИНН производителя Параметр не возвращается для КИТУ
товара
*status string + Статус КИ См. "Справочник "Статусы КИ""
*parent string - КИ агрегата
*childs [string] - Список КИ, входящих
в состав агрегата
*partialSaleInfo object - Объект параметров Возвращается для ТГ "Альтернативная табачная
частичного выбытия продукция" (количество в шт) и "Духи и туалетная вода"
(наливная продукция, объем в мл)
**innerUnitCount number - Общее количество Значением параметра является количество/объём товара в
(объем) товара в потребительской упаковке/единице товара
потребительской
упаковке
**soldUnitCount number - Количество (объем) Значением параметра является число выбывших, в том
выведенного из числе от невладельцев, из оборота единиц употребления из
оборота товара по КИ всех чеков. УОТ отображается информация только по
собственным чекам. ФОИВ доступна информация по всем
чекам
**rest number - Количество (объем) Значением параметра является расчётное количество/объём
товара, доступного к оставшихся в потребительской упаковке/единице товара
выводу из оборота по единиц употребления/мл товара после продажи всеми УОТ.
КИ УОТ отображается информация только по собственным
чекам. ФОИВ доступна информация по всем чекам

207
Параметр Тип Обяз. Описание Комментарий
**correctRest boolean - Корректность остатка Показатель корректности остатка товара после вывода
товара товара из оборота: false - продано или возвращено больше
допустимого количества/объема товара; true - продано или
возвращено в пределах допустимого количества/объема
товара. Для товарной группы "Духи и туалетная вода"
(наливная продукция) продажа товара в объеме,
превышающем заявленный, а также превышение остатка
товара более чем на 8% считаются некорректными
errors [string] - Список КИ, Возвращается в случае наличия ошибок
обработанных с
ошибкой
*cises [string] - Список КИ
message string - Сообщение об ошибке Возвращается только в случае ошибки

5.6.3. Метод аннулирования подписанного согласия о предоставлении информации

Метод аннулирует последнее успешно сформированное и подписанное согласие о предоставлении
информации.
Тип приватности:
1. Производители/импортёры продукции.
2. Покупатели продукции (Оптовик, Розница).
URL: /agreement-registry/cancellation
Метод: POST
Пример строки запроса:
curl -X POST "<url стенда>/agreement-registry/cancellation" -H "accept: */*"
-H "Authorization: Bearer <ТОКЕН>

Пример ответа:
1.В случае успеха 201 "Документ успешно создан".
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "string",
"statusCode": "ESTABLISHED",
"sign": {
"fingerPrint": "string",
"serialNumber": "string",
"inn": "string",
"owner": "string",
"organisationName": "string",
"validityDateFrom": 0,
"validityDateUpTo": 0,

208
 "signingTime": 0
},
"documentRegNumber": "string"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа согласия о
предоставлении
информации
status string + Статус документа
statusCode string + Код статуса документа Возможные значения:
ESTABLISHED - сформирован
(присваивается при записи документа в БД
после успешного прохождения всех
проверок);
SIGNED - подписан (присваивается по факту
подписания пользователем);
REJECTED - отклонён (присваивается, если
пользователь отказывается от подписания
документа);
OUTDATED - устарел (присваивается в
случае, если документ был подписан ранее,
но вместо него был подписан новый
документ);
CANCELLED - аннулирован (присваивается
в случае аннулирования документа)
sign object + УКЭП
*fingerPrint string - Отпечаток сертификата
*serialNumber string - Серийный номер
*validityDateFrom integer($int64) - Действителен с
*validityDateUpTo integer($int64) - Действителен до
*signingTime integer($int64) - Время подписания
документа
documentRegNumber string + Регистрационный номер
документа

1.В случае успеха 201 "Документ успешно создан".

{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "string",
"statusCode": "ESTABLISHED",
"sign": {
"fingerPrint": "string",
"serialNumber": "string",
"inn": "string",
"owner": "string",

209
 "organisationName": "string",
"validityDateFrom": 0,
"validityDateUpTo": 0,
"signingTime": 0
},
"documentRegNumber": "string"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа согласия о
предоставлении
информации
status string + Статус документа
statusCode string + Код статуса документа Возможные значения:
ESTABLISHED - сформирован
(присваивается при записи документа в БД
после успешного прохождения всех
проверок);
SIGNED - подписан (присваивается по факту
подписания пользователем);
REJECTED - отклонён (присваивается, если
пользователь отказывается от подписания
документа);
OUTDATED - устарел (присваивается в
случае, если документ был подписан ранее,
но вместо него был подписан новый
документ);
CANCELLED - аннулирован (присваивается
в случае аннулирования документа)
sign object + УКЭП
*fingerPrint string - Отпечаток сертификата
*serialNumber string - Серийный номер
*validityDateFrom integer($int64) - Действителен с
*validityDateUpTo integer($int64) - Действителен до
*signingTime integer($int64) - Время подписания
документа
documentRegNumber string + Регистрационный номер
документа

5.6.4. Метод отображения списка документов согласия о предоставлении информации

Метод позволяет участнику оборота товаров получить список всех документов согласия о
предоставлении информации.
Тип приватности:

210
1. Приватный.
2. Оператор.
URL: /agreement-registry/agreement/list
Метод: GET
Пример строки запроса:
curl -X GET "<url стенда>/agreement-
registry/agreement/list?offset=0&limit=0&sort=string&direction=ASC&
participantId=0&participantInn=string&documentRegNumber=3fa85f64-5717-4562-b3fc-
2c963f66afa6
&status=CANCELLED&publicationDate=id,string,name,string&createDate=id,string,name,strin
g&expirationDate=id,string
,name,string&offset=0&limit=0&sort=string&direction=ASC" -H "accept: application/json"

Параметры запроса

Параметр Тип Обяз. Описание Комментарий

participantId integer($int64) - ID участника оборота
товаров
participantInn string - ИНН участника
оборота товаров
documentRegNumber string - Регистрационный
номер документа
status string - Статус документа Возможные значения:
ESTABLISHED - сформирован (присваивается
при записи документа в БД после успешного
прохождения всех проверок);
SIGNED - подписан (присваивается по факту
подписания пользователем);
REJECTED - отклонён (присваивается, если
пользователь отказывается от подписания
документа);
OUTDATED - устарел (присваивается в случае,
если документ был подписан ранее, но вместо
него был подписан новый документ);
CANCELLED - аннулирован (присваивается в
случае аннулирования документа)
publicationDate object - Фильтр по дате
подписания
документа
*from string - Начало периода Задаётся в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
*to string - Конец периода Задаётся в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
createDate object - Фильтр по дате
создания документа

211
Параметр Тип Обяз. Описание Комментарий
*from string - Начало периода Задаётся в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
*to string - Конец периода Задаётся в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
expirationDate object - Фильтр по дате
истечения срока
действия документа
*from string - Начало периода Задаётся в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
*to string - Конец периода Задаётся в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
offset integer($int64) - Смещение страницы Значение по умолчанию: 0
limit integer($int32) - Предельное Значение по умолчанию: 0
количество записей
sort string - Параметр фильтрации Доступные параметры для фильтрации:
"publisherId", "agreementCancellations",
"agreement", "revisionNumber", "rejectionDate",
"creatorId", "trustedOrganisations", "id",
"publicationDate", "createDate", "status",
"printForm"
direction string - Направление
фильтрации:
ASC – по
возрастанию;
DESC – по убыванию

В запросе должен быть указан хотя бы один параметр, иначе в ответе возвращается ошибка 400 "Bad
request" (ошибка в параметрах запроса).
Пример ответа:
1. В случае успеха 200 "Данные успешно получены".
{
"results": [
{
"agreementRevisionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createDate": 0,
"publicationDate": 0,
"expirationDate": "string",
"status": "string",
"creatorId": 0,
"publisherId": 0,
"cancellation": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createDate": "2021-01-31T16:40:48.549Z",
"publicationDate": "2021-01-31T16:40:48.549Z",
"status": "string",

212
 "statusCode": "string",
"creatorId": 0,
"publisherId": 0,
"documentRegNumber": "string"
},
"documentRegNumber": "string"
}
],
"total": 0,
"errorCode": "string",
"last": true
}

2.В случае ошибки 400 "Входные параметры некорректны", ошибки 500 "Ошибка при выполнении
запроса".
{
"error": "string",
"error_description": "string"
}

Параметры ответа

Параметр Тип Обяз. Описание Комментарий

result [array] + Результат запроса
*agreementRevisionId string($uuid) + Первичный ключ (ID
документа согласия о
предоставлении
информации)
*createDate integer($int64) + Дата создания документа
*publicationDate integer($int64) - Дата подписания документа
*expirationDate string (date- + Дата окончания срока Формат: yyyy-MM-ddTHH:mm:ss.SS’Z
time) действия согласия
*status string + Статус документа Возможные значения:
ESTABLISHED - сформирован
(присваивается при записи документа в
БД после успешного прохождения всех
проверок);
SIGNED - подписан (присваивается по
факту подписания пользователем);
REJECTED - отклонён (присваивается,
если пользователь отказывается от
подписания документа);
OUTDATED - устарел (присваивается в
случае, если документ был подписан
ранее, но вместо него был подписан
новый документ);
CANCELLED - аннулирован
(присваивается в случае аннулирования
документа)

213
Параметр Тип Обяз. Описание Комментарий
*creatorId integer($int64) + ID участника оборота
товаров, создавшего
документ
*publisherId integer($int64) - ID участника оборота
товаров, подписавшего
документ
*cancellation object - Документ аннулирования
связанный с редакцией
документа соглашения
**id string - ID Документа
**createDate string (date- + Дата создания документа Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
**publicationDate string (date- - Дата подписания документа Формат: yyyy-MM-ddTHH:mm:ss.SS’Z
time)
**status string + Статус документа Возможные значения:
ESTABLISHED - сформирован
(присваивается при записи документа в
БД после успешного прохождения всех
проверок);
SIGNED - подписан (присваивается по
факту подписания пользователем);
REJECTED - отклонён (присваивается,
если пользователь отказывается от
подписания документа);
OUTDATED - устарел (присваивается в
случае, если документ был подписан
ранее, но вместо него был подписан
новый документ);
CANCELLED - аннулирован
(присваивается в случае аннулирования
документа)
**statusCode string + Код статуса документа
**creatorId integer($int64) + ID участника оборота
товаров, создавшего
документ
**publisherId integer($int64) - ID участника оборота
товаров, подписавшего
документ
**documentRegNumber string - Регистрационный номер
документа
*documentRegNumber string - Регистрационный номер
документа
total integer($int64) + Всего записей
errorCode string - Описание ошибки Возвращается в случае ошибки
last boolean - Последняя запись на

214
Параметр Тип Обяз. Описание Комментарий
странице
error string - Ошибка Возвращается только в случае ошибки

5.6.5. Метод получения тела документа согласия или документа аннулирования согласия
Данный метод используется для получения в ответе тела документа согласия или аннулирования
согласия, которое необходимо подписать откреплённой УКЭП и вставить в поле "signature" в методе
"Метод подписания документа согласия или документа аннулирования согласия о предоставлении
информации".
Тип приватности: приватный.
URL: agreement-registry/{id}/print-form
Пример строки запроса:
curl -X GET "<url стенда>/agreement-registry/c9d1c4c6-a045-4205-b142-
c9d5a13155f7/print-form?documentType=AGREEMENT"
-H "accept: application/json" -H "Authorization: Bearer <ТОКЕН>

Параметры запроса:
Параметры запроса

Параметр Тип Обяз. Описание Комментарий

id string + ID
документа
documentType string + Тип Возможные значения: AGREEMENT - документ согласия о предоставлении
документа информации AGREEMENT_CANCELLATION - документ отмены согласия

Пример ответа:
1. В случае успеха 200.
{
"documentRegNumber": "AR631208202400074",
"ownerOrganisationName": "ООО \"X\"",
"ownerOrganisationInn": "1234567890",
"ownerOrganisationOgrn": "1234567890123",
"trustedOrganisations": [],
"everyonePermitted": true
}

2.В случае ошибки 400, 500.

{
"error":"string",
"error_description":"string"
}

215
Параметры ответа

Параметр Тип Обяз. Описание Комментарий

documentRegNumber string + Регистрационный
номер документа
ownerOrganisationName string - Наименование
владельца
организации
ownerOrganisationOgrn string - ОГРН владельца
организации
trustedOrganisations [string] + Доверенные
организации
everyonePermitted boolean - Признак При необходимости подписания согласия для всех
предоставления контрагентов значение параметра должно быть "true",
согласия для всех при этом параметр "trustedOrganisations" должен быть
контрагентов пустым. Заполнение обоих параметров одновременно
недопустимо. При передаче списка доверенных
контрагентов в параметре "trustedOrganisations"
параметр "everyonePermitted" должен быть либо
пустым, либо иметь значение "false". Параметр
"everyonePermitted" автоматически принимает
значение "false" при передаче пустого значения
error string - Ошибка Возвращается только в случае ошибки

5.6.6. Метод подписания документа согласия или документа аннулирования согласия о

предоставлении информации
Данный метод используется для подписания документа согласия и аннулирования документа
согласия.
Тип приватности: приватный.
URL: agreement-registry/publish
Метод: POST
Пример строки запроса:
curl -X POST "<url стенда>/agreement-registry/publish"
-H "accept: */*" -H "Content-Type: application/json" -d "{\"documentId\":\"3fa85f64-
5717-4562-b3fc-2c963f66afa6\",\"documentType\":
\"AGREEMENT\",\"signature\":\"string\"}"

Пример тела запроса:

{
"documentId": "string",
"documentType": "AGREEMENT",
"signature": "string"
}

216
Параметры запроса

Параметр Тип Обяз. Описание Комментарий

documentId string + ID документа
documentType string + Тип документа Возможные значения:
"AGREEMENT" - подписание документа согласия;
"AGREEMENT_CANCELLATION" - подписание документа
аннулирования согласия.
При отсутствии одного из указанных значений возвращается
ошибка 400
signature string + Откреплённая УКЭП директора или генерального директора, осуществившего
УКЭП в кодировке регистрацию компании в ГИС МТ, либо сотрудника, который
base64 зарегистрировал компанию на основании доверенности

Пример ответа:
1. В случае успеха 200.
{
"documentId": "string",
"status": "string"
}

2.В случае ошибки 400.

{
"error_message": "Параметры запроса заданы неверно или документ не прошёл проверку"
}

3.В случае ошибки 404.

{
"error_message": "Документ не найден"
}

Параметры ответа

Параметр Тип Обяз. Описание Комментарий

documentId string + ID документа
status string + Статус Возможные значения:
документа ESTABLISHED - сформирован (присваивается при записи документа в БД
после успешного прохождения всех проверок);
SIGNED - подписан (присваивается по факту подписания пользователем);
REJECTED - отклонён (присваивается, если пользователь отказывается от
подписания документа);
OUTDATED - устарел (присваивается в случае, если документ был
подписан ранее, но вместо него был подписан новый документ);
CANCELLED - аннулирован (присваивается в случае аннулирования
документа)

217
5.6.7. Метод получения списка ИНН доверенных участников оборота товаров
Для того, чтобы воспользоваться данным методом у участника оборота товаров должно быть
действующее согласие о предоставлении информации
Тип приватности:
1. Приватный.
2. Оператор.
URL: /agreement-registry/trusted/{ownerInn}/list
Метод: GET
Пример строки запроса:
curl -X GET "<url стенда>/agreement-
registry/trusted/1111111111/list?inn=string&name=string&offset=0&limit=0&needTotal=true
" -H "accept: application/json"

Параметры запроса

Параметр Тип Обяз. Описание Комментарий

ownerInn string + ИНН доверителя
inn string - ИНН участника оборота товаров
name string - Наименование организации участника оборота
товаров
offset integer($int64) - Смещение страницы Значение по умолчанию: 0
limit integer($int32) - Предельное количество записей Значение по умолчанию: 0
needTotal boolean - Признак необходимости подсчёта суммарного числа Значение по умолчанию:
записей "true"

В запросе должен быть указан параметр "ownerInn" ("ИНН доверителя"), иначе в ответе возвращается
ошибка 400 "Bad request" (ошибка в параметрах запроса).
Пример ответа:
1. В случае успеха 200 "Данные успешно получены".
{
"results":[
{
"inn":"string"
}
],
"total":0,
"expirationDate":"string",
"everyonePermitted": true,
"last":true
}

218
Параметры ответа

Параметр Тип Обяз. Описание Комментарий

results [array] + Список ИНН, Если у доверителя, участника оборота товаров,
возвращаемых в запросе подписан договор согласия с признаком
предоставления сведений всем контрагентам, то
параметр "results" должен быть пустым, а параметр
"everyonePermitted" = true
*inn string + ИНН участника оборота
товаров
expirationDate string - Дата окончания срока Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z.
(date- действия согласия,
time) указанная при создании
документа согласия
everyonePermitted boolean - Признак предоставления Если подписанное согласие предоставлено для всех
согласия для всех контрагентов, то в ответе "everyonePermitted" = true, и
контрагентов параметр "inn" возвращается пустым. Если
"everyonePermitted" = false, то возвращается список
ИНН доверенных контрагентов
total number - Общее количество
записей
errorCode string - Код ошибки Параметр возвращается при наличии ошибки
last boolean - Последняя запись на
странице

Если у доверителя подписан договор согласия с признаком предоставления сведений всем

контрагентам, то параметр "results" возвращается пустым.

5.6.8. Метод проверки ИНН доверенного участника оборота товаров

Метод используется для проверки наличия у ИНН участника оборота товаров признака доверия в
соответствии с согласием о предоставлении информации.
Тип приватности: публичный (с использованием токена).
URL: /agreement-registry/trusted/{ownerInn}
Метод: POST
Пример строки запроса:
curl -X GET "<url стенда>/agreement-registry/trusted/00000001?trustedInn=00000002" -H
"accept: application/json"

Параметры запроса

219
Параметр Тип Обяз. Описание Комментарий
ownerInn string + ИНН
предполагаемого
доверителя
trustedInn string(10- + ИНН доверенного
12) участника оборота
товаров
everyonePermitted boolean - Признак При необходимости подписания согласия для всех
предоставления контрагентов значение параметра должно быть "true", при
согласия для всех этом параметр "trustedInn" должен быть пустым.
контрагентов Заполнение обоих параметров одновременно
недопустимо. При передаче списка ИНН доверенных
контрагентов в параметре "trustedInn" параметр
"everyonePermitted" должен быть либо пустым, либо
иметь значение "false". Параметр "everyonePermitted"
автоматически принимает значение "false" при передаче
пустого значения

Пример ответа:
1. В случае успеха 200 "Данные успешно получены".
{
"trusted": true,
"expirationDate": "string"
}

2.В случае ошибки 400 "Входные параметры некорректны".

{
"error": "string",
"error_description": "string"
}

Параметры ответа

Параметр Тип Обяз. Описание Комментарий

trusted boolean + Признак предоставленного доверия Параметр принимает значение "true",
участнику если доверия предоставлено, иначе -
"false"
expirationDate string + Дата окончания срока действия согласия, Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-time) указанная при создании документа
согласия
error string - Ошибка Возвращается только в случае ошибки

220
5.6.9. Метод получения списка ИНН по идентификатору документа согласия о предоставлении
информации
Метод возвращает список доверенных ИНН по указанному идентификатору согласия. Список ИНН
возможно получить по подписанному/аннулированному согласию.
Тип приватности:
1. Приватный.
2. Оператор.
URL: agreement-registry/agreement/{id}/trusted-inns
Метод: GET
Пример строки запроса:
curl -X GET "<url стенда>/agreement-registry/agreement/9df4ffeb-20ec-4c30-9b2b-
0f3370421cb2/trusted-inns" -H "accept: application/json"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа согласия

Пример ответа:
1. В случае успеха 200 "ИНН получен".
{
"trustedInns": [
"string"
],
"everyonePermitted": true,
"expirationDate": 0
}

2.В случае ошибок 400, 404 и 500.

{
"error": "string",
"error_description": "string"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

trustedInns [string] + Список доверенных ИНН
контрагентов
everyonePermitted boolean - Признак предоставления Если подписанное согласие предоставлено для всех

221
Параметр Тип Обяз. Описание Комментарий
согласия для всех контрагентов, то в ответе "everyonePermitted" = true, и
контрагентов параметр "trustedInns" возвращается пустым. Если
"everyonePermitted" = false, то возвращается список
доверенных ИНН контрагентов
expirationDate string + Дата окончания срока Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z
(date- действия согласия,
time) указанная при создании
документа согласия
error string - Ошибка Возвращается только в случае ошибки

5.7. Метод регистрация табачной продукции от производителя/импортёра

В результате успешной отправки xml-файла с формой МТПФ-20 (далее в настоящем методе -
Документ) в ответе возвращается статус выполнения данной операции. Перед отправкой Документ
должен быть подписан УКЭП.
Заявление о регистрации табачной продукции представляет только производитель или импортер
табачной продукции.
Тип приватности: приватный.
URL: /external-api/tp
Метод: POST
Content-Type: application/json
Параметры тела запроса:

Параметр Тип Обяз. Описание

Content-Disposition string + Наименование xml-файла с заполненной формой подписанного УКЭП Документа
Send-Receipt-To string + URL-адрес для ответных квитанций

XSD схема документа:

<?xml version="1.0" encoding="windows-1251"?>
<xs:schema elementFormDefault="qualified"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="<FileName>">
<xs:complexType>
<xs:sequence>
<xs:element name="РегистрацияПродукции">
<xs:complexType>
<xs:sequence>
<xs:element name="СписокПродукции" type="СписокПродукции"
minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

222
 </xs:element>
</xs:sequence>
<xs:attribute name="<FileName>" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="MTTPS-(([1-9][0-9]\{1,2}))_((((19|20)[0-
9]\{2})-(((0[1-9]\{1}|1[0-2]\{1})-(0[1-9]\{1}|1[0-9]\{1}|2[0-8]\{1}))|((01|0[3-
9]\{1}|1[0-2]\{1})-(29|30))|((01|03|05|07|08|10|12)-
31)))|(((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))-02-29)))_[0-9a-fA-F]\{8}\-[0-
9a-fA-F]\{4}\-[0-9a-fA-F]\{4}\-[0-9a-fA-F]\{4}\-[0-9a-fA-F]\{12}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="ВерсияФормата" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="1.001"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="ВерсияПрограммы" use="optional">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
<xs:maxLength value="100"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="ТипДокумента" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="РегистрацияПродукции"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:simpleType name="НомерСтроки">
<xs:restriction base="xs:integer">
<xs:totalDigits value="9"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="СписокПродукции">
<xs:sequence>
<xs:element name="НомерСтроки" type="НомерСтроки"/>
<xs:element name="GTINПродукции">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="14"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="ИмяПродукции">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="5"/>
</xs:restriction>

223
 </xs:simpleType>
</xs:element>
<xs:element name="КодТНВЭД">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="КодОКПД2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="12"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="КодАкциза">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:totalDigits value="3"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:schema>

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

status string + Код статуса ответа См. Справочник "Статусы ответов"

Пример запроса:
POST <url стенда>/external-api/tp
Content-Type: application/json
Authorization: Bearer <ТОКЕН>
Cache-Control: no-cache
Send-Receipt-To: /external-api/tp/doc
Content-Disposition: attachment; filename="Example_MTTPS-20.xml"

Пример ответа: 1 В случае успеха:

200 OK
2 В случае ошибок:
2.1. Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

224
5.8. Метод получения истории движения КИ ТГ "Табачная продукция"
Метод возвращает информацию о движении (истории) запрашиваемых КИ (в одном запросе
указывается один КИ) по событиям, в которых УОТ принимал участие, чей токен используется при
выполнении запроса.
Каждый УОТ видит производителя продукции, своего продавца и текущего владельца. Если данных
УОТ, сформировавшего запрос, нет в цепочке движения, то возвращается только производитель и
текущий владелец. Если КИ выведен из оборота, то вместо текущего владельца возвращается
соответствующая информация.
Тип приватности:
1. Приватный;
2. Для производителей продукции;
3. Для покупателей продукции;
4. Для Оператора;
5. Для ФОИВ;
6. Для Администратора.
URL: /cises/history
Метод: GET
Пример запроса:
curl -X GET <url стенда>/cises/history?cis=(01)04600266012258(21)5n4Jh5D' \
--header 'Authorization: Bearer ' <Токен>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

cis array[string] + Код идентификации

Пример ответа:
1.Код 200. В случае успеха:
[
{
"cis": "string",
"gtin": "string",
"packageType": "string",
"ownerInn": "string",
"status": "string",
"maxRetailPrice": 0,
"child": [

225
 "string"
],
"parent": "string",
"producerInn": "string",
"timestamp": 0,
"operationDate": 0,
"emissionDate": 0,
"docId": "string",
"partialSaleInfo": {
"soldUnitCount": 0,
"rest": 0,
"correctRest": true,
"innerUnitCount": 0
},
"turnoverType": "string",
"productGroup": "string"
}
]

2.В случае ошибок:

2.1. Код 401 В случае, когда указан устаревший токен:
<InvalidTokenException>
<error>invalid_token</error>
<error_description>Access token expired:
eyJhbGciOi...zSPUg</error_description>
</InvalidTokenException>

2.2. Код 404 Если указанный КИ не найден:

{
"error_message": "КМ не найдены"
}

2.3. Код 400 При неправильном формате КИ в URL:

{
"error_message": "Неверный формат КМ"
}

2.4 Код 400 Если используется КИ из другой ТГ

{
"error_message": "КМ принадлежит ТГ отличной от МОТП"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

cis string + КИ ГИС МТ
gtin string + Код товара Если код товара менее 14 символов, то он дополняется
ведущими нулями

226
Параметр Тип Обяз. Описание Комментарий
packageType string + Код типа упаковки Тип упаковки. см. Справочник "Типы упаковки"
ownerInn string - ИНН собственника
товара
*maxRetailPrice number - Максимальная цена Возвращается для ТГ «Табачная продукция»,
розничной продажи «Альтернативная табачная продукция» и
«Никотиносодержащая продукция» только для пачки или
блока. Если у блока или пачки отсутствует МРЦ, то
параметр не возвращается. Для блока значение =
maxRetailPrice*количество штук в блоке. При отсутствии
информации в БД выводится значение NULL //// Если в
составе КИ в запросе присутствует МРЦ, то поиск
осуществляется с учётом МРЦ. Если МРЦ в ГИС МТ
найдена и отличается от МРЦ в составе КИ в запросе, то в
ответе будет получена ошибка "Код не найден". Если МРЦ
в ГИС МТ отсутствует, то поиск КИ осуществляется без
указания МРЦ ////
child array - Список КИ в агрегате
[string]
parent string - КИ агрегата
timestamp string - Отметка времени Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
emissionDate string - Дата эмиссии Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-
time)
operationDate string - Дата создания Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date- документа, по
time) которому в последний
раз менялся статус КИ
docId string - Номер документа, по
которому в последний
раз менялся статус КИ
partialSaleInfo object - Объект параметров Возвращается для ТГ "Духи и туалетная вода" (объём в в
частичного выбытия мл.)
*innerUnitCount number - Общее количество Значением параметра является количество товара в
(объем) товара в потребительской упаковке
потребительской
упаковке
*soldUnitCount number - Количество (объём) Значением параметра является число выбывших, в том
выведенного из числе от невладельцев, из оборота единиц употребления из
оборота товара по КИ всех чеков УОТ отображается информация только по
собственным чекам. ФОИВ доступна информация по всем
чекам
*rest number - Количество товара, Значением параметра является расчётное количество
доступного к выводу оставшихся в потребительской упаковке единиц
из оборота по КИ употребления товара после продажи всеми УОТ. УОТ

227
Параметр Тип Обяз. Описание Комментарий
отображается информация только по собственным чекам.
ФОИВ доступна информация по всем чекам
*correctRest boolean - Корректность остатка Показатель корректности остатка товара после вывода
товара товара из оборота: false - продано или возвращено больше
допустимого количества товара; true - продано или
возвращено в пределах допустимого количества товара
productGroup string + Товарная группа См. "Справочник "Список поддерживаемых товарных
групп""
turnoverType string - Код типа отгрузки Возможные значения:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент

5.9. Метод проверки КИ ТГ "Табачная продукция" на вхождение в "Серую зону"

Метод возвращает информацию по заданному списку кодов о принадлежности кодов к серой зоне,
для транспортных упаковок – о наличии кодов из "Серой зоны" в их составе.
Возвращаемые параметры "gzPacks" и "gzBlocks" – это расчетные единицы для агрегатов, которые
считаются на основании разницы физической емкости упаковки и указанных при агрегировании
кодов, т.е. это потенциальное число блоков и пачек, которые могут находится в "Серой зоне" в
данной упаковке. Признак "Серой зоны" для пачки/блока проставляется на основании отчета от
производителя. gzBlocks - расчетное суммарное число блоков в коробе, которые либо полностью в
серой зоне, либо в них есть пачки, включённые в серую зону. gzPacks - расчетное суммарное число
пачек из серой зоны по блокам из короба
Тип приватности: публичный
URL: /cises/gz/info
Метод: POST
Пример запроса:
POST <url стенда>/cises/gz/info
Authorization: Bearer <ТОКЕН>
Content-Type: application/json
["000000462106549pJu6lt","(01)00000046210654(21)4u4qrBQ",
"0100000046057555211KWMj2680050950009133Iz92djit","010460026601214221000003E80051234569
34g7O"]

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

codes array + Массив кодов Массив не пустой, допускается получение от 1 до 1000
[string] идентификации элементов в массиве.

Пример ответа:
228
[
{
"info": {
"code": "string",
"packageType": "UNIT",
"inGrayZone": true,
"applicationDate": "2020-09-04T08:09:34.484Z",
"containsGrayCodes": true,
"aggCount": 0,
"gzPacks": 0,
"gzBlocks": 0
},
"errorMessage": "string",
"errorCode": "string"
}
]

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

code string + Код идентификации
packageType string + Тип упаковки Справочник "Типы упаковки"
inGrayZone boolean - Фактическая принадлежность кода к true – если пачка/блок в серой зоне;
серой зоне, заполняется только для false – если пачка/блок не в серой зоне
пачек/блоков
applicationDate string - Дата нанесения Формат: yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z. Возвращается
time) только для пачек и блоков, если
"inGrayZone" = true
containsGrayCodes boolean - Наличие расчетных серых кодов в true – в составе агрегата есть серые
составе агрегата коды;
false – в составе агрегата нет серых
кодов
aggCount number - Количество вложений нижестоящего Заполняется только для агрегатов,
уровня в агрегате если containsGrayCodes = true
gzPacks number - Расчетное суммарное число пачек из Заполняется только для агрегатов,
"Серой зоны" по блокам из короба если containsGrayCodes = true
gzBlocks number - Расчетное суммарное число блоков в Заполняется только для агрегатов,
коробе, которые либо полностью в если containsGrayCodes = true
"Серой зоны", либо в них есть пачки,
включённые в "Серую зону"
errorCode string - Код ошибки См. Справочник "Статусы ответов"
Параметр указывается при наличии
ошибки
errorMessage string - Сообщение об ошибке См. Справочник "Статусы ответов"
Параметр указывается при наличии
ошибки

229
6. Работа с документами и чеками в ГИС МТ
6.1. Метод получения списка загруженных документов в ГИС МТ
Тип приватности: приватный
URL: /doc/listV2
Метод: GET
Пример строки запроса:
curl '<url стенда>/doc/listV2?dateFrom=2019-06-13T11%3A59%3A53.570Z&dateTo=2021-12-
13T11%3A59%3A53.570Z&did=cc79fbd8-5b12-4d98-b7ca-
c38ee4c92fa9&documentFormat=MANUAL&documentStatus=
IN_PROGRESS%2CCHECKED_OK%2CCHECKED_NOT_OK&documentType=LP_ACCEPT_GOODS%2COST_DESCRIPTIO
N&inputFormat
=false&limit=10&number=be1edfc3-9308-4274-8248-
4c91fedc035f&order=ASC&orderColumn=DATE&orderedColumnValue=
2020-06-07T15:34:01.980Z&pageDir=PREV&participantInn=1901089824&pg=lp
-H 'content-type: application/json' -H 'Authorization: Bearer <ТОКЕН>'

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

dateFrom (date- - Дата документа, от Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
dateTo (date- - Дата документа, до Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
did string + Значение номера документа,
"точки отсчёта" (запись, с которой
начнется выборка), по которому
сортируются записи. Параметр
является обязательным при
заполненном параметре
"orderedColumnValue"
documentFormat string - Тип документа:
MANUAL – формат json;
UPD – ЭДО;
XML – формат XML;
CSV – формат CSV
documentStatus string - Статус документа См. Справочник "Статусы документов"
documentType [string] - Тип документа Cм. Справочник "Типы документов"
inputFormat boolean - Входящий (true)/исходящий (false)
документ
limit integer - Значение устанавливает
количество записей в ответе (не
более 10000 записей, по
умолчанию 10 записей). При

230
Параметр Тип Обяз. Описание Комментарий
указании данного параметра
необходимо указать товарную
группу
number string - Номер документа
order enum - Направление сортировки:
ASC – по возрастанию;
DESC – по убыванию
orderColumn string - Название столбца, по которому Допустимые значения:
будет производиться сортировка "receivedAt" - дата приёма/обработки
документа в ГИС МТ;
"docDate" - дата документа ЭДО

orderedColumnValue string - Значение столбца, "точки отсчета"

(запись, с которой начинается
выборка), по которому
сортируются записи. Использовать
только совместно с параметром
"did"
pageDir enum - Выбор направления:
PREV – предыдущий раздел;
NEXT – следующий раздел
participantInn string - ИНН участника, осуществившего
эмиссию КМ
pg string + Товарная группа См. Справочник "Список поддерживаемых
товарных групп" Параметр обязательно
указывать при установке параметра "limit".
В параметре "pg" также доступно указание
значения "empty" ("Неопределённая
товарная группа"). Данное значение
указывается с целью выявления
документов, для которых товарная группа
не была определена

В запросе должен быть указан хотя бы один параметр, иначе в ответе возвращается ошибка 400 "Bad
request" (ошибка в параметрах запроса).
Пример ответа:
{
"results": [
{
"number": "string",
"docDate": "string",
"receivedAt": "string",
"type": "UNKNOWN",
"status": "string",
"externalId": "string",
"senderInn": "string",
"senderName": "string",

231
 "receiverInn": "string",
"receiverName": "string",
"relatedDocId": null,
"invoiceNumber": "string",
"invoiceDate": "string",
"total": 0,
"vat": 0,
"downloadStatus": "string",
"downloadDesc": "string",
"body": {
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
},
"content": "string",
"input": true,
"pdfFile": "string",
"errors": [
"string"
],
"docErrors": [
{
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
}
],
"sender": {
"name": "string",
"address": "string",
"inn": "string",
"kpp": "string"
},
"receiver": {
"name": "string",
"address": "string",
"inn": "string",
"kpp": "string"
}
}
],
"total": 0
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

results: +
*number string - id документа для УД – полное имя файла
*docDate string - Дата и время документа Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
*receivedAt string - Дата и время получения в формате yyyy-MM-ddTHH:mm:ss.SSS’Z.

232
Параметр Тип Обяз. Описание Комментарий
(date- документа Пример 2019-01-01T03:00:00.000Z
time)
*type string + Тип документа См. Справочник "Типы документов"
*status string + Статус обработки документа См. Справочник "Статусы документов"
*senderInn string - ИНН отправителя документа
*senderName string - Наименование отправителя
документа
*relatedDocId string +
*receiverInn string - ИНН получателя документа
*receiverName string - Наименование получателя
документа
*invoiceNumber string - Номер счёта-фактуры, УКД Для ТГ "Табачная продукция" не выводится
*invoiceDate string - Дата счёта-фактуры, УКД Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
*total number - Общая сумма документа Сумма в копейках
*vat number - Сумма НДС документа Сумма в копейках
*downloadStatus string - Статус загрузки документа см. Справочник "Статусы документов"
*downloadDesc string - Описание загрузки документа При наличии ошибки в загрузке документа.
Справочник "Статусы ответов"
*body object - Контент документа Содержимое документа в формате JSON с
набором полей, специфичных для каждого типа
документа.
Значение параметра может быть пустым для
любой ТГ, кроме ТГ "Табачная продукция" и
"АТП"
additionalProp Object - Контент документа Тело документа
*content string - Контент документа Содержимое документа в начальном виде
*input boolean - Признак того, что документ Возможные значения:
является входящим/исходящим true – входящий;
false – исходящий
*pdfFile string - Ссылка на PDF-файл
*errors [string] - Ошибки. Параметр для УД ошибки не будут возвращаться
возвращается при наличии
ошибки
*docErrors [string] - Список ошибок обработки Только в случае ошибки. Для ТГ "Табачная
документа продукция" не выводится
additionalProp string - Список ошибок обработки Структура данных, состоящая из перечня
документа ошибок обработки документа. Возвращается в
случае ошибки

233
Параметр Тип Обяз. Описание Комментарий
*errorMessage string - Сообщение об ошибке при Параметр возвращается при наличии ошибки.
обработке json, xml Выводится только для УД документов. Общее
описание ошибки по документу.
*errorMessages List - Список сообщений об ошибке Параметр возвращается при наличии ошибок
<string> при обработке самого документа
*sender string - Отправитель Только для УКД
**name string - Наименование
**address string - Адрес
**inn string - ИНН
**kpp string - КПП код причины постановки на учет
*receiver string - Получатель Только для УД
**name string - Наименование
**address string - Адрес
**inn string - ИНН
**kpp string - КПП код причины постановки на учет
total integer + Количество вернувшихся документов в ответе

6.2. Метод получения списка загруженных чеков ККТ в ГИС МТ

Тип приватности: приватный
URL: /receipt/listV2
Метод: GET
Пример запроса:
curl -X GET
"<url стенда>/receipt/listV2?dateFrom=2020-03-01T17%3A47%3A49.000Z&dateTo=2020-07-
31T17%3A47%3A49.000Z&did=111656675222335054&limit=10&order=ASC&pageDir=PREV&senderInn=7
809008119&pg=tobacco"
-H "accept: */*" -H "Authorization: Bearer <ТОКЕН>"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

dateFrom (date- - Дата документа, от Формат: yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
dateTo (date- - Дата документа, до Формат: yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
did string - Значение номера документа, "точки отсчёта" (запись, с которой
начнется выборка), по которому сортируются записи. Параметр
является обязательным при заполненном параметре

234
Параметр Тип Обяз. Описание Комментарий
"orderedColumnValue"
limit integer - Значение устанавливает количество записей в ответе (не более
10000 записей, по умолчанию 10 записей). При указании
данного параметра необходимо указать товарную группу
order enum - Направление сортировки:
ASC – по возрастанию;
DESC – по убыванию
pageDir enum - Выбор направления:
PREV – предыдущий раздел;
NEXT – следующий раздел
senderInn string - ИНН отправителя документа
pg string - Товарная группа:
параметр обязателен для товарных групп:
milk – "Молочная продукция";
water – "Упакованная вода";
tobacco – "Табачная продукция";
otp – "Альтернативная табачная продукция"

Пример ответа:
[
{
"did": "string",
"receiptDate": "2020-09-09T16:10:20.538Z",
"type": "string",
"status": "string",
"senderInn": "string",
"senderName": "string",
"total": 0
}
]

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

did string + Значение номера документа, "точки отсчета"
(запись, с которой начнется выборка), по которому
сортируются записи
receiptDate string + Дата вывода из оборота Возвращается в формате yyyy-
(date- MM-ddTHH:mm:ss.SSS’Z
time)
type string + Тип документа См. Справочник "Типы
документов"
status string + Статус обработки документа См. Справочник "Статусы
документов"
senderInn string - ИНН отправителя документа

235
Параметр Тип Обяз. Описание Комментарий
senderName string + Отправитель
total integer + Общее количество значений, подходящие под
параметры фильтрации

6.3. Метод поиска содержимого документа по идентификатору документа

В ответе на запрос возвращается содержимое документа.
Тип приватности:

Администратор.
URL: /doc/{docId}/content
Метод: GET
Пример запроса:
curl -X GET '<url стенда>/doc/{docId}/content"
-H 'Authorization: Bearer <ТОКЕН>'

Параметры заголовка запроса: Authorization: Bearer <token>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

docId string + Номер документа
pg string - Товарная группа См. Справочник "Список поддерживаемых товарных групп"

Пример ответа:
[
"string"
]

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

content string + Содержимое документа

1.В случае ошибки 400: "Ошибка получения тела документа".

{
"error_message": "string"
}

2.В случае ошибки 401: "Для доступа к данному ресурсу требуется полная аутентификация".

236
{
"error": "string",
"error_description": "string"
}

3.В случае ошибки 404: "Документ с указанным идентификатором не найден"

{
"error": "string",
"error_description": "string"
}

4.В случае ошибки 500: "Ошибка при выполнении запроса".

{
"error": "string",
"error_description": "string"
}

6.4. Метод получения содержимого документа по идентификатору

Метод возвращает общую информацию о запрашиваемом документе, включая статус обработки
документа. В одном запросе возможно запросить информацию по одному документу (см.
"Справочник "Типы документов""). Получение информации о документе возможно только в том
случае, если участник оборота товаров, запрашивающий информацию о документе, является
стороной данного документа.
Для ТГ "Духи и туалетная вода" метод возвращает в ответе только коды идентификации из тела
документа (см. "Справочник "Типы документов"") без отражения информации о кодах
идентификации дочерних вложений, входящих в состав агрегирующих кодов идентификации:
параметры "count_children" и "children" в ответе остаются скрытыми.
Тип приватности: приватный
1. Оператор;
2. ФОИВ;
3. Администратор.
URL: /doc/{docId}/info
Метод: GET
Пример запроса:
curl -X GET "<url стенда>/doc/f460134e-41fa-44d3-813d-3cf7c5f9468c/info?pg=3&limit=15
-H "accept: */*" -H "Authorization: Bearer <Токен>

Параметры запроса:

237
Параметр Тип Обяз. Описание Комментарий
docId string + Идентификатор / номер документа,
формируемый в ГИС МТ
limit integer - Значение устанавливает количество При указании данного параметра необходимо
записей в ответе (не более 10 000 указать товарную группу. При limit=0 не
записей, по умолчанию 10 записей) выводятся КИ, содержащиеся в запрашиваемом
документе
pg string - Товарная группа См. Справочник "Список поддерживаемых
товарных групп"

Пример ответа:
1.В случае успеха:
1.1. Для всех ТГ, кроме ТГ "Табачная продукция" и "Альтернативная табачная продукция":
{
"number": "string",
"docDate": "2020-04-16T09:29:01.120Z",
"receivedAt": "2020-04-16T09:29:01.120Z",
"type": "UNKNOWN",
"status": "string",
"externalId": "string",
"senderInn": "string",
"senderName": "string",
"receiverInn": "string",
"receiverName": "string",
"invoiceNumber": "string",
"invoiceDate": "2020-04-16T09:29:01.120Z",
"total": 0,
"vat": 0,
"downloadStatus": "string",
"downloadDesc": "string",
"body": {
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
},
"content": "string",
"input": true,
"pdfFile": "string",
"errors": [
"string"
],
"docErrors": [
{
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
}
],
"sender": {
"name": "string",

238
 "address": "string",
"inn": "string",
"kpp": "string"
},
"receiver": {
"name": "string",
"address": "string",
"inn": "string",
"kpp": "string"
}
}

1.2. Для ТГ "Табачная продукция" и "АТП":

{
"number": "string",
"docDate": "2020-05-27T17:18:45.144Z",
"receivedAt": "2020-05-27T17:18:45.144Z",
"type": "UNKNOWN",
"status": "IN_PROGRESS",
"externalId": "string",
"senderName": "string",
"receiverName": "string",
"invoiceNumber": "string",
"invoiceDate": "2020-05-27T17:18:45.144Z",
"total": 0,
"vat": 0,
"downloadStatus": "string",
"downloadDesc": "string",
"body": {
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
},
"content": "string",
"input": true,
"pdfFile": "string",
"errors": [
"string"
]
}

2.В случае ошибок:

2.1. Код 401, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

2.2. Код 403, если документ недоступен:

239
{
"error_message":"Отсутствует доступ к ресурсу"
}

2.3. Код 404, если отсутствует документ с указанным в URL идентификатором:

{
"error_message":"Документ с указанным идентификатором не найден"
}

2.4. При возникновении любых ошибок при запросах к gismt-api-service на этапе получение тела
документа для ТГ "Табачная продукция" и "Альтернативная табачная продукция" (параметра "body"
ответа):
{
"error_message":"Ошибка получения тела документа"
}

2.5. Код 400:

{
"error_message": "Ошибка получения тела документа"
}

2.6. Код 500:

{
"error_message": "Произошла внутренняя ошибка"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

number string - Номер документа
docDate string - Дата и время документа Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
receivedAt string - Дата и время получения Возвращается в формате yyyy-MM-
(date- документа ddTHH:mm:ss.SSS’Z
time)
type string - Тип документа См. Справочник "Типы документов"
status string + Статус обработки документа См. Справочник "Статусы документов"
externalId string - ID документа во внешней
системе ЭДО
senderInn string - ИНН отправителя документа
senderName string - Наименование отправителя
документа
receiverInn string - ИНН получателя документа

240
Параметр Тип Обяз. Описание Комментарий
receiverName string - Наименование получателя
документа
invoiceNumber string - Номер счёта-фактуры, УКД
invoiceDate string - Дата счёта-фактуры, УКД Возвращается в формате yyyy-MM-
(date- ddTHH:mm:ss.SSS’Z
time)
total number - Общая сумма документа
vat number - Сумма НДС документа
downloadStatus string - Статус загрузки документа См. Справочник "Статусы документов"
downloadDesc string - Описание загрузки документа
body object + Тело документа
additionalProp Object + Контент документа Тело документа
content string + Содержимое документа Содержимое отправленного документа в формате
JSON с набором полей, специфичных для
каждого типа документа. См. Справочник "Типы
документов"
input boolean - Признак того, что документ Возможные значения:
является входящим/исходящим true – входящий;
false – исходящий
pdfFile string - Ссылка на PDF-файл
errors [string] - Ошибки (параметр возвращается При ошибке в УД параметр не возвращаются.
при наличии ошибки) Используется для вывода ошибок при прямой
подаче сведений в документах, загруженных в
ГИС МТ
docErrors [string] - Список ошибок обработки
документа. Только в случае
ошибки
additionalProp string - Список ошибок обработки Структура данных, состоящая из перечня ошибок
документа обработки документа. Возвращается в случае
ошибки
errorMessage string - Сообщение об ошибке при Параметр возвращается при наличии ошибки
обработке документа в формате только для УД документов (общее описание
JSON, XML ошибки по документу)
errorMessages List - Список сообщений об ошибке Параметр возвращается при наличии ошибок
<string> при обработке самого документа
atk string - Агрегированный таможенный
код
sender string - Отправитель Возвращается только для УД
*name string - Наименование
*address string - Адрес
*inn string - ИНН

241
Параметр Тип Обяз. Описание Комментарий
*kpp string - КПП Код причины постановки на учёт
receiver string - Получатель Возвращается только для УД
*name string - Наименование
*address string - Адрес
*inn string - ИНН
*kpp string - КПП Код причины постановки на учет

6.5. Метод получения содержимого чека ККТ по идентификатору

Тип приватности: приватный
URL: /receipt/{receiptId}/info
Метод: GET
Пример запроса:
curl -X GET "<url стенда>/receipt/41009929078910011255/info?pg=3"
-H 'content-type: application/json' -H 'Authorization: Bearer <ТОКЕН>'

Параметры тела запроса:

Параметр Тип Обязательность Описание Комментарий

receiptId string + Идентификатор чека
pg string - Товарная группа Параметр обязательно указывать для товарных групп:
milk – "Молочная продукция";
water – "Упакованная вода";
tobacco – "Табачная продукция";
otp – "Альтернативная табачная продукция"

Пример ответа:
{
"number": "000000000000000000",
"docDate": "2020-06-01T10:33:43.000Z",
"receivedAt": "2020-06-01T10:33:43.000Z",
"type": "RECEIPT",
"status": "CHECKED_OK",
"senderName": "ООО \"X\"",
"total": 280080,
"vat": 560160,
"downloadStatus": "CHECKED_OK",
"downloadDesc": "",
"body": {},
"content": {},
"pdfFile": "",

242
 "docErrors": []
}

Параметры ответа:

Параметр Тип Обяз. Описание

number string + Номер документа
docDate string (date-time) + Дата документа. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
receivedAt string (date) - Дата загрузки документа. Возвращается в формате yyyy-MM-dd
type string + см. "Справочник "Типы документов""
status enum + Статус обработки документа см. Справочник "Статусы документов"
senderName string + Отправитель
total integer (int64) - Общее количество значений, подходящие под параметры фильтрации
vat integer - Сумма НДС. Стоимость в копейках
downloadStatus string - Статус загрузки: Справочник "Статусы документов"
downloadDesc string - Полный список ошибок обработки документа
body object + Тело отправленного документа в json формате. См. Типы документов
content string + Оригинальное содержимое документа
pdfFile string - Ссылка на PDF-файл
docErrors string - Список ошибок обработки документа. Только в случае ошибки

6.6. Метод отправки документа ЭДО на повторную обработку

Данный метод используется для отправки документа УПД, УКД, УПД(и) или УКД(и), ранее
загруженного в ГИС МТ, на повторную обработку после исправления ошибки, найденной при
предыдущей обработке документа. Возможна повторная загрузка следующих типов документов:
UNIVERSAL_TRANSFER_DOCUMENT, UNIVERSAL_CORRECTION_DOCUMENT
UNIVERSAL_TRANSFER_DOCUMENT_FIX, UNIVERSAL_CORRECTION_DOCUMENT_FIX (см.
Справочник "Типы документов"). При загрузке иных типов документов будет выдана ошибка.

После того, как документ будет отправлен и принят на повторную обработку статус документа
изменится на "IN_PROGRESS" - "Проверяется" (см. "Справочник "Статусы документов""). Повторная
обработка недоступна для документов в статусах: CHECKED_OK, CANCELLED,
PROCESSING_ERROR, IN_PROGRESS (см. "Справочник "Статусы документов"").
Документ не будет обработан повторно, если по результату его первой обработки в ГИС МТ были
зафиксированы следующие типы ошибок:
• 4 - Проверка отсутствия регистрации УД (Документ $docId не может быть повторно обработан);

• 46 - Проверка имени файла и титулов УД (Имя или структура документа некорректны);

243
• 54 - Проверка заполненной даты исправления (Дата Исправления УПД(и) имеет пустое значение
или имеет неверный формат);

• 69 - Проверка кода итога приёмки товаров (работ, услуг, прав). Поле «КодИтога» Титула
Покупателя (если указан) заполнено некорректным значением;

• 71 - Проверка наличия сведений о маркированных товарах в УД. Проверка валидности УД (В

документе нет сведений о кодах идентификации маркированного товара);

• 72 - Проверка по типу документа (Некорректный тип документа: $docType);

• 76 - Проверка ID документа (Документ с id $id не найден);

• 79 - Коды идентификации имеют длину менее 18 символов либо содержат недопустимые

символы;

• 102 - Документ содержит КИ разных товарных групп;

• 103 - Документ не содержит Кодов Маркировки.

Код ошибки возвращается в параметре "code" Повторная обработка документа возможна не ранее,
чем через 4 часа.
Тип приватности: приватный.
URL: /document/reprocess
Метод: POST
Пример запроса:
curl -X POST "<url стенда>/document/reprocess?pg=2"
Content-Type: application/json
Authorization: Bearer <ТОКЕН>

Пример тела запроса:

{
"documentId": "string"
}

Параметры запроса

244
Параметр Тип Обяз. Описание Комментарий
documentId string + Идентификатор универсального
документа (ИдФайл)
pg string + Товарная группа См. Справочник "Список поддерживаемых
товарных групп"

Пример ответа
1. В случае успеха 200
{
"code":0,
"description":"Ok",
"resultDocId":"UTXMNGR00000000000000000013-9339",
"sourceDocId":"UUD00000000000000000007-5340",
"nextTimeToReprocess":"2021-02-24T18:33:49.110Z"
}

2.В случае ошибки 401: "Для доступа к этому ресурсу требуется полная аутентификация"
{
"error": "string",
"error_description": "string"
}

Параметры ответа

Параметр Тип Обяз. Описание Комментарий

code string + Уникальный код ошибки
description string + Описание кода ошибки
sourceDocId string - Внутренний идентификатор Возвращается при использовании токена с
документа в ГИС МТ правами администратора
resultDocId string - Внутренний идентификатор Возвращается при использовании токена с
квитанции в ГИС МТ правами администратора
nextTimeToReprocess (date- - Следующее время обработки Возвращается при использовании токена с
time) правами оператора. Значение возвращается в
UTC.
error string - Код ошибки
error_description string - Описание кода ошибки

6.7. Метод подачи УПД на предварительную проверку

После подачи УПД на стороне ГИС МТ выполняются следующие действия:
• проверка регистрации продавца и покупателя УД в ГИС МТ;
• проверка валидности УД и отсутствия дублирования в ГИС МТ;

245
• проверка корректности КИ УД и наличия сведений о маркированных товарах в ГИС МТ;
• проверка статуса УОТ;
• проверка полномочий продавца на операции с КИ.
На проверку могут быть отправлены только документы УПД и УПДи до осуществления приёмки
продукции со стороны покупателя.
Тип приватности: публичный
URL: /doc/validator/create
Метод: POST
Пример запроса:
curl -X POST "<url стенда>/doc/validator/create"
-H "accept: application/json" -H "Content-Type: application/json"
-d
"{\"id\":\"string\",\"content\":\"string\",\"documentType\":\"string\",\"documentFormat
\":\"string\"}"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа
content string + Документ, закодированный в
base64
documentType string + Тип документа Поддерживается только тип UPD (универсальный
передаточный документ)
documentFormat string + Формат документа Поддерживается только формат XML

Пример ответа:
1.В случае успеха
{
"message": "string"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

message string + Сообщение о том, что подаваемый документ успешно В случае ошибки выводится
отправлен в ГИС МТ сообщение об ошибке

2.В случае ошибок:

2.1 Код 409: "Проверяемый документ находится в несуществующем статусе"

246
{
"error_message":"Текст ошибки"
}

2.2 Код 500: "Внутренняя ошибка сервиса"

{
"error_message":"Текст ошибки"
}

6.8. Метод получения статуса обработки документа

Метод предназначен для получения текущего статуса проверки документов УПД и УПДи,
направленных в ГИС МТ до проведения первичной отгрузки товаров. Данный метод не используется
для получения статуса проверки УКД и УКДи. В успешном ответе возвращается параметр "status" со
значением одного из приведенных ниже кодов статусов:
Код Описание
VERIFIED Проверка завершена успешно
NOT_VALID Ошибка проверки
NOT_FOUND Не найден
IN_PROGRESS В обработке
AWAITING В ожидании

Тип приватности: публичный

URL: /doc/validator/status
Метод: POST
Пример запроса:
curl -X POST "/api/v3/true-api/doc/validator/status"
-H "accept: application/json" -H "Content-Type: application/json" -d
"{\"id\":\"string\"}"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

id string + ID документа

Пример ответа:
1.В случае успеха
{
"status":"VERIFIED",
"description":"Успешно проверен"
}

247
2.В случае ошибок:
2.1. Код 404: "Документ не найден"
{
"error_message": "Текст ошибки",
"error_description": "Описание ошибки"
}

2.1. Код 500: "Внутренняя ошибка сервера"

{
"error_message": "Текст ошибки",
"error_description": "Описание ошибки"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

status string + Статус проверки
errors string - Ошибка обработки документа Обязательный, если "status" принимает значение
NOT_VALID (ошибка проверки)
*code number - Код ошибки
*description string - Текстовое сообщение с
результатом проверки
*cis string + КИ/КИН/КИТУ/КИГУ/КИТУ Проверка вложений в КИН/КИТ/КИГУ/КИТУ не
осуществляется. Возвращаются
КИ/КИН/КИТ/КИГУ/КИТУ (без указания вложений),
по которым выявлены ошибки.

Выполняется проверка документа на наличие следующих ошибок:

Код
ошибки Описание ошибки
13 Участник <ИНН> не идентифицирован (не зарегистрирован)
46 Содержание или имя документа некорректно
82 УПД <docId> для счёт-фактуры №: <номер>, дата: <дата> не валидный (зарегистрирован ранее либо был
проведён УПДи)
71 В документе нет сведений о маркированном товаре
79 Неверный код маркировки <код>
22 Коды Маркировки <код> не найден(ы)
102 Документ содержит мультитоварные Коды Маркировки
24 Статус Кода Маркировки <код> не соответствует выполняемой операции
23 У участника <ИНН> нет полномочий на выполнение операции с Кодом Маркировки <код>

248
Ограничение по количеству возвращаемых ошибок по документу: 1000.

6.9. Метод получения списка КИ по номеру документа

Метод отражает КИ, которые когда-либо были в документе, включая агрегаты, на которые повлиял
данный документ. В ответе возвращается список КИ по номеру документа, указанному в запросе.
Тип приватности:
1. Приватный (только автору заказа);
2. Оператор ЦРПТ;
3. ФОИВ;
4. Администратор.
URL: /cises/doc/{docNum}
Метод: GET
Пример запроса:
curl -X GET '<url стенда>/cises/doc/79b5d681-52af-49cd-9603-4f7a141f4764' \
--header 'accept: */*' \
--header 'Authorization: Bearer <ТОКЕН>'

Параметры заголовка запроса: Authorization: Bearer <token>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

docNum string + Номер документа
pg string - Товарная группа См. "Справочник "Список поддерживаемых товарных групп""

Пример ответа:
{
"gtins":[
"string"
]
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

gtins string + Список запрашиваемых КИ

Примеры ответа в случае ошибок

1.В случае ошибки 400: "Неизвестная товарная группа".

249
{
"error_message": "string"
}

2.В случае ошибки 401: "Для доступа к данному ресурсу требуется полная аутентификация".
{
"error": "string",
"error_description": "string"
}

3.В случае ошибки 500: "Ошибка при выполнении запроса".

{
"error": "string",
"error_description": "string"
}

6.10. Метод получения списка кодов идентификации и GTIN по номеру документа

Метод используется для получения списка КИ и GTIN по номеру документа, обработанного успешно
или обработанного с ошибкой. В запросе может быть указан только один ID документа. Метод не
предназначен для запроса информации по УПД и УКД.
Тип приватности:
1. публичный;
2. для отправителя документа;
3. для получателя документа;
4. Оператор;
5. Администратор
URL: /doc/cises
Метод: POST
Пример запроса:
curl -X POST
"<url стенда>/doc/cises?documentId=5b7f19e8-db96-463a-9735-
2ef1a73abf9b&pageDir=PREV&limit=10&pg=lp&includeSubaccount=true"
-H "accept: */*" -H "Authorization: Bearer <ТОКЕН>"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

documentId string + Идентификатор документа
pageDir string - Выбор направления Возможные значения:
PREV – предыдущий раздел;

250
Параметр Тип Обяз. Описание Комментарий
пагинации NEXT – следующий раздел
limit integer(int64) - Значение устанавливает
количество записей в
ответе: не более 5000
записей (по умолчанию 10
записей)
pg string - Товарная группа Товарная группа (см. "Справочник "Список
поддерживаемых товарных групп""). Параметр
является обязательным при установке параметра
"limit"
includeSubaccount boolean - Признак отображения Если значение "true" - выводятся товары,
информации о товарах, к принадлежащие участнику оборота и товары, по
которым участнику которым участнику оборота предоставлен
оборота товаров доступ. Информация по глобальному GTIN не
предоставлен доступ возвращается субаккаунту, если субаккаунту
предоставлен полный доступ на GTIN;
Если значение "false" - выводятся только товары,
принадлежащие участнику оборота товаров.
Значение "false" установлено по умолчанию

Пример ответа:
Код 200 в случае успеха.
{
"senderInn":"string",
"senderName":"string",
"receiverInn":"string",
"receiverName":"string",
"type":"string",
"status":"string",
"receivedAt":"2020-12-14T09:29:01.120Z",
"documentId":"string",
"turnoverType":"SELLING",
"relatedDocId":"string",
"products":[
{
"cis":"string"
}
],
"nextPage":"true"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

senderInn string + ИНН отправителя
документа
senderName string + Наименование

251
Параметр Тип Обяз. Описание Комментарий
отправителя документа
receiverInn string - ИНН получателя
документа
receiverName string - Наименование
получателя документа
type string + Тип документа См. "Справочник "Типы документов""
status string + Статус обработки См. "Справочник "Статусы документов""
документа
receivedAt string + Дата и время получения Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date- документа
time)
documentId string + Идентификатор
документа
turnoverType string - Код типа отгрузки Возможные значения:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент
relatedDocId string - ID документа Параметр не возвращается для товарных групп
"Приёмка" или "Альтернативная табачная продукция",
"Отгрузки" "Никотиносодержащая продукция", "Табачная продукция").
Если запрос осуществляется для документа "Приёмка", то
возвращается номер документа "Отгрузка". Если запрос
осуществляется для документа "Отгрузка", возвращается
номер документа "Приёмка". Если для документа "Отгрузка"
отсутствует документ "Приёмка", то возвращается значение
"null". Для товарных групп "Альтернативная табачная
продукция", "Никотиносодержащая продукция", "Табачная
продукция" всегда возвращается значение "null"
products array + Массив КИ товаров c См. "Справочник "Дополнительные параметры в ответе в
параметрами по зависимости от товарных групп""
товарам, специфичным
для каждой товарной
группы
*cis string - КИ товара
*prevCises string - Предыдущие КИ в Возвращается только для документа "Перемаркировка"
случае перемаркировки
товара
*gtin string - Код товара Возвращается только для документа "Описание остатков"
*name string - Наименование товара Возвращается только для документа "Описание остатков"
nextPage boolean + Признак наличия Возможные значения: "true" - следующая страница есть;
следующей страницы "false" - следующей страницы нет

Примечание: параметры без значений в ответе не возвращаются.

252
7. Метод получения квитанций результата обработки документов
7.1. Метод получения квитанций результата обработки универсального
документа по идентификатору документа
Квитанция по результатам обработки документов ЭДО содержит перечень из первых 10 ошибок по
документу. Для получения полного перечня ошибок необходимо использовать "Получение ошибок
по результатам обработки документов".
Метод возвращает квитанцию результата обработки документов (УПД, УПД(и), УКД, УКД(и) и
предложения об аннулировании УД) в ГИС МТ, которые были отправлены с 15 июля 2020 года.
Запрос направляется по одному документу.
URL: /documents/edo/tpr/ud
Метод: GET
Тип приватности: Приватный
Пример запроса:
curl -X GET "<url стенда>/documents/edo/tpr/ud?fileId=ON_NSCHF_...6FA0"
-H "accept: */*" -H "Authorization: Bearer <Токен>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

fileId string + Полное имя из "ИдФайл" XML направленного документа

Примечание: метод возвращает только 10 КИ, имеющих одинаковую ошибку. Для получения полного
списка КИ, содержащих ошибку, в документе используется метод "Получение ошибок по результатам
обработки документов"
Примеры ответа:
Пример положительной квитанции:
{
"resultDocId": "UINT04TXMNGR00000000000000000004-0093",
"resultDocDate": 1585320802931,
"sourceDocId": "URCPT00000000000000000005-0031",
"sourceDocDate": 1585320802315,
"state": "SUCCESS",
"code": 0,
"description": "Document was successfully processed",
"operations": [
{
"operationId": "f817bf34-5d7a-4bc0-842e-a06c873e6d8d",
"operationDate": 1585320802352,
"operationType": "DOCUMENT_VALIDATION",
"details": {
"successful": "true",

253
 "tpInternalId": "UCMS00000000000000000018-1476",
"documentType": "UNIVERSAL_TRANSFER_DOCUMENT",
"documentName": "ON_NSCHFDOPPRMARK_2EV-600000555_2EV-
600000749_20200414_051fc5fc-91e7-48c0-a091-f4f3cba39410",
"documentNumber": "тест-1",
"documentDateTime": "14.04.2020"
}
},
{
"operationId": "773e9985-3bfe-476e-b62d-6e00f8e69166",
"operationDate": 1585320802398,
"operationType": "DOCUMENT_ROUTED",
"details": {
"productGroups": ["tobacco"]
}
},
{
"operationId": "a1045297-0cdc-420d-b5e3-b0984ba0e567",
"operationDate": 1585320802696,
"operationType": "DOCUMENT_PROCESSED_AT_PRODUCT_GROUP_TOBACCO",
"details": {"successful": true}
}
]
}

Пример отрицательной квитанции:

{
"resultDocId": "UINT04TXMNGR00000000000000000004-0093",
"resultDocDate": 1585320802931,
"sourceDocId": "URCPT00000000000000000005-0031",
"sourceDocDate": 1585320802315,
"state": "FAILED",
"code": 1,
"description": "Document processing was failed",
"operations": [
{
"operationId": "f817bf34-5d7a-4bc0-842e-a06c873e6d8d",
"operationDate": 1585320802352,
"operationType": "DOCUMENT_VALIDATION",
"details": {
"successful": "true",
"tpInternalId": "UCMS00000000000000000018-1477",
"documentType": "UNIVERSAL_TRANSFER_DOCUMENT",
"documentName": "ON_NSCHFDOPPRMARK_2EV-600000555_2EV-
600000749_20200414_051fc5fc-91e7-48c0-a091-f4f3cba39410",
"documentNumber": "тест-1",
"documentDateTime": "14.04.2020"
}
},
{
"operationId": "773e9985-3bfe-476e-b62d-6e00f8e69166",
"operationDate": 1585320802398,
"operationType": "DOCUMENT_ROUTED",
"details": {
"productGroups": ["tobacco"]
}

254
 },
{
"operationId": "a1045297-0cdc-420d-b5e3-b0984ba0e567",
"operationDate": 1585320802696,
"operationType": "DOCUMENT_PROCESSED_AT_PRODUCT_GROUP_TOBACCO",
"details": {
"successful": false,
"errors": [
{
"code": 22,
"text": "Коды маркировки 000000462106543zdK0IB не найдены в ГИС
МТ",
"error": {
"CisNotExists": {},
"details": "Текстовое описание ошибки"
},
"data": {
"cis": ["000000462106543zdK0IB"],
"count": 1,
"tpe": "CisErrorData"
}
}
]
}
}
]
}

Параметры ответа:

Обя
Параметр Тип з. Описание Комментарий
resultDocId string + Идентификатор Значение соответствует значению из
результирующей квитанции атрибута /Квитанция/ГИСМТ/ЛС/@ИдТК транспортной
(цепочки операций) квитанции
resultDocDate numb + Дата формирования
er результирующей
технологической квитанции
sourceDocId string + Идентификатор логического Значение соответствует значению атрибута
сообщения в ГИС МТ /Квитанция/ГИСМТ/ЛС/@ИдЛС Внутренней
транспортной квитанции
sourceDocDate numb + Дата получения входящего Дата формате UnixDataTime (в миллисекундах)
er логического сообщения
state string + Результат обработки Возможные значения:
исходного документа (УПД,
• SUCCESS – документ обработан успешно,
УКД)
получен положительный ответ от всех товарных
групп;
• FAILED – документ обработан. Ответ получен от
всех товарных групп, но в процессе обработки
возникли ошибки;
• IN_PROGRESS – документ находится в процессе

255
 Обя
Параметр Тип з. Описание Комментарий
обработки;
code numb + Код результата выполнения Возможные значения:
er обработки
• 0 – при state = SUCCESS
• 1 – при state = FAILED
• 2 – при state = IN_PROGRESS
description string + Текстовое описание
результата обработки
operations object + Список операций, связанных с
[] обработкой исходного
документа
*operationId string + Идентификатор операции в
ГИС МТ
*operationDate numb + Дата совершения операции в Дата формате UnixDataTime (в миллисекундах)
er ГИС МТ
*operationType string + Тип операции Возможные значения:
• DOCUMENT_VALIDATION – операция
валидации документа;
• DOCUMENT_ROUTED – операция
маршрутизации. Документ отправлен \ не
отправлен в товарную группу;
• DOCUMENT_PROCESSED_AT_PRODUCT_GRO
UP_<наименование товарной группы> – получен
ответ от товарной группы о результате обработки
документа
*docId string - Идентификатор
документа (внутренней
квитанции) в ГИС МТ
*docDate numb - Дата формирования Дата формате UnixDataTime (в миллисекундах)
er документа (внутренней
квитанции) в ГИС МТ
*docHash string - Хеш документа (внутренней
квитанции) в ГИС МТ
*details object - Детали
[]
**productGroup array - Товарные группы См. справочник "Справочник "Список поддерживаемых
s of товарных групп""
string
**successful string + Флаг обработки документа на Возможные значения:
данной стадии
• true – обработан успешно;
• false – обработка завершилась с ошибкой

256
 Обя
Параметр Тип з. Описание Комментарий
**tpInternalId string - Идентификатор
транспортного пакета (ТП) в
ГИС МТ. Совпадает со
значением
/Квитанция/ГИСМТ/@ИдТПВ
нутренний из транспортной
квитанции (ТрК)
**documentTyp string - Тип входящего документа, на Возможные значения:
e который формируется
• UNIVERSAL_TRANSFER_DOCUMENT – УПД;
квитанция
• UNIVERSAL_CORRECTION_DOCUMENT – УКД
**documentNa string - Имя файла УПД\УКД без Возможные значения:
me расширения
• для УПД - значение из атрибута /Файл/@ИдФайл
Титула продавца (ON_NSCHFDOPPRMARK);
• для УКД - значение из атрибута /Файл/@ИдФайл
Титула продавца (ON_KORSCHFDOPPR)
**documentnu string - Номер входящего документа Возможные значения:
mber
* для УПД – значение из
атрибута /Файл/Документ/СвСчФакт/@НомерСчФ; *
для УКД – значение из
атрибута /Файл/Документ/СвКСчФ/@НомерКСчФ
**documentDat string - Дата входящего документа в Возможные значения: * для УПД - значение из атрибута
eTime формате ДД.ММ.ГГГГ /Файл/Документ/СвСчФакт/@ДатаСчФ Титула
продавца (ON_NSCHFDOPPRMARK); * для УКД -
значение из
атрибута /Файл/Документ/СвКСчФ/@ДатаКСчФ
Титула продавца (ON_KORSCHFDOPPR)
**errors array - Объект описания ошибок
of обработки документа
object
[]
***code numb + Код ошибки
er
***text string - Текстовое описание кодов
ошибок
***error object + Содержит внутри себя
[] текстового значение кода
ошибки
****CisNotExis array - Значение из столбца
ts of "Тестовое описание кода
string ошибки" таблицы "[Описание
кодов возвращаемых ошибок
в квитанции]"
*****details string - Текстовое описание ошибки Поле обязательно для кода ошибки 106 и 107

257
 Обя
Параметр Тип з. Описание Комментарий
***data object + Содержит внутри себя детали Описание ошибок описано в таблице "[Описание кодов
[] ошибки возвращаемых ошибок в квитанции]"
****participant array - ИНН участника оборота
of товаров. Для кодов ошибок:
string 13 и 102
****cis array - Список кодов идентификации,
of из-за которых возникла
string ошибка обработки документа.
Для кодов ошибок: 22, 23, 24 и
79
****pack array - Список кодов упаковок, из-за
of которых возникла ошибка
string обработки документа. Для
кодов ошибок: 22, 23, 24 и 79
****invoice array - Номер документа. Для кодов
of ошибок: 16, 63 и 64
string
**** array - Дата документа. Для кодов
invoiceDate of ошибок: 16, 63 и 64
string
****fixnumber array - Номер исправления. Для кода
of ошибки 82
string
****fixDate array - Дата исправления. Для кода
of ошибки 82
string
****count numb - Количество значений в
er массиве вышестоящего поля
****tpe string - Служебная информация

7.2. Метод получения квитанции результата обработки документа по

идентификатору чека
Метод предназначен для получения квитанции по ID чека, обработанного в ГИС МТ.
Тип приватности: публичный
URL: /receipt/documents/{receiptId}
Метод: GET
Пример запроса:
curl -X GET "<url стенда v3>/receipt/documents/URCPT000000000000000000020003"
-H "accept: */*"
-H "authorization: Bearer

258
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwcm5DUkVBxFUi5MUF9JTlRST0RVQr9zdGF0dXMiOiJSRUk3
_2ZY"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

receiptId string + ID чека

Пример ответа
1.Код 200: в случае успеха.
{
"resultDocId": "UTXMNGR00000000000000000015-9151",
"resultDocDate": "2021-03-19T09:20:52.105Z",
"sourceDocId": "URCPT00000000000000000013-6112",
"sourceDocDate": "2021-03-18T16:10:57.190Z",
"state": "IN_PROGRESS",
"code": 2,
"description": "Document in processing",
"operations": [
{
"operationId": "9db33800-3726-4571-9116-03a102f02e98",
"operationType": "RECEIPT_VALIDATION",
"operationDate": "2021-03-18T16:10:57.219Z",
"details": {
"ofdInn": "1234567890",
"successful": "true",
"documentType": "TICKET",
"documentNumber": "19",
"documentDateTime": "1564744080"
}
},
{
"operationId": "4d2fd710-548c-4d45-8232-b61a67eb6616",
"operationType": "RECEIPT_ROUTED",
"operationDate": "2021-03-18T16:10:57.411Z",
"details": {
"productGroups": [
"shoes"
],
"successful": "true"
}
}
]
}

2.В случае ошибок.

2.1 Код 401: для доступа к ресурсу требуется полная аутентификация.
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this

259
resource</error_description>
</UnauthorizedException>

2.2 Код 403: документ недоступен.

{
"code": 403,
"timestamp": 1595487274974,
"error_message": "Отсутствует доступ к ресурсу"
}

2.3 Код 404: запрашиваемая информация не найдена в ГИС МТ либо допущена ошибка в указании
URL метода.
{
"code": 404,
"description": "Document with id 123 is missing"
}

2.4 Код 500: внутренняя ошибка сервиса.

{
"code": 500,
"timestamp": 1595487274974,
"error_message": "Ошибка при выполнении запроса"
}

Параметры ответа:

Обяз
Параметр Тип . Описание Комментарий
*resultDocId string + Уникальный ID
квитанции в
ГИС МТ
*resultDocDate string + Дата и время Формат: 2021-03-19T09:20:52.105Z
окончания
обработки
документа
*sourceDocId string + Уникальный
идентификатор
исходного
документа в
ГИС МТ
*sourceDocDate string + Дата и время Формат: 2021-03-19T09:20:52.105Z
приёма
исходного
документа
*state string + Результат Возможные значения:
обработки SUCCESS - документ обработан успешно;
документа FAILED - документ обработан с ошибкой;
PARTIALLY - документ обработан частично

260
 Обяз
Параметр Тип . Описание Комментарий
*code number + Код обработки Возможные значения:
документа 0 - документ обработан успешно;
1 - документ обработан с ошибкой;
2 - документ обработан частично
*description string + Описание
результата
обработки
документа
*operations array + Список
операций,
связанных с
обработкой
документа
**operationId string + ID операции,
присвоенный в
ГИС МТ
**operationTyp string + Тип операции Возможные значения:
e RECEIPT_VALIDATION - операция валидации документа;
RECEIPT_ROUTED - операция маршрутизации. Документ
отправлен/ не отправлен в товарную группу;
RECEIPT_SENT_TO_FALLBACK - операция маршрутизации
для документа не определена товарная группа. Документ
отправлен в очередь документов с неопределённой товарной
группой;

Получен ответ от товарной группы о результате обработки

документа:
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_TOBACCO;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_SHOES;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_LP;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_ELECTRONIC
S;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_PERFUMERY;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_BICYCLE;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_TIRES;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_WHEELCHAI
R; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_WATER;
RECEIPT_PROCESSED_AT_PRODUCT_GROUP_MILK;
**operationDate string(date + Дата и время Формат: 2021-03-19T09:20:52.105Z
-time) операции
**details array - Дополнительна Параметры массива изменяются в зависимости от получаемой
я информация квитанции
code number - Код ошибки Возвращается в случае ошибки
timestamp long - Дата и время Возвращается в случае ошибки. Формат: 1595487274974
ответа в
секундах

261
 Обяз
Параметр Тип . Описание Комментарий
error_message string - Текст Возвращается в случае ошибки
сообщения об
ошибке
description string - Описание Возвращается в случае ошибки
ошибки

7.3. Описание кодов возвращаемых ошибок при обработке документов

Текстовое описание кода
№ Описание кода ошибки Комментарий
4 DuplicateDocument Документ $docId Документ зарегистрирован в ГИС МТ
зарегистрирован ранее
7 IncorrectUDHistory Последний успешный УД не
найден для счёт-фактуры №:
$invoice, дата: $invoiceDate
10 VendorNotExists Продавец $vendor не Продавец не зарегистрирован в ГИС МТ
идентифицирован (не
зарегистрирован)
12 CustomerNotExists Покупатель не
зарегистрирован в ГИС МТ
13 ParticipantNotExists Участник $participant не Участник <ИНН Продавца УД> или
идентифицирован (не <ИНН Покупателя> не зарегистрирован в
зарегистрирован) ГИС МТ (проверка регистрации <ИНН
Покупателя> не осуществляется при
отгрузках для собственных нужд или в
рамках государственного контракта) Для
всех товарных групп проверяется наличие
подписанного договора на
взаимодействие с товарной группой
14 DuplicateTransferDocument УПД $docId для счёт-
фактуры №: $invoice, дата:
$invoiceDate зарегистрирован
ранее
16 UniversalCorrectionDocumentNotValid УКД (УКДи) $docId для счёт- В ГИС МТ ранее был успешно обработан
фактуры №: $invoice, дата: УКД/УКД(и) с такими же № и датой УКД,
$invoiceDate не валидный <ИНН Получателя> и <ИНН
(отсутствует исходный УПД, Отправителя>, № и датой исправления
либо документ не является (если был направлен на обработку
последним) УКД(и)), как у текущего направленного
УКД или УКД(и), либо в ГИС МТ ранее
был успешно обработан УКД(и) с более
поздней датой корректировки
18 CisEditedByAnotherDoc Код Маркировки $cis был
изменен более поздним
документом: $documentId

262
 Текстовое описание кода
№ Описание кода ошибки Комментарий
19 CisHistoryNotExists Отсутствуют записи в
истории по Коду
Маркировки: $cis
20 CisHistoryNotValid Последняя запись в истории
Кода Маркировки: $cis не
соответствует изменению по
документу. ИД документа не
указан
21 CisIncorrectAggregation Код Маркировки $cis с
родителем $currentParent
нельзя агрегировать в
$newParent
22 CisNotExists Коды Маркировки $cis не Указанные в документе коды
найден(ы) идентификации не найдены в ГИС МТ
23 InsufficientRights У участника $participant нет При обработке документа поставщик не
полномочий на выполнение является владельцем указанного кода
операции с Кодом идентификации.
Маркировки $cis
При обработке исправлений:
* при возврате на поставщика кода
идентификации покупатель не является
владельцем кода идентификации по
данным ГИС МТ; * при добавлении к
перемещению на покупателя кода
идентификации поставщик не является
владельцем кода по данным ГИС МТ
24 InvalidStatus Статус Кода Маркировки $cis Статус кодов идентификации или их
не соответствует состояние («ожидают приёмку»,
выполняемой операции" «ожидают перемаркировку») не
соответствуют выполняемой операции
25 InvalidAggregationHistory Последняя запись в истории
$cis имеет тип операции, не
соответствующий агрегации
26 ParticipantDissolved Участник $participant не
зарегистрирован в
ЕГРИП/ЕГРЮЛ как
действующее лицо
27 CisHistoryForUDNotExists Для УД (счёт-фактура №:
$invoice, дата: $invoiceDate)
не найдены истории КМ
31 InsufficientRightsGroup У участника $participant нет
полномочий на выполнение
операций с групповой
упаковкой $pack и Кодом
Маркировки $cis
33 IncorrectDisaggregationLevel Групповая упаковка $pack
вложена в групповую

263
 Текстовое описание кода
№ Описание кода ошибки Комментарий
упаковку. Для дезагрегации
используйте идентификатор
верхней групповой упаковки
44 XsdValidationError Ошибка валидации
документа $docId по XSD-
схеме
46 InvalidDocumentContent Содержание или имя Имя файла не корректно или структура
документа некорректно XML не прошла проверку по XSD-схеме
54 EmptyFixDate Дата исправления не Дата исправления УПД(и) имеет пустое
заполнена для документа значение или имеет не верный формат
$docId
56 InvalidAggregationParentType Тип упаковки для агрегата
$cis - пачка
57 ParticipantAlreadyExists Участник $participant уже
существует
58 ParticipantNotExistsInEGRUL Участник $participant не
зарегистрирован в
ЕГРИП/ЕГРЮЛ
59 OfdNotExists Оператор фискальных
данных с ИНН $inn не найден
60 ProductNotExists Продукция с GTIN $gtin не
найдена
61 ProductInsufficientRights У участника $participant нет
полномочий на выполнение
операций с продукцией
имеющей GTIN $gtin
62 InvalidAggregationChildType Тип упаковки $cis нельзя
поместить в упаковку $parent
63 UniversalTransferDocumentNotValid УПД $docId для счёт- В ГИС МТ ранее был успешно обработан
фактуры №: $invoice, дата: УПД с такими же № и датой УПД, <ИНН
$invoiceDate не валидный Получателя> и <ИНН Отправителя>, как у
(зарегистрирован ранее, либо текущего направленного УПД, либо в
был проведен УПДи) ГИС МТ был успешно обработан УПД(и)
с более поздней датой исправления
64 UniversalTransferFixDocumentNotValid УПДи №{номер} от {дата} не В ГИС МТ ранее был успешно обработан
обработан. Был проведен УПД(и) с № и датой УПД, <ИНН
УПДи с более поздними Получателя> и <ИНН Отправителя>, с №
номером или датой и датой исправления позднее, чем у
исправления текущего направленного УПД(и)
65 ApiError Ошибка во время обращения
к $apiName
66 NotEmptyAggregatorError Агрегат $cis не пустой
67 InvalidAggregationDate Дата эмиссии/нанесения
новой групповой упаковки

264
 Текстовое описание кода
№ Описание кода ошибки Комментарий
$newParent меньше даты
эмиссии/нанесения старой
$previousParent, либо даты
эмиссии/нанесения
отсутствуют
68 CisNotPaid Код Маркировки $cis не По кодам идентификации, указанным в
оплачен документе, не произведена оплата
69 DocParsingError Содержание документа Поле «КодИтога» титула покупателя (при
некорректно. Некорректные условии его указании) заполнено не
данные: $reason корректным значением
70 DocumentDataFieldsError Содержание документа
некорректно. Отсутствуют
сведения о маркировке
71 DocumentValidationError Содержание документа
некорректно. Некорректные
данные: $reason
72 InvalidDocumentType Некорректный тип
документа: $docType
73 WrongEmissionType Некорректный тип эмиссии
74 DifferentChildrenStatus Статусы приведённых в
документе "Агрегация"
транспортных упаковок либо
товаров не совпадают
75 InvalidEmissionType Код Маркировки $cis имеет
некорректный тип эмиссии
76 DocumentNotExis Документ с id $id не найден
77 UniversalCancelDocumentNotValid Документ, аннулирующий
УПД с id $id, невалидный
78 DuplicateCis Код маркировки $cis
перечислен более одного раза
79 CisNotValid Неверный код маркировки Коды идентификации имеют не
$cis корректную длину либо содержат
недопустимые символы
80 InvalidUdContract Текущий или предыдущий
документ не могут быть гос.
контрактом
81 CisNotInUdChain Код маркировки $cis При обработке корректировок: при
отсутствует в цепочке возврате на поставщика кода
универсальных документов идентификации покупатель не является
владельцем кода идентификации по
данным ГИС МТ
82 UniversalTransferFixDocumentDuplicate УПДи №{номер} от {дата} не В ГИС МТ ранее был успешно обработан
обработан. Данный документ УПД(и) с такими же № и датой УПД,
(№ исправления: {номер}, <ИНН Получателя> и <ИНН

265
 Текстовое описание кода
№ Описание кода ошибки Комментарий
дата исправления: {дата}) Отправителя>, № и датой исправления,
зарегистрирован в ГИС МТ как у текущего направленного УПД(и)
ранее
83 IncorrectUdChain Некорректная Проверка истории перемещения кодов
последовательность УД для идентификации при обработке
Кода Маркировки $cis корректировок:
* указанные без изменений коды
идентификации в документе по данным
ГИС МТ были ранее перемещены с
поставщика на покупателя; * для
возвращаемых на поставщика кодов
идентификации владельцем является
покупатель; * для добавленных к
перемещению на покупателя кодов
идентификации владельцем является
отправитель
84 NotAggregatedCis Неудавшиеся при агрегации
короба и паллеты: $cis
85 InvalidPackageType Тип упаковки Кода
Маркировки $cis не
соответствует выполняемой
операции
86 CisesIncorrectValueParent Код маркировки $cis,
указанный в документе
$documentName, содержит в
родителе самого себя
87 InvalidParamFormat Некорректный формат
параметра $field для КМ $cis
88 InvalidParamValue Некорректное значение
параметра $field для КМ $cis
89 InvalidProductGroup Продуктовая группа Кода
Маркировки $cis не
соответствует выполняемой
операции
100 DatabaseLoadingError Ошибка при загрузке из базы
данных
101 SkippedDocumentError Обработка документа
прервана
102 MultiCodes Документ содержит
мультитоварные Коды
Маркировки
103 CodesIsEmpty Документ не содержит Кодов
Маркировки
104 ProductCodesDecodingError Код Маркировки

266
 Текстовое описание кода
№ Описание кода ошибки Комментарий
неподдерживаемого формата
105 ValidationError Ошибка валидации
дополнительных свойств в
чеке
106 DocumentValidation Ошибка валидации
документа
107 SignatureError Ошибка валидации подписи Если дата формирования подписи (1. Дата
формирования открепленной подписи 2.
ДатаИнфПр и ВремяИнфПр из титула
продавца) < даты отзыва сертификата, то
документ обрабатывается, и в
результирующей квитанции возвращается
ошибка 107, неблокирующая ошибку-
предупреждение. Если дата формирования
подписи (1. дата формирования
открепленной подписи 2. ДатаИнфПр и
ВремяИнфПр из титула продавца) > даты
отзыва сертификата, то документ
обрабатывается с блокирующей ошибкой
107
108 ServiceError Произошла сервисная ошибка
109 ServiceError Документ находится в
обработке. Повторное
рассмотрение возможно
после окончания обработки
документа
110 InvalidDocumentStatus Некорректный статус
документа
111 RoutingError Произошла ошибка
маршрутизации документа
116 IntroduceByNotOwner Участник $participant не
может перемещать Код
маркировки $cis, не
введенный в оборот
117 CisEmitted Код маркировки $cis
эмитирован

267
8. Методы формирования выгрузок данных из ГИС МТ
В данном разделе описана последовательность формирование выгрузки из ГИС МТ сведений
больших объёмов с использованием функционала "Сервисов выгрузок" (далее – СВ). Участнику
оборота товаров предоставляется возможность создания однократных заданий на выгрузку с
возможностью скачивания результата в формате файла CSV. В результате успешной обработки
задания на формирования выгрузки на адрес электронной почты, указанный в личном кабинете УОТ,
приходит уведомление о готовности выгрузки.
В текущей реализации методы формирования выгрузок данных в ГИС МТ доступны только на
промышленном стенде.
Формирование выгрузок из ГИС МТ сведений больших объёмов осуществляется согласно следующей
последовательности:
Шаг 1. Создание нового задания на выгрузку ("Метод создания нового задания на выгрузку"). Далее
в документе приведено описание получения сведений по КИ и агрегатам ("Получение сведений по
кодам идентификации и агрегатам"), получения ошибок по результатам обработки документов ЭДО.
("Получение ошибок по результатам обработки документов") и "Пример ответа для всех
формируемых запросов на выгрузку". В ответе на данный метод возвращается ID формируемой
выгрузки, который используется в последующем запросе проверки статуса задания;
Шаг 2. Проверка статуса готовности задания на выгрузку ("currentStatus") по ID выгрузки ("Метод
получения статуса задания на выгрузку по ID выгрузки"). В параметре запроса "task_id" указываются
ID запрошенных выгрузок;
Шаг 3. "Метод получения результирующих ID выгрузок данных" возвращает список заданий с
указанием результирующего ID. В параметре запроса "task_ids" указываются ID запрошенных
выгрузок. Результирующий идентификатор возвращается только для выгрузок в статусе "Выполнено"
(COMPLETED);
Шаг 4. Получение сформированного файла выгрузки данных по полученному на третьем шаге
результирующему ID ("Метод получения ZIP файла выгрузки"). Получить файл выгрузки можно
только для задачи в статусе "Выполнено" (COMPLETED). Если выгрузка перемещена в архив или
отменена необходимо сформировать выгрузку повторно.
В текущей реализации функционал "Сервис выгрузок" не доступен для тестирования на
демонстрационном стенде.

8.1. Метод создания нового задания на выгрузку

Для начала работы с СВ необходимо вызвать "Метод создания нового задания на выгрузку". В ответе
метод возвращает ID выгрузки, который необходим для работы с другими методами СВ. Формат
ответа данного метода имеет единую структуру для всех формируемых заданий на выгрузку
("Пример ответа для всех формируемых запросов на выгрузку"). Далее описаны запросы метода для
получения сведений по КИ и агрегатам и получения ошибок по результатам обработки документов
ЭДО.

268
8.1.1. Получение сведений по кодам идентификации и агрегатам
Для формирования запроса на получение сведений о КИ в файле формата CSV необходимо передать
массив КИ. Ограничение по количеству указываемых КИ: 100 000.
Получение сведений о КИ другого участника оборота товаров возможно только при наличии согласия
о предоставлении сведений, подписанного обеими сторонами.
У участника оборота товаров, запрашивающего данные о КИ из ГИС МТ, должны быть подписаны
договора по всем товарным группам, по КИ которых запрашивается выгрузка. Данное требование
также действует для участников оборота товаров, у которых подписано согласие о предоставление
сведений о КИ другого участника оборота товаров.
В случае отсутствия подписанного договора при запросе данных возвращается ошибка 403
(отсутствует доступ к данным, не подписан договор о предоставлении сведений).
URL: dispenser/tasks
Тип приватности: публичный
Метод: GET
Пример запроса:
curl -X GET '<url стенда>dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d
"{
"format":"CSV",
"name":"CIS_REPORT",
"params":"{\"cises\": [\"cis1\", \"cis2\",...]}",
"periodicity":"SINGLE"
"productGroupCode":"3"
}"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

format string + Формат файла: CSV
name string + Наименование выгрузки: "CIS_REPORT" – для
получения отчета по сведениям по кодам
идентификации и агрегатам
params string + Строка параметров задания в формате JSON Заполняется "{\"cises\": [\"cis1\",
\"cis2\",…]}"
periodicity string + Вид выгрузки: SINGLE (однократная)
productGroupCode string + Товарная группа См. "Справочник "Список
поддерживаемых товарных
групп""

Параметры заголовка запроса: Authorization: Bearer <token>

269
8.1.2. Получение ошибок по результатам обработки документов
В разделе описано формирование запроса на детализированную выгрузку ошибок по результатам
обработки документов ЭДО. Ограничение по количеству запрашиваемых документов: 1000.
Выгрузка предназначена для запроса сведений по ошибкам обработки документов прямой подачи
сведений и ЭДО. В параметрах запроса необходимо передать массив идентификаторов документов.
Ограничение по количеству запрашиваемых документов: 1000. Для ЭДО документов передается
полный идентификатор, равный значению, указываемому в "ИдФайл" документа XML. Для
документов прямой подачи сведений передается идентификатор, присвоенный ГИС МТ.
URL: dispenser/tasks
Тип приватности: публичный
Метод: GET
Пример запроса:
curl -X GET '<url стенда>dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d
"{
"format": "CSV",
"name": "ERRORS_REPORT",
"params": "{/"documentId/":[/"uuid/",/"uuid/"]}",
"periodicity": "SINGLE"
"productGroupCode": "3"
}"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

format string + Формат файла: CSV
name string + Наименование выгрузки: ERRORS_REPORT – для
получения отчета по формированию выгрузки
ошибок по документам ЭДО
params string + Строка параметров задания в формате JSON Заполняется "{"documentId":[
"uuid"]}""
periodicity string + Вид выгрузки: SINGLE (однократная)
productGroupCode string + Товарная группа См. "Справочник "Список
поддерживаемых товарных
групп""

8.1.3. Получение списка кодов идентификации УОТ по заданному фильтру

Выгрузка предназначена для получения сведений о КИ, находящихся на балансе у участника оборота
товаров. У участника оборота товаров, запрашивающего данные из ГИС МТ должен быть подписан
договор по товарной группе, указанной в параметре "productGroupCode". Данное требование также

270
действует для участников оборота товаров, у которых подписано согласие о предоставление сведений
о КИ другого участника оборота товаров.
В случае отсутствия подписанного договора при запросе данных возвращается ошибка 403 (нет
доступа к данным, не подписан договор).
Вывод сведений о КИ осуществляется с учётом установленных фильтров в параметре "params".
URL: dispenser/tasks
Тип приватности:
• приватный;
• Оператор.
Метод: POST
Параметры заголовка запроса: Authorization: Bearer <token>
Пример запроса:
curl -X GET '<url стенда>/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d
"{
"format": "CSV",
"name": "FILTERED_CIS_REPORT",
"periodicity": "SINGLE",
"productGroupCode": "2",
"params":
"{\"participantInn\":\"7707099460\",\"packageType\":[\"UNIT\",\"LEVEL1\"],\"status\":\"
INTRODUCED\",\"appliedPeriod\":{\"start\": \"2020-01-
01T08:02:30.577395Z\",\"end\":\"2020-12-
09T08:02:30.577395Z\"},\"emissionPeriod\":{\"start\":\"2020-01-
01T08:02:30.577395Z\",\"end\":\"2020-12-09T08:02:30.577395Z\"},\"includeGtin\":
[\"04620074363472\"]}"
}"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

format string + Формат файла: CSV
name string + Наименование выгрузки:
FILTERED_CIS_REPORT –
получения списка КИ,
принадлежащих УОТ
params string + Строка параметров задания в формате
JSON
participantInn string + ИНН участника
*includeGtin array[string] - Код товара КИ, по которым осуществляется

271
Параметр Тип Обяз. Описание Комментарий
поиск
*excludeGtin array[string] - Код товара КИ товара, которые исключаются из
поиска. Если параметр "includeGtin"
заполнен, то параметр "excludeGtin"
может быть пустым
*packageType array[string] + Тип упаковки См. "Справочник "Типы упаковки""
*status string + Статус КМ См. "Справочник "Статусы КИ""
*emissionPeriod - string Период отбора по дате эмиссии
(date-
time)
**start string (date- - Дата начала периода отбора по дате
time) эмиссии
**end string (date- - Дата окончания периода отбора по
time) дате эмиссии
*appliedPeriod string (date- - Период отбора по дате нанесения
time)
**start string (date- - Дата начала периода отбора по дате
time) нанесения
**end string (date- - Дата окончания периода отбора по
time) дате нанесения
periodicity string + Вид выгрузки: SINGLE (однократная)
productGroupCode string + Товарная группа См. "Справочник "Список
поддерживаемых товарных групп""

8.1.4. Пример ответа для всех формируемых запросов на выгрузку

В ответе возвращается ID выгрузки, необходимый для дальнейше работы с методами сервиса
выгрузок.
{
"id":"string",
"name":"string",
"createDate":"2020-06-19T14:44:27.968Z",
"currentStatus":"PREPARATION",
"dataStartDate":"string",
"dataEndDate":"string",
"frontendTaskUrl":"string",
"orgInn":"string",
"period":"HALF_MIN",
"periodicity":"SINGLE",
"productGroupCode":0,
"productGroups":[
{
"id":0,
"name":"string"
}

272
 ],
"timeoutSecs":0
}

Параметры ответа:

Параметр Тип Обяз. Описание

createDate string + Дата создания. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
(date-time)
id string + Идентификатор задания на выгрузку, необходимый для работы с другими
методами сервиса выгрузок
name string + Наименование задания
currentStatus string - Текущий статус:
PREPARATION – подготовка;
COMPLETED – выполнено;
CANCELED – отменено;
ARCHIVE – архив;
FAILED – ошибка
dataStartDate string - Дата начала периода, по которому сформирована выгрузка (используется только
(date) для заданий c periodicity=SINGLE). Возвращается в формате yyyy-MM-dd
dataEndDate string - Дата окончания периода, по которому сформирована выгрузка (используется
(date) только для заданий c periodicity=SINGLE). Возвращается в формате yyyy-MM-dd
frontendTaskUrl string - Адрес к заданию в личном кабинете (указать абсолютный URL, не включая
переменную пути {taskId})
orgInn string + ИНН организации
period string - Периодичность регулярной выгрузки:
HALF_MIN – полминуты;
TEN_MINUTES – 10 минут;
DAY – день;
WEEK – неделя;
MONTH – месяц;
QUARTER – квартал;
YEAR – год
periodicity string + Вид периодичности:
SINGLE – однократная;
REGULAR – регулярная
productGroupCode integer - Код товарной группы
productGroups object - Доступные товарные группы для текущего типа задач
*id integer - Идентификатор текущей задачи
*name string - Наименование товарной группы
timeoutSecs integer - Таймаут в сек., при наступлении которого диспетчер считает, что выгрузка по
данному заданию не выполнена

273
8.2. Метод получения статуса задания на выгрузку по ID выгрузки
В формируемом запросе указывается ID выгрузки, вернувшийся в ответе на запрос "Метода создания
нового задания на выгрузку". В ответе на запрос возвращается текущий статус задания на выгрузку
("currentStatus"). Возможные значения: PREPARATION – подготовка; COMPLETED – выполнено;
CANCELED – отменено; ARCHIVE – архив; FAILED – ошибка
URL: dispenser/tasks/{taskId}
Тип приватности: публичный
Метод: GET
Пример запроса:
{
"taskId": "1111",
"pg": "string"
}

Параметры запроса:

Параметр Тип Обяз. Описание

taskId string + Идентификатор формируемой выгрузки (идентификатор, который вернулся в ответе на запрос
о формировании выгрузки)
pg string + Товарная группа (см. Справочник "Список поддерживаемых товарных групп")

Параметры заголовка запроса: Authorization: Bearer <token>

Пример ответа:
{
"id": "string",
"name": "string",
"createDate": "string",
"currentStatus": "string",
"orgInn": "string",
"productGroupCode": 0,
"downloadingStorageDays": 0,
"productGroups": [
{
"id": "string",
"name": "string"
}
],
"timeoutSecs": 0
}

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

Параметры ответа:

274
Параметр Тип Обяз. Описание
id string + Идентификатор задания на выгрузку
name string + Наименование выгрузки
createDate string (date- + Дата создания. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
currentStatus string - Текущий Статус:
PREPARATION – подготовка;
COMPLETED – выполнено;
CANCELED – отменено;
ARCHIVE – архив;
FAILED – ошибка
orgInn string + ИНН организации
productGroupCode integer - Код товарной группы
downloadingStorageDays integer - Время хранения выгрузки в днях
productGroups object - Доступные товарные группы для текущего типа задач
*id integer + Идентификатор текущей задачи
*name string + Наименование товарной группы
timeoutSecs integer - Таймаут в сек., при наступлении которого диспетчер считает, что
выгрузка по данному заданию не выполнена

8.3. Метод получения результирующих ID выгрузок данных

URL: dispenser/results
Тип приватности: публичный
Метод: GET
Пример запроса:
curl -X GET '<url стенда>/results?page=1&pg=1&size=12"
-H 'Authorization: Bearer <ТОКЕН>'

Параметры запроса:

Параметр Тип Обяз. Описание

page string + Номер страницы (отсчёт с 0)
size string + Количество записей на странице
pg string - ID товарной группы Справочник "Список поддерживаемых товарных групп"
task_ids array [string] - Список ID задач

Параметры заголовка запроса: Authorization: Bearer <token>

Пример ответа:

275
{
"list": [
{
"id": "string",
"archiveSize": 0,
"available": "string",
"dataStartDate": "string",
"dataEndDate": "string",
"downloadStatus": "string",
"downloadingTime": 0,
"errorMessage": "string",
"fullErrorMessage": "string",
"fileDeleteDate": "string",
"generationStartDate": "string",
"generationEndDate": "string",
"notEditable": true,
"taskId": "string"
}
]
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

list object + Результат запроса
*archiveSize integer - Размер архива выгрузки в байтах
*available string - Доступность загрузки файла:
AVAILABLE - доступен;
NOT_AVAILABLE - недоступен
*dataStartDate string - Дата-время начала периода, по которому сформирована
(date-time) выгрузка. Возвращается в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
*dataEndDate string - Дата-время окончания периода, по которому сформирована
(date-time) выгрузка. Возвращается в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
*downloadStatus string - Статус:
SUCCESS – успешно;
PREPARATION – в обработке;
FAILED – неуспешно
*downloadingTime integer - Длительность выполнения выгрузки в секундах
*errorMessage string - Сообщение об ошибке. Параметр указывается при наличии
ошибки
*fileDeleteDate string - Дата-время запланированного удаления файла выгрузки с
(date-time) сервера. Возвращается в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
*generationStartDate string - Дата-время начала генерации выгрузки. Возвращается в
(date-time) формате yyyy-MM-ddTHH:mm:ss.SSS’Z
*generationEndDate string - Дата-время окончания генерации выгрузки. Возвращается в

276
Параметр Тип Обяз. Описание Комментарий
(date-time) формате yyyy-MM-ddTHH:mm:ss.SSS’Z
*notEditable boolean - Признак, указывающий на возможность удаления или
продления выгрузки
*taskId string - Идентификатор задания

8.4. Метод получения ZIP файла выгрузки

Пользователю доступно скачивание выгрузки в текущем статусе "Выполнено" (currentStatus =
COMPLETED), полученном в ответе на запрос "Метода получения статуса задания на выгрузку по ID
выгрузки".
Для получения ZIP файла выгрузки со сведениями по КИ и агрегатам используется "Метод получения
CSV по кодам идентификации и агрегатам". Для получения ZIP файла ошибок используется "Метод
получения CSV ошибок по результатам обработки документов".
URL: dispenser/results/{result_id}/file
Тип приватности: публичный
Метод: GET
Пример запроса:
curl -X GET '<url стенда>results/11d65d37-3138-4b78-804d-226589e46381/file?pg=3
-H 'Authorization: Bearer <ТОКЕН>'

Параметры запроса:

Параметр Тип Обяз. Описание

result_id string + ID выгрузки

Параметры заголовка запроса: Authorization: Bearer <token>

8.4.1. Метод получения CSV ошибок по результатам обработки документов

В ответ возвращается ZIP файл с выгрузкой из запроса в формате CSV. Для агрегатов выводится
список вложенных кодов идентификации первого слоя. Сформированный архив будет доступен для
скачивания в течение 30 дней.
Пример структуры выгрузки ошибок:
<id УД в ГИС>
№ <Порядковый номер УД> от <Дата УД>
Отправитель <Наименование Отправителя УД>, <ИНН Отправителя УД>
Получатель <Наименование Получателя УД>, <ИНН Получателя УД>
<Код типа ошибки1>: <описание ошибки1>
"<КИ/КИТУ/КИГУ1 1>"
"<КИ/КИТУ/КИГУ1 2>"

277
Пример ответа CSV для сформированной выгрузки ошибок по документам ЭДО
"document_id","status","document_number","document_date","sender_inn","receiver_inn","c
is","error_code","error_text"
"7f4c6249-976e-43d5-b25f-afccc9e8cf42","IN_PROGRESS","7f4c6249-976e-43d5-b25f-
afccc9e8cf42",,,,,,
"ON_NSCHFDOP_Test_prng-777-300342343243","IN_PROGRESS","7202323234433",,,,,,
"7a2fba8a-4d14-45ad-a10b-9b53c7003cf5","CHECKED_NOT_OK","7a2fba8a-4d14-45ad-a10b-
9b53c7003cf5","2020-09-02 15:24:10.947","7724211288",,,,"Не пройдена проверка подписи"
"1efce0ec-09f6-4987-b4b1-f9d056c44e7b","CHECKED_NOT_OK","1efce0ec-09f6-4987-b4b1-
f9d056c44e7b","2020-09-11 08:45:46.463","7724211288",,,"INTRO_ERROR","41: Недостаточное
описание товара, указанного в документе ""Ввод в оборот"" cI046902297902"
"8032b556-cd82-4e05-876b-da0a5cbfcb34","CHECKED_NOT_OK","8032b556-cd82-4e05-876b-
da0a5cbfcb34","2020-09-09 14:44:57.619","7724211288",,,"INTRO_ERROR","07: Недопустимое
количество символов в значении поля ""КИ"" ""010463003407001221BM(__Рѕ__)G0E3""
в документе ""Ввод в оборот""."
"09252711-e901-482d-963a-544ad4fe4a29","CHECKED_NOT_OK","09252711-e901-482d-963a-
544ad4fe4a29","2020-09-07 20:13:16.729","7724211288",,,"INTRO_ERROR","06: Значение поля
""КИТУ"" ""214623467234823423"" в документе ""Ввод в оборот"" не найдено в базе
данных."
"e2a942c6-252e-4114-8d89-49b04f4f5ddb","PARSE_ERROR","e2a942c6-252e-4114-8d89-
49b04f4f5ddb","2020-07-20 13:11:18.056","7724211288",,"20.07.2020
04:11",,"REM_ERR","28: Передаваемый файл XML не соответствует XSD-схеме."

Коды ошибок общих проверок для УД:

Код типа
ошибки Описание ошибки Комментарий
4 Проверка отсутствия регистрации Документ зарегистрирован ранее в ГИС МТ
УД
13 Проверка регистрации Участник <ИНН Продавца УД> или <ИНН Покупателя> не
Продавца/Покупателя УД в ГИС зарегистрирован в ГИС МТ (Проверка регистрации <ИНН
МТ при отсутствии ИГК Покупателя> не осуществляется при отгрузках для собственных нужд
или в рамках государственного контракта)
Дополнительно: для всех товарных групп (исключение составляет ТГ
«Табачная продукция») проверяется наличие подписанного договора
на взаимодействие с товарной группой
16 Проверка отсутствия дублирования В ГИС МТ ранее был успешно обработан УКД/УКД(и) с такими же №
УКД/УКД(и) в ГИС и датой УКД, <ИНН Получателя> и <ИНН Отправителя>, № и датой
исправления (если был направлен на обработку УКД(и)), как у
текущего направленного УКД или УКД(и), либо в ГИС МТ ранее был
успешно обработан УКД(и) с более поздней датой корректировки
46 Проверка имени файла и титулов Имя файла не корректно или структура XML не прошла проверку по
УД схеме XSD
49 Проверка совпадения значения Параметр имеет различное значение в документах на приемку и
параметра "turnover_type" в отгрузку
документе на отгрузку и в
документе на приемку
54 Проверка заполненной даты Дата Исправления УПД(и) имеет пустое значение или имеет неверный
исправления формат

278
Код типа
ошибки Описание ошибки Комментарий
63 Проверка отсутствия дублирования В ГИС МТ ранее был успешно обработан УПД с такими же № и датой
УПД в ГИС МТ УПД, <ИНН Получателя> и <ИНН Отправителя>, как у текущего
направленного УПД, либо в ГИС МТ был успешно обработан УПД(и) с
более поздней датой исправления
64 Проверка в ГИС корректности В ГИС МТ ранее был успешно обработан УПД(и) с № и датой УПД,
последовательности УПД(и) в <ИНН Получателя> и <ИНН Отправителя>, с № и датой исправления
цепочке УД текущего УПД(и) позднее, чем у текущего направленного УПД(и)
МОТП/ЛП
69 Проверка кода итога приёмки Поле «КодИтога» Титула Покупателя (при условии его указании)
товаров (работ, услуг, прав) заполнено не корректным значением
71 Проверка наличия сведений о В документе нет сведений о кодах идентификации маркированного
маркированных товарах в УД; товара
Проверка валидности УД
82 Проверка отсутствия дублирования В ГИС МТ ранее был успешно обработан УПД(и) с такими же № и
УПД(и) в ГИС МТ датой УПД, <ИНН Получателя> и <ИНН Отправителя>, № и датой
исправления, как у текущего направленного УПД(и)

Коды и текст ошибок для УД

Код типа
ошибки Описание ошибки Комментарий
22 Не найдены коды идентификации Указанные в документе коды идентификации не найдены в
ГИС МТ
23 У участника нет полномочий на выполнение При обработке документа Поставщик не является
операции с кодом идентификации владельцем указанного кода идентификации.
При обработке исправлений:
• при возврате на Поставщика кода идентификации
Покупатель не является владельцем кода по данным
ГИС МТ;
• при добавлении к перемещению на Покупателя кода
идентификации Поставщик не является владельцем
кода по данным ГИС МТ
24 Статус кодов идентификации/агрегатов не Статус кодов идентификации или их состояние («ожидают
соответствует выполняемой операции приемку», «ожидают перемаркировку») не соответствуют
выполняемой операции
27 Для УД не найдены истории КИ При обработке возвратов по кодам идентификации
проверяется наличие истории перемещения кода
идентификации между Поставщиком и Покупателем
68 Код идентификации не оплачен По кодам идентификации, указанным в документе, не
произведена оплата
75 Код идентификации имеет некорректный тип По кодам идентификации с типом эмиссии «Импорт»,
эмиссии указанным в документе, не произведена оплата
79 Коды идентификации имеют длину менее 18 Коды идентификации имеют не корректную длину либо

279
Код типа
ошибки Описание ошибки Комментарий
символов либо содержат недопустимые содержат недопустимые символы
символы
81 Код идентификации отсутствует в цепочке При обработке корректировок:
универсальных документов
при возврате на Поставщика кода идентификации
Покупатель не является владельцем кода по данным ГИС
МТ
83 Некорректная последовательность УД для Проверка истории перемещения кодов идентификации при
кода идентификации обработке корректировок:
• указанные без изменений коды идентификации в
документе по данным ГИС МТ были ранее
перемещены с Поставщика на Покупателя;
• для возвращаемых на Поставщика кодов
идентификации владельцем является Покупатель;
• для добавленных к перемещению на Покупателя
кодов идентификации владельцем является
Отправитель

Коды ошибок для документов прямой подачи

0 Success Обработка документа прошла успешно

10 VendorNotExists Продавец не идентифицирован (не зарегистрирован)
100 DatabaseLoadingError Ошибка при загрузке из базы данных
101 SkippedDocumentError Обработка документа прервана
12 CustomerNotExists Покупатель не идентифицирован (не зарегистрирован)
13 ParticipantNotExists Участник не идентифицирован (не зарегистрирован)
14 DuplicateTransferDocument УПД для счет-фактуры зарегистрирован ранее
18 CisEditedByAnotherDoc Код идентификации был изменен более поздним документом
19 CisHistoryNotExists Отсутствуют записи в истории по коду идентификации
20 CisHistoryNotValid Последняя запись в истории кода идентификации не соответствует изменению по
документу. ИД документа не указан
21 CisIncorrectAggregation Код идентификации с «родителем» нельзя агрегировать
25 InvalidAggregationHistory Последняя запись в истории имеет тип операции, не соответствующий агрегации
26 ParticipantDissolved Участник не зарегистрирован в ЕГРИП/ЕГРЮЛ как действующее лицо
31 InsufficientRightsGroup У участника нет полномочий на выполнение операций с групповой упаковкой и
кодом идентификации
33 IncorrectDisaggregationLevel Групповая упаковка вложена в групповую упаковку. Для дезагрегации используйте
идентификатор верхней групповой упаковки
44 XsdValidationError Ошибка валидации документа по XSD схеме

280
0 Success Обработка документа прошла успешно
55 Дата документа $docId меньше, чем дата эмиссии или нанесения в коде $cis
56 InvalidAggregationParentType Тип упаковки для агрегата - пачка
57 ParticipantAlreadyExists Участник уже существует
58 ParticipantNotExistsInEGRUL Участник не зарегистрирован в ЕГРИП/ЕГРЮЛ
59 OfdNotExists Оператор фискальных данных с ИНН не найден
60 ProductNotExists Продукция с GTIN не найдена
61 ProductInsufficientRights У участника нет полномочий на выполнение операций с продукцией, имеющей
GTIN
62 InvalidAggregationChildType Тип упаковки нельзя поместить в упаковку
65 ApiError Ошибка во время обращения к
66 NotEmptyAggregatorError Агрегат не пустой
67 InvalidAggregationDate Дата эмиссии новой групповой упаковки меньше даты эмиссии старой, либо даты
эмиссии отсутствуют
7 IncorrectUDHistory Последний успешный УД не найден для счёт-фактуры №, дата
70 DocumentDataFieldsError Содержание документа некорректно. Отсутствуют
72 InvalidDocumentType Некорректный тип документа
73 WrongEmissionType Некорректный тип эмиссии
74 DifferentChildrenStatus 3014 - статусы приведённых в документе «Агрегация товаров» транспортных
упаковок либо товаров не совпадают
76 Документ с ID $id не найден
102 MultiCodes Документ содержит мультитоварные Коды Маркировки
103 CodesIsEmpty Документ не содержит Кодов Маркировки

8.4.2. Метод получения CSV по кодам идентификации и агрегатам

В ответе формируется ZIP файл с выгрузкой из запроса в формате CSV. Для агрегатов выводится
список вложенных кодов идентификации первого слоя. Сформированный архив будет доступен для
скачивания в течение 30 дней.
"requestCis; parent; child; status; packageType; gtin; tg-id; tg-name; productName;
tnved_code; producedDate; emissionDate; emissionType; producerInn; producerName;
ownerInn; ownerName; maxRetailPrice; pVSD; expirationDate; In_gray_zone; gray_quantity;
error "
"1111; ; 1211, 1311; applied; level3; ; 3; tobacco; ; ; ; ; ; ; ; 3664069397; BAT; ; ;
; true; 2"
"2111; 5555; 2211, 2311, 2411; applied; level2; 04605025000880; 3; tobacco; kamel
light; ; 01.01.2020; 05.01.2020; local; 3664069397; BAT; 3664069397; BAT; 80,00; 0987;
; true; 1"
"3111; 6666; ; ; applied; level1; 04605025000880; 3; tobacco; kamel light; 24;
01.01.2020; 05.01.2020; local; 3664069397; BAT; 3664069397; BAT; 80,00; 0987;
01.01.2022 ; false"

281
"5555, 6666, 7777, 8888; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ;not_found"
"9999; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; invalid_format"

Параметры ответа CSV для получения сведений по кодам идентификации и агрегатам

Параметр Тип Обяз. Описание Комментарий

requestCis string + Запрашиваемый Отсутствует, если выводится из вложенной иерархии
код идентификации (агрегат
или КИ) из запроса
parent string + Код идентификации или Выводится, если есть "родительский" код
агрегат "родителя" идентификации
status integer + Статус кода или агрегата см. Справочник "Статусы КИ"
packageType integer + Уровень упаковки агрегата см. Справочник "Типы упаковки"
или кода идентификации
gtin string - Код товара Выводится для КИГУ и КИ
tg-id integer + Код товарной группы см. Справочник "Список поддерживаемых товарных
групп"
tg-name string + Наименование товарной см. Справочник "Список поддерживаемых товарных
группы групп"
productName string - Наименование товара Не выводится для КИТУ
tnved_code string - 10 значный код ТН ВЭД Выводится для КИ (штука, комплект)
producedDate string - Дата ввода в оборот или Отсутствует, если код идентификации в статусе
(date- формирования агрегата "Эмитирован". Не выводится для КИТУ, кроме ТГ
time) "Табачная продукция". Возвращается в формате yyyy-
MM-ddTHH:mm:ss.SSS’Z
emissionDate string - Дата эмиссии Не выводится для КИТУ. Возвращается в формате
(date- yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
emissionType integer - Тип производства LOCAL – производство РФ;
FOREIG – ввезен в РФ Не выводится для КИТУ
producerInn string - ИНН производителя Только для товара, произведенного на территории
РФ. Не выводится для КИТУ и наборов, кроме ТГ
"Табачная продукция"
producerName string - Наименование Не выводится для КИТУ и наборов, кроме ТГ
производителя "Табачная продукция"
ownerInn string + Владелец кода В случае передачи идентификатора по агентской,
идентификации или агрегата комиссионной схеме - отражается агент, комиссионер,
который реализует данный идентификатор
ownerName string + Наименование владельца В случае передачи идентификатора по агентской,
кода идентификации или комиссионной схеме отражается агент, комиссионер,
агрегата который реализует данный идентификатор
maxRetailPrice string - Максимальная цена Только для ТГ "Табачная продукция" (пачка, блок).
розничной продажи Для блока значение = количество штук в блоке,
умноженное на МРЦ пачки

282
Параметр Тип Обяз. Описание Комментарий
pVSD string - ID производственного ВСД ID производственного ВСД, сопровождающего
партию. Только для ТГ "Молочная продукция"
expirationDate string - Дата срока годности Минимальный срок годности, если задаётся период.
(date- Возвращается только для ТГ «Молочная продукция»
time) в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
in_gray_zone integer + Признак наличия в Серой Признак наличия кода в серой зоне или наличия в
зоне агрегате Серой зоны. Возвращается только для ТГ
"Табачная продукция"
gray_quanity integer - Количество кодов в Серой Количество кодов в Серой зоне в агрегате.
зоне Возвращается только для ТГ "Табачная продукция"
statusEx enum - Актуальные особые
состояния КИ см.
Справочник "Статусы КИ"
mark_withdraw integer - Признак выбытия КИ от не Признак выбытия КИ от не владельца
владельца
child array + Массив кодов вложений Не выводится для КИ
первого уровня без
детализации
cis string + Код идентификации или
агрегата, вложенного в
уровень выше

8.4.3. Метод получения CSV по списку кодов идентификации УОТ по заданному фильтру
В ответе формируется ZIP файл с выгрузкой из запроса в формате CSV со сведениями о КИ, которые
находятся на балансе у участника оборота товаров. Вывод сведений о КИ осуществляется с учётом
установленных фильтров. Сформированный архив будет доступен для скачивания в течение 30 дней.
"Filter(participantInn=0000000000, productGroup=TOBACCO, packageType=[LEVEL1],
status=EMITTED, includeGtin=[], excludeGtin=[], appliedPeriod=null,
emissionPeriod=null)"
"requestedCis","gtin","tnVedEaes","tnVedEaesGroup","mrp","parent","producerInn","ownerI
nn","prVetDocument","productName","brand","ownerName","producerName","introducedDate","
receiptDate","status","statusEx","emissionType","withdrawReason","packageType","product
Group","applicationDate","emissionDate","expirationDate","child"
"(01)000000000000000(21)N8JY6Hl","000000000000205","1","1","12500","00000046229205K6RKY
lY5jNnQa1IIJn1mTxtr","0000000000",,,,,,"АО ""БАТ-
СПБ""","","","APPLIED",,"LOCAL",,"LEVEL1","TOBACCO","2020-06-09T16:29:51Z","2020-06-
09T16:29:34Z","2020-06-09T16:29:34Z"
"(01)000000000000000(21)1x5n1eh","000000000000205",,,"",,"0000000000",,,,,,"АО ""БАТ-
СПБ""","","","APPLIED",,"LOCAL",,"LEVEL1","TOBACCO","2019-12-04T08:42:33Z","2019-12-
04T08:42:22Z",

Параметр Тип Обяз. Описание Комментарий

requestedCis string + КИ потребительских/групповых/транспортных При наличии параметра в ответе
упаковок (если найдены КИ по запросу)

283
Параметр Тип Обяз. Описание Комментарий
gtin string + Код товара Если код товара менее 14
символов, то дополняется
ведущими нулями
tnVedEaes string - 10 значный код ТН ВЭД
tnVedEaesGroup string - 4 значный код ТН ВЭД
maxRetailPrice number - Максимальная розничная цена в копейках В текущей реализации возможно
выведение параметра "mrp",
который в последующих версиях
будет заменён на "maxRetailPrice"
parent string - Родительский КИ
producerInn string - ИНН производителя Не возвращается для агрегатов,
кроме товарных групп "Табачная
продукция" и "Альтернативная
табачная продукция"
ownerInn string - ИНН собственника товара Данный параметр возвращается
только владельцу продукции,
ФОИВ и Оператору. Возвращение
данных о владельце настраивается
параметром конфигурации.
Параметр не возвращается для
товарной группы "Табачная
продукция"
prVetDocument string - Производственный ветеринарный
сопроводительный документ, транспортный
ВСД для импортируемой продукции
(обязательный параметр для ТГ "Молочная
продукция")
productName string - Наименование продукции
ownerName string - Наименование собственника товара Данный параметр возвращается
только владельцу продукции,
ФОИВ и Оператору. Отображение
данных о владельце настраивается
параметром конфигурации.
Параметр не возвращается для
товарной группы "Табачная
продукция"
producerName string - Наименование производителя Не возвращается для агрегатов,
кроме товарных групп "Табачная
продукция" и "Альтернативная
табачная продукция"
introducedDate string - Дата ввода товара в оборот или формирование Возвращается в формате yyyy-
(date- агрегата MM-ddTHH:mm:ss.SSS’Z
time)
emissionDate string - Дата эмиссии Возвращается в формате yyyy-
(date- MM-ddTHH:mm:ss.SSS’Z
time)

284
Параметр Тип Обяз. Описание Комментарий
emissionType string - Тип эмиссии
maxRetailPrice number - Максимальная цена розничной продажи Только для пачки и блока
applicationDate string - Дата нанесения Возвращается в формате yyyy-
(date- MM-ddTHH:mm:ss.SSS’Z
time)
receiptDate string - Дата вывода из оборота Возвращается в формате yyyy-
(date- MM-ddTHH:mm:ss.SSS’Z
time)
withdrawReason string - Причина вывода из оборота
packageType string + Тип упаковки
child array - Список дочерних КИ в агрегате
[string]
brand string - Бренд
expirationDate string + Срок годности (для ТГ "Молочная продукция")
(date-
time)
productGroup string - Товарная группа См. "Справочник "Список
поддерживаемых товарных
групп""
status string + Статус КИ Cм. "Справочник "Статусы КИ""
statusEx string - Актуальный расширенный статус КИ См. cправочник "Актуальные
статусы"
setGtin array - Список и количество "gtin", входящих в Возвращается только с типом
справочный состав набора упаковки "Набор" (SET)
setDesription string - Текстовое описание состава набора Возвращается только с типом
упаковки "Набор" (SET)
introducedDate string + Дата ввода товара в оборот или формирования Возвращается в формате yyyy-
(date- агрегата MM-ddTHH:mm:ss.SSS’Z.
time) Параметр может возвращаться с
пустым значением. Данные
выводятся только для продукции,
произведённой с января 2021 года
receiptDate string + Дата вывода из оборота Возвращается в формате yyyy-
(date- MM-ddTHH:mm:ss.SSS’Z только
time) для выгрузки
FILTERED_CIS_REPORT.
Параметр может возвращаться с
пустым значением

285
9. Взаимодействие с провайдером ЭДО Lite
9.1. Публичный метод получения идентификатора абонента в ЭДО Lite
Метод предназначен для получения идентификатора абонента в ЭДО Lite: в одном запросе
указывается ИНН одного участника оборота товаров.
Тип приватности:
1. публичный;
2. без токена.
Принцип формирования ответа метода:
1. если участник оборота товаров не зарегистрирован в ЭДО Lite, то возвращается текст сообщения
об ошибке: "Организация не зарегистрирована";
2. если участник оборота товаров зарегистрирован в ЭДО Lite, но в качестве основного ЭДО
провайдера указан не ЭДО LITE, то возвращается текст сообщения об ошибке: "УОТ использует
другого оператора ЭДО";
3. если участник оборота товаров зарегистрирован в ЭДО Lite и в качестве основного ЭДО
провайдера указан ЭДО Lite, то возвращается ID участник оборота товаров вместе с префиксом
"2LT-" формата "2LT-<ID участника обмена ЭДО Lite>" (например: 2LT-572279911).
Версия метода 4 (v4):
URL: /edo/inn/{inn}
Метод: GET
Пример запроса с токеном:
curl -X GET "<url стенда>/edo/inn/7777777777"
Authorization: Bearer <ТОКЕН>

Пример запроса без токена:

curl -X GET "<url стенда>/edo/inn/7777777777"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

inn string + ИНН участника оборота товаров

Пример ответа:
1.В случае успеха:

286
{
"inn": "7777777777",
"id": "2LT-572279988",
"name": "ООО",
"hub": true
}

2.В случае ошибок:

2.1. Код 400, если запрос в сервис организации вернул пустой ответ:
{
"error_message": "Организация не зарегистрирована"
}

2.2. Код 400, если в ответе от сервиса ЭДО для запрашиваемого ID участника обмена нет информации
по операторам ЭДО, или ни один из найденных операторов ЭДО не является основным, или
наименование у найденного основного оператора ЭДО не равно "ЭДО Lite" (нечувствительная к
регистру проверка наименования):
{
"error_message": "УОТ использует другого оператора ЭДО"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

inn string - ИНН запрашиваемой организации Параметр возвращается только при выполнении п. 3
"Принципа формирования ответа метода" в
описании настоящего метода
id string - ID участника обмена ЭДО Lite Параметр возвращается только при выполнении п. 3
"Принципа формирования ответа метода" в
описании настоящего метода
name string - Наименование организации или Параметр возвращается только при выполнении п. 3
ФИО индивидуального "Принципа формирования ответа метода" в
предпринимателя описании настоящего метода
hub boolean - Признак использования Возможные значения:
организацией 1С Хаб
true - организация использует 1С Хаб;
false - Организация не использует 1С Хаб
Параметр возвращается только при выполнении п. 3
"Принципа формирования ответа метода" в
описании настоящего метода

Версия 3 метода будет поддерживаться для сохранения обратной совместимости. Плановая дата
отключения: 03.08.2021
URL: /edo/inn/{inn}
Метод: GET

287
Пример запроса с токеном:
curl -X GET "<url стенда>/edo/inn/7777777777"
Authorization: Bearer <ТОКЕН>

Пример запроса без токена:

curl -X GET "<url стенда>/edo/inn/7777777777"

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

inn string + ИНН участника оборота товаров (участника обмена ЭДО Lite)

Пример ответа:
1.В случае успеха:
{
"id": "2LT-572279988"
}

2.В случае ошибок:

2.1. Код 400, если запрос в сервис организации вернул пустой ответ:
{
"error_message": "Организация не зарегистрирована"
}

2.2. Код 400, если в ответе от сервиса ЭДО для запрашиваемого ID участника обмена нет информации
по операторам ЭДО, или ни один из найденных операторов ЭДО не является основным, или
наименование у найденного основного оператора ЭДО не равно "ЭДО Lite" (нечувствительная к
регистру проверка наименования):
{
"error_message": "УОТ использует другого оператора ЭДО"
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string - ID участника оборота товаров При выполнении п. 3 блока "Принцип формирования
(участника обмена ЭДО Lite) ответа метода" в описании настоящего метода

9.2. Метод загрузки титулов

Метод предназначен для загрузки xml-файлов с титулом покупателя. В случае успешной загрузки
статус документа изменяется на "4" ("Подписан").
Тип приватности: приватный.

288
URL:

Тип документов URL

УПД /incoming-documents/xml/upd/title
УПДи /incoming-documents/xml/updi/title
УКД /incoming-documents/xml/ukd/title
УКДи /incoming-documents/xml/ukdi/title

Метод: POST
Параметры заголовка запроса: Authorization: Bearer <token>
Content-Type: application/json; charset=utf-8
Параметры тела запроса:

Параметр Тип Обяз. Описание

content file + Файл титула документа
doc_id string + Идентификатор титула
signature string + Откреплённая УКЭП в кодировке Base64

Пример запроса:
curl --location --request POST '<url стенда>/incoming-documents/xml/upd/title' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer <token> \
--form 'content=@"/<Путь к файлу>/<Название файла>"' \
--form 'doc_id="ec798fcb-efae-45e4-9e18-a166b281d7a0"' \
--form 'signature="Откреплённая УКЭП в кодировке Base64"'\

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID титула

Пример ответа
В случае успеха:
{
"id": "875b2e45-3aad-4c55-831b-2c58a5d7bb40"
}

9.3. Метод загрузки квитанций с уведомлением об уточнении

Метод предназначен для загрузки xml-файла квитанции с уведомлением об уточнении. В случае
успешной загрузки статус документа изменяется на "8" ("Требуется уточнение").

289
Тип приватности: приватный.
URL: /incoming-documents/xml/uvtoch
Метод: POST
Параметры заголовка запроса: Authorization: Bearer <token>
Content-Type: application/json; charset=utf-8
Параметры тела запроса:

Параметр Тип Обяз. Описание

content file + Файл титула документа
doc_id string + Идентификатор документа, для которого создается УвТоч
signature string + Откреплённая УКЭП в кодировке Base64

Пример запроса:
curl --location --request POST '<url стенда>/incoming-documents/xml/uvtoch' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer <token> \
--form 'content=@"/<Путь к файлу>/<Название файла>"' \
--form 'doc_id="ec798fcb-efae-45e4-9e18-a166b281d7a0"' \
--form 'signature="Откреплённая УКЭП в кодировке Base64"'\

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID квитанции с уведомлением об уточнении

Пример ответа
В случае успеха:
{
"id": "875b2e45-3aad-4c55-831b-2c58a5d7bb40"
}

9.4. Метод загрузки квитанций с предложением об аннулирования

Метод предназначен для загрузки xml-файла квитанции с предложением об аннулировании
документа. В случае успешной загрузки статус документа изменяется на "16" ("Ожидается
аннулирование").
Тип приватности: приватный.
URL:

290
Тип документов URL
Для версии DP_PRANNUL 1.01, входящий документ /incoming-documents/xml/annul_01
для версии DP_PRANNUL 1.02, входящий документ /incoming-documents/xml/annul_02
для версии DP_PRANNUL 1.01, исходящий документ /outgoing-documents/xml/annul_01
для версии DP_PRANNUL 1.02, исходящий документ /outgoing-documents/xml/annul_02

Выбор URL осуществляется с учетом версии и типа документа (входящий/исходящий).

Метод: POST
Параметры заголовка запроса: Authorization: Bearer <token>
Content-Type: application/json; charset=utf-8
Параметры тела запроса:

Параметр Тип Обяз. Описание

content file + Файл DR_PRANNUL
doc_id string + Идентификатор аннулируемого документа
signature string + Откреплённая УКЭП в кодировке Base64

Пример запроса:
curl --location --request POST '<url стенда>/incoming-documents/xml/annul_01' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer <token> \
--form 'content=@"/<Путь к файлу>/<Название файла>"' \
--form 'doc_id="ec798fcb-efae-45e4-9e18-a166b281d7a0"' \
--form 'signature="Откреплённая УКЭП в кодировке Base64"'\

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID квитанции с предложением об аннулировании

Пример ответа
В случае успеха:
{
"id": "875b2e45-3aad-4c55-831b-2c58a5d7bb40"
}

291
9.5. Метод аннулирования документа
Метод предназначен для аннулирования документа. В случае успеха статус документа изменяется на
"18" ("Аннулирован").
Тип приватности: приватный.
URL:

Тип документов URL

Входящий документ /incoming-documents/{doc_id}/events/{event_id}/signature
Исходящий документ /outgoing-documents/{doc_id}/events/{event_id}/signature

Метод: POST
Параметры заголовка запроса:
Authorization: Bearer <token>;
Content-Type: text/plain;
Сontent-encoding: base64';
|doc_id |string |+ |Идентификатор аннулируемого документа |event_id |string |+ |Идентификатор
квитанции (DP_PRANNUL)
Параметры тела запроса:

Параметр Тип Обяз. Описание

string + Откреплённая УКЭП в кодировке Base64

Пример запроса:
curl '<url стенда>/incoming-documents/a4940e6f-cbec-4c6d-b3de-
55dbeca93595/events/d33337d2-c087-4e04-a834-844d21e30802/signature' \
-H 'content-encoding: base64' \
-H 'authorization: Bearer <Токен>' \
-H 'content-type: text/plain' \

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + Идентификатор квитанции с предложением об аннулировании

Пример ответа
В случае успеха:
{
"id": "875b2e45-3aad-4c55-831b-2c58a5d7bb40"
}

292
9.6. Метод загрузки квитанций c предложением отклонения аннулирования
Метод предназначен для загрузки xml-файла с уведомлением об уточнении для квитанции
аннулирования. В случае успешной загрузки статус документа изменяется на "19" ("Отказано в
аннулировании"). Метод доступен только для документа, находящегося в статусе "17" ("Требуется
Аннуилрование").
Тип приватности: приватный.
URL:

Тип документов URL

Входящий документ /incoming-documents/xml/annul_uvtoch
Исходящий документ /outgoing-documents/xml/annul_uvtoch

Метод: POST
Параметры заголовка запроса: Authorization: Bearer <token>
Content-Type: application/json; charset=utf-8
Параметры тела запроса:

Параметр Тип Обяз. Описание

content file + Файл DR_PRANNUL
doc_id string + Идентификатор аннулируемого документа
annul_id string + Идентификатор предложения об аннулировании (DP_PRANNUL)
signature string + Откреплённая УКЭП в кодировке Base64

Пример запроса:
curl --location --request POST '<url стенда>//incoming-documents/xml/annul_uvtoch' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer <token> \
--form 'content=@"/<Путь к файлу>/<Название файла>"' \
--form 'doc_id="ec798fcb-efae-45e4-9e18-a166b281d7a0"' \
--form 'annul_id="Идентификатор документа об обнулировании"' \
--form 'signature="Откреплённая УКЭП в кодировке Base64"'\

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

id string + ID квитанции с предложением отклонения аннулирования

Пример ответа
В случае успеха:

293
{
"id": "875b2e45-3aad-4c55-831b-2c58a5d7bb40"
}

9.7. Метод получения ZIP-архива документа ЭДО с подписями и квитанциями из

ЭДО Lite
Метод предназначен для получения ZIP-архива входящих либо исходящих документов ЭДО (УПД,
УПД(и), УКД, УКД(и)) с подписями и квитанциями обмена с подписями.
Тип приватности: приватный.
URL:

Тип документов URL

Для исходящих документов /elk/outgoing-documents/{documentId}
Для входящих документов /elk/incoming-documents/{documentId}

Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание

documentId string + Идентификатор документа в системе ЭДО оператора

Параметры ответа:
ZIP-архив с документом, подписью и квитанциями с подписями, если это УПД или УКД.
Пример запроса:
<url стенда>/elk/outgoing-documents/5b7f19e8-db96-463a-9735-2ef1a73abf9b
Authorization: Bearer <ТОКЕН>
Accept: */*

Пример ответа:
1 В случае успеха:
ZIP-архив
2 В случае ошибок:
2.1 Код 401 В случае, если не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to access this
resource</error_description>
</UnauthorizedException>

294
2.2 Код 401 В случае, если указан невалидный токен:
<InvalidTokenException>
<error>invalid_token</error>
<error_description>Cannot convert access token to
JSON</error_description>
</InvalidTokenException>

2.3 Код 404 В случае, если указан невалидный {documentId} в параметре URL запроса:
{
"error_message": "Документ не найден"
}

295
10. Методы Национального каталога
Вызов методов "Национального каталога" доступен только по токену, указываемому в
параметре "apikey" URL запроса метода. Данный токен предоставляется системой "Национального
каталога" по индивидуальной заявке. Заявку можно оставить по ссылке Национальный каталог.

10.1. Универсальные параметры запроса

Значение по
Параметр Обяз. умолчанию Описание
apikey + Параметр, необходимый для авторизации и совершения запросов API.
Предоставляется системой.
format - Формат вывода JSON
ответа

10.2. Метод получения списка атрибутов как публичных, так и приватных для
запрашивающего аккаунта
Метод возвращает перечень атрибутов для создания карточки товара с указанным кодом ТНВЭД или
идентификатором категории. Если не указан код ТНВЭД или идентификатор категории, возвращается
полный список атрибутов доступных для запрашивающего аккаунта.
Тип приватности: публичный.
URL: /nk/attributes
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

attr_type string - Тип атрибута Возможные значения:
"a" — вернуть все атрибуты (значение
по умолчанию);
"m" — вернуть только обязательные
атрибуты;
"r" — вернуть только рекомендуемые
атрибуты;
"o" — вернуть только опциональные
атрибуты
cat_id string - Идентификатор любой из категорий товаров, к Является обязательным, если указании
которой относятся атрибуты attr_type и не указан tnved
tnved string - код ТНВЭД (10 знаков) или группы ТНВЭД (4 Обязателен, если указан параметр
знака), для которого запрашивается набор attr_type (тип атрибута) и не указан
атрибутов cat_id

Параметры ответа:

296
Параметр Тип Обяз. Описание Комментарий
apiversion number + Номер версии API метода
result array - Результат При наличии ответа
*attr_id number + Идентификатор атрибута
*attr_name string + Наименование атрибута
*attr_group_name string + Наименование группы, к которой относится
атрибут
*attr_group_id number + Идентификатор группы, к которой относится
атрибут
*attr_value_type array[string] + Массив возможных значений типа атрибута
*attr_field_type string + Тип значения атрибута Возможные значения:
"number";
"text"
*second_layer boolean + признак принадлежности атрибута ко второму принимает значения true -
слою атрибутов (атрибуты, необходимые для атрибут необходим /false-
ввода товаров в оборот) атрибут не необходим
*attr_preset array[string] + Массив возможных значений атрибута
*attr_type string - Тип атрибута При наличии cat_id в запросе

Пример запроса с использованием идентификатора категории:

<url стенда>/nk/attributes?attributes?apikey=XXX&cat_id=30933&attr_type=m

Пример запроса с использованием кода ТНВЭД:

<url стенда>/nk/attributes?apikey=XXX&tnved=3033&attr_type=m

Пример ответа:
1 В случае успеха:
1.1. Для формата json:
{
"apiversion": 3,
"result": [
{
"attr_group_name": "Состав",
"attr_field_type": "text",
"attr_value_type": [],
"attr_group_id": 26,
"attr_name": "Комплектация",
"attr_id": 28,
"second_layer": false,
"attr_type": "r",
"attr_preset": []
},
{

297
 "attr_group_id": 26,
"attr_name": "Тип материала, %",
"attr_id": 741,
"second_layer": false,
"attr_type": "r",
"attr_preset": [
"АКРИЛ",
"АУТЛАСТ",
"БАМБУК",
"БАМБУКОВОЕ ВОЛОКНО",
"БУМАГА",
"ВИНИЛ",
"ВИСКОЗА",
"ИСКУССТВЕННЫЙ ЛЕН",
"ИСКУССТВЕННЫЙ МЕХ",
"ИСКУССТВЕННЫЙ ШЕЛК",
"КОМБИНАЦИЯ",
"ЛЕН",
"ПВХ",
"ПОЛИАМИД",
"ПОЛИЭСТЕР",
"ПОЛИУРЕТАН",
"ПОЛИЭФИР",
"РЕЗИНА",
"СИНТЕТИЧЕСКОЕ ВОЛОКНО",
"ХЛОПОК",
"ЦЕЛЛЮЛОЗА",
"ШЕЛК",
"ШЕРСТЬ",
"ЭВКАЛИПТОВОЕ ВОЛОКНО",
"ЭКОФАЙБЕР",
"НЕ КЛАССИФИЦИРОВАНО",
"НЕ ОПРЕДЕЛЕНО"
]
},
{
"attr_group_name": "Потребительские свойства",
"attr_field_type": "text",
"attr_value_type": [],
"attr_group_id": 103,
"attr_name": "Возраст потребителя",
"attr_id": 557,
"second_layer": true,
"attr_type": "m",
"attr_preset": [
"ВЗРОСЛЫЙ",
"ДЕТСКИЙ",
"ЛЮБОЙ ВОЗРАСТ",
"НЕ КЛАССИФИЦИРОВАНО",
"НЕ ОПРЕДЕЛЕНО"
]
},
...
]
}

1.2. Для формата xml:

298
<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<item>
<attr_group_name>Рекомендации производителя</attr_group_name>
<attr_field_type>text</attr_field_type>
<attr_value_type/>
<attr_group_id>69</attr_group_id>
<attr_name>Меры предосторожности</attr_name>
<attr_id>4003</attr_id>
<second_layer></second_layer>
<attr_type>r</attr_type>
<attr_preset>
<item>Недоступное для детей место</item>
<item>Недоступное для детей и животных место</item>
<item>Вдали от отопительных приборов</item>
<item>Вдали от легковоспламеняющихся предметов</item>
<item>Вдали от легковоспламеняющихся предметов, недоступное для детей
место</item>
<item>Вдали от отопительных приборов, недоступное для детей
место</item>
<item>Огнеопасно! Не использовать вблизи открытого огня</item>
<item>Огнеопасно! Не использовать вблизи открытого огня, хранить в
недоступном для детей месте</item>
<item>Не допускать попадания в глаза, хранить в недоступном для детей
месте</item>
<item>Огнеопасно! Хранить в недоступном для детей месте</item>
<item>Огнеопасно! Хранить в недоступном для детей месте. Избегать
попадания на кожу и в глаза. Не
смешивать с другими чистящими средствами
</item>
<item>Не смешивать с другими чистящими средствами. Избегать попадания
на кожу и в глаза. Хранить в
недоступном для детей месте
</item>
<item>Огнеопасно! Хранить вдали от источников тепла и открытого огня.
Избегать попадания в глаза</item>
<item>Избегать попадания в глаза</item>
<item>Избегать попадания на кожу и в глаза</item>
<item>Не держать у открытого огня</item>
<item>Избегать попадания на кожу и в глаза. хранить в недоступном для
детей месте</item>
<item>Хранить отдельно от пищевых продуктов в недоступном для детей
месте, избегать попадания в глаза
</item>
<item>Хранить вдали от источников тепла и открытого огня, недоступное
для детей место</item>
<item>Хранить вдали от источников тепла и огня, избегать попадания на
кожу</item>
</attr_preset>
</item>
<item>
<attr_group_name>Характеристики товара в состоянии
использования</attr_group_name>
<attr_field_type>text</attr_field_type>
<attr_value_type>

299
 <item>см</item>
<item>мм</item>
<item>м</item>
</attr_value_type>
<attr_group_id>107</attr_group_id>
<attr_name>Высота изделия</attr_name>
<attr_id>13896</attr_id>
<second_layer></second_layer>
<attr_type>r</attr_type>
<attr_preset/>
</item>

<item>
<attr_group_name>Эксплуатация и условия хранения</attr_group_name>
<attr_field_type>text</attr_field_type>
<attr_value_type/>
<attr_group_id>7</attr_group_id>
<attr_name>Особые условия хранения</attr_name>
<attr_id>13884</attr_id>
<second_layer></second_layer>
<attr_type>r</attr_type>
<attr_preset/>
</item>
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

2.2. Код 404 Если не найдены атрибуты для указанной категории:

{
"error_message": "Данные не найдены"
}

2.3. Код 400 При ошибках в параметрах запроса:

{
"error_message": "Ошибка в параметрах запроса"
}

10.3. Метод получения списка торговых марок

Метод предназначен для получения списка торговых марок. При отправке ID торговой сети в ответе
возвращаются данные о брендах.
Тип приватности: публичный.
URL: /nk/brands
Метод: GET

300
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result array - Результат При наличии ответа
*brand_id number + Идентификатор товарного знака
*brand_name string + Наименование бренда

Пример запроса:
<url стенда>/nk/brands?apikey=XXX

Пример ответа:
1 В случае успеха:
1.1. Для формата json:
{
"apiversion": 3,
"result": [
{
"brand_id": 29096,
"brand_name": "Bercatti"
},
{
"brand_id": 28964,
"brand_name": "OUTEMER"
},
{
"brand_id": 7105,
"brand_name": "Roshen"
},
{
"brand_id": 28900,
"brand_name": "PIONEER"
},
{
"brand_id": 28879,
"brand_name": "Smile of Milady"
}
]
}

1.2. Для формата xml:

<root>
<apiversion>3</apiversion>
<result>
<item>
<brand_id>8117</brand_id>
<brand_name>1 Сентября</brand_name>

301
 </item>
<item>
<brand_id>6262</brand_id>
<brand_name>Nike</brand_name>
</item>
<item>
<party_brand_id>12345</party_brand_id>
<brand_id>7105</brand_id>
<brand_name>Roshen</brand_name>
</item>
<item>
<brand_id>6035</brand_id>
<brand_name>1000 секретов</brand_name>
</item>
...
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

10.4. Метод получения списка субаккаунтов компании

URL: /nk/linked-accounts
Метод: GET
Тип приватности: приватный.
Пример запроса:
curl -X GET "<url стенда>/nk/linked-accounts?apikey=<APIKEY>&format=json"
-H "accept: application/json"

Пример ответа в формате JSON:

{
"apiversion": 3,
"result": {
"linked_accounts": [
{
"account_inn": "0000000001",
"account_name": "Общество с ограниченной ответственностью \"Ромашка\""
},
{
"account_inn": "0000000002",
"account_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"Ромашка 2\""
}
]
}
}

302
Пример ответа в формате JSON при отсутствии субаккаунтов:
{
"apiversion":3,
"result":{
"linked_accounts":[

]
}
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Версия API
result object + Результат При наличии ответа
*linked_accounts [array] + Массив субаккаунтов Если субаккаунты отсутствуют, возвращается пустой
компании массив
**account_inn string + ИНН субаккаунта
**account_name string + Наименование субаккаунта

Пример ответа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<linked_accounts>
<item>
<account_inn>0000000001</account_inn>
<account_name>ООО"</account_name>
</item>
<item>
<account_inn>0000000002</account_inn>
<account_name>ООО"</account_name>
</item>
</linked_accounts>
</result>
</root>

10.5. Метод подписи предоставления или отзыва разрешения на использование

КИ
Метод предназначен для подписи (с помощью сертификата в формате PKCS#7) предоставления или
отзыва разрешения субаккаунту на использование своих кодов товара для эмиссии КМ и ввода
товаров в оборот товара. Данные кодируются в BASE64.
Максимальное количество позиций в запросе: 100.
URL: /nk/linked-accounts-sign

303
Метод: POST
Тип приватности: приватный.
Пример запроса:
curl -X POST "<url стенда>nk/linked-accounts-sign?apikey=123&format=json"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "[{\"linked_account_inn\":0,\"base64_xml\":\"string\",\"signature\":\"string\"}]"

Пример тела запроса:

[
{
"linked_account_inn": 000000001,
"base64_xml":"string",
"signature":"string"
}
]

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

linked_account_inn integer + ИНН субаккаунта
(int64)
base64Xml string + Закодированный в BASE64 файл в формате XML с формой
предоставления/отзыва доступа
signature string + Открепленная подпись, закодированная в BASE64,
соответствующая типу CAdES в формате PKCS7

Пример ответа:
{
"signed":[
{
"linked_account_inn":"0000000001",
"access":"allowed"
},
{
"linked_account_inn":"0000000002",
"access":"deleted"
}
],
"errors":[
{
"linked_account_inn":"0000000003",
"message":"text",
"code":"11"
}
]
}

304
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

signed array[number] + Массив числовых идентификаторов товаров, для
которых прошла валидация и проверка карточки
товара, товар переведен в статус "Опубликован"
*linked_account_inn string + ИНН субаккаунта
*access string + Флаг предоставления или отзыва доступа Возможные
значения:
allowed –
предоставление
доступа;
deleted – отзыв
доступа
errors array[string] - Массив объектов, содержащих идентификаторы
товара и текст ошибки, возникшей при обработке
переданных XML (закодированных в BASE64)
*linked_account_inn string + ИНН субаккаунта
*message string + Текст ошибки Возвращается в
случае ошибки
*code string + Код ошибки Возвращается в
случае ошибки

10.6. Метод получения файла в формате XML для управления доступами

субаккаунтов
Метод возвращает файл в формате XML, необходимый для управления доступами субаккаунтов.
Полученный файл необходимо подписать: то есть предоставить или отозвать доступ для субакканута.
URL: /nk/linked-accounts-documents
Метод: POST
Тип приватности: приватный.
Пример запроса:
curl -X POST "<url стенда>/nk/linked-accounts-documents?apikey=<APIKEY>&format=json"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "[{\"linked_account_inn\":\"string\",\"is_access_allowed\":true}]"

Пример запроса в формате JSON:

[
{
"linked_account_inn":"6310000012",
"linked_goods":[
"04600000000001",
"04600000000002"

305
 ],
"is_access_allowed":true
}
]

Пример запроса в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<account>
<schemaVersion>6.0</schemaVersion>
<mainAccountInn>0000000001</mainAccountInn>
<linkedAccountInn>0000000002</linkedAccountInn>
<isAccessAllowed value=“1”>Я разрешаю 0000000002 использовать свои коды товара для
заказа кодов маркировки и ввода товаров в оборот</isAccessAllowed>
</account>
</xml>

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

linked_account_inn string + ИНН субаккаунта
is_access_allowed boolean + Признак Возможные значения:
отзыва/предоставления false - отзыв разрешения у субаккаунта на
разрешения использование своих кодов товара для заказа кодов
маркировки и ввода товаров в оборот;

true - предоставление разрешения субаккаунту

использовать свои коды товара для заказа кодов
маркировки и ввода товаров в оборот
mainAccountInn string + ИНН родительского аккаунта
linkedAccountInn string + ИНН субаккаунта
isAccessAllowed string + Код согласия и текст кода Возможные значения:
Value[0] - Я отзываю разрешение ИНН
использовать свои коды товара для заказа кодов
маркировки и ввода товаров в оборот;
Value[1] - Я разрешаю ИНН использовать свои
коды товара для заказа кодов маркировки и ввода
товаров в оборот

Пример ответа в формате JSON в случае успеха:

{
"result":{
"xmls":[
{
"linked_account_inn":"0000000001",
"xml":"<?xml version=\"1.0\" encoding=\"UTF-
8\"?>\n<account><schemaVersion>6.0</schemaVersion><mainAccountInn>0000000002</mainAccou
ntInn><linkedAccountInn>7731369928</linkedAccountInn><isAccessAllowed value=\"1\">Я
разрешаю 0000000001 использовать свои коды товара для заказа кодов маркировки и ввода
товаров в оборот</isAccessAllowed></account>\n"

306
 }
]
}
}

Пример ответа в формате JSON в случае ошибки:

{
"result": {
"xmls": [],
"errors": [
{
"linked_account_inn": "0000000003",
"message": "Для ИНН:0000000003 еще не был предоставлен доступ ко всем Кодам
Товаров.",
"code": 99
}
]
}
}

Пример ответа в формате XML:

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<xmls>
<item>
<linked_account_inn>0000000001</linked_account_inn>
<xml><?xml version="1.0" encoding="UTF-8"?>
<account><schemaVersion>6.0</schemaVersion><mainAccountInn>0000000002</mainAccountInn><
linkedAccountInn>0000000001</linkedAccountInn><isAccessAllowed value="1">Я разрешаю
0000000001 использовать свои коды товара для заказа кодов маркировки и ввода товаров в
оборот</isAccessAllowed></account>
</xml>
</item>
</xmls>
</result>
</root>

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

result object + При наличии ответа
*xmls array + Массив объектов Параметр возвращается только в случае
успешного запроса (найден хотя бы один
массив объектов)
*errors array[string] - Массив ошибок,
обнаруженных при
валидации контента
**linked_account_inn string + ИНН субаккаунта

307
Параметр Тип Обяз. Описание Комментарий
**message string + Текст ошибки Возвращается в случае ошибки
**code string + Числовой код ошибки

10.7. Метод получения дерева категорий, корень дерева не возвращается

Метод предназначен для получения дерева категорий без корня дерева. В ответе возвращается список
данных о каждом элементе дерева категорий.
Тип приватности: публичный.
URL: /nk/categories
Метод: GET
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Версия API
result array - Результат При наличии ответа
*cat_id number + Идентификатор любой из категорий товаров
*cat_name string + Наименование категории
*cat_parent_id number + Идентификатор родительской категории
*cat_level string + Уровень в дереве категорий

Пример запроса:
<url стенда>/nk/categories?apikey=xee7s6i3sr0l375f&format=

Пример ответа:
1 В случае успеха:
1.1. Для формата json:
{
"apiversion": 3,
"result": [
{
"cat_id": 14001,
"cat_name": "Продукты питания",
"cat_parent_id": 14000,
"cat_level": "1"
},
{
"cat_id": 14002,
"cat_name": "Напитки",
"cat_parent_id": 14001,
"cat_level": 2

308
 }
]
}

1.2. Для формата xml:

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<item>
<cat_id>14002</cat_id>
<cat_name>Напитки</cat_name>
<cat_parent_id>14000</cat_parent_id>
<cat_level>2</cat_level>
</item>
<item>
<cat_id>14001</cat_id>
<cat_name>Питание</cat_name>
<cat_parent_id>14000</cat_parent_id>
<cat_level>2</cat_level>
</item>
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

10.8. Метод получения полной информации о товаре

Метод возвращает краткую или полную информацию о продукте (товаре). Требует обязательного
указания одного из следующих параметров: идентификатор товара или код товара (штрих-код)
товара.
Если указаны оба обязательных параметра, то возвращается результат выборки, соответствующий
параметру good_id. Если карточка товара с данным идентификатором не обнаружена, то
возвращается ошибка 404 независимо от указания кода товара в запросе.
Тип приватности: публичный.
URL: /nk/product
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

good_id string - идентификатор товара в каталоге Обязательно, если не указан gtin

309
Параметр Тип Обяз. Описание Комментарий
gtin string - Глобальный код товара (штрих-код) Обязательно, если не указан good_id
product_name string - Название продукта Используется при запросе на поиск
отсутствующего товара
cat_id string - Идентификатор любой из категорий Используется при запросе на поиск
товаров отсутствующего товара

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result [array] + Результат При наличии ответа
*identified_by [array] + массив содержащий
информацию о штрих-кодах
**value string + штрих-код или локальный
идентификатор
**type string + Тип идентификатора Возможные значения:
"gtin" — глобальный код товара
(штрих-код);
"barcode" — штрих-код Barcode
(штрихкод с неправильной
контрольной цифрой)
**party_id string - Идентификатор торговой сети возвращается только при
условии, что параметр type
имеет значение barcode.
**multiplier number + Количество товаров в Значение по умолчанию = 1
упаковке
**level string + Тип упаковки (уровень Возможные значения:
упаковки) "trade-unit" — штука;
"box" — коробка;
"layer" — слой на палете;
"pallet" — палета;
"metro-unit" — метро-юнит;
"show-pack" — шоу-пак;
"inner-pack" — спайка
*good_id number + Идентификатор товара
*good_name string + Наименование товара
*good_img string + Изображение товара
*categories [array] + Массив категорий
**cat_id number + Идентификатор любой из
категорий товаров, в которой
расположен товар, исключая
родителей этой категории

310
Параметр Тип Обяз. Описание Комментарий
**cat_name string + Наименование категории, в
которой расположен товар
и/или
**party_cat_id number + Идентификатор категории Только для владельца сети, если
торговой сети, в которой указан party_id в запросе
расположен товар
**party_cat_name string + Наименование категории
торговой сети, в которой
расположен товар
*party_brand_id string - Идентификатор бренда для Только для владельца сети, если
торговой сети указан party_id в запросе
*brand_id number + Идентификатор товарного
знака
*brand_name string + Наименование бренда
*good_rating number + Рейтинг товара
*good_images array + Массив с изображениями
**photo_type string + тип фотографии Возможные значения:
"default" — фотография по
умолчанию (вид спереди);
"facing" — crop-фотография для
планограмм (обрезанная по
контуру товара);
"left" — фотография товара
слева;
"right" — фотография товара
справа;
"back" — фотография товара
сзади;
"3ds" — 3D серия;
"marketing" — коммерческая
фотография товара;
"ecommerce" — e-commerce
фото;
"undef" — single shot,
фотография товара с не
предопределенного ракурса;
"cubi" — фотография измерения
ВГХ
**photo_date string (date- + дата создания фотографии UTC yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**photo_url [string] + ссылка на med (medium)
размер фотографии
**barcode string - штрихкод или артикул товара,
для которого сделана
фотография
*good_attrs array - Массив атрибутов Приватные атрибуты отдаются

311
Параметр Тип Обяз. Описание Комментарий
только те, которые принадлежат
аккаунту apikey
**attr_id number + Идентификатор атрибута
**attr_name string + Наименование атрибута
**attr_value_id string - Идентификатор значения
атрибута
**attr_value string + Значение атрибута
**value_id number + Идентификатор значения
атрибута
**attr_value_type array[string] + Массив возможных значений
типа атрибута
**attr_group_id number + Идентификатор группы, к
которой относится атрибут
**attr_group_name string + Наименование группы, к
которой относится атрибут
**measure_date string (date- - Дата измерения атрибута UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**published_date string (date- - Дата публикации атрибута UTC.yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**effective_date string (date- - Дата, с которой UTC. yyyy-MM-
time) действительно значение ddTHH:mm:ss.SSS’Z
атрибута
**expired_date string (date- - Дата, с которой UTC. yyyy-MM-
time) недействительно значение ddTHH:mm:ss.SSS’Z
атрибута
**location_id string - Идентификатор локации, в
которой было проведено
измерение
**party_location_id string - Внутренний идентификатор Отображается только компании,
локации для компании, в которой принадлежит локация
которой было проведено
измерение
**level string - Уровень упаковки
**gtin string - код товара (Штрих-код)
**multiplier number - Мультипликатор
**certificate_number string - номер сертификата Только у атрибутов из группы
"Сертификаты"
**certificate_issued_date string (date- - Дата начала срока действия yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
**certificate_valid_until_date string (date- - Дата окончания срока yyyy-MM-ddTHH:mm:ss.SSS’Z
time) действия

312
Параметр Тип Обяз. Описание Комментарий
**certificate_applicant string - Заявитель
**certificate_manufacturer string - Изготовитель
**certificate_product_description string - Продукция
*good_reviews array + Массив с отзывами
**review_id number + идентификатор отзыва
**review_author string + автор (имя, фамилия,
псевдоним)
**review_rating number + рейтинг отзыва
**review_text string + текст отзыва
**review_date string (date- + дата создания отзыва UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**review_author_img string + ссылка на фотографию автора
**review_replies array - Массив с отзывами Если отзыв имеет ответы (т.е.
отзывы с review_parent_id
= review_id
данного/родительского отзыва)
***review_id number + идентификатор отзыва-ответа
***review_author string + автор (имя, фамилия,
псевдоним)
***review_rating number + рейтинг отзыва-ответа
***review_text string + текст отзыва-ответа
***review_date string (date- + дата создания отзыва UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
***review_author_img string + ссылка на фотографию автора
*good_reviews_count number + Количество отзывов
*good_url string + Ссылка на страницу товара
*good_prices array + Массив цен на товар по
торговым сетям данного
аккаунта
**party_id number + Идентификатор торговой сети
**address array + Местонахождение
***country string + Название страны ISO 3166-2
***city string + Название города
***street string + Название улицы, дом
***location array + Координаты
* ***lat string + Географическая широта
* ***lon string + Географическая долгота

313
Пример запроса:
<url стенда>/nk/product?apikey=XXX&gtin=0000000000000

Пример ответа:
1 В случае успеха:
1.1. Для формата json:
{
"apiversion": 3,
"result": [
{
"good_id": 672136,
"identified_by": [
{
"value": "11033",
"type": "gtin",
"multiplier": 1,
"level": "trade-unit"
},
{
"value": "24823002000164",
"type": "gtin",
"multiplier": 12,
"level": "box"
}
],
"good_name": "Gala стиральный порошoк авт. 1,5кг. Горная лаванда",
"good_url": "https://национальный-каталог.рф/product/gala-pralniy-poroshok-avt-
15kg-svizhist-girskoi-lavandi",
"good_img": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.jpg",
"categories": [
{
"cat_id": 14786,
"cat_name": "Порошки"
},
{
"party_cat_id": 241000,
"party_cat_name": "Порошки"
}
],
"brand_id": null,
"brand_name": null,
"good_rating": 4.33333,
"good_images": [
{
"photo_type": "default",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.jpg",
"barcode": "6437005056338"
},
{

314
 "photo_type": "3ds",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": [
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.0.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.1.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.2.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.3.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.4.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.5.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.6.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.7.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.8.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.9.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.10.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.11.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.12.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.13.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.14.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.15.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.16.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.17.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.18.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.19.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.20.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.21.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.22.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.23.jpg"
],
"barcode": "6437005056338"
},
{
"photo_type": "left",
"photo_date": "2016-07-20T16:26:30+00:00",

315
 "photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.6.jpg",
"barcode": "6437005056338"
},
{
"photo_type": "right",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.18.jpg",
"barcode": "6437005056338"
},
{
"photo_type": "back",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.12.jpg",
"barcode": "6437005056338"
}
],
"good_attrs": [
{
"attr_id": 18,
"attr_name": "Вес брутто",
"attr_value": "1.506",
"value_id": 7824938,
"attr_value_type": "кг",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 19,
"attr_name": "Высота",
"attr_value": "29.2",
"value_id": 8214928,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{

316
 "attr_id": 20,
"attr_name": "Глубина",
"attr_value": "",
"value_id": 5325635,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 21,
"attr_name": "Ширина",
"attr_value": "20.7",
"value_id": 1224735,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 2503,
"attr_name": "Производитель",
"attr_value_id": 3408,
"value_id": 7812631,
"attr_value": "ООО «ООО»",
"attr_value_type": "",
"attr_group_id": 25,
"attr_group_name": "Стороны",
"published_date": "2017-12-10 15:35:08",
"location_id": "532",
"party_location_id": "Store #53"
},
{
"attr_id": 2813,
"attr_name": "Единый реестр сертификатов соответствия",
"attr_value": "https://национальный-
каталог.рф/certificates/86F13A2714824C4B93545560F7D1CCC1",
"value_id": 1624735,
"attr_group_id": 41,
"attr_group_name": "Сертификаты",
"published_date": "2017-12-15 17:14:01",

317
 "location_id": "532",
"party_location_id": "Store #53",
"certificate_number": "С-RU.АЮ64.В.01026",
"certificate_issued_date": "24.07.2017",
"certificate_valid_until_date": "23.07.2022",
"certificate_applicant": "Общество с ограниченной ответственностью
«Производственная компания «Севкабель»",
"certificate_manufacturer": "Общество с ограниченной ответственностью
«Производственная компания «Севкабель»",
"certificate_product_description": "Кабель судовой безгалогенный ..."
}
],
"good_reviews": [
{
"review_id": 286,
"review_author": "Evgeniy",
"review_rating": 4,
"review_text": "Отлично!",
"review_date": "2016-11-28T09:31:54+00:00",
"review_author_img": "https://lh5.googleusercontent.com/-
F0rhYj_uC6o/AAAAAAAAAAI/AAAAAAAAFUs/_nuL7XLXK88/photo.jpg?sz=50",
"review_replies": [
{
"review_id": 288,
"review_author": "Maxim",
"review_rating": 4,
"review_text": "Perfect!!!",
"review_date": "2016-11-28T09:49:39+00:00",
"review_author_img": "https://lh5.googleusercontent.com/-
F0rhYj_uC6o/AAAAAAAAAAI/AAAAAAAAFUs/_nuL7XLXK88/photo.jpg?sz=50"
}
]
},
{
"review_id": 282,
"review_author": "Maria Moryakina",
"review_rating": 5,
"review_text": "Вкусно пахнет",
"review_date": "2016-11-17T11:19:48+00:00",
"review_author_img": "https://scontent.xx.fbcdn.net/v/t1.0-
1/c0.17.100.100/p100x100/14102384_286143021757109_2710809744588865430_n.jpg?oh=2eb1e9f7
51c01e58c7b9fdc76dc7153b&oe=58F8B7F4"
}
],
"good_reviews_count": 3,
"good_prices": []
}
]
}{
"apiversion": 3,
"result": [
{
"good_id": 672136,
"identified_by": [
{
"value": "11033",
"type": "gtin",

318
 "multiplier": 1,
"level": "trade-unit"
},
{
"value": "24823002000164",
"type": "gtin",
"multiplier": 12,
"level": "box"
}
],
"good_name": "Gala стиральный порошoк авт. 1,5кг. Горная лаванда",
"good_url": "https://национальный-каталог.рф/product/gala-pralniy-poroshok-avt-
15kg-svizhist-girskoi-lavandi",
"good_img": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.jpg",
"categories": [
{
"cat_id": 14786,
"cat_name": "Порошки"
},
{
"party_cat_id": 241000,
"party_cat_name": "Порошки"
}
],
"brand_id": null,
"brand_name": null,
"good_rating": 4.33333,
"good_images": [
{
"photo_type": "default",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.jpg",
"barcode": "6437005056338"
},
{
"photo_type": "3ds",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": [
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.0.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.1.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.2.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.3.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.4.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.5.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.6.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.7.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-

319
65a0e37da584.3d.8.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.9.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.10.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.11.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.12.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.13.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.14.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.15.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.16.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.17.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.18.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.19.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.20.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.21.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.22.jpg",
"https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-db33-f86b-
65a0e37da584.3d.23.jpg"
],
"barcode": "6437005056338"
},
{
"photo_type": "left",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.6.jpg",
"barcode": "6437005056338"
},
{
"photo_type": "right",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.18.jpg",
"barcode": "6437005056338"
},
{
"photo_type": "back",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.12.jpg",
"barcode": "6437005056338"
}
],
"good_attrs": [

320
{
"attr_id": 18,
"attr_name": "Вес брутто",
"attr_value": "1.506",
"value_id": 7824938,
"attr_value_type": "кг",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 19,
"attr_name": "Высота",
"attr_value": "29.2",
"value_id": 8214928,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 20,
"attr_name": "Глубина",
"attr_value": "",
"value_id": 5325635,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 21,
"attr_name": "Ширина",

321
 "attr_value": "20.7",
"value_id": 1224735,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 2503,
"attr_name": "Производитель",
"attr_value_id": 3408,
"value_id": 7812631,
"attr_value": "ООО «ООО»",
"attr_value_type": "",
"attr_group_id": 25,
"attr_group_name": "Стороны",
"published_date": "2017-12-10 15:35:08",
"location_id": "532",
"party_location_id": "Store #53"
},
{
"attr_id": 2813,
"attr_name": "Единый реестр сертификатов соответствия",
"attr_value": "https://национальный-
каталог.рф/certificates/86F13A2714824C4B93545560F7D1CCC1",
"value_id": 1624735,
"attr_group_id": 41,
"attr_group_name": "Сертификаты",
"published_date": "2017-12-15 17:14:01",
"location_id": "532",
"party_location_id": "Store #53",
"certificate_number": "С-RU.АЮ64.В.01026",
"certificate_issued_date": "24.07.2017",
"certificate_valid_until_date": "23.07.2022",
"certificate_applicant": "Общество с ограниченной ответственностью
«Производственная компания «Севкабель»",
"certificate_manufacturer": "Общество с ограниченной ответственностью
«Производственная компания «Севкабель»",
"certificate_product_description": "Кабель судовой безгалогенный ..."
}
],
"good_reviews": [
{
"review_id": 286,
"review_author": "Evgeniy",
"review_rating": 4,
"review_text": "Отлично!",
"review_date": "2016-11-28T09:31:54+00:00",
"review_author_img": "https://lh5.googleusercontent.com/-

322
F0rhYj_uC6o/AAAAAAAAAAI/AAAAAAAAFUs/_nuL7XLXK88/photo.jpg?sz=50",
"review_replies": [
{
"review_id": 288,
"review_author": "Maxim",
"review_rating": 4,
"review_text": "Perfect!!!",
"review_date": "2016-11-28T09:49:39+00:00",
"review_author_img": "https://lh5.googleusercontent.com/-
F0rhYj_uC6o/AAAAAAAAAAI/AAAAAAAAFUs/_nuL7XLXK88/photo.jpg?sz=50"
}
]
},
{
"review_id": 282,
"review_author": "Maria Moryakina",
"review_rating": 5,
"review_text": "Вкусно пахнет",
"review_date": "2016-11-17T11:19:48+00:00",
"review_author_img": "https://scontent.xx.fbcdn.net/v/t1.0-
1/c0.17.100.100/p100x100/14102384_286143021757109_2710809744588865430_n.jpg?oh=2eb1e9f7
51c01e58c7b9fdc76dc7153b&oe=58F8B7F4"
}
],
"good_reviews_count": 3,
"good_prices": []
}
]
}

1.2. Для формата xml:

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<item>
<good_id>672136</good_id>
<identified_by>
<item>
<value>11033</value>
<type>gtin</type>
<multiplier>1</multiplier>
<good_id>672136</good_id>
<level>trade-unit</level>
</item>
<item>
<value>24823002000164</value>
<type>gtin</type>
<multiplier>12</multiplier>
<good_id>672136</good_id>
<level>box</level>
</item>
</identified_by>
<good_name>Gala стиральный порошoк авт. 1,5кг. Горная лаванда</good_name>
<good_url>https://национальный-каталог.рф/product/gala-pralniy-poroshok-
avt-15kg-svizhist-girskoi-lavandi</good_url>

323
 <good_img>https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.jpg</good_img>
<categories>
<item>
<cat_id>14786</cat_id>
<cat_name>Порошки</cat_name>
</item>
<item>
<party_cat_id>241000</party_cat_id>
<party_cat_name>Порошки</party_cat_name>
</item>
</categories>
<brand_id></brand_id>
<brand_name></brand_name>
<good_rating>4,33333</good_rating>
<good_images>
<item>
<photo_type>default</photo_type>
<photo_date>2016-07-20T16:26:30+00:00</photo_date>
<photo_url>https://национальный-каталог.рф/i/med/63d3beae-b0be-
db33-f86b-65a0e37da584.jpg</photo_url>
<barcode>6437005056338</barcode>
</item>
<item>
<photo_type>3ds</photo_type>
<photo_date>2016-07-20T16:26:30+00:00</photo_date>
<photo_url>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.0.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.1.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.2.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.3.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.4.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.5.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.6.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.7.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.8.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.9.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.10.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.11.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.12.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.13.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.14.jpg</item>

324
 <item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.15.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.16.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.17.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.18.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.19.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.20.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.21.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.22.jpg</item>
<item>https://национальный-каталог.рф/i/med/3d/63d3beae-b0be-
db33-f86b-65a0e37da584.3d.23.jpg</item>
</photo_url>
<barcode>6437005056338</barcode>
</item>
<item>
<photo_type>left</photo_type>
<photo_date>2016-07-20T16:26:30+00:00</photo_date>
<photo_url>https://национальный-каталог.рф/i/med/63d3beae-b0be-
db33-f86b-65a0e37da584.6.jpg</photo_url>
<barcode>6437005056338</barcode>
</item>
<item>
<photo_type>right</photo_type>
<photo_date>2016-07-20T16:26:30+00:00</photo_date>
<photo_url>https://национальный-каталог.рф/i/med/63d3beae-b0be-
db33-f86b-65a0e37da584.18.jpg</photo_url>
<barcode>6437005056338</barcode>
</item>
<item>
<photo_type>back</photo_type>
<photo_date>2016-07-20T16:26:30+00:00</photo_date>
<photo_url>https://национальный-каталог.рф/i/med/63d3beae-b0be-
db33-f86b-65a0e37da584.12.jpg</photo_url>
<barcode>6437005056338</barcode>
</item>
</good_images>
<good_attrs>
<item>
<attr_id>18</attr_id>
<attr_name>Вес брутто</attr_name>
<attr_value>1.506</attr_value>
<value_id>7824938</value_id>
<attr_value_type>кг</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>

325
 <party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>19</attr_id>
<attr_name>Высота</attr_name>
<attr_value>29.2</attr_value>
<value_id>8214928</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>20</attr_id>
<attr_name>Глубина</attr_name>
<attr_value></attr_value>
<value_id>5325635</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>21</attr_id>
<attr_name>Ширина</attr_name>
<attr_value>20.7</attr_value>
<value_id>1224735</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>

326
 <multiplier>1.00</multiplier>
</item>
<item>
<attr_id>2503</attr_id>
<attr_name>Производитель</attr_name>
<attr_value_id>3408</attr_value>
<value_id>7812631</value_id>
<attr_value>ООО ООО</attr_value>
<attr_value_type></attr_value_type>
<attr_group_id>25</attr_group_id>
<attr_group_name>Стороны</attr_group_name>
<published_date>2017-12-10 15:35:08</published_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
</item>
<item>
<attr_id>2813</attr_id>
<attr_name>Единый реестр сертификатов соответствия</attr_name>
<attr_value>https://национальный-
каталог.рф/certificates/86F13A2714824C4B93545560F7D1CCC1</attr_value>
<value_id>1624735</value_id>
<attr_group_id>41</attr_group_id>
<attr_group_name>Сертификаты</attr_group_name>
<published_date>2017-12-15 17:14:01</published_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<certificate_number>С-RU.АЮ64.В.01026</certificate_number>
<certificate_issued_date>24.07.2017</certificate_issued_date>

<certificate_valid_until_date>23.07.2022</certificate_valid_until_date>
<certificate_applicant>Общество с ограниченной ответственностью
«Производственная компания «Севкабель»</certificate_applicant>
<certificate_manufacturer>Общество с ограниченной ответственностью
«Производственная компания «Севкабель»</certificate_manufacturer>
<certificate_product_description>Кабель судовой безгалогенный, не
распространяющий горение...</certificate_product_description>
</item>
</good_attrs>
<good_reviews>
<item>
<review_id>286</review_id>
<review_author>Evgeniy</review_author>
<review_rating>4</review_rating>
<review_text>Отлично!</review_text>
<review_date>2016-11-28T09:31:54+00:00</review_date>
<review_author_img>https://lh5.googleusercontent.com/-
F0rhYj_uC6o/AAAAAAAAAAI/AAAAAAAAFUs/_nuL7XLXK88/photo.jpg?sz=50</review_author_img>
<review_replies>
<item>
<review_id>288</review_id>
<review_author>Maxim</review_author>
<review_rating>4</review_rating>
<review_text>Perfect!!!</review_text>
<review_date>2016-11-28T09:49:39+00:00</review_date>
<review_author_img>https://lh5.googleusercontent.com/-
F0rhYj_uC6o/AAAAAAAAAAI/AAAAAAAAFUs/_nuL7XLXK88/photo.jpg?sz=50</review_author_img>
</item>

327
 </review_replies>
</item>
<item>
<review_id>282</review_id>
<review_author>Maria Moryakina</review_author>
<review_rating>5</review_rating>
<review_text>Вкусно пахнет</review_text>
<review_date>2016-11-17T11:19:48+00:00</review_date>
<review_author_img>https://scontent.xx.fbcdn.net/v/t1.0-
1/c0.17.100.100/p100x100/14102384_286143021757109_2710809744588865430_n.jpg?oh=2eb1e9f7
51c01e58c7b9fdc76dc7153b&amp;oe=58F8B7F4</review_author_img>
</item>
</good_reviews>
<good_reviews_count>3</good_reviews_count>
<good_prices/>
</item>
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

2.2. Код 404 Если не найден продукт:

{
"error_message": "Данные не найдены"
}

2.3. Код 400 Если пропущен обязательный параметр или недопустимое значение параметра:
{
"error_message": "Ошибка в параметрах запроса"
}

10.9. Метод получения краткой информации о товаре

Метод возвращает краткую или полную информацию о продукте (товаре). Требует обязательного
указания одного из следующих параметров: идентификатор товара, код товара (штрих-код) с
указанием идентификатора торговой сети, который относится к запрашиваемому аккаунту.
Если указаны более одного из обязательных параметров, то возвращается результат выборки,
соответствующий данному алгоритму:
good_id - при указании, возвращается товар с соответствующим идентификатором или ошибка 404.
При этом код товара (штрих код) игнорируется.
gtin - при указании, возвращается товар с соответствующим кодом товара (штрих код) или ошибка
404.
Тип приватности: публичный.

328
URL: /nk/short-product?apikey=XXX&gtin=0000000000000
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

good_id string - идентификатор товара в каталоге Обязательно, если не указан gtin
gtin string - Глобальный код товара (штрих-код) Обязательно, если не указан good_id
product_name string - Название продукта Используется при запросе на поиск
отсутствующего товара
cat_id string - Идентификатор любой из категорий Используется при запросе на поиск
товаров отсутствующего товара

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result [array] - Результат При наличии ответа
*identified_by [array] + массив содержащий
информацию о штрих-кодах
**value string + штрих-код или локальный
идентификатор
**type string + Тип идентификатора Возможные значения:
"gtin" — глобальный код товара
(штрих-код);
"barcode" — штрих-код Barcode
(штрихкод с неправильной
контрольной цифрой)
**party_id string - Идентификатор торговой сети возвращается только при
условии, что параметр type
имеет значение barcode.
**multiplier number + Количество товаров в Значение по умолчанию = 1
упаковке
**level string + Тип упаковки (уровень Возможные значения:
упаковки) "trade-unit" — штука;
"box" — коробка;
"layer" — слой на палете;
"pallet" — палета;
"metro-unit" — метро-юнит;
"show-pack" — шоу-пак;
"inner-pack" — спайка
*categories + Массив категорий
**cat_id number + Идентификатор любой из
категорий товаров, в которой
расположен товар, исключая

329
Параметр Тип Обяз. Описание Комментарий
родителей этой категории
**cat_name string + Наименование категории, в
которой расположен товар
и/или
**party_cat_id number + Идентификатор категории Только для владельца сети,
торговой сети, в которой если указан party_id в запросе
расположен товар
**party_cat_name string - Наименование категории
торговой сети, в которой
расположен товар
*good_images array + Массив с изображениями
**photo_type string + тип фотографии Принимает значение - "facing"
— crop-фотография для
планограмм (обрезанная по
контуру товара)
**photo_date string (date- + дата создания фотографии UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**photo_url [string] + ссылка на med (medium)
размер фотографии
**barcode string - штрихкод или артикул товара,
для которого сделана
фотография
*good_attrs array - Массив атрибутов Приватные атрибуты отдаются
только те, которые
принадлежат аккаунту apikey
**attr_id number + Идентификатор атрибута
**attr_name string + Наименование атрибута
**attr_value_id string - Идентификатор значения
атрибута
**attr_value string + Значение атрибута
**value_id number - Идентификатор значения
атрибута
**attr_value_type array[string] + Массив возможных значений
типа атрибута
**attr_group_id number + Идентификатор группы, к
которой относится атрибут
**attr_group_name string + Наименование группы, к
которой относится атрибут
**measure_date string (date- - Дата измерения атрибута UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**published_date string (date- - Дата публикации атрибута UTC.yyyy-MM-
time) ddTHH:mm:ss.SSS’Z

330
Параметр Тип Обяз. Описание Комментарий
**effective_date string (date- - Дата, с которой действительно UTC. yyyy-MM-
time) значение атрибута ddTHH:mm:ss.SSS’Z
**expired_date string (date- - Дата, с которой UTC. yyyy-MM-
time) недействительно значение ddTHH:mm:ss.SSS’Z
атрибута
**location_id string - Идентификатор локации, в
которой было проведено
измерение
**party_location_id string - Внутренний идентификатор Отображается только
локации для компании, в компании, которой
которой было проведено принадлежит локация
измерение
**level string - Уровень упаковки
**gtin string - код товара (Штрих-код)
**multiplier number - Мультипликатор
**certificate_number string - номер сертификата Только у атрибутов из группы
"Сертификаты"
**certificate_issued_date string (date- - Дата начала срока действия yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
**certificate_valid_until_date string (date- - Дата окончания срока yyyy-MM-ddTHH:mm:ss.SSS’Z
time) действия
**certificate_applicant string - Заявитель
**certificate_manufacturer string - Изготовитель
**certificate_product_description string - Продукция

Пример запроса:
<url стенда>/nk/short-product?apikey=XXX&gtin=0000000000000

Пример ответа:
1 В случае успеха:
1.2. Для формата json:
{
"apiversion": 3,
"result": [
{
"identified_by": [
{
"value": "11033",
"type": "gtin",
"multiplier": 1,
"level": "trade-unit"
},

331
 {
"value": "24823002000164",
"type": "gtin",
"multiplier": 12,
"level": "box"
}
],
"categories": [
{
"cat_id": 14786,
"cat_name": "Порошки"
},
{
"party_cat_id": 241000,
"party_cat_name": "Порошки"
}
],
"good_images": [
{
"photo_type": "facing",
"photo_date": "2016-07-20T16:26:30+00:00",
"photo_url": "https://национальный-каталог.рф/i/med/63d3beae-b0be-db33-f86b-
65a0e37da584.jpg",
"barcode": "6437005056338"
}
],
"good_attrs": [
{
"attr_id": 18,
"attr_name": "Вес брутто",
"attr_value": "1.506",
"value_id": 7824938,
"attr_value_type": "кг",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 19,
"attr_name": "Высота",
"attr_value": "29.2",
"value_id": 8214928,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",

332
 "location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 20,
"attr_name": "Глубина",
"attr_value": "",
"value_id": 5325635,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 21,
"attr_name": "Ширина",
"attr_value": "20.7",
"value_id": 1224735,
"attr_value_type": "см",
"attr_group_id": 19,
"attr_group_name": "Cubiscan-атрибуты",
"measure_date": "2018-02-01T16:39:04+00:00",
"published_date": "2018-02-03T13:22:11+00:00",
"effective_date": "2018-02-05T16:39:04+00:00",
"expired_date": "2018-08-05T16:39:04+00:00",
"location_id": "532",
"party_location_id": "Store #53",
"level": "trade-unit",
"gtin": "4011200255905",
"multiplier": 1.00
},
{
"attr_id": 2503,
"attr_name": "Производитель",
"attr_value_id": 3408,
"value_id": 7812631,
"attr_value": "ООО «ООО»",
"attr_value_type": "",
"attr_group_id": 25,
"attr_group_name": "Стороны",
"published_date": "2017-12-10 15:35:08",
"location_id": "532",
"party_location_id": "Store #53"
},
{
"attr_id": 2813,

333
 "attr_name": "Единый реестр сертификатов соответствия",
"attr_value": "https://национальный-
каталог.рф/certificates/86F13A2714824C4B93545560F7D1CCC1",
"value_id": 1624735,
"attr_group_id": 41,
"attr_group_name": "Сертификаты",
"published_date": "2017-12-15 17:14:01",
"location_id": "532",
"party_location_id": "Store #53",
"certificate_number": "С-RU.АЮ64.В.01026",
"certificate_issued_date": "24.07.2017",
"certificate_valid_until_date": "23.07.2022",
"certificate_applicant": "Общество с ограниченной ответственностью
«Производственная компания «Севкабель»",
"certificate_manufacturer": "Общество с ограниченной ответственностью
«Производственная компания «Севкабель»",
"certificate_product_description": "Кабель судовой безгалогенный ..."
}
]
}
]
}

1.2. Для формата xml:

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<item>
<identified_by>
<item>
<value>11033</value>
<type>gtin</type>
<multiplier>1</multiplier>
<good_id>672136</good_id>
<level>trade-unit</level>
</item>
<item>
<value>24823002000164</value>
<type>gtin</type>
<multiplier>12</multiplier>
<good_id>672136</good_id>
<level>box</level>
</item>
</identified_by>
<categories>
<item>
<cat_id>14786</cat_id>
<cat_name>Порошки</cat_name>
</item>
<item>
<party_cat_id>241000</party_cat_id>
<party_cat_name>Порошки</party_cat_name>
</item>
</categories>
<good_images>

334
 <item>
<photo_type>facing</photo_type>
<photo_date>2016-07-20T16:26:30+00:00</photo_date>
<photo_url>https://национальный-каталог.рф/i/med/63d3beae-b0be-
db33-f86b-65a0e37da584.jpg</photo_url>
<barcode>6437005056338</barcode>
</item>
</good_images>
<good_attrs>
<item>
<attr_id>18</attr_id>
<attr_name>Вес брутто</attr_name>
<attr_value>1.506</attr_value>
<value_id>7824938</value_id>
<attr_value_type>кг</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>19</attr_id>
<attr_name>Высота</attr_name>
<attr_value>29.2</attr_value>
<value_id>8214928</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>20</attr_id>
<attr_name>Глубина</attr_name>
<attr_value></attr_value>
<value_id>5325635</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>

335
 <location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>21</attr_id>
<attr_name>Ширина</attr_name>
<attr_value>20.7</attr_value>
<value_id>1224735</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>2503</attr_id>
<attr_name>Производитель</attr_name>
<attr_value_id>3408</attr_value>
<value_id>7812631</value_id>
<attr_value>ООО ООО</attr_value>
<attr_value_type></attr_value_type>
<attr_group_id>25</attr_group_id>
<attr_group_name>Стороны</attr_group_name>
<published_date>2017-12-10 15:35:08</published_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
</item>
<item>
<attr_id>2813</attr_id>
<attr_name>Единый реестр сертификатов соответствия</attr_name>
<attr_value>https://национальный-
каталог.рф/certificates/86F13A2714824C4B93545560F7D1CCC1</attr_value>
<value_id>1624735</value_id>
<attr_group_id>41</attr_group_id>
<attr_group_name>Сертификаты</attr_group_name>
<published_date>2017-12-15 17:14:01</published_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<certificate_number>С-RU.АЮ64.В.01026</certificate_number>
<certificate_issued_date>24.07.2017</certificate_issued_date>

<certificate_valid_until_date>23.07.2022</certificate_valid_until_date>
<certificate_applicant>Общество с ограниченной ответственностью
«Производственная компания «Севкабель»</certificate_applicant>
<certificate_manufacturer>Общество с ограниченной ответственностью
«Производственная компания «Севкабель»</certificate_manufacturer>
<certificate_product_description>Кабель судовой безгалогенный, не

336
распространяющий горение...</certificate_product_description>
</item>
</good_attrs>
</item>
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

2.2. Код 404 Если не найден продукт:

{
"error_message": "Данные не найдены"
}

10.10. Метод получения карточки товара, в том числе неопубликованной

карточки
Метод возвращает всю имеющуюся информацию о продукте, то есть все заполненные атрибуты
карточки товара независимо от статуса самой карточки, в отличие от метода product, который
возвращает информацию только по опубликованным карточкам. Требует обязательного указания
следующих параметров: идентификатор товара (goodId), код товара (штрих-код) и указание apikey
владельца товара.
Если указаны оба обязательных параметра, то возвращается результат выборки по good_id. При этом
код товара игнорируется.
Тип приватности: публичный.
URL: /nk/feed-product
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

good_id string - ID товара в каталоге Обязательно, если не указан gtin
gtin string - Код товара Обязательно, если не указан good_id

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода

337
Параметр Тип Обяз. Описание Комментарий
result [array] - Результат При наличии ответа
*identified_by [array] + массив содержащий
информацию о штрих-кодах
**value string + штрих-код или локальный
идентификатор
**type string + Тип идентификатора Возможные значения:
"gtin" — глобальный код товара
(штрих-код);
"barcode" — штрих-код Barcode
(штрихкод с неправильной
контрольной цифрой)
**party_id string - Идентификатор торговой сети возвращается только при
условии, что параметр type
имеет значение barcode.
**multiplier number + Количество товаров в Значение по умолчанию = 1
упаковке
**level string + Тип упаковки (уровень Возможные значения:
упаковки) "trade-unit" — штука;
"box" — коробка;
"layer" — слой на палете;
"pallet" — палета;
"metro-unit" — метро-юнит;
"show-pack" — шоу-пак;
"inner-pack" — спайка
*good_id number + Идентификатор товара
*good_name string + Наименование товара
*good_img string + Изображение товара
*good_status string + Статус карточки товара
*categories [array] + Массив категорий
**cat_id number + Идентификатор любой из
категорий товаров, в которой
расположен товар, исключая
родителей этой категории
**cat_name string + Наименование категории, в
которой расположен товар
и/или
**party_cat_id number + Идентификатор категории Только для владельца сети, если
торговой сети, в которой указан party_id в запросе
расположен товар
**party_cat_name string + Наименование категории
торговой сети, в которой
расположен товар
*party_brand_id string - Идентификатор бренда для Только для владельца сети, если
торговой сети указан party_id в запросе

338
Параметр Тип Обяз. Описание Комментарий
*brand_id number + Идентификатор товарного
знака
*brand_name string + Наименование бренда
*good_rating number + Рейтинг товара
*good_images array + Массив с изображениями
**photo_type string + тип фотографии Возможные значения:
"default" — фотография по
умолчанию (вид спереди);
"facing" — crop-фотография для
планограмм (обрезанная по
контуру товара);
"left" — фотография товара
слева;
"right" — фотография товара
справа;
"back" — фотография товара
сзади;
"3ds" — 3D серия;
"marketing" — коммерческая
фотография товара;
"ecommerce" — e-commerce
фото;
"undef" — single shot,
фотография товара с не
предопределенного ракурса;
"cubi" — фотография измерения
ВГХ
**photo_date string (date- + дата создания фотографии UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**photo_url [string] + ссылка на med (medium)
размер фотографии
**barcode string - штрихкод или артикул товара,
для которого сделана
фотография
*good_attrs array - Массив атрибутов Приватные атрибуты отдаются
только те, которые принадлежат
аккаунту apikey
**attr_id number + Идентификатор атрибута
**attr_name string + Наименование атрибута
**attr_value_id string - Идентификатор значения
атрибута
**attr_value string + Значение атрибута
**value_id number - Идентификатор значения
атрибута
**attr_value_type array[string] + Массив возможных значений

339
Параметр Тип Обяз. Описание Комментарий
типа атрибута
**attr_group_id number + Идентификатор группы, к
которой относится атрибут
**attr_group_name string + Наименование группы, к
которой относится атрибут
**measure_date string (date- - Дата измерения атрибута UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**published_date string (date- - Дата публикации атрибута UTC.yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**effective_date string (date- - Дата, с которой UTC. yyyy-MM-
time) действительно значение ddTHH:mm:ss.SSS’Z
атрибута
**expired_date string (date- - Дата, с которой UTC. yyyy-MM-
time) недействительно значение ddTHH:mm:ss.SSS’Z
атрибута
**location_id string - Идентификатор локации, в
которой было проведено
измерение
**party_location_id string - Внутренний идентификатор Отображается только компании,
локации для компании, в которой принадлежит локация
которой было проведено
измерение
**level string - Уровень упаковки
**gtin string - код товара (Штрих-код)
**multiplier number - Мультипликатор
**certificate_number string - номер сертификата Только у атрибутов из группы
"Сертификаты"
**certificate_issued_date string (date- - Дата начала срока действия yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
**certificate_valid_until_date string (date- - Дата окончания срока yyyy-MM-ddTHH:mm:ss.SSS’Z
time) действия
**certificate_applicant string - Заявитель
**certificate_manufacturer string - Изготовитель
**certificate_product_description string - Продукция
*good_reviews array + Массив с отзывами
**review_id number + идентификатор отзыва
**review_author string + автор (имя, фамилия,
псевдоним)
**review_rating number + рейтинг отзыва при наличии
**review_text string + текст отзыва

340
Параметр Тип Обяз. Описание Комментарий
**review_date string (date- + дата создания отзыва UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
**review_author_img string + ссылка на фотографию автора
**review_replies array - Массив с отзывами Если отзыв имеет ответы (т.е.
отзывы с review_parent_id
= review_id
данного/родительского отзыва)
***review_id number + идентификатор отзыва-ответа
***review_author string + автор (имя, фамилия,
псевдоним)
***review_rating number + рейтинг отзыва-ответа
***review_text string + текст отзыва-ответа
***review_date string (date- + дата создания отзыва UTC. yyyy-MM-
time) ddTHH:mm:ss.SSS’Z
***review_author_img string + ссылка на фотографию автора
*good_reviews_count number + Количество отзывов
*good_url string + Ссылка на страницу товара
*good_prices array + Массив цен на товар по
торговым сетям данного
аккаунта
**party_id number + Идентификатор торговой сети
**address array + Местонахождение
***country string + Название страны ISO 3166-2
***city string + Название города
***street string + Название улицы, дом
***location array + Координаты
* ***lat string + Географическая широта
* ***lon string + Географическая долгота

Пример запроса:
<url стенда>/nk/feed-product?apikey=XXX&gtin=0000000000000&format=xml

Пример ответа:
1 В случае успеха:
1.1. Для формата json:
{
"apiversion":3,
"result":[

341
 {
"good_id":720679,
"identified_by":[
{
"value":"4600494523007",
"type":"gtin",
"multiplier":1,
"level":"trade-unit"
},
{
"value":"4600494523007",
"type":"gtin",
"multiplier":1,
"level":"trade-unit"
}
],
"good_name":"Чешки детские",
"good_url":"https://staging.catalog.crpt.ru/product/4600494523007-ru-cheshki-
detskie",
"good_img":null,
"good_status":"draft",
"good_signed":false,
"good_mark_flag":false,
"good_turn_flag":false,
"producer_inn":null,
"producer_name":null,
"categories":[
{
"cat_id":30717,
"cat_name":"Обувь домашняя"
}
],
"brand_id":null,
"brand_name":null,
"good_rating":null,
"good_images":[

],
"good_attrs":[
{
"attr_id":2478,
"attr_name":"Полное наименование товара",
"attr_value":"Чешки детские",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":3793,
"attr_name":"Базовая единица измерения",
"attr_value":"ШТ",
"attr_value_type":null,
"attr_group_id":0,

342
 "attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":2630,
"attr_name":"Страна производства",
"attr_value":"RU",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13876,
"attr_name":"Бренд ORIGINAL",
"attr_value":"Котофей",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13898,
"attr_name":"Материал верха, %",
"attr_value":"ИСКУССТВЕННАЯ КОЖА",
"attr_value_type":"100",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13901,
"attr_name":"Материал подкладки, %",
"attr_value":"ТКАНЬ",
"attr_value_type":"100",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13904,
"attr_name":"Материал стельки,%",

343
 "attr_value":"ТКАНЬ",
"attr_value_type":"100",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13902,
"attr_name":"Материал низа/подошвы, %",
"attr_value":"КОЖА (БАРАНЬЯ)",
"attr_value_type":"100",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13905,
"attr_name":"Вид обуви",
"attr_value":"Чешки",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13886,
"attr_name":"Размер в штихмассовой системе",
"attr_value":"26",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":36,
"attr_name":"Цвет",
"attr_value":"БЕЛЫЙ",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},

344
{
"attr_id":3959,
"attr_name":"Группа ТНВЭД",
"attr_value":"6402",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":13933,
"attr_name":"Код ТНВЭД",
"attr_value":"11.11",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":3961,
"attr_name":"Группа ОКПД2",
"attr_value":"15.20.14",
"attr_value_type":null,
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":null,
"multiplier":null,
"level":""
},
{
"attr_id":2439,
"attr_name":"Ширина",
"attr_value":"10",
"attr_value_type":"см",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":"4600494523007",
"multiplier":null,
"level":"trade-unit"
},
{
"attr_id":2438,
"attr_name":"Глубина",
"attr_value":"35",
"attr_value_type":"см",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":"4600494523007",

345
 "multiplier":null,
"level":"trade-unit"
},
{
"attr_id":2437,
"attr_name":"Высота",
"attr_value":"5",
"attr_value_type":"кг",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":"4600494523007",
"multiplier":null,
"level":"trade-unit"
},
{
"attr_id":2440,
"attr_name":"Вес брутто",
"attr_value":"0.15",
"attr_value_type":"см",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":"4600494523007",
"multiplier":null,
"level":"trade-unit"
},
{
"attr_id":13756,
"attr_name":"Расчетный объем",
"attr_value":"1750",
"attr_value_type":"",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":"4600494523007",
"multiplier":null,
"level":"trade-unit"
},
{
"attr_id":4424,
"attr_name":"Краткое наименование товара",
"attr_value":"Чешки детские",
"attr_value_type":"",
"attr_group_id":0,
"attr_group_name":null,
"value_id":0,
"gtin":"4600494523007",
"multiplier":null,
"level":"trade-unit"
}
],
"good_reviews":[

],
"good_reviews_count":0,
"good_prices":[

346
 ]
}
]
}

1.2. Для формата xml:

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<item>
<identified_by>
<item>
<value>11033</value>
<type>gtin</type>
<multiplier>1</multiplier>
<good_id>672136</good_id>
<level>trade-unit</level>
</item>
<item>
<value>24823002000164</value>
<type>gtin</type>
<multiplier>12</multiplier>
<good_id>672136</good_id>
<level>box</level>
</item>
</identified_by>
<categories>
<item>
<cat_id>14786</cat_id>
<cat_name>Порошки</cat_name>
</item>
<item>
<party_cat_id>241000</party_cat_id>
<party_cat_name>Порошки</party_cat_name>
</item>
</categories>
<good_images>
<item>
<photo_type>facing</photo_type>
<photo_date>2016-07-20T16:26:30+00:00</photo_date>
<photo_url>https://национальный-каталог.рф/i/med/63d3beae-b0be-
db33-f86b-65a0e37da584.jpg</photo_url>
<barcode>6437005056338</barcode>
</item>
</good_images>
<good_attrs>
<item>
<attr_id>18</attr_id>
<attr_name>Вес брутто</attr_name>
<attr_value>1.506</attr_value>
<value_id>7824938</value_id>
<attr_value_type>кг</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>

347
 <measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>19</attr_id>
<attr_name>Высота</attr_name>
<attr_value>29.2</attr_value>
<value_id>8214928</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>20</attr_id>
<attr_name>Глубина</attr_name>
<attr_value></attr_value>
<value_id>5325635</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>
<expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>21</attr_id>
<attr_name>Ширина</attr_name>
<attr_value>20.7</attr_value>
<value_id>1224735</value_id>
<attr_value_type>см</attr_value_type>
<attr_group_id>19</attr_group_id>
<attr_group_name>Cubiscan-атрибуты</attr_group_name>
<measure_date>2018-02-01T16:39:04+00:00</measure_date>
<published_date>2018-02-03T13:22:11+00:00</published_date>
<effective_date>2018-02-05T16:39:04+00:00</effective_date>

348
 <expired_date>2018-08-05T16:39:04+00:00</expired_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<level>trade-unit</level>
<gtin>4011200255905</gtin>
<multiplier>1.00</multiplier>
</item>
<item>
<attr_id>2503</attr_id>
<attr_name>Производитель</attr_name>
<attr_value_id>3408</attr_value>
<value_id>7812631</value_id>
<attr_value>ООО ООО</attr_value>
<attr_value_type></attr_value_type>
<attr_group_id>25</attr_group_id>
<attr_group_name>Стороны</attr_group_name>
<published_date>2017-12-10 15:35:08</published_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
</item>
<item>
<attr_id>2813</attr_id>
<attr_name>Единый реестр сертификатов соответствия</attr_name>
<attr_value>https://национальный-
каталог.рф/certificates/86F13A2714824C4B93545560F7D1CCC1</attr_value>
<value_id>1624735</value_id>
<attr_group_id>41</attr_group_id>
<attr_group_name>Сертификаты</attr_group_name>
<published_date>2017-12-15 17:14:01</published_date>
<location_id>532</location_id>
<party_location_id>Store #53</party_location_id>
<certificate_number>С-RU.АЮ64.В.01026</certificate_number>
<certificate_issued_date>24.07.2017</certificate_issued_date>

<certificate_valid_until_date>23.07.2022</certificate_valid_until_date>
<certificate_applicant>Общество с ограниченной ответственностью
«Производственная компания «Севкабель»</certificate_applicant>
<certificate_manufacturer>Общество с ограниченной ответственностью
«Производственная компания «Севкабель»</certificate_manufacturer>
<certificate_product_description>Кабель судовой безгалогенный, не
распространяющий горение...</certificate_product_description>
</item>
</good_attrs>
</item>
</result>
</root>

10.11. Метод подписи карточки товара

Метод предназначен для подписи карточки товара или нескольких карточек с помощью сертификата
в формате PKCS#7. Отличается от метода "Метода получения массива ID прошедших валидацию
товаров" (/nk/feed-product-sign) тем, что из содержимого карточки товара в формате XML
исключается подпись, которая при использовании текущего метода передается отдельным
параметром в запросе. Данные кодируются в BASE64.

349
URL: /nk/feed-product-sign-pkcs
Метод: POST
Тип приватности: приватный.
Пример строки запроса:
curl -X POST "<url стенда>/nk/feed-product-sign-pkcs?apikey=<apikey>"&format=xml"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "[{\"goodId\":0,\"base64Xml\":\"string\",\"signature\":\"string\"}]"

Пример тела запроса:

[
{
"goodId":3,
"base64Xml":"...",
"signature":"..."
},
{
"goodId":3119690,
"base64Xml":"...",
"signature":"..."
},
{
"goodId":521,
"base64Xml":"...",
"signature":"..."
}
]

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

goodId integer + Идентификатор товара в "Национальный каталог" Максимальное число
(int64) идентификаторов в одном запросе:
25
base64Xml string + Карточка товара в формате XML, закодированная в
BASE64
signature string + Открепленная подпись, закодированная в BASE64,
соответствующая типу CAdES в формате PKCS#7

Пример ответа:
{
"apiversion": 3,
"result":{
"signed":[
3,
3
],

350
 "errors":[
{
"goodId":1,
"message":"Товар goodId: 1 не готов к подписанию"
}
]
}
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Версия API
result object + Результат При наличии ответа
*signed array[number] - Массив числовых идентификаторов товаров, для которых
прошла валидация карточки товара, товар переведен в
статус "Опубликован"
*errors array[string] - Массив объектов, содержащих идентификаторы товара и Параметр возвращается
текст ошибки, возникшей при обработке переданных XML при наличии ошибки
(закодированных в BASE64)
**goodId integer (int64) + Идентификатор товара в КМТ
**message string + Текст ошибки Возвращается в случае
ошибки

Примечание: ответе возвращается до 25 объектов, иначе возвращается ошибка 400.

10.12. Метод получения XML товаров по массиву ID товаров или коду товара
Метод предназначен для получения XML товаров для подписи по goodId или коду товара. При
отправке массива ID товаров либо массива строк кодов товаров в ответе возвращается массив XML
товаров для подписания и (при наличии) массив объектов с информацией об ошибках при отсутствии
товаров по ID/коду товара.
Ограничения:
• Количество товаров в запросе - не более 25.
Тип приватности: публичный.
URL: /nk/feed-product-document
Метод: POST
Content-Type: application/json
Параметры тела запроса:

351
Параметр Тип Обяз. Описание Комментарий
goodIds array[number] - Массив ID товаров Обязательно, если не указан gtins
gtins array[string] - Массив строк кодов товаров Обязательно, если не указан goodIds
publicationAgreement boolean - Согласие на публикацию true/1 - согласны, false/0 - не согласны. При
товаров на сайте отсутствии данного параметра будет
национальный-каталог.рф выставлено значение по умолчанию - "Не
согласен".

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result array - Результат При наличии ответа
*xmls array + Массив XML товаров для подписания
**goodId number + Идентификатор товара в "Национальном
каталоге"
**xml string + XML товара для подписания
*errors array + Массив ошибок по каждому товару
**goodId number + Идентификатор товара в "Национальном
каталоге"
*gtin string + Код товара
*message string + Текст ошибки Также при не нахождении товара по коду
товара

Пример запроса:
POST <url стенда>/nk/feed-product-document?apikey=XXX
Content-Type: application/json; charset=utf-8
{
"goodIds": [
123, 234, 345
],
"gtins": [
"4612312312312", "123123123123"
],
"publicationAgreement": false
}

Пример ответа:
1 В случае успеха:
{
"apiversion": 3,
"result": [
{

352
 "xmls": [
{
"goodId": 123,
"xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>..."
},
{
"goodId": 234,
"xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>..."
}
],
"errors": [
{
"goodId": 345,
"message": "Информация о товаре ... устарела или скомпрометирована.
Попробуйте еще раз."
},
{
"GTIN": "123123123123",
"message": "Не удалось получить товар по GTIN"
}
]
}
]
}

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

2.2. Код 413 Если больше 25 запрашиваемых идентификаторов в теле запроса:

{
"error_message": "Слишком большой запрос"
}

10.13. Метод получения массива ID прошедших валидацию товаров

Метод принимает массив объектов, в объектах содержатся good_id товара и подписанный XML для
этого товара.
Ограничения:
• Количество товаров в запросе - не более 25.
Тип приватности: публичный.
URL: /nk/feed-product-sign
Метод: POST
Content-Type: application/json

353
Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

array + Массив подписанных XML товаров
goodId number + Идентификатор товара в "Национальном каталоге", для которого передаётся
XML
xml string + Подписанный XML товара

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result array - Результат При наличии ответа
*signed array[number] + Массив ID товаров, XML для которых прошли При наличии успешно
валидацию, были сохранены, и товар переведен в провалидированных товаров
статус "Опубликован"
*errors array + Массив ошибок по каждому товару Параметр возвращается при
наличии ошибки
**goodId number + Идентификатор товара в "Национальном каталоге"
**message string + Текст ошибки

Пример запроса:
POST <url стенда>/nk/feed-product-sign?apikey=XXX
Content-Type: application/json; charset=utf-8
[
{
"goodId": 5000,
"xml": "<?xml version="1.0" encoding="UTF-8"?>..."
},
{
"goodId": 3,
"xml": "<?xml version="1.0" encoding="UTF-8"?>..."
},
{
"goodId": 5,
"xml": "<?xml version="1.0" encoding="UTF-8"?>..."
}
]

Пример ответа:
1 В случае успеха:
{
"apiversion": 3,
"result": {
"signed": [

354
 5000,
3
],
"errors": [
{
"goodId": 5,
"message": "Информация о товаре ... устарела или скомпрометирована. Попробуйте
еще раз. "
}
]
}
}

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

10.14. Метод получения списка всех принадлежащих одному владельцу товаров

Метод возвращает список всех товаров, принадлежащих определенному владельцу, вместе с хешем
содержания страницы. Предназначен для получения списка хешей, сравнения с локальным
хранилищем и обновления информации по товарам (см. "Метод получения полной информации о
товаре") для которых хеш изменился (есть новые данные). Таким образом возможно выявить товары,
в карточки которых были внесены изменения. Метод возвращает список товаров и их хеши по
заданным фильтрам. Если не указан ни один из необязательных параметров, в ответе будут
возвращаться записи из всего списка товаров.
URL: /nk/etagslist
Метод: GET
Тип приватности: приватный.
Пример запроса:
curl -X GET "<url
стенда>/nk/etagslist?apikey=<APIKEY>&format=json&brand_id="string"&owner_id="string"&ca
t_id="string"&offset=1"
-H "accept: application/json"

Пример запроса:
curl -X GET "<url
стенда>/nk/etagslist?apikey=<APIKEY>&format=json&brand_id="string"&owner_id="string"&ca
t_id="string"&offset=1"
-H "accept: application/json"

Параметры запроса:

355
Параметр Тип Обяз. Описание Комментарий
brand_id string - Идентификатор товарного знака
owner_id string - Идентификатор аккаунта владельца товаров
cat_id string - Идентификатор любой из категорий товаров
offset integer - Смещение относительно начала списка выдачи

Примечание: должен быть указан минимум один параметр запроса.

Пример ответа:
{
"apiversion":3,
"result":{
"goods_count":100,
"offset":0,
"last_product_number":100,
"goods":[
{
"good_id":3,
"etag":"32b3502ff24f7c30"
},
{
"good_id":4,
"etag":"8529021f8808aaa9"
},
{
"good_id":5,
"etag":"4c23e42d0384a622"
}
]
}
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result object + Результат При наличии ответа
goods_count integer + Число товаров в текущем ответе
(int64)
offset integer + Смещение относительно начала списка
(int64) выдачи
last_product_number integer + Номер последнего показанного товара
(int64) относительно начала списка выдачи
goods array + Массив товаров и их хешей В одном ответе может
содержаться не более 100 товаров
*good_id integer + Идентификатор товара

356
Параметр Тип Обяз. Описание Комментарий
(int64)
*etag string + Хеш
<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<goods_count>100</goods_count>
<offset>0</offset>
<last_product_number>100</last_product_number>
<goods>
<item>
<good_id>3</good_id>
<etag>32b3502ff24f7c30</etag>
</item>
<item>
<good_id>4</good_id>
<etag>8529021f8808aaa9</etag>
</item>
<item>
<good_id>5</good_id>
<etag>4c23e42d0384a622</etag>
</item>
</goods>
</result>
</root>

10.15. Метод изменения размера изображения с заполнением недостающих полей

белым цветом
Метод предназначен для пропорционального изменения размера изображения с заполнением
недостающих полей белым цветом. При отправке данных об изображении в ответе возвращается
JPEG изменённого изображения.
Тип приватности: Публичный.
URL: /nk/image
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

apikey string + Параметр, необходимый для Предоставляется системой национального
авторизации и совершения запросов API каталога по индивидуальной заявке
name string - Полный URI изображения
width string - Ширина рисунка на выходе в пикселях Должен быть в границах [100,
1000](результирующая ширина в пикселях)
height string - Высота рисунка на выходе в пикселях Должен быть в границах [100,

357
Параметр Тип Обяз. Описание Комментарий
1000](результирующая высота в пикселях)
no- string - Параметр добавления белого фона к Возможные значения:
background рисунку для соблюдения размеров "1" - фон не добавлять;
"0" - фон добавлять (значение по умолчанию)

Параметры ответа:
изображение изменённого размера
Пример запроса:
<url стенда>/nk/image?apikey=XXX&name=https://национальный-
каталог.рф/i/300x200/5a7eb614-13d3-69ed-caf7-420624d1bdd3.jpg&width=300&height=400

Пример ответа:
1 В случае успеха:
изображение изменённого размера
2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

10.16. Метод генерации черновиков кодов товаров

Метод предназначен для генерации и получения списка черновиков кодов товаров. При отправке
числа новых кодов товаров и (при необходимости) ключа поставщика/производителя товаров в ответе
возвращается число доступных в течение месяца для генерации кодов товаров, число уже
сгенерированных кодов товаров, список новых кодов товаров.
Тип приватности: публичный.
URL: /nk/generate-gtins
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

quantity string + Количество новых обязателен при запросе генерации новых черновиков gtin
черновиков кодов товаров,
которые нужно сгенерировать
exist boolean - признак, обозначающий принимает значения 1/0 (true/false)
запрос уже сгенерированных

358
Параметр Тип Обяз. Описание Комментарий
и имеющихся в базе
пользователя gtin
supplier_key string - "api-key" поставщика или При выставлении данного параметра генерируется
производителя товаров карточка товара поставщика/производителя товаров
(GTIN) в КМТ. При этом используется GCP\GLN
организации поставщика\производителя товаров

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result array - Результат При наличии ответа
*monthly- object + Ежемесячное ограничение
limit
**limit number + Общее количество черновиков кодов товаров, доступных
для генерации в течение одного месяца
**usage number + Количество черновиков кодов товаров, которые уже
были сгенерированы в течение этого месяца
*drafts array + Список черновиков При наличии
сгенерированных черновиков
**gtin string + код товара, который был сгенерированы

Пример запроса генерации новых черновиков gtin:

<url стенда>/nk/generate-gtins?apikey=XXX&quantity=3

Пример запроса генерации новых черновиков gtin от имени поставщика контента или
лаборатории:
<url стенда>/nk/generate-gtins?apikey=XXX&quantity=3&supplier_key=YYY

Пример запроса, возвращающий уже имеющиеся черновики gtin:

<url стенда>/nk/generate-gtins?apikey=XXX&exist=1

Пример ответа:
1 В случае успеха:
1.2 Пример ответа json
{
"apiversion": 3,
"result": {
"monthly-limit": {
"limit": 100,
"usage": 6

359
 },
"drafts": [
{
"gtin": "4600002575689"
},
{
"gtin": "4600002575696"
},
{
"gtin": "4600002575702"
}
]
}
}

1.2 Пример ответа xml

<root>
<apiversion>3</apiversion>
<result>
<monthly-limit>
<limit>100</limit>
<usage>6</usage>
</monthly-limit>
<drafts>
<gtin>4600002575689</gtin>
<gtin>4600002575696</gtin>
<gtin>4600002575702</gtin>
</drafts>
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

10.17. Метод создания и обновления товаров

Метод предназначен для получения идентификатора фида созданных/обновлённых товаров с
указанием json/xml формата фида. При отправке массива данных о товарах, которые нужно создать
либо обновить (указывается ID товаров) с возможностью указать ключ поставщика/производителя
товара, в ответе возвращается ID фида созданных/обновлённых товаров либо сообщение об ошибке
(при наличии).
Ограничения:
• Размер фида - 25 МБ;
• Количество товаров в фиде - 5000.
Тип приватности: Публичный.

360
URL: /nk/feed
Метод: POST
"Content-Type: application/xml", если фид в формате xml;
"Content-Type: application/json", если фид в формате json.
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

supplier_key string - Ключ поставщика или производителя "api-key" поставщика или производителя
товаров товаров

Примечание - Для изменения существующего товара должно быть передано значение его
идентификатора good_id. Если параметра good_id нет, товар определяется как новый. Для нового
товара обязательным является параметр good_name и gtin.
Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

@id string - идентификатор entry,
который лаборатория может
задать для более конкретной
идентификации ответа
good_id number - идентификатор товара Обязательно при обновлении товара
gtin string - идентификатор в обязательный для нового товара
Национальном каталоге
товаров, код товара
is_tech_gtin boolean - признак создания карточки принимает значения 1/0 (true/false).
товара с техническим кодом обязателен при создании карточки товара с
товара техническим кодом товара, в этом случае код
товара в энтри не указывается
is_kit boolean - признак создания карточки принимает значения 1/0 (true/false).
товара с техническим кодом Обязателен при создании карточки товара с
товара техническим кодом товара, в этом случае код
товара в энтри не указывается
good_name string - наименование товара Обязательно при создании товара
tnved string - ТН ВЭД Обязательно для нового товара
brand string - торговая марка товара Обязательно для нового товара
moderation boolean - признак того, что товар надо Возможные значения:
отправлять на модерацию true - требуется модерация;
false - модерация не требуется
identified_by array - массив идентификаторов если создается карточка товара с кодом
товара, относящимся к упаковке типа trade-
unit, то массив идентификаторов обязательно
должен включать, как минимум,

361
Параметр Тип Обяз. Описание Комментарий
идентификатор данного вида упаковки
*type string + Тип идентификатора Возможные значения:
"gtin" — глобальный код товара (штрих-код)
*value string + Значение идентификатора
*level string + Тип упаковки (уровень Возможные значения:
упаковки) "trade-unit" — штука;
"box" — коробка;
"layer" — слой на палете;
"pallet" — палета;
"metro-unit" — метро-юнит;
"show-pack" — шоу-пак;
"inner-pack" — спайка
**attr_id number - идентификатор атрибута Обязателен для всех типов упаковки, кроме
trade-unit
**attr_value number - значение атрибута Указывается код упаковки предыдущего
уровня Обязателен для всех типов упаковки,
кроме trade-unit
*multiplier number + Количество в упаковке Значение по умолчанию = 1
*party_id string - Идентификатор торговой Необязательно при типе gtin, обязательно при
сети других типах
*unit string - Тип измерений Возможные значения:
"кг" — килограмм;
"шт" — штука
categories array[number] - массив идентификаторов
категорий
good_attrs array - массив атрибутов
attr_value_id number - Идентификатор значения Обязательный для обновления
атрибута существующих атрибутов товара
*attr_id number + Идентификатор атрибута Обязательный при создании товара
*attr_value string - Значение атрибута обязательный при создании товара;
необязательный при редактировании и
удалении
*attr_value_type array[string] - Массив возможных
значений типа атрибута
*gtin string - код товара (Штрих-код)
*delete number - Признак удаления товара Со значением 1 - удаление атрибута товара.
Доступно только при редактировании
существующего товара. При передаче
данного параметра обязательно указать
attr_value_id
good_images array - массив изображений
*photo_type string + тип изображения Возможные значения:
"default" — фотография по умолчанию (вид

362
Параметр Тип Обяз. Описание Комментарий
спереди);
"facing" — crop-фотография для планограмм
(обрезанная по контуру товара);
"7" — фотография товара слева;
"19" — фотография товара справа;
"13" — фотография товара сзади;
"si1" — фотография товара сверху;
"si2" — фотография товара снизу;
"si3" — фотография товара в упаковке;
"si4" — фотография товара без упаковки;
"si5" — фотография товара внутри упаковки;
"3ds" — 3D серия;
"marketing" — коммерческая фотография
товара;
"text" — фотография текста на товаре;
"ecommerce" — e-commerce фото;
"undef" — single shot, фотография товара с
непредопределенного ракурса;
"cubi" — фотография измерения ВГХ
photo_url string либо + url либо массив url Массив url указывается при photo_type=3ds
array[string]
identifier string - идентификатор заданного значение gtin/barcode. Используется для связи
типа фотографий с идентификаторами товара
identifier_type string - тип идентификатора Обязательно при наличии identifier.
Возможные значения:
"gtin" — глобальный штрих-код кода товара;
"barcode" — штрих-код Barcode (штрихкод с
неправильной контрольной цифрой)
identifier_party_id number - идентификатор торговой Необязательно при identifier_type=gtin,
сети обязательно при других типах

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API метода
result array - Результат При наличии ответа
*feed_id number + Идентификатор фида

Пример запроса:
POST <url стенда>/nk/feed?apikey=XXX&supplier_key=YYY
Content-Type: application/json; charset=utf-8

Примеры тела запроса

Создание карточки товара с кодом потребительской упаковки

363
[
{
"gtin": "469518017278",
"tnved": "3303",
"brand": "Nivea Men",
"categories": [30570],
"good_name": "Полное наименование товара",
"identified_by":
[
{
"value": "469518017278",
"type": "gtin",
"multiplier": 1,
"level": "trade-unit",
"unit":"кг"
}
],

"good_attrs": [
{
"attr_id": 2630,
"attr_value": "RU"
},
{
"attr_id": 2501,
"attr_value": "ДА",
"attr_value_type": "кг"
}
]
}
]

Создание карточки товара с кодом упаковок разного уровня (с вложениями)

[
{
"gtin": "469518017278",
"tnved": "3303",
"brand": "Nivea Men",
"categories": [30570],
"good_name": "Полное наименование товара",
"identified_by":
[
{
"value": "469518017278",
"type": "gtin",
"multiplier": 1,
"level": "trade-unit",
"unit":"шт"
},
{
"value": "469518017308",
"type": "gtin",
"multiplier": 10,
"level": "box",
"unit":"шт"

364
 },
{
"value": "469518017360",
"type": "gtin",
"multiplier": 100,
"level": "pallet",
"unit":"шт"
}
],

"good_attrs": [
{
"attr_id": 13763,
"attr_type": "gtin",
"attr_value": "469518017308",
"gtin": "469518017360"
},
{
"attr_id": 13763,
"attr_type": "gtin",
"attr_value": "469518017278",
"gtin": "469518017308"
}
]
}
]

Создание карточки товара с техническим кодом товара

[
{
"is_tech_gtin": 1,
"tnved": "3303",
"brand": "Nivea Men",
"good_name": "Полное наименование товара",
"good_attrs": [
{
"attr_id": 2630,
"attr_value": "RU"
},
{
"attr_id": 2501,
"attr_value": "ДА",
"attr_value_type": "кг"
}
]
}
]

Создание нового товара JSON

[
{
"@id": "12",
"gtin": "4600000000015",
"tnved": "3303",
"brand": "brand_name",

365
 "categories": [1],
"good_name": "Шоколад с Цельным Миндалём 55% 90г 14шт шоу-бокс",
"identified_by": [
{
"value": "4600000000015",
"type": "gtin",
"multiplier": 1,
"level": "trade-unit",
"unit":"кг"
},
{

"value": "4607065373085",
"type": "gtin",
"multiplier": 10,
"level": "box",
"unit":"кг"
}
],
"good_images": [
{
"photo_type": "default",
"photo_url": "https://your-site-name.com/photo.jpg",
"identifier": "4600000000015",
"identifier_type": "gtin",
"identifier_party_id": 2
},
{
"photo_type": "3ds",
"photo_url": [
"https://your-site-name.com/photo-1.jpg",
"https://your-site-name.com/photo-2.jpg"
]
}
],
"good_attrs": [
{
"attr_id": 2630,
"attr_value": "RU",
"gtin":"4607065373089"
},
{
"attr_id": 2501,
"attr_value": "ДА",
"attr_value_type": "кг"
}
]
}
]

Создание нового товара xml

<?xml version="1.0" encoding="UTF-8"?>
<entries>
<entry id="12">
<gtin>4600000000015</gtin>
<tnved>3303</tnved>

366
 <brand>brand_name</brand>
<good_name>Йогурт легкий. Злаки + чернослив</good_name>
<identified_by>
<item>
<value>4600000000015</value>
<type>gtin</type>
<multiplier>1</multiplier>
<level>trade-unit</level>
<unit>кг</unit>
</item>
<item>
<value>4607065373085</value>
<type>gtin</type>
<multiplier>10</multiplier>
<level>box</level>
<unit>кг</unit>
</item>
</identified_by>
<categories>
<item>
1
</item>
</categories>
<good_images>
<item>
<photo_type>default</photo_type>
<photo_url>https://your-site-name.com/photo.jpg</photo_url>
<identifier>4600000000015</identifier>
<identifier_type>gtin</identifier_type>
<identifier_party_id>2</identifier_party_id>
</item>
<item>
<photo_type>3ds</photo_type>
<photo_url>
<item>https://your-site-name.com/photo.jpg</item>
<item>https://your-site-name.com/photo.jpg</item>
</photo_url>
</item>
</good_images>
<good_attrs>
<item>
<attr_id>2630</attr_id>
<attr_value>RU</attr_value>
<gtin>490122000021</gtin>
</item>
<item>
<attr_id>2501</attr_id>
<attr_value>RU</attr_value>
<attr_value_type>кг</attr_value_type>
</item>
</good_attrs>
</entry>
</entries>

Обновление существующего товара JSON

367
[
{
"@id": "13",
"good_id": 1939447,
"gtin": "4600000000015",
"identified_by": [
{
"value": "4607065373092",
"type": "gtin",
"multiplier": 1,
"level": "trade-unit"
}
],
"good_attrs": [
{
"attr_id": 5,
"attr_value": "46%"
},
{
"attr_id": 4540,
"attr_value": "ДА",
"attr_value_id": 12742580
},
{
"attr_id": 4424,
"attr_value_id": 12183715,
"delete": 1
}
]
}
]

Обновление существующего товара xml

<?xml version="1.0" encoding="UTF-8"?>
<entries>
<entry id="13">
<good_id>1939447</good_id>
<gtin>4600000000015</gtin>
<identified_by>
<item>
<value>4607065373092</value>
<type>gtin</type>
<multiplier>1</multiplier>
<level>trade-unit</level>
</item>
</identified_by>
<good_images>
<item>
<photo_type>default</photo_type>
<photo_url>https://your-site-name.com/photo.jpg</photo_url>
</item>
</good_images>
<good_attrs>
<item>
<attr_id>5</attr_id>

368
 <attr_value>46%</attr_value>
</item>
<item>
<attr_id>4540</attr_id>
<attr_value>ДА</attr_value>
<attr_value_id>12742580</attr_value_id>
</item>
<item>
<attr_id>4424</attr_id>
<attr_value_id>12183715</attr_value_id>
<delete>1</delete>
</item>
</good_attrs>
</entry>
</entries>

Пример ответа:
1 В случае успеха:
1.1 Пример ответа json
{
"apiversion": 3,
"result": {
"feed_id": 2131
}
}

1.2 Пример ответа xml

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<feed_id>2131</feed_id>
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

2.2. Код 413 Если слишком большое тело запроса:

{
"error_message": "Слишком большой запрос"
}

10.18. Метод получения статуса фида по ID фида от его заказчика

Метод предназначен для проверки статуса ранее отправленного пакета обновлений (фида). Результат
возможно получить только для тех фидов, которые были отправлены компанией (лабораторией).
369
Тип приватности: Публичный.
URL: /nk/feed-status
Метод: GET
Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

feed_id string + Идентификатор фида
supplier_key string - api_key аккаунта Предназначен для лабораторий и других поставщиков контента,
владельца товаров которые от имени владельца товаров размещают карточки
товаров в его аккаунте

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Номер версии API
метода
result array - Результат При наличии ответа
*feed_id number + Идентификатор фида
*status_id number + Идентификатор статуса Возможные значения: 0 — запрос не принят;
фида 1 — запрос получен, данные на модерации;
2 — товары прошли модерацию;
3 — одобренные модератором товары подписаны
*status string + Статус фида Возможные значения: Rejected — запрос не принят;
Received — запрос получен, данные на модерации;
Moderated — товары прошли модерацию;
Signed — одобренные модератором товары подписаны
*received_at string + Время создания фида В формате yyyy-MM-ddTHH:mm:ss.SSS’Z
*status_updated_at string + Время перехода фида в yyyy-MM-ddTHH:mm:ss.SSS’Z
(date- текущий статус
time)
*result array - Ошибки при валидации
контента
*item array - Список При наличии сообщения. Структура каждого
дополнительных сообщения:
сообщений gtin — глобальный штрих-код к которому относится
сообщение. Если связанного штрих-кода нет, то
значение null;
good_id — идентификатор товара в каталоге, к
которому относится сообщение. Если связанного
товара нет, то значение null;
attribute_id — идентификатор атрибута в каталоге, к
которому относится сообщение. Если связанного
атрибута нет, то значение null;
attribute_name — название атрибута в каталоге, к

370
Параметр Тип Обяз. Описание Комментарий
которому относится сообщение. Значение может не
передаваться;
status_code — числовой код ошибки;
status_message — текст статуса;
message — текст сообщения
*totalErrors number - Общее количество
ошибок
*commonError string - Общая ошибка при
разборе информации

Пример запроса:
<url стенда>/nk/feed-status?apikey=XXX&feed_id=7126

1 Примеры успешных ответов

1.1 Пример ответа успешно разобранной информации JSON:
{
"apiversion":3,
"result": {
"feed_id": 7126,
"status_id": 1,
"status": "Received",
"received_at":"2018-08-13T17:03:40Z",
"status_updated_at":"2018-08-14T12:03:40Z"
}
}

1.2 Пример успешно разобранной информации xml

<root>
<apiversion>3</apiversion>
<result>
<feed_id>7126</feed_id>
<status_id>1</status_id>
<status>Received</status>
<received_at>2018-08-13T17:03:40Z</received_at>
<status_updated_at>2018-08-14T12:03:40Z</status_updated_at>
</result>
</root>

1.3 Пример на этапе модерации JSON

{
"apiversion": 3,
"result": {
"feed_id": 66707,
"status": "Moderated",
"status_id": 2,
"received_at": "2019-10-02T13:42:23Z",
"status_updated_at": "2019-10-02T13:51:35Z",

371
"item": [
{
"gtin": null,
"good_id": null,
"attribute_id": 2716,
"attribute_name": "Заявленный объем",
"status_code": 5,
"status_message": "Отменено",
"message": "Неверный объем"
},
{
"gtin": null,
"good_id": null,
"attribute_id": 2716,
"attribute_name": "Заявленный объем",
"status_code": 5,
"status_message": "Отменено",
"message": "Неверный объем"
},
{
"gtin": "4650065317337",
"good_id": 789817,
"attribute_id": 2716,
"attribute_name": "Заявленный объем",
"status_code": 5,
"status_message": "Отменено",
"message": "Неверный объем"
},
{
"gtin": "4650065317337",
"good_id": 789817,
"attribute_id": 2716,
"attribute_name": "Заявленный объем",
"status_code": 5,
"status_message": "Отменено",
"message": "Неверный объем"
},
{
"gtin": "4650065317337",
"good_id": 789817,
"attribute_id": 2716,
"attribute_name": "Заявленный объем",
"status_code": 5,
"status_message": "Отменено",
"message": "Неверный объем"
},
{
"gtin": "4650065317337",
"good_id": 789817,
"attribute_id": 2716,
"attribute_name": "Заявленный объем",
"status_code": 5,
"status_message": "Отменено",
"message": "Неверный объем"
},
{
"gtin": null,

372
 "good_id": null,
"attribute_id": 13918,
"attribute_name": "Селектив",
"status_code": 5,
"status_message": "Отменено",
"message": "Ошибка"
},
{
"gtin": null,
"good_id": null,
"attribute_id": 13918,
"attribute_name": "Селектив",
"status_code": 5,
"status_message": "Отменено",
"message": "Ошибка"
},
{
"gtin": "4650065317337",
"good_id": 789817,
"attribute_id": 13918,
"attribute_name": "Селектив",
"status_code": 5,
"status_message": "Отменено",
"message": "Ошибка"
},
{
"gtin": "4650065317337",
"good_id": 789817,
"attribute_id": 13918,
"attribute_name": "Селектив",
"status_code": 5,
"status_message": "Отменено",
"message": "Ошибка"
},
{
"gtin": "4650065317337",
"good_id": 789817,
"attribute_id": 13918,
"attribute_name": "Селектив",
"status_code": 5,
"status_message": "Отменено",
"message": "Ошибка"
}
]
}
}

1.4 Пример на этапе модерации xml

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<feed_id>66707</feed_id>
<status>Moderated</status>
<status_id>2</status_id>
<received_at>2019-10-02T13:42:23Z</received_at>

373
<status_updated_at>2019-10-02T13:51:35Z</status_updated_at>
<item>
<item>
<gtin/>
<good_id/>
<attribute_id>2716</attribute_id>
<attribute_name>Заявленный объем</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Неверный объем</message>
</item>
<item>
<gtin/>
<good_id/>
<attribute_id>2716</attribute_id>
<attribute_name>Заявленный объем</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Неверный объем</message>
</item>
<item>
<gtin>4650065317337</gtin>
<good_id>789817</good_id>
<attribute_id>2716</attribute_id>
<attribute_name>Заявленный объем</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Неверный объем</message>
</item>
<item>
<gtin>4650065317337</gtin>
<good_id>789817</good_id>
<attribute_id>2716</attribute_id>
<attribute_name>Заявленный объем</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Неверный объем</message>
</item>
<item>
<gtin>4650065317337</gtin>
<good_id>789817</good_id>
<attribute_id>2716</attribute_id>
<attribute_name>Заявленный объем</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Неверный объем</message>
</item>
<item>
<gtin>4650065317337</gtin>
<good_id>789817</good_id>
<attribute_id>2716</attribute_id>
<attribute_name>Заявленный объем</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Неверный объем</message>
</item>
<item>

374
 <gtin/>
<good_id/>
<attribute_id>13918</attribute_id>
<attribute_name>Селектив</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Ошибка</message>
</item>
<item>
<gtin/>
<good_id/>
<attribute_id>13918</attribute_id>
<attribute_name>Селектив</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Ошибка</message>
</item>
<item>
<gtin>4650065317337</gtin>
<good_id>789817</good_id>
<attribute_id>13918</attribute_id>
<attribute_name>Селектив</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Ошибка</message>
</item>
<item>
<gtin>4650065317337</gtin>
<good_id>789817</good_id>
<attribute_id>13918</attribute_id>
<attribute_name>Селектив</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Ошибка</message>
</item>
<item>
<gtin>4650065317337</gtin>
<good_id>789817</good_id>
<attribute_id>13918</attribute_id>
<attribute_name>Селектив</attribute_name>
<status_code>5</status_code>
<status_message>Отменено</status_message>
<message>Ошибка</message>
</item>
</item>
</result>
</root>

1.5 Пример отклоненной информации JSON

{
"apiversion": 3,
"result": {
"feed_id": 7126,
"status_id": 0,
"status": "Rejected",
"received_at": "2018-12-06T13:03:20Z",

375
 "status_updated_at": "2018-12-06T13:03:30Z",
"result": {
"0": [
"GTIN 4600002576143 используется другим товаром"
],
"totalErrors": "1",
"commonError": ""
}
}
}

1.6 Пример отклоненной информации xml

<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<feed_id>7126</feed_id>
<status_id>0</status_id>
<status>Rejected</status>
<received_at>2018-08-13T17:03:40Z</received_at>
<status_updated_at>2018-08-14T12:03:40Z</status_updated_at>
<result>
<item>GTIN 4600002576075 используется другим товаром</item>
<item>Атрибут #44 недоступен для редактирования</item>
</result>
<totalErrors>2</totalErrors>
<commonError/>
</result>
</root>

2 В случае ошибок:
2.1. Код 403 Если указан неправильный ключ API:
{
"error_message": "Отсутствует доступ к ресурсу"
}

2.2. Код 404 Если не найдена карточка продукта:

{
"error_message": "Данные не найдены"
}

2.3. Код 400 При отсутствии параметра feed_id:

{
"error_message": "Отсутствует обязательный параметр: feed_id"
}

2.4. Код 400 При недопустимом значении параметра feed_id:

{
"error_message": "Ошибка в параметрах запроса"
}

376
2.5. Код 403 При указании feed_id, не принадлежащего пользователю:
{
"error_message": "Отсутствует доступ к ресурсу"
}

10.19. Метод отправки на модерацию карточки товаров в статусе "Черновик"

Метод отправляет на модерацию, для указанных в запросе good_id или код товара+ИНН, созданные
ранее карточки товаров в статусе "Черновик"
Тип приватности: Публичный.
URL: /nk/feed-moderation
Если указаны более одного из обязательных параметров, то возвращается результат выборки,
соответствующий данному алгоритму:
• good_id - при указании возвращается товар с соответствующим идентификатором или ошибка
404. При этом код товара+inn игнорируются.
• gtin+inn - при указании возвращается товар с соответствующим кодом товара для inn или
ошибка 404.
Метод: GET
Параметры запроса:

Параметр Тип Обяз Описание Комментарий

good_id string - ID товара в каталоге Обязательно, если не указаны gtin и inn
gtin string - код товара Обязательно, если не указан good_id
inn string - ИНН аккаунта Обязательно, если не указан good_id

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Версия API
result array - Результат При наличии ответа
*good_draft_id number + ID шаблона товара в каталоге
*error string - Текст ошибки Параметр указывается при наличии ошибки

Пример запроса:
при указании good_id:
<url стенда>/nk/feed-moderation?apikey=XXX&good_id=7126

при указании gtin+inn:

377
<url стенда>/nk/feed-moderation?apikey=XXX>in=04640002660886&inn=123455678

Пример ответа:
{
"apiversion": 3 ,
"result": {
"good_draft_id": 123456 ,
"error": "Черновик GTIN 02XXXXXXXX601050000383 не в том статусе."
}
}

10.20. Метод определения кода принадлежности товара к маркируемым товарным

группам
Метод предназначен для определения принадлежности товара с указанными КИ или кодами ТН ВЭД
к маркируемым товарным группам. В одном запросе не может быть суммарно указано более 100 КИ и
кодов ТН ВЭД.
URL: /nk/mark-check?apikey=XXX
Метод: POST
Тип приватности: приватный.
Пример запроса:
curl -X POST "<url стенда>/nk/mark-check?apikey=<APIKEY>&format=json"
-H "accept: application/json"
-H "Content-Type: application/json"
-d "{\"gtins\":[\"string\"],\"tnveds\":[\"string\"]}"

Пример тела запроса:

{
"gtins":[
"04610043553256",
"04610043553287",
"03331436808029",
"0783320402685",
"3234567890126",
"038000232671",
"04640076801444",
"04640076801352",
"4810978019678",
"02900001633116",
"7891024188279"
],
"tnveds":[
"63",
"0401",
"6302",
"040410",
"0404100200",
"6404",

378
 "9001200000"
]
}

Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

gtins array[string] - Массив, содержащий коды товаров
tnveds array[string] - Массив, содержащий коды ТН ВЭД, с которым При отсутствии товара в системе код
связан указанный в запросе код товара. ТН ВЭД не указывается

Примеры ответа:
1.В случае успеха:
1.1 Пример ответа в формате JSON
{
"apiversion": 3,
"result": {
"gtins": [
{
"gtin": "783320402685",
"tnved": "3303",
"is_marked": "Товар подлежит маркировке",
"is_marked_code": 1
},
{
"gtin": "3234567890126",
"tnved": null,
"is_marked": "Товар не найден",
"is_marked_code": 2
}
],
"tnveds": [
{
"tnved": "63",
"is_marked": "По указанному коду ТНВЭД невозможно установить необходимость
маркировки. Уточните код ТНВЭД товара",
"is_marked_code": 3
},
{
"tnved": "6302",
"is_marked": "Товар с указанным кодом ТНВЭД подлежит маркировке",
"is_marked_code": 1
},
{
"tnved": "040410",
"is_marked": "ТНВЭД не найден",
"is_marked_code": 2
},
{
"tnved": "2008",
"is_marked": "Товар с указанным кодом ТНВЭД не подлежит маркировке",

379
 "is_marked_code": 0
}
]
}
}

Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

apiversion number + Версия API
result object + Результат При наличии ответа
*gtins array - массив, содержащий полученные коды
товаров и коды ТН ВЭД, к которым
привязаны коды товаров содержится
информация о маркировке и коде ответа
**gtin string + КИ, в отношении которого проводился
поиск признака маркируемости товара
**tnved string + Код ТН ВЭД, с которым связан указанный в При отсутствии товара в системе
запросе код товара код ТН ВЭД не указывается
**is_marked string + Текст ответа, содержащий информацию о
необходимости маркировки товара с
указанным GTIN
**is_marked_code integer + Коды ответов Возможные значения:
(int64) 0 – товар не подлежит маркировке;
1 – товар подлежит маркировке;
2 – товар не найден
Возможные значения для товарных
остатков (товары с КИ,
начинающимся с 029):
1 — остаток подлежит маркировке;
2 — остаток не найден
*tnveds array - Массив, содержащий коды ТН ВЭД или
коды групп ТН ВЭД
**tnved string + Код ТН ВЭД
**is_marked string + Текст ответа, содержащий информацию о
необходимости маркировки товара с
указанным кодом ТН ВЭД
**is_marked_code integer + Коды ответов Возможные значения:
(int64) 0 – Товар с указанным кодом ТН
ВЭД не подлежит маркировке;
1 – Товар с указанным кодом ТН
ВЭД подлежит маркировке;
2 – ТН ВЭД не найден;
3 – По указанному коду ТН ВЭД
невозможно установить
необходимость маркировки.
Уточните код ТН ВЭД товара

380
1.2 Пример ответа xml
<?xml version="1.0" encoding="UTF-8"?>
<root>
<apiversion>3</apiversion>
<result>
<gtins>
<item>
<gtin>783320402685</gtin>
<tnved>3303</tnved>
<is_marked>Товар подлежит маркировке</is_marked>
<is_marked_code>1</is_marked_code>
</item>
<item>
<gtin>3234567890126</gtin>
<tnved></tnved>
<is_marked>Товар не найден</is_marked>
<is_marked_code>2</is_marked_code>
</item>
</gtins>
<tnveds>
<item>
<tnved>63</tnved>
<is_marked>По указанному коду ТНВЭД невозможно установить необходимость
маркировки. Уточните код ТНВЭД товара</is_marked>
<is_marked_code>3</is_marked_code>
</item>
<item>
<tnved>6302</tnved>
<is_marked>Товар с указанным кодом ТНВЭД подлежит
маркировке</is_marked>
<is_marked_code>1</is_marked_code>
</item>
<item>
<tnved>040410</tnved>
<is_marked>ТНВЭД не найден</is_marked>
<is_marked_code>2</is_marked_code>
</item>
<item>
<tnved>2008</tnved>
<is_marked>Товар с указанным кодом ТНВЭД не подлежит
маркировке</is_marked>
<is_marked_code>0</is_marked_code>
</item>
</tnveds>
</result>
</root>

2.В случае ошибок:

2.1. Код 403, если указан неправильный ключ API.
{
"error_message": "Отсутствует доступ к ресурсу"
}

381
11. Методы "Станции управления заказами"
11.1. Метод получения токена аутентификации в СУЗ
Метод используется для получения маркера безопасности (токена аутентификации) в СУЗ. Для
получения токена для СУЗ в строке запроса указывается параметр «omsConnection» - уникальный
идентификатор соединения (внешнего подключения), присвоенный зарегистрированной установке
интеграционного решения.
URL: /auth/simpleSignIn/{omsConnection}
Метод: POST
Пример строки запроса:
curl -X POST "<url стенда>/auth/simpleSignIn/11b1abc9-f4ee-47db-8a20-f80ac83504e8"
-H "accept: application/json"
-H "Content-Type: application/json" -d

Параметры строки запроса:

Параметр Тип Обяз. Описание Комментарий

omsConnection string + Уникальный идентификатор соединения (внешнего подключения),
присвоенный зарегистрированной установке интеграционного решения.
Выдается при регистрации установки интеграционного решения

Примечание: на переходном этапе получение уникального идентификатора соединения (внешнего

подключения - "omsConnection") также будет доступно посредством регистрации в пользовательском
интерфейсе СУЗ клиентского устройства (системы), которое будет взаимодействовать через API СУЗ.
Пример тела запроса:
{
"uuid":"b223216d-5c43-416a-b2c3-39c79240c08a",
"data":"<Подписанные данные в base64>"
}

Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

uuid string + Уникальный идентификатор сгенерированных случайных данных
data string + Cлучайные данные в base64, подписанные УКЭП участника оборота товаров,
зарегистрированного в ГИС МТ (присоединённая электронная подпись)

Пример ответа:
{
"token": "6f9954c5-cbc8-43ff-bc5c-7021418fbef3"
}

382
Параметры ответа:

Параметр Тип Обяз. Описание Комментарий

token string - Токен аутентификации. Токен действителен в течение 10 часов.
Параметр возвращается в случае успешного ответа
code string - Код ошибки
error_message string - Сообщение об ошибке Возвращается в
случае ошибки
description string - Описание ошибки Возвращается в
случае ошибки

383
Список сокращений, условных обозначений и терминов
Сокращение Описание
API Application Programming Interface (Интерфейс программирования приложений)
Base64 Стандарт кодирования двоичных данных при помощи только 64 символов ASCII
CSV (Comma-Separated Values) текстовый формат, предназначенный для представления табличных данных
GTIN Код товара
JSON JavaScript Object Notation (текстовый формат обмена данными, основанный на JavaScript)
MIME Multipurpose Internet Mail Extensions (стандарт, описывающий передачу различных типов данных по
электронной почте)
pdf Portable Document Format (межплатформенный открытый формат электронных документов)
RFC Request for Comments (документ из серии пронумерованных информационных документов Интернета,
содержащих технические спецификации и стандарты, широко применяемые во всемирной сети)
SGTIN Serialized Global Trade Item Number (индивидуальный идентификационный код потребительской упаковки
для прослеживаемости в (GTIN + индивидуальный серийный номер вторичной (потребительской)
упаковки или первичной упаковки, в случае отсутствия вторичной)
URL Uniform Resource Locator (единый указатель ресурса)
UTF-8 Unicode Transformation Format, 8-bit (формат преобразования Юникода, 8-бит)
UUID Universally unique identifier. Универсальный уникальный идентификатор участника оборота товаров.
Записывается в виде последовательности шестнадцатеричных цифр в нижнем регистре, разделённых
знаками минуса на несколько групп, в следующем порядке: группа из 8 цифр, три группы из 4 цифр и
группа из 12 цифр, что в сумме составляет 32 цифры и представляет 128 бит. Пример UUID: a0eebc99-
9c0b-4ef8-bb6d-6bb9bd380a11
XML eXtensible Markup Language (расширяемый язык разметки)
XSD XML Schema definition (язык описания структуры XML документа)
АТК Агрегированный таможенный код
БД База данных
ВСД ветеринарно-сопроводительный документ (транспортный сопроводительный документ)
ГИС МТ Государственная информационная система мониторинга за оборотом товаров
ЕНВД Единый налог на вменённый доход
ЕСХН Единый сельскохозяйственный налог
ДИС Документ об изменении стоимости отгруженных товаров (выполненных работ, оказанных услуг),
переданных имущественных прав
ДОП Первичный документ. Например: накладная или акт
ДТ Декларация на товары
ЕАЭС Евразийский экономический союз
ИНН Идентификационный номер налогоплательщика
КИ Код идентификации
КИГУ Код идентификации групповой упаковки

384
Сокращение Описание
КИК Код идентификации комплекта
КИН Код идентификации набора (указывается по аналогии с КИ)
КИТУ Код идентификации транспортной упаковки (указывается от 18 до 74 символов включительно: цифры,
буквы латинского алфавита, спецсимволы: A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !)
КМ Код маркировки. Включает в себя КИ, КИГУ, КИК, КИН, КИТУ
КСЧФ Корректировочная счет-фактура, применяемая при расчетах по налогу на добавленную стоимость
КСЧФ ДИС Корректировочная счет-фактура, применяемая при расчетах по налогу на добавленную стоимость, и
документ об изменении стоимости отгруженных товаров (выполненных работ, оказанных услуг),
переданных имущественных прав
МОТП Мониторинг оборота табачной продукции
НДС Налог на добавленную стоимость
НК Национальный каталог
ОКСМ Общероссийский классификатор стран мира
ОСН Общая система налогообложения
РБ Республика Беларусь
РД Разрешительная документация
РЭ Регистратор эмиссии
СКПТ Код подакцизного товара
СУЗ Станция управления заказами
СЧФ Счёт-фактура
СЧФ ДОП См. УПД
ТГ Товарная группа
ТН ВЭД Товарная номенклатура внешнеэкономической деятельности Евразийского экономического союза
ЕАЭС
УД Универсальный документ
УКД Универсальный корректировочный документ
УКДи Исправленный универсальный корректировочный документ
УКЭП Усиленная квалифицированная электронная подпись
УНП Учётный номер плательщика
УОТ Участник оборота товара
УПД Универсальный передаточный документ
УПДи Исправленный универсальный передаточный документ
УСН Упрощённая система налогообложения
ФД Фискальный документ
ФТС Федеральная таможенная служба

385
Сокращение Описание
ФОИВ Федеральные органы исполнительной власти
ФПД Фискальный признак документа
ЦРПТ Центр развития перспективных технологий
ЭДО Электронный документооборот

386
Приложение 1. Справочники

387
Справочник "Список поддерживаемых товарных групп"
Код в БД Наименование Описание
1 lp Предметы одежды, бельё постельное, столовое, туалетное и кухонное
2 shoes Обувные товары
3 tobacco Табачная продукция
4 perfumery Духи и туалетная вода
5 tires Шины и покрышки пневматические резиновые новые
6 electronics Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки
8 milk Молочная продукция
9 bicycle Велосипеды и велосипедные рамы
10 wheelchairs Кресла-коляски
12 otp Альтернативная табачная продукция
13 water Упакованная вода
14 furs Товары из натурального меха
15 beer Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки
16 ncp Никотиносодержащая продукция
17 bio Биологические активные добавки к пище

Справочник "Типы документов"

Код Наименование Формат
AGGREGATION_DOCUMENT Агрегация JSON
AGGREGATION_DOCUMENT_CSV Агрегация CSV
AGGREGATION_DOCUMENT_XML Агрегация XML
SETS_AGGREGATION Формирование наборов JSON
SETS_AGGREGATION_CSV Формирование наборов CSV
SETS_AGGREGATION_XML Формирование наборов XML
DISAGGREGATION_DOCUMENT Расформирование агрегата JSON
DISAGGREGATION_DOCUMENT_CSV Расформирование агрегата CSV
DISAGGREGATION_DOCUMENT_XML Расформирование агрегата XML
REAGGREGATION_DOCUMENT Трансформация агрегата JSON
REAGGREGATION_DOCUMENT_XML Трансформация агрегата XML
REAGGREGATION_DOCUMENT_CSV Трансформация агрегата CSV
LP_INTRODUCE_GOODS Ввод в оборот. Производство РФ JSON
LP_INTRODUCE_GOODS_CSV Ввод в оборот. Производство РФ CSV

388
Код Наименование Формат
LP_INTRODUCE_GOODS_XML Ввод в оборот. Производство РФ XML
LP_SHIP_GOODS Отгрузка JSON
LP_SHIP_GOODS_CSV Отгрузка CSV
LP_SHIP_GOODS_XML Отгрузка XML
LP_SHIP_RECEIPT Отгрузка с выводом из оборота JSON
LP_SHIP_RECEIPT_CSV Отгрузка с выводом из оборота CSV
LP_SHIP_RECEIPT_XML Отгрузка с выводом из оборота XML
LP_SHIP_GOODS_CROSSBORDER Отгрузка при трансграничной JSON
торговле
LP_ACCEPT_GOODS Приемка JSON
LP_ACCEPT_GOODS_XML Приемка XML
LK_REMARK Перемаркировка JSON
LK_REMARK_CSV Перемаркировка CSV
LK_REMARK_XML Перемаркировка XML
LP_GOODS_IMPORT Ввод в оборот. Импорт JSON
LP_GOODS_IMPORT_CSV Ввод в оборот. Импорт CSV
LP_GOODS_IMPORT_XML Ввод в оборот. Импорт XML
LP_CANCEL_SHIPMENT Отмена отгрузки JSON
LP_CANCEL_SHIPMENT_CROSSBORDER Отмена отгрузки при JSON
трансграничной торговле
LK_KM_CANCELLATION Списание не нанесённых КИ JSON
LK_KM_CANCELLATION_XML Списание не нанесённых КИ XML
LK_KM_CANCELLATION_CSV Списание не нанесённых КИ CSV
LK_APPLIED_KM_CANCELLATION Списание нанесённых КИ JSON
LK_APPLIED_KM_CANCELLATION_XML Списание нанесённых КИ XML
LK_APPLIED_KM_CANCELLATION_CSV Списание нанесённых КИ CSV
LK_CONTRACT_COMMISSIONING Ввод в оборот товара. Контрактное JSON
производство РФ
LK_CONTRACT_COMMISSIONING_CSV Ввод в оборот товара. Контрактное CSV
производство РФ
LK_CONTRACT_COMMISSIONING_XML Ввод в оборот товара. Контрактное XML
производство РФ
LK_INDI_COMMISSIONING Ввод в оборот товара. Полученных JSON
от физических лиц
LK_INDI_COMMISSIONING_CSV Ввод в оборот товара. Полученных CSV
от физических лиц

389
Код Наименование Формат
LK_INDI_COMMISSIONING_XML Ввод в оборот товара. Полученных XML
от физических лиц
LP_RETURN Возврат в оборот JSON
LP_RETURN_CSV Возврат в оборот CSV
LP_RETURN_XML Возврат в оборот XML
OST_DESCRIPTION Описание остатков товара JSON
OST_DESCRIPTION_CSV Описание остатков товара CSV
OST_DESCRIPTION_XML Описание остатков товара XML
LP_INTRODUCE_OST Ввод в оборот. Маркировка JSON
остатков
LP_INTRODUCE_OST_CSV Ввод в оборот. Маркировка CSV
остатков
LP_INTRODUCE_OST_XML Ввод в оборот. Маркировка XML
остатков
CROSSBORDER Ввод в оборот. Трансграничная JSON
торговля
CROSSBORDER_CSV Ввод в оборот. Трансграничная CSV
торговля
CROSSBORDER_XML Ввод в оборот. Трансграничная XML
торговля
LK_RECEIPT Вывод из оборота JSON
LK_RECEIPT_CSV Вывод из оборота CSV
LK_RECEIPT_XML Вывод из оборота XML
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_JSON Ввод в оборот. На территории стран JSON
ЕАЭС (контрактное производство)
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_XML Ввод в оборот. На территории стран XML
ЕАЭС (контрактное производство)
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_CSV Ввод в оборот. На территории стран CSV
ЕАЭС (контрактное производство)
LP_FTS_INTRODUCE_JSON Ввод в оборот. Импорт с ФТС JSON
LP_FTS_INTRODUCE_XML Ввод в оборот. Импорт с ФТС XML
LP_FTS_INTRODUCE_CSV Ввод в оборот. Импорт с ФТС CSV
LP_FTS_INTRODUCE_RESPONSE Декларация на товары JSON
ATK_AGGREGATION Формирование АТК JSON
ATK_AGGREGATION_CSV Формирование АТК CSV
ATK_AGGREGATION_XML Формирование АТК XML
ATK_TRANSFORMATION Трансформация АТК JSON

390
Код Наименование Формат
ATK_TRANSFORMATION_CSV Трансформация АТК CSV
ATK_TRANSFORMATION_XML Трансформация АТК XML
ATK_DISAGGREGATION Расформирование АТК JSON
ATK_DISAGGREGATION_CSV Расформирование АТК CSV
ATK_DISAGGREGATION_XML Расформирование АТК XML
RECEIPT Чек Формируется
оператором фискальных
данных
RECEIPT_RETURN Чек возврата Формируется
оператором фискальных
данных
AGGREGATION_DOCUMENT Документ агрегации (для ТГ JSON
"Табачная продукция" и "АТП")
AGGREGATION_DOCUMENT Документ агрегации (для ТГ XML
"Табачная продукция" и "АТП")
WRITE_OFF Документ списания (для ТГ JSON
"Табачная продукция" и "АТП")
WRITE_OFF Документ списания (для ТГ XML
"Табачная продукция" и "АТП")

Для создания универсальных документов необходимо использовать Описание API ЭДО Lite.
Документы поступают от коммерческого ЭДО.

Наименование универсального документа Код

УПД ДОП (накладная) UNIVERSAL_TRANSFER_DOCUMENT
УДП СЧФ (счет-фактура) UNIVERSAL_TRANSFER_DOCUMENT
УПД СЧФ ДОП (счет-фактура+накладная) UNIVERSAL_TRANSFER_DOCUMENT
УПД(и) ДОП (на накладную) UNIVERSAL_TRANSFER_DOCUMENT_FIX
УПД(и) СЧФ (на счет-фактуру) UNIVERSAL_TRANSFER_DOCUMENT_FIX
УПД(и) СЧФ ДОП UNIVERSAL_TRANSFER_DOCUMENT_FIX
УКД ДИС (на накладную) UNIVERSAL_CORRECTION_DOCUMENT
УКД КСЧФ (на счет-фактуру) UNIVERSAL_CORRECTION_DOCUMENT
УКД КСЧФ ДИС UNIVERSAL_CORRECTION_DOCUMENT
УКД(и) ДИС (исправление корректировки накладной) UNIVERSAL_CORRECTION_DOCUMENT_FIX
УКД(и) КСЧФ (исправление корректировочной счет-фактуры) UNIVERSAL_CORRECTION_DOCUMENT_FIX
УКД(и) КСЧФ ДИС UNIVERSAL_CORRECTION_DOCUMENT_FIX
Универсальный документ отмены UNIVERSAL_CANCEL_DOCUMENT

391
Справочник "Статусы проверок УПД"
Код Наименование
VERIFIED Успешно проверен
NOT_VALID Ошибка проверок
NOT_FOUND Не найден
IN_PROGRESS В обработке
AWAITING В ожидании

Справочник "Типы договоров"

Код в БД Наименование
-2 Договор о подключении к ГИС МТ
-3 Договор по предоставлению РЭ
-4 Договор на услуги по предоставлению КИ
-5 Договор по предоставлению РВ
-6 Договор ЭДО
-7 Договор безвозмездного пользования движимым имуществом
-8 Договор по предоставлению РЭ УОТ путем УД
-9 Заявка Участника о предоставлении Оборудования РВ
-10 Заявка Участника о предоставлении Оборудования РЭ
-11 Заявка УОТ о предоставлении РЭ путем УД
-12 Акт приема-передачи Оборудования
-13 Акт возврата Оборудования
-14 Акт проверки состояния и условий эксплуатации Оборудования
-15 Акт выполненных работ
-16 Уведомление о предоставлении Участнику права пользования Оборудованием путем предоставления УД
-17 Дополнительное соглашение
-18 Дополнительное соглашение (нерезидент)
-19 Соглашение об электронном взаимодействии
-20 Письмо об осуществлении оплаты третьей стороной
-21 Договор на оказание возмездных услуг по предоставлению КИ (с нерезидентом)
-22 Договор по предоставлению РЭ (с нерезидентом)
-23 Договор по предоставлению РЭ УОТ путем УД (с нерезидентом)
-24 Информационное письмо
-25 Уведомление от Оператора
-26 Заявка Участника о предоставлении Оборудования РЭ (нерезидент)
-27 Заявка Участника о предоставлении РЭ путем УД (нерезидент)

392
-28 Уведомление Участника о передаче РВ
-29 Акт о невозможности исполнения обязательств
-100 Счет на оплату
-10000 Акт сверки

Справочник "Типы эмиссии КИ"

Код Описание
LOCAL Производство РФ
FOREIGN Ввезён в РФ
REMAINS Маркировка остатков;
CROSSBORDER Ввезён из стран ЕАЭС
REMARK Перемаркировка
COMMISSION Принят на комиссию от физического лица

Справочник "Статусы КИ"

Актуальные статусы

Код Описание
EMITTED Эмитирован. Выпущен
APPLIED Эмитирован. Получен
INTRODUCED В обороте
WRITTEN_OFF Списан
RETIRED Выбыл
WITHDRAWN Выбыл (только для ТГ "Табачная продукция" и "Альтернативная табачная продукция")
INTRODUCED_RETURNED Возвращён в оборот (только для ТГ "Табачная продукция" и "Альтернативная табачная
продукция")
DISAGGREGATION Расформирован (только для КИТУ, АТК и набора всех ТГ, кроме "Табачная продукция" и
"Альтернативная табачная продукция")
DISAGGREGATED Расформирован (только для КИТУ и АТК ТГ "Табачная продукция" и "Альтернативная
табачная продукция")

Актуальные особые состояния

Актуальный
Код Описание статус
EMPTY Значение отсутствует
RESERVED_NOT_USED Зарезервировано. Не использовать INTRODUCED

393
 Актуальный
Код Описание статус
INTRODUCED_RETURNED Возвращён в оборот INTRODUCED
WAIT_SHIPMENT Ожидает подтверждения приёмки INTRODUCED
EXPORTED Используется для документов экспорта
LOAN_RETIRED Выведен из оборота по договору рассрочки RETIRED
REMARK_RETIRED Выведен из оборота при перемаркировке WRITTEN-OFF
WAIT_TRANSFER_TO_OWNER Ожидает передачу собственнику (контрактное производство) INTRODUCED
WAIT_REMARK Товар ожидает перемаркировку или КИ списан после WRITTEN_OFF
нанесения на товар
RETIRED_CANCELLATION Списание WRITTEN_OFF
RETIRED_DONATION Безвозмездная передача, применяется в документе "Отгрузка" RETIRED
RETIRED_STATE_ENTERPRISE Приобретение государственным предприятием, применяется в RETIRED
документе "Отгрузка"
RETIRED_NO_RETAIL_USE Использование для собственных нужд покупателем, RETIRED
применяется в документе "Отгрузка"
RETIRED_BEYOND_EEC_EXPORT Экспорт за пределы стран ЕАЭС, применяется в документе RETIRED
Вывод из оборота
RETIRED_REMOTE_SALE Продажа по образцам, дистанционный способ продажи, RETIRED
применяется в документе "Вывод из оборота"
RETIRED_EEC_EXPORT Экспорт в страны ЕАЭС, применяется в документе "Вывод из RETIRED
оборота"
RETIRED_RETURN Возврат физическому лицу, применяется в документе "Вывод RETIRED
из оборота"
RETIRED_DAMAGE_LOSS Утрата или повреждение, применяется в документе "Вывод из RETIRED
оборота"
RETIRED_DESTRUCTION Уничтожение, применяется в документе "Вывод из оборота" RETIRED
RETIRED_CONFISCATION Конфискация, применяется в документе "Вывод из оборота" RETIRED
RETIRED_LIQUIDATION Ликвидация предприятия, применяется в документе "Вывод из RETIRED
оборота"
RETIRED_ENTERPRISE_USE Использование для собственных нужд RETIRED
FTS_RESPONSE_OK Положительное решение ФТС APPLIED
FTS_RESPOND_NOT_OK Отрицательное решение ФТС APPLIED
FTS_RESPOND_WAITING Ожидает подтверждение ФТС APPLIED
FTS_CONTROL На контроле ФТС APPLIED
IN_GRAY_ZONE Находится в Серой зоне APPLIED
VSD_STATUS_REQUEST Запрос статуса ВСД отправлен во ФГИС “ВетИС”
VSD_RESPONSE_NOT_OK Проверка статуса ВСД во ФГИС “ВетИС” пройдена с ошибкой

394
 Актуальный
Код Описание статус
VSD_RESPONSE_OK Проверка статуса ВСД во ФГИС “ВетИС” успешно пройдена

Справочник "Типы производства"

Код Описание
LOCAL Производство РФ
FOREIGN Ввезен в РФ

Справочник "Типы упаковки"

Примечание для ТГ
"Табачная продукция",
"АТП",
Ограничение использования в "Никотиносодержащая Примечание для
Код Описание зависимости от ТГ продукция" прочих ТГ
UNIT Единица товара Пачка Потребительская
упаковка
GROUP Групповая Используется только для ТГ
упаковка "Молочная продукция",
"Упакованная вода", "Табачная
продукция", "АТП"
LEVEL1 Упаковка 1-го Блок
уровня
LEVEL2 Упаковка 2-го Коробка Транспортная упаковка
уровня (SSCC)
LEVEL3 Упаковка 3-го Паллета
уровня
LEVEL4 Упаковка 4-го
уровня
LEVEL5 Упаковка 5-го
уровня
BUNDLE Комплект Используется только ТГ
"Предметы одежды, бельё
постельное, столовое,
туалетное и кухонное", "Духи и
туалетная вода", "Фотокамеры
(кроме кинокамер),
фотовспышки и лампы-
вспышки"
АТК Агрегированный В составе АТК может
таможенный код быть только единичная
упаковка (UNIT) или
комплект (BUNDLE)

395
 Примечание для ТГ
"Табачная продукция",
"АТП",
Ограничение использования в "Никотиносодержащая Примечание для
Код Описание зависимости от ТГ продукция" прочих ТГ
SET Набор Используется только ТГ "Духи
и туалетная вода",
"Фотокамеры (кроме
кинокамер), фотовспышки и
лампы-вспышки", "Предметы
одежды, бельё постельное,
столовое, туалетное и
кухонное"

Справочник "Статусы заказов"

Код Описание
NEW Зарегистрирован
PRODUCTION Производство
VALIDATION_FAILED Ошибка в проверке
IN PROGRESS Заказ в процессе выполнения
SUCCESS Заказ выполнен
ERROR При выполнении заказа возникла ошибка
RESULT_EXPIRED Заказ устарел

Справочник "Статусы документов"

Код Описание Комментарий
IN_PROGRESS Проверяется
CHECKED_OK Обработан
CHECKED_NOT_OK Обработан с
ошибками
PROCESSING_ERROR Техническая ошибка
ACCEPTED Принят Только для документа "Отгрузка"
CANCELLED Аннулирован Только для документа "Отгрузка" и документов ЭДО
WAIT_ACCEPTANCE Ожидает приемку Только для документа "Отгрузка". Устанавливается
при успешной обработке документа "Отгрузка"
PARSE_ERROR Обработан с
ошибками
WAIT_PARTICIPANT_REGISTRATION Ожидает Только для документа "Отгрузка". Устанавливается
регистрации при успешной обработке документа "Отгрузка товара"
участника в ГИС МТ в сторону незарегистрированного участника

396
Код Описание Комментарий
WAIT_FOR_CONTINUATION Ожидает
продолжения
обработки документа

Справочник "Причины вывода из оборота"

Код Описание
RETAIL Розничная продажа
DAMAGE_LOSS Утрата
DEFECT Повреждение/брак
DESTRUCTION Уничтожение
LIQUIDATION Ликвидация
CONFISCATION Конфискация
ENTERPRISE_USE Использование для собственных нужд
DEMO_SAMPLES Демонстрационные образцы
EXPIRY Истечение срока
QA_SAMPLES Лабораторные образцы
PRODUCT_TESTING Тестовые образцы
PRODUCT_RECALL Отзыв с рынка
COMPLAINTS Рекламации
EEC_EXPORT Экспорт в страны ЕАЭС
BEYOND_EEC_EXPORT Экспорт за пределы стран ЕАЭС
RETURN Возврат физическому лицу (значение не используется для товарной группы "Молочная
продукция")
REMOTE_SALE Продажа по образцам, дистанционный способ продажи
DAMAGE_LOSS Утрата или повреждение
OTHER Другое

Справочник "Статусы ответов"

Код
в БД Наименование Описание Формат сообщения об ошибке
200 ОК Статус ответа в случае успеха -
201 CREATED Статус ответа в случае успеха
202 ACCEPTED Статус ответа в случае успеха
400 ERROR Ошибка в параметрах запроса 1 Для НК-методов:
Bad Request (отсутствует обязательный 1.1. При отсутствии параметра apikey или feed:
параметр)

397
Код
в БД Наименование Описание Формат сообщения об ошибке
{ "error_message": "Отсутствует обязательный
параметр: <имя обязательного параметра>" }
1.2. При отсутствии остальных параметров:
{ "error_message": "Ошибка в параметрах
запроса" }
2 Для всех методов, кроме НК:
{ "error_message": "Отсутствует обязательный
параметр: <имя обязательного параметра>" }
Ошибка в параметрах запроса 1 Для НК-методов:
(неверный тип параметра)
{ "error_message": "Ошибка в параметрах
запроса" }
2 Для всех методов, кроме НК:
{ "error_message": "Параметр <имя параметра>
требует значение типа <требуемый тип
параметра>" }
401 ERROR Ошибка авторизации 1 Для всех методов, требующих токен, кроме
НК-методов:
{ "error_message":"Для 1.1. Указан устаревший токен:
доступа к этому ресурсу
<InvalidTokenException>
требуется полная
<error>invalid_token</error>
аутентификация" }
<error_description>Access token expired:
<токен></error_description>
</InvalidTokenException>
1.2. Не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication is required to
access this resource</error_description>
</UnauthorizedException>
402 ERROR Ошибка в атрибутивном
составе тела запроса
403 ERROR Доступ запрещён 1 Для всех методов, кроме НК:
Forbidden
1.1. Если пользователь (УОТ) не имеет доступа к
конкретному удаленному сервису:
{ "error_message": "Отсутствует доступ к
ресурсу" }
2 Для всех НК-методов:
2.1. Если указан неправильный ключ API
{ "error_message": "Отсутствует доступ к
ресурсу" }
404 ERROR Запрашиваемая информация 1 Для всех НК-методов:

398
Код
в БД Наименование Описание Формат сообщения об ошибке
Not Found не найдена в ГИС МТ { "error_message": Данные не найдены> не
найден"
}
2 Для всех методов, кроме НК:

{ "error_message": "<Описание параметра> не

найден" }
Ошибка в указании URL { "error_message": "Метод с указанным URL не
метода найден" }
409 ERROR Запрос не может быть
выполнен из-за конфликтного
обращения к ресурсу
410 ERROR Ресурс ранее был доступен по
указанному URL, но сейчас
он удалён и недоступен
414 ERROR Превышен допустимый { "error_message": "Слишком большой запрос" }
размер тела запросаa
422 ERROR Ошибка проверки подписи { "error_message": "Ошибка проверки подписи" }
500 ERROR Внутренняя ошибка { "error_message": "Ошибка при выполнении
Internal server Error удалённых систем запроса" }
(технически
детализированное описание
не возвращается)
502 ERROR Сервер временно недоступен
Bad gateway Nginx или заблокирован
503 ERROR Проблема с доступом к { "error_message": "Удаленная система
Service Unavailable удалённой системе недоступна" }
504 ERROR Ошибка при получении { error_message: "Отсутствует ответ системы" }
ответа системы

Справочник "Типы организаций"

Код в БД Код Описание
1 TRADE_PARTICIPANT Участник оборота товаров
2 PRODUCER Производитель товара
3 IMPORTER Импортер товара
4 WHOLESALER Оптовая торговля
5 RETAIL Розничная торговля
6 IS_MP_OPERATOR Оператор ГИС МТ
7 CEM LABELLING_CENTER

399
Код в БД Код Описание
8 OGV Орган государственной власти

Справочник "Статусы УОТ"

Код Описание
REGISTERED Зарегистрирован
NOT_REGISTERED Не зарегистрирован
REMOVED Удален
RESTORED Восстановлен
BLOCKED Заблокирован

Справочник "Статусы заявки на регистрацию УОТ"

№ Код Описание
1 IN_PROGRESS На рассмотрении (проверяется)
2 CHECKED_OK Оформлен
3 REGISTERED Документ зарегистрирован (принят системой)
4 CHECKED_NOT_OK Ошибка
5 PROSECCING_ERROR Ошибка при обработке
6 UNDEFINED Не определен

Справочник "Статусы документа в жизненном цикле SD"

Код в БД Описание
10 Новый
20 Согласование
40 Подписание
50 Активация
60 Активен
100 Недействителен

Справочник "Статусная модель"

Для каждого статуса указано, к каким типам документов он применим:

Код в
БД Статусы исходящих документов Статусы входящих документов
0 Черновик -

400
Код в
БД Статусы исходящих документов Статусы входящих документов
11 Ожидается отправка -
1 Отправлен -
2 Доставлен (подпись не требуется) Подпись не требуется
12 Просмотрен (подпись не требуется) Подпись не требуется (документ просмотрен)
3 Доставлен (ожидается подпись) Требуется подпись
13 Просмотрен (ожидается подпись) Требуется подпись (документ просмотрен)
4 Подписан Подписан
5 Отклонен Отклонен
15 Отклонен (запрос просмотрен) Отклонен (запрос просмотрен)
6 Отозван Отозван
16 Запрошено аннулирование Ожидается аннулирование
17 Ожидается аннулирование Запрошено аннулирование
18 Аннулирован Аннулирован
19 В аннулировании отказано В аннулировании отказано
7 Уточнён Уточнён
8 Требуется уточнение Ожидается уточнение
14 Требуется уточнение (запрос на уточнение Запрос на уточнение просмотрен (ожидается
просмотрен) уточнение)
9 Ошибка в подписи Ошибка в подписи
10 Ошибка доставки Ошибка доставки

Справочник "Дополнительные параметры в ответе в зависимости от товарных

групп"
Дополнительные параметры возвращаются в ответе при условии указания сведений в карточке
описания товара в КМТ.

Дополнительные параметры для ТГ "Альтернативная табачная продукция" и "Табачная

продукция"

Параметр Описание Примечание

tobaсcoType Тип табачного продукта
okpd2Group Код ОКПД2
okpd2Code Код ОКПД2 Опционально
exciseProduct Акцизный товар
exciseProductCode Код подакцизного товара (СКПТ)

401
Параметр Описание Примечание
quantityInPack Единица измерения по атрибуту "Количество единиц употребления в weight
потребительской упаковке" (только "АТП")
Заявленный вес multiplier
(АТП)

Дополнительные параметры для ТГ "Обувные товары"

Параметр Описание Примечание

brand Торговая Марка / Бренд
productType Вид обуви
productTypeDesc Вид обуви
name Полное наименование
товара
productSize Размер в штихмассовой
системе
color Цвет изделия
materialUpper Материал верха
materialLining Материал подкладки
materialDown Материал низа / подошвы
model Модель / артикул
производителя
country Страна производства
color Цвет
size Размер
sizes Размер Массив уникальных значений размера в штихмассовой системе - значения
из КМТ и полученные из ГИС МТ

Дополнительные параметры для ТГ "Предметы одежды, бельё постельное, столовое, туалетное

и кухонное"

Параметр Описание Примечание

brand Товарный знак
name Полное наименование товара
type Тип изделия
size Размер одежды
color Цвет
textileType Тип текстиля

402
Параметр Описание Примечание
structure Состав
consumerAge Возраст потребителя
gender Целевой пол
model Модель / артикул производителя
country Страна производства
structure Состав изделия
standardNumber Номер регламента или стандарта
productKind Вид товара
productAreaSize Размер изделия

Дополнительные параметры для ТГ "Фотокамеры (кроме кинокамер), фотовспышки и лампы-

вспышки"

Параметр Описание Примечание

brand Товарный знак
name Полное наименование товара
type Вид товара
standardNumber Номер регламента / стандарта
model Модель / артикул производителя
country Страна производства
standardNumber Номер регламента или стандарта
productKind Вид товара

Дополнительные параметры для ТГ "Велосипеды и велосипедные рамы"

Параметр Описание Примечание

brand Торговая Марка / Бренд
model Модель / артикул производителя
productKind Вид товара
productionYear Год производства
engineType Тип двигателя
enginePower Мощность двигателя
electricEnginePower Мощность электродвигателя, Вт
frameSize Размер рамы
weightGross Конструктивная масса, кг

403
Параметр Описание Примечание
frameMaterial Материал рамы
rimDiameter Номинальный посадочный диаметр обода, дюйм
sectionWidth Ширина профиля шины (камеры), дюйм
brakeSystemType Тип тормозной системы
frontForkType Тип передней вилки
country Страна производства
rimDiameter Номинальный посадочный диаметр обода, дюйм

Дополнительные параметры для ТГ "Кресла-коляски"

Параметр Описание Примечание

brand Торговая Марка / Бренд
productKind Вид товара
model Модель / артикул производителя
weightGross Конструктивная масса, кг
maximumLoad Максимальная нагрузка, кг
seatDepth Глубина сиденья
seatWidth Ширина сиденья
seatHeight Высота сиденья
backHeight Высота спинки
country Страна производства
productKind Вид товара

Дополнительные параметры для ТГ "Духи и туалетная вода"

Параметр Описание Примечание

brand Торговая Марка / Бренд
perfumeryType Тип парфюмерии
volume Заявленный объём
packageType Тип упаковки
packMaterial Материал упаковки
country Страна производства
standardNumber Номер регламента или стандарта
packMaterial Материал упаковки
quantityInPack Единица измерения по атрибуту "Заявленный объём"

404
Дополнительные параметры для ТГ "Шины и покрышки пневматические резиновые новые"

Параметр Описание Примечание

brand Торговый знак
model Модель / артикул производителя
tireSectionWidth Ширина профиля шины (камеры), мм/дюйм
heightWidthRatio Номинальное отношение высоты профиля шины к его ширине, %
frameConstructionType Тип конструкции каркаса шины
tireLoadIndex Индекс нагрузки на шину
speedCategory Категория скорости
seasonality Сезонность
frameSealingType Тип шины по способу герметизации
rimDiameter Посадочный диаметр обода, дюйм
sectionWidth Ширина профиля, мм/дюйм

Дополнительные параметры для ТГ "Молочная продукция"

Параметр Описание Примечание

brand Торговая Марка / Бренд
milkProductType Тип продукта
rawOrigin Происхождение сырья
fat Жирность, %
volume Заявленный объём
volumeWeight Заявленный объём / вес нетто
vetisId Идентификатор товара в ФГИС ВетИС
babyFoodProduct Продукция для детского питания
structure Состав
packMaterial Материал упаковки
veterinaryControl Подлежит ветеринарному контролю (надзору)
multiplier Количество вложений в упаковке
isShelfLife40Days Срок хранения до 40 суток (включительно)
isSpecializedFoodProduct Специализированная пищевая продукция
compositionOption Вариант состава

405
Дополнительные параметры для ТГ "Упакованная вода"

Параметр Описание Примечание

productType Тип продукта
structure Состав
packMaterial Материал упаковки
volume Заявленный объём
babyFoodProduct Продукция для детского питания
mineralization Общая минерализация
carbonationMethod Метод газирования

Дополнительные параметры для ТГ "Товары из натурального меха"

Параметр Описание Примечание

isCombinedProduct Комбинированное меховое изделие
furType Тип меха
otherFurType Остальные виды меха
isDyedFur Является ди мех крашеным
size Разамер изделия из натурального меха
color Цвет

406
Приложение 2. Примеры аутентификации по УКЭП / Подписание
документов
Пример получения токена при авторизации с прикрепленной подписью /
подписание документов с открепленной подписью на 1С
// sThumbprint - отпечаток сертификата, используемого для подписи; строка,
// представляющая отпечаток в шестнадцатеричном виде
// пример 195934d72dcdf69149901d6632aca4562d8806d8
// ТекстДляПодписи должен быть в Base64
// bDetached - Истина/Ложь - откреплённая(для подписания документов)/прикреплённая(для
получения токена авторизации) подпись

Функция ПодписатьТекст(ТекстДляПодписи, sThumbprint, bDetached)

CADESCOM_BASE64_TO_BINARY = 1; // Входные данные пришли в Base64
CADESCOM_CADES_TYPE = 1; // Тип усовершенствованной подписи
CAPICOM_AUTHENTICATED_ATTRIBUTE_SIGNING_TIME = 0; // Атрибут штампа времени подписи

oSigner = Новый COMОбъект("CAdESCOM.CPSigner");

// Объект, задающий параметры создания и содержащий информацию об усовершенствованной
подписи.
oSigner.Certificate = ПолучитьСертификатПоОтпечатку(sThumbprint);

oSigningTimeAttr = Новый COMОбъект("CAdESCOM.CPAttribute");

oSigningTimeAttr.Name = CAPICOM_AUTHENTICATED_ATTRIBUTE_SIGNING_TIME;
oSigningTimeAttr.Value = ТекущаяДата();
oSigner.AuthenticatedAttributes2.Add(oSigningTimeAttr);

ТекстДляПодписи = СокрЛП(ТекстДляПодписи);

oSignedData = Новый COMОбъект("CAdESCOM.CadesSignedData");

// Объект CadesSignedData предоставляет свойства и методы для работы с
усовершенствованной подписью.
oSignedData.ContentEncoding = CADESCOM_BASE64_TO_BINARY;
SignedData.Content = СокрЛП(ТекстДляПодписи);
EncodingType = 0;

sSignedMessage = oSignedData.SignCades(oSigner, CADESCOM_CADES_TYPE, bDetached,

EncodingType);
// Метод добавляет к сообщению усовершенствованную подпись.
Возврат sSignedMessage; // Подпись в формате Base64
КонецФункции

//Отпечаток - строка HEX

Функция ПолучитьСертификатПоОтпечатку(ОтпечатокСтр)
Рез = Неопределено; // Найденный сертификат (Com-объект)
CAPICOM_CURRENT_USER_STORE = 2;
//2 - Искать сертификат в ветке "Личное" хранилища.
CAPICOM_MY_STORE = "My";

// Указываем, что ветку "Личное" берем из хранилища текущего пользователя

CAPICOM_STORE_OPEN_READ_ONLY = 0; // Открыть хранилище только на чтение
oStore = Новый COMОбъект("CAdESCOM.Store"); // Объект описывает хранилище сертификатов
oStore.Open(CAPICOM_CURRENT_USER_STORE, CAPICOM_MY_STORE,
CAPICOM_STORE_OPEN_READ_ONLY); // Открыть хранилище сертификатов

407
// 1 вариант: поиск сертификата по отпечатку
CAPICOM_CERTIFICATE_FIND_SHA1_HASH = 0;
Certificates = oStore.Certificates.Find(CAPICOM_CERTIFICATE_FIND_SHA1_HASH,
ОтпечатокСтр);
Рез = Certificates.Item(1);

//2 вариант: обходом по коллекции и сравнение с отпечатком

//Для Каждого ТекСертификат Из oStore.Certificates Цикл
//ТекОтпечаток = ТекСертификат.Thumbprint; // возвращается отпечаток в
шестнадцатеричном виде
//Если ВРЕГ(ТекОтпечаток) = ВРЕГ(ОтпечатокСтр) Тогда //Рез = ТекСертификат;
//Прервать;
//КонецЕсли;
//КонецЦикла;
oStore.Close(); // Закрыть хранилище сертификатов и освободить объект 61

Возврат Рез;
КонецФункции

Пример получения токена при авторизации REACT JS

import { CadesPluginer as anyName } from "@crpt/cades-pluginer"; //or
import CadesPluginer from "@crpt/cades-pluginer";
//usually you will need 2 methods
CadesPluginer.getFinalCertsArray().then(certs => {
console.log("certs", certs);
CadesPluginer.signMessage("lalala", certs[0].certificate).then(signed =>
console.log("signed", signed);
);
});

Пример получения токена при авторизации с помощью прикрепленной подписи /

подписание документов с помощью открепленной подписи на Java
String data = ...//получение кода для авторизации
boolean detached = false;
// false - прикреплённая(для получения токена авторизации) подпись
// true - откреплённая(для подписания документов) подпись
//Формирование подписи
KeyStore keyStore = loadKeyStore();//инициализация хранилища ключей
List<X509CertificateHolder> chain = new ArrayList<>();
List<Certificate> certs = Arrays.asList(keyStore.getCertificateChain(alias));
certs.forEach(cert -> {
try {
chain.add(new X509CertificateHolder(cert.getEncoded()));
} catch (IOException | CertificateEncodingException e) {
log.error("Error while building certificate chain", e);
}
});
PrivateKey privateKey = (PrivateKey) (keyStore.getKey(alias, password));
ByteArrayOutputStream out = new ByteArrayOutputStream();
CAdESSignature signature = new CAdESSignature(detached);
signature.setCertificateStore(new CollectionStore(chain));
final Hashtable table = new Hashtable();
Attribute attr = new Attribute(CMSAttributes.signingTime,
new DERSet(new Time(new Date()))); // устанавливаем время подписи

408
table.put(attr.getAttrType(), attr);
AttributeTable attrTable = new AttributeTable(table);
//Добавление подписанта. Алгоритмы могут отличаться в зависимости от требований
signature.addSigner(JCP.PROVIDER_NAME,
JCP.GOST_DIGEST_OID,
JCP.GOST_EL_DH_OID,
privateKey,
certs,
CAdESType.CAdES_BES,
null,
false,
attrTable,
null);
signature.open(out);
signature.update(data);
signature.close();
byte[] signedCode = out.toByteArray();
//Использовать подписанный код для получение токена / сформированную открепленную
подпись УКЭП документа вместе с самим документом

Описание методов плагина

Метод Описание
getFinalCertsArray(): Init plugin, create store, . Cert: \{certificate: \{}, info: [] }, certificate is an original
Promise<Cert[]> cadesplugin Certificate object, info is an array [name, date_from, date_to, serial_number].
signMessage(message, cert, Sign message with selected certificate
detached): Promise

Last updated 2021-05-20 10:18:32 UTC

409