Описание API ГИС МТ...

1

Описание API ГИС МТ v18

Содержание

1 Общие положения ............................................................................................................... 4

Принципы взаимодействия с API ............................................................................... 4

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

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

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

Аутентификация ........................................................................................................... 7

Запрос авторизаций ............................................................................................... 8

Получение аутентификационного токена ........................................................... 8

2 Методы ............................................................................................................................... 10

Общие методы ............................................................................................................ 10

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

информацией о КИ ................................................................................................................... 10

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

Метод получения списка товаров по заданному фильтру ............................... 24

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

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

Получение списка КИЗ по идентификатору ..................................................... 43

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

Справочник по КМТ ............................................................................................ 50

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

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

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

.................................................................................................................................................... 67

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

Методы документов ................................................................................................... 73

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

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

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

УПД на отгрузку .................................................................................................. 83

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

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

Отгрузка.............................................................................................................. 104

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

2

Приемка .............................................................................................................. 108

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

Заказ КМ. СУЗ ................................................................................................. 115

Списание КМ ................................................................................................... 115

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

3 Справочники .................................................................................................................... 122

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

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

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

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

столовое, туалетное и кухонное ............................................................................................ 124

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

фотовспышки и лампы-вспышки .......................................................................................... 124

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

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

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

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

резиновые новые .................................................................................................................... 126

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

Справочник "Ошибки обработки документов" ..................................................... 126

3

Версия документа

Дата Версия Изменения

20.03.2020 17 Начальная версия

13.04.2020 18

Изменена обязательность для документа «отмена отгрузки»

Добавлены методы:

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

производство) 2.2.5.5;

Получение списка КИЗ по идентификатору (POST) 2.1.6.

Добавлены:

ТГ вода и АТП;

Вид агрегации: комплект;

Причина вывода из оборота: «Выявлены ошибки описания товара»;

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

4

1 Общие положения

Принципы взаимодействия с API

Взаимодействие участников оборота товара (далее – УОТ) и оператора

Государственной информационной системы мониторинга за оборотом товаров (далее –

ГИС МТ) осуществляется в электронном виде. Обмен документами на бумажном носителе не

предусмотрен.

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

1 Предоставление сведений, т.е. обмен электронными документами, на основании

которых могут вноситься сведения в реестры ГИС МТ. Представление сведений

определено как обязанность УОТ.

2 Запрос сведений, т.е. обмен, при котором сведения из реестров ГИС МТ

предоставляются УОТ в соответствии с установленными разрешениями на получение

сведений. При этом изменения в реестры не вносятся. Запрос и последующее

представление сведений из ГИС МТ инициируется УОТ по своему усмотрению и

применяется, например, для проверки статусов КМ или статуса регистрации УОТ.

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

электронными документами в соответствии с определенным порядком. Для юридически

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

подпись (УКЭП). УКЭП передается вместе с электронным документом. Электронное

взаимодействие осуществляется с применением программных интерфейсов взаимодействия

(API) ГИС МТ и информационных систем участников оборота товара.

При взаимодействии через API выполняются следующие требования:

1 Аутентификация и авторизация УОТ (определение полномочий на осуществление

электронного взаимодействия) осуществляется при помощи УКЭП.

2 При предоставлении и запросе сведений защита передаваемых данных выполняется

TLS/HTTPS (ГОСТ 28147-89) шифрованием канала передачи данных в адрес Оператора

сертифицированными РФ СКЗИ (ГОСТ Р 34.10-2012).

В API отсутствует разделение на категории участников оборота товара.

Информация о вложенности параметров

Параметр считается вложенным, если выровнен не по левому краю таблицы.

Пример вложенности:

Параметр Описание

results:

agentInn

children:

brand

5

Читать как:

Параметр results содержит параметры agentInn и children, а children содержит параметр

brand.

Информация о стендах:

1 https://ismp.crpt.ru/api/v3 - Базовый адрес промышленного ГИС МТ;

2 https://demo.lp.crpt.tech - Базовый адрес демонстрационной версии ГИС МТ

Информация об ошибках при запросах API методов имеет следующий формат:

