|
|
содержание .. 1 2 ..
Описание API ГИС МТ
Версия 78.0
Содержание
История изменений
6
1. Назначение и условия применения API ГИС МТ
51
1.1. Электронное взаимодействие участника оборота товаров и Оператора ГИС МТ
51
1.1.1. Требования к файлам обмена
53
1.1.2. Экранирование
54
1.1.3. Тип возвращаемого методами API контента
55
1.1.4. Указание параметров в строке запроса при работе с большими агрегатами
55
1.1.5. Аутентификация
57
1.1.5.1. Запрос авторизации
57
1.1.5.2. Получение аутентификационного токена
58
2. Обращение к API ГИС МТ
59
2.1. Метод получения списка КИ по заданному фильтру с подробной информацией о КИ . . . 59
2.2. Метод получения подробной информации о КИ (GET)
71
2.3. Метод получения списка товаров по заданному фильтру
77
2.4. Метод получения краткой информации о КИ/списке КИ (общедоступный)
92
2.5. Метод получения списка КИ по идентификатору
98
2.6. Метод получения информации о товаре по GTIN товара
105
2.7. Метод получения списка загруженных документов в ГИС МТ
112
2.8. Метод поиска чека по идентификатору
118
2.9. Метод поиска тела чека по идентификатору
122
2.10. Метод получения списка загруженных чеков в ГИС МТ
127
2.11. Метод получения содержимого загруженного документа по идентификатору
133
2.12. Метод получения списка товаров по номеру документа
143
2.13. Метод получения списка 10-ти значных кодов ТН ВЭД
147
2.14. Метод получения информации о маркированном товаре
149
2.15. Метод получения информации о маркированном товаре по началу КИ
159
2.16. Метод получения списка полученных КИ с возможностью фильтрации
168
2.17. Метод получения списка переданных КИ с возможностью фильтрации
182
2.18. Метод получения количества переданных КИ с возможностью фильтрации
193
2.19. Запрос информации об участнике оборота товаров по ИНН
197
2.20. Метод получения информации о средстве идентификации по началу КИ
199
2.21. Метод получения КИ и всех внутренних КИ
208
2.22. Метод получения информации о средстве идентификации (POST)
209
2.23. Метод получения КИ по идентификатору
216
2.24. Метод получения списка КИ по номеру документа
221
2.25. Метод поиска содержимого документа по идентификатору документа
221
2.26. Справочник по КМТ
222
3. Подача сведений в систему ГИС МТ через "Единый метод создания документов"
226
3.1. Единый метод создания документов
226
3.2. Типы документов для подачи сведений в ГИС МТ
229
3.2.1. Агрегирование
229
3.2.1.1. Агрегация
229
3.2.1.2. Трансформация
232
3.2.1.3. Расформирование
234
3.2.2. Формирование наборов
235
3.2.3. Операции с АТК
239
3.2.3.1. Формирование АТК
239
3.2.3.2. Трансформация АТК
241
3.2.3.3. Расформирование АТК
244
3.2.4. Ввод в оборот
245
3.2.4.1. Ввод в оборот. Производство РФ
245
3.2.4.2. Ввод в оборот. Полученных от физических лиц
256
3.2.4.3. Ввод в оборот. Производство вне ЕАЭС
258
3.2.4.4. Ввод в оборот. Трансграничная торговля
270
3.2.4.5. Ввод в оборот. На территории стран ЕАЭС (контрактное производство)
277
3.2.4.6. Ввод в оборот. Маркировка остатков
283
3.2.4.7. Ввод в оборот. Контрактное производство РФ
287
3.2.4.8. Ввод в оборот. Импорт с ФТС
293
3.2.4.8.1. Декларация на товары
304
3.2.5. Описание остатков
313
3.2.6. Возврат в оборот
316
3.2.7. Отгрузка
320
3.2.7.1. Отгрузка с выводом из оборота
324
3.2.7.2. Отгрузка при трансграничной торговле
328
3.2.7.3. Отгрузка в государствах-членах ЕАЭС с признанием КИ при объёмно-
сортовом учёте (экспорт)
332
3.2.7.4. Отгрузка из государств-членов ЕАЭС с признанием КИ при объёмно-сортовом
учёте (импорт)
338
3.2.7.5. Отгрузка из ЕАЭС с признанием КИ
343
3.2.7.6. Отгрузка в ЕАЭС с признанием КИ (экспорт)
350
3.2.7.7. Отмена отгрузки
355
3.2.7.8. Отмена отгрузки при трансграничной торговле
355
3.2.8. Приёмка
356
3.2.8.1. Приёмка отгрузки из РФ
356
3.2.8.2. Приёмка отгрузки из государств-членов ЕАЭС на документ "Отгрузка при
трансграничной торговле"
361
3.2.8.3. Приёмка отгрузки из государств-членов ЕАЭС на документ "Отгрузка из
ЕАЭС с признанием КИ"
374
3.2.8.4. Приёмка отгрузки из государств-членов ЕАЭС с признанием КИ при объёмно-
сортовом учёте
382
3.2.8.5. Приёмка отгрузки в ЕАЭС с признанием КИ (экспорт)
390
3.2.9. Вывод из оборота
394
3.2.10. Списание КИ
405
3.2.10.1. Списание не нанесённых КИ с/без СИ
405
3.2.10.2. Списание нанесённых КИ с СИ
407
3.2.11. Предоставление дополнительных сведений об РД для ввода товара в оборот
410
3.2.12. Перемаркировка
412
3.3. УПД на отгрузку
423
3.4. Заказ КМ. СУЗ
423
Список сокращений, условных обозначений и терминов
423
Справочники
427
Справочник "Список поддерживаемых товарных групп"
427
Справочник "Типы документов"
427
Справочник "Статусы проверок УПД"
431
Справочник "Типы договоров"
432
Справочник "Типы эмиссии КИ"
433
Справочник "Статусы КИ"
433
Актуальные статусы
433
Актуальные особые состояния
434
Справочник "Типы производства"
435
Справочник "Типы упаковки"
435
Справочник "Статусы заказов"
436
Справочник "Статусы документов"
437
Справочник "Причины вывода из оборота"
437
Справочник "Статусы ответов"
438
Справочник "Типы организаций"
441
Справочник "Статусы УОТ"
441
Справочник "Статусы заявки на регистрацию УОТ"
441
Справочник "Статусы документа в жизненном цикле SD"
442
Справочник "Статусная модель"
442
Справочник "Дополнительные параметры в ответе в зависимости от товарных групп"
443
Дополнительные параметры для ТГ "Альтернативная табачная продукция" и "Табачная
продукция"
443
Дополнительные параметры для ТГ "Обувные товары"
444
Дополнительные параметры для ТГ "Предметы одежды, бельё постельное, столовое,
туалетное и кухонное"
445
Дополнительные параметры для ТГ "Фотокамеры (кроме кинокамер), фотовспышки и
лампы-вспышки"
445
Дополнительные параметры для ТГ "Велосипеды и велосипедные рамы"
446
Дополнительные параметры для ТГ "Кресла-коляски"
446
Дополнительные параметры для ТГ "Духи и туалетная вода"
447
Дополнительные параметры для ТГ "Шины и покрышки пневматические резиновые
новые"
448
Дополнительные параметры для ТГ "Молочная продукция"
448
Дополнительные параметры для ТГ "Упакованная вода"
449
Дополнительные параметры для ТГ "Товары из натурального меха"
450
Дополнительные параметры для ТГ "Пиво, напитки, изготавливаемые на основе пива,
слабоалкогольные напитки"
450
Дополнительные параметры для ТГ "Антисептики и дезинфицирующие средства"
451
Примеры аутентификации по УКЭП / Подписание документов
451
Пример получения токена при авторизации с прикрепленной подписью / подписание
документов с открепленной подписью на 1С
451
Пример получения токена при авторизации REACT JS
452
Пример получения токена при авторизации с помощью прикрепленной подписи /
подписание документов с помощью открепленной подписи на Java
453
Описание методов плагина
454
История изменений
Дата
Версия
Изменения
документа
30.12.2021
78.0
В типах документов "Приёмка отгрузки из
государств-членов ЕАЭС с признанием КИ при
объёмно-сортовом учёте", "Ввод в оборот.
Производство РФ", "Ввод в оборот. Контрактное
производство РФ", "Ввод в оборот. Производство
вне ЕАЭС", "Ввод в оборот. Трансграничная
торговля", "Ввод в оборот. На территории стран
ЕАЭС (контрактное производство)",
"Перемаркировка" в комментарий параметра
"tnved_code" ("Код ТН ВЭД ЕАЭС (10 знаков)")
добавлена информация о возможности указания
устаревших и новых кодов ТН ВЭД
28.12.2021
77.0
Актуализировано описание типа документа
"Списание не нанесённых КИ с/без СИ" для
товарных групп "Молочная продукция",
"Упакованная вода";
В разделе "Требования к файлам обмена" добавлена
рекомендация по количеству КИ в одном
загружаемом документе;
В разделах "Метод поиска тела чека по
идентификатору" актуализирован пример запроса и
добавлены опциональные параметры запроса
"content" и "body";
В разделах "Метод получения содержимого
загруженного документа по идентификатору"
актуализирован пример запроса и добавлен
опциональный параметр запроса "body";
В типе документа "Перемаркировка"
скорректировано описание условий перемаркировки
6
Дата
Версия
Изменения
документа
21.12.2021
76.0
Добавлены типы документов прямой подачи
сведений "Отгрузка в ЕАЭС с признанием КИ
(экспорт)" (EAS_CROSSBORDER_EXPORT,
EAS_CROSSBORDER_EXPORT_CSV) и "Приёмка
отгрузки в ЕАЭС с признанием КИ (экспорт)"
(EAS_CROSSBORDER_EXPORT_ACCEPTANCE),
доступные для товарных групп "Обувные товары" и
"Шины и покрышки пневматические резиновые
новые". Идентификаторы данных типов документов
добавлены в "Справочник "Типы документов"";
Раздел "Приёмка отгрузки из государств-членов
ЕАЭС" (LP_ACCEPT_GOODS) разделён на два
подраздела: "Приёмка отгрузки из государств-
членов ЕАЭС на документ "Отгрузка при
трансграничной торговле"" (LP_ACCEPT_GOODS)
и "Приёмка отгрузки из государств-членов ЕАЭС на
документ "Отгрузка из ЕАЭС с признанием КИ""
(LP_ACCEPT_GOODS), в каждом из которых
дополнено описание параметров, скорректированы
значения параметров "trade_sender_name"
("Наименование Оператора ЕАЭС") и "tnved_code"
("Код ТН ВЭД ЕАЭС (10 знаков)") в примере тела
документа в формате * .json, произведена замена
значения допустимого идентификатора типа
документа LP_ACCEPT_GOODS_XML на
LP_ACCEPT_GOODS_CSV. Указанный
идентификатор (LP_ACCEPT_GOODS_CSV)
добавлен в «Справочник "Типы документов"»;
Дополнено описание параметров документов
"Отгрузка из ЕАЭС с признанием КИ"
(EAS_CROSSBORDER), "Отгрузка из государств-
членов ЕАЭС с признанием КИ при объёмно-
сортовом учёте (импорт)"
(EAS_GTIN_CROSSBORDER_IMPORT), "Приёмка
отгрузки из государств-членов ЕАЭС с признанием
КИ при объёмно-сортовом учёте"
(EAS_GTIN_CROSSBORDER_ACCEPTANCE),
"Отгрузка в государствах-членах ЕАЭС с
признанием КИ при объёмно-сортовом учёте
(экспорт)" (EAS_GTIN_CROSSBORDER_EXPORT)
7
Дата
Версия
Изменения
документа
15.12.2021
75.0
Актуализирован тип документа "Отгрузка в
государствах-членах ЕАЭС с признанием КИ при
объёмно-сортовом учёте (экспорт)" в формате *
.csv;
В разделе "Электронное взаимодействие участника
оборота товаров и Оператора ГИС МТ" удалён
устаревший адрес стенда и планируемая дата
изменения адреса стенда;
В типах документов "Ввод в оборот. Импорт с ФТС"
и "Ввод в оборот. Производство вне ЕАЭС" для
товарной группы "Упакованная вода"
скорректирована информация о подаче сведений в
соответствии с датой ДТ;
Добавлено уточнённое описание параметров "Цена
за единицу" и "Сумма НДС" в типы документов
"Отгрузка" (LP_SHIP_GOODS), "Отгрузка с
выводом из оборота" (LP_SHIP_RECEIPT),
"Отгрузка при трансграничной торговле"
(LP_SHIP_GOODS_CROSSBORDER), "Отгрузка из
ЕАЭС с признанием КИ" (EAS_CROSSBORDER),
"Отгрузка из государств-членов ЕАЭС с
признанием КИ при объёмно-сортовом учёте
(импорт)" (EAS_GTIN_CROSSBORDER_IMPORT),
"Отгрузка в государствах-членах ЕАЭС с
признанием КИ при объёмно-сортовом учёте
(экспорт)" (EAS_GTIN_CROSSBORDER_EXPORT)
, "Приёмка отгрузки из РФ" (LP_ACCEPT_GOODS),
"[Приёмка отгрузки из государств-членов
ЕАЭС]"(LP_ACCEPT_GOODS), "Приёмка отгрузки
из государств-членов ЕАЭС с признанием КИ при
объёмно-сортовом
учёте"(EAS_GTIN_CROSSBORDER_ACCEPTANC
E)", "Вывод из оборота" (LK_RECEIPT);
Подача сведений в типах документов
"Формирование АТК", "Трансформация АТК",
"Расформирование АТК" доступна для товарных
групп "Антисептики и дезинфицирующие
средства", "Биологически активные добавки к
пище" и "Кресла-коляски"
08.12.2021
74.0
В "Список сокращений, условных обозначений и
терминов" добавлены аббревиатуры ЕГРИП,
ЕГРЮЛ, ИП, МОД, РАФП, ЮЛ;
В типе документа "Ввод в оборот. Производство
РФ" скорректирована вложенность и комментарий
параметра "well_number" ("Номер скважины")
8
Дата
Версия
Изменения
документа
06.12.2021
73.0
Типы документов "Отгрузка при трансграничной
торговле", "Отмена отгрузки при трансграничной
торговле", "Приёмка отгрузки из государств-членов
ЕАЭС" на документ "Отгрузка при трансграничной
торговле" открыты для товарной группы
"Упакованная вода" для осуществления
взаимодействия с Республикой Беларусь;
Подача сведений в типах документов
"Формирование АТК", "Трансформация АТК",
"Расформирование АТК" доступна для товарной
группы "Упакованная вода";
Для типов документов "Формирование АТК" и
"Трансформация АТК" актуализировано
примечание о вложенности типов КИ для параметра
"ki" ("КИ");
В типе документа "Расформирование АТК"
изменена обязательность параметра "atk" ("АТК");
В "Справочник "Типы упаковки"" внесено
уточнение о вложенности типов КИ для кода "АТК"
("Агрегированный таможенный код")
02.12.2021
72.0
В запросы методов раздела "Аутентификация"
добавлено указание на версию v3;
Актуализировано описание параметров запроса в
разделах Метод получения списка загруженных
документов в ГИС МТ (/facade/doc/listV2) и Метод
получения списка загруженных чеков в ГИС МТ
(/facade/receipt/listV2);
Для типа документа "Вывод из оборота" добавлено
указание на доступность подачи сведений для
товарной группы "Биологически активные добавки
к пище", дополнено описание параметра
"state_contract_id" ("Идентификатор
государственного контракта") В тип документа
"Вывод из оборота" в формате * .json добавлен
необязательный параметр "importer_id" ("ИНН (или
аналог) импортёра"), применимый, если значение
параметра "action" ("Причина вывода из оборота") =
"EEC_EXPORT" ("Экспорт в страны ЕАЭС"),
актуализирован пример документа в формате *
.json;
Скорректировано описание параметров документа
"Перемаркировка"
9
Дата
Версия
Изменения
документа
01.12.2021
71.0
Добавлено описание типа документа "Описание
остатков" для товарной группы "Фотокамеры
(кроме кинокамер), фотовспышки и лампы-
вспышки";
В документе "Ввод в оборот. Маркировка остатков"
для товарной группы "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки"
добавлено уточнение о доступности документа
только для комплектов, в пример тела документа в
формате * .json добавлен параметр "ki" ("КИ")
30.11.2021
70.0
В разделе "Электронное взаимодействие участника
оборота товаров и Оператора ГИС МТ" добавлено
рекомендованное ограничение по количеству
запросов в секунду;
В описании типа документа "Ввод в оборот.
Производство РФ" параметр "production_order"
("Тип производственного заказа") изменён на
"production_type" ("Тип производственного заказа"),
актуализированы пример документа в формате *
.json;
В описании документа "Формирование наборов"
актуализированы комментарии параметров
"unitSerialNumber" ("Код идентификации набора"),
"sntins" ("Список КИ и/или КИК, входящих в
набор")
29.11.2021
69.0
Подача сведений в типе документа "Ввод в оборот.
Импорт с ФТС" доступна для товарной группы
"Упакованная вода";
Указано ограничения на подачу сведений в типе
документа "Ввод в оборот. Производство вне
ЕАЭС", если дата ДТ ≥ 30.11.2021
26.11.2021
68.0
Для товарной группы "Шины и покрышки
пневматические резиновые новые" доступна подача
сведений в типе документа "Отгрузка из ЕАЭС с
признанием КИ";
Актуализировано описание параметра "uitu" ("Код
расформировываемого агрегата") для типа
документа "Расформирование"
10
Дата
Версия
Изменения
документа
22.11.2021
67.0
Актуализировано описание типа документа
"Отгрузка из ЕАЭС с признанием КИ";
Актуализирован "Список сокращений, условных
обозначений и терминов";
Расширено количество параметров в разделе
"Справочник "Дополнительные параметры в ответе
в зависимости от товарных групп"";
В описании документов "Отгрузка в государствах-
членах ЕАЭС с признанием КИ при объёмно-
сортовом учёте (экспорт)" и "Отгрузка из
государств-членов ЕАЭС с признанием КИ при
объёмно-сортовом учёте (импорт)" скорректировано
описание параметра "gtin" ("Код товара
потребительской упаковки товара")
16.11.2021
66.0
Актуализирован пример типа документа "Ввод в
оборот. Маркировка остатков" в формате * .json;
Скорректирована таблица типа документа "Приёмка
отгрузки из государств-членов ЕАЭС с признанием
КИ при объёмно-сортовом учёте";
Актуализировано описание параметра
"well_number" для типов документов "Ввод в
оборот. Производство РФ" и "Ввод в оборот.
Контрактное производство РФ"
11
Дата
Версия
Изменения
документа
12.11.2021
65.0
Типы документов "Агрегация", "Трансформация",
"Расформирование", "Формирование наборов",
"Формирование АТК", "Ввод в оборот.
Производство РФ", "Ввод в оборот. Производство
вне ЕАЭС", "Ввод в оборот. Трансграничная
торговля", "Ввод в оборот. На территории стран
ЕАЭС (контрактное производство)", "Ввод в оборот.
Контрактное производство РФ", "Ввод в оборот.
Импорт с ФТС", "Ввод в оборот. Маркировка
остатков" "Возврат в оборот", "Отгрузка", "Отгрузка
с выводом из оборота", "Отмена отгрузки",
"Приёмка отгрузки из РФ", "Вывод из оборота",
"Списание не нанесённых КИ с/без СИ", "Списание
нанесённых КИ с СИ", "Перемаркировка" доступны
для товарной группы "Антисептики и
дезинфицирующие средства";
В "Справочник "Список поддерживаемых товарных
групп"" добавлен код товарной группы
"Антисептики";
В разделах "Метод получения списка КИ по
заданному фильтру с подробной информацией о
КИ" и Метод получения информации о
маркированном товаре" скорректировано описание
параметра "producedDate";
В "Метод получения содержимого загруженного
документа по идентификатору" добавлен
обязательный параметр строки ответа
"count_children" ("Кол-во вложенных КИ"),
актуализирован пример тела ответа
03.11.2021
64.0
В тип документа "Вывод из оборота" в формате *
.json добавлен необязательный параметр
"destination_country_code" ("Код страны
назначения"), применимый, если значение
параметра "action" ("Причина вывода из оборота") =
"EEC_EXPORT" ("Экспорт в страны ЕАЭС"),
актуализирован пример тела документа в формате *
.json
01.11.2021
63.0
В документе "Ввод в оборот. Маркировка остатков"
для товарной группы "Духи и туалетная вода"
актуализирован комментарий параметра "ki" ("КИ");
В документе "Описание остатков" для товарной
группы "Духи и туалетная вода" добавлено
уточнение о доступности документа только для
комплектов
12
Дата
Версия
Изменения
документа
26.10.2021
62.0
Добавлено описание типов документов "Отгрузка
из государств-членов ЕАЭС с признанием КИ при
объёмно-сортовом учёте (импорт)" (плановая дата
доступности создания документа на промышленном
стенде - 1 ноября 2021 года) и "Приёмка отгрузки
из государств-членов ЕАЭС с признанием КИ при
объёмно-сортовом учёте" (плановая дата
доступности создания документа на
демонстрационном и промышленном стендах - 10
ноября 2021 года) для товарной группы "Молочная
продукция";
В "Справочник "Типы документов"" добавлены
идентификаторы типов документов "Отгрузка из
государств-членов ЕАЭС с признанием КИ при
объёмно-сортовом учёте (импорт)" и "Приёмка
отгрузки из государств-членов ЕАЭС с признанием
КИ при объёмно-сортовом учёте"
13
Дата
Версия
Изменения
документа
22.10.2021
61.0
В "Метод получения информации о маркированном
товаре по началу КИ" добавлен необязательный
параметр строки запроса "full_cis" ("Флаг,
включающий поиск по полному значению КИ"),
актуализированы примеры строки и тела запроса,
тела ответа;
В типы документов "Ввод в оборот. Производство
РФ", "Ввод в оборот. Производство вне ЕАЭС",
"Ввод в оборот. Контрактное производство РФ",
"Ввод в оборот. Маркировка остатков", "Ввод в
оборот. Трансграничная торговля", "Ввод в оборот.
На территории стран ЕАЭС (контрактное
производство)", "Перемаркировка", "Приёмка
отгрузки из государств-членов ЕАЭС", Приёмка
отгрузки из государств-членов ЕАЭС с признанием
КИ при объёмно-сортовом учёте" добавлен массив
"certificate_document_data" ("Массив, содержащий
данные документов, подтверждающих
соответствие") с параметрами "certificate_number"
("Номер документа разрешительной
документации"), "certificate_date" ("Дата документа
разрешительной документации") и "certificate_type"
("Вид документа разрешительной документации");
В "Метод получения информации о маркированном
товаре" добавлены параметры ответа "certDocList"
("Массив, содержащий данные документов,
подтверждающих соответствие"), "type" ("Вид
документа разрешительной документации"),
"number" ("Номер документа разрешительной
документации"), "date" ("Дата документа
разрешительной документации");
В описание типов документов "Ввод в оборот.
Производство РФ" и "Ввод в оборот. Контрактное
производство РФ" для товарной группы
"Упакованная вода" добавлен параметр
"well_number" ("Номер скважины"),
актуализированы примеры тела документов в
форматах * .json, * .xml, * .csv;
В разделы "Метод получения списка КИ по
идентификатору", "Метод получения краткой
информации о КИ/списке КИ (общедоступный)",
"Метод получения информации о маркированном
товаре", "Метод получения подробной информации
о КИ (GET)" добавлен необязательный параметр
ответа "wellNumber" ("Номер скважины") для
товарной группы "Упакованная вода"
14
Дата
Версия
Изменения
документа
13.10.2021
60.0
Актуализирован адрес стенда для
демонстрационного контура ГИС МТ в разделе
"Электронное взаимодействие участника оборота
товаров и Оператора ГИС МТ";
Скорректировано описание в типе документа
"Отгрузка из ЕАЭС с признанием КИ"
08.10.2021
59.0
Актуализированы адреса стендов для
демонстрационного и промышленного
(продуктивного) контуров ГИС МТ в разделе
"Электронное взаимодействие участника оборота
товаров и Оператора ГИС МТ"
01.10.2021
58.0
В разделе "Ввод в оборот. Импорт с ФТС"
актуализирован комментарий параметра "cis" ("ki"
("КИ"), "kigu" ("КИГУ"), "kik" ("КИК"), "kitu"
("КИТУ") или "atk" ("АТК")");
Добавлено описание типа документа "Отгрузка из
ЕАЭС с признанием КИ";
В описании типа документов "Приёмка отгрузки из
государств-членов ЕАЭС" актуализированы
описания параметров "certificate_document_data"
("Массив, содержащий данные документов,
подтверждающих соответствие"), "certificate_type"
("Вид документа, подтверждающего соответствие"),
"certificate_number" ("Номер документа,
подтверждающего соответствие"), "certificate_date"
("Дата документа, подтверждающего
соответствие"), а также пример тела документа в
формате * .json при приёмке отгрузки при
трансграничной торговле;
В описании типа документов "Отгрузка при
трансграничной торговле" добавлены параметры
"product_cost" (Цена за единицу), "product_tax"
("Сумма НДС"), certificate_document_data"
("Массив, содержащий данные документов,
подтверждающих соответствие"), "certificate_type"
("Вид документа, подтверждающего соответствие"),
"certificate_number" ("Номер документа,
подтверждающего соответствие"), "certificate_date"
("Дата документа, подтверждающего
соответствие"), а также актуализирован пример тела
документа в формате * .json;
В "Справочник "Типы упаковки"" для кода "АТК"
("Агрегированный таможенный код") добавлено
ограничение использования для товарной группы
"Никотиносодержащая продукция";
Скорректированы адреcа стендов в разделе
"Электронное взаимодействие участника оборота
товаров и Оператора ГИС МТ"
15
Дата
Версия
Изменения
документа
28.09.2021
57.0
Добавлено описание типа документа "Описание
остатков" для товарной группы "Духи и туалетная
вода"
23.09.2021
56.0
В "Справочник "Типы упаковки"" для кода "АТК"
("Агрегированный таможенный код") добавлено
ограничение использования для товарной группы
"Никотиносодержащая продукция";
В разделах "Метод получения информации о
маркированном товаре", "Метод получения
информации о маркированном товаре по началу
КИ", "Метод получения списка товаров по
заданному фильтру" актуализированы описание и
комментарий параметра ответа "status" ("Статус
КИ");
Актуализирована информация о стендах в разделе
"Электронное взаимодействие участника оборота
товаров и Оператора ГИС МТ";
Актуализированы типы документов "Приёмка",
"Отгрузка при трансграничной торговле (объёмно-
сортовой учёт)", "Отгрузка при трансграничной
торговле"
16
Дата
Версия
Изменения
документа
16.09.2021
55.0
В описании типа документов "Вывод из оборота"
актуализированы значения параметров "action"
("Причина вывода из оборота"), "document_type"
("Тип первичного документа"), актуализирован
комментарий параметра "cis" ("КИ"), добавлен
параметр "state_contract_id" ("Идентификатор
государственного контракта");
В описании типов документов "Формирование
АТК", "Трансформация АТК" актуализированы
описания параметров "products_list" ("Массив,
содержащий список агрегируемых в АТК КИ,
КИГУ, КИК"), "products_list" ("Массив, содержащий
список перемещаемых КИ, КИГУ, КИК") и
комментарии параметров "ki" ("КИ");
В описании типов документов "Трансформация
АТК", "Расформирование АТК" актуализированы
комментарии параметров "atk"
("Трансформируемый АТК") и "atk" ("АТК");
Актуализирован "Справочник "Причины вывода из
оборота"";
В описание типа документа "Перемаркировка"
добавлено условие перемаркировки КИН:
обязательно указание предыдущего КИН в поле
"last_uin" ("Предыдущий КИ/КИК/КИН") для всех
причин перемаркировки;
В разделе "Метод получения содержимого
загруженного документа по идентификатору"
актуализированы примеры строки запроса и
первого запроса, добавлены примеры запроса для
получения информации по первым нескольким КИ
из документа и по следующим нескольким КИ из
документа, параметры запроса "paging"
("Пагинация"), "offset" ("Смещение по КИ в теле
документа"), "content" ("Возвращать контент")
17
Дата
Версия
Изменения
документа
10.09.2021
54.0
В "Метод получения списка КИ по
идентификатору" добавлены параметры ответа
"withdrawReason" ("Причина вывода из оборота") и
"withdrawReasonOther" ("Введенная вручную
причина вывода из оборота");
Тип документа "Ввод в оборот. Полученных от
физических лиц" недоступен для товарной группы
"Упакованная вода";
Для типа документа "Вывод из оборота" доступна
причина вывода из оборота STATE_SECRET
("Продажа по сделке, составляющей гос. тайну")
для товарных групп "Духи и туалетная вода",
"Молочная продукция", "Обувные товары",
"Предметы одежды, бельё постельное, столовое,
туалетное и кухонное", "Упакованная вода",
"Фотокамеры (кроме кинокамер), фотовспышки и
лампы-вспышки", "Шины и покрышки
пневматические резиновые новые";
Для параметра "action" ("Причина вывода из
оборота") добавлено новое значение
STATE_SECRET ("Продажа по сделке,
составляющей гос. тайну"), добавлен новый
параметр "state_contract_id" ("Идентификатор
государственного контракта"), обязательный при
указании причины списания STATE_SECRET
("Продажа по сделке, составляющей гос. тайну")
18
Дата
Версия
Изменения
документа
03.09.2021
53.0
В разделе "Вывод из оборота" актуализирован
пример тела документа в формате * .xml;
В "Единый метод создания документов" добавлен
параметр тела запроса "signExt" ("Откреплённая
УКЭП Оператора РБ, закодированная в base64");
Добавлен тип документа "Отгрузка при
трансграничной торговле (объёмно-сортовой учёт)"
для товарной группы "Молочная продукция";
В тип документа "Приёмка" (для приёмки отгрузки
при трансграничном перемещении для товарной
группы "Молочная продукция") добавлены
параметры "gtin" ("Код товара передаваемых КИ"),
"cis_quantity" ("Количество передаваемых КИ по
данному коду товара"), "group_quantity"
("Количество передаваемых КИГУ по данному коду
товара") и пример тела документа в формате * .json
для приёмки отгрузки при трансграничной торговле
(объёмно-сортовой учёт) для товарной группы
"Молочная продукция";
В "Справочник "Типы документов"" добавлен тип
документа "Отгрузка при трансграничной торговле
(объёмно-сортовой учёт)";
В методы "Метод получения списка КИ по номеру
документа", "Метод получения списка товаров по
номеру документа", "Метод поиска содержимого
документа по идентификатору документа", "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ", "Метод получения
КИ и всех внутренних КИ", "Метод получения
информации о средстве идентификации (POST)",
"Метод поиска чека по идентификатору" добавлен
параметр "pg" ("Товарная группа");
В методы "Метод получения списка товаров по
заданному фильтру", "Метод получения списка
полученных КИ с возможностью фильтрации",
"Метод получения списка КИ по заданному фильтру
с подробной информацией о КИ" добавлен
параметр ответа "nextPage" ("Признак наличия
следующей страницы"), актуализированы примеры
ответа в формате * .json
30.08.2021
52.0
В документе "Приёмка" отгрузки при
трансграничной торговле добавлено значение для
параметра "release_order_number"
19
Дата
Версия
Изменения
документа
23.08.2021
51.0
Актуализированы параметры запроса методов
"Метод получения списка полученных КИ с
возможностью фильтрации" и "Метод получения
списка переданных КИ с возможностью
фильтрации" (добавлены параметры "packageTypes"
и "remarkHistory");
В описание типа документа "Формирование
наборов" добавлена информация о доступности
документа для товарной группы "Молочная
продукция", информация о создании и
расформировании КИН, списании КИН без
вложений
18.08.2021
50.0
Для метода "Единый метод создания документов"
актуализированы ответ, перечень ошибок и
примечание о применимости для товарных групп
"Альтернативная табачная продукция",
"Никотиносодержащая продукция", "Табачная
продукция";
В описании типов документов "Формирование
АТК", "Трансформация АТК" актуализированы
описания параметров "products_list" ("Массив,
содержащий список агрегируемых в АТК КИ,
КИГУ, КИК), "products_list" ("Массив, содержащий
список перемещаемых КИ, КИГУ, КИК") и
комментарии параметров "ki" ("КИ");
В описании типов документов "Трансформация
АТК", "Расформирование АТК" актуализированы
комментарии параметров "atk"
("Трансформируемый АТК") и "atk" ("АТК");
Типы документов "Агрегация", "Ввод в оборот.
Контрактное производство РФ", "Ввод в оборот.
Производство вне ЕАЭС", "Ввод в оборот.
Производство РФ", "Ввод в оборот. Трансграничная
торговля", "Вывод из оборота", "Отгрузка",
"Отгрузка с выводом из оборота", "Отмена
отгрузки", "Перемаркировка", "Приёмка",
"Расформирование", "Списание нанесённых КИ с
СИ", "Списание не нанесённых КИ с/без СИ",
"Трансформация" доступны для товарной группы
"Биологически активные добавки к пище"
20
Дата
Версия
Изменения
документа
29.07.2021
49.0
В разделе "Метод получения списка загруженных
чеков в ГИС МТ" актуализировано описание
параметра запроса "orderColumn" ("Название
столбца, по которому будет производиться
сортировка");
Актуализирован комментарий параметра запроса
"cisMatchMode"("Режим фильтрации по КИ") в
разделах "Метод получения списка КИ по
заданному фильтру с подробной информацией о
КИ", "Метод получения списка товаров по
заданному фильтру", "Метод получения списка
полученных КИ с возможностью фильтрации",
"Метод получения списка переданных КИ с
возможностью фильтрации", "Метод получения
количества переданных КИ с возможностью
фильтрации";
Для типа документа "Трансформация" для
параметра "uit_uitu" ("КИ/КИН для
добавления/изъятия") добавлен комментарий;
В описании типа документа "Отгрузка при
трансграничной торговле" актуализированы пример
тела документа в формате * .json и комментарий
параметра "document_date" ("Дата первичного
документа")
19.07.2021
48.0
В описание типа документа "Формирование
наборов" добавлено уточнение, что при вводе
набора в оборот, набор не должен быть пустым: в
набор должны быть вложены КИ и/или КИК. При
вводе в оборот КИ и/или КИК, вложенных в набор
со статусом "APPLIED" ("Эмитирован. Получен"),
набор будет автоматически расформирован;
В описании типов документов "Ввод в оборот.
Производство вне ЕАЭС" и "Ввод в оборот. Импорт
с ФТС" добавлены сведения о логике обработки
документов для товарной группы "Молочная
продукция" в зависимости от указанной даты ДТ;
В описании типа документа "Предоставление
дополнительных сведений об РД для ввода товара в
оборот" актуализирован комментарий параметра
"code" ("КИ или агрегат, к которым осуществляется
загрузка РД")
21
Дата
Версия
Изменения
документа
14.07.2021
47.0
В документе "Декларация на товары" удалён
параметр "cisIntId" ("Цифровой идентификатор
применения блока информации, содержащейся в
КИ");
В разделах "Метод получения краткой информации
о КИ/списке КИ (общедоступный)", "Метод
получения списка КИ по идентификатору", "Метод
получения КИ по идентификатору"
актуализировано описание параметра "ownerInn"
("ИНН собственника товара");
Актуализирован "Метод получения информации о
товаре по GTIN товара";
В "Справочник "Дополнительные параметры в
ответе в зависимости от товарных групп"" добавлен
раздел "Дополнительные параметры для ТГ "Пиво,
напитки, изготавливаемые на основе пива,
слабоалкогольные напитки"", актуализированы
разделы товарных групп;
В описании типа документа "Вывод из оборота" для
параметра "document_type" ("Тип первичного
документа"), указанного в массиве "products"
("Массив, содержащий список КИ") и вне данного
массива, изменено название первичного документа
"DESTRUCTION_ACT" ("Акт уничтожения") на
"DESTRUCTION_ACT" ("Акт уничтожения
(утраты/утилизации)")
07.07.2021
46.0
Изменён пример в формате * .json для типа
документа "Ввод в оборот. Импорт с ФТС" товарной
группы "Молочная продукция";
Дополнено описание типа документа "Ввод в
оборот. Производство вне ЕАЭС", добавлены
примеры в формате * .json и * .xml для товарной
группы "Молочная продукция"
05.07.2021
45.0
Актуализированы описания документов "Ввод в
оборот. Производство вне ЕАЭС" и "Ввод в оборот.
Импорт с ФТС" в связи с реализацией подачи
сведений об импорте товаров в групповых
упаковках для товарной группы "Молочная
продукция"
22
Дата
Версия
Изменения
документа
01.07.2021
44.0
В разделе "Метод получения списка товаров по
заданному фильтру" актуализированы комментарии
для параметров ответа "status" (Статус товара/КИ),
"statusExt" (Дополнительный статус товара);
Добавлено описание типа документа
"Предоставление дополнительных сведений об РД
для ввода товара в оборот"
(CIRCULATION_INFORMATION);
Тип документа "Предоставление дополнительных
сведений об РД для ввода товара в оборот"
(CIRCULATION_INFORMATION) добавлен в
"Справочник "Типы документов"";
Тип документа "Приёмка" недоступен для товарной
группы "Молочная продукция". Подача сведений в
документе "Приёмка" для товарной группы
"Молочная продукция" остаётся доступной при
трансграничной торговле;
Тип документа "Описание остатков" недоступен для
товарных групп
23
Дата
Версия
Изменения
документа
25.06.2021
43.0
В описание типа документа "Ввод в оборот. Импорт
с ФТС" добавлен пример запроса в формате * .json
для товарных групп "Обувные товары" и "Предметы
одежды, бельё постельное, столовое, туалетное и
кухонное", изменён пример запроса для товарной
группы "Молочная продукция", внесено уточнение
в описание параметров "productSize" ("Размер"),
"color" ("Цвет"), "children" ("Массив, содержащий
список вложенных КИ");
В "Метод получения краткой информации о
КИ/списке КИ (общедоступный)" и "Метод
получения списка КИ по идентификатору" добавлен
параметр ответа "producerInn" ("ИНН
производителя товара"), актуализирован пример
ответа;
В описание типов документов "Ввод в оборот.
Производство вне ЕАЭС" и "Ввод в оборот. Импорт
с ФТС" для товарной группы "Молочная
продукция" добавлено примечание по указанию
агрегата и его вложений, имеющих признак
подконтрольности ВСД, в документе в формате *
.csv;
В описание типа документа "Формирование
наборов" в комментарий параметра
"unitSerialNumber" ("Код идентификации набора")
добавлено уточнение об указании типа эмиссии
"Произведён в РФ" (LOCAL) при заказе КМ на
наборы, ввозимые в РФ;
В разделе "Метод получения списка товаров по
заданному фильтру" актуализирован комментарий
параметра ответа "date" ("Дата сертификата"),
параметр ответа "receiptDateTime" ("Дата вывода из
оборота") переименован в "receiptDate" ("Дата
вывода из оборота") и актуализирован комментарий,
удалён комментарий параметра ответа
"certificateDate" ("Дата документа,
подтверждающего соответствие")
24
Дата
Версия
Изменения
документа
18.06.2021
42.0
В типах документов "Ввод в оборот. Производство
РФ", "Ввод в оборот. Производство вне ЕАЭС",
"Ввод в оборот. Трансграничная торговля", "Ввод в
оборот. На территории стран ЕАЭС (контрактное
производство)", "Ввод в оборот. Контрактное
производство РФ" добавлено правило указания ВСД
для АТК;
В разделе "Требования к файлам обмена" добавлено
ограничение для указания древовидной структуры
агрегата при подаче файла в формате * .csv;
В описании параметров типа документа "Вывод из
оборота" параметр "document_custom_name"
("Наименование первичного документа")
скорректирован на
"primary_document_custom_name" ("Наименование
первичного документа");
В разделе "Метод получения списка 10-ти значных
кодов ТН ВЭД" изменено описание параметров
запроса "page", "limit", "sort", "direction",
"validRequest", "prefix", "pg", указано ограничение
на размер тела ответа;
В типе документа "Агрегирование (ТГ "Табачная
продукция", "Альтернативная табачная продукция"
и "Никотиносодержащая продукция")" изменён
формат даты первичного документа на "yyyy-MM-
dd"
15.06.2021
41.00
Актуализировано описание и пример для типа
документа "Приёмка" при трансграничном
перемещении;
Тип документа "Ввод в оборот. Маркировка
остатков" недоступен для товарной группы
"Обувные товары" Тип документа "Описание
остатков" недоступен для товарной группы
"Альтернативная табачная продукция"
07.06.2021
40.0
Тип документов "Приёмка" недоступен для
товарной группы "Молочная продукция". Подача
сведений в документе "Приёмка" остаётся
доступной при трансграничной торговле
25
Дата
Версия
Изменения
документа
03.06.2021
40.0
В примере в формате * .json типа документа
"Приёмка" параметр "turnover-type" ("Код типа
отгрузки") заменён на "turnover_type" ("Код типа
отгрузки");
Актуализировано описание типа документа
"Формирование наборов";
В "Дополнительные параметры для ТГ "Молочная
продукция"" добавлены параметры ответа:
"declNumber" ("Номер декларации о соответствии"),
"regNumber" ("Номер свидетельства о
государственной регистрации"), "certNumber"
("Номер сертификата соответствия");
В справочник "Дополнительные параметры для ТГ
"Альтернативная табачная продукция" и "Табачная
продукция"" добавлен параметр
"rawTobaccoWeight" ("Масса табачного сырья");
"Метод получения информации о товаре по GTIN
товара" используется в версии 3 (планируемая дата
отключения метода - ноябрь 2021 года). Вместо
данного метода рекомендуется использовать "Метод
получения информации о товаре по GTIN товара" в
True API (подробнее см. в "Описание True API");
В разделе "Запрос информации об участнике
оборота товаров по ИНН" актуализированы пример
строки запроса и пример ответа, из таблицы
параметров ответа удалён параметр
"productGroupInfo" ("Тип участника")
26
Дата
Версия
Изменения
документа
31.05.2021
39.0
Подача сведений в типе документа "Ввод в оборот.
Производство вне ЕАЭС" недоступна для товарной
группы "Обувные товары" с 01.06.2021;
В типах документов "Ввод в оборот. Производство
РФ", "Ввод в оборот. Производство вне ЕАЭС",
"Ввод в оборот. Трансграничная торговля", "Ввод в
оборот. На территории стран ЕАЭС (контрактное
производство)", "Ввод в оборот. Контрактное
производство РФ" актуализирован комментарий
параметра "vsd_number" ("Номер ВСД");
В типе документа "Ввод в оборот. Импорт с ФТС"
актуализированы комментарий параметра
"vsd_number" ("Номер ВСД") и примечание по
заполнению параметра "Номер ВСД" документа в
формате * .csv;
В разделе "Запрос авторизации" в URL строки
запроса метода добавлено указание на
использование версии 3;
В документе "Приёмка" в формате * .json параметр
"products_list" изменён на "products" ("Массив,
содержащий список передаваемых КИ"), из
таблицы параметров удалён параметр "cis",
добавлено примечание к таблице описания
параметров документа
25.05.2021
38.0
Актуализирован пример строки запроса в разделе
"Метод получения подробной информации о КИ
(GET)";
В разделе "Метод получения списка КИ по
заданному фильтру с подробной информацией о
КИ" актуализирован пример запроса;
В разделе "Метод получения краткой информации о
КИ/списке КИ (общедоступный)" в ответе в
параметре "productGroup" возвращается значение
"lp" (не "clothes") для товарной группы "Предметы
одежды, бельё постельное, столовое, туалетное и
кухонное"
20.05.2021
37.0
Добавлено описание типов документов "Ввод в
оборот. Импорт с ФТС", "Формирование АТК",
"Расформирование АТК", "Трансформация АТК"
для товарной группы "Молочная продукция"
18.05.2021
36.0
Скорректирован тип документа "Вывод из оборота";
Актуализирован "Справочник "Статусы
документов""
27
Дата
Версия
Изменения
документа
17.05.2021
35.0
В документе "Приёмка" длина значения параметра
"exporter_taxpayer_id" ("УНП экспортёра") должно
соответствовать 8/9/10/12/14 символов;
Расширено описание параметра "document_type"
("Тип первичного документа") типа документа
"Вывод из оборота";
Для типов документов "Ввод в оборот.
Производство РФ", "Приёмка", "Ввод в оборот.
Производство вне ЕАЭС", "Ввод в оборот.
Контрактное производство РФ", "Ввод в оборот.
Трансграничная торговля", "Ввод в оборот. На
территории стран ЕАЭС (контрактное
производство)" добавлено описание ФЛК по
обработке значения параметра "vsd_number"
("Номер ВСД"); В ответах методов "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ", "Метод получения
подробной информации о КИ (GET)", "Метод
получения информации о средстве идентификации
по началу КИ", "Метод получения информации о
средстве идентификации (POST)" параметр
"receiptDate" ("Дата вывода из оборота") считать
устаревшим: вместо него в ответе возвращается
параметр "receiptDateTime" ("Дата вывода из
оборота"); В разделах "Метод получения списка КИ
по заданному фильтру с подробной информацией о
КИ", "Метод получения содержимого загруженного
документа по идентификатору" доступно указание
КИГУ для товарных групп "Молочная продукция" и
"Упакованная вода";
Добавлен параметр ответа "packageTypeDescription"
("Описание типа упаковки") в "Метод получения
информации о маркированном товаре";
Добавлен код "GROUP" ("Групповая упаковка") в
"Справочник "Типы упаковки""
28
Дата
Версия
Изменения
документа
11.05.2021
34.0
Типы документов "Отгрузка", "Отгрузка с выводом
из оборота", "Отмена отгрузки", "Приёмка" в
формате * .xml недоступны для товарной группы
"Молочная продукция";
В тип документа "Вывод из оборота" добавлен
параметр "withdrawal_type_other" ("Другая
причина") в связи с реализацией функциональности
вывода из оборота по причине "Другое" для всех
товарных групп, кроме товарных групп
"Альтернативная табачная продукция",
"Никотиносодержащая продукция" и "Табачная
продукция";
Актуализирован "Справочник "Причины вывода из
оборота"";
Актуализирован справочник "Актуальные особые
состояния";
В ответ в разделах "Метод получения подробной
информации о КИ (GET)" и "Метод получения
информации о маркированном товаре" добавлен
параметр "withdrawReasonOther" ("Причина вывода
из оборота (другое)"
29
Дата
Версия
Изменения
документа
06.05.2021
33.0
Тип документов "Ввод в оборот. Маркировка
остатков" недоступен для товарной группы
"Предметы одежды, бельё постельное, столовое,
туалетное и кухонное";
Добавлен новый параметр ответа "expirationDate"
("Дата истечения срока годности"), являющийся
обязательным для товарной группы "Молочная
продукция", в разделы "Метод получения списка
товаров по заданному фильтру", "Метод получения
информации о маркированном товаре", "Метод
получения информации о маркированном товаре по
началу КИ";
Добавлен параметр ответа "additionalProp" ("Список
ошибок обработки документа") в "Метод получения
списка КИ по заданному фильтру с подробной
информацией о КИ", "Метод получения списка
товаров по номеру документа";
Добавлены параметры ответа "additionalProp"
("Контент документа") и "additionalProp" ("Список
ошибок обработки документа") в "Метод получения
списка загруженных документов в ГИС МТ",
"Метод поиска чека по идентификатору", "Метод
поиска тела чека по идентификатору", "Метод
получения списка загруженных чеков в ГИС МТ";
Добавлены параметры ответа "additionalProp"
("Список ошибок обработки документа") и
"additionalProp" ("Внутренний параметр системы") в
"Метод получения содержимого загруженного
документа по идентификатору";
Удалён пример запроса в формате JSON из раздела
"Метод получения списка товаров по заданному
фильтру" Актуализирован пример запроса в разделе
"Метод получения подробной информации о КИ
(GET)";
Актуализирован пример запроса в разделе "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ"
30
Дата
Версия
Изменения
документа
22.04.2021
32.0
Тип документа "Ввод в оборот. Маркировка
остатков" доступен для единиц товаров товарной
группы "Обувные товары", описанных в КМТ по
полному атрибутивному составу. В текущей
реализации заполнение параметра "kitu" ("КИТУ")
для товарной группы "Обувные товары" недоступно
в документе "Ввод в оборот. Маркировка остатков".
Плановый срок отключения возможности создания
документа для товарной группы "Обувные товары" -
16.06.2021;
Для документа "Ввод в оборот. Маркировка
остатков" параметр "products_list" ("Список
сведений о товарах") обязательный для заполнения;
"Метод получения краткой информации о
КИ/списке КИ (общедоступный)" является
устаревшим и в дальнейшем будет удалён из
описания, вместо него использовать "Метод
получения списка КИ по идентификатору"
(/cis/cis_list, POST)
16.04.2021
31.2
Расширено описание параметра "cis" документа
"Ввод в оборот. Импорт с ФТС";
Актуализирован "Справочник "Список
поддерживаемых товарных групп"";
Дополнено ограничение на использование значений
для параметра "withdrawal_type" ("Причина вывода
из оборота") в документе "Отгрузка с выводом из
оборота" для товарной группы "Молочная
продукция";
В документе "Возврат в оборот" удалено значение
RECEIPT_RETURN ("Чек возврата") параметра
"return_type"
05.04.2021
31.1
Дополнено описание параметров документ "Ввод в
оборот. Импорт с ФТС";
Актуализирован состав параметров документа
"Декларация на товары";
Актуализирован "Справочник "Дополнительные
параметры в ответе в зависимости от товарных
групп""; В ответ в разделе "Метод получения
содержимого загруженного документа по
идентификатору" добавлен параметр "fts_response"
("Код решения по товару")
31
Дата
Версия
Изменения
документа
01.04.2021
31.0
Добавлена ТГ "Никотинсодержащая продукция" в
"Справочник "Список поддерживаемых товарных
групп"";
Документы "Описание остатков", "Агрегирование
(ТГ "Табачная продукция", "Альтернативная
табачная продукция" и "Никотинсодержащая
продукция")", "Выбытие (ТГ "Табачная продукция",
"Альтернативная табачная продукция" и
"Никотинсодержащая продукция")";
В "Справочник "Список поддерживаемых товарных
групп"" добавлена товарная группа "Пиво, напитки,
изготавливаемые на основе пива, слабоалкогольные
напитки";
Типы документов "Агрегация", "Возврат в оборот",
"Вывод из оборота", "Трансформация",
"Расформирование", "Списание не нанесённых КИ
с/без СИ" доступны для товарной группы "Пиво,
напитки, изготавливаемые на основе пива,
слабоалкогольные напитки";
24.03.2021
30.9
Скорректирован уровень вложенности параметров
ответа в разделе "Метод получения списка КИ по
идентификатору";
Актуализировано описание в разделе "Метод
получения информации о товаре по GTIN товара";
Актуализирован "Справочник "Дополнительные
параметры в ответе в зависимости от товарных
групп"";
Изменён тип параметра "partialSaleInfo" (Объект
параметров частичного выбытия);
Для документа "Ввод в оборот. Импорт с ФТС"
дополнено описание параметра "cis" (КИ);
Актуализировано описание параметра в разделах
"Справочник по КМТ" и "Метод получения
информации о товаре по GTIN товара";
Актуализирован перечень товарных групп, для
которых доступен документ "Ввод в оборот.
Производство вне ЕАЭС";
Дополнено описание в разделе "Метод получения
списка КИ по номеру документа";
Добавлен "Справочник "Причины вывода из
оборота (списание)";
Скорректировано описание параметра
"orderedColumnValue" в запросе раздела "Метод
получения списка загруженных документов в ГИС
МТ"
32
Дата
Версия
Изменения
документа
19.03.2021
30.8
Актуализировано описание параметров и примеры
документа "Приёмка" в формате * .json;
Актуализирован документ "Отгрузка при
трансграничной торговле";
Дополнена информация в разделе "Электронное
взаимодействие участника оборота товаров и
Оператора ГИС МТ" в части информации о стендах;
Скорректировано описание формата даты
документа "Отгрузка";
В разделе "Формирование наборов" добавлено
примечание по расформированию набора с
ошибочно добавленными КИ;
Скорректировано описание для параметра
"packType" документа "Ввод в оборот. Импорт с
ФТС";
Тип документа "Ввод в оборот. Маркировка
остатков" доступен для единиц товаров товарной
группы "Предметы одежды, бельё постельное,
столовое, туалетное и кухонное", описанных в КМТ
по полному атрибутивному составу. Плановый срок
отключения возможности создания документа для
товарной группы "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное" -
01.05.2021. В текущей реализации заполнение
параметра "kitu" для товарной группы "Предметы
одежды, бельё постельное, столовое, туалетное и
кухонное" недоступно в документе "Ввод в оборот.
Маркировка остатков"
01.03.2021
30.7
Тип документа "Описание остатков" недоступен для
ТГ "Шины и покрышки пневматические резиновые
новые" с 01.03.2021
24.02.2021
30.6
В "Метод получения списка загруженных
документов в ГИС МТ" добавлена возможность
указывать в запросе значение "empty" в параметре
"pg", если товарная группа в документе не
определена;
Актуализировано примечание для документа
"Агрегация"
33
Дата
Версия
Изменения
документа
17.02.2021
30.5
В ответе раздела "Метод получения краткой
информации о КИ/списке КИ (общедоступный)"
добавлен параметр "markWithdraw"
("Зафиксировано выбытие по чеку от невладельца
КИ");
Актуализирован пример ответа в разделах "Метод
получения информации о средстве идентификации
(POST)", "Метод получения подробной информации
о КИ (GET)" и "Метод получения информации о
товаре по коду товара" в рамках реализации
функциональности по частичному выбытию для
товарной группы "Духи и туалетная вода";
В документе "Ввод в оборот. Полученных от
физических лиц" скорректировано примечание;
В "Метод получения списка загруженных
документов в ГИС МТ" добавлен параметр ответа
"cisTotal" (Количество КИ в составе документа)
11.02.2021
30.4
Актуализирована обязательность параметров типа
документа "Отгрузка при трансграничной
торговле";
Актуализированы обязательность и описание
параметров типа документа "Приёмка";
Актуализировано описание кода "CANCELLED" в
разделе Справочник "Статусы документов";
Добавлены параметры "cancelled_by_did" и
"cancelled_did" в параметры ответа в разделе"Метод
получения содержимого загруженного документа по
идентификатору"
03.02.2021
30.3
В "Метод получения подробной информации о КИ
(GET)" добавлен параметр "markWithdraw"
("Признак выбытия по чеку ККТ от невладельца")
01.02.2021
30.2
Типы документов "Ввод в оборот. Маркировка
остатков" и "Описание остатков" недоступны для
ТГ "Предметы одежды, бельё постельное, столовое,
туалетное и кухонное" с 01.02.2021;
Актуализирована примеры документа "Описание
остатков" в формате *.json и *.xml
29.01.2021
30.1
Для документа "Ввод в оборот. Полученных от
физических лиц" тип выпуска КИ должен быть
только COMMISSION ("Принят от физических
лиц"). Тип выпуска КИ LOCAL ("Производство
РФ") для данного документа больше недоступен;
Актуализированы параметры документа "Приёмка"
для товарной группы "Молочная продукция"
34
Дата
Версия
Изменения
документа
22.01.2021
30.0
Для типа документа "Перемаркировка" в формате *
.csv сохраняется использование причин
перемаркировки с названием, отличным от
используемого в личном кабинете ГИС МТ при
создании документа: "Возврат товаров с
поврежденным СИ/без СИ при розничной
реализации" (в ЛК ГИС МТ "Возврат от розничного
покупателя" (RETAIL_RETURN)) и "Возврат
товаров с поврежденным СИ/без СИ при
дистанционном способе продажи" (в ЛК ГИС МТ
"Возврат в случае дистанционной продажи"
(REMOTE_SALE_RETURN));
На демонстрационном стенде для товарной
группы "Молочная продукция" добавлен параметр
"vsd_number" ("Номер ВСД") в документ "Приёмка"
в формате * .json - функциональность на текущий
момент находится в тестировании;
Дополнено описание типа документа
"Перемаркировка" в связи с реализацией
функциональности перемаркировки наборов;
Дополнено описание параметра "uit" ("Уникальный
КИ") и актуализирован пример *.xml для типов
документов в разделе "Списание не нанесённых КИ
с/без СИ" и "Списание нанесённых КИ с СИ"
35
Дата
Версия
Изменения
документа
13.01.2021
29.5
Актуализирован пример тела документа
"Декларация на товары";
Расширено описание параметра "uit" для типа
документа "Ввод в оборот. Полученных от
физических лиц";
Добавлен код "COMMISSION" ("Принят на
комиссию от физического лица") в "Справочник
"Типы эмиссии КИ"";
Актуализирован комментарий с возможными
значениями параметра "emissionType" в следующих
разделах:
"Метод получения списка товаров по заданному
фильтру";
"Метод получения подробной информации о КИ
(GET)";
"Метод получения списка КИ по заданному фильтру
с подробной информацией о КИ";
"Метод получения списка КИ по идентификатору";
"Метод получения информации о маркированном
товаре";
"Метод получения информации о маркированном
товаре по началу КИ";
"Метод получения информации о средстве
идентификации по началу КИ";
"Метод получения информации о средстве
идентификации (POST)";
"Метод получения содержимого загруженного
документа по идентификатору";
Добавлена рекомендация по заполнению документа
"Ввод в оборот. Трансграничная торговля";
Внесены изменения в шаблон документа "Ввод в
оборот. Импорт с ФТС";
Добавлено описание пагинации в разделе "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ";
Удалена устаревшая версия URL
/api/v3/facade/identifytools/listV2. Вместо
устаревшей версии использовать
/api/v4/facade/identifytools/listV2
36
Дата
Версия
Изменения
документа
25.12.2020
29.4
Добавлен параметр запроса "includeSubaccount" в
методы "Справочник по КМТ" и "Метод получения
информации о товаре по коду товара";
Актуализирован пример документа "Отгрузка" в
формате XML;
Скорректировано описание параметра
"markWithdraw" в ответах соответствующих
методов;
Актуализирован формат параметра
"certificate_document_date" в документе
"Перемаркировка";
Актуализировано описание документа
"Трансформация АТК";
Расширен комментарий для параметра "ki" в
документе "Трансформация АТК"
18.12.2020
29.3
Изменена обязательность параметра "turnover_type"
в документе "Приёмка" и скорректировано
описание параметров в типах документов "Ввод в
оборот. Производство РФ" и "Ввод в оборот.
Контрактное производство РФ";
Тип документа "Ввод в оборот. Маркировка
остатков" будет открыт для ТГ «Духи и туалетная
вода»;
"Метод получения списка товаров по номеру
документа" доступен только для УПД
10.12.2020
29.2
Изменение ФЛК документов "Приёмка" и "
Отгрузка": значение "turnover_type" документа
"Приёмка" должно совпадать со значением
"turnover_type" документа "Отгрузка"
07.12.2020
29.1
Документ "Формирование наборов" доступен для
товарной группы "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное";
Актуализирована обязательность параметров
документа "Приёмка"; Актуализирован пример в
формате CSV типа документа "Ввод в оборот.
Импорт с ФТС"
37
Дата
Версия
Изменения
документа
04.12.2020
29.0
Актуализировано описание типа документа
"Перемаркировка";
Документ "Ввод в оборот. Импорт с ФТС" и типы
документов раздела "Операции с АТК" доступны
для товарной группы "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное" c
01.12.2020 ;
Удалены "Метод формирования согласия на
предоставление сведений о кодах идентификации
для невладельцев", "Метод аннулирования
документа на основании текущего опубликованного
документа согласия", "Метод получения
информации о КИ по списку КИ при наличии
согласия";
Актуализировано описание раздела "Метод
получения содержимого загруженного документа по
идентификатору";
Добавлен тип документа "Декларация на товары",
поступающий в ГИС МТ от ФТС России
30.11.2020
28.3
Создание документа "Описание остатков"
недоступно для товарных групп "Табачная
продукция" и "Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки" с 01.12.2020;
Актуализированы возможные причины вывода из
оборота для ответа в разделе "Метод получения
содержимого загруженного документа по
идентификатору";
Скорректировано описание типа документа "Ввод в
оборот. Производство РФ"
25.11.2020
28.2
Актуализирован метод "Метод получения списка
КИ по идентификатору";
Актуализирован тип документа "Перемаркировка"
18.11.2020
28.1
Добавлено примечание в разделы "Метод получения
содержимого загруженного документа по
идентификатору" и "Метод поиска содержимого
документа по идентификатору документа";
Удалён тип документа "Оприходование излишков":
доступность к документу ограничена и
предоставляется отдельным участникам оборота
товаров по запросу
38
Дата
Версия
Изменения
документа
16.11.2020
28.0
Для предварительной интеграции участников
оборота товаров добавлено описание новой версии
типа документа "Перемаркировка";
Для типов документов "Отгрузка" указана
доступность создания документа в зависимости от
товарной группы;
Актуализированы форматы документа (JSON, CSV
XML) для типа документа "Ввод в оборот.
Трансграничная торговля";
Удалены методы функционала "Сервиса выгрузок":
для выгрузки данных рекомендуется использовать
методы функциональности "Сервиса выгрузок",
описанные в True API;
В запросе разделов "Метод получения списка КИ по
заданному фильтру с подробной информацией о
КИ" и "Метод получения списка товаров по
заданному фильтру" параметр "tree" указан как
устаревший: рекомендуется использовать
параметры "childrenPaging", "childrenPage",
"childrenLimit" (подробнее см. раздел "Указание
параметров в строке запроса при работе с
большими агрегатами")
09.11.2020
27.0
Скорректировано примечание по подаче сведений в
документе "Приёмка";
Для предварительной интеграции участников
оборота товаров добавлен тип документа
"Оприходование излишков" для ТГ "Табачная
продукция" и "Альтернативная табачная
продукция". См. также раздел "Планируемые
изменения в описании API ГИС МТ" и раздел
"Оприходование излишков";
В документе "Возврат в оборот" изменена
обязательность параметра "ki" (КИ/КИН)
02.11.2020
26.0
Скорректировано примечание по подаче сведений и
актуализировано описание параметров в документе
"Приёмка";
Актуализирован "Метод получения содержимого
загруженного документа по идентификатору";
Для типов документов уточнено указание КИН при
подаче сведений
39
Дата
Версия
Изменения
документа
26.10.2020
25.0
Удалены устаревшие методы "Метод получения
количества КИ с возможностью фильтрации"
(/facade/cis/count), "Метод получения количества КИ
с возможностью фильтрации"
(/facade/identifytools/count), "Метод получения
количества полученных КИ с возможностью
фильтрации (agent/received/count), "Метод
получения количества переданных КИ с
возможностью фильтрации" (agent/given/count);
Добавлен раздел "Указание параметров в строке
запроса при работе с большими агрегатами";
В справочнике и в документе "Формирование
наборов" указано, что код идентификации набора
(КИН) указывается по аналогии с КИ (кодом
идентификации);
Уточнено описание параметра "sntins" документа
"Формирование наборов";
Добавлено уточнение по указанию АТК в документе
"Формирование АТК";
Добавлены "Методы функционала "Сервис
выгрузок"";
Указана доступность создания документов через
"Единый метод создания документов" для товарных
групп;
Актуализированы методы: "Метод получения
списка КИ по идентификатору", "Метод получения
КИ по идентификатору", "Метод получения списка
КИ по заданному фильтру с подробной
информацией о КИ", "Метод получения подробной
информации о конкретном КИ (GET)", "Метод
получения информации о средстве идентификации
(POST)", "Метод получения информации о средстве
идентификации по началу КИ", "Метод получения
списка товаров по заданному фильтру", "Метод
получения информации о маркированном товаре",
"Метод получения информации о маркированном
товаре по началу КИ","Метод получения списка
переданных КИ с возможностью фильтрации",
"Метод получения списка полученных КИ с
возможностью фильтрации";
В "Список сокращений и условных обозначений"
добавлено уточнение по указанию КИН при подаче
сведений в документах
40
Дата
Версия
Изменения
документа
07.10.2020
24.2
Следующие методы считать устаревшими: "Метод
получения количества КИ с возможностью
фильтрации" (cis/count)", "Метод получения
количества КИ с возможностью фильтрации"
(identifytools/count);
Для типа документа "Перемаркировка"
скорректировано описание для параметров
"last_uin" и "new_uin";
В раздел "Список сокращений и условных
обозначений" добавлены расшифровки аббревиатур
"КИГУ", "КИН", "КИК";
Для метода "Ввод в оборот. Импорт с ФТС"
обновлено описание параметра "cis";
Изменена логика проверки указываемого формата
значения КИТУ: увеличено количество и изменён
формат вводимых символов;
Актуализированы примеры запросов раздела
"Метод получения списка КИ по заданному фильтру
с подробной информацией о КИ";
Расширен справочник "Актуальные особые
состояния";
Актуализирован "Метод получения содержимого
загруженного документа по идентификатору";
Для подачи документа "Описание остатков"
товарными группами "Табачная продукция" и
"Альтернативная табачная продукция";
уточнены адреса стендов при текущей реализации
функционала;
Добавлено описание для раздела "Метод получения
списка КИ по номеру документа";
Актуализированы параметры запроса в разделе
"Метод получения списка КИ по заданному фильтру
с подробной информацией о КИ";
Дополнено описания параметров "packs" и
"cisPackageType"
41
Дата
Версия
Изменения
документа
29.09.2020
24.1
Реализована возможность подачи документа "Ввод
в оборот. Импорт с ФТС" для товарных групп:
"Духи и туалетная вода", "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые
новые";
Указаны плановые даты отключения подачи
документа "Ввод в оборот. Производство вне
ЕАЭС" для товарных групп "Предметы одежды,
бельё постельное, столовое, туалетное и кухонное",
"Духи и туалетная вода", "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки",
"Шины и покрышки пневматические резиновые
новые";
Актуализирован пример ответа в разделе
"Справочник по КМТ";
Расширен набор параметров в разделе "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ";
Указаны дополнительные комментарии по
заполнению файла CSV документа "Формирование
наборов";
Для документа "Описание остатков" уточнено
ограничение по созданию в зависимости от
товарной группы;
Актуализирован пример в формате * .xml "Ввод в
оборот. Импорт с ФТС". Ослаблен ФЛК для поля
размера обуви (productSize)
42
Дата
Версия
Изменения
документа
21.09.2020
24.0
Добавлен раздел "Планируемые изменения в API
ГИС МТ" с целью предварительного уведомления
участников оборота товаров;
о значимых изменениях принципов работы
существующих методов и добавлении новых
методов API;
Актуализированы примеры типа документа
"Агрегация";
Добавлен тип документа "Формирование наборов"
для товарных групп "Духи и туалетная вода",
"Фотокамеры (кроме кинокамер), фотовспышки и
лампы вспышки";
В "Справочник "Типы документов"" добавлен тип
документа "Формирование наборов";
В "Справочник "Типы упаковки"" добавлен тип
упаковки "Набор" (SET);
Расширены параметры ответа в разделах "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ"
(/api/v3/facade/identifytools/listV2,
/api/v4/facade/identifytools/listV2), "Метод получения
подробной информации о конкретном КИ (GET)"
(/api/v3/facade/identifytools/info,
/api/v4/facade/identifytools/info) "Метод получения
информации о товаре по коду товара" (/product/info)
в связи с добавлением типа документа
"Формирование наборов";
Для типов документов "Ввод в оборот.
Производство вне ЕАЭС", "Ввод в оборот. Импорт с
ФТС", "Формирование АТК", "Трансформация
АТК", "Расформирование АТК" установлены
плановые сроки доступности создания в
зависимости от товарных групп
43
Дата
Версия
Изменения
документа
14.09.2020
23.0
Для типа документа "Описание остатков" расширен
состав параметров для ТГ "Табачная продукция" и
"Альтернативная табачная продукция";
Для типа документа "Описание остатков" уточнена
обязательность параметров в зависимости от
значения кода товарной номенклатуры;
В разделе "Справочник "Типы упаковки"" уточнено
использование ТГ типа упаковки "Комплект"
(BUNDLE);
В разделе "Метод получения списка КИ по
идентификатору" добавлен обязательный параметр
"pg" для ТГ "Молочная продукция" и "Упакованная
вода";
Уточнены значения справочника "Актуальные
статусы" для КИ;
Для документа "Ввод в оборот. Импорт с ФТС"
скорректировано описание для параметра запроса
"cis"
01.09.2020
22.0
Дополнено описание параметров документа
"Приёмка";
Изменена структура справочника "Справочник
"Статусы КИ";
Скорректирована XML схема для типа документа
"Вывод из оборота";
Для параметра "document_type" типа документа
"Вывод из оборота" изменено название первичного
документа "DESTRUCTION" на
"DESTRUCTION_ACT";
Для метода "Метод получения списка КИ по
идентификатору" (POST) добавлен параметр ответа
"markWithdrawn";
По тексту документа код маркировки заменен на
код идентификации;
Для метода "Ввод в оборот. Производство вне
ЕАЭС" уточнена предварительная дата отключения
для товарных групп;
С 01.09.2020 "Ввод в оборот. Маркировка остатков"
недоступен для ТГ "Обувные товары";
Для метода "Ввод в оборот. Импорт с ФТС"
изменено описание для параметров "color" и
"productSize"
44
Дата
Версия
Изменения
документа
31.07.2020
21.0
Для методов "Метод получения списка полученных
КИ с возможностью фильтрации", "Метод
получения количества полученных КИ с
возможностью фильтрации", "Метод получения
списка переданных КИ с возможностью
фильтрации" и "Метод получения количества
переданных КИ с возможностью фильтрации"
изменены значения для параметра
"Дополнительный статус товара" (statusExt);
Изменены возможные принимаемые значения для
параметра "Причина вывода из оборота"
(withdrawReason);
Для метода "Единый метод создания документов"
параметр "Товарная группа" (pg) обязательный для
заполнения;
Удалены методы: "Метод поиска по журналу
действий", Метод получения списка доступных
заявок с возможностью фильтрации";
Для метода "Перемаркировка" удалено ограничение
по товарным группам;
Для товарных групп "Молочная продукция" и
"Упакованная вода" параметр "Код причины
повторной маркировки" (remarking_cause)
принимает только следующие значения:
KM_SPOILED - Испорчено либо утеряно СИ с КИ;
DESCRIPTION_ERRORS - Выявлены ошибки
описания товара.
Для метода "Возврат в оборот" добавлено
ограничение по обязательности для первичных
документов.
Для метода "Описание остатков" добавлено
ограничение по созданию типов документов для ТГ
"Обувные товары";
Для метода "Ввод в оборот. Импорт с ФТС"
минимальная дата декларации на товары изменена с
2020-07-01 на 2020-08-01
45
Дата
Версия
Изменения
документа
17.07.2020
20.0
Для методов "Метод поиска тела чека по
идентификатору" и "Метод поиска чека по
идентификатору" добавлены параметры
"Идентификатор государственного контракта" и
"Причины вывода";
"Метод получения списка доступных заявок с
возможностью фильтрации" считать устаревший,
вместо него требуется использовать "Метод поиска
по журналу действий";
Изменен URL стендов, добавлен URL для стендов
v4;
Добавлены примечания по логике работы методов
"Ввод в оборот. Производство вне ЕАЭС" и "Ввод в
оборот. Импорт с ФТС";
Для метода "Ввод в оборот. Импорт с ФТС" в JSON
обновлено описание параметра cis (Указывается КИ
или КИТУ или АТК);
ТГ "Питьевая вода" переименована в "Упакованная
вода";
Для метода "Метод получения списка КИ по
идентификатору" добавлен параметра ТН ВЭД
(tnVed10);
Для метода "Ввод в оборот. На территории стран
ЕАЭС (контрактное производство)" удалены
параметры "Сумма НДС" и "Цена за единицу";
Для метода "Формирование АТК" добавлено
ограничения для параметра КИ (ki) "Указываются
только номера КИ. Указание в данном поле номера
КИТУ или КИ, уже входящих в КИТУ или другой
АТК, не допускается";
В методе "Метод получения списка товаров по
заданному фильтру" изменены значения для
параметра "Дополнительный статус товара"
(statusExt);
Для параметра "Статус загрузки документа"
(downloadStatus) добавлена ссылка на справочник
"Справочник "Статусы документов"";
Удален метод "Метод получения списка участников
по введенному наименованию организации"
46
Дата
Версия
Изменения
документа
06.07.2020
19.0
Добавлены методы: "Метод поиска чека по
идентификатору", "Метод поиска тела чека по
идентификатору", Метод получения списка
доступных заявок с возможностью фильтрации,
"Запрос информации об участнике оборота товаров
по ИНН", "Метод получения информации о
средстве идентификации по началу КИ", "Метод
получения КИ и всех внутренних КИ", "Метод
получения информации о средстве идентификации
(POST)", Метод получения количества КИ с
возможностью фильтрации, Метод получения
списка участников по введенному наименованию
организации, "Метод получения КИ по
идентификатору", Метод получения количества КИ
с возможностью фильтрации, "Метод получения
списка КИ по номеру документа", "Метод поиска
содержимого документа по идентификатору
документа";
Для параметра "status" добавлено значение "КИ
списан" (WRITTEN_OFF);
Документ "Вывод товара из оборота при реализации
конечному потребителю" переименован в "Вывод из
оборота";
Добавлены версии v4 методов: "Метод получения
списка КИ по заданному фильтру с подробной
информацией о КИ", Справочник по КИТ, "Метод
получения информации о товаре по коду товара",
"Метод получения списка КИ по идентификатору",
"Метод получения подробной информации о
конкретном КИ (GET)";
Следующие методы считать устаревшими: "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ", "Метод получения
списка КИ по идентификатору", "Метод получения
подробной информации о конкретном КИ (GET)";
Обновлены параметры ответа в разделах "Метод
получения списка товаров по заданному фильтру";
В "Метод получения содержимого загруженного
документа по идентификатору" добавлены
параметры "Количество КИ в ответе",
"Идентификатор государственного контракта",
"Причина вывода";
Для параметра "orderColumn" допустимое значение
изменено с "docDate" на "receivedAt";
Для статуса КИ удалено значение
"WAIT_FOR_CONTINUATION"
47
Дата
Версия
Изменения
документа
30.06.2020
18.3
Метод "Ввод в оборот. Производство вне ЕАЭС"
считать устаревшим, будет поддерживаться в
течение трёх месяцев;
В методе "Ввод в оборот. Импорт с ФТС"
параметры цвет ("color") и размер ("productSize")
изменены на необязательные
48
Дата
Версия
Изменения
документа
10.06.2020
18.2
Добавлены следующие методы и типы документов:
"Метод получения информации о КИ по списку КИ
при наличии согласия", "Метод получения
информации о маркированном товаре", "Метод
получения информации о маркированном товаре по
началу КИ", "Метод получения списка полученных
КИ с возможностью фильтрации", "Метод
получения количества полученных КИ с
возможностью фильтрации", "Метод получения
списка переданных КИ с возможностью
фильтрации", "Метод получения количества
переданных КИ с возможностью фильтрации",
"Отгрузка при трансграничной торговле", "Отмена
отгрузки при трансграничной торговле", "Ввод в
оборот. Импорт с ФТС", "Формирование АТК",
"Расформирование АТК", "Трансформация АТК";
В раздел "Метод получения подробной информации
о конкретном КИ" добавлен параметр
"lastDocType";
Для параметров "childrenMap" и "childrenDetails"
удалена рекурсия;
В "Метод получения списка КИ по
идентификатору" добавлен параметр "turnoverType";
Добавлен "Справочник "Список поддерживаемых
товарных групп"";
Удалён параметр "offset" в разделе "Метод
получения списка 10-ти значных кодов ТН ВЭД";
Добавлен параметр "name" для типа документа
"Трансформация";
Добавлен параметр "cisChildren" в разделы "Метод
получения списка КИ по заданному фильтру с
подробной информацией о КИ", "Метод получения
списка товаров по заданному фильтру", "Метод
получения списка полученных КИ с возможностью
фильтрации", "Метод получения списка переданных
КИ с возможностью фильтрации";
Изменены параметры ответов в разделе "Метод
получения информации о маркированном товаре";
Добавлены "Примеры аутентификации по УКЭП /
Подписание документов";
Добавлены параметры запроса в "Метод получения
списка КИ по заданному фильтру с подробной
информацией о КИ";
Для товарной группы "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное"
заменено обозначение с "clothes" на "lp" в разделе
"Справочник "Список поддерживаемых товарных
групп""
49
Дата
Версия
Изменения
документа
24.04.2020
18.1
Добавлены следующие методы: "Метод создания
документа согласия", "Метод создания документа
аннулирования на основании текущего
опубликованного документа согласия", "Метод
получения информации о КИ по списку КИ";
Тип документа "Ввод в оборот. Трансграничная
торговля (контрактное производство)"
переименован на "Ввод в оборот. На территории
стран ЕАЭС (контрактное производство)";
Добавлен Список сокращений и аббревиатур,
используемых в документации "Описание API ГИС
МТ"
13.04.2020
18.0
Изменена обязательность параметров типа
документа "Отмена отгрузки";
Изменён документ "Перемаркировка";
Добавлена товарная группа "Упакованная вода";
Добавлен тип упаковки "Комплект";
Описаны виды первичного документа
20.03.2020
17.0
Начальная версия
50
1. Назначение и условия применения API ГИС
МТ
1.1. Электронное взаимодействие участника оборота товаров
и Оператора ГИС МТ
Взаимодействие участников оборота товара и Оператора ГИС МТ осуществляется в
электронном виде. Обмен документами на бумажном носителе не предусмотрен.
Электронное взаимодействие осуществляется по одному из двух вариантов:
1. Предоставление сведений, т. е. обмен электронными документами, на основании которых
могут вноситься сведения в реестры ГИС МТ. Предоставление сведений является
обязательством участника оборота товаров.
2. Запрос сведений, т.е. обмен, при котором сведения из реестров ГИС МТ предоставляются
участнику оборота товаров в соответствии с установленными разрешениями на получение
сведений. При этом изменения в реестры не вносятся. Запрос и последующее представление
сведений из ГИС МТ инициируется участником оборота товаров по своему усмотрению и
применяется, например, для проверки статусов КИ или статуса регистрации участника
оборота товаров.
Электронное взаимодействие осуществляется путем обмена электронными документами в
соответствии с определенным порядком. Для юридически значимых электронных документов
применяется УКЭП. УКЭП передаётся вместе с электронным документом. Электронное
взаимодействие осуществляется с применением программных интерфейсов взаимодействия
(API) ГИС МТ и информационных систем участников оборота товара.
При взаимодействии через API выполняются следующие требования:
1. Аутентификация и авторизация участника оборота товаров (определение полномочий на
осуществление электронного взаимодействия) осуществляется при помощи УКЭП.
2. При предоставлении и запросе сведений защита передаваемых данных выполняется
TLS/HTTPS (ГОСТ 28147-89) шифрованием канала передачи данных в адрес Оператора ГИС
МТ сертифицированными РФ СКЗИ (ГОСТ Р 34.10-2012).
В API отсутствует разделение на категории участников оборота товара. При выводе данных о
нерезидентах, вместо ИНН будет возвращаться его аналог в стране ЕАЭС. Коды маркировки
можно получить только через API СУЗ.
Информация о вложенности параметров
Вложенные параметры помечены "*".
Пример вложенности:
Параметр
Описание
results:
agentInn
*children:
51
Параметр
Описание
**brand
Читать как: параметр "results" содержит параметры "agentInn" и "children", а "children" содержит
параметр "brand".
Информация о стендах
Базовые адреса демонстрационного контура ГИС МТ:
• товарные группы "Альтернативная табачная продукция", "Никотиносодержащая продукция"
и "Табачная продукция":
• остальные товарные группы:
Базовые адреса промышленного (продуктивного) контура ГИС МТ:
• товарные группы "Альтернативная табачная продукция", "Никотиносодержащая продукция"
и "Табачная продукция":
• остальные товарные группы:
При указании запросов обратить внимание на следующее:
• в некоторых запросах рекомендуется указывать товарную группу (см. "Справочник "Список
поддерживаемых товарных групп"");
• новые методы могут быть реализованы с указанием версии, которая отличается от "v3"
(версии 3), первоначально указываемой в документации API. В таком случае в URL стендов
необходимо произвести замену версии на новую. Старая версия поддерживается в течение
полугода для сохранения обратной совместимости.
Информация об ошибках при запросах API методов имеет следующий формат:
(подробнее: см. "Справочник "Статусы ответов"")
Пример ошибки:
Status code: 403
Content-Type: application/json
52
{
"error_message": "<Отсутствует доступ к ресурсу >"
}
Status code: 401
информация об ошибке возвращается в формате XML
Методы Национального каталога возвращают сообщения об ошибках, которые могут быть как в
XML, так и в JSON форматах в зависимости от выбранного формата запроса
Коды стран представлены в соответствии с ISO 3166.
1.1.1. Требования к файлам обмена
Файл обмена должен подписываться УКЭП лица, имеющего право действовать без
доверенности от имени участника оборота товара, и соответствовать следующим требованиям:
1. Файл формата JSON:
◦ для обмена с ГИС МТ используется JSON стандарта RFC 7159 (https://tools.ietf.org/html/
rfc7159);
◦ использует кодировку UTF-8;
◦ в результирующем JSON также может содержаться набор полей, специфичных для
конкретного товара.
2. Файл обмена формата CSV:
◦ соответствует стандарту RFC 4180;
◦ использует кодировку UTF-8;
◦ содержит символ "," в контенте файла в качестве разделителя;
◦ в документе формата * .csv не поддерживается передача древовидной структуры агрегата.
Если в документе указать на одном уровне код агрегата и коды вложений, документ будет
обработан с ошибкой дублирования данных. Передать данные содержимого агрегата в
иерархической структуре в формате * .csv невозможно.
3. Файл обмена формата XML:
◦ XML формат описан в xsd схемах. Актуальные xsd схемы можно найти в разделе
"Помощь";
◦ содержит информацию, целиком включающуюся в блок с XML-тэгом "Файл";
◦ содержит единственный экземпляр электронного документа;
◦ использует кодировку UTF-8;
◦ содержит первую строку вида <?xml version="1.0" encoding="utf-8"?>;
◦ определяет стандартные типы данных в соответствии со стандартом ISO (см. описание
◦ проверяется на корректность на основании XSD-схемы - логической модели для обмена
информацией, описывающей логические элементы и атрибуты XML-файлов.
53
ПРИМЕЧАНИЕ:
1. В примерах сurl запросы выполнены и проверены на UNIX системах, для корректной работы
в других операционных системах, может понадобиться замена символов.
2. В ответах REST API ГИС МТ могут содержаться дополнительные служебные JSON
атрибуты, не указанные в документации. Неизвестные атрибуты следует игнорировать.
3. Максимальный размер документа, передаваемого по API, не должен превышать 30 мегабайт.
4. Максимальное количество КМ в одном загружаемом документе по API не рекомендуется
превышать 30 000 КИ (подробнее см. "SLA по обработке документов ГИС МТ"). По данной
рекомендации документ может не загрузиться, если, например, в одном загружаемом
документе указаны 30 000 КИТУ.
5. Все значения атрибутов в форматах JSON и CSV, выражаемые в деньгах (цены, налоги, и т.п),
задаются в копейках без разделителей.
1.1.2. Экранирование
Экранирование - замена в тексте управляющих символов на соответствующие текстовые
подстановки. Экранирование используется для отделения текста от кода и управляющих
символов. Экранирование применяется при передаче параметров запросов API методов согласно
следующим стандартам:
• при передаче параметров в едином указателе ресурса (Uniform Resource Locator, URL), т.е. в
URL запроса, должно применяться экранирование согласно стандарту RFC 3986 (см.
• при передаче параметров в JSON-строке тела запроса URL должно применяться
экранирование согласно стандарту RFC
8259 (см. описание стандарта в п.
7
• при загрузке сведения в ГИС МТ посредством файла формата 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:
54
"010481097886269421""LLRY<%"JZTVZ"
• экранирование для XML по стандарту W3C:
<cis>0104650117240408211dmfcZNcM<4</cis>
<cis>0104650117240408211dmfcZNcM<4</cis>
<cis><![CDATA[0104650117240408211dmfcZNcM<4]]></cis>
1.1.3. Тип возвращаемого методами API контента
Методы API преимущественно возвращают ответы в формате JSON, т.е. MIME-type
application/json. Некоторые методы в корректном ответе возвращают двоичное содержимое
(например, документы в zip) MIME-type application/zip или application/octet-stream, а в случае
ошибки - описание этой самой ошибки в JSON. Таким образом, один и тот же метод в
зависимости от ситуации может вернуть разные типы содержимого (контента).
Для корректной работы методов API параметр Accept заголовка запроса должен быть установлен
так, чтобы учитывались все возможные ответы сервера, т.е. и application/zip, и application/json.
Самый простой вариант - использовать универсальный шаблон:
Accept: /
Для ограничения набора возвращаемых типов контента можно указывать несколько заголовков
запроса методов:
Accept: application/octet-stream
Accept: application/json
Если в перечне заголовков запроса методов API не окажется ни одного подходящего под
сгенерированный сервером ответ, то API вернется ответ c кодом = 406 (Not Acceptable) с пустым
телом ответа.
1.1.4. Указание параметров в строке запроса при работе с большими агрегатами
Агрегирование представляет собой объединение в транспортную упаковку товаров первого
уровня либо транспортных упаковок первого уровня в транспортную упаковку последующего
уровня с сохранением информации о взаимосвязи КИ каждого вложенного товара,
потребительской или транспортной упаковки товаров с КИ создаваемой транспортной упаковки
и нанесением соответствующего КИТУ на создаваемую в результате объединения транспортную
упаковку для обеспечения прослеживаемости движения товаров по товаропроводящей цепи без
необходимости вскрытия создаваемой транспортной упаковки.
Работа с большими агрегатами через API может снижать скорость обработки запросов и
приводить к ошибке с кодом 500. Большой агрегат, как правило, содержит более 10 000
вложений ("детей"). Работа с большими агрегатами также подразумевает использованием метода
поиска по списку агрегатов, когда сумма вложений этих агрегатов составляет более 10 000.
Для получения больших агрегатов через API реализована пагинация агрегатов первого слоя, при
этом все оставшиеся агрегаты, начиная со второго слоя вложенности, игнорируются.
55
Работа с большими агрегатами реализована для методов API, у которых в ответе на запрос
возвращается параметр с полным описанием агрегатов разных уровней вложенности.
Работа с большими агрегатами реализована для следующих методов API:
• "Метод
получения
списка
КИ
по
идентификатору"
(/v3/facade/cis/cis_list,
/v4/facade/cis/cis_list);
• "Метод получения КИ по идентификатору" (/facade/cis/info);
• "Метод получения списка КИ по заданному фильтру с подробной информацией о КИ"
(/v3/facade/identifytools/listV2, /v4/facade/identifytools/listV2);
• "Метод получения подробной информации о КИ (GET)"
(/v3/facade/identifytools/info,
/v4/facade/identifytools/info);
• "Метод
получения
информации
о
средстве
идентификации
(POST)"
(/facade/identifytools/infolist);
• "Метод получения информации о средстве идентификации по началу КИ"
(/facade/identifytools/start_with);
• "Метод получения списка товаров по заданному фильтру" (/facade/marked_products/listV2);
• "Метод получения информации о маркированном товаре" (/facade/marked_products/info);
• "Метод получения информации о маркированном товаре по началу КИ"
(facade/marked_products/start_with);
• "Метод получения списка переданных КИ с возможностью фильтрации"
(facade/agent/given/list);
• "Метод получения списка полученных КИ с возможностью фильтрации"
(facade/agent/received/list).
Параметры запроса:
Параметр
Тип
Обяз.
Описание
Комментарий
childrenPagin
boolean
+
Флаг,
Значение по умолчанию: false
g
включающий
пагинацию
агрегатов. При
включённом
значении
возвращает
постранично
агрегаты только
первого слоя
через указанные
ниже параметры
childrenPage
number
-
Число страниц
Значение по умолчанию: 1
вложений
агрегата первого
слоя
56
Параметр
Тип
Обяз.
Описание
Комментарий
childrenLimit
number
-
Количество
Значение по умолчанию: 50
вложений на
странице агрегата
первого слоя
Для использования данной функциональности со значениями по умолчанию (1 страница с 50
агрегатами первого слоя) необходимо в качестве URL параметра указать: "childrenPaging"=true.
Для переключения на следующие страницы необходимо использовать параметр "childrenPage":
&childrenPaging=true&childrenPage=2
Для того чтобы агрегаты не возвращались необходимо указать параметр "childrenLimit"=0:
&childrenPaging=true&childrenLimit=0
Параметры ответа:
Параметр
Тип
Обяз.
Описание
Комментарий
countChildren
integer
-
Количество
дочерних КИ
1.1.5. Аутентификация
Для работы с интерфейсом API необходимо зарегистрироваться в ЛК ГИС МТ: на продуктивном
стенде
или
на
интеграционном
(демо)
стенде
подключенной товарной группой ГИС МТ (см. "Справочник "Типы документов"").
Метод предназначен для получения аутентификационного токена по УКЭП:
• В результате использования данного метода пользователь получает пары "uuid - data", где
uuid - идентификатор текущей аутентификации, data - строка на подпись пользователю
• сервер отвечает на запрос сообщением с кодом 200 (ОК) и возвращает токен, либо сообщение
об ошибке (подробнее: см. "Справочник "Статусы ответов"").
Все методы API взаимодействия с ГИС МТ требуют передачи в заголовке параметра
'Authorization: Bearer <token>'
где token - аутентификационный токен, получаемый в результате работы метода получения.
Токен действителен 10 часов
1.1.5.1. Запрос авторизации
URL: auth/cert/key
Метод: GET
Пример запроса:
57
curl -v <url стенда v3>/auth/cert/key
Ответ:
< HTTP/1.1 200
< Content-Type: application/json;charset=UTF-8
<
{"uuid":"b7b1abc9-f4ee-47db-8a20-f80ac83504e8",
"data":"QNRPNPFGJZFUXCERQMTWLRMBRNRAAP"}
Параметры ответа:
Параметр
Тип
Обяз.
Доступ
Описание
uuid
string
+
Только чтение
Уникальный идентификатор
сгенерированных случайных данных
data
string
+
Только чтение
Случайная строка данных
1.1.5.2. Получение аутентификационного токена
URL: /auth/cert/
Метод: POST
Пример запроса:
curl -X POST -v '<url стенда v3>/auth/cert/'
-H 'content-type: application/json;charset=UTF-8'
--data-binary '{
"uuid":" b7b1abc9-f4ee-47db-8a20-f80ac83504e8",
"data":"<Подписанные данные в base64>"'}
Параметры тела запроса:
Параметр
Тип
Обяз.
Описание
uuid
string
+
Уникальный идентификатор подписанных
случайных данных
data
string
+
Подписанные УКЭП зарегистрированного
участника оборота товаров - случайные
данные в base64 (ЭП присоединённая)
Ответ:
58
< HTTP/2 200
< content-type: application/json;charset=UTF-8
<
{"token": “eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…”}
Параметры ответа:
Параметр
Тип
Обяз.
Описание
Комментарий
token
string
-
Аутентификацион
Параметр обязательный в случае
ный токен
успешного ответа
code
string
-
Код ошибки
Параметр обязательный в случае не
успешного ответа
error_messag
string
-
Сообщение об
e
ошибке
description
string
-
Описание ошибки
ВАЖНО!
Все методы API взаимодействия с ГИС МТ требуют передачи в заголовке параметра
'Authorization: Bearer <token>',
где token - аутентификационный токен полученный в результате работы метода получения
аутентификационного токена.
2. Обращение к API ГИС МТ
2.1. Метод получения списка КИ по заданному фильтру с
подробной информацией о КИ
Метод возвращает список КИ с подробной информацией, которые доступны в данный момент
времени участнику оборота товаров согласно заданному фильтру (ИНН определяется по токену).
URL: /api/v4/facade/identifytools/listV2
Метод: GET
Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в
разделе "Указание параметров в строке запроса при работе с большими агрегатами".
Пример получения множества КИ с пагинацией по заданному фильтру. Первый этап:
• отправить запрос по фильтру (в примере используется gtin=04664974393504 для товарной
группы "Предметы одежды, бельё столовое, туалетное и кухонное" ("pg=lp") с сортировкой
по дате эмиссии КИ "orderColumn=emd", и типом сортировки времени "order=ASC"). Лимит
выводимых КИ установлен в 15 единиц ("limit=15), с выставленным запретом кеширования
("cache=false") (для возвращения более 1524 КИ) и возможностью работы с большими
агрегатами (childrenPaging=false&childrenLimit=1&childrenPage=1) curl
--location
--request
GET
'<url
стенда
59
v4>/facade/identifytools/listV2?pg=lp>in=04664974393504&orderColumn=emd&order=ASC&l
imit=15&cache=false&childrenPaging=false&childrenLimit=1&childrenPage=1' \;
• получить 15 первых КИ согласно фильтру;
{
"results":[
{
"uit":"010466497439350421&y3jEH>XoIn9=",
"cis":"010466497439350421&y3jEH>XoIn9=",
"gtin":"04664974393504",
"sgtin":"&y3jEH>XoIn9=",
"tnVedEaesCode":"4203",
"productName":"Одежда 1",
"emissionDate":"2020-12-14T08:38:03.699Z",
"producerName":"ООО \"ЖОЛБАРЫС\"",
"producerInn":"0411168627",
"ownerName":"ООО \"ЖОЛБАРЫС\"",
"ownerInn":"0411168627",
"emissionType":"LOCAL",
"prevCises":[
],
"nextCises":[
],
"status":"EMITTED",
"packType":"UNIT",
"productGroup":"lp"
}
],
"total":0,
"nextPage":true
}
• так как осуществляется сортировка по дате эмиссии ("orderColumn=emd"), взять из ответа
последний "uit" и подставить значение в одноимённый параметр "uit". Значение
"emissionDate"
подставляется
в
параметр
"orderedColumnValue",
добавить
"caсhe=false,pageDir=NEXT" и отправить запрос для получения следующей страницы по
первому
фильтру:
curl
--location
--request
GET
'<url
стенда
v4>/facade/identifytools/listV2?pg=lp>in=04664974393504&pageDir=NEXT&uit=0104664974
39350421%26y3jEH%3EXoIn9%3D&orderColumn=emd&order=ASC&orderedColumnValue=20
20-12-
14T08%3A38%3A03.699Z&limit=15&cache=false&childrenPaging=false&childrenLimit=1&chil
drenPage=1' \
В ответе получить следующую страницу из максимум 15 КИ (поскольку выставлен "limit=15"),
начиная с последнего КИ из значения, указанного выше.
Второй этап:
60
• отправить запрос;
• получить первые 10 КИ согласно фильтру;
• применить "cis", "emissionDate", "orderColumnValue".
Пример строки запроса:
curl -X GET "<url стенда
v4>/facade/identifytools/childrenPaging=false&childrenPage=1&childrenLimit=2
&pg=string&cis=string&cisMatchMode=EQ&emissionDateFrom=0&emissionDateTo=0>in=string
&sn=string&producerInn=string&ownerInn=string&cisPackageType=UNIT&tnVed10=string
&emissionType=INVALID_VALUE&pageDir=PREV&uit=string&orderColumn=string&order=ASC
&orderedColumnValue=string&limit=0&cisAggregationState=PACKED&packs=ALL&aggregation=tr
ue
&countChildren=0&tree=NO_TREE&uituStatus=string&cache=true&prVetDocument=string&docTyp
e=UNKNOWN
&statusExt=CANCELLATION_APPLIED&cisStatus=EMITTED&withdrawReason=string
&documentId=string&haveChildren=true&packageTypes=UNIT&emissionTypes=INVALID_VALUE"
-H 'Authorization: Bearer <ТОКЕН>' -H 'content-type: application/json'
Параметры запроса:
Параметр
Тип
Обяз.
Описание
Комментарий
childrenPagin
boolean
+
Флаг,
При включённом значении возвращает
g
включающий
постранично агрегаты только первого слоя
пагинацию
через указанные ниже параметры.
агрегатов
Значение по умолчанию: false
childrenPage
number
-
Число страниц
Значение по умолчанию: 1
вложений
агрегата первого
слоя
childrenLimit
number
-
Количество
Значение по умолчанию: 50
вложений на
странице агрегата
первого слоя
*pg
string
-
Товарная группа
Параметр обязательно указывать для
товарных групп:
milk - "Молочная продукция";
water - "Упакованная вода"
*cis
string
-
КИ товара,
используемый для
фильтрации по
списку КИ
61
Параметр
Тип
Обяз.
Описание
Комментарий
*cisMatchMo
string
-
Режим
Возможные значения:
de
фильтрации по
EQ - полностью равен;
КИ
LIKE - содержит в себе. Является
устаревшим и в дальнейшем будет удалён.
Рекомендуется использовать
"START_WITH" ("Начинается с");
START_WITH - начинается с
*emissionDat
integer
-
Дата эмиссии, от
Задаётся в формате yyyy-MM-
eFrom
ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z
*emissionDat
integer
-
Дата эмиссии, до
Задаётся в формате yyyy-MM-
eTo
ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z
*gtin
string
-
Код товара
*sn
string
-
Серийный номер
КИ
*producerInn
string
-
ИНН
производителя
*ownerInn
string
-
ИНН
собственника
товара
*tnVed10
string
-
Код товарной
номенклатуры (10
знаков)
*emissionTyp
string
-
Тип эмиссии
См. "Справочник "Типы эмиссии КИ""
e
*pageDir
string
-
Выбор
Возможные значения:
направления для
PREV - Предыдущий раздел;
пагинации
NEXT - Следующий раздел
*uit
string
-
Значение КИ,
"точки отсчета"
(запись, с которой
начнётся
выборка), по
которому
сортируются
записи.
Использовать
только вместе с
параметром
"orderedColumnVa
lue"
*order
string
-
Направление
Возможные значения:
сортировки
ASC - по возрастанию;
DESC - по убыванию
62
Параметр
Тип
Обяз.
Описание
Комментарий
*orderColum
string
-
Название столбца,
n
по которому будет
производиться
сортировка.
Допустимое
значение "emd" -
дата эмиссии
*orderedColu
string
-
Значение столбца,
Использовать только совместно с
mnValue
"точки
параметром "uit"
отсчета"(запись, с
которой
начинается
выборка), по
которому
сортируются
записи
*limit
integer
-
Количество
записей в ответе
*cisAggregati
string
-
Состояние
Возможные значения:
onState
КИ/КИТУ
PACKED- в агрегате (агрегирован);
NOT_PACKED - не в агрегате
(дезагрегирован);
ANY - любое состояние (значение по
умолчанию)
*packs
string
-
Фильтрация по
Возможные значения:
единичным
ALL - товары и упаковки;
товарным
UNIT - только товары (UNIT, BUNDLE);
упаковкам
PACK - только упаковки (LEVEL1,
LEVEL2, LEVEL3, LEVEL4, LEVEL5,
ATK, SET).
См. "Справочник "Типы упаковки"".
Обязательный параметр, если не
заполнены параметры "packageTypes" или
"cisPackageType"
*cisPackageT
string
-
Тип упаковки
Можно указать только одно значение типа
ype
упаковки. См. "Справочник "Типы
упаковки""
*packageTyp
[string]
-
Список типов
Возможные значения:
es
упаковок,
UNIT, BUNDLE, SET, LEVEL1, LEVEL2,
необходимых для
LEVEL3, ATK (см. "Справочник "Типы
отбора
упаковки"")
*aggregation
boolean
-
Агрегация
Отражает товары и товарные упаковки
только в одном статусе для агрегации
*countChildre
integer
-
Количество
n
дочерних КИ
63
Параметр
Тип
Обяз.
Описание
Комментарий
*tree
string
-
Способ вывода
Возможные значения:
дерева списка
NO_TREE - Не возвращать вложенные
КИ/КИТУ
КИ;
ONE_LEVEL - Возвращать только первый
уровень вложенности;
ALL_TREE - Возвращать все дерево
Данный параметр считается
устаревшим и в дальнейшем
поддерживаться не будет: рекомендуется
использовать параметры "childrenPaging",
"childrenPage", "childrenLimit" (подробнее
см. раздел "Указание параметров в строке
запроса при работе с большими
агрегатами")
*uituStatus
string
-
Статус КИТУ
*cache
boolean
-
Установленный
флажок
использования
кэшированных
данных
*prVetDocum
string
-
ID
Обязательный параметр для ТГ
ent
производственног
"Молочная продукция". Данный параметр
о ВСД (для
используется вместо устаревшего
продукции,
"prVetDoc"
произведённой в
РФ) или ID
транспортного
ВСД (для
продукции,
произведённой
вне РФ)
*docType
string
-
Тип документа
см. Справочник "Типы документов""
*statusExt
string
-
Дополнительный
См. справочник "Справочник "Статусы
статус КИ
КИ""
*cisStatus
string
-
Актуальный
Cм. "Справочник "Статусы КИ""
статус КИ
*withdrawRe
string
-
Причина вывода
ason
из оборота
*documentId
string
-
Регистрационный
Необходимо указать при поиске КИ в
номер документа
документе
*haveChildre
boolean
-
Наличие
Параметр фильтрации, который
n
дочерних КИ
возвращает только коды, у которых
параметр "children" включает дочерние
КИ
64
Параметр
Тип
Обяз.
Описание
Комментарий
*packageTyp
string
-
Типы упаковок
См. "Справочник "Типы упаковки""
es
*emissionTyp
string
-
Виды выпуска в
es
оборот
*documentId
string
-
Регистрационный
номер документа.
Необходимо
указать при
поиске КИ в
документе
pg
string
-
Товарная группа
Параметр обязательно указывать для
товарных групп:
milk - "Молочная продукция";
water - "Упакованная вода"
Примечание: в запросе должен быть обязательно заполнен один из параметров "cisPackageType",
"packageTypes", "packs".
Пример ответа:
{
"results": [
{
"uit": "string",
"cis": "string",
"gtin": "string",
"sgtin": "string",
"tnVedEaes": "string",
"tnVedEaesGroup": "string",
"productName": "string",
"emissionDate": 0,
"producedDate": 0,
"participantName": "string",
"participantInn": "string",
"producerName": "string",
"producerInn": "string",
"ownerName": "string",
"ownerInn": "string",
"statusEx": "EMPTY",
"lastDocId": "string",
"lastDocType": "UNKNOWN",
"emissionType": "string",
"receiptDateTime": "2021-05-07T00:00:00.000Z",
"withdrawReason": "string",
"prevCises": [
"string"
],
"nextCises": [
65
"string"
],
"status": "EMITTED",
"packType": "UNIT",
"children": [
null
],
"countChildren": 0,
"cisChildren": [
"string"
],
"uitu": "string",
"dateChange": 0,
"parent": "string",
"expireDate": 0,
"prVetDocument": "string",
"introducedDate": 0,
"agentName": "string",
"agentInn": "string",
"previousAgentName": "string",
"previousAgentInn": "string",
"exporterName": "string",
"exporterTaxpayerId": "string",
"turnoverType": "SELLING",
"lastStatusChangeDate": 0,
"productGroup": "string",
"veterinaryControl":true,
"setGtin": [
{
"gtin": "string",
"productName": "string",
"quantity": 0
}
],
"setDescription": "string"
}
],
"total": 0,
"nextPage": true,
"docErrors": [
{
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
}
]
}
Параметры ответа:
66
Параметр
Тип
Обяз.
Описание
Комментарий
results
array
+
Результат запроса
*uit
string
-
КИ
Обязательный параметр, если не указан
"uitu"
*cis
string
+
Код
идентификации,
используемый для
фильтрации по
списку КИ
*gtin
string
-
Код товара
*sgtin
string
-
Код товара и
серийный номер
КИ
*tnVedEaes
string
-
Код ТН ВЭД
ЕАЭС товара (10
знаков)
*tnVedEaesG
string
-
Код товарной
roup
позиции ТН ВЭД
ЕАЭС товара
*productNam
string
-
Наименование
e
товара на этикетке
*emissionDat
integer
+
Дата эмиссии КИ
Возвращается в формате yyyy-MM-
e
ddTHH:mm:ss.SSS’Z
*producedDat
integer
-
Дата
Возвращается в формате yyyy-MM-
e
производства
ddTHH:mm:ss.SSS’Z
*participantN
string
-
Наименование
ame
участника
оборота товаров
*participantIn
string
-
ИНН участника
n
оборота товара
*producerNa
string
-
Производитель
me
товара
*producerInn
string
-
ИНН
производителя
товара
*ownerName
string
-
Наименование
собственника
товара
*ownerInn
string
-
ИНН
собственника
товара
67
Параметр
Тип
Обяз.
Описание
Комментарий
*statusEx
enum
-
Актуальные
особые состояния
КИ (см.
"Справочник
"Статусы КИ"")
*lastDocId
string
-
Последний
регистрационный
номер документа,
зафиксированный
в ГИС МТ по
этому КИ
*lastDocType
string
+
Тип последнего
документа (см.
"Справочник
"Типы
документов"")
*emissionTyp
string
+
Тип эмиссии
См. "Справочник "Типы эмиссии КИ""
e
*receiptDateT
string
-
Дата вывода из
Возвращается в формате yyyy-MM-
ime
оборота
ddTHH:mm:ss.SSS’Z. Поле "receiptDate"
является устаревшим
*withdrawRe
string
-
Причина вывода
ason
из оборота
*prevCises
[string]
-
Предыдущие
номера КИ (в
случае
перемаркировки
товара)
*nextCises
[string]
-
Следующие
номера КИ (в
случае
перемаркировки
товара)
*status
enum
+
Статус КИ. См
справочник
"Актуальные
статусы"
*packType
string
+
Тип упаковки (см.
"Справочник
"Типы
упаковки"")
*children
[array]
-
КИ в агрегате
(дочерние КИ)
68
Параметр
Тип
Обяз.
Описание
Комментарий
*countChildre
integer
-
Количество
n
дочерних КИ
*cisChildren
[string]
-
Список дочерних
КИ
*uitu
string
-
КИТУ,
обязательный
параметр, если не
указан "uit"
*dateChange
integer
-
Дата внесения
Возвращается в формате yyyy-MM-
изменений в
ddTHH:mm:ss.SSS’Z
КИТУ
*parent
string
-
Код
идентификации
упаковки, в
которую
агрегирован товар
*expireDate
integer
-
Дата истечения
Возвращается в формате yyyy-MM-
срока годности
ddTHH:mm:ss.SSS’Z (обязательный для
ТГ "Молочная продукция")
*prVetDocum
string
-
ID
Обязательный параметр для ТГ
ent
производственног
"Молочная продукция", если в карточке
о ВСД (для
НК "veterinaryControl" = true. Данный
продукции,
параметр используется вместо
произведённой в
устаревшего "prVetDoc". Используется
РФ) или ID
только ТГ "Молочная продукция"
транспортного
ВСД (для
продукции,
произведённой
вне РФ)
*introducedD
integer
-
Дата ввода в
ate
оборот.
Возвращается в
формате yyyy-
MM-
ddTHH:mm:ss.SSS
’Z
*agentName
string
-
Наименование
текущего
владельца товара
*agentInn
string
-
ИНН текущего
владельца товара
*previousAge
string
-
Наименование
ntName
предыдущего
владельца товара
69
Параметр
Тип
Обяз.
Описание
Комментарий
*previousAge
string
-
ИНН
ntInn
предыдущего
владельца товара
*exporterNam
string
-
Наименование
e
экспортёра
*exporterTax
string
-
Уникальный
payerId
идентификатор
экспортёра в
национальной
системе учёта
налогоплательщи
ков
*turnoverTyp
enum
-
Вид
Возможные значения:
e
товарооборота
SELLING - продажа;
COMMISSION
(COMMISSIONAIRE_SALE - устар.) -
комиссия;
AGENT - агент;
CONTRACT - передача маркированного
товара по договору подряда
*lastStatusCh
integer
+
Дата последнего
Возвращается в формате yyyy-MM-
angeDate
изменения статуса
ddTHH:mm:ss.SSS’Z
*productGrou
string
+
Товарная группа
См. "Справочник "Список
p
поддерживаемых товарных групп""
*veterinaryCo
boolean
-
Признак
Возвращается только для ТГ "Молочная
ntrol
подконтрольности
продукция"
ВСД, означающий
необходимость
проверки ВСД в
"ВетИС"
*setGtin
[array]
-
Код набора
Массив всегда возвращается в ответе,
если "packType" = "SET"
**gtin
string
+
Код товара,
входящего в
набор
**productNa
string
+
Наименование
me
товара на этикетке
**quantity
integer
+
Количество кодов
товара, входящих
в набор
70
Параметр
Тип
Обяз.
Описание
Комментарий
*setDescriptio
string
-
Текстовое
Возвращается описание товара в составе
n
описание набора
набора, содержащее параметры,
специфичные для конкретного товара.
Данный параметр вернётся в том случае,
если он заполнен в карточке НК (см.
"Справочник "Дополнительные
параметры в ответе в зависимости от
товарных групп"")
total
string
+
Количество
вернувшихся
ответов
nextPage
boolean
+
Признак наличия
Возможные значения:
следующей
true - имеется следующая страница;
страницы
false - следующая страница отсутствует
docErrors
[string]
-
Список ошибок
обработки
документа.
Возвращается в
случае ошибки
additionalPro
string
-
Список ошибок
Структура данных, состоящая из перечня
p
обработки
ошибок обработки документа.
документа
Возвращается в случае ошибки
2.2. Метод получения подробной информации о КИ (GET)
Метод возвращает подробную информацию о запрашиваемом КИ (в 1 запросе 1 КИ), который
доступен в данный момент времени участнику оборота товаров (ИНН организации содержится в
токене).
URL: v4/facade/identifytools/info
Метод: GET
Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в
разделе "Указание параметров в строке запроса при работе с большими агрегатами".
Пример строки запроса:
curl -X GET "<url стенда
v4>/facade/facade/identifytools/info?childrenPage=1&childrenLimit=50&cis=0000000000000
00000%00bD%0B0FUTJHhbN""
-H "accept: */*
Параметры строки запроса:
71
Параметр
Тип
Обяз.
Описание
Комментарий
cis
string
+
КИ
childrenPagin
boolean
+
Флаг,
При включённом значении возвращает
g
включающий
постранично агрегаты только первого слоя
пагинацию
через указанные ниже параметры.
агрегатов
Значение по умолчанию: false
childrenPage
number
-
Число страниц
Значение по умолчанию: 1
вложений
агрегата первого
слоя
childrenLimit
number
-
Количество
Значение по умолчанию: 50
вложений на
странице агрегата
первого слоя
pg
string
-
Товарная группа
Параметр обязательно указывать для
товарных групп:
milk - "Молочная продукция";
water - "Упакованная вода"
Пример ответа
{
"uit": "0104669318392182215=8xv7rzu't%_",
"cis": "0104669318392182215=8xv7rzu't%_",
"gtin": "04669318392182",
"sgtin": "5=8xv7rzu't%_",
"tnVedEaes": "2201101100",
"tnVedEaesCode": "2201",
"productName": "Вода",
"emissionDate": "2021-09-17T07:23:54.282Z",
"producedDate": "2021-09-23T00:00:00.000Z",
"producerName": "ООО \"ОПЕРАТОР-ЦРПТ\"",
"producerInn": "7731376812",
"lastDocId": "10f1511f-7253-4e34-9235-48acaf930b9b",
"lastDocType": "LP_INTRODUCE_GOODS",
"emissionType": "LOCAL",
"prevCises": [],
"nextCises": [],
"status": "INTRODUCED",
"packType": "UNIT",
"introducedDate": "2021-09-23T13:28:47.615Z",
"lastStatusChangeDate": "2021-09-23T13:28:47.615Z",
"productGroup": "water",
"markWithdraw": false,
"wellNumber": "111114, 111115, 111116"
}
72
Параметры ответа:
Параметр
Тип
Обяз.
Описание
Комментарий
uit
string
-
КИ
Обязательный параметр, если не указан
"uitu"
cis
string
+
КИ,
используемый для
фильтрации по
списку КИ
gtin
string
-
Код товара
sgtin
string
-
Код товара и
серийный номер
КИ
tnVedEaes
string
-
Код ТН ВЭД
ЕАЭС товара (10
знаков)
tnVedEaesCo
string
-
Код ТН ВЭД
de
ЕАЭС товара (4
знака)
tnVedEaesGr
string
-
Код товарной
oup
позиции ТН ВЭД
ЕАЭС товара
productName
string
-
Наименование
товара на этикетке
emissionDate
integer
+
Дата эмиссии КИ
Возвращается в формате yyyy-MM-
ddTHH:mm:ss.SSS’Z
producedDate
integer
-
Дата ввода товара
Возвращается в формате yyyy-MM-
с КИ в оборот
ddTHH:mm:ss.SSS’Z
participantInn
string
-
ИНН участника
оборота товара
participantNa
string
-
Наименование
me
участника
оборота товаров
producerInn
string
-
ИНН
производителя
товара
producerNam
string
-
Производитель
e
товара
ownerInn
string
-
ИНН
собственника
товара
73
Параметр
Тип
Обяз.
Описание
Комментарий
ownerName
string
-
Наименование
собственника
товара
statusEx
string
+
Особое состояние
См справочник "Актуальные особые
КИ
состояния"
lastDocId
string
-
Последний
регистрационный
номер документа,
зафиксированный
в ГИС МТ по
этому КИ
lastDocType
string
+
Тип последнего
См. "Справочник "Типы документов""
документа
emissionType
string
+
Тип эмиссии
Возможные значение:
См. "Справочник "Типы эмиссии КИ""
receiptDateTi
string
-
Дата вывода из
Возвращается в формате yyyy-MM-
me
оборота
ddTHH:mm:ss.SSS’Z. Поле "receiptDate"
является устаревшим
withdrawReas
string
-
Причина вывода
on
из оборота
withdrawal_ty
string(1-
-
Другая причина
Параметр обязательный при
pe_other
255)
"withdrawReason" ("Причина вывода из
оборота") = OTHER ("Другое"). В случае
указания иных причин данный параметр
недоступен
prevCises
[string]
-
Предыдущие
номера КИ (в
случае
перемаркировки
товара)
nextCises
[string]
-
Следующие
номера КИ (в
случае
перемаркировки
товара)
status
string
+
Статус КИ
См. справочник "Актуальные статусы"
packType
string
+
Тип упаковки
См. "Справочник "Типы упаковки""
children
[string]
-
КИ в агрегате
countChildren
integer
-
Количество
дочерних КИ
cisChildren
[string]
-
Список дочерних
КИ
74
Параметр
Тип
Обяз.
Описание
Комментарий
uitu
string
-
КИТУ
Обязательный параметр, если не указан
"uit"
dateChange
integer
-
Дата внесения
Возвращается в формате yyyy-MM-
изменений в
ddTHH:mm:ss.SSS’Z
КИТУ
parent
string
-
КИТУ
вышестоящего
уровня
expireDate
integer
-
Дата истечения
Возвращается в формате yyyy-MM-
срока годности
ddTHH:mm:ss.SSS’Z (обязательный для
ТГ "Молочная продукция")
prVetDocume
string
-
ID
Обязательный параметр для ТГ
nt
производственног
"Молочная продукция". Данный параметр
о ВСД (для
используется вместо устаревшего
продукции,
"prVetDoc"
произведённой в
РФ) или ID
транспортного
ВСД (для
продукции,
произведённой
вне РФ)
introducedDat
integer
-
Дата ввода в
Возвращается в формате yyyy-MM-
e
оборот с КИ
ddTHH:mm:ss.SSS’Z
agentInn
string
-
ИНН текущего
владельца товара
agentName
string
-
Наименование
текущего
владельца товара
previousAgen
string
-
ИНН
tInn
предыдущего
владельца товара
previousAgen
string
-
Наименование
tName
предыдущего
владельца товара
exporterName
string
-
Наименование
экспортёра
exporterTaxp
string
-
Уникальный
ayerId
идентификатор
экспортёра в
национальной
системе учета
налогоплательщи
ков
75
Параметр
Тип
Обяз.
Описание
Комментарий
turnoverType
enum
-
Вид
товарооборота
lastStatusCha
integer
+
Дата последнего
Возвращается в формате yyyy-MM-
ngeDate
изменения статуса
ddTHH:mm:ss.SSS’Z
productGroup
string
+
Товарная группа
См. "Справочник "Список
поддерживаемых товарных групп""
markWithdra
boolean
-
Признак выбытия
w
по чеку ККТ от
невладельца
withdrawReas
string(1-
-
Причина выбытия
Обязательное поле с описанием причины
onOther
225)
(другое)
вывода из оборота при значении "Причина
выбытия" ("withdrawReason") = "Другое"
(OTHER)
partialSaleInf
object
-
Объект
Возвращается для ТГ "Духи и туалетная
o
параметров
вода" (наливная продукция, объем в мл)
частичного
выбытия
*innerUnitCo
integer
-
Общее
Значением параметра является
unt
количество
количество/объём товара в
(объем) товара в
потребительской упаковке/единице товара
потребительской
упаковке
*soldUnitCou
number
-
Количество
Значением параметра является число
nt
(объем)
выбывших, в том числе от невладельцев,
выведенного из
из оборота единиц употребления из всех
оборота товара по
чеков. Участнику оборота товаров
КИ
отображается информация только по
собственным чекам. ФОИВ доступна
информация по всем чекам
*rest
number
-
Количество
Значением параметра является расчётное
(объем) товара,
количество/объём оставшихся в
доступного к
потребительской упаковке/единице товара
выводу из
единиц употребления/мл товара после
оборота по КИ
продажи всеми участниками оборота
товаров. Участнику оборота товаров
отображается информация только по
собственным чекам. ФОИВ доступна
информация по всем чекам
76
Параметр
Тип
Обяз.
Описание
Комментарий
*correctRest
boolean
-
Корректность
Показатель корректности остатка товара
остатка товара
после вывода товара из оборота: false -
продано или возвращено больше
допустимого количества/объема товара;
true - продано или возвращено в пределах
допустимого количества/объема товара.
Для товарной группы "Духи и туалетная
вода" (наливная продукция) продажа
товара в объеме, превышающем
заявленный, а также превышение остатка
товара более чем на 8% считаются
некорректными
setGtin
[array]
-
Код набора
Массив всегда возвращается в ответе,
если "packType" = "SET"
*gtin
string
+
Код товара,
входящего в
набор
*productNam
string
+
Наименование
e
товара на этикетке
*quantity
integer
+
Количество кодов
товара, входящих
в набор
setDescription
string
-
Текстовое
Возвращается описание товара в составе
описание набора
набора, содержащее параметры,
специфичные для конкретного товара.
Данный параметр вернётся в том случае,
если он заполнен в карточке НК (см.
"Справочник "Дополнительные
параметры в ответе в зависимости от
товарных групп"").
veterinaryCon
boolean
-
Признак
Возвращается только для ТГ "Молочная
trol
подконтрольности
продукция"
ВСД, означающий
необходимость
проверки ВСД в
"ВетИС"
wellNumber
string
-
Номер скважины
Возвращается только для товарной группы
"Упакованная вода"
2.3. Метод получения списка товаров по заданному фильтру
Согласно заданному фильтру метод возвращает подробную информацию о списке товаров,
которые доступны на данный момент времени участнику оборота товаров (ИНН организации
содержится в токене).
URL: /facade/marked_products/listV2
77
Метод: GET
Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в
разделе "Указание параметров в строке запроса при работе с большими агрегатами".
Пример строки запроса:
curl -X GET '<url
стенда>/facade/marked_products/listV2?childrenPage=1&childrenLimit=50
&pg=string&cis=010290000004722821M%26pIX4%271xFQM.&cisMatchMode=EQ&emissionDateFrom=0
&emissionDateTo=0>in=string&sn=string&producerInn=string&ownerInn=string&cisPackageT
ype=UNIT
&tnVed10=string&emissionType=INVALID_VALUE&pageDir=PREV&uit=string&orderColumn=string&
order=ASC
&orderedColumnValue=string&limit=0&cisAggregationState=PACKED&packs=ALL&aggregation=tr
ue &countChildren=0&tree=NO_TREE&uituStatus=string&cache=true&prVetDocument=string
&docType=UNKNOWN&statusExt=WAIT_SHIPMENT&cisStatus=INTRODUCED®istryType=RECEIVED
&agentInn=string&previousAgentInn=string&turnoverType=SELLING"
-H 'Authorization: Bearer <ТОКЕН>'
Параметры строки запроса:
Параметр
Тип
Обяз.
Описание
Комментарий
childrenPagin
boolean
+
Флаг,
При включённом значении возвращает
g
включающий
постранично агрегаты только первого слоя
пагинацию
через указанные ниже параметры.
агрегатов
Значение по умолчанию: false
childrenPage
number
-
Число страниц
Значение по умолчанию: 1
вложений
агрегата первого
слоя
childrenLimit
number
-
Количество
Значение по умолчанию: 50
вложений на
странице агрегата
первого слоя
pg
string
-
Товарная группа
Параметр обязательно указывается в
строке запроса для товарных групп:
milk - "Молочная продукция";
water - "Упакованная вода"
filter
object
+
Фильтр запроса
packType
string
+
Тип упаковки
Cм. "Справочник "Типы упаковки""
*cache
boolean
-
Флаг
использование
кэша
78
Параметр
Тип
Обяз.
Описание
Комментарий
*cis
string
-
Код
идентификации,
используемый для
фильтрации по
списку КИ
*cisMatchMo
string
-
Режим
Возможные значения:
de
фильтрации по
EQ - полностью равен;
КИ
LIKE - содержит в себе. Является
устаревшим и в дальнейшем будет удалён.
Рекомендуется использовать
"START_WITH" ("Начинается с");
START_WITH - начинается с
*emissionDat
date-
-
Дата эмиссии, от
Формат: yyyy-MM-
eFrom
time
ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
Пример 2019-01-01T03:00:00.000Z
*emissionDat
date-
-
Дата эмиссии, до
Формат: yyyy-MM-
eTo
time
ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z.
Пример 2019-01-01T03:00:00.000Z
*gtin
string
-
Код товара
*producerInn
string
-
ИНН
производителя
*sn
string
-
Серийный номер
кода
идентификации
*ownerInn
string
-
ИНН
собственника
товара
*cisPackageT
enum
-
Тип упаковки
См. "Справочник "Типы упаковки"".
ype
Можно указать только одно значение типа
упаковки
*tnVed10
string
-
Код товарной
номенклатуры (10
знаков)
*emissionTyp
string
-
Тип эмиссии
См. "Справочник "Типы эмиссии КИ""
e
*pageDir
enum
-
Выбор
Возможные значения:
направления для
PREV - Предыдущий раздел;
пагинации
NEXT - Следующий раздел
79
Параметр
Тип
Обяз.
Описание
Комментарий
*uit
string
-
Значение КИ,
"точки отсчёта"
(запись, с которой
начнется
выборка), по
которому
сортируются
записи.
Использовать
только совместно
с параметром
"orderedColumnVa
lue"
*order
string
-
Направление
Возможные значения:
сортировки
ASC - по возрастанию;
DESC - по убыванию
*orderColum
string
-
Название столбца,
n
по которому будет
производиться
сортировка.
Допустимое
значение emd -
дата эмиссии
*orderedColu
string
-
Значение столбца,
mnValue
"точки отсчёта"
(запись, с которой
начинается
выборка), по
которому
сортируются
записи.
Использовать
только совместно
с параметром "uit"
*limit
integer
-
Значение
устанавливает
количество
записей в ответе,
не более 10000
записей (по
умолчанию 10
записей)
*cisAggregati
enum
-
Состояние КИ
Возможные значения:
onState
PACKED - в агрегате (агрегирован);
NOT_PACKED - не в агрегате
(дезагрегирован);
ANY - любое состояние
80
Параметр
Тип
Обяз.
Описание
Комментарий
*packs
string
-
Фильтрация по
Возможные значения:
единичным
ALL - товары и упаковки;
товарным
UNIT - только товары (UNIT, BUNDLE);
упаковкам
PACK - только упаковки (LEVEL1,
LEVEL2, LEVEL3, LEVEL4, LEVEL5,
ATK, SET)
См. "Справочник "Типы упаковки""
*aggregation
boolean
-
Показывать
товары и
товарные
упаковки только в
одном статусе для
агрегации
*countChildre
integer
-
Количество
n
(int32)
дочерних КИ
*tree
string
-
Способ вывода
Возможные значения:
дерева списка
NO_TREE - Не возвращать вложенные
КИ/КИТУ
КИ;
ONE_LEVEL - Возвращать только первый
уровень вложенности;
ALL_TREE - Возвращать всё дерево
Данный параметр считается
устаревшим и в дальнейшем
поддерживаться не будет: рекомендуется
использовать параметры "childrenPaging",
"childrenPage", "childrenLimit" (подробнее
см. раздел "Указание параметров в строке
запроса при работе с большими
агрегатами")
*uituStatus
string
-
Статус КИТУ
*prVetDocum
string
-
ID
Обязательный параметр для товарной
ent
производственног
группы "Молочная продукция". Данный
о ВСД (для
параметр используется вместо
продукции,
устаревшего "prVetDoc"
произведённой в
РФ) или ID
транспортного
ВСД (для
продукции,
произведённой
вне РФ)
*doctype
string
-
Тип документа
См. "Справочник "Типы документов""
*cisStatus
string
-
Текущий статус
См. справочник "Актуальные статусы"
КИ
81
Параметр
Тип
Обяз.
Описание
Комментарий
*statusExt
enum
-
Актуальное
См. справочник "Актуальные особые
особое состояние
состояния"
товара
*turnoverTyp
enum
-
Вид
Возможные значения:
e
товарооборота
SELLING - продажа;
COMMISSION
(COMMISSIONAIRE_SALE - устар.) -
комиссия;
AGENT - агент
*registryType
string
-
Тип реестра
Возможные значения:
RECEIVED - полученные;
GIVEN - переданные
*agentInn
string
-
ИНН владельца
товара
*previousAge
string
-
ИНН
ntInn
предыдущего
владельца товара
Пример ответа:
{
"results": [
{
"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",
"turnoverType": "SELLING",
"statusEx": "EMPTY",
"docNum": "string",
"emissionDate": 0,
"producedDate": 0,
"introducedDate": 0,
"emissionType": "string",
"prodOrderType": "SELF_MADE",
"lastDocId": "string",
"name": "string",
82
"brand": "string",
"model": "string",
"certDoc": {
"type": "string",
"number": "string",
"date": "string"
},
"prevCises": [
"string"
],
"nextCises": [
"string"
],
"status": "INTRODUCED",
"remarks": [
{
"curr": "string",
"prev": "string",
"date": "string"
}
],
"cisChildren": [
"string"
],
"children": [
{
"cis": "string",
"gtin": "string",
"producerName": "string",
"status": "INTRODUCED",
"emissionDate": 0,
"producedDate": 0,
"packageType": "UNIT",
"ownerName": "string",
"ownerInn": "string",
"productName": "string",
"brand": "string",
"prevCises": [
"string"
],
"nextCises": [
"string"
],
"statusEx": "EMPTY",
"children": [
"string"
],
"childrenMap": {},
"countChildren": 0,
"parent": "string",
"lastDocId": "string",
83
"expireDate": 0,
"prVetDocument": "string",
"introducedDate": 0,
"exporterName": "string",
"exporterTaxpayerId": "string",
"agentName": "string",
"agentInn": "string",
"lastStatusChangeDate": 0,
"turnoverType": "SELLING",
"productGroup": "string",
"tnVed10": "string",
"veterinaryControl": true,
"markWithdraw": "TRUE"
}
],
"childrenDetails": [
null
],
"countChildren": 0,
"uitu": "string",
"parent": "string",
"packType": "UNIT",
"withdrawReason": "string",
"receiptDate": "2021-05-07T00:00:00.000Z",
"expireDate": 0,
"prVetDocument": "string",
"exporterName": "string",
"exporterTaxpayerId": "string",
"certificateType": "CONFORMITY_CERT",
"certificateNumber": "string",
"certificateDate": "string",
"productGroup": "string"
}
],
"total": 0,
"nextPage": true,
"docErrors": [
]
}
Параметры ответа:
Параметр
Тип
Обяз.
Описание
Комментарий
results
object
+
Результат запроса
*cis
string
+
Код
идентификации,
используемый для
фильтрации по
списку КИ
84
Параметр
Тип
Обяз.
Описание
Комментарий
*gtin
string
-
Код товара
*sgtin
string
-
Код товара и
серийный номер
КИ
*tnvd
string
-
Код товарной
номенклатуры (10
знаков)
*tnvedGroup
string
-
Код товарной
позиции ТН ВЭД
ЕАС товара
(первые 4
символа)
*producerNa
string
-
Производитель
me
товара
*productNam
string
-
Наименование
e
продукта
*producerInn
string
-
ИНН
производителя/им
портёра товара
*ownerName
string
-
Наименование
собственника
товара
*ownerInn
string
-
ИНН
собственника
товара
*agentName
string
-
Наименование
текущего
владельца товара
*agentInn
string
-
ИНН текущего
владельца товара
*previousAge
string
-
Наименование
ntName
предыдущего
владельца товара
*previousAge
string
-
ИНН
ntInn
предыдущего
владельца товара
*turnoverTyp
enum
-
Вид
Возможные значения:
e
товарооборота
SELLING - продажа;
COMMISSION
(COMMISSIONAIRE_SALE - устар.) -
комиссия;
AGENT - агент
85
Параметр
Тип
Обяз.
Описание
Комментарий
statusExt
enum
-
Дополнительный
Возможные значения:
статус товара
WAIT_SHIPMENT - ожидает
подтверждения приёмки;
WAIT_TRANSFER_TO_OWNER -
ожидает передачу владельцу
(производство по контракту);
WAIT_REMARK - КИ списан после
нанесения на товар (товар ожидает
перемаркировку);
WITHDRAW - вывод из оборота;
REMARK_RETIRED - перемаркирован
*docNum
string
-
Регистрационный
номер документа
*emissionDat
string
+
Дата эмиссии КИ
Возвращается в формате yyyy-MM-
e
(date-
ddTHH:mm:ss.SSS’Z
time)
*producedDat
string
-
Дата нанесения
Возвращается в формате yyyy-MM-
e
(date-
ddTHH:mm:ss.SSS’Z
time)
*introducedD
string
-
Дата ввода в
Возвращается в формате yyyy-MM-
ate
(date-
оборот
ddTHH:mm:ss.SSS’Z
time)
*emissionTyp
string
-
Тип эмиссии
См. "Справочник "Типы эмиссии КИ""
e
*prodOrderTy
enum
-
Тип
Возможные значения:
pe
производственног
SELF_MADE - Собственное
о заказа
производство;
OPERATOR - Производство товара по
договору
*lastDocId
string
-
Последний
регистрационный
номер документа,
зафиксированный
в ГИС МТ по
этому КИ
*name
string
-
Наименование
товара
*brand
string
-
Бренд
*model
string
-
Модель товара
*certDoc
string
-
Сертификат
86
Параметр
Тип
Обяз.
Описание
Комментарий
**date
string
-
Дата сертификата
Возвращается в одном из форматов:
dd.MM.yyyy, yyyy-MM-dd, yyyy-MM-
dd’T’HH:mm:ss.SSS’Z’, yyyy-MM-
dd’T’HH:mm:ss’Z’, dd.MM.yyyy HH:mm
**number
string
-
Номер
сертификата
**type
string
-
Тип сертификата
*prevCises
[string]
-
Предыдущие КИ
в случае
перемаркировки
товара
*nextCises
[string]
-
Следующие
номера КИ в
случае
перемаркировки
товара
*status
enum
+
Статус КИ
Возможные значения:
INTRODUCED - В обороте;
RETIRED - Выбыл
Для перемаркированного КИ возможное
значение "RETIRED" (Выбыл)
*remarks
-
Список
перемаркировок
данного товара
**curr
string
-
Текущий КИ
товара
**date
string
-
Дата
Возвращается в формате yyyy-MM-
перемаркировки
ddTHH:mm:ss.SSS’Z
**prev
string
-
Предыдущие КИ
товара
*cisChildren
[string]
-
Список дочерних
КИ
*children
[array]
-
КИ в агрегате
**cis
string
+
КИ товара
**gtin
string
-
Код товара
**producerNa
string
-
Производитель
me
товара
87
Параметр
Тип
Обяз.
Описание
Комментарий
**status
enum
+
Статус товара/КИ
Возможные значения:
INTRODUCED - В обороте;
RETIRED - Выбыл
**emissionDa
string
+
Дата эмиссии
Задаётся в формате yyyy-MM-
te
(date-
ddTHH:mm:ss.SSS’Z
time)
**producedD
string
-
Дата ввода товара
Возвращается в формате yyyy-MM-
ate
(date-
с КИ в оборот
ddTHH:mm:ss.SSS’Z
time)
**packageTy
string
+
Тип упаковки
См. "Справочник "Типы упаковки""
pe
**ownerInn
string
-
ИНН
собственника
товара
**ownerNam
string
-
Наименование
e
собственника
товара
**productNa
string
-
Наименование
me
товара на этикетке
**brand
string
-
Бренд
**nextCises
[string]
-
Следующие
номера КИ в
случае
перемаркировки
товара
**prevCises
[string]
-
Предыдущие
номера КИ в
случае
перемаркировки
товара
**statusEx
enum
-
Актуальные
См. "Справочник "Статусы КИ""
особые состояния
КИ
**children
[string]
-
Все КИ в агрегате
Возвращается в формате JSON-массива
**childrenMa
[string]
-
Краткая
p
информация о
дочерних КИ
**countChildr
integer
-
Количество
en
дочерних КИ
88
Параметр
Тип
Обяз.
Описание
Комментарий
**parent
string
-
Код
идентификации
упаковки, в
которую
агрегирован товар
**lastDocId
string
-
Последний
регистрационный
номер документа,
зафиксированный
в ГИС МТ по
этому КИ
**expireDate
string
-
Дата истечения
Обязательный для товарной группы
(date-
срока годности
"Молочная продукция"
time)
expirationDat
string
-
Дата истечения
Возвращается в формате yyyy-MM-
e
(date-
срока годности
ddTHH:mm:ss.SSS’Z. Обязательный для
time)
товарной группы "Молочная продукция"
**prVetDocu
string
-
ID
Обязательный параметр для товарной
ment
производственног
группы "Молочная продукция". Данный
о ВСД (для
параметр используется вместо
продукции,
устаревшего "prVetDoc"
произведённой в
РФ) или ID
транспортного
ВСД (для
продукции,
произведённой
вне РФ)
**introduced
string
-
Дата ввода КИ в
Возвращается в формате yyyy-MM-
Date
(date-
оборот
ddTHH:mm:ss.SSS’Z
time)
**exporterNa
string
-
Наименование
me
экспортёра
**exporterTa
string
-
Уникальный
xpayerId
идентификатор
экспортёра в
национальной
системе учёта
налогоплательщи
ков
**agentName
string
-
ИНН текущего
владельца товара
**agentInn
string
-
Наименование
текущего
владельца товара
89
Параметр
Тип
Обяз.
Описание
Комментарий
**lastStatusC
string
+
Дата последнего
Возвращается в формате yyyy-MM-
hangeDate
(date-
изменения статуса
ddTHH:mm:ss.SSS’Z
time)
**turnoverTy
enum
-
Вид
Возможные значения:
pe
товарооборота
SELLING - продажа;
COMMISSION
(COMMISSIONAIRE_SALE - устар.) -
комиссия;
AGENT - агент
**productGro
string
+
Товарная группа
См. "Справочник "Список
up
поддерживаемых товарных групп""
**tnVed10
string
-
Код ТН ВЭД (10
знаков)
**veterinaryC
boolean
-
Признак
Возвращается только для товарной группы
ontrol
подконтрольности
"Молочная продукция"
ВСД, означающий
необходимость
проверки ВСД в
ФГИС "ВетИС"
**markWithd
boolean
-
Зафиксирована
raw
розничная
продажа по чеку
от невладельца
КИ
*childrenDeta
[array]
-
Маркированный
ils
товар
*countChildre
integer
-
Количество
n
дочерних КИ
*uitu
string
-
КИТУ
вышестоящего
уровня
*parent
string
-
Код
идентификации
упаковки, в
которую
агрегирован товар
*packType
string
+
Тип упаковки
См. "Справочник "Типы упаковки""
*withdrawRe
string
-
Причина вывода
ason
из оборота
receiptDate
string
-
Дата вывода из
Возвращается в формате yyyy-MM-
оборота
ddTHH:mm:ss.SSS’Z
90
Параметр
Тип
Обяз.
Описание
Комментарий
*expireDate
string
-
Дата истечения
Обязательный для товарной группы
(date-
срока годности
"Молочная продукция"
time)
*prVetDocum
string
-
ID
Обязательный параметр для товарной
ent
производственног
группы "Молочная продукция". Данный
о ВСД (для
параметр используется вместо
продукции,
устаревшего "prVetDoc"
произведённой в
РФ) или ID
транспортного
ВСД (для
продукции,
произведённой
вне РФ)
*exporterNam
string
-
Наименование
e
экспортёра
*exporterTax
string
-
Уникальный
payerId
идентификатор
экспортёра в
национальной
системе учёта
налогоплательщи
ков
*certificateTy
string
-
Вид документа,
Возможные значения:
pe
подтверждающего
соответствие
CONFORMITY_CERTIFICATE -
сертификат соответствия;
CONFORMITY_DECLARATION -
декларация о соответствии;
CONFORMITY_CERTIFICATE_OR_DEC
LARATION - сертификат или декларация
о соответствии
*certificateNu
string
-
Номер документа,
mber
подтверждающего
соответствие
*certificateDa
string
-
Дата документа,
te
подтверждающего
соответствие
*productGrou
string
+
Товарная группа
Cм. "Справочник "Список
p
поддерживаемых товарных групп""
*color
string
-
Цвет
Возвращается для товарной группы
"Обувные товары"
*productSize
string
-
Размер
Возвращается для товарной группы
"Обувные товары"
91
Параметр
Тип
Обяз.
Описание
Комментарий
total
string
+
Количество
вернувшихся
ответов
docErrors
[string]
-
Список ошибок
Возвращается в случае ошибки
обработки
документа
nextPage
boolean
+
Признак наличия
Возможные значения:
следующей
true - имеется следующая страница;
страницы
false - следующая страница отсутствует
2.4. Метод получения краткой информации о КИ/списке КИ
(общедоступный)
Метод является устаревшим и будет удалён из описания. Использовать "Метод получения списка
КИ по идентификатору" /cis/cis_list (POST).
URL: /facade/cis/cis_list
Метод: GET
Пример запроса:
curl -X GET
"<url
стенда>/facade/cis/cis_list?cis=010463003407002921wskg1E44R1qym2406401&cis=01046902297
8096621qSF7qjA3aRIqM2406402"
-H 'content-type: application/json' -H 'Authorization: Bearer <ТОКЕН>'
Параметры запроса:
Параметр
Тип
Обяз.
Описание
Комментарий
childrenPagin
boolean
+
Флаг,
При включённом значении возвращает
g
включающий
постранично агрегаты только первого слоя
пагинацию
через указанные ниже параметры.
агрегатов
Значение по умолчанию: false
childrenPage
number
-
Число страниц
Значение по умолчанию: 1
вложений
агрегата первого
слоя
childrenLimit
number
-
Количество
Значение по умолчанию: 50
вложений на
странице агрегата
первого слоя
cis
string
+
Код
идентификации
92
Параметр
Тип
Обяз.
Описание
Комментарий
pg
string
-
Товарная группа
Параметр обязательно указывать для
товарных групп:
milk - "Молочная продукция";
water - "Упакованная вода"
Параметры заголовка запроса: Authorization: Bearer <token>
Пример ответа:
93
{
"0000000000000000000=8xv7rzu't%_": {
"cis": "000000000000000000=8xv7rzu't%_",
"gtin": "0111111111111",
"producerName": "ООО \"X\"",
"producerInn": "7777777777",
"status": "INTRODUCED",
"emissionDate": "2021-09-17T07:23:54.282Z",
"emissionType": "LOCAL",
"producedDate": "2021-09-23T00:00:00.000Z",
"packType": "UNIT",
"ownerName": "ООО \"ОПЕРАТОР-ЦРПТ\"",
"ownerInn": "7777777777",
"productName": "Вода",
"brand": "X",
"prevCises": [],
"nextCises": [],
"countChildren": 0,
"lastDocId": "10f1511f-7253-4e34-9235-48acaf930b9b",
"introducedDate": "2021-09-23T13:28:47.615Z",
"agentName": "",
"lastStatusChangeDate": "2021-09-23T13:28:47.615Z",
"productGroup": "water",
"tnVed10": "2201101100",
"markWithdraw": false,
"certDoc": [
{
"type": "CONFORMITY_CERTIFICATE",
"number": "12343434234234",
"date": "2021-02-03"
},
{
"type": "CONFORMITY_DECLARATION",
"number": "12343434234234",
"date": "2021-02-03"
},
{
"type": "STATE_REGISTRATION_CERTIFICATE",
"number": "12343434234234",
"date": "2021-02-03",
"wellNumber": "111114"
},
{
"type": "STATE_REGISTRATION_CERTIFICATE",
"number": "12343434234234",
"date": "2021-02-03"
}
]
}
}
94
Параметры ответа:
Параметр
Тип
Обяз.
Описание
*cis
string
+
Код идентификации, используемый для
фильтрации по списку КИ
*gtin
string
-
Код товара
*producerName
string
-
Производитель товара
*producerInn
string
-
ИНН производителя товара
*status
enum
+
Статус товара/КИ:
EMITTED - Эмитирован. Выпущен;
APPLIED - Эмитирован. Получен;
INTRODUCED - В обороте;
WRITTEN_OFF - КИ списан;
RETIRED - Выбыл;
DISAGGREGATION - Расформирован (только
для упаковок)
*emissionDate
string
+
Дата выпуска КИ. Возвращается в формате
(date-
yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
*producedDate
string
-
Дата нанесения. Возвращается в формате yyyy-
(date-
MM-ddTHH:mm:ss.SSS’Z
time)
packageType
string
+
Тип упаковки. см. Справочник "Типы
упаковки"
*ownerName
string
-
Наименование собственника товара
*ownerInn
string
-
ИНН собственника товара
*productName
string
-
Название продукта
*brand
string
-
Бренд
*prevCises
[string]
-
Предыдущие номера КИ. В случае
перемаркировки товара
*nextCises
[string]
-
Следующие номера КИ. В случае
перемаркировки товара
*statusEx
enum
-
Актуальные особые состояния КИ (см.
Справочник "Статусы КИ")
*children
[string]
-
КИ в агрегате
*childrenMap
[string]
-
Краткая информация о дочерних КИ
*brand
string
-
Бренд
*children:
[string]
-
Все дочерние КИ. Возвращается в формате
JSON-массива
*childrenMap
[string]
-
Краткая информация о дочерних КИ
95
Параметр
Тип
Обяз.
Описание
*cis
string
+
КИ товара
*countChildren
integer
-
Количество дочерних КИ
(int32)
*emissionDate
string
+
Дата эмиссии. Возвращается в формате yyyy-
(date-
MM-ddTHH:mm:ss.SSS’Z
time)
*emissionType
string
-
Тип эмиссии. См. Справочник "Типы эмиссии
КИ"
*expireDate
string
-
Дата истечения срока годности. Возвращается
(date-
в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
(обязательный для ТГ "Молочная продукция")
*exporterName
string
-
Наименование экспортёра
*exporterTaxpayerId
string
-
уникальный идентификатор экспортера в
национальной системе учета
налогоплательщиков
*sgtin
string
-
Код товара и серийный номер КИ
*introducedDate
string
-
Дата ввода в оборот. Возвращается в формате
(date-
yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
*lastDocId
string
-
Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
*nextCises
[string]
-
Следующие номера КИ при перемаркировке
*ownerInn
string
-
ИНН собственника товара
*ownerName
string
-
Наименование собственника товара
*packageType
string
+
Тип упаковки (см. "Справочник "Типы
упаковки"")
*parent
string
-
Код идентификации упаковки, в которую
агрегирован товар
*prVetDocument
string
-
ID производственного ВСД (для продукции,
произведённой в РФ) или ID транспортного
ВСД (для продукции, произведённой вне РФ).
Обязательный параметр для ТГ "Молочная
продукция". Данный параметр используется
вместо устаревшего "prVetDoc"
*producedDate
string
-
Дата нанесения. Возвращается в формате yyyy-
(date-
MM-ddTHH:mm:ss.SSS’Z
time)
*producerName
string
-
Производитель товара
*productName
string
-
Название продукта
96
Параметр
Тип
Обяз.
Описание
*status
enum
+
Статус товара/КИ:
EMITTED - Эмитирован. Выпущен;
APPLIED - Эмитирован. Получен;
INTRODUCED - В обороте;
WRITTEN_OFF - КИ списан;
RETIRED - Выбыл;
DISAGGREGATION - Расформирован (только
для упаковок)
*statusEx
enum
-
Актуальные особые состояния КИ (см.
"Справочник "Статусы КИ"")
*turnoverType
enum
-
Вид товарооборота: SELLING - продажа;
COMMISSION - комиссия; AGENT - агент
*productGroup
string
+
Товарная группа (см. "Справочник "Список
поддерживаемых товарных групп"")
*tnVed10
string
-
Код ТН ВЭД (10 знаков)
*countChildren
integer
-
Количество дочерних КИ
(int32)
*parent
string
-
КИТУ вышестоящего уровня
*lastDocId
string
-
Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
*expireDate
string
-
Дата истечения срока годности. Возвращается
(date-
в формате yyyy-MM-ddTHH:mm:ss.SSS’Z
time)
(обязательный для ТГ "Молочная продукция")
*prVetDocument
string
-
ID производственного ВСД (для продукции,
произведённой в РФ) или ID транспортного
ВСД (для продукции, произведённой вне РФ).
Обязательный параметр для ТГ "Молочная
продукция". Данный параметр используется
вместо устаревшего "prVetDoc"
*introducedDate
string
-
Дата ввода в оборот с КИ в оборот.
(date-
Возвращается в формате yyyy-MM-
time)
ddTHH:mm:ss.SSS’Z
*exporterName
string
-
Наименование экспортера
*exporterTaxpayerId
string
-
уникальный идентификатор экспортера в
национальной системе учета
налогоплательщиков
*agentInn
string
-
ИНН текущего владельца товара
*agentName
string
-
Наименование текущего владельца товара
*lastStatusChangeDate
string
+
Дата последнего изменения статуса.
(date-
Возвращается в формате yyyy-MM-
time)
ddTHH:mm:ss.SSS’Z
97
Параметр
Тип
Обяз.
Описание
*turnoverType
enum
-
Вид товарооборота: SELLING - продажа;
COMMISSION (COMMISSIONAIRE_SALE -
устар.) - комиссия; AGENT - агент
*productGroup
string
+
Товарная группа (см. Справочник "Список
поддерживаемых товарных групп")
*markWithdraw
boolean
-
Зафиксирована розничная продажа по чеку от
невладельца КИ
*certDoc
string
-
Документ обязательной сертификации
**type
string
-
Вид документа обязательной сертификации.
Возможные значения:
CONFORMITY_CERTIFICATE - сертификат
соответствия;
CONFORMITY_DECLARATION - декларация
о соответствии;
STATE_REGISTRATION_CERTIFICATE -
свидетельство государственной регистрации
**number
string
-
Номер документа обязательной сертификации
**date
string(da
-
Дата выдачи документа обязательной
te)
сертификации. Формат: yyyy.MM.dd
**wellNumber
string
-
Номер скважины
Примечание: Для невладельца ответ зависит от статуса КИ:
• Если КИ "Эмитирован. Получен" или "В обороте", возвращаются все сведения;
• Если КИ "Выбыл", возвращаются сведения по КИ, без информации об участнику оборота
товаров, от которого КИ выбыл;
• Если сформированный агрегат, возвращаются все сведения и список КИ в агрегате первого
уровня;
• Если расформированный агрегат, возвращается статус агрегата и список КИ в агрегате
первого уровня.
2.5. Метод получения списка КИ по идентификатору
Версия 3 является устаревшей, рекомендуется использовать версию 4.
Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в
разделе "Указание параметров в строке запроса при работе с большими агрегатами".
Метод: POST
Пример строки запроса:
98
curl -X POST "<url стенда
v4>/facade/cis/cis_list?childrenPaging=true&childrenPage=1&childrenLimit=50"
-H 'Authorization: Bearer <ТОКЕН>' -H 'content-type: application/json'
-d "{"cises":["0000000000000000000000000000000"]}"
Параметры строки запроса:
Параметр
Тип
Обяз.
Описание
Комментарий
childrenPagin
boolean
+
Флаг,
При включённом значении возвращает
g
включающий
постранично агрегаты только первого слоя
пагинацию
через указанные ниже параметры.
агрегатов
Значение по умолчанию: false
childrenPage
number
-
Число страниц
Значение по умолчанию: 1
вложений
агрегата первого
слоя
childrenLimit
number
-
Количество
Значение по умолчанию: 50
вложений на
странице агрегата
первого слоя
pg
string
-
Товарная группа
Параметр обязателен для товарных групп:
milk - Молочная продукция;
water - Упакованная вода
Пример тела запроса
{
"cises": [
"0000000000000000000000000000000"
]
}
Параметры тела запроса:
Параметр
Тип
Обяз.
Описание
Комментарий
cises
string
-
Список
уникальных
идентификаторов
товара (КИ)
Для невладельца ответ зависит от статуса КИ:
• если КИ в статусе "Эмитирован. Получен" или "В обороте", то возвращаются все сведения;
• если КИ выбыл, то возвращаются сведения по КИ без информации об участнике оборота
товаров, от которого КИ выбыл;
99
• если агрегат сформирован, то возвращаются все сведения и список КИ в агрегате первого
уровня;
• если агрегат расформирован, то возвращается статус агрегата и список КИ в агрегате первого
уровня.
Пример ответа:
100
содержание .. 1 2 ..
////////////////////////////////////////// |
||
|
|
|