Описание True API (Версия 72.0)

Содержание

История изменений

1. Назначение и условия применения True API

1.1. Электронное взаимодействие УОТ и Оператора ГИС МТ

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

1.3. Экранирование

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

1.5. Единая аутентификация

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

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

1.6. Типы приватности методов True API в зависимости от аутентификационного токена . . . 59

2. Рекомендации по работе с методами True API

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

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

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

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

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

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

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

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

2.2.1. Шаг 1: получение информации о статусе КИ

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

документов"

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

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

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

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

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

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

2.3.2.1. Шаг 1: получение сведений о новых документах, загруженных в ГИС МТ

2.3.2.2. Шаг 2: получение сведений о содержимом документа по идентификатору

2.3.2.3. Шаг 3: подача сведений о приёмке

2.3.2.4. Шаг 4: просмотр статуса отправленного документа "Приёмка"

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

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

3. Обращение к True API

3.1. Регистрация участника оборота товаров

3.1.1. Метод создания заявки на регистрацию участника оборота товаров

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

3.2. Метод проверки регистрации участников оборота товаров по ИНН в ГИС МТ

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

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

Оператором ГИС МТ

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

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

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

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

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

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

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

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

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

табачная продукция")

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

100

4. Подача сведений в систему ГИС МТ через "Единый метод создания документов"

101

4.1. Единый метод создания документов

101

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

104

4.2.1. Агрегирование

104

4.2.1.1. Агрегация

104

4.2.1.2. Трансформация

106

4.2.1.3. Расформирование

109

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

110

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

114

4.2.3.1. Формирование АТК

114

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

116

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

119

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

120

4.2.4.1. Ввод в оборот. Производство РФ

120

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

131

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

133

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

145

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

152

4.2.4.6. Ввод в оборот. Маркировка остатков

158

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

162

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

168

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

179

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

188

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

191

4.2.7. Отгрузка

195

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

199

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

203

4.2.7.3. Отгрузка в государствах-членах ЕАЭС с признанием КИ при объёмно-

сортовом учёте (экспорт)

207

4.2.7.4. Отгрузка из государств-членов ЕАЭС с признанием КИ при объёмно-сортовом

учёте (импорт)

213

4.2.7.5. Отгрузка из ЕАЭС с признанием КИ

218

4.2.7.6. Отгрузка в ЕАЭС с признанием КИ (экспорт)

225

4.2.7.7. Отмена отгрузки

230

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

230

4.2.8. Приёмка

231

4.2.8.1. Приёмка отгрузки из РФ

231

4.2.8.2. Приёмка отгрузки из государств-членов ЕАЭС на документ "Отгрузка при

трансграничной торговле"

236

4.2.8.3. Приёмка отгрузки из государств-членов ЕАЭС на документ "Отгрузка из

ЕАЭС с признанием КИ"

249

4.2.8.4. Приёмка отгрузки из государств-членов ЕАЭС с признанием КИ при объёмно-

сортовом учёте

257

4.2.8.5. Приёмка отгрузки в ЕАЭС с признанием КИ (экспорт)

265

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

269

4.2.10. Списание КИ

280

4.2.10.1. Списание не нанесённых КИ с/без СИ

280

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

282

4.2.11. Предоставление дополнительных сведений об РД для ввода товара в оборот

285

4.2.12. Перемаркировка

287

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

и "Никотиносодержащая продукция")

298

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

"Никотиносодержащая продукция")

304

5. Методы получения сведений о КИ и маркированных товарах

311

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

311

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

311

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

фильтру

317

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

326

5.1.4. Метод получения общедоступной информации о КИ по списку (упрощённый

атрибутивный состав)

338

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

345

5.1.6. Метод запроса подлинности КМ

352

5.2. Метод получения истории движения КИ

358

5.2.1. Метод получения карточки товара по КИ

362

5.2.2. Получение вложенной структуры агрегированных КИ

372

5.2.2.1. Запрос списка агрегированных КИ (GET)

372

5.2.2.2. Запрос списка агрегированных КИ (POST)

375

5.3. Метод истории агрегирования кода идентификации

378

5.4. Метод получения списка десятизначных кодов ТН ВЭД

380

5.5. Получение информации о карточках товара УОТ

381

5.5.1. Метод получения информации о товаре по GTIN товара

381

5.5.2. Метод получения списка кодов товаров (GTIN) УОТ по ИНН

389

5.6. Метод получения кода товарной группы по КИ товара (GTIN)

392

5.7. Работа с согласием о предоставлении информации участникам оборота товаров ГИС

МТ

395

5.7.1. Метод создания документа согласия о предоставлении сведений о КИ

395

5.7.2. Метод получения информации о КИ по списку КИ при наличии согласия о

предоставлении информации

398

5.7.3. Метод аннулирования подписанного согласия о предоставлении информации

401

5.7.4. Метод отображения списка документов согласия о предоставлении информации . . 404

5.7.5. Метод получения тела документа согласия или документа аннулирования согласия 410

5.7.6. Метод подписания документа согласия или документа аннулирования согласия о

предоставлении информации

411

5.7.7. Метод получения списка ИНН доверенных участников оборота товаров

413

5.7.8. Метод проверки ИНН доверенного участника оборота товаров

415

5.7.9. Метод получения списка ИНН по идентификатору документа согласия о

предоставлении информации

417

5.8. Метод получения истории движения КИ ТГ "Табачная продукция"

418

5.9. Метод проверки КИ ТГ "Табачная продукция" на вхождение в "серую зону"

421

6. Работа с документами и чеками в ГИС МТ

423

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

423

6.1.1. Версия v4

423

6.1.2. Версия v3

429

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

435

6.2.1. Версия v4

435

6.2.2. Версия v3

439

6.3. Метод получения содержимого документа по идентификатору

441

6.3.1. Версия v4

441

6.3.2. Версия v3

446

6.4. Метод получения содержимого чека ККТ по идентификатору

451

6.4.1. Версия v4

451

6.4.2. Версия v3

458

6.5. Метод отправки документа ЭДО на повторную обработку

462

6.6. Метод подачи УПД на предварительную проверку

465

6.7. Метод получения статуса обработки документа

467

6.8. Метод получения списка КИ по номеру документа

469

6.9. Метод получения списка кодов идентификации и кодов товара по идентификатору

документа

470

7. Методы получения квитанций результата обработки документов

473

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

идентификатору документа

473

7.2. Метод получения квитанции результата обработки чека по идентификатору чека

480

7.3. Описание кодов возвращаемых ошибок при обработке документов

485

8. Методы формирования выгрузок данных из ГИС МТ

493

8.1. Метод создания нового задания на выгрузку

494

8.1.1. Получение сведений по КИ и агрегатам

494

8.1.2. Получение ошибок по результатам обработки документов

495

8.1.3. Получение списка КИ участника оборота товаров по заданному фильтру

496

8.1.4. Пример ответа для всех формируемых запросов на выгрузку

498

8.2. Метод получения статуса задания на выгрузку по ID выгрузки

499

8.3. Метод получения статусов заданий на выгрузку

502

8.4. Метод получения результирующих ID выгрузок данных

504

8.5. Метод получения ZIP файла выгрузки

506

8.5.1. Метод получения CSV ошибок по результатам обработки документов

507

8.5.2. Метод получения CSV по КИ и агрегатам

513

8.5.3. Метод получения CSV по списку КИ участника оборота товаров по заданному

фильтру

515

9. Взаимодействие с провайдером ЭДО Lite

518

9.1. Публичный метод получения идентификатора абонента в ЭДО Lite

518

9.1.1. Версия v4

519

9.1.2. Версия v3

521

9.2. Метод получения ZIP-архива документа ЭДО с подписями и квитанциями из ЭДО Lite 522

10. Методы Национального каталога

524

10.1. Универсальные параметры запроса

524

10.2. Метод получения списка атрибутов как публичных, так и приватных для

запрашивающего аккаунта

524

10.3. Метод получения списка торговых марок

531

10.4. Метод получения списка субаккаунтов компании

535

10.5. Метод подписи предоставления или отзыва разрешения на использование КИ

538

10.6. Метод получения файла в формате XML для управления доступами субаккаунтов . . . 542

10.7. Метод получения дерева категорий (корень дерева не возвращается)

546

10.8. Метод получения полной информации о товаре

550

10.9. Метод получения краткой информации о товаре

565

10.10. Метод получения карточки товара, в том числе неопубликованной карточки

576

10.11. Метод подписи карточки товара

593

10.12. Метод получения XML товаров по массиву ID товаров или коду товара

597

10.13. Метод получения массива ID прошедших валидацию товаров

599

10.14. Метод получения списка всех принадлежащих одному владельцу товаров

603

10.15. Метод изменения размера изображения с заполнением недостающих полей белым

цветом

607

10.16. Метод генерации черновиков кодов товаров

609

10.17. Метод создания и обновления товаров

613

10.18. Метод получения статуса фида по ID фида от его заказчика

626

10.19. Метод отправки на модерацию карточки товаров в статусе "Черновик"

638

10.20. Метод определения кода принадлежности товара к маркируемым товарным группам 640

11. Методы "Станции управления заказами"

646

11.1. Метод получения токена аутентификации в СУЗ

647

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

648

Приложение 1. Справочники

652

Справочник "Список поддерживаемых товарных групп"

652

Справочник "Типы документов"

652

Справочник "Статусы проверок УПД"

656

Справочник "Типы договоров"

657

Справочник "Типы эмиссии КИ"

658

Справочник "Статусы КИ"

658

Актуальные статусы

658

Актуальные особые состояния

659

Справочник "Типы производства"

660

Справочник "Типы упаковки"

660

Справочник "Статусы заказов"

661

Справочник "Статусы документов"

662

Справочник "Причины вывода из оборота"

662

Справочник "Статусы ответов"

663

Справочник "Типы организаций"

666

Справочник "Статусы УОТ"

666

Справочник "Статусы заявки на регистрацию УОТ"

666

Справочник "Статусы документа в жизненном цикле SD"

667

Справочник "Статусная модель"

667

Справочник "Дополнительные параметры в ответе в зависимости от товарных групп"

668

Дополнительные параметры для ТГ "Альтернативная табачная продукция" и "Табачная

продукция"

668

Дополнительные параметры для ТГ "Обувные товары"

669

Дополнительные параметры для ТГ "Предметы одежды, бельё постельное, столовое,

туалетное и кухонное"

670

Дополнительные параметры для ТГ "Фотокамеры (кроме кинокамер), фотовспышки и

лампы-вспышки"

670

Дополнительные параметры для ТГ "Велосипеды и велосипедные рамы"

671

Дополнительные параметры для ТГ "Кресла-коляски"

671

Дополнительные параметры для ТГ "Духи и туалетная вода"

672

Дополнительные параметры для ТГ "Шины и покрышки пневматические резиновые

новые"

673

Дополнительные параметры для ТГ "Молочная продукция"

673

Дополнительные параметры для ТГ "Упакованная вода"

674

Дополнительные параметры для ТГ "Товары из натурального меха"

675

Дополнительные параметры для ТГ "Пиво, напитки, изготавливаемые на основе пива,

слабоалкогольные напитки"

675

Дополнительные параметры для ТГ "Антисептики и дезинфицирующие средства"

676

Приложение 2. Примеры аутентификации по УКЭП / Подписание документов

677

Пример получения токена при авторизации с прикрепленной подписью / подписание

документов с открепленной подписью на 1С

677

Пример получения токена при авторизации REACT JS

678

История изменений

Дата

Версия

Изменения

докуме

нта

30.12.2021

72.0

В типах документов "Приёмка отгрузки из государств-членов ЕАЭС с

признанием КИ при объёмно-сортовом учёте", "Ввод в оборот.

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

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

Трансграничная торговля", "Ввод в оборот. На территории стран ЕАЭС

(контрактное производство)", "Перемаркировка" в комментарий

параметра "tnved_code" ("Код ТН ВЭД ЕАЭС (10 знаков)") добавлена

информация о возможности указания устаревших и новых кодов ТН

ВЭД

29.12.2021

71.0

В "Метод запроса подлинности КМ" (/cises/eaes/info) указана

возможность проверки подлинности КМ, эмитированных в Республике

Казахстан для товарной группы "Обувные товары"

Дата

Версия

Изменения

докуме

нта

28.12.2021

70.0

В разделе "Метод проверки регистрации участников оборота товаров

по ИНН в ГИС МТ" скорректировано название параметра

расширенного ответа "productGroups";

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

МТ" для версии v4 скорректированы URL метода, запрос, комментарий

параметра запроса "limit", описание параметра запроса "number",

обязательность параметра запроса "pg", удалены параметры запроса

"participantInn" и "page";

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

МТ" для версии v3 скорректированы запрос и удалён параметр запроса

"participantInn";

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

МТ" для версии v4 скорректированы URL метода и описание параметра

запроса "did";

Актуализировано описание типа документа "Списание не нанесённых

КИ с/без СИ" для товарных групп "Молочная продукция",

"Упакованная вода";

В разделе "Методы формирования выгрузок данных из ГИС МТ"

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

данных в ГИС МТ на демо стенде;

В разделе "Требования к файлам обмена" добавлена рекомендация по

количеству КИ в одном загружаемом документе;

В разделах "Метод получения содержимого документа по

идентификатору", "Метод получения содержимого чека ККТ по

идентификатору" добавлены необязательные параметры запроса "body"

("Признак необходимости в теле ответа содержимого чека") и "content"

("Признак необходимости контента чека в теле ответа");

В разделе "Метод получения содержимого чека ККТ по

идентификатору" добавлены параметры ответа "body" ("Содержимое

отправленного чека"), "content" ("Контент чека");

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

МТ" изменена обязательность параметра ответа "did" ("Значение

номера документа, по которому сортируются записи ("точки отсчёта" -

запись, с которой начнётся выборка)");

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

списку (упрощённый атрибутивный состав)" актуализирован пример

ответа в случае ошибки с кодом "404" при запросе не найденных кодов

в подписанной товарной группе;

В разделе "Метод получения содержимого документа по

идентификатору" в описании версий v3 и v4 актуализированы

комментарии для параметра запроса "pg" ("Товарная группа");

В разделе "Ввод в оборот. Импорт с ФТС" (LP_FTS_INTRODUCE)

добавлено примечание по возможным принятым решениям о выпуске

товара, полученным от ФТС: FTS_RESPONSE_OK - положительное

решение, товар введен в оборот, FTS_RESPONSE_NOT_OK -

отрицательное решение, товар не введен в оборот

Дата

Версия

Изменения

докуме

нта

21.12.2021

69.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)

Дата

Версия

Изменения

докуме

нта

15.12.2021

68.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_ACCEPTANCE)",

"Вывод из оборота" (LK_RECEIPT);

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

МТ", "Метод получения содержимого документа по идентификатору" и

"Метод получения содержимого чека ККТ по идентификатору"

добавлены версии v4 методов;

Подача сведений в типах документов "Формирование АТК",

"Трансформация АТК", "Расформирование АТК" доступна для

товарных групп "Антисептики и дезинфицирующие средства",

"Биологически активные добавки к пище" и "Кресла-коляски"

08.12.2021

67.0

В разделе "Метод создания заявки на регистрацию участника оборота

товаров" в структуре данных "product_document" актуализированы

комментарии, описание и обязательность параметров;

В "Список сокращений, условных обозначений и терминов" добавлены

аббревиатуры ЕГРИП, ЕГРЮЛ, ИП, МОД, РАФП, ЮЛ;

В разделе "Метод получения списка кодов товаров (GTIN) УОТ по

ИНН" удалена версия v3 в связи со снятием с поддержки;

В типе документа "Ввод в оборот. Производство РФ" скорректирована