(подробнее: см. "Справочник "Статусы ответов")

Пример ошибки:

// Status code: 403

Content-Type: application/json

body:

{

"error_message": "< Отсутствует доступ к ресурсу >"

}

// Status code: 401

// информация об ошибке возвращается в формате xml

// Методы Национального каталога возвращают сообщения об ошибках, которые

могут быть как в xml, так и в json форматах в зависимости от выбранного формата

запроса

Коды стран представлены в соответствии с ISO 3166.

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

Файл обмена должен подписываться УКЭП лица, имеющего право действовать без

доверенности от имени участника оборота товара, и соответствовать следующим требованиям:

1 Файл формата JSON:

• для обмена с ГИС МТ используется json стандарта RFC 7159

(https://tools.ietf.org/html/rfc7159);

• использует кодировку UTF-8;

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

для конкретного товара.

2 Файл обмена формата CSV:

• соответствует стандарту RFC 4180;

• использует кодировку UTF-8

• содержит символ "," в контенте файла в качестве разделителя.

https://ismp.crpt.ru/api/v3

https://demo.lp.crpt.tech/

https://www.iso.org/ru/iso-3166-country-codes.html

https://tools.ietf.org/html/rfc7159

https://tools.ietf.org/html/rfc4180

6

3 Файл обмена формата XML:

• xml формат описан в xsd схемах. Актуальные xsd схемы можно найти в разделе

«Помощь»;

• содержит информацию, целиком включающуюся в блок с XML-тэгом "Файл";

• содержит единственный экземпляр электронного документа;

• использует кодировку UTF-8;

• содержит первую строку вида <?xml version="1.0" encoding="utf-8"?>;

• определяет стандартные типы данных в соответствии со стандартом ISO (см.

описание стандарта ISO https://www.w3schools.com/xml/schema_dtypes_date.asp);

• проверяется на корректность на основании XSD-схемы - логической модели для

обмена информацией, описывающей логические элементы и атрибуты XML-

файлов.

ВНИМАНИЕ: в примерах сurl запросы выполнены и проверены на UNIX

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

замена символов

В ответах REST API ГИС МТ могут содержаться дополнительные служебные json

атрибуты, не указанные в документации. Неизвестные атрибуты следует игнорировать.

Максимальный размер документа, передаваемого по API, не должен превышать 70

мегабайт.

Все значения атрибутов в форматах json и csv, выражаемые в деньгах (цены, налоги, и

т.п), задаются в копейках.

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

Экранирование - замена в тексте управляющих символов на соответствующие

текстовые подстановки. Экранирование используется для отделения текста от кода и

управляющих символов. Экранирование применяется при передаче параметров запросов API

методов согласно следующим стандартам:

⎯ при передаче параметров в едином указателе ресурса (Uniform Resource Locator, URL),

т.е. в URL запроса, должно применяться экранирование согласно стандарта rfc3986 (см.

описание стандарта в п. 2.1 https://www.protocols.ru/WP/rfc3986/);

⎯ при передаче параметров в JSON-строке тела запроса URL должно применяться

экранирование согласно стандарта rfc8259 (см. описание стандарта в п. 7

https://www.protocols.ru/WP/rfc8259/);

⎯ при использовании csv файлов для экранирования символа «'» (апостроф)

используется символ «''» (двойной апостроф);

⎯ при передаче параметров в XML-строке тела запроса URL должно применяться

экранирование согласно стандарта W3C (см. описание стандарта в

https://www.w3.org/TR/xml/).

Пример:

⎯ экранирование для JSON по стандарту rfc8259:

https://www.w3schools.com/xml/schema_dtypes_date.asp

https://www.protocols.ru/WP/rfc3986/

https://www.protocols.ru/WP/rfc8259/

https://www.w3.org/TR/xml/

7

0104650117240408211dmfcZNcM"4 => 0104650117240408211dmfcZNcM\"4

⎯ экранирование для URL по стандарту rfc3986:

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

./cises/aggregated/list?codes=0104650117240408211dmfcZNcM%224

⎯ экранирование для CSV:

"010481097886269421""LLRY<%"JZTVZ"

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

<cis>0104650117240408211dmfcZNcM<4</cis> =>

<cis>0104650117240408211dmfcZNcM<4</cis> либо

<cis>0104650117240408211dmfcZNcM<4</cis> =>

<cis><![CDATA[0104650117240408211dmfcZNcM<4]]></cis>

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

Методы API преимущественно возвращают ответы в формате JSON, т.е. MIME-type

application/json. Некоторые методы в корректном ответе возвращают двоичное содержимое

(например, документы в zip) MIME-type application/zip или application/octet-stream, а в случае

ошибки - описание этой самой ошибки в JSON. Таким образом, один и тот же метод в

зависимости от ситуации может вернуть разные типы содержимого (контента).

Для корректной работы методов API параметр Accept заголовка запроса должен быть

установлен так, чтобы учитывались все возможные ответы сервера, т.е. и application/zip, и

application/json. Самый простой вариант - использовать универсальный шаблон:

Accept: */*

Для ограничения набора возвращаемых типов контента можно указывать несколько

заголовков запроса методов:

Accept: application/octet-stream

Accept: application/json

Если в перечне заголовков запроса методов API не окажется ни одного подходящего

под сгенерированный сервером ответ, то API вернется ответ c кодом = 406 (Not Acceptable) с

пустым телом ответа.

Аутентификация

Для работы с интерфейсом API необходимо зарегистрироваться в ЕЛК ГИС МТ: на

демо стенде (https://markirovka.demo.crpt.tech/) или на интеграционном стенде

(https://ismp.crpt.ru/api/v3) - необходимо иметь личный кабинет с хотя бы одной подключенной

товарной группой ГИС МТ ("Предметы одежды, белье постельное, столовое, туалетное и

https://markirovka.demo.crpt.tech/

https://ismp.crpt.ru/api/v3

8

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

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

Метод предназначен для получения аутентификационного токена по УКЭП:

⎯ В результате использования данного метода пользователь получает пары "uuid - data",

где uuid - идентификатор текущей аутентификации, data - строка на подпись пользователю

⎯ Сервер отвечает на запрос либо сообщением с кодом 200 (всё ок) и токеном, либо

сообщением об ошибке (подробнее: см. "Справочник "Статусы ответов").

ВАЖНО!

Все методы API взаимодействия с ГИС МТ требуют передачи в заголовке параметра

'Authorization: Bearer <token>'

где token – аутентификационный токен, получаемый в результате работы метода

получения.

Токен действителен 10 часов.

Запрос авторизаций

URL: api/v3/auth/cert/key

Метод: GET

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

curl -v https://ismp.crpt.ru/api/v3/auth/cert/key

Ответ:

< HTTP/1.1 200

< Content-Type: application/json;charset=UTF-8

<

{"uuid":"b7b1abc9-f4ee-47db-8a20-f80ac83504e8",

"data":"QNRPNPFGJZFUXCERQMTWLRMBRNRAAP"}

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

№ Параметр Тип Обязательность Доступ Описание

1 uuid String + Только чтение Уникальный идентификатор

сгенерированных случайных данных

2 data String + Только чтение Случайная строка данных

Получение аутентификационного токена

URL: /api/v3/auth/cert/

https://ismp.crpt.ru/api/v3/auth/cert/key

9

Метод: POST


curl -X POST -v 'https://ismp.crpt.ru/api/v3/auth/cert/'\

-H 'content-type: application/json;charset=UTF-8'\

--data-binary '{\

"uuid":" b7b1abc9-f4ee-47db-8a20-f80ac83504e8",\

"data":"<Подписанные данные в base64>"'}

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

№ Параметр Тип Обязательность Описание

1 uuid String + Уникальный идентификатор подписанных случайных

данных

2 data String + Подписанные УКЭП зарегистрированного УОТ

случайные данные в base64 (ЭП присоединенная)

Ответ:

< HTTP/2 200

< content-type: application/json;charset=UTF-8

<

{"token": “eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9…”}


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

1 token String - Аутентификационный токен Параметр обязательный в

случае успешного ответа

2 code String - Код ошибки Параметр обязательный в

случае не успешного

ответа

3 error_message String - Сообщение об ошибке

4 description String - Описание ошибки

ВАЖНО!

Все методы API взаимодействия с ГИС МТ требуют передачи в заголовке параметра

'Authorization: Bearer <token>',

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

получения аутентификационного токена.

10

2 Методы

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

«Справочник "Дополнительные параметры для ТГ"».

Общие методы

В разделе описаны методы для всех видов товаров.

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

о КИ

Метод возвращает список КИ с подробной информацией, которые доступны в данный

момент времени участнику оборота товаров (ИНН определится по токену), согласно заданному

фильтру.

URL: /api/v3/facade/identifytools/listV2

Метод: GET


curl -X GET 'https://ismp.crpt.ru/api/v3/facade/identifytools/listV2?\

limit=10&order=DESC&orderColumn=emd&\

uit=010469022978096621qSF7qjA3aRIqM2406402&\

orderedColumnValue=2019-01-23T08:42:17.593Z&pageDir=NEXT' \

-H 'Authorization: Bearer <ТОКЕН>'

Данный запрос вернет 10 (параметр limit) следующих (параметр pageDir) записей,

начиная с даты эмиссии 2019-01-23T08:42:17.593Z (параметр orderedColumnValue) и кода

маркировки 010469022978096621qSF7qjA3aRIqM2406402 (параметр uit). Сортировка будет

производиться по дате эмиссии (параметр orderColumn) и (всегда) по самому коду маркировки

(вне зависимости от переданных параметров) DESC’ом (параметр order). Значение даты

эмиссии и кода маркировки должно быть взято из последней строки (для pageDir NEXT) и из

первой для (pageDir PREV) для перемещения между страницами.

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

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

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

1 cache boolean -

Флаг использование кэша. При включенном флаге УОТ

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

маркировки 1524

2 cis string - Код идентификации, используемый для фильтрации по

списку КМ

11


3 cisAggregationStat enum -

Состояние КИ/КИТУ:

PACKED- в агрегате (агрегирован);

NOT_PACKED – не в агрегате (дезагрегирован);

ANY – любое состояние (значение по умолчанию)

4 cisPackageType enum -

Тип упаковки:

UNIT – Единица товара;

LEVEL1 – Упаковка 1-го уровня;





BUNDLE – Комплект

5 cisStatus string -

Текущий статус КИ:

APPLIED – Эмиттирован. Получен;

EMITTED – Эмитирован.Выпущен;

INTRODUCED – В обороте;

RETIRED – Выбыл

6 documentId string - Регистрационный номер документа. Необходимо указать

при поиске КИ в документе

7 emissionDateFrom date-

time -

Дата эмиссии, от. Задается в формате yyyy-MM-

ddTHH:mm:ss.SSS'Z. Пример 2019-01-01T03:00:00.000Z

8 emissionDateTo date-

time -

Дата эмиссии, до. Задается в формате yyyy-MM-


9 emissionType string -

Тип эмиссии:

LOCAL – Производство РФ;

FOREIGN – Ввезен в РФ;

REMAINS – Маркировка остатков;

CROSSBORDER – Ввезен из стран ЕАЭС

10 gtin string - Код товара

11 limit integer -

Максимальное количество записей, которое вернется в

качестве ответа, не более 10000 записей. (По умолчанию 10

записей)

12 order string -

Направление сортировки:

ASC – по возрастанию;

DESC – по убыванию

13 orderColumn string - Название столбца, по которому будет производиться

сортировка. Допустимое значение emd - дата эмиссии

14 orderedColumnValu

e string -

Значение столбца – “точки отсчета” (запись с которой

начнется выборка), по которому сортируются записи

15 packs string -

Фильтрация по товарным упаковкам:

ALL – товары и упаковки;

UNIT – только товары;

PACK – только упаковки

12


16 pageDir -

Выбор направления для пагинации:

PREV – Вперед;

NEXT – Назад

17 pg string -

Товарная группа:

параметр обязательно указывать для товарных групп:

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

water – Вода;

otp – альтернативная табачная продукция

18 producerInn string - ИНН производителя

19 sn string - Серийный номер

20 statusExt -

Дополнительный статус КИ: CANCELLATION_APPLIED – Списан после нанесения на товар;

REMARK_RETIRED – Перемаркирован;

RETIRED_CANCELLATION – Списан;

DONATION – Безвозмездная передача товара;

STATE_ENTERPRISE – Приобретение гос.предприятием;

NO_RETAIL_USE – Использование для собственных нужд

покупателем;

BEYOND_EEC_EXPORT – Экспорт за пределы ЕАЭС;

ЕАЭС REMOTE_SALE – Продажа по образцам, дистанционный

способ продажи;

EEC_EXPORT – Экспорт в ЕАЭС;

ЕАЭС RETURN – Возврат физическому лицу;

DAMAGE_LOSS – Утрата или повреждение;

DESTRUCTION – Уничтожение;

CONFISCATION – Конфискация;

LIQUIDATION – Ликвидация предприятия

21 tnVed10 string - Код товарной номенклатуры (10 знаков)

22 tree string -

Способ вывода дерева списка КИ/КИТУ:

NO_TREE – Не возвращать вложенные КИ;

ONE_LEVEL – Возвращать только первый уровень

вложенности;

ALL_TREE – Возвращать все дерево

23 uit string - Значение КИ – "точки отсчета"(запись, с которой начнется

выборка), по которому сортируются записи

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

{

"results": [

{

"agentInn": "string",

"agentName": "string",

"children": [

{

"brand": "string",

"children": [

"string"

13

],

"childrenMap": [

null

],

"cis": "string",

"countChildren": 0,

"emissionDate": "2020-01-23T16:17:48Z",

"expireDate": "2020-01-23T16:17:48Z",

"exporterName": "string",

"exporterTaxpayerId": "string",

"sgtin": "string",

"introducedDate": "2020-01-23T16:17:48Z",

"lastDocId": "string",

"nextCises": [

"string"

],

"ownerInn": "string",

"ownerName": "string",

"packageType": "string",

"parent": "string",

"prVetDocument": "string",

"prevCises": [

"string"

],

"producedDate": "2020-01-23T16:17:48Z",

"producerName": "string",

"productName": "string",

"status": "string",

"statusEx": "string"

}

],

"cis": "string",

"countChildren": 0,

"dateChange": "2020-01-23T16:17:48Z",

"emissionDate": "2020-01-23T16:17:48Z",

"emissionType": "string",

"expireDate": "2020-01-23T16:17:48Z",



"gtin": "string",



"nextCises": [

"string"

],



"packType": "string",

"parent": "string",

"participantInn": "string",

"participantName": "string",


"prevCises": [

"string"

],

"producedDate": "2020-01-23T16:17:48Z",


"receiptDate": "2020-01-23T16:17:48Z",

"sgtin": "string",

14

"status": "string",

"statusEx": "string",

"tnVedEaes": "string",

"tnVedEaesGroup": "string",

"uit": "string",

"uitu": "string",

"withdrawReason": "string"

}

]

}



1 results: +

2 agentInn string - ИНН текущего владельца товара

3 agentName string - Наименование текущего владельца товара

4 children - КИ в агрегате

5 brand string - Бренд

6 children: [string] - Все Дочерние КИ. Выглядит как JSON массив

7 childrenMap - Краткая информация о дочерних КИ (рекурсия)

8 cis string + КИ товара

9 countChildren integer

(int32) - Количество дочерних КИ

10 emissionDate

string

(date-

time)

+ Дата эмиссии. Задается в формате yyyy-MM-dd

11 expireDate

string

(date-

time)

- Дата истечения срока годности. Задается в формате yyyy-

MM-dd (обязательный для ТГ "молоко")

12 exporterName string - Наименование экспортера

13 exporterTaxpayerId string - Уникальный идентификатор экспортера в национальной

системе учета налогоплательщиков

14 sgtin string - Код товара и серийный номер КИ

15 introducedDate

string

(date-

time)

- Дата ввода в оборот. Задается в формате yyyy-MM-dd

16 lastDocId string - Последний регистрационный номер документа,

зафиксированный в ГИС МТ по этому КИ

17 nextCises [string] - Следующие номера КИ при перемаркировке

15


18 ownerInn string - ИНН собственника товара

19 ownerName string - Наименование собственника товара

20 packType string +









21 parent string - Код идентификации упаковки, в которую агрегирован

товар

22 prVetDocument string - Производственный ветеринарный сопроводительный

документ (обязательный для ТГ "молоко")

23 prevCises [string] - Предыдущие КИ (перемаркировка)

24 producedDate

string

(date-

time)

- Дата нанесения. Задается в формате yyyy-MM-dd

25 producerName string - Производитель товара

26 productName string - Название продукта

27 status enum +

Статус товара/КИ:

EMITTED – Эмитирован.Выпущен

APPLIED – Эмитирован.Выдан

INTRODUCED – В обороте


WRITTEN_OFF – КМ списан

DISAGGREGATION – Расформирован (только для

упаковок)

28 statusEx enum -

Расширенный статус КИ:

EMPTY – Нет

WAIT_SHIPMENT – Ожидает приемку

WAIT_TRANSFER_TO_OWNER – Ожидает передачу

собственнику (производство по контракту)

REMARK_RETIRED – Перемаркирован

RETIRED_CANCELLATION – Списание

WAIT_REMARK – КИ списан после нанесения на товар

(Товар ожидает перемаркировку)

29 cis string + Код идентификации, используемый для фильтрации по

списку КМ



16


31 dateChange

string

(date-

time)

- Дата внесения изменений в КИТУ. Задается в формате

yyyy-MM-dd

32 emissionDate

string

(date-

time)

+ Дата эмиссии КИ. Задается в формате yyyy-MM-dd

33 emissionType string +






34 expireDate

string

(date-

time)




36 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной



38 introducedDate

string

(date-

time)

- Дата ввода в оборот с КИ в оборот. Задается в формате

yyyy-MM-dd






43 packageType string +









44 parent string - КИТУ вышестоящего уровня

45 participantInn string - ИНН участника, осуществившего эмиссию КМ

46 participantName string - Наименование участника оборота товаров



17


48 prevCises string - Предыдущие номера КИ

49 producedDate

string

(date-

time)

- Дата ввода товара с КИ в оборот. Задается в формате yyyy-

MM-dd

50 productName string - Наименование товара на этикетке

51 receiptDate

string

(date-

time)

- Дата вывода из оборота. Задается в формате yyyy-MM-dd


53 status enum +








упаковок)

54 statusEx enum -


EMPTY – Нет








55 tnVedEaes string - Код товарной номенклатуры (10 знаков)

56 tnVedEaesGroup string - Код товарной позиции ТН ВЭД ЕАЭС товара

57 uit string - КИ, Обязательный, если не указан uitu

58 uitu string - КИТУ, Обязательный, если не указан uit

18


59 withdrawReason string -

Причина вывода из оборота:

KM_SPOILED – Испорчен;

KM_SPOILED_OR_LOST – Испорчен либо утерян СИ с КМ;

KM_LOST – Утерян;

KM_DESTROYED – Уничтожен;

DESCRIPTION_ERRORS - Выявлены ошибки описания товара;

RETAIL – Розничная продажа;

EEC_EXPORT – Экспорт в страны ЕАЭС;

BEYOND_EEC_EXPORT – Экспорт за пределы стран ЕАЭС;

RETURN – Возврат физическому лицу;

REMOTE_SALE – Продажа по образцам, дистанционный





LIQUIDATION – Ликвидация предприятия;

DONATION – Безвозмездная передача;




ENTERPRISE_USE – Использование для собственных нужд

предприятия

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

URL: /api/v3/facade/identifytools/info

Метод: GET

Метод возвращает подробную информацию о запрашиваемом КИ (в 1 запросе 1 КИ),

который доступен в данный момент времени участнику оборота товаров (ИНН организации

содержится в токене).


curl -X GET

'https://ismp.crpt.ru/api/v3/facade/identifytools/info?cis=0104059155704529

21HXRNJW15asPkB2406405' \




1 cis string + Код идентификации

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

{



"children": [

19

{

"brand": "string",

"children": [

"string"

],

"childrenMap": [

null

],

"cis": "string",

"countChildren": 0,

"emissionDate": "2020-01-23T16:17:48Z",

"expireDate": "2020-01-23T16:17:48Z",



"sgtin": "string",



"nextCises": [

"string"

],




"parent": "string",


"prevCises": [

"string"

],

"producedDate": "2020-01-23T16:17:48Z",



"status": "string",


}

],

"cis": "string",

"countChildren": 0,

"dateChange": "2020-01-23T16:17:48Z",

"emissionDate": "2020-01-23T16:17:48Z",


"expireDate": "2020-01-23T16:17:48Z",



"gtin": "string",



"nextCises": [

"string"

],




"parent": "string",




"prevCises": [

"string"

],

20

"producedDate": "2020-01-23T16:17:48Z",


"receiptDate": "2020-01-23T16:17:48Z",

"sgtin": "string",

"status": "string",




"uit": "string",

"uitu": "string",


}






3 children: - КИ в агрегате







9 emissionDate

string

(date-

time)


10 expireDate

string

(date-

time)







14 introducedDate

string

(date-

time)





21














товар




23 producedDate

string

(date-

time)




26 status enum +









упаковок)

27 statusEx enum -


EMPTY – Нет









списку КМ



22


30 dateChange

string

(date-

time)


yyyy-MM-dd

31 emissionDate

string

(date-

time)








33 expireDate

string

(date-

time)







37 introducedDate

string

(date-

time)


yyyy-MM-dd




















23



48 producedDate

string

(date-

time)


MM-dd


50 receiptDate

string

(date-

time)



52 status enum +








упаковок)

53 statusEx enum -


EMPTY – Нет












24

























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

Метод возвращает список товаров с подробной информацией, которые доступны в

данный момент времени участнику оборота товаров (ИНН организации содержится в токене),

согласно заданному фильтру.

URL: /api/v3/facade/marked_products/listV2

Метод: GET


curl -X GET 'https://ismp.crpt.ru/api/v3/facade/marked_products/listV2?\

limit=10&order=DESC&orderColumn=emd&\

uit=010469022978096621qSF7qjA3aRIqM2406402&\






1 cache boolean -

Флаг использование кэша. При включенном флаге УОТ

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

маркировки 1524

25


2 cis string - Код идентификации, используемый для фильтрации по

списку КМ

3 cisAggregationStat enum -

Состояние КИ:

PACKED- в агрегате (агрегирован);

NOT_PACKED – не в агрегате (дезагрегирован);

ANY – любое состояние

4 cisPackageType enum -









5 cisStatus string -








упаковок)

6 emissionDateFrom date-

time -

Дата эмиссии, от. Задается в формате yyyy-MM-


7 emissionDateTo date-

time -

Дата эмиссии, до. Задается в формате yyyy-MM-









10 limit integer -

Максимальное количество записей, которое вернется в

качестве ответа, не более 10000 записей. (По умолчанию 10

записей)

11 order string -




12 orderColumn string - Название столбца, по которому будет производиться

сортировка. Допустимое значение emd - дата эмиссии

13 orderedColumnValu

e string -

Значение столбца – “точки отсчета” (запись с которой

начнется выборка), по которому сортируются записи

26


14 packs string -

Фильтрация по товарным упаковкам:

ALL – товары и упаковки;

UNIT – только товары;

PACK – только упаковки

15 pageDir -

Выбор направления:

PREV – вперед;

NEXT – назад

16 pg array -




water – Вода;


17 producerInn string - ИНН производителя

18 sn string - Серийный номер

19 statusExt enum -


CANCELLATION_APPLIED – Списан после нанесения на

товар;

REMARK_RETIRED – Перемаркирован;

RETIRED_CANCELLATION – Списан;

DONATION – Безвозмездная передача товара;




BEYOND_EEC_EXPORT – Экспорт за пределы стран;

ЕАЭС REMOTE_SALE – Продажа по образцам,

дистанционный способ продажи;

EEC_EXPORT – Экспорт в страны;

ЕАЭС RETURN – Возврат физическому лицу;




LIQUIDATION – Ликвидация предприятия

20 tnVed10 string - Код товарной номенклатуры (10 знаков)

21 tree string -

Способ вывода дерева списка КИ/КИТУ:

NO_TREE – Не возвращать вложенные КИ;

ONE_LEVEL – Возвращать только первый уровень

вложенности;

ALL_TREE – Возвращать все дерево

22 turnoverType enum -

Вид товарооборота:

SELLING - продажа;

COMMISSION - комиссия;

AGENT - агент

27


{

"results": [

{



"children": [

{

"brand": "string",

"children": [

"string"

],

"childrenMap": [

null

],

"cis": "string",

"countChildren": 0,

"emissionDate": "2020-01-23T16:17:48Z",

"expireDate": "2020-01-23T16:17:48Z",



"sgtin": "string",



"nextCises": [

"string"

],




"parent": "string",


"prevCises": [

"string"

],

"producedDate": "2020-01-23T16:17:48Z",



"status": "string",


}

],

"cis": "string",

"countChildren": 0,

"dateChange": "2020-01-23T16:17:48Z",

"emissionDate": "2020-01-23T16:17:48Z",


"expireDate": "2020-01-23T16:17:48Z",



"gtin": "string",



"nextCises": [

"string"

],



28


"parent": "string",




"prevCises": [

"string"

],

"producedDate": "2020-01-23T16:17:48Z",


"receiptDate": "2020-01-23T16:17:48Z",

"sgtin": "string",

"status": "string",




"uit": "string",

"uitu": "string",


}

]

}



1 results: +










10 emissionDate

string

(date-

time)


11 expireDate

string

(date-

time)






29



15 introducedDate

string

(date-

time)

















товар




24 producedDate

string

(date-

time)




27 status enum +

С Статус товара/КИ:







упаковок)

30


28 statusEx enum -


EMPTY – Нет









списку КМ



31 dateChange

string

(date-

time)


yyyy-MM-dd

32 emissionDate

string

(date-

time)








34 expireDate

string

(date-

time)







38 introducedDate

string

(date-

time)


yyyy-MM-dd






31

















49 producedDate

string

(date-

time)


MM-dd


51 receiptDate

string

(date-

time)



53 status enum +








упаковок)

54 statusEx enum -


EMPTY – Нет










32



























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

Метод возвращает список товаров с подробной информацией, которые доступны в

данный момент времени (товары, введенные в оборот) участнику оборота товаров (ИНН

организации содержится в токене), согласно заданному фильтру.

URL: /api/v3/facade/marked_products/info

Метод: GET


curl -X GET

'https://ismp.crpt.ru/api/v3/facade/marked_products/info?cis=01046300340700

2921wskg1E44R1qym2406401' \




1 cis string + уникальный идентификатор товара (КИ)

33

Ответ:

{



"brand": "string",

"certDoc": {

"date": "string",

"number": "string",

"type": "string"

},

"children": [

{

"brand": "string",

"children": [

"string"

],

"childrenMap": [

null

],

"cis": "string",

"countChildren": 0,

"emissionDate": "2020-01-23T16:17:48Z",

"expireDate": "2020-01-23T16:17:48Z",



"sgtin": "string",



"nextCises": [

"string"

],




"parent": "string",


"prevCises": [

"string"

],

"producedDate": "2020-01-23T16:17:48Z",



"status": "string",


}

],

"childrenDetails": [

null

],

"cis": "string",

"countChildren": 0,

"docNum": "string",

"emissionDate": "2020-01-23T16:17:48Z",


"expireDate": "2020-01-23T16:17:48Z",



"gtin": "string",

34



"model": "string",

"name": "string",

"nextCises": [

"string"

],





"prevCises": [

"string"

],

"previousAgentInn": "string",

"previousAgentName": "string",

"producedDate": "2020-01-23T16:17:48Z",

"producerInn": "string",



"remarks": [

{

"curr": "string",

"date": "string",

"prev": "string"

}

],

"sgtin": "string",

"status": "string",


"tnvd": "string",

"tnvedGroup": "string",

"turnoverType": "string",

"uitu": "string",


}







4 certDoc - Сертификат

5 date string - Дата сертификата. Задается в формате yyyy-MM-dd

6 number string - Номер сертификата

7 type string - Тип сертификата


35



10 children: [string] - Все КИ в агрегате. Выглядит как JSON массив





14 emissionDate

string

(date-

time)


15 expireDate

string

(date-

time)







19 introducedDate

string

(date-

time)

















товар




36


28 producedDate

string

(date-

time)




31 status enum +








упаковок)

32 statusEx enum -


EMPTY – Нет








33 childrenDetails - Маркированный товар (рекусрия)


списку КМ



36 docNum string - Регистрационный номер документа

37 emissionDate

string

(date-

time)








39 expireDate

string

(date-

time)






37



43 introducedDate

string

(date-

time)


yyyy-MM-dd



45 model string - Производитель товара

46 name string - Наименование товара




50 packType +












53 previousAgentInn string - ИНН предыдущего владельца товара

54 previousAgentName string - Наименование предыдущего владельца товара

55 producedDate

string

(date-

time)


MM-dd

56 producerInn string - ИНН производителя/импортёра товара


58 remarks - Список перемаркировок данного товара

59 curr string - Текущий КИ товара

60 date string - Дата перемаркиовки. Задается в формате yyyy-MM-dd

61 prev string - предыдущие КИ товара


38


63 status enum +








упаковок)

64 statusEx enum -


EMPTY – Нет






WAIT_REMARK – КИ списан после нанесения на товар (Товар

ожидает перемаркировку)

65 tnvd string - Код товарной номенклатуры (10 знаков)

66 tnvedGroup string - Код товарной позиции ТН ВЭД ЕАЭС товара (первые 4

символа)

67 turnoverType enum -

Вид товарооборота:

SELLING – продажа;

COMMISSION – комиссия;

AGENT – агент

68 uitu string - КИТУ вышестоящего уровня
























39

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

URL: /api/v3/facade/cis/cis_list

Метод: GET


curl -X GET

"http://ismp.crpt.ru/api/v3/facade/cis/cis_list?cis=010463003407002921wskg1

E44R1qym2406401&cis=010469022978096621qSF7qjA3aRIqM2406402" \

-H 'content-type: application/json' -H 'Authorization: Bearer <ТОКЕН>'



1 cis string + уникальный идентификатор товара (КИ)


Ответ:

"cis": "string",

"gtin": "string",


"status": "EMITTED",

"emissionDate": 0,

"producedDate": 0,

"packageType": "UNIT",




"brand": "string",

"prevCises": [

"string"

],

"nextCises": [

"string"

],

"statusEx": "EMPTY",

"children": [

"string"

],

"childrenMap":

{

"brand": "string",

"children": [

"string"

],

"childrenMap": [

null

],

"cis": "string",

"countChildren": 0,

"emissionDate": "2020-01-23T16:17:48Z",

"expireDate": "2020-01-23T16:17:48Z",


40


"sgtin": "string",



"nextCises": [

"string"

],




"parent": "string",


"prevCises": [

"string"

],

"producedDate": "2020-01-23T16:17:48Z",



"status": "string",


}

"countChildren": 0,

"parent": "string",


"expireDate": 0,


"introducedDate": 0,





"lastStatusChangeDate": 0

}




списку КМ



4 status enum +








упаковок)

5 emissionDate

string

(date-

time)

+ Дата выпуска КИ. Задается в формате yyyy-MM-dd

41


6 producedDate

string

(date-

time)


7 packageType

+









8 ownerName string - Наименование текущего владельца товара




12 prevCises [string] - Предыдущие номера КИ


14 statusEx enum -


EMPTY – Нет








15 children [string] - КИ в агрегате

16 childrenMap - Краткая информация о дочерних КИ







22 emissionDate

string

(date-

time)


42


23 expireDate

string

(date-

time)







27 introducedDate

string

(date-

time)

















товар




36 producedDate

string

(date-

time)




43


39 status enum +








упаковок)

40 statusEx enum -


EMPTY – Нет













44 expireDate

string

(date-

time)





46 introducedDate

string

(date-

time)


yyyy-MM-dd






51 lastStatusChangeDat

e

string

(date) +

Дата последнего изменения статуса. Задается в формате

yyyy-MM-dd

Получение списка КИЗ по идентификатору

URL: /api/v3/facade/cis/cis_list

44

Метод: POST


curl -X POST "http://ismp.crpt.ru/api/v3/facade/cis/cis_list" \

-H 'Authorization: Bearer <ТОКЕН>' -H 'content-type: application/json' -d

"{\"cises\":[\"0000000000000000000000000000000\"]}"

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

{

"cises": [

"0000000000000000000000000000000"

]

}



1 cises string - Список уникальных идентификаторов товара

(КИ)


Ответ:

{

"0000000000000000000000000000000": {

"cis": "0000000000000000000000000000000",

"gtin": "string",


"status": "EMITTED",

"emissionDate": 0,

"producedDate": 0,

"packageType": "UNIT",




"brand": "string",

"prevCises": [

"string"

],

"nextCises": [

"string"

],

"statusEx": "EMPTY",

"children": [

"string"

],

"childrenMap": {},

"countChildren": 0,

"parent": "string",


"expireDate": 0,


"introducedDate": 0,


45




"lastStatusChangeDate": 0

},

}




списку КМ



4 status enum +








упаковок)

5 emissionDate

string

(date-

time)

+ Дата выпуска КИ. Задается в формате yyyy-MM-dd

6 producedDate

string

(date-

time)


7 packageType

+









8 ownerName string - Наименование текущего владельца товара




12 prevCises [string] - Предыдущие номера КИ


46


14 statusEx enum -


EMPTY – Нет








15 children [string] - КИ в агрегате

16 childrenMap - Краткая информация о дочерних КИ







22 emissionDate

string

(date-

time)


23 expireDate

string

(date-

time)







27 introducedDate

string

(date-

time)







47












товар




36 producedDate

string

(date-

time)




39 status enum +








упаковок)

40 statusEx enum -


EMPTY – Нет













44 expireDate

string

(date-

time)



48




46 introducedDate

string

(date-

time)


yyyy-MM-dd






51 lastStatusChangeDate string

(date) +

Дата последнего изменения статуса. Задается в формате

yyyy-MM-dd

Метод получения информации о товаре по Коду товара (GTIN)

В результате успешного выполнения запроса по списку GTIN в ответе возвращается

массив с информацией о товарах по запрошенным GTIN.

Примечание - в результирующем JSON также может содержаться набор полей,

специфичных для конкретного товара (см. Справочник "Дополнительные параметры для ТГ").

URL: /api/v3/product/info

Метод: GET

Запрос:

curl -X GET 'https://ismp.crpt.ru/api/v3/product/info?\

gtins=04690257113712,04690257113712' \




1 gtins array + список кодов товаров (gtin)



{

"brand": "string",

49

"goodMarkFlag": true,

"goodSignedFlag": true,

"goodTurnFlag": true,

"gtin": "string",

"id": 0,

"inn": "string",

"innerUnitCount": 0,

"model": "string",

"name": "string",


"productGroupId": 0,

"publicationDate": "2020-01-23",

"tnVedCode": "string"

}




2 goodMarkFlag boolean + Индикатор заполнения первого слоя, true - можно заказать

код идентификации

3 goodSignedFlag boolean + Флаг, показывающий, подписана ли карточка кода товара

4 goodTurnFlag boolean + Индикатор заполнения второго слоя, true - можно ввести в

оборот

5 gtin string + Код товара

6 id integer

(int64) + Уникальный идентификатор товара в БД ГИС МТ

7 inn string + ИНН Российского производителя

8 innerUnitCount integer

(int64) - Число экземпляров товара

9 model string - Модель производителя











50


12 productGroupId integer +

Код продукта:

код - 1, Предметы одежды, белье постельное, столовое,

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

код - 2, Обувные товары;

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

код - 4, Духи и туалетная вода;

код - 5, Шины и покрышки пневматические резиновые

новые;

код - 6, Фотокамеры (кроме кинокамер), фотовспышки и

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

код - 7, Лекарственные препараты для медицинского

применения;

код - 8, Молочная продукция;

код - 9, Велосипеды и велосипедные рамы;

код - 10, Кресла-коляски

13 publicationDate (date) - Дата публикации Кода товара. Задается в формате yyyy-

MM-dd

14 tnVedCode string - Четырёхзначный код ТН ВЭД

Справочник по КМТ

URL: /api/v3/product/search

Метод: GET

Запрос:

curl -X GET 'https://ismp.crpt.ru/api/v3/product/search?\

limit=10&offset=0&page=0&pg=shoes' \




1 gtin string - код товара

2 limit integer -

Максимальное количество записей, которое вернется

в качестве ответа, не более 10000 записей. (По

умолчанию 10 записей)

3 offset integer - позиция смещения в наборе результатов для начала

нумерации страниц

4 page integer - Номер страницы ответа, начальное значение 0

51


5

pg string - Товарная группа:



water – Вода;



{

"results": [

{

"brand": "string",

"goodMarkFlag": true,

"goodSignedFlag": true,

"goodTurnFlag": true,

"gtin": "string",

"id": 0,

"inn": "string",

"innerUnitCount": 0,

"model": "string",

"name": "string",


"productGroupId": 0,

"publicationDate": "2020-01-23",

"tnVedCode": "string"

}

]

}




1 results: +


3 goodMarkFlag boolean + Индикатор заполнения первого слоя, true - можно заказать

код идентификации

4 goodSignedFlag boolean + Флаг, показывающий, подписана ли карточка кода товара

5 goodTurnFlag boolean + Индикатор заполнения второго слоя, true - можно ввести в

оборот

6 gtin string + Код товара

7 id integer

(int64) + Уникальный идентификатор товара в БД ГИС МТ

8 inn string + ИНН Российского производителя

52


9 innerUnitCount integer

(int64) - Число экземпляров товара

10 model string - Модель производителя


12 packageType string -









13 productGroupId integer +

Код продукта:

код - 1, Предметы одежды, белье постельное, столовое,


код - 2, Обувные товары;

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

код - 4, Духи и туалетная вода;

код - 5, Шины и покрышки пневматические резиновые

новые;

код - 6, Фотокамеры (кроме кинокамер), фотовспышки и


код - 7, Лекарственные препараты для медицинского


код - 8, Молочная продукция;

код - 9, Велосипеды и велосипедные рамы;

код - 10, Кресла-коляски

14 publicationDate (date) - Дата публикации Кода товара. Задается в формате yyyy-

MM-dd

15 tnVedCode string - Четырёхзначный код ТН ВЭД

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

URL: /api/v3/facade/doc/listV2

Метод: GET

Запрос:

curl 'https://ismp.crpt.ru/api/v3/facade/doc/listV2?\

limit=10&order=DESC&\

orderColumn=docDate&did=623136d3-7a9b-40c9-8ce3-8091e41f83aa&\



53



1 dateFrom string (date-

time) -

Дата документа, от. Задается в формате yyyy-MM-

ddTHH:mm:ss.SSS'Z, пример 2019-01-

01T03:00:00.000Z

2 dateTo string (date-

time) -

Дата документа, до. Задается в формате yyyy-MM-


01T03:00:00.000Z

3 did string -

Значение номера документа - "точки отсчета"

(запись с которой начнется выборка), по которому

сортируются записи.

4 documentFormat -

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

MANUAL – формат json;

UPD – ЭДО;

XML – формат xml;

CSV – формат csv

5 documentStatus -

Статус документа:

IN_PROGRESS – Проверяется;

CHECKED_OK – Обработан;

CHECKED_NOT_OK – Обработан с ошибками;

PROCESSING_ERROR – Техническая ошибка;

UNDEFINED – не определен;

CANCELLED – Аннулирован. Только для

документа 'Отмена отгрузки';

ACCEPTED – Принят. Только для документа

'Отгрузка';

WAIT_ACCEPTANCE – Ожидание приемку.

Только для документа 'Отгрузка'. Устанавливается

при успешной обработке документа 'Отгрузка

товара';

WAIT_PARTICIPANT_REGISTRATION -Ожидает

регистрации участника в ГИС МТ. Только для

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

успешной обработке документа 'Отгрузка товара' в

сторону незарегистрированного участника

6 documentType array[string] -

Тип документа: AGGREGATION_DOCUMENT – Агрегирование. json;

AGGREGATION_DOCUMENT_CSV – Агрегирование.

csv;

AGGREGATION_DOCUMENT_XML –

Агрегирование. xml;

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

json;

DISAGGREGATION_DOCUMENT_CSV –

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

DISAGGREGATION_DOCUMENT_XML –

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

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

json;

54


REAGGREGATION_DOCUMENT_CSV –

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

REAGGREGATION_DOCUMENT_XML –

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

ATK_AGGREGATION – Формирование АТК. json

ATK_AGGREGATION_CSV – Формирование АТК. csv

ATK_AGGREGATION_XML – Формирование АТК.xml

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

json

ATK_DISAGGREGATION_CSV – Расформирование

АТК.csv

ATK_DISAGGREGATION_XML – Расформирование

АТК. xml

ATK_TRANSFORMATION – Трансформация АТК. json

ATK_TRANSFORMATION_CSV – Трансформация

АТК. csv

ATK_TRANSFORMATION_XML – Трансформация

АТК. json

LP_SHIP_GOODS – Отгрузка. json;

LP_SHIP_GOODS_CSV – Отгрузка. csv;

LP_SHIP_GOODS_XML – Отгрузка. xml;

LP_INTRODUCE_GOODS – Ввод в оборот.

Производство РФ. json;

LP_INTRODUCE_GOODS_CSV – Ввод в оборот.

Производство РФ. csv;

LP_INTRODUCE_GOODS_XML – Ввод в оборот.

Производство РФ. xml;

LP_ACCEPT_GOODS – Приемка. json;

LP_ACCEPT_GOODS_XML – Приемка. xml;

LK_REMARK – Перемаркировка. json;

LK_REMARK_CSV – Перемаркировка. csv;

LK_REMARK_XML – Перемаркировка. xml;

LK_RECEIPT – Вывод из оборота. json;

LK_RECEIPT_XML – Вывод из оборота. xml;

LK_RECEIPT_CSV – Вывод из оборота. csv;

LP_GOODS_IMPORT – Ввод в оборот. Импорт. json;

LP_GOODS_IMPORT_CSV – Ввод в оборот. Импорт.

csv;

LP_GOODS_IMPORT_XML – Ввод в оборот. Импорт.

xml;

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

json

LP_FTS_INTRODUCE_CSV – Ввод в оборот. Импорт с

ФТС. csv

LP_FTS_INTRODUCE_XML – Ввод в оборот. Импорт с

ФТС. xml

LP_CANCEL_SHIPMENT – Отмена отгрузки. Json;

LK_KM_CANCELLATION – Списание

ненанесенных КИ. json;

LK_KM_CANCELLATION_CSV – Списание

ненанесенных КИ. csv;

LK_KM_CANCELLATION_XML – Списание

ненанесенных КИ. xml;

LK_APPLIED_KM_CANCELLATION – Списание

нанесенных КИ. json;

55


LK_APPLIED_KM_CANCELLATION_CSV – Списание

нанесенных КИ. csv;

LK_APPLIED_KM_CANCELLATION_XML – Списание

нанесенных КИ. xml;

LK_CONTRACT_COMMISSIONING – Ввод в оборот.

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

LK_CONTRACT_COMMISSIONING_CSV – Ввод в

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

LK_CONTRACT_COMMISSIONING_XML – Ввод в

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

LP_INTRODUCE_GOODS_CROSSBORDER_CSD –


производство). json

LP_INTRODUCE_GOODS_CROSSBORDER_CSD_CSV

– Ввод в оборот. На территории стран ЕАЭС

(контрактное производство). csv

LP_INTRODUCE_GOODS_CROSSBORDER_CSD_XML


(контрактное производство). xml

LK_INDI_COMMISSIONING – Ввод в оборот.

Полученных от физических лиц. json;

LK_INDI_COMMISSIONING_CSV – Ввод в оборот.

Полученных от физических лиц. csv;

LK_INDI_COMMISSIONING_XML – Ввод в оборот.

Полученных от физических лиц. xml;

LP_INTRODUCE_OST – Ввод в оборот. Маркировка

остатков. json;

LP_INTRODUCE_OST_CSV – Ввод в оборот.

Маркировка остатков. csv;

LP_INTRODUCE_OST_XML – Ввод в оборот.

Маркировка остатков. xml;

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

json;

LP_SHIP_RECEIPT_CSV – Отгрузка с выводом из

оборота. csv;

LP_SHIP_RECEIPT_XML – Отгрузка с выводом из

оборота.xml;

OST_DESCRIPTION – Описание остатков товара. json;

OST_DESCRIPTION_CSV – Описание остатков товара.

csv;

OST_DESCRIPTION_XML – Описание остатков товара.

xml;

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

торговля. json;

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

торговля. csv;

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

торговля. xml;

LP_RETURN – Возврат в оборот. json;

LP_RETURN_CSV – Возврат в оборот. csv;

LP_RETURN_XML – Возврат в оборот. xml;

LP_SHIP_GOODS_CROSSBORDER – Отгрузка при

трансграничной торговли. json;

LP_SHIP_GOODS_CROSSBORDER_CSV – Отгрузка

при трансграничной торговли. csv;

56


LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка

при трансграничной торговли. xml

LP_CANCEL_SHIPMENT_CROSSBORDER – Отмена

отгрузки при трансграничной торговли. Производство

РФ. json

7 inputFormat boolean - входящий (true) / исходящий (false) документ

8 limit integer -

Максимальное количество записей, которое

вернется в качестве ответа, не более 10000 записей.

(По умолчанию 10 записей)

9 number string - Номер документа

10 order enum -




11 orderColumn string -

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

производиться сортировка. Допустимое значение

docDate - дата эмиссии

12 orderColumnValue date - Задается в формате yyyy-MM-ddTHH:mm:ss.SSS'Z,

пример 2019-01-01T03:00:00.000Z

13 pageDir enum -



NEXT – назад


15 pg string -


параметр обязательно указывать для товарных

групп:


water – Вода;




{

"results": [

{

"docDate": "2020-01-23",

"downloadDesc": "string",

"downloadStatus": "string",

"number": "string",

"pdfFile": "string",

"receivedAt": "2020-01-23",

"receiverName": "string",

"senderName": "string",

"status": null,

"type": "string"

57

}

]

}



1 results: +

2 docDate string

(date-time) + Дата документа. Задается в формате yyyy-MM-dd

3 downloadDesc string - Полный список ошибок обработки документа

4 downloadStatus string -

Статус загрузки: IN_PROGRESS – Проверяется

CHECKED_OK – Оформлен

CHECKED_NOT_OK – Ошибка

PROCESSING_ERROR – Ошибка при обработке

UNDEFINED – Не определен

CANCELLED – Документ отменен. Для отгрузки, при отмене

отгрузки выставляется этот статус

ACCEPTED – Документ принят. Приемка, для принятой

отгрузки, ставится этот статус (обратный статус

CANCELLED)

WAIT_ACCEPTANCE – Ожидание приемки. Для отгрузки,

вместо CHECKED_OK

WAIT_PARTICIPANT_REGISTRATION – Ожидаем

регистрации участника в ГИС МТ. Для отгрузки не УОТ,


PARSE_ERROR – Статус документ, если не удалось

распарсить

WAIT_FOR_CONTINUATION – Ожидаем продолжения

процессинга документа. Для ФТС

5 number string + Номер документа

6 pdfFile string - Ссылка на PDF-файл

7 receivedAt string

(date) -

Дата загрузки документа. Задается в формате yyyy-MM-

dd

8 receiverName string - Получен от

9 senderName string + Отправитель

10 status enum +

Статус обработки документа: IN_PROGRESS – Проверяется









CANCELLED)

58











11 type string +


AGGREGATION_DOCUMENT_CSV – Агрегирование. csv;

AGGREGATION_DOCUMENT_XML – Агрегирование. xml;

DISAGGREGATION_DOCUMENT – Расформирование. json;

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

csv;



REAGGREGATION_DOCUMENT – Трансформация. json;








ATK_DISAGGREGATION – Расформирование АТК. json

ATK_DISAGGREGATION_CSV – Расформирование АТК.csv

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

xml


ATK_TRANSFORMATION_CSV – Трансформация АТК. csv

ATK_TRANSFORMATION_XML – Трансформация АТК. json



















LP_GOODS_IMPORT_CSV – Ввод в оборот. Импорт. csv;

LP_GOODS_IMPORT_XML – Ввод в оборот. Импорт. xml;

LP_FTS_INTRODUCE – Ввод в оборот. Импорт с ФТС. json

59


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

csv

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

xml
















LK_CONTRACT_COMMISSIONING_CSV – Ввод в оборот.

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

LK_CONTRACT_COMMISSIONING_XML – Ввод в оборот.

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

LK_INDI_COMMISSIONING – Ввод в оборот. Полученных от

физических лиц. json;







LP_INTRODUCE_OST_CSV – Ввод в оборот. Маркировка

остатков. csv;

LP_INTRODUCE_OST_XML – Ввод в оборот. Маркировка

остатков. xml;

LP_SHIP_RECEIPT – Отгрузка с выводом из оборота. json;

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

csv;


оборота.xml;


OST_DESCRIPTION_CSV – Описание остатков товара. csv;

OST_DESCRIPTION_XML – Описание остатков товара. xml;



LP_INTRODUCE_GOODS_CROSSBORDER_CSD_CSV –


производство). csv

LP_INTRODUCE_GOODS_CROSSBORDER_CSD_XML –


производство). xml

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

json;



60









LP_SHIP_GOODS_CROSSBORDER_CSV – Отгрузка при

трансграничной торговли. csv;

LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка при

трансграничной торговли. xml


отгрузки при трансграничной торговли. Производство РФ.

json

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

URL: /api/v3/facade/receipt/listV2

Метод: GET

Запрос:

curl -X GET

"https://ismp.crpt.ru/api/v3/facade/receipt/listV2?number=string&dateFrom=2

020-04-04T07%3A43%3A27.237Z&dateTo=2020-04-

04T07%3A43%3A27.237Z&participantInn=string&\

documentType=UNKNOWN&documentStatus=IN_PROGRESS&documentFormat=MANUAL&\

inputFormat=true&pageDir=PREV&did=string&orderColumn=string&\

order=ASC&orderedColumnValue=string&limit=0&pg=string" \

-H "accept: */*" -H "Authorization: Bearer <ТОКЕН>'



1 number string - Номер документа

2 dateFrom string (date-

time) -

Дата документа, от. Задается в формате yyyy-MM-


01T03:00:00.000Z

3 dateTo string (date-

time) -

Дата документа, до. Задается в формате yyyy-MM-


01T03:00:00.000Z


5 documentType array[string] -


AGGREGATION_DOCUMENT_CSV – Агрегирование.

csv;

61


AGGREGATION_DOCUMENT_XML –

Агрегирование. xml;

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

json;





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

json;








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

json


АТК.csv

ATK_DISAGGREGATION_XML – Расформирование

АТК. xml


ATK_TRANSFORMATION_CSV – Трансформация

АТК. csv

ATK_TRANSFORMATION_XML – Трансформация

АТК. json



















LP_GOODS_IMPORT_CSV – Ввод в оборот. Импорт.

csv;

LP_GOODS_IMPORT_XML – Ввод в оборот. Импорт.

xml;

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

json

LP_FTS_INTRODUCE_CSV – Ввод в оборот. Импорт с

ФТС. csv

LP_FTS_INTRODUCE_XML – Ввод в оборот. Импорт с

ФТС. xml

62

















LK_CONTRACT_COMMISSIONING_CSV – Ввод в

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

LK_CONTRACT_COMMISSIONING_XML – Ввод в

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



LP_INTRODUCE_GOODS_CROSSBORDER_CSD_CSV


(контрактное производство). csv

LP_INTRODUCE_GOODS_CROSSBORDER_CSD_XML


(контрактное производство). xml

LK_INDI_COMMISSIONING – Ввод в оборот.

Полученных от физических лиц. json;







LP_INTRODUCE_OST_CSV – Ввод в оборот.

Маркировка остатков. csv;

LP_INTRODUCE_OST_XML – Ввод в оборот.

Маркировка остатков. xml;

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

json;

LP_SHIP_RECEIPT_CSV – Отгрузка с выводом из

оборота. csv;


оборота.xml;


OST_DESCRIPTION_CSV – Описание остатков товара.

csv;

OST_DESCRIPTION_XML – Описание остатков товара.

xml;

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

торговля. json;





63







LP_SHIP_GOODS_CROSSBORDER_CSV – Отгрузка

при трансграничной торговли. csv;

LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка

при трансграничной торговли. xml


отгрузки при трансграничной торговли. Производство

РФ. json

6 documentStatus -

Статус документа:

IN_PROGRESS – Проверяется;

CHECKED_OK – Обработан;

CHECKED_NOT_OK – Обработан с ошибками;

PROCESSING_ERROR – Техническая ошибка;

UNDEFINED – не определен;

CANCELLED – Аннулирован. Только для

документа 'Отмена отгрузки';

ACCEPTED – Принят. Только для документа

'Отгрузка';

WAIT_ACCEPTANCE – Ожидание приемку.

Только для документа 'Отгрузка'. Устанавливается

при успешной обработке документа 'Отгрузка

товара';

WAIT_PARTICIPANT_REGISTRATION -Ожидает

регистрации участника в ГИС МТ. Только для

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

успешной обработке документа 'Отгрузка товара' в

сторону незарегистрированного участника

7 documentFormat -



UPD – ЭДО;



8 inputFormat boolean - входящий (true) / исходящий (false) документ

9 did string -

Значение номера документа - "точки отсчета"

(запись с которой начнется выборка), по которому

сортируются записи.

10 limit integer -


вернется в качестве ответа, не более 10000 записей.

(По умолчанию 10 записей)

11 pageDir enum -



NEXT – назад

12 order enum - Направление сортировки:

64




13 orderColumn string -

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

производиться сортировка. Допустимое значение

docDate - дата эмиссии

14 orderColumnValue date - Задается в формате yyyy-MM-ddTHH:mm:ss.SSS'Z,

пример 2019-01-01T03:00:00.000Z

15 pg string -



групп:


water – Вода;




{

"results": [

{

"docDate": "2020-01-23",



"number": "string",


"receivedAt": "2020-01-23",



"status": null,

"type": "string"

}

]

}



1 results: +

2 docDate string








65







CANCELLED)












7 receivedAt string

(date) -


dd

8 receiverName string - Получен от


10 status enum +










CANCELLED)










11 type string +






csv;



66













xml


























csv


xml
















67




















csv;


оборота.xml;





json;
























json

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

URL: / api/v3/facade/doc/{docId}/body

68

Метод: GET

Запрос:

curl -X GET 'https://ismp.crpt.ru/api/v3/facade/doc/e76a1c45-c8ce-4961-

84f1-1df47e5a7d35/body' \




1 pg string -



групп:


water – Вода;


2 docId string +

Возможные значения:

Уникальный идентификатор документа в ГИС

МТ, указывается для ГИС документов;

Идентификатор юридически значимого

документа

3 limit integer -

Максимальное количество кодов маркировки,

которое вернется в качестве ответа, не более

10000 КМ

4 orderedColumnValue string -

Значение столбца – “точки отсчета” (КМ с

которой начнется выборка), по которому

сортируются коды маркировки

5 pageDir enum -



NEXT – назад

Примечание – при необходимости вывести более 10000 КМ, требуется повторить

запрос.



{

"body": {},

"content": "string",

"docDate": "2020-01-23",



"errors": [

"string"

],

"input": true,

"number": "string",


69

"receivedAt": "2020-01-23",



"status": null,

"type": "string"

}



1 body object + Тело отправленного документа в json формате. См.

Методы документов 2.2

2 content string + Оригинальное содержимое документа

3 docDate string













CANCELLED)










6 errors [string] - Список ошибок обработки документа

7 input boolean + входящий (true) / исходящий (false) документ



10 receivedAt string

(date) -


dd

11 receiverName string - Получатель


13 status string +




70








CANCELLED)










14 type string +






csv;














xml



















71









csv


xml










































csv;


оборота.xml;



72




json;
















json

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

В результате успешного выполнения запроса на получение списка кодов ТН ВЭД с

указанием массива префиксов ТН ВЭД и параметров пагинации в ответе возвращается массив

информации об удовлетворяющих запросу кодах ТН ВЭД и общее число элементов данного

массива.

URL: /api/v3/facade/tnved/search

Метод: GET


curl -X GET 'https://ismp.crpt.ru/api/v3/facade/tnved/search?\

limit=10&offset=0&page=0&prefix=6401,6402,6403,6404,6405' \




1 code string - Код ТН ВЭД (10 знаков)

2 limit integer -


вернется в качестве ответа, не более 10000

записей. (По умолчанию 10 записей)

3 offset integer - позиция смещения в наборе результатов для

начала нумерации страниц

73


4 page integer

(int32) - Номер страницы ответа, начальное значение 0

5 prefix string -

Список товарных позиций с одного из которых

должны начинаться искомые коды ТН ВЭД.

Используется для фильтрации товарной группы.

Пример '6401,6402,6403,6404,6405'.


{

"records": [

{

"code": "string",

"description": "string"

}

],

"total": 0

}



1 records + Описание кода ТН ВЭД

2 code string + 10-ти значный код ТН ВЭД

3 description string + Текстовое описание кода ТН ВЭД

4 total integer

(int64) +

Общее количество кодов ТН ВЭД, подходящие

под параметры фильтрации

Методы документов

Методы, описанные в настоящем подразделе, предназначены для получения

информации по всем ТГ, кроме МОТП и МДЛП.

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

⎯ Описание остатков;

⎯ Агрегирование;

⎯ УПД на отгрузку;

⎯ Ввод в оборот;

⎯ Возврат в оборот;

⎯ Отгрузка;

⎯ Отмена отгрузки;

⎯ Приемка;

74

⎯ Вывод из оборота ;

⎯ Заказ КМ. СУЗ;

⎯ Списание КМ;

⎯ Перемаркировка;

⎯ Ошибка! Источник ссылки не найден.;

⎯ Ошибка! Источник ссылки не найден.;

⎯ Ошибка! Источник ссылки не найден..

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

URL: /api/v3/lk/documents/create

Метод: POST


curl 'https://ismp.crpt.ru/api/v3/lk/documents/create?pg=milk' \


--data-binary'{"product_document":"<Документ в base64>",\

"document_format":"MANUAL", "type": "LP_INTRODUCE_GOODS",\

"signature":"<Открепленная подпись в base64>"}'


Наименование Тип данных Обяз. Описание

pg string - Товарная группа:



water – Вода;

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

Тело запроса:

{

"document_format": "string",

"product_document": "string",

"product_group": "string",

"signature": "string",

"type": "string"

}

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


document_format string + Тип документа:




product_document string + Тело документа переведённое в base64

product_group string -


clothes – Предметы одежды, белье постельное,

столовое, туалетное и кухонное;

shoes – Обувные товары;

75


tobacco – Табачная продукция;

perfumery – Духи и туалетная вода;

tires – Шины и покрышки пневматические резиновые

новые;

electronics – Фотокамеры (кроме кинокамер),

фотовспышки и лампы-вспышки;

pharma – Лекарственные препараты для медицинского



bicycle – Велосипеды и велосипедные рамы;

wheelchairs – Кресла-коляски

signature string + Открепленная подпись (УКЭП) в формате BASE64

type string +



















АТК.csv


xml



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

json



















76

Наименование Тип данных Обяз. Описание LP_GOODS_IMPORT_CSV – Ввод в оборот. Импорт. csv;




csv


xml




























LK_INDI_COMMISSIONING – Ввод в оборот. Полученных

от физических лиц. json;













csv;


оборота.xml;





json;

77

Наименование Тип данных Обяз. Описание CROSSBORDER_CSV – Ввод в оборот. Трансграничная















json


{

"9abd3d41-76bc-4542-a88e-b1f7be8130b5"

}

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

документа в ГИС МТ. Параметры не успешного ответа указаны в таблице ниже.


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

1 code String - Код ошибки

Параметр указывается в

случае не успешного ответа 2 error_message String - Сообщение об ошибке

3 description String - Описание ошибки

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

2.2.2.1 По упрощенной схеме


Тип Описание

OST_DESCRIPTION Описание остатков товара JSON (MANUAL)

OST_DESCRIPTION_CSV Описание остатков товара CSV

OST_DESCRIPTION_XML Описание остатков товара XML

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

{

"products_list": [

{

"release_method": "string",

"tnved_code_2": "string"

}

],

"trade_participant_inn": "string"

}

78

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

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

1 trade_participant_inn

ИНН участника,

осуществившего

эмиссию КМ

string +

2 products_list Список сведений о

товарах array +

3 release_method Способ ввода товара в

оборот string +

Обязательно для «обувные товары» и

«Предметы одежды»


PRODUCED_IN_RF – Произведен в

РФ;

IMPORTED_INTO_RF – Ввезен в РФ;

CROSSBORDER – трансграничная

торговля

4 tnved_code_2

Код товарной

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

(2 знака)

string +


42, 61, 62 – Предметы одежды,

белье постельное, столовое,


64 – Обувные товары;

33 – Духи и туалетная вода;

40 – Шины и покрышки

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

90 – Фотокамеры (кроме

кинокамер), фотовспышки и


04, 21, 22 – Молочная продукция;

87, 95 – Велосипеды и

велосипедные рамы;

87 – Кресла-коляски

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

ИНН участника оборота,Версия

1111111111,2

Список товаров,,,,,,

Код товарной номенклатуры (2 знака),Торговая Марка Бренд,Наименование

товара,Целевой пол,Способ ввода товара в оборот,Возраст потребителя,Модель

/ артикул производителя

00,trademark,product_name,Мужской,Произведен в РФ,Детское,model

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

<?xml version="1.0" encoding="UTF-8"?>

<ost_description version="2" action_id="33.1">

<trade_participant_inn>1111111111</trade_participant_inn>

<products_list>

<product>

<tnved_code_2>00</tnved_code_2>

<brand>trademark</brand>

<name>product_name</name>

79

<product_gender>MALE</product_gender>

<release_method>PRODUCED_IN_RF</release_method>

<consumer_age>BABY</consumer_age>

<model>model</model>

</product>

</products_list>

</ost_description>

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

2.2.3.1 Агрегация



AGGREGATION_DOCUMENT Агрегирование JSON (MANUAL)

AGGREGATION_DOCUMENT_CSV Агрегирование CSV

AGGREGATION_DOCUMENT_XML Агрегирование XML

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

{

"participantId": "string",

"aggregationUnits": [

{

"unitSerialNumber": "string",

"aggregationType": "string",

"sntins": [

"string"

],

"aggregationUnits": [

null

]

}

]

}


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

1 participantId ИНН УОТ string +

2 aggregationUnits

Список

создаваемых

агрегатов

array +

3 aggregationUnits

Список

создаваемых

агрегатов

array + Рекурсия

4 unitSerialNumber КИТУ код

агрегата string +

Серийный код транспортной упаковки

формируется по стандарту КИТУ (18

символов)

5 aggregationType Код типа

агрегации string +

Значение может быть только

"AGGREGATION"

80


6 sntins

Список КИ,

входящих в

агрегат

array[string] + Статусы КМ, либо Агрегата, должны

быть идентичен

Примечание - Агрегация может быть до ввода в оборот, так и после ввода в оборот. Если агрегация

была до ввода в оборот, то в документе ввода в оборот необходимо указывать агрегаты, а не КМ,

иначе агрегаты расформировываются. Для формирования ввода в оборот остатков нужно сначала

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

расформировываться.

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

Тип документа,ИНН участника оборота товаров

Документ на агрегацию,0000000000

КИТУ,Вложеннный КИ/КИТУ

"0000000000000000000000000000000","000000000000000000"

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


<unit_pack document_id="unit_pack_7FFF90D5-4785-7EC9-899E-534A7BAA2B71"

VerForm="1.03" file_date_time="2019-04-12T11:07:45+03:00"

VerProg="VerProg1">

<Document operation_date_time="2019-06-05T14:28:14+03:00"

document_number="157743-20199">

<organisation>

<id_info>

<LP_info org_name="ООО" LP_TIN="0000000000" RRC="000000000"

/>

</id_info>

<Address>

<location_address country_code="643" text_address="142305"

/>

</Address>

<contacts phone_number="123456789" email="[email protected]" />

</organisation>

<pack_content>

<pack_code>000000000000000000</pack_code>

<cis><![CDATA[00000000000000000000000000000000000002]]></cis>

</pack_content>

<pack_content>

<pack_code>000000000000000001</pack_code>

<cis><![CDATA[000000000000000002]]></cis>

</pack_content>

</Document>

</unit_pack>

2.2.3.2 Трансформация



REAGGREGATION_DOCUMENT Трансформация. JSON (MANUAL)

REAGGREGATION_DOCUMENT_CSV Трансформация CSV

REAGGREGATION_DOCUMENT_XML Трансформация XML

81

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

{

"participant_inn": "string",

"reaggregation_type": "string",

"uit_uitu_list": [

{

"uit_uitu": "string"

}

],

"uitu": "string"

}



1 participant_inn


осуществившего эмиссию

КМ

string +

2 reaggregation_type Код типа операции string +


REMOVING – изъятие;

ADDING – добавление

3 uitu Код модифицируемого

агрегата string +

4 uit_uitu_list Список агрегатов для

добавления/изъятия array +

5 uit_uitu Коды маркировки для

добавления/изъятия string +

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

ИНН участника оборота,Тип трансформации,Код идентификации трансформируемой

транспортной упаковки(КИТУ),Версия

0000000000,Изъятие,000000000000000000,2

Список транспортных упаковок или товаров

КИ,КИТУ

"00000000000000000000000000000000000000",

"11111111111111111111111111111111111111",

,"222222222222222222"

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


<reaggregation action_id="32" version="2">


<reaggregation_type>REMOVING</reaggregation_type>

<reaggregating_kitu>000000000000000000</reaggregating_kitu>

<product_list>

<packing_product>

<kit><![CDATA[00000000000000000000000000000000000000]]></kit>

</packing_product>

<packing_product>

82

<kit><![CDATA[11111111111111111111111111111111111111]]></kit>

</packing_product>

<packing_product>

<kitu><![CDATA[222222222222222222]]></kitu>

</packing_product>

</product_list>

</reaggregation>

2.2.3.3 Расформирование



DISAGGREGATION_DOCUMENT Расформирование. JSON (MANUAL)

DISAGGREGATION_DOCUMENT_CSV Расформирование CSV

DISAGGREGATION_DOCUMENT_XML Расформирование XML


{


"products_list": [

{

"uitu": "string"

}

]

}


№ Наименование Описание Тип Обязательность Комментарий

1 participant_inn



эмиссию КМ

string +



3 uitu Код расформируемого

агрегата string -

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


0000000000,2

Список транспортных упаковок

"000000000000000000"

"111111111111111111"

"222222222222222222"



<disaggregation action_id="31" version="2">


<packings_list>

83

<packing>

<kitu><![CDATA[000000000000000000]]></kitu>

</packing>

<packing>

<kitu><![CADTA[111111111111111111]]></kitu>

</packing>

<packing>

<kitu><![CDATA[222222222222222222]]></kitu>

</packing>

</packings_list>

</disaggregation>

УПД на отгрузку

Работа с УПД описана в документе API ЭДО lite.

Ввод в оборот

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



LP_INTRODUCE_GOODS Ввод в оборот. Производство РФ. JSON (MANUAL)

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

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


{

"document_description" : {

"participant_inn": "0000000000",

"production_date": "2012-11-22",

"producer_inn": "000000000",

"owner_inn": "000000000",

"production_type": "OWN_PRODUCTION"

},

"doc_type": "Promotion_Inform_Selfmade",

"products": [

{

"production_date": "2012-11-22",

"uit_code": "11111111111111111111111111111111111111",

"uitu_code": "000000000000000000",

"tnved_code": "0123456789",

"producer_inn": "000000000",

"owner_inn": "000000000",

"certificate_document": "CONFORMITY_DECLAR",

"certificate_document_number": "FFFFFF",

"certificate_document_date": "2014-11-22"

},

]

}



1 document_description -

https://честныйзнак.рф/upload/API%20%D0%AD%D0%94%D0%9E%20lite%20v1.0.pdf

84


2 participant_inn



эмиссию КМ

string +

3 producer_inn

ИНН

производителя

товара

string +

4 production_date Дата производства

товара string +

Задается в формате yyyy-MM-

dd.

5 owner_inn

ИНН

собственника

товара

string +

6 production_type

Тип

производственног

о заказа

string + Возможные значения:

OWN_PRODUCTION –

Собственное производство

7 doc_type Тип создаваемого

документа string +

8 products Перечень товаров -

9 certificate_document

Код вида документа

обязательной

сертификации

string -

Возможный значения:

CONFORMITY_CERTIFICATE –

сертификат соответствия;

CONFORMITY_DECLARATION –

декларация соответствия

10 certificate_document_date

Дата документа



string - Задается в формате yyyy-MM-dd

11 certificate_document_number

Номер документа



string -

12 owner_inn ИНН собственника string +

13 producer_inn

ИНН


товара

string +

14 production_date

Дата производства

товара из общих

сведениях о вводе

товаров в оборот

string +

Параметр присутствует в

запросе, если его значение

отличается от значения

параметра production_date (№ 8 в

данной таблице).

Задается в формате yyyy-MM-dd

15 tnved_code


номенклатуры (10

знаков)

string +

85


16 uit_code

Уникальный

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

товара

string - Обязательный, если не указан

uitu_code

17 uitu_code



транспортной

упаковки


uit_code

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

Тип документа,ИНН участника оборота товаров,Дата производства,ИНН

производителя товара,ИНН собственника товаров,Тип производственного заказа,

Заявка на ввод товаров в оборот (собственное

производство),0000000000,12.04.2019,0000000000,0000000000,Собственное

производство,

Перечень товаров

КИТ,КИТУ,Код ТН ВЭД ЕАЭС,Дата производства товара,Документ обязательной

сертификации,Номер документа,Дата документа,

"11111111111111111111111111111111111111","000000000000000000",0000000000,12

.04.2019,Сертификат соответствия,111,12.04.2019,

"11111111111111111111111111111111111112","000000000000000000",0000000000,12

.04.2019,Декларация о соответствии,111,12.04.2019,



<vvod action_id="05" version="5">


<producer_inn>1111111111</producer_inn>

<owner_inn>1111111111</owner_inn>



<product_date>12.04.2019</product_date>

<production_order>OWN_PRODUCTION</production_order>

<products_list>



<product>



<kit><![CDATA[00000000000000000000000000000000000002]]></kit>



<kitu>000000000000000000</kitu>




<tnved_code>0001000000</tnved_code>

<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>

<certificate_number>string</certificate_number>

<certificate_date>12.04.2019</certificate_date>

</product>

<product>



<kit><![CDATA[11111111111111111111111111111111111112]]></kit>



<kitu>000000000000000000</kitu>

86


<certificate_number>string</certificate_number>


</product>

</products_list>

</vvod>

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



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

лиц. JSON (MANUAL) LK_INDI_COMMISSIONING_CSV Ввод в оборот. Полученных от физических

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

лиц. XML


{

"doc_type": "string",


"product_receiving_date": "2020-01-23",

"products_list": []

}



1 doc_type Тип создаваемого


2 participant_inn



эмиссию КМ

string +

3 product_receiving_date Дата получения

товара

string

(date) + Задается в формате yyyy-MM-dd

4 products_list Список товаров на

ввод в оборот array +

5 uit



товара

string - Обязательный, если не указан uitu

6 uitu




упаковки

string - Обязательный, если не указан uit

7 product_receiving_date Дата получения

товара date +

Параметр присутствует в запросе,

если его значение отличается от

87


значения параметра

product_receiving_date.


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

ИНН участника оборота,Дата получения товара,Версия

1111111111,12.04.2019,2

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

КИ,КИТУ,Дата получения товара

"000000000000000000000000000000000",,12.04.2019

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


<vvod_individuals action_id="5.3" version="3">




<product_receiving_date>12.04.2019</product_receiving_date>

<products_list>


<product>



<kit><![CDATA[000000000000000000000000000000000]]>/kit>

<kitu>000000000000000000</kitu>

<product_receiving_date>12.04.2019</product_receiving_date>

</product>

</products_list>

</vvod_individuals>

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



LP_GOODS_IMPORT Ввод в оборот. Импорт. JSON (MANUAL)

LP_GOODS_IMPORT_CSV Ввод в оборот. Импорт. CSV

LP_GOODS_IMPORT_XML Ввод в оборот. Импорт. XML


{

"doc_type": "GOODSIMPORT",

"document_description": {


"declaration_date": "2019-12-31",

"declaration_number": "decl num",

"customs_code": "customs code",

"decision_code": 1

},

"products": [

{

"uit_code": "33333",

"uitu_code": "123456789123456789",

"tnved_code": "0123456789",

88

"certificate_document": "CONFORMITY_DECLAR",

"certificate_document_number": "FFFFFF",

"certificate_document_date": "2014-11-22"

}

],

"pdfFile": "pdfContent"

}



1 doc_type

Тип

создаваемого

документа

string +

2 document_description

Общие

параметры

документа

object +

3 participant_inn

ИНН

участника,

осуществивше

го эмиссию

КМ

string +

4 declaration_date

Дата

регистрации

ДТ

string + Задается в формате yyyy-

MM-dd

5 declaration_number Регистрационн

ый номер ДТ string +

6 customs_code

Код

таможенного

органа

string +

7 decision_code Код принятого

решения string +

Может принимать значения:

10 - выпуск товаров

разрешен;

11 - выпуск товаров при

условии обеспечения

исполнения обязанности по

уплате таможенных пошлин;

12 - выпуск товаров с

особенностями,

предусмотренными статьёй

121 ТК ЕЭС;




122 ТК ЕЭС;




123 ТК ЕЭС;

89


20 - условный выпуск

товаров

8 pdfFile

Прикрепленны

й PDF файл. В

Base64

string -

9 products

Список

данных о КМ

для ввода в

оборот

array +


Код вида

документа



string -


CONFORMITY_CERTIFICATE

– сертификат соответствия;

CONFORMITY_DECLARATIO

N – декларация соответствия

11 certificate_document_number

Номер

документа



string -


Дата

документа



string - Задается в формате yyyy-

MM-dd

13 tnved_code



(10 знаков)

string +

14 uit_code


идентификато

р товара

string - Обязательный, если не

указан uitu_code

15 uitu_code



р


упаковки

string - Обязательный, если не

указан uit_code


ИНН участника оборота,Дата регистрации ДТ,Регистрационный номер ДТ,Код

таможенного органа,Код принятого решения,Версия

1234567890,01.01.2019,123,11111111,10,3


КИ,КИТУ,Вид документа подтверждающего соответствие,Номер документа

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

соответствие,Код ТН ВЭД ЕАС товара

"11111111111111111111111111111111111111",,Сертификат

соответствия,123,01.01.2019,0000000000

90



<vvod_import action_id="5.1" version="3">


<declaration_date>12.04.2019</declaration_date>

<declaration_number>876</declaration_number>

<customs_code>11111111</customs_code>

<decision_code>10</decision_code>

<products_list>

<product>

<kit><![CDATA[11111111111111111111111111111111111111]]></kit>

<certificate_type>CONFORMITY_DECLARATION</certificate_type>

<certificate_number>6534</certificate_number>



</product>

</products_list>

</vvod_import>

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



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

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


{

"country_oksm": "string",

"exporter_name": "string",

"import_date": "2020-01-23",

"primary_document_date": "2020-01-23",

"primary_document_number": "string",

"products_list": [

{

"certificate_date": "2020-01-23",

"certificate_number": "string",

"certificate_type": "string",

"cost": 0,

"ki": "string",

"kitu": "string",

"tnved_code": "string",

"vat_value": 0

}

],

"sender_tax_number": "string",


}

91



1 country_oksm Код страны

экспортера string +

Числовой код длиной 3 символа из

ОКСМ:

112 – Белоруссия

417 – Киргизия

487 – Казахстан

51 – Армения

2 exporter_name Наименование


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

4 primary_document_

date

Дата первичного

документа,

подтверждающего

перемещение

товара

string + Задается в формате yyyy-MM-dd

5 primary_document_

number

Номер первичного

документа,



товара

string +



7 certificate_date

Дата документа,


соответствие

string

(date) - Задается в формате yyyy-MM-dd

8 certificate_number




string -

9 certificate_type Тип документа,


соответствие string -





декларация соответствия.

10 cost Цена за единицу integer - Стоимость в копейках

11 ki



товара

string - Обязательное, если не указано kitu

12 kitu




упаковки

string - Обязательное, если не указано ki

92


13 tnved_code

10-ти значный код

ТН ВЭД ЕАЭС

товара

string +

14 vat_value Сумма НДС integer - Стоимость в копейках

15 sender_tax_number Номер

налогоплательщик

а отправителя

string +




эмиссию КМ

string +


ИНН участника оборота,Номер налогоплательщика отправителя,Наименование

экспортера,Код страны,Дата импорта,Номер первичного документа

подтверждающего перемещение товара,Дата первичного документа

подтверждающего перемещение товара,Версия

0000000000,UNIQUE ID,ООО Ромашка,010,12.04.2019,123,12.04.2019,1


КИ,КИТУ,Код товарной номенклатуры (10 знаков),Цена за единицу,Сумма НДС,Вид

документа подтверждающего соответствие,Номер документа подтверждающего

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

"00000000000000000000000000000000000000",,000000000,1000,0,Сертификат

соответствия,123,12.04.2019,

"111111111111111111",0000000000,1000,0,Сертификат

соответствия,123,12.04.2019



<vvod_crossborder action_id="5.5" version="1">


<sender_tax_number>UNIQUE ID</sender_tax_number>

<exporter_name>ООО Ромашка</exporter_name>

<country_oksm>000</country_oksm>

<import_date>12.04.2019</import_date>

<primary_document_number>123</primary_document_number>

<primary_document_date>12.04.2019</primary_document_date>

<products_list>

<product>

<ki><![CDATA[00000000000000000000000000000000000000]]></ki>


<cost>1000</cost>

<vat_value>10</vat_value>




</product>

<product>

<kitu>111111111111111111</kitu>


<cost>1000</cost>


93






</product>

</products_list>

</vvod_crossborder>

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



LP_INTRODUCE_GOODS_CROSSBORDER_CSD Ввод в оборот. На территории стран ЕАЭС

(контрактное производство). JSON

(MANUAL) LP_INTRODUCE_GOODS_CROSSBORDER_CSD

_CSV Ввод в оборот. На территории стран ЕАЭС

(контрактное производство). CSV LP_INTRODUCE_GOODS_CROSSBORDER_CSD

_XML Ввод в оборот. На территории стран ЕАЭС

(контрактное производство). XML


{

"country_oksm": "string",

"exporter_name": "string",

"import_date": "2020-01-23",



"vsd_number": "Номер ВСД",

"products_list": [

{




"cost": 0,

"ki": "string",

"kitu": "string",


"vat_value": 0

}

],

"sender_tax_number": "string",

94

}



1 country_oksm Код страны


Числовой код длиной 3 символа из

ОКСМ:

112 – Белоруссия

417 – Киргизия

487 – Казахстан

51 – Армения

2 exporter_name Наименование


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

4 primary_document_

date

Дата первичного

документа,



товара


5 primary_document_

number

Номер первичного

документа,



товара

string +

6 vsd_number Номер ВСД string +

Сведения о ветеринарно-

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

(транспортном сопроводительном

документе)



8 certificate_date

Дата документа,



string






string -



соответствие string -





декларация соответствия.

11 cost Цена за единицу integer - Стоимость в копейках

12 ki



товара

string - Обязательное, если не указано kitu

95


13 kitu




упаковки

string - Обязательное, если не указано ki

14 tnved_code

10-ти значный код

ТН ВЭД ЕАЭС

товара

string +

15 vat_value Сумма НДС integer - Стоимость в копейках

16 sender_tax_number Номер

налогоплательщик

а отправителя

string +




эмиссию КМ

string +


ИНН участника оборота,Номер налогоплательщика отправителя,Наименование

экспортера,Код страны,Дата импорта,Номер первичного документа

подтверждающего перемещение товара,Дата первичного документа

подтверждающего перемещение товара,Номер ВСД,Версия

0000000000,TAXPAYER ID,Экпортер

№1,010,01.09.2019,123,01.09.2019,Номер ВСД,2


КИ,КИТУ,Код ТН ВЭД ЕАС товара,Цена за единицу,Сумма НДС,Вид



"00000000000000000000000000000000000000",,0000000000,1000,0,Сертификат


,111111111111111111,000000000,1000,0,Сертификат



<vvod_crossborder version="2">


<sender_tax_number>TAXPAYER ID</sender_tax_number>

<exporter_name>Экпортер №1</exporter_name>

<country_oksm>000</country_oksm>

<import_date>01.09.2019</import_date>



<vsd_number>Номер ВСД</vsd_number>

<products_list>

<product>

<ki><![CDATA[0000000000000000000000000000000000]]></ki>


<cost>1000</cost>



96



</product>

<product>

<kitu>111111111111111111</kitu>


<cost>1000</cost>





</product>

</products_list>

</vvod_crossborder>

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



LP_INTRODUCE_OST Ввод в оборот. Маркировка остатков. JSON (MANUAL)

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

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


{

"products_list": [

{




"country": "string",

"declaration_date": "2020-01-23",

"declaration_number": "string",

"ki": "string",

"kitu": "string"

}

],


}






эмиссию КМ

string +


товарах array -

3 certificate_date




string(d

ate) - Задается в формате yyyy-MM-dd

97






string -

5 certificate_type

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



string -

Вид документа обязательной

сертификации:


Сертификат соответствия;


Декларация о соответствии

6 country Страна производства string - Указываются код и название страны

7 declaration_date Дата регистрации

ДТ string - Задается в формате yyyy-MM-dd

8 declaration_number Регистрационный

номер ДТ string -

9 ki КИ string - Обязательный, если не указан kitu

10 kitu КИТУ string - Обязательный, если не указан kit



1111111111,2


КИ,КИТУ,Страна производства,Дата регистрации ДТ,Регистрационный номер

ДТ,Вид документа подтверждающего соответствие,Номер документа

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

"00000000000000000000000000000",,111,12.04.2019,123456,Сертификат




<vvod_ostatky version="2" action_id="5.4">


<products_list>

<product>

<ki><![CDATA[00000000000000000000000000000]]></ki>

<country>111</country>

<declaration_date>12.04.2019</declaration_date>

<declaration_number>123456</declaration_number>




</product>

</products_list>

</vvod_ostatky>

98

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



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

(MANUAL)

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

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


{

"producer_inn": "string",

"owner_inn": "string",

"production_date": "2019-04-01,

"production_order": "CONTRACT_PRODUCTION",

"products_list": [

{

"uit": "string",

"uitu": "string",


"production_date": "2019-04-01,

"certificate_doc_type": "CONFORMITY_CERT",

"certificate_doc_number": "string",

"certificate_doc_date": 0,

}

],

"owner": true,

"producer": true

}



1 producer_inn

ИНН


товара

string +

2 owner_inn

ИНН

собственника

товара

string +

3 production_date

Дата

производства

товара


4 production_order

Тип

производствен

ного заказа

string + CONTRACT_PRODUCTION –

Производство товара по договору

5 owner Признак 'Я

собственник' boolean + Если producer = true, то поле = false

6 producer Признак 'Я

производитель boolean + Если owner = true, то поле = false

99


7 products_list:

Список

товаров на

ввод в оборот

+

8 certificate_doct_date





9 certificate_doc_type

Код вида

документа



string






10 certificate_doc_number

Номер

документа



string -

11 production_date

Дата

производства

товара из

общих

сведениях о

вводе товаров в

оборот

string +

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

его значение отличается от значения

параметра production_date (№ 6 в данной

таблице).


12 tnved_code



(10 знаков)

string +

13 uit



товара

string - Обязательный, если не указан uitu

14 uitu



р


упаковки

string - Обязательный, если не указан uit


ИНН производителя или импортера,ИНН собственника,Дата производства,Тип

производственного заказа,Версия

1111111111,2222222222,12.04.2019,Контрактное производство,2


КИ,КИТУ,Код ТН ВЭД ЕАЭС товара,Дата производства,Вид документа

подтверждающего соответствие,Номер документа подтверждающего


"000000000000000000000000000000000000","000000000000000000",0000000000,12.0

4.2019,Сертификат соответствия,12345,12.04.2019

100



<vvod_contract_production action_id="5.2" version="3">

<producer_inn>1111111111</producer_inn>

<owner_inn>2222222222</owner_inn>

<production_date>12.04.2019</production_date>

<production_order>CONTRACT_PRODUCTION</production_order>

<products_list>


<product>



<kit><![CDATA[000000000000000000000000000000000000]]></kit>

<kitu>000000000000000000</kitu>






</product>

<product>



<kit><![CDATA[000000000000000000000000000000000001]]></kit>

<kitu>000000000000000000</kitu>






</product>

<product>



<kit><![CDATA[000000000000000000000000000000000011]]></kit>

<kitu>000000000000000000</kitu>






</product>

</products_list>

</vvod_contract_production>

2.2.5.8 Автоматический ввод в оборот. СУЗ

Работа с СУЗ описана в документе «Станция управления заказами. Спецификация API».

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



LP_RETURN Возврат в оборот. JSON (MANUAL)

LP_RETURN_CSV Возврат в оборот. CSV

LP_RETURN_XML Возврат в оборот. XML

https://честныйзнак.рф/upload/iblock/07f/STANTSIYA-UPRAVLENIYA-ZAKAZAMI.pdf

101


{




"paid": true,

"primary_document_custom_name": "string",



"primary_document_type": "string",

"products_list": [

{




"ki": "string",

"paid": true,




"primary_document_type": "string"

}

],

"return_type": "RETAIL_RETURN",

"trade_participant_inn": "string",

}



1 certificate_date Дата документа,

подтверждающе

го соответствие

string



Номер

документа,



string -



го соответствие string -


CONFORMITY_CERTIFICATE - сертификат

соответствия;

CONFORMITY_DECLARATION - декларация

соответствия.

4 paid Товар был

оплачен

покупателем boolean -

Обязательно, если "Вид возврата" =

"Возврат при дистанционном способе

продажи".

Признак оплаты товара:

true – оплачен;

false – не оплачен

5 primary_document_date

Дата

первичного

документа

string

(date) +


Возврат при розничной реализации.


6 primary_document_nu

mber

Номер




Возврат при розничной реализации

102


7 primary_document_type Вид первичного

документа enum +



RECEIPT – Кассовый чек;

SALES_RECEIPT – Товарный чек;

OTHER – Прочее

8 primary_document_cust

om_name

Наименование


документа string -

Обязательно, если в поле «Вид

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

«OTHER – Прочее»

9 products_list +

10 certificate_date Дата документа,



string



Номер

документа,



string -



го соответствие string -

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

соответствие:

CONFORMITY_CERTIFICATE -

Сертификат соответствия;

CONFORMITY_DECLARATION -

Декларация о соответствии

13 ki Код

идентификации string -

14 paid Товар оплачен boolean -

Признак оплаты товара:

true – оплачен;

false – не оплачен

15 primary_document_c

ustom_name



документа string -


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

16 primary_document_date

Дата


документа

string

(date) +




17 primary_document_nu

mber

Номер












19 return_type Вид возврат string +

RETAIL_RETURN – Возврат при

розничной реализации;

REMOTE_SALE_RETURN – Возврат

при дистанционном способе продажи

103



ИНН

участника,

осуществивше

го эмиссию

КМ

string +


ИНН участника оборота,Вид возврата,Оплачен покупателем,Тип первичного

документа,Наименование первичного документа,Номер первичного документа,Дата

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

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

соответствие,Версия

00000000,Возврат при розничной реализации,Да,Кассовый

чек,,12345,12.04.2019,Сертификат соответствия,12345,12.04.2019,1

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

КИ,Оплачен покупателем,Тип первичного документа,Наименование первичного

документа,Номер первичного документа,Дата первичного документа,Вид


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

"00000000000000000000000000000000000000",Да,Кассовый

чек,,12345,12.04.2019,Сертификат соответствия,12345,12.04.2019,,



<return action_id="34" version="1">


<return_type>RETAIL_RETURN</return_type>

<paid>true</paid>

<primary_document_type>RECEIPT</primary_document_type>






<products_list>

<product>

<ki><![CDATA[00000000000000000000000000000000000000]]></ki>

<paid>true</paid>







</product>

</products_list>

</return>

104

Отгрузка



LP_SHIP_GOODS Отгрузка. JSON (MANUAL)

LP_ SHIP_GOODS_CSV Отгрузка. CSV

LP_ SHIP_GOODS_XML Отгрузка. XML


{

"document_date": "2020-04-20",

"transfer_date": "2020-04-20",

"document_num": "123",

"receiver_inn": "0000000000",

"turnover_type": "SELLING",

"sender_inn": "0000000000",

"to_not_participant": false,

"products": [

{

"product_description": "Остатки",

"uit_code": "000000000000125121raskIWlKDlkD!"

}

]

}



1 document_num

Номер


документа

string +

2 document_date

Дата


документа


3 transfer_date

Дата передачи

маркированных

товаров


4 products

Список

сведений о

товарах

array +

5 uit_code



товара

string - Обязательный, если не указан uitu_code

6 uitu_code




упаковки

string - Обязательный, если не указан uit_code

7 product_description Наименования

продукта string +

105


8 receiver_inn ИНН

получателя string +

9 sender_inn ИНН

отправителя string -

10 to_not_participant

Признак

отгрузки

неучастнику

boolean -


true – отгрузка неучастнику;

false – отгрузка участнику

11 turnover_type Вид

товарооборота string +






ИНН отправителя,ИНН получателя,Дата передачи товара,Номер первичного

документа,Дата первичного документа,Наименование первичного документа,Вид

оборота товаров,Отгрузка неучастнику,Версия

0000000000,0000000000,12.04.2019,123,12.04.2019,,Продажа-покупка,,Нет,5


КИ,КИТУ,Цена за единицу,Сумма НДС

"00000000000000000000000000000000000000",,33030,270



<shipment action_id="10" version="5">

<trade_participant_inn_sender>0000000000</trade_participant_inn_sender>

<trade_participant_inn_receiver>0000000000</trade_participant_inn_receiver>

<transfer_date>12.04.2019</transfer_date>

<move_document_number>123</move_document_number>

<move_document_date>12.04.2019</move_document_date>

<turnover_type>SELLING</turnover_type>

<to_not_participant>true</to_not_participant>

<products_list>

<product>

<ki><![CDATA[00000000000000000000000000000000000000]]></ki>

<cost>330305</cost>


</product>

</products_list>

</shipment>

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



LP_SHIP_RECEIPT Отгрузка с выводом из оборота. JSON (MANUAL)

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

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

106


{


"document_num": "document number",

"products": [

{

"product_cost": 33030,

"product_tax": 270,

"uit_code": "00000000000000000000000000000000000001"

},{

"product_cost": 33030,

"product_tax": 270,

"uitu_code": "111111111111111111"

}

],

"receiver_inn": "получатель",


"turnover_type": "SELLING",

"sender_inn": "отправитель",

"withdrawal_type": "NO_RETAIL_USE",

"withdrawal_date": "2019-10-01",

"to_not_participant": false

}



1 document_num

Номер


документа

string +

2 document_date

Дата


документа


3 products

Список

сведений о

товарах

array +

4 uit_code



товара

string - Обязательный, если не указан uitu_code

5 uitu_code




упаковки

string - Обязательный, если не указан uit_code

6 product_cost Цена за единицу integer - Стоимость в копейках, с учетом НДС

7 product_tax Сумма НДС integer -

8 receiver_inn ИНН

получателя string +

107


9 transfer_date

Дата передачи

маркированных

товаров



товарооборота string +


SELLING – продажа

11 sender_inn ИНН

отправителя string -

12 st_contract_id

Идентификатор

государственно

го контракта

string - Заполняется при withdrawal_type = STATE_ENTERPRISE

13 to_not_participant

Признак

отгрузки

неучастнику

boolean -


true – отгрузка неучастнику;

false – отгрузка участнику

14 withdrawal_date Дата вывода из

оборота string - Задается в формате yyyy-MM-dd

15 withdrawal_type

Причина

вывода из

оборота

enum -



STATE_ENTERPRISE – Приобретение

гос.предприятием;

NO_RETAIL_USE – Использование для

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


ИНН отправителя,ИНН получателя,Дата передачи товара,Номер первичного

документа,Дата первичного документа,Наименование первичного документа,Вид

оборота товаров,Отгрузка неучастнику,Версия

0000000000,0000000000,12.04.2019,123,12.04.2019,,Продажа-покупка,,Нет,5


КИ,КИТУ,Цена за единицу,Сумма НДС

"00000000000000000000000000000000000000",,33030.5,270.85



<shipment action_id="10" version="5">






<turnover_type>SELLING</turnover_type>



<withdrawal_type>STATE_ENTERPRISE</withdrawal_type>



<withdrawal_date>01.01.2020</withdrawal_date>



<st_contract_id>string</st_contract_id>

<products_list>

108

<product>



<ki><![CDATA[00000000000000000000000000000]]></ki>



<cost>1000.00</cost>



<vat_value>1000.00</vat_value>

</product>

</products_list>

</shipment>

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



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


{

"cancel_shipment_date": "string",

"cancel_shipment_number": "string",



"shipment_number": "string"

}



1 participant_inn ИНН участника,

осуществившего эмиссию КМ string +

2 pdfFile Приложенный PDF файл в

Base64 string -

3 shipment_number Номер документа на отгрузку string +

Приемка



LP_ ACCEPT_GOODS Отгрузка. JSON (MANUAL)

LP_ ACCEPT_GOODS_XML Отгрузка. XML


"acceptance_date": "2020-01-23",


"document_number": "string",

"products": [

{

"accepted": true,

109

"product_cost": 0,

"product_description": "string",

"product_tax": 0,

"uit_code": "string",

"uitu_code": "string"

}

],

"release_method": "string",

"release_order_number": "string",

"request_type": "string",

"trade_recipient_inn": "string",

"trade_sender_inn": "string",


"turnover_type": "string"

}



1 acceptance_date Дата приемки

товара string + Задается в формате yyyy-MM-dd

2 document_date Дата первичного

документа string + Задается в формате yyyy-MM-dd

3 document_number

Номер


документа

string +

4 products Список сведений

о товарах array +

5 accepted

Признак, товар

принят или не

принят

boolean +

6 uit_code



товара


uitu_code

7 uitu_code




упаковки


uit_code

8 release_method Код способа

ввода в оборот string -

Обязательно для «обувные товары» и

«Предметы одежды»


PRODUCED_IN_RF – Произведен в РФ;

IMPORTED_INTO_RF – Ввезен в РФ;

CROSSBORDER – трансграничная

торговля.

Параметр указывается только для

приемки документа отгрузки Трансгран и

при этом его значение должно быть =

"CROSSBORDER"

9 release_order_numb

er

Номер заявки на

отгрузку string +

110


10 request_type Тип документа string + Значение параметра должно =

"ACCEPTANCE"

11 trade_recipient_inn ИНН получателя string +

12 trade_sender_inn ИНН отправителя string +

13 transfer_date Дата передачи

товара string + Задается в формате yyyy-MM-dd


товарооборота string -







<acceptance action_id="11" version="6">

<shipment_id>57250cce-52cf-408b-99ef-39cc239f60fd</shipment_id>



<shipment_date>2019-11-18T21:00:00.000Z</shipment_date>

<reception_date>2019-11-18T21:00:00.000Z</reception_date>




<turnover_type>SELLING</turnover_type>

<products_list>


<product>

<ki><![CDATA[000000000000000000000000000000000]]></ki>

<accept_type>true</accept_type>

</product>

</products_list>

</acceptance>

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



LK_RECEIPT Вывод из оборота. JSON (MANUAL)

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

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


{

"action": "string",

"action_date": "2020-01-23",



"document_type": "string",

"inn": "string",

111

"kkt_number": "string",

"orderDate": "2020-01-23",

"order_number": "string",



"products": [

{

"cis": "string",



"document_type": "string",


"product_cost": 0

}

]

}



1 action Причина вывода

из оборота enum +



EEC_EXPORT – Экспорт в страны

ЕАЭС;

BEYOND_EEC_EXPORT – Экспорт

за пределы стран ЕАЭС;

RETURN – Возврат физическому

лицу;

REMOTE_SALE – Продажа по

образцам, дистанционный способ

продажи;

DAMAGE_LOSS – Утрата или

повреждение;



LIQUIDATION – Ликвидация

предприятия;

ENTERPRISE_USE – Использование

для собственных нужд предприятия

2 action_date Дата вывода из

оборота string + Задается в формате yyyy-MM-dd

3 document_date

Дата


документа


4 document_number

Номер


документа

string +

5 document_type Вид первичного


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

параметра action:

RETAIL – Розничная реализация:

RECEIPT – Кассовый чек

SALES_RECEIPT – Товарный чек

112


OTHER – Прочее (с указанием

наименования вручную)


за пределы стран ЕАЭС:

CUSTOMS_DECLARATION –

Таможенная декларация на товары


ЕАЭС:

CONSIGNMENT_NOTE – Товарная

накладная

UTD – Универсальный передаточный

документ




лицу:





продажи:




накладная;


документ;



повреждение:

DESTRUCTION_ACT - Акт

уничтожения (утраты/утилизации)



DESTRUCTION – Уничтожение:

DESTRUCTION – Акт уничтожения

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



CONFISCATION – Конфискация:


накладная;


документ;


LIQUIDATION –Ликвидация

предприятия:

113



накладная;


документ;


ENTERPRISE_USE –

Использование для собственных

нужд предприятия:


уничтожения (утраты/утилизации);


6 inn ИНН УОТ string +

7 kkt_number

Контрольно-

кассовая

техника

string - Номер кассы

8 pdfFile

Приложенный

PDF файл в

Base64

string -

9 primary_document_custo

m_name



документа

string -



прочее

10 products Товар в заявке array +

11 cis КИ string + КИ

12 primary_document_date Дата первичного

документа string

(date) + Задается в формате yyyy-MM-dd

13 primary_document_num

ber

Номер





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

параметра action:

RETAIL – Розничная реализация:

RECEIPT – Кассовый чек

SALES_RECEIPT – Товарный чек




за пределы стран ЕАЭС:

CUSTOMS_DECLARATION –

Таможенная декларация на товары


ЕАЭС:


накладная


документ

114





лицу:





продажи:




накладная;


документ;



повреждение:


уничтожения (утраты/утилизации)



DESTRUCTION – Уничтожение:

DESTRUCTION – Акт уничтожения

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



CONFISCATION – Конфискация:


накладная;


документ;


LIQUIDATION – Ликвидация

предприятия:


накладная;


документ;


ENTERPRISE_USE –

Использование для собственных

нужд предприятия:


уничтожения (утраты/утилизации);


115


15 primary_document_custo

m_name



документа

string -



прочее

16 product_cost Цена за единицу integer + Стоимость в копейках, с учетом

НДС


ИНН участника оборота,Причина вывода из оборота,Дата вывода из оборота,Тип

первичного документа,Номер первичного документа,Дата первичного

документа,Наименование первичного документа,Регистрационный номер

ККТ,Версия

00000000000,Розничная продажа,12.04.2019,Кассовый

чек,PDN,12.04.2019,custom,kkt_number,4


КИ,Цена за единицу,Тип первичного документа,Номер первичного документа,Дата

первичного документа,Наименование первичного документа

"00000000000000000000000000000000000000",1000,Кассовый

чек,PDN,12.04.2019,custom



<withdrawal action_id="15" version="4">


<withdrawal_type>RETAIL</withdrawal_type>

<withdrawal_date>12.04.2019</withdrawal_date>


<primary_document_number>PDN</primary_document_number>


<primary_document_custom_name>custom</primary_document_custom_name>

<kkt_number>kkt_number</kkt_number>

<products_list>

<product>

<kit><![CDATA[00000000000000000000000000000000000000]]></kit>

<cost>1000</cost>


<primary_document_number>PDN</primary_document_number>


<primary_document_custom_name>custom</primary_document_custom_name>

</product>

</products_list>

</withdrawal>

Заказ КМ. СУЗ

Работа с КМ описана в документе «Станция управления заказами. Спецификация API».

Списание КМ

2.2.12.1 Списание ненанесенных КИ


https://честныйзнак.рф/upload/iblock/07f/STANTSIYA-UPRAVLENIYA-ZAKAZAMI.pdf

116


LK_KM_CANCELLATION Списание КМ. JSON (MANUAL)

LK_KM_CANCELLATION_CSV Списание КМ. CSV

LK_KM_CANCELLATION_XML Списание КМ. XML


{

"cancellation_doc_date": "2020-01-23",

"cancellation_doc_number": "string",

"cancellation_reason": "string",

"km_list": [

{


"uit": "string",

"uitu": "string"

}

],



}



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

2 cancellation_doc_number

Номер


документа на

списание

string +

3 cancellation_reason Причина

списания string +


KM_SPOILED – испорчен;

KM_LOST – утерян;

KM_DESTROYED – уничтожен

4 km_list Список данных о

КМ array +

5 uit



товара

string - Обязательное, если не указано uitu

6 uitu




упаковки

string - Обязательное, если не указано uit

7 cancellation_reason Код причины






117


8 pdfFile


PDF файл в

Base64

string -




эмиссию КМ

string +


ИНН участника оборота,Причина списания кода маркировки,Дата документа

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

0000000000,Испорчен,12.04.2019,123,2

Параметры кодов маркировки

КИ,КИТУ,Причина списания кода маркировки

"00000000000000000000000000000000000000",,Испорчен



<km_cancellation action_id="14" version="2">


<cancellation_reason>KM_SPOILED</cancellation_reason>

<cancellation_document_date>12.04.2019</cancellation_document_date>

<cancellation_document_number>123</cancellation_document_number>

<km_list>


<km>

<kit><![CDATA[00000000000000000000000000000000000000]]></kit>

<cancellation_reason>KM_LOST</cancellation_reason>

</km>

<km>

<kitu>000000000000000000</kitu>


</km>

</km_list>

</km_cancellation>

2.2.12.2 Списание нанесенных КИ



LK_APPLIED_KM_CANCELLATION Списание нанесенных КИ. JSON (MANUAL)

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

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


{

"cancellation_doc_date": "2020-01-23",

"cancellation_doc_number": "string",


"km_list": [

118

{


"uit": "string",

"uitu": "string"

}

],



}



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

2 cancellation_doc_number

Номер


документа на

списание

string +

3 cancellation_reason Причина






4 km_list Список данных о

КМ array +

5 uit



товара

string - Обязательное, если не указано uitu

6 uitu




упаковки

string - Обязательное, если не указано uit

7 cancellation_reason Код причины






8 pdfFile


PDF файл в

Base64

string -




эмиссию КМ

string +


ИНН участника оборота,Причина списания кода маркировки,Дата документа

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

0000000000,Испорчен,12.04.2019,123,2

Параметры кодов маркировки

119

КИ,КИТУ,Причина списания кода маркировки

"00000000000000000000000000000000000000",,Испорчен



<km_cancellation action_id="14" version="2">


<cancellation_reason>KM_SPOILED</cancellation_reason>

<cancellation_document_date>12.04.2019</cancellation_document_date>

<cancellation_document_number>123</cancellation_document_number>

<km_list>


<km>

<kit><![CDATA[00000000000000000000000000000000000000]]></kit>


</km>

<km>

<kitu>000000000000000000</kitu>


</km>

</km_list>

</km_cancellation>

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



LK_REMARK Перемаркировка. JSON (MANUAL)

LK_REMARK_CSV Перемаркировка. CSV

LK_REMARK_XML Перемаркировка. XML


{


"products": [

{

"certificate_document": "string",

"certificate_document_date": "2020-01-23",

"certificate_document_number": "string",

"last_uin": "string",

"new_uin": "string",

"remarking_cause": "string",

"remarking_date": "2020-01-23"

}

],

"remarking_cause": "KM_SPOILED",

"remarking_date": "2020-01-23"

}

120



1 participant_inn


осуществившег

о эмиссию КМ

string +

2 remarking_date Дата повторной

маркировки string + Задается в формате yyyy-MM-dd

3 remarking_cause

Код причины

повторной

маркировки

string +


KM_SPOILED – Испорчено либо

утеряно СИ с КМ;

DESCRIPTION_ERRORS –

Выявлены ошибки описания товара.

4 products

Список

сведений о

товарах

array +


Код вида

документа



string -






6 certificate_document_n

umber

Номер

документа



string -






8 last_uin

Предыдущий

уникальный


товара

string +

9 new_uin

Новый

уникальный


товара

string +

10 remarking_date Дата повторной

маркировки string + Задается в формате yyyy-MM-dd

11 remarking_cause

Код причины

повторной


string +

Причина повторной маркировки:

KM_SPOILED – Испорчено либо

утеряно КИ;

DESCRIPTION_ERRORS – Выявлены

ошибки описания товара

121


ИНН участника,Наименование участника,Дата повторной маркировки,Причина

повторной маркировки,

0000000000,participant,12.04.2019,Выявлены ошибки описания товара

Дата повторной маркировки,Причина повторной маркировки,Предыдущий КИ,Новый

КИ,Вид документа обязательной сертификации,Номер документа обязательной

сертификации,Дата документа обязательной сертификации

12.04.2019,,"00000000000000000000000000000000000000","111111111111111111111

11111111111111111",Сертификат соответствия,123,12.04.2019


<remark action_id="09" version="3">


<remark_date>01.01.2019</remark_date>

<remark_cause>DESCRIPTION_ERRORS</remark_cause>

<products_list>

<product>

<last_kit><![CDATA[00000000000000000000000000000000000000]]></last_kit>

<new_kit><![CDATA[11111111111111111111111111111111111111]]></new_kit>

<remark_date>01.01.2019</remark_date>




</product>

</products_list>

</remark>

122

3 Справочники

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

Код Наименование Описание Формат сообщения об ошибке

200 ОК Статус ответа в случае

успеха -

201 CREATED

Статус ответа в случае

успеха создания

документа

-

202 ACCEPTED Статус ответа в случае

успеха -

400 ERROR

Bad Request

Ошибка в параметрах

запроса (отсутствует

обязательный параметр)

{

"error_message": "Отсутствует обязательный

параметр: <имя обязательного параметра>"

}

Ошибка в параметрах

запроса (неверный тип

параметра)

{

"error_message": "Параметр <имя параметра>

требует значение типа <требуемый тип

параметра>"

}

401 ERROR

Unauthorized Ошибка авторизации

//1 Указан устаревший токен:

<InvalidTokenException>

<error>invalid_token</error>

<error_description>Access token expired:

<токен></error_description>

</InvalidTokenException>

//2 Не указан токен:

<UnauthorizedException>

<error>unauthorized</error>

<error_description>Full authentication is required

to access this resource</error_description>

</UnauthorizedException>

402 ERROR Ошибка в атрибутивном

составе тела запроса

403 ERROR

Forbidden Доступ запрещён

//Если пользователь (УОТ) не имеет доступа к

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

{

"error_message": "Отсутствует доступ к ресурсу"

}

404 ERROR

Not Found

Запрашиваемая

информация не найдена

в ГИС МТ

{

"error_message": "<Описание параметра> не

найден"

}

123

Код Наименование Описание Формат сообщения об ошибке

Ошибка в указании URL

метода

{

"error_message": "Метод с указанным URL не

найден"

}

409 ERROR

Запрос не может быть

выполнен из-за

конфликтного

обращения к ресурсу

410 ERROR

Ресурс ранее был

доступен по указанному

URL, но сейчас он

удалён и недоступен

413 ERROR Превышен допустимый

размер тела запроса

{

"error_message": "Слишком большой запрос"

}

453 ERROR

Подпись другого

документа, некорректна

или отсутствует

обязательный заголовок

454 ERROR Подпись не принадлежит

сотруднику организации

500

ERROR

Internal server

Error

Внутренняя ошибка

удалённых систем

(технически

детализированное

описание не

возвращается)

{

"error_message": "Ошибка при выполнении

запроса"

}

503

ERROR

Service

Unavailable

Проблема с доступом к

удалённой системе

{

"error_message": "Удаленная система

недоступна"

}

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

Параметр Описание Примечание

brand Торговая Марка / Бренд

productType Вид обуви

productTypeDesc Текстовое описание вида обуви

name Полное наименование товара

productSize Размер в штихмассовой системе

color Цвет

materialUpper Материал верха

124


materialLining Материал подкладки

materialDown Материал низа / подошвы

model Модель / артикул


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

столовое, туалетное и кухонное


brand Товарный знак


type Вид товара

size Размер изделия

color Цвет

textileType Тип текстиля

structure Состав

consumer_age Возраст потребителя

gender Целевой пол



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

фотовспышки и лампы-вспышки


brand Товарный знак


type Вид товара

standardNumber Номер регламента / стандарта



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





125


productKind Вид товара

productionYear Год производства

engineType Тип двигателя

enginePower Мощность двигателя, л.с.

electricEnginePower Мощность электродвигателя,

Вт

frameSize Размер рамы

color Цвет

weightGross Вес брутто

frameMaterial Материал рамы

rimDiameter Посадочный диаметр обода,

дюйм

sectionWidth Ширина профиля, дюйм

brakeSystemType Тип тормозной системы

frontForkType Тип передней вилки

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



productKind Вид товара



weightGross Вес брутто

maximumLoad Максимальная нагрузка, кг

seatDepth Глубина сиденья

seatWidth Ширина сиденья

seatHeight Высота сиденья

backHeight Высота спинки

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



perfumeryType Тип парфюмерии

volume Заявленный объем

packageType Тип упаковки

packMaterial Материал упаковки

126

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

резиновые новые


brand Торговый знак



tireSectionWidth Ширина профиля шины

(камеры), мм

heightWidthRatio Номинальное отношение

высоты профиля шины к его

ширине, %

frameConstructionType Тип конструкции каркаса шины

tireLoadIndex Индекс нагрузки на шину

speedCategory Категория скорости

seasonality Сезонность

frameSealingType Тип шины по способу

герметизации

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



milkProductType Тип продукта

rawOrigin Происхождение сырья

fat Жирность, %

volumeWeight Заявленный объём / вес нетто

vetisId Идентификатор товара в ФГИС

ВетИС

babyFoodProduct Продукция для детского

питания

structure Состав

Справочник "Ошибки обработки документов"

Формирование текста уведомления

В случае возникновения ошибки валидации документа, в системе формируется

уведомление об ошибке. Уведомление об ошибке содержит код ошибки и текст. Текст

127

уведомления содержит информацию о возникшей ошибке, наименование поля, проверка

которого вызвала ошибку, и формат передаваемого файла.

Отображение уведомлений об ошибках

Документы, обработанные с ошибкой, сохраняются в системе и отображаются в реестре

документов со статусом Обработан с ошибкой.

Проверка Ошибка Код

ошибки Текст уведомления

Проверки формата файла

Проверка размера

передаваемого файла

Размер передаваемого

файла превышает

допустимый

26

26: Размер передаваемого файла

превышает допустимый. Создание

документа <тип документа>

недоступно.

Проверка соответствия

XSD-схеме передаваемого

файла XML

Передаваемый файл

обмена не соответствует

XSD-схеме.

28 28: Передаваемый файл XML не

соответствует XSD-схеме.

Проверка формата


JSON.

Недопустимый формат


JSON

29 29: Недопустимый формат

передаваемого файла JSON.



CSV.



CSV

34 34: Недопустимый формат

передаваемого файла CSV.

Проверки форматно-логического контроля

Проверка заполненности

поля Значение не указано 01

01: Не заполнено поле

<наименование поля> в документе

<тип документа>.


поля

Значение поля должно

быть пустым 44

44: Значение поля <наименование

поля> в документе <тип документа>

должно быть пустым.


комбинации полей

Не заполнено ни одно из

полей.

47

47: Не заполнено ни одно из

полей: Должно быть заполнено хотя

бы одно из полей <наименование

поля_1> и <наименование поля_2>

в документе <тип документа>.

Заполнено более одного

поля.

47: Заполнено более одного

поля: Одновременное заполнение

полей <наименование

поля_1> и <наименование

поля_2> в документе <тип

документа> недопустимо.

128



Проверка комбинации

значений

Недопустимая

комбинация значений

параметров

55

55: Недопустимая комбинация

значений полей <наименование


поля_2> в документе <тип

документа>.


значения


значения 03

03: Недопустимый формат значения

поля <наименование поля>

в документе <тип документа>.

Проверка значений

перечисления

Значение не найдено в

списке допустимых 08


поля> в документе <тип документа>

не найдено в списке допустимых.

Проверка диапазона дат Значение даты вне

допустимого диапазона 04

04: Значение даты, указанной в поле

<наименование поля> в документе

<тип документа>, вне допустимого

диапазона.

Проверка числового

диапазона

Значение находится вне

допустимого числового

диапазона

05


поля> в документе <тип

документа> находится вне

допустимого числового диапазона.

Проверка количества

символов

Недопустимое

количество символов 07

07: Недопустимое количество

символов в значении

поля <наименование поля>

<значение поля>в документе <тип



массива Пустой массив 13

13: В документе <тип документа> не

указан ни один товар.

Проверка уникальности

значения в текущем

массиве

Не уникальное значение

в текущем массиве 16


поля> не уникально в текущем

массиве в документе <тип


Проверки бизнес-логики

Поиск в базе данных

Поиск значения в базе

данных

Значение не найдено в

базе данных 06


поля> <значение поля> в документе

<тип документа> не найдено в базе

данных.


значения в базе данных

Значение не уникально в

базе данных 17


поля> <значение поля> в документе

<тип документа> не уникально в базе

данных.

129




комбинации значений

параметров в базе

данных

Не

уникальная комбинация

значений параметров в

базе данных

56

56: Комбинация значений

полей <наименование

поля_1> <значение


поля_2> <значение поля_2> в

документе <тип документа> уже

используется в базе данных.

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


данным текущего УОТ

Значение не

соответствует данным

текущего УОТ

02

02: <наименование поля> <значение

поля> в документе <тип

документа> не соответствует данным

текущего УОТ

Проверка статуса УОТ Недопустимый статус

УОТ 18

18: Недопустимый статус участника,

найденного по ИНН <значение

поля>, указанному в

поле <наименование поля> в

документе <тип документа>.

Проверка типа УОТ Недопустимый тип УОТ 35

35: Недопустимый тип участника,

найденного по ИНН <значение

поля>, указанному в

поле <наименование поля> в


Проверка товарной

группы УОТ

Несоответствие

товарной группы 40

40: <наименование параметра>

<значение параметра> в документе

<тип документа>, не соответствует

товарным группам участника.

Поиск организации

в ЕГРЮЛ/ЕГРИП/РАФП

Организация не найдена

в ЕГРЮЛ/ЕГРИП/РАФП 42

42: Организация <наименование

организации> <ИНН организации>

не найдена в ЕГРЮЛ/ЕГРИП/РАФП.

Проверка

статуса организации


Недопустимый статус

организации


43

43: Недопустимый статус

организации в

ЕГРЮЛ/ЕГРИП/РАФП, найденного

по ИНН <значение поля>,

указанному в поле <наименование

поля> в документе <тип документа>.

Проверка значения на

соответствие данным

сертификата УКЭП

Значение не

соответствует

параметрам сертификата

УКЭП

27 27: Значение не соответствует

данным сертификата УКЭП.

Проверки параметров кода маркировки

130




значениям параметров

кода маркировки




48

48: Недопустимое

значение параметра <наименование

параметра> кода

маркировки <значение КИ> в


Проверка статуса товара Недопустимый статус

товара 09

09: Недопустимый статус товара,

найденного по

параметру <наименование

поля> <значение поля>, в документе


Проверка статуса кода



кода маркировки 14

14: Недопустимый статус кода

маркировки <значение КИ либо

КИТУ>, указанного в документе


Проверка собственника

товара

Товар не принадлежит

УОТ 10

10: Товар <значение КИ>,

указанный в документе <тип

документа>, не принадлежит

участнику оборота.

Проверка собственника


Код маркировки не

принадлежит УОТ 11

11: Код маркировки <значение КИ

либо КИТУ>, указанный в документе

<тип документа>, не принадлежит

участнику оборота.

Проверка причины

вывода из оборота

Недопустимая причина

вывода из оборота 57

57: Недопустимая причина вывода из

оборота кода маркировки <значение

КИ либо КИТУ>: <причина вывода

из оборота>.


параметра в базе данных Значение не указано 50

50: Для кода маркировки <значение

КИ либо КИТУ> не указано значение

параметра <наименование поля> в

базе данных.


параметров кодов

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

Не идентичные значения

параметров кодов


51

51: Значения

параметра <наименование

параметра> кодов маркировки

<значение КИ_1> и <значение

КИ_2>, указанных в документе <тип

документа>, не идентичны.

Проверка наличия

родительского кода


Код идентификации уже

имеет родительский код


58

58: Код идентификации <значение

КИ> уже имеет родительский код

маркировки<значение родительского

кода>.

131



Проверка родительского


Нарушение иерархии

упаковки 52

52: Упаковка <значение

родительского кода упаковки>, не

может быть помещена в упаковку

<значение перемещаемого кода

упаковки>.

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

Проверка типа

документа

Недопустимый тип

документа 36

36: Недопустимый тип документа,

найденного по ID <ID документа>,

указанному в поле <наименование

поля> в документе <тип документа>.



связанного документа


параметрам связанного

документа

49


поля> <значение параметра> в

документе <тип документа> не

соответствует значению поля

<наименование поля связанного

документа> в документе <тип

связанного документа>.

Поиск в массиве

связанного документа

Значения не найдены в

массиве связанного

документа

12

12: В списке товаров документа <тип

документа> не найден(ы) коды

идентификации:

<значение КИ1>,



<значение КИn>.

Проверка статуса

документа


документа 37

37: Недопустимый статус связанного

документа <тип документа><ID


Проверка условия

передачи товара

Невозможное условие

передачи товаров 22

22: Невозможное условие передачи

товара <значение КИ либо КИТУ> в


Проверки товарной группы

Проверка статуса

товарной группы


товарной группы 59

59: Создание документа <тип

документа> недоступно для текущей

товарной группы.


товарной группе


товарной группе 54

54: Создание документа <тип

документа> недоступно для текущей

товарной группы.

Описание API ГИС МТ...

Documents

Transcript of Описание API ГИС МТ...