Описание api ГИС МТ...
TRANSCRIPT
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
• содержит символ "," в контенте файла в качестве разделителя.
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:
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) - необходимо иметь личный кабинет с хотя бы одной подключенной
товарной группой ГИС МТ ("Предметы одежды, белье постельное, столовое, туалетное и
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/
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-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
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-
ddTHH:mm:ss.SSS'Z. Пример 2019-01-01T03:00:00.000Z
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",
"exporterName": "string",
"exporterTaxpayerId": "string",
"gtin": "string",
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
"packType": "string",
"parent": "string",
"participantInn": "string",
"participantName": "string",
"prVetDocument": "string",
"prevCises": [
"string"
],
"producedDate": "2020-01-23T16:17:48Z",
"productName": "string",
"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 +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
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 – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
28 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
29 cis string + Код идентификации, используемый для фильтрации по
списку КМ
30 countChildren integer
(int32) - Количество дочерних КИ
16
№ Параметр Тип Обяз. Описание
31 dateChange
string
(date-
time)
- Дата внесения изменений в КИТУ. Задается в формате
yyyy-MM-dd
32 emissionDate
string
(date-
time)
+ Дата эмиссии КИ. Задается в формате yyyy-MM-dd
33 emissionType string +
Тип эмиссии:
LOCAL – Производство РФ;
FOREIGN – Ввезен в РФ;
REMAINS – Маркировка остатков;
CROSSBORDER – Ввезен из стран ЕАЭС
34 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
35 exporterName string - Наименование экспортера
36 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
37 gtin string - Код товара
38 introducedDate
string
(date-
time)
- Дата ввода в оборот с КИ в оборот. Задается в формате
yyyy-MM-dd
39 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
40 nextCises [string] - Следующие номера КИ при перемаркировке
41 ownerInn string - ИНН собственника товара
42 ownerName string - Наименование собственника товара
43 packageType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
44 parent string - КИТУ вышестоящего уровня
45 participantInn string - ИНН участника, осуществившего эмиссию КМ
46 participantName string - Наименование участника оборота товаров
47 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
17
№ Параметр Тип Обяз. Описание
48 prevCises string - Предыдущие номера КИ
49 producedDate
string
(date-
time)
- Дата ввода товара с КИ в оборот. Задается в формате yyyy-
MM-dd
50 productName string - Наименование товара на этикетке
51 receiptDate
string
(date-
time)
- Дата вывода из оборота. Задается в формате yyyy-MM-dd
52 sgtin string - Код товара и серийный номер КИ
53 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
54 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
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 – Продажа по образцам, дистанционный
способ продажи;
DAMAGE_LOSS – Утрата или повреждение;
DESTRUCTION – Уничтожение;
CONFISCATION – Конфискация;
LIQUIDATION – Ликвидация предприятия;
DONATION – Безвозмездная передача;
STATE_ENTERPRISE – Приобретение гос.предприятием;
NO_RETAIL_USE – Использование для собственных нужд
покупателем;
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' \
-H 'Authorization: Bearer <ТОКЕН>'
Параметры запроса:
№ Параметр Тип Обяз. Описание
1 cis string + Код идентификации
Примеры ответов:
{
"agentInn": "string",
"agentName": "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",
"exporterName": "string",
"exporterTaxpayerId": "string",
"sgtin": "string",
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
"packageType": "string",
"parent": "string",
"prVetDocument": "string",
"prevCises": [
"string"
],
"producedDate": "2020-01-23T16:17:48Z",
"producerName": "string",
"productName": "string",
"status": "string",
"statusEx": "string"
}
],
"cis": "string",
"countChildren": 0,
"dateChange": "2020-01-23T16:17:48Z",
"emissionDate": "2020-01-23T16:17:48Z",
"emissionType": "string",
"expireDate": "2020-01-23T16:17:48Z",
"exporterName": "string",
"exporterTaxpayerId": "string",
"gtin": "string",
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
"packType": "string",
"parent": "string",
"participantInn": "string",
"participantName": "string",
"prVetDocument": "string",
"prevCises": [
"string"
],
20
"producedDate": "2020-01-23T16:17:48Z",
"productName": "string",
"receiptDate": "2020-01-23T16:17:48Z",
"sgtin": "string",
"status": "string",
"statusEx": "string",
"tnVedEaes": "string",
"tnVedEaesGroup": "string",
"uit": "string",
"uitu": "string",
"withdrawReason": "string"
}
Параметры заголовка запроса: Authorization: Bearer <token>
Параметры ответа:
№ Параметр Тип Обяз. Описание
1 agentInn string - ИНН текущего владельца товара
2 agentName string - Наименование текущего владельца товара
3 children: - КИ в агрегате
4 brand string - Бренд
5 children: [string] - Все Дочерние КИ. Выглядит как JSON массив
6 childrenMap - Краткая информация о дочерних КИ (рекурсия)
7 cis string + КИ товара
8 countChildren integer
(int32) - Количество дочерних КИ
9 emissionDate
string
(date-
time)
+ Дата эмиссии. Задается в формате yyyy-MM-dd
10 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
11 exporterName string - Наименование экспортера
12 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
13 sgtin string - Код товара и серийный номер КИ
14 introducedDate
string
(date-
time)
- Дата ввода в оборот. Задается в формате yyyy-MM-dd
15 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
16 nextCises [string] - Следующие номера КИ при перемаркировке
21
№ Параметр Тип Обяз. Описание
17 ownerInn string - ИНН собственника товара
18 ownerName string - Наименование собственника товара
19 packType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
20 parent string - Код идентификации упаковки, в которую агрегирован
товар
21 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
22 prevCises [string] - Предыдущие КИ (перемаркировка)
23 producedDate
string
(date-
time)
- Дата нанесения. Задается в формате yyyy-MM-dd
24 producerName string - Производитель товара
25 productName string - Название продукта
26 status enum +
Статус товара/КИ:
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
27 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
28 cis string + Код идентификации, используемый для фильтрации по
списку КМ
29 countChildren integer
(int32) - Количество дочерних КИ
22
№ Параметр Тип Обяз. Описание
30 dateChange
string
(date-
time)
- Дата внесения изменений в КИТУ. Задается в формате
yyyy-MM-dd
31 emissionDate
string
(date-
time)
+ Дата эмиссии КИ. Задается в формате yyyy-MM-dd
32 emissionType string +
Тип эмиссии:
LOCAL – Производство РФ;
FOREIGN – Ввезен в РФ;
REMAINS – Маркировка остатков;
CROSSBORDER – Ввезен из стран ЕАЭС
33 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
34 exporterName string - Наименование экспортера
35 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
36 gtin string - Код товара
37 introducedDate
string
(date-
time)
- Дата ввода в оборот с КИ в оборот. Задается в формате
yyyy-MM-dd
38 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
39 nextCises [string] - Следующие номера КИ при перемаркировке
40 ownerInn string - ИНН собственника товара
41 ownerName string - Наименование собственника товара
42 packageType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
43 parent string - КИТУ вышестоящего уровня
44 participantInn string - ИНН участника, осуществившего эмиссию КМ
45 participantName string - Наименование участника оборота товаров
46 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
23
№ Параметр Тип Обяз. Описание
47 prevCises string - Предыдущие номера КИ
48 producedDate
string
(date-
time)
- Дата ввода товара с КИ в оборот. Задается в формате yyyy-
MM-dd
49 productName string - Наименование товара на этикетке
50 receiptDate
string
(date-
time)
- Дата вывода из оборота. Задается в формате yyyy-MM-dd
51 sgtin string - Код товара и серийный номер КИ
52 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
53 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
54 tnVedEaes string - Код товарной номенклатуры (10 знаков)
55 tnVedEaesGroup string - Код товарной позиции ТН ВЭД ЕАЭС товара
56 uit string - КИ, Обязательный, если не указан uitu
57 uitu string - КИТУ, Обязательный, если не указан uit
24
№ Параметр Тип Обяз. Описание
58 withdrawReason string -
Причина вывода из оборота:
KM_SPOILED – Испорчен;
KM_SPOILED_OR_LOST – Испорчен либо утерян СИ с КМ;
KM_LOST – Утерян;
KM_DESTROYED – Уничтожен;
DESCRIPTION_ERRORS - Выявлены ошибки описания товара;
RETAIL – Розничная продажа;
EEC_EXPORT – Экспорт в страны ЕАЭС;
BEYOND_EEC_EXPORT – Экспорт за пределы стран ЕАЭС;
RETURN – Возврат физическому лицу;
REMOTE_SALE – Продажа по образцам, дистанционный
способ продажи;
DAMAGE_LOSS – Утрата или повреждение;
DESTRUCTION – Уничтожение;
CONFISCATION – Конфискация;
LIQUIDATION – Ликвидация предприятия;
DONATION – Безвозмездная передача;
STATE_ENTERPRISE – Приобретение гос.предприятием;
NO_RETAIL_USE – Использование для собственных нужд
покупателем;
ENTERPRISE_USE – Использование для собственных нужд
предприятия
Метод получения списка товаров по заданному фильтру
Метод возвращает список товаров с подробной информацией, которые доступны в
данный момент времени участнику оборота товаров (ИНН организации содержится в токене),
согласно заданному фильтру.
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&\
orderedColumnValue=2019-01-23T08:42:17.593Z&pageDir=NEXT' \
-H 'Authorization: Bearer <ТОКЕН>'
Параметры заголовка запроса: Authorization: Bearer <token>
Параметры запроса:
№ Параметр Тип Обяз. Описание
1 cache boolean -
Флаг использование кэша. При включенном флаге УОТ
получает в ответ не более установленного лимита кода
маркировки 1524
25
№ Параметр Тип Обяз. Описание
2 cis string - Код идентификации, используемый для фильтрации по
списку КМ
3 cisAggregationStat enum -
Состояние КИ:
PACKED- в агрегате (агрегирован);
NOT_PACKED – не в агрегате (дезагрегирован);
ANY – любое состояние
4 cisPackageType enum -
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
5 cisStatus string -
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
6 emissionDateFrom date-
time -
Дата эмиссии, от. Задается в формате yyyy-MM-
ddTHH:mm:ss.SSS'Z. Пример 2019-01-01T03:00:00.000Z
7 emissionDateTo date-
time -
Дата эмиссии, до. Задается в формате yyyy-MM-
ddTHH:mm:ss.SSS'Z. Пример 2019-01-01T03:00:00.000Z
8 emissionType string -
Тип эмиссии:
LOCAL – Производство РФ;
FOREIGN – Ввезен в РФ;
REMAINS – Маркировка остатков;
CROSSBORDER – Ввезен из стран ЕАЭС
9 gtin string - Код товара
10 limit integer -
Максимальное количество записей, которое вернется в
качестве ответа, не более 10000 записей. (По умолчанию 10
записей)
11 order string -
Направление сортировки:
ASC – по возрастанию;
DESC – по убыванию
12 orderColumn string - Название столбца, по которому будет производиться
сортировка. Допустимое значение emd - дата эмиссии
13 orderedColumnValu
e string -
Значение столбца – “точки отсчета” (запись с которой
начнется выборка), по которому сортируются записи
26
№ Параметр Тип Обяз. Описание
14 packs string -
Фильтрация по товарным упаковкам:
ALL – товары и упаковки;
UNIT – только товары;
PACK – только упаковки
15 pageDir -
Выбор направления:
PREV – вперед;
NEXT – назад
16 pg array -
Товарная группа:
параметр обязательно указывать для товарных групп:
milk – Молочная продукция;
water – Вода;
otp – альтернативная табачная продукция
17 producerInn string - ИНН производителя
18 sn string - Серийный номер
19 statusExt enum -
Расширенный статус КИ:
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 – Ликвидация предприятия
20 tnVed10 string - Код товарной номенклатуры (10 знаков)
21 tree string -
Способ вывода дерева списка КИ/КИТУ:
NO_TREE – Не возвращать вложенные КИ;
ONE_LEVEL – Возвращать только первый уровень
вложенности;
ALL_TREE – Возвращать все дерево
22 turnoverType enum -
Вид товарооборота:
SELLING - продажа;
COMMISSION - комиссия;
AGENT - агент
27
Пример ответа:
{
"results": [
{
"agentInn": "string",
"agentName": "string",
"children": [
{
"brand": "string",
"children": [
"string"
],
"childrenMap": [
null
],
"cis": "string",
"countChildren": 0,
"emissionDate": "2020-01-23T16:17:48Z",
"expireDate": "2020-01-23T16:17:48Z",
"exporterName": "string",
"exporterTaxpayerId": "string",
"sgtin": "string",
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
"packageType": "string",
"parent": "string",
"prVetDocument": "string",
"prevCises": [
"string"
],
"producedDate": "2020-01-23T16:17:48Z",
"producerName": "string",
"productName": "string",
"status": "string",
"statusEx": "string"
}
],
"cis": "string",
"countChildren": 0,
"dateChange": "2020-01-23T16:17:48Z",
"emissionDate": "2020-01-23T16:17:48Z",
"emissionType": "string",
"expireDate": "2020-01-23T16:17:48Z",
"exporterName": "string",
"exporterTaxpayerId": "string",
"gtin": "string",
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
28
"packType": "string",
"parent": "string",
"participantInn": "string",
"participantName": "string",
"prVetDocument": "string",
"prevCises": [
"string"
],
"producedDate": "2020-01-23T16:17:48Z",
"productName": "string",
"receiptDate": "2020-01-23T16:17:48Z",
"sgtin": "string",
"status": "string",
"statusEx": "string",
"tnVedEaes": "string",
"tnVedEaesGroup": "string",
"uit": "string",
"uitu": "string",
"withdrawReason": "string"
}
]
}
Параметры ответа:
№ Параметр Тип Обяз. Описание
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 - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
29
№ Параметр Тип Обяз. Описание
14 sgtin string - Код товара и серийный номер КИ
15 introducedDate
string
(date-
time)
- Дата ввода в оборот. Задается в формате yyyy-MM-dd
16 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
17 nextCises [string] - Следующие номера КИ при перемаркировке
18 ownerInn string - ИНН собственника товара
19 ownerName string - Наименование собственника товара
20 packType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
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 – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
30
№ Параметр Тип Обяз. Описание
28 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
29 cis string + Код идентификации, используемый для фильтрации по
списку КМ
30 countChildren integer
(int32) - Количество дочерних КИ
31 dateChange
string
(date-
time)
- Дата внесения изменений в КИТУ. Задается в формате
yyyy-MM-dd
32 emissionDate
string
(date-
time)
+ Дата эмиссии КИ. Задается в формате yyyy-MM-dd
33 emissionType string +
Тип эмиссии:
LOCAL – Производство РФ;
FOREIGN – Ввезен в РФ;
REMAINS – Маркировка остатков;
CROSSBORDER – Ввезен из стран ЕАЭС
34 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
35 exporterName string - Наименование экспортера
36 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
37 gtin string - Код товара
38 introducedDate
string
(date-
time)
- Дата ввода в оборот с КИ в оборот. Задается в формате
yyyy-MM-dd
39 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
40 nextCises [string] - Следующие номера КИ при перемаркировке
41 ownerInn string - ИНН собственника товара
42 ownerName string - Наименование собственника товара
31
№ Параметр Тип Обяз. Описание
43 packageType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
44 parent string - КИТУ вышестоящего уровня
45 participantInn string - ИНН участника, осуществившего эмиссию КМ
46 participantName string - Наименование участника оборота товаров
47 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
48 prevCises string - Предыдущие номера КИ
49 producedDate
string
(date-
time)
- Дата ввода товара с КИ в оборот. Задается в формате yyyy-
MM-dd
50 productName string - Наименование товара на этикетке
51 receiptDate
string
(date-
time)
- Дата вывода из оборота. Задается в формате yyyy-MM-dd
52 sgtin string - Код товара и серийный номер КИ
53 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
54 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
55 tnVedEaes string - Код товарной номенклатуры (10 знаков)
56 tnVedEaesGroup string - Код товарной позиции ТН ВЭД ЕАЭС товара
32
№ Параметр Тип Обяз. Описание
57 uit string - КИ, Обязательный, если не указан uitu
58 uitu string - КИТУ, Обязательный, если не указан uit
59 withdrawReason string -
Причина вывода из оборота:
KM_SPOILED – Испорчен;
KM_SPOILED_OR_LOST – Испорчен либо утерян СИ с КМ;
KM_LOST – Утерян;
KM_DESTROYED – Уничтожен;
DESCRIPTION_ERRORS - Выявлены ошибки описания товара;
RETAIL – Розничная продажа;
EEC_EXPORT – Экспорт в страны ЕАЭС;
BEYOND_EEC_EXPORT – Экспорт за пределы стран ЕАЭС;
RETURN – Возврат физическому лицу;
REMOTE_SALE – Продажа по образцам, дистанционный
способ продажи;
DAMAGE_LOSS – Утрата или повреждение;
DESTRUCTION – Уничтожение;
CONFISCATION – Конфискация;
LIQUIDATION – Ликвидация предприятия;
DONATION – Безвозмездная передача;
STATE_ENTERPRISE – Приобретение гос.предприятием;
NO_RETAIL_USE – Использование для собственных нужд
покупателем;
ENTERPRISE_USE – Использование для собственных нужд
предприятия
Метод получения информации о маркированном товаре
Метод возвращает список товаров с подробной информацией, которые доступны в
данный момент времени (товары, введенные в оборот) участнику оборота товаров (ИНН
организации содержится в токене), согласно заданному фильтру.
URL: /api/v3/facade/marked_products/info
Метод: GET
Пример запроса:
curl -X GET
'https://ismp.crpt.ru/api/v3/facade/marked_products/info?cis=01046300340700
2921wskg1E44R1qym2406401' \
-H 'Authorization: Bearer <ТОКЕН>'
Параметры запроса:
№ Параметр Тип Обяз. Описание
1 cis string + уникальный идентификатор товара (КИ)
33
Ответ:
{
"agentInn": "string",
"agentName": "string",
"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",
"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"
}
],
"childrenDetails": [
null
],
"cis": "string",
"countChildren": 0,
"docNum": "string",
"emissionDate": "2020-01-23T16:17:48Z",
"emissionType": "string",
"expireDate": "2020-01-23T16:17:48Z",
"exporterName": "string",
"exporterTaxpayerId": "string",
"gtin": "string",
34
"introducedDate": "2020-01-23T16:17:48Z",
"lastDocId": "string",
"model": "string",
"name": "string",
"nextCises": [
"string"
],
"ownerInn": "string",
"ownerName": "string",
"packType": "string",
"prVetDocument": "string",
"prevCises": [
"string"
],
"previousAgentInn": "string",
"previousAgentName": "string",
"producedDate": "2020-01-23T16:17:48Z",
"producerInn": "string",
"producerName": "string",
"productName": "string",
"remarks": [
{
"curr": "string",
"date": "string",
"prev": "string"
}
],
"sgtin": "string",
"status": "string",
"statusEx": "string",
"tnvd": "string",
"tnvedGroup": "string",
"turnoverType": "string",
"uitu": "string",
"withdrawReason": "string"
}
Параметры заголовка запроса: Authorization: Bearer <token>
Параметры ответа:
№ Параметр Тип Обяз. Описание
1 agentInn string - ИНН текущего владельца товара
2 agentName string - Наименование текущего владельца товара
3 brand string - Бренд
4 certDoc - Сертификат
5 date string - Дата сертификата. Задается в формате yyyy-MM-dd
6 number string - Номер сертификата
7 type string - Тип сертификата
8 children: - КИ в агрегате
35
№ Параметр Тип Обяз. Описание
9 brand string - Бренд
10 children: [string] - Все КИ в агрегате. Выглядит как JSON массив
11 childrenMap - Краткая информация о дочерних КИ (рекурсия)
12 cis string + КИ товара
13 countChildren integer
(int32) - Количество дочерних КИ
14 emissionDate
string
(date-
time)
+ Дата эмиссии. Задается в формате yyyy-MM-dd
15 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
16 exporterName string - Наименование экспортера
17 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
18 sgtin string - Код товара и серийный номер КИ
19 introducedDate
string
(date-
time)
- Дата ввода в оборот. Задается в формате yyyy-MM-dd
20 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
21 nextCises [string] - Следующие номера КИ при перемаркировке
22 ownerInn string - ИНН собственника товара
23 ownerName string - Наименование собственника товара
24 packageType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
25 parent string - Код идентификации упаковки, в которую агрегирован
товар
26 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
27 prevCises [string] - Предыдущие КИ (перемаркировка)
36
№ Параметр Тип Обяз. Описание
28 producedDate
string
(date-
time)
- Дата нанесения. Задается в формате yyyy-MM-dd
29 producerName string - Производитель товара
30 productName string - Название продукта
31 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
32 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
33 childrenDetails - Маркированный товар (рекусрия)
34 cis string + Код идентификации, используемый для фильтрации по
списку КМ
35 countChildren integer
(int32) - Количество дочерних КИ
36 docNum string - Регистрационный номер документа
37 emissionDate
string
(date-
time)
+ Дата эмиссии КИ. Задается в формате yyyy-MM-dd
38 emissionType string -
Тип эмиссии:
LOCAL – Производство РФ;
FOREIGN – Ввезен в РФ;
REMAINS – Маркировка остатков;
CROSSBORDER – Ввезен из стран ЕАЭС
39 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
40 exporterName string - Наименование экспортера
41 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
37
№ Параметр Тип Обяз. Описание
42 gtin string - Код товара
43 introducedDate
string
(date-
time)
- Дата ввода в оборот с КИ в оборот. Задается в формате
yyyy-MM-dd
44 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
45 model string - Производитель товара
46 name string - Наименование товара
47 nextCises [string] - Следующие номера КИ при перемаркировке
48 ownerInn string - ИНН собственника товара
49 ownerName string - Наименование собственника товара
50 packType +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
51 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
52 prevCises string - Предыдущие номера КИ
53 previousAgentInn string - ИНН предыдущего владельца товара
54 previousAgentName string - Наименование предыдущего владельца товара
55 producedDate
string
(date-
time)
- Дата ввода товара с КИ в оборот. Задается в формате yyyy-
MM-dd
56 producerInn string - ИНН производителя/импортёра товара
57 productName string - Наименование товара на этикетке
58 remarks - Список перемаркировок данного товара
59 curr string - Текущий КИ товара
60 date string - Дата перемаркиовки. Задается в формате yyyy-MM-dd
61 prev string - предыдущие КИ товара
62 sgtin string - Код товара и серийный номер КИ
38
№ Параметр Тип Обяз. Описание
63 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
64 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар (Товар
ожидает перемаркировку)
65 tnvd string - Код товарной номенклатуры (10 знаков)
66 tnvedGroup string - Код товарной позиции ТН ВЭД ЕАЭС товара (первые 4
символа)
67 turnoverType enum -
Вид товарооборота:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент
68 uitu string - КИТУ вышестоящего уровня
69 withdrawReason string -
Причина вывода из оборота:
KM_SPOILED – Испорчен;
KM_SPOILED_OR_LOST – Испорчен либо утерян СИ с КМ;
KM_LOST – Утерян;
KM_DESTROYED – Уничтожен;
DESCRIPTION_ERRORS - Выявлены ошибки описания товара;
RETAIL – Розничная продажа;
EEC_EXPORT – Экспорт в страны ЕАЭС;
BEYOND_EEC_EXPORT – Экспорт за пределы стран ЕАЭС;
RETURN – Возврат физическому лицу;
REMOTE_SALE – Продажа по образцам, дистанционный
способ продажи;
DAMAGE_LOSS – Утрата или повреждение;
DESTRUCTION – Уничтожение;
CONFISCATION – Конфискация;
LIQUIDATION – Ликвидация предприятия;
DONATION – Безвозмездная передача;
STATE_ENTERPRISE – Приобретение гос.предприятием;
NO_RETAIL_USE – Использование для собственных нужд
покупателем;
ENTERPRISE_USE – Использование для собственных нужд
предприятия
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 + уникальный идентификатор товара (КИ)
Параметры заголовка запроса: Authorization: Bearer <token>
Ответ:
"cis": "string",
"gtin": "string",
"producerName": "string",
"status": "EMITTED",
"emissionDate": 0,
"producedDate": 0,
"packageType": "UNIT",
"ownerName": "string",
"ownerInn": "string",
"productName": "string",
"brand": "string",
"prevCises": [
"string"
],
"nextCises": [
"string"
],
"statusEx": "EMPTY",
"children": [
"string"
],
"childrenMap":
{
"brand": "string",
"children": [
"string"
],
"childrenMap": [
null
],
"cis": "string",
"countChildren": 0,
"emissionDate": "2020-01-23T16:17:48Z",
"expireDate": "2020-01-23T16:17:48Z",
"exporterName": "string",
40
"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"
}
"countChildren": 0,
"parent": "string",
"lastDocId": "string",
"expireDate": 0,
"prVetDocument": "string",
"introducedDate": 0,
"exporterName": "string",
"exporterTaxpayerId": "string",
"agentName": "string",
"agentInn": "string",
"lastStatusChangeDate": 0
}
Параметры ответа:
№ Параметр Тип Обяз. Описание
1 cis string + Код идентификации, используемый для фильтрации по
списку КМ
2 gtin string - Код товара
3 producerName string - Производитель товара
4 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
5 emissionDate
string
(date-
time)
+ Дата выпуска КИ. Задается в формате yyyy-MM-dd
41
№ Параметр Тип Обяз. Описание
6 producedDate
string
(date-
time)
- Дата нанесения. Задается в формате yyyy-MM-dd
7 packageType
+
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
8 ownerName string - Наименование текущего владельца товара
9 ownerInn string - ИНН собственника товара
10 productName string - Название продукта
11 brand string - Бренд
12 prevCises [string] - Предыдущие номера КИ
13 nextCises [string] - Следующие номера КИ при перемаркировке
14 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
15 children [string] - КИ в агрегате
16 childrenMap - Краткая информация о дочерних КИ
17 brand string - Бренд
18 children: [string] - Все Дочерние КИ. Выглядит как JSON массив
19 childrenMap - Краткая информация о дочерних КИ (рекурсия)
20 cis string + КИ товара
21 countChildren integer
(int32) - Количество дочерних КИ
22 emissionDate
string
(date-
time)
+ Дата эмиссии. Задается в формате yyyy-MM-dd
42
№ Параметр Тип Обяз. Описание
23 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
24 exporterName string - Наименование экспортера
25 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
26 sgtin string - Код товара и серийный номер КИ
27 introducedDate
string
(date-
time)
- Дата ввода в оборот. Задается в формате yyyy-MM-dd
28 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
29 nextCises [string] - Следующие номера КИ при перемаркировке
30 ownerInn string - ИНН собственника товара
31 ownerName string - Наименование собственника товара
32 packageType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
33 parent string - Код идентификации упаковки, в которую агрегирован
товар
34 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
35 prevCises [string] - Предыдущие КИ (перемаркировка)
36 producedDate
string
(date-
time)
- Дата нанесения. Задается в формате yyyy-MM-dd
37 producerName string - Производитель товара
38 productName string - Название продукта
43
№ Параметр Тип Обяз. Описание
39 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
40 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
41 countChildren integer
(int32) - Количество дочерних КИ
42 parent string - КИТУ вышестоящего уровня
43 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
44 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
45 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
46 introducedDate
string
(date-
time)
- Дата ввода в оборот с КИ в оборот. Задается в формате
yyyy-MM-dd
47 exporterName string - Наименование экспортера
48 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
49 agentInn string - ИНН текущего владельца товара
50 agentName string - Наименование текущего владельца товара
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 - Список уникальных идентификаторов товара
(КИ)
Параметры заголовка запроса: Authorization: Bearer <token>
Ответ:
{
"0000000000000000000000000000000": {
"cis": "0000000000000000000000000000000",
"gtin": "string",
"producerName": "string",
"status": "EMITTED",
"emissionDate": 0,
"producedDate": 0,
"packageType": "UNIT",
"ownerName": "string",
"ownerInn": "string",
"productName": "string",
"brand": "string",
"prevCises": [
"string"
],
"nextCises": [
"string"
],
"statusEx": "EMPTY",
"children": [
"string"
],
"childrenMap": {},
"countChildren": 0,
"parent": "string",
"lastDocId": "string",
"expireDate": 0,
"prVetDocument": "string",
"introducedDate": 0,
"exporterName": "string",
45
"exporterTaxpayerId": "string",
"agentName": "string",
"agentInn": "string",
"lastStatusChangeDate": 0
},
}
Параметры ответа:
№ Параметр Тип Обяз. Описание
1 cis string + Код идентификации, используемый для фильтрации по
списку КМ
2 gtin string - Код товара
3 producerName string - Производитель товара
4 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
5 emissionDate
string
(date-
time)
+ Дата выпуска КИ. Задается в формате yyyy-MM-dd
6 producedDate
string
(date-
time)
- Дата нанесения. Задается в формате yyyy-MM-dd
7 packageType
+
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
8 ownerName string - Наименование текущего владельца товара
9 ownerInn string - ИНН собственника товара
10 productName string - Название продукта
11 brand string - Бренд
12 prevCises [string] - Предыдущие номера КИ
13 nextCises [string] - Следующие номера КИ при перемаркировке
46
№ Параметр Тип Обяз. Описание
14 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
15 children [string] - КИ в агрегате
16 childrenMap - Краткая информация о дочерних КИ
17 brand string - Бренд
18 children: [string] - Все Дочерние КИ. Выглядит как JSON массив
19 childrenMap - Краткая информация о дочерних КИ (рекурсия)
20 cis string + КИ товара
21 countChildren integer
(int32) - Количество дочерних КИ
22 emissionDate
string
(date-
time)
+ Дата эмиссии. Задается в формате yyyy-MM-dd
23 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
24 exporterName string - Наименование экспортера
25 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
26 sgtin string - Код товара и серийный номер КИ
27 introducedDate
string
(date-
time)
- Дата ввода в оборот. Задается в формате yyyy-MM-dd
28 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
29 nextCises [string] - Следующие номера КИ при перемаркировке
30 ownerInn string - ИНН собственника товара
31 ownerName string - Наименование собственника товара
47
№ Параметр Тип Обяз. Описание
32 packageType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
33 parent string - Код идентификации упаковки, в которую агрегирован
товар
34 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
35 prevCises [string] - Предыдущие КИ (перемаркировка)
36 producedDate
string
(date-
time)
- Дата нанесения. Задается в формате yyyy-MM-dd
37 producerName string - Производитель товара
38 productName string - Название продукта
39 status enum +
Статус товара/КИ:
EMITTED – Эмитирован.Выпущен
APPLIED – Эмитирован.Выдан
INTRODUCED – В обороте
RETIRED – Выбыл
WRITTEN_OFF – КМ списан
DISAGGREGATION – Расформирован (только для
упаковок)
40 statusEx enum -
Расширенный статус КИ:
EMPTY – Нет
WAIT_SHIPMENT – Ожидает приемку
WAIT_TRANSFER_TO_OWNER – Ожидает передачу
собственнику (производство по контракту)
REMARK_RETIRED – Перемаркирован
RETIRED_CANCELLATION – Списание
WAIT_REMARK – КИ списан после нанесения на товар
(Товар ожидает перемаркировку)
41 countChildren integer
(int32) - Количество дочерних КИ
42 parent string - КИТУ вышестоящего уровня
43 lastDocId string - Последний регистрационный номер документа,
зафиксированный в ГИС МТ по этому КИ
44 expireDate
string
(date-
time)
- Дата истечения срока годности. Задается в формате yyyy-
MM-dd (обязательный для ТГ "молоко")
48
№ Параметр Тип Обяз. Описание
45 prVetDocument string - Производственный ветеринарный сопроводительный
документ (обязательный для ТГ "молоко")
46 introducedDate
string
(date-
time)
- Дата ввода в оборот с КИ в оборот. Задается в формате
yyyy-MM-dd
47 exporterName string - Наименование экспортера
48 exporterTaxpayerId string - уникальный идентификатор экспортера в национальной
системе учета налогоплательщиков
49 agentInn string - ИНН текущего владельца товара
50 agentName string - Наименование текущего владельца товара
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' \
-H 'Authorization: Bearer <ТОКЕН>'
Параметры запроса:
№ Параметр Тип Обяз. Описание
1 gtins array + список кодов товаров (gtin)
Параметры заголовка запроса: Authorization: Bearer <token>
Пример ответа:
{
"brand": "string",
49
"goodMarkFlag": true,
"goodSignedFlag": true,
"goodTurnFlag": true,
"gtin": "string",
"id": 0,
"inn": "string",
"innerUnitCount": 0,
"model": "string",
"name": "string",
"packageType": "string",
"productGroupId": 0,
"publicationDate": "2020-01-23",
"tnVedCode": "string"
}
Параметры ответа:
№ Параметр Тип Обяз. Описание
1 brand 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 - Модель производителя
10 name string - Наименование товара
11 packageType string +
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
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' \
-H 'Authorization: Bearer <ТОКЕН>'
Параметры запроса:
№ Параметр Тип Обяз. Описание
1 gtin string - код товара
2 limit integer -
Максимальное количество записей, которое вернется
в качестве ответа, не более 10000 записей. (По
умолчанию 10 записей)
3 offset integer - позиция смещения в наборе результатов для начала
нумерации страниц
4 page integer - Номер страницы ответа, начальное значение 0
51
№ Параметр Тип Обяз. Описание
5
pg string - Товарная группа:
параметр обязательно указывать для товарных групп:
milk – Молочная продукция;
water – Вода;
otp – альтернативная табачная продукция
Пример ответа:
{
"results": [
{
"brand": "string",
"goodMarkFlag": true,
"goodSignedFlag": true,
"goodTurnFlag": true,
"gtin": "string",
"id": 0,
"inn": "string",
"innerUnitCount": 0,
"model": "string",
"name": "string",
"packageType": "string",
"productGroupId": 0,
"publicationDate": "2020-01-23",
"tnVedCode": "string"
}
]
}
Параметры заголовка запроса: Authorization: Bearer <token>
Параметры ответа:
№ Параметр Тип Обяз. Описание
1 results: +
2 brand string - Бренд
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 - Модель производителя
11 name string - Наименование товара
12 packageType string -
Тип упаковки:
UNIT – Единица товара;
LEVEL1 – Упаковка 1-го уровня;
LEVEL2 – Упаковка 2-го уровня;
LEVEL3 – Упаковка 3-го уровня;
LEVEL4 – Упаковка 4-го уровня;
LEVEL5 – Упаковка 5-го уровня;
BUNDLE – Комплект
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&\
orderedColumnValue=2019-01-28T09:30:40.136Z&pageDir=NEXT' \
-H 'content-type: application/json' -H 'Authorization: Bearer <ТОКЕН>'
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-
ddTHH:mm:ss.SSS'Z, пример 2019-01-
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 -
Направление сортировки:
ASC – по возрастанию;
DESC – по убыванию
11 orderColumn string -
Название столбца, по которому будет
производиться сортировка. Допустимое значение
docDate - дата эмиссии
12 orderColumnValue date - Задается в формате yyyy-MM-ddTHH:mm:ss.SSS'Z,
пример 2019-01-01T03:00:00.000Z
13 pageDir enum -
Выбор направления:
PREV – вперед;
NEXT – назад
14 participantInn string - ИНН участника, осуществившего эмиссию КМ
15 pg string -
Товарная группа:
параметр обязательно указывать для товарных
групп:
milk – Молочная продукция;
water – Вода;
otp – альтернативная табачная продукция
Параметры заголовка запроса: Authorization: Bearer <token>
Пример ответа:
{
"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 – Ожидаем
регистрации участника в ГИС МТ. Для отгрузки не УОТ,
вместо CHECKED_OK
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 – Проверяется
CHECKED_OK – Оформлен
CHECKED_NOT_OK – Ошибка
PROCESSING_ERROR – Ошибка при обработке
UNDEFINED – Не определен
CANCELLED – Документ отменен. Для отгрузки, при отмене
отгрузки выставляется этот статус
ACCEPTED – Документ принят. Приемка, для принятой
отгрузки, ставится этот статус (обратный статус
CANCELLED)
58
№ Параметр Тип Обяз. Описание
WAIT_ACCEPTANCE – Ожидание приемки. Для отгрузки,
вместо CHECKED_OK
WAIT_PARTICIPANT_REGISTRATION – Ожидаем
регистрации участника в ГИС МТ. Для отгрузки не УОТ,
вместо CHECKED_OK
PARSE_ERROR – Статус документ, если не удалось
распарсить
WAIT_FOR_CONTINUATION – Ожидаем продолжения
процессинга документа. Для ФТС
11 type 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;
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
59
№ Параметр Тип Обяз. Описание
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;
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;
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;
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). json
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_CSV –
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). csv
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_XML –
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). xml
CROSSBORDER – Ввод в оборот. Трансграничная торговля.
json;
CROSSBORDER_CSV – Ввод в оборот. Трансграничная
торговля. csv;
60
№ Параметр Тип Обяз. Описание
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;
LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка при
трансграничной торговли. xml
LP_CANCEL_SHIPMENT_CROSSBORDER – Отмена
отгрузки при трансграничной торговли. Производство РФ.
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-
ddTHH:mm:ss.SSS'Z, пример 2019-01-
01T03:00:00.000Z
3 dateTo string (date-
time) -
Дата документа, до. Задается в формате yyyy-MM-
ddTHH:mm:ss.SSS'Z, пример 2019-01-
01T03:00:00.000Z
4 participantInn string - ИНН участника, осуществившего эмиссию КМ
5 documentType array[string] -
Тип документа: AGGREGATION_DOCUMENT – Агрегирование. json;
AGGREGATION_DOCUMENT_CSV – Агрегирование.
csv;
61
№ Параметр Тип Обяз. Описание
AGGREGATION_DOCUMENT_XML –
Агрегирование. xml;
DISAGGREGATION_DOCUMENT – Расформирование.
json;
DISAGGREGATION_DOCUMENT_CSV –
Расформирование. csv;
DISAGGREGATION_DOCUMENT_XML –
Расформирование. xml;
REAGGREGATION_DOCUMENT – Трансформация.
json;
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
62
№ Параметр Тип Обяз. Описание
LP_CANCEL_SHIPMENT – Отмена отгрузки. Json;
LK_KM_CANCELLATION – Списание
ненанесенных КИ. json;
LK_KM_CANCELLATION_CSV – Списание
ненанесенных КИ. csv;
LK_KM_CANCELLATION_XML – Списание
ненанесенных КИ. xml;
LK_APPLIED_KM_CANCELLATION – Списание
нанесенных КИ. json;
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;
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). 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;
63
№ Параметр Тип Обяз. Описание
LP_RETURN – Возврат в оборот. json;
LP_RETURN_CSV – Возврат в оборот. csv;
LP_RETURN_XML – Возврат в оборот. xml;
LP_SHIP_GOODS_CROSSBORDER – Отгрузка при
трансграничной торговли. json;
LP_SHIP_GOODS_CROSSBORDER_CSV – Отгрузка
при трансграничной торговли. csv;
LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка
при трансграничной торговли. xml
LP_CANCEL_SHIPMENT_CROSSBORDER – Отмена
отгрузки при трансграничной торговли. Производство
РФ. json
6 documentStatus -
Статус документа:
IN_PROGRESS – Проверяется;
CHECKED_OK – Обработан;
CHECKED_NOT_OK – Обработан с ошибками;
PROCESSING_ERROR – Техническая ошибка;
UNDEFINED – не определен;
CANCELLED – Аннулирован. Только для
документа 'Отмена отгрузки';
ACCEPTED – Принят. Только для документа
'Отгрузка';
WAIT_ACCEPTANCE – Ожидание приемку.
Только для документа 'Отгрузка'. Устанавливается
при успешной обработке документа 'Отгрузка
товара';
WAIT_PARTICIPANT_REGISTRATION -Ожидает
регистрации участника в ГИС МТ. Только для
документа 'Отгрузка'. Устанавливается при
успешной обработке документа 'Отгрузка товара' в
сторону незарегистрированного участника
7 documentFormat -
Тип документа:
MANUAL – формат json;
UPD – ЭДО;
XML – формат xml;
CSV – формат csv
8 inputFormat boolean - входящий (true) / исходящий (false) документ
9 did string -
Значение номера документа - "точки отсчета"
(запись с которой начнется выборка), по которому
сортируются записи.
10 limit integer -
Максимальное количество записей, которое
вернется в качестве ответа, не более 10000 записей.
(По умолчанию 10 записей)
11 pageDir enum -
Выбор направления:
PREV – вперед;
NEXT – назад
12 order enum - Направление сортировки:
64
№ Параметр Тип Обяз. Описание
ASC – по возрастанию;
DESC – по убыванию
13 orderColumn string -
Название столбца, по которому будет
производиться сортировка. Допустимое значение
docDate - дата эмиссии
14 orderColumnValue date - Задается в формате yyyy-MM-ddTHH:mm:ss.SSS'Z,
пример 2019-01-01T03:00:00.000Z
15 pg string -
Товарная группа:
параметр обязательно указывать для товарных
групп:
milk – Молочная продукция;
water – Вода;
otp – альтернативная табачная продукция
Параметры заголовка запроса: Authorization: Bearer <token>
Пример ответа:
{
"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"
}
]
}
Параметры ответа:
№ Параметр Тип Обяз. Описание
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 – Ошибка при обработке
65
№ Параметр Тип Обяз. Описание
UNDEFINED – Не определен
CANCELLED – Документ отменен. Для отгрузки, при отмене
отгрузки выставляется этот статус
ACCEPTED – Документ принят. Приемка, для принятой
отгрузки, ставится этот статус (обратный статус
CANCELLED)
WAIT_ACCEPTANCE – Ожидание приемки. Для отгрузки,
вместо CHECKED_OK
WAIT_PARTICIPANT_REGISTRATION – Ожидаем
регистрации участника в ГИС МТ. Для отгрузки не УОТ,
вместо CHECKED_OK
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 – Проверяется
CHECKED_OK – Оформлен
CHECKED_NOT_OK – Ошибка
PROCESSING_ERROR – Ошибка при обработке
UNDEFINED – Не определен
CANCELLED – Документ отменен. Для отгрузки, при отмене
отгрузки выставляется этот статус
ACCEPTED – Документ принят. Приемка, для принятой
отгрузки, ставится этот статус (обратный статус
CANCELLED)
WAIT_ACCEPTANCE – Ожидание приемки. Для отгрузки,
вместо CHECKED_OK
WAIT_PARTICIPANT_REGISTRATION – Ожидаем
регистрации участника в ГИС МТ. Для отгрузки не УОТ,
вместо CHECKED_OK
PARSE_ERROR – Статус документ, если не удалось
распарсить
WAIT_FOR_CONTINUATION – Ожидаем продолжения
процессинга документа. Для ФТС
11 type string +
Тип документа: AGGREGATION_DOCUMENT – Агрегирование. json;
AGGREGATION_DOCUMENT_CSV – Агрегирование. csv;
AGGREGATION_DOCUMENT_XML – Агрегирование. xml;
DISAGGREGATION_DOCUMENT – Расформирование. json;
DISAGGREGATION_DOCUMENT_CSV – Расформирование.
csv;
DISAGGREGATION_DOCUMENT_XML –
Расформирование. xml;
66
№ Параметр Тип Обяз. Описание
REAGGREGATION_DOCUMENT – Трансформация. json;
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;
LK_APPLIED_KM_CANCELLATION_CSV – Списание
нанесенных КИ. csv;
LK_APPLIED_KM_CANCELLATION_XML – Списание
нанесенных КИ. xml;
LK_CONTRACT_COMMISSIONING – Ввод в оборот.
Контрактное производство РФ. json;
67
№ Параметр Тип Обяз. Описание
LK_CONTRACT_COMMISSIONING_CSV – Ввод в оборот.
Контрактное производство РФ. csv;
LK_CONTRACT_COMMISSIONING_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;
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). json
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_CSV –
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). csv
LP_INTRODUCE_GOODS_CROSSBORDER_CSD_XML –
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). xml
LP_RETURN – Возврат в оборот. json;
LP_RETURN_CSV – Возврат в оборот. csv;
LP_RETURN_XML – Возврат в оборот. xml;
LP_SHIP_GOODS_CROSSBORDER – Отгрузка при
трансграничной торговли. json;
LP_SHIP_GOODS_CROSSBORDER_CSV – Отгрузка при
трансграничной торговли. csv;
LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка при
трансграничной торговли. xml
LP_CANCEL_SHIPMENT_CROSSBORDER – Отмена
отгрузки при трансграничной торговли. Производство РФ.
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' \
-H 'content-type: application/json' -H 'Authorization: Bearer <ТОКЕН>'
Параметры запроса:
№ Параметр Тип Обяз. Описание
1 pg string -
Товарная группа:
параметр обязательно указывать для товарных
групп:
milk – Молочная продукция;
water – Вода;
otp – альтернативная табачная продукция
2 docId string +
Возможные значения:
Уникальный идентификатор документа в ГИС
МТ, указывается для ГИС документов;
Идентификатор юридически значимого
документа
3 limit integer -
Максимальное количество кодов маркировки,
которое вернется в качестве ответа, не более
10000 КМ
4 orderedColumnValue string -
Значение столбца – “точки отсчета” (КМ с
которой начнется выборка), по которому
сортируются коды маркировки
5 pageDir enum -
Выбор направления:
PREV – вперед;
NEXT – назад
Примечание – при необходимости вывести более 10000 КМ, требуется повторить
запрос.
Параметры заголовка запроса: Authorization: Bearer <token>
Пример ответа:
{
"body": {},
"content": "string",
"docDate": "2020-01-23",
"downloadDesc": "string",
"downloadStatus": "string",
"errors": [
"string"
],
"input": true,
"number": "string",
"pdfFile": "string",
69
"receivedAt": "2020-01-23",
"receiverName": "string",
"senderName": "string",
"status": null,
"type": "string"
}
Параметры ответа:
№ Параметр Тип Обяз. Описание
1 body object + Тело отправленного документа в json формате. См.
Методы документов 2.2
2 content string + Оригинальное содержимое документа
3 docDate string
(date-time) + Дата документа. Задается в формате yyyy-MM-dd
4 downloadDesc string - Полный список ошибок обработки документа
5 downloadStatus string -
Статус загрузки: IN_PROGRESS – Проверяется
CHECKED_OK – Оформлен
CHECKED_NOT_OK – Ошибка
PROCESSING_ERROR – Ошибка при обработке
UNDEFINED – Не определен
CANCELLED – Документ отменен. Для отгрузки, при отмене
отгрузки выставляется этот статус
ACCEPTED – Документ принят. Приемка, для принятой
отгрузки, ставится этот статус (обратный статус
CANCELLED)
WAIT_ACCEPTANCE – Ожидание приемки. Для отгрузки,
вместо CHECKED_OK
WAIT_PARTICIPANT_REGISTRATION – Ожидаем
регистрации участника в ГИС МТ. Для отгрузки не УОТ,
вместо CHECKED_OK
PARSE_ERROR – Статус документ, если не удалось
распарсить
WAIT_FOR_CONTINUATION – Ожидаем продолжения
процессинга документа. Для ФТС
6 errors [string] - Список ошибок обработки документа
7 input boolean + входящий (true) / исходящий (false) документ
8 number string + Номер документа
9 pdfFile string - Ссылка на PDF-файл
10 receivedAt string
(date) -
Дата загрузки документа. Задается в формате yyyy-MM-
dd
11 receiverName string - Получатель
12 senderName string + Отправитель
13 status string +
Статус обработки документа: IN_PROGRESS – Проверяется
CHECKED_OK – Оформлен
CHECKED_NOT_OK – Ошибка
70
№ Параметр Тип Обяз. Описание
PROCESSING_ERROR – Ошибка при обработке
UNDEFINED – Не определен
CANCELLED – Документ отменен. Для отгрузки, при отмене
отгрузки выставляется этот статус
ACCEPTED – Документ принят. Приемка, для принятой
отгрузки, ставится этот статус (обратный статус
CANCELLED)
WAIT_ACCEPTANCE – Ожидание приемки. Для отгрузки,
вместо CHECKED_OK
WAIT_PARTICIPANT_REGISTRATION – Ожидаем
регистрации участника в ГИС МТ. Для отгрузки не УОТ,
вместо CHECKED_OK
PARSE_ERROR – Статус документ, если не удалось
распарсить
WAIT_FOR_CONTINUATION – Ожидаем продолжения
процессинга документа. Для ФТС
14 type 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;
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;
71
№ Параметр Тип Обяз. Описание
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;
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;
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). 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;
72
№ Параметр Тип Обяз. Описание
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;
LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка при
трансграничной торговли. xml
LP_CANCEL_SHIPMENT_CROSSBORDER – Отмена
отгрузки при трансграничной торговли. Производство РФ.
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' \
-H 'Authorization: Bearer <ТОКЕН>'
Параметры запроса:
№ Параметр Тип Обяз. Описание
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' \
-H 'content-type: application/json' -H 'Authorization: Bearer <ТОКЕН>'
--data-binary'{"product_document":"<Документ в base64>",\
"document_format":"MANUAL", "type": "LP_INTRODUCE_GOODS",\
"signature":"<Открепленная подпись в base64>"}'
Параметры запроса:
Наименование Тип данных Обяз. Описание
pg string - Товарная группа:
параметр обязательно указывать для товарных групп:
milk – Молочная продукция;
water – Вода;
otp – Альтернативная табачная продукция
Тело запроса:
{
"document_format": "string",
"product_document": "string",
"product_group": "string",
"signature": "string",
"type": "string"
}
Параметры тела запроса:
Наименование Тип данных Обяз. Описание
document_format string + Тип документа:
MANUAL – формат json;
XML – формат xml;
CSV – формат csv
product_document string + Тело документа переведённое в base64
product_group string -
Товарная группа:
clothes – Предметы одежды, белье постельное,
столовое, туалетное и кухонное;
shoes – Обувные товары;
75
Наименование Тип данных Обяз. Описание
tobacco – Табачная продукция;
perfumery – Духи и туалетная вода;
tires – Шины и покрышки пневматические резиновые
новые;
electronics – Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки;
pharma – Лекарственные препараты для медицинского
применения;
milk – Молочная продукция;
bicycle – Велосипеды и велосипедные рамы;
wheelchairs – Кресла-коляски
signature string + Открепленная подпись (УКЭП) в формате BASE64
type 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;
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;
76
Наименование Тип данных Обяз. Описание 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;
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;
Ввод в оборот. На территории стран ЕАЭС (контрактное
производство). 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;
77
Наименование Тип данных Обяз. Описание 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;
LP_SHIP_GOODS_CROSSBORDER_XML – Отгрузка при
трансграничной торговли. xml
LP_CANCEL_SHIPMENT_CROSSBORDER – Отмена
отгрузки при трансграничной торговли. Производство РФ.
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:
<?xml version="1.0" encoding="UTF-8"?>
<unit_pack document_id="unit_pack_7FFF90D5-4785-7EC9-899E-534A7BAA2B71"
VerForm="1.03" file_date_time="2019-04-12T11:07:45+03:00"
VerProg="VerProg1">
<Document operation_date_time="2019-06-05T14:28:14+03:00"
document_number="157743-20199">
<organisation>
<id_info>
<LP_info org_name="ООО" LP_TIN="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:
<?xml version="1.0" encoding="UTF-8"?>
<reaggregation action_id="32" version="2">
<trade_participant_inn>0000000000</trade_participant_inn>
<reaggregation_type>REMOVING</reaggregation_type>
<reaggregating_kitu>000000000000000000</reaggregating_kitu>
<product_list>
<packing_product>
<kit><![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
Пример тела документа в формате JSON:
{
"participant_inn": "string",
"products_list": [
{
"uitu": "string"
}
]
}
Параметры документа:
№ Наименование Описание Тип Обязательность Комментарий
1 participant_inn
ИНН участника,
осуществившего
эмиссию КМ
string +
2 products_list Список сведений о
товарах array +
3 uitu Код расформируемого
агрегата string -
Пример тела документа в формате csv
ИНН участника оборота,Версия
0000000000,2
Список транспортных упаковок
"000000000000000000"
"111111111111111111"
"222222222222222222"
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<disaggregation action_id="31" version="2">
<trade_participant_inn>0000000000</trade_participant_inn>
<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
Пример тела документа в формате JSON:
{
"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 -
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
Уникальный
идентификатор
транспортной
упаковки
string - Обязательный, если не указан
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,
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<vvod action_id="05" version="5">
<trade_participant_inn>1111111111</trade_participant_inn>
<producer_inn>1111111111</producer_inn>
<owner_inn>1111111111</owner_inn>
<!--Optional:-->
<product_date>12.04.2019</product_date>
<production_order>OWN_PRODUCTION</production_order>
<products_list>
<!--1 or more repetitions:-->
<product>
<!--Optional:-->
<kit><![CDATA[00000000000000000000000000000000000002]]></kit>
<!--Optional:-->
<kitu>000000000000000000</kitu>
<!--Optional:-->
<product_date>12.04.2019</product_date>
<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>
<!--Optional:-->
<kit><![CDATA[11111111111111111111111111111111111112]]></kit>
<!--Optional:-->
<kitu>000000000000000000</kitu>
<!--Optional:-->
<product_date>12.04.2019</product_date>
<tnved_code>0000000000</tnved_code>
86
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>string</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
</products_list>
</vvod>
2.2.5.2 Ввод в оборот. Полученных от физических лиц
Тип документа:
Тип Описание
LK_INDI_COMMISSIONING Ввод в оборот. Полученных от физических
лиц. JSON (MANUAL) LK_INDI_COMMISSIONING_CSV Ввод в оборот. Полученных от физических
лиц. CSV LK_INDI_COMMISSIONING_XML Ввод в оборот. Полученных от физических
лиц. XML
Пример тела документа в формате JSON:
{
"doc_type": "string",
"participant_inn": "string",
"product_receiving_date": "2020-01-23",
"products_list": []
}
Параметры документа:
№ Параметр Описание Тип Обяз. Комментарий
1 doc_type Тип создаваемого
документа string +
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.
Задается в формате yyyy-MM-dd
Пример тела документа в формате CSV:
ИНН участника оборота,Дата получения товара,Версия
1111111111,12.04.2019,2
Параметры товаров
КИ,КИТУ,Дата получения товара
"000000000000000000000000000000000",,12.04.2019
Пример тела документа в формате XML:
<?xml version="1.0" encoding="UTF-8"?>
<vvod_individuals action_id="5.3" version="3">
<trade_participant_inn>1111111111</trade_participant_inn>
<!--Optional:-->
<product_receiving_date>12.04.2019</product_receiving_date>
<products_list>
<!--1 or more repetitions:-->
<product>
<!--Optional:-->
<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
Пример тела документа в формате JSON:
{
"doc_type": "GOODSIMPORT",
"document_description": {
"participant_inn": "string",
"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 ТК ЕЭС;
13 - выпуск товаров с
особенностями,
предусмотренными статьёй
122 ТК ЕЭС;
14 - выпуск товаров с
особенностями,
предусмотренными статьёй
123 ТК ЕЭС;
89
№ Параметр Описание Тип Обяз. Комментарий
20 - условный выпуск
товаров
8 pdfFile
Прикрепленны
й PDF файл. В
Base64
string -
9 products
Список
данных о КМ
для ввода в
оборот
array +
10 certificate_document
Код вида
документа
обязательной
сертификации
string -
Возможный значения:
CONFORMITY_CERTIFICATE
– сертификат соответствия;
CONFORMITY_DECLARATIO
N – декларация соответствия
11 certificate_document_number
Номер
документа
обязательной
сертификации
string -
12 certificate_document_date
Дата
документа
обязательной
сертификации
string - Задается в формате yyyy-
MM-dd
13 tnved_code
Код товарной
номенклатуры
(10 знаков)
string +
14 uit_code
Уникальный
идентификато
р товара
string - Обязательный, если не
указан uitu_code
15 uitu_code
Уникальный
идентификато
р
транспортной
упаковки
string - Обязательный, если не
указан uit_code
Пример тела документа в формате CSV:
ИНН участника оборота,Дата регистрации ДТ,Регистрационный номер ДТ,Код
таможенного органа,Код принятого решения,Версия
1234567890,01.01.2019,123,11111111,10,3
Параметры товаров
КИ,КИТУ,Вид документа подтверждающего соответствие,Номер документа
подтверждающего соответствие,Дата документа подтверждающего
соответствие,Код ТН ВЭД ЕАС товара
"11111111111111111111111111111111111111",,Сертификат
соответствия,123,01.01.2019,0000000000
90
Пример тела документа в формате XML:
<?xml version="1.0" encoding="UTF-8"?>
<vvod_import action_id="5.1" version="3">
<trade_participant_inn>1234567890</trade_participant_inn>
<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>
<certificate_date>12.04.2019</certificate_date>
<tnved_code>0000000003</tnved_code>
</product>
</products_list>
</vvod_import>
2.2.5.4 Ввод в оборот. Трансграничная торговля
Тип документа:
Тип Описание
CROSSBORDER Ввод в оборот. Трансграничная торговля. JSON
(MANUAL) CROSSBORDER_CSV Ввод в оборот. Трансграничная торговля. CSV CROSSBORDER_XML Ввод в оборот. Трансграничная торговля. XML
Пример тела документа в формате JSON:
{
"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",
"trade_participant_inn": "string"
}
91
Параметры документа:
№ Параметр Описание Тип Обяз. Комментарий
1 country_oksm Код страны
экспортера string +
Числовой код длиной 3 символа из
ОКСМ:
112 – Белоруссия
417 – Киргизия
487 – Казахстан
51 – Армения
2 exporter_name Наименование
экспортера string +
3 import_date Дата импорта string + Задается в формате yyyy-MM-dd
4 primary_document_
date
Дата первичного
документа,
подтверждающего
перемещение
товара
string + Задается в формате yyyy-MM-dd
5 primary_document_
number
Номер первичного
документа,
подтверждающего
перемещение
товара
string +
6 products_list Список сведений о
товарах array +
7 certificate_date
Дата документа,
подтверждающего
соответствие
string
(date) - Задается в формате yyyy-MM-dd
8 certificate_number
Номер документа
обязательной
сертификации
string -
9 certificate_type Тип документа,
подтверждающего
соответствие string -
Возможный значения:
CONFORMITY_CERTIFICATE –
сертификат соответствия;
CONFORMITY_DECLARATION –
декларация соответствия.
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 +
16 trade_participant_inn
ИНН участника,
осуществившего
эмиссию КМ
string +
Пример тела документа в формате CSV:
ИНН участника оборота,Номер налогоплательщика отправителя,Наименование
экспортера,Код страны,Дата импорта,Номер первичного документа
подтверждающего перемещение товара,Дата первичного документа
подтверждающего перемещение товара,Версия
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
Пример тела документа в формате XML:
<?xml version="1.0" encoding="UTF-8"?>
<vvod_crossborder action_id="5.5" version="1">
<trade_participant_inn>00000000</trade_participant_inn>
<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>
<tnved_code>000000000</tnved_code>
<cost>1000</cost>
<vat_value>10</vat_value>
<certificate_type>CONFORMITY_DECLARATION</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
<product>
<kitu>111111111111111111</kitu>
<tnved_code>000000000</tnved_code>
<cost>1000</cost>
<vat_value>10</vat_value>
93
<certificate_type>CONFORMITY_DECLARATION</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>12.04.2019</certificate_date>
<!--
<children_products_list>
<product>
<ki><![CDATA[0000000000000000000000000000000001]]></ki>
<tnved_code>0000000000</tnved_code>
<cost>1000</cost>
<vat_value>10</vat_value>
<certificate_type>CONFORMITY_DECLARATION</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
</children_products_list>
//-->
</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
Пример тела документа в формате JSON:
{
"country_oksm": "string",
"exporter_name": "string",
"import_date": "2020-01-23",
"primary_document_date": "2020-01-23",
"primary_document_number": "string",
"vsd_number": "Номер ВСД",
"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",
"trade_participant_inn": "string"
94
}
Параметры документа:
№ Параметр Описание Тип Обяз. Комментарий
1 country_oksm Код страны
экспортера string +
Числовой код длиной 3 символа из
ОКСМ:
112 – Белоруссия
417 – Киргизия
487 – Казахстан
51 – Армения
2 exporter_name Наименование
экспортера string +
3 import_date Дата импорта string + Задается в формате yyyy-MM-dd
4 primary_document_
date
Дата первичного
документа,
подтверждающего
перемещение
товара
string + Задается в формате yyyy-MM-dd
5 primary_document_
number
Номер первичного
документа,
подтверждающего
перемещение
товара
string +
6 vsd_number Номер ВСД string +
Сведения о ветеринарно-
сопроводительных документах
(транспортном сопроводительном
документе)
7 products_list Список сведений о
товарах array +
8 certificate_date
Дата документа,
подтверждающего
соответствие
string
(date) - Задается в формате yyyy-MM-dd
9 certificate_number
Номер документа
обязательной
сертификации
string -
10 certificate_type Тип документа,
подтверждающего
соответствие string -
Возможный значения:
CONFORMITY_CERTIFICATE –
сертификат соответствия;
CONFORMITY_DECLARATION –
декларация соответствия.
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 +
17 trade_participant_inn
ИНН участника,
осуществившего
эмиссию КМ
string +
Пример тела документа в формате CSV:
ИНН участника оборота,Номер налогоплательщика отправителя,Наименование
экспортера,Код страны,Дата импорта,Номер первичного документа
подтверждающего перемещение товара,Дата первичного документа
подтверждающего перемещение товара,Номер ВСД,Версия
0000000000,TAXPAYER ID,Экпортер
№1,010,01.09.2019,123,01.09.2019,Номер ВСД,2
Параметры товаров
КИ,КИТУ,Код ТН ВЭД ЕАС товара,Цена за единицу,Сумма НДС,Вид
документа подтверждающего соответствие,Номер документа подтверждающего
соответствие,Дата документа подтверждающего соответствие
"00000000000000000000000000000000000000",,0000000000,1000,0,Сертификат
соответствия,123,01.01.2019
,111111111111111111,000000000,1000,0,Сертификат
соответствия,123,01.01.2019
Пример тела документа в формате XML:
<vvod_crossborder version="2">
<trade_participant_inn>0000000000</trade_participant_inn>
<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>
<primary_document_number>123</primary_document_number>
<primary_document_date>01.09.2019</primary_document_date>
<vsd_number>Номер ВСД</vsd_number>
<products_list>
<product>
<ki><![CDATA[0000000000000000000000000000000000]]></ki>
<tnved_code>000000000</tnved_code>
<cost>1000</cost>
<vat_value>10</vat_value>
<certificate_type>CONFORMITY_DECLARATION</certificate_type>
96
<certificate_number>123</certificate_number>
<certificate_date>01.09.2019</certificate_date>
</product>
<product>
<kitu>111111111111111111</kitu>
<tnved_code>000000000</tnved_code>
<cost>1000</cost>
<vat_value>10</vat_value>
<certificate_type>CONFORMITY_DECLARATION</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>01.09.2019</certificate_date>
</product>
</products_list>
</vvod_crossborder>
2.2.5.6 Ввод в оборот. Маркировка остатков
Тип документа:
Тип Описание
LP_INTRODUCE_OST Ввод в оборот. Маркировка остатков. JSON (MANUAL)
LP_INTRODUCE_OST_CSV Ввод в оборот. Маркировка остатков. CSV
LP_INTRODUCE_OST_XML Ввод в оборот. Маркировка остатков. XML
Пример тела документа в формате JSON:
{
"products_list": [
{
"certificate_date": "2020-01-23",
"certificate_number": "string",
"certificate_type": "string",
"country": "string",
"declaration_date": "2020-01-23",
"declaration_number": "string",
"ki": "string",
"kitu": "string"
}
],
"trade_participant_inn": "string"
}
Параметры документа:
№ Параметр Описание Тип Обяз. Комментарий
1 trade_participant_inn
ИНН участника,
осуществившего
эмиссию КМ
string +
2 products_list Список сведений о
товарах array -
3 certificate_date
Дата документа
обязательной
сертификации
string(d
ate) - Задается в формате yyyy-MM-dd
97
№ Параметр Описание Тип Обяз. Комментарий
4 certificate_number
Номер документа
обязательной
сертификации
string -
5 certificate_type
Тип документа,
подтверждающего
соответствие
string -
Вид документа обязательной
сертификации:
CONFORMITY_CERTIFICATE –
Сертификат соответствия;
CONFORMITY_DECLARATION –
Декларация о соответствии
6 country Страна производства string - Указываются код и название страны
7 declaration_date Дата регистрации
ДТ string - Задается в формате yyyy-MM-dd
8 declaration_number Регистрационный
номер ДТ string -
9 ki КИ string - Обязательный, если не указан kitu
10 kitu КИТУ string - Обязательный, если не указан kit
Пример тела документа в формате CSV
ИНН участника оборота,Версия
1111111111,2
Параметры товаров
КИ,КИТУ,Страна производства,Дата регистрации ДТ,Регистрационный номер
ДТ,Вид документа подтверждающего соответствие,Номер документа
подтверждающего соответствие,Дата документа подтверждающего соответствие
"00000000000000000000000000000",,111,12.04.2019,123456,Сертификат
соответствия,123456,12.04.2019
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<vvod_ostatky version="2" action_id="5.4">
<trade_participant_inn>1111111111</trade_participant_inn>
<products_list>
<product>
<ki><![CDATA[00000000000000000000000000000]]></ki>
<country>111</country>
<declaration_date>12.04.2019</declaration_date>
<declaration_number>123456</declaration_number>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>123456</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</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
Пример тела документа в формате JSON:
{
"producer_inn": "string",
"owner_inn": "string",
"production_date": "2019-04-01,
"production_order": "CONTRACT_PRODUCTION",
"products_list": [
{
"uit": "string",
"uitu": "string",
"tnved_code": "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
Дата
производства
товара
string + Задается в формате yyyy-MM-dd
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
Дата документа
обязательной
сертификации
string - Задается в формате yyyy-MM-dd
9 certificate_doc_type
Код вида
документа
обязательной
сертификации
string
Возможный значения:
CONFORMITY_CERTIFICATE –
сертификат соответствия;
CONFORMITY_DECLARATION –
декларация соответствия
10 certificate_doc_number
Номер
документа
обязательной
сертификации
string -
11 production_date
Дата
производства
товара из
общих
сведениях о
вводе товаров в
оборот
string +
Параметр присутствует в запросе, если
его значение отличается от значения
параметра production_date (№ 6 в данной
таблице).
Задается в формате yyyy-MM-dd
12 tnved_code
Код товарной
номенклатуры
(10 знаков)
string +
13 uit
Уникальный
идентификатор
товара
string - Обязательный, если не указан uitu
14 uitu
Уникальный
идентификато
р
транспортной
упаковки
string - Обязательный, если не указан uit
Пример тела документа в формате CSV
ИНН производителя или импортера,ИНН собственника,Дата производства,Тип
производственного заказа,Версия
1111111111,2222222222,12.04.2019,Контрактное производство,2
Параметры товаров
КИ,КИТУ,Код ТН ВЭД ЕАЭС товара,Дата производства,Вид документа
подтверждающего соответствие,Номер документа подтверждающего
соответствие,Дата документа подтверждающего соответствие
"000000000000000000000000000000000000","000000000000000000",0000000000,12.0
4.2019,Сертификат соответствия,12345,12.04.2019
100
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<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>
<!--1 or more repetitions:-->
<product>
<!--Optional:-->
<kit><![CDATA[000000000000000000000000000000000000]]></kit>
<kitu>000000000000000000</kitu>
<tnved_code>0000000000</tnved_code>
<production_date>12.04.2019</production_date>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>12345</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
<product>
<!--Optional:-->
<kit><![CDATA[000000000000000000000000000000000001]]></kit>
<kitu>000000000000000000</kitu>
<tnved_code>0000000000</tnved_code>
<production_date>12.04.2019</production_date>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>12345</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
<product>
<!--Optional:-->
<kit><![CDATA[000000000000000000000000000000000011]]></kit>
<kitu>000000000000000000</kitu>
<tnved_code>0000000000</tnved_code>
<production_date>12.04.2019</production_date>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>12345</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
</products_list>
</vvod_contract_production>
2.2.5.8 Автоматический ввод в оборот. СУЗ
Работа с СУЗ описана в документе «Станция управления заказами. Спецификация API».
Возврат в оборот
Тип документа:
Тип Описание
LP_RETURN Возврат в оборот. JSON (MANUAL)
LP_RETURN_CSV Возврат в оборот. CSV
LP_RETURN_XML Возврат в оборот. XML
101
Пример тела документа в формате JSON:
{
"certificate_date": "2020-01-23",
"certificate_number": "string",
"certificate_type": "string",
"paid": true,
"primary_document_custom_name": "string",
"primary_document_date": "2020-01-23",
"primary_document_number": "string",
"primary_document_type": "string",
"products_list": [
{
"certificate_date": "2020-01-23",
"certificate_number": "string",
"certificate_type": "string",
"ki": "string",
"paid": true,
"primary_document_custom_name": "string",
"primary_document_date": "2020-01-23",
"primary_document_number": "string",
"primary_document_type": "string"
}
],
"return_type": "RETAIL_RETURN",
"trade_participant_inn": "string",
}
Параметры документа:
№ Параметр Описание Тип Обяз. Комментарий
1 certificate_date Дата документа,
подтверждающе
го соответствие
string
(date) - Задается в формате yyyy-MM-dd
2 certificate_number
Номер
документа,
подтверждающе
го соответствие
string -
3 certificate_type Тип документа,
подтверждающе
го соответствие string -
Возможный значения:
CONFORMITY_CERTIFICATE - сертификат
соответствия;
CONFORMITY_DECLARATION - декларация
соответствия.
4 paid Товар был
оплачен
покупателем boolean -
Обязательно, если "Вид возврата" =
"Возврат при дистанционном способе
продажи".
Признак оплаты товара:
true – оплачен;
false – не оплачен
5 primary_document_date
Дата
первичного
документа
string
(date) +
Обязательно, если "Вид возврата" =
Возврат при розничной реализации.
Задается в формате yyyy-MM-dd
6 primary_document_nu
mber
Номер
первичного
документа string +
Обязательно, если "Вид возврата" =
Возврат при розничной реализации
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
(date) - Задается в формате yyyy-MM-dd
11 certificate_number
Номер
документа,
подтверждающе
го соответствие
string -
12 certificate_type Тип документа,
подтверждающе
го соответствие 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) +
Обязательно, если "Вид возврата" =
Возврат при розничной реализации.
Задается в формате yyyy-MM-dd
17 primary_document_nu
mber
Номер
первичного
документа string +
Обязательно, если "Вид возврата" =
Возврат при розничной реализации.
18 primary_document_type Вид первичного
документа enum +
Обязательно, если "Вид возврата" =
Возврат при розничной реализации.
RECEIPT – Кассовый чек;
SALES_RECEIPT – Товарный чек;
OTHER – Прочее
19 return_type Вид возврат string +
RETAIL_RETURN – Возврат при
розничной реализации;
REMOTE_SALE_RETURN – Возврат
при дистанционном способе продажи
103
№ Параметр Описание Тип Обяз. Комментарий
20 trade_participant_inn
ИНН
участника,
осуществивше
го эмиссию
КМ
string +
Пример тела документа в формате CSV
ИНН участника оборота,Вид возврата,Оплачен покупателем,Тип первичного
документа,Наименование первичного документа,Номер первичного документа,Дата
первичного документа,Вид документа подтверждающего соответствие,Номер
документа подтверждающего соответствие,Дата документа подтверждающего
соответствие,Версия
00000000,Возврат при розничной реализации,Да,Кассовый
чек,,12345,12.04.2019,Сертификат соответствия,12345,12.04.2019,1
Параметры товаров,,,,,,,,,,
КИ,Оплачен покупателем,Тип первичного документа,Наименование первичного
документа,Номер первичного документа,Дата первичного документа,Вид
документа подтверждающего соответствие,Номер документа подтверждающего
соответствие,Дата документа подтверждающего соответствие,,
"00000000000000000000000000000000000000",Да,Кассовый
чек,,12345,12.04.2019,Сертификат соответствия,12345,12.04.2019,,
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<return action_id="34" version="1">
<trade_participant_inn>000000000</trade_participant_inn>
<return_type>RETAIL_RETURN</return_type>
<paid>true</paid>
<primary_document_type>RECEIPT</primary_document_type>
<primary_document_number>12345</primary_document_number>
<primary_document_date>12.04.2019</primary_document_date>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>12345</certificate_number>
<certificate_date>12.04.2019</certificate_date>
<products_list>
<product>
<ki><![CDATA[00000000000000000000000000000000000000]]></ki>
<paid>true</paid>
<primary_document_type>RECEIPT</primary_document_type>
<primary_document_number>12345</primary_document_number>
<primary_document_date>12.04.2019</primary_document_date>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>12345</certificate_number>
<certificate_date>12.04.2019</certificate_date>
</product>
</products_list>
</return>
104
Отгрузка
Тип документа:
Тип Описание
LP_SHIP_GOODS Отгрузка. JSON (MANUAL)
LP_ SHIP_GOODS_CSV Отгрузка. CSV
LP_ SHIP_GOODS_XML Отгрузка. XML
Пример тела документа в формате JSON:
{
"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
Дата
первичного
документа
string + Задается в формате yyyy-MM-dd
3 transfer_date
Дата передачи
маркированных
товаров
string + Задается в формате yyyy-MM-dd
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 +
Возможные значения:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент
Пример тела документа в формате CSV
ИНН отправителя,ИНН получателя,Дата передачи товара,Номер первичного
документа,Дата первичного документа,Наименование первичного документа,Вид
оборота товаров,Отгрузка неучастнику,Версия
0000000000,0000000000,12.04.2019,123,12.04.2019,,Продажа-покупка,,Нет,5
Параметры товаров
КИ,КИТУ,Цена за единицу,Сумма НДС
"00000000000000000000000000000000000000",,33030,270
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<shipment action_id="10" version="5">
<trade_participant_inn_sender>0000000000</trade_participant_inn_sender>
<trade_participant_inn_receiver>0000000000</trade_participant_inn_receiver>
<transfer_date>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><!-- вместо SALE -->
<to_not_participant>true</to_not_participant>
<products_list>
<product>
<ki><![CDATA[00000000000000000000000000000000000000]]></ki>
<cost>330305</cost>
<vat_value>27085</vat_value>
</product>
</products_list>
</shipment>
2.2.7.1 Отгрузка с выводом из оборота
Тип документа:
Тип Описание
LP_SHIP_RECEIPT Отгрузка с выводом из оборота. JSON (MANUAL)
LP_SHIP_RECEIPT _CSV Отгрузка с выводом из оборота. CSV
LP_SHIP_RECEIPT _XML Отгрузка с выводом из оборота. XML
106
Пример тела документа в формате JSON:
{
"document_date": "2019-01-01",
"document_num": "document number",
"products": [
{
"product_cost": 33030,
"product_tax": 270,
"uit_code": "00000000000000000000000000000000000001"
},{
"product_cost": 33030,
"product_tax": 270,
"uitu_code": "111111111111111111"
}
],
"receiver_inn": "получатель",
"transfer_date": "2019-01-01",
"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
Дата
первичного
документа
string + Задается в формате yyyy-MM-dd
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 + Задается в формате yyyy-MM-dd
10 turnover_type Вид
товарооборота 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 -
Причина вывода из оборота:
DONATION – Безвозмездная передача;
STATE_ENTERPRISE – Приобретение
гос.предприятием;
NO_RETAIL_USE – Использование для
собственных нужд покупателем
Пример тела документа в формате CSV
ИНН отправителя,ИНН получателя,Дата передачи товара,Номер первичного
документа,Дата первичного документа,Наименование первичного документа,Вид
оборота товаров,Отгрузка неучастнику,Версия
0000000000,0000000000,12.04.2019,123,12.04.2019,,Продажа-покупка,,Нет,5
Параметры товаров
КИ,КИТУ,Цена за единицу,Сумма НДС
"00000000000000000000000000000000000000",,33030.5,270.85
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<shipment action_id="10" version="5">
<trade_participant_inn_sender>0000000000</trade_participant_inn_sender>
<trade_participant_inn_receiver>0000000000</trade_participant_inn_receiver>
<transfer_date>01.01.2020</transfer_date>
<move_document_number>12345678901234567890</move_document_number>
<move_document_date>01.01.2020</move_document_date>
<turnover_type>SELLING</turnover_type>
<!--Optional:-->
<withdrawal_type>STATE_ENTERPRISE</withdrawal_type>
<!--Optional:-->
<withdrawal_date>01.01.2020</withdrawal_date>
<!--Optional:-->
<st_contract_id>string</st_contract_id>
<products_list>
<!--1 or more repetitions:-->
108
<product>
<!--Optional:-->
<ki><![CDATA[00000000000000000000000000000]]></ki>
<!--Optional:-->
<cost>1000.00</cost>
<!--Optional:-->
<vat_value>1000.00</vat_value>
</product>
</products_list>
</shipment>
Отмена отгрузки
Тип документа:
Тип Описание
LP_CANCEL_SHIPMENT Отмена отгрузки. JSON (MANUAL)
Пример тела документа в формате JSON:
{
"cancel_shipment_date": "string",
"cancel_shipment_number": "string",
"participant_inn": "string",
"pdfFile": "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
Пример тела документа в формате JSON:
"acceptance_date": "2020-01-23",
"document_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",
"transfer_date": "2020-01-23",
"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
Уникальный
идентификатор
товара
string - Обязательный, если не указан
uitu_code
7 uitu_code
Уникальный
идентификатор
транспортной
упаковки
string - Обязательный, если не указан
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
14 turnover_type Вид
товарооборота string -
Возможные значения:
SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<acceptance action_id="11" version="6">
<shipment_id>57250cce-52cf-408b-99ef-39cc239f60fd</shipment_id>
<trade_participant_inn_sender>0000000000</trade_participant_inn_sender>
<trade_participant_inn_receiver>0000000000</trade_participant_inn_receiver>
<shipment_date>2019-11-18T21:00:00.000Z</shipment_date>
<reception_date>2019-11-18T21:00:00.000Z</reception_date>
<transfer_date>12.04.2019</transfer_date>
<move_document_number>784378438</move_document_number>
<move_document_date>12.04.2019</move_document_date>
<turnover_type>SELLING</turnover_type>
<products_list>
<!--1 or more repetitions:-->
<product>
<ki><![CDATA[000000000000000000000000000000000]]></ki>
<accept_type>true</accept_type>
</product>
</products_list>
</acceptance>
Вывод из оборота
Тип документа:
Тип Описание
LK_RECEIPT Вывод из оборота. JSON (MANUAL)
LK_RECEIPT_CSV Вывод из оборота. CSV
LK_RECEIPT_XML Вывод из оборота. XML
Пример тела документа в формате JSON:
{
"action": "string",
"action_date": "2020-01-23",
"document_date": "2020-01-23",
"document_number": "string",
"document_type": "string",
"inn": "string",
111
"kkt_number": "string",
"orderDate": "2020-01-23",
"order_number": "string",
"pdfFile": "string",
"primary_document_custom_name": "string",
"products": [
{
"cis": "string",
"document_date": "2020-01-23",
"document_number": "string",
"document_type": "string",
"primary_document_custom_name": "string",
"product_cost": 0
}
]
}
Параметры документа:
№ Параметр Описание Тип Обяз. Комментарий
1 action Причина вывода
из оборота enum +
Причина вывода из оборота:
RETAIL – Розничная продажа;
EEC_EXPORT – Экспорт в страны
ЕАЭС;
BEYOND_EEC_EXPORT – Экспорт
за пределы стран ЕАЭС;
RETURN – Возврат физическому
лицу;
REMOTE_SALE – Продажа по
образцам, дистанционный способ
продажи;
DAMAGE_LOSS – Утрата или
повреждение;
DESTRUCTION – Уничтожение;
CONFISCATION – Конфискация;
LIQUIDATION – Ликвидация
предприятия;
ENTERPRISE_USE – Использование
для собственных нужд предприятия
2 action_date Дата вывода из
оборота string + Задается в формате yyyy-MM-dd
3 document_date
Дата
первичного
документа
string + Задается в формате yyyy-MM-dd
4 document_number
Номер
первичного
документа
string +
5 document_type Вид первичного
документа enum +
Вид первичного документа зависит от
параметра action:
RETAIL – Розничная реализация:
RECEIPT – Кассовый чек
SALES_RECEIPT – Товарный чек
112
№ Параметр Описание Тип Обяз. Комментарий
OTHER – Прочее (с указанием
наименования вручную)
BEYOND_EEC_EXPORT – Экспорт
за пределы стран ЕАЭС:
CUSTOMS_DECLARATION –
Таможенная декларация на товары
EEC_EXPORT – Экспорт в страны
ЕАЭС:
CONSIGNMENT_NOTE – Товарная
накладная
UTD – Универсальный передаточный
документ
OTHER – Прочее (с указанием
наименования вручную)
RETURN – Возврат физическому
лицу:
OTHER – Прочее (с указанием
наименования вручную)
REMOTE_SALE – Продажа по
образцам, дистанционный способ
продажи:
RECEIPT – Кассовый чек;
SALES_RECEIPT – Товарный чек;
CONSIGNMENT_NOTE – Товарная
накладная;
UTD – Универсальный передаточный
документ;
OTHER – Прочее
DAMAGE_LOSS – Утрата или
повреждение:
DESTRUCTION_ACT - Акт
уничтожения (утраты/утилизации)
OTHER – Прочее (с указанием
наименования вручную)
DESTRUCTION – Уничтожение:
DESTRUCTION – Акт уничтожения
(утраты/утилизации)
OTHER – Прочее (с указанием
наименования вручную)
CONFISCATION – Конфискация:
CONSIGNMENT_NOTE – Товарная
накладная;
UTD – Универсальный передаточный
документ;
OTHER – Прочее
LIQUIDATION –Ликвидация
предприятия:
113
№ Параметр Описание Тип Обяз. Комментарий
CONSIGNMENT_NOTE – Товарная
накладная;
UTD – Универсальный передаточный
документ;
OTHER – Прочее
ENTERPRISE_USE –
Использование для собственных
нужд предприятия:
DESTRUCTION_ACT - Акт
уничтожения (утраты/утилизации);
OTHER – Прочее
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
Номер
первичного
документа string +
14 primary_document_type Вид первичного
документа enum +
Вид первичного документа зависит от
параметра action:
RETAIL – Розничная реализация:
RECEIPT – Кассовый чек
SALES_RECEIPT – Товарный чек
OTHER – Прочее (с указанием
наименования вручную)
BEYOND_EEC_EXPORT – Экспорт
за пределы стран ЕАЭС:
CUSTOMS_DECLARATION –
Таможенная декларация на товары
EEC_EXPORT – Экспорт в страны
ЕАЭС:
CONSIGNMENT_NOTE – Товарная
накладная
UTD – Универсальный передаточный
документ
114
№ Параметр Описание Тип Обяз. Комментарий
OTHER – Прочее (с указанием
наименования вручную)
RETURN – Возврат физическому
лицу:
OTHER – Прочее (с указанием
наименования вручную)
REMOTE_SALE – Продажа по
образцам, дистанционный способ
продажи:
RECEIPT – Кассовый чек;
SALES_RECEIPT – Товарный чек;
CONSIGNMENT_NOTE – Товарная
накладная;
UTD – Универсальный передаточный
документ;
OTHER – Прочее
DAMAGE_LOSS – Утрата или
повреждение:
DESTRUCTION_ACT - Акт
уничтожения (утраты/утилизации)
OTHER – Прочее (с указанием
наименования вручную)
DESTRUCTION – Уничтожение:
DESTRUCTION – Акт уничтожения
(утраты/утилизации)
OTHER – Прочее (с указанием
наименования вручную)
CONFISCATION – Конфискация:
CONSIGNMENT_NOTE – Товарная
накладная;
UTD – Универсальный передаточный
документ;
OTHER – Прочее
LIQUIDATION – Ликвидация
предприятия:
CONSIGNMENT_NOTE – Товарная
накладная;
UTD – Универсальный передаточный
документ;
OTHER – Прочее
ENTERPRISE_USE –
Использование для собственных
нужд предприятия:
DESTRUCTION_ACT - Акт
уничтожения (утраты/утилизации);
OTHER – Прочее
115
№ Параметр Описание Тип Обяз. Комментарий
15 primary_document_custo
m_name
Наименование
первичного
документа
string -
Обязательно, если в поле «Вид
первичного документа» указано
прочее
16 product_cost Цена за единицу integer + Стоимость в копейках, с учетом
НДС
Пример тела документа в формате CSV
ИНН участника оборота,Причина вывода из оборота,Дата вывода из оборота,Тип
первичного документа,Номер первичного документа,Дата первичного
документа,Наименование первичного документа,Регистрационный номер
ККТ,Версия
00000000000,Розничная продажа,12.04.2019,Кассовый
чек,PDN,12.04.2019,custom,kkt_number,4
Параметры товаров
КИ,Цена за единицу,Тип первичного документа,Номер первичного документа,Дата
первичного документа,Наименование первичного документа
"00000000000000000000000000000000000000",1000,Кассовый
чек,PDN,12.04.2019,custom
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<withdrawal action_id="15" version="4">
<trade_participant_inn>0000000000</trade_participant_inn>
<withdrawal_type>RETAIL</withdrawal_type>
<withdrawal_date>12.04.2019</withdrawal_date>
<primary_document_type>RECEIPT</primary_document_type>
<primary_document_number>PDN</primary_document_number>
<primary_document_date>12.04.2019</primary_document_date>
<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_type>RECEIPT</primary_document_type>
<primary_document_number>PDN</primary_document_number>
<primary_document_date>12.04.2019</primary_document_date>
<primary_document_custom_name>custom</primary_document_custom_name>
</product>
</products_list>
</withdrawal>
Заказ КМ. СУЗ
Работа с КМ описана в документе «Станция управления заказами. Спецификация API».
Списание КМ
2.2.12.1 Списание ненанесенных КИ
Тип документа:
116
Тип Описание
LK_KM_CANCELLATION Списание КМ. JSON (MANUAL)
LK_KM_CANCELLATION_CSV Списание КМ. CSV
LK_KM_CANCELLATION_XML Списание КМ. XML
Пример тела документа в формате JSON:
{
"cancellation_doc_date": "2020-01-23",
"cancellation_doc_number": "string",
"cancellation_reason": "string",
"km_list": [
{
"cancellation_reason": "string",
"uit": "string",
"uitu": "string"
}
],
"pdfFile": "string",
"trade_participant_inn": "string"
}
Параметры документа:
№ Параметр Описание Тип Обяз. Комментарий
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 Код причины
списания string +
Возможные значения:
KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен
117
№ Параметр Описание Тип Обяз. Комментарий
8 pdfFile
Приложенный
PDF файл в
Base64
string -
9 trade_participant_inn
ИНН участника,
осуществившего
эмиссию КМ
string +
Пример тела документа в формате CSV
ИНН участника оборота,Причина списания кода маркировки,Дата документа
подтверждающего списание,Номер документа подтверждающего списание,Версия
0000000000,Испорчен,12.04.2019,123,2
Параметры кодов маркировки
КИ,КИТУ,Причина списания кода маркировки
"00000000000000000000000000000000000000",,Испорчен
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<km_cancellation action_id="14" version="2">
<trade_participant_inn>0000000000</trade_participant_inn>
<cancellation_reason>KM_SPOILED</cancellation_reason>
<cancellation_document_date>12.04.2019</cancellation_document_date>
<cancellation_document_number>123</cancellation_document_number>
<km_list>
<!--1 or more repetitions:-->
<km>
<kit><![CDATA[00000000000000000000000000000000000000]]></kit>
<cancellation_reason>KM_LOST</cancellation_reason>
</km>
<km>
<kitu>000000000000000000</kitu>
<cancellation_reason>KM_LOST</cancellation_reason>
</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
Пример тела документа в формате JSON:
{
"cancellation_doc_date": "2020-01-23",
"cancellation_doc_number": "string",
"cancellation_reason": "string",
"km_list": [
118
{
"cancellation_reason": "string",
"uit": "string",
"uitu": "string"
}
],
"pdfFile": "string",
"trade_participant_inn": "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 Код причины
списания string +
Возможные значения:
KM_SPOILED – испорчен;
KM_LOST – утерян;
KM_DESTROYED – уничтожен
8 pdfFile
Приложенный
PDF файл в
Base64
string -
9 trade_participant_inn
ИНН участника,
осуществившего
эмиссию КМ
string +
Пример тела документа в формате CSV
ИНН участника оборота,Причина списания кода маркировки,Дата документа
подтверждающего списание,Номер документа подтверждающего списание,Версия
0000000000,Испорчен,12.04.2019,123,2
Параметры кодов маркировки
119
КИ,КИТУ,Причина списания кода маркировки
"00000000000000000000000000000000000000",,Испорчен
Пример тела документа в формате XML
<?xml version="1.0" encoding="UTF-8"?>
<km_cancellation action_id="14" version="2">
<trade_participant_inn>0000000000</trade_participant_inn>
<cancellation_reason>KM_SPOILED</cancellation_reason>
<cancellation_document_date>12.04.2019</cancellation_document_date>
<cancellation_document_number>123</cancellation_document_number>
<km_list>
<!--1 or more repetitions:-->
<km>
<kit><![CDATA[00000000000000000000000000000000000000]]></kit>
<cancellation_reason>KM_LOST</cancellation_reason>
</km>
<km>
<kitu>000000000000000000</kitu>
<cancellation_reason>KM_LOST</cancellation_reason>
</km>
</km_list>
</km_cancellation>
Перемаркировка
Тип документа:
Тип Описание
LK_REMARK Перемаркировка. JSON (MANUAL)
LK_REMARK_CSV Перемаркировка. CSV
LK_REMARK_XML Перемаркировка. XML
Пример тела документа в формате JSON:
{
"participant_inn": "string",
"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 +
5 certificate_document
Код вида
документа
обязательной
сертификации
string -
Возможный значения:
CONFORMITY_CERTIFICATE –
сертификат соответствия;
CONFORMITY_DECLARATION –
декларация соответствия
6 certificate_document_n
umber
Номер
документа
обязательной
сертификации
string -
7 certificate_document_date
Дата документа
обязательной
сертификации
string - Задается в формате yyyy-MM-dd
8 last_uin
Предыдущий
уникальный
идентификатор
товара
string +
9 new_uin
Новый
уникальный
идентификатор
товара
string +
10 remarking_date Дата повторной
маркировки string + Задается в формате yyyy-MM-dd
11 remarking_cause
Код причины
повторной
маркировки
string +
Причина повторной маркировки:
KM_SPOILED – Испорчено либо
утеряно КИ;
DESCRIPTION_ERRORS – Выявлены
ошибки описания товара
121
Пример тела документа в формате CSV
ИНН участника,Наименование участника,Дата повторной маркировки,Причина
повторной маркировки,
0000000000,participant,12.04.2019,Выявлены ошибки описания товара
Дата повторной маркировки,Причина повторной маркировки,Предыдущий КИ,Новый
КИ,Вид документа обязательной сертификации,Номер документа обязательной
сертификации,Дата документа обязательной сертификации
12.04.2019,,"00000000000000000000000000000000000000","111111111111111111111
11111111111111111",Сертификат соответствия,123,12.04.2019
Пример тела документа в формате XML
<remark action_id="09" version="3">
<trade_participant_inn>000000000</trade_participant_inn>
<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>
<certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
<certificate_number>123</certificate_number>
<certificate_date>01.01.2019</certificate_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 Товарный знак
name Полное наименование товара
type Вид товара
size Размер изделия
color Цвет
textileType Тип текстиля
structure Состав
consumer_age Возраст потребителя
gender Целевой пол
model Модель / артикул
производителя
Дополнительные параметры для ТГ Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки
Параметр Описание Примечание
brand Товарный знак
name Полное наименование товара
type Вид товара
standardNumber Номер регламента / стандарта
model Модель / артикул
производителя
Дополнительные параметры для ТГ Велосипеды и велосипедные рамы
Параметр Описание Примечание
brand Торговая Марка / Бренд
model Модель / артикул
производителя
125
Параметр Описание Примечание
productKind Вид товара
productionYear Год производства
engineType Тип двигателя
enginePower Мощность двигателя, л.с.
electricEnginePower Мощность электродвигателя,
Вт
frameSize Размер рамы
color Цвет
weightGross Вес брутто
frameMaterial Материал рамы
rimDiameter Посадочный диаметр обода,
дюйм
sectionWidth Ширина профиля, дюйм
brakeSystemType Тип тормозной системы
frontForkType Тип передней вилки
Дополнительные параметры для ТГ Кресла-коляски
Параметр Описание Примечание
brand Торговая Марка / Бренд
productKind Вид товара
model Модель / артикул
производителя
weightGross Вес брутто
maximumLoad Максимальная нагрузка, кг
seatDepth Глубина сиденья
seatWidth Ширина сиденья
seatHeight Высота сиденья
backHeight Высота спинки
Дополнительные параметры для ТГ Духи и туалетная вода
Параметр Описание Примечание
brand Торговая Марка / Бренд
perfumeryType Тип парфюмерии
volume Заявленный объем
packageType Тип упаковки
packMaterial Материал упаковки
126
Дополнительные параметры для ТГ Шины и покрышки пневматические
резиновые новые
Параметр Описание Примечание
brand Торговый знак
model Модель / артикул
производителя
tireSectionWidth Ширина профиля шины
(камеры), мм
heightWidthRatio Номинальное отношение
высоты профиля шины к его
ширине, %
frameConstructionType Тип конструкции каркаса шины
tireLoadIndex Индекс нагрузки на шину
speedCategory Категория скорости
seasonality Сезонность
frameSealingType Тип шины по способу
герметизации
Дополнительные параметры для ТГ Молочная продукция
Параметр Описание Примечание
brand Торговая Марка / Бренд
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: Недопустимая комбинация
значений полей <наименование
поля_1> и <наименование
поля_2> в документе <тип
документа>.
Проверка формата
значения
Недопустимый формат
значения 03
03: Недопустимый формат значения
поля <наименование поля>
в документе <тип документа>.
Проверка значений
перечисления
Значение не найдено в
списке допустимых 08
08: Значение поля <наименование
поля> в документе <тип документа>
не найдено в списке допустимых.
Проверка диапазона дат Значение даты вне
допустимого диапазона 04
04: Значение даты, указанной в поле
<наименование поля> в документе
<тип документа>, вне допустимого
диапазона.
Проверка числового
диапазона
Значение находится вне
допустимого числового
диапазона
05
05: Значение поля <наименование
поля> в документе <тип
документа> находится вне
допустимого числового диапазона.
Проверка количества
символов
Недопустимое
количество символов 07
07: Недопустимое количество
символов в значении
поля <наименование поля>
<значение поля>в документе <тип
документа>.
Проверка заполненности
массива Пустой массив 13
13: В документе <тип документа> не
указан ни один товар.
Проверка уникальности
значения в текущем
массиве
Не уникальное значение
в текущем массиве 16
16: Значение поля <наименование
поля> не уникально в текущем
массиве в документе <тип
документа>.
Проверки бизнес-логики
Поиск в базе данных
Поиск значения в базе
данных
Значение не найдено в
базе данных 06
06: Значение поля <наименование
поля> <значение поля> в документе
<тип документа> не найдено в базе
данных.
Проверка уникальности
значения в базе данных
Значение не уникально в
базе данных 17
17: Значение поля <наименование
поля> <значение поля> в документе
<тип документа> не уникально в базе
данных.
129
Проверка Ошибка Код
ошибки Текст уведомления
Проверка уникальности
комбинации значений
параметров в базе
данных
Не
уникальная комбинация
значений параметров в
базе данных
56
56: Комбинация значений
полей <наименование
поля_1> <значение
поля_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
49: Значение поля <наименование
поля> <значение параметра> в
документе <тип документа> не
соответствует значению поля
<наименование поля связанного
документа> в документе <тип
связанного документа>.
Поиск в массиве
связанного документа
Значения не найдены в
массиве связанного
документа
12
12: В списке товаров документа <тип
документа> не найден(ы) коды
идентификации:
<значение КИ1>,
<значение КИ2>,
<значение КИ3>,
<значение КИn>.
Проверка статуса
документа
Недопустимый статус
документа 37
37: Недопустимый статус связанного
документа <тип документа><ID
документа>.
Проверка условия
передачи товара
Невозможное условие
передачи товаров 22
22: Невозможное условие передачи
товара <значение КИ либо КИТУ> в
документе <тип документа>.
Проверки товарной группы
Проверка статуса
товарной группы
Недопустимый статус
товарной группы 59
59: Создание документа <тип
документа> недоступно для текущей
товарной группы.
Проверка соответствия
товарной группе
Несоответствие
товарной группе 54
54: Создание документа <тип
документа> недоступно для текущей
товарной группы.