вложенность и комментарий параметра "well_number" ("Номер

скважины")

Дата

Версия

Изменения

докуме

нта

06.12.2021

66.0

Подача сведений в типах документов "Формирование АТК",

"Трансформация АТК", "Расформирование АТК" доступна для

товарной группы "Упакованная вода";

Для типов документов "Формирование АТК" и "Трансформация АТК"

актуализировано примечание о вложенности типов КИ для параметра

"ki" ("КИ");

В типе документа "Расформирование АТК" изменена обязательность

параметра "atk" ("АТК");

В "Справочник "Типы упаковки"" внесено уточнение о вложенности

типов КИ для кода "АТК" ("Агрегированный таможенный код");

Типы документов "Отгрузка при трансграничной торговле", "Отмена

отгрузки при трансграничной торговле", "Приёмка отгрузки из

государств-членов ЕАЭС" на документ "Отгрузка при трансграничной

торговле" открыты для товарной группы "Упакованная вода" для

осуществления взаимодействия с Республикой Беларусь

02.12.2021

65.0

В запросы методов раздела "Единая аутентификация" добавлено

указание на версию v3;

Актуализировано описание параметров запроса в методах "Метод

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

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

МТ"(receipt/listV2);

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

МТ" добавлены ограничения на возвращение параметров ответа

"productGroup" ("Наименование товарной группы") и "productGroupId"

("Идентификатор товарной группы участника оборота товаров");

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

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

списку (упрощённый атрибутивный состав)" актуализировано

описание параметра "pg";

Для типа документа "Вывод из оборота" добавлено указание на

доступность подачи сведений для товарной группы "Биологически

активные добавки к пище", дополнено описание параметра

"state_contract_id" ("Идентификатор государственного контракта") В

тип документа "Вывод из оборота" в формате * .json добавлен

необязательный параметр "importer_id" ("ИНН (или аналог)

импортёра"), применимый, если значение параметра "action" ("Причина

вывода из оборота") = "EEC_EXPORT" ("Экспорт в страны ЕАЭС"),

актуализирован пример документа в формате * .json;

Скорректировано описание параметров документа "Перемаркировка"

01.12.2021

64.0

Добавлено описание типа документа "Описание остатков" для

товарной группы "Фотокамеры (кроме кинокамер), фотовспышки и

лампы-вспышки";

В документе "Ввод в оборот. Маркировка остатков" для товарной

группы "Фотокамеры (кроме кинокамер), фотовспышки и лампы-

вспышки" добавлено уточнение о доступности документа только для

комплектов, в пример тела документа в формате * .json добавлен

параметр "ki" ("КИ")

Дата

Версия

Изменения

докуме

нта

30.11.2021

63.0

В разделе "Электронное взаимодействие УОТ и Оператора ГИС МТ"

добавлено рекомендованное ограничение по количеству запросов в

секунду;

В описании типа документа "Ввод в оборот. Производство РФ"

параметр "production_order" ("Тип производственного заказа") изменён

на "production_type" ("Тип производственного заказа"),

актуализированы пример документа в формате * .json;

В разделе "Метод подписания документа согласия или документа

аннулирования согласия о предоставлении информации" добавлено

уточнение об удалении пробелов и переносов строк перед подписанием

документа согласия;

В описании документа "Формирование наборов" актуализированы

комментарии параметров "unitSerialNumber" ("Код идентификации

набора"), "sntins" ("Список КИ и/или КИК, входящих в набор")

29.11.2021

62.0

Подача сведений в типе документа "Ввод в оборот. Импорт с ФТС"

доступна для товарной группы "Упакованная вода";

Указано ограничения на подачу сведений в типе документа "Ввод в

оборот. Производство вне ЕАЭС", если дата ДТ ≥ 30.11.2021

26.11.2021

61.0

Для товарной группы "Шины и покрышки пневматические резиновые

новые" доступна подача сведений в типе документа "Отгрузка из ЕАЭС

с признанием КИ";

Актуализировано описание параметра "uitu" ("Код

расформировываемого агрегата") для типа документа

"Расформирование";

Добавлена дата доступности версии v3 в раздел "Метод получения

списка кодов товаров (GTIN) УОТ по ИНН";

Удалена версия v4, добавлена версия v3 в раздел "Метод получения

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

Добавлена версия v3 в раздел "Метод получения списка загруженных

чеков ККТ в ГИС МТ";

Удалена версия v4, добавлена версия v3 в раздел "Метод получения

содержимого документа по идентификатору";

Удалена версия v4, добавлена версия v3 в раздел "Метод получения

содержимого чека ККТ по идентификатору";

Добавлена версия v3 в раздел "Публичный метод получения

идентификатора абонента в ЭДО Lite"

Дата

Версия

Изменения

докуме

нта

22.11.2021

60.0

Актуализировано описание типа документа "Отгрузка из ЕАЭС с

признанием КИ";

Актуализирован "Список сокращений, условных обозначений и

терминов";

Расширено количество параметров в разделе "Справочник

"Дополнительные параметры в ответе в зависимости от товарных

групп"";

В описании документов "Отгрузка в государствах-членах ЕАЭС с

признанием КИ при объёмно-сортовом учёте (экспорт)" и "Отгрузка из

государств-членов ЕАЭС с признанием КИ при объёмно-сортовом

учёте (импорт)" скорректировано описание параметра "gtin" ("Код

товара потребительской упаковки товара")

16.11.2021

59.0

В разделе "Универсальные параметры запроса" изменена

обязательность параметра "apikey" для авторизации в системе;

Актуализированы методы: "Метод получения списка атрибутов как

публичных, так и приватных для запрашивающего аккаунта"

(/nk/attributes), Метод получения списка торговых марок" (/nk/brands),

"Метод получения дерева категорий (корень дерева не возвращается)"

(/nk/categories), "Метод получения полной информации о товаре"

(/nk/product), "Метод получения краткой информации о товаре"

(/nk/short-product), "Метод получения карточки товара, в том числе

неопубликованной карточки" (/nk/feed-product), "Метод получения

XML товаров по массиву ID товаров или коду товара" (/nk/feed-product-

document), "Метод получения массива ID прошедших валидацию

товаров" (/nk/feed-product-sign), "Метод получения списка всех

принадлежащих одному владельцу товаров" (/nk/etagslist), "Метод

изменения размера изображения с заполнением недостающих полей

белым цветом" (/nk/image), "Метод генерации черновиков кодов

товаров" (/nk/generate-gtins), "Метод создания и обновления товаров"

(/nk/feed), "Метод получения статуса фида по ID фида от его заказчика"

(/nk/feed-status), "Метод отправки на модерацию карточки товаров в

статусе "Черновик"" (/nk/feed-moderation), "Метод определения кода

принадлежности товара к маркируемым товарным группам" (/nk/mark-

check), "Метод получения списка субаккаунтов компании" (/nk/linked-

accounts), "Метод подписи предоставления или отзыва разрешения на

использование КИ" (/nk/linked-accounts-sign), "Метод получения файла

в формате XML для управления доступами субаккаунтов" (/nk/linked-

accounts-documents), "Метод подписи карточки товара" (/nk/feed-

product-sign-pkcs);

Актуализирован пример типа документа "Ввод в оборот. Маркировка

остатков" в формате * .json;

Скорректирована таблица типа документа "Приёмка отгрузки из

государств-членов ЕАЭС с признанием КИ при объёмно-сортовом

учёте";

Актуализировано описание параметра "well_number" для типов

документов "Ввод в оборот. Производство РФ" и "Ввод в оборот.

Контрактное производство РФ"

Дата

Версия

Изменения

докуме

нта

12.11.2021

58.0

Типы документов "Агрегация", "Трансформация", "Расформирование",

"Формирование наборов", "Формирование АТК", "Ввод в оборот.

Производство РФ", "Ввод в оборот. Производство вне ЕАЭС", "Ввод в

оборот. Трансграничная торговля", "Ввод в оборот. На территории

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

производство РФ", "Ввод в оборот. Импорт с ФТС", "Ввод в оборот.

Маркировка остатков" "Возврат в оборот", "Отгрузка", "Отгрузка с

выводом из оборота", "Отмена отгрузки", "Приёмка отгрузки из РФ",

"Вывод из оборота", "Списание не нанесённых КИ с/без СИ",

"Списание нанесённых КИ с СИ", "Перемаркировка" доступны для

товарной группы "Антисептики и дезинфицирующие средства";

В "Справочник "Список поддерживаемых товарных групп"" добавлен

код товарной группы "Антисептики";

В разделы "Метод подачи УПД на предварительную проверку" и

"Метод получения статуса обработки документа" добавлено уточнение

о типах поддерживаемых токенов, примеры ответов в случае ошибки с

кодом 401: "Невалидный токен"

03.11.2021

57.0

В тип документа "Вывод из оборота" в формате * .json добавлен

необязательный параметр "destination_country_code" ("Код страны

назначения"), применимый, если значение параметра "action"

("Причина вывода из оборота") = "EEC_EXPORT" ("Экспорт в страны

ЕАЭС"), актуализирован пример тела документа в формате * .json

01.11.2021

56.0

В документе "Ввод в оборот. Маркировка остатков" для товарной

группы "Духи и туалетная вода" актуализирован комментарий

параметра "ki" ("КИ");

В документе "Описание остатков" для товарной группы "Духи и

туалетная вода" добавлено уточнение о доступности документа только

для комплектов

Дата

Версия

Изменения

докуме

нта

26.10.2021

55.0

Добавлено описание типов документов "Отгрузка из государств-членов

ЕАЭС с признанием КИ при объёмно-сортовом учёте (импорт)"

(плановая дата доступности создания документа на промышленном

стенде - 1 ноября 2021 года) и "Приёмка отгрузки из государств-

членов ЕАЭС с признанием КИ при объёмно-сортовом учёте"

(плановая дата доступности создания документа на демонстрационном

и промышленном стендах - 10 ноября 2021 года) для товарной группы

"Молочная продукция";

В "Справочник "Типы документов"" добавлены идентификаторы типов

документов "Отгрузка из государств-членов ЕАЭС с признанием КИ

при объёмно-сортовом учёте (импорт)" и "Приёмка отгрузки из

государств-членов ЕАЭС с признанием КИ при объёмно-сортовом

учёте";

Актуализирован "Метод запроса подлинности КМ" в связи с

реализацией проверки подлинности КМ для товарных групп "Обувные

товары", "Предметы одежды, бельё постельное, столовое, туалетное и

кухонное", "Шины и покрышки пневматические резиновые новые":

добавлены параметры ответа "registered" ("Признак наличия КМ в ГИС

МТ"), "cisStatus" ("Статус КМ в ГИС МТ"), "emissionType" ("Тип

эмиссии КМ в ГИС МТ"), "statusEx" ("Дополнительный статус товара в

ГИС МТ")

22.10.2021

54.0

В типы документов "Ввод в оборот. Производство РФ", "Ввод в оборот.

Производство вне ЕАЭС", "Ввод в оборот. Контрактное производство

РФ", "Ввод в оборот. Маркировка остатков", "Ввод в оборот.

Трансграничная торговля", "Ввод в оборот. На территории стран ЕАЭС

(контрактное производство)", "Перемаркировка", "Приёмка отгрузки из

государств-членов ЕАЭС", Приёмка отгрузки из государств-членов

ЕАЭС с признанием КИ при объёмно-сортовом учёте" добавлен массив

"certificate_document_data" ("Массив, содержащий данные документов,

подтверждающих соответствие") с параметрами "certificate_number"

("Номер документа разрешительной документации"), "certificate_date"

("Дата документа разрешительной документации") и "certificate_type"

("Вид документа разрешительной документации");

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

списку", "Метод получения общедоступной информации о КИ по

списку (упрощённый атрибутивный состав)" актуализированы

примеры ответов;

В описание типов документов "Ввод в оборот. Производство РФ" и

"Ввод в оборот. Контрактное производство РФ" для товарной группы

"Упакованная вода" добавлен параметр "well_number" ("Номер

скважины"), актуализированы примеры тела документов в форматах *

.json, * .xml, * .csv;

В разделы "Метод получения карточки товара по КИ", "Метод

получения общедоступной информации о КИ по списку", "Метод

получения общедоступной информации о КИ по списку (упрощённый

атрибутивный состав)" добавлен необязательный параметр ответа

"wellNumber" ("Номер скважины") для товарной группы "Упакованная

вода"

Дата

Версия

Изменения

докуме

нта

20.10.2021

53.0

Расширен список доступных документов в разделе "Метод получения

списка кодов идентификации и кодов товара по идентификатору

документа";

В документе "Вывод из оборота" для параметра "state_contract_id"

("Идентификатор государственного контракта") изменено описание;

В разделах "Получение списка КИ участника оборота товаров по

заданному фильтру", "Метод получения статуса задания на выгрузку по

ID выгрузки" актуализирован пример запроса

13.10.2021

52.0

Актуализирован адрес стенда для демонстрационного контура ГИС МТ

в разделе "Электронное взаимодействие УОТ и Оператора ГИС МТ";

Скорректировано описание в типе документа "Отгрузка из ЕАЭС с

признанием КИ"

08.10.2021

51.0

Актуализированы адреса стендов для демонстрационного и

промышленного контуров ГИС МТ в разделе "Электронное

взаимодействие УОТ и Оператора ГИС МТ";

Актуализировано описание типов документов в разделе "Приёмка";

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

по заданному фильтру название параметра "tnVedEaes" ("Код товарной

номенклатуры") изменено на "tnVedEaesCode" ("Код товарной

номенклатуры")

Дата

Версия

Изменения

докуме

нта

01.10.2021

50.0

В описании типа документов "Приёмка отгрузки из государств-членов

ЕАЭС" актуализированы описания параметров;

В описании типа документов "Отгрузка при трансграничной торговле"

добавлены параметры "product_cost" (Цена за единицу), "product_tax"

("Сумма НДС"), certificate_document_data" ("Массив, содержащий

данные документов, подтверждающих соответствие"), "certificate_type"

("Вид документа, подтверждающего соответствие"),

"certificate_number" ("Номер документа, подтверждающего

соответствие"), "certificate_date" ("Дата документа, подтверждающего

соответствие"), актуализирован пример тела документа в формате *

.json;

В разделе "Метод отображения списка документов согласия о

предоставлении информации" актуализирован пример запроса;

Добавлено описание типа документа "Отгрузка из ЕАЭС с признанием

КИ";

В раздел "Метод запроса подлинности КМ" добавлен параметр строки

запроса "pg" ("Товарная группа");

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

МТ" добавлены параметры запроса "senderInn" ("ИНН отправителя

документа"), "receiverInn" ("ИНН получателя документа"), примеры

ответов и таблица с параметрами ответа;

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

по списку" добавлены параметры ответа "tnVedEaesGroup" ("Код

товарной позиции ТН ВЭД ЕАЭС товара"), "emissionDate" ("Дата

эмиссии"), "emissionType" ("Тип эмиссии"), "statusEx" ("Расширенный

статус КИ");

В раздел "Метод получения списка атрибутов как публичных, так и

приватных для запрашивающего аккаунта" добавлен параметр запроса

"is_set" ("Признак карточки товара типа "Набор"");

"Метод получения квитанции результата обработки документа по

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

результата обработки чека по идентификатору чека";

В разделе "Метод получения квитанции результата обработки чека по

идентификатору чека" дополнено описание функции метода;

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

МТ" скорректирован комментарий параметра "pg" ("Товарная группа");

В разделе "Ввод в оборот. Импорт с ФТС" актуализирован комментарий

параметра "cis" ("ki" ("КИ"), "kigu" ("КИГУ"), "kik" ("КИК"), "kitu"

("КИТУ") или "atk" ("АТК")");

В раздел "Метод создания заявки на регистрацию участника оборота

товаров" добавлены параметры структуры данных "product_document"

("Закодированная в base64 заявка на добавление организации")

28.09.2021

49.0

Добавлено описание типа документа "Описание остатков" для

товарной группы "Духи и туалетная вода"

Дата

Версия

Изменения

докуме

нта

23.09.2021

48.0

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

табачная продукция" и "Никотиносодержащая продукция")" расширено

описание параметров документа в формате * .xml

"ИнформацияОбАгрегировании", "ТипУпаковки";

В "Справочник "Типы упаковки"" для кода "АТК" ("Агрегированный

таможенный код") добавлено ограничение использования для товарной

группы "Никотиносодержащая продукция";

В раздел "Методы формирования выгрузок данных из ГИС МТ"

добавлено уточнение о времени выполнения задания на выгрузку;

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

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

"packs" ("Фильтрация по единичным товарным упаковкам");

В разделе "Метод получения содержимого чека ККТ по

идентификатору" удалён параметр ответа "docErrors" ("Список ошибок

обработки документа"), добавлено уточнение по получению ошибок по

чекам;

В разделах "Метод получения карточки товара по КИ" и "Метод

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

фильтру" актуализировано описание параметра ответа "status" ("Статус

КИ");

Актуализированы типы документов "Приёмка", "Отгрузка при

трансграничной торговле (объёмно-сортовой учёт)", "Отгрузка при

трансграничной торговле"

Дата

Версия

Изменения

докуме

нта

15.09.2021

47.0

В описании типа документов "Вывод из оборота" актуализированы

значения параметров "action" ("Причина вывода из оборота"),

"document_type" ("Тип первичного документа"), актуализирован

комментарий параметра "cis" ("КИ"), добавлен параметр

"state_contract_id" ("Идентификатор государственного контракта");

В описании типов документов "Формирование АТК", "Трансформация

АТК" актуализированы описания параметров "products_list" ("Массив,

содержащий список агрегируемых в АТК КИ, КИГУ, КИК"),

"products_list" ("Массив, содержащий список перемещаемых КИ,

КИГУ, КИК") и комментарии параметров "ki" ("КИ");

В описании типов документов "Трансформация АТК",

"Расформирование АТК" актуализированы комментарии параметров

"atk" ("Трансформируемый АТК") и "atk" ("АТК");

Актуализирован "Справочник "Причины вывода из оборота"";

Удалён раздел "Запрос списка контрагентов";

В раздел "Метод получения дерева категорий (корень дерева не

возвращается)" добавлены параметры ответа "cateegory_active"

("Признак активности категории"), "gismt_codes" ("Код маркируемой

товарной группы");

Для метода "Метод получения списка атрибутов как публичных, так и

приватных для запрашивающего аккаунта" актуализирован

комментарий параметра "second_layer" ("Признак принадлежности

атрибута ко второму слою атрибутов (атрибуты, необходимые для ввода

товаров в оборот)");

В методе "Получение счёта на оплату" изменён пример строки запроса,

прмиер тела запроса, актуализировано описание параметров тела

запроса;

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

перемаркировки КИН: обязательно указание предыдущего КИН в поле

"last_uin" ("Предыдущий КИ/КИК/КИН") для всех причин

перемаркировки

Дата

Версия

Изменения

докуме

нта

10.09.2021

46.0

Для типа документа "Вывод из оборота" доступна причина вывода из

оборота STATE_SECRET ("Продажа по сделке, составляющей гос.

тайну") для товарных групп "Духи и туалетная вода", "Молочная

продукция", "Обувные товары", "Предметы одежды, бельё постельное,

столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры

(кроме кинокамер), фотовспышки и лампы-вспышки", "Шины и

покрышки пневматические резиновые новые";

Для параметра "action" ("Причина вывода из оборота") добавлено новое

значение STATE_SECRET ("Продажа по сделке, составляющей гос.

тайну"), добавлен новый параметр "state_contract_id" ("Идентификатор

государственного контракта"), обязательный при указании причины

списания STATE_SECRET ("Продажа по сделке, составляющей гос.

тайну");

В "Метод получения общедоступной информации о КИ по списку" и

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

списку" добавлены параметры ответа "withdrawReason" ("Причина

вывода из оборота") и "withdrawReasonOther" ("Введенная вручную

причина вывода из оборота");

В разделе "Метод получения списка кодов идентификации и кодов

товара по идентификатору документа" актуализированы тип метода и

пример запроса;

В разделах "Запрос списка агрегированных КИ (GET)", "Запрос списка

агрегированных КИ (POST)" удалены параметры запроса

"childrenPage" ("Номер страницы вложений в агрегат первого слоя"),

"childrenLimit" ("Размер страницы вложений в агрегат первого слоя");

В документе "Возврат в оборот" добавлено уточнение, что в качестве

значения параметра документа "ki" может быть указан

КИ/КИК/КИН/КИГУ

09.09.2021

45.0

В разделе "Метод получения информации о товаре по GTIN товара"

актуализирован комментарий параметра "packageType" ("Тип

упаковки");

В разделе "Метод запроса подлинности КМ" актуализированы пример

строки запроса и параметры запроса;

Тип документа "Ввод в оборот. Полученных от физических лиц"

недоступен для товарной группы "Упакованная вода"

Дата

Версия

Изменения

докуме

нта

03.09.2021

44.0

В разделе "Вывод из оборота" актуализирован пример тела документа в

формате * .xml;

В "Единый метод создания документов" добавлен параметр тела

запроса "signExt" ("Откреплённая УКЭП Оператора РБ, закодированная

в base64");

Добавлен тип документа "Отгрузка при трансграничной торговле

(объёмно-сортовой учёт)" для товарной группы "Молочная продукция";

В тип документа "Приёмка" (для приёмки отгрузки при

трансграничном перемещении для товарной группы "Молочная

продукция") добавлены параметры "gtin" ("Код товара передаваемых

КИ"), "cis_quantity" ("Количество передаваемых КИ по данному коду

товара"), "group_quantity" ("Количество передаваемых КИГУ по

данному коду товара") и пример тела документа в формате * .json для

приёмки отгрузки при трансграничной торговле (объёмно-сортовой

учёт) для товарной группы "Молочная продукция";

В "Справочник "Типы документов"" добавлен тип документа "Отгрузка

при трансграничной торговле (объёмно-сортовой учёт)";

Добавлен "Метод истории агрегирования кода идентификации"

30.08.2021

43.0

В документе "Приёмка" отгрузки при трансграничной торговле

добавлено значение для параметра "release_order_number"

25.08.2021

42.0

Из описания удалён "Метод регистрации табачной продукции от

производителя/импортёра" в связи прекращением использования и

дальнейшей регистрации табачных категорий товаров в НК;

В описание типа документа "Формирование наборов" добавлена

информация о доступности документа для товарной группы "Молочная

продукция", информация о создании и расформировании КИН,

списании КИН без вложений

Дата

Версия

Изменения

докуме

нта

18.08.2021

41.0

Для метода "Единый метод создания документов" актуализированы

ответ, перечень ошибок и примечание о применимости для товарных

групп "Альтернативная табачная продукция", "Никотиносодержащая

продукция", "Табачная продукция";

В описании типов документов "Формирование АТК", "Трансформация

АТК" актуализированы описания параметров "products_list" ("Массив,

содержащий список агрегируемых в АТК КИ, КИГУ, КИК),

"products_list" ("Массив, содержащий список перемещаемых КИ,

КИГУ, КИК") и комментарии параметров "ki" ("КИ");

В описании типов документов "Трансформация АТК",

"Расформирование АТК" актуализированы комментарии параметров

"atk" ("Трансформируемый АТК") и "atk" ("АТК");

Удалено ограничение о недоступности методов раздела "Методы

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

стенде;

Типы документов "Агрегация", "Ввод в оборот. Контрактное

производство РФ", "Ввод в оборот. Производство вне ЕАЭС", "Ввод в

оборот. Производство РФ", "Ввод в оборот. Трансграничная торговля",

"Вывод из оборота", "Отгрузка", "Отгрузка с выводом из оборота",

"Отмена отгрузки", "Перемаркировка", "Приёмка", "Расформирование",

"Списание нанесённых КИ с СИ", "Списание не нанесённых КИ с/без

СИ", "Трансформация" доступны для товарной группы "Биологически

активные добавки к пище"

05.08.2021

40.0

В разделе "Метод проверки регистрации участников оборота товаров

по ИНН в ГИС МТ" актуализированы примеры базового и

расширенного ответов, добавлен параметр базового ответа "is_kfh"

("Признак того, что участник оборота товаров является крестьянским

фермерским хозяйством"), параметры расширенного ответа "is_kfh"

("Признак того, что участник оборота товаров является крестьянским

фермерским хозяйством"), "okopf" ("ОКОПФ"), "productGroup"

("Список товарных групп, подключённых у ИНН");

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

по списку (упрощённый атрибутивный состав)"

29.07.2021

39.0

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

товаров по заданному фильтру" актуализирован комментарий

параметра запроса "cisMatchMode" ("Режим фильтрации по КИ");

Для типа документа "Трансформация" для параметра "uit_uitu"

("КИ/КИН для добавления/изъятия") добавлен комментарий;

В описании типа документа "Отгрузка при трансграничной торговле"

актуализированы пример тела документа в формате * .json и

комментарий параметра "document_date" ("Дата первичного

документа")

Дата

Версия

Изменения

докуме

нта

21.07.2021

38.0

Из описания удалены "Метод загрузки титулов", "Метод загрузки

квитанций с уведомлением об уточнении", "Метод загрузки квитанций

с предложением об аннулировании", "Метод аннулирования

документа", "Метод загрузки квитанций c предложением отклонения

аннулирования";

В разделах "Пример ответа для всех формируемых запросов на

выгрузку", "Метод получения статуса задания на выгрузку по ID

выгрузки", "Метод получения статусов заданий на выгрузку"

актуализировано описание параметра ответа "createDate" ("Дата

создания");

В описании типов документов "Ввод в оборот. Производство вне

ЕАЭС" и "Ввод в оборот. Импорт с ФТС" добавлены сведения о логике

обработки документов для товарной группы "Молочная продукция" в

зависимости от указанной даты ДТ;

В описание типа документа "Формирование наборов" добавлено

уточнение, что при вводе набора в оборот, набор не должен быть

пустым: в набор должны быть вложены КИ и/или КИК. При вводе в

оборот КИ и/или КИК, вложенных в набор со статусом "APPLIED"

("Эмитирован. Получен"), набор будет автоматически расформирован;

В описании типа документа "Предоставление дополнительных

сведений об РД для ввода товара в оборот" актуализирован

комментарий параметра "code" ("КИ или агрегат, к которым

осуществляется загрузка РД");

В разделе "Метод получения информации о товаре по GTIN товара" для

параметра запроса "gtins" ("Массив кодов товаров") и для параметра

ответа "gtin" ("Код товара, по которому выполняется запрос")

добавлены комментарии;

В разделе "Метод проверки КИ ТГ "Табачная продукция" на вхождение

в "серую зону"" актуализированы описания параметров ответа

"inGrayZone" ("Фактическая принадлежность кода к серой зоне") и

"applicationDate" ("Дата нанесения")

Дата

Версия

Изменения

докуме

нта

15.07.2021

37.0

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

списку" и "Метод получения краткой общедоступной информации о

КИ по списку" изменена обязательность параметра ответа "gtin" ("Код

товара");

В разделе "Метод получения информации о товаре по GTIN товара"

актуализированы пример ответа и параметры ответа;

В разделе "Электронное взаимодействие УОТ и Оператора ГИС МТ"

актуализирован URL демонстрационного стенда;

В документе "Декларация на товары" удалён параметр "cisIntId"

("Цифровой идентификатор применения блока информации,

содержащейся в КИ");

Добавлены параметры запроса "gtins" ("Список кодов товара в НК"),

"good_ids" ("Список идентификаторов товара в НК") и описание для

следующих методов: "Метод получения карточки товара, в том числе

неопубликованной карточки", "Метод получения полной информации о

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

В разделе "Метод получения статуса фида по ID фида от его заказчика"

добавлено примечание;

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

"Метод получения массива ID прошедших валидацию товаров", "Метод

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

GTIN товара";

В "Справочник "Дополнительные параметры в ответе в зависимости от

товарных групп"" добавлен раздел "Дополнительные параметры для ТГ

"Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные

напитки"", актуализированы разделы товарных групп;

Актуализирован раздел "Метод получения информации о товаре по

GTIN товара";

В "Справочник "Дополнительные параметры в ответе в зависимости от

товарных групп"" добавлен раздел "Дополнительные параметры для ТГ

"Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные

напитки"", актуализированы разделы для других товарных групп;

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

МТ" скорректировано описание для параметра "limit" ("Значение

устанавливает количество записей в ответе");

В описании типа документа "Вывод из оборота" для параметра

"document_type" ("Тип первичного документа"), указанного в массиве

"products" ("Массив, содержащий список КИ") и вне данного массива,

изменено название первичного документа "DESTRUCTION_ACT"

("Акт уничтожения") на "DESTRUCTION_ACT" ("Акт уничтожения

(утраты/утилизации)")

07.07.2021

36.0

Изменён пример в формате * .json для типа документа "Ввод в оборот.

Импорт с ФТС" товарной группы "Молочная продукция";

Дополнено описание типа документа "Ввод в оборот. Производство вне

ЕАЭС", добавлены примеры в формате * .json и * .xml для товарной

группы "Молочная продукция";

Актуализировано описание раздела "Метод получения общедоступной

информации о КИ по списку"

Дата

Версия

Изменения

докуме

нта

05.07.2021

35.0

Актуализированы описания документов "Ввод в оборот. Производство

вне ЕАЭС" и "Ввод в оборот. Импорт с ФТС" в связи с реализацией

подачи сведений об импорте товаров в групповых упаковках для

товарной группы "Молочная продукция";

Дополнено описание в разделе "Метод получения списка кодов

идентификации и кодов товара по идентификатору документа"

02.07.2021

34.0

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

обработки документа по идентификатору чека";

Актуализировано описание в разделе "Метод проверки КИ ТГ

"Табачная продукция" на вхождение в "серую зону"";

В тип документа "Агрегирование (ТГ "Табачная продукция",

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

продукция")" добавлен необязательный параметр "productionDate"

("Дата производства")

01.07.2021

33.0

Добавлено описание типа документа "Предоставление дополнительных

сведений об РД для ввода товара в оборот"

(CIRCULATION_INFORMATION);

Тип документа "Предоставление дополнительных сведений об РД для

ввода товара в оборот" (CIRCULATION_INFORMATION) добавлен в

"Справочник "Типы документов"";

Тип документа "Приёмка" недоступен для товарной группы "Молочная

продукция". Подача сведений в документе "Приёмка" для товарной

группы "Молочная продукция" остаётся доступной при

трансграничной торговле;

Тип документа "Описание остатков" недоступен для товарных групп

Дата

Версия

Изменения

докуме

нта

25.06.2021

32.0

В описание типа документа "Ввод в оборот. Импорт с ФТС" добавлен

пример запроса в формате * .json для товарных групп "Обувные

товары" и "Предметы одежды, бельё постельное, столовое, туалетное и

кухонное", изменён пример запроса для товарной группы "Молочная

продукция", внесено уточнение в описание параметров "productSize"

("Размер"), "color" ("Цвет"), "children" ("Массив, содержащий список

вложенных КИ");

В описание типов документов "Ввод в оборот. Производство вне

ЕАЭС" и "Ввод в оборот. Импорт с ФТС" для товарной группы

"Молочная продукция" добавлено примечание по указанию агрегата и

его вложений, имеющих признак подконтрольности ВСД, в документе

в формате * .csv;

В разделы "Метод получения дерева категорий (корень дерева не

возвращается)", "Метод получения списка торговых марок" добавлена

таблица с параметрами запроса;

Актуализирован "Метод получения статуса фида по ID фида от его

заказчика";

В описание типа документа "Формирование наборов" в комментарий

параметра "unitSerialNumber" ("Код идентификации набора") добавлено

уточнение об указании типа эмиссии "Произведён в РФ" (LOCAL) при

заказе КМ на наборы, ввозимые в РФ;

Актуализирован раздел "Метод получения информации о товаре по

GTIN товара";

Удалён "Метод получения истории движения КИ ТГ "Табачная

продукция"; В разделе "Метод поиска содержимого документа по

идентификатору документа" актуализирован список типов

пользователей, для которых доступен метод (тип приватности);

В разделе Метод проверки ИНН доверенного участника оборота

товаров метод изменен с POST на GET

Дата

Версия

Изменения

докуме

нта

18.06.2021

31.0

В типах документов "Ввод в оборот. Производство РФ", "Ввод в оборот.

Производство вне ЕАЭС", "Ввод в оборот. Трансграничная торговля",

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

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

добавлено правило указания ВСД для АТК;

В разделе "Требования к файлам обмена" добавлено ограничение для

указания древовидной структуры агрегата при подаче файла в формате

* .csv;

В описании параметров типа документа "Вывод из оборота" параметр

"document_custom_name" ("Наименование первичного документа")

изменён на "primary_document_custom_name" ("Наименование

первичного документа");

В описании "Метод запроса подлинности КМ" исправлен способ

экранирования символа GS в КМ в примерах тела запроса и ответа;

В типе документа "Агрегирование (ТГ "Табачная продукция",

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

продукция")" изменён формат даты первичного документа на "yyyy-

MM-dd";

В описании раздела "Метод запроса подлинности КМ"

скорректировано экранирование символа GS в КМ в примерах тела

запроса и ответа, актуализирован пример ответа

15.06.2021

30.0

Актуализировано описание и пример типа документа "Приёмка" при

трансграничном перемещении;

Тип документа "Ввод в оборот. Маркировка остатков" недоступен для

товарной группы "Обувные товары"

Дата

Версия

Изменения

докуме

нта

07.06.2021

29.0

Тип документов "Приёмка" недоступен для товарной группы

"Молочная продукция". Подача сведений в документе "Приёмка"

остаётся доступной при трансграничной торговле;

В описание "Метод получения списка кодов идентификации и кодов

товара по идентификатору документа" добавлен перечень документов,

для которых доступен данный метод;

В типе документа "Выбытие (ТГ "Табачная продукция",

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

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

"dropoutReason" ("Причина списания");

В "Метод получения CSV по списку кодов идентификации УОТ по

заданному фильтру" для параметра "withdrawReason" ("Причина

вывода из оборота") добавлен комментарий со ссылкой на "Справочник

"Причины вывода из оборота"";

В разделе "Метод получения статуса обработки документа" расширен

список проверок документа на наличие ошибок;

В примере в формате * .json типа документа "Приёмка" параметр

"turnover-type" ("Код типа отгрузки") заменён на "turnover_type" ("Код

типа отгрузки");

Актуализировано описание типа документа "Формирование наборов";

Скорректировано описание параметров ответа в разделе "Метод

получения общедоступной информации о КИ по списку" "ownerInn"

("ИНН владельца товара") и "ownerName" ("Наименование владельца

товара"), "StatusEx" ("Актуальное особое состояние");

Актуализировано описание метода "Работа с согласием о

предоставлении информации участникам оборота товаров ГИС МТ";

Скорректировано описание параметров метода "Получение ошибок по

результатам обработки документов";

В "Дополнительные параметры для ТГ "Молочная продукция""

добавлены параметры ответа: "declNumber" ("Номер декларации о

соответствии"), "regNumber" ("Номер свидетельства о государственной

регистрации"), "certNumber" ("Номер сертификата соответствия");

В справочник "Дополнительные параметры для ТГ "Альтернативная

табачная продукция" и "Табачная продукция"" добавлен параметр

"rawTobaccoWeight" ("Масса табачного сырья")

01.06.2021

28.0

Добавлен "Метод получения списка кодов идентификации и кодов

товара по идентификатору документа";

Добавлен "Метод запроса подлинности КМ"

Дата

Версия

Изменения

докуме

нта

31.05.2021

27.0

Подача сведений в типе документа "Ввод в оборот. Производство вне

ЕАЭС" недоступна для товарной группы "Обувные товары" с

01.06.2021;

В методе "Метод получения списка ИНН доверенных участников

оборота товаров" актуализирован комментарий параметра запроса

"limit" ("Предельное количество записей");

В типах документов "Ввод в оборот. Производство РФ", "Ввод в оборот.

Производство вне ЕАЭС", "Ввод в оборот. Трансграничная торговля",

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

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

актуализирован комментарий параметра "vsd_number" ("Номер ВСД");

В типе документа "Ввод в оборот. Импорт с ФТС" актуализированы

комментарий параметра "vsd_number" ("Номер ВСД") и примечание по

заполнению параметра "Номер ВСД" документа в формате * .csv; В

документе "Приёмка" в формате * .json параметр "products_list"

изменён на "products" ("Массив, содержащий список передаваемых

КИ"), из таблицы параметров удалён параметр "cis", добавлено

примечание к таблице описания параметров документа

27.05.2021

26.0

В "Метод получения CSV по списку кодов идентификации УОТ по

заданному фильтру" для параметра "withdrawReason" ("Причина

вывода из оборота") добавлен комментарий со ссылкой на "Справочник

"Причины вывода из оборота"";

В "Метод получения общедоступной информации о КИ по списку"

добавлен пример запроса для типа приватности с токеном, удалён

пример запроса для типа приватности без токена;

В методе "Получение ошибок по результатам обработки документов"

актуализирован пример запроса и описание метода;

В методе "Получение сведений по кодам идентификации и агрегатам"

актуализирован пример запроса и описание метода;

В разделе "Метод получения результирующих ID выгрузок данных"

добавлено описание, актуализирован пример запроса;

В разделе "Метод получения статуса задания на выгрузку по ID

выгрузки" добавлен комментарий для параметра "pg" ("Кодовое

значение товарной группы") и изменён тип данных;

Добавлен новый раздел "Метод получения статусов заданий на

выгрузку";

Актуализирован "Пример ответа для всех формируемых запросов на

выгрузку";

В разделе "Получение ошибок по результатам обработки документов"

актуализированы пример запроса и описание параметра запроса "name"

("Наименование выгрузки");

В разделе "Метод получения статуса задания на выгрузку по ID

выгрузки" актуализирован пример запроса

20.05.2021

25.0

Добавлено описание типов документов "Ввод в оборот. Импорт с

ФТС", "Формирование АТК", "Расформирование АТК",

"Трансформация АТК" для товарной группы "Молочная продукция"

Дата

Версия

Изменения

докуме

нта

18.05.2021

24.0

Скорректирован тип документа "Вывод из оборота";

Актуализирован "Справочник "Статусы документов"";

Актуализирован "Метод получения информации о товаре по GTIN

товара"

17.05.2021

23.0

В документе "Приёмка" длина значения параметра

"exporter_taxpayer_id" ("УНП экспортёра") должна соответствовать

8/9/10/12/14 символов;

Расширено описание параметра "document_type" ("Тип первичного

документа") типа документа "Вывод из оборота";

Для типов документов "Ввод в оборот. Производство РФ", "Приёмка",

"Ввод в оборот. Производство вне ЕАЭС", "Ввод в оборот. Контрактное

производство РФ", "Ввод в оборот. Трансграничная торговля", "Ввод в

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

добавлено описание ФЛК по обработке значения параметра

"vsd_number" ("Номер ВСД");

Добавлен код "GROUP" ("Групповая упаковка") в "Справочник "Типы

упаковки""

11.05.2021

22.0

Типы документов "Отгрузка", "Отгрузка с выводом из оборота",

"Отмена отгрузки", "Приёмка" в формате * .xml недоступны для

товарной группы "Молочная продукция";

В тип документа "Вывод из оборота" добавлен параметр

"withdrawal_type_other" ("Другая причина") в связи с реализацией

функциональности вывода из оборота по причине "Другое" для всех

товарных групп, кроме товарных групп "Альтернативная табачная

продукция", "Никотиносодержащая продукция" и "Табачная

продукция";

Актуализирован "Справочник "Причины вывода из оборота"";

Актуализирован справочник "Актуальные особые состояния"

Дата

Версия

Изменения

докуме

нта

06.05.2021

21.0

Добавлена рекомендация по использованию методов "Метод поиска

содержимого документа по идентификатору документа" и "Метод

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

документе "Отгрузка" 10000 КИ и более в разделе "Подача сведений в

документе "Отгрузка"";

Заменён рекомендуемый метод для использования при наличии в

документе "Приёмка" 10000 КИ и более на "Метод поиска содержимого

документа по идентификатору документа" в разделе "Шаг 2: получение

сведений о содержимом документа по идентификатору";

Актуализирован пример запроса в разделе "Метод поиска содержимого

документа по идентификатору документа";

Актуализирован URL в разделе "Метод получения содержимого

документа по идентификатору";

Тип документов "Ввод в оборот. Маркировка остатков" недоступен для

товарной группы "Предметы одежды, бельё постельное, столовое,

туалетное и кухонное";

В разделе скорректирован "Метод получения списка ИНН доверенных

участников оборота товаров" URL и пример запроса, удалены

параметры запроса "filter" ("Фильтр поиска доверенных участников") и

"pg" ("Товарная группа"), добавлено примечание: "В запросе должен

быть указан параметр "ownerInn" ("ИНН доверителя"), иначе в ответе

возвращается ошибка 400 "Bad request" ("Ошибка в параметрах

запроса");

В разделе "Метод получения статуса обработки документа" для

параметра "cis" расширено описание: "КИ/КИН/КИТУ/КИГУ/КИТУ",

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

В раздел "Метод получения статуса обработки документа" добавлена

информация об ограничении по количеству возвращаемых ошибок по

документу: 1000;

Добавлено примечание: "При отсутствии вложений в агрегате, в ответе

возвращается пустой массив КИ в квадратных скобках "[]" в раздел

"Запрос списка агрегированных КИ (POST)";

Добавлен параметр запроса "pg" ("Товарная группа") в "Метод

получения содержимого документа по идентификатору". Указание

данного параметра обязательно при установке параметра "limit";

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

в ГИС МТ" удалён параметр ответа "externalId" ("ID документа во

внешней системе ЭДО");

Добавлены параметры ответа "additionalProp" ("Контент документа") и

"additionalProp" ("Список ошибок обработки документа") в "Метод

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

получения содержимого документа по идентификатору"

Дата

Версия

Изменения

докуме

нта

22.04.2021

20.1

Актуализирован успешный ответ на запрос в разделе "Метод

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

Тип документа "Ввод в оборот. Маркировка остатков" доступен для

единиц товаров товарной группы "Обувные товары", описанных в НК

по полному атрибутивному составу. В текущей реализации заполнение

параметра "kitu" ("КИТУ") для товарной группы "Обувные товары"

недоступно в документе "Ввод в оборот. Маркировка остатков".

Плановый срок отключения возможности создания документа для

товарной группы "Обувные товары" - 16.06.2021;

Для документа "Ввод в оборот. Маркировка остатков" параметр

"products_list" ("Список сведений о товарах") обязательный для

заполнения

16.04.2021

20.0

Расширено описание параметра "cis" документа "Ввод в оборот.

Импорт с ФТС";

Актуализирован "Справочник "Список поддерживаемых товарных

групп"";

Добавлено уточнение для методов "Получение сведений по кодам

идентификации и агрегатам" и "Получение списка кодов

идентификации УОТ по заданному фильтру" выполнением проверки

наличия договора по всем товарным группам, по КИ которых

запрашивается выгрузка;

Дополнено ограничение на использование значений для параметра

"withdrawal_type" ("Причина вывода из оборота") в документе

"Отгрузка с выводом из оборота" для товарной группы "Молочная

продукция";

В документе "Возврат в оборот" удалено значение RECEIPT_RETURN

("Чек возврата") параметра "return_type"

05.04.2021

19.0

Дополнено описание параметров документ "Ввод в оборот. Импорт с

ФТС";

Актуализирован состав параметров документа "Декларация на товары";

Актуализирован "Справочник "Дополнительные параметры в ответе в

зависимости от товарных групп""

Дата

Версия

Изменения

докуме

нта

01.04.2021

18.0

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

"Список поддерживаемых товарных групп"";

Документы "Описание остатков", "Агрегирование (ТГ "Табачная

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

"Никотиносодержащая продукция")", "Выбытие (ТГ "Табачная

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

"Никотиносодержащая продукция")" доступны для товарной группы

"Никотиносодержащая продукция";

В "Справочник "Список поддерживаемых товарных групп"" добавлена

товарная группа "Пиво, напитки, изготавливаемые на основе пива,

слабоалкогольные напитки";

Типы документов "Агрегация", "Возврат в оборот", "Вывод из

оборота", "Трансформация", "Расформирование", "Списание не

нанесённых КИ с/без СИ" доступны для товарной группы "Пиво,

напитки, изготавливаемые на основе пива, слабоалкогольные напитки";

В ответе метода "Метод получения краткой общедоступной

информации о КИ по списку" добавлен параметр "maxRetailPrice"

("Максимальная цена розничной продажи");

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

сгруппированы в раздел "Метод получения квитанций результата

обработки документов"

26.03.2021

17.3

Добавлен "Метод получения квитанции результата обработки

документа по идентификатору чека";

Актуализирован "Справочник "Дополнительные параметры в ответе в

зависимости от товарных групп"";

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

товаре по GTIN товара";

Дополнено описание параметров типов документов в формате * .json

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

продукция")" и "Выбытие (ТГ "Табачная продукция" и

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

Изменён тип параметра "partialSaleInfo" (Объект параметров

частичного выбытия);

Для документа "Ввод в оборот. Импорт с ФТС" дополнено описание

параметра "cis" (КИ);

Актуализирован перечень товарных групп, для которых доступен

документ "Ввод в оборот. Производство вне ЕАЭС";

Добавлен "Справочник "Причины вывода из оборота""

Дата

Версия

Изменения

докуме

нта

19.03.2021

17.2

Скорректировано описание параметров типа документа "Выбытие (ТГ

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

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

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

Тип документа "Ввод в оборот. Маркировка остатков" доступен для

единиц товаров товарной группы "Предметы одежды, бельё

постельное, столовое, туалетное и кухонное", описанных в НК по

полному атрибутивному составу. Плановый срок отключения

возможности создания документа для товарной группы "Предметы

одежды, бельё постельное, столовое, туалетное и кухонное" -

01.05.2021. В текущей реализации заполнение параметра "kitu" для

товарной группы "Предметы одежды, бельё постельное, столовое,

туалетное и кухонное" недоступно в документе "Ввод в оборот.

Маркировка остатков"

15.03.2021

17.1

Скорректировано описание для параметра "packType" документа "Ввод

в оборот. Импорт с ФТС"

Дата

Версия

Изменения

докуме

нта

12.03.2021

17.0

В разделе "Формирование наборов" добавлено примечание по

расформированию набора с ошибочно добавленными КИ;

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

"Приёмка" в формате * .json;

Актуализирован документ "Отгрузка при трансграничной торговле";

Актуализирована информация о стендах в разделе "Электронное

взаимодействие УОТ и Оператора ГИС МТ";

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

"Отгрузка";

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

товаре по КИ товара";

Добавлен формат * .json для типов документов "Агрегирование (ТГ

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

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

продукция")";

Добавлен метод "Метод получения истории движения КИ";

Добавлена информация о необходимости наличия согласия в раздел

"Работа с согласием о предоставлении информации участникам

оборота товаров ГИС МТ";

Актуализировано описание метода "Метод получения истории

движения КИ ТГ "Табачная продукция"";

Добавлен "Метод поиска содержимого документа по идентификатору

документа";

Внесены корректировки в запросы и ответы следующих методов

"Национального каталога маркированных товаров": "Метод подписи

карточки товара", "Метод подписи предоставления или отзыва

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

XML для управления доступами субаккаунтов", "Метод получения

списка субаккаунтов компании", "Метод подписи карточки товара",

"Метод получения списка субаккаунтов компании", "Метод получения

файла в формате XML для управления доступами субаккаунтов",

"Метод подписи предоставления или отзыва разрешения на

использование КИ"

Дата

Версия

Изменения

докуме

нта

04.03.2021

16.0

Реализована версия 4 (v4) метода GET /edo/inn/{inn}("Публичный

метод получения идентификатора абонента в ЭДО Lite"). Версия 3

метода будет поддерживаться для сохранения обратной совместимости.

Плановая дата отключения: 03.08.2021;

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

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

ответа;

Расширены параметры ответа в методах: "Метод получения

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

номеру документа";

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

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

товаров", Метод получения списка всех принадлежащих одному

владельцу товаров", "Метод определения кода принадлежности товара

к маркируемым товарным группам";

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

карточки товара", "Метод получения списка субаккаунтов компании",

"Метод получения файла в формате XML для управления доступами

субаккаунтов", "Метод подписи предоставления или отзыва разрешения

на использование КИ";

Добавлены разделы "Методы "Станции управления заказами"" и

"Метод получения токена аутентификации в СУЗ"

01.03.2021

15.2

Добавлен комментарий к ошибке 107 в разделе "Описание кодов

возвращаемых ошибок при обработке документов";

Тип документа "Описание остатков" недоступен для товарной группы

"Шины и покрышки пневматические резиновые новые" с 01.03.2021

24.02.2021

15.1

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

добавлена возможность указывать в запросе значение "empty" в

параметре "pg", если товарная группа в документе не определена;

Актуализировано примечание для документа "Агрегация";

Добавлен "Метод получения тела документа согласия или документа

аннулирования согласия";

Для методов раздела скорректирован формат даты параметра

expirationDate" ("Дата окончания срока действия согласия");

Актуализированы примеры curl методов: "Метод получения списка

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

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

документа по идентификатору", "Метод получения общедоступной

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

общедоступной информации о КИ по списку", "Запрос списка

агрегированных КИ (GET)", "Запрос списка агрегированных КИ

(POST)", "Метод получения списка десятизначных кодов ТН ВЭД",

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

отправки документа ЭДО на повторную обработку";

Расширены параметры запроса в разделе "Метод отправки документа

ЭДО на повторную обработку"

Дата

Версия

Изменения

докуме

нта

17.02.2021

15.0

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

скорректировано примечание;

Актуализированы примеры ответа в разделах "Метод получения

общедоступной информации о КИ по списку", "Метод получения

краткой общедоступной информации о КИ по списку", "Метод

получения истории движения КИ ТГ "Табачная продукция"" и "Метод

получения информации о КИ по списку КИ при наличии согласия о

предоставлении информации" в рамках реализации функциональности

по частичному выбытию для товарных групп "Альтернативная

табачная продукция" и "Духи и туалетная вода"

11.02.2021

14.0

В разделе "Метод отправки документа ЭДО на повторную обработку"

изменилось описание ошибок;

"Метод получения квитанций результата обработки универсального

документа по идентификатору документа" позволяет получить

квитанцию результата обработки предложения об аннулировании УД;

Актуализировано описание кода "CANCELLED" в разделе

"Справочник "Статусы документов"";

Добавлены разделы "Метод подачи УПД на предварительную

проверку" и "Метод получения статуса обработки документа" в раздел

"Взаимодействие с провайдером ЭДО Lite";

Изменилась структура по запрашиваемому массиву ИНН участников

оборота товаров в разделе "Метод проверки регистрации участников

оборота товаров по ИНН в ГИС МТ"

10.02.2021

13.4

В "Метод получения общедоступной информации о КИ по списку" и

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

списку" добавлен необязательный параметр ответа "ИНН агента"

("agentInn")

09.02.2021

13.3

Актуализирована обязательность параметров типа документа "Отгрузка

при трансграничной торговле";

Актуализированы обязательность и описание параметров типа

документа "Приёмка";

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

табачная продукция")" изменена обязательность параметра

"КодыИдентификации"; Актуализированы методы раздела "Работа с

согласием о предоставлении информации участникам оборота товаров

ГИС МТ"

Дата

Версия

Изменения

докуме

нта

04.02.2021

13.2

В разделе "Получение списка кодов идентификации УОТ по заданному

фильтру" расширен комментарий параметра запроса

"emissionDateFrom" ("Дата эмиссии от");

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

заданному фильтру" добавлен параметр запроса "remarkHistory"

("Фильтрация по истории перемаркировки КИ");

В разделе "Метод получения содержимого документа по

идентификатору" расширен комментарий параметра запроса "limit"

("Значение устанавливает количество записей в ответе");

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

товаров по заданному фильтру" добавлен фильтр по типу упаковки;

Внесены изменения в "Метод получения CSV ошибок по результатам

обработки документов";

Дополнено описание назначения метода "Получение списка кодов

идентификации УОТ по заданному фильтру"

01.02.2021

13.1

Типы документов "Ввод в оборот. Маркировка остатков" и "Описание

остатков" недоступны для товарной группы "Предметы одежды, бельё

постельное, столовое, туалетное и кухонное" с 01.02.2021;

Актуализирована примеры документа "Описание остатков" в формате

*.json и *.xml

29.01.2021

13.0

Добавлены методы формирование выгрузок данных из ГИС МТ: метод

"Получение списка кодов идентификации УОТ по заданному фильтру"

и "Метод получения CSV по списку кодов идентификации УОТ по

заданному фильтру";

В справочник "Актуальные статусы" добавлен статус "Возвращён в

оборот" (INTRODUCED_RETURNED) для ТГ "Табачная продукция" и

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

Для документа "Ввод в оборот. Полученных от физических лиц" тип

выпуска КИ должен быть только COMMISSION ("Принят от

физических лиц"). Тип выпуска КИ LOCAL ("Производство РФ") для

данного документа больше недоступен;

Актуализированы параметры документа "Приёмка" для товарной

группы "Молочная продукция"

22.01.2021

12.0

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

МТ" в параметре запроса не указывается массив для "pg" - запрос

осуществляется по одной товарной группе;

На демонстрационном стенде для товарной группы "Молочная

продукция" добавлен параметр "vsd_number" ("Номер ВСД") в

документ "Приёмка" в формате * .json - функциональность на

текущий момент находится в тестировании;

Дополнено описание типа документа "Перемаркировка" в связи с

реализацией функциональности перемаркировки наборов;

Дополнено описание параметра "uit" ("Уникальный КИ") и

актуализирован пример *.xml для типов документов в разделе

"Списание не нанесённых КИ с/без СИ" и "Списание нанесённых КИ с

СИ"

Дата

Версия

Изменения

докуме

нта

20.01.2021

11.7

Добавлены следующие разделы: "Метод загрузки титулов", "Метод

загрузки квитанций с уведомлением об уточнении", "Метод загрузки

квитанций с предложением об аннулировании", "Метод аннулирования

документа", "Метод загрузки квитанций c предложением отклонения

аннулирования"

18.01.2021

11.6

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

выгрузки данных: "Метод получения статуса задания на выгрузку по ID

выгрузки", "Метод получения результирующих ID выгрузок данных",

"Пример ответа для всех формируемых запросов на выгрузку". Для

указанных методов сокращён состав возвращаемых параметров в

ответе

15.01.2021

11.5

Скорректирован URL в разделе "Метод подписания документа согласия

или документа аннулирования согласия";

Изменён тип приватности в разделе "Метод получения общедоступной

информации о КИ по списку" для товарных групп "Табачная

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

Для типа документа "Перемаркировка" в формате * .csv сохраняется

использование причин перемаркировки с названием, отличным от

используемого в личном кабинете ГИС МТ при создании документа:

"Возврат товаров с поврежденным СИ/без СИ при розничной

реализации" (в ЛК ГИС МТ "Возврат от розничного покупателя"

(RETAIL_RETURN)) и Возврат товаров с поврежденным СИ/без СИ

при дистанционном способе продажи (в ЛК ГИС МТ "Возврат в случае

дистанционной продажи" (REMOTE_SALE_RETURN))

13.01.2021

11.4

Актуализирован пример тела документа "Декларация на товары";

Добавлен код "COMMISSION" ("Принят на комиссию от физического

лица") в "Справочник "Типы эмиссии КИ"";

Расширено описание параметра "uit" для типа документа "Ввод в

оборот. Полученных от физических лиц";

Добавлена рекомендация по заполнению документа "Ввод в оборот.

Трансграничная торговля"

25.12.2020

11.3

Актуализирован пример документа "Отгрузка" в формате * .xml;

Актуализирован тип приватности в разделе "Метод проверки КИ ТГ

"Табачная продукция" на вхождение в "серую зону"";

Уточнён пример запроса и исключён параметр "ID" из таблицы

параметров запроса в методе "Получение сведений по заключённым

договорам между УОТ и ГИС МТ";

Расширен комментарий для параметра "ki" в документе

"Трансформация АТК";

Актуализировано описание документа "Трансформация АТК";

Актуализированы значения параметра запроса "orderColumn" в разделе

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

Актуализированы формат параметра "certificate_document_date" в

документе "Перемаркировка"

Дата

Версия

Изменения

докуме

нта

18.12.2020

11.2

Изменена обязательность параметра "turnover_type" в документе

"Приёмка" и скорректировано описание параметров в типах

документов "Ввод в оборот. Производство РФ" и "Ввод в оборот.

Контрактное производство РФ";

Актуализирован "Метод отправки документа ЭДО на повторную

обработку";

Тип документа "Ввод в оборот. Маркировка остатков" будет открыт для

товарной группы "Духи и туалетная вода"

10.12.2020

11.1

Добавлен "Метод получения списка ИНН по идентификатору

документа согласия";

Актуализирована таблица "Коды ошибок общих проверок для УД" в

разделе "Метод получения CSV ошибок по результатам обработки

документов"; Изменение ФЛК документов "Приёмка" и "Отгрузка":

значение "turnover_type" документа "Приёмка" должно совпадать со

значением "turnover_type" документа "Отгрузка"

07.12.2020

11.0

Документ "Формирование наборов" доступен для товарной группы

"Предметы одежды, бельё постельное, столовое, туалетное и

кухонное";

Актуализирована обязательность параметров документа "Приёмка";

Актуализирован пример CSV типа документа "Ввод в оборот. Импорт с

ФТС";

Добавлен "Метод отправки документа ЭДО на повторную обработку";

Актуализирована таблица "Коды и текст ошибок для УД" в разделе

"Метод получения CSV ошибок по результатам обработки документов"

03.12.2020

10.0

Актуализировано описание типа документа "Перемаркировка";

Документ "Ввод в оборот. Импорт с ФТС" и типы документов раздела

"Операции с АТК" доступны для ТГ "Предметы одежды, бельё

постельное, столовое, туалетное и кухонное" c 01.12.2020.

Актуализировано описание раздела "Метод получения содержимого

документа по идентификатору";

Добавлен тип документа "Декларация на товары", поступающий в ГИС

МТ от ФТС России

30.11.2020

9.4

Создание документа "Описание остатков" недоступно для товарных

групп "Табачная продукция" и "Фотокамеры (кроме кинокамер),

фотовспышки и лампы-вспышки" с 01.12.2020;

Скорректировано описание типа документа "Ввод в оборот.

Производство РФ";

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

универсального документа по идентификатору документа"

25.11.2020

9.3

Актуализирован "Метод получения списка КИ товаров (GTIN) УОТ по

ИНН";

Актуализирован тип документа "Перемаркировка".

Дата

Версия

Изменения

докуме

нта

17.11.2020

9.1

Уточнён пример ответа и параметры ответа в разделе "Метод

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

Уточнено наименование раздела "Метод получения списка кодов

товаров (GTIN) УОТ по ИНН";

Уточнен пример тела документа в формате XML в разделе "Отгрузка";

Уточнено описание типа документа в разделе "Ввод в оборот. На

территории стран ЕАЭС (контрактное производство)";

Удалён тип документа "Оприходование излишков": доступность подачи

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

запросу

06.11.2020

9.0

Актуализирован "Метод проверки регистрации участников оборота

товаров по ИНН в ГИС МТ";

Добавлено примечание в раздел "Метод получения квитанций

результата обработки универсального документа по идентификатору

документа";

Уточнён пример запроса в методе "Получение сведений по

заключённым договорам между УОТ и ГИС МТ";

Уточнён комментарий для параметра "guid" в методе "Получение

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

Добавлен пример запроса в раздел "Метод получения истории

движения КИ ТГ "Табачная продукция"";

Уточнён пример запроса в методе "Запрос списка агрегированных КИ

(GET)";

Уточнено описание параметра "edo_operator_name" в разделе "Метод

создания заявки на регистрацию участника оборота товаров";

Актуализирован пример ответа в случае ошибки с кодом 404 в разделе

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

Актуализирован пример запроса, в таблицу параметров запроса

добавлен параметр "pg" в разделе"Метод получения статуса задания на

выгрузку по ID выгрузки";

Удален параметр "filter" из таблицы параметров запроса в разделе

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

заданному фильтру";

Уточнен комментарий для параметра "declaration_date" и

"certificate_document_date" в разделе "Ввод в оборот. Производство вне

ЕАЭС"; Для предварительной интеграции УОТ добавлено описание

новой версии типа документа "Перемаркировка";

Для типов документов "Отгрузка" указана доступность создания

документа в зависимости от товарной группы;

Актуализированы форматы документа (JSON, CSV XML) для типа

документа "Ввод в оборот. Трансграничная торговля";

Для документов "Агрегирование (ТГ "Табачная продукция" и

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

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

возвращение в ответе "id"

Дата

Версия

Изменения

докуме

нта

09.11.2020

8.3

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

идентификации и агрегатам";

Скорректировано примечание по подаче сведений в документе

"Приёмка";

Для предварительной интеграции УОТ добавлен тип документа

"Оприходование излишков" для ТГ "Табачная продукция" и

"Альтернативная табачная продукция". См. также раздел

"Планируемые изменения в True API" и раздел "Оприходование

излишков";

В документе "Возврат в оборот" изменена обязательность параметра

"ki" (КИ/КИН)

02.11.2020

8.2

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

Скорректирован комментарий к документу "Приёмка";

Актуализирован раздел "Метод получения содержимого документа по

идентификатору";

Уточнено указание КИН при подаче сведений в документах;

Удалён устаревший метод "Получения списка кодов идентификации"

(/cises/my);

Актуализировано наименование системного поля, указываемого в

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

ошибок по результатам обработки документов";

Добавлен тип документа "Оприходование излишков" для ТГ "Табачная

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

Дата

Версия

Изменения

докуме

нта

26.10.2020

8.1

Уточнён тип приватности для метода "Метод получения краткой

общедоступной информации о КИ по списку";

Для типа документа "Перемаркировка" скорректировано описание для

параметров "last_uin" и "new_uin";

В раздел "Список сокращений и условных обозначений" добавлены

расшифровки аббревиатур "КИГУ", "КИН", "КИК";

Для метода "Получение сведений по заключённым договорам между

УОТ и ГИС МТ" расширен состав параметров запроса;

Актуализирован пример запроса в разделе "Метод получения списка

десятизначных кодов ТН ВЭД";

Для метода "Ввод в оборот. Импорт с ФТС" обновлено описание

параметра "cis";

Для метода "Метод получения краткой общедоступной информации о

КИ по списку" уточнено описание параметра запроса "values";

Изменена логика проверки указываемого формата значения КИТУ:

увеличено количество и изменён формат вводимых символов;

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

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

табачная продукция";

Для документа "Описание остатков" при подаче товарными группами

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

уточнены адреса стендов при текущей реализации функционала;

Уточнено описание параметра "sntins" документа "Формирование

наборов";

Метод "Запрос карточки продукта по одному уникальному

идентификатору товара" переименован в "Метод получения карточки

товара по КИ";

Удалён устаревший URL: /cises/{code}/history "Метод получения

истории движения КИ ТГ "Табачная продукция"": в текущей

реализации использовать URL: /cises/history. Актуализировано

описание метода;

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

денежных средств по всем товарным группам";

Добавлен параметр "uuid" в типы документов "Агрегирование (ТГ

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

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

продукция")";

Добавлено уточнение указания АТК в документе "Формирование АТК";

Добавлены кодовые наименования типов документов "Агрегирование

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

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

продукция")";

Дополнено описания параметров "packs" и "cisPackageType"

Дата

Версия

Изменения

докуме

нта

06.10.2020

8.0

Добавлен "Метод подписания документа согласия или документа

аннулирования согласия";

Детализировано описание ответа в случае успеха для "Агрегирование

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

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

продукция")";

Актуализирован раздел "Планируемые изменения в True API"

28.09.2020

7.0

Добавлен тип документа "Формирование наборов" для товарных групп

"Предметы одежды, бельё постельное, столовое, туалетное и

кухонное", "Духи и туалетная вода", "Фотокамеры (кроме кинокамер),

фотовспышки и лампы вспышки";

В "Справочник "Типы документов"" добавлен тип документа

"Формирование наборов";

В "Справочник "Типы упаковки"" добавлен тип упаковки "Набор"

(SET);

Актуализировано описание запроса и ответа в разделе "Метод

получения общедоступной информации о кодах идентификации по

списку";

Раздел "Нетабачные методы" переименован в "Методы создания

документов" Реализована возможность подачи документа "Ввод в

оборот. Импорт с ФТС", для товарных групп "Предметы одежды, бельё

постельное, столовое, туалетное и кухонное", "Духи и туалетная вода",

"Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки",

"Шины и покрышки пневматические резиновые новые";

Определены плановые даты отключения подачи документа "Ввод в

оборот. Производство вне ЕАЭС" для товарных групп "Предметы

одежды, бельё постельное, столовое, туалетное и кухонное", "Духи и

туалетная вода", "Фотокамеры (кроме кинокамер), фотовспышки и

лампы-вспышки", "Шины и покрышки пневматические резиновые

новые";

Метод /api/v3/true-api/cises/{code}/history "Запрос цепочки движения

кода идентификации" является устаревшим, в дальнейшем

рекомендуется использовать /api/v3/true-api/cises/history;

Для документа "Описание остатков" уточнено ограничение по

созданию в зависимости от товарной группы;

Метод "Запрос карточки продукта по одному уникальному

идентификатору товара /products/{cis} (метод устарел)" устаревший,

удалён из документации

Дата

Версия

Изменения

докуме

нта

14.09.2020

6.4

Дополнено описание параметров документа "Приёмка";

Скорректирована XML-схема для типа документа "Вывод из оборота";

Изменена структура справочника "Справочник "Статусы КИ"";

Добавлены коды ошибок документа в раздел "Метод получения CSV

ошибок по результатам обработки документов";

Для параметра "document_type" типа документа "Вывод из оборота"

изменено название первичного документа "DESTRUCTION" на

"DESTRUCTION_ACT";

Для метода "Запрос цепочки движения кода идентификации" расширен

состав параметров ответа;

Для метода "Ввод в оборот. Импорт с ФТС" изменилась логика

проверки даты декларации;

В разделе "Метод получения содержимого документа" изменён пример

запроса;

Для параметра "signtype" добавлено описание статусной модели;

Добавлен раздел "Регистрация УОТ";

"Метод формирования согласия на предоставление сведений о кодах

идентификации для невладельцев", "Метод аннулирования документа

на основании текущего опубликованного документа согласия", "Метод

получения информации о КИ по списку КИ при наличии согласия"

перенесены в раздел "Работа с согласием на предоставление сведений о

своих КИ и агрегатах другим участникам";

В методе "Создание заявки на регистрацию УОТ" изменено описание

шагов по созданию ключа;

В методе "Получение сведений по черновикам договоров между УОТ и

ГИС МТ" удалена обязательность для параметров: "edoStatus",

"edoDocumentId", дополнено описание. Для параметра "doctype"

добавлена ссылка на "Справочник "Типы договоров"". Для параметра

"signtype" добавлено описание статусной модели.

Добавлен раздел "Регистрация участника оборота товаров";

Изменено наименование метода "Запрос карточки продукта по одному

уникальному идентификатору товара /products/{cis}" на "Запрос

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

/products/{cis} (метод устарел)";

Для метода "Ввод в оборот. Производство вне ЕАЭС" уточнена

предварительная дата отключения для товарных групп;

"Ввод в оборот. Маркировка остатков" недоступен для товарной

группы "Обувные товары";

Для метода "Ввод в оборот. Импорт с ФТС" изменено описание

параметров "color" и "productSize";

Для метода "Описание остатков" уточнена обязательность параметров в

зависимости от значения кода товарной номенклатуры;

Изменены параметры запроса и ответа раздела "Метод получения

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

Для метода "Запрос данных о списке кодов идентификации по cis

(POST)" уточнено значение количества, указываемых КИ в URL

запроса;

Уточнены значения справочника "Актуальные статусы" для КИ;

Для документа "Ввод в оборот. Импорт с ФТС" скорректировано

описание для параметра запроса "cis"

Дата

Версия

Изменения

докуме

нта

30.07.2020

6.3

Добавлены "Методы формирования выгрузок данных из ГИС МТ";

Для метода "Запрос данных о списке кодов идентификации по cis

(POST)" описаны параметры ответов;

Удалены разделы "Перечень возможных параметров ответов методов

получения данных о кодах идентификации" и "Перечень возможных

параметров ответов методов получения списка контрагентов УОТ";

Добавлены примечания по логике работы методов "Ввод в оборот.

Производство вне ЕАЭС" и "Ввод в оборот. Импорт с ФТС";

Для метода "Метод получения статуса фида по ID фида от его

заказчика" добавлен параметр apikey заказчика ("supplier_key");

Для метода "Ввод в оборот. На территории стран ЕАЭС (контрактное

производство)" удалены параметры "Сумма НДС" и "Цена за единицу";

В "Методе получения списка товаров по заданному фильтру" изменены

значения для параметра "Дополнительный статус товара" (statusExt);

Для метода "Формирование АТК" добавлено ограничения для

параметра КИ (ki) "Указываются только номера КИ. Указание в данном

поле номера КИТУ или КИ, уже входящих в КИТУ или другой АТК, не

допускается";

Удалён параметр "Атрибуты ответа" (documentDataDTO);

Изменены возможные принимаемые значения для параметра "Причина

вывода из оборота" (withdrawReason);

Для метода "Запрос цепочки движения кода идентификации" добавлен

параметр "Номер документа смены статуса" (docId);

В раздел "Метод получения содержимого документа" в запрос добавлен

необязательный параметр "Товарная группа" (pg);

В раздел "Метод проверки КИ ТГ "Табачная продукция" на вхождение

в "серую зону"" добавлено описание параметров "gzPacks" и "gzBlock";

В "Методе получения общедоступной информации о кодах

идентификации по списку" из тела запроса удален параметр "codes" в

запросе передается массив кодов идентификации;

Для типа документа "Ввод в оборот. Полученных от физических лиц"

изменён пример в формате * .json, удалён параметр "Тип документа";

Изменено наименование метода "Метод получения ZIP-архива

документа с подписью и квитанциями" на "Метод получения ZIP-

архива документа ЭДО с подписями и квитанциями из ЭДО Lite"

22.07.2020

6.2

Добавлен метод "Метод получения квитанций результата обработки

универсального документа по идентификатору документа"

Дата

Версия

Изменения

докуме

нта

06.07.2020

6.1

Добавлен "Метод проверки КИ ТГ "Табачная продукция" на вхождение

в "серую зону"";

Для методов "Запрос карточки продукта по одному уникальному

идентификатору товара /products/info" и "Запрос карточки продукта по

одному уникальному идентификатору товара /products/{cis}";

Для типа документа "Ввод в оборот. Производство вне ЕАЭС"

изменено описание, для каких ТГ метод является устаревшим;

Для методов "Получение состава агрегата" изменено описание, ответ

возвращает только первый слой;

Для статуса КИ удален ошибочный параметр

"WAIT_FOR_CONTINUATION";

Для типа документа "Ввод в оборот. На территории стран ЕАЭС

(контрактное производство)" добавлено описание, что только для ТГ

"Молочная продукция";

Для типа документа "Приёмка" добавлено обязательное поле "Номер

отгрузки";

Для параметра статус добавлен параметр "WITHDRAWN - выбыл,

только для товарной группы "Табачная продукция""

Дата

Версия

Изменения

докуме

нта

23.06.2020

6.0

Изменено описание для параметров "childrenPage" и "childrenLimit";

Удалены атрибуты 2502 и 2503 для методов НК;

Для методов "Запрос списка агрегированных кодов идентификации по

списку родительских кодов идентификации (GET)" и "Запрос списка

агрегированных кодов идентификации по списку родительских кодов

идентификации (POST)" изменена приватность на публичную;

Добавлены ограничения по товарным группам и удалён параметр тип

товарооборота для типа документа "Отгрузка при трансграничной

торговле";

Добавлены ограничения по товарным группам для типа документа

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

Для параметра "status" добавлено значение "Списан" (WRITTEN_OFF);

Параметр "Максимальное количество записей" (limit) для общих

методов не может использоваться без указания товарной группы;

Актуализирован "Справочник "Типы документов"";

Метод "Запрос данных о списке кодов идентификации по cis (POST)"

перенесён в общие методы;

Документ "Вывод товара из оборота при реализации конечному

потребителю" переименован в "Вывод из оборота";

Метод "Запрос карточки продукта по одному уникальному

идентификатору товара /products/{cis}" считать устаревшим,

используется метод "Запрос карточки продукта по одному уникальному

идентификатору товара /products/info";

Изменено описание для параметров "childrenPage" и "childrenLimit";

Добавлено описание для параметра "orderedColumnValue";

Для методов "Запрос карточки продукта по одному уникальному

идентификатору товара /products/info" и "Запрос карточки продукта по

одному уникальному идентификатору товара /products/{cis}"

обновлены параметры ответов для МОТП;

Для параметра "orderColumn" допустимое значение заменено с

"docDate" на "receivedAt";

Метод "Ввод в оборот. Производство вне ЕАЭС" считать устаревшим,

будет поддерживаться в течении трёх месяцев;

Вместо устаревшего "Ввод в оборот. Производство вне ЕАЭС"

реализован метод "Ввод в оборот. Импорт с ФТС";

В типе документа "Ввод в оборот. Импорт с ФТС" поля цвет (color) и

размер (productSize) изменены на необязательные;

Дата

Версия

Изменения

докуме

нта

05.06.2020

5.1

Обновлён "Метод получения содержимого документа" добавлены

параметры;

Изменены параметры ответа для метода "Запрос информации об

участнике оборота товаров по ИНН";

Изменены параметры ответа для метода "Метод получения списка

загруженных документов в ГИС МТ";

Обновлены все методы в разделе "Методы Национального каталога";

Обновлены ендпоинты во всех методах, удалена часть api/v3/true-api;

Добавлен параметр ответа "response" для метода "Метод получения

счёта на оплату";

Удалён параметр "owner_name" для "Метода получения информации о

КИ по списку КИ при наличии согласия";

Обновлен * .json и обязательность параметров для метода создания

документа "Вывод товара из оборота при реализации конечному

потребителю";

Добавлены параметры запроса "childrenLimit" и "childrenPage" для

методов: "Метод получения списка товаров по заданному фильтру",

"Запрос списка агрегированных кодов идентификации по списку

родительских кодов идентификации (GET)", "Запрос списка

агрегированных кодов идентификации по списку родительских кодов

идентификации (POST)", "Запрос карточки продукта по одному

уникальному идентификатору товара";

Обновлено описание параметров ответов для метода "Запрос карточки

продукта по одному уникальному идентификатору товара";

Обновлены параметры ответа для метода "Метод получения

информации о товаре по Коду товара";

Добавлены параметры для массива "childs" метода "Метод получения

информации о КИ по списку КИ при наличии согласия";

"Запрос информации о чеке по его идентификатору" перемещен в

раздел "Общие методы для табачной и нетабачной товарной группы";

Переименован метод "Получение подробной информации о кодах

идентификации по списку" в "Метод получения общедоступной

информации о кодах идентификации по списку"

Дата

Версия

Изменения

докуме

нта

26.05.2020

5.0

Добавлены следующие типы документов и методы: "Отгрузка при

трансграничной торговле", "Метод получения списка загруженных

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

ГИС МТ", "Метод формирования согласия на предоставление сведений

о кодах идентификации для невладельцев", "Метод аннулирования

документа на основании текущего опубликованного документа

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

наличии согласия", "Запрос информации об участнике оборота товаров

по ИНН";

В "Общие положения" добавлено примечание "ВНИМАНИЕ: При

выводе данных о нерезидентах, вместо ИНН будет возвращаться его

аналог в стране ЕАЭС";

Добавлен параметр name для типа документа "Трансформация";

Изменены параметры запроса для "Метода получения списка товаров

по заданному фильтру" (products/listV2);

Для "Перечня возможных параметров ответов методов получения

данных о кодах идентификации" добавлены параметры prVetDocument,

maxRetailPrice и brand;

Добавлен параметр запроса pg и описание ошибок в ответе для

метода "Получение подробной информации о кодах идентификации по

списку" (cises/info);

Удалён параметр error_message для метода "Получение товарных групп

по кодам товаров";

Метод "Запрос информации об участнике оборота товаров по

ИНН" перенесен в общие методы;

Для метода "Создание заявки на регистрацию участника оборота

товаров" для параметра code изменен тип с number на string и описание;

Изменены параметры ответа для метода "Проверка статуса заявки на

регистрацию участника оборота товаров по ID

заявки" (status/{documentId} );

Изменён метод "Подписание договоров";

Для "Метода получения счёта на оплату" в запрос добавлен

обязательный параметр "contractId" и добавлено описание для

параметра "amount";

Заменены gtin на код товара в описаниях;

В Справочник "Типы документов"" добавлены универсальные

документы;

В "Справочник "Статусы ответов"" добавлен код ошибки 504;

Для параметра childrenMap удалена рекурсия;

Для методов с описанием трансграничной торговли добавлено

описание "Метод доступен только операторам ЕАЭС";

06.11.2019

1.0

Начальная версия

1. Назначение и условия применения True API

1.1. Электронное взаимодействие УОТ и Оператора ГИС МТ

Взаимодействие участников оборота товаров (УОТ) и Оператора Государственной

информационной системы мониторинга за оборотом товаров (далее - ГИС МТ) осуществляется

в электронном виде. Обмен документами на бумажном носителе не предусмотрен.

Электронное взаимодействие осуществляется по одному из двух вариантов:

1. Предоставление сведений, т.е. обмен электронными документами, на основании которых

могут вноситься изменения в реестры ГИС МТ. Предоставление сведений является

обязательством участников оборота товаров.

2. Запрос сведений, т.е. обмен, при котором сведения из реестров ГИС МТ предоставляются

участниками оборота товаров в соответствии с установленными разрешениями на получение

сведений. При этом изменения в реестры не вносятся. Запрос и последующее представление

сведений из ГИС МТ инициируется участником оборота товаров по своему усмотрению и

применяется, например, для проверки статусов КИ или статуса регистрации участника

оборота товаров.

Электронное взаимодействие осуществляется путём обмена электронными документами в

соответствии с определённым порядком. Для юридически значимых электронных документов

применяется усиленная квалифицированная электронная подпись (УКЭП). Электронное

взаимодействие осуществляется с применением программных интерфейсов взаимодействия

(API) ГИС МТ и информационных систем участника оборота товаров.

При взаимодействии через API выполняются следующие требования:

1. Аутентификация и авторизация участника оборота товаров (определение полномочий на

осуществление электронного взаимодействия) осуществляется при помощи УКЭП.

2. При предоставлении и запросе сведений защита передаваемых данных выполняется

TLS/HTTPS (ГОСТ 28147-89) шифрованием канала передачи данных в адрес Оператора ГИС

МТ сертифицированными РФ СКЗИ (ГОСТ Р 34.10-2012).

3. Количество запросов в секунду не должно превышать 50 от одного участника оборота

товаров. В случае невыполнения данного требования участник оборота товаров может быть

заблокирован.

Информация о стендах

Базовые адреса демонстрационного контура:

• https://markirovka.sandbox.crpt.tech/api/v3/true-api;

• https://markirovka.sandbox.crpt.tech/api/v4/true-api.

Базовые адреса промышленного контура:

• https://markirovka.crpt.ru/api/v3/true-api;

• https://markirovka.crpt.ru/api/v4/true-api.

При указании запросов обратить внимание на следующее:

• в некоторых запросах рекомендуется указывать товарную группу (см. "Справочник "Список

поддерживаемых товарных групп"");

• новые методы могут быть реализованы с указанием версии, которая отличается от "v3"

(версии 3), первоначально указываемой в документации API. В таком случае в URL стендов

необходимо произвести замену версии на новую. Старая версия поддерживается в течение

полугода для сохранения обратной совместимости.

Информация об ошибках при запросах API методов имеет следующий формат:

(подробнее: см. "Справочник "Статусы ответов"")

Status code: 400

{

"error_message": "<текст сообщения об ошибке>"

}

Status code: 401

Информация об ошибке возвращается в формате * .xml.

Методы Национального каталога возвращают сообщения об ошибках, которые могут быть как в

* .xml, так и в * .json форматах в зависимости от выбранного формата запроса.

Информация о вложенности параметров

Вложенные параметры помечены "*".

Пример вложенности:

Параметр

Описание

results:

agentInn

*children:

**brand

Читать как: параметр "results" содержит параметры "agentInn" и "children", а "children" содержит

параметр "brand".

Информация о кодах стран:

Коды стран представлены в соответствии с ISO 3166.

ВНИМАНИЕ: при выводе данных о нерезидентах, вместо ИНН будет возвращаться его аналог в

стране ЕАЭС.

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

Файл обмена должен подписываться УКЭП лица, имеющего право действовать от имени УОТ, и

соответствовать следующим требованиям:

1. Файл формата JSON:

◦ для обмена с ГИС МТ используется json стандарта RFC 7159 (https://tools.ietf.org/html/

rfc7159);

◦ использует кодировку UTF-8;

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

конкретного товара.

2. Файл обмена формата CSV:

◦ соответствует стандарту RFC 4180;

◦ использует кодировку UTF-8;

◦ содержит символ "," в контенте файла в качестве разделителя;

◦ в документе формата * .csv не поддерживается передача древовидной структуры агрегата.

Если в документе указать на одном уровне код агрегата и коды вложений, документ будет

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

иерархической структуре в формате * .csv невозможно.

3. Файл обмена формата XML:

◦ xml формат описан в xsd схемах. Актуальные xsd схемы можно найти в разделе "Помощь"

в Личном кабинете ГИС МТ;

◦ содержит единственный экземпляр электронного документа;

◦ использует кодировку UTF-8;

◦ содержит первую строку вида <?xml version="1.0" encoding="utf-8"?>;

◦ определяет стандартные типы данных в соответствии со стандартом ISO (см. описание

стандарта ISO https://www.w3schools.com/xml/schema_dtypes_date.asp );

◦ проверяется на корректность на основании XSD-схемы - логической модели для обмена

информацией, описывающей логические элементы и атрибуты XML-файлов.

ВНИМАНИЕ: В примерах сurl запросы выполнены и проверены на UNIX системах, в других

операционных системах, экранирование отдельных символов может отличаться

Максимальный размер документа, передаваемого по API, не должен превышать 30 мегабайт.

Максимальное количество КМ в одном загружаемом документе по API не рекомендуется

превышать 30 000 КИ (подробнее см. "SLA по обработке документов ГИС МТ"). По данной

рекомендации документ может не загрузиться, если, например, в одном загружаемом документе

указаны 30 000 КИТУ.

1.3. Экранирование

Экранирование - замена в тексте управляющих символов на соответствующие текстовые

подстановки. Экранирование используется для отделения текста от кода и управляющих

символов. Экранирование применяется при передаче параметров запросов API методов согласно

следующим стандартам:

• при передаче параметров в едином указателе ресурса (Uniform Resource Locator, URL), т.е. в

URL запроса, должно применяться экранирование согласно стандарту RFC 3986 (см.

описание стандарта в п. 2.1 https://www.protocols.ru/WP/rfc3986/ );

• при передаче параметров в JSON-строке тела запроса URL должно применяться

экранирование согласно стандарту RFC

8259 (см. описание стандарта в п.

https://www.protocols.ru/WP/rfc8259/ );

• при загрузке сведения в ГИС МТ посредством файла формата CSV с использованием в

загружаемом файле КИ со специальными символами необходимо всю строку КИ

экранировать двойными кавычками (");

• при передаче параметров в XML-строке тела запроса URL должно применяться

экранирование согласно стандарту W3C (см. описание стандарта в https://www.w3.org/TR/

xml/).

Пример:

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

0104650117240408211dmfcZNcM"4=>

0104650117240408211dmfcZNcM\"4

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

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

./cises/aggregated/list?codes=0104650117240408211dmfcZNcM%224

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

"010481097886269421""LLRY<%"JZTVZ"

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

<cis>0104650117240408211dmfcZNcM<4</cis>

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

Методы True API преимущественно возвращают ответы в формате JSON, т.е. MIME-type

application/json. Некоторые методы в корректном ответе возвращают двоичное содержимое

(например, документы в ZIP) MIME-type application/zip или application/octet-stream, а в случае

ошибки - описание этой самой ошибки в JSON. Таким образом, один и тот же метод в

зависимости от ситуации может вернуть разные типы содержимого (контента).

Для корректной работы методов True API параметр Accept заголовка запроса должен быть

установлен так, чтобы учитывались все возможные ответы сервера, т.е. и application/zip, и

application/json. Самый простой вариант - использовать универсальный шаблон:

Accept: /

Для ограничения набора возвращаемых типов контента можно указывать несколько заголовков

запроса методов True API:

Accept: application/octet-stream

Accept: application/json

Если в перечне заголовков запроса методов True API не окажется ни одного подходящего под

сгенерированный сервером ответ, то True API вернется ответ c кодом = 406 (Not Acceptable) с

пустым телом ответа.

1.5. Единая аутентификация

Для работы с интерфейсом True API необходимо зарегистрироваться в ЛК ГИС:

https://markirovka.crpt.ru/ - необходимо иметь ЛК с подключенной товарной группой, по которой

планируется передача сведений по КИ.

После успешной аутентификации пользователь сможет работать с методами API и оперировать

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

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

Метод используется для получения аутентификационного токена по УКЭП:

1. получение пары "uuid - data", где "uuid" - идентификатор текущей аутентификации, data -

строка на подпись пользователю;

2. отправка в ГИС МТ данных в том же виде, в котором данные были получены (пара "uuid -

data"), только теперь "data" - это подписанная УКЭП строка;

3. сервер отвечает на запрос сообщением с кодом 200 (ОК) и возвращает токен, либо

сообщением об ошибке.

URL: /auth/key

Метод: GET

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

curl -X GET "<url стенда v3>/auth/key"

-H "accept: application/json"

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

Параметр

Тип

Обяз.

Описание

uuid

string

Уникальный идентификатор сгенерированных

случайных данных

data

string

Случайная строка данных

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

{

"uuid":"a63ff582-b723-4da7-958b-453da27a6c62",

"data":"GNUFBAZBMPIUUMLXNMIOGSHTGFXZMT"

}

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

URL: /auth/simpleSignIn

Метод: POST

Content-Type: application/json

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

curl -X POST "<url стенда v3>/auth/simpleSignIn"

-H "accept: application/json"

-H "Content-Type: application/json"

{

"uuid":"string",

"data":"string"

}

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

Параметр

Тип

Обяз.

Описание

uuid

string

Уникальный идентификатор подписанных случайных

данных

data

string

Подписанные УКЭП зарегистрированного УОТ

случайные данные в base64 (присоединённая ЭП)

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

Параметр

Тип

Обяз.

Описание

Комментарий

token

string

Аутентификацион

Параметр указывается в случае успешного

ный токен

ответа

code

string

Код ошибки

Параметр указывается в случае не

успешного ответа

error_messag

string

Сообщение об

ошибке

description

string

Описание ошибки

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

аутентификации. Срок действия полученного токена не более 10 часов с момента получения.

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

1.В случае успеха:

{

"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e

mk6qe0lB12w9zEs"

}

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

2.1 Код 401:

{

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

}

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

{

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

}

1.6. Типы приватности методов True API в зависимости от

аутентификационного токена

Существуют следующие типы приватности методов в зависимости от используемого

аутентификационного токена:

1. приватный - только для владельца КИ либо для автора запроса;

2. производитель продукции;

3. покупатель продукции (оптовик, розница);

4. Оператор;

5. ФОИВ;

6. администратор;

7. публичный - для всех пользователей с токеном;

8. без токена - для всех пользователей без токена.

Для методов с типами приватности №1-7 обязательно наличие аутентификационного токена (см.

"Единая аутентификация" и "Приложение 2. Примеры аутентификации по УКЭП / Подписание

документов").

2. Рекомендации по работе с методами True API

При использовании приватных методов True API обязательно наличие аутентификационного

токена (см. разделы "Единая аутентификация" и "Приложение 2. Примеры аутентификации по

УКЭП / Подписание документов").

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

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

URL: /elk/registration

Метод: POST

Подробное описание метода см. в разделе "Метод создания заявки на регистрацию участника

оборота товаров".

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

URL: /elk/documents/status/{documentId}

Метод: GET

Подробное описание метода см. в разделе "Метод проверки статуса заявки УОТ на регистрацию

по ID заявки".

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

URL: /elk/crm-api/documents

Метод: GET

Подробное описание метода см. в разделе "Получение сведений по черновикам заключённых

договоров между УОТ и Оператором ГИС МТ". После обработки заявки на регистрацию для

начала работы с товарными группами, указанными в заявке на регистрацию, УОТ должен

подписать соответствующие договора. Если запрос успешно обработан, в ответ вернётся

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

Все договора, которые УОТ заключает с ГИС МТ в рамках маркировки товаров, являются

исходящими от УОТ и должны быть подписаны.

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

URL: /elk/crm-api/document?guid={id}

Метод: GET

Подробное описание метода см. в разделе "Получение сведений по заключённым договорам

между УОТ и ГИС МТ".

Наименование для файла договора необходимо брать из поля "Content-Disposition" после

"filename="UTF-8"" заголовка ответа метода. Имя файла необходимо декодировать.

Пример:

Content-Disposition: attachment; filename=" _00691_20.pdf"; filename*=UTF-

8''%D0%9C%D0%9F_00691_20.pdf

%D0%9C%D0%9F_00691_20.pdf -> МП_00691_20.pdf

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

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

URL: /elk/outgoing-documents/{id}/signature

Метод: POST

Подробное описание метода см. в разделе "Подписание договоров".

УОТ должен подписать загруженный договор УКЭП. Шаги 4 и 5 необходимо повторить для всех

договоров, информация о которых возвращается на шаге 3. В случае обработки договоров со

стороны Оператора, которые были подписаны УОТ, при вызове метода на шаге 3, в поле "status"

у договоров будет возвращаться код "2" ("Оформлен\Подписан"). Статусы документов в системе

ЭДО, соответственно, будут следующими:

• "2 - Доставлен (подпись не требуется)" для документов, у которых "signtype" - 2;

• "4 - Подписан" для документов, у которых "signtype" - 1.

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

URL: /elk/outgoing-documents/{edoDocumentId}

Метод: GET

Подробное описание метода см. в разделе "Метод получения ZIP-архива документа ЭДО с

подписями и квитанциями из ЭДО Lite".

Данный метод используется при необходимости получения ZIP архива подписанных входящих

либо исходящих документов ЭДО и подписанными квитанциями обмена. После регистрации

УОТ использует API СУЗ для создания заказа на эмиссию кодов маркировки (далее - КМ).

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

Агрегирование представляет собой объединение в транспортную упаковку товаров первого

уровня либо транспортных упаковок первого уровня в транспортную упаковку последующего

уровня с сохранением информации о взаимосвязи КИ каждого вложенного товара,

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

и нанесением соответствующего КИТУ на создаваемую в результате объединения транспортную

упаковку для обеспечения прослеживаемости движения товаров по товаропроводящей цепи без

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

2.2.1. Шаг 1: получение информации о статусе КИ

Для получения информации о статусе КИ используется "Метод получения общедоступной

информации о КИ по списку" (/cises/info).

Агрегация осуществляется до или после ввода товара в оборот, при этом КИ должны быть в

статусе "APPLIED" или "INTRODUCED" (См. Справочник "Статусы КИ").

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

документов"

Тип документа «Агрегация» используется для подачи сведений в ГИС МТ при агрегации

готовых товаров. Для подачи сведений необходимо тело документа в формате * .json заполнить

значениями параметров в соответствии с описанием в таблице (см. "Единый метод создания

документов"). Параметр «product_document» должен быть заполнен телом документа

«Агрегация» со всеми указанными параметрами, закодированным в base64. Далее тело

незакодированного документа в формате * .json требуется подписать откреплённой УКЭП в

кодировке base64 и заполнить полученным значением параметр «signature». В случае успеха в

ответе возвращается уникальный идентификатор документа. В случае успеха в ответе

возвращается уникальный идентификатор документа.

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

Для проверки информации о сформированном документе "Агрегация" используется "Метод

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

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

"Метод получения общедоступной информации о КИ по списку" (/cises/info) возвращает

информацию о КИ агрегата и вложений с выводом в ответе дополнительных параметров.

Метод "Запрос списка агрегированных КИ (GET)"

(/cises/aggregated/list) возвращает

информацию о вложенных КИ без вывода в ответе дополнительных параметров. Если в ответе в

значении параметра "parent" указан идентификатор созданного агрегата, то агрегат успешно

сформирован. КИ агрегата возвращается в ответе в том случае, если верхнеуровневый агрегат не

расформирован. Для КИ агрегата, указанного в параметре "child", возвращается массив

вложенных КИ.

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

Тип документа "Ввод в оборот" используется для подачи сведений в ГИС МТ при вводе в оборот

готовых товаров. Для подачи сведений необходимо тело документа в формате JSON "Единого

метода создания документов" заполнить значениями параметров в соответствии с описанием в

таблице (см. "Единый метод создания документов"). Параметр "product_document" должен быть

телом документа "Ввод в оборот" со всеми указанными параметрами, закодированным в Base64.

Далее тело незакодированного документа в формате JSON требуется подписать открепленной

УКЭП в кодировке Base64 и заполнить полученным значением параметр "signature".

Сформированную УКЭП необходимо открыть в любом доступном текстовом редакторе и

удалить символы переноса строк.

В случае успеха в ответе приходит уникальный идентификатор документа.

Выбор способа ввода в оборот осуществляется по типу эмиссии КИ (см."Ввод в оборот").

Например: если тип эмиссии КИ = LOCAL (производство в РФ), то подача сведений в ГИС МТ

осуществляется с использованием типа документа "Ввод в оборот. Производство РФ", "Ввод в

оборот. Полученных от физических лиц" или "Ввод в оборот. Контрактное производство РФ".

Для участников оборота товаров, использующих контрактное производство за пределами РФ,

параметр «product_document» «Единого метода создания документов» заполняется телом

документа "Ввод в оборот. Импорт с ФТС" или "Ввод в оборот. На территории стран ЕАЭС

(контрактное производство)" в зависимости от товарной группы.

Для участников оборота товарной группы «Молочная продукция», использующих контрактное

производство, доступны только типы документов "Ввод в оборот. Трансграничная торговля" и

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

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

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

Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания

документов" заполнить значениями параметров в соответствии с описанием в таблице (см.

"Единый метод создания документов"). Параметр "product_document" должен быть телом

документа "Отгрузка" со всеми указанными параметрами, закодированным в Base64. Далее тело

незакодированного документа в формате JSON требуется подписать открепленной УКЭП в

кодировке Base64 и заполнить полученным значением параметр "signature". Сформированную

УКЭП необходимо открыть в любом доступном текстовом редакторе и удалить символы

переноса строк.

В случае успеха в ответе приходит уникальный идентификатор документа.

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

2.3.2.1. Шаг 1: получение сведений о новых документах, загруженных в ГИС МТ

Для получения сведений о новых документах типа "Приёмка" используется "Метод получения

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

Параметр "inputFormat" для УОТ, осуществляющего приёмку, принимает значение "true" -

"входящий". Параметр "documentType" может принимать значения LP_SHIP_GOODS,

LP_SHIP_GOODS_CSV, LP_SHIP_GOODS_XML (см."Справочник "Типы документов"" и тип

документа "Отгрузка"). Так как документ на отгрузку может быть подан в любом из

перечисленных форматов, рекомендуется выполнять запрос поочередно с каждым из

перечисленных значений. В ответе на запрос сведений о документе "Приёмка" выводится

параметр "doc_Id" (идентификатор документа).

2.3.2.2. Шаг 2: получение сведений о содержимом документа по идентификатору

Для получения информации о содержимом агрегатов в документе "Приёмка" используется

"Метод получения содержимого документа по идентификатору", параметром запроса в котором

является идентификатор документа, полученный в шаге 1.

2.3.2.3. Шаг 3: подача сведений о приёмке

Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания

документов" заполнить значениями параметров в соответствии с описанием в таблице (см.

"Единый метод создания документов"). Параметр "product_document" должен быть телом

документа "Приёмка" со всеми указанными параметрами, закодированным в Base64. Далее тело

незакодированного документа в формате JSON требуется подписать открепленной УКЭП в

кодировке Base64 и заполнить полученным значением параметр "signature". Сформированную

УКЭП необходимо открыть в любом доступном текстовом редакторе и удалить символы

переноса строк.

В случае успеха в ответе приходит уникальный идентификатор документа.

2.3.2.4. Шаг 4: просмотр статуса отправленного документа "Приёмка"

Уникальный идентификатор документа, полученный на этапе "Шаг 3: подача сведений о

приёмке", указывается в запросе "Метод получения содержимого документа по идентификатору"

для получения информации о статусе документа "Приёмка", поданного в ГИС МТ. В случае

успеха параметр "status" в ответе примет значение "CHECKED_OK".

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

Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания

документов" заполнить значениями параметров в соответствии с описанием в таблице (см.

"Единый метод создания документов"). Параметр "product_document" должен быть телом

документа "Вывод из оборота" со всеми указанными параметрами, закодированным в Base64.

Далее тело незакодированного документа в формате JSON требуется подписать открепленной

УКЭП в кодировке Base64 и заполнить полученным значением параметр "signature".

Сформированную УКЭП необходимо открыть в любом доступном текстовом редакторе и

удалить символы переноса строк.

В случае успеха в ответе приходит уникальный идентификатор документа.

После вывода из оборота товара статус КИ меняет тип на RETIRED (Выведен из оборота) или

WRITTEN_OFF ("Списан") (см."Справочник "Статусы КИ"").

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

Для подачи сведений необходимо тело документа в формате JSON "Единого метода создания

документов" заполнить значениями параметров в соответствии с описанием в таблице (см.

"Единый метод создания документов"). Параметр "product_document" должен быть телом

документа "Возврат в оборот" со всеми указанными параметрами, закодированным в Base64.

Далее тело незакодированного документа в формате JSON требуется подписать открепленной

УКЭП в кодировке Base64 и заполнить полученным значением параметр "signature".

Сформированную УКЭП необходимо открыть в любом доступном текстовом редакторе и

удалить символы переноса строк.

В случае успеха в ответе приходит уникальный идентификатор документа.

После возврата товара в оборот КИ меняет тип на - "INTRODUCED" - Введен в оборот" -

(см."Справочник "Статусы КИ"").

3. Обращение к True API

3.1. Регистрация участника оборота товаров

3.1.1. Метод создания заявки на регистрацию участника оборота товаров

Для создания заявки на регистрацию участника оборота товаров необходимы данные

сертификата участника оборота товаров, а также значения параметров "e-mail (адрес

электронной почты участника оборота товаров)" и "Телефон (контактный телефон участника

оборота товаров)". При этом должность руководителя организации участника оборота товаров

должна быть указана в сертификате, и её значение должно совпадать со значением указанного

параметра в ЕГРЮЛ.

Партнёр, который помог сформировать и отправить участнику оборота товаров заявку на

регистрацию в ГИС МТ, направляет в REST API заявку на регистрацию, подписанную будущим

участником оборота товаров.

Запрос осуществляется только при наличии JWT-токена.

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

требуется выполнить следующие действия:

Сгенерировать две пары ключей (одна пара для интеграционного стенда, вторая - для

промышленного) с помощью следующих команд:

◦ openssl genrsa -out private.pem 1024

◦ openssl rsa -inprivate.pem -outform PEM -pubout -out public.pem

Отправить письмо на адрес support@crpt.ru с темой "Файлы открытых ключей для метода

создания заявки на регистрацию участника оборота товаров", где предоставить следующую

информацию:

◦ ИНН;

◦ полное наименование организации;

◦ веб-сайт организации;

◦ файлы открытых ключей для добавления в список Партнёров на соответствующие

стенды:

▪ public_int.pem (для интеграционного стенда)

▪ public_prod.pem (для промышленного стенда)

Перед добавлением открытого ключа выполнить проверку открытого ключа (открытый ключ

должен быть 1024) с помощью команды:

◦ $openssl rsa -inform PEM -pubin -in 6663003127.pem -text

◦ Public-Key: (1024 bit)

Сгенерировать токен в соответствии с JWT RFC-7519, используя алгоритм RS512. При этом

токен должен удовлетворять следующим требованиям:

1. Токен должен состоять из трёх частей:

▪ заголовок;

▪ тело;

▪ подпись.

2. Заголовок и тело токена должны содержать * .json, закодированный в BASE64.

3. Подпись токена в формате BASE64 должна содержать подпись, полученную при

подписании тела токена с применением закрытого ключа Партнёра.

4. Токен должен содержать следующие параметры:

Параметр

Тип

Обяз.

Описание

Пример

alg

string

Алгоритм RS512

"RS512"

inn

string

ИНН Партнёра

"1234567890"

full_name

string

Полное

"Общество с ограниченной

наименование

ответственностью"

организации

Партнёра

Параметр

Тип

Обяз.

Описание

Пример

date

Long

Дата создания

1546342656 (01.01.2019 11:37:36

токена в

GMT)

секундах

[signature]

string

Подпись

e. Тело токена может содержать дополнительные поля, но они будут игнорироваться ГИС

МТ.

f. Пример состава токена:

{

"alg":"RS512"

}{

"inn":"1234567890",

"full_name":"Общество с ограниченной ответственностью",

"date":1546342656

}[

"signature"

]

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

6. Токен считается валидным, если для него выполняются следующие условия:

◦ подпись токена успешно проверена при помощи открытого ключа Партнёра. Открытый

ключ каждого Партнёра должен быть заранее предоставлен Оператору системы для

настройки авторизации Оператора Партнёра на сервере ГИС МТ;

◦ данные, полученные из подписи токена, соответствуют телу токена (тот же состав полей

+ inn из токена должен быть равен inn из запроса);

◦ дата создания токена валидна, то есть она меньше текущей даты сервера (UTC 0) в

момент запроса и не старше, чем установленное время жизни токена.

Тип приватности: публичный

URL: /elk/registration

Метод: POST

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

curl -X POST "<url стенда>/elk/registration"

-H "accept: application/json"

-H "Content-Type: application/json"

-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

document_format

string

Код формата

Возможные значения:

данных с

параметрами

"MANUAL" (документ формата

.json);

сертификата

участника

"XML" (документ формата * .xml)

оборота товаров

product_document

string

Закодированная в

Кодируемый * .json должен быть в

base64 заявка на

кодировке utf-8

добавление

организации

signature

string

Откреплённая

УКЭП в

кодировке base64

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

Параметр

Тип

Обяз

Описание

Комментарий

organisation

object

Параметры

организации

*inn

string

ИНН организации

При подаче заявки на регистрацию

участника

оборота

товаров

проверяется,

что

ИНН

из

загруженной УКЭП равен ИНН

данной организации в следующем

реестре:

ЕГРЮЛ (Единый государственный

реестр юридических лиц) для ЮЛ

РФ;

ЕГРИП (Единый государственный

реестр

индивидуальных

предпринимателей) для ИП;

РАФП (Реестр аккредитованных

филиалов,

представительств

иностранных юридических лиц)

для ЮЛ не из РФ

Параметр

Тип

Обяз

Описание

Комментарий

*ogrn

string

ОГРН/ОГРНИП

Значением данного параметра

является

основной

государственный регистрационный

номер,

который

должен

удовлетворять

следующим

требованиям:

Для ЮЛ:

длина значения параметра

знаков, обязательно к заполнению;

Для ИП:

длина значения параметра

знаков,

необязательно

заполнению

*organisation_nam

string

Наименование

При подаче заявки на регистрацию

организации

участника

оборота

товаров

участника оборота

осуществляется проверка, что

товаров либо ИП

наименование организации из

Ф.И.О.

загруженной УКЭП соответствует

наименованию данной организации

в следующем реестре:

ЕГРЮЛ (Единый государственный

реестр юридических лиц) для ЮЛ

РФ;

ЕГРИП (Единый государственный

реестр

индивидуальных

предпринимателей) для ИП

*email

string

E-mail

Значением данного параметра

является адрес электронной почты

участника оборота товаров, на

который будет осуществляться

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

Значение

данного

параметра

должно быть уникально в ГИС МТ,

т.е. не допускается указание одного

и того же адреса электронной

почты для регистрации различных

участников оборота товаров

*ifns

string

Код ИФНС

Значение данного параметра

длиной 4 знака берётся из сведений

о налоговом органе, в котором

участник оборота товаров числится

на учёте

Параметр

Тип

Обяз

Описание

Комментарий

*phone

string

Контактный номер

Значением данного параметра

участника оборота

является номер телефон участника

товаров

оборота товаров

*kpp

string

КПП

Значением данного параметра

длиной

9 знаков является код

причины постановки участника

оборота товаров на учёт. Данный

параметр для ИП не заполняется

*address

string

Адрес

Значением данного параметра

является юридический адрес

регистрации организации,

например, "125362, МОКВА Г,

СВОБОДЫ УЛ, ДОМ 17, ПОДВАЛ

ПОМЕЩЕНИЕ I - КОМНАТА 5"

*gs1_list

array

Список пар номеров

GCP+GLN

**gcp

number(

Номер GCP

Значением данного параметра

является глобальный префикс

предприятия

GCP (Global

Company Prefix) - международный

регистрационный

номер

предприятия в системе GS1.

Параметр является обязательным,

если указан параметр "gs1_list".

Значение

данного

параметра

запрашивается в каталоге GS46

(если участник оборота товаров не

является членом ассоциации GS1,

то в Национальном Каталоге в

разделе "Профиль" предусмотрена

возможность подачи "Заявления на

вступление в ассоциацию")

Параметр

Тип

Обяз

Описание

Комментарий

**glns

number(

Номер GLN

Значением данного параметра

13)

является

глобальный

идентификационный номер

• GLN (Global Location Number),

т.е.

цифровой

код,

предназначенный

для

идентификации предприятий,

функциональных

подразделений,

физических

местоположений

- в системе

GS1.

Параметр является обязательным,

если указан параметр "gs1_list".

Значение

данного

параметра

запрашивается в каталоге GS46

(если участник оборота товаров не

является членом ассоциации GS1,

то в Национальном Каталоге в

разделе "Профиль" предусмотрена

возможность подачи "Заявления на

вступление в ассоциацию")

product_group

array

Список товарных

групп участника

оборота товаров

*code

string

Код товарной

См. Справочник "Список

группы участника

поддерживаемых товарных групп"

оборота товаров

*types

array[stri

Тип участника для

Варианты значений:

ng]

товарной группы

"PRODUCER" ("Производитель");

"IMPORTER" ("Импортёр товара");

"WHOLESALER"

("Оптовая

торговля");

"RETAIL" ("Розничная торговля")

user

object

Пользователь

*finger_print

string

Отпечаток

Пример значения данного

сертификата УКЭП

параметра:

dd5c1ba2e7bb1a260e69797d0f45110

93ca0d3b5

Параметр

Тип

Обяз

Описание

Комментарий

*last_name

string

Фамилия

При подаче заявки на регистрацию

участника

оборота

товаров

осуществляется

проверка: значения

параметров

"<Фамилия> <Имя и Отчество>" из

загруженной УКЭП

= Ф.И.О. в

следующем реестре:

ЕГРЮЛ (Единый государственный

реестр юридических лиц) для ЮЛ

РФ;

ЕГРИП (Единый государственный

реестр

индивидуальных

предпринимателей) для ИП;

РАФП (Реестр аккредитованных

филиалов,

представительств

иностранных юридических лиц)

для ЮЛ не из РФ

*name

string

Имя и Отчество

management_comp

object

Управляющая

Заполняется при наличии

any

компания

управляющей компании

*contract

string

Реквизиты договора

Значение параметра формата

на управление

"Договор № <number> от <date>".

Параметр является обязательным,

если указан параметр

"management_company"

*inn

string

ИНН Управляющей

Параметр является обязательным,

организации/ИП

если указан параметр

"management_company"

Параметр

Тип

Обяз

Описание

Комментарий

production_place

array

Производственные

Параметр является обязательным,

площадки

если:

• значение "code" ("Код товарной

группы участника оборота

товаров")

равно

"tobacco"

("Табачная

продукция")

значение

"types"

("Тип

участника

для

товарной

группы") равно "PRODUCER"

("Производитель");

• значение "code" ("Код товарной

группы участника оборота

товаров") равно "beer" ("Пиво,

напитки, изготавливаемые на

основе пива, слабоалкогольные

напитки") при следующих

значениях

"types"

("Тип

участника

для

товарной

группы"):

◦ для ЮЛ допустимо любое

значение;

◦ для

ИП

допустимы

значения:

"RETAIL" ("Розничная торговля"),

"WHOLESALER"

("Оптовая

торговля")

*production_group

string

Наименование

Значение является обязательным,

товарной группы

если указан параметр

для

"production_place"

производственных

("Производственные площадки").

площадок/МОД

Возможные значения:

"tobacco" ("Табачная продукция");

"beer" ("Пиво, напитки,

изготавливаемые на основе пива,

слабоалкогольные напитки")

*production_place

string

Наименование

Значение является обязательным,

_name

производственной

если указан параметр

площадки /

"production_place"

Наименование МОД

("Производственные площадки")

Параметр

Тип

Обяз

Описание

Комментарий

*production_countr

string

Код страны

Значение является обязательным,

y_numeric_code

производства

если указан параметр

"production_place"

("Производственные площадки").

Указывается код страны в

соответствии с ОКСМ (например:

"643" - "Российская Федерация")

*production_addre

string

Адрес

Значение является обязательным,

производства/Адрес

если

указан

параметр

МОД

"production_place"

("Производственные площадки") и

если:

• значение "code" ("Код товарной

группы участника оборота

товаров")

равно

"tobacco"

("Табачная

продукция")

значение

"production_country_numeric_co

de" равно "643" ("Российская

Федерация");

• значение "code" ("Код товарной

группы участника оборота

товаров") равно "beer" ("Пиво,

напитки, изготавливаемые на

основе пива, слабоалкогольные

напитки") при следующих

значениях

"types"

("Тип

участника

для

товарной

группы"):

◦ для ЮЛ допустимо любое

значение;

◦ для

ИП

допустимы

значения:

"RETAIL" ("Розничная торговля"),

"WHOLESALER"

("Оптовая

торговля")

Параметр

Тип

Обяз

Описание

Комментарий

*production_kpp

string

КПП

Значение является обязательным,

если:

• указан

параметр

"production_place"

("Производственные

площадки");

• значение "code" ("Код товарной

группы участника оборота

товаров") равно "beer" ("Пиво,

напитки, изготавливаемые на

основе пива, слабоалкогольные

напитки");

• длина "inn" составляет

знаков, т.е. ИНН принадлежит

ЮЛ

*production_lines

array[stri

Список

Значение является обязательным,

ng]

наименований

если указан параметр

производственных

"production_place"

линий

("Производственные площадки").

Параметр не указывается, если

значение "code" ("Код товарной

группы участника оборота

товаров") равно "beer" ("Пиво,

напитки, изготавливаемые на

основе пива, слабоалкогольные

напитки")

edo_operators

array

Список Операторов

Необходимо указать стороннего

ЭДО

Оператора ЭДО

*edo_operator_na

string

Наименование

Оператора ЭДО по

ЕГРЮЛ

*edo_participant_i

string

ID участника

Идентификатор участника оборота

товаров в системе ЭДО Оператора

*is_main_operator

boolean

Оператор является

Значение "true" может принимать

основным

только один Оператор ЭДО

Оператором ЭДО

для участника

оборота товаров

*edo_operator_inn

string

ИНН Оператора

ЭДО

bank_details

object

Банковские

Обязательно для всех видов

реквизиты

организаций, кроме ИП

Параметр

Тип

Обяз

Описание

Комментарий

*bic

string

БИК Банка

*account

string

Расчётный счет

*sf_required

boolean

Признак счёта-

параметре

указывается,

фактуры

необходимо ли участнику оборота

товаров

предоставлять

счёт-

фактуру на аванс.

Возможные значения:

"true" ("Организация работает по

ОСН");

"false" ("Организация не работает

по ОСН")

type

string

Тип заполняемой

Всегда = "EXTERNAL"

заявки

Пример * .json-формата параметра product_document:

{

"organisation": {

"inn": "7743000100",

"ogrn": "1037700020001",

"organisation_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ\"РОМАШКА\"",

"email": "romashka@yopmail.com",

"ifns": "7743",

"phone": "9999999999",

"kpp": "774301001",

"address": "197022, САНКТ-ПЕТЕРБУРГ ГОРОД, УЛИЦА ПРОФЕССОРА ПОПОВА, ДОМ 47, ЛИТЕРА

А, ПОМЕЩЕНИЕ 36"

"bank_details": {

"bic": "044525000",

"account": "40702810000000010002",

"sf_required": true

"product_group": [

{

"code": "shoes",

"types": [

"RETAIL",

"WHOLESALER"

]

{

"code": "shoes",

"types": [

"RETAIL",

"WHOLESALER"

]

}

"user": {

"last_name": "ИВАНОВ",

"name": "ИВАН ИВАНОВИЧ",

"finger_print": "fefb734345296b7c292923428db57b3a7876da69"

"production_place": [

"production_place_name": "Барнаул 3",

"production_group": "beer",

"production_address": "Барнаул, улица Островского, 85А",

"production_kpp": "91827332"

"edo_operators": [

{

"edo_operator_name": "ОПЕРАТОР",

"edo_participant_id": "deeb9214-aa33-4f3c-8027-3aeaf8563574",

"is_main_operator": true

}

]

}

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

Параметр

Обяз.

Тип

Описание

Комментарий

registrationRequest

number

Номер заявки на

При успешном создании в ГИС МТ

DocId

добавление

организации

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

curl -X POST "<url стенда>/elk/registration"

-H "accept: application/json"

-H "Content-Type: application/json"

-H "Authorization: Bearer <ТОКЕН>"

{

"document_format": "MANUAL",

"product_document": "<Документ JSON, закодированный в base64>",

"signature": "<Тело JSON, подписанное откреплённой УКЭП и закодированное

в base64>"

}

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

{

"registrationRequestDocId":1095

}

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

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

{}

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

{

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

`ru.crpt.lk.doc.api.dto.FileType` from string \"MANUL\": value not one

of declared Enum instance names: [UPD, CSV, XML, MANUAL]; nested

exception is com.fasterxml.jackson.databind.exc.InvalidFormatException:

Cannot deserialize value of type `ru.crpt.lk.doc.api.dto.FileType` from

string \"MANUL\": value not one of declared Enum instance names: [UPD,

CSV, XML, MANUAL]\n at [Source: (PushbackInputStream); line: 2, column:

24] (through reference chain:

ru.crpt.trueapi.dto.lp.documents.InputDocumentDto[\"document_format\"])"

}

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

Метод предназначен для получения результата обработки заявки на регистрацию УОТ в ГИС

МТ. При отправке ID заявки на регистрацию УОТ, полученного на этапе создания заявки на

регистрацию УОТ, в ответе возвращается статус регистрации заявки:

• если заявка не прошла проверку ГИС МТ (код статуса ≠ "CHECKED_OK"), то УОТ

недоступна авторизация и дальнейшие действия в ГИС МТ;

• если заявка успешно прошла проверку ГИС МТ (код статуса = "CHECKED_OK"), то УОТ

доступны дальнейшие действия в ГИС МТ.

Тип приватности: без токена.

URL: /elk/documents/status/{documentId}

Метод: GET

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

Параметр

Обяз.

Тип

Описание

documentId

number

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

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

Параметр

Обяз.

Тип

Описание

Комментарий

registrationRequest

string

Код статуса

см. "Справочник "Статусы заявки на

Status

заявки на

регистрацию УОТ""

добавление

организации

documentType

string

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

errors

string

Ошибки

*message

string

Сообщение об

ошибке

*internalError

string

Сообщение о

внутренней

ошибке

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

curl -X GET "<url стенда>/elk/documents/status/1095"

-H "accept: application/json"

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

1 В случае успеха:

{

"registrationRequestStatus":"CHECKED_OK"

}

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

2.1. Код 400:

{

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

LK_REGISTRATION"

}

3.2. Метод проверки регистрации участников оборота

товаров по ИНН в ГИС МТ

В результате успешного выполнения запроса по одному или нескольким (до 1000) ИНН

участников оборота товаров в ответе возвращается информация о запрашиваемых участниках

оборота товаров.

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

1. Публичный (данный тип приватности сохранён для обратной совместимости с предыдущими

релизами True API).

2. Без токена (в связи с расширением общедоступной информации для товарных групп:

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

краткая информация о запрашиваемом участнике.

3. С токеном: в ответе возвращается расширенная информация о запрашиваемом участнике,

если ИНН запрашивающего равен ИНН участника оборота товаров.

URL: /participants/{inn}

Метод: GET

Пример строки запроса для одного ИНН участника оборота товаров: (с токеном и без

токена: в ответе возвращается краткая информация о запрашиваемом участнике)

curl -X GET "<url стенда>/participants/0000000000"

-H "accept: application/json"

-H "Authorization: Bearer <ТОКЕН>"

URL: /participants

Метод: GET

Пример строки запроса для нескольких ИНН участников оборота товаров: (с токеном: в

ответе возвращается расширенная информация о запрашиваемом участнике)

curl -X GET "<url стенда>/participants?inns=0000000000&inns=0000000001"

-H "accept: application/json"

-H "Authorization: Bearer <ТОКЕН>"

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

товаров.

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

Параметр

Тип

Обяз.

Описание

Коммен

тарий

inn

string

Один запрашиваемый ИНН участника

При

оборота товаров

запросе

несколь

ких

ИНН

необход

имо

вместо

"inn"

("ИНН")

указыва

ть

"inns"

("Списо

ИНН")

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

1. В случае успеха:

{

"inn": "0000000000",

"status_inn": "Зарегистрирован",

"is_registered": true,

"is_kfh": true

}

Параметры базового ответа (ИНН запрашивающего не соответствует ИНН участника

оборота товаров или не указан токен аутентификации):

Параметр

Тип

Обяз.

Описание

Комментарий

inn

string

ИНН участника

оборота товаров

status

string

Текущий статус

Возможные значения:

участника

NOT_REGISTERED - Не

оборота товаров

зарегистрирован;

RESTORED - Восстановлен;

REGISTERED - Зарегистрирован;

REMOVED - Удалён;

BLOCKED - Заблокирован

Параметр

Тип

Обяз.

Описание

Комментарий

is_registered

boolean

Признак

true - текущий статус участника

регистрации в

оборота товаров в ГИС МТ

ГИС МТ

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

REGISTERED ("Зарегистрирован"),

RESTORED ("Восстановлен") и

BLOCKED ("Заблокирован");

false - в остальных случаях

is_kfh

boolean

Признак того,

true - участник оборота товаров

что участник

является крестьянским фермерским

оборота товаров

хозяйством;

является

false - в остальных случаях.

крестьянским

фермерским

Идентификация крестьянских

хозяйством

(фермерских)

хозяйств/сельскохозяйственных

производственных кооперативов

осуществляется по ОКОПФ:

15300 - крестьянские (фермерские)

хозяйства;

50101 - главы крестьянских

(фермерских) хозяйств;

14100 - сельскохозяйственные

производственные кооперативы

Пример расширенного ответа (с токеном Оператора):

2. В случае успеха:

[

{

"inn": "000000000001",

"error_code": "400",

"error_message": "ИНН некорректен"

{

"inn": "0000000002",

"name": "СПК \"X\"",

"statusInn": "NOT_REGISTERED",

"status": "Не зарегистрирован",

"okopf": "00001",

"chief": [

"string"

"role": [],

"is_registered": false,

"is_kfh": true

{

"inn": "0000000003",

Параметр

Тип

Обяз.

Описание

Комментарий

statusInn

string

Статус

См. "Справочник "Статусы УОТ""

регистрации

участника

оборота товаров

status

string

Текущий статус

Возможные значения:

участника

NOT_REGISTERED - Не

оборота товаров

зарегистрирован;

RESTORED - Восстановлен;

REGISTERED - Зарегистрирован;

REMOVED - Удалён;

BLOCKED - Заблокирован

chief

array[stri

Список Ф.И.О.

ng]

руководителей

role

array[stri

Список кодов

См. "Справочник "Типы

ng]

типов

организаций""

организации

участника

оборота товаров

is_registered

boolean

Признак

true - статус участника оборота

регистрации в

товаров в ГИС МТ равен:

ГИС МТ

"Зарегистрирован", "Восстановлен" и

"Заблокирован";

false - в остальных случаях

is_kfh

boolean

Признак -

true - участник оборота товаров

является ли

является крестьянским фермерским

участник оборота

хозяйством;

товаров

false - в остальных случаях.

крестьянским

Идентификация крестьянских

фермерским

(фермерских)

хозяйством

хозяйств/сельскохозяйственных

производственных кооперативов

осуществляется по общероссийскому

классификатору организационно-

правовых форм:

15300 - крестьянские (фермерские)

хозяйства;

50101 - главы крестьянских

(фермерских) хозяйств;

14100 - сельскохозяйственные

производственные кооперативы

okopf

string

ОКОПФ

productGroups

array[stri

Список товарных

См. "Справочник "Список

ng]

групп,

поддерживаемых товарных групп""

подключенных к

ИНН участника

оборота товаров

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

не найден":

{

"error_message":"УОТ не найден"

}

3.2 При запросе информации по нескольким ИНН и некорректности хотя бы одного из них

возвращается ответ с кодом ошибки 400 "ИНН некорректен (один или более)":

{

"error_message":"ИНН некорректен (один или более)"

}

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

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

Оператором ГИС МТ

В результате выполнения запроса возвращаются метаданные договоров между УОТ и ГИС МТ.

Идентификатор УОТ (ParticipantId) берётся из токена.

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

URL: /elk/crm-api/documents

Метод: GET

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

Параметр

Тип

Обяз.

Описание

Комментарий

status

string

Код статуса

Cм. "Справочник "Статусы ответов""

обработки

запроса

response

array

Список договоров

При наличии договора в ГИС МТ

*guid

number

ID черновика

договора

*lcstage

number

Статус документа

См. "Справочник "Статусы

в жизненном

документа в жизненном цикле SD""

цикле SD

*inn

number

Порядковый

номер из

идентификатора

*createtime

string

Дата и время

создания договора

в CRM/SD

Параметр

Тип

Обяз.

Описание

Комментарий

*fileSize

number

Размер файла

договора в байтах

*document

number

ID документа

*name

string

Наименование

файла договора

без расширения

*signdate

string

Дата подписания

yyyy-MM-ddTHH:mm:ss.SSS’Z

(date-

договора

time)

*fileName

string

Наименование

файла договора с

расширением

*position

string

Наименование

должности

руководителя

организации УОТ

*fullname

string

Ф.И.О.

руководителя

организации УОТ

*edoStatus

number

Статус договора в

см. "Справочник "Статусная модель""

ЭДО

Данное поле возвращается только

после подписания документа со

стороны УОТ

*edoDocumentId

string

ID договора в

Данное поле возвращается только

ЭДО

после подписания документа со

стороны УОТ

*docid

string

ID документа

формата

"<name>/<год

создания>"

*link

array

Список команд

заголовка запроса

*href

string

URL получения

документа по guid

*action

string

Метод запроса

*types

string

Тип контента

*status

number

Статус

Возможны следующие статусы:

заключения

0 - на проверке/обрабатывается;

документа

1 - ожидает подписания со стороны

УОТ;

2 - оформлен/подписан (зависит от

signtype).

Параметр

Тип

Обяз.

Описание

Комментарий

*doctype

number

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

см. "Справочник "Типы договоров""

*signtype

number

Тип подписи

Возможны следующие статусы:

документа

1 - требует подписания обеих сторон,

2 - требует подписания только со

стороны УОТ,

3 - требует подписания только со

стороны Оператора-ЦРПТ,

4 - подписание не требуется.

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

curl -X GET "<url стенда>/elk/crm-api/documents"

-H "accept: application/json"

-H "Authorization: Bearer <ТОКЕН>"

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

1 В случае успеха:

{

"status": "200",

"response": [

{

"guid": 215,

"lcstage": 40,

"inn": 23499,

"createtime": "2019-07-09T19:53:37.835+03:00",

"fileSize": 46406,

"document": 220,

"name": "РЭ_Т_00026_19",

"fileName": "РЭ_Т_00026_19.pdf",

"position": "Владыкич",

"fullname": "Колдамасова Светлана Николаевна",

"edoDocumentId": "5b7f19e8-db96-463a-9735-2ef1a73abf9b",

"docid": "РЭ_Т_00026/19",

"link":

"{'href':'https://sdtest.crpt.ru/rest/1.0/sdcrpt/rpc/document?guid=220'}",

"action": "GET",

"types": [

"text/xml",

"application/json"

]

{

"status": 1,

"doctype":-11,

"signtype" : 2

{

"guid": 214,

"lcstage": 40,

"inn": 23499,

"createtime": "2019-07-09T19:53:37.799+03:00",

"fileSize": 46119,

"document": 219,

"name": "КМ_Т_00134_19",

"fileName": "КМ_Т_00134_19.pdf",

"position": "Владыкич",

"fullname": "Колдамасова Светлана Николаевна",

"edoDocumentId": "t2yu19e8-db96-463a-9735-2ef1a73akli8y",

"docid": "КМ_Т_00134/19",

"link":

"{'href':'https://sdtest.crpt.ru/rest/1.0/sdcrpt/rpc/document?guid=219'}",

"action": "GET",

"types": [

"text/xml",

"application/json"

]

{

"status":

"doctype" : -4,

"signtype": 1

}

]

}

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

2.1. Код 401 В случае, если не указан токен:

<error>unauthorized</error>

<error_description>Full authentication is required to access this

resource</error_description>

</UnauthorizedException>

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

В результате выполнения запроса возвращаются метаданные договоров между УОТ и ГИС МТ.

Идентификатор УОТ (ParticipantId) берётся из токена.

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

URL: /elk/crm-api/document

Метод: GET

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

curl -X GET "<url стенда>/elk/crm-api/document?guid=8725"

-H "accept: */*"

-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

guid

number

ID черновика

Значение параметра "document" ("ID

договора

документа") в ответе метода

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

заключённых договоров между УОТ

и Оператором ГИС МТ" (elk/crm-

api/documents)

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

1. В случае успеха:

"string"

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

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

В ответ придут номера договоров.

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

2.1. Код 401 В случае, если не указан токен:

<error>unauthorized</error>

<error_description>Full authentication is required to access this

resource</error_description>

</UnauthorizedException>

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

Метод предназначен для подписания УОТ договоров с ГИС МТ с помощью УКЭП.

В результате передачи в запросе ЭП к договору с указываемым идентификатором на выходе

возвращается статус обработки запроса и информация об ошибке (при её наличии).

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

URL: /elk/outgoing-documents/{documentId}/signature

Метод: POST

Content-Type: text/plain

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

Параметр

Тип

Обяз.

Описание

documentId

string

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

оператора. Можно найти по методу

/elk/crm-api/documents в ответе которого

будет нужный параметр "document" ("ID

документа")

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

curl -X POST "<url стенда>/elk/outgoing-documents/4958/signature"

-H "accept: application/json"

-H "Content-Type: text/plain"

-H "Authorization: Bearer <ТОКЕН>"

--data-raw 'signature'

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

Параметр

Тип

Обяз.

Описание

signature

string

Открепленная подпись под

документом в base64

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

1. В случае успеха:

{

"id":"string"

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

id документа по

ЭДО Лайт

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

2.1. Код 401 В случае, если не указан токен (ответ удаленной системы):

<error>unauthorized</error>

<error_description>Full authentication is required to access this

resource</error_description>

</UnauthorizedException>

2.2. Код 401 В случае, если не указан токен (ответ True API):

{

"error_message":"Для доступа к этому ресурсу требуется полная

аутентификация"

}

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

Метод предназначен для получения информации о статусе заключения всех договоров между

ГИС МТ и УОТ.

В результате передачи в токене запроса идентификатора УОТ (ParticipantId) возвращается массив

статусов обработки договоров УОТ.

Существуют следующие статусы:

• общий статус УОТ в backend ЕЛК (зависит от статусов заключения всех договоров УОТ с

ГИС МТ);

• расширенный статус договоров (зависит от результата заключения данного договора с ГИС

МТ).

Если подписана только часть договоров, то УОТ не может быть полностью активен в ГИС МТ

(общий статус УОТ не валиден в Системе).

Если требуется подписание договора со стороны УОТ, то статус входящего документа =

"Черновик".

Если требуется подписание договора со стороны Оператора, то статус входящего документа =

"Доставлен (ожидается подпись)", статус исходящего документа = "Требуется подпись".

Если обе стороны подписали документ, то статус входящего и исходящего документа =

"Подписан".

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

URL:

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

URL

Для исходящих документов

/elk/outgoing-documents

Для входящих документов

/elk/incoming-documents

Метод: GET

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

Параметр

Тип

Обяз.

Описание

Комментарий

limit

string

Количество

Значение по умолчанию = 10

возвращаемых

документов

offset

string

Смещение

Значение по умолчанию = 0

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

Параметр

Тип

Обяз.

Описание

Комментарий

count

number

Число

возвращённых

документов

items

array

Список договоров

При наличии договора в ГИС МТ

с ГИС МТ

*id

string

Идентификатор

документа в

системе ЭДО

оператора

*status

number

Статус

см. "Справочник "Статусная модель""

заключения

черновика

Если status = 4, то договор считается

договора либо

подписанным обеими сторонами.

договора

Иначе при любом другом значении

status договор считается

неподписанным обеими сторонами.

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

curl -X GET "<url стенда>/elk/outgoing-documents?limit=10&offset=0"

-H "accept: application/json"

-H "Authorization: Bearer <ТОКЕН>"

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

1 В случае успеха:

Параметр

Тип

Обяз.

Описание

documentId

string

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

оператора

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

запрашиваемый файл

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

curl -X GET "<url стенда>/elk/outgoing-documents/f2aab44e-9cc3-4b37-a4ff-c8edf0b6e57b"

-H "accept: application/json"

-H "Authorization: Bearer <ТОКЕН>"

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

1 В случае успеха:

запрашиваемый файл.

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

2.1 Код 401 В случае, если не указан токен:

<error>unauthorized</error>

<error_description>Full authentication is required to access this

resource</error_description>

</UnauthorizedException>

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

{

"error_message": "Документ не найден"

}

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

При успешном выполнении запроса на указанный в запросе e-mail отправляется файл со счётом

на оплату.

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

URL: /elk/crm-api/prequests

Метод: POST

Content-Type: application/json

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

{

"contractId":"1111111",

"sendto":"email",

"amount":"111"

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

contractId

string

Номер лицевого

счёта товарной

группы

amount

string

Сумма счёта на

Значение данного параметра будет

оплату с учетом

указано в счёте на оплату.

НДС

Указывается в рублях с разделителем

". "(точка) для указания копеек.

sendto

string

e-mail УОТ

На данный e-mail будет отправлен

счёт на оплату

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

Параметр

Обяз.

Тип

Описание

Комментарий

status

string

Код статуса

см. "Справочник "Статусы ответов""

обработки

запроса на

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

на оплату

response

integer

Идентификатор

созданного счета

на оплату

error_message

string

Текст сообщения

Параметр возвращается при наличии

об ошибке при

ошибки

обработке запроса

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

curl -X POST "<url стенда>/elk/crm-api/prequests"

-H "accept: application/json"

-H "Content-Type: application/json"

-H "Authorization: Bearer <ТОКЕН>"

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

1 В случае успеха:

{

"status": 200

}

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

2.1. Код 401 В случае, если не указан токен:

<error>unauthorized</error>

<error_description>Full authentication is required to access this

resource</error_description>

</UnauthorizedException>

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

группам

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

группам

Метод предназначен для получения значения баланса лицевых счетов, запрашиваемого УОТ по

каждой товарной группе. Выполнить запрос можно только для получения собственного баланса

денежных средств.

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

URL: /elk/product-groups/balance/all

Метод: GET

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

Параметр

Тип

Обяз.

Описание

Комментарий

balance

number

Значение баланса

в копейках

contractId

number

Идентификатор

договора УОТ с

ГИС МТ на

подключенную

ТГ

organisationId

number

ID УОТ

Идентификатор организации УОТ в

ГИС МТ

productGroupId

number

Идентификатор

см. "Справочник "Список

товарной группы

поддерживаемых товарных групп""

УОТ

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

<error>unauthorized</error>

<error_description>Full authentication is required to access this

resource</error_description>

</UnauthorizedException>

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

{

"error_message": "В токене указано некорректное значение параметра pid либо в

Системе ГИС МТ нет пользователя с данным идентификатором, либо у пользователя нет

лицевого счёта в Системе ГИС МТ"

}

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

группе

Метод предназначен для получения значения баланса лицевого счета, запрашиваемого УОТ по

одной товарной группы. Выполнить запрос можно только для получения информации о

собственном балансе денежных средств.

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

URL: /elk/product-groups/balance

Метод: GET

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

Параметр

Тип

Обяз.

Описание

Комментарий

productGroupId

number

Идентификатор

см. "Справочник "Список

товарной группы

поддерживаемых товарных групп""

УОТ

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

Параметр

Тип

Обяз.

Описание

Комментарий

balance

number

Значение баланса

в копейках

contractId

number

Идентификатор

договора УОТ с

ГИС МТ

organisationId

number

ID УОТ

Идентификатор организации УОТ в

ГИС МТ

productGroupId

number

Идентификатор

см. "Справочник "Список

товарной группы

поддерживаемых товарных групп""

УОТ

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

curl -X GET "<url стенда>/elk/product-groups/balance?productGroupId=1"

-H "accept: application/json"

-H "Authorization: Bearer:<ТОКЕН>"

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

1 В случае успеха:

{

"balance": 120000000,

"organisationId": 600000749,

"productGroupId": 8

}

2 В случае ошибок: 2.1. Код 404 В случае, если в ответе вернулся пустой массив, означающий

указание в запросе некорректного/несуществующего в Системе ГИС МТ ID УОТ либо

отсутствие у УОТ лицевого счёта в Системе ГИС МТ:

{

"error_message": "В токене указано некорректное значение параметра pid либо в Системе

ГИС МТ нет пользователя с идентификаторами {0} нет лицевого счёта в Системе ГИС МТ",

где {0} это pid берется из tokena"

}

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

<error>unauthorized</error>

<error_description>Full authentication is required to access this

resource</error_description>

</UnauthorizedException>

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

{

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

}

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

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

Описание True API (Версия 72.0) - часть 1