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

Код 200, 201. В случае успешного создания документа в ответ приходит уникальный идентификатор документа в ГИС МТ. Для документа «FIXATION» приходит идентификатор в формате «FIX_<ИдФайл>», который указан в составе «product_document».
В случае ошибок:
2.1. Код 401, если не указан токен:
{ "error_message":"Для доступа к этому ресурсу требуется полная аутентификация. Проверьте токен" }
2.2. Код 400 при неверной структуре JSON в теле запроса:
{ "error_message": "JSON parse error: <описание ошибки>" }
2.3. Код 400 при отсутствии полей:

2.3.1. При отсутствии поля «document_format» в теле запроса:
{ "error_message": "Отсутствует обязательное поле: document_format" }
2.3.2. При отсутствии поля «product_document» в теле запроса:
{ "error_message": "Отсутствует обязательное поле: product_document" }
2.3.3. При отсутствии поля «type» в теле запроса:
{ "error_message": "Отсутствует обязательное поле: type" }
2.3.4. При отсутствии поля «signature» в теле запроса:
{ "error_message": "Отсутствует обязательное поле: signature" }
2.3.5. При отсутствии полей «second_product_document», «second_signature» в теле запроса для типов документов «UNIVERSAL_TRANSFER_DOCUMENT», «UNIVERSAL_TRANSFER_DOCUMENT_FIX», «UNIVERSAL_CORRECTION_DOCUMENT», «UNIVERSAL_CORRECTION_DOCUMENT_FIX»:
{ "error_message":"Для типа документа <type> не переданы параметры: <second_product_document>/<second_signature>" }
2.4. Код 400 при отсутствии тела запроса:
{ "error_message": "Required request body is missing: <описание ошибки>" }
2.5. Код 400, если не указана товарная группа:
{ "error_message": "Отсутствует обязательный параметр: pg" }
2.6. Код 400, если для типа документа недопустимо указание параметров «second_product_document», «second_signature»:
{ "error_message": "Для типа документа <type> не допустимо указание параметров: <second_product_document>/<second_signature>" }
2.7. Код 400, если в параметре строки запроса «pg» указана товарная группа «Альтернативная табачная продукция», «Никотиносодержащая продукция» или «Табачная продукция», а в параметре тела запроса «type» код типа документа не из списка:
{ "error_message": "Метод не работает с товарной группой табак" }
2.8. Код 403 при недоступности функциональности товарной группе, когда нет тела ответа от компонента товарной группы:
{ "error_message": "Отсутствует доступ к ресурсу" }
2.9. Код 422 при недоступности функциональности товарной группе, когда есть тело ответа от ЛП-компонента:
{ "error_message": "<type> недоступен для товарной группы <Наименование ТГ>" }

4.1.2. Операции с КИГУ, КИН и КИТУ

4.1.2.1. Формирование упаковки

Создание документа доступно для товарных групп «Автозапчасти и комплектующие транспортных средств», «Алкоголь», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Обувные товары», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Товары для дома и интерьера», «Удобрения в потребительской упаковке», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Для товарных групп «Автозапчасти и комплектующие транспортных средств», «Алкоголь», «Бакалейная продукция», «Ветеринарные препараты», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Строительные материалы», «Товары для дома и интерьера», «Удобрения в потребительской упаковке» подача документа доступна только в формате * .json.

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

транспортной упаковки;
групповой упаковки;
набора (для товарных групп «Радиоэлектронная продукция», «Радиоэлектронная продукция. Электронные системы доставки никотина»);
мультитоварного набора (для всех товарных групп, в которых реализованы наборы, кроме товарной группы «Радиоэлектронная продукция. Электронные системы доставки никотина»).

Доступные типы упаковок по товарным группам см. в справочнике «Типы упаковки».

Формирование упаковки может осуществляться как до ввода в оборот, так и после ввода в оборот. Если формирование упаковки произведено до ввода в оборот, то в документе ввода в оборот необходимо указывать агрегаты, а не КИ, иначе агрегаты будут расформированы.

В одном документе указываются КИ агрегатов одной длины, при этом длина КИ вложений агрегатов может отличаться.

Особенности формирования набора:

отправитель документа должен быть собственником кодов. Проверка собственника не выполняется для вложенных КИ товарных групп, для которых не наступила прослеживаемость товаров или если в карточке в НКМТ «isShelfLife40Days» («Срок хранения до 40 суток (включительно)») = «true». После успешной обработки документа они сменят владельца на отправителя документа;
до формирования набора все вложения должны быть в одинаковом статусе: «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»), особое состояние отсутствует или равно «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»). После успешной обработки документа особое состояние кода снимается. Если отправитель документа не является собственником кодов, входящих в состав набора, то такие коды могут быть добавлены в набор только в статусе «В обороте»;
КИ / КИК, планируемые к объединению в набор, не вложены в другой агрегат;
при формировании набора из вложений в статусе «APPLIED» («Нанесён»):
- у вложений и формируемого набора должен быть одинаковый тип эмиссии;
- тип эмиссии не может быть «REMARK» («Перемаркировка»);
- у формируемого набора должен быть статус «APPLIED» («Нанесён»).
при формировании набора из вложений в статусе «INTRODUCED» («В обороте»):
- у формируемого набора должен быть статус «APPLIED» («Нанесён») и тип эмиссии «LOCAL» («Произведён в РФ»). При этом у вложений может быть любой тип эмиссии.
- в результате успешного формирования статус набора изменится на «INTRODUCED» («В обороте») — набор автоматически вводится в оборот.
состав КИН должен полностью соответствовать описанию в карточке набора в НКМТ:
- коды товаров КИ равны кодам товаров, указанным в карточке кода набора в НКМТ;
- количество КИ с одинаковыми кодами товаров равно количеству этих кодов товаров в карточке набора в НКМТ. Для товарной группы «Радиоэлектронная продукция» (только для кодов ТН ВЭД ЕАЭС 8534001100, 8534001900, 8534009000) возможно формирование набора с любым количеством кодов идентификации, если в карточке товара в НКМТ было указано количество «0» по соответствующему коду товара, вложенному в набор.

Особенности формирования мультитоварного набора:

все вложения в статусе «INTRODUCED» («В обороте»), особое состояние отсутствует или равно «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»);
товарная группа хотя бы одного из вложенных кодов совпадает с товарной группой формируемого набора;
набор с типом эмиссии «LOCAL» («Произведён в РФ») или «REMAINS» («Маркировка остатков»);
вложения с любым типом эмиссии, и он может не совпадать с типом эмиссии набора;
для предотвращения ошибок при подаче других документов с мультитоварными наборами в качестве товарной группы набора рекомендуется указывать ту, для которой действует более строгий набор ограничений;
состав КИН должен полностью соответствовать описанию в карточке набора в НКМТ:
- коды товаров КИ равны кодам товаров, указанным в карточке кода набора в НКМТ;
- количество КИ с одинаковыми кодами товаров равно количеству этих кодов товаров в карточке набора в НКМТ.

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

Тип	Описание
AGGREGATION_DOCUMENT	Формирование упаковки. JSON (MANUAL)
AGGREGATION_DOCUMENT_XML	Формирование упаковки. XML

Тип

Описание

AGGREGATION_DOCUMENT

Формирование упаковки. JSON (MANUAL)

AGGREGATION_DOCUMENT_XML

Формирование упаковки. XML

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

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

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

Параметр	Тип	Обяз.	Описание	Комментарий
participantId	string	+	ИНН участника оборота товаров
aggregationUnits	array of objects	+	Список формируемых агрегатов
*unitSerialNumber	string	+	Код идентификации агрегата	Допустимые типы упаковок: BOX — «КИТУ»; GROUP — «КИГУ» (должна быть пустой); SET — «КИН». В рамках одного документа указываются КИ агрегата одной длины и с одинаковым типом упаковки. КИ агрегата не должен соответствовать маске 02[gtin]37[count] или 02[gtin]37[count]3103[netWeight], где «gtin» — <код товара> (14 цифр), «count» — количество товара в единице измерения упаковки (от 1 до 8 цифр), «netWeight» — вес товара (9 цифр). Данная маска используется для передачи информации об объёме и сорте товара в ГИС МТ. При указании КИ агрегата с такой маской документ будет обработан с ошибкой.
				Требования к КИГУ: статус — «APPLIED» («Нанесён»), тип эмиссии такой же, как у вложений. Если КИ, входящие в КИГУ в статусе «INTRODUCED» («В обороте»), то после формирования упаковки КИГУ перейдёт в такой же статус; указываемый при формировании упаковки состав КИГУ должен соответствовать справочному составу в НКМТ. Требования к КИТУ: должен быть уникален в Системе маркировки, независимо от ИНН, товарной группы или статуса. Требования к КИГУ / КИТУ: от 18 до 74 символов включительно: цифры, буквы латинского алфавита, спецсимволы (A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !). Для товарной группы «Алкоголь» рекомендуется использовать только КИТУ, длина которого составляет 18 или 26 цифр; идентификаторы применения AI (00, 01, 21) в составе КИТУ указываются без обрамляющих круглых скобок.
				При недоступности ФГИС «ВетИС», ГИС МТ работает в специальном режиме, без проверки идентификатора ВСД. Когда ФГИС «ВетИС» становится доступна, в ГИС МТ запускается автоматическая повторная обработка документа, с проверкой идентификатора ВСД. Данные о неудачной проверке идентификатора ВСД в КИ, входящих в состав КИГУ, который успешно сформирован в аварийном режиме при недоступности ФГИС «ВетИС», будут фиксироваться для КИГУ до тех пор, пока все КИ, входящие в его состав, не пройдут проверку идентификатора ВСД. В случае, если код идентификации был вложен в два агрегата, один из которых был расформирован, ошибка обработки ВСД будет зафиксирована у обоих агрегатов: как у предыдущего, так и у действующего
*unitSerialNumberType	string	-	Тип кода агрегата	Обязательный при формировании набора и мультитоварного набора. Возможные значения: BOX — «КИТУ»; GROUP — «КИГУ»; PRODUCT_SET — «КИН»
*aggregationType	string	-	Код типа агрегации	Возможное значение: «AGGREGATION» («Агрегация»)
*sntins	array of objects	+	Список КИ, входящих в агрегат	Допустимые типы упаковок: UNIT — «Единица товара»; GROUP — «КИГУ»; BOX — «КИТУ»; BUNDLE — «КИК»; SET — «КИН». Статусы КИ, входящих в агрегат, должны быть идентичны, особое состояние отсутствует или равно «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»). После успешной обработки документа особое состояние кода снимается. В рамках одного документа КИ, входящие в агрегат, могут быть разной длины. При формировании КИТУ и мультитоварного набора доступно добавление КИ, непринадлежащих отправителю документа, если подача сведений о нанесении таких КИ зафиксирована до включения полной прослеживаемости, для товарной группы реализован объёмно-сортовой учёт, а также по КИ не зафиксирована поэкземплярная передача. После успешной обработки документа вложенные КИ сменят владельца на отправителя документа.
				Требования к КИ, входящих в КИГУ: тип упаковки — UNIT («Единица товара»); тип эмиссии — не должен быть «REMARK» («Перемаркировка»); КИ должны относиться к одному коду товара; КИ не вложены в другой агрегат; статус — «APPLIED» («Нанесён») (кроме товарной группы «Алкоголь») или «INTRODUCED» («В обороте»); КИ должны иметь одинаковый идентификатор ВСД; собственник КИ — отправитель документа. При формировании групповой упаковки из вложений, у которых заполнен срок годности, у КИГУ автоматически изменится срок на минимальный срок годности, зафиксированный среди всех этих вложений. Если у кодов не указан срок годности, то у КИГУ будет автоматически удалён срок годности

Параметр

Тип

Обяз.

Описание

Комментарий

participantId

string

ИНН участника оборота товаров

aggregationUnits

array of objects

Список формируемых агрегатов

*unitSerialNumber

string

Код идентификации агрегата

Допустимые типы упаковок:

BOX — «КИТУ»;
GROUP — «КИГУ» (должна быть пустой);
SET — «КИН».

В рамках одного документа указываются КИ агрегата одной длины и с одинаковым типом упаковки.

КИ агрегата не должен соответствовать маске 02[gtin]37[count] или 02[gtin]37[count]3103[netWeight], где «gtin» — <код товара> (14 цифр), «count» — количество товара в единице измерения упаковки (от 1 до 8 цифр), «netWeight» — вес товара (9 цифр). Данная маска используется для передачи информации об объёме и сорте товара в ГИС МТ. При указании КИ агрегата с такой маской документ будет обработан с ошибкой.

Требования к КИГУ:

статус — «APPLIED» («Нанесён»), тип эмиссии такой же, как у вложений. Если КИ, входящие в КИГУ в статусе «INTRODUCED» («В обороте»), то после формирования упаковки КИГУ перейдёт в такой же статус;
указываемый при формировании упаковки состав КИГУ должен соответствовать справочному составу в НКМТ.

Требования к КИТУ:

должен быть уникален в Системе маркировки, независимо от ИНН, товарной группы или статуса.

Требования к КИГУ / КИТУ:

от 18 до 74 символов включительно: цифры, буквы латинского алфавита, спецсимволы (A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !). Для товарной группы «Алкоголь» рекомендуется использовать только КИТУ, длина которого составляет 18 или 26 цифр;
идентификаторы применения AI (00, 01, 21) в составе КИТУ указываются без обрамляющих круглых скобок.

При недоступности ФГИС «ВетИС», ГИС МТ работает в специальном режиме, без проверки идентификатора ВСД. Когда ФГИС «ВетИС» становится доступна, в ГИС МТ запускается автоматическая повторная обработка документа, с проверкой идентификатора ВСД. Данные о неудачной проверке идентификатора ВСД в КИ, входящих в состав КИГУ, который успешно сформирован в аварийном режиме при недоступности ФГИС «ВетИС», будут фиксироваться для КИГУ до тех пор, пока все КИ, входящие в его состав, не пройдут проверку идентификатора ВСД. В случае, если код идентификации был вложен в два агрегата, один из которых был расформирован, ошибка обработки ВСД будет зафиксирована у обоих агрегатов: как у предыдущего, так и у действующего

*unitSerialNumberType

string

Тип кода агрегата

Обязательный при формировании набора и мультитоварного набора. Возможные значения:

BOX — «КИТУ»;
GROUP — «КИГУ»;
PRODUCT_SET — «КИН»

*aggregationType

string

Код типа агрегации

Возможное значение: «AGGREGATION» («Агрегация»)

*sntins

array of objects

Список КИ, входящих в агрегат

Допустимые типы упаковок:

UNIT — «Единица товара»;
GROUP — «КИГУ»;
BOX — «КИТУ»;
BUNDLE — «КИК»;
SET — «КИН».

Статусы КИ, входящих в агрегат, должны быть идентичны, особое состояние отсутствует или равно «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»). После успешной обработки документа особое состояние кода снимается. В рамках одного документа КИ, входящие в агрегат, могут быть разной длины.

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

Требования к КИ, входящих в КИГУ:

тип упаковки — UNIT («Единица товара»);
тип эмиссии — не должен быть «REMARK» («Перемаркировка»);
КИ должны относиться к одному коду товара;
КИ не вложены в другой агрегат;
статус — «APPLIED» («Нанесён») (кроме товарной группы «Алкоголь») или «INTRODUCED» («В обороте»);
КИ должны иметь одинаковый идентификатор ВСД;
собственник КИ — отправитель документа.

При формировании групповой упаковки из вложений, у которых заполнен срок годности, у КИГУ автоматически изменится срок на минимальный срок годности, зафиксированный среди всех этих вложений. Если у кодов не указан срок годности, то у КИГУ будет автоматически удалён срок годности

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

<?xml version="1.0" encoding="UTF-8"?>
<unit_pack>
    <Document>
        <organisation>
            <id_info>
                <LP_info LP_TIN="7777777777" />
            </id_info>
        </organisation>
        <pack_content>
            <pack_code>123456789123456789123456789</pack_code>
            <cis>010463333333333321AAAAAAAAAAAAA</cis>
            <cis>010463333333333321BBBBBBBBBBBBB</cis>
        </pack_content>
        <pack_content>
            <pack_code>987654321987654321987654321</pack_code>
            <cis>010463333333333321CCCCCCCCCCCCC</cis>
        </pack_content>
    </Document>
</unit_pack>

4.1.2.2. Трансформация упаковки

Примечание

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

Если в набор (КИН) добавлен код, у которого заполнен срок годности, и этот срок является минимальным сроком среди всех вложений данного набора, то у КИН автоматически изменится срок годности на срок, заполненный у добавленного кода. При изъятии из набора кода, у которого был указан срок годности, у КИН автоматически изменится срок на минимальный срок годности, зафиксированный среди всех оставшихся вложений. При этом, если был изъят последний код с заполненным сроком годности, то у КИН будет автоматически удалён срок годности.

При недоступности ФГИС «ВетИС», ГИС МТ работает в специальном режиме, без проверки идентификатора ВСД. Когда ФГИС «ВетИС» становится доступна, в ГИС МТ запускается автоматическая повторная обработка документа, с проверкой идентификатора ВСД. Данные о неудачной проверке идентификатора ВСД в КИ, входящих в состав КИН, сведения о трансформации которого успешно обработаны в аварийном режиме при недоступности ФГИС «ВетИС», будут фиксироваться для КИН до тех пор, пока все КИ, входящие в его состав, не пройдут проверку идентификатора ВСД. В случае, если код идентификации был вложен в два агрегата, один из которых был расформирован, ошибка обработки ВСД будет зафиксирована у обоих агрегатов: как у предыдущего, так и у действующего.

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

Тип	Описание
REAGGREGATION_DOCUMENT	Трансформация упаковки. JSON (MANUAL)

Тип

Описание

REAGGREGATION_DOCUMENT

Трансформация упаковки. JSON (MANUAL)

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

{
   "participant_inn":"string",
   "reaggregation_type":"string",
   "uitu":"string",
   "uit_uitu_list":[
      {
         "uit_uitu":"string"
      },
      {
         "uit_uitu":"string"
      }
   ]
}

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

Параметр	Тип	Обяз.	Описание	Комментарий
participant_inn	string	+	ИНН участника оборота товара	Отправитель документа должен быть собственником кодов
reaggregation_type	string	+	Тип трансформации	Возможные значения: REMOVING — изъятие; ADDING — добавление. При изъятии из агрегата всех вложений происходит автоматическое расформирование агрегата
uitu	string	+	Код трансформируемого агрегата	Допустимые типы упаковок: BOX — «КИТУ»; SET — «КИН». Требования к трансформируемому КИН: не пустой; товарная группа не «Радиоэлектронная продукция»
uit_uitu_list	array of objects	+	Массив вложений для добавления / изъятия	Коды должны быть уникальны
*uit_uitu	string	-	Код для добавления / изъятия	Обязательный, если не указан «kitu» («Код вложенного агрегата для добавления / изъятия»). Строго не заполнен, если указан «kitu». Допустимые типы упаковок: UNIT — «Единица товара»; GROUP — «КИГУ»; BUNDLE — «КИК»; SET — «КИН». Статусы добавляемых / изымаемых кодов и статус трансформируемого агрегата должны быть равны между собой: «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»), особое состояние отсутствует. Если статус агрегата «APPLIED» («Нанесён»), то тип эмиссии входящих в его состав КИ не должен быть «REMARK» («Перемаркировка») и «REAPPLY» («Маркировка вне производства или импорта»). Если изымается / добавляется несколько кодов, они все должны быть перечислены либо в «uit_uitu», либо в «kitu». Допустимые типы вложений в зависимости от типа трансформируемого агрегата см. в «Справочник «Типы упаковки»»
*kitu	string	-	Код вложенного агрегата для добавления / изъятия	Обязательный, если не указан «uit_uitu» («Код для добавления / изъятия»). Строго не заполнен, если указан «uit_uitu». Может быть заполнен, если «uitu» («Код трансформируемого агрегата) = BOX («КИТУ»). Допустимые типы упаковок: BOX — «КИТУ». Статусы добавляемых / изымаемых кодов должны быть равны между собой: «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»), особое состояние отсутствует или равно «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»). Если статус вложений, входящих в состав КИТУ, «APPLIED» («Нанесён»), тип эмиссии не должен быть «REMARK» («Перемаркировка»). Если изымается / добавляется несколько кодов, они все должны быть перечислены либо в «uit_uitu», либо в «kitu»

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товара

Отправитель документа должен быть собственником кодов

reaggregation_type

string

Тип трансформации

Возможные значения:

REMOVING — изъятие;
ADDING — добавление.

При изъятии из агрегата всех вложений происходит автоматическое расформирование агрегата

uitu

string

Код трансформируемого агрегата

Допустимые типы упаковок:

BOX — «КИТУ»;
SET — «КИН».

Требования к трансформируемому КИН:

не пустой;
товарная группа не «Радиоэлектронная продукция»

uit_uitu_list

array of objects

Массив вложений для добавления / изъятия

Коды должны быть уникальны

*uit_uitu

string

Код для добавления / изъятия

Обязательный, если не указан «kitu» («Код вложенного агрегата для добавления / изъятия»). Строго не заполнен, если указан «kitu».

Допустимые типы упаковок:
UNIT — «Единица товара»;
GROUP — «КИГУ»;
BUNDLE — «КИК»;
SET — «КИН».

Статусы добавляемых / изымаемых кодов и статус трансформируемого агрегата должны быть равны между собой: «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»), особое состояние отсутствует.

Если статус агрегата «APPLIED» («Нанесён»), то тип эмиссии входящих в его состав КИ не должен быть «REMARK» («Перемаркировка») и «REAPPLY» («Маркировка вне производства или импорта»).

Если изымается / добавляется несколько кодов, они все должны быть перечислены либо в «uit_uitu», либо в «kitu».

Допустимые типы вложений в зависимости от типа трансформируемого агрегата см. в «Справочник «Типы упаковки»»

*kitu

string

Код вложенного агрегата для добавления / изъятия

Обязательный, если не указан «uit_uitu» («Код для добавления / изъятия»). Строго не заполнен, если указан «uit_uitu». Может быть заполнен, если «uitu» («Код трансформируемого агрегата) = BOX («КИТУ»).

Допустимые типы упаковок:
BOX — «КИТУ».

Статусы добавляемых / изымаемых кодов должны быть равны между собой: «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»), особое состояние отсутствует или равно «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»).

Если статус вложений, входящих в состав КИТУ, «APPLIED» («Нанесён»), тип эмиссии не должен быть «REMARK» («Перемаркировка»).

Если изымается / добавляется несколько кодов, они все должны быть перечислены либо в «uit_uitu», либо в «kitu»

4.1.2.3. Расформирование упаковки

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

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

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

Тип

Описание

DISAGGREGATION_DOCUMENT

Расформирование упаковки. JSON (MANUAL)

DISAGGREGATION_DOCUMENT_XML

Расформирование упаковки. XML

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

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

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

Параметр	Тип	Обяз.	Описание	Комментарий
participant_inn	string	+	ИНН участника оборота товара	Отправитель документа может быть владельцем и невладельцем кодов. Расформирование упаковки, непринадлежащей отправителю документа, доступно при выполнении условий: КИГУ / КИН / КИТУ был сформирован в период доступности объёмно-сортового учёта; подача сведений о нанесении всех КИ, входящих в состав КИГУ / КИН / КИТУ, была зафиксирована до включения полной прослеживаемости. После успешной обработки документа, отправленного невладельцем упаковки, КИГУ / КИН / КИТУ и вложенные в его состав КИ не сменят владельца на отправителя документа
products_list	array of objects	+	Массив кодов агрегатов для расформирования
*uitu	string	+	Код расформировываемого агрегата	Допустимые типы упаковок: BOX — «КИТУ»; SET — «КИН»; GROUP — «КИГУ»

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товара

Отправитель документа может быть владельцем и невладельцем кодов.

Расформирование упаковки, непринадлежащей отправителю документа, доступно при выполнении условий:

КИГУ / КИН / КИТУ был сформирован в период доступности объёмно-сортового учёта;
подача сведений о нанесении всех КИ, входящих в состав КИГУ / КИН / КИТУ, была зафиксирована до включения полной прослеживаемости.

После успешной обработки документа, отправленного невладельцем упаковки, КИГУ / КИН / КИТУ и вложенные в его состав КИ не сменят владельца на отправителя документа

products_list

array of objects

Массив кодов агрегатов для расформирования

*uitu

string

Код расформировываемого агрегата

Допустимые типы упаковок:

BOX — «КИТУ»;
SET — «КИН»;
GROUP — «КИГУ»

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

<disaggregation action_id="31" version="2">
    <trade_participant_inn>0000000000</trade_participant_inn>
    <packings_list>
        <packing>
            <kitu>000000000000000000</kitu>
        </packing>
        <packing>
            <kitu>111111111111111111</kitu>
        </packing>
        <packing>
            <kitu>222222222222222222</kitu>
        </packing>
        <packing>
            <kitu>222222222222222222</kitu>
        </packing>
        <packing>
            <kitu>222222222222222222</kitu>
        </packing>
    </packings_list>
</disaggregation>

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

Создание документа доступно для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Пиротехника и огнетушащее оборудование», «Печатная продукция», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки».

Для товарных групп «Бакалейная продукция», «Безалкогольное пиво», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Растительные масла», «Сладости и кондитерские изделия» подача документа доступна только в формате * .json.

Особенности формирования наборов:

отправитель документа должен быть собственником кодов. Проверка собственника не выполняется для вложенных КИ товарных групп, для которых не наступила прослеживаемость товаров или если в карточке в НКМТ «isShelfLife40Days» («Срок хранения до 40 суток (включительно)») = «true». После успешной обработки документа они сменят владельца на отправителя документа;
до формирования набора все вложения должны быть в одинаковом статусе: «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»), особое состояние отсутствует или равно «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»). После успешной обработки документа особое состояние кода снимается. Если отправитель документа не является собственником кодов, входящих в состав набора, то такие коды могут быть добавлены в набор только в статусе «В обороте»;
КИ / КИК, планируемые к объединению в набор, не вложены в другой агрегат;
при формировании набора из вложений в статусе «APPLIED» («Нанесён»):
- у вложений и формируемого набора должен быть одинаковый тип эмиссии;
- тип эмиссии не может быть «REMARK» («Перемаркировка») и «REAPPLY» («Маркировка вне производства или импорта»);
- у формируемого набора должен быть статус «APPLIED» («Нанесён»).
при формировании набора из вложений в статусе «INTRODUCED» («В обороте»):
- у формируемого набора должен быть статус «APPLIED» («Нанесён») и тип эмиссии «LOCAL» («Произведён в РФ») или «REMAINS» («Маркировка остатков»). При этом:
  - если тип эмиссии набора «LOCAL», то у вложений может быть любой тип эмиссии;
  - если тип эмиссии набора «REMAINS», то у вложений может быть тип эмиссии только «REMAINS».
- в результате успешного формирования статус набора изменится на «INTRODUCED» («В обороте») — набор автоматически вводится в оборот.

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

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

Тип

Описание

SETS_AGGREGATION

Формирование набора. JSON (MANUAL)

SETS_AGGREGATION_XML

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

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

{
   "participantId":"7777777777",
   "aggregationUnits":[
      {
         "unitSerialNumber":"010461111111111121LLLLLLLLLLLLL",
         "sntins":[
            "010462111111111121NNNNNNNNNNNNN"
         ]
      }
   ]
}

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

Параметр	Тип	Обяз.	Описание	Комментарий
participantId	string	+	ИНН участника оборота товаров
aggregationUnits	array of objects	+	Список формируемых наборов
*unitSerialNumber	string	+	Код идентификации набора	КИН состоит от 18 до 74 символов включительно: цифры, буквы латинского алфавита, спецсимволы (A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !)
*sntins	array of string	+	Список КИ / КИК, входящих в набор	В набор могут быть вложены только единицы товаров (UNIT) или комплекты (BUNDLE) товарной группы «Предметы одежды, бельё постельное, столовое, туалетное и кухонное». Состав КИН должен полностью соответствовать описанию в карточке набора в НКМТ: коды товаров КИ равны кодам товаров, указанным в карточке кода набора в НКМТ; количество КИ с одинаковыми кодами товаров равно количеству этих кодов товаров в карточке набора в НКМТ. Для товарной группы «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», если в карточке кода набора в НКМТ не были указаны параметры «gtin» («Код товара, вложенного в набор») и «quantity» («Количество вложений»), то можно указать любые другие коды товаров в количестве указанном в карточке кода набора в НКМТ в параметре «markedProductsQuantityInSet» («Количество маркированных товаров в наборе») (см. раздел «Метод создания и обновления товаров»).
				Карточки кодов товаров в НКМТ, на которые получены данные КИ, должны быть в статусе «Опубликована» (данный статус доступен после подписания карточки товара в НКМТ). При формировании набора из вложений, у которых заполнен срок годности, у КИН автоматически изменится срок на минимальный срок годности, зафиксированный среди всех этих вложений. Если у кодов не указан срок годности, то у КИН будет автоматически удалён срок годности. При недоступности ФГИС «ВетИС», ГИС МТ работает в специальном режиме, без проверки идентификатора ВСД. Когда ФГИС «ВетИС» становится доступна, в ГИС МТ запускается автоматическая повторная обработка документа, с проверкой идентификатора ВСД. Данные о неудачной проверке идентификатора ВСД в КИ, входящих в состав КИН, который успешно сформирован в аварийном режиме при недоступности ФГИС «ВетИС», будут фиксироваться для КИН до тех пор, пока все КИ, входящие в его состав, не пройдут проверку идентификатора ВСД. В случае, если код идентификации был вложен в два агрегата, один из которых был расформирован, ошибка обработки ВСД будет зафиксирована у обоих агрегатов: как у предыдущего, так и у действующего

Параметр

Тип

Обяз.

Описание

Комментарий

participantId

string

ИНН участника оборота товаров

aggregationUnits

array of objects

Список формируемых наборов

*unitSerialNumber

string

Код идентификации набора

КИН состоит от 18 до 74 символов включительно: цифры, буквы латинского алфавита, спецсимволы (A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !)

*sntins

array of string

Список КИ / КИК, входящих в набор

В набор могут быть вложены только единицы товаров (UNIT) или комплекты (BUNDLE) товарной группы «Предметы одежды, бельё постельное, столовое, туалетное и кухонное».

Состав КИН должен полностью соответствовать описанию в карточке набора в НКМТ:

коды товаров КИ равны кодам товаров, указанным в карточке кода набора в НКМТ;
количество КИ с одинаковыми кодами товаров равно количеству этих кодов товаров в карточке набора в НКМТ.

Для товарной группы «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», если в карточке кода набора в НКМТ не были указаны параметры «gtin» («Код товара, вложенного в набор») и «quantity» («Количество вложений»), то можно указать любые другие коды товаров в количестве указанном в карточке кода набора в НКМТ в параметре «markedProductsQuantityInSet» («Количество маркированных товаров в наборе») (см. раздел «Метод создания и обновления товаров»).

Карточки кодов товаров в НКМТ, на которые получены данные КИ, должны быть в статусе «Опубликована» (данный статус доступен после подписания карточки товара в НКМТ).

При формировании набора из вложений, у которых заполнен срок годности, у КИН автоматически изменится срок на минимальный срок годности, зафиксированный среди всех этих вложений. Если у кодов не указан срок годности, то у КИН будет автоматически удалён срок годности.

При недоступности ФГИС «ВетИС», ГИС МТ работает в специальном режиме, без проверки идентификатора ВСД. Когда ФГИС «ВетИС» становится доступна, в ГИС МТ запускается автоматическая повторная обработка документа, с проверкой идентификатора ВСД. Данные о неудачной проверке идентификатора ВСД в КИ, входящих в состав КИН, который успешно сформирован в аварийном режиме при недоступности ФГИС «ВетИС», будут фиксироваться для КИН до тех пор, пока все КИ, входящие в его состав, не пройдут проверку идентификатора ВСД. В случае, если код идентификации был вложен в два агрегата, один из которых был расформирован, ошибка обработки ВСД будет зафиксирована у обоих агрегатов: как у предыдущего, так и у действующего

При вводе набора в оборот, набор не должен быть пустым: в набор должны быть вложены КИ / КИК. При вводе в оборот КИ / КИК, вложенных в набор со статусом «Нанесён» (APPLIED), отдельно от набора, набор будет автоматически расформирован.

При поступлении чека или документа о продаже КИН или КИ / КИК, вложенных в КИН, происходит автоматическое расформирование КИН. Вывод КИН из оборота производится только через авторасформирование. Пустой КИН выводится из оборота путём подачи сведений о списании ненанесённого КИН.

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

<?xml version="1.0" encoding="UTF-8"?>
<unit_pack document_id="unit_pack_1FFF11D1-1111-1EC1-111E-111A1BAA1B11" VerForm="1.03" file_date_time="2022-06-18T04:11:14+03:00" VerProg="VerProg1">
    <Document operation_date_time="2022-06-18T04:11:14+03:00" document_number="111111-22222">
        <organisation>
            <id_info>
                <LP_info org_name="ООО XXX" LP_TIN="7777777777" RRC="555555555"/>
            </id_info>
            <Address>
                <location_address country_code="643" text_address="117218"/>
            </Address>
            <contacts phone_number="123456789" email="mail@email.ru"/>
        </organisation>
        <pack_content>
            <pack_code>0104611111111111LLLLLLLLLLLLl</pack_code>
            <cis>010462111111111121NNNNNNNNNNNNn</cis>
        </pack_content>
    </Document>
</unit_pack>

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

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

Создание документа доступно для товарных групп «Альтернативная табачная продукция», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Натуральный мех», «Никотиносодержащая продукция», «Обувные товары», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Табачная продукция», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Для товарных групп «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Натуральный мех», «Растительные масла», «Сладости и кондитерские изделия», «Строительные материалы» подача документа доступна только в формате * .json.

Примечание

Ниже в описании параметров документа используется термин «код» для обозначения кодов идентификации всех типов упаковок, допустимых для агрегирования в АТК

Типы упаковок, допустимые для агрегирования в АТК, см. в справочнике «Типы упаковки».

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

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

Тип

Описание

ATK_AGGREGATION

Формирование АТК. JSON (MANUAL)

ATK_AGGREGATION_XML

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

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

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

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

Параметр	Тип	Обяз.	Описание	Комментарий
trade_participant_inn	string	+	ИНН участника оборота товаров	Отправитель документа должен быть с типом организации «IMPORTER» («Импортёр товара») и являться собственником товаров
products_list	array	+	Массив, содержащий список кодов, агрегируемых в АТК	В массиве должен быть указан хотя бы один код. Указываемые коды должны быть уникальны, относиться к одной товарной группе и иметь один код ТН ВЭД ЕАЭС (первые 4 цифры). Для КИН коды ТН ВЭД ЕАЭС всех вложений должны полностью совпадать
*ki	string	+	Код	Код (в том числе код, вложенный в агрегат) должен быть с типом эмиссии «FOREIGN» («Ввезён в РФ») и находиться в статусе «APPLIED» («Нанесён») без особого состояния или с особым состоянием «FTS_RESPOND_NOT_OK» («Отрицательное решение ФТС»). Агрегаты должны содержать вложения. Не допускается указание кодов, вложенных в другой агрегат

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН участника оборота товаров

Отправитель документа должен быть с типом организации «IMPORTER» («Импортёр товара») и являться собственником товаров

products_list

array

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

В массиве должен быть указан хотя бы один код. Указываемые коды должны быть уникальны, относиться к одной товарной группе и иметь один код ТН ВЭД ЕАЭС (первые 4 цифры). Для КИН коды ТН ВЭД ЕАЭС всех вложений должны полностью совпадать

*ki

string

Код

Код (в том числе код, вложенный в агрегат) должен быть с типом эмиссии «FOREIGN» («Ввезён в РФ») и находиться в статусе «APPLIED» («Нанесён») без особого состояния или с особым состоянием «FTS_RESPOND_NOT_OK» («Отрицательное решение ФТС»). Агрегаты должны содержать вложения. Не допускается указание кодов, вложенных в другой агрегат

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

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

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

Примечание

Типы упаковок, допустимые для агрегирования в АТК, см. в справочнике «Типы упаковки».

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

Тип

Описание

ATK_TRANSFORMATION

Трансформация АТК. JSON (MANUAL)

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

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

Отправитель документа должен быть с типом организации «IMPORTER» («Импортёр товара») и являться собственником кодов

atk

string

Трансформируемый АТК

Код должен находиться в статусе «APPLIED» («Нанесён») без особого состояния или с особым состоянием «FTS_RESPOND_NOT_OK» («Отрицательное решение ФТС»)

transformation_type

string

Тип трансформации

Возможные значения:

REMOVING — изъятие;
ADDING — добавление

products_list

array

Массив, содержащий список перемещаемых кодов

*ki

string

Код

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

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

Тип

Описание

ATK_DISAGGREGATION

Расформирование АТК. JSON (MANUAL)

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН отправителя

Отправитель документа должен быть с типом организации «IMPORTER» («Импортёр товара») и являться собственником АТК

products_list

array

Массив, содержащий список расформировываемых АТК

В массиве должен быть указан хотя бы один АТК. Указываемые АТК должны быть уникальны и относиться к одной товарной группе

*atk

string

Дезагрегируемый АТК

Код должен находиться в статусе «APPLIED» («Нанесён») без особого состояния или с особым состоянием «FTS_RESPOND_NOT_OK» («Отрицательное решение ФТС») / «FTS_CONTROL» («На контроле ФТС»)

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

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

Создание документа доступно для товарных групп «Автозапчасти и комплектующие транспортных средств», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Обувные товары», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Титановая металлопродукция», «Товары для дома и интерьера», «Удобрения в потребительской упаковке», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Для товарных групп «Автозапчасти и комплектующие транспортных средств», «Бакалейная продукция», «Ветеринарные препараты», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Строительные материалы», «Титановая металлопродукция», «Товары для дома и интерьера», «Удобрения в потребительской упаковке» подача документа доступна только в формате * .json.

Во избежание ошибок перед подачей документа необходимо убедиться:

в наличии действующей лицензии на производство в реестре Россельхознадзора — для товарной группы «Ветеринарные препараты»;
для КИ, в том числе вложенных в агрегат, указан действующий разрешительный документ — для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Натуральный мех», «Обувные товары», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые»;
суммарный вес / объём продукции, указанной в документе (включая продукцию, вложенную в агрегат), не превышает вес / объём, указанный в ВСД, более чем на:
- 2 % — для товарной группы «Морепродукты»;
- 5 % — для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция».

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

Тип

Описание

LP_INTRODUCE_GOODS

Ввод в оборот. Производство РФ. JSON (MANUAL)

LP_INTRODUCE_GOODS_CSV

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

LP_INTRODUCE_GOODS_XML

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

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

{
   "participant_inn":"1111111111",
   "producer_inn":"1111111111",
   "owner_inn":"1111111111",
   "production_date":"2021-07-06",
   "production_type":"OWN_PRODUCTION",
   "products":[
      {
         "uit_code":"010461111111111121LLLLLLLLLLLLL",
         "tnved_code":"0000000000",
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-07-07"
            },
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00002/21",
               "certificate_date":"2021-07-07"
            }
         ]
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товаров

Отправитель документа должен быть собственником кодов

producer_inn

string

ИНН производителя товара

owner_inn

string

ИНН собственника товара

production_date

string

Дата производства товара

Для товарных групп «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Строительные материалы» (только с кодом ТН ВЭД 2523, за исключением 2523 10 000 0), «Шины и покрышки пневматические резиновые новые» параметр опциональный. Для остальных товарных групп обязательный, если дата производства не была указана в отчёте о нанесении для единиц товаров.

Если параметр будет заполнен для КИ, у которого ранее была указана дата производства, то она изменится на ту, что указана в этом параметре.

Для КИГУ / КИН проверяется наличие даты производства у вложений. В случае отсутствия этих данных хотя бы для одного вложения, необходимо указать дату в данном параметре. Дата производства не будет присвоена КИГУ / КИН, но будет перезаписана для всех вложений, входящих в состав агрегата.

Диапазон допустимых значений: от даты создания документа минус пять лет по дату создания документа. Указание времени допускается, но игнорируется при обработке.

Формат:
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

production_type

string

Тип производственного заказа

Возможное значение: OWN_PRODUCTION – собственное производство

products

array of objects

Массив, содержащий список передаваемых кодов товаров

Должна быть указана хотя бы одна запись списка.

В карточках товаров в НКМТ, в том числе у кодов, вложенных в агрегат, атрибуты «goodMarkFlag» («Признак готовности к маркировке») и «goodTurnFlag» («Признак готовности товара к обороту») = «true»

*uit_code

string

КИ

Указываемый код должен быть без особого состояния.

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

Для товарной группы «Молочная продукция» допускается указывать КИ / КИН / КИГУ в статусе «RETIRED» («Выбыл»), если они были нанесены, но не были ранее введены в оборот

*uitu_code

string

КИТУ

Параметр обязательный, если не указано значение параметра «uit_code» («КИ»).

Для товарной группы «Молочная продукция» указывается КИ агрегата и КИ вложений.

*vsd_number

string

Идентификатор ВСД

Номер производственного ВСД.

Параметр обязательный, если товар подлежит ветеринарному контролю (в карточке в НКМТ «veterinaryControl» («Подлежит ветеринарному контролю (надзору)») = «true»). Для неподконтрольных товаров параметр строго отсутствует.

Формат:

[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12};
[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12};
[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4};
[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}.

Порядок указания номера ВСД:

КИ — номер ВСД указывается для КИ;
КИГУ — номер ВСД указывается для вложенных КИ или для КИГУ, или и для вложенных КИ и для КИГУ, при этом номер ВСД у КИГУ и вложенных КИ должен совпадать. Номер ВСД, указанный только для КИГУ, по умолчанию передаётся всем вложенным КИ;
КИТУ — номер ВСД указывается только для вложенных КИ.
Номер ВСД, указанный для вложенных КИ, не передаётся по умолчанию агрегату.

При недоступности ФГИС «ВетИС», ГИС МТ работает в специальном режиме, без проверки идентификатора ВСД. Поэтому в период недоступности ФГИС «ВетИС» параметр можно заполнить как реальным идентификатором ВСД, так и нулями (значение 00000000-0000-0000-0000-000000000000 или 0000-0000-0000-0000-0000-0000-0000-0000), но только в случае если на момент подачи документа нет технической возможности оформить электронный ВСД во ФГИС «ВетИС».

Когда ФГИС «ВетИС» становится доступна, в ГИС МТ запускается автоматическая повторная обработка документа, с проверкой идентификатора ВСД. При этом идентификаторы, состоящие из нулей, не проверяются. Результат проверки можно посмотреть в карточке КИ в поле «Тип операции по документу». Если проверка пройдена с ошибкой или в документе был указан идентификатор, состоящий только из нулей, то необходимо подать в ГИС МТ документ «Корректировка сведений о кодах» (CIS_INFORMATION_CHANGE), указав в нём корректный идентификатор ВСД.

Если идентификатор ВСД не будет скорректирован, то информация о нарушении будет передана уполномоченным государственным органам для проведения контрольных (надзорных) мероприятий. Данные о неудачной проверке идентификатора ВСД в КИ, входящих в состав КИГУ / КИН, будут фиксироваться для КИГУ / КИН до тех пор, пока все КИ, входящие в их состав, не пройдут проверку идентификатора ВСД

*tnved_code

string

Код ТН ВЭД ЕАЭС товара

Для товарных групп «Антисептики и дезинфицирующие средства», «Молочная продукция», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Специализированная пищевая продукция и БАД к пище» и «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки» доступно указание как устаревших (действительных до 31.01.2022), так и новых кодов ТН ВЭД ЕАЭС (действительных с 01.01.2022)

*certificate_document_data

array of objects

Массив сведений о разрешительной документации

Сведения могут быть указаны либо внутри массива «certificate_document_data» в параметрах «certificate_type», «certificate_number», «certificate_date», либо вне массива в параметрах «certificate_document», «certificate_document_number», «certificate_document_date». Одновременное указание внутри и вне массива «certificate_document_data» не допускается. Одновременно должны быть заполнены все три параметра, либо все три не заполнены.

Для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Моторные масла», «Натуральный мех», «Сладости и кондитерские изделия», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые» сведения о разрешительном документе должны соответствовать сведениям, указанным в карточке товара в НКМТ. Если сведения о разрешительном документе указываются для КИГУ / КИН / КИТУ, то проверка соответствия будет в карточках товаров вложенных единиц или комплектов, входящих в состав такого агрегата. Если в карточке товара в НКМТ не указан ни один разрешительный документ и в параметре «reasonCertMissingDetails» («Требования подтверждения соответствия отсутствуют; основание») = «true», то проверка на соответствие разрешительных документов не осуществляется.

Сведения о разрешительном документе не могут быть указаны на уровне агрегата товарной группы «Косметика, бытовая химия и товары личной гигиены».

Параметры должны строго отсутствовать для товарных групп «Ветеринарные препараты», «Специализированная пищевая продукция и БАД к пище».

Параметры обязательные для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Молочная продукция», «Морепродукты», «Моторные масла», «Натуральный мех», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Строительные материалы», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые», если в Системе маркировки для кодов не указаны сведения о разрешительной документации и для таких кодов в карточке товара в НКМТ не заполнен «reasonCertMissingDetails» («Требования подтверждения соответствия отсутствуют; основание»).

В остальных случаях параметры необязательные.

Указанные здесь сведения о разрешительном документе являются превалирующими. Если ранее в Системе маркировки для кода был указан иной разрешительный документ, он будет заменён на новый из текущего документа

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа разрешительной документации

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string date

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

Указание времени в значении допускается, но игнорируется при обработке.

Формат:
yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон:

для «STATE_REGISTRATION_CERTIFICATE» — начиная с 1900-01-01 по текущую дату;
для остальных видов разрешительной документации — начиная с 2000-01-01 по текущую дату

**well_number

string

Номер скважины

Указывается только для товарной группы «Упакованная вода». Для остальных товарных групп игнорируется при обработке.

Параметр обязательный, если для кодов идентификации единиц товаров, в том числе для вложенных в агрегат, в карточке товара в Национальном каталоге не заполнен параметр «groundwaterUtilization» («Не добывается из подземных вод»).

Длина значения: от 1 до 255 символов включительно. Указывается один или несколько номеров скважин, разделённых запятой с пробелом, в формате: «44444444, 55555555, 88888888».

Возможно указание параметра «well_number» («Номер скважины») без обязательного заполнения параметров «certificate_type» («Вид документа разрешительной документации»), «certificate_number» («Номер документа разрешительной документации»), «certificate_date» («Дата документа разрешительной документации»)

*certificate_document

string

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

Данный параметр считается устаревшим, сохраняется для обратной совместимости. См. комментарий к параметрам «certificate_document_data», «certificate_type»

*certificate_document_number

string(1-255)

Номер документа обязательной сертификации

Данный параметр считается устаревшим, сохраняется для обратной совместимости. См. комментарий к параметрам «certificate_document_data», «certificate_number»

*certificate_document_date

string date

Дата документа обязательной сертификации

Данный параметр считается устаревшим, сохраняется для обратной совместимости. См. комментарий к параметрам «certificate_document_data», «certificate_date»

*licences

array of objects

Массив лицензий на пользование недрами

Массив «licences» с параметрами «licence_number» («Номер лицензии на пользование недрами») и «licence_date» («Дата выдачи лицензии») обязательный, если для единиц товаров, в том числе вложенных в агрегат, в карточке товара в НКМТ не заполнен «groundwaterUtilization» («Не добывается из подземных вод»).

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

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

**licence_number

string

Номер лицензии на пользование недрами

Обязательный, если указано значение «licence_date» («Дата выдачи лицензии»). Для продукции, которая добывается из подземных вод (в карточке товара в НКМТ не заполнен «groundwaterUtilization» («Не добывается из подземных вод»)), формат должен соответствовать структуре: «СерияНомерВид», содержать от 10 до 14 символов включительно: цифры и кириллица (0-9 А-Я а-я) без пробелов и специальных символов. Пример: МОС06318ВЭ

**licence_date

string date

Дата выдачи лицензии

Обязательный, если указано значение «licence_number» («Номер лицензии на пользование недрами»). Указание времени в значении допускается, но игнорируется при обработке. Диапазон допустимых значений: начиная с 1900-01-01 по текущую дату. Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

*production_date

string

Дата производства товара

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

*children

array of objects

Массив, содержащий список вложенных КИ

Рекурсивный элемент, содержащий те же параметры, что и массив «products» («Массив, содержащий список передаваемых КИ»). Заполняется только для КИН, КИГУ, КИТУ

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

ИНН участника оборота,ИНН производителя,ИНН собственника,Дата производства,Тип производственного заказа,Версия
1111111111,2222222222,3333333333,2019-01-01,Собственное производство,6
Параметры товаров
КИ,КИТУ,Дата производства,Код ТН ВЭД ЕАС товара,Вид документа подтверждающего соответствие,Номер документа подтверждающего соответствие,Дата документа подтверждающего соответствие,Номер скважины,Номера лицензий на пользование недрами,Дата выдачи лицензии,Идентификатор ВСД
"0000000000000000000AREwAwLETM0g000ffd0",,2019-01-01,6401921000,Сертификат соответствия,123,2019-01-01,"46246794, 46246794, 46246795, 46246796, 46246797, 55-Т",12346796,2021-07-07,

В файле в формате * .csv доступно указание только одного вида документа разрешительной документации.

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

<introduce_rf version="9">
    <trade_participant_inn>1111111111</trade_participant_inn>
    <producer_inn>1111111111</producer_inn>
    <owner_inn>1111111111</owner_inn>
    <production_date>2019-11-20</production_date>
    <production_order>OWN_PRODUCTION</production_order>
    <products_list>
        <product>
            <kitu>00000000000000000CFHhW0ZO0nayEXCt0bTH</kitu>
            <production_date>2019-11-20</production_date>
            <tnved_code>9999999999</tnved_code>
            <licences_list>
                <licence>
                    <number>12346796</number>
                    <date>2021-07-07</date>
                </licence>
                <licence>
                    <number>12346796</number>
                    <date>2021-07-07</date>
                </licence>
            </licences_list>
            <children>
                <product>
                    <ki>000000000000000000CFHhW0ZO0nayEXCt0bTH</ki>
                    <production_date>2019-11-20</production_date>
                    <tnved_code>9999999999</tnved_code>
                    <certificate_document_data>
                        <product>
                            <certificate_type>STATE_REGISTRATION_CERTIFICATE</certificate_type>
                            <certificate_number>1234</certificate_number>
                            <certificate_date>2019-11-20</certificate_date>
                            <well_number>44444444, 55555555, 66666666, 77777777, 55-Т</well_number>
                        </product>
                    </certificate_document_data>
                </product>
                <product>
                    <kitu>00000000000000000CFHhW0ZO0nayEXCt0bTH</kitu>
                    <production_date>2019-11-20</production_date>
                    <tnved_code>9999999999</tnved_code>
                    <children>
                        <product>
                            <ki>000000000000000000CFHhW0ZO0nayEXCt0bTH</ki>
                            <production_date>2019-11-20</production_date>
                            <tnved_code>9999999999</tnved_code>
                            <certificate_document_data>
                                <product>
                                    <certificate_type>STATE_REGISTRATION_CERTIFICATE</certificate_type>
                                    <certificate_number>1234</certificate_number>
                                    <certificate_date>2019-11-20</certificate_date>
                                    <well_number>88888888</well_number>
                                </product>
                            </certificate_document_data>
                        </product>
                    </children>
                </product>
            </children>
        </product>
    </products_list>
</introduce_rf>

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

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

Для товарной группы «Игры и игрушки для детей» подача документа доступна только в формате * .json.

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

Тип

Описание

LK_INDI_COMMISSIONING

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

LK_INDI_COMMISSIONING_XML

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

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товаров

product_receiving_date

string (date-time)

Дата получения товара

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

products_list

array of objects

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

Должна быть указана хотя бы одна запись списка.

*uit

string

КИ / КиЗ

Для товарной группы «Товары из натурального меха» параметр обязательный. Для других товарных групп: параметр обязательный, если не указано значение «uitu» («КИ транспортной упаковки»). Указываемые КИ или КИН должны быть со способом ввода в оборот «Принят на комиссию от физического лица» (см. «Справочник «Типы эмиссии КИ»»), если pg = lp или shoes. Если pg = perfumery или tires, или electronics, или bicycle, или toys, или furs, то тип выпуска должен быть LOCAL («Производство РФ»). КИГУ и КИН не вводятся в оборот без указания вложенных КИ

*uitu

string

КИ транспортной упаковки

Параметр не применим для товарной группы «Товары из натурального меха». Для других товарных групп: параметр обязательный, если не указан «uit» («КИ / КиЗ»)

*product_receiving_date

date

Дата получения товара

Параметр обязательный, если его значение отличается от значения параметра «product_receiving_date» («Дата получения товара»), указанного в массиве «products_list» («Массив, содержащий список передаваемых кодов товаров»). Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

*children

array of objects

Массив, содержащий список вложенных КИ

Рекурсивный элемент, содержащий те же параметры, что и массив «products_list» («Массив, содержащий список передаваемых КИ»). Заполняется только для КИН, КИГУ, КИТУ

productName

string

Наименование товара

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

<vvod_individuals action_id="5.3" version="3">
<trade_participant_inn>1111111111</trade_participant_inn>
<product_receiving_date>26.04.2022</product_receiving_date>
<products_list>
    <product>
        <kit>0000000000000000000AREwWwWWWW0w000www0</kit>
        <product_receiving_date>27.04.2022</product_receiving_date>
    </product>
    <product>
        <kitu>1111111111aaaaaa1111111111</kitu>
        <product_receiving_date>28.04.2022</product_receiving_date>
    </product>
</products_list>
</vvod_individuals>

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

Создание документа доступно для товарных групп «Автозапчасти и комплектующие транспортных средств», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Моторные масла», «Мясные изделия», «Натуральный мех», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Товары для дома и интерьера», «Удобрения в потребительской упаковке».

Документ доступен только для товаров, для которых ещё не наступила обязательная маркировка. Перечень товаров и этапы введения обязательной маркировки указаны в Постановлении Правительства РФ об утверждении Правил маркировки для соответствующей товарной группы. Документ «Ввод в оборот. Производство вне ЕАЭС» будет обработан с ошибкой, если в нём указан хотя бы один товар, для которого наступила обязательная маркировка. Для такого товара используйте документ «Ввод в оборот. Импорт с ФТС».

Во избежание ошибок перед подачей документа необходимо убедиться:

в наличии действующей лицензии на производство в реестре Россельхознадзора — для товарной группы «Ветеринарные препараты»;
суммарный вес / объём продукции, указанной в документе (включая продукцию, вложенную в агрегат), не превышает вес / объём, указанный в ВСД, более чем на 5 % — для товарных групп «Консервированная продукция», «Корма для животных».

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

Тип

Описание

LP_GOODS_IMPORT

Ввод в оборот. Производство вне ЕАЭС. JSON (MANUAL)

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

{
   "participant_inn":"7777777777",
   "declaration_date":"2021-05-25",
   "declaration_number":"12345678/123456/1234567",
   "customs_code":"00000000",
   "decision_code":11,
   "products":[
      {
         "uit_code":"010461111111111121LLLLLLLLLLLLL",
         "tnved_code":"0000000000",
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_DECLARATION",
               "certificate_number":"RU Д-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-08-07"
            },
            {
               "certificate_type":"CONFORMITY_DECLARATION",
               "certificate_number":"RU Д-ХХ.АА00.B.00002/21",
               "certificate_date":"2021-07-07"
            }
         ]
      },
      {
         "uitu_code":"222222222222222222",
         "children":[
            {
               "uit_code":"010463333333333321FFFFFFFFFFFFF",
               "tnved_code":"3333333333",
               "certificate_document_data":[
                  {
                     "certificate_type":"CONFORMITY_DECLARATION",
                     "certificate_number":"RU Д-ХХ.АА00.B.00003/21",
                     "certificate_date":"2021-08-07"
                  }
               ]
            }
         ]
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товаров

Отправитель документа должен быть собственником кодов

declaration_number

string

Регистрационный номер ДТ

Формат: XXXXXXXX/XXXXXX/XXXXXXX (23 цифры (8, 6 и 7), разделённых символом «/»)

declaration_date

string

Дата регистрации ДТ

Формат: YYYY-MM-DD. Диапазон даты: с 01.01.2000 по дату создания документа. Соответствует значению параметра «declaration_number» («Регистрационный номер ДТ»)

customs_code

string

Код таможенного органа

Формат: 8 цифр

decision_code

string

Код решения, принятого таможенным органом

Значение из классификатора решений, принимаемых таможенными органами. Формат: 2 цифры

products

array of objects

Массив, содержащий список передаваемых кодов

Должен быть указан хотя бы один код и данные о нём.

*uit_code

string

КИ

Требования к КИ:

статус КИ — «APPLIED» («Нанесён»);
тип эмиссии — «FOREIGN» («Ввезён в РФ»);
особое состояние отсутствует.

При указании КИ, входящего в состав агрегата, агрегат автоматически расформировывается.

Если указан КИГУ, то ввод в оборот производится успешно, когда в ДТ данный КИГУ получает положительное решение ФТС, или все КИ, входящие в состав КИГУ и указанные в ДТ, получают положительное решение ФТС.

Если в документе «Ввод в оборот. Производство вне ЕАЭС» указан КИ агрегата, то ввод в оборот производится успешно, когда в ДТ найден данный КИ агрегата с положительным решением ФТС или найдены все вложения данного агрегата с положительным решением ФТС.

При подаче сведений об импорте товара в групповой упаковке с одинаковыми ТН ВЭД в ДТ указывается только КИГУ. Данный КИГУ также указывается в документе «Ввод в оборот. Производство вне ЕАЭС». При импорте товара в групповой упаковке с разными ТН ВЭД в ДТ указываются КИ, находящиеся в составе КИГУ, сгруппированные в строках ДТ согласно коду ТН ВЭД. В документе «Ввод в оборот. Производство вне ЕАЭС» также указываются все КИ, входящие в состав КИГУ с соответствующим ТН ВЭД

*uitu_code

string

КИТУ

Параметр обязательный, если не указано значение параметра «uit_code» («КИ»). Требования к КИТУ:

статус КИТУ не равен «DISAGGREGATION» («Расформирован»);
тип эмиссии вложений КИТУ — «FOREIGN» («Ввезён в РФ»), особое состояние отсутствует

*tnved_code

string

Код ТН ВЭД (10 знаков)

Для товарной группы «Специализированная пищевая продукция и БАД к пище» доступно указание как устаревших (действительных до 31.01.2022), так и новых кодов ТН ВЭД ЕАЭС (действительных с 01.01.2022)

*certificate_document_data

array of objects

Массив, содержащий данные документов разрешительной документации

Сведения могут быть указаны либо внутри массива «certificate_document_data» в параметрах «certificate_type», «certificate_number», «certificate_date», либо вне массива в одноимённых параметрах. Одновременное указание внутри и вне массива «certificate_document_data» не допускается. Одновременно должны быть заполнены все три параметра, либо все три не заполнены.

Параметры должны строго отсутствовать для товарных групп «Ветеринарные препараты», «Специализированная пищевая продукция и БАД к пище»

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа разрешительной документации

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string date

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

Указание времени в значении допускается, но игнорируется при обработке.

Формат:
yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон:

для «STATE_REGISTRATION_CERTIFICATE» — начиная с 1900-01-01 по текущую дату;
для остальных видов разрешительной документации — начиная с 2000-01-01 по текущую дату

*certificate_type

string

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

Данный параметр считается устаревшим, сохраняется для обратной совместимости. Cм. комментарий к массиву «certificate_document_data» и комментарий к одноимённому параметру внутри этого массива

*certificate_number

string

Номер документа обязательной сертификации

*certificate_date

string

Дата документа обязательной сертификации

*vsd_number

string

Идентификатор ВСД

Номер первого транспортного ВСД.

Формат:

Порядок указания номера ВСД:

КИ — номер ВСД указывается для КИ;
КИТУ — номер ВСД указывается только для вложенных КИ.
Номер ВСД, указанный для вложенных КИ, не передаётся по умолчанию агрегату.

*children

array of objects

Массив, содержащий список вложенных КИ

Рекурсивный элемент, содержащий те же параметры, что и массив «products» («Массив, содержащий список передаваемых кодов»). Заполняется только для КИН, КИГУ, КИТУ

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

Создание документа доступно для товарных групп «Автозапчасти и комплектующие транспортных средств», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Обувные товары», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Товары для дома и интерьера», «Удобрения в потребительской упаковке», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»:

КМ с типом эмиссии «Ввезён в РФ» («FOREIGN») после успешной обработки отчёта о нанесении меняют статус с «Эмитирован» («EMITTED») на «Нанесён» («APPLIED»), после чего могут быть указаны в документе «Ввод в оборот. Трансграничная торговля» (CROSSBORDER).

При обработке документа «Ввод в оборот. Трансграничная торговля» (CROSSBORDER) будет осуществляться проверка ИНН и КПП отправителя документа на отсутствие блокировки в ЕГАИС.

Во избежание ошибок перед подачей документа необходимо убедиться:

в наличии действующей лицензии на производство в реестре Россельхознадзора — для товарной группы «Ветеринарные препараты»;
для КИ, в том числе вложенных в агрегат, указан действующий разрешительный документ — для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Натуральный мех», «Обувные товары», «Пиво, напитки, изготавливаемые на основе пива, и слабоалкогольные напитки», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые»;
суммарный вес / объём продукции, указанной в документе (включая продукцию, вложенную в агрегат), не превышает вес / объём, указанный в ВСД, более чем на:
- 2 % — для товарной группы «Морепродукты»;
- 5 % — для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция».

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

Тип

Описание

CROSSBORDER

Ввод в оборот. Трансграничная торговля. JSON (MANUAL)

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

{
   "trade_participant_inn":"1111111111",
   "sender_tax_number":"1111111111",
   "exporter_name":"string",
   "country_oksm":"112",
   "import_date":"2021-07-06",
   "primary_document_number":"123",
   "primary_document_date":"2021-07-06",
   "products_list":[
      {
         "ki":"0000000000000000000AREwAwLETM7g240ffd0",
         "tnved_code":"0000000000",
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-07-07"
            },
            {
               "certificate_type":"STATE_REGISTRATION_CERTIFICATE",
               "certificate_number":"RU.01.ЯЯ.00.001.Е.000001.07.21",
               "certificate_date":"2021-07-07"
            }
         ]
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН участника оборота товара

Отправитель документа должен быть собственником кодов

trade_participant_kpp

string

КПП участника оборота товара

Обязательно заполнен, если товарная группа «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки». Для других товарных групп строго не заполнен. Формат: 9 цифр

sender_tax_number

string

Номер налогоплательщика отправителя

Формат: 8 / 9 / 12 / 14 цифр

exporter_name

string

Наименование экспортёра

Длина значения — от 1 до 255 символов включительно

country_oksm

string

Код страны экспортёра

Числовой код (3 цифры) из ОКСМ:

112 — Белоруссия;
417 — Киргизия;
398 — Казахстан;
051 — Армения

import_date

string date

Дата импорта

Диапазон:
максимальное значение — текущая дата плюс 1 год;
минимальное значение — текущая дата минус 5 лет.

Указание времени допускается, но игнорируется при обработке.

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

primary_document_date

string date

Дата первичного документа, подтверждающего перемещение товара

Диапазон: не более текущей даты и не менее текущей даты минус 5 лет.

Указание времени допускается, но игнорируется при обработке.

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» можно указать дату первичного документа или договора, на основании которого осуществляется ввоз

primary_document_number

string

Номер первичного документа, подтверждающего перемещение товара

Длина значения — от 1 до 255 символов включительно.

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» можно указать номер первичного документа или договора, на основании которого осуществляется ввоз

products_list

array of objects

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

Должен быть указан хотя бы один код и данные о нём.

*ki

string

КИ

Требования к КИ:

статус КИ — «APPLIED» («Нанесён»);
тип эмиссии — «FOREIGN» («Ввезён в РФ»);
тип упаковки не равен АТК;
особое состояние отсутствует.

Параметр обязательный, если не указан «kitu» («КИТУ»). При агрегации, осуществлённой до ввода в оборот, необходимо указать КИ агрегатов. КИГУ и КИН не вводятся в оборот без указания вложенных КИ

*kitu

string

КИТУ

Параметр обязательный, если не указан «ki» («КИ»).

Требования к КИТУ:

статус КИТУ не равен «DISAGGREGATION» («Расформирован»);
тип эмиссии вложений КИТУ — «FOREIGN» («Ввезён в РФ»), особое состояние отсутствует;
тип упаковки — «BOX» («КИТУ»).

Если в документе одновременно указан КИТУ и его вложение вне параметра «children» («Массив, содержащий список вложенных КИ»), то документ будет обработан с ошибкой.

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

*vsd_number

string

Идентификатор ВСД

Номер первого транспортного ВСД.

Формат:

Порядок указания номера ВСД:

КИ — номер ВСД указывается для КИ;
КИГУ — номер ВСД указывается для вложенных КИ или для КИГУ, или и для вложенных КИ и для КИГУ, при этом номер ВСД у КИГУ и вложенных КИ должен совпадать. Номер ВСД, указанный только для КИГУ, по умолчанию передаётся всем вложенным КИ;
КИТУ, АТК — номер ВСД указывается только для вложенных КИ.

Номер ВСД, указанный для вложенных КИ, не передаётся по умолчанию агрегату.

*tnved_code

string

Код ТН ВЭД ЕАЭС товара

Если указан КИ единицы товара, то обязательно заполнен. Если указан КИН или КИТУ, то строго не заполнен, но заполнен для всех вложений. Если указан КИГУ, то заполнен и у КИГУ и у всех вложенных КИ. Формат: 10 цифр.

*cost

integer

Цена за единицу

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»:

параметр обязательный, если в документе указан КИ единицы товара или КИ агрегата, но не указаны все его вложения;
если в документе указан КИТУ, то в параметре «cost» («Цена за единицу») стоимость указывается за весь КИТУ, при этом стоимость КИ, входящих в состав такого КИТУ, будет рассчитана как среднее арифметическое значение (чтобы получить реальную стоимость КИ, в КИТУ должна содержаться одинаковая продукция).

Цена указывается в копейках с учётом НДС (если сделка облагается НДС). Значение не может быть отрицательным, должно быть строго больше «vat_value» («Сумма НДС»), длина числового значения от 0 до 17 цифр включительно. Диапазон значений: от 0 до 99999999999999999 включительно

*vat_value

integer

Сумма НДС

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» параметр обязательный, если в документе указан КИ единицы товара или КИ агрегата, но не указаны все его вложения.

Сумма НДС указывается в копейках: длина числового значения от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение «0»

*excise

integer

Сумма акциза по позиции

Указывается в копейках. Числовое значение до 17 символов в целой части и до 2 символов в дробной части (дробная часть опциональна). Диапазон значений: 0 ≤ excise ≤ 9999999999999999999

*certificate_document_data

array of objects

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

Сведения могут быть указаны либо внутри массива «certificate_document_data» в параметрах «certificate_type», «certificate_number», «certificate_date», либо вне массива в одноимённых параметрах. Одновременное указание внутри и вне массива «certificate_document_data» не допускается. Одновременно должны быть заполнены все три параметра, либо все три не заполнены.

Для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Моторные масла», «Натуральный мех», «Пиво, напитки, изготавливаемые на основе пива, и слабоалкогольные напитки», «Сладости и кондитерские изделия», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые» сведения о разрешительном документе должны соответствовать сведениям, указанным в карточке товара в НКМТ. Если сведения о разрешительном документе указываются для КИГУ / КИН / КИТУ, то проверка соответствия будет в карточках товаров вложенных единиц или комплектов, входящих в состав такого агрегата.

Если в карточке товара в НКМТ не указан ни один разрешительный документ и в параметре «reasonCertMissingDetails» («Требования подтверждения соответствия отсутствуют; основание») = «true», то проверка на соответствие разрешительных документов не осуществляется.

Параметры обязательные для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки». Для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Натуральный мех», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Строительные материалы», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые» параметры обязательные, если в Системе маркировки для кодов не указаны сведения о разрешительном документе и для таких кодов в карточке товара в НКМТ не заполнен «reasonCertMissingDetails» («Требования подтверждения соответствия отсутствуют; основание»).

В остальных случаях параметры необязательные.

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string date

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

Указание времени в значении допускается, но игнорируется при обработке.

Формат:
yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон:

для «STATE_REGISTRATION_CERTIFICATE» — начиная с 1900-01-01 по текущую дату;
для остальных видов разрешительной документации — начиная с 2000-01-01 по текущую дату

*certificate_type

string

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

*certificate_number

string

Номер документа, подтверждающего соответствие

*certificate_date

string date

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

*children

array of objects

Массив, содержащий список вложенных КИ

4.1.4.5. Ввод в оборот. Трансграничная торговля ("Товары из натурального меха")

Создание документа доступно для товарной группы "Товары из натурального меха".

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

Тип

Описание

FURS_CROSSBORDER

Ввод в оборот. Трансграничная торговля ("Товары из натурального меха"). JSON (MANUAL)

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

{
    "trade_participant_inn": "1111111111",
    "country_oksm": "112",
    "exporter_name": "string",
    "sender_tax_number": "1111111111",
    "import_date": "2021-05-04",
    "primary_document_number": "123",
    "primary_document_date": "2021-05-04",
    "products_list": [
        {
            "ki": "KZ-123456-2016061001",
            "tnved_code": "4303109010",
            "certificate_document_data": [ {
                "certificate_type": "CONFORMITY_CERTIFICATE",
                "certificate_number": "RU С-ХХ.АА00.B.00001/19",
                "certificate_date": "2019-01-01"
            } ],
            "cost": 10000000,
            "vat_value": 1666667
        },
        {
            "ki": "KZ-123456-2016061002",
            "tnved_code": "4303109020",
            "certificate_document_data": [ {
                "certificate_type": "CONFORMITY_CERTIFICATE",
                "certificate_number": "RU С-ХХ.АА00.B.00002/19",
                "certificate_date": "2019-01-02"
            } ],
            "cost": 12000000,
            "vat_value": 2000000
        }
    ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН участника оборота товара

country_oksm

string

Код страны экспортёра

Числовой код (3 цифры) из ОКСМ:

112 – Белоруссия;
417 – Киргизия;
398 – Казахстан;
051 – Армения

exporter_name

string

Наименование экспортёра

sender_tax_number

string

Номер налогоплательщика отправителя (или его аналог)

import_date

string date

Дата импорта

Формат:

yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон: не более текущей даты и не менее текущей даты минус 5 лет

primary_document_number

string (1-255)

Номер первичного документа

primary_document_date

string date

Дата первичного документа

Формат:

yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон: не более текущей даты и не менее текущей даты минус 5 лет

products_list

array of objects

Массив, содержащий список передаваемых КиЗ

Должна быть указана хотя бы одна запись списка

*ki

string

Номер КиЗ

Формат: (RU,AM,BY,KZ,KG)-[A-Z0-9]{6}-[A-Z0-9]{10}. Требования к КиЗ:

статус КиЗ — «RETIRED» («Выбыл»);
тип эмиссии — «LOCAL» («Произведён в РФ») или «FOREIGN» («Ввезён в РФ»);
особое состояние — «NULL» или «EAS_RESPOND_NOT_OK» («Отрицательное решение ЕАЭС»)

*tnved_code

string

Код ТН ВЭД (10 знаков)

*certificate_document_data

array of objects

Массив, содержащий сведения о документах разрешительной документации

Значения указываются в параметрах "certificate_type" ("Вид документа разрешительной документации"), "certificate_number" ("Номер документа разрешительной документации"), "certificate_date" ("Дата документа разрешительной документации"). Одновременно должны быть заполнены все три параметра массива либо все три не заполнены

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа разрешительной документации

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string date

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

Формат:

yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон: не более текущей даты и не менее текущей даты минус 5 лет

*cost

decimal

Цена за единицу

Цена указывается в копейках с учётом НДС (если сделка облагается НДС). Значение не может быть отрицательным, должно быть строго больше "vat_value" ("Сумма НДС"), длина числового значения от 0 до 15 цифр включительно

*vat_value

decimal

Сумма НДС

Сумма НДС указывается в копейках при наличии НДС: длина числового значения от 0 до 15 цифр включительно

4.1.4.6. Ввод в оборот. Остатки

Создание документа доступно для товарных групп «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Моторные масла», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Специализированная пищевая продукция и БАД к пище».

Важно

Для товарной группы «Игры и игрушки для детей» подача документа доступна только для товаров, указанных в Постановлении Правительства РФ от 31.05.2025 № 819 «Об утверждении Правил маркировки средствами идентификации отдельных видов товаров для детей и особенностях внедрения государственной информационной системы мониторинга за оборотом товаров, подлежащих обязательной маркировке средствами идентификации, в отношении отдельных видов товаров для детей».

Для товарной группы «Косметика, бытовая химия и товары личной гигиены» подача документа доступна только для товаров, указанных в Постановлении Правительства РФ от 31.05.2025 № 808 «О проведении на территории Российской Федерации эксперимента по маркировке средствами идентификации отдельных видов товаров личной гигиены, упакованных в потребительскую упаковку, и внесении изменений в постановление Правительства Российской Федерации от 30 ноября 2024 № 1681».

Для товарной группы «Моторные масла» подача документа доступна только для товаров, указанных в Постановлении Правительства РФ от 30.11.2024 № 1683 «Об утверждении Правил маркировки отдельных видов смазочных материалов и специальных автомобильных жидкостей средствами идентификации и особенностях внедрения государственной информационной системы мониторинга за оборотом товаров, подлежащих обязательной маркировке средствами идентификации, в отношении отдельных видов смазочных материалов и специальных автомобильных жидкостей».

Для товарной группы «Предметы одежды, бельё постельное, столовое, туалетное и кухонное» подача документа доступна только для товаров, указанных в Постановлении Правительства РФ от 25.12.2025 № 2129 «О внесении изменений в постановление Правительства Российской Федерации от 31 декабря 2019 г. № 1956». Возврат денежных средств по заказанным КМ на товары, которые подлежат маркировке с 01.01.2021, с типом эмиссии «Маркировка остатков» произведён не будет.

Для товарной группы «Специализированная пищевая продукция и БАД к пище» подача документа доступна только для товаров, указанных в Постановлении Правительства РФ от 31.05.2025 № 811 «Об утверждении Правил маркировки пищевой продукции для питания спортсменов средствами идентификации, особенностях внедрения государственной информационной системы мониторинга за оборотом товаров, подлежащих обязательной маркировке средствами идентификации в отношении пищевой продукции для питания спортсменов, и о проведении на территории Российской Федерации эксперимента по маркировке средствами идентификации пищевой продукции для питания спортсменов»

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

Тип

Описание

LP_INTRODUCE_OST

Ввод в оборот. Остатки. JSON (MANUAL)

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

{
   "trade_participant_inn":"8888888888",
   "products_list":[
      {
         "ki":"010463333333333321KKkkKkKkKkKKk",
         "country":"643",
         "declaration_number":"XXXXXXXX/XXXXXX/XXXXXXX",
         "declaration_date":"2021-07-07",
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-07-07"
            },
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00002/21",
               "certificate_date":"2021-07-07"
            }
         ]
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН производителя или импортёра

Отправитель документа должен быть собственником кодов

products_list

array of objects

Массив, содержащий список уникальных кодов

Должен быть указан хотя бы один код и данные о нём.

*ki

string

КИ

Обязательный, если не указан «kitu».

Требования к кодам:

типы: КИ, КИГУ, КИК, КИН;
тип эмиссии:
- «REAPPLY» («Маркировка вне производства или импорта») — для товарных групп «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Специализированная пищевая продукция и БАД к пище»;
- «REMAINS» («Маркировка остатков») — для остальных товарных групп.
статус «APPLIED» («Нанесён»), особое состояние отсутствует.

При типе эмиссии «REAPPLY» («Маркировка вне производства или импорта») доступно указание только КИ.

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

Перечисленные в документе КИ вложений должны принадлежать КИ агрегата, указанному в документе. При этом в документе могут быть перечислены не все вложения агрегата

*kitu

string

КИТУ

Обязательный, если не указан «ki». Указание КИТУ недоступно для товарных групп «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное» и «Специализированная пищевая продукция и БАД к пище».

Статус ≠ «DISAGGREGATION» («Расформирован»), особое состояние отсутствует

*country

string

Код страны производства в соответствии с ОКСМ

Формат: 3 цифры. Пример: «643» (Российская Федерация)

*declaration_number

string

Регистрационный номер декларации на товары

*declaration_date

string

Дата регистрации декларации на товары

Строго соответствует значению даты внутри регистрационного номера декларации на товары (символы с 9 по 14), который указывается в параметре «declaration_number». При этом дата в «declaration_number» должна быть в диапазоне: начиная с 2000-01-01, но не ранее «certificate_date» (если указан) по текущую дату плюс один день. Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке документа

*certificate_document_data

array of objects

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

**certificate_type

string

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

Обязательный внутри или вне массива «certificate_document_data», если в Системе маркировки для кодов не указаны сведения о разрешительной документации.

Если данный параметр указан, то «certificate_number» и «certificate_date» являются обязательными на том же уровне, на котором указан «certificate_type».

Одновременное заполнение сведений о документе, подтверждающем соответствие, внутри и вне массива «certificate_document_data» не допускается.

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

Возможные значения см. в разделе «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

См. комментарий к параметру «certificate_type» массива «certificate_document_data».

Формат: значение должно соответствовать регулярному выражению

**certificate_date

string

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

См. комментарий к параметру «certificate_type» массива «certificate_document_data».

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке документа.

Диапазон: начиная с 2000-01-01 по текущую дату. Если в «certificate_type» = «STATE_REGISTRATION_CERTIFICATE», то диапазон: начиная с 1900-01-01 по текущую дату

*certificate_type

string

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

Cм. комментарий к одноимённому параметру массива «certificate_document_data».

Данные параметры считаются устаревшими, сохраняются для обратной совместимости

*certificate_number

string

Номер документа, подтверждающего соответствие

*certificate_date

string

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

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

Создание документа доступно для товарных групп «Автозапчасти и комплектующие транспортных средств», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Обувные товары», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Титановая металлопродукция», «Товары для дома и интерьера», «Товары из натурального меха», «Удобрения в потребительской упаковке», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Для товарных групп «Автозапчасти и комплектующие транспортных средств», «Бакалейная продукция», «Ветеринарные препараты», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Строительные материалы», «Титановая металлопродукция», «Товары для дома и интерьера», «Удобрения в потребительской упаковке» подача документа доступна только в формате * .json.

Во избежание ошибок перед подачей документа необходимо убедиться:

у производителя товара, ИНН которого указывается в параметре «producer_inn» («ИНН производителя товара»), есть действующая лицензия на производство в реестре Россельхознадзора — для товарной группы «Ветеринарные препараты»;
для КИ, в том числе вложенных в агрегат, указан действующий разрешительный документ — для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Натуральный мех», «Обувные товары», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые»;
суммарный вес / объём продукции, указанной в документе (включая продукцию, вложенную в агрегат), не превышает вес / объём, указанный в ВСД, более чем на:
- 2 % — для товарной группы «Морепродукты»;
- 5 % — для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция».

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

Тип

Описание

LK_CONTRACT_COMMISSIONING

Ввод в оборот. Контрактное производство. JSON (MANUAL)

LK_CONTRACT_COMMISSIONING_XML

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

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

{
  "producer_inn": "1111111111",
  "owner_inn": "1111111111",
  "production_date": "2021-07-06",
  "production_order": "CONTRACT_PRODUCTION",
  "products_list": [
    {
      "uit": "0000000000000000000AREwAwLETM0g000ffd0",
      "tnved_code": "6666666666",
      "licences": [
        {
          "licence_number": "12345678",
          "licence_date": "2021-07-07"
        },
        {
          "licence_number": "22222222",
          "licence_date": "2021-07-07"
        },
        {
          "licence_number": "33333333",
          "licence_date": "2021-07-07"
        }
      ],
      "certificate_document_data": [
        {
          "certificate_type": "STATE_REGISTRATION_CERTIFICATE",
          "certificate_number": "RU.01.ЯЯ.00.001.Е.000001.07.21",
          "certificate_date": "2021-07-07",
          "well_number": "44444444, 55555555, 55-Т"
        },
        {
          "certificate_type": "STATE_REGISTRATION_CERTIFICATE",
          "certificate_number": "RU.01.ЯЯ.00.001.Е.000002.07.21",
          "certificate_date": "2021-07-07",
          "well_number": "66666666, 77777777, 88888888"
        }
      ]
    }
  ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

producer_inn

string

ИНН производителя товара

Выполняется проверка на соответствие ИНН хозяйствующего субъекта, на который оформлен ВСД, возвращаемого в ответе ФГИС «ВетИС». Если ни одно из значений, указанных в полях «producer_inn» («ИНН производителя товара») и «owner_inn» («ИНН собственника товара»), не совпадает с ИНН хозяйствующего субъекта, то запрос обработается с ошибкой

owner_inn

string

ИНН собственника товара

production_date

string

Дата производства товара

Для товарных групп «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Строительные материалы» (только с кодом ТН ВЭД 2523, за исключением 2523 10 000 0), «Товары из натурального меха», «Шины и покрышки пневматические резиновые новые» параметр опциональный. Для остальных товарных групп обязательный, если дата производства не была указана в отчёте о нанесении для единиц товаров.

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

production_order

string

Тип производственного заказа

Возможное значение:
CONTRACT_PRODUCTION – контрактное производство

products_list

array of objects

Массив, содержащий список передаваемых кодов товаров

Должна быть указана хотя бы одна запись списка.

children

array of objects

Массив, содержащий список вложенных КИ

*uit

string

КИ / КиЗ

Требования к коду:

статус КИ — «APPLIED» («Нанесён»);
тип эмиссии — «LOCAL» («Производство РФ»);
тип упаковки — «UNIT» («Единица товара»), «GROUP» («Групповая упаковка»), «SET» («Набор») или «BUNDLE» («Комплект»);
особое состояние отсутствует.

Для товарной группы «Молочная продукция» допускается указывать КИ / КИН / КИГУ в статусе «RETIRED» («Выбыл»), если они были нанесены, но не были ранее введены в оборот.

Для всех товарных групп, кроме товарной группы «Товары из натурального меха»: при агрегации, осуществлённой до ввода в оборот, необходимо указать КИ агрегатов. КИГУ и КИН не вводятся в оборот без указания вложенных КИ

*uitu

string

КИТУ

Параметр не применим для товарной группы «Товары из натурального меха». Для других товарных групп: параметр обязательный, если не указано значение параметра «uit» («КИ / КиЗ»). Требования к КИТУ:

статус КИТУ не равен «DISAGGREGATION» («Расформирован»);
тип эмиссии вложений КИТУ — «LOCAL» («Производство РФ»), особое состояние отсутствует;
тип упаковки — «BOX» («КИТУ»)

*vsd_number

string

Идентификатор ВСД

Номер производственного ВСД.

Формат:

Порядок указания номера ВСД:

КИ — номер ВСД указывается для КИ;
КИГУ — номер ВСД указывается для вложенных КИ или для КИГУ, или и для вложенных КИ и для КИГУ, при этом номер ВСД у КИГУ и вложенных КИ должен совпадать. Номер ВСД, указанный только для КИГУ, по умолчанию передаётся всем вложенным КИ;
КИТУ, АТК — номер ВСД указывается только для вложенных КИ.
Номер ВСД, указанный для вложенных КИ, не передаётся по умолчанию агрегату.

*tnved_code

string

Код ТН ВЭД ЕАЭС товара

*certificate_document_data

array of objects

Массив сведений о разрешительной документации

Сведения могут быть указаны либо внутри массива «certificate_document_data» в параметрах «certificate_type», «certificate_number», «certificate_date», либо вне массива в параметрах «certificate_doc_type», «certificate_doc_number», «certificate_doc_date». Одновременное указание внутри и вне массива «certificate_document_data» не допускается. Одновременно должны быть заполнены все три параметра, либо все три не заполнены.

В остальных случаях параметры необязательные.

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа разрешительной документации

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string date

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

Указание времени в значении допускается, но игнорируется при обработке.

Формат:
yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон:

для «STATE_REGISTRATION_CERTIFICATE» — начиная с 1900-01-01 по текущую дату;
для остальных видов разрешительной документации — начиная с 2000-01-01 по текущую дату

**well_number

string

Номер скважины

*certificate_doc_date

string date

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

*certificate_doc_type

string

Тип документа, подтверждающего соответствие

*certificate_doc_number

string

Номер документа обязательной сертификации

*production_date

string

Дата производства товара

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

*licences

array of objects

Массив лицензий на пользование недрами

**licence_number

string

Номер лицензии на пользование недрами

**licence_date

string date

Дата выдачи лицензии

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

*children

array of objects

Массив, содержащий список вложенных КИ

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

<?xml version="1.0" encoding="UTF-8"?>
<introduce_contract version="7">
    <producer_inn>7777777777</producer_inn>
    <owner_inn>8888888888</owner_inn>
    <production_date>2020-04-07</production_date>
    <production_order>CONTRACT_PRODUCTION</production_order>
    <products_list>
        <product>
            <ki>000000000000000000CFHhW0ZO0nayEXCt0bTH</ki>
            <production_date>2019-11-20</production_date>
            <tnved_code>9999999999</tnved_code>
            <licences_list>
                <licence>
                    <number>12346796</number>
                    <date>2021-07-07</date>
                </licence>
                <licence>
                    <number>12346796</number>
                    <date>2021-07-07</date>
                </licence>
            </licences_list>
            <certificate_document_data>
                <product>
                    <certificate_type>STATE_REGISTRATION_CERTIFICATE</certificate_type>
                    <certificate_number>1234</certificate_number>
                    <certificate_date>2019-11-20</certificate_date>
                </product>
            </certificate_document_data>
            <children>
                <product>
                    <kitu>000000000000000000CFHhW0ZO0nayEXCt0bTH</kitu>
                    <production_date>2019-11-20</production_date>
                    <tnved_code>9999999999</tnved_code>
                    <children>
                        <product>
                            <ki>000000000000000000CFHhW0ZO0nayEXCt0bTH</ki>
                            <production_date>2019-11-20</production_date>
                            <tnved_code>9999999999</tnved_code>
                            <certificate_document_data>
                                <product>
                                    <certificate_type>STATE_REGISTRATION_CERTIFICATE</certificate_type>
                                    <certificate_number>1234</certificate_number>
                                    <certificate_date>2019-11-20</certificate_date>
                                    <well_number>44444444, 55555555, 66666666, 77777777, 55-Т</well_number>
                                </product>
                            </certificate_document_data>
                        </product>
                    </children>
                </product>
            </children>
        </product>
    </products_list>
</introduce_contract>

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

Создание документа доступно для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Натуральный мех», «Обувные товары», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Морепродукты», «Моторные масла», «Натуральный мех», «Растительные масла», «Сладости и кондитерские изделия», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» подача документа доступна только в формате * .json.

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»:

КИ с типом эмиссии «Ввезён в РФ» («FOREIGN») после успешной обработки отчёта о нанесении меняют статус с «Эмитирован» («EMITTED») на «Нанесён» («APPLIED»), после чего могут быть указаны в документе «Ввод в оборот. Импорт с ФТС» (LP_FTS_INTRODUCE).

Примечание

При получении ГИС МТ уведомления «Рассылка универсальных сведений из «ЕАИС ТО» о выпущенных товарах» от ФТС коды идентификации, по которым принято положительное решение, будут введены в оборот автоматически с помощью документа «Автоввод в оборот при импорте с ФТС» (LP_FTS_INTRODUCE_AUTO)

До старта обязательной маркировки товаров с характеристикой упаковки, отличной от «Кег», рекомендуется не указывать их КИ в документе на промышленном контуре. При указании таких КИ документ будет обработан успешно, но КИ не будут введены в оборот и останутся в особом состоянии «Ожидает подтверждения ФТС» вплоть до повторной подачи документа и получения соответствующего ответа от ФТС, поскольку до старта обязательной маркировки товаров с характеристикой упаковки, отличной от «Кег», ФТС не будет предоставлять сведения о таких товарах в ГИС МТ. Допускается указывать АТК.

При обработке документа осуществляется проверка ИНН и КПП отправителя документа на отсутствие блокировки в ЕГАИС.

Для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Моторные масла», «Натуральный мех», «Пиво, напитки, изготавливаемые на основе пива, и слабоалкогольные напитки», «Сладости и кондитерские изделия», «Упакованная вода» и «Шины и покрышки пневматические резиновые новые» выполняется проверка наличия сведений о разрешительном документе в декларации на товары для кодов единиц товаров и комплектов, в том числе вложенных в агрегат.

Для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Моторные масла», «Натуральный мех», «Пиво, напитки, изготавливаемые на основе пива, и слабоалкогольные напитки», «Сладости и кондитерские изделия», «Строительные материалы», «Упакованная вода», а также «Шины и покрышки пневматические резиновые новые» сведения о разрешительном документе, указанные в декларации на товары, должны:

соответствовать сведениям, указанным в карточках товаров в НКМТ ввозимых единиц товаров или комплектов, в том числе вложенных в агрегат. Если в карточке товара в НКМТ не указан ни один разрешительный документ и в параметре «reasonCertMissingDetails» («Требования подтверждения соответствия отсутствуют; основание») = «true», то проверка на соответствие разрешительных документов не осуществляется;
быть действующими.

Для товарных групп «Косметика, бытовая химия и товары личной гигиены» и «Строительные материалы» при отсутствии в декларации на товары сведений о разрешительном документе проверки осуществляются по уже существующим данным, указанным ранее в Системе маркировки для КИ единиц товаров или комплектов, в том числе для вложенных в агрегат.

Если ранее в Системе маркировки для кода был указан иной разрешительный документ, он будет перезаписан сведениями из декларации на товары.

Во избежание ошибок перед подачей документа необходимо убедиться:

в наличии действующей лицензии на производство в реестре Россельхознадзора — для товарной группы «Ветеринарные препараты»;
суммарный вес / объём продукции, указанной в документе (включая продукцию, вложенную в агрегат), не превышает вес / объём, указанный в ВСД, более чем на:
- 2 % — для товарной группы «Морепродукты»;
- 5 % — для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция».

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

Тип

Описание

LP_FTS_INTRODUCE

Ввод в оборот. Импорт с ФТС. JSON (MANUAL)

LP_FTS_INTRODUCE_XML

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

Пример тела документа в формате * .json для товарных групп «Молочная продукция» и «Морепродукты»:

{
   "trade_participant_inn":"7777777777",
   "declaration_number":"50999020/010721/0002040",
   "declaration_date":"2021-07-01",
   "production_date":"2021-06-17",
   "products_list":[
      {
         "ki":"0104611111111111215znbGV",
         "production_date":"2020-06-10",
         "vsd_number":"111a1a11-aaa1-1a11-11aa-aa1111a11111",
         "children":[
            {
               "ki":"0104622222222222215JFvd?",
               "production_date":"2020-06-10",
               "vsd_number":"222a2a22-aaa2-2a22-22aa-aa2222a22222"
            },
            {
               "ki":"0104633333333333215fEhY!",
               "production_date":"2021-06-17",
               "vsd_number":"333a3a33-aaa3-3a33-33aa-aa3333a33333"
            }
         ]
      }
   ]
}

Пример тела документа в формате * .json для товарных групп «Обувные товары» и «Предметы одежды, бельё постельное, столовое, туалетное и кухонное»:

{
   "trade_participant_inn":"7777777777",
   "declaration_number":"50999020/010721/0002040",
   "declaration_date":"2021-07-01",
   "products_list":[
      {
         "cis":"010461111111111121NNNNNNNNNNNNN",
         "color":"RED",
         "productSize":"20.5"
      },
      {
         "cis":"000000000000000001",
         "color":"RED",
         "productSize":"20.5",
         "children":[
            {
               "cis":"010462222222222221TTTTTTTTTTTTT",
               "color":"RED",
               "productSize":"20.5"
            }
         ]
      },
      {
         "cis":"00000000000000000000000000000000000004",
         "color":"RED",
         "productSize":"20.5",
         "children":[
            {
               "cis":"010462222222222221KKKKKKKKKKKKK",
               "color":"RED",
               "productSize":"20.5"
            }
         ]
      }
   ]
}

Пример тела документа в формате * .json для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»:

{
   "trade_participant_inn":"string",
   "trade_participant_kpp":"string",
   "declaration_number":"string",
   "declaration_date":"2021-01-29",
   "products_list":[
      {
         "cis":"string"
      }
   ]
}

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

{
   "trade_participant_inn":"7777777777",
   "declaration_number":"50999020/010721/0002040",
   "declaration_date":"2021-07-01",
   "products_list":[
      {
         "cis":"010461111111111121NNNNNNNNNNNNN"
      },
      {
         "cis":"000000000000000001",
         "children":[
            {
               "cis":"010462222222222221TTTTTTTTTTTTT"
            }
         ]
      },
      {
         "cis":"00000000000000000000000000000000000004",
         "children":[
            {
               "cis":"010462222222222221KKKKKKKKKKKKK"
            }
         ]
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН участника оборота товаров

trade_participant_kpp

string

КПП участника оборота товаров

Заполнен, если товарная группа «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки». Формат: 9 цифр

declaration_number

string

Регистрационный номер ДТ

Формат: XXXXXXXX/XXXXXX/XXXXXXX (23 цифры (8, 6 и 7), разделённых символом «/»)

declaration_date

string(9-14)

Дата регистрации ДТ

Формат: YYYY-MM-DD. Диапазон даты: с 01.01.2000 по дату создания документа. Соответствует дате в значении параметра «declaration_number» («Регистрационный номер ДТ»)

production_date

string date

Дата производства товара

Для товарной группы «Молочная продукция» параметр является обязательным, если дата производства не была указана при подаче отчёта о нанесении. Если параметр будет заполнен для КИ, у которого ранее была указана дата производства, то она изменится на ту, что указана в этом параметре.

Для остальных товарных групп параметр опциональный.

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

products_list

array of objects

Массив, содержащий список кодов для ввода в оборот

*cis / *ki / *kitu / *atk

string

Код

Код должен быть указан в одном из параметров в зависимости от типа упаковки:

«cis» — для любого типа упаковки;
«ki» — для любого типа упаковки, кроме «BOX» (транспортная упаковка (КИТУ)) и «ATK» (агрегированный таможенный код (АТК));
«kitu» — для типов упаковки «GROUP» (групповая упаковка (КИГУ)) и «BOX» (транспортная упаковка (КИТУ));
«atk» — для типа упаковки «ATK» (агрегированный таможенный код (АТК)).

При указании КИ, входящего в состав агрегата, агрегат автоматически расформировывается. Указываемый код должен быть без особого состояния или с особым состоянием «FTS_RESPOND_NOT_OK» («Отрицательное решение ФТС») / «FTS_CONTROL» («На контроле ФТС»).

При одновременном указании агрегата и его вложений вне параметра «children» («Массив, содержащий список вложенных КИ») документ обрабатывается с ошибкой.

Если в документе указан КИ агрегата, то ввод в оборот производится успешно, когда в ДТ найден данный КИ агрегата (АТК, КИТУ) с положительным решением ФТС.

При подаче сведений об импорте:

групповой упаковки / комплекта — в ДТ и в документе указывается только КИГУ / КИК;
набора — в ДТ указывается только КИН, если его вложения с одинаковыми кодами ТН ВЭД, и указываются КИ, находящиеся в составе набора, сгруппированные в строках ДТ согласно коду ТН ВЭД — если вложения в наборе с разными кодами ТН ВЭД. При этом в документе всегда указывается только КИН

*color

string

Цвет

Заполнен, если товарная группа «Обувные товары» или «Предметы одежды, бельё постельное, столовое, туалетное и кухонное». Длина значения от 1 до 1024 буквенных символа на английском или русском языке

*productSize

string

Размер

*vsd_number

string

Идентификатор ВСД

Номер первого транспортного ВСД. Параметр обязательный, если товар подлежит ветеринарному контролю (в карточке в НКМТ «veterinaryControl» («Подлежит ветеринарному контролю (надзору)») = «true»). Для неподконтрольных товаров параметр строго отсутствует.

Формат:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12};
[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12};
[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4};
[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}.

Порядок указания номера ВСД:

КИ — номер ВСД указывается для КИ;
КИГУ — номер ВСД указывается для вложенных КИ и / или для КИГУ (номер ВСД у КИГУ и вложенных КИ должен совпадать).

Номер ВСД, указанный только для КИГУ, по умолчанию передаётся всем вложенным КИ;
КИН, КИТУ, АТК — номер ВСД указывается только для вложенных КИ.
Номер ВСД, указанный для вложенных КИ, не передаётся по умолчанию агрегату.

*production_date

string date

Дата производства товара

Для товарной группы «Молочная продукция» параметр является обязательным, если дата производства не была указана при подаче отчёта о нанесении и вне массива «products_list» («Массив, содержащий список кодов для ввода в оборот»). Если параметр будет заполнен для КИ, у которого ранее была указана дата производства, то она изменится на ту, что указана в этом параметре.

Для остальных товарных групп параметр опциональный.

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

*children

array of objects

Массив, содержащий список вложенных КИ

Рекурсивный элемент, содержащий те же параметры, что и массив «products_list» («Массив, содержащий список передаваемых КИ»). Заполняется только для КИН, КИГУ, КИТУ, АТК. Параметр обязательный для вложений, которые подлежат ветеринарному контролю. Для неподконтрольных вложений параметр опциональный.

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

После обработки документа к каждому КИ будет указано решение о выпуске, полученное от ФТС. Возможные значения:

FTS_RESPONSE_OK — положительное решение, товар введён в оборот;
FTS_RESPONSE_NOT_OK — отрицательное решение, товар не введён в оборот.

Пример тела документа в формате * .xml для товарной группы «Молочная продукция»:

<?xml version="1.0" encoding="UTF-8"?>
<introduce_import_fts version="3">
    <trade_participant_inn>7777777777</trade_participant_inn>
    <declaration_number>11111111/222222/3333333</declaration_number>
    <declaration_date>2020-03-01</declaration_date>
    <production_date>2020-02-01</production_date>
    <products_list>
        <product>
            <ki>0104611111111111215znbGV</ki>
            <production_date>2020-02-01</production_date>
            <vsd_number>111a1a11-aaa1-1a11-11aa-aa1111a11111</vsd_number>
        </product>
        <product>
            <kitu>000000000100023580</kitu>
            <children>
                <product>
                    <ki>0104622222222222215JFvd?UPw</ki>
                    <vsd_number>222a2a22-aaa2-2a22-22aa-aa2222a22222</vsd_number>
                </product>
            </children>
        </product>
        <product>
            <atk>23000000000100023580</atk>
            <children>
                <product>
                    <ki>0104633333333333215fEhY!</ki>
                    <production_date>2020-02-01</production_date>
                    <vsd_number>333a3a33-aaa3-3a33-33aa-aa3333a33333</vsd_number>
                </product>
            </children>
        </product>
    </products_list>
</introduce_import_fts>

Пример тела документа в формате * .xml для других товарных групп:

<?xml version="1.0" encoding="UTF-8"?>
<introduce_import_fts version="3">
    <trade_participant_inn>7777777777</trade_participant_inn>
    <declaration_number>11111111/222222/3333333</declaration_number>
    <declaration_date>2020-03-01</declaration_date>
    <products_list>
        <product>
            <ki>010461111111111121NNNNNNNNNNNNN</ki>
            <color>RED</color>
            <product_size>20.511111111111111111111111zzz</product_size>
        </product>
        <product>
            <ki>010462222222222221TTTTTTTTTTTTT</ki>
            <color>RED</color>
            <product_size>20.5</product_size>
        </product>
        <product>
            <kitu>333333333333333333</kitu>
            <color>RED</color>
            <product_size>20.5</product_size>
            <children>
                <product>
                    <ki>010462222222222221KKKKKKKKKKKKK</ki>
                    <color>RED</color>
                    <product_size>20.5</product_size>
                </product>
            </children>
        </product>
        <product>
            <atk>4444444444444444444444444</atk>
            <color>RED</color>
            <product_size>20.5</product_size>
            <children>
                <product>
                    <ki>010462222222222221FFFFFFFFFFFFF</ki>
                    <color>RED</color>
                    <product_size>20.5</product_size>
                </product>
            </children>
        </product>
    </products_list>
</introduce_import_fts>

4.1.4.9. Ввод в оборот. Импорт ФТС ("Товары из натурального меха")

Создание документа доступно для товарной группы "Товары из натурального меха".

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

Тип

Описание

FURS_FTS_INTRODUCE

Ввод в оборот. Импорт ФТС ("Товары из натурального меха"). JSON (MANUAL)

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

{
    "trade_participant_inn": "0000000000",
    "declaration_number": "11111111/040821/3333333",
    "declaration_date": "2021-08-04",
    "products_list": [
        {
            "cis": "KZ-123456-2016061001",
            "pack_type": "UNIT",
            "tnved_code": "4303109010",
            "goods_description": "Шубы детские"
        },
        {
            "cis": "KZ-123456-2016061002",
            "pack_type": "UNIT",
            "tnved_code": "4303109080",
            "fur_kind": 4,
            "goods_description": "Полушубок из шиншиллы"
        }
    ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН участника оборота товаров

declaration_number

string

Регистрационный номер ДТ

Обязательный при заполнении параметра "declaration_date" ("Дата регистрации ДТ").

Формат:XXXXXXXX/XXXXXX/XXXXXXX (23 цифры (8, 6 и 7), разделённых символом "/"). Вторая группа цифр в регистрационном номере должна совпадать со значением даты регистрации декларации, указанной в поле "declaration_date" ("Дата декларации на товары"), и соответствовать формату: ddMMyy.

declaration_date

string(9-14)

Дата регистрации ДТ

Обязательный при заполнении параметра "declaration_number" ("Регистрационный номер ДТ"). Соответствует значению параметра "declaration_number" ("Регистрационный номер ДТ")

Формат:
yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон даты: с 01.01.2000 по дату создания документа

products_list

array of objects

Список номеров КиЗ

cis

string

Номер КиЗ

Требования к КиЗ:

статус КиЗ — «APPLIED» («Нанесён»);
тип эмиссии — «FOREIGN» («Ввезён в РФ»);
особое состояние — «INDIVIDUAL» («КиЗ индивидуализирован»), «NON_INDIVIDUAL» («Не индивидуализирован»), «FTS_RESPOND_NOT_OK» («Отрицательное решение ФТС»), «FTS_RESPOND_NOT_OK_NON_INDIVIDUAL» («Отрицательное решение ФТС»)

*pack_type

string

Тип упаковки

Возможные значения:
"UNIT" - "Единица товара"

*tnved_code

string

Код ТН ВЭД

*fur_kind

number

Вид меха

Обязательный при значении параметра "tnved_code" ("Код ТН ВЭД") равном "4303109080" ("Прочие предметы одежды").

Строго не заполнен, если параметр "tnved_code" ("Код ТН ВЭД") не равен "4303109080".

Возможные значения см. в разделе "Справочник "Вид меха""

*goods_description

string

Описание товара

Длина значения от 1 до 350 символов включительно

Ввод в оборот КиЗ производится только при выполнении всех следующих условий:

получение положительного решения ФТС;
успешная обработка документа «Ввод в оборот. Импорт ФТС. Мех» (FURS_FTS_INTRODUCE);
успешная обработка документа «Индивидуализация КиЗ» (LK_INDIVIDUALIZATION, LK_INDIVIDUALIZATION_XML).

4.1.4.10. Ввод в оборот. С причиной

Создание документа доступно для товарной группы «Радиоэлектронная продукция».

Примечание

Подача документа временно ограничена. О возобновлении возможности формирования документа будет сообщено дополнительно

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

Тип

Описание

LK_UNIVERSAL_INTRODUCE

Ввод в оборот. С причиной. JSON (MANUAL)

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

{
   "participant_inn":"1111111111",
   "reason_type":"DISMANTLING",
   "products":[
      {
         "uit_code":"010461111111111121LLLLLLLLLLLLL"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товаров

Отправитель документа должен быть собственником кодов

reason_type

string

Причина ввода товара в оборот

Возможное значение:

«DISMANTLING» («Разукомплектация»)

products

array of objects

Список товаров

uit_code

string

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

Требования к кодам:

тип упаковки «UNIT» («Единица товара»);
статус «APPLIED» («Нанесён»), особое состояние отсутствует;
тип эмиссии «REAPPLY» («Маркировка вне производства или импорта»)

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

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

При этом для товарных групп «Альтернативная табачная продукция», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Молочная продукция», «Морепродукты», «Моторные масла», «Никотиносодержащая продукция», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Табачная продукция», «Упакованная вода» подача документа доступна только в формате * .json.

Особенности для мультитоварных наборов:

товарные группы всех кодов, указываемых непосредственно в документе, должны совпадать. Товарные группы их вложений могут отличаться;
проверка разрешительных документов выполняется для каждого кода, включая вложения;
причина возврата должна быть доступна для всех товарных групп указанных кодов.

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

Тип

Описание

LP_RETURN

Возврат в оборот. JSON (MANUAL)

LP_RETURN_XML

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

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

{
   "trade_participant_inn":"7777777777",
   "return_type":"OWN_USE_RETURN",
   "products_list":[
      {
         "ki":"string"
      },
      {
         "ki":"string"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_inn

string

ИНН участника оборота товара

Отправитель документа должен быть собственником кодов

return_type

string

Причина возврата

Причина возврата должна соответствовать причине выбытия указываемых кодов. См. «Справочник «Причины возврата с соответствующими причинами выбытия»»

paid

boolean

Признак оплаты товара

Обязательный на уровне документа (вне массива «products_list»), либо на уровне товаров (в массиве «products_list»), если «return_type» = «REMOTE_SALE_RETURN». Для иных значений параметр строго отсутствует.

Значение параметра «paid» в массиве «products_list» превалирующее.

Возможные значения:

true — товар оплачен покупателем;
false — товар не оплачен покупателем

state_contract_id

string

Идентификатор государственного контракта

Обязательный, если «return_type» = «STATE_CONTRACT_RETURN». Для иных значений параметр строго отсутствует.

Идентификатор должен совпадать с идентификатором, указанным в документе «Вывод из оборота» (LK_RECEIPT, LK_RECEIPT_CSV, LK_RECEIPT_XML) для возвращаемого кода.

Формат: 25 цифровых символов, 13-ый по счёту символ должен иметь значение «1», «2» или «3»

primary_document_type

string

Вид первичного документа

Обязательный на уровне документа (вне массива «products_list»), либо на уровне товаров (в массиве «products_list») для причин возврата:

«RETAIL_RETURN»;
«NOT_FOR_SALE_RETURN»;
«REMOTE_SALE_RETURN» и «paid» = true.

Для иных значений параметр строго отсутствует.

Если данный параметр указан, то «primary_document_number» и «primary_document_date» являются обязательными на том же уровне, на котором указан «primary_document_type». Сведения о первичном документе, указанные на уровне товаров, превалирующие.

Возможные значения:

«RECEIPT» («Кассовый чек») — только для причины возврата «RETAIL_RETURN» и «REMOTE_SALE_RETURN»;
«SALES_RECEIPT» («Товарный чек») — только для причины возврата «RETAIL_RETURN» и «REMOTE_SALE_RETURN»;
«OTHER» («Прочее»)

primary_document_number

string

Номер первичного документа

См. комментарий к параметру «primary_document_type» вне массива «products_list».

Длина значения — от 1 до 255 символов включительно

primary_document_date

string

Дата первичного документа

См. комментарий к параметру «primary_document_type» вне массива «products_list».

Диапазон: не менее текущей даты минус 5 лет. Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке

primary_document_custom_name

string

Наименование первичного документа

Обязательный, если «primary_document_type» = «OTHER», иначе — строго отсутствует.

Значение «primary_document_custom_name» в массиве «products_list» превалирующее

certificate_type

string

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

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

товарная группа «Ветеринарные препараты» или «Специализированная пищевая продукция и БАД к пище»;
причина возврата: «STATE_CONTRACT_RETURN», «VENDING_RETURN» или «OWN_USE_RETURN».

В остальных случаях параметр необязательный.

Одновременное заполнение сведений о документе, подтверждающем соответствие, внутри и вне массива «products_list» не допускается.

Может быть указан только для КИ и КИК.

Возможные значения см. в разделе «Справочник «Виды разрешительной документации»»

certificate_number

string

Номер документа, подтверждающего соответствие

См. комментарий к параметру «certificate_type» вне массива «products_list».

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

certificate_date

string

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

См. комментарий к параметру «certificate_type» вне массива «products_list».

Диапазон: начиная с 2000-01-01 по текущую дату плюс один день. Если «certificate_type» = «STATE_REGISTRATION_CERTIFICATE», то диапазон: начиная с 1900-01-01 по текущую дату плюс один день. Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

products_list

array of objects

Список сведений о товарах

*ki

string

Код

Требования к кодам:

уникальны внутри массива «products_list»;
типы: КИ / КиЗ, КИГУ, КИК, КИН;
статус «RETIRED» («Выбыл»), особое состояние отсутствует;
дата истечения срока годности не менее текущей даты, если «return_type» = «STATE_CONTRACT_RETURN»;
соответствующий ВСД не аннулирован в ФГИС «ВетИС» (для КИ, у которого в карточке товара в НКМТ «veterinaryControl» («Подлежит ветеринарному контролю (надзору)») = true).

При возврате в оборот КИГУ, КИН в оборот так же возвращаются КИ, входящие в состав агрегата, с сохранением информации о КИ агрегата и вложенных КИ.

При указании вложенного КИ, агрегат будет расформирован

*paid

boolean

Признак оплаты товара

Cм. комментарий к одноимённому параметру вне массива «products_list»

*primary_document_type

string

Вид первичного документа

*primary_document_number

string

Номер первичного документа

*primary_document_date

string

Дата первичного документа

*primary_document_custom_name

string

Наименование первичного документа

*certificate_type

string

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

*certificate_number

string

Номер документа, подтверждающего соответствие

*certificate_date

string

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

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

<?xml version="1.0" encoding="UTF-8"?>
<return version="1">
	<trade_participant_inn>0000000000</trade_participant_inn>
	<return_type>OWN_USE_RETURN</return_type>
	<products_list>
		<product>
			<ki>0000000000000000000000000000000</ki>
		</product>
	</products_list>
</return>

4.1.6. Отгрузка

4.1.6.1. Отгрузка по России

Создание документа доступно для товарной группы "Товары из натурального меха".

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

Тип

Описание

LP_SHIP_GOODS

Отгрузка. JSON (MANUAL)

LP_SHIP_GOODS_CSV

Отгрузка. CSV

LP_SHIP_GOODS_XML

Отгрузка. XML

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

{
  "sender_inn": "0000000000",
  "receiver_inn": "1111111111",
  "transfer_date": "2021-03-12T18:26:41.948Z",
  "document_num": "4234234",
  "document_date": "2021-03-12T18:26:41.948Z",
  "turnover_type": "SELLING",
  "to_not_participant": "false",
  "products": [
    {
      "uit_code": "RU-000000-0000000000",
      "product_cost": "10000000",
      "product_tax": "1300000"
    },
    {
      "uit_code": "RU-111111-1111111111",
      "product_cost": "15000000",
      "product_tax": "0"
    }
  ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

receiver_inn

string

ИНН получателя

sender_inn

string

ИНН отправителя

transfer_date

string

Дата отгрузки

Формат:

yyyy-MM-ddTHH:mm:ss.SSS
yyyy-MM-ddTHH:mm:ss
dd.MM.yyyy
dd.MM.yyyy HH:mm
yyyy-MM-dd

document_num

string

Номер первичного документа

Длина значения: до 255 символов

document_date

string

Дата первичного документа

Формат:

yyyy-MM-ddTHH:mm:ss.SSS
yyyy-MM-ddTHH:mm:ss
dd.MM.yyyy
dd.MM.yyyy HH:mm
yyyy-MM-dd

turnover_type

string

Код типа отгрузки

Возможные значения:

"SELLING" — "Продажа";
"COMMISSION" — "Комиссия";
"AGENT" — "Агент".

Значение должно совпадать со значением поля "turnover_type" ("Код типа отгрузки") в документе "Приёмка отгрузки по России"

to_not_participant

boolean

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

Возможные значения:
"true" — "Отгрузка неучастнику";
"false" — "Отгрузка участнику"

products

array

Массив, содержащий список передаваемых КиЗ

*uit_code

string

КиЗ

*product_cost

decimal

Цена за единицу

Для товарной группы "Товары из натурального меха" обязательный при любом значении "turnover_type" ("Код типа отгрузки"):

"SELLING" — "Продажа";
"COMMISSION" — "Комиссия";
"AGENT" — "Агент".

Цена указывается в копейках с учётом НДС (если сделка облагается НДС). Значение не может быть отрицательным, должно быть строго больше "product_tax" ("Сумма НДС"), длина числового значения от 0 до 17 цифр включительно. Диапазон значений: от 0 до 99999999999999999 включительно

*product_tax

decimal

Сумма НДС

Сумма НДС указывается в копейках. Значение не может быть отрицательным, должно быть строго меньше "product_cost" ("Цена за единицу"), длина числового значения от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение "0".

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

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

ИНН отправителя,ИНН получателя,Дата отгрузки,Номер первичного документа,Дата первичного документа,Вид оборота товаров,Причина вывода из оборота,Дата вывода из оборота,Идентификатор гос.контракта,Отгрузка неучастнику,Версия
000000000,1111111111,25.05.2020,123,25.05.2020,Продажа,,,,Нет,5
Параметры товаров
КИ,КИТУ,Цена за единицу,Сумма НДС
"RU-000000-0000000000",,10000000,1300000

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

<?xml version="1.0" encoding="UTF-8"?>
<shipment action_id="10" version="5">
    <trade_participant_inn_sender>1111111111</trade_participant_inn_sender>
    <trade_participant_inn_receiver>2222222222</trade_participant_inn_receiver>
    <transfer_date>2020-11-13</transfer_date>
    <move_document_number>123</move_document_number>
    <move_document_date>2020-11-13</move_document_date>
    <turnover_type>SELLING</turnover_type>
    <to_not_participant>false</to_not_participant>
    <products_list>
        <product>
            <ki>RU-000000-0000000000</ki>
            <cost>330305</cost>
            <vat_value>27085</vat_value>
        </product>
    </products_list>
</shipment>

4.1.6.2. Отгрузка в ЕАЭС

В ГИС МТ обеспечен процесс подачи сведений об отгрузке КИ, эмитированных в Российской Федерации, в государства-члены ЕАЭС с признанием в Национальной информационной системе маркировки и прослеживаемости товаров государств-членов ЕАЭС. Подача сведений об отгрузке в ЕАЭС с признанием КИ реализована для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Моторные масла», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Упакованная вода», «Шины и покрышки пневматические резиновые новые».

При этом для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Моторные масла», «Растительные масла», «Соковая продукция и безалкогольные напитки» подача документа доступна только в формате * .json.

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

Тип

Описание

EAS_CROSSBORDER_EXPORT

Отгрузка в ЕАЭС. JSON (MANUAL)

EAS_CROSSBORDER_EXPORT_CSV

Отгрузка в ЕАЭС. CSV

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

{
   "sender_inn":"0000000000",
   "receiver_inn":"111111111",
   "receiver":"X",
   "receiver_gln": "0000000000002",
   "receiver_country_code":112,
   "document_num":"UECB00000000000000000000-0000",
   "document_date":"2021-12-13",
   "transfer_date":"2021-12-13",
   "products":[
      {
         "cis":"0000000000000000000n)YspnXyJ9tU",
         "product_cost":100,
         "product_tax":50,
         "import_data":{
            "importer_id":"1234567890",
            "importer_name":"ООО Импортер",
            "declaration_number":"88888888/131221/7777777",
            "declaration_date":"2021-12-13"
         },
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-11-30"
            },
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00002/21",
               "certificate_date":"2021-11-30"
            }
         ]
      },
      {
         "cis":"0000000000000000005Gb=\"1K?/HQ;p",
         "product_cost":17300000,
         "product_tax":0,
         "production_data":{
            "producer_id":"123456789",
            "producer_name":"ООО Производитель"
         }
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

sender_inn

string

Идентификатор отправителя

ИНН текущего участника оборота товаров РФ

receiver_inn

string

Идентификатор получателя

Длина значения: 8/9/10/12/14 цифр

receiver

string

Наименование получателя

Длина от 1 до 255 символов включительно

receiver_gln

string

Глобальный номер места нахождения получателя (GLN)

Длина 13 символов. Допустимые символы: цифры от 0 до 9.

При отгрузке товара в Республику Беларусь указание параметра является обязательным. В случае указания некорректного значения или его отсутствия вернётся ошибка о том, что получатель товара не найден. При отгрузке в другие государства-члены ЕАЭС, если значение атрибута не передано, то атрибут автоматически будет заполнен значением «0000000000000»

receiver_country_code

string

Код страны получателя

Код государства-члена ЕАЭС, на территорию которого осуществляется вывоз товаров.

Возможные значения:

для товарной группы «Обувные товары»:

«112» — Республика Беларусь;
«398» — Республика Казахстан.
для товарной группы «Соковая продукция и безалкогольные напитки»:

«051» — Республика Армения;
«112» — Республика Беларусь.
для товарных групп «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Шины и покрышки пневматические резиновые новые»:

«112» — Республика Беларусь.
для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Моторные масла», «Растительные масла» и «Упакованная вода»:

«051» — Республика Армения

document_num

string

Номер первичного документа

Длина от 1 до 255 символов включительно

document_date

string

Дата первичного документа

Формат:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

transfer_date

string (date-time)

Дата и время отгрузки

Формат:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

products

array of objects

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

Должна быть заполнена хотя бы одна запись. Количество указываемых КИ не должно превышать 30 000

*cis

string

Передаваемый КИ

Требования, предъявляемые к КИ:

уникален в массиве «products» («Массив, содержащий список передаваемых КИ»);
товарная группа совпадает со значением параметра «pg» («Товарная группа»), указанным в запросе;
статус — «INTRODUCED» («В обороте»);
особое состояние не заполнено;
код товара не принадлежит диапазону 0290 — 0299;
вложенные КИ не заполнены;
КИ агрегата не заполнен;
тип упаковки — «UNIT» («Единица товара») / «BUNDLE» («Комплект») (только при экспорте в Республику Беларусь).

Признанные коды идентификации хранятся в базах данных ГИС МТ без кодов проверки.

Максимальное количество КИ в одном документе — 30 000

*product_cost

integer

Цена за единицу

Цена указывается в копейках с учётом НДС (если сделка облагается НДС). Значение должно быть строго больше «product_tax» («Сумма НДС»), до 17 символов

*product_tax

integer

Сумма НДС

Сумма НДС указывается в копейках. Значение должно быть строго меньше «product_cost» («Цена за единицу»), до 17 символов. Если сделка не облагается НДС, то указывается значение «0»

*production_date

string

Дата производства

Обязательно заполнен для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Моторные масла», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Упакованная вода». Может быть указан только для кодов с типом упаковки UNIT («Единица товара»).

Формат:
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Указание времени допускается, но игнорируется при обработке. Диапазон: не более текущей даты плюс один день и не менее текущей даты минус 20 лет

*expiration_date

string

Дата истечения срока годности

Формат:
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Указание времени допускается, но игнорируется при обработке. Диапазон: не менее текущей даты минус 1 день и не более 31.12.2099

*certificate_document_data

array of objects

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

Параметр и вложенные значения временно опциональны. Одновременно должны быть заполнены все три параметра, либо все три не заполнены

**certificate_type

string

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

Если данный параметр указан, то «certificate_number» и «certificate_date» являются обязательными. Возможные значения см. в разделе «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

Если данный параметр указан, то «certificate_type» и «certificate_date» являются обязательными. Формат: значение должно соответствовать регулярному выражению

**certificate_date

string

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

Если данный параметр указан, то «certificate_type» и «certificate_number» являются обязательными. Формат:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон: начиная с 2000-01-01 по текущую дату. Если в параметре «certificate_type» («Вид документа разрешительной документации») указано значение «STATE_REGISTRATION_CERTIFICATE» («Свидетельство о государственной регистрации»), то диапазон: начиная с 1900-01-01 по текущую дату

*import_data

object

Данные импорта

**importer_id

string

ИНН (или аналог) импортёра

От 1 до 50 символов включительно. Является обязательным, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен

**importer_name

string

Наименование импортёра

От 1 до 255 символов включительно. Является обязательным, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен

**declaration_number

string

Регистрационный номер декларации на товары

Три группы, разделённые символом «/», где первая группа может содержать 2, 5 либо 8 символов, вторая — 6 (дата декларации на товары), третья — 7. Пример: 88888888/010422/7777777. Вторая группа цифр в регистрационном номере должна совпадать со значением даты регистрации декларации, указанной в поле «declaration_date» («Дата декларации на товары»), и соответствовать формату: ddMMyy.

Является обязательным, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен

**declaration_date

string

Дата декларации на товары

Диапазон даты: с 01.01.2000 по дату создания документа. Является обязательным, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен. Соответствует значению параметра «declaration_number» («Регистрационный номер декларации на товары»).

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке документа

*production_data

object

Данные производства

**producer_id

string

ИНН (или аналог) производителя

От 1 до 50 символов включительно. Является обязательными, если заполнен параметр «production_data» («Данные производства»), иначе — строго не заполнен

**producer_name

string

Наименование производителя

От 1 до 255 символов включительно. Является обязательными, если заполнен параметр «production_data» («Данные производства»), иначе — строго не заполнен

*part_number

string

Номер партии товара

Может быть заполнен для товарной группы «Молочная продукция», для других товарных групп строго не заполнен.

Формат: от 21 до 32 символов включительно с учётом пробелов. Допустимые символы: цифры, буквы латинского алфавита, спецсимволы (/ . , -)

*product_weight

integer

Переменный вес продукта (в граммах)

Обязательный для товарной группы «Корма для животных», «Молочная продукция», «Морепродукты» если в карточке товара в НКМТ «isVarQuantity» («Товар с переменным количеством») = true. Для остальных товарных групп — необязательный. Для товаров без переменного количества параметр должен строго отсутствовать.

Диапазон значений: от 1 до 999999 включительно

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

Номер первичного документа,Дата первичного документа,ИНН участника оборота заявителя,ИНН (или аналог) получателя в стране ЕАЭС,Наименование получателя в стране ЕАЭС,Код страны получателя,Дата отгрузки,Глобальный номер места нахождения получателя (GLN),Версия
111111111,20.05.2020,1111111111,222222222,ООО Получатель в Республике Беларусь,112,20.05.2020,1232222222222,3
Параметры товаров,,,,,,,,
Код товара,Цена за единицу,Сумма НДС,Вид документа подтверждающего соответствие,Номер документа подтверждающего соответствие,Дата документа подтверждающего соответствие,Идентификатор импортера,Наименование импортера,Регистрационный номер декларации на товары,Дата декларации на товары,Идентификатор производителя,Наименование производителя
0100000000000002222222222222222,100,10,,,,1111111111,ООО Импортер,11111111/222222/3333333,10.10.2021,,

4.1.6.3. Отгрузка в ЕАЭС (ОСУ)

Создание документа доступно для товарной группы «Молочная продукция». Подача документа осуществляется экспортёром РФ до фактического перемещения маркированных товаров на территорию Республики Беларусь. В рамках документа выполняется передача объёмно-сортовых показателей (коды товаров, количество товара, количество групповых упаковок (при необходимости)).

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

Тип

Описание

EAS_GTIN_CROSSBORDER_EXPORT

Отгрузка в ЕАЭС (ОСУ). JSON (MANUAL)

EAS_GTIN_CROSSBORDER_EXPORT_CSV

Отгрузка в ЕАЭС (ОСУ). CSV

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

{
   "document_num":"123",
   "document_date":"2021-12-31",
   "exporter_inn":"1111111111",
   "receiver_inn":"100000000",
   "receiver_name":"ПРИМЕР",
   "receiver_gln": "1234567891234",
   "country":"112",
   "transfer_date":"2021-12-31",
   "products":[
      {
         "gtin":"04611111111111",
         "product_name":"string",
         "cis_quantity":160,
         "vsd_number":"1111-1111-1111-1111-1111-1111-1111-1111",
         "cost":16000,
         "tax":0
      },
      {
         "gtin":"04622222222222",
         "product_name":"string",
         "cis_quantity":10000000,
         "group_quantity":100,
         "cost":200000,
         "tax":200
      },
      {
         "gtin":"04633333333333",
         "product_name":"string",
         "cis_quantity":10000000,
         "group_quantity":100,
         "cost":50000,
         "tax":0
      },
      {
         "gtin":"04644444444444",
         "product_name":"string",
         "cis_quantity":10000000,
         "group_quantity":100,
         "cost":50000,
         "tax":0,
         "certificate_document_data":[
            {
               "certificate_type":"STATE_REGISTRATION_CERTIFICATE",
               "certificate_number":"RU.01.ЯЯ.00.001.Е.000001.07.21",
               "certificate_date":"2021-12-21"
            }
         ]
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

document_num

string

Номер первичного документа

Длина значения: от 1 до 255 символов включительно

document_date

string

Дата первичного документа

Допустимые форматы:

dd.MM.yyyy;
yyyy-MM-dd

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

exporter_inn

string

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

receiver_inn

string

ИНН (или аналог) получателя в стране ЕАЭС

Длина значения: 9 цифр

receiver_name

string

Наименование получателя в стране ЕАЭС

Длина значения: от 1 до 255 символов включительно

receiver_gln

string

Глобальный номер места нахождения получателя (GLN)

Длина 13 символов. Допустимые символы: цифры от 0 до 9.

transfer_date

string (date-time)

Дата отгрузки товара

Значение не может быть ранее даты первичного документа. Дата может быть указана в будущем. Допустимые форматы:

dd.MM.yyyy;
yyyy-MM-dd

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

country

string

Код страны получателя

Числовой код (3 цифры) из ОКСМ. Возможное значение: 112 (Республика Беларусь)

products

array of objects

Список передаваемых товаров

Должна быть указана хотя бы одна запись списка. Количество указываемых КИ не должно превышать 30 000

*gtin

string

Код товара

Указать 14 цифр (без пробелов, специальных символов, букв) кода отгружаемого товара, зарегистрированного в НКМТ и относящегося к товарной группе «Молочная продукция».

Требования, предъявляемые к коду товара:

пара значений параметров «gtin» («Код товара») и «vsd_number» («Идентификатор ВСД») должна быть уникальна внутри массива «products» («Список передаваемых товаров»). При этом один и тот же номер ВСД не должен повторяться для разных кодов товаров;
товарная группа должна совпадать со значением параметра «pg» («Товарная группа»), указанным в запросе;
код товара не принадлежит диапазону 0290 — 0299;
параметры «goodMarkFlag» («Признак готовности к маркировке») и «goodTurnFlag» («Признак готовности к обороту») равны «true».

Максимальное количество кодов товара в одном документе - 1 000

*product_name

string

Наименование товара

*cis_quantity

integer

Количество потребительских упаковок

Количество передаваемых КИ по данному коду товара. Формат: целое число не менее 1 и не более 1 000 000

*group_quantity

integer

Количество групповых упаковок

Количество передаваемых КИГУ по данному коду товара. Формат: целое число не менее 1 и не более 1 000 000

*vsd_number

string

Идентификатор ВСД

Номер первого транспортного ВСД по данному коду товара.

Требования, предъявляемые к идентификатору ВСД:

пара значений параметров «gtin» («Код товара») и «vsd_number» («Идентификатор ВСД») должна быть уникальна внутри массива «products» («Список передаваемых товаров»). При этом один и тот же номер ВСД не должен повторяться для разных кодов товаров;
длина значения: от 36 до 39 символов включительно. Формат:

[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12};
[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}

*cost

decimal

Цена за единицу

Цена указывается в копейках с учётом НДС (если сделка облагается НДС). Значение не может быть отрицательным, должно быть строго больше «tax» («Сумма НДС»), длина числового значения от 0 до 17 цифр включительно. Диапазон значений: от 0 до 99999999999999999 включительно.

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

*tax

decimal

Сумма НДС

Сумма НДС указывается в копейках. Значение не может быть отрицательным, должно быть строго меньше «cost» («Цена за единицу»), длина числового значения от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение «0».

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

*certificate_document_data

array of objects

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

Данные могут быть указаны либо внутри массива «certificate_document_data» («Массив, содержащий данные документов, подтверждающих соответствие») в параметрах «certificate_type» («Вид документа, подтверждающего соответствие»), «certificate_number» («Номер документа, подтверждающего соответствие»), «certificate_date» («Дата документа, подтверждающего соответствие»), либо внутри массива «products» («Список передаваемых товаров») в параметрах «certificate_type» («Вид документа, подтверждающего соответствие»), «certificate_number» («Номер документа, подтверждающего соответствие»), «certificate_date» («Дата документа, подтверждающего соответствие»). Одновременное заполнение внутри и вне массива «certificate_document_data» («Массив, содержащий данные документов, подтверждающих соответствие») не допускается. Одновременно должны быть заполнены все три параметра массива, либо все три не заполнены

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string

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

Допустимые форматы:

dd.MM.yyyy;
yyyy-MM-dd

Указание времени в значении допускается, но игнорируется при обработке. Диапазон: начиная с 2000-01-01 по текущую дату. Если в параметре «certificate_type» («Вид документа разрешительной документации») указано значение «STATE_REGISTRATION_CERTIFICATE» («Свидетельство о государственной регистрации»), то диапазон: начиная с 1900-01-01 по текущую дату

*certificate_type

string

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

Параметр обязательный, если указано значение параметра «certificate_number» («Номер документа, подтверждающего соответствие») и / или «certificate_date» («Дата документа, подтверждающего соответствие»). См. «Справочник «Виды разрешительной документации»»

*certificate_number

string

Номер документа, подтверждающего соответствие

Параметр обязательный, если указано значение параметра «certificate_type» («Вид документа, подтверждающего соответствие») и/или «certificate_date» («Дата документа, подтверждающего соответствие»). Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

*certificate_date

string

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

Параметр обязательный, если указано значение параметра «certificate_type» («Вид документа, подтверждающего соответствие») и/или «certificate_number» («Номер документа, подтверждающего соответствие»). Допустимые форматы:

dd.MM.yyyy;
yyyy-MM-dd

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

Номер первичного документа,Дата первичного документа,ИНН участника оборота заявителя,ИНН (или аналог) получателя в стране ЕАЭС,Наименование получателя в стране ЕАЭС,Код страны экспорта,Дата отгрузки,Глобальный номер места нахождения получателя (GLN),Версия
111111111,20.05.2020,1111111111,100000000,ООО Получатель в Республике Беларусь,112,20.05.2020,1231111111111,2
Параметры товаров,,,,,,,,
Код товара,Количество потребительских упаковок,Количество групповых упаковок,Идентификатор ВСД,Стоимость товаров,Сумма НДС,Вид документа подтверждающего соответствие,Номер документа подтверждающего соответствие,Дата документа подтверждающего соответствие
11111111111111,10000000,,1111-1111-1111-1111-1111-1111-1111-1111,50000,0,,,
22222222222222,10000000,100,,200000,200,,,
33333333333333,10000000,100,,50000,0,Свидетельство о государственной регистрации,111111,20.05.2020

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

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

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

Тип

Описание

LP_CANCEL_SHIPMENT

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

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товара

Отправитель документа должен быть собственником кодов

shipment_number

string

Номер документа на отгрузку

4.1.7. Приёмка

4.1.7.1. Приёмка отгрузки по России

Создание документа доступно для товарной группы «Товары из натурального меха».

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

Тип

Описание

LP_ACCEPT_GOODS

Приёмка. JSON (MANUAL)

LP_ACCEPT_GOODS_XML

Приёмка. XML

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

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

Параметры документа в формате * .json:

Параметр

Тип

Обяз.

Описание

Комментарий

release_order_number

string

Номер документа отгрузки

document_number

string

Номер первичного документа

document_date

string (date-time)

Дата первичного документа

Формат: yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z. Диапазон: текущая дата минус 5 календарных лет ← дата ← текущая дата

accept_all

boolean

Принять всё

Если значение true, то параметр «products» («Массив, содержащий список передаваемых КИ / КиЗ») может быть незаполнен: принимаются все коды, перечисленные в документе отгрузки.

Если параметр «reject_all» («Отклонить всё») и «accept_all» («Принять всё») = false, то анализируется параметр «accepted» («Признак того, что товар принят или не принят») для каждого КИ в документе «Приёмка».

Параметр не может быть заполнен одновременно с параметром «reject_all» («Отклонить всё»)

reject_all

boolean

Отклонить всё

Если значение true, то параметр «products» («Массив, содержащий список передаваемых КИ / КиЗ») может быть незаполнен: отклоняются все коды, перечисленные в документе отгрузки.

Параметр не может быть заполнен одновременно с параметром «accept_all» («Принять всё»)

transfer_date

string (date-time)

Дата и время отгрузки

Формат: yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z. Диапазон: текущая дата минус 5 календарных лет ← дата ← следующий день. Значение параметра должно соответствовать значению параметра «transfer_date» («Дата и время отгрузки») в документе отгрузки

acceptance_date

string (date-time)

Дата и время приёмки товара

Формат: yyyy-MM-ddTHH:mm:ss.SSS’ZTHH:mm:ss.SSS’Z. Диапазон: текущая дата минус 5 календарных лет ← дата ← текущая дата

trade_sender_inn

string

ИНН отправителя

trade_recipient_inn

string

ИНН получателя

turnover_type

string

Код типа отгрузки

Возможные значения:

SELLING – продажа;
COMMISSION – комиссия;
AGENT – агент

Значение параметра должно совпадать со значением параметра «turnover_type» («Код типа отгрузки») в документе отгрузки

products

array

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

Список КИ/КиЗ в документе «Приёмка» должен полностью соответствовать списку в документе отгрузки

*children

array

Массив, содержащий список дочерних КИ

Рекурсивный элемент, содержащий те же параметры, что и массив «products» («Массив, содержащий список передаваемых КИ / КиЗ»)

*uit_code

string

Передаваемый КИ / КиЗ

Параметр обязательный для товарной группы «Товары из натурального меха»

*uitu_code

string

Передаваемый КИТУ

Параметр не применим для товарной группы «Товары из натурального меха».

Для других товарных групп: параметр обязательный, если не указан «uit_code» («Передаваемый КИ / КиЗ»)

*product_cost

decimal

Цена за единицу

Цена указывается в копейках с учётом НДС (если сделка облагается НДС). Значение не может быть отрицательным, должно быть строго больше «product_tax» («Сумма НДС»), длина числового значения от 0 до 17 цифр включительно. Диапазон значений: от 0 до 99999999999999999 включительно.

Если «accepted» («Признак того, что товар принят или не принят») равно «true», то допускается отсутствие параметра, наличие параметра без значения, наличие параметра и его значения. Если «accepted» («Признак того, что товар принят или не принят») равно «false», то параметр строго не указан

*product_tax

decimal

Сумма НДС

Сумма НДС указывается в копейках. Значение не может быть отрицательным, должно быть строго меньше «product_cost» («Цена за единицу»), длина числового значения от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение «0».

*accepted

boolean

Признак того, что товар принят или не принят

«true» - товара принят, «false» - товар не принят. Параметры «accept_all» («Принять всё») и «reject_all» («Отклонить всё») не могут быть заполнены одновременно

Параметр «cis» («Передаваемый КИ / КиЗ») возвращается в ответе, если отсутствуют параметры «uit_code» («Передаваемый КИ / КиЗ») и «uitu_code» («Передаваемый КИТУ») в теле передаваемого документа в формате * .json.

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

<?xml version="1.0" encoding="UTF-8"?>
<acceptance action_id="11" version="6">
    <shipment_id>57250cce-52cf-408b-99ef-39cc239f60fd</shipment_id>
    <trade_participant_inn_sender>0000000000</trade_participant_inn_sender>
    <trade_participant_inn_receiver>0000000000</trade_participant_inn_receiver>
    <shipment_date>2019-11-18T21:00:00.000Z</shipment_date>
    <reception_date>2019-11-18T21:00:00.000Z</reception_date>
    <transfer_date>12.04.2019</transfer_date>
    <move_document_number>784378438</move_document_number>
    <move_document_date>12.04.2019</move_document_date>
    <turnover_type>SELLING</turnover_type>
    <products_list>
        <!--1 or more repetitions:-->
        <product>
            <ki>0000000000000000FFFFFFFFFFFFFFFFF</ki>
            <accept_type>true</accept_type>
        </product>
    </products_list>
</acceptance>

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

4.1.7.2. Приёмка отгрузки из ЕАЭС

Приёмка из ЕАЭС на документ «Отгрузка из ЕАЭС с признанием КИ» (EAS_CROSSBORDER):

Создание документа доступно для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Моторные масла», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Упакованная вода», «Шины и покрышки пневматические резиновые новые».

В связанном документе «Отгрузка из ЕАЭС с признанием КИ» могут быть переданы как коды, эмитированные в Республике Беларусь, Республике Казахстан или Республике Армения, так и коды, эмитированные в РФ и ранее экспортированные в Республику Беларусь, в Республику Казахстан или в Республику Армения (реимпорт товаров в РФ).

Коды, передаваемые в рамках реимпорта товаров в РФ, находятся в ГИС МТ в статусе «RETIRED» («Выбыл») с причиной выбытия «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»), в документе отгрузки проверка собственника для таких кодов в ГИС МТ не осуществляется. После приёмки такие коды меняют статус с «RETIRED» («Выбыл») (особое состояние «WAIT_SHIPMENT» («Ожидает приёмку товара»)) на «INTRODUCED» («В обороте»). Непринятые коды остаются в ГИС МТ в статусе «RETIRED» («Выбыл») без особого состояния.

Коды, эмитированные в государствах-членах ЕАЭС, при указании в документе отгрузки находятся в статусах «EMITTED» («Эмитирован») или «APPLIED» («Нанесён»), особое состояние «WAIT_SHIPMENT» («Ожидает приёмку товара») в Национальных информационных системах маркировки и прослеживаемости товаров государств-членов ЕАЭС. Принятые коды, сохраняются в ГИС МТ в статусе «INTRODUCED» («В обороте») без особого состояния. Непринятые коды в ГИС МТ не хранятся.

Для товарных групп «Консервированная продукция», «Корма для животных», «Морепродукты», «Моторные масла», «Обувные товары», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Упакованная вода», «Шины и покрышки пневматические резиновые новые» во избежание ошибок перед подачей документа необходимо убедиться, что для КИ, в том числе для вложенных в агрегат, указан действующий разрешительный документ.

Приёмка из ЕАЭС на документ «Отгрузка из ЕАЭС» (LP_SHIP_GOODS_CROSSBORDER):

Создание документа доступно для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция» (трансграничная торговля), «Морепродукты», «Моторные масла», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Во избежание ошибок перед подачей документа необходимо убедиться:

для КИ, в том числе вложенных в агрегат, указан действующий разрешительный документ — для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Обувные товары», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые»;
суммарный вес / объём продукции, указанной в документе (включая продукцию, вложенную в агрегат), не превышает вес / объём, указанный в ВСД, более чем на:
- 2 % — для товарной группы «Морепродукты»;
- 5 % — для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция».
Для продукции с переменным весом, в случае превышения допустимого отклонения, укажите в документе вес, соответствующий данным в ВСД.
в наличии действующей лицензии с наименованием «Оптовая торговля лекарственными средствами для ветеринарного применения» в реестре Россельхознадзора — для товарной группы «Ветеринарные препараты».

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

Тип

Описание

LP_ACCEPT_GOODS

Приёмка из ЕАЭС. JSON (MANUAL)

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

{
   "release_order_number":"a0000a00-aa0a-0a00-0aa0-000aaa0aa000",
   "trade_sender_inn":"000000000",
   "trade_sender_name":"string",
   "trade_recipient_inn":"7777777777",
   "trade_recipient_name":"ООО Завод",
   "exporter_taxpayer_id":"1111111111",
   "exporter_name":"XXX",
   "document_number":"111222333",
   "document_date":"2021-01-14T00:00:00.000Z",
   "transfer_date":"2021-01-14T00:00:00.000Z",
   "acceptance_date":"2021-01-14T00:00:00.000Z",
   "request_type":"ACCEPTANCE",
   "release_method":"CROSSBORDER",
   "products":[
      {
         "uit_code":"000000000000000000qSyEMozA3oJjP0000000",
         "accepted":"true",
         "tnved_code":"0000000000",
         "product_cost":2000050,
         "product_tax":0,
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/20",
               "certificate_date":"2020-06-07"
            },
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-03-03"
            }
         ]
      },
      {
         "uitu_code":"123456789012345678",
         "accepted":"true"
      },
      {
         "uitu_code":"123456789012345678",
         "accepted":"true",
         "children":[
            {
               "uit_code":"000000000000000000qSyEMozA3oJjP0000000",
               "accepted":"true",
               "tnved_code":"2222 22 222 2",
               "product_cost":2000050,
               "product_tax":0,
               "certificate_type":"CONFORMITY_DECLARATION",
               "certificate_number":"RU Д-ХХ.АА00.B.00001/20",
               "certificate_date":"2020-10-14T00:00:00.000Z"
            },
            {
               "uitu_code":"123456789012345678",
               "accepted":"true"
            },
            {
               "uit_code":"000000000000000011qSyEMozA3oJjP0000000",
               "accepted":"false"
            }
         ]
      },
      {
         "uit_code":"000000000000000011qSyEMozA3oJjP0000000",
         "accepted":"false"
      }
   ]
}

Пример тела документа в формате * .json для товарной группы «Молочная продукция»:

{
   "release_order_number":"f0000b00-fd0b-0a00-0bc0-000cfe0fe000",
   "trade_sender_inn":"000000000",
   "trade_sender_name":"string",
   "trade_recipient_inn":"1111111111",
   "trade_recipient_name":"string",
   "exporter_taxpayer_id":"7777777777",
   "exporter_name":"Белобувьэкспорт",
   "document_number":"784378438",
   "document_date":"2021-01-14T00:00:00.000Z",
   "transfer_date":"2021-01-14T00:00:00.000Z",
   "acceptance_date":"2021-01-14T00:00:00.000Z",
   "request_type":"ACCEPTANCE",
   "release_method":"CROSSBORDER",
   "products":[
      {
         "uit_code":"000000000000000000boNq0FMHTFJJ/",
         "accepted":"true",
         "tnved_code":"0000000000",
         "vsd_number":"0DDA-0D00-FAEA-00DD-B00D-0DCC-AC00-0000",
         "product_cost":2000050,
         "product_tax":0,
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_DECLARATION",
               "certificate_number":"RU Д-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-08-07"
            },
            {
               "certificate_type":"STATE_REGISTRATION_CERTIFICATE",
               "certificate_number":"RU.01.ЯЯ.00.001.Е.000001.07.21",
               "certificate_date":"2021-07-07"
            }
         ]
      },
      {
         "uitu_code":"123456789012345678",
         "accepted":"true",
         "vsd_number":"0DDA-0D50-FAEA-00DD-B00D-0DCC-AC00-0000"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

release_order_number

string

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

Указывается GUID документа «Отгрузка из ЕАЭС с признанием КИ» (EAS_CROSSBORDER) или «Отгрузка из ЕАЭС» (LP_SHIP_GOODS_CROSSBORDER).

Допустимые статусы «WAIT_ACCEPTANCE» («Ожидает приёмку») или «WAIT_PARTICIPANT_REGISTRATION» («Ожидает регистрации участника в ГИС МТ»)

trade_sender_inn

string

Идентификатор Оператора ЕАЭС

Значение параметра соответствует значению «sender_inn» («ИНН отправителя или его аналог в государстве-члене ЕАЭС») в связанном документе отгрузки

trade_sender_name

string

Наименование Оператора ЕАЭС

Длина значения: от 1 до 255 символов включительно

trade_recipient_inn

string

ИНН получателя в РФ

Значение параметра соответствует значению «receiver_inn» («ИНН получателя») в связанном документе отгрузки

trade_recipient_name

string

Наименование получателя

Длина значения: от 1 до 255 символов включительно

exporter_taxpayer_id

string

Идентификатор экспортёра в ЕАЭС

Значение параметра соответствует значению «exporter_taxpayer_id» («Уникальный идентификатор экспортёра в национальной системе учёта налогоплательщиков») в связанном документе отгрузки

exporter_name

string

Наименование экспортёра в ЕАЭС

Длина значения: от 1 до 255 символов включительно

document_number

string

Номер первичного документа

Длина значения: от 1 до 255 символов включительно

document_date

string (date)

Дата первичного документа

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Диапазон: текущая дата минус 5 календарных лет ← дата ← следующий день

transfer_date

string

Дата и время отгрузки

Значение соответствует значению «transfer_date» («Дата и время отгрузки») в связанном документе отгрузки

acceptance_date

string

Дата и время приёмки товара

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Диапазон: текущая дата минус 5 календарных лет ← дата ← текущая дата

request_type

string

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

Возможное значение: «ACCEPTANCE» («Приёмка»)

release_method

string

Код способа ввода товара в оборот

Возможное значение: «CROSSBORDER» («Ввод в оборот. Трансграничная торговля»)

reject_all

boolean

Отклонить всё

Если значение true, то массив «products» может быть не заполнен: отклоняются все коды, перечисленные в связанном документе отгрузки, значения в «products» игнорируются.

Если значение false, то анализируется параметр «accepted» для каждого кода в документе.

Если «pg» («Товарная группы») = «milk» («Молочная продукция»), то данный параметр при обработке документа игнорируется

products

array of objects

Массив, содержащий список передаваемых кодов

Массив может быть пустым, если «reject_all» = true. Указываются коды, перечисленные в связанном документе отгрузки. Требования к кодам:

уникальны в документе;
в карточке товара в НКМТ «goodTurnFlag» («Признак готовности товара к обороту») и «goodMarkFlag» («Признак готовности к маркировке») = true;
статус «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»), особое состояние «WAIT_SHIPMENT» («Ожидает приёмку товара») — для всех кодов, кроме КИТУ;
статус не равен «DISAGGREGATION» («Расформирован») — для КИТУ

*uit_code

string

КИ / КИК

Указывается код с типом упаковки:

«UNIT» («Единица товара»);
«BUNDLE» («Комплект») — только при реимпорте из Республики Беларусь в режиме взаимного признания кодов

*uitu_code

string

КИГУ / КИТУ

Обязательный, если не указан «uit_code». Указывается код с типом упаковки:

«BOX» («КИТУ») — для товарной группы «Упакованная вода» при импорте из Республики Армения в режиме взаимного признания кодов может содержать не более 5 уровней вложенности;
«GROUP» («КИГУ») — только для товарной группы «Упакованная вода» при импорте из Республики Армения в режиме взаимного признания кодов.

Максимальное количество вложенных кодов в КИГУ / КИТУ — 10 000

*accepted

boolean

Признак того, что товар принят или не принят

Обязательный, если «reject_all» = false или отсутствует. Возможные значения:

true — товар принят;
false — товар не принят

*tnved_code

string

Код ТН ВЭД ЕАЭС (10 знаков)

Обязательный, если «accepted» = true, иначе — строго не заполнен. Указывается только для КИ / КИК.

Для товарных групп «Молочная продукция», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Специализированная пищевая продукция и БАД к пище» и «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки» доступно указание как устаревших (действительных до 31.01.2022), так и новых кодов ТН ВЭД ЕАЭС (действительных с 01.01.2022)

*vsd_number

string

Идентификатор ВСД

Номер первого транспортного ВСД.
Обязательный, если в карточке товара в НКМТ «veterinaryControl» («Подлежит ветеринарному контролю (надзору)») = true, а если «veterinaryControl» = false — строго отсутствует. Для товарных групп без признака «veterinaryControl» игнорируется при обработке.

*product_cost

integer

Цена

Может отсутствовать.

Цена указывается в копейках с учётом НДС (если сделка облагается НДС).

Значение не может быть отрицательным, должно быть строго больше «product_tax».

Длина значения: от 0 до 17 цифр включительно. Диапазон: от 0 до 99999999999999999 включительно

*product_tax

integer

Сумма НДС

Может отсутствовать, если «accepted» = true или «reject_all» = true.

Строго не указан, если «accepted» = false.

Сумма НДС указывается в копейках: от 0 до 17 цифр включительно.

Если сделка не облагается НДС, то указывается значение «0»

*expiration_date

string

Дата истечения срока годности

Обязательный для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Ветеринарные препараты», «Консервированная продукция», «Корма для животных», «Молочная продукция» (при импорте в режиме взаимного признания кодов), «Морепродукты», «Моторные масла», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Упакованная вода», если «accepted» = true.

При этом необязательный для КИТУ товарной группы «Упакованная вода» при импорте из Республики Армения в режиме взаимного признания кодов.

Для товарной группы «Косметика, бытовая химия и товары личной гигиены» обязательный, если «accepted» = true и в карточке товара в НКМТ «serviceLifeCharacteristic» («Характеристика срока использования товара») не заполнен или = «Срок годности».

Для товарных групп «Игры и игрушки для детей», «Медицинские изделия» обязательный, если «accepted» = true и в карточке товара в НКМТ «serviceLifeCharacteristic» («Характеристика срока использования товара») = «Срок годности».

Для товарной группы «Молочная продукция» значение должно строго соответствовать значению «expiration_date» из документа «Отгрузка из ЕАЭС с признанием КИ».

Для товарной группы «Строительные материалы» обязательный для всех товаров, кроме тех, для которых в карточке товара в НКМТ заполнен «warrantyPeriod» («Гарантийный срок»).

Для других товарных групп игнорируется при обработке.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке. Диапазон: не менее текущей даты минус 5 лет и не более 31.12.2099.

Если дата истечения срока годности указывается для кода, вложенного в КИГУ / КИН, и эта дата является минимальной среди всех вложений данного КИГУ / КИН, то дата истечения срока годности для КИГУ / КИН автоматически изменится на дату, указанную в этом параметре

*production_date

string

Дата производства

Обязательный для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция» (при импорте в режиме взаимного признания кодов), «Морепродукты», «Моторные масла», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», если «accepted» = true.

Для товарной группы «Молочная продукция» значение должно строго соответствовать значению «production_date» из документа «Отгрузка из ЕАЭС с признанием КИ».

Может быть заполнен для товарной группы «Упакованная вода».

Для других товарных групп игнорируется при обработке.

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

*variable_expiration

array of objects

Информация о вариативном сроке годности

Может быть заполнен для товарной группы «Растительные масла»

**id

string

Идентификатор условий хранения

Обязательный, если указан параметр «date»

**date

string

Дата истечения срока годности для идентификатора условий хранения

Обязательный, если указан параметр «id».

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке

*production_guid

string

Идентификатор производственной площадки в формате GUID

Обязательный, если в карточке товара в НКМТ признак производства товара из подконтрольного сырья («rawMaterialVetControl») = «ДА»

*excisable

boolean

Признак подакцизного товара

Обязательный для товарных групп «Моторные масла» и «Соковая продукция и безалкогольные напитки» только для КИ, если «accepted» = true. Для других товарных групп строго не заполнен.

Возможные значения:

true — является подакцизным товаром;
false — не является подакцизным товаром

*excise

integer

Сумма акциза

Обязательный для товарных групп «Моторные масла» и «Соковая продукция и безалкогольные напитки» только для КИ, если «excisable» = true. Для других товарных групп строго не заполнен.

Указывается в копейках.

Длина значения: от 1 до 17 символов. Диапазон: от 1 до 99999999999999999

*batch_number

string

Номер серии товара

Обязательный для товарной группы «Ветеринарные препараты». Для товарной группы «Медицинские изделия» обязательный, если не указаны «part_number» («Номер партии товара») и «factory_serial_number» («Заводской серийный номер»). Для остальных товарных групп — необязательный.

Для товарной группы «Ветеринарные препараты» значение не более 30 символов, для товарной группы «Медицинские изделия» не более 49 символов с учётом пробелов: цифры, буквы (латиница, кириллица), спецсимволы (/ . , -).

Если для КИ ранее не был указан номер серии товара, то для данного КИ сохранится номер из документа, а если указан — будет перезаписан

*part_number

string

Номер партии товара

Обязательный для товарной группы «Медицинские изделия» при приёмке на документ «Отгрузка из ЕАЭС» (LP_SHIP_GOODS_CROSSBORDER), если не указаны «batch_number» («Номер серии товара») и «factory_serial_number» («Заводской серийный номер»). Значение не более 49 символов с учётом пробелов: цифры, буквы (латиница, кириллица), спецсимволы (/ . , -).

Если для КИ ранее не был указан номер партии товара, то для данного КИ сохранится номер из документа, а если указан — будет перезаписан.

Может быть заполнен для товарной группы «Молочная продукция» значением, строго соответствующим значению «part_number» из документа «Отгрузка из ЕАЭС с признанием КИ» (EAS_CROSSBORDER). Формат: от 21 до 32 символов включительно с учётом пробелов. Допустимые символы: цифры, буквы латинского алфавита, спецсимволы (/ . , -).

Для остальных товарных групп — необязательный

*factory_serial_number

string

Заводской серийный номер

Обязательный для товарной группы «Медицинские изделия», если не указаны «batch_number» («Номер серии товара») и «part_number» («Номер партии товара»). Значение не более 30 символов с учётом пробелов: цифры, буквы (латиница, кириллица), спецсимволы (/ . , -).

Если для КИ ранее не был указан заводской серийный номер товара, то для данного КИ сохранится номер из документа, а если указан — будет перезаписан.

Для остальных товарных групп — необязательный

*product_weight

integer

Переменный вес продукта (в граммах)

Обязательный для товарных групп «Корма для животных», «Молочная продукция» (при импорте в режиме взаимного признания кодов) и «Морепродукты», если в карточке товара в НКМТ «isVarQuantity» («Товар с переменным количеством») = true. Для остальных товарных групп — необязательный. Для товаров без переменного количества параметр должен строго отсутствовать.

Для товарной группы «Молочная продукция» значение должно строго соответствовать значению «product_weight» из документа «Отгрузка из ЕАЭС с признанием КИ».

Целое число в диапазоне: от 1 до 999999 включительно.

Если для КИ ранее не был указан переменный вес, то для данного КИ сохранится вес из документа, а если указан — будет перезаписан

*import_data

object

Данные импорта

**importer_id

string

ИНН (или аналог) импортёра

Обязательный, если заполнен параметр «import_data», иначе — строго не заполнен.

Длина значения: от 1 до 50 символов включительно

**importer_name

string

Наименование импортёра

Обязательный, если заполнен параметр «import_data», иначе — строго не заполнен.

Длина значения: от 1 до 255 символов включительно

**declaration_number

string

Регистрационный номер декларации на товары

Обязательный, если заполнен параметр «import_data», иначе — строго не заполнен.

Три группы, разделённые символом «/», где первая группа может содержать 2, 5 либо 8 символов, вторая — 6 (дата декларации на товары), третья — 7. Пример: 88888888/010422/7777777. Вторая группа цифр в регистрационном номере должна совпадать со значением в параметре «declaration_date», и соответствовать формату: ddMMyy

**declaration_date

string

Дата декларации на товары

Обязательный, если заполнен параметр «import_data», иначе — строго не заполнен. Соответствует значению параметра «declaration_number». Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке. Диапазон даты: с 01.01.2000 по дату создания документа

*production_data

object

Данные производства

**producer_id

string

ИНН (или аналог) производителя

Обязательный, если заполнен параметр «production_data», иначе — строго не заполнен.

Длина значения: от 1 до 50 символов включительно

**producer_name

string

Наименование производителя

Обязательный, если заполнен параметр «production_data», иначе — строго не заполнен.

Длина значения: от 1 до 255 символов включительно

*certificate_document_data

array of objects

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

Сведения могут быть указаны либо внутри массива «certificate_document_data» в параметрах «certificate_type», «certificate_number», «certificate_date», либо вне массива в одноимённых параметрах. Одновременное указание внутри и вне массива «certificate_document_data» не допускается. Одновременно должны быть заполнены все три параметра, либо все три не заполнены.

Строго не заполнен, если «accepted» = false. Сведения о разрешительном документе не могут быть указаны на уровне агрегата товарной группы «Косметика, бытовая химия и товары личной гигиены».

Обязательный для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия» (кроме кодов ТН ВЭД ЕАЭС: 9021101000, 9021399000, 9021909009), «Молочная продукция» (при приёмке отгрузки с признанием КИ), «Морепродукты», «Моторные масла», «Обувные товары», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые»,

если в Системе маркировки для кодов не указаны сведения о разрешительном документе и для таких кодов в карточке товара в НКМТ не заполнен «reasonCertMissingDetails» («Требования подтверждения соответствия отсутствуют; основание»).

Исключение, если одновременно код маркировки эмитирован в РФ и импортёр не является эмитентом кода маркировки.

В остальных случаях параметры необязательные.

**certificate_type

string

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

См. в разделе «Справочник «Виды разрешительной документации»».

Для товарной группы «Медицинские изделия» необходимо указывать вид разрешительного документа «Регистрационное удостоверение» (REGISTRATION_CERTIFICATE)

**certificate_number

string

Номер документа, подтверждающего соответствие

Формат: значение должно соответствовать регулярному выражению

**certificate_date

string

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

Указание времени допускается, но игнорируется при обработке документа.

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Диапазон:

для «STATE_REGISTRATION_CERTIFICATE» — начиная с 1900-01-01 по текущую дату;
для остальных видов разрешительной документации — начиная с 2000-01-01 по текущую дату

*certificate_type

string

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

*certificate_number

string(1-255)

Номер документа, подтверждающего соответствие

*certificate_date

string

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

*alco_content

decimal

Фактическое содержание этилового спирта

Обязательный для товарной группы «Косметика, бытовая химия и товары личной гигиены», для остальных товарных групп строго отсутствует. Формат:

число до 3 цифр в целой части и до 1 символа в дробной части (разделитель точка, дробная часть опциональна);
значение в диапазоне от 0 (0.0) до 100 (100.0) включительно.

Если спирт отсутствует, то указывается значение «0»

*children

array of objects

Массив, содержащий список вложенных кодов

Рекурсивный элемент, содержащий те же параметры, что и массив «products».

Обязательный для товарной группы «Упакованная вода» при импорте КИГУ / КИТУ из Республики Армения в режиме взаимного признания кодов. Должны быть указаны все вложения агрегата. Частичная приёмка вложений недоступна: агрегат можно принять только целиком со всеми его вложениями или полностью отклонить (включая все вложения)

4.1.7.3. Приёмка из ЕАЭС (ОСУ)

Создание документа доступно для товарной группы «Молочная продукция». Подача сведений в документе осуществляется между импортёром из Российской Федерации и экспортёром из Республики Беларусь по объёмно-сортовым показателям: в документе указывается количество принимаемых товаров и их коды товаров.

Приёмка из ЕАЭС (ОСУ) — это набор данных в документе, сформированном для документа «Отгрузка из ЕАЭС (ОСУ)» («EAS_GTIN_CROSSBORDER_IMPORT»). В значении параметра «release_order_number» («Номер документа отгрузки») указывается ID типа документа «Отгрузка из ЕАЭС (ОСУ)» («EAS_GTIN_CROSSBORDER_IMPORT»).

Во избежание ошибок перед подачей документа необходимо убедиться, что суммарный вес или объём товаров не превышает значение в ВСД, более чем на 5 %. Для продукции с переменным весом, в случае превышения допустимого отклонения, укажите в документе вес, соответствующий данным в ВСД.

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

Тип

Описание

EAS_GTIN_CROSSBORDER_ACCEPTANCE

Приёмка из ЕАЭС (ОСУ). JSON (MANUAL)

EAS_GTIN_CROSSBORDER_ACCEPTANCE_CSV

Приёмка из ЕАЭС (ОСУ). CSV

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

{
   "release_order_number":"UEGCI00000000000000000000-0000",
   "trade_sender_inn":"100083608",
   "trade_sender_name":"Наименование Оператора ЕАЭС",
   "trade_recipient_inn":"5555555555",
   "trade_recipient_name":"Наименование получателя в РФ",
   "exporter_taxpayer_id":"3333333333",
   "exporter_name":"Наименование Экспортёра в ЕАЭС",
   "document_number":"123456",
   "document_date":"2021-10-10T00:00:00.000Z",
   "transfer_date":"2021-10-10T00:00:00.000Z",
   "acceptance_date":"2021-10-10T00:00:00.000Z",
   "products":[
      {
         "gtin":"04611111111111",
         "cis_quantity":50,
         "tnved_code":"2202999900",
         "vsd_number":"0DDA-0D50-FAEA-00DD-B00D-0DCC-AC00-1111",
         "product_cost":2000050,
         "product_tax":250
      },
      {
         "gtin":"04622222222222",
         "cis_quantity":5,
         "tnved_code":"2202999900",
         "vsd_number":"0DDA-0D50-FAEA-00DD-B00D-0DCC-AC00-2222",
         "product_cost":2050,
         "product_tax":20,
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-10-10"
            },
            {
               "certificate_type":"STATE_REGISTRATION_CERTIFICATE",
               "certificate_number":"RU.01.ЯЯ.00.001.Е.000001.10.21",
               "certificate_date":"2021-10-10"
            }
         ]
      },
      {
         "gtin":"04633333333333",
         "cis_quantity":100,
         "tnved_code":"4583999900",
         "product_cost":704000,
         "product_tax":0,
         "weight": 1000
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

release_order_number

string

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

Указывается ID документа с типом «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT) в статусе «WAIT_ACCEPTANCE» («Ожидает приёмку») или «WAIT_PARTICIPANT_REGISTRATION» («Ожидает регистрации участника в ГИС МТ»). Длина значения: от 1 до 255 символов включительно

trade_sender_inn

string

Идентификатор Оператора ЕАЭС

Длина значения: 8/9/10/12/14 символов. Значение параметра соответствует значению «sender_inn» («ИНН отправителя») в документе «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT)

trade_sender_name

string

Наименование Оператора ЕАЭС

Длина значения: от 1 до 255 символов включительно

trade_recipient_inn

string

ИНН получателя в РФ

Получателем является участник оборота товаров в РФ. Значение параметра соответствует значению «receiver_inn» («ИНН получателя в РФ») в документе «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT)

trade_recipient_name

string

Наименование получателя в РФ

Длина значения: от 1 до 255 символов включительно

exporter_taxpayer_id

string

Идентификатор экспортёра в ЕАЭС

Длина значения: 8/9/10/12/14 символов. Значение соответствует значению «exporter_taxpayer_id» («ИНН экспортёра в ЕАЭС») в документе «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT)

exporter_name

string

Наименование экспортёра в ЕАЭС

Длина значения: от 1 до 255 символов включительно

document_number

string

Номер первичного документа

Длина значения: от 1 до 255 символов включительно

document_date

string(date)

Дата первичного документа

Диапазон: не более текущей даты и не менее текущей даты минус 5 лет. Допустимые форматы:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

transfer_date

string (date-time)

Дата отгрузки

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон: текущая дата минус 5 календарных лет ← дата ← текущая дата. Значение соответствует значению «transfer_date» («Дата и время отгрузки») в документе «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT)

acceptance_date

string (date-time)

Дата и время приёмки товара

Допустимые форматы:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

reject_all

boolean

Отклонить всё

Если значение «true», то параметр «products» («Массив передаваемых кодов товаров») может быть не заполнен: отклоняются все коды, перечисленные в документе отгрузки, значения в параметре «products» («Массив передаваемых кодов товаров») игнорируются.

Если значение «false», то анализируется параметр «accepted» («Признак того, что товар принят или не принят») для каждого КИ / кода товара в документе «Приёмка»

products

array of objects

Массив передаваемых кодов товаров

Значения массива игнорируются, если значение параметра «reject_all» («Признак отказа от приёмки товара») = «true». В массиве должен быть указан хотя бы один код товара и данные о нём

*gtin

string

Код товара

Код товара соответствует указанному в документе «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT), карточка которого получена на единицу товара в НКМТ (указание кодов товаров, полученных на другие типы упаковки, недоступно). Длина значения: 14 цифр. Максимальное количество кодов товаров в одном документе — 1 000.

Пара значений параметров «gtin» («Код товара») и «vsd_number» («Идентификатор ВСД») должна быть уникальна внутри массива «products» («Массив передаваемых кодов товаров»). При этом один и тот же номер ВСД не должен повторяться для разных кодов товаров

*cis_quantity

integer

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

Указывается при приёмке товара по документу. Формат: целое число не менее 0 и не более значения, указанного в документе «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT), для данного «gtin» («Код товара»). Значение «0» указывается в случае, если товар не принят

*group_quantity

integer

Количество передаваемых КИГУ по данному коду товара

Обязателен, если не указан «cis_quantity» («Количество передаваемых КИ по данному коду товара»). Формат: целое число не менее 0 и не более значения, указанного в документе «Отгрузка из ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_IMPORT), для данного «gtin» («Код товара»). Значение «0» указывается в случае, если товар не принят

*tnved_code

string

Код ТН ВЭД ЕАЭС (10 знаков)

Доступно указание как устаревших (действительных до 31.01.2022), так и новых кодов ТН ВЭД ЕАЭС (действительных с 01.01.2022)

*vsd_number

string

Идентификатор ВСД

Номер первого транспортного ВСД. Указывается только для товарной группы «Молочная продукция».

Первый транспортный ВСД формируется производителем молочной продукции для её дальнейшей реализации.

Формат: минимальное значение — 36 символов, максимальное — 39 символов;
не содержит пробелы;
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}; [A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}.

*product_cost

decimal

Цена за единицу с учётом НДС

Параметр является обязательным, если значение параметра «reject_all» («Отклонить всё») равно «false» или отсутствует. Цена с учётом НДС единицы товара (с нанесенным КИ) указывается в валюте Оператора принимающего сведения (если сделка облагается НДС) только для единиц товаров и не применима для агрегатов. Значение не может быть отрицательным, должно быть строго больше «product_tax» («Сумма НДС»), длина числового значения от 0 до 17 цифр включительно. Диапазон значений: от 0 до 99999999999999999 включительно

*product_tax

decimal

Сумма НДС

Параметр является обязательным, если значение параметра «reject_all» («Отклонить всё») равно «false» или отсутствует. Сумма НДС указывается в копейках только для единиц товаров. Значение не может быть отрицательным, строго меньше «product_cost» («Цена за единицу с учётом НДС»), длина числового значения от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение «0»

*weight

integer

Совокупный вес продукции

Параметр должен быть заполнен для товара с признаком переменного веса (в карточке товара в НКМТ в атрибуте «Товар с переменным количеством» указано значение «Да»). В остальных случаях параметр строго не заполнен.

Указывается общий вес всей позиции в граммах — только целое число в диапазоне от 1 до 999999999

*certificate_document_data

array

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

Данные строго не указаны, если «gtin» («Код товара») не принят, то есть соответствующие значения «cis_quantity» («Количество передаваемых КИ по данному коду товара») или «group_quantity» («Количество передаваемых КИГУ по данному коду товара») равны «0». Одновременно должны быть заполнены все три параметра массива, либо все три не заполнены

**certificate_type

string

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

Указывается только для единиц товаров. См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

Указывается только для единиц товаров. Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string

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

Указывается только для единиц товаров. Формат: 2020-01-14T00:00:00.000Z. Диапазон: начиная с 2000-01-01 по текущую дату. Если в параметре «certificate_type» («Вид документа разрешительной документации») указано значение «STATE_REGISTRATION_CERTIFICATE» («Свидетельство о государственной регистрации»), то диапазон: начиная с 1900-01-01 по текущую дату

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

Номер документа отгрузки,Идентификатор Оператора ЕАЭС,Наименование Оператора ЕАЭС,ИНН получателя в РФ,Наименование получателя в РФ,Идентификатор экспортера в ЕАЭС,Наименование экспортера в ЕАЭС,Номер первичного документа,Дата первичного документа,Дата отгрузки,Дата приемки,Отклонить все,Версия
UEGCI00000000000000000000-0000,777777777,ППО РУП "Оператор",5555555555,ООО "Получатель",333333333,РУП "Экспортёр",123,10.10.2021,10.10.2021,10.10.2021,,2
Параметры товаров
GTIN,Количество КИ,Количество КИГУ,Код ТН ВЭД ЕАЭС товара,ВСД,Стоимость товаров,Сумма НДС,"Вид документа, подтверждающего соответствие","Номер документа, подтверждающего соответствие","Дата документа, подтверждающего соответствие",Совокупный вес продукции
04611111111111,50,,4011100003,,1000,0,Декларация о соответствии,123,10.10.2021,1000
04622222222222,30,20,4011800000,,5000,0,Декларация о соответствии,123,10.10.2021,

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

Создание документа доступно для товарных групп «Автозапчасти и комплектующие транспортных средств», «Алкоголь», «Альтернативная табачная продукция», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Никотиносодержащая продукция», «Обувные товары», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Табачная продукция», «Титановая металлопродукция», «Товары из натурального меха», «Товары для дома и интерьера», «Удобрения в потребительской упаковке», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

Для товарных групп «Автозапчасти и комплектующие транспортных средств», «Алкоголь», «Альтернативная табачная продукция», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Ветеринарные препараты», «Игры и игрушки для детей», «Кабельно-проводниковая продукция», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Морепродукты», «Моторные масла», «Мясные изделия», «Натуральный мех», «Никотиносодержащая продукция», «Оптоволокно и оптоволоконная продукция», «Отопительные приборы», «Печатная продукция», «Пиротехника и огнетушащее оборудование», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Табачная продукция», «Титановая металлопродукция», «Товары для дома и интерьера», «Удобрения в потребительской упаковке» подача документа доступна только в формате * .json.

Для товарных групп, для которых не наступила прослеживаемость товаров, по всем причинам вывода доступна подача сведений о выводе КИ из оборота не только собственнику товара по данным Системы маркировки, т. е. ИНН участника оборота товаров в документе может не совпадать с собственником КИ по данным Системы маркировки. Возможно подать сведения о выводе КИ / КИГУ /КИН / КИТУ, не принадлежащих отправителю документа. Сравнение ИНН отправителя документа и собственника КИ по данным Системы маркировки не осуществляется. При успешной обработке документа КИ / КИГУ / КИН / КИТУ останутся на балансе собственника по данным Системы маркировки и изменят статус на «RETIRED» («Выбыл») с указанием выбранной причины вывода.

Для товарной группы «Ветеринарные препараты» перед выводом из оборота по причинам «RETAIL» («Розничная продажа»), «DISTANCE» («Дистанционная продажа»), «VENDING» («Продажа через вендинговый аппарат») или «BY_SAMPLES» («Продажа по образцам») необходимо убедиться в наличии действующей лицензии на розничную продажу в реестре Россельхознадзора. При её отсутствии информация будет передана уполномоченным государственным органам для проведения контрольных (надзорных) мероприятий.

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»:

Подача вывода из оборота по причинам «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС») и «BEYOND_EEC_EXPORT» («Экспорт за пределы стран ЕАЭС») возможна только для кодов с дополнительным состоянием «MOVING_BY_UD» («Отгружен»).

Для присвоения этого дополнительного состояния перед выводом из оборота необходимо подать документ «Уведомление о состоянии кодов» (CIS_NOTICE) с указанием состояния «SHIPPED_ABROAD» («Запланирована отгрузка на экспорт»).

Если состояние «MOVING_BY_UD» («Отгружен») не будет присвоено или будет присвоено с помощью документа «УПД (отгрузка продукции)» (FIXATION), то документ вывода из оборота обработается с ошибкой.

Особенности вывода из оборота мультитоварных наборов:

товарные группы всех кодов, указываемых непосредственно в документе, должны совпадать. Товарные группы их вложений могут отличаться;
причина выбытия (включая все ограничения для причины «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»)) должна быть доступна для всех товарных групп указанных кодов. В противном случае вывод мультитоварного набора из оборота будет невозможен — потребуется расформировать набор и вывести из оборота каждое вложение отдельно;
вывод из оборота набора, который содержит в себе вложения с более строгими ограничениями, может обрабатываться с ошибкой. Потребуется расформировать набор для вывода из оборота вложений. Для предотвращения ошибок при формировании мультитоварного набора в качестве товарной группы набора рекомендуется указывать ту, для которой действует более строгий набор ограничений.

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

Тип

Описание

LK_RECEIPT

Вывод из оборота. JSON (MANUAL)

LK_RECEIPT_CSV

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

LK_RECEIPT_XML

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

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

{
   "inn":"1111111111",
   "action":"OTHER",
   "action_date":"2024-01-01",
   "withdrawal_type_other":"string",
   "document_type":"OTHER",
   "document_number":"22222",
   "document_date":"2024-01-01",
   "primary_document_custom_name":"string",
   "products":[
      {
         "cis":"010468888888888821lBEtVuGyhA0HO"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

inn

string

ИНН участника оборота товаров

buyer_inn

string

ИНН покупателя

Обязательный, если «action» («Причина выбытия») = «DONATION» («Безвозмездная передача»). Необязательный, если «action» («Причина выбытия») = «OWN_USE» («Использование для собственных нужд») или «PRODUCTION_USE» («Использование для производственных целей»). Не указывается при ином значении параметра «action» («Причина выбытия»)

action

string

Причина выбытия

Возможные значения см. в разделе «Справочник «Причины выбытия»».

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»:

при указании значения «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС») или «BEYOND_EEC_EXPORT» («Экспорт за пределы стран ЕАЭС») проверяется лицензия на соответствие требованиям;
при поставке товаров на территории Донецкой Народной Республики, Луганской Народной Республики, Запорожской области и Херсонской области указывается значение «OTHER» («Другое»)

action_date

string

Дата вывода из оборота

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке. Диапазон: не более текущей даты и не менее текущей даты минус 5 лет

withdrawal_type_other

string

Описание причины

Обязательный при «action» («Причина выбытия») = «OTHER» («Другое»). Длина значения — от 1 до 1024 символов включительно. В случае указания иных причин данный параметр строго не заполнен.

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция» и «Табачная продукция»: при поставке товаров на территории Донецкой Народной Республики, Луганской Народной Республики, Запорожской области и Херсонской области указать значение:

«Отгрузка в ДНР»;
«Отгрузка в ЛНР»;
«Отгрузка в Херсонскую обл.»;
«Отгрузка в Запорожскую обл.»

state_contract_id

string

Идентификатор государственного контракта

Обязательный, если «action» («Причина выбытия») равно «STATE_SECRET» («Продажа по сделке с государственной тайной») и «STATE_CONTRACT» («Продажа по государственному (муниципальному) контракту»). Для иных причин выбытия параметр строго не заполнен.

Если «action» = «STATE_SECRET», то длина идентификатора — 25 цифровых символов, 13-ый по счёту символ должен иметь значение «1», «2» или «3». В случае если длина идентификатора менее 25 цифр, то недостающие разряды (14-25) могут быть заполнены нулями.
Если «action» = «STATE_CONTRACT», то длина идентификатора от 1 до 255 символов включительно. Допустимые символы: цифры, буквы, спецсимволы (% & ' " ( ) * + , - _ . / : ; < = > ? !)

document_type

string

Тип первичного документа

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

«document_number» («Номер первичного документа»),
«document_date» («Дата первичного документа»).

Обязательный, если в массиве «products» («Массив, содержащий список КИ / КиЗ») не заполнен параметр «primary_document_type» («Тип первичного документа») при «action» («Причина выбытия»):

«BEYOND_EEC_EXPORT» («Экспорт за пределы стран ЕАЭС»);
«CONFISCATION» («Конфискация»);
«DESTRUCTION» («Уничтожение»);
«DONATION» («Безвозмездная передача»);
«EXPIRATION» («Истечение срока годности»);
«LOSS» («Утрата»);
«MEDICAL_USE» («Использование для медицинского применения»);
«MISMATCH» («Пересортица по кодам идентификации»);
«OTHER» («Другое»);
«OWN_USE» («Использование для собственных нужд»);
«PRODUCTION_USE» («Использование для производственных целей»);
«RECALL» («Отзыв с рынка»);

«RETURN» («Возврат физическому лицу»);
«UTILIZATION» («Утилизация»);
«VETERINARY_USE» («Использование для ветеринарного применения»).

Параметр строго заполнен при «action» («Причина выбытия») — «RETAIL» («Розничная продажа»).

Параметр опционален при «action» («Причина выбытия»):

«BY_SAMPLES» («Продажа по образцам»);
«DISTANCE» («Дистанционная продажа»);
«PACKING» («Фасовка»);
«VENDING» («Продажа через вендинговый аппарат»).

Параметр строго не заполнен при «action» («Причина выбытия»):

«EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»);
«STATE_CONTRACT» («Продажа по государственному (муниципальному) контракту»);
«STATE_SECRET» («Продажа по сделке с государственной тайной»).

Возможные значения:

«CONSIGNMENT_NOTE» — «Товарная накладная»;
«CUSTOMS_DECLARATION» — «Таможенная декларация»;
«DESTRUCTION_ACT» — «Акт уничтожения (утраты/утилизации)»;
«DIGITAL_CERTIFICATE» — «Электронный сертификат» (указание доступно только в формате * .json);
«ORTHOPEDIC_PRODUCT_ACT» — «Акт протезно-ортопедического изделия» (указание доступно только в формате * .json);
«OTHER» — «Прочее»;
«RECEIPT» — «Кассовый чек»;
«SALES_RECEIPT» — «Товарный чек»;
«UTD» — «Универсальный передаточный документ».

Тип первичного документа зависит от значения параметра «action» («Причина выбытия»):

«BEYOND_EEC_EXPORT» = «CUSTOMS_DECLARATION», «OTHER»;
«BY_SAMPLES», «DISTANCE» = «RECEIPT», «SALES_RECEIPT», «OTHER», «CONSIGNMENT_NOTE», «UTD»;
«CONFISCATION» = «OTHER», «CONSIGNMENT_NOTE», «UTD»;
«DESTRUCTION» = «DESTRUCTION_ACT», «OTHER»;
«DONATION» = «CONSIGNMENT_NOTE», «OTHER»;
«PRODUCTION_USE» = «DIGITAL_CERTIFICATE», «ORTHOPEDIC_PRODUCT_ACT», «OTHER»;
«RETAIL» = «RECEIPT», «SALES_RECEIPT», «OTHER»;
«VENDING», «OWN_USE», «RETURN», «LOSS», «UTILIZATION», «RECALL», «PACKING», «EXPIRATION», «OTHER», «MEDICAL_USE», «MISMATCH», «VETERINARY_USE» = «OTHER»

document_number

string(1-255)

Номер первичного документа

Обязательный, если заполнен «document_type» («Тип первичного документа»)

document_date

string

Дата первичного документа

Обязательный, если заполнен «document_type» («Тип первичного документа»).

Формат:
dd.MM.yyyy;
yyyy-MM-dd

primary_document_custom_name

string

Наименование первичного документа

Обязательный, если значение «document_type» («Тип первичного документа») = «OTHER» («Прочее»). Строго не заполнен, если значение «action» («Причина выбытия») = «STATE_CONTRACT» («Продажа по государственному (муниципальному) контракту») / «STATE_SECRET» («Продажа по сделке с государственной тайной») / «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»). В остальных случаях параметр является необязательным

destination_country_code

string

Код страны назначения

Параметр обязательный, если значение «action» («Причина вывода из оборота») = «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»). В случае указания иных причин вывода из оборота данный параметр строго не заполнен. Возможные значения:

112 — Республика Беларусь (кроме товарных групп «Обувные товары», «Шины и покрышки пневматические резиновые новые»);
417 — Кыргызская Республика;
398 — Республика Казахстан (кроме товарной группы «Обувные товары»);
051 — Республика Армения

importer_id

string

ИНН (или аналог) импортёра

ИНН участника оборота товаров ЕАЭС. Параметр опционален при «action» («Причина выбытия») = «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»). В случае указания иных причин вывода товара из оборота данный параметр строго не заполнен. Формат:

051 — Армения [0-9]{8};
112 — Беларусь [0-9]{9} (кроме товарных групп «Обувные товары», «Шины и покрышки пневматические резиновые новые»);
398 — Казахстан [0-9]{12};
417 — Киргизия [0-9]{14}

kpp

string

КПП участника оборота

Только для юридических лиц.

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

«EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»);
«BEYOND_EEC_EXPORT» («Экспорт за пределы стран ЕАЭС»).

Для товарных групп «Алкоголь» и «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» параметр обязательный при всех значениях «action» («Причина выбытия»), кроме «STATE_CONTRACT» («Продажа по государственному (муниципальному) контракту»). По указанному КПП (в сочетании с «fias_id», если он также передан) осуществляется поиск уникального действующего МОД среди зарегистрированных МОД участника оборота товаров, сформировавшего документ.

При отсутствии параметра или соответствующего МОД документ будет обработан с ошибкой о ненайденном МОД.

В остальных случаях параметр необязательный.

Если заполнено для товарных групп «Алкоголь» и «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» при «action» = «STATE_CONTRACT», а также для товарных групп «Ветеринарные препараты», «Духи и туалетная вода», «Обувные товары», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые», по указанному КПП (в сочетании с «fias_id», если он также передан) осуществляется поиск уникального действующего МОД среди зарегистрированных МОД участника оборота товаров, сформировавшего документ. При отсутствии соответствующего МОД документ будет обработан с ошибкой.

Формат: 9 цифр

fias_id

string

Идентификатор ФИАС

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция» параметр:

обязательный при значении «action» («Причина выбытия»):
«RETAIL» («Розничная продажа»);
«DESTRUCTION» («Уничтожение»);
«CONFISCATION» («Конфискация»);
«OTHER» («Другое»);
«UTILIZATION» («Утилизация»);
«RECALL» («Отзыв с рынка»);
«LOSS» («Утрата»).
обязательный для индивидуальных предпринимателей при значении «action» («Причина выбытия»):
«EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»);
«BEYOND_EEC_EXPORT» («Экспорт за пределы стран ЕАЭС»).

Для товарных групп «Алкоголь» и «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» при всех значениях «action» («Причина выбытия»), кроме «STATE_CONTRACT» («Продажа по государственному (муниципальному) контракту»), параметр:

обязательный для индивидуальных предпринимателей;
может быть указан для юридических лиц, если идентификатор ФИАС существует среди зарегистрированных МОД участника оборота товаров, сформировавшего документ.

По указанному идентификатору ФИАС (в сочетании с «kpp», если он также передан) осуществляется поиск уникального действующего МОД среди зарегистрированных МОД участника оборота товаров, сформировавшего документ.

При отсутствии параметра или соответствующего МОД документ будет обработан с ошибкой о ненайденном МОД.

В остальных случаях параметр необязательный.

Если заполнено для товарных групп «Алкоголь» и «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» при «action» = «STATE_CONTRACT», а также для товарных групп «Ветеринарные препараты», «Духи и туалетная вода», «Обувные товары», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые», по указанному идентификатору ФИАС (в сочетании с «kpp», если он также передан) осуществляется поиск уникального действующего МОД среди зарегистрированных МОД участника оборота товаров, сформировавшего документ. При отсутствии соответствующего МОД документ будет обработан с ошибкой.

Формат: UUID [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

products

array of objects

Массив, содержащий список КИ / КиЗ

Все КИ / КиЗ, указанные в массиве, должны принадлежать одной товарной группе. При подаче сведений должна быть заполнена хотя бы одна запись в массиве

*cis

string

КИ / КиЗ

Допустимые типы упаковок:

UNIT — «Единица товара»;
GROUP — «КИГУ»;
BOX — «КИТУ»;
BUNDLE — «КИК»;
SET — «КИН».

Требования, предъявляемые к КИ / КиЗ:

товарная группа совпадает со значением параметра «pg» («Товарная группа»), указанном в запросе;
при «pg» («Товарная группа») = «milk» («Молочная продукция») могут быть указаны КИ / КИГУ / КИН, эмитированные в Республике Беларусь;
статус кода «INTRODUCED» («В обороте»), особое состояние:

если наступила прослеживаемость товаров — отсутствует или = «CONNECT_TAP» («Подключён к оборудованию для розлива») / «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику»);
если не наступила прослеживаемость товаров — отсутствует или отличное от «MOVING_BY_UD» («Отгружен»).

После успешной обработки документа:

КИ / КиЗ, эмитированные в РФ, меняют статус на «Выбыл»;
КИ / КИГУ / КИН, эмитированные в Республике Беларусь, не меняют статус;
КИТУ меняют статус на «Расформирован», вложенные коды, эмитированные в РФ, выводятся из оборота и меняют статус на «Выбыл» и «Расформирован»;

если указанные в документе КИ / КИГУ / КИН / КИТУ, эмитированные в РФ, входят в состав агрегата вышестоящего уровня, выполняется расформирование агрегата вышестоящего уровня;
КИГУ / КИН, эмитированные в РФ, меняют статус на «Выбыл», вложенные КИ, эмитированные в РФ, меняют статус на «Выбыл», КИГУ / КИН остаётся в состоянии «Сформирован»;
если в документе указан КИ, по сведениям ГИС МТ находящийся в КИГУ / КИН, агрегат меняет статус на «Списан»

*product_cost

decimal

Цена за единицу

Указывается в копейках с учётом НДС (если сделка облагается НДС): длина числового значения от 0 до 17 цифр включительно. Диапазон значений: от 0 до 99999999999999999 включительно.

Обязательный при «action» («Причина выбытия»):
«RETAIL» («Розничная продажа»);
«BY_SAMPLES» («Продажа по образцам»);
«DISTANCE» («Дистанционная продажа»);
«VENDING» («Продажа через вендинговый аппарат»);
«PACKING» («Фасовка»).

Если указан ИНН покупателя («buyer_inn»), то параметр обязательный при «action»:
«DONATION» («Безвозмездная передача»);
«OWN_USE» («Использование для собственных нужд»);
«PRODUCTION_USE» («Использование для производственных целей»).

При остальных значениях «action» параметр строго не заполнен.

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

*partial_quantity

float

Количество частично выбывших единиц потребления

Может быть заполнен для товарных групп «Безалкогольное пиво», «Ветеринарные препараты» при выполнении условий:

документ в формате * .json;
«action» («Причина выбытия»):
«CONFISCATION» («Конфискация»);
«DESTRUCTION» («Уничтожение»);
«EXPIRATION» («Истечение срока годности»);
«LOSS» («Утрата»);
«OTHER» («Другое»);
«UTILIZATION» («Утилизация»);
«VETERINARY_USE» («Использование для ветеринарного применения») — только для товарной группы «Ветеринарные препараты».
тип упаковки «UNIT» — «Единица товара»;
в карточке товара в НКМТ заполнен «variableProperty» («Заявленный вес / объём / длина / количество») и / или «quantityInPack» («Количество единиц употребления в потребительской упаковке»).

При заполнении параметра для КИ, входящего в состав агрегата, агрегат автоматически расформировывается. Если параметр не заполнен, осуществляется полное выбытие товара.

В остальных случаях строго не заполнен. Формат:

число до 6 цифр в целой части и до 3 символов в дробной части (разделитель точка, дробная часть опциональна);
значение в диапазоне от 0.001 до 999999 включительно. При указании дробной части значение округляется до целого по арифметическому правилу округления (пример: 2.15 → 2; 2.6 → 3).

При реализации всех единиц из потребительской упаковки статус КИ сменится на «RETIRED» («Выбыл») с причиной выбытия, указанной в последнем поданном документе вывода из оборота

*primary_document_type

string

Тип первичного документа

Значение параметра имеет более высокий приоритет перед значением параметра «document_type» («Тип первичного документа»), указанного вне массива «products» («Массив, содержащий список КИ / КиЗ»).

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

«primary_document_number» («Номер первичного документа»),
«primary_document_date» («Дата первичного документа»).

Обязательный, если вне массива «products» («Массив, содержащий список КИ / КиЗ») не заполнен параметр «document_type» («Тип первичного документа») при «action» («Причина выбытия»):

Параметр строго заполнен при «action» («Причина выбытия») — «RETAIL» («Розничная продажа»).

Параметр опционален при «action» («Причина выбытия»):

Параметр строго не заполнен при «action» («Причина выбытия»):

Возможные значения:

Тип первичного документа зависит от значения параметра «action» («Причина выбытия»):

*primary_document_number

string(1-255)

Номер первичного документа

Обязательный, если заполнен «primary_document_type» («Тип первичного документа»)

*primary_document_date

string(date)

Дата первичного документа

Обязательный, если заполнен «primary_document_type» («Тип первичного документа»). Формат: 2020-01-14T00:00:00.000Z. Диапазон: текущая дата минус 5 календарных лет ← дата ← текущая дата

*primary_document_custom_name

string

Наименование первичного документа

Обязательный, если значение «primary_document_type» («Тип первичного документа») равно «OTHER» («Прочее»). Строго не заполнен, если значение «action» («Причина выбытия») = «STATE_CONTRACT» («Продажа по государственному (муниципальному) контракту») / «STATE_SECRET» («Продажа по сделке с государственной тайной») / «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»). В остальных случаях параметр является необязательным

Параметры «destination_country_code» («Код страны назначения») и «importer_id» («ИНН (или аналог) импортёра») являются уникальными для документа в формате * .json и неприменимы для документов в формате * .xml и * .csv.

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

ИНН участника оборота,ИНН покупателя,Причина вывода из оборота,Другая причина вывода из оборота,Дата вывода из оборота,Тип первичного документа,Номер первичного документа,Дата первичного документа,Наименование первичного документа,Идентификатор ФИАС,Идентификатор госконтракта,Версия
7777777777,,Другое,Описание другой причины,2024-01-01,Прочее,123,2024-01-01,Наименование первичного документа,,,7
Параметры товаров
КИ,Цена за единицу,Тип первичного документа,Номер первичного документа,Дата первичного документа,Наименование первичного документа
010464444444444421BEtVuGyhA0HO3,,,,,
010464444444444421BEtVuGyhA0HO4,,,,,

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

<?xml version="1.0" encoding="UTF-8"?>
<withdrawal version="8">
    <trade_participant_inn>7777777777</trade_participant_inn>
    <withdrawal_type>OTHER</withdrawal_type>
    <withdrawal_type_other>Описание другой причины</withdrawal_type_other>
    <withdrawal_date>2024-01-13</withdrawal_date>
    <primary_document_type>OTHER</primary_document_type>
    <primary_document_number>123</primary_document_number>
    <primary_document_date>2024-01-13</primary_document_date>
    <primary_document_custom_name>Наименование первичного документа</primary_document_custom_name>
    <products_list>
        <product>
            <cis>010464444444444421BEtVuGyhA0HO5</cis>
        </product>
    </products_list>
</withdrawal>

4.1.9. Отмена вывода из оборота

Создание документа доступно для всех товарных групп, которым доступен документ «Вывод из оборота» (LK_RECEIPT, LK_RECEIPT_CSV, LK_RECEIPT_XML), кроме товарных групп «Автозапчасти и комплектующие транспортных средств», «Полимерные трубы», «Сладости и кондитерские изделия».

Данный документ предназначен для аннулирования документа «Вывод из оборота» (LK_RECEIPT, LK_RECEIPT_CSV, LK_RECEIPT_XML) в статусе «CHECKED_OK» («Обработан»).

Важно

Если для одного и того же кода идентификации передано несколько документов «Вывод из оборота» (LK_RECEIPT) с признаком частичного выбытия (заполнен «partial_quantity» («Количество частично выбывших единиц потребления»)), то аннулирование возможно только для последней зафиксированной операции выбытия

Для успешной обработки документа:

ИНН отправителя документа отмены должен совпадать с ИНН отправителя документа вывода;
аннулируемый документ вывода из оборота должен быть последним документом, повлиявшим на все коды маркировки из этого документа;
отправитель документа отмены должен быть собственником всех кодов из документа вывода (только для товарных групп, для которых наступила прослеживаемость товаров).

При успешной обработке документа:

документ вывода меняет статус на «CANCELED» («Отменён»);
коды возвращаются в исходный статус: КИТУ в статус «Сформирован», остальные типы кодов в статус «В обороте». При этом, если отмена вывода осуществляется по документу, в котором указаны КИГУ / КИН / КИТУ, то в исходный статус вернутся как КИГУ / КИН / КИТУ, так и все их вложения. Если же в документе вывода указаны только вложения, то КИГУ / КИН / КИТУ, в состав которых они входят, не изменят свой статус;
количество товара на балансе склада в Системе маркировки возвращается к исходному.

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

Тип

Описание

LK_RECEIPT_CANCEL

Отмена вывода из оборота. JSON (MANUAL)

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

{
   "inn":"7777777777",
   "lk_receipt_id":"11111cce-11cf-111b-11ef-11cc111f11f1"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

inn

string

ИНН участника оборота товаров

lk_receipt_id

string

Идентификатор отменяемого документа вывода

4.1.10. Вывод из оборота (ОСУ)

Создание документа доступно для товарных групп «Антисептики и дезинфицирующие средства», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Молочная продукция», «Морепродукты», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище».

Особенности вывода из оборота мультитоварных наборов:

товарные группы всех кодов, указываемых непосредственно в документе, должны совпадать. Товарные группы их вложений могут отличаться;
в документе могут быть указаны коды (включая вложения), для товарных групп которых доступна подача данного документа;
причина выбытия (включая все ограничения для причины «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»)) должна быть доступна для всех товарных групп указанных кодов. В противном случае вывод мультитоварного набора из оборота будет невозможен — потребуется расформировать набор и вывести из оборота каждое вложение отдельно.

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

Тип

Описание

LK_GTIN_RECEIPT

Вывод из оборота (ОСУ). JSON (MANUAL)

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

{
   "action":"DONATION",
   "inn":"1111111111",
   "buyer_inn":"7777777777",
   "action_date":"2022-08-05",
   "document_type":"CONSIGNMENT_NOTE",
   "document_number":"56783",
   "document_date":"2022-07-05",
   "products":[
      {
         "gtin":"04611111111111",
         "gtin_quantity":4,
         "product_cost":0.00
      },
      {
         "gtin":"04622222222222",
         "gtin_quantity":1,
         "product_cost":0.00
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

action

string

Причина выбытия

Возможные значения см. в разделе «Справочник «Причины выбытия»»

inn

string

ИНН участника оборота товаров

buyer_inn

string

ИНН покупателя

Обязательный, если «action» = «DONATION». Может быть указан, если «action» = «OWN_USE» / «PRODUCTION_USE», иначе — строго отсутствует

importer_id

string

ИНН (или аналог) импортёра

ИНН участника оборота товаров ЕАЭС. Может быть указан, если «action» = «EAS_TRADE», иначе — строго отсутствует.

Формат:

«051» — Армения [0-9]{8};
«112» — Беларусь [0-9]{9};
«398» — Казахстан [0-9]{12};
«417» — Киргизия [0-9]{14}

destination_country_code

string

Код страны назначения

Может быть указан, если «action» = «EAS_TRADE», иначе — строго отсутствует.

Возможные значения:

«051» — Республика Армения;
«112» — Республика Беларусь;
«398» — Республика Казахстан;
«417» — Кыргызская Республика

action_date

string

Дата вывода из оборота

Диапазон: не более текущей даты и не менее даты эмиссии и даты ввода в оборот. Формат: yyyy-MM-dd

withdrawal_type_other

string

Описание причины

Обязательный, если «action» = «OTHER», иначе — строго отсутствует.

Длина значения — от 1 до 255 символов включительно

state_contract_id

string

Идентификатор государственного контракта

Обязательный, если «action» = «STATE_CONTRACT» / «STATE_SECRET», иначе — строго отсутствует.

Если «action» = «STATE_CONTRACT», то длина значения — от 1 до 255 символов включительно. Допустимые символы: цифры, буквы, спецсимволы (% & ' " ( ) * + , - _ . / : ; < = > ? !).

Если «action» = «STATE_SECRET», то длина значения — 25 цифровых символов, 13-ый по счёту символ должен иметь значение «1», «2» или «3». В случае если длина значения менее 25 цифр, то недостающие разряды (14-25) могут быть заполнены нулями

document_type

string

Тип первичного документа

Строго отсутствует, если «action» = «EAS_TRADE» / «STATE_CONTRACT» / «STATE_SECRET», иначе — обязательный.

Если данный параметр указан, то «document_number» и «document_date» являются обязательными.

Возможные значения:

«CONSIGNMENT_NOTE» — «Товарная накладная»;
«CUSTOMS_DECLARATION» — «Таможенная декларация»;
«DESTRUCTION_ACT» — «Акт уничтожения (утраты/утилизации)»;
«OTHER» — «Прочее»;
«UTD» — «Универсальный передаточный документ».

Тип первичного документа зависит от значения «action»:

«BEYOND_EEC_EXPORT» = «CUSTOMS_DECLARATION», «OTHER»;
«CONFISCATION» = «OTHER», «CONSIGNMENT_NOTE», «UTD»;
«DESTRUCTION» = «DESTRUCTION_ACT», «OTHER»;
«DONATION» = «CONSIGNMENT_NOTE», «OTHER»;
«OWN_USE», «PRODUCTION_USE», «LOSS», «UTILIZATION», «EXPIRATION», «OTHER», «BALANCE_CORRECTION», «DAMAGE_LOSS» = «OTHER»

document_number

string

Номер первичного документа

Обязательный, если указан «document_type».

Длина значения — от 1 до 255 символов включительно

document_date

string

Дата первичного документа

Обязательный, если указан «document_type».

Диапазон: не более текущей даты и не менее текущей даты минус 5 лет. Формат:

dd.MM.yyyy;
yyyy-MM-dd

primary_document_custom_name

string

Наименование первичного документа

Обязательный, если «document_type» = «OTHER». Строго отсутствует, если «action» = «STATE_CONTRACT» / «STATE_SECRET» / «EAS_TRADE», иначе — может быть указан.

Длина значения — от 1 до 255 символов включительно

fias_id

string

Идентификатор ФИАС

Может быть заполнен, если «action» = «CONFISCATION» / «DESTRUCTION» / «EXPIRATION» / «LOSS» / «OTHER» / «BALANCE_CORRECTION» / «UTILIZATION», иначе — строго отсутствует.

Формат: UUID [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

products

array of objects

Массив, содержащий список товаров (GTIN)

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

*gtin

string

Код товара

Товарная группа кода товара должна совпадать со значением параметра «pg» («Товарная группа»), указанном в запросе.

Формат: 14 цифр

*gtin_quantity

integer

Количество единиц товара

Формат:

только цифры;
целое число;
от 1 до 17 знаков включительно;
значение в диапазоне от 1 до 99999999999999999 включительно

*product_cost

decimal

Общая стоимость с НДС

Обязательный, если указан «buyer_inn» и «action» = «DONATION» / «OWN_USE» / «PRODUCTION_USE», иначе — строго отсутствует.

Указывается в копейках с учётом НДС (если сделка облагается НДС): длина числового значения от 0 до 17 цифр включительно.

Диапазон: от 0 до 99999999999999999 включительно.

Если «action» = «DONATION» и «product_cost» заполнен, то значение должно быть «0.00»

*gtin_weight

integer

Вес в граммах

Общий вес в граммах по коду товара, указанному в параметре «gtin». Обязательный для товарной группы «Молочная продукция» при наличии признака переменного веса (в карточке товара в НКМТ в атрибуте «Товар с переменным количеством» указано значение «Да»).

Если товар имеет признак переменного веса, но параметр отсутствует — документ обработается с ошибкой.

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

Формат:

только цифры;
целое число без символа-разделителя. Если значение в миллиграммах, округлить до грамм (до целого числа);
от 1 до 9 знаков включительно;
значение в диапазоне от 1 до 999999999.

Для групповой упаковки признак переменного веса копируется из вложений, входящих в состав данной упаковки. При наличии признака переменного веса для групповой упаковки указывается вес, равный весу одного вложения.

На виртуальный склад передаются коды товаров вложений и вес, указанный в документе / в карточке товара (в зависимости от наличия признака переменного веса), умноженный на количество вложений.

Для набора анализируются вложенные в него товары:

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

На виртуальный склад передаётся вес, указанный в документе, для товара с переменным весом, и вес из карточки товара для вложений с постоянным весом;
при отсутствии признака переменного веса у товаров в наборе вес, указанный в документе, игнорируется.

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

*part_number

string

Номер партии

Заполняется только в рамках эксперимента по партионному учёту. Номер партии присваивается производителем / импортёром молочной продукции и не может быть изменён другими участниками оборота товаров.

Формат: от 1 до 49 символов включительно с учётом пробелов. Допустимые символы: цифры, буквы (латиница, кириллица), спецсимволы (/ . , -).

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

4.1.11. Отмена вывода из оборота (ОСУ)

Создание документа доступно для товарных групп, для которых доступен документ «Вывод из оборота (ОСУ)».

Документ предназначен для подачи сведений об аннулировании документа «Вывод из оборота (ОСУ)» (LK_GTIN_RECEIPT), обработанного успешно в ГИС МТ. При успешной обработке документа «Отмена вывода из оборота (ОСУ)» (LK_GTIN_RECEIPT_CANCEL) документ «Вывод из оборота (ОСУ)» меняет статус на «Отменён» (CANCELED), количество товара на балансе склада в ГИС МТ возвращается к исходному.

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

Тип

Описание

LK_GTIN_RECEIPT_CANCEL

Отмена вывода из оборота (ОСУ). JSON (MANUAL)

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

{
   "inn":"7777777777",
   "lk_gtin_receipt_id":"11111cce-11cf-111b-11ef-11cc111f11f1",
   "version":1
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

inn

string

ИНН участника оборота товаров

ИНН отправителя документа должен быть = ИНН отправителя документа «Вывод из оборота (ОСУ)» (LK_GTIN_RECEIPT)

lk_gtin_receipt_id

string

Идентификатор отменяемого документа «Вывод из оборота (ОСУ)» (LK_GTIN_RECEIPT)

Статус документа «Вывод из оборота (ОСУ)» (LK_GTIN_RECEIPT) должен быть = «CHECKED_OK» («Обработан»)

version

integer

Номер версии документа

Возможное значение: 1

4.1.12. Списание

Создание документа доступно только для товарной группы «Товары из натурального меха».

Применяется для КиЗ в статусе «APPLIED» («Нанесён»), когда участнику оборота товаров они не требуются и их необходимо списать в Системе маркировки.

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

Тип

Описание

LK_KM_CANCELLATION

Списание. JSON (MANUAL)

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

cancellation_doc_date

string date

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

Формат:

yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

cancellation_doc_number

string

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

От 1 до 255 символов включительно

cancellation_reason

string

Причина списания

Обязательный, если значение «cancellation_reason» («Причина списания») не указано в массиве «km_list» («Список данных о КиЗ»). Возможные значения:

«KM_SPOILED» — «Испорчен»;
«KM_LOST» — «Утерян»;
«KM_DESTROYED» — «Уничтожен»

km_list

array of objects

Список данных о КиЗ

Указана хотя бы одна запись в массиве

*cancellation_reason

string

Причина списания

Может быть не указан, если указан на уровне документа. Возможные значения:

«KM_SPOILED» — «Испорчен»;
«KM_LOST» — «Утерян»;
«KM_DESTROYED» — «Уничтожен»

*uit

string

Уникальный КиЗ

Указываемый код должен быть без особого состояния.

Допустимые типы упаковок:

«UNIT» — «Единица товара»

trade_participant_inn

string

ИНН участника оборота товара

4.1.13. Списание (общий документ)

Подача сведений доступна для всех товарных групп, кроме товарных групп «Бакалейная продукция», «Ветеринарные препараты», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Оптоволокно и оптоволоконная продукция», «Радиоэлектронная продукция», «Растительные масла», «Титановая металлопродукция», «Товары из натурального меха».

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция» и «Табачная продукция» при списании по причинам «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС») и «BEYOND_EEC_EXPORT» («Экспорт за пределы стран ЕАЭС») проверяется лицензия на соответствие требованиям. При отсутствии такой лицензии документ будет обработан с ошибкой и коды не будут списаны.

Особенности для мультитованых наборов:

списание набора, который содержит в себе вложения с более строгими ограничениями, может обрабатываться с ошибкой. Потребуется расформировать набор для списания вложений. Для предотвращения ошибок при формировании мультитоварного набора в качестве товарной группы набора рекомендуется указывать ту, для которой действует более строгий набор ограничений;
причина списания должна быть доступна для всех товарных групп указанных кодов;
товарные группы всех кодов, указываемых непосредственно в документе, должны совпадать. Товарные группы их вложений могут отличаться.

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

Тип

Описание

WRITE_OFF

Списание (общий документ). JSON (MANUAL)

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

{
   "participantId":"7777777777",
   "dropoutReason":"OWN_USE_EXCISE",
   "withChild":false,
   "sntins":[
      "010461111111111121NNNNNNNNNNNNN",
      "010461111111111121KKKKKKKKKKKKK",
      "010461111111111121LLLLLLLLLLLLL"
   ],
   "sourceDocType":"OTHER",
   "sourceDocDate":"2022-02-22",
   "sourceDocNum":"123",
   "sourceDocName":"other source document"
}

Параметры документа в формате * .json:

Параметр

Тип

Обяз.

Описание

Комментарий

participantId

string

ИНН участника оборота товаров

dropoutReason

string

Причина списания

Возможные значения см. в разделе «Справочник «Причины выбытия»».

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция» при указании значения «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС») или «BEYOND_EEC_EXPORT» («Экспорт за пределы стран ЕАЭС») проверяется лицензия на соответствие требованиям

destinationCountryCode

string

Код страны назначения

Обязательный, если «dropoutReason» = «EAS_TRADE». Возможные значения:

112 — Республика Беларусь;
417 — Кыргызская Республика;
398 — Республика Казахстан;
051 — Республика Армения

buyerId

string

ИНН (или аналог) в стране получателя

Обязательный, если «dropoutReason» = «EAS_TRADE»

fiasId

string

Идентификатор ФИАС

Обязательно заполнен при «dropoutReason» = «EAS_TRADE» или «BEYOND_EEC_EXPORT» для индивидуальных предпринимателей. В остальных случаях может отсутствовать для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция». Для остальных товарных групп, кроме «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» — необязательный

kpp

string

КПП участника оборота товаров

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция» параметр обязательный для юридических лиц при «dropoutReason» = «EAS_TRADE» или «BEYOND_EEC_EXPORT»

withChild

boolean

Признак списания всех вложенных элементов

Возможные значения:

«true» — списать агрегат вместе с вложенными кодами (по умолчанию); «false» (доступно только для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция» и «Табачная продукция») — списать только агрегат.

При «dropoutReason» = «EAS_TRADE» или «BEYOND_EEC_EXPORT» значение отсутствует или = «true»

sourceDocType

string

Тип первичного документа

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция» и «Табачная продукция» параметр обязательный только при «dropoutReason» = «EAS_TRADE» или «BEYOND_EEC_EXPORT».

Для остальных товарных групп параметр обязательный.

Возможные значения:

«DESTRUCTION_ACT» — «Акт уничтожения (утраты / утилизации)» (недоступно при «dropoutReason» = «EAS_TRADE» или «BEYOND_EEC_EXPORT»);
«CUSTOMS_DECLARATION» — «Таможенная декларация» (доступно только при «dropoutReason» = «EAS_TRADE» или «BEYOND_EEC_EXPORT»);
«OTHER» — «Прочее»

sourceDocNum

string

Номер первичного документа

Для остальных товарных групп параметр обязательный.

Длина значения — от 1 до 255 символов включительно

sourceDocDate

string date

Дата первичного документа

Формат: yyyy-MM-dd.

Диапазон допустимых значений: от даты создания документа (текущей даты) минус пять лет по дату создания документа плюс 30 дней

sourceDocName

string

Наименование первичного документа

Обязательный, если значение «sourceDocType» («Тип первичного документа») равно «OTHER» («Прочее»). В остальных случаях строго не заполнен. Длина значения — от 1 до 255 символов включительно

sntins

array[string]

Список КИ

Указываемый КИ должен быть без особого состояния или с особым состоянием «IN_GRAY_ZONE» («В Серой зоне») в статусе:

«EMITTED» («Эмитирован»);
«APPLIED» («Нанесён»);
«INTRODUCED» («В обороте»);
«APPLIED_NOT_PAID» («Не оплачен»).

После успешной обработки документа КИ меняют статус на «WRITTEN_OFF» («Списан») без особого состояния.

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция» при значении параметра «dropoutReason» = «EAS_TRADE» или «BEYOND_EEC_EXPORT» недопустимо указание АТК

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

1.Код 200 в случае успеха:

{
  "id": "string"
}

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

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

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

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

Идентификатор документа, прошедшего проверку

error_message

string

Текст сообщения об ошибке

Параметр возвращается при наличии ошибки

4.1.14. Отчёт о нанесении ФСМ

Создание отчёта доступно для товарной группы «Алкоголь».

Отчёт о нанесении ФСМ подаётся после фактического нанесения ФСМ на произведённую продукцию для смены статуса кода маркировки на «INTRODUCED» («В обороте»).

При обработке отчёта осуществляется проверка ИНН и КПП отправителя отчёта на отсутствие блокировки в ЕГАИС. Также осуществляется контроль уникальности места осуществления деятельности: на один и тот же ИНН и КПП в Системе маркировки может быть зарегистрировано только одно место осуществления деятельности.

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

Тип

Описание

ALCO_UTILISED

Отчёт о нанесении ФСМ. JSON (MANUAL)

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

{
   "participantInn":"7777777777",
   "participantKpp":"111111111",
   "gtin":"04688888888888",
   "productionDate":"1733821226",
   "expirationDate":"1734821226",
   "primaryDocumentNumber":"1111",
   "primaryDocumentDate":1733821226,
   "alcoholVolume":5.9,
   "emissionType":"LOCAL",
   "codes":[
"111111111111111111111NNNNN1NNNN1NN1NNNN11NNN1NNNENNN1NNN1NNNNNNNNNNNNNNN1N1NEN1ENN1NNNN1NNNNNNNNNNNNNNNNNE1NNNNNNN1NNNNNNE1N1NNNNNNNNNN1EN1NNNNNNNNNN="
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantInn

string

ИНН участника оборота товаров

Отправитель документа должен быть собственником кодов

participantKpp

string

КПП участника оборота товаров

Формат: 9 цифр

gtin

string

Код товара

Формат: 14 цифр. Требования к коду товара:

отправитель документа должен являться владельцем карточки товара в «Национальном каталоге маркированных товаров» или иметь доступ к ней по механизму настройки субаккаунтов;
значение параметров «goodMarkFlag» («Признак готовности к маркировке») и «goodTurnFlag» («Признак готовности к обороту») равно «true»;
статус карточки товара — «published» («Опубликована»)

productionDate

long

Дата производства продукции

Формат: Unix Timestamp (в секундах). Не более текущей даты плюс 1 день и не менее текущей даты минус 20 лет

expirationDate

long

Дата истечения срока годности продукции

Формат: Unix Timestamp (в секундах). Не более 31.12.2099 и не менее текущей даты минус 1 день

primaryDocumentNumber

string

Номер первичного учётного документа

Длина значения — от 1 до 255 символов включительно

primaryDocumentDate

long

Дата первичного учётного документа

Формат: Unix Timestamp (в секундах)

alcoholVolume

number

Объёмная доля этилового спирта, в процентах

Задаётся в формате десятичной дроби с одной цифрой после точки (0.0). Допустимый диапазон значений: от 0 (0.0) до 100 (100.0) включительно

emissionType

string

Тип эмиссии

Возможные значения:

«LOCAL» («Производство РФ»);
«FOREIGN» («Ввезён в РФ»)

codes

array of string

Список кодов маркировки (с крипточастью)

Должен быть указан хотя бы один код. Коды должны быть уникальными, со статусом «EMITTED» («Эмитирован») и без особого состояния

4.1.15. Уведомление о состоянии кодов

Создание документа доступно для всех товарных групп, кроме товарных групп «Автозапчасти и комплектующие транспортных средств», «Мясные изделия», «Натуральный мех», «Полуфабрикаты и замороженные продукты», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Сладости и кондитерские изделия», «Товары для дома и интерьера», «Товары из натурального меха», «Удобрения в потребительской упаковке».

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

Поддерживаются следующие операции:

установка состояния «LOST_INVENTORY» («Не найдены по итогу инвентаризации») для кодов, числящихся на балансе в Системе маркировки, но не обнаруженных при инвентаризации;
установка состояния «MOVING_BY_UD» («Отгружен») для кодов товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», планируемых для экспорта за пределы Российской Федерации;
снятие состояния «MOVING_BY_UD» («Отгружен») с кодов товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», которые планировались для экспорта за пределы Российской Федерации.

Примечание

Ниже в описании параметров документа используется термин «код» для обозначения кодов идентификации всех типов упаковок, допустимых для указания в документе: КИ, КИГУ, КИК, КИН, КИТУ. Для мультитоварных наборов товарные группы всех кодов, указываемых непосредственно в документе, должны совпадать. Товарные группы их вложений могут отличаться

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

Тип

Описание

CIS_NOTICE

Уведомление о состоянии кодов. JSON (MANUAL)

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

{
   "participantInn":"1111111111",
   "actionDate":"2024-10-01",
   "action":"LOST_INVENTORY",
   "codes":[
      {
         "code":"010464444444444421KkKKkk"
      },
      {
         "code":"010464444444444421TtTTtt"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantInn

string

ИНН участника оборота товара

Отправитель документа должен быть собственником кодов. Если «action» = «SHIPPED_ABROAD» или «CANCEL_SHIPPED_ABROAD», то ИНН должен состоять из 10 цифр (доступно только юридическим лицам)

actionDate

string

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

Диапазон: не более текущей даты плюс 100 лет и не менее текущей даты минус 5 лет.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке

action

string

Состояние кодов

Возможные значения: «LOST_INVENTORY» — не найдены по итогу инвентаризации;
«SHIPPED_ABROAD» — запланирована отгрузка на экспорт;
«CANCEL_SHIPPED_ABROAD» — отмена отгрузки на экспорт

kpp

string

КПП МОД

Обязательный, если «action» = «SHIPPED_ABROAD».

Формат: 9 цифр.

По указанному КПП должно быть зарегистрировано не более одного активного МОД, не заблокированного в ЕГАИС. При отсутствии такого МОД документ будет обработан с ошибкой

epdId

string

ID электронного перевозочного документа

Обязательный, если не заполнен «transportDetails» («Транспортные реквизиты») и «action» = «SHIPPED_ABROAD». Строго отсутствует, если заполнен «transportDetails».

Формат: UUID

transportDetails

object

Транспортные реквизиты

Обязательный, если не заполнен «epdId» («ID электронного перевозочного документа») и «action» = «SHIPPED_ABROAD». Строго отсутствует, если заполнен «epdId»

*documentNumber

string

Номер перевозочного документа

Обязательный, если указано значение «transportDetails» («Транспортные реквизиты»).

Длина значения — от 1 до 255 символов включительно

*documentDate

string

Дата перевозочного документа

Обязательный, если указано значение «transportDetails» («Транспортные реквизиты»).

Диапазон: не более текущей даты плюс 5 лет и не менее текущей даты минус 5 лет.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

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

*numberVehicle

string

Государственный регистрационный номер транспортного средства

Обязательный, если указано значение «transportDetails» («Транспортные реквизиты»).

Длина значения — от 1 до 255 символов включительно

shippingDate

string

Дата отгрузки

Обязательный, если «action» = «SHIPPED_ABROAD».

Диапазон: не более текущей даты плюс 5 лет и не менее текущей даты минус 5 лет.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

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

importerCountryCode

string

Код страны

Обязательный, если «action» = «SHIPPED_ABROAD». Код страны, на территорию которой планируется вывоз товаров. Числовой код (3 цифры) из справочника ОКСМ (например: 112 — Республика Беларусь)

recipientInn

string

ИНН получателя (или аналог)

Обязательный, если «action» = «SHIPPED_ABROAD». Длина значения — от 1 до 255 символов включительно

recipientName

string

Наименование получателя

Обязательный, если «action» = «SHIPPED_ABROAD». Длина значения — от 1 до 255 символов включительно

codes

array of objects

Список кодов

Должен быть указан хотя бы один код. Коды должны быть уникальными.

Максимальное количество кодов в одном документе — 30 000. Общее количество кодов, с учётом вложений — не более 2 000 000

*code

string

Код

Требования к кодам:

статус — «INTRODUCED» («В обороте»), в том числе у кодов, вложенных в агрегат;
дополнительное состояние:
- отсутствует или отличное от «LOST_INVENTORY» («Не найдены по итогу инвентаризации») и «MOVING_BY_UD» («Отгружен»), если «action» = «LOST_INVENTORY»;
- отсутствует, если «action» = «SHIPPED_ABROAD»;
- «MOVING_BY_UD» («Отгружен»), если «action» = «CANCEL_SHIPPED_ABROAD».
не вложены в агрегат. Чтобы установить или снять дополнительное состояние с кодов, вложенных в агрегат, предварительно агрегат нужно расформировать, либо указать код агрегата в документе, в таком случае дополнительное состояние будет установлено или снято со всех его вложений

4.1.16. Отчёт о перевзвешивании

Создание документа доступно для товарной группы «Молочная продукция».

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

Тип

Описание

REPORT_REWEIGHING

Отчёт о перевзвешивании. JSON (MANUAL)

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

{
  "participantInn": "7777777777",
  "codes": [
    {
      "code": "0000000000000010010000000",
      "productWeight": 1111
    },
    {
      "code": "1111111111111111111111111",
      "productWeight": 22222
    },
    {
      "code": "2222222222222222222222222",
      "productWeight": 22222
    }
  ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantInn

string

ИНН участника оборота товаров

codes

array of object

Массив КИ

Должен быть указан хотя бы один КИ

*code

string

КИ, для которого указан уточнённый вес

Указываемый КИ должен быть в статусе «INTRODUCED» («В обороте») без особого состояния

*productWeight

integer

Уточнённый вес с точностью до грамма

Формат:

от 1 до 6 цифр (без разделителей);
значение должно быть больше 1 грамма и не может быть больше значения веса, указанного изначально. Максимальное значение — 999999

4.1.17. Корректировка сведений о кодах

Примечание

В описании данного типа документа для обозначения КИ, КиЗ и КИК используется термин «код»

Создание документа доступно для товарных групп «Автозапчасти и комплектующие транспортных средств», «Альтернативная табачная продукция», «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Натуральный мех», «Никотиносодержащая продукция», «Обувные товары», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Табачная продукция», «Товары из натурального меха», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

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

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

Во избежание ошибок перед подачей документа необходимо убедиться, что суммарный вес / объём продукции, указанной в документе (включая продукцию, вложенную в агрегат), не превышает вес / объём, указанный в ВСД, более чем на:

2 % — для товарной группы «Морепродукты»;
5 % — для товарных групп «Консервированная продукция», «Корма для животных» и «Молочная продукция».

Виды сведений и доступность их изменения
Вид корректируемых сведений	Доступность по товарным группам	Участник оборота товаров, которому доступно внесение изменений
«vsd» («Идентификатор ВСД»)	Доступно для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты»	Участник оборота товаров, который осуществил нанесение кода или ввод в оборот
«productionDate» («Дата производства»)	Для всех товарных групп	Участник оборота товаров, который осуществил нанесение кода или ввод в оборот
«expirationDate» («Дата истечения срока годности»)	Доступно для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Безалкогольное пиво», «Ветеринарные препараты», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция», «Морепродукты», «Моторные масла», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода»	Участник оборота товаров, который осуществил нанесение кода
«variableExpiration» («Информация о вариативном сроке годности»	Доступно для товарной группы «Молочная продукция»	Участник оборота товаров, который осуществил нанесение кода
«weight» («Фактический вес товара в граммах»)	Доступно для товарных групп «Молочная продукция», «Морепродукты»	Участник оборота товаров, который осуществил нанесение кода
«tnved» («Код ТН ВЭД ЕАЭС (10 цифр)»)	Недоступно для товарных групп «Альтернативная табачная продукция», «Безалкогольное пиво», «Никотиносодержащая продукция», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Табачная продукция»	Участник оборота товаров, который осуществил нанесение кода или ввод в оборот
«permitDocsOperation» («Операция, применяемая для всех сведений о разрешительной документации») «permitDocs» («Сведения о разрешительной документации»)	Недоступно для товарных групп «Ветеринарные препараты», «Специализированная пищевая продукция и БАД к пище»	Участник оборота товаров, который осуществил нанесение кода или ввод в оборот
«licences» («Массив лицензий на пользование недрами»)	Доступно для товарной группы «Упакованная вода»	Участник оборота товаров, который осуществил нанесение кода или ввод в оборот
«emissionType» («Тип эмиссии»)	Недоступно для товарных групп «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки», «Товары из натурального меха»	Участник оборота товаров, который осуществил эмиссию кода
«partNumber» («Номер партии»)	Доступно для товарной группы «Молочная продукция»	Участник оборота товаров, который осуществил нанесение кода

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

Тип

Описание

CIS_INFORMATION_CHANGE

Корректировка сведений о кодах. JSON (MANUAL)

Пример тела документа для товарной группы «Молочная продукция»:

{
   "participantInn":"string",
   "codes":[
      {
         "code":[
            "010463333333333321KnKNn4",
            "010463333333333321Kn5KNk"
         ],
         "vsd":"string",
         "productionDate":"string",
         "variableExpiration":{
            "2":1682121600000,
            "4":1679443200000
         },
         "tnved":"string",
         "weight":"string",
         "permitDocsOperation":0,
         "permitDocs":[
            {
               "permitDocNumber":"string",
               "permitDocDate":"01.01.2023",
               "permitDocType":2
            }
         ],
         "emissionType":2
      }
   ]
}

Пример тела документа для товарной группы «Упакованная вода»:

{
   "participantInn":"string",
   "codes":[
      {
         "code":[
            "010463333333333321KnKNn4KnKNn4v",
            "010463333333333321Kn5KNkKn5KNkV"
         ],
         "productionDate":"string",
         "expirationDate":"string",
         "tnved":"string",
         "permitDocsOperation":0,
         "permitDocs":[
            {
               "permitDocNumber":"string",
               "permitDocDate":"01.01.2023",
               "permitDocType":2
            }
         ],
         "emissionType":2,
         "licencesOperation":1,
         "licences":[
            {
               "licence_number":"string",
               "licence_date":"01.06.2023"
            }
         ]
      }
   ]
}

Пример тела документа для других товарных групп:

{
   "participantInn":"string",
   "codes":[
      {
         "code":[
            "010463333333333321KnKNn4",
            "010463333333333321Kn5KNk"
         ],
         "productionDate":"string",
         "expirationDate":"string",
         "tnved":"string",
         "permitDocsOperation":0,
         "permitDocs":[
            {
               "permitDocNumber":"string",
               "permitDocDate":"01.01.2023",
               "permitDocType":2
            }
         ],
         "emissionType":2
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantInn

string

ИНН участника оборота товаров

codes

array of objects

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

Массив объектов, содержащих уникальные коды и сведения, которые будут в этих кодах отредактированы (обновлены). Должен быть указан хотя бы один код и вид сведений для изменения. Количество объектов не должно превышать 1000

*code

array of string

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

Указываемый код должен быть без особого состояния или = «WAIT_TRANSFER_TO_OWNER» («Ожидает передачу собственнику») (см. справочник «Актуальные особые состояния»). Максимальное количество кодов — 100 000

*vsd

string

Идентификатор ВСД

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
в карточке товара в НКМТ «veterinaryControl» («Подлежит ветеринарному контролю (надзору)») = true;
код с типом упаковки «UNIT» («Единица товара») и не вложен в групповую упаковку;
статус кода «INTRODUCED» («В обороте»), «RETIRED» («Выбыл») или «WRITTEN_OFF» («Списан»);
идентификатор ВСД, указанный в документе, не совпадает с идентификатором ВСД в коде маркировки.

Минимальное значение — 36 символов, максимальное — 39 символов. Формат:

[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12};
[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}.

Изменить идентификатор ВСД не получится в период недоступности ФГИС «ВетИС», а также для КИ, введённого в оборот в период недоступности ФГИС «ВетИС», если по нему не завершилась автоматическая повторная обработка документа. В обоих случаях документ будет обработан с ошибкой. Данные о неудачной проверке идентификатора ВСД в КИ, входящих в состав КИГУ / КИН, будут фиксироваться для КИГУ / КИН до тех пор, пока все КИ, входящие в их состав, не пройдут проверку идентификатора ВСД. Результат проверки повторной обработки документа можно посмотреть в карточке КИ в поле «Тип операции по документу»

*productionDate

string

Дата производства

Можно указать при выполнении всех условий:

код с типом упаковки «UNIT» («Единица товара») или «BUNDLE» («Комплект»);
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Диапазон допустимых значений: от даты создания документа (текущей даты) минус двадцать лет по текущую дату плюс один день. Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке

*expirationDate

string

Дата истечения срока годности

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT»;
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Диапазон: начиная с 01.01.1999 по 31.12.2099. Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке.

Для одного кода не допускается одновременное указание данного параметра и «variableExpiration».

*variableExpiration

object

Информация о вариативном сроке годности

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
в карточке товара в НКМТ указан вариативный срок годности;
код с типом упаковки «UNIT»;
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Указываются условия хранения из карточки товара в НКМТ и дата в формате: "<индекс>": <дата>. Дата передаётся в формате timestamp в миллисекундах. Диапазон: начиная с 01.01.1999 по 31.12.2099.

Для одного кода не допускается одновременное указание данного параметра и «expirationDate».

Если вариативный срок годности указывается для кода, вложенного в КИГУ, и этот срок является минимальным среди всех вложений данного КИГУ, то срок годности для КИГУ автоматически изменится на срок, указанный в этом параметре

*tnved

string

Код ТН ВЭД ЕАЭС (10 цифр)

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT» («Единица товара») или «BUNDLE» («Комплект»), не вложен в групповую упаковку;
статус кода «INTRODUCED» («В обороте»);
тип эмиссии кода, отличный от «FOREIGN» («Ввезён в РФ»)

*weight

number

Фактический вес товара в граммах

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
в карточке товара в НКМТ «isVarQuantity» («Товар с переменным количеством») = true;
код с типом упаковки «UNIT» («Единица товара»);
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Длина значения: от 1 до 6 цифр (без разделителей). Минимальное значение — 1, максимальное — 999999

*partNumber

string

Номер партии

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT» («Единица товара»).

Длина значения от 21 до 32 символов включительно: цифры, буквы латинского алфавита, спецсимволы (0-9 A-Z a-z / . , - ), без пробелов

*permitDocsOperation

number

Операция, применяемая для всех сведений о разрешительной документации

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT» («Единица товара») или «BUNDLE» («Комплект»);
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Возможные значения:

0 — добавление новых сведений о разрешительной документации, указанных в массиве «permitDocs»;
1 — замена всех сведений о разрешительной документации из кода на указанные в массиве «permitDocs».

Для одного кода недоступно одновременное указание двух значений («0» и «1»), а также одновременно двух операций «1».

Если данный параметр не заполнен, то по умолчанию выполняется операция «0»

*permitDocs

array of objects

Сведения о разрешительной документации

Обязательный, если заполнен «permitDocsOperation». Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT» («Единица товара») или «BUNDLE» («Комплект»);
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Моторные масла», «Натуральный мех», «Никотиносодержащая продукция», «Пиво, напитки, изготавливаемые на основе пива, и слабоалкогольные напитки», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые» сведения о разрешительном документе должны соответствовать сведениям, указанным в карточке товара в НКМТ.

Если в карточке товара отсутствуют сведения о разрешительном документе, но при этом они будут указаны при подаче документа, то документ будет обработан с ошибкой.

Для товарных групп «Бакалейная продукция», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Морепродукты», «Моторные масла», «Натуральный мех», «Никотиносодержащая продукция», «Обувные товары», «Пиво, напитки, изготавливаемые на основе пива, и слабоалкогольные напитки», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Строительные материалы», «Упакованная вода», «Шины и покрышки пневматические резиновые новые» во избежание ошибок необходимо убедиться, что в документе указывается действующий разрешительный документ.

Максимальное количество разрешительных документов — 1000. Должны быть заполнены все три параметра массива, либо все три не заполнены

**permitDocNumber

string

Номер разрешительного документа

Формат: значение должно соответствовать регулярному выражению

**permitDocType

number

Вид разрешительного документа

См. «Справочник «Виды разрешительной документации»»

**permitDocDate

string

Дата разрешительного документа

Формат: dd.MM.yyyy. Если «permitDocType» = «4» («STATE_REGISTRATION_CERTIFICATE» / «Свидетельство о государственной регистрации»), то диапазон: начиная с 01.01.1900 по текущую дату, при других значениях — диапазон: начиная с 01.01.2000 по текущую дату

*licencesOperation

number

Операция, применяемая для всех лицензий на пользование недрами

Обязательный, если указан параметр «licences». Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT» («Единица товара»);
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Возможные значения:

0 — добавление новых сведений о лицензиях, указанных в массиве «licences»;
1 — замена всех сведений о лицензиях из кода на указанные в массиве «licences».

Если данный параметр не заполнен, то по умолчанию выполняется операция «0»

*licences

array of objects

Массив лицензий на пользование недрами

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT» («Единица товара»);
статус кода «APPLIED» («Нанесён») или «INTRODUCED» («В обороте»).

Обязательный, если указан параметр «licencesOperation». Одновременно должны быть заполнены все два параметра массива, либо все два не заполнены

**licence_number

string

Номер лицензии на пользование недрами

Для продукции, которая добывается из подземных вод (в карточке товара в НКМТ не заполнен «groundwaterUtilization» («Не добывается из подземных вод»)), формат должен соответствовать структуре: «СерияНомерВид», содержать от 10 до 14 символов включительно: цифры и кириллица (0-9 А-Я а-я) без пробелов и специальных символов. Пример: МОС06318ВЭ

**licence_date

string

Дата выдачи лицензии на пользование недрами

Диапазон: начиная с 01.01.1900 по текущую дату плюс один день. Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке

*emissionType

number

Тип эмиссии

Можно указать при выполнении всех условий:

код относится к одной из доступных товарных групп;
код с типом упаковки «UNIT» («Единица товара») или «BUNDLE» («Комплект»);
статус кода «EMITTED» («Эмитирован») или «APPLIED» («Нанесён»);
тип эмиссии кода «LOCAL» («Произведён в РФ») или «FOREIGN» («Ввезён в РФ»);
код не вложен в агрегат.

Возможные значения:

1 — «Произвёден в РФ»;
2 — «Ввезён в РФ»

4.1.18. Подключение кега к оборудованию для розлива

Создание документа доступно для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки».

При обработке документа осуществляется проверка ИНН и места осуществления деятельности отправителя документа на отсутствие блокировки в ЕГАИС, а также проверка КИ на отсутствие блокировки органами государственной власти.

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

Тип

Описание

CONNECT_TAP

Подключение кега к оборудованию для розлива. JSON (MANUAL)

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

{
   "participantInn":"1111111111",
   "participantKpp":"222222222",
   "codes":[
      {
         "cis":"010463333333333321kKkKkKk",
         "connectDate":"2023-04-20",
         "expirationDate":"2023-05-07"
      },
      {
         "cis":"010464444444444421NnNnNnN",
         "connectDate":"2023-04-17",
         "expirationDate":"2023-05-05"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantInn

string

ИНН участника оборота товаров, формирующего документ

participantKpp

string

КПП торговой точки

Обязательно заполнен для юридических лиц. Строго не заполнен для индивидуальных предпринимателей

fiasId

string

Идентификатор ФИАС

Обязательно заполнен для индивидуальных предпринимателей. Строго не заполнен для юридических лиц

codes

array of objects

Данные о кеге

Должен быть указан хотя бы один КИ и данные о нём. Количество КИ, указанных в одном документе, не должно превышать 100 000

*cis

string

КИ

Требования, предъявляемые к КИ:

принадлежат отправителю документа (для продукции, произведённой после 1 марта 2025 года и для которой наступила прослеживаемость);
уникальны внутри массива «codes»;
статус «INTRODUCED» («В обороте») или «RETIRED» («Выбыл»), особое состояние отсутствует;
тип упаковки «UNIT» («Единица товара»);
в карточке товара в НКМТ «packageCharacteristic» («Характеристика упаковки») = «КЕГ»;
в карточке товара в НКМТ значения «goodTurnFlag» («Признак готовности товара к обороту») и «goodMarkFlag» («Признак готовности к маркировке») = true;
заводской срок годности КИ больше «connectDate»

*connectDate

string

Дата подключения кега к оборудованию для розлива

Формат: yyyy-MM-dd. Диапазон допустимых значений: от даты создания документа минус пять лет по дату создания документа

*expirationDate

string

Дата истечения срока годности

В параметре указывается дата истечения предельного срока реализации продукции в кеге после его подключения к оборудованию. Формат: yyyy-MM-dd. Диапазон допустимых значений:

больше даты, указанной в «connectDate»;
не превышает заводской срок годности;
не превышает срок, рассчитанный как «connectDate» + «shelfLifeSpecializedPackageDays» («Предельный срок реализации после вскрытия кега») из карточки товара в НКМТ, если такой атрибут заполнен

После успешной обработки документа:

КИ присваивается особое состояние «CONNECT_TAP» («Подключён к оборудованию для розлива») — КИ с таким состоянием недоступен для агрегации и движения (перемещения);
владельцем КИ становится отправитель документа, если в документе был указан КИ, принадлежащий не отправителю документа (только для продукции, произведённой до 1 марта 2025 года и для которой не наступила прослеживаемость);
агрегат расформировывается (без смены владельца), если в документе указан вложенный в агрегат КИ;
для КИ сохраняются идентификатор текущего места осуществления деятельности, дата установки кега на кран, дата истечения срока годности, указанные в документе.

При этом, если срок годности не указан в документе, то после успешной обработки документа срок годности изменится для всех КИ на срок, рассчитанный как «connectDate» из документа + «shelfLifeSpecializedPackageDays» из карточки товара в НКМТ, но если такой срок не превышает заводской срок годности, и заполнен атрибут «shelfLifeSpecializedPackageDays» в карточке товара в НКМТ. Если срок превышен или атрибут не заполнен, то сохранится заводской срок годности.

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

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

Для товарных групп «Безалкогольное пиво», «Ветеринарные препараты», «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Моторные масла», «Строительные материалы» подача документа доступна только в формате * .json.

Примечание

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

Краткое описание причин перемаркировки:

испорчено либо утеряно СИ с КМ (KM_SPOILED) — участник оборота товаров, являющийся собственником товара, планирует перемаркировать товар, который находится в обороте. Указание данной причины возможно с указанием или без указания предыдущего КИ / КиЗ. Указанный предыдущий КИ должен быть в статусе «В обороте» / «Выбыл» по причине списания КИ / КиЗ;
выявлены ошибки описания товара (DESCRIPTION_ERRORS) — участник оборота товаров, являющийся собственником товара, планирует перемаркировать товар, который находится в обороте. Указание данной причины возможно только с указанием предыдущего КИ / КиЗ в статусе «В обороте» / «Выбыл» по причине списания КИ / КиЗ;
возврат товаров с повреждённым СИ / без СИ при розничной реализации (в ЛК ГИС МТ «Возврат от розничного покупателя» (RETAIL_RETURN)) — участник оборота товара, являющийся собственником товара, планирует перемаркировать товар, возвращённый после розничной реализации (например: чек возврата без КИ / КиЗ). Указание данной причины возможно с указанием или без указания предыдущего КИ / КиЗ. Указанный предыдущий КИ / КиЗ должен быть в статусе «Выбыл» по причине розничной реализации;
возврат товаров с повреждённым СИ / без СИ при дистанционном способе продажи (в ЛК ГИС МТ «Возврат в случае дистанционной продажи» (REMOTE_SALE_RETURN)) — участник оборота товара, являющийся собственником товара, планирует перемаркировать товар, возвращённый после дистанционного способа продажи. Указание данной причины возможно с указанием или без указания предыдущего КИ / КиЗ. Указанный предыдущий КИ / КиЗ должен быть в статусе «Выбыл» по причине дистанционного способа продажи;
возврат от конечного покупателя (юр. лица / ИП) (LEGAL_RETURN) — участник оборота товара, являющийся собственником товара, планирует перемаркировать товар, возвращённый после реализации ЮЛ / ИП. Указание данной причины возможно как с указанием предыдущего КИ / КиЗ, так и без него. Указанный предыдущий КИ / КиЗ должен быть в статусе «Выбыл» по причине исполнения государственного контракта безвозмездной передачи, использования товара для собственных нужд покупателем;
решение о реализации товаров, приобретённых в целях, не связанных с их реализацией (INTERNAL_RETURN) — участник оборота товара, являющийся собственником товара, планирует перемаркировать ранее приобретённый товар с целью дальнейшей реализации. Указание данной причины возможно как с указанием предыдущего КИ / КиЗ, так и без него. Указанный предыдущий КИ / КиЗ должен быть в статусе «Выбыл» по причине использования товара для собственных нужд. КИ / КиЗ был выведен из оборота через документ вывода из оборота или УПД с выводом из оборота;
возврат ранее экспортированного в ЕАЭС (EEC_EXPORT_RETURN) — участник оборота товара, являющийся последним собственником товара, планирует перемаркировать ранее приобретённый товар, который возвращён после экспорта в страны ЕЭАС. Указание данной причины возможно как с указанием предыдущего КИ / КиЗ, так и без него. Указанный предыдущий КИ / КиЗ должен быть в статусе «Выбыл» по причине экспорта в страны ЕАЭС.

Для всех товарных групп, кроме «Антисептики и дезинфицирующие средства», «Безалкогольное пиво», «Ветеринарные препараты», «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Моторные масла», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы» доступны все причины перемаркировки.

Для товарных групп «Антисептики и дезинфицирующие средства», «Безалкогольное пиво», «Ветеринарные препараты», «Игры и игрушки для детей», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Моторные масла», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы» доступны только следующие причины перемаркировки:

испорчено либо утеряно СИ с КМ (KM_SPOILED);
выявлены ошибки описания товара (DESCRIPTION_ERRORS).

Условия перемаркировки:

новый КИ / КиЗ может быть только в статусе «Нанесён» (APPLIED) с типом эмиссии «Перемаркировка» (REMARK) или «Маркировка вне производства или импорта» (REAPPLY);
перемаркировка осуществляется для предыдущего КИ / КиЗ только в статусе «В обороте» (INTRODUCED) или «Выбыл» (RETIRED);
участник оборота товаров, осуществляющий перемаркировку, должен быть владельцем предыдущего КИ / КиЗ;
обязательно указание предыдущего КИ / КиЗ в параметре «last_uin» («Предыдущий КИ / КиЗ») для причины перемаркировки «Выявлены ошибки описания товара», а также для КИГУ или КИН для всех причин перемаркировки. При указании предыдущего КИ / КиЗ данные о цвете, размере и стране производства берутся из указанного предыдущего КИ / КиЗ, даже если при формировании документа были указаны данные, отличные от данных предыдущего КИ / КиЗ;
если товар вложен в КИГУ или КИН, то код товара нового КИ должен совпадать с кодом товара предыдущего КИ, если он указан в параметре «last_uin» («Предыдущий КИ / КиЗ»);
КИ агрегата и КИ товара, входящего в состав агрегата, в параметре «new_uin» («Новый КИ / КиЗ») не указывается. При указании КИ, входящего в состав агрегата в статусе «Сформирован», агрегат расформировывается;
причина выбытия КИ / КиЗ соответствует причине перемаркировки;
тип упаковки нового КИ / КиЗ должен соответствовать типу упаковки предыдущего КИ / КиЗ;
для товарной группы «Велосипеды и велосипедные рамы»: если новый КИ получен на код товара с префиксом «029», то карточка такого кода в НКМТ должна быть с типом «Техническая карточка» («isTechGtin» = true). Перемаркировка недоступна на КИ, который получен на код товара с типом карточки «Остатки (велосипеды)» («isTechGtin» = false).

Примечание

Перемаркировка с использованием типа эмиссии «Маркировка вне производства или импорта» (REAPPLY) недоступна для КИН и КИГУ

Условия перемаркировки КИН:

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

Перемаркировка КИН или КИ в составе КИН недоступна при следующих условиях (документ будет обработан с ошибкой):

указание значения DESCRIPTION_ERRORS («Выявлены ошибки описания товара»);
КИ в статусе «Списан» (WRITTEN_OFF), находящийся в составе КИН;
указание КИН и вложенных в него КИ в одном документе.

После обработки документа все вложения из предыдущего КИН переходят в новый КИН, при этом предыдущий КИН переходит в статус «Выбыл» (RETIRED), а новый КИН переходит в статус «В обороте» (INTRODUCED). Если статус предыдущего КИН «Выбыл» (RETIRED), то все вложения переходят в новый КИН и вводятся в оборот вместе с КИН.

При перемаркировке КИ в статусе «В обороте» (INTRODUCED) в составе КИН со статусом «В обороте» (INTRODUCED), КИН не расформировывается, предыдущий КИ списывается, исключается из КИН и в состав КИН включается новый КИ, при этом GTIN нового и предыдущего КИ должны совпадать.

При перемаркировке КИ в статусе «Выбыл» (RETIRED) в составе КИН со статусом «Выбыл» (RETIRED), КИН расформировывается (DISAGGREGATION), предыдущий КИ списывается (WRITTEN_OFF), а новый КИ вводится в оборот (INTRODUCED).

В результате успешной обработки документа, в котором агентом / комиссионером были указаны предыдущий и новый КИ / КиЗ, полученные на один код товара, новый КИ / КиЗ получит те же самые характеристики, что и предыдущий КИ / КиЗ, а именно о том, что КИ / КиЗ был передан по АКС с указанием того собственника, который передал агенту / комиссионеру этот КИ / КиЗ.

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

Тип

Описание

LK_REMARK

Перемаркировка. JSON (MANUAL)

LK_REMARK_XML

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

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

{
   "participant_inn":"7777777777",
   "remarking_date":"2021-10-10",
   "remarking_cause":"string",
   "products":[
      {
         "last_uin":"010461111111111121LLLLLLLLLLLLL",
         "new_uin":"010463333333333321FFFFFFFFFFFFF",
         "tnved_10":"0000000000",
         "production_country":"string",
         "color":"string",
         "product_size":"string",
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00001/21",
               "certificate_date":"2021-10-10"
            },
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"RU С-ХХ.АА00.B.00002/21",
               "certificate_date":"2021-10-10"
            }
         ]
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника оборота товаров

remarking_date

string

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

Обязательный, если не указан одноимённый параметр в массиве «products».

Диапазон: текущая дата минус 5 календарных лет ← дата ← текущая дата.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени в значении допускается, но игнорируется при обработке.

Значение параметра «remarking_date» в массиве «products» превалирующее

remarking_cause

string

Причина перемаркировки

Обязательный, если не указан одноимённый параметр в массиве «products». Возможные значения см. в разделе «Справочник «Причины выбытия»».

Значение параметра «remarking_cause» в массиве «products» превалирующее

products

array of objects

Массив перемаркируемых КИ / КиЗ

Должна быть указана хотя бы одна запись списка

*last_uin

string

Предыдущий код

Обязательный, если выполнено хотя бы одно из условий:

«remarking_cause» = «DESCRIPTION_ERRORS»;
указан КИГУ или КИН.

Предыдущий КИ должен быть в статусе «В обороте» (INTRODUCED) или «Выбыл» (RETIRED)

*new_uin

string

Новый код

Требования к кодам:

статус «APPLIED» («Нанесён»), особое состояние отсутствует;
тип эмиссии «REMARK» («Перемаркировка») или «REAPPLY» («Маркировка вне производства или импорта»).

Повторный ввод в оборот возможен, если не указаны предыдущие КИ / КиЗ / КИК

*primary_document_type

string

Вид первичного документа

Если данный параметр указан, то «primary_document_number», «primary_document_date» являются обязательными. Одновременно должны быть заполнены все три параметра, либо все три не заполнены.

Не указывается для КИГУ и КИН.

Возможные значения:

если «remarking_cause» = «RETAIL_RETURN» или «REMOTE_SALE_RETURN»:

RECEIPT — кассовый чек;
SALES_RECEIPT — товарный чек;
OTHER — прочее.
если «remarking_cause» = «LEGAL_RETURN»: UTD — универсальный передаточный документ;
если «remarking_cause» = «EEC_EXPORT_RETURN»:

CONSIGNMENT_NOTE — товарная накладная;
UTD — универсальный передаточный документ

*primary_document_custom_name

string

Наименование первичного документа

Не указывается для КИГУ и КИН.

Длина значения — от 1 до 255 символов включительно

*primary_document_date

string

Дата первичного документа

См. комментарий к параметру «primary_document_type».

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке

*primary_document_number

string

Номер первичного документа

См. комментарий к параметру «primary_document_type».

Длина значения — от 1 до 255 символов включительно

*remarking_date

string

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

Обязательный, если не указан одноимённый параметр вне массива «products». См. комментарий к параметру «remarking_date» вне массива «products»

*remarking_cause

string

Причина перемаркировки

Обязательный, если не указан одноимённый параметр в массиве «products». См. комментарий к параметру «remarking_date» вне массива «products»

*tnved_10

string

Код ТН ВЭД ЕАЭС товара

Обязательный, если не указан параметр «last_uin». Если указан КИН, то строго не заполнен.

Для товарных групп «Антисептики и дезинфицирующие средства», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Специализированная пищевая продукция и БАД к пище» и «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки» доступно указание как устаревших (действительных до 31.01.2022), так и новых кодов ТН ВЭД ЕАЭС (действительных с 01.01.2022)

*paid

boolean

Товар оплачен

Признак оплаты товара:

true — оплачен;
false — не оплачен.

Параметр устаревший и в дальнейшем будет удалён

*production_country

string

Страна производства

Может быть указан для товарной группы «Обувные товары». Для других товарных групп игнорируется при обработке.

Указывается код страны в соответствии с ОКСМ (например: 112 — Республика Беларусь)

*color

string

Цвет

Формат: от 1 до 1024 буквенных символа на английском или русском языке

*product_size

string

Размер

Формат: от 1 до 1024 буквенных символа на английском или русском языке (например: 37RUS / 6US). Допускается указание диапазона размеров для следующих кодов ТН ВЭД ЕАЭС: 6401929000, 6402200000, 6402991000, 6402993900, 6404191000, 6404199000. Так же диапазон значений может применяться для ряда товаров с кодом ТН ВЭД ЕАЭС 6402190000 (например, ботинки раздвижные для роликовых коньков)

*certificate_document_data

array of objects

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

**certificate_type

string

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

Обязательный, если не указан «certificate_document» и в Системе маркировки для кодов не указаны сведения о разрешительной документации.

Если указан «certificate_type», то обязательны «certificate_number» и «certificate_date» в массиве «certificate_document_data». Если указан «certificate_document», то обязательны «certificate_document_number» и «certificate_document_date» вне массива «certificate_document_data».

Параметр может быть указан только для КИ, КиЗ, КИК.

Строго не заполнен для товарных групп «Ветеринарные препараты», «Специализированная пищевая продукция и БАД к пище».

Возможные значения см. в разделе «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

См. комментарий к параметру «certificate_type» массива «certificate_document_data».

Формат: значение должно соответствовать регулярному выражению

**certificate_date

string date

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

См. комментарий к параметру «certificate_type» массива «certificate_document_data».

Диапазон: начиная с 2000-01-01 по текущую дату. Если в «certificate_type» = «STATE_REGISTRATION_CERTIFICATE», то диапазон: начиная с 1900-01-01 по текущую дату.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке документа

*certificate_document

string

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

См. комментарий к параметру «certificate_type» массива «certificate_document_data».

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

*certificate_document_number

string

Номер документа, подтверждающего соответствие

См. комментарий к параметру «certificate_number» массива «certificate_document_data».

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

*certificate_document_date

string

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

См. комментарий к параметру «certificate_date» массива «certificate_document_data».

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

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

<remark version="7">
    <trade_participant_inn>7777777777</trade_participant_inn>
    <remark_date>2021-10-10</remark_date>
    <remark_cause>KM_SPOILED</remark_cause>
    <products_list>
        <product>
            <last_ki>010461111111111121LLLLLLLLLLLLL</last_ki>
            <new_ki>010463333333333321FFFFFFFFFFFFF</new_ki>
            <tnved_code_10>0000000000</tnved_code_10>
            <production_country>ИНДОНЕЗИЯ</production_country>
            <color>зеленый</color>
            <product_size>25</product_size>
            <primary_document_type>RECEIPT</primary_document_type>
            <primary_document_number>1234</primary_document_number>
            <primary_document_date>2021-10-10</primary_document_date>
            <certificate_document_data>
                <product>
                    <certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
                    <certificate_number>1234</certificate_number>
                    <certificate_date>2021-10-10</certificate_date>
                </product>
                <product>
                    <certificate_type>CONFORMITY_CERTIFICATE</certificate_type>
                    <certificate_number>4563</certificate_number>
                    <certificate_date>2021-10-10</certificate_date>
                </product>
            </certificate_document_data>
        </product>
    </products_list>
</remark>

4.1.20. Индивидуализация КиЗ

Создание документа доступно только для товарной группы "Товары из натурального меха".

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

Тип

Описание

LK_INDIVIDUALIZATION

Индивидуализация КиЗ. JSON

LK_INDIVIDUALIZATION_XML

Индивидуализация КиЗ. XML

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string (10, 12)

ИНН участника оборота товаров, осуществившего индивидуализацию КиЗ

Формат: только цифры, от 10 до 12 знаков

individualization_date

string

Дата индивидуализации КиЗ

Формат для LK_INDIVIDUALIZATION:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Диапазон допустимых значений: от даты создания документа минус пять лет по дату создания документа

products_list

[string]

Перечень КиЗ и товаров

*cis_code

string

Уникальный номер КиЗ

Длина: 20 символов.

Шаблон: (RU|AM|BY|KZ|KG)[-]{1}[A-Z0-9]{6}[-]{1}[A-Z0-9]{10}

*sgtin

string

Идентификационный номер SGTIN в бинарном формате длиной 96 бит

Формат: 96 символов, только "0" и "1", <признак SGTIN-96 (8 символов)><фильтр (3 символа)><разделитель (3 символа)><GTIN (44 символа)><серийный номер предмета (38 символов)>, где:

значение признака SGTIN-96 фиксировано и равно "00110000", означая, что информация, содержащаяся на RFID-метке, должна обрабатываться как SGTIN-96;
значение фильтра фиксировано для товарной группы "Товары из натурального меха" и равно "001", что указывает на предмет для розничной продажи. Подробная информация о значениях фильтра представлена в спецификации GS1 EPC Tag Data Standard;
значение разделителя определяет правило интерпретации GTIN, то есть указывает на число символов, отведённых для составляющих GTIN: префикса производителя и ссылки на предмет торговли;
GTIN содержит префикс производителя и ссылку на предмет торговли согласно ГОСТ Р 54621-2011/ISO/IEC TR 24729-1:2008;

* серийный номер предмета — уникальный номер каждой единицы товара среди однородных товаров. Генерация серийных номеров для SGTIN-96 осуществляется по правилам, устанавливаемым производителями RFID-меток. Первые три символа указывают на производителя RFID-метки и формируются с учётом соглашения Multi-vendor Chipbased Serialization. Остальные символы формируются путём комбинации 35-битной бинарной строки из уникального идентификатора RFID-метки.

Вся структура номера SGTIN-96 представлена 96-битовой бинарной строкой: 00110000011101000100101011110111111010001100010010111111000000000000000100000100100011000000100.

SGTIN-96 формируется согласно ГОСТ Р 54621-2011/ISO/IEC TR 24729-1:2008 и спецификации GS1 EPC Tag Data Standard. Подробнее о формировании SGTIN-96 см. в "Инструкция по формированию серийного глобального номера предмета торговли, соответствующего международному стандарту SGTIN-96, для товарной группы "Товары из натурального меха""

*gtin

string

Код товара

Формат: 14 цифровых символов от 0 до 9 с указанием ведущих нулей для кода товара (GTIN) длиной 8, 12 или 13 цифр

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

{
  "participant_inn": "0000000000",
  "individualization_date": "2020-11-21",
  "products_list": [
    {
      "cis_code": "RU-000000-AAA0000001",
      "sgtin": "001100000011010100011101101010110100110000001011000111110011111110011101010100111001000001011001",
      "gtin": "00000000000000"
    },
    {
      "cis_code": "RU-000000-AAA0000002",
      "sgtin": "001100000011010100011101101010110100110000001011000111110011111110011101010100111001000001000001",
      "gtin": "00000000000000"
    }
  ]
}

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

<?xml version="1.0" encoding="UTF-8"?>
<individualizationKiz version="1">
  <participant_inn>7777777777</participant_inn>
  <individualization_date>2022-05-17</individualization_date>
  <products_list>
    <product>
      <cis_code>RU-11111W-1S1SSS1SSS</cis_code>
      <sgtin>001100000011010100011101101010110100110000001011000111110011111110011101010100111001000001011001</sgtin>
      <gtin>04600000000000</gtin>
    </product>
  </products_list>
</individualizationKiz>

4.1.21. Отмена отгрузки по УПД

Создание документа доступно для товарных групп «Алкоголь», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки». Для товарной группы «Алкоголь» создание доступно только на демонстрационном контуре.

Документ предназначен для подачи сведений об отмене документа «УПД (отгрузка продукции)» (FIXATION), обработанного успешно в Системе маркировки.

Подача документа доступна только отправителю документа «УПД (отгрузка продукции)» (FIXATION).

Для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» во избежание ошибок перед подачей документа необходимо убедиться, что для КИ, в том числе для вложенных в агрегат, указан действующий разрешительный документ.

При успешной обработке документа:

документ «УПД (отгрузка продукции)» (FIXATION) меняет статус на «CANCELED» («Отменён»);
особое состояние кодов («MOVING_BY_UD» («Отгружен»)) аннулируется.

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

Тип

Описание

FIXATION_CANCEL

Отмена отгрузки по УПД. JSON (MANUAL)

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

{
   "inn":"1111111111",
   "fixation_document_id":"FIX_1111111111"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

inn

string

ИНН участника оборота товаров

fixation_document_id

string

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

Указывается уникальный идентификатор документа в Системе маркировки в формате «FIX_<ИдФайл>», полученный в ответе при отправке типа документа «FIXATION»

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

Код

Наименование

Формат

Доступны только для просмотра

EAS_CROSSBORDER

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

JSON

LP_SHIP_GOODS_CROSSBORDER

Отгрузка из ЕАЭС

JSON

EAS_GTIN_CROSSBORDER_IMPORT

Отгрузка из ЕАЭС (ОСУ)

JSON

LP_CANCEL_SHIPMENT_CROSSBORDER

Отмена отгрузки из ЕАЭС

JSON

EAS_CROSSBORDER_EXPORT_ACCEPTANCE

Приёмка в ЕАЭС

JSON

EAS_GTIN_CROSSBORDER_EXPORT_ACCEPTANCE

Приёмка в ЕАЭС (ОСУ)

JSON

LP_FTS_INTRODUCE_RESPONSE

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

JSON

LP_FTS_INTRODUCE_AUTO

Автоввод в оборот при импорте с ФТС

JSON

GRAY_ZONE_CSV

Уведомление о временно непрослеживаемых кодах идентификации («Табачная продукция»)

CSV

RECEIPT

Чек (Формируется оператором фискальных данных)

RECEIPT_RETURN

Чек возврата (формируется оператором фискальных данных)

UNIVERSAL_TRANSFER_DOCUMENT

УПД ДОП (накладная)

UNIVERSAL_TRANSFER_DOCUMENT

УПД СЧФ (счет-фактура)

UNIVERSAL_TRANSFER_DOCUMENT

УПД СЧФДОП (счет-фактура+накладная)

UNIVERSAL_TRANSFER_DOCUMENT_FIX

УПД(и) ДОП (на накладную)

UNIVERSAL_TRANSFER_DOCUMENT_FIX

УПД(и) СЧФ (на счет-фактуру)

UNIVERSAL_TRANSFER_DOCUMENT_FIX

УПД(и) СЧФДОП

UNIVERSAL_CORRECTION_DOCUMENT

УКД ДИС (на накладную)

UNIVERSAL_CORRECTION_DOCUMENT

УКД КСЧФ (на счет-фактуру)

UNIVERSAL_CORRECTION_DOCUMENT

УКД КСЧФ ДИС

UNIVERSAL_CORRECTION_DOCUMENT_FIX

УКД(и) ДИС (исправление корректировки накладной)

UNIVERSAL_CORRECTION_DOCUMENT_FIX

УКД(и) КСЧФ (исправление корректировочной счет-фактуры)

UNIVERSAL_CORRECTION_DOCUMENT_FIX

УКД(и) КСЧФ ДИС

UNIVERSAL_CANCEL_DOCUMENT

Аннулирование УД

4.2.1. Отгрузка

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

В ГИС МТ обеспечен процесс получения, обработки и признания кодов, эмитированных в Национальной информационной системе маркировки и прослеживаемости товаров государств-членов ЕАЭС и указанных в документе трансграничной отгрузки, полученном от Оператора системы маркировки государства-члена ЕАЭС:

Государство-член ЕАЭС

Товарная группа с признанием кодов

Республика Беларусь

«Молочная продукция»
«Обувные товары»
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»
«Соковая продукция и безалкогольные напитки»
«Шины и покрышки пневматические резиновые новые»

Республика Казахстан

«Обувные товары»

Республика Армения

«Консервированная продукция»
«Корма для животных»
«Молочная продукция»
«Морепродукты»
«Моторные масла»
«Растительные масла»
«Соковая продукция и безалкогольные напитки»
«Упакованная вода»

При создании документа на трансграничную отгрузку с признанием кодов в документ, наряду с данными кодов, эмитированных в РФ, могут быть переданы данные кодов, эмитированных в государстве-члене ЕАЭС. Такие коды проходят через процесс признания: проверяются и сохраняются в ГИС МТ как эмитированные в РФ.

Также в документ могут быть переданы данные кодов, эмитированных в РФ и экспортированных в государство-член ЕАЭС, с целью реэкспорта в РФ.

В ГИС МТ реализован контроль дубликатов кодов: если в результате проверки кодов государства-члена ЕАЭС, указанных в документе отгрузки, будут обнаружены дубли кодов РФ (полное совпадение кодов РФ и кодов государства-члена ЕАЭС), то такой документ отгрузки будет отклонён, поскольку взаимное признание дублей кодов недопустимо.

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

Тип

Описание

EAS_CROSSBORDER

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

Пример тела документа для товарной группы «Упакованная вода» при экспорте агрегатов из Республики Армения:

{
   "sender_inn":"777777777",
   "sender":"Оператор ЕАЭС",
   "receiver_inn":"0000000001",
   "receiver":"ООО Название",
   "exporter_taxpayer_id":"0000000003",
   "exporter_name":"Экспортёр в ЕАЭС",
   "document_date":"2020-01-14T00:00:00.000Z",
   "document_num":"454545",
   "release_method":"CROSSBORDER",
   "transfer_date":"2020-01-14T00:00:00.000Z",
   "products":[
      {
         "cis":"string",
         "cis_type":"BOX",
         "product_tax":20,
         "product_cost":200,
         "children":[
            {
               "cis":"string",
               "cis_type":"BOX",
               "children":[
                  {
                     "cis":"string",
                     "emission_country_code":"1",
                     "cis_type":"UNIT",
                     "expiration_date":"2025-12-31",
                     "production_date":"2023-01-01",
                     "certificate_document_data":[
                        {
                           "certificate_type":"Quality",
                           "certificate_number":"CERT12345",
                           "certificate_date":"2023-06-01"
                        }
                     ],
                     "product_tax":10,
                     "product_cost":100,
                     "production_data":{
                        "producer_id":"1234567890",
                        "producer_name":"ООО Производитель"
                     },
                     "import_data":{
                        "importer_name":"Importer Corp",
                        "importer_id":"IMP456",
                        "declaration_number":"DECL789",
                        "declaration_date":"2023-07-01"
                     }
                  }
               ]
            }
         ]
      }
   ]
}

Пример тела документа для остальных случаев:

{
  "sender_inn": "000000002",
  "sender": "Оператор ЕАЭС",
  "receiver_inn": "0000000001",
  "receiver": "ООО Название",
  "exporter_taxpayer_id": "0000000003",
  "exporter_name": "Экспортёр в ЕАЭС",
  "exporter_gln": "0000000000002",
  "document_num": "000000000",
  "document_date": "2020-01-14T00:00:00.000Z",
  "release_method": "CROSSBORDER",
  "transfer_date": "2020-01-14T00:00:00.000Z",
  "products": [
    {
      "cis": "010000000000000021111111",
      "emission_country_code": 3,
      "product_cost": 2050,
      "product_tax": 20,
      "certificate_document_data": [
        {
          "certificate_type": "CONFORMITY_CERTIFICATE",
          "certificate_number": "123",
          "certificate_date": "2021-07-07"
        },
        {
          "certificate_type": "STATE_REGISTRATION_CERTIFICATE",
          "certificate_number": "321",
          "certificate_date": "2021-07-07"
        }
      ]
    },
    {
      "cis": "010000000000000021222222",
      "emission_country_code": 3,
      "import_data": {
        "importer_id": 1234567890,
        "importer_name": "ООО Импортёр",
        "declaration_number": "88888888/131221/7777777",
        "declaration_date": "2021-12-13"
      }
    },
    {
      "cis": "0000000000033333",
      "emission_country_code": 5,
      "production_data": {
        "producer_id": 1234567890,
        "producer_name": "ООО Производитель"
      }
    }
  ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

sender_inn

string

Идентификатор Оператора ЕАЭС

Возможные значения:

«100083608» (Республика Беларусь);
«02284645» (Республика Армения);
«941240000193» (Республика Казахстан);
«00406200910056» (Кыргызская Республика) — на текущий момент признание КИ не реализовано

sender

string

Наименование Оператора ЕАЭС

Длина значения: от 1 до 255 символов включительно.

Возможные значения:

«РУП «Издательство «Белбланкавыд»»» (Республика Беларусь);
«ЦРПТ-Армения» (Республика Армения);
«АО «Казахтелеком»» (Республика Казахстан);
«ЗАО «Альфа Телеком» (Мегаком)» (Кыргызская Республика) — на текущий момент признание КИ не реализовано

exporter_name

string

Наименование экспортёра

Длина значения: от 1 до 255 символов включительно

exporter_gln

string

Глобальный номер места нахождения получателя (GLN)

receiver_inn

string

ИНН получателя в РФ

Получателем является участник оборота товаров РФ

receiver

string

Наименование получателя в РФ

Длина от 1 до 255 символов включительно

exporter_taxpayer_id

string

Уникальный идентификатор экспортёра в национальной системе учёта налогоплательщиков

Длина значения: 8/9/10/12/14 цифр

receiver_country_code

string

Код страны получателя

Возможное значение: «643» (Российская Федерация)

sender_country_code

string

Код страны отправителя

Возможные значения:

«112» — Республика Беларусь;
«417» — Кыргызская республика;
«398» — Республика Казахстан;
«051» — Республика Армения

release_method

string

Способ ввода товара в оборот

Параметр принимает значение «CROSSBORDER» («Ввезён из стран ЕАЭС»)

document_num

string

Номер первичного документа

Длина значения: от 1 до 255 символов включительно

document_date

string

Дата первичного документа

Формат:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

Диапазон: текущая дата минус 5 календарных лет ← дата ← следующий день

transfer_date

string (date-time)

Дата и время отгрузки

Формат:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

Диапазон: текущая дата минус 5 календарных лет ← дата ← следующий день

products

array of objects

Массив, содержащий список передаваемых кодов

Должен быть указан хотя бы один код и сведения о нём

*cis

string

Передаваемый КИ / КИГУ / КИК / КИТУ

Требования к кодам:

уникальны в документе;
количество кодов (в том числе агрегатов) в одном документе не превышает 100 000;
тип упаковки:
- «UNIT» («Единица товара»);
- «BUNDLE» («Комплект») — только при реэкспорте в РФ из Республики Беларусь;
- «BOX» («КИТУ»), «GROUP» («КИГУ») — только для товарной группы «Упакованная вода» при экспорте из Республики Армения.
статус «EMITTED» («Эмитирован»), «APPLIED» («Нанесён») или «RETIRED» («Выбыл»), особое состояние отсутствует — для КИ / КИГУ / КИК, в том числе вложенных в агрегат;

статус «APPLIED» («Нанесён»), особое состояние «WAIT_SHIPMENT» («Ожидает приёмку товара») — для КИ / КИГУ / КИК / КИТУ, если они ранее были отгружены в составе агрегата. Если данный код отгружается в составе предыдущего агрегата, то состав этого агрегата должен полностью соответствовать составу при предыдущей отгрузке. Если код отгружается в составе агрегата с новым идентификатором, то тип упаковки агрегата должен оставаться прежним, а его состав может отличаться от состава предыдущего агрегата, в который ранее был вложен данный код. При этом, если данный код содержит вложения, их состав должен полностью совпадать с составом при предыдущей отгрузке. При указании кода вне состава агрегата предыдущий агрегат автоматически расформировывается;
статус не равен «DISAGGREGATION» («Расформирован») — для КИТУ;

для кодов в статусе «RETIRED» («Выбыл») причина выбытия — «EAS_TRADE» («Трансграничная продажа в страны ЕАЭС»);
КИ могут быть вложены в КИГУ / КИТУ только для товарной группы «Упакованная вода» при экспорте из Республики Армения;
КИТУ: может содержать не более 5 уровней вложенности, при этом количество кодов на одном уровне — не более 10 000;
идентификатор текущего владельца кода должен совпадать со значением «sender_inn» («Идентификатор Оператора ЕАЭС»), если статус кода «EMITTED» («Эмитирован») или «APPLIED» («Нанесён»). Для кода в статусе «RETIRED» («Выбыл») идентификатор текущего владельца может не совпадать с идентификатором Оператора ЕАЭС;

товарная группа должна совпадать со значением параметра «pg» («Товарная группа»), указанным в запросе;
в карточке товара в НКМТ значения атрибутов «goodMarkFlag» («Признак готовности к маркировке») и «goodTurnFlag» («Признак готовности товара к обороту») = true;
первый символ серийного номера должен быть равен значению «emission_country_code» («Код страны эмитента»).

Признанные КИ хранятся в базах данных ГИС МТ без кодов проверки

*cis_type

string

Тип КИ

Возможные значения:

«UNIT» («Единица товара») — значение по умолчанию;
«BOX» («КИТУ»);
«GROUP» («КИГУ»)

*gtin_inn

string

ИНН владельца карточки товара

Параметр игнорируется. Реализован для совместимости с API Оператора ЕАЭС

*emission_country_code

integer

Код страны эмитента

Обязательный для всех кодов, кроме КИТУ. Для КИТУ строго не указан. Возможные значения:

1 — Республика Армения;
2 — Республика Беларусь;
3 — Республика Казахстан;
4 — Кыргызская Республика;
5 — Российская Федерация.

Для КИ значение равно первому символу серийного номера

*part_number

string

Номер партии

Может быть заполнен для товарной группы «Молочная продукция». Для других товарных групп строго не заполнен.

*product_cost

integer

Цена

Цена за промаркированную единицу товара с учётом НДС (если сделка облагается НДС) или за все вложения агрегата. Значение указывается в копейках РФ, должно быть строго больше «product_tax» («Сумма НДС»), до 17 символов

*product_tax

integer

Сумма НДС

Сумма НДС за промаркированную единицу товара или за все вложения агрегата. Указывается в копейках. Если сделка не облагается НДС, то указывается значение «0». Значение должно быть строго меньше «product_cost» («Цена за единицу»), до 17 символов

*product_weight

integer

Переменный вес продукта (в граммах)

Обязательный для товарных групп «Корма для животных», «Молочная продукция», «Морепродукты», если в карточке товара в НКМТ «isVarQuantity» («Товар с переменным количеством») = true. Для товаров без переменного количества параметр должен строго отсутствовать. Для остальных товарных групп — необязательный.

Длина значения: от 1 до 6 цифр (без разделителей). Минимальное значение — 1, максимальное — 999999

*production_date

string

Дата производства

Обязательный для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Моторные масла», «Растительные масла», «Соковая продукция и безалкогольные напитки» и «Упакованная вода». Может быть указан только для КИ. Для других товарных групп игнорируется при обработке.

Формат:
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

*expiration_date

string

Дата истечения срока годности

Формат:
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

Указание времени допускается, но игнорируется при обработке. Диапазон: не менее текущей даты минус 5 лет и не более 31.12.2099

*certificate_document_data

array of objects

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

Параметр и вложенные значения временно опциональны

**certificate_type

string

Код вида документа, подтверждающего соответствие

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string

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

*import_data

object

Данные импорта

Может быть указан только для КИ / КИК

**importer_id

string

ИНН (или аналог) импортёра

От 1 до 50 символов включительно. Обязательный, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен

**importer_name

string

Наименование импортёра

От 1 до 255 символов включительно. Обязательный, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен

**declaration_number

string

Регистрационный номер декларации на товары

Обязательный, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен. Три группы, разделённые символом «/», где первая группа может содержать 2, 5 либо 8 символов, вторая — 6, третья — 7. Пример: 88888888/010422/7777777. Вторая группа цифр в регистрационном номере должна совпадать со значением даты регистрации декларации, указанной в поле «declaration_date» («Дата декларации на товары»), и соответствовать формату: ddMMyy

**declaration_date

string

Дата декларации на товары

Обязательный, если заполнен параметр «import_data» («Данные импорта»), иначе — строго не заполнен. Диапазон даты: с 01.01.2000 по дату создания документа. Соответствует значению параметра «declaration_number» («Регистрационный номер декларации на товары»).

Формат:
dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке документа

*production_data

object

Данные производства

Может быть указан только для КИ / КИК

**producer_id

string

ИНН (или аналог) производителя

От 1 до 50 символов включительно. Обязательный, если заполнен параметр «production_data» («Данные производства»), иначе — строго не заполнен

**producer_name

string

Наименование производителя

От 1 до 255 символов включительно. Обязательный, если заполнен параметр «production_data» («Данные производства»), иначе — строго не заполнен

*children

array of objects

Массив, содержащий список вложенных кодов

Рекурсивный элемент, содержащий те же параметры, что и массив «products». Обязательный для КИГУ / КИТУ товарной группы «Упакованная вода» при экспорте из Республики Армения, иначе — строго не заполнен. Указываются все вложения

4.2.1.2. Отгрузка из ЕАЭС

Документ доступен только Операторам государств-членов ЕАЭС для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Морепродукты», «Моторные масла», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

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

Тип

Описание

LP_SHIP_GOODS_CROSSBORDER

Отгрузка из ЕАЭС. JSON (MANUAL)

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

{
  "document_num": "77777777",
  "document_date": "2020-01-14T00:00:00.000Z",
  "receiver_inn": "777777777",
  "receiver": "ООО",
  "sender_inn": "100083608",
  "sender": "РУП Издательство Белбланкавыд",
  "exporter_taxpayer_id": "7813364670",
  "exporter_name": "Белобувьэкспорт",
  "request_type": "SHIPMENT",
  "release_method": "CROSSBORDER",
  "transfer_date": "2020-01-14T00:00:00.000Z",
  "products": [
    {
      "uit_code": "010463003759131621qSyEMozA3oJjP2406401",
      "product_cost": 2050,
      "product_tax": 20,
      "certificate_document_data": [
        {
          "certificate_type": "CONFORMITY_CERTIFICATE",
          "certificate_number": "123",
          "certificate_date": "2021-07-07"
        },
        {
          "certificate_type": "STATE_REGISTRATION_CERTIFICATE",
          "certificate_number": "321",
          "certificate_date": "2021-07-07"
        }
      ]
    },
    {
      "uit_code": "010463003569131621eSyEMozA3oJjP2406401"
    },
    {
      "uitu_code": "00807602215iqaOR"
    }
  ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

document_num

string

Номер первичного документа

Длина значения: от 1 до 255 символов включительно

document_date

string

Дата первичного документа

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm

receiver_inn

string

ИНН получателя

Получателем является участник оборота товаров РФ

receiver

string

Наименование получателя

Длина значения: от 1 до 255 символов включительно

sender_inn

string

ИНН отправителя или его аналог в государстве-члене ЕАЭС

Под отправителем понимается Оператор государства-члена ЕАЭС. Возможные значения:

100083608 — Республика Беларусь;
02284645 — Республика Армения;
941240000193 — Республика Казахстан;
00406200910056 — Кыргызская Республика.

Для товарной группы «Упакованная вода» допустимы значения: «100083608» и «02284645».

Для товарных групп «Корма для животных» и «Косметика, бытовая химия и товары личной гигиены» допустимы значения: «100083608» и «00406200910056».

Для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Игры и игрушки для детей», «Консервированная продукция», «Медицинские изделия», «Морепродукты», «Моторные масла», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы» допустимо значение: «100083608»

sender

string

Наименование отправителя (Оператора государства-члена ЕАЭС)

Длина значения: от 1 до 255 символов включительно. Возможные значения:

РУП Издательство Белбланкавыд — Республика Беларусь (для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Морепродукты», «Моторные масла», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы»);
ЦРПТ-Армения — Республика Армения (для товарной группы «Упакованная вода»);
ЗАО «Альфа Телеком» — Кыргызская Республика (для товарных групп «Корма для животных» и «Косметика, бытовая химия и товары личной гигиены»)

exporter_taxpayer_id

string

Уникальный идентификатор экспортёра в национальной системе учёта налогоплательщиков

Длина значения: 8/9/12/14 цифр.

Для товарной группы «Упакованная вода» при отправке документа от Оператора Республике Беларусь допустимо указывать только учётный номер плательщика

exporter_name

string

Наименование экспортёра

Длина значения: от 1 до 255 символов включительно

request_type

string

Тип запроса (документа)

Возможное значение: «SHIPMENT» («Отгрузка»)

release_method

string

Способ ввода товара в оборот

Возможное значение: «CROSSBORDER» («Ввезён из стран ЕАЭС»)

transfer_date

string

Дата и время отгрузки

Формат: 2020-01-14T00:00:00.000Z

products

array

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

*uit_code

string

Передаваемый КИ

Обязательный, если не указан «uitu_code».

Требования к кодам:

в карточке товара в НКМТ «goodTurnFlag» («Признак готовности товара к обороту») и «goodMarkFlag» («Признак готовности к маркировке») = true;
статус «APPLIED» («Нанесён»), особое состояние отсутствует;
тип эмиссии «CROSSBORDER» («Ввезён из стран ЕАЭС»).

Максимальное количество кодов в одном документе - 30 000.

Товарная группа должна совпадать со значением параметра «pg» («Товарная группа»), указанном в запросе

*uitu_code

string

Передаваемый КИТУ

Обязательный, если не указан «uit_code».

Требование к КИТУ: статус не равен «DISAGGREGATION» («Расформирован»).

Максимальное количество кодов в одном документе - 30 000.

Товарная группа должна совпадать со значением параметра «pg» («Товарная группа»), указанном в запросе

*product_cost

decimal

Цена за единицу

Длина значения: от 0 до 17 цифр включительно. Диапазон: от 0 до 99999999999999999 включительно.

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

*product_tax

decimal

Сумма НДС

Сумма НДС указывается в копейках. Значение не может быть отрицательным, должно быть строго меньше «product_cost».

Длина значения: от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение «0».

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

*expiration_date

string

Дата истечения срока годности

Обязательный для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Ветеринарные препараты», «Консервированная продукция», «Корма для животных», «Морепродукты», «Моторные масла», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище». Может быть заполнен для товарной группы «Упакованная вода».

Для других товарных групп игнорируется при обработке.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

*production_date

string

Дата производства

Обязательный для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Морепродукты», «Моторные масла», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище». Может быть заполнен для товарной группы «Упакованная вода».

Для других товарных групп игнорируется при обработке.

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

*batch_number

string

Номер серии товара

Для товарной группы «Ветеринарные препараты» значение не более 30 символов, для товарной группы «Медицинские изделия» значение не более 49 символов с учётом пробелов: цифры, буквы (латиница, кириллица), спецсимволы (/ . , -)

*part_number

string

Номер партии товара

Обязательный для товарной группы «Медицинские изделия», если не указаны «batch_number» («Номер серии товара») и «factory_serial_number» («Заводской серийный номер»). Значение не более 49 символов с учётом пробелов (цифры, буквы (латиница, кириллица), спецсимволы (/ . , -).

Для остальных товарных групп — необязательный

*factory_serial_number

string

Заводской серийный номер

Для остальных товарных групп — необязательный

*product_weight

integer

Переменный вес продукта (в граммах)

Обязательный для товарных групп «Корма для животных» и «Морепродукты», если в карточке товара в НКМТ «isVarQuantity» («Товар с переменным количеством») = true. Для остальных товарных групп — необязательный. Для товаров без переменного количества параметр должен строго отсутствовать.

Диапазон значений: от 1 до 999999 включительно

*variable_expiration

array of objects

Информация о вариативном сроке годности

Может быть заполнен для товарной группы «Растительные масла»

**id

string

Идентификатор условий хранения

Обязательный, если указан параметр «date»

**date

string

Дата истечения срока годности для идентификатора условий хранения

Обязательный, если указан параметр «id».

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке

*certificate_document_data

array of objects

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

**certificate_type

string

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

Обязательный для товарных групп «Ветеринарные препараты» и «Медицинские изделия» (за исключением кодов ТН ВЭД ЕАЭС: 9021101000, 9021399000, 9021909009).

Для товарной группы «Медицинские изделия» необходимо указывать вид разрешительного документа «Регистрационное удостоверение» (REGISTRATION_CERTIFICATE).

Строго не указан для товарной группы «Специализированная пищевая продукция и БАД к пище». Если указан «certificate_type», то обязательны «certificate_number» и «certificate_date».

Возможные значения см. в разделе «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

См. комментарий к параметру «certificate_type».

Формат: значение должно соответствовать регулярному выражению

**certificate_date

string

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

См. комментарий к параметру «certificate_type».

Формат:

dd.MM.yyyy;
yyyy-MM-dd;
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy HH:mm.

Указание времени допускается, но игнорируется при обработке.

*children

array of objects

Массив, содержащий список вложенных КИ

Рекурсивный элемент, содержащий те же параметры, что и массив «products»

*alco_content

decimal

Фактическое содержание этилового спирта

число до 3 цифр в целой части и до 1 символа в дробной части (разделитель точка, дробная часть опциональна);
значение в диапазоне от 0 (0.0) до 100 (100.0) включительно.

Если этиловый спирт отсутствует, указывается значение «0»

4.2.1.3. Отгрузка из ЕАЭС (ОСУ)

Создание документа доступно только для товарной группы «Молочная продукция» и формируется экспортёром из Республики Беларусь при отгрузке маркированной продукции на территории Российской Федерации. Документ доступен только Оператору Республики Беларусь.

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

Тип

Описание

EAS_GTIN_CROSSBORDER_IMPORT

Отгрузка из ЕАЭС (ОСУ). JSON (MANUAL)

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

{
   "document_num":"777777777",
   "document_date":"2021-10-10T00:00:00.000Z",
   "receiver_inn":"5555555555",
   "receiver":"Наименование получателя в РФ",
   "sender_inn":"000000000",
   "sender":"Наименование Оператора ЕАЭС",
   "exporter_taxpayer_id":"4444444444",
   "exporter_name":"Наименование экспортёра в ЕАЭС",
   "exporter_gln": "4814130900002",
   "transfer_date":"2021-10-10T00:00:00.000Z",
   "products":[
      {
         "gtin":"04611111111111",
         "vsd_number":"0DDA-0D50-FAEA-00DD-B00D-0DCC-AC00-1111",
         "cis_quantity":10000000,
         "group_quantity":500,
         "certificate_document_data":[
            {
               "certificate_type":"CONFORMITY_CERTIFICATE",
               "certificate_number":"123",
               "certificate_date":"2021-10-10"
            },
            {
               "certificate_type":"STATE_REGISTRATION_CERTIFICATE",
               "certificate_number":"321",
               "certificate_date":"2021-10-10"
            }
         ]
      },
      {
         "gtin":"04622222222222",
         "vsd_number":"0DDA-0D50-FAEA-00DD-B00D-0DCC-AC00-2222",
         "cis_quantity":10000000,
         "group_quantity":700
      },
      {
         "gtin":"04633333333333",
         "vsd_number":"0DDA-0D50-FAEA-00DD-B00D-0DCC-AC00-3333",
         "cis_quantity":10000000
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

document_num

string

Номер первичного документа

Длина значения: от 1 до 255 символов включительно

document_date

string

Дата первичного документа

Допустимые форматы:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

receiver_inn

string

ИНН получателя в РФ

receiver

string

Наименование получателя в РФ

Длина значения: от 1 до 255 символов включительно

sender_inn

string

Идентификатор Оператора ЕАЭС

Возможное значение: 100083608 (Республика Беларусь)

sender

string

Наименование Оператора ЕАЭС

Возможное значение: «РУП «Издательство «Белбланкавыд»»» (Республика Беларусь)

exporter_taxpayer_id

string

ИНН (или аналог) экспортёра в ЕАЭС

Длина значения: 8/9/12/14 цифр

exporter_name

string

Наименование экспортёра в ЕАЭС

Длина значения: от 1 до 255 символов включительно

exporter_gln

string

Глобальный номер места нахождения получателя (GLN)

transfer_date

string (date-time)

Дата отгрузки товара

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd

products

array of objects

Массив передаваемых кодов

Должна быть указана хотя бы одна запись списка. Массив передаваемых количество позиций с указанием «gtin» («Код товара») товара не должно превышать 1 000

*gtin

string

Код товара

Требования, предъявляемые к коду товара:

пара значений параметров «gtin» («Код товара») и «vsd_number» («Идентификатор ВСД») должна быть уникальна внутри массива «products» («Массив передаваемых кодов»). При этом один и тот же номер ВСД не должен повторяться для разных кодов товаров;
товарная группа должна совпадать со значением параметра «pg» («Товарная группа»), указанном в запросе;
код товара не принадлежит диапазону 0290 — 0299

*vsd_number

string

Идентификатор ВСД

Номер первого транспортного ВСД по данному коду товара. Первый транспортный ВСД формируется производителем молочной продукции для её дальнейшей реализации. Если признак подконтрольности ВСД в карточке товара в НКМТ не указан, то параметр строго не заполнен.

Требования, предъявляемые к идентификатору ВСД:

пара значений параметров «gtin» («Код товара») и «vsd_number» («Идентификатор ВСД») должна быть уникальна внутри массива «products» («Массив передаваемых кодов»). При этом один и тот же номер ВСД не должен повторяться для разных кодов товаров;
длина значения: от 36 до 39 символов включительно. Формат:

[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12};
[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}

*cis_quantity

integer

Количество потребительских упаковок

Количество товара. Целое число не менее 1 и не более 1 000 000

*group_quantity

integer

Количество групповых упаковок

Количество передаваемых КИГУ по данному коду товара. Целое число не менее 1 и не более 1 000 000

*product_cost

decimal

Цена за единицу с учётом НДС

Цена с учётом НДС единицы товара (с нанесенным КИ) указывается в валюте Оператора принимающего сведения (если сделка облагается НДС). Значение не может быть отрицательным, должно быть строго больше «product_tax» («Сумма НДС»), длина числового значения от 0 до 17 цифр включительно. Диапазон значений: от 0 до 99999999999999999 включительно.

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

*product_tax

decimal

Сумма НДС

Сумма НДС указывается в копейках. Значение не может быть отрицательным, должно быть строго меньше «product_cost» («Цена за единицу с учётом НДС»), длина числового значения от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение «0»

*weight

integer

Совокупный вес продукции

Указывается общий вес всей позиции в граммах — только целое число в диапазоне от 1 до 999999999

*certificate_document_data

array of objects

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

Значения указываются в параметрах «certificate_document» («Вид документа, подтверждающего соответствие»), «certificate_document_number» («Номер документа, подтверждающего соответствие»), «certificate_document_date» («Дата документа, подтверждающего соответствие»). Одновременно должны быть заполнены все три параметра массива либо все три не заполнены

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа разрешительной документации

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string date

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

Формат:

yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd.

4.2.1.4. Отмена отгрузки из ЕАЭС

Документ доступен только Операторам стран-членов ЕАЭС для товарных групп «Антисептики и дезинфицирующие средства», «Бакалейная продукция», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Игры и игрушки для детей», «Консервированная продукция», «Корма для животных», «Косметика, бытовая химия и товары личной гигиены», «Медицинские изделия», «Молочная продукция» (при отгрузке с признанием КИ в разрезе экземплярного учёта), «Морепродукты», «Моторные масла», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Сладости и кондитерские изделия», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище», «Строительные материалы», «Упакованная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые».

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

Тип

Описание

LP_CANCEL_SHIPMENT_CROSSBORDER

Отмена отгрузки из ЕАЭС. JSON (MANUAL)

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН отправителя или его аналог в государстве-члене ЕАЭС

Под отправителем понимается Оператор государства-члена ЕАЭС

shipment_number

string

Номер отменяемого документа отгрузки

4.2.2. Приёмка

4.2.2.1. Приёмка в ЕАЭС

Документ доступен для товарных групп «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Моторные масла», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Упакованная вода», «Шины и покрышки пневматические резиновые новые». Данный документ формируется в ответ на документ «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT). Отправка документа для участников оборота товаров РФ недоступна.

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

Тип

Описание

EAS_CROSSBORDER_EXPORT_ACCEPTANCE

Приёмка в ЕАЭС. JSON (MANUAL)

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

{
    "sender_inn": "100083608",
    "sender": "Издательство \"Белбланкавыд\"",
    "receiver_inn": "7777777777",
    "receiver": "УОТ-получатель Республики Беларусь",
    "exporter_taxpayer_id": "5555555555",
    "document_num": "15",
    "document_date": "2021-10-22T11:27:09.255Z",
    "release_order_number": "00000000-0000-0000-0000-000000000000",
    "acceptance_date": "2021-10-17T10:01:19.505Z",
    "transfer_date": "2021-10-05T00:00:00.000Z",
    "products": [
        {
            "cis": "0100000000000000211111111111111",
            "product_cost": 160,
            "product_tax": 16,
            "certificate_document_data": [
                {
                    "certificate_type": "CONFORMITY_CERTIFICATE",
                    "certificate_number": "123",
                    "certificate_date": "2021-07-01T00:00:00.000Z"
                },
                {
                    "certificate_type": "CONFORMITY_DECLARATION",
                    "certificate_number": "321",
                    "certificate_date": "2021-07-02T00:00:00.000Z"
                }
            ],
            "accepted": true
        },
        {
            "cis": "0100000000000000213333333333333",
            "product_cost": 17,
            "product_tax": 0,
            "markable": false
        },
        {
            "cis": "0100000000000000214444444444444",
            "accepted": false
        }
    ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

sender_inn

string

Идентификатор отправителя

Идентификатор Оператора ЕАЭС.

Возможные значения:

«100083608» (Республика Беларусь);
«02284645» (Республика Армения);
«941240000193» (Республика Казахстан);
«00406200910056» (Кыргызская Республика)

sender

string

Наименование отправителя

Наименование Оператора ЕАЭС.

Возможные значения:

receiver_inn

string

Идентификатор получателя

Заполняется на основании значения в параметре «receiver_inn» в «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT)

receiver

string

Наименование получателя

Заполняется на основании значения в параметре «receiver» в «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT)

exporter_taxpayer_id

string

Идентификатор экспортёра в РФ

ИНН участника оборота в РФ. Заполняется на основании значения из в «sender_inn» в «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT)

release_order_number

string

Номер документа отгрузки

Указывается идентификатор исходного документа «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT)

acceptance_date

string (date-time)

Дата и время приёмки товара

Заполняется на основании данных обработки приёмки в Информационной системе Оператора ЕАЭС

document_num

string

Номер первичного документа

document_date

string

Дата первичного документа

transfer_date

string (date-time)

Дата отгрузки

products

array of objects

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

*cis

string

Передаваемый КИ

Значение соответствует КИ, указанному в документе «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT).

Признанные коды идентификации хранятся в базах данных ГИС МТ без кодов проверки.

Максимальное количество КИ в одном документе - 30 000

*product_cost

decimal

Цена за единицу

*product_tax

decimal

Сумма НДС

Сумма НДС указывается в копейках. Значение не может быть отрицательным, строго меньше «product_cost» («Цена за единицу»), длина числового значения от 0 до 17 цифр включительно. Если сделка не облагается НДС, то указывается значение «0»

*certificate_document_data

array of objects

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

**certificate_type

string

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

См. «Справочник «Виды разрешительной документации»»

**certificate_number

string

Номер документа, подтверждающего соответствие

Формат: значение должно соответствовать регулярному выражению (подробнее см. в памятке)

**certificate_date

string

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

Формат: 2020-01-14T00:00:00.000Z

*accepted

boolean

Признак того, что товар принят или не принят

Возможные значения:

«true» — товар принят = вывод из оборота;
«false» — товар не принят = возврат в оборот. Обязательный, если «markable» («Признак обязательной маркировки в государстве-члене ЕАЭС») = «true» или отсутствует. Необязательный, если «markable» («Признак обязательной маркировки в государстве-члене ЕАЭС») = «false»

*markable

boolean

Признак обязательной маркировки в государстве-члене ЕАЭС

Возможные значения:

«true» — товар подлежит обязательной маркировке в государстве-члене ЕАЭС (значение по умолчанию);
«false» — товар не подлежит обязательной маркировке в государстве-члене ЕАЭС. Если «markable» («Признак обязательной маркировки в государстве-члене ЕАЭС») = «true», то параметр «accepted» («Признак того, что товар принят или не принят») обязательный;
Если «markable» («Признак обязательной маркировки в государстве-члене ЕАЭС») = «false», то параметр «accepted» («Признак того, что товар принят или не принят») необязательный;
Если параметр «markable» («Признак обязательной маркировки в государстве-члене ЕАЭС») отсутствует, то параметр «accepted» («Признак того, что товар принят или не принят») обязательный

4.2.2.2. Приёмка в ЕАЭС (ОСУ)

Документ доступен только Оператору Республики Беларусь и формируется при приёмке маркированной продукции на территории Республики Беларусь в ответ на документ «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT). Подача сведений в документе осуществляется между импортёром из Республики Беларусь и экспортёром из Российской Федерации по объёмно-сортовым показателям: в документе указывается количество принимаемых товаров и их коды товаров. Создание документа доступно только для товарной группы «Молочная продукция».

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

Тип

Описание

EAS_GTIN_CROSSBORDER_EXPORT_ACCEPTANCE

Приёмка в ЕАЭС (ОСУ). JSON (MANUAL)

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

Параметр

Тип

Обяз.

Описание

Комментарий

sender_inn

string

Идентификатор Оператора Республики Беларусь

sender

string

Наименование Оператора Республики Беларусь

receiver_inn

string

ИНН (или аналог) получателя в стране ЕАЭС

Значение соответствует значению параметра «receiver_inn» («ИНН (или аналог) получателя в стране ЕАЭС») в документе «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT)

receiver

string

Наименование получателя в стране ЕАЭС

Значение соответствует значению параметра «receiver_name» («Наименование получателя в стране ЕАЭС») в документе «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT)

exporter_taxpayer_id

string

Идентификатор экспортёра (ИНН участника в РФ)

Значение соответствует значению параметра «exporter_inn» («ИНН участника оборота (заявителя)») в документе «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT)

document_num

string

Номер первичного документа

document_date

string

Дата первичного документа

release_order_number

string

Номер документа отгрузки

Идентификатор исходного документа «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT)

acceptance_date

string

Дата приёмки

transfer_date

string date-time

Дата отгрузки

products

array of objects

Массив, содержащий список передаваемых кодов товара

*gtin

string

Код товара (GTIN)

Значение соответствует коду товара, указанному в документе «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT).

Максимальное количество кодов товара в одном документе - 1 000

*cis_quantity

integer

Количество потребительских упаковок

Количество передаваемых КИ по данному коду товара. Формат: целое число не менее 0 и не более значения, указанного в документе «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT), для данного «gtin» («Код товара (GTIN)»). Значение «0» указывается в случае, если товар не принят. Для успешно обработанного документа приёмки, независимо от значения параметра «cis_quantity» («Количество потребительских упаковок»), связанный документ отгрузки меняет статус на «Принят»

*group_quantity

integer

Количество групповых упаковок

Количество передаваемых КИГУ по данному коду товара. Формат: целое число не менее 0 и не более значения, указанного в документе «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT), для данного «gtin» («Код товара (GTIN)»). Значение «0» указывается в случае, если товар не принят

*vsd_number

string

Идентификатор ВСД

Идентификатор первого транспортного ветеринарного сопроводительного документа по данному коду товара

*product_cost

decimal

Цена за единицу

*product_tax

decimal

Сумма НДС

*certificate_document_data

array of objects

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

**certificate_type

string

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

**certificate_number

string

Номер документа, подтверждающего соответствие

**certificate_date

string

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

4.2.2.3. Автоввод в оборот при импорте с ФТС

Документ доступен для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» и формируется автоматически после получения ГИС МТ уведомления «Рассылка универсальных сведений из «ЕАИС ТО» о выпущенных товарах» от ФТС.

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

Если документ «Автоввод в оборот при импорте с ФТС» (LP_FTS_INTRODUCE_AUTO) обработан с ошибкой, требуется подать сведения о вводе товаров в оборот самостоятельно с помощью документа «Ввод в оборот. Импорт с ФТС» (LP_FTS_INTRODUCE).

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

Тип

Описание

LP_FTS_INTRODUCE_AUTO

Автоввод в оборот при импорте с ФТС. JSON (MANUAL)

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

{
   "info":{
      "requestId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status":"MESSAGE_PROCESSED",
      "direction":"FROM_SMEV",
      "urn":"urn://x-artefacts-ftsBroadcastGoodsReleaseInfoMultipurpose/root/1.0.0",
      "urnVersion":"1.0.0",
      "declarationNumber":"11111111\\22222222\\33333333"
   },
   "content":{
      "documentId":"211bd1e1-3e73-41db-a8d3-dc111aee1111",
      "refDocumentId":"6ba7b810-9dad-11d1-80b4-00c00fd111c1",
      "innSign":"f47ac10b-58cc-4372-a567-0e01b1c1d111",
      "mcdId":"550e8400-e29b-41d4-a716-111111111111",
      "reqDate":"2025-08-15T11:47:55",
      "goodsRelease":{
         "customsProcedure":"ИМ",
         "customsModeCode":"40",
         "declarationKind":"123",
         "gtdNumber":{
            "customsCode":"10131010",
            "registrationDate":"2025-06-14",
            "gtdNumber":"5252888"
         },
         "declarant":{
            "inn":"1111111111",
            "organizationName":"ООО <ОРГАНИЗАЦИЯ>",
            "countryA2Code":"112",
            "countryName":"РОССИЯ",
            "taxpayerId":{
               "uitnCode":"KZ123456789012",
               "countryCode":"112"
            },
            "kpp":"111111111"
         },
         "consignee":{
            "inn":"1111111111",
            "organizationName":"Sender",
            "countryA2Code":"112",
            "countryName":"РОССИЯ",
            "taxpayerId":{
               "uitnCode":"KZ123456789012",
               "countryCode":"112"
            }
         },
         "consignor":{
            "inn":"1111111111",
            "organizationName":"ООО <ОРГАНИЗАЦИЯ2>",
            "countryA2Code":"112",
            "countryName":"РОССИЯ",
            "taxpayerId":{
               "uitnCode":"KZ123456789012",
               "countryCode":"112"
            }
         },
         "goods":[
            {
               "goodsNumeric":1,
               "goodsTnvedCode":"220600",
               "invoicedCurrencyCode":"EUR",
               "invoicedCost":11345.51,
               "customsCost":1022363.19,
               "statisticalCost":12639.2,
               "originCountryCode":"PL",
               "supplementaryGoodsQuantity":{
                  "goodsQuantity":60,
                  "measureUnitQualifierName":" ШТ",
                  "measureUnitQualifierCode":"796"
               },
               "goodsDescription":[
                  "НАИМЕНОВАНИЕ"
               ],
               "grossWeightQuantity":908.16,
               "netWeightQuantity":908.16,
               "cimQuantity":0,
               "identificationMeansDetails":[
                  {
                     "аggregationKindCode":"0",
                     "identificationMeansItemDetails":[
                        {
                           "identificationMeansKindCode":"301",
                           "identificationMeansDataUnitDetails":[
                              {
                                 "aiId":"111",
                                 "identifacationMeansUnitCharacterValueId":"1111111111974625215-uBmvFGhZtOh"
                              }
                           ]
                        }
                     ]
                  }
               ],
               "permitDoc":[
                  {
                     "prDocumentName":"СЕРТИФИКАТ СООТВЕТСТВИЯ ТЕХ. РЕГЛАМЕНТА ЕАЭС (ТС)",
                     "prDocumentNumber":"ЕАЭС RU С-JP.НХ27.В.11111/11",
                     "prDocumentDate":"2024-02-20",
                     "docKindCode":"01401"
                  }
               ],
               "drug":{
                  "prDocumentName":"ЛЕКАРСТВО",
                  "prDocumentNumber":"СПЕЦ.111/2025",
                  "prDocumentDate":"2025-05-05",
                  "docKindCode":"10051"
               },
               "excise":{
                  "excise":726549.74
               },
               "vat":1598409.43,
               "decisionCode":"10",
               "dateInf":"2025-06-14"
            }
         ],
         "decisionCode":"10",
         "dateInf":"2025-06-14",
         "dataSved":"2025-06-14"
      },
      "codeResult":"OK",
      "result":"Сообщение успешно обработано",
      "documentModeId":"1111111E"
   }
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

info

object

Метаданные документа

*requestId

string

Идентификатор записи о запросе в БД

Формат: GUID

*status

string

Статус запроса

Всегда «MESSAGE_PROCESSED» — сообщение запроса / ответа успешно обработано

*direction

string

Направление запроса

Всегда «FROM_SMEV» — запрос получен от СМЭВ (входящий)

*urn

string

Пространство имён URI (URN)

Всегда «FTS_BROADCAST_GOODS_RELEASE_INFO_MULTIPURPOSE» — рассылка универсальных сведений из «ЕАИС ТО» о выпущенных товарах

*urnVersion

string

Версия вида сведений

Всегда «1.0.0»

*declarationNumber

string

Регистрационный номер декларации на товары

content

object

Данные декларации на товары, полученной от ФТС

*documentId

string

Уникальный идентификатор документа

Формат: GUID

*refDocumentId

string

Уникальный идентификатор исходного документа

Формат: GUID

*innSign

string

ИНН владельца МЧД

Формат: от 10 до 12 цифр

*mcdId

string

Единый регистрационный номер доверенности в формате МЧД

Формат: GUID

*reqDate

string

Время и дата запроса / ответа

Формат: YYYY-MM-DDThh:mm:ss

*goodsRelease

object

Выпущенные ДТ

**customsProcedure

string

Направление перемещения

Возможные значения:

«ИМ» — импорт;
«ЭК» — экспорт

**customsModeCode

string

Код таможенной процедуры

**declarationKind

string

Код особенности декларирования товаров

**gtdNumber

object

Регистрационный номер ДТ

***customsCode

string

Код таможенного органа, зарегистрировавшего документ

2, 5 или 8 цифр, формат:
[0-9]{2};
[0-9]{5};
[0-9]{8}.

Пример: 10131010

***registrationDate

string

Дата регистрации документа

Формат: YYYY-MM-DD

***gtdNumber

string

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

Формат: от 1 до 7 цифр

**declarant

object

Декларант

***kpp

string

Код причины постановки на учет

Формат: 9 цифр

***inn

string

ИНН организации

Формат: от 10 до 12 цифр

***organizationName

string

Наименование организации

Формат: до 150 символов

***countryA2Code

string

Код страны

Формат: 3 цифры.

Пример: 112 — Республика Беларусь

***countryName

string

Название страны

Формат: до 40 символов

***taxpayerId

object

Идентификатор налогоплательщика (не РФ)

****uitnCode

string

Универсальный идентификационный таможенный номер

Формат: до 40 символов

****countryCode

string

Кодовое обозначение страны, выдавшей идентификатор

Формат: 3 цифры.

Пример: 112 — Республика Беларусь

**consignee

object

Получатель

***inn

string

ИНН организации

Формат: от 10 до 12 цифр

***organizationName

string

Наименование организации

***countryA2Code

string

Код страны

***countryName

string

Название страны

***taxpayerId

object

Идентификатор налогоплательщика (не РФ)

****uitnCode

string

Универсальный идентификационный таможенный номер

Формат: не более 40 символов

****countryCode

string

Кодовое обозначение страны, выдавшей идентификатор

Формат: 3 цифры.

Пример: 112 — Республика Беларусь

**consignor

object

Отправитель

***inn

string

ИНН организации

Формат: от 10 до 12 цифр

***organizationName

string

Наименование организации

***countryA2Code

string

Код страны

***countryName

string

Название страны

***taxpayerId

object

Идентификатор налогоплательщика (не РФ)

****uitnCode

string

Универсальный идентификационный таможенный номер

Формат: не более 40 символов

****countryCode

string

Кодовое обозначение страны, выдавшей идентификатор

Формат: 3 цифры.

Пример: 112 — Республика Беларусь

**goods

array of objects

Товары ДТ

***goodsNumeric

integer

Номер товара по ДТ

Формат: от 1 до 3 цифр

***goodsTnvedCode

integer

Код товара по ТН ВЭД ЕАЭС

Формат: 4, 6, 8 или 10 цифр:

для ДТ / КДТ: 4 или 10 цифр;
для ТД: 6, 8 или 10 цифр

***invoicedCurrencyCode

string

Код валюты (по классификатору)

***invoicedCost

decimal

Цена / стоимость товара

***customsCost

decimal

Таможенная стоимость

***statisticalCost

decimal

Статистическая стоимость

***originCountryCode

string

Код страны происхождения

Формат: 3 цифры.

Пример: 112 — Республика Беларусь

***supplementaryGoodsQuantity

object

Количество в дополнительной единице измерения

****goodsQuantity

decimal

Количество товара в единице измерения

Формат: до 24 цифр. 6 знаков после запятой

****measureUnitQualifierName

string

Условное обозначение единицы измерения

Формат: до 50 символов

****measureUnitQualifierCode

string

Код единицы измерения в соответствии с единицами измерения, применяемыми в ТН ВЭД ЕАЭС

Формат: от 1 до 4 символов

***goodsDescription

array of strings

Наименование товара (до 4 строк)

Формат: до 250 символов

***grossWeightQuantity

decimal

Вес брутто

(кг, гр)

***netWeightQuantity

decimal

Вес нетто

(кг, гр)

***cimQuantity

integer

Количество кодов идентификации

***identificationMeansDetails

array of objects

Сведения о средствах идентификации

****аggregationKindCode

string

Код уровня маркировки

****identificationMeansItemDetails

array of objects

Сведения о коде идентификации

*****identificationMeansKindCode

string

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

*****identificationMeansDataUnitDetails

array of objects

Блоки информации, содержащиеся в коде идентификации

******aiId

string

Идентификатор

Формат: \d{2,4}:

\d - любая цифра (0-9);
{2,4} - от 2 до 4 символов

Пример: 123

******identifacationMeansUnitCharacterValueId

string

Значение блока информации (символьное представление)

***permitDoc

array of objects

Сведения о разрешительных документах

****prDocumentName

string

Наименование документа

****prDocumentNumber

string

Номер документа

****prDocumentDate

string

Дата документа

Формат: YYYY-MM-DD

****docKindCode

string

Код вида документа по классификатору ФТС

***drug

object

Сведения о лекарственных средствах

****prDocumentName

string

Наименование документа

****prDocumentNumber

string

Номер документа

****prDocumentDate

string

Дата документа

Формат: YYYY-MM-DD

****docKindCode

string

Код вида документа по классификатору ФТС

***excise

object

Сведения об акцизных товарах

****excise

decimal

Сумма уплаченного акциза в рублях

Формат: 20 цифр, из них до 2 знаков после запятой

***vat

decimal

Сумма уплаченного НДС

***decisionCode

string

Код решения таможенного органа

***dateInf

string

Дата решения

Формат: YYYY-MM-DD

**decisionCode

string

Код решения таможенного органа

**dateInf

string

Дата решения

Формат: YYYY-MM-DD

**dateSved

string

Дата внесения сведений

Формат: YYYY-MM-DD

*codeResult

string

Код обработки запроса

*result

string

Описание результатов обработки

*documentModeId

string

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

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

4.3.1. Формирование упаковки («Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»)

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

Важно

В документе коды идентификации указываются в нормализованном виде (без скобок, обрамляющих идентификаторы применения)

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

Тип

Описание

AGGREGATION_DOCUMENT

Формирования упаковки. JSON

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

URL: /documents/aggregation/create

Метод: POST

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

curl -X POST "<url стенда>/documents/aggregation/create"
-H "X-Signature: <string>"
-H "Content-Type: multipart/form-data"
-H "accept: application/json"
-H "Authorization: Bearer <Токен>"
--form "jsonFile=@"/C:/Users/79278/Desktop/XXX.json"

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

Параметр

Тип

Обяз.

Описание

Комментарий

X-Signature

string

Закодированная откреплённая подпись в формате base64

jsonFile

file

Параметр тела запроса в формате * .json

Прикреплённый документ подачи сведений о формировании упаковки в формате * .json

Пример документа в формате * .json:

{
   "participantId":"7777777777",
   "productionLineId":"123456",
   "productionDate":1625127082533,
   "productionOrderId":"123456789",
   "aggregationUnits":[
      {
         "aggregatedItemsCount":2,
         "aggregationType":"AGGREGATION",
         "aggregationUnitCapacity":10,
         "sntins":[
            "00000046210654vS<Vyzh"
         ],
         "unitSerialNumber":"010000004621065421WB4KBn-"
      }
   ]
}

Параметры документа в формате * .json:

Параметр

Тип

Обяз.

Описание

Комментарий

participantId

string

ИНН участника оборота товаров

dateDoc

long

Дата и время формирования документа в формате UNIX в миллисекундах

productionDate

string

Дата производства

productionLineId

string

ID производственной линии

aggregationUnits

array[string]

Список формируемых агрегатов

*aggregationType

string

Код типа агрегации

Возможные значения:
«AGGREGATION» («Агрегация»);
«SETS_AGGREGATION» («Формирование набора»)

*unitSerialNumber

string

Код идентификации агрегата

Указывается только нормализованное значение КИ (без скобок, обрамляющих идентификаторы применения).

КИ или КИТУ может содержать от 18 до 74 символов включительно: цифры, буквы латинского алфавита, спецсимволы (A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !). Рекомендуемый формат кода идентификации:

групповой упаковки в соответствии c требованиями Постановления Правительства РФ № 224 от 28.02.2019 «Об утверждении Правил маркировки табачной продукции средствами идентификации и особенностях внедрения государственной информационной системы мониторинга за оборотом товаров, подлежащих обязательной маркировке средствами идентификации, в отношении табачной продукции»;
транспортной упаковки (SSCC — длина 20 цифровых символов, включающий идентификатор применения GS1 AI 00);
транспортной упаковки формата, определяемого участником оборота товаров (длина от 34 до 74 символов, содержащий цифры и буквы латинского алфавита, а также спецсимволы A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : . < = > ? !);

для типа упаковки «Набор» используется формат транспортной упаковки (короба) (цифра расширения — «0» в номере SSCC).

КИТУ:

должен быть уникален в Системе маркировки, независимо от ИНН, товарной группы или статуса;
не должен соответствовать маске 02[gtin]37[count], где «gtin» — <код товара> (14 цифр), «count» — количество товара в единице измерения упаковки (от 1 до 8 цифр).

Допустимые статусы групповой упаковки и набора:

«APPLIED» («Нанесён»);
«INTRODUCED» («В обороте»).

Особое состояние у кода должно отсутствовать.

Для успешного формирования набора (доступно только для товарной группы «Никотиносодержащая продукция»), при заказе КМ на набор должен быть указан код товара набора из НКМТ, иначе документ формирования упаковки будет обработан с ошибкой

*aggregatedItemsCount

integer

Агрегируемое количество КИ

*aggregationUnitCapacity

integer

Ёмкость агрегата (кол-во вложенных КИ)

*sntins

array[string]

Список КИ, входящих в состав агрегата

Указывается только нормализованное значение КИ (без скобок, обрамляющих идентификаторы применения).

Статусы КИ, входящих в состав агрегата, должны быть идентичны. Допустимые статусы КИ:

«APPLIED» («Нанесён»);
«INTRODUCED» («В обороте»).

Особое состояние у кода должно отсутствовать.

Состав КИН (доступен только для товарной группы «Никотиносодержащая продукция») должен полностью соответствовать описанию в карточке набора в НКМТ:

коды товаров КИ равны кодам товаров, указанным в карточке кода набора в НКМТ;
количество КИ с одинаковыми кодами товаров равно количеству этих кодов товаров в карточке набора в НКМТ.

Отправитель документа должен являться владельцем карточки набора в НКМТ или иметь доступ к ней по механизму настройки субаккаунтов

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

Код 200. В случае успеха:
```
{
   "id":"string"
}
```

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

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

ID документа, прошедшего проверку

error_message

string

Текст сообщения об ошибке при обработке запроса

Параметр возвращается при наличии ошибки

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

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

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

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

Метод позволяет получить информацию по КИ / КиЗ, числящихся на участнике оборота товаров по заданным фильтрам. Максимальный лимит кодов в ответе с учётом пагинации 10 000.

Примечание

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

Тип приватности: c токеном авторизации

URL: /api/v4/true-api/cises/search

Метод: POST

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

POST <url стенда>/api/v4/true-api/cises/search
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

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

{
  "filter": {
    "emissionDatePeriod": {
      "from": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "to": "yyyy-MM-ddTHH:mm:ss.SSSZ"
    },
    "applicationDatePeriod": {
      "from": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "to": "yyyy-MM-ddTHH:mm:ss.SSSZ"
    },
    "productionDatePeriod": {
      "from": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "to": "yyyy-MM-ddTHH:mm:ss.SSSZ"
    },
    "introducedDatePeriod": {
      "from": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "to": "yyyy-MM-ddTHH:mm:ss.SSSZ"
    },
    "gtins": [
      "string",
      "string"
    ],
    "producerInns": [
      "string",
      "string"
    ],
    "generalPackageTypes": [
      "string",
      "string"
    ],
    "turnoverTypes": [
      "string",
      "string"
    ],
    "states": [
      {
        "status": "string",
        "statusExt": "string"
      },
      {
        "status": "string"
      },
      {
        "statusExt": "string"
      },
      {
        "status": "string",
        "isStatusExtNull": true
      }
    ],
    "tnVed": "string",
    "tnVed10": "string",
    "emissionTypes": [
      "string",
      "string"
    ],
    "isAggregated": false,
    "productGroups": [
      "string",
      "string"
    ],
    "eliminationReasons": [
      "string",
      "string"
    ],
    "prVetDoc": "string",
    "haveChildren": false,
    "serviceProviderIdPresented": true,
    "serviceProviderTypes": [
      "string",
      "string"
    ],
    "orderIds": [
      "string",
      "string"
    ]
  },
  "pagination": {
    "perPage": 0,
    "lastEmissionDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
    "sgtin": "string",
    "direction": 0
  }
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

filter

object

Параметры фильтрации

Поиск КИ по указанным значениям параметров КИ

*emissionDatePeriod

object

Период эмиссии

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

**from

string (date-time)

Дата эмиссии, от

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ для точной фильтрации по товарным группам с массовым производством

**to

string (date-time)

Дата эмиссии, до

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ для точной фильтрации по товарным группам с массовым производством. Значение данного параметра должно быть не меньше, чем значение параметра «from» («Дата эмиссии, до»)

*applicationDatePeriod

object

Период нанесения

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

**from

string (date-time)

Дата нанесения, от

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ для точной фильтрации по товарным группам с массовым производством

**to

string (date-time)

Дата нанесения, до

*productionDatePeriod

object

Период производства

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

**from

string (date-time)

Дата производства, от

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

**to

string (date-time)

Дата производства, до

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ. Значение данного параметра должно быть не меньше, чем значение параметра «from» («Дата производства, до»)

*introducedDatePeriod

object

Период ввода в оборот

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

**from

string (date-time)

Дата ввода в оборот, от

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

**to

string (date-time)

Дата ввода в оборот, до

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ. Значение данного параметра должно быть не меньше, чем значение параметра «from» («Дата ввода в оборот, до»)

*gtins

array of strings

Список кодов товаров

Не более 1000 кодов товара в массиве

*producerInns

array of strings

Список ИНН производителей

*generalPackageTypes

array of strings

Список видов упаковок

*turnoverTypes

array of strings

Список типов отгрузки

Возможные значения:

«SELLING» — «Продажа / передача товара»;
«CONTRACT» — «Передача по АКС»

*states

array of objects

Список статусов КИ

При заполнении фильтра по статусу КИ и / или по особому состоянию КИ между объектами массива условие «ИЛИ», внутри одного объекта условие «И»

**status

string

Код статуса КИ

Возможные значения см. в разделе «Актуальные статусы» справочника «Статусы КИ»

**statusExt

string

Особое состояние КИ

Возможные значения см. в разделе «Актуальные особые состояния» справочника «Статусы КИ»

**isStatusExtNull

boolean

Признак отсутствия особого состояния КМ

Возможные значения:

«true» — КИ без особого состояния;
«false» — КИ с особым состоянием.

При отсутствии данного параметра, наличие особого состояния КМ проверяется согласно непустому «statusExt» («Особое состояние КИ»)

*tnVed

string

4-значный код ТН ВЭД

*tnVed10

string

10-значный код ТН ВЭД

*emissionTypes

array of strings

Список типов эмиссии

Возможные значения см. в «Справочник «Типы эмиссии КИ»»

*isAggregated

boolean

Состояние КИ в агрегате

Возможные значения:

«true» — КИ упакован (поиск КИ, вложенных в вышестоящую упаковку);
«false» — КИ не упакован (поиск КИ, не вложенных в другие упаковки).

При отсутствии данного параметра выбираются все КИ

*productGroups

array of strings

Список товарных групп

Возможные значения см. в «Справочник «Список поддерживаемых товарных групп»». Должна быть указана хотя бы одна товарная группа. Значение указывается в нижнем регистре

*eliminationReasons

array of strings

Список причин выбытия

Возможные значения см. в «Справочник «Причины выбытия»»

*prVetDoc

string

Идентификатор ВСД

*haveChildren

boolean

Признак обязательного наличия вложенных КИ

Возможные значения:

«true» — поиск КИ с вложенными КИ;
«false» — поиск КИ без вложенных КИ.

При отсутствии данного параметра наличие вложенных КИ не проверяется

*serviceProviderIdPresented

boolean

Признак обязательного наличия регистрационных данных контрагента

Возможные значения:

«true» — только КИ с заполненными регистрационными данными контрагента;
«false» — только КИ с незаполненными регистрационными данными контрагента.

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

*serviceProviderTypes

array of strings

Список типов сервис-провайдеров

Возможные значения:

«CEM» — «Типография»;
«CL» — «Логистический склад»;
«CM» — «Контрактное производство»;
«CA» — «Комиссионная площадка»

*orderIds

array of strings

Список идентификаторов заказа на эмиссию КИ в СУЗ

*partyNumber

string

Номер партии товара

При указании данного параметра поиск будет производиться по этому номеру партии. Если данный параметр не указан, то в ответе вернутся коды с «partyNumber», если в отчёте о нанесении КМ в СУЗ указано соответствующее значение

*mods

array of objects

Массив объектов для поиска МОД

Количество объектов массива не должно превышать 50 (без проверки уникальности)

**kpp

string

КПП МОД

**fiasId

string

Код ФИАС МОД

*manufacturerInns

string

Список ИНН производителей товаров

*importerInns

string

Список ИНН импортёров товара вне ЕАЭС

pagination

object

Параметры пагинации

Обеспечивает постраничный вывод результата поиска КИ

*perPage

integer

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

Значение по умолчанию: 100. Значение параметра не должно превышать 1000

*lastEmissionDate

string (date-time)

Дата эмиссии КИ, с которой требуется начать вывод результата поиска

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*sgtin

string

Идентификационный номер SGTIN (GTIN + индивидуальный серийный номер), с которого требуется начать вывод результата поиска

*direction

integer

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

Возможные значения:

«0» — прямое направление поиска: с использованием сортировки только по «КИ по возрастанию и Дата эмиссии КИ по убыванию»;
«1» — обратное направление поиска: с использованием сортировки только по «КИ по убыванию и Дата эмиссии КИ по возрастанию».

Значение по умолчанию: 0

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

В случае успеха:

{
  "isLastPage": true,
  "result": [
    {
      "sgtin": "string",
      "cis": "string",
      "gtin": "string",
      "producerInn": "string",
      "status": "string",
      "statusExt": "string",
      "emissionDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "applicationDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "productionDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "generalPackageType": "string",
      "ownerInn": "string",
      "tnVed": "string",
      "tnVed10": "string",
      "emissionType": "string",
      "productGroup": "string",
      "haveChildren": false,
      "parent": "string",
      "eliminationReason": "string",
      "expirationDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "prVetDocument": "string",
      "mrp": 0,
      "introducedDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "receiptDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
      "turnoverType": "string",
      "color": "string",
      "productSize": "string",
      "country": "string",
      "inGrayZone": false,
      "serviceProviderId": "string",
      "serviceProviderType": "string",
      "returnType": "string",
      "eliminationReasonOther": "string",
      "modId": "string",
      "productWeight": 0,
      "expiration": [
        {
          "expirationStorageDate": "yyyy-MM-ddTHH:mm:ss.SSSZ",
          "storageConditionId": "string"
        }
      ],
      "emissionCountryCode": 0,
      "exportCountryCode": 0,
      "orderId": "string",
      "operationIntroducedDate": "yyyy-MM-ddTHH:mm:ss.SSSZ"
    }
  ]
}

В случае ошибок:
2.1. Код 200 при отсутствии запрошенных сведений в базе данных:
{ "isLastPage": true, "result": [] }
2.2. Код 400 при неверном формате указанных значений:
{ "error_message":"Ошибка в параметрах запроса <наименование_параметра>" }
2.3. Код 400 при превышении максимально допустимого количества для параметров «gtins» («Список кодов товаров») или «perPage» («Максимальное количество записей на странице результата поиска»):
{ "error_message":"Превышено допустимое количество <наименование_параметра> (1000)" }
2.4. Код 400, если в указанном интервале дат «Дата, от» больше, чем «Дата, до»:
{ "error_message":"Неверно указан интервал дат <наименование_параметра>" }
2.5. Код 400, если не указан обязательный параметр:
{ "error_message":"Не указан обязательный параметр <наименование_параметра>" }
2.6. Код 401 при непройденной авторизации, если в запрос не указан токен:
{ "error_message":"Для доступа к этому ресурсу требуется полная аутентификация. Проверьте токен" }
2.7. Код 401 при непройденной авторизации, если указан невалидный токен:
{ "error_message":"Токен не действителен. Необходимо получить новый токен аутентификации" }
2.8. Код 403, если не подписан договор:
{ "error_message":"Отсутствует действующий договор по <pg>" }
2.9. Код 500: "Внутренняя ошибка сервера".

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

Параметр

Тип

Обяз.

Описание

Комментарий

isLastPage

boolean

Признак последней страницы результата поиска

Возможные значения:

«true» — страница результата поиска является последней;
«false» — страница результата поиска не является последней

result

array of objects

Результат поиска КИ

*sgtin

string

sgtin (GTIN + серийный номер)

*cis

string

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

*gtin

string

Код товара

Непустое значение длиной менее 14 символов дополняется ведущими нулями до 14 символов

*producerInn

string

ИНН производителя

*status

string

Статус КИ

Возможные значения см. в разделе «Актуальные статусы» справочника «Статусы КИ»

*statusExt

string

Особое состояние КИ

Возможные значения см. в разделе «Актуальные особые состояния» справочника «Статусы КИ»

*emissionDate

string (date-time)

Дата эмиссии

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*applicationDate

string (date-time)

Дата нанесения

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*productionDate

string (date-time)

Дата производства

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*generalPackageType

string

Тип упаковки

*ownerInn

string

ИНН владельца товара

При отсутствии ИНН владельца товара передаётся ИНН российского производителя

*tnVed

string

4-значный код ТН ВЭД

*tnVed10

string

10-значный код ТН ВЭД

*emissionType

string

Тип эмиссии

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

*productGroup

string

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

Возможные значения см. в «Справочник «Список поддерживаемых товарных групп»»

*haveChildren

boolean

Признак наличия вложенных КИ

*parent

string

КИ агрегата

*eliminationReason

string

Причина выбытия

Возможные значения см. в «Справочник «Причины выбытия»»

*expirationDate

string (date-time)

Дата истечения срока годности

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*prVetDocument

string

Идентификатор ВСД

*mrp

number

Максимальная цена розничной продажи в копейках

Возвращается при наличии для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция» и «Табачная продукция»

*introducedDate

string (date-time)

Дата ввода в оборот по данным производителя / импортера

Дата полной успешной обработки документа «Ввод в оборот» в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*receiptDate

string (date-time)

Дата вывода из оборота

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*turnoverType

string

Тип отгрузки

Возможные значения:

«SELLING» — «Продажа / передача товара»;
«CONTRACT» — «Передача по АКС»

*color

string

Цвет товара

Возвращается при наличии для товарной группы «Обувные товары»

*productSize

string

Размер в штихмассовой системе

Возвращается при наличии для товарной группы «Обувные товары»

*country

string

Страна производства

*inGrayZone

boolean

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

Возвращается при наличии только для товарной группы «Табачная продукция». Возможные значения:

«true» — в серой зоне;
«false» — не в серой зоне

*serviceProviderId

string

Регистрационные данные контрагента — ЦЭМ

*serviceProviderType

string

Тип сервис-провайдера

Возможные значения:

*returnType

string

Вид возврата

Возможные значения:

«REMOTE_SALE_RETURN» — «Возврат при дистанционном способе продажи»;
«RETAIL_RETURN» — «Возврат при розничной реализации»;
«RECEIPT_RETURN» — «Возврат товара, выведенного из оборота для продаж»;
«OWN_USE_RETURN» — «Возврат товара, выведенного из оборота в целях, не связанных с их последующей реализацией»;
«PRODUCTION_USE_RETURN» — «Возврат товара, выведенного из оборота для производственных целей» (в пользовательском интерфейсе отображается как «Возврат товара, выведенного из оборота в целях, не связанных с их последующей реализацией»);
«NOT_FOR_SALE_RETURN» — «Возврат товара, возвращенного покупателем, приобретавшим его в целях, не связанных с последующей реализацией»;
«VENDING_RETURN» — «Возврат товара, выведенного из оборота для продажи через вендинговый аппарат»;
«STATE_CONTRACT_RETURN» — «Возврат товара, выведенного из оборота для продажи по сделке с государственной тайной»

*eliminationReasonOther

string

Описание другой причины вывода из оборота

*modId

string

Идентификатор места осуществления деятельности

*modInfo

array of objects

Информация о МОД

**kpp

string

КПП МОД

**fiasId

string

Код ФИАС МОД

**address

string

Адрес МОД

*manufacturerInn

string

ИНН производителя товара

*importerInn

string

ИНН импортёра товара вне ЕАЭС

*productWeight

integer

Переменный вес продукта (в граммах)

*expiration

array of objects

Сведения о сроках годности в зависимости от условий хранения

Возвращается, если в карточке товара в НКМТ и в отчёте о нанесении в СУЗ указано несколько сроков годности

**expirationStorageDate

string (date-time)

Вариативная дата истечения срока годности

Возвращается, если в отчёте о нанесении в СУЗ указано несколько сроков годности. Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

**storageConditionId

string

Идентификатор условия хранения

Возвращается, если в карточке товара в НКМТ указан идентификатор условия хранения

*emissionCountryCode

integer

Код страны эмитента

Возможные значения:

«1» — Республика Армения;
«2» — Республика Беларусь;
«3» — Республика Казахстан;
«4» — Кыргызская Республика;
«5» — Российская Федерация

*exportCountryCode

integer

Код страны экспортёра

Возможные значения:

«112» — Республика Беларусь;
«417» — Кыргызская Республика;
«398» — Республика Казахстан;
«051» — Республика Армения

*orderId

string

Идентификатор заказа на эмиссию КИ в СУЗ

*operationIntroducedDate

string (date-time)

Дата фактической операции, осуществившей ввод в оборот

Дата в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*partyNumber

string

Номер партии товара

*productLengthMm

integer

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

error_message

string

Сообщение об ошибке

Возвращается только при наличии ошибки при выполнении запроса

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

Метод возвращает подробную информацию о запрашиваемом списке КИ / КиЗ: в одном запросе указывается как один КИ / КиЗ, так и несколько (не более 1000). Также метод возвращает информацию о КИ товаров, отгруженных из стран ЕАЭС (если отгрузка была оформлена с экземплярным указанием КИ).

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

Коды идентификации в запросе указываются в нормализованном виде (без скобок, обрамляющих идентификаторы применения).

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция» и «Табачная продукция» поиск КИ реализован с МРЦ и без МРЦ для единиц товаров и групповых упаковок. Если произойдёт совпадение КИ потребительской упаковки, указанного с учётом МРЦ или иной информации, с КИ транспортной упаковки, то в ответе будут выведены значения и по потребительской, и по транспортной упаковкам.

Тип приватности: c токеном авторизации

Общедоступная информация:

информация о КИ / КиЗ;
данные о производителе;
дата и время производства;
текущий статус в обороте;
текущий владелец.

URL: /api/v3/true-api/cises/info

Метод: POST

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

curl -X POST "<url стенда>/cises/info?pg=lp"
-H "accept: application/json"
-H "Content-Type: application/json"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

childsWithoutBrackets

boolean

Признак получения кодов вложений без скобок

Параметр считается устаревшим и не рекомендуется к использованию, при любом указанном или неуказанном значении игнорируется

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

[
   "010460000000000021LLLLLLLLLLLLL"
]

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

array[string]

Массив КИ / КиЗ

Значение АТК, КИ, КиЗ, КИТУ от 18 до 74 символов включительно без заключённых в скобки идентификаторов применений «01» и «21» для всех товарных групп.

Не более 1000 КИ в массиве

Пример ответа для товарной группы «Молочная продукция»:

В случае успеха:

[
   {
      "cisInfo": {
            "productWeightGr":"integer",
            "isVarQuantity":true,
            "requestedCis":"string",
            "cis":"string",
            "gtin":"string",
            "tnVedEaesGroup":"string",
            "productName":"string",
            "productGroupId":8,
            "productGroup":"milk",
            "brand":"brand",
            "emissionDate":"2021-12-28T11:42:32.098Z",
            "emissionType":"LOCAL",
            "packageType":"UNIT",
            "ownerInn":"string",
            "ownerName":"string",
            "status":"INTRODUCED",
            "statusEx":"EMPTY",
            "producerInn":"string",
            "producerName":"string",
            "markWithdraw":false
      }
   }
]

Пример ответа для товарной группы «Товары из натурального меха»:

В случае успеха:

[
   {
      "cisInfo":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "tnVedEaes":"string",
         "tnVedEaesGroup":"string",
         "productName":"string",
         "productGroupId":14,
         "productGroup":"furs",
         "brand":"string",
         "producedDate":"2020-04-07T11:59:28.727Z",
         "emissionDate":"2020-04-03T05:56:57.054Z",
         "emissionType":"LOCAL",
         "packageType":"UNIT",
         "ownerInn":"string",
         "ownerName":"string",
         "status":"INTRODUCED",
         "statusEx":"INDIVIDUAL",
         "producerInn":"string",
         "producerName":"string"
      }
   }
]

Пример ответа для прочих товарных групп:

В случае успеха:

 {
   "cisInfo":{
      "requestedCis":"string",
      "cis":"string",
      "gtin":"string",
      "tnVedEaesGroup":"string",
      "productName":"string",
      "productGroupId":12,
      "productGroup":"water",
      "brand":"string",
      "emissionDate":"2020-12-30T07:37:49.293Z",
      "emissionType":"LOCAL",
      "packageType":"UNIT",
      "ownerInn":"string",
      "ownerName":"string",
      "status":"INTRODUCED",
      "statusEx":"EMPTY",
      "producerInn":"string",
      "producerName":"string",
      "markWithdraw":false,
      "certDoc":[
         {
            "type":"CONFORMITY_DECLARATION",
            "number":"RU Д-ХХ.АА00.B.00001/21",
            "date":"2021-07-01T00:00:00.000Z",
            "wellNumber":"string",
            "indx": 123
         },
         {
            "type":"STATE_REGISTRATION_CERTIFICATE",
            "number":"RU.01.ЯЯ.00.001.Е.000001.07.21",
            "date":"2021-07-02T00:00:00.000Z",
            "wellNumber":"string",
            "indx": 456
         }
      ],
      "licences":[
         {
            "licenceNumber":"string",
            "licenceDate":"2021-09-06"
         }
      ]
   }
}

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

2.1. Код 200 при указании в запросе несколько КИ или агрегатов, если на хотя бы один из них вернулся успешный ответ или на все КИ и агрегаты вернулись разные ошибки:

[
   {
      "cisInfo":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "packageType":null
      },
      "errorMessage":"КИ не найден",
      "errorCode":"404"
   },
   {
      "cisInfo":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "packageType":null
      },
      "errorMessage":"Отсутствует ответ системы",
      "errorCode":"504"
   }
]

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

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

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

{
   "error_message":"Required request body is missing: public org.springframework.http.ResponseEntity ru.crpt.trueapi.controller.motp.CisesController.getCisesInfoByCodeList(java.util.List<java.lang.string>)"
}

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

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

2.5. Код 401 при не пройденной авторизации (если указан токен, но он не валиден):

[
    {
        "cisInfo": {
            "requestedCis":"string",
            "cis":"string",
            "gtin":"string",
            "productGroup":null,
            "packageType":null,
            "generalPackageType":null
        },
        "errorMessage": "Авторизация не пройдена",
        "errorCode": "401"
    }
]

2.6. Код 403 при не подписанном договоре, если на КИ и агрегаты вернулась ошибка 403:

{
   "error_message":"Отсутствует действующий договор по ТГ"
}

2.7. Код 404 при неизвестных КИ:

[
   {
      "cisInfo":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "packageType":null
      },
      "errorMessage":"КИ не найден",
      "errorCode":"404"
   }
]

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

[
   {
      "cisInfo":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "packageType":null
      },
      "errorMessage":"КИ не найден",
      "errorCode":"404"
   }
]

2.9. Код 404 при указании в запросе КИ без кодов товара и кодов транспортных упаковок, не найденных в товарной группе:

[
   {
      "cisInfo":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "packageType":null
      },
      "errorMessage":"КИ не найден",
      "errorCode":"404"
   }
]

2.10. Код 422, если для КИ не может быть возвращена информация, так как отсутствует согласие от текущего владельца КИ:

{
   "error_message":"Отсутствует доступ к сведениям"
}

2.11. Код 504, если в запросе несколько КИ или агрегатов — по всем КИ и агрегатам ошибка, что сервис не вернул ответ:

[
   {
      "cisInfo":{
         "requestedCis":"string"
      },
      "errorMessage":"Отсутствует ответ системы",
      "errorCode":"504"
   },
   {
      "cisInfo":{
         "requestedCis":"string"
      },
      "errorMessage":"string",
      "errorCode":"504"
   },
   {
      "cisInfo":{
         "requestedCis":"string"
      },
      "errorMessage":"Отсутствует ответ системы",
      "errorCode":"504"
   }
]

2.12. Код 701 при указании в запросе КИ с МРЦ, несоответствующей МРЦ в базе данных ГИС МТ по этому КИ (для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»):

[
   {
      "cisInfo":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "packageType":null
      },
      "errorMessage":"МРЦ в ГИС отличается от МРЦ указанного в запросе КМ",
      "errorCode":"701"
   }
]

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

Параметр

Тип

Обяз.

Описание

Комментарий

cisInfo

object

Список КИ / КиЗ

*requestedCis

string

КИ / КиЗ из запроса

Значение КИ, указанное в запросе.
КиЗ для товарной группы «Товары из натурального меха» соответствуют 20-значному шаблону: (RU|AM|BY|KZ|KG)[-]{1}[A-Z0-9]{6}[-]{1}[A-Z0-9]{10}.
Пример: RU-430302-AAA7064491

*cis

string

КИ / КиЗ из ответа

Код в нормализованном виде.
Параметр не возвращается для агрегатов со статусом «DISAGGREGATION» («Расформирован»)

*applicationDate

string (date-time)

Дата нанесения

Возвращается только при наличии у КИ для всех типов упаковок, кроме КИТУ и АТК. Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*introducedDate

string (date-time)

Дата ввода в оборот

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*ogvs

array of string

Органы государственной власти, установившие блокировку на КМ

Возможные значения:

«RAR» — Росалкогольрегулирование;
«FTS» — ФТС России;
«FNS» — ФНС России;
«RSHN» — Россельхознадзор;
«RPN» — Роспотребнадзор;
«MVD» — МВД России;
«RZN» — Росздравнадзор

*gtin

string

Код товара

Если код товара менее 14 символов, то дополняется ведущими нулями. При отсутствии кода товара значение = ""

*tnVedEaes

string

10-значный код ТН ВЭД

Если от НКМТ вернётся ошибка запроса получения сведений о товаре по коду товара запрашиваемого КИ, то о таком КИ вернётся ответ с кодом 504 и сообщением об ошибке «Отсутствует ответ системы»

*tnVedEaesGroup

string

4-значный код ТН ВЭД

*productName

string

Наименование продукции

Возвращается непустое значение из НКМТ для единицы товара, комплекта, набора и групповой упаковки, либо значение = «-» (прочерк). Если от НКМТ вернётся ошибка запроса получения сведений о товаре по коду товара запрашиваемого КИ, то о таком КИ вернётся ответ с кодом 504 и сообщением об ошибке «Отсутствует ответ системы»

*productGroupId

integer

Идентификатор товарной группы

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

*productGroup

string

Наименование товарной группы

См. «Справочник «Список поддерживаемых товарных групп»». При отсутствии товарной группы значение = null

*producedDate

string (date-time)

Дата производства

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z. Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция» параметр не возвращается для АТК, для остальных товарных групп — для АТК и КИТУ

*emissionDate

string (date-time)

Дата эмиссии

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*emissionType

string

Тип эмиссии

*generalPackageType

string

Общий вид упаковки

Если значение параметра = «ATK» или «BOX» то в ответе не возвращаются параметры «tnVedEaes» («10-значный код ТН ВЭД»), «tnVedEaesGroup» («4-значный код ТН ВЭД»), «productName» («Наименование продукции»), «brand» («Бренд»).

При отсутствии типа упаковки значение = null

*brand

string

Бренд

*packageType

string

Код типа упаковки

Устаревший атрибут, в 2025 году будет исключён из ответа. Необходимо использовать «generalPackageType» («Общий вид упаковки»).

Cм. «Справочник «Типы упаковки»». При отсутствии типа упаковки значение = null

*ownerInn

string

ИНН владельца товара

*ownerName

string

Наименование владельца товара

*status

string

Статус КИ / КиЗ

См. «Справочник «Группы статусов разрешительных документов»»

*statusEx

string

Актуальное особое состояние КИ / КиЗ

Cм. «Справочник «Статусы КИ»». При отсутствии у КИ / КиЗ особого состояния возвращается значение «EMPTY» («Значение отсутствует»)

*markWithdraw

boolean

Признак выбытия от не владельца

Параметр возвращается для всех товарных групп с обязательной экземплярной прослеживаемостью, если была зафиксирована продажа по чеку от невладельца КИ в ГИС МТ

*turnoverType

string

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

Возможные значения:

«SELLING» — «Продажа»;
«CONTRACT» — «Передача по АКС»

*certDoc

array [object]

Сведения о разрешительном документе

Массив не возвращается в ответе, если у КИ / КиЗ отсутствуют сведения о разрешительном документе

**type

string

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

См. «Справочник «Виды разрешительной документации»». Также может вернуться «CONFORMITY_CERTIFICATE_OR_DECLARATION» («Сертификат или декларация соответствия»), который ранее записывался в КМ, если при получении ответа от ФТС не получилось определить вид документа

**number

string

Номер документа, подтверждающего соответствие

**date

string (date-time)

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

Возвращается в формате поданного в ГИС МТ значения:

yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy.MM.dd

**wellNumber

string

Номер скважины

Возвращается только для товарной группы «Упакованная вода»

**indx

integer

Индекс разрешительного документа

Индекс, присвоенный данному разрешительному документу

**statusGroup

integer

Группа статуса разрешительного документа

*certDocRequirementDetails

object

Требования подтверждения соответствия отсутствуют; основание

Возвращается в ответе, если у КИ / КиЗ отсутствуют сведения о разрешительном документе и в НКМТ заполнен соответствующий атрибут — «reasonCertMissingDetails» («Требования подтверждения соответствия отсутствуют; основание»)

**notRequiredReason

string

Основание отсутствия необходимости указания разрешительного документа

**isRequired

boolean

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

Возможные значения:

«true» — есть причина;
«false» — нет причины

*child

array [string]

Список дочерних КИ в агрегате

*parent

string

КИ агрегата

*maxRetailPrice

number

Максимальная цена розничной продажи в копейках

Параметр возвращается для КИ единиц товаров и групповых упаковок для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция». Для единиц товаров и групповых упаковок значение параметра строго = значению МРЦ из базы данных ГИС МТ (оно может быть ≥ 0 либо is null для КИ без МРЦ либо для КИ с нулевой МРЦ в запросе). Если КИ в запросе указан с МРЦ (0 < МРЦ ≤ 500000 копеек), то выполняется сравнение этой МРЦ с валидной МРЦ в базе данных ГИС МТ:

если МРЦ найдена в БД ГИС МТ и отличается от МРЦ КИ в запросе, то в ответе метода вернётся ошибка «errorCode» («Код ошибки») 701;
если МРЦ найдена в БД ГИС МТ и совпадает с МРЦ КИ в запросе, то в ответе вернётся информация по КИ;
если МРЦ отсутствует в БД ГИС МТ (is null), то в ответе вернётся информация по КИ, сравнение МРЦ из базы данных ГИС МТ с МРЦ у КИ в запросе не выполняется

*mcGtinCop

array of integer

Минимальная цена в копейках

Возвращается для товарных групп «Альтернативная табачная продукция» и «Никотиносодержащая продукция» при наличии в карточке товара НКМТ минимальной цены на момент запроса по московскому времени (UTC+3)

*volumeSpecialPack

string

Фактический объём выпущенной продукции, мл

Возвращается для товарных групп «Безалкогольное пиво», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»

*producerInn

string

ИНН производителя или импортёра РФ

Возвращается для КИТУ только в товарных группах «Альтернативная табачная продукция» и «Табачная продукция», для остальных товарных групп не возвращается

*producerName

string

Наименование производителя или импортёра РФ

Для расформированных агрегатов не возвращается для всех товарных групп, кроме товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»

*prVetDocument

string

Идентификатор ВСД

*exporterName

string

Наименование экспортёра

*expirationDate

string (date-time)

Дата срока годности

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*productWeightGr

integer

Вес выпущенной продукции

Возвращается в граммах, первые три цифры – значение кг, последние три цифры – десятые, сотые и тысячные. Например: «productWeightGr»: «001234» означает 1234 грамма или 1.234 кг

*isVarQuantity

boolean

Признак переменного веса

Возможные значения:

«true» — да;
«false» — нет

*partialSaleInfo

object

Сведения о частичном выбытии

Возвращается владельцу и невладельцу КИ, Оператору и ФОИВ, если количество товара в потребительской упаковке больше одного (значение параметра «innerUnitCount» («Общее количество (объём / вес) товара в потребительской упаковке (для товара с возможностью частичного выбытия)») больше «1»)

**innerUnitCount

integer(int32)

Общее количество (объём / вес) товара в потребительской упаковке (для товара с возможностью частичного выбытия)

Значением параметра является первоначальное количество / объём / вес товара в потребительской упаковке / единице товара до продаж и возвратов товара

**soldUnitCount

integer(int32)

Количество (объём / вес) выведенного из оборота товара по КИ

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

**rest

integer(int32)

Количество (объём / вес) товара, доступного к выводу из оборота по КИ

Значением параметра является расчётное количество / объём / вес оставшихся в потребительской упаковке / единице товара единиц употребления / мл товара после продажи всеми участниками оборота товаров

**correctRest

boolean

Корректность остатка товара

Показатель корректности остатка товара после вывода товара из оборота:

«false» — продано или возвращено больше допустимого количества / объёма товара;
«true» — продано или возвращено в пределах допустимого количества / объёма товара.

Для товарной группы «Духи и туалетная вода» (наливная продукция) продажа товара в объёме, превышающем заявленный, а также превышение остатка товара более чем на 8 % считаются некорректными.

Показатель рассчитывается по всем чекам с данным КИ

*expirations

array [object]

Массив сроков годности

Возвращается, если в карточке товара в НКМТ и в отчёте о нанесении КМ в СУЗ указано несколько сроков годности

**expirationStorageDate

string (date-time)

Дата срока годности

Возвращается, если в отчёте о нанесении в СУЗ указано несколько сроков годности. Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

**storageConditionId

integer

Идентификатор условия хранения

Возвращается, если в карточке товара в НКМТ указан идентификатор условия хранения

**storageConditionName

string

Описание условий хранения

Возвращается, если в карточке товара в НКМТ указано описание условий хранения. Формат значения соответствует указанному в НКМТ, с учётом расширенной информации, указанной в соответствии с этикеткой на упаковке. Пример значения: «120 суток при температуре хранения 0°C и относительной влажности воздуха от 80% до 85% включительно»

*withdrawReason

string

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

См. «Справочник «Причины выбытия»». Если «withdrawReason» («Причина вывода из оборота») = «OTHER» («Другое»), то причина возвращается в дополнительном параметре «withdrawReasonOther» («Описание другой причины вывода из оборота»)

*withdrawReasonOther

string

Описание другой причины вывода из оборота

Возвращается, если «withdrawReason» («Причина вывода из оборота») = «OTHER» («Другое»)

*connectDate

string

Дата подключения кега к оборудованию для розлива

Возвращается только для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»

*ownerMod

object

Сведения о текущем месте осуществления деятельности

**modId

integer

Идентификатор текущего места осуществления деятельности

**kpp

string

КПП торговой точки

Возвращается только для юридических лиц

**fiasId

string

Идентификатор ФИАС

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

**address

string

Адрес места осуществления деятельности

*applicationMod

object

Сведения о месте осуществления деятельности, где было нанесено средство идентификации

**kpp

string

КПП

Возвращается для юридических лиц

**fiasId

string

Идентификатор ФИАС

**address

string

Адрес

*licences

array[object]

Массив лицензий на пользование недрами

Возвращается только для товарной группы «Упакованная вода»

**licenceNumber

string

Номер лицензии на пользование недрами

Возвращается только для товарной группы «Упакованная вода»

**licenceDate

string date

Дата выдачи лицензии

Возвращается только для товарной группы «Упакованная вода» в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*batchNumber

string

Номер серии товара

*manufacturerSerialNumber

string

Заводской серийный номер

*partyNumber

string

Номер партии товара

Возвращается, если в отчёте о нанесении КМ в СУЗ указано соответствующее значение

*productLengthMm

integer

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

Значение параметра в миллиметрах без ведущих нулей

*isTracking

boolean

Признак прослеживаемости кода

Возможные значения:

«true» — код прослеживается;
«false» — код не прослеживается или прослеживается условно

*isExcisableProduct

boolean

Признак подакцизности товара

Может вернуться для подакцизных товарных групп. Возможные значения:

«true» — товар подакцизный;
«false» — товар не подакцизный

*exciseProductCode

string

Код подакцизного товара

Возвращается только при «isExcisableProduct» = «true»

*manufacturerInn

string

ИНН производителя товара

*manufacturerName

string

Наименование производителя товара

*importerInn

string

ИНН импортёра товара вне ЕАЭС

*importerName

string

Наименование импортёра товара вне ЕАЭС

*isMultipleSales

boolean

Признак множественных продаж

Возможные значения:

«true» — код идентификации был выведен из оборота несколько раз владельцем и / или не владельцем;
«false» — код идентификации не был выведен из оборота или был выведен один раз

errorMessage

string

Сообщение об ошибке

См. «Справочник "Статусы ответов"». Параметр возвращается при наличии ошибки

errorCode

string

Код ошибки

Возвращается при наличии ошибки

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

Метод возвращает информацию о запрашиваемом списке кодов. Предназначен для проверки кодов перед отгрузкой / приёмкой товаров всех товарных групп, используя информацию только из «cis» («Массив КИ»).

Тип приватности: публичный

URL: /cises/short/list

Метод: POST

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

curl -X POST "<url стенда>/cises/short/list"
-H "accept: */*"
-H "Content-Type: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

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

childsWithoutBrackets

boolean

Признак получения кодов вложений без скобок

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

["010460000000000021AAAAAAAAA"]

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

array[string]

Массив КИ

Не более 1000 КИ в массиве

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

В случае успеха:

[
   {
      "result":{
         "requestedCis":"string",
         "cis":"string",
         "gtin":"string",
         "producerInn":"string",
         "status":"RETIRED",
         "emissionDate":"2020-07-16T18:51:27.000Z",
         "applicationDate":"2020-07-16T18:51:39.000Z",
         "parent":"string",
         "packageType":"UNIT",
         "ownerInn":"string",
         "tnVedEaesGroup":"string",
         "tnVedEaes":"string",
         "receiptDate":"2020-07-16T18:51:28.000Z",
         "emissionType":"LOCAL",
         "specialAttributes":{
            "introducedDate":"2020-07-16T18:51:27.000Z",
            "nextCis":[
               "array[string]"
            ],
            "prevCis":[
               "array[string]"
            ],
            "ftsDecisionCode":"string",
            "eliminationReasonOther":"string",
            "approvementDocument":{
               "certDoc":[
                  {
                     "type":"CONFORMITY_CERTIFICATE",
                     "number":"RU С-ХХ.АА00.B.00001/23",
                     "date":"2023-01-01T00:00:00Z",
                     "wellNumber":"string"
                  },
                  {
                     "type":"CONFORMITY_DECLARATION",
                     "number":"RU Д-ХХ.АА00.B.00001/23",
                     "date":"2023-01-01T00:00:00Z",
                     "wellNumber":"46246798"
                  }
               ],
               "declarationDate":"11.08.2020",
               "declarationRegNumber":"10000000/060820/0000000",
               "declarationId":"string"
            },
            "productWeightGr": "string",
            "isVarQuantity": true
         },
         "statusEx":"FTS_RESPOND_NOT_OK",
         "productGroup":"water",
         "productGroupId":13,
         "extendedPackageType":"string",
         "withdrawReason":"KM_SPOILED",
         "licences":[
            {
               "licenceNumber":"string",
               "licenceDate":"2021-09-06"
            }
         ]
      }
   }
]

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

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

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

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

{
   "error_message":"Required request body is missing: public org.springframework.http.ResponseEntity ru.crpt.trueapi.controller.motp.CisesController.getCisesInfoByCodeList(java.util.List<java.lang.string>)"
}

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

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

2.4. Код 400 при запросе свыше 1000 КИ:

{
   "error_message":"Слишком много КИ в запросе. Количество не должно превышать 1000"
}

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

{
   "error_message":"Для доступа к этому ресурсу требуется полная аутентификация. Проверьте токен"
}

2.6. Код 403 при не подписанном договоре, если на КИ и агрегаты вернулась ошибка 403:

{
   "error_message":"отсутствует действующий договор по <pg>"
}

2.7. Код 403, если не соответствует {pamyatka_rolevaya_model_dostupa}[роль]:

{
   "error_message":"Отсутствует доступ к ресурсу"
}

2.8. Код 404 при запросе не найденных кодов в подписанной товарной группе:

{
   "result":{
      "requestedCis":"010460000000000021AAAAAAAAA",
      "gtin":"04600000000000"
   },
   "errorMessage":"КИ не найден",
   "errorCode":"404"
}

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

Параметр

Обяз.

Тип

Описание

Комментарий

result

array

Результат

*cis

string

КИ

Код в нормализованном виде

*requestedCis

string

КИ запрашиваемых потребительских / групповых / транспортных упаковок

Значение КИ из запроса

*applicationDate

string (date-time)

Дата нанесения

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z. Параметр не возвращается для КИТУ, АТК

*children

array[string]

Список дочерних КИ в агрегате

Возвращается список КИ только верхнего уровня

*emissionDate

string(date-time)

Дата эмиссии

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*emissionType

string

Тип эмиссии

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

*gtin

string

Код товара

Если код товара менее 14 символов, то он дополняется ведущими нулями. Значение в параметре не выводится, если «extendedPackageType» («Тип упаковки») = «ATK» («Агрегированный таможенный код») или «BOX» («Транспортная упаковка»)

*ogvs

array of string

Органы государственной власти, установившие блокировку на КМ

Возможные значения:

*ownerInn

string

ИНН владельца КИ

*packageType

string

Уровень упаковки

Устаревший атрибут, в 2025 году будет исключён из ответа. Необходимо использовать «extendedPackageType»

*extendedPackageType

string

Тип упаковки

Cм. «Справочник «Типы упаковки»».

Если значение параметра = «BOX» («Транспортная упаковка»), то в ответе не возвращается параметр «applicationDate» («Дата нанесения»)

*parent

string

Родительский КИ

*volumeSpecialPack

string

Фактический объём выпущенной продукции, мл

*producerInn

string

ИНН производителя

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

*productGroup

string

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

*productGroupId

string

ID товарной группы

*producedDate

string (date-time)

Дата производства

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z. Параметр не возвращается для КИТУ и АТК (кроме товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»)

*receiptDate

string(date-time)

Дата вывода из оборота

Возвращается для КИ, КИН, КИГУ, КИК в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*status

string

Статус КИ

*statusEx

string

Расширенный статус КИ, КИН, КИГУ

*tnVedEaes

string

10-значный код ТН ВЭД

КИ, КИН, КИГУ

*tnVedEaesGroup

string

4-значный код ТН ВЭД

КИ, КИН, КИГУ

*withdrawReason

string

Причина выбытия

См. "Справочник «Виды разрешительной документации»"

*licences

array[object]

Массив лицензий на пользование недрами

Значение параметра возвращается для товарной группы «Упакованная вода»

**licenceNumber

string

Номер лицензии на пользование недрами

Возвращается для товарной группы «Упакованная вода»

**licenceDate

string date

Дата выдачи лицензии

Возвращается для товарной группы «Упакованная вода» в формате yyyy-MM-ddTHH:mm:ss.SSSZ

*batchNumber

string

Номер серии товара

*partyNumber

string

Номер партии товара

Возвращается, если в отчёте о нанесении КМ в СУЗ указано соответствующее значение

*specialAttributes

specialAttributesDto

Дополнительные атрибуты «cis» («КИ потребительских / групповых / транспортных упаковок»)

**maxRetailPrice

number

Максимальная цена розничной продажи

Возвращается только для единицы товара и групповой упаковки (расформированные агрегаты — для групповых упаковок товарной группы «Табачная продукция»)

**expirationDate

string(date-time)

Срок годности

Возвращается только для товарной группы «Молочная продукция»

**prVetDocument

string

Идентификатор ВСД

**introducedDate

string(date-time)

Дата ввода товара в оборот или формирования агрегата

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

**capacity

string

Объём

Возвращается только для товарной группы «Молочная продукция»

**nextCis

string

Следующие КИ, после перемаркировки

**prevCis

string

Предыдущие КИ, до перемаркировки

**productLengthMm

integer

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

Значение параметра в миллиметрах без ведущих нулей

**turnoverType

string

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

Возможные значения:
«SELLING» — «Продажа»;
«CONTRACT» — «Передача по АКС»

**retType

string

Тип возврата в оборот

**expNum

string

ИНН / УНБ экспортёра

**expName

string

Наименование экспортёра

**remainsImport

string

Признак импортного товара, ввезённого в РФ после 01.07.2020

**ftsDecisionCode

string

Код принятого решения из ДТ

**quantityInPack

string

Количество единиц употребления в потребительской упаковке / заявленный объём

**soldCount

string

Счётчик проданного и возвращённого товара участниками оборота товаров

**eliminationReasonOther

string

Описание другой причины вывода из оборота

**productWeightGr

integer

Вес выпущенной продукции

Возвращается в граммах, первые три цифры — значение кг, последние три цифры — десятые, сотые и тысячные. Например: «productWeightGr»: «001234» означает 1234 грамма или 1.234 кг

**manufacturerSerialNumber

string

Заводской серийный номер

**approvementDocument

array

Сведения о сертификатах и декларациях

***declarationDate

string

Дата ДТ

***declarationId

string

Регистрационный номер ДТ

***declarationRegNumber

string

ID ДТ

***certDoc

array

Сертификаты / декларации соответствия

****type

string

Тип сертификата

****number

string

Номер сертификата

****date

string

Дата сертификата

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

****wellNumber

string

Номер скважины

Возвращается для товарной группы «Упакованная вода»

*expirations

array[object]

Массив сроков годности

Возвращается, если в карточке товара в НКМТ и в отчёте о нанесении КМ в СУЗ указано несколько сроков годности

**expirationStorageDate

string

Дата срока годности

Возвращается, если в отчёте о нанесении в СУЗ указано несколько сроков годности. Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

**storageConditionId

integer

Идентификатор условия хранения

Возвращается, если в карточке товара в НКМТ указан идентификатор условия хранения

*connectDate

string

Дата подключения кега к оборудованию для розлива

Только для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»

*ownerMod

object

Сведения о текущем месте осуществления деятельности

Только для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»

**modId

integer

Идентификатор текущего места осуществления деятельности

*isMultipleSales

boolean

Признак множественных продаж

Возможные значения:

*isTracking

boolean

Признак прослеживаемости кода

Возможные значения:

«true» — код прослеживается;
«false» — код не прослеживается или прослеживается условно

*manufacturerInn

string

ИНН производителя товара

*importerInn

string

ИНН импортёра товара вне ЕАЭС

errorMessage

string

Сообщение об ошибке

См. «Справочник "Статусы ответов"». Параметр возвращается при наличии ошибки

errorCode

string

Код ошибки

Параметр возвращается при наличии ошибки

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

Метод возвращает информацию о списке запрашиваемых КИ / КиЗ: в одном запросе можно указать несколько КИ / КиЗ. Метод не предназначен для проверки сведений при сканировании КИ / КиЗ на ККТ при реализации маркированных товаров.

КиЗ для товарной группы «Товары из натурального меха» указывать в запросах в соответствии с шаблоном из 20 символов: (RU|AM|BY|KZ|KG)[-]{1}[A-Z0-9]{6}[-]{1}[A-Z0-9]{10}. Пример: RU-430302-AAA7064491.

Тип приватности: с токеном авторизации

Общедоступная информация:

информация о КИ / КиЗ;
данные о производителе;
дата и время производства;
текущий статус в обороте;
текущий владелец – показ только владельцу, ФОИВ, Оператору-ЦРПТ и Администратору.

URL: /cises/list

Метод: POST

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

curl -X POST <url стенда v3>/cises/list?values=000000462106549OOv1s0XzlzIFDjtcXJjz5cB&values=00000046210654QuHCUeP
-H "accept: */*"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

values

array[string]

Список КИ

КиЗ для товарной группы «Товары из натурального меха» указывать в соответствии с 20-значным шаблоном: (RU|AM|BY|KZ|KG)[-]{1}[A-Z0-9]{6}[-]{1}[A-Z0-9]{10}. Пример: RU-430302-AAA7064491

string

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

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

childsWithoutBrackets

boolean

Признак получения кодов вложений без скобок

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

В случае успеха:

[
   {
      "requestedCis":"string",
      "cis":"string",
      "status":"INTRODUCED",
      "statusEx":"EMPTY",
      "gtin":"string",
      "productGroup":"lp",
      "productGroupId":1,
      "producedDate":"2022-01-12T00:00:00.000Z",
      "packageType":"UNIT",
      "producerInn":"string",
      "producerName":"string",
      "emissionDate":"2021-12-20T12:55:55.062Z",
      "emissionType":"LOCAL",
      "ownerInn":"string",
      "ownerName":"string",
      "tnVedEaes":"string",
      "parent":"string",
      "maxRetailPrice":null
   }
]

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

2.1. Код 400 при отсутствии обязательного параметра:
```
{
   "error_message":"Отсутствует обязательный параметр: values"
}
```
2.2. Код 404, если указанный КИ не найден:
```
{
   "error_message":"КИ не найдены"
}
```

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

Параметр

Тип

Обяз.

Описание

Комментарий

applicationDate

string (date-time)

Дата нанесения

introducedDate

string (date-time)

Дата ввода в оборот

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSSZ

productWeightGr

integer

Вес выпущенной продукции

isVarQuantity

boolean

Признак переменного веса

Возможные значения:

«true» — да;
«false» — нет

requestedCis

string

КИ / КиЗ из запроса

cis

string

КИ / КиЗ

Код в нормализованном виде

status

string

Код статуса КИ / КиЗ

gtin

string

Код товара

Если код товара менее 14 символов, то он дополняется ведущими нулями

tnVedEaes

string

10-значный код ТН ВЭД

tnVedEaesGroup

string

4-значный код ТН ВЭД

productName

string

Наименование продукции

Возвращается непустое значение из НКМТ для единицы товара, комплекта, набора и групповой упаковки либо значение = «-» (прочерк)

producedDate

string (date-time)

Дата производства

emissionDate

string (date-time)

Дата эмиссии КИ / КиЗ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSSZ

emissionType

string

Тип эмиссии

packageType

string

Код типа упаковки

Устаревший атрибут, в 2025 году будет исключен из ответа. Необходимо использовать «generalPackageType» («Общий вид упаковки»).

generalPackageType

string

Общий вид упаковки

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

Если значение параметра = «ATK» или «BOX», то в ответе не возвращаются параметры «tnVedEaes» («10-значный код ТН ВЭД»), «tnVedEaesGroup» («Код товарной позиции ТН ВЭД ЕАЭС товара»), «productName» («Наименование продукции»)

producerInn

string

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

Не возвращается для расформированных агрегатов для всех товарных групп, кроме товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»

producerName

string

Наименование производителя

ownerInn

string

ИНН владельца товара

ownerName

string

Наименование владельца товара

parent

string

Родительский КИ

ogvs

array of string

Органы государственной власти, установившие блокировку на КМ

Возможные значения:

volumeSpecialPack

string

Фактический объём выпущенной продукции, мл

child

array [string]

Список дочерних КИ в агрегате

Параметр возвращается для всех товарных групп. Для всех товарных групп, кроме «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция» параметр возвращается, в том числе для расформированных агрегатов

productGroupId

integer

Идентификатор товарной группы

productGroup

string

Наименование товарной группы

maxRetailPrice

number

Максимальная цена розничной продажи

если МРЦ найдена в БД ГИС МТ и отличается от МРЦ КИ в запросе, то в ответе метода вернётся ошибка «errorCode» («Код ошибки») 701;
если МРЦ найдена в БД ГИС МТ и совпадает с МРЦ КИ в запросе, то в ответе вернётся информация по КИ;
если МРЦ отсутствует в БД ГИС МТ (is null), то в ответе вернётся информация по КИ, сравнение МРЦ из базы данных ГИС МТ с МРЦ у КИ в запросе не выполняется

mcGtinCop

array of integer

Минимальная цена в копейках

partialSaleInfo

object

Сведения о частичном выбытии

*innerUnitCount

integer(int32)

Значением параметра является первоначальное количество/объём товара в потребительской упаковке/единице товара до продаж и возвратов товара

*soldUnitCount

integer(int32)

Количество (объём / вес) выведенного из оборота товара по КИ, шт (мл / кг)

*rest

integer(int32)

Количество (объём / вес) товара, доступного к выводу из оборота по КИ, шт (мл / кг)

*correctRest

boolean

Корректность остатка товара

Показатель корректности остатка товара после вывода товара из оборота:

false — продано или возвращено больше допустимого количества/объёма товара;
true — продано или возвращено в пределах допустимого количества/объёма товара.

Показатель рассчитывается по всем чекам с данным КИ

withdrawReason

string

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

withdrawReasonOther

string

Описание другой причины вывода из оборота

Возвращается, если «withdrawReason» («Причина вывода из оборота») = «OTHER» («Другое»)

turnoverType

string

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

Возможные значения:

«SELLING» — «Продажа»;
«CONTRACT» — «Передача по АКС»;
«CONTRACT_RETURN» — «Возврат по АКС»

statusEx

string

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

expirations

array[object]

Массив сроков годности

Возвращается, если в карточке товара в НКМТ и в отчёте о нанесении КМ в СУЗ указано несколько сроков годности

*expirationStorageDate

string (date-time)

Дата срока годности

Возвращается, если в отчёте о нанесении в СУЗ указано несколько сроков годности. Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

*storageConditionId

integer

Идентификатор условия хранения

Возвращается, если в карточке товара в НКМТ указан идентификатор условия хранения

*storageConditionName

string

Описание условий хранения

licences

array[object]

Массив лицензий на пользование недрами

Значение параметра возвращается для товарной группы «Упакованная вода»

*licenceNumber

string

Номер лицензии на пользование недрами

Возвращается для товарной группы «Упакованная вода»

*licenceDate

string date

Дата выдачи лицензии

Возвращается для товарной группы «Упакованная вода» в формате yyyy-MM-ddTHH:mm:ss.SSSZ

batchNumber

string

Номер серии товара

manufacturerSerialNumber

string

Заводской серийный номер

partyNumber

string

Номер партии товара

Возвращается, если в отчёте о нанесении КМ в СУЗ указано соответствующее значение

connectDate

string

Дата подключения кега к оборудованию для розлива

Только для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»

ownerMod

object

Сведения о текущем месте осуществления деятельности

Только для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»

*modId

integer

Идентификатор текущего места осуществления деятельности

*kpp

string

КПП торговой точки

Только для юридических лиц

*fiasId

string

Идентификатор ФИАС

Только для индивидуальных предпринимателей

*address

string

Адрес места осуществления деятельности

isMultipleSales

boolean

Признак множественных продаж

Возможные значения:

productLengthMm

integer

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

Значение параметра в миллиметрах без ведущих нулей

isTracking

boolean

Признак прослеживаемости кода

Возможные значения:

«true» — код прослеживается;
«false» — код не прослеживается или прослеживается условно

manufacturerInn

string

ИНН производителя товара

manufacturerName

string

Наименование производителя товара

importerInn

string

ИНН импортёра товара вне ЕАЭС

importerName

string

Наименование импортёра товара вне ЕАЭС

5.1.5. Метод запроса подлинности КМ, выпущенных Операторами ЕАЭС

Метод предназначен для проверки валидности КМ, выпущенных Операторами государств-членов ЕАЭС:

Республика Беларусь — товарные группы "Молочная продукция", "Обувные товары", "Предметы одежды, бельё постельное, столовое, туалетное и кухонное" (с 1 марта 2022), "Шины и покрышки пневматические резиновые новые";
Республика Казахстан — товарная группа "Обувные товары".

URL: /cises/eaes/info

Тип приватности: публичный

Метод: POST

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

curl -X POST "<url стенда>/cises/eaes/info?country=112"
-H "Content-Type: application/json"
-H "Authorization: Bearer<ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

country

integer

Числовой код страны по ОКСМ

Возможные значения:

112 — Республика Беларусь;
398 — Республика Казахстан.

При указании значения "398" (Республика Казахстан), в параметре "pg" может быть указано только значение "shoes" ("Обувные товары").

Все коды маркировки, указанные в теле запроса в параметре "cis", проходят валидацию на соответствие шаблону кодов маркировки страны, указанной в параметре "country"

string

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

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

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

{
   "cis":"0104655555555555212FFFFFFFFFFFF\u001D91LlLl\u001D9212345TtTtT12345TtTtT12345TtTtT12345TtTtTtTt="
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

string

КМ

Указывается полный КМ с ключом проверки. Cимвол GS (по таблице ASCII — код 029) в составе КМ необходимо экранировать с помощью \u001d.

Допускается указание КМ, эмитированных:

на территории Республики Беларусь для товарных групп "Молочная продукция", "Обувные товары", "Предметы одежды, бельё постельное, столовое, туалетное и кухонное", "Шины и покрышки пневматические резиновые новые";
на территории Республики Казахстан для товарной группы "Обувные товары".

Все указанные КМ проходят валидацию на соответствие шаблону КМ страны, указанной в параметре "country"

Ответ может содержать параметры, специфичные только для товарной группы "Молочная продукция". Полный список возможных параметров см. в справочнике "Дополнительные параметры для ТГ "Молочная продукция"".

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

Код 200. КМ подлинный:

{
   "cis":"string",
   "authenticity":true,
   "cisStatusId":"1",
   "cisStatusName":"в обороте в стране ЕАЭС",
   "gtin":"04655555555555",
   "productName":"Шина",
   "brand":"Бренд",
   "tnvedGroup":"0000",
   "expireDate":"2021-10-10",
   "registered":true,
   "cisStatus":"INTRODUCED",
   "emissionType":"CROSSBORDER",
   "statusEx":"WAIT_SHIPMENT"
}

Код 200. КМ неподлинный:

{
   "cis":"string",
   "authenticity":false
}

Код 200. КМ подлинный, но не найден в ГИС МТ:

{
   "cis":"string",
   "authenticity":true,
   "cisStatusId":"1",
   "cisStatusName":"в обороте в стране ЕАЭС",
   "registered":false
}

Код 401. Для доступа к ресурсу требуется полная аутентификация:

{
   "error_message":"Для доступа к этому ресурсу требуется полная аутентификация"
}

Код 401. Ошибка при выполнении запроса:
```
{
   "error":"string",
   "error_description":"string"
}
```

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

string

КМ

КМ из запроса

authenticity

boolean

Признак подлинности КМ

Признак подлинности КМ на территории государства-члена ЕАЭС. Возможные значения:

"true" - получен положительный ответ о подлинности КМ;
"false" - получен отрицательный ответ о подлинности КМ

cisStatusId

string

Код статуса КМ

Идентификатор статуса КМ на территории государства-члена ЕАЭС. Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true". Возможные значения:

"00" - не определён;
"1" - в обороте на территории государства-члена ЕАЭС;
"2" - не в обороте на территории государства-члена ЕАЭС

cisStatusName

string

Название статуса КМ

Наименование статуса КМ на территории государства-члена ЕАЭС. Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true". Если значение отсутствует, то указывается "Не определён"

expireDate

string(date)

Дата истечения срока годности

Возвращается в ответе только для товарной группы "Молочная продукция". Формат: yyyy-MM-dd

registered

boolean

Признак наличия КМ в ГИС МТ

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true". Возможные значения:

true — КМ зарегистрирован в БД ГИС МТ;
false — КМ в БД ГИС МТ не найден

productGroup

string (enum)

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

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true" и "registered" ("Признак наличия КМ в ГИС МТ") = "true". См. "Справочник «Список поддерживаемых товарных групп»"

cisStatus

string

Статус КМ в ГИС МТ

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true". См. справочник "Актуальные статусы"

emissionType

string

Тип эмиссии КМ в ГИС МТ

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true" и подан документ "Приёмка отгрузки из ЕАЭС" (LP_ACCEPT_GOODS). См. "Справочник «Типы эмиссии КИ»"

statusEx

string

Дополнительный статус товара в ГИС МТ

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true". См. справочник "Актуальные особые состояния"

gtin

string

Код товара

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true"

productName

string

Наименование товара

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true"

brand

string

Бренд

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true"

tnvedGroup

string

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

Возвращается в ответе, только если "authenticity" ("Признак подлинности КМ") = "true"

babyFoodProduct

string

Продукция для детского питания

Возвращается в ответе только для товарной группы "Молочная продукция" и если "authenticity" ("Признак подлинности КМ") = "true"

milkProductType

string

Тип продукта

rawOrigin

string

Происхождение сырья

structure

string

Состав

vetisId

string

Идентификатор товара в ФГИС "ВетИС"

volumeWeight

string

Заявленный объём/вес нетто

fat

string

Жирность, %

Специфичные параметры в ответе возвращаются только для товарной группы "Молочная продукция". Специфичные параметры для товарных групп "Обувные товары", "Предметы одежды, бельё постельное, столовое, туалетное и кухонное", "Шины и покрышки пневматические резиновые новые" в ответе не возвращаются.

5.1.6. Метод проверки готовности товара к вывозу в ЕАЭС

Метод предназначен для проверки доступности корректной отгрузки товаров в выбранное государство-член ЕАЭС, в том числе если участник оборота товаров, формирующий запрос, не является владельцем кода товаров, а товар, по которому запрашивается информация, отсутствует на балансе.

Проверка доступна только для кодов товаров, произведённых в РФ и Республике Беларусь.

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

URL: /cises/eaes/check-export

Метод: POST

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

curl -X POST "<url стенда>/cises/eaes/check-export?pg=milk&countryCode=417"
-H "Content-Type: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

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

Если отсутствует, то поиск осуществляется по всем товарным группам

countryCode

integer

Код страны по справочнику ОКСМ

Доступные значения:

"112" – Республика Беларусь;
"417" – Кыргызская Республика;
"398" – Республика Казахстан;
"051" – Республика Армения

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

{
   "codes":[
      "0111111111111111111111111",
      "0222222222222222222222222"
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

codes

[string]

Список КИ

От 1 до 1000 значений в массиве.
Проверка доступна только для кодов товаров, произведённых в РФ и Республике Беларусь

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

{
   "results":[
      {
         "code":"0111111111111111111111111",
         "exportAllow":true
      },
      {
         "code":"0222222222222222222222222",
         "exportAllow":false
      }
   ]
}

Примеры ответа с ошибкой:

{
    "error_message":"Недопустимый код страны"
}

{
    "results": [
      {
        "code": "0333333333333333333333333",
        "errorMessage": "По запрашиваемому КИ информация о товаре не найдена в НК",
        "errorCode": 404
      }
    ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

array[object]

Список товаров

Массив объектов, включающий все КИ из запроса и результаты проверки по каждому КИ

*code

string

КИ

*exportAllow

boolean

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

Возможные значения:

true – "Товар готов к вывозу в ЕАЭС";
false – "Товар не готов к вывозу в ЕАЭС"

*errorMessage

string

Сообщение об индивидуальной ошибке по КИ

*errorCode

integer

Код индивидуальной ошибки по КИ

error_message

string

Сообщение об общей ошибке

Параметр возвращается при невозможности поиска КИ

5.1.7. Метод верификации кода маркировки

Метод предназначен для проверки наличия в ГИС МТ указанного КИ с криптографической частью. Метод ограничен по частоте запросов (допустимая частота запросов метода - 2 секунды) и количеству КИ в запросе (максимальное количество КИ в запросе - 1000) и не предназначен для вызова с ККТ при сканировании КИ при розничной реализации.

URL: /cises/check

Метод: POST

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

токен участника оборота товаров;
токен Оператора.

Пример тела запроса

{
   "codes":[
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

codes

array of string

Массив кодов для проверки криптохвоста

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

Все коды валидны:

{
    "result": true,
    "quantity": 100
}

Все коды не валидны:

{
    "result": false,
    "quantity": 100
}

Часть кодов не валидна:

{
    "result": false,
    "codes": [
    ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

result

boolean

Признак проверки валидности

true — все КИ валидны;
false — хотя бы один из КИ невалиден

quantity

integer

+/-

Число кодов, прошедших проверку

Параметр возвращается, если абсолютно все КИ имеют одинаковое значение признака проверки валидности. Если КИ имеют разные значения (и "false" и "true"), то параметр в ответе не возвращается

codes

array of string

Список невалидных КИ

Параметр возвращается, если КИ имеют разные значения (и "false" и "true"). Если абсолютно все КИ имеют значение "false", параметр в ответе не возвращается

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

Метод возвращает информацию о движении (истории) запрашиваемых КИ (в одном запросе указывается один КИ) по событиям, в которых участник оборота товаров принимал участие, чей токен используется при выполнении запроса.

Каждому участнику оборота товаров доступна информация о производителе продукции, продавце и текущем владельце. Если КИ выведен из оборота, то информация о текущем владельце не возвращается.

Данный метод рекомендуется использовать вместо «Метода получения истории движения КИ товарной группы «Табачная продукция»», снятого с поддержки.

Тип приватности: публичный (с использованием токена).

URL: /cises/history

Метод: POST

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

curl -X POST "<url стенда>/cises/history?cis=0104600266012258215n4Jh5D"
-H "accept: */*"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

string

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

Указывается только нормализованное значение КИ (без скобок, обрамляющих идентификаторы применения)

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

В случае успеха:

[
   {
      "cis":"string",
      "gtin":"string",
      "productName":"string",
      "producedDate":"2023-03-03T13:21:03.071Z",
      "packageType":"string",
      "ownerInn":"string",
      "ownerName":"string",
      "status":"string",
      "maxRetailPrice":0,
      "child":[
         "array [string]"
      ],
      "parent":"string",
      "producerInn":"string",
      "producerName":"string",
      "timestamp":"2023-03-03T13:21:03.071Z",
      "operationDate":"2023-03-03T13:21:03.071Z",
      "emissionDate":"2023-03-03T13:21:03.071Z",
      "docId":"string",
      "partialSaleInfo":{
         "innerUnitCount":0,
         "soldUnitCount":0,
         "rest":0,
         "correctRest":true
      },
      "turnoverType":"string",
      "productGroup":"string"
   }
]

Если какой-либо параметр не возвращается или приходит пустым, в параметре отображается значение «null».

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

2.1. Код 400 При неправильном формате КИ в URL:

{
  "error_message": "Неверный формат КМ"
}

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

{
  "error_message": "Токен не действителен. Необходимо получить новый токен аутентификации"
}

2.3. Код 404 Если по КИ не найдены операции:

{
  "error_message": "Не найдены операции по запрашиваемому КИ"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

string

КИ ГИС МТ

gtin

string

Код товара

Если код товара менее 14 символов, то он дополняется ведущими нулями

packageType

string

Код типа упаковки

ownerInn

string

ИНН собственника товара

status

string

Код статуса КИ

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

maxRetailPrice

number

Максимальная цена розничной продажи

Только для единицы товара и групповой упаковки. Для групповой упаковки значение = maxRetailPrice*количество штук в групповой упаковке

child

array [string]

Список дочерних КИ в агрегате

parent

string

Родительский КИ

producerInn

string

ИНН Российского производителя в МОТП

timestamp

string (date-time)

Отметка времени

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

emissionDate

string (date-time)

Дата эмиссии

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

operationDate

string (date-time)

Дата создания документа, по которому в последний раз менялся статус КИ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

partialSaleInfo

object

Набор параметров частичного выбытия

Возвращается при частичной реализации по чеку

*innerUnitCount

number

Общее количество или объём товара в потребительской упаковке, шт

*soldUnitCount

number

Количество или объём выведенного из оборота товара по КИ, шт

*rest

number

Количество или объём товара, доступного к выводу из оборота по КИ, шт

*correctRest

boolean

Корректность остатка товара (показатель корректности остатка товара после вывода товара из оборота)

productGroup

string

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

manufacturerInn

string

ИНН производителя товара

importerInn

string

ИНН импортёра товара вне ЕАЭС

docId

string

Номер документа, по которому менялся статус КИ

В ответе возвращаются все номера документов, по которым менялся статус КИ по событиям, в которых участвовал участник оборота товаров, чей токен используется при выполнении запроса

turnoverType

string

Код типа отгрузки

Возможные значения:

«SELLING» — «Продажа»;
«CONTRACT» — «Передача по АКС»

5.3. Метод запроса списка агрегированных КИ

Метод возвращает дочерние КИ первого слоя агрегата. В одном запросе можно указать несколько КИ. Запятая не интерпретируется как разделитель для параметров запроса, а считается частью самого параметра. Метод возвращает все слои для агрегата товарной группы «Табачная продукция». Для групповой упаковки товарной группы «Табачная продукция» метод возвращает все единицы товаров, для транспортной упаковки — все групповые упаковки.

Тип приватности: публичный

Общедоступная информация:

информация о КИ;
данные о производителе;
дата и время производства;
текущий статус в обороте;
текущий владелец — показ только владельцу, ФОИВ, Оператору-ЦРПТ и Администратору.

URL: /cises/aggregated/list

Метод: POST

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

curl -X POST "<url стенда>/cises/aggregated/list"
-H "Authorization: Bearer <ТОКЕН>"
-H "accept: */*"
-H "Content-Type: application/json"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

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

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

[
   "010463333333333321KkKkKK",
   "010463333333333321NNnnNn"
]

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

Параметр

Тип

Обяз.

Описание

Комментарий

—

array of string

Массив КИ

От 1 до 1000 КИ. Указывается только нормализованное значение КИ (без скобок, обрамляющих идентификаторы применения)

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

Параметр

Тип

Обяз.

Описание

Комментарий

—

object

Перечень вложений агрегатов

Допустимые форматы КИ для данного метода см. в документе «Описание вариантов передачи КМ / КИ / КиЗ в разрезе товарных групп и каналов передачи данных». При отсутствии вложений в агрегате, в ответе возвращается пустой массив КИ в квадратных скобках «[]»

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

В случае успеха:

{
   "010463333333333321KkKkKK":{
      "010465555555555521KkKkKK":[

      ],
      "010465555555555521TvvVvv":[

      ]
   },
   "010463333333333321NNnnNn":{
      "010465555555555521TvvVNn":[

      ],
      "010465555555555521TvvVNN":[

      ]
   }
}

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

2.1. Код 200 при неизвестных КИ:

{

}

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

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

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

{
   "error_message":"Тело запроса не может быть пустым"
}

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

{
   "error_message":"Некорректный JSON. Данные ошибки: Unexpected character ('1' (code 49)): was expecting comma to separate Array entries. java.util.ArrayList[1] [line: 2, column: 5]"
}

2.5. Код 401 при отсутствии токена:

{
   "error_message":"Токен не действителен. Необходимо получить новый токен аутентификации"
}

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

Метод предназначен для получения истории дезагрегации агрегатов по КИ всех товарных групп. Ограничение по количеству указываемых в запросе КИ: 1.

Проверка принадлежности по владельцу КИ, агрегатов не осуществляется. В ответе возвращается только прямой КИ агрегата, без вложенности второго, третьего уровня. Вложенность по агрегированным КИ не выводится.

Тип приватности: публичный

URL: /cises/history/list

Метод: POST

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

curl -X POST "<url стенда>/cises/history/list"
-H "accept: */*"
-H "Authorization: Bearer <ТОКЕН>"
-H "Content-Type: application/json"

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

{
  "cis": "010000001111111121NN88nNN"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

string

КИ

Не более 1 КИ единицы товара, групповой упаковки, комплекта, набора, агрегата, АТК.

Указывается только нормализованное значение КИ (без скобок, обрамляющих идентификаторы применения)

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

{
   "cisAggregation":[
      {
         "cis":"string",
         "operationType":"AGGREGATION",
         "packageType":"LEVEL1",
         "parent":"string"
      },
      {
         "cis":"string",
         "operationType":"AUTODISAGGREGATION",
         "operationDate":"2021-08-10T10:11:01.000Z",
         "packageType":"LEVEL1",
         "parent":"string"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

cisAggregation

array

Список, содержащий историю агрегации КИ

*cis

string

КИ

*operationType

string

Тип операции

Возможные значения:

AGGREGATION — сформирован;
DISAGGREGATION — расформирован;
AUTODISAGGREGATED — автоматически расформирован

*operationDate

string

Дата и время операции

Возвращается в формате yyyy-MM-dd HH:mm:ss

*packageType

string

Тип упаковки

*extendedPackageType

string

Тип агрегата

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

*parent

string

КИ агрегата, в который агрегирован данный КИ

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

Тип приватности: c токеном авторизации

URL: /api/v4/true-api/tn-ved/search

Метод: POST

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

POST <url стенда>/api/v4/true-api/tn-ved/search
Content-Type: application/json
Authorization: Bearer token

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

{
   "pg":["string"],
   "tnveds":["string"],
   "page":0,
   "limit":100,
   "sort":"tnved",
   "direction":"ASC"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

array of string

Список товарных групп

Обязательный, если не указан параметр «tnveds» («Коды ТН ВЭД»). См. «Справочник «Список поддерживаемых товарных групп»»

tnveds

array of string

Коды ТН ВЭД

Обязательный, если не указан параметр «pg» («Список товарных групп»). Значение может состоять от 4 до 10 цифр включительно

page

integer

Номер страницы

Используется для пагинации. Начинается с «0»

limit

integer

Количество элементов массива выходного объекта

Максимально допустимое значение — 1000, минимально допустимое значение — 1

sort

string

Колонка для сортировки

Название параметра, по которому будет осуществляться сортировка в ответе. Значение по умолчанию — «tnved»

direction

string

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

Возможные значения:

«ASC» – по возрастанию (по умолчанию);
«DESC» – по убыванию

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

{
   "tnveds":[
      {
         "tnved":"string",
         "description":"string",
         "pg":"milk"
      },
      {
         "tnved":"string",
         "description":"string",
         "pg":"milk"
      }
   ],
   "total":2,
   "last":true
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

tnveds

array of objects

Массив выходных объектов

При отсутствии значения параметра «tnveds» («Коды ТН ВЭД») в ГИС МТ возвращается пустой массив

*tnved

string

Код ТН ВЭД

Код ТН ВЭД (10 цифр). Если в параметре запроса «tnveds» («Коды ТН ВЭД») был передан только префикс кода ТН ВЭД, то в ответе будут все коды ТН ВЭД из 10 цифр, найденные по префиксу

*description

string

Текстовое описание кода ТН ВЭД

*pg

string

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

См. «Справочник «Список поддерживаемых товарных групп»». Если значение параметра «tnved» («Код ТН ВЭД») встречается в нескольких товарных группах, то для каждой товарной группы передаётся свой элемент массива

total

integer($int64)

Всего записей

last

boolean

Последняя запись на странице

errorMessage

string

Описание ошибки

Возвращается только при наличии ошибки при выполнении запроса

errorCode

string

Код ошибки

Возвращается только при наличии ошибки при выполнении запроса

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

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

В результате успешного выполнения запроса по списку кодов товаров в ответе возвращается массив с информацией о товарах по запрошенным КИ. В результирующем * .json также может содержаться набор полей, специфичных для товара конкретной товарной группы (см. «Справочник "Дополнительные параметры в ответе в зависимости от товарных групп"»).

Действует следующее ограничение: не более 1000 значений «gtin» («Код товара») в параметре «gtins» («Массив кодов товаров»).

В ответе метода возвращается информация только по карточкам товаров, для которых значения признаков «goodTurnFlag» («Признак готовности товара к обороту») и «goodMarkFlag» («Признак готовности к маркировке») = «true».

Тип приватности: публичный

URL: /api/v4/true-api/product/info

Метод: POST

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

curl -X POST "<стенд>/api/v4/true-api/product/info"
-H "accept: */*"
-H "Content-Type: application/json"
-H "Authorization: Bearer <ТОКЕН>"
-d "{\"gtins\":[\"string\"]}"

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

Параметр

Тип

Обяз.

Описание

Комментарий

gtins

array[string]

Список GTIN, для которых нужно получить информацию

Максимальное количество кодов товаров в списке — 1000

rdInfo

boolean

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

Возможные значения:

«true» — получить сведения о разрешительном документе;
«false» — не получать сведения о разрешительном документе (значение по умолчанию).

Максимальное количество возвращаемых разрешительных документов в ответе — 1000

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

{
   "results":[
      {
         "name":"ХХХХХХХХХХ ХХХХХХ ХХХХ 1",
         "gtin":"04611111111111",
         "brand": "ХХХХХХ",
         "packageType":"UNDEFINED",
         "innerUnitCount":1,
         "inn":"7777777777",
         "permittedInns":[
            "011111111100",
            "2222222222"
         ],
         "productGroupId":8,
         "productGroup":"milk",
         "goodSignedFlag":true,
         "goodMarkFlag":true,
         "goodTurnFlag":true,
         "isKit":true,
         "isTechGtin":false,
         "isSet":true,
         "setGtin":[

         ],
         "level":"trade-unit",
         "mainGtin":"04611111111111",
         "multiplier":1,
         "conformityDeclaration":"6527112",
         "permits":{
            "conformityDeclaration":[
               "6527112"
            ]
         }
      }
   ],
   "total":1
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

array

Список товаров

*name

string

Наименование товара

*gtin

string

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

Формат кода товара: 14 цифр (с лидирующими нулями). Количество возвращаемых кодов товаров в ответе не может быть больше числа запрошенных.

Возвращается информация только по кодам, в карточках товаров которых значения признаков «goodTurnFlag» («Признак готовности товара к обороту») и «goodMarkFlag» («Признак готовности к маркировке») = «true»

*brand

string

Бренд

*subBrand

string

Суббренд

*privateBrand

string

Собственная торговая марка

*packageType

string

Тип упаковки

В ответе возвращаются значения типов упаковок, указанных в карточке товара в НКМТ

*innerUnitCount

integer

Количество товара в упаковке

*model

string

Модель / артикул производителя

*inn

string

ИНН владельца кода товара (GTIN)

Возвращается владельцам и тем, кто имеет доступ по механизму субаккаунта

*exporter

object

Заявитель маркируемого и вводимого в оборот товара

Для участников оборота товаров, не являющихся владельцами, параметр не возвращается

**exporterName

string

Наименование заявителя

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ и возврате объекта «exporter» («Заявитель маркируемого и вводимого в оборот товара»)

**exporterTaxpayerId

string

ИНН или его аналог (налоговый идентификатор) заявителя

**kpp

string

КПП или его аналог

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

**gcp

string

Глобальный идентификатор компании в GS1

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ. Возвращается обязательно при возврате объекта «exporter» («Заявитель маркируемого и вводимого в оборот товара»). Для участников оборота товаров, не являющимися владельцами, параметр не возвращается

**gln

string

Глобальный идентификатор места нахождения

**manufactureAddress

string

Адрес производственной площадки

*permittedInns

array[string]

Массив ИНН компаний-субаккаунтов, которым владелец GTIN предоставил возможность использования данного GTIN для заказа КМ

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ. Параметр возвращается для владельца кода товара

*productGroupId

integer

id товарной группы

*goodSignedFlag

boolean

Признак подписания карточки товара в НКМТ

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

*goodMarkFlag

boolean

Признак готовности к маркировке

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

*goodTurnFlag

boolean

Признак готовности к обороту

Индикатор заполнения второго слоя и подписания карточки товара в НКМТ. Для карточки товара, описанной по короткому атрибутивному составу и карточки, созданной по API, подпись для признака «goodTurnFlag» не проверяется, поскольку данная карточка товара не подписывается. Если значение параметра = «true», то доступен заказ КМ и ввод товара в оборот.

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

*isKit

boolean

Признак «Комплект» в карточке товара в НКМТ

*isTechGtin

boolean

Признак «Технологический» в карточке товара в НКМТ

Если в НКМТ атрибут не заполнен, то в ответе возвращается null

*explain

string

Ошибка заполнения атрибутов и подписания карточки товара в НКМТ

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

*foreignProducer

object

Объект с данными о производителе

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

**name

string

Наименование производителя

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ. Возвращается обязательно при возврате объекта «foreignProducer» («Объект с данными о производителе»)

**inn

string

ИНН (или его аналог) производителя

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

**kpp

string

КПП (или его аналог) производителя

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

**gcp

string

GCP производителя

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ. Для участников оборота товаров, не являющимися владельцами, параметр не возвращается

**gln

string

GLN производителя

**address

array of string

Массив адресов производителя

*isSet

boolean

Признак «Набор» в НКМТ

Для карточки набора принимает значение «true» после изменения значения «isKit» («Признак «Комплект» в карточке товара») с «true» на «false».

Для карточки единицы товара принимает значение «false» после изменения значения «isKit» («Признак «Комплект» в карточке товара») с «true» на «false»

*setGtin

array[object]

Массив кодов товара, входящих в состав набора

Возвращается в ответе, если «isSet» («Признак «Набор» по карточке товара в НК») = «true» при условии указания сведений в карточке товара в НКМТ

**gtin

string

Код товара

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

**quantity

integer

Количество кодов товаров

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

*level

string

Уровень упаковки

Значения:

«trade-unit» — единица товара;
«inner-pack» — групповая упаковка

*mainGtin

integer

Код товара вложения в упаковку (GTIN потребительской упаковки). Параметр является обязательным, если значение параметра «level" («Уровень упаковки») не равно «trade-unit» («Единица товара»)

Возвращается в ответе при условии указания сведений в карточке товара в НКМТ

*multiplier

integer

Количество вложений в упаковку

*reasonCertMissing

string

Требования подтверждения соответствия отсутствуют; основание

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

*reasonCertMissingDetails

object

Требования подтверждения соответствия отсутствуют; основание (раздельный)

**value

string

Значение атрибута

**type

string

Тип атрибута

**typeBool

boolean

Тип атрибута

Возможные значения:

«true» — если «type» = «ДА»;
«false» — если «type» != «ДА» или отсутствует

*goodStatus

string

Статус карточки товара из НКМТ

Возможные значения:

«draft» — статус карточки товара в НКМТ: «Черновик», «На модерации», «Требует изменений», «Ожидает подписания»;
«published» — статус карточки товара в НКМТ: «Опубликована» — карточка товара, подписанная УКЭП;
«archived» — статус карточки товара в НКМТ: «В архиве» — карточка товара в архиве.

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

*productGroup

string

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

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

*standardNumber

string

Номер регламента / стандарта

*tnVedCode

string

Группа ТН ВЭД

*tnVedCode10

string

Код ТН ВЭД

*certDocList

array of object

Сведения о разрешительном документе

Возвращается при указании в запросе «rdInfo» = «true»

**type

string

Вид разрешительного документа

См. «Справочник «Виды разрешительной документации»»

**number

string

Номер разрешительного документа

**date

string

Дата оформления разрешительного документа

Формат: yyyy-MM-dd

**dateTo

string

Дата окончания действия разрешительного документа

Формат: yyyy-MM-dd

**series

string

Серия разрешительного документа из РФ

Возвращается для REGISTRATION_VET_CERTIFICATE

**guid

string

Глобальный идентификатор продукции

Возвращается для REGISTRATION_VET_CERTIFICATE

**active

boolean

Статус активности разрешительного документа

Возможные значения:

«true» — действительный;
«false» — недействительный

**unlimited

string

Признак отсутствия установленной даты окончания срока действия

Возвращается для REGISTRATION_VET_CERTIFICATE

**errorCode

integer

Код ошибки

**errorMessage

string

Текст ошибки

*authDocNumber

string

Номер разрешительного документа

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

*isAutoAttachPermitsInfoDetails

object

Автоприкрепление сведений по ДС / СС к кодам идентификации (раздельный)

**value

string

Значение атрибута

**typeBool

boolean

Тип атрибута

Возможные значения:

«true» — если «value» = «ДА»;
«false» — если «value» != «ДА»

*okpd2Group

string

Код ОКПД2

*okpd2Code

string

Код ОКПД2 (опционально)

*isExcisableProduct

boolean

Признак подакцизности товара

Может вернуться для подакцизных товарных групп. Возможные значения:

«true» — товар подакцизный;
«false» — товар не подакцизный

*exciseProductCode

string

Код подакцизного товара

Возвращается только при «isExcisableProduct» = «true»

*quantityInPack

integer

Количество единиц употребления в потребительской упаковке / Заявленный объём

Возвращается для товарных групп, которым доступна частичная реализация

*quantityInPackType

string

Единица измерения по атрибуту «Количество единиц употребления в потребительской упаковке» / Единица измерения по атрибуту «Заявленный объем»

Выводится совместно с атрибутом «quantityInPack»

*basicUnit

string

Базовая единица измерения

*setDescription

string

Состав набора

*fullName

string

Полное наименование товара

*methodProduction

string

Способ (вид) производства / обработки

*releaseForm

string

Форма выпуска

*storageConditions

string

Условия хранения

*storageCondition

array

Идентификатор и условия хранения

**storageConditionName

string

Условия хранения

**storageConditionId

integer

Идентификатор хранения

*isVarQuantity

boolean

Признак переменного веса

Возможные значения:

«true» — да;
«false» — нет

*volumeWeight

string

Заявленный объём / вес нетто

*weightMin

string

Диапазон веса, от

*weightMax

string

Диапазон веса, до

*coreVolume

integer

Вычисленный объём продукта в мл

*coreWeight

integer

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

Если товар имеет признак переменного веса «isVarQuantity» = «true», то значение веса определяется как среднее арифметическое между параметрами «weightMin» и «weightMax».

Для товарной группы «Консервированная продукция» значение веса определяется по значению из «netWeight» («Масса нетто»), если для товара заполнен и «netWeight» («Масса нетто»), и «volumeWeight» («Заявленный объём / вес нетто»)

*volumeTradeUnit

string

Объём потребительской единицы

*expireDuration

string

Срок годности товара

*colors

array of strings

Массив уникальных значений цветов изделия

*conformityCertificate

array of strings

Список идентификаторов сертификатов соответствия

*conformityDeclaration

array of strings

Список идентификаторов деклараций соответствия

*registrationCertificate

array of strings

Список идентификаторов регистрационных удостоверений

*stateRegistrationCertificate

array of strings

Список свидетельств о государственной регистрации удостоверений

*permits

object

Сведения о разрешительной документации

**conformityCertificate

array of strings

Список идентификаторов сертификатов соответствия

**conformityDeclaration

array of strings

Список идентификаторов деклараций соответствия

**registrationCertificate

array of strings

Список идентификаторов регистрационных удостоверений

**stateRegistrationCertificate

array of strings

Список свидетельств о государственной регистрации удостоверений

**vetRegistrationCertificate

array of strings

Регистрационное удостоверение в государственном реестре

*mc

array of objects

Вычисленная минимальная цена для кода товара в копейках c датами

Возвращается для товарных групп «Альтернативная табачная продукция» и «Никотиносодержащая продукция» при наличии в карточке товара НКМТ минимальной цены

**mcName

string

Наименование ставки минимальной цены

**mcTariff

integer

Номер ставки минимальной цены

**mcGtinCop

integer

Минимальная цена в копейках, вычисленная с учётом массы / объёма продукции с точностью до тысячной доли г / мл

Для групповой упаковки вычисляется на основании единицы товара и количества вложений в упаковку

**dateFrom

string

Дата, с которой действует минимальная цена, включительно

**dateTo

string

Дата, до которой действует минимальная цена, включительно

total

integer

Количество найденных товаров

errorCode

string

Код ошибки

Возвращается при наличии ошибки

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

Метод возвращает список кодов товаров с возможностью указания параметров фильтрации в запросе. Для товарной группы «Альтернативная табачная продукция» в ответе отсутствует информация по кодам товаров, добавленным с помощью пользовательского интерфейса или через «Метод создания и обновления товаров» раздела «Методы «Национального каталога»».

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

URL: /product/gtin

Метод: GET

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

curl -X GET "<url стенда v4>/product/gtin?includeSubaccount=false&limit=2&page=0&pg=tobacco"
-H "accept: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

limit

integer($int32)

Максимальное количество заказов КМ в ответе

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

page

integer($int32)

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

string

Наименование товарной группы

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

includeSubaccount

boolean

Субаккаунт

Если значение = true, то в ответе возвращаются данные по всем кодам товаров: принадлежащих участнику оборота товаров и предоставленных ему через субаккаунт. Если значение = false, то в ответе возвращаются данные только по коду товара, принадлежащему участнику оборота товаров. Значение по умолчанию = false

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

array of objects

В ответе возвращается по тем «gtin», по которым найдены сведения, и которые удовлетворяют условиям поиска

*goodStatus

string

Статус карточки товара в НК

Возможные значения: draft - черновик, на модерации, требует изменений, ожидает подписания; published - опубликована; archived - в архиве

*gtin

string

Код товара

*isGtinSubaccount

boolean

Признак принадлежности кода товара субаккаунту

Если значение = true — субаккаунту был предоставлен доступ к этому коду товара. Если значение = false — код товара собственный

*isKit

boolean

Признак «Комплект» в карточке товара

Возвращается в ответе при условии указания сведений в карточке товара в НК. Принимает значение «false» при изменении карточки комплекта на карточку набора или на карточку единицы товара для товарных групп «Духи и туалетная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»

*isSet

boolean

Признак «Набор» по карточке товара в НК

Возвращается в ответе при условии указания сведений в карточке товара в НК. Для карточки набора принимает значение «true» после изменения значения «isKit» («Признак «Комплект» в карточке товара») с «true» на «false» для товарных групп «Духи и туалетная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки».

Для карточки единицы товара принимает значение «false» после изменения значения «isKit» («Признак «Комплект» в карточке товара») с true на false для товарных групп «Духи и туалетная вода», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»

*permittedInns

array of string

Массив ИНН компаний-субаккаунтов, которым владелец кода товара предоставил возможность использовать данный код товара для заказа КМ

Возвращается в ответе при условии указания сведений в карточке товара в НК и только владельцу кода товара

*setDescription

string

Описание состава набора

Возвращается описание товара в составе набора, содержащее параметры, специфичные для конкретного товара. Данный параметр вернётся в том случае, если он заполнен в карточке НК (см. «Справочник "Дополнительные параметры в ответе в зависимости от товарных групп"»)

*setGtin

array of objects

Массив кодов товаров, входящих в набор

Возвращается в ответе, если «isSet» («Признак «Набор» по карточке товара в НК») = true

**gtin

string

Код товара

**quantity

integer (int64)

Количество кодов товаров

total

number

Количество найденных товаров

errorCode

string

Код ошибки

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

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

В случае успеха:

{
  "results": [
    {
      "gtin": "string",
      "goodStatus": "string",
      "isKit": false,
      "isSet": true,
      "isGtinSubaccount": true,
      "setGtin": [
        {
          "gtin": "string",
          "quantity": 0
        }
      ],
      "setDescription": "string"
    }
  ],
  "total": 0,
  "errorCode": "string"
}

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

2.1. Код 400 При неверном значении товарной группы в параметре pg:

{
   "error_message": "Could not determine product group by name 'shoe'"
}

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

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

5.7. Метод получения информации о разрешительном документе по его номеру

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

Тип приватности: публичный

URL: /api/v4/true-api/rd/list

Метод: POST

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

curl -X POST "<url стенда>/api/v4/true-api/rd/list"
-H "accept: */*"
-H "Content-Type: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

{
   "documents":[
      {
         "type":"STATE_REGISTRATION_CERTIFICATE",
         "number":"string"
      },
      {
         "type":"CONFORMITY_DECLARATION",
         "number":"string",
         "dateFrom":"2025-01-01"
      }
   ]
}

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

Параметр

Обяз.

Тип

Описание

Комментарий

documents

array of object

Сведения о разрешительных документах

Должен быть указан хотя бы один разрешительный документ и его номер. Максимальное количество объектов массива — 25

type

string

Вид разрешительного документа

См. «Справочник «Виды разрешительной документации»»

number

string

Номер разрешительного документа

dateFrom

string

Дата оформления разрешительного документа

Обязательный для CONFORMITY_CERTIFICATE, CONFORMITY_DECLARATION. Указание для STATE_REGISTRATION_CERTIFICATE допускается, но игнорируется при запросе. Формат: yyyy-MM-dd

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

В случае успеха:

1.1. Код 200, разрешительные документы найдены:

{
   "result":{
      "documents":[
         {
            "type":"STATE_REGISTRATION_CERTIFICATE",
            "number":"string",
            "dateFrom":"2012-10-24",
            "dateTo":"2032-10-24",
            "productName":"string",
            "manufacturerProductName":"string",
            "getProductName":"string",
            "active":false,
            "update_date":"2024-03-11 11:06:34",
            "indx":375930
         },
         {
            "type":"CONFORMITY_CERTIFICATE",
            "number":"string",
            "dateFrom":"2012-10-24",
            "productType":"string",
            "productName":"string",
            "applicantProductName":"string",
            "applicantProductType":"string",
            "manufacturerProductName":"string",
            "manufacturerProductType":"string",
            "productTnved":"string",
            "productTechRegulations":"string",
            "status":"string",
            "updateDate":"2024-03-11 11:06:34",
            "indx":320587
         }
      ]
   }
}

1.2. Код 200, разрешительные документы не найдены:

{
   "result":{
      "documents":[

      ],
      "errors":[
         {
            "code":"string",
            "message":"string",
            "number":"string"
         },
         {
            "code":"string",
            "message":"string",
            "number":"string"
         }
      ]
   }
}

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

2.1. Код 400, если не передано тело запроса:

{
   "error_message":"Тело запроса не может быть пустым"
}

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

{
   "error_message":"Некорректный JSON тела запроса"
}

2.3. Код 400, если не указан обязательный параметр или указан с пустым значением:

{
   "error_message":"Не указан обязательный параметр <название параметра>"
}

2.4. Код 400, если в теле запроса указано более 25 разрешительных документов:

{
   "error_message":"Количество элементов <название параметра> в запросе не должно превышать 25"
}

2.5. Код 400, если в теле запроса значение вне списка допустимых или равно null:

{
   "error_message":"Параметр <название параметра> передан с недопустимым значением"
}

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

{
   "error_message":"Параметр <название параметра> передан с недопустимым форматом"
}

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

Параметр

Обяз.

Тип

Описание

Комментарий

result

object

Результат

*documents

array of object

Массив найденных разрешительных документов

**type

string

Вид разрешительного документа

См. «Справочник «Виды разрешительной документации»»

**number

string

Номер разрешительного документа

**dateFrom

string

Дата оформления разрешительного документа

Формат: yyyy-MM-dd

**dateTo

string

Дата окончания действия разрешительного документа

Формат: yyyy-MM-dd

**productType

string

Тип разрешительного документа

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**productName

string

Наименование продукции

**productCountry

string

Страна происхождения продукции

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**applicantProductName

string

Наименование заявителя

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**applicantProductType

string

Тип заявителя

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**manufacturerProductName

string

Наименование изготовителя (производителя)

**manufacturerProductCountry

string

Страна изготовителя (производителя)

Возвращается для STATE_REGISTRATION_CERTIFICATE

**manufacturerProductType

string

Тип изготовителя (производителя)

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**getProductName

string

Наименование получателя

Возвращается для STATE_REGISTRATION_CERTIFICATE

**getProductCountry

string

Страна получателя

Возвращается для STATE_REGISTRATION_CERTIFICATE

**productTnved

string

Код ТН ВЭД ЕАЭС

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**productIdentification

object

Сведения о продукции, обеспечивающие её идентификацию

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

***type

string

Тип

***tradeMark

string

Марка

***model

string

Модель

***article

string

Артикул

***sort

string

Сорт

**productTechRegulations

string

Технический регламент (на основании которого изготовлена продукция)

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**status

string

Статус разрешительного документа

Возвращается для:

CONFORMITY_CERTIFICATE;
CONFORMITY_DECLARATION

**active

boolean

Признак того, что разрешительный документ является действительным

Возвращается для STATE_REGISTRATION_CERTIFICATE. Возможные значения:

true — действительный;
false — недействительный

**updateDate

string

Дата изменения данных в Системе маркировки

Формат: yyyy-MM-dd HH:mm:ss

**indx

integer

Индекс, присвоенный разрешительному документу

*errors

array of object

Массив ошибок

**code

string

Код ошибки

**message

string

Текст ошибки

**number

string

Номер разрешительного документа

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

Методы позволяют участнику оборота товаров запросить сведения о КИ, находящихся в собственности его контрагента. Со стороны ГИС МТ при этом осуществляется проверка наличия действующего согласие о предоставлении информации о КИ, выданное участнику оборота товаров, запрашивающего информацию ок КИ. В ответ участник оборота товаров получает запрашиваемую информацию, либо отказ в предоставлении запрашиваемой информации.

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

Метод формирует черновик, который подписывается УКЭП генерального директора в личном кабинете ГИС МТ. В ГИС МТ может находиться только один действующий документ согласия о предоставлении сведений.

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

URL: /agreement-registry/agreement

Метод: POST

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

curl -X POST "<url стенда>/agreement-registry/agreement"
-H "accept: application/json"
-H "Content-Type: application/json"
-H "Authorization: Bearer <ТОКЕН>"
--data-raw "{\"trustedInns\":[\"string\"],\"everyonePermitted\":true,\"expirationDate\":yyyy-MM-ddTHH:mm:ss.SSS'Z}"

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

{
  "trustedInns": [
    "string"
  ],
  "everyonePermitted": true,
  "expirationDate": "string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trustedInns

[string]

Список доверенных ИНН контрагентов

everyonePermitted

boolean

Признак предоставления согласия для всех контрагентов

При необходимости подписания согласия для всех контрагентов значение параметра должно быть "true", при этом параметр "trustedInn" должен быть пустым. Заполнение обоих параметров одновременно недопустимо. При передаче списка ИНН доверенных контрагентов в параметре "trustedInn" параметр "everyonePermitted" должен быть либо пустым, либо иметь значение "false". Параметр "everyonePermitted" автоматически принимает значение "false" при передаче пустого значения

expirationDate

string (date-time)

Дата окончания срока действия согласия

Формат: yyyy-MM-ddTHH:mm:ss.SS’Z. Значение не может превышать дату окончания срока действия используемой УКЭП. Значение устанавливаемой даты не может быть меньше текущей даты создания документа согласия о предоставлении сведений

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

1.В случае успеха 201 "Документ успешно создан".

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

2.В случае ошибки 400 (документ не прошёл валидацию);

[
   {
      "message":"Для опубликованной ревизии согласия существует документ аннулирования в статусе 'На подготовке'",
      "object":[

      ]
   },
   {
      "message":"Срок действия документа не должен заканчиваться позже даты окончания действия сертификата",
      "object":[

      ]
   },
   {
      "message":"ИНН не зарегистрированы в системе",
      "object":[
         "string"
      ]
   },
   {
      "message":"ИНН организации, создающей документ согласия, не может находиться в списке доверенных ИНН",
      "object":[
         "string"
      ]
   },
   {
      "message":"Срок действия документа не должен заканчиваться раньше текущей даты",
      "object":[
         "string"
      ]
   },
   {
      "message":"У УОТа уже есть актуальная ревизия согласия",
      "object":[
         "string"
      ]
   },
   {
      "message":"Список доверенных ИНН пустой",
      "object":[
         "string"
      ]
   }
]

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

message

string

Сообщение об ошибке

Возвращается только в случае ошибки

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

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

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

Производители / импортёры продукции.
Покупатели продукции (Оптовик, Розница).

URL: /agreement-registry/cancellation

Метод: POST

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

curl -X POST "<url стенда>/agreement-registry/cancellation"
-H "accept: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

1.В случае успеха 201 "Документ успешно создан".

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "string",
  "statusCode": "ESTABLISHED",
  "sign": {
    "fingerPrint": "string",
    "serialNumber": "string",
    "inn": "string",
    "owner": "string",
    "organisationName": "string",
    "validityDateFrom": 0,
    "validityDateUpTo": 0,
    "signingTime": 0
  },
  "documentRegNumber": "string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

status

string

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

statusCode

string

Код статуса документа

Возможные значения:
ESTABLISHED - сформирован (присваивается при записи документа в БД после успешного прохождения всех проверок);
SIGNED - подписан (присваивается по факту подписания пользователем);
REJECTED - отклонён (присваивается, если пользователь отказывается от подписания документа);
OUTDATED - устарел (присваивается в случае, если документ был подписан ранее, но вместо него был подписан новый документ);
CANCELLED - аннулирован (присваивается в случае аннулирования документа)

sign

object

УКЭП

*fingerPrint

string

Отпечаток сертификата

*serialNumber

string

Серийный номер

*validityDateFrom

integer($int64)

Действителен с

*validityDateUpTo

integer($int64)

Действителен до

*signingTime

integer($int64)

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

documentRegNumber

string

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

1.В случае успеха 201 "Документ успешно создан".

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "string",
  "statusCode": "ESTABLISHED",
  "sign": {
    "fingerPrint": "string",
    "serialNumber": "string",
    "inn": "string",
    "owner": "string",
    "organisationName": "string",
    "validityDateFrom": 0,
    "validityDateUpTo": 0,
    "signingTime": 0
  },
  "documentRegNumber": "string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

status

string

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

statusCode

string

Код статуса документа

sign

object

УКЭП

*fingerPrint

string

Отпечаток сертификата

*serialNumber

string

Серийный номер

*validityDateFrom

integer($int64)

Действителен с

*validityDateUpTo

integer($int64)

Действителен до

*signingTime

integer($int64)

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

documentRegNumber

string

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

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

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

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

Приватный.
Оператор.

URL: /agreement-registry/agreement/list

Метод: GET

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

curl -X GET "<url стенда>/agreement-registry/agreement/list?expirationDate.from=2021-06-22T07:04:42.000Z&expirationDate.to=2021-09-22T07:04:42.000Z&offset=0&limit=10&sort=publicationDate&direction=DESC"
-H "accept: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantId

integer($int64)

ID участника оборота товаров

participantInn

string

ИНН участника оборота товаров

documentRegNumber

string

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

status

string

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

publicationDate

object

Фильтр по дате подписания документа

*from

string

Начало периода

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*to

string

Конец периода

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

createDate

object

Фильтр по дате создания документа

*from

string

Начало периода

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*to

string

Конец периода

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

expirationDate

object

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

*from

string

Начало периода

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*to

string

Конец периода

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

offset

integer($int64)

Смещение страницы

Значение по умолчанию: 0

limit

integer($int32)

Предельное количество записей

Значение по умолчанию: 0

sort

string

Параметр фильтрации

Доступные параметры для фильтрации: "publisherId", "agreementCancellations", "agreement", "revisionNumber", "rejectionDate", "creatorId", "trustedOrganisations", "id", "publicationDate", "createDate", "status", "printForm"

direction

string

Направление фильтрации

Возможные значения:
ASC – по возрастанию;
DESC – по убыванию

В запросе должен быть указан хотя бы один параметр, иначе в ответе возвращается ошибка 400 "Bad request" (ошибка в параметрах запроса).

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

В случае успеха 200 "Данные успешно получены".

{
   "results":[
      {
         "agreementRevisionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "createDate":0,
         "publicationDate":0,
         "expirationDate":"string",
         "status":"string",
         "creatorId":0,
         "publisherId":0,
         "cancellation":{
            "id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "createDate":"2021-01-31T16:40:48.549Z",
            "publicationDate":"2020-01-31T16:40:48.549Z",
            "status":"string",
            "statusCode":"string",
            "creatorId":0,
            "publisherId":0,
            "documentRegNumber":"string"
         },
         "documentRegNumber":"string"
      }
   ],
   "total":0,
   "errorCode":"string",
   "last":true
}

В случае ошибки 400 "Входные параметры некорректны", ошибки 500 "Ошибка при выполнении запроса".
```
{
   "error":"string",
   "error_description":"string"
}
```

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

Параметр

Тип

Обяз.

Описание

Комментарий

result

[array]

Результат запроса

*agreementRevisionId

string($uuid)

Первичный ключ (ID документа согласия о предоставлении информации)

*createDate

integer($int64)

Дата создания документа

*publicationDate

integer($int64)

Дата подписания документа

*expirationDate

string (date-time)

Дата окончания срока действия согласия

Формат: yyyy-MM-ddTHH:mm:ss.SS’Z

*status

string

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

*creatorId

integer($int64)

ID участника оборота товаров, создавшего документ

*publisherId

integer($int64)

ID участника оборота товаров, подписавшего документ

*cancellation

object

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

**id

string

ID Документа

**createDate

string (date-time)

Дата создания документа

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

**publicationDate

string (date-time)

Дата подписания документа

Формат: yyyy-MM-ddTHH:mm:ss.SS’Z

**status

string

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

**statusCode

string

Код статуса документа

**creatorId

integer($int64)

ID участника оборота товаров, создавшего документ

**publisherId

integer($int64)

ID участника оборота товаров, подписавшего документ

**documentRegNumber

string

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

*documentRegNumber

string

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

total

integer($int64)

Всего записей

errorCode

string

Описание ошибки

Возвращается в случае ошибки

last

boolean

Последняя запись на странице

error

string

Ошибка

Возвращается только в случае ошибки

error_description

string

Описание ошибки

Возвращается только в случае ошибки

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

Данный метод используется для получения в ответе тела документа согласия или аннулирования согласия, которое необходимо подписать откреплённой УКЭП и вставить в поле "signature" в методе "Метод подписания документа согласия или документа аннулирования согласия о предоставлении информации".

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

URL: agreement-registry/{id}/print-form

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

curl -X GET "<url стенда>/agreement-registry/c9d1c4c6-a045-4205-b142-c9d5a13155f7/print-form?documentType=AGREEMENT"
-H "accept: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

ID документа

documentType

string

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

Возможные значения: AGREEMENT - документ согласия о предоставлении информации AGREEMENT_CANCELLATION - документ отмены согласия

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

1.В случае успеха 200.

{
  "documentRegNumber": "AR631208202400074",
  "ownerOrganisationName": "ООО \"X\"",
  "ownerOrganisationInn": "1234567890",
  "ownerOrganisationOgrn": "1234567890123",
  "trustedOrganisations": [],
  "everyonePermitted": true
}

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

{
   "error":"string",
   "error_description":"string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

documentRegNumber

string

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

ownerOrganisationName

string

Наименование владельца организации

ownerOrganisationOgrn

string

ОГРН владельца организации

trustedOrganisations

[string]

Доверенные организации

everyonePermitted

boolean

Признак предоставления согласия для всех контрагентов

При необходимости подписания согласия для всех контрагентов значение параметра должно быть "true", при этом параметр "trustedOrganisations" должен быть пустым. Заполнение обоих параметров одновременно недопустимо. При передаче списка доверенных контрагентов в параметре "trustedOrganisations" параметр "everyonePermitted" должен быть либо пустым, либо иметь значение "false". Параметр "everyonePermitted" автоматически принимает значение "false" при передаче пустого значения

error

string

Ошибка

Возвращается только в случае ошибки

error_description

string

Описание ошибки

Возвращается только в случае ошибки

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

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

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

URL: agreement-registry/publish

Метод: POST

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

curl -X POST "<url стенда>/agreement-registry/publish"
-H "accept: application/json"
-H "Content-Type: application/json"
-H "Authorization: Bearer <ТОКЕН>"
--data-raw "{\"documentId\":\"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\"documentType\":\"AGREEMENT\",\"signature\":\"string\"}"

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

{
  "documentId": "string",
  "documentType": "AGREEMENT",
  "signature": "string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

documentId

string

ID документа

documentType

string

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

Возможные значения:
"AGREEMENT" - подписание документа согласия;
"AGREEMENT_CANCELLATION" - подписание документа аннулирования согласия.
При отсутствии одного из указанных значений возвращается ошибка 400

signature

string

Откреплённая УКЭП в кодировке base64

УКЭП директора или генерального директора, осуществившего регистрацию компании в ГИС МТ, либо сотрудника, который зарегистрировал компанию на основании доверенности

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

1.В случае успеха 200.

{
  "documentId": "string",
  "status": "string"
}

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

{
  "error_message": "Параметры запроса заданы неверно или документ не прошёл проверку"
}

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

{
  "error_message": "Документ не найден"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

documentId

string

ID документа

status

string

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

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

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

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

Приватный.
Оператор.

URL: /agreement-registry/trusted/{ownerInn}/list

Метод: GET

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

curl -X GET "<url стенда>/agreement-registry/trusted/1111111111/list?inn=string&name=string&offset=0&limit=0&needTotal=true"
-H "accept: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

ownerInn

string

ИНН доверителя

inn

string

ИНН участника оборота товаров

name

string

Наименование организации участника оборота товаров

offset

integer($int64)

Смещение страницы

Значение по умолчанию: 0

limit

integer($int32)

Предельное количество записей

Значение по умолчанию: 10

needTotal

boolean

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

Значение по умолчанию: "true"

В запросе должен быть указан параметр "ownerInn" ("ИНН доверителя"), иначе в ответе возвращается ошибка 400 "Bad request" (ошибка в параметрах запроса).

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

1.В случае успеха 200 "Данные успешно получены".

{
   "results":[
      {
         "inn":"string"
      }
   ],
   "total":0,
   "expirationDate":"string",
   "everyonePermitted": true,
   "last":true
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

[array]

Список ИНН, возвращаемых в запросе

Если у доверителя, участника оборота товаров, подписан договор согласия с признаком предоставления сведений всем контрагентам, то параметр "results" должен быть пустым, а параметр "everyonePermitted" = true

*inn

string

ИНН участника оборота товаров

expirationDate

string (date-time)

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

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

everyonePermitted

boolean

Признак предоставления согласия для всех контрагентов

Если подписанное согласие предоставлено для всех контрагентов, то в ответе "everyonePermitted" = true, и параметр "inn" возвращается пустым. Если "everyonePermitted" = false, то возвращается список ИНН доверенных контрагентов

total

number

Общее количество записей

errorCode

string

Код ошибки

Параметр возвращается при наличии ошибки

last

boolean

Последняя запись на странице

Если у доверителя подписан договор согласия с признаком предоставления сведений всем контрагентам, то параметр "results" возвращается пустым.

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

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

Тип приватности: публичный (с использованием токена).

URL: /agreement-registry/trusted/{ownerInn}

Метод: GET

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

curl -X GET "<url стенда>/agreement-registry/trusted/00000001?trustedInn=00000002"
-H "accept: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

ownerInn

string

ИНН предполагаемого доверителя

trustedInn

string(10-12)

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

everyonePermitted

boolean

Признак предоставления согласия для всех контрагентов

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

1.В случае успеха 200 "Данные успешно получены".

{
  "trusted": true,
  "expirationDate": "string"
}

2.В случае ошибки 400 "Входные параметры некорректны".

{
  "error": "string",
  "error_description": "string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trusted

boolean

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

Параметр принимает значение "true", если доверия предоставлено, иначе - "false"

expirationDate

string (date-time)

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

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

error

string

Ошибка

Возвращается только в случае ошибки

error_description

string

Описание ошибки

Возвращается только в случае ошибки

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

Метод возвращает список доверенных ИНН по указанному идентификатору согласия. Список ИНН возможно получить по подписанному/аннулированному согласию.

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

Приватный.
Оператор.

URL: agreement-registry/agreement/{id}/trusted-inns

Метод: GET

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

curl -X GET "<url стенда>/agreement-registry/agreement/9df4ffeb-20ec-4c30-9b2b-0f3370421cb2/trusted-inns"
-H "accept: application/json"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

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

1.В случае успеха 200 "ИНН получен".

{
  "trustedInns": [
    "string"
  ],
  "everyonePermitted": true,
  "expirationDate": 0
}

2.В случае ошибок 400, 404 и 500.

{
  "error": "string",
  "error_description": "string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trustedInns

[string]

Список доверенных ИНН контрагентов

everyonePermitted

boolean

Признак предоставления согласия для всех контрагентов

Если подписанное согласие предоставлено для всех контрагентов, то в ответе "everyonePermitted" = true, и параметр "trustedInns" возвращается пустым. Если "everyonePermitted" = false, то возвращается список доверенных ИНН контрагентов

expirationDate

string (date-time)

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

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

error

string

Ошибка

Возвращается только в случае ошибки

error_description

string

Описание ошибки

Возвращается только в случае ошибки

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

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

Возвращаемые параметры «gzPacks» («Расчётное суммарное число единиц товаров в серой зоне») и «gzBlocks» («Расчётное суммарное число групповых упаковок в транспортной упаковке в серой зоне») — это расчётные единицы для агрегатов, которые считаются на основании разницы физической ёмкости упаковки и указанных при агрегировании кодов, т.е. это потенциальное число единиц товаров и групповых упаковок, которые могут находиться в «Серой зоне» в данной упаковке. Признак «Серой зоны» для единицы товара / групповой упаковки проставляется на основании отчёта от производителя.

Параметр «gzBlocks» («Расчётное суммарное число групповых упаковок в транспортной упаковке в серой зоне») — расчётное суммарное число единиц товаров в серой зоне, которые находятся в серой зоне. Значение для транспортной упаковки считается как сумма всех «gzPacks» («Расчётное суммарное число единиц товаров в серой зоне»), умноженное на 10. Отрицательное значение свидетельствует об ошибке в предоставленных данных. Для устранения ошибки следует предоставить исправленные данные по агрегату.

Тип приватности: публичный

URL: /cises/gz/info

Метод: POST

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

curl -X POST "<url стенда>/cises/gz/info"
-H "Authorization: Bearer <ТОКЕН>"
-H "accept: application/json"
-H "Content-Type: application/json"
--data-raw ["000000462106549pJu6lt"]

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

Параметр

Тип

Обяз.

Описание

Комментарий

codes

array [string]

Массив кодов идентификации

Массив не пустой, допускается получение от 1 до 1000 элементов в массиве

childsWithoutBrackets

boolean

Признак получения кодов вложений без скобок

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

[
  {
    "info": {
      "code":"string",
      "packageType":"UNIT",
      "inGrayZone":true,
      "applicationDate":"2020-09-04T08:09:34.484Z",
      "containsGrayCodes":true,
      "aggCount":0,
      "gzPacks":0,
      "gzBlocks":0
    },
    "errorMessage":"string",
    "errorCode":"string"
  }
]

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

Параметр

Тип

Обяз.

Описание

Комментарий

info

object

Информация о принадлежности кода к серой зоне

*code

string

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

*cisWithoutBrackets

string

КИ без скобок

Параметр считается устаревшим

*packageType

string

Тип упаковки

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

*inGrayZone

boolean

Фактическая принадлежность кода к серой зоне, заполняется только для единицы товара и групповой упаковки

Возможные значения:

true — если единица товара / групповая упаковка в серой зоне;
false — если единица товара / групповая упаковка не в серой зоне

*applicationDate

string (date-time)

Дата нанесения

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z. Возвращается, если «inGrayZone» («Фактическая принадлежность кода к серой зоне») = true

*containsGrayCodes

boolean

Наличие расчётных серых кодов в составе агрегата

Возможные значения:

true — в составе агрегата есть серые коды;
false — в составе агрегата нет серых кодов

*aggCount

number

Количество вложений нижестоящего уровня в агрегате

Заполняется только для агрегатов, если «containsGrayCodes» («Наличие расчётных серых кодов в составе агрегата») = true

*gzPacks

number

Расчётное суммарное число единиц товаров в серой зоне

Заполняется только для агрегатов, если «containsGrayCodes» («Наличие расчётных серых кодов в составе агрегата») = true

*gzBlocks

number

Расчётное суммарное число групповых упаковок в транспортной упаковке в серой зоне

Заполняется только для агрегатов, если «containsGrayCodes» («Наличие расчётных серых кодов в составе агрегата») = true

errorCode

string

Код ошибки

См. «Справочник "Статусы ответов"». Параметр указывается при наличии ошибки

errorMessage

string

Сообщение об ошибке

См. «Справочник "Статусы ответов"». Параметр указывается при наличии ошибки

5.10. Метод получения актуального баланса на складе

Метод возвращает информацию о балансе, актуальном на текущий день, по кодам товаров без остатков и без движения за текущие сутки, для товарных групп «Антисептики и дезинфицирующие средства», «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище» и «Упакованная вода».

Функциональность «Склад» обеспечивает предоставление сведений об обороте маркированного товара в объёмно-сортовом разрезе. Информация о состоянии баланса позволяет осуществлять контроль товарооборота — отслеживать количество единиц полученного и переданного товара по коду товара, что особенно актуально для документов с подачей сведений по объёмно-сортовым показателям (в подаваемом документе указываются коды товара и количество товара по каждому коду товара), а также отслеживать объёмно-весовые характеристики товара. Учёт товара ведётся на основании результата обработки полученных документов, влияющих на баланс, как с экземплярной прослеживаемостью (в подаваемом документе указывается перечень КИ), так и с объёмно-сортовой прослеживаемостью. Документами, влияющими на баланс, являются сведения, содержащие указание экземплярной или объёмно-сортовой прослеживаемости, поступившие от участника оборота товаров, и успешно обработанные в ГИС МТ.

На балансе склада ГИС МТ не осуществляется учёт по кодам товаров групповых упаковок и наборов. После успешной обработки документа, влияющего на баланс, в котором указаны коды товаров групповых упаковок или наборов, к учёту будут приняты только коды единиц товаров, вложенные в данную групповую упаковку или набор. Количество на балансе склада ГИС МТ равно общему количеству кодов единиц товаров.

На балансе склада учитываются операции расхода по чеку продажи с поэкземплярным указанием кодов маркировки и прихода по чеку возврата / чеку возврата (коррекции) при отсутствии признака HoReCa в реквизитах чека. Для чеков с указанием кода товара (GTIN) и количества такие операции учитываются только при отсутствии признаков вендинга и HoReCa в реквизитах чека.

Операции расхода / прихода на балансе склада по чеку продажи / чеку возврата / чеку возврата (коррекции) с признаком агентско-комиссионной схемы и указанием кода товара (GTIN), а также количества, отражаются на балансе поставщика, а не фактического продавца, если до момента реализации не зарегистрировано перемещение кодов идентификации на фактического продавца.

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

URL: /warehouse/balance

Метод: POST

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

POST <url стенда>/api/v3/true-api/warehouse/balance
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

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

{
   "gtins":[
      "04611111111111",
      "00022222222222",
      "04833333333333"
   ],
   "pagination":{
      "page":1,
      "perPage":100
   }
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

gtins

array of string

Массив кодов товаров

От 1 до 1000 кодов товаров включительно. Формат кода товара: 14 цифр включительно. Если код товара менее 14 цифр, то дополнить его лидирующими нулями.

При отсутствии параметра в ответе возвращается информация по всем найденным кодам товаров (не более 1000 на странице с учётом параметров пагинации) участника оборота товаров, выполнившего запрос

pagination

object

Параметры пагинации

При отсутствии параметра возвращаются первые 1000 найденных кодов товаров

*page

integer

Номер страницы

Если на складе нет запрошенного числа записей на странице с запрошенным номером, то вернётся пустой ответ

*perPage

integer

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

Максимально допустимое значение — 1000, минимально допустимое значение — 1

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

В случае успеха:

1.1. При наличии сведений на складе:

{
   "code":0,
   "description":"Ok",
   "balances":[
      {
         "gtin":"04611111111111",
         "saldo":2,
         "actualInput":100,
         "actualOutput":92,
         "quantity":8,
         "netWeight":1,
         "volume":3,
         "actualOperationsCount":2
      },
      {
         "gtin":"00022222222222",
         "saldo":-20,
         "actualInput":20,
         "actualOutput":40,
         "quantity":-40,
         "netWeight":66,
         "volume":1,
         "actualOperationsCount":7
      },
      {
         "gtin":"04833333333333",
         "saldo":0,
         "actualInput":1,
         "actualOutput":1,
         "quantity":0,
         "netWeight":0,
         "volume":0,
         "actualOperationsCount":1
      }
   ]
}

1.2. При отсутствии сведений на складе по всем кодам товаров, указанным в запросе в корректном формате (см. комментарий параметра тела запроса «gtins» («Массив кодов товаров»)) и некорректном:

{
   "code":0,
   "description":"Ok",
   "balances":[

   ]
}

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

2.1. Код 400, если в теле запроса указано более 1000 кодов товаров:
```
{
   "error_message":"Количество GTIN в запросе не должно превышать 1000"
}
```
2.2. Код 400, если в теле запроса в параметре «perPage» («Максимальное количество записей на странице результата поиска») указано значение меньше 1:
```
{
   "error_message":"Количество pagination.perPage содержит значение меньше допустимого (1)"
}
```
2.3. Код 400, если в теле запроса в параметре «perPage» («Максимальное количество записей на странице результата поиска») указано значение больше 1000:
```
{
   "error_message":"Превышено допустимое количество pagination.perPage (1000)"
}
```
2.4. Код 400, если в теле запроса указано значение параметра «page» («Номер страницы») и не указано значение параметра «perPage» («Максимальное количество записей на странице результата поиска»):
```
{
   "error_message":"Для пагинации необходимо указать pagination.perPage"
}
```
2.5. Код 400, если в теле запроса указано значение параметра «perPage» («Максимальное количество записей на странице результата поиска») и не указано значение параметра «page» («Номер страницы»):
```
{
   "error_message":"Для пагинации необходимо указать pagination.page"
}
```
2.6. Код 401, если токен не действителен:
```
{
   "error_message":"Токен не действителен. Необходимо получить новый токен аутентификации"
}
```
2.7. Код 429, если внутренняя ошибка сервиса:
```
{
   "error_message":"Превышено допустимое количество запросов"
}
```

При ошибках с кодом 4xx требуется исправить запрос перед повторной отправкой. При ошибках с кодом 5xx (внутренняя ошибка сервиса) требуется повторить запрос. Минимальное значение (в секундах) указано в параметре заголовка ответного сообщения — Retry-After. Если значение параметра Retry-After отсутствует — минимум через 30 секунд.

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

Параметр

Тип

Обяз.

Описание

Комментарий

code

integer

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

Возможные значения:

«0» — операция завершена успешно;
«400» — операция завершена с ошибкой

description

string

Описание результата выполнения запроса

Возможные значения:

«Ok» — операция завершена успешно;
«<Описание ошибки>» — операция завершена с ошибкой

balances

array of object

Актуальный баланс по каждому коду товара

*gtin

string

Код товара

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

*saldo

long

Начальное сальдо единиц товара на балансе на начало периода (на 00:00:00 текущего дня)

Возвращается при наличии сведений на складе. Значение является суммой количества единиц товара за все предыдущие дни

*actualInput

long

Количество поступивших на баланс единиц товара за текущий день

Возвращается при наличии сведений на складе. Значение является суммой положительного количества единиц товара за текущую дату

*actualOutput

long

Количество убывших с баланса единиц товара за текущий день

Возвращается при наличии сведений на складе. Значение является суммой отрицательного количества единиц товара за текущую дату

*quantity

long

Суммарное количество единиц товара с учётом текущего дня (на 23:59:59 текущего дня)

Возвращается при наличии сведений на складе. Значение является суммой количества единиц товара за весь текущий день

*netWeight

long

Суммарный вес товара на балансе на текущую дату, в граммах

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

DROPPED_OUT — «Отчёт о списании»;
EAS_GTIN_CROSSBORDER_ACCEPTANCE — «Приёмка из ЕАЭС (ОСУ)»;
EAS_GTIN_CROSSBORDER_EXPORT_ACCEPTANCE — «Приёмка в ЕАЭС (ОСУ)»;
LK_GTIN_RECEIPT — «Вывод из оборота (ОСУ)»;
LK_GTIN_RECEIPT_CANCEL — «Отмена вывода из оборота (ОСУ)»;
LK_KM_CANCELLATION — «Списание»;
LK_RECEIPT — «Вывод из оборота»;
LK_RECEIPT_CANCEL — «Отмена вывода из оборота»;
LP_ACCEPT_GOODS — «Приёмка из ЕАЭС»;
RECEIPT — «Чек»;
RECEIPT_RETURN — «Чек возврата»;
RECEIPT_CORRECTION_FOR_RETURN — «Чек коррекции к чеку возврата (в том числе мелкого опта)»;
REPORT_REWEIGHING — «Отчёт о перевзвешивании»;
UTILISED — «Отчёт о нанесении»

Если товар имеет признак переменного веса, то значение параметра зависит от типа прослеживаемости товара:

при экземплярной прослеживаемости значение = суммарному значению веса из состава всех КМ данного товара, переданного и полученного за текущую дату;
при объёмно-сортовой прослеживаемости значение = суммарному значению веса из параметров документов, влияющих на баланс склада, переданных и полученных за текущую дату.

Если значение отсутствует в составе КМ или в документах, влияющих на баланс, то значением веса является среднее арифметическое значений атрибутов «Диапазон веса, от» и «Диапазон веса, до», указанных в карточке товара в НКМТ.

Для товара без признака переменного веса с любым типом прослеживаемости значение = значению из карточки товара в НКМТ, в том числе если в параметре документа, влияющего на баланс склада, было указано значение (данное значение на складе ГИС МТ учтено не будет), а также для товара, для которого в НКМТ в атрибуте «Товар с переменным количеством» значение отсутствует

Если товар не имеет признак переменного веса и указан его объём, то значение возвращается в параметре «volume» и = значению из карточки товара в НКМТ. По коду товара, соответствующий КИ которого указан в документе «Отчёт о перевзвешивании» (REPORT_REWEIGHING), значением параметра является разница между заявленным весом товара и перевзвешенным весом.

Если в карточке товара НКМТ не указано значение в каком-либо из атрибутов или = 0, то параметр в ответе не возвращается

*volume

long

Суммарный объём товара на балансе на текущую дату в миллилитрах

Cм. комментарий к параметру «netWeight»

*actualOperationsCount

long

Число документов по коду товара за текущую дату

Возвращается при наличии сведений на складе. Количество документов прямой подачи сведений, отчётов, чеков, документов ЭДО, влияющих на баланс, с датой документа равной дате расчёта баланса (текущей дате)

*length

long

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

*actualLengthInput

long

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

*actualLengthOutput

long

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

*units

long

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

Значение указывается со знаком:
«+» — приход;
«-» — расход

*actualUnitsInput

long

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

*actualUnitsOutput

long

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

*actualVolumeInput

long

Суммарный объём товара, поступившего на баланс участника на момент даты актуального баланса, в миллилитрах

*actualVolumeOutput

long

Суммарный объём товара, убывшего с баланса участника на момент даты актуального баланса, в миллилитрах

*actualNetWeightInput

long

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

*actualNetWeightOutput

long

Суммарный вес товара, убывшего с баланса участника на момент даты актуального баланса, в граммах

5.11. Метод получения списка операций на складе

Метод возвращает список документов, влияющих на баланс склада участника оборота товаров, за запрашиваемый период (разница между начальной и конечной датами не более 92 дней) для товарных групп «Антисептики и дезинфицирующие средства», «Консервированная продукция», «Корма для животных», «Молочная продукция», «Морепродукты», «Растительные масла», «Соковая продукция и безалкогольные напитки», «Специализированная пищевая продукция и БАД к пище» и «Упакованная вода».

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

URL: /warehouse/operations

Метод: POST

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

POST <url стенда>/api/v3/true-api/warehouse/operations
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

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

{
   "docDateTimeInterval":{
      "from":"2022-06-22",
      "to":"2022-07-22"
   },
   "gtins":[
      "04611111111111",
      "00162222222222"
   ],
   "pagination":{
      "page":0,
      "perPage":100
   }
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

docDateTimeInterval

object

Период построения выборки по бизнес-дате (дате из документа)

Обязательный, если не указан «processingDateTimeInterval», иначе — строго отсутствует. Допустимо указание любого интервала дат с разницей между начальной и конечной датами не более 92 дней

processingDateTimeInterval

object

Период для построения выборки по дате обработки документа в ГИС МТ (системной дате)

Обязательный, если не указан «docDateTimeInterval», иначе — строго отсутствует. Допустимо указание любого интервала дат с разницей между начальной и конечной датами не более 92 дней

*from

string (date)

Дата начала периода

Формат: yyyy-MM-dd

*to

string (date)

Дата окончания периода

Формат: yyyy-MM-dd. Значение не может быть ранее значения, указанного в параметре «from»

gtins

array of string

Массив кодов товаров

От 1 до 1000 кодов товаров включительно. Формат кода товара: 14 цифр включительно. Если код товара менее 14 цифр, то дополнить его лидирующими нулями. При отсутствии параметра в ответе возвращается не более 1000 кодов товаров на странице с учётом параметров пагинации

pagination

object

Параметры пагинации

*page

integer

Номер страницы

Значение по умолчанию — 0. Доступно указание любого числового значения. Если на складе нет запрошенного числа записей на странице с запрошенным номером, то вернётся пустой ответ

*perPage

integer

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

Максимально допустимое значение — 1000, минимально допустимое значение — 1. В ответе возвращается число записей не более, чем указано в параметре

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

В случае успеха:

1.1. При наличии сведений на складе:

{
   "code":0,
   "description":"Ok",
   "pagination":{
      "isLastPage":true,
      "perPage":100,
      "page":0
   },
   "operations":[
      {
         "docId":"string",
         "docType":"string",
         "inn":"7777777777",
         "quantity":5,
         "gtin":"04611111111111",
         "productGroups":[
            8
         ],
         "docDateTime":"2022-06-22T00:00:00.000Z",
         "processingDateTime":"2022-06-22T00:00:00.000Z",
         "sinn":"6666666666",
         "rinn":"7777777777",
         "netWeight":0,
         "volume":0
      },
      {
         "docId":"string",
         "docType":"string",
         "inn":"7777777777",
         "quantity":-5,
         "gtin":"00162222222222",
         "productGroups":[
            8
         ],
         "docDateTime":"2022-06-22T00:00:00.000Z",
         "processingDateTime":"2022-06-22T00:00:00.000Z",
         "sinn":"6666666666",
         "rinn":"7777777777",
         "netWeight":0,
         "volume":0
      },
      {
         "docId":"string",
         "docType":"string",
         "inn":"7777777777",
         "quantity":5,
         "gtin":"00162222222222",
         "productGroups":[
            8
         ],
         "docDateTime":"2022-07-09T00:00:00.000Z",
         "processingDateTime":"2022-07-09T00:00:00.000Z",
         "sinn":"6666666666",
         "rinn":"7777777777",
         "netWeight":0,
         "volume":0
      }
   ]
}

{
   "code":0,
   "description":"Ok",
   "pagination":{
      "isLastPage":true,
      "perPage":100,
      "page":0
   },
   "operations":[

   ]
}

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

2.1. Код 400, если в теле запроса указано более 1000 кодов товаров:
```
{
   "error_message":"Количество GTIN в запросе не должно превышать 1000"
}
```
2.2. Код 400, если отсутствует тело запроса:
```
{
   "error_message":"Тело запроса не может быть пустым"
}
```
2.3. Код 400, если не указан период поиска в параметре «docDateTimeInterval» («Период построения выборки по бизнес-дате (дате из документа)») или «processingDateTimeInterval» («Период для построения выборки по дате обработки документа в ГИС МТ (системной дате)») (оба параметра не указаны либо одновременно указаны оба параметра):
```
{
   "error_message":"Необходимо указать один параметр: docDateTimeInterval или processingDateTimeInterval"
}
```
2.4. Код 400, если в теле запроса у параметров «docDateTimeInterval» («Период построения выборки по бизнес-дате (дате из документа)») или «processingDateTimeInterval» («Период для построения выборки по дате обработки документа в ГИС МТ (системной дате)») не указаны значения параметров «from» («Дата начала периода») или «to» («Дата окончания периода»):
```
{
   "error_message":"Отсутствует обязательный параметр: <имя обязательного параметра>"
}
```
2.5. Код 400, если разница между начальной и конечной датами «docDateTimeInterval» («Период построения выборки по бизнес-дате (дате из документа)») или «processingDateTimeInterval» («Период для построения выборки по дате обработки документа в ГИС МТ (системной дате)») более 92 дней:
```
{
   "error_message":"Разница между начальной и конечной датами <имя параметра с периодом запроса> должна быть не более 92 дней"
}
```
2.6. Код 400, если в теле запроса не указано значение параметра «pagination» («Параметры пагинации») или значения в его парамтерах «page» («Номер страницы») или «perPage» («Максимальное количество записей в ответе»):
```
{
   "error_message":"Отсутствует обязательный параметр: <имя обязательного параметра>"
}
```
2.7. Код 400, если в теле запроса у параметров «docDateTimeInterval» («Период построения выборки по бизнес-дате (дате из документа)») или «processingDateTimeInterval» («Период для построения выборки по дате обработки документа в ГИС МТ (системной дате)») значения параметров «from» («Дата начала периода») или «to» («Дата окончания периода») указаны в формате отличном от yyyy-MM-dd:
```
{
   "error_message":"Неверный формат <имя параметра1> [, <имя параметра2>]"
}
```
2.8. Код 400, если в теле запроса у параметров «docDateTimeInterval» («Период построения выборки по бизнес-дате (дате из документа)») или «processingDateTimeInterval» («Период для построения выборки по дате обработки документа в ГИС МТ (системной дате)») значение параметра «from» («Дата начала периода») больше значения параметра «to» («Дата окончания периода»):
```
{
   "error_message":"Значение параметра from должно быть более ранним или совпадать со значением параметра to"
}
```
2.9. Код 400, если в теле запроса в параметре «perPage» («Максимальное количество записей на странице результата поиска») указано значение меньше 1:
```
{
   "error_message":"Количество pagination.perPage содержит значение меньше допустимого (1)"
}
```
2.10. Код 400, если в теле запроса в параметре «perPage» («Максимальное количество записей на странице результата поиска») указано значение больше 1000:
```
{
   "error_message":"Превышено допустимое количество pagination.perPage (1000)"
}
```
2.11. Код 401, если токен не действителен:
```
{
   "error_message":"Токен не действителен. Необходимо получить новый токен аутентификации"
}
```
2.12. Код 429, если внутренняя ошибка сервиса:
```
{
   "error_message":"Превышено допустимое количество запросов"
}
```

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

Параметр

Тип

Обяз.

Описание

Комментарий

code

integer

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

Возможные значения:

«0» — операция завершена успешно;
«400» — операция завершена с ошибкой

description

string

Описание результата выполнения запроса

Возможные значения:

«Ok» — операция завершена успешно;
«<Описание ошибки>» — операция завершена с ошибкой

pagination

object

Параметры пагинации

Сведения о количестве найденных и возвращённых данных

*isLastPage

boolean

Признак последней страницы

Возможные значения:

«true» — страница является последней;
«false» — страница не является последней

*perPage

integer

Количество записей на странице

Значение равно непустому значению в параметре запроса «perPage» («Максимальное количество записей в ответе»)

*page

integer

Номер запрошенной страницы

Значение равно непустому значению в параметре запроса «page» («Номер страницы»)

operations

array of object

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

*docId

string

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

*docType

string

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

Тип документа, влияющий на баланс:

«DISAGGREGATION_DOCUMENT» — «Расформирование упаковки»;
«DROPPED_OUT» — «Отчёт о списании»;
«EAS_CROSSBORDER_EXPORT_ACCEPTANCE» — «Приёмка в ЕАЭС»;
«EAS_GTIN_CROSSBORDER_ACCEPTANCE» — «Приёмка из ЕАЭС (ОСУ)»;
«EAS_GTIN_CROSSBORDER_EXPORT_ACCEPTANCE» — «Приёмка в ЕАЭС (ОСУ)»;
«ELIMINATED» — «Отчёт об аннулировании»;
«LK_GTIN_RECEIPT» — «Вывод из оборота (ОСУ)»;
«LK_GTIN_RECEIPT_CANCEL» — «Отмена вывода из оборота (ОСУ)»;
«LK_KM_CANCELLATION» — «Списание»;
«LK_RECEIPT» — «Вывод из оборота»;
LK_RECEIPT_CANCEL — «Отмена вывода из оборота»;
«LK_REMARK» — «Перемаркировка»;
«LP_ACCEPT_GOODS» — «Приёмка из ЕАЭС»;
«LP_RETURN» — «Возврат в оборот»;
«RECEIPT_RETURN» — «Чек возврата»;
«RECEIPT_CORRECTION_FOR_RETURN» — «Чек коррекции к чеку возврата (в том числе мелкого опта)»;
«RECEIPT» — «Чек»;

«REPORT_REWEIGHING» — «Отчёт о перевзвешивании»;
«UNIVERSAL_CANCEL_DOCUMENT» — «Аннулирование УД»;
«UNIVERSAL_CORRECTION_DOCUMENT_FIX» — «УКДи»;
«UNIVERSAL_CORRECTION_DOCUMENT» — «УКД»;
«UNIVERSAL_TRANSFER_DOCUMENT_FIX» — «УПДи»;
«UNIVERSAL_TRANSFER_DOCUMENT» — «УПД»;
«UTILISED» — «Отчёт о нанесении»

*inn

string

ИНН участника оборота товаров

*quantity

integer

Количество передаваемых единиц маркированного товара

Значение указывается со знаком:

«+» — приход (документ поступления на склад);
«-» — расход (документ убытия со склада)

*gtin

string

Код товара

Запрашиваемый код товара, по которому есть сведения на складе. Если по запрашиваемому коду товара нет сведений (не было ни одного документа и / или указан некорректный код товара), то такой код товара в параметре не возвращается

*productGroups

array[integer]

Массив идентификаторов товарных групп

*docDateTime

string (date-time)

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

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

*processingDateTime

string (date-time)

Дата и время обработки документа в ГИС МТ

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

*sinn

string

ИНН отправителя документа

*rinn

string

ИНН получателя документа

*netWeight

long

Вес переданного товара

Возвращается при наличии. Для веса: три младших разряда — граммы, старшие разряды — килограммы. Для объёма: три младших разряда — миллилитры, старшие разряды — литры. Значение указывается со знаком:

«+» — приход (документ поступления на склад);
«-» — расход (документ убытия со склада).

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

«DROPPED_OUT» — «Отчёт о списании»;
«EAS_GTIN_CROSSBORDER_ACCEPTANCE» — «Приёмка из ЕАЭС (ОСУ)»;
«EAS_GTIN_CROSSBORDER_EXPORT_ACCEPTANCE» — «Приёмка в ЕАЭС (ОСУ)»;
«LK_GTIN_RECEIPT» — «Вывод из оборота (ОСУ)»;
«LK_GTIN_RECEIPT_CANCEL» — «Отмена вывода из оборота (ОСУ)»;
«LK_KM_CANCELLATION» — «Списание»;
«LK_RECEIPT» — «Вывод из оборота»;
LK_RECEIPT_CANCEL — «Отмена вывода из оборота»;
«LP_ACCEPT_GOODS» — «Приёмка из ЕАЭС»;
«RECEIPT» — «Чек»;

«RECEIPT_RETURN» — «Чек возврата»;
«RECEIPT_CORRECTION_FOR_RETURN» — «Чек коррекции к чеку возврата (в том числе мелкого опта)»;
«REPORT_REWEIGHING» — «Отчёт о перевзвешивании»;
«UTILISED» — «Отчёт о нанесении».

Если товар имеет признак переменного веса, то значение параметра зависит от типа прослеживаемости товара:

при экземплярной прослеживаемости значение = значению, указанному в составе КМ;
при объёмно-сортовой прослеживаемости значение = значению из параметра документа, повлиявшего на баланс склада.

Если значение отсутствует в составе КМ или в документе, влияющем на баланс склада, то значением является среднее арифметическое значений атрибутов «Диапазон веса, от» и «Диапазон веса, до», указанных в карточке товара в НКМТ

*volume

long

Объём переданного товара

Cм. комментарий к параметру «netWeight»

*length

integer

Длина переданного товара (при наличии)

Три младших разряда — миллиметры, старшие разряды — метры. Значение указывается со знаком:
«+» — приход;
«-» — расход

*units

integer

Количество переданного товара (при наличии)

Возвращается только для единиц товара. Количество штук переданного товара из одной упаковки (при наличии). Применимо для операций с экземплярами КМ у которых указано количество единиц употребления в потребительской упаковке (feats.qntip). Не путать с quantity.
Значение указывается со знаком:

«+» — приход;
«-» — расход

5.12. Метод расчёта количества КИ на основании веса товара

В ответе метода возвращается информация о количестве единиц товара для каждой запрашиваемой пары кода товара и веса в граммах. Если в карточке товара в НКМТ не заполнены или некорректно заполнены атрибуты по весовым характеристикам товара, то в ответе метода информация о количестве КИ будет отсутствовать.

Метод доступен для товарных групп, в которых реализован объёмно-сортовой учёт (в документе указывается количество товаров и их коды товаров) по весу товара.

Для метода действует ограничение на частоту запросов. Минимальный интервал между запросами — 30 секунд.

Тип приватности: c токеном авторизации участника оборота товаров или Оператора ЭДО.

URL: /api/v3/true-api/product/gtin-weight/cis-count

Метод: POST

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

POST <url стенда>/api/v3/true-api/product/gtin-weight/cis-count
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

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

{
   "products":[
      {
         "gtin":"string",
         "weight":"string"
      },
      {
         "gtin":"string",
         "weight":"string"
      }
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

products

object

Список параметров товара

Должен быть указан минимум 1 код товара и вес для данного товара. Максимум 1000 заполненных объектов (пар заполненных параметров "gtin" ("Код товара"), "weight" ("Вес товара в граммах"))

*gtin

string

Код товара

Длина значения — от 8 до 14 цифр включительно. При указании значения < 14 цифр система автоматически добавляет лидирующие нули до установки каждому запрошенному коду товара формата = 14 цифр перед получением информации о коде товара из НКМТ. Проверка на принадлежность кода товара организации, ИНН которой указан в токене, не осуществляется

*weight

string

Вес товара в граммах

Значение должно быть целым числом > 0 длиной до 10 цифр

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

Код 200 в случае успеха:

{
   "results":[
      {
         "gtin":"string",
         "weight":5,
         "cisCount":2
      },
      {
         "gtin":"string",
         "weight":5,
         "cisCount":2
      }
   ]
}

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

2.1. Код 400 при неверной структуре * .json в теле запроса:
```
{
   "error_message":"Некорректный JSON. Данные ошибки: <системное описание ошибки>"
}
```
2.2. Код 400 при указании в теле запроса более 1000 объектов в параметре тела запроса "products" ("Список параметров товаров"):
```
{
   "error_message":"Количество пар GTIN+вес в запросе не должно превышать 1000"
}
```
2.3. Код 400 при указании в параметре тела запроса "weight" ("Вес товара в граммах") значения в недопустимом формате:
```
{
   "error_message":"Неверный формат <имя параметра>"
}
```
2.4. Код 400 при отсутствии заполненного параметра тела запроса "gtin" ("Код товара") и / или в параметре тела запроса "weight" ("Вес товара в граммах") значение не > 0:
```
{
   "error_message":"Отсутствует обязательный параметр: <имя параметра1> [, <имя параметра2>]"
}
```
2.5. Код 400 при отсутствии тела запроса:
```
{
   "error_message":"Тело запроса не может быть пустым"
}
```
2.6. Код 400 при указании в параметре тела запроса "gtin" ("Код товара") пустого значения или значения в недопустимом формате:
```
{
   "error_message":"Указаны неверные параметры. Список gtins [, null] - пустой или содержит недопустимые значения."
}
```
2.7. Код 401 при указании невалидного токена или валидного токена с истёкшим сроком действия:
```
{
   "error_message":"Токен не действителен. Необходимо получить новый токен аутентификации"
}
```
2.8. Код 404 при отсутствии всех запрошенных кодов товаров в НКМТ:
```
{
   "error_message":"По запрашиваемым gtin информация не найдена в ГИС МТ"
}
```
2.9. Код 404 при отсутствии кода товара в НКМТ и одновременном получении как минимум одной карточки товара другого кода товара в НКМТ:
```
{
   "results":[
      {
         "gtin":"string",
         "weight":0,
         "errorMessage":"По запрашиваемому gtin информация не найдена в ГИС МТ",
         "errorCode":404
      }
   ]
}
```
2.10. Код 422 при отсутствии вычисленного веса (среднего веса) товара в граммах в НКМТ для кода товара, указанного в параметре тела запроса "gtin" ("Код товара"):
```
{
   "results":[
      {
         "gtin":"string",
         "weight":0,
         "errorMessage":"Для GTIN не указан вес в описании карточки",
         "errorCode":422
      }
   ]
}
```
2.11. Код 504 при отсутствии ответа из НКМТ, в том числе при получении системной ошибки:
```
{
   "error_message":"Отсутствует ответ системы"
}
```

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

object

Результат поиска кода товара в НКМТ и формирования целевого параметра

Возвращается при получении минимум одной карточки кода товара в НКМТ

*gtin

string

Код товара из тела запроса

*weight

integer

Вес товара в граммах из тела запроса

Число строкового типа преобразуется в число числового типа

*cisCount

integer

Количество КИ

Количество единиц товара для каждого запрашиваемого объекта в параметре тела запроса "products" ("Список параметров товаров"). Возвращается при наличии вычисленного веса (среднего веса) товара в граммах (> 0) в карточке кода товара в НКМТ. Принцип расчёта количества КИ: значение параметра тела запроса "weight" ("Вес товара в граммах") / значение веса > 0 для первого найденного кода товара из запроса в НКМТ = округлённое значение до ближайшего большего целого (пример: 0.1 → 1; 2.3 → 3; 100.15 → 101)

*errorMessage

string

Сообщение об индивидуальной ошибке по КИ

Возвращается при наличии для каждого объекта в параметре тела запроса "products" ("Список параметров товаров")

*errorCode

integer

Код индивидуальной ошибки по КИ

Возвращается при наличии для каждого объекта в параметре тела запроса "products" ("Список параметров товаров")

error_message

string

Сообщение об общей ошибке

Возвращается при наличии для всех объектов в параметре тела запроса "products" ("Список параметров товаров")

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

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

URL: /api/v4/true-api/doc/list

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

Метод: GET

Запрос:

curl "<url стенда v4>/doc/list?pg=lp"
-H "accept: */*"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

dateFrom

(date-time)

Дата документа, от

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

dateTo

(date-time)

Дата документа, до

Задаётся в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

did

string

Значение номера документа, по которому сортируются записи («точка отсчёта» — запись, с которой начнётся выборка)

Использовать только совместно с параметром «orderedColumnValue" ("Значение столбца, «точки отсчета" (запись, с которой начинается выборка), по которому сортируются записи")

documentFormat

string

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

Возможные значения:
«MANUAL» – формат * .json;
«UPD» – документы в формате ЭДО;
«XML» – формат * .xml;
«CSV» – формат * .csv

documentStatus

string

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

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

documentType

[string]

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

Cм. «Справочник «Типы документов»»

limit

integer

Количество записей в ответе

Значение устанавливает количество записей в ответе. Максимальное значение — 1000. Значение по умолчанию — 50

number

string

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

При указании данного параметра, параметр «did» («Значение номера документа, по которому сортируются записи («точка отсчёта» - запись, с которой начнётся выборка)») будет игнорироваться

order

enum

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

Возможные значения:
«ASC» – по возрастанию;
«DESC» – по убыванию

orderColumn

string

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

Данный параметр считается устаревшим. Сортировка возможна только по параметру ответа «docDate» («Дата и время документа») и устанавливается по умолчанию

orderedColumnValue

string

Значение столбца, «точки отсчёта» (запись, с которой начинается выборка), по которому сортируются записи

Параметр обязательный при указании параметра «did» («Значение номера документа, по которому сортируются записи («точка отсчёта» — запись, с которой начнётся выборка)»), в других случаях параметр неприменим

pageDir

enum

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

Возможные значения:
«PREV» – предыдущий раздел;
«NEXT» – следующий раздел

string

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

senderInn

string

ИНН отправителя документа

Обязательный, если нет «receiverInn» («ИНН получателя документа»). Одновременное указание параметров «senderInn» («ИНН отправителя документа») и «receiverInn» («ИНН получателя документа») не допускается

receiverInn

string

ИНН получателя документа

Обязательный, если нет «senderInn» («ИНН отправителя документа»). Одновременное указание параметров «receiverInn» («ИНН получателя документа») и «senderInn» («ИНН отправителя документа») не допускается

В запросе должен быть указан хотя бы один параметр, иначе в ответе возвращается ошибка 400 «Bad request» (Ошибка в параметрах запроса).

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

{
   "results":[
      {
         "number":"00bec0ce-000b-0ad0-a000-a0ef000000c0",
         "docDate":"2021-06-11T08:15:26.748Z",
         "receivedAt":"2021-06-11T08:15:26.748Z",
         "type":"LP_SHIP_GOODS",
         "status":"ACCEPTED",
         "senderInn":"0000000000",
         "senderName":"string",
         "receiverInn":"1111111111",
         "receiverName":"string",
         "invoiceNumber":null,
         "relatedDocId":"b0af00ca-000d-0e00-a0b0-0b000000a0e0",
         "downloadDesc":"",
         "input":false,
         "errors":null,
         "productGroup":"lp",
         "productGroupId":1
      }
   ],
   "nextPage":true
}

Пример ответа с ошибкой:

{
   "results":[
      {
         "number":"d0f00f00-eed0-0f0f-a00a-0cf0d0cdae0e",
         "docDate":"2021-06-11T10:52:41.925Z",
         "receivedAt":"2021-06-11T10:52:41.925Z",
         "type":"LK_KM_CANCELLATION",
         "status":"CHECKED_NOT_OK",
         "senderInn":"0000000000",
         "senderName":"string",
         "receiverInn":null,
         "receiverName":null,
         "invoiceNumber":null,
         "relatedDocId":null,
         "downloadDesc":"47: Одновременное заполнение полей [КИТУ, КИ] в документе \"Списание КМ\" недопустимо.",
         "input":false,
         "errors":[
            "47: Одновременное заполнение полей [КИТУ, КИ] в документе \"Списание КМ\" недопустимо."
         ],
         "productGroup":"lp",
         "productGroupId":1
      }
   ],
   "nextPage":true
}

В случае ошибки: Код 400, если одновременно указаны параметры запроса «senderInn» («ИНН отправителя документа») и «receiverInn» («ИНН получателя документа»):

{
    "error_message": "Параметры senderInn и receiverInn не могут быть указаны одновременно"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

object

*number

string

ID документа

Полное наименование файла УД

*docDate

string (date-time)

Дата и время документа

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z. ДатаСЧФ для УПД, УПДи, ДатаКСЧФ для УКД, УКДи по структуре XML-схемы

*receivedAt

string (date-time)

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

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*type

string

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

*status

string

Статус обработки документа

*senderInn

string

ИНН отправителя документа

*senderName

string

Наименование отправителя документа

*receiverInn

string

ИНН получателя документа

*receiverName

string

Наименование получателя документа

*invoiceNumber

string

НомерСЧФ для УПД, УПДи, НомерКСЧФ для УКД, УКДи по структуре XML-схемы

*downloadDesc

string

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

При наличии ошибки в загрузке документа. См. «Справочник "Статусы ответов"»

*input

boolean

Признак того, что документ является входящим/исходящим

Возможные значения:
true — входящий;
false — исходящий

*errors

array of string

Ошибки

Значение параметра возвращается при наличии ошибки

*productGroup

string

Наименование товарной группы

Наименование товарной группы соответствует указанной в запросе (см. «Справочник «Список поддерживаемых товарных групп»")

*productGroupId

integer

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

Идентификатор товарной группы соответствует указанной в запросе (см. «Справочник «Список поддерживаемых товарных групп»»)

*eliminationReason

string

Причина выбытия

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

boolean

Признак наличия следующей страницы

Возможные значения:
true — имеется следующая страница;
false — следующая страница отсутствует

Примечание: в ответе возвращаются все перечисленные параметры. При отсутствии значения обязательных параметров в ответе возвращается «null».

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

Этот метод позволяет:

получить сведения о мультитоварных чеках одной записью вместо нескольких;
фильтровать чеки по покупателю и продавцу, указанному в чеке мелкого опта;
отобрать все квитанции, где вы являетесь либо получателем, либо продавцом, если не заполнены параметры запроса «receiptUserInns» («ИНН продавца») и «receiptBuyerInns» («ИНН покупателя»).

Квитанции доступны с 1 мая 2020 года.

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

URL: /api/v3/true-api/receipt/search

Метод: POST

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

POST <url стенда>/api/v3/true-api/receipt/search
Authorization: Bearer <ТОКЕН>
Content-Type: application/json

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

{
   "filter":{
      "transactionIds":[

      ],
      "resultDocDate":{
         "from":"2023-12-13T07:33:07.618Z",
         "to":"2023-12-13T07:33:07.618Z"
      },
      "sourceDocIds":[

      ],
      "sourceDocDate":{
         "from":"2023-12-13T07:33:07.618Z",
         "to":"2023-12-13T07:33:07.618Z"
      },
      "status":[

      ],
      "details":{
         "receiptTypes":[

         ],
         "productGroups":[

         ],
         "documentNumbers":[

         ],
         "receiptDateTime":{
            "from":"2023-12-13T07:33:07.618Z",
            "to":"2023-12-13T07:33:07.618Z"
         },
         "receiptCodes":[

         ],
         "fiscalDriveNumbers":[

         ],
         "receiptUserInns":[

         ],
         "receiptBuyerInns":[

         ],
         "kktRegIds":[

         ]
      }
   },
   "pagination":{
      "perPage":0,
      "pageToken":"string"
   }
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

filter

array of objects

Параметры фильтрации

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

*transactionIds

array of string

Идентификатор результирующей квитанции

Обязательно заполнен, если не заполнены параметры «resultDocDate» («Дата и время формирования результирующей квитанции»), «sourceDocDate» («Дата и время создания исходного документа») и «receiptDateTime» («Дата и время формирования чека в ОФД»)

*resultDocDate

object

Дата и время формирования результирующей квитанции

Диапазон поиска транзакций по дате формирования результирующей квитанции, не более 90 дней.

Обязательно заполнен, если не заполнены параметры «transactionIds» («Идентификатор результирующей квитанции»), «sourceDocDate» («Дата и время создания исходного документа») и «receiptDateTime» («Дата и время формирования чека в ОФД»)

**from

string (date-time)

Дата от

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

**to

string (date-time)

Дата до

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

*sourceDocIds

array of string

Идентификатор исходного документа

Исходный документ — документ, для которого была сформирована квитанция

*sourceDocDate

object

Дата и время создания исходного документа

Диапазон поиска по дате исходного документа (документа, для которого была сформирована квитанция), не более 90 дней.

Обязательно заполнен, если не заполнены параметры «transactionIds» («Идентификатор результирующей квитанции»), «resultDocDate» («Дата и время формирования результирующей квитанции») и «receiptDateTime» («Дата и время формирования чека в ОФД»)

**from

string (date-time)

Дата от

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

**to

string (date-time)

Дата до

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

*status

array of string

Статус обработки документа (статус квитанции)

Возможные значения:

SUCCESS — обработан успешно;
FAILED — обработан с ошибками;
IN_PROGRESS — в процессе обработки;
PARTIALLY — обработан частично

*details

array of objects

Детали транзакции

Фильтр по деталям транзакции

**receiptTypes

array of string

Тип чека

Возможные значения:

RECEIPT — чек на реализацию;
RECEIPT_RETURN — чек возврата;
RECEIPT_CORRECTION — чек коррекции на чек реализации;
RECEIPT_CORRECTION_FOR_RETURN — чек коррекции на чек возврата

**productGroups

array of string

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

**documentNumbers

array of string

Номер фискального документа

**receiptDateTime

object

Дата и время формирования чека в ОФД

Диапазон поиска транзакций по дате формирования чека в ОФД, не более 90 дней.

Обязательно заполнен, если не заполнены параметры «transactionIds» («Идентификатор результирующей квитанции»), «resultDocDate» («Дата и время формирования результирующей квитанции») и «sourceDocDate» («Дата и время создания исходного документа»)

***from

string (date-time)

Дата от

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

***to

string (date-time)

Дата до

Формат: yyyy-MM-ddTHH:mm:ss.SSSZ

**receiptCodes

array of integer

Код формы фискального документа (чека)

Возможные значения:

3 — чек;
4 — бланк строгой отчётности;
31 — чек коррекции;
82 — уведомление о реализации КМ

**fiscalDriveNumbers

array of string

Заводской номер фискального накопителя

**receiptDocumentNumber

array of string

Номер чека ККТ

**receiptUserInns

array of string

ИНН продавца

Не более 50 значений

**receiptBuyerInns

array of string

ИНН покупателя

Не более 50 значений

**kktRegIds

array of string

Регистрационный номер ККТ

pagination

object

Параметры пагинации

Обеспечивает постраничный вывод результата поиска

*perPage

integer

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

Максимально допустимое значение — 1000, минимально допустимое значение — 1. Значение по умолчанию — 100

*pageToken

string

Токен страницы

Идентификатор страницы для перехода на следующую или предыдущую страницу результата поиска. Значение можно взять из параметров ответа «nextPageToken» («Токен для следующей страницы») или «prevPageToken» («Токен для предыдущей страницы»). Если значение не указано, то в ответе возвращается первая страница результата поиска

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

Код 200: в случае успеха.

{
  "nextPageToken": "string",
  "prevPageToken": "string",
  "results": [
    {
      "transactionId": "string",
      "resultDocDate": "2023-12-13T07:33:07.633Z",
      "sourceDocId": "string",
      "sourceDocDate": "2023-12-13T07:33:07.633Z",
      "status": 0,
      "details": {
        "receiptTypeId": "string",
        "receiptProviderInns": [
          "string"
        ],
        "productGroups": [
          "string"
        ],
        "hasUnknownEaesCodes": true,
        "ofdInn": "string",
        "documentType": "string",
        "documentNumber": "string",
        "documentDateTime": "2023-12-13T07:33:07.633Z",
        "receiptDateTime": "2023-12-13T07:33:07.633Z",
        "receiptFiscalDocumentFormatVer": "string",
        "receiptOperationType": "string",
        "did": "string",
        "receiptCode": "string",
        "kktRegId": "string",
        "fiscalDriveNumber": "string",
        "receiptUserInn": "string",
        "receiptBuyerInn": "string"
      }
    }
  ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

nextPageToken

string

Токен для следующей страницы

Идентификатор страницы для пагинации. Возвращается, если есть следующая страница

prevPageToken

string

Токен для предыдущей страницы

Идентификатор страницы для пагинации. Возвращается, если есть предыдущая страница

results

array of objects

Сведения о найденных квитанциях

*transactionIds

string

Идентификатор результирующей квитанции

*resultDocDate

string

Дата и время формирования итоговой квитанции по транзакции

*sourceDocIds

string

Идентификатор исходного документа

Исходный документ — документ, для которого была сформирована квитанция

*sourceDocDate

string

Дата и время создания исходного документа

Исходный документ — документ, для которого была сформирована квитанция

*status

string

Статус обработки документа (статус квитанции)

Возможные значения:

*details

array of objects

Детали транзакции

**receiptTypeId

string

Тип чека

Возможные значения:

**receiptProviderInns

array of string

ИНН поставщика

**productGroups

array of string

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

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

**hasUnknownEaesCodes

boolean

Признак кода ЕАЭС

Возможные значения:

true — содержит товары, маркированные кодами, выпущенными Операторами государств-членов ЕАЭС;
false — не содержит товары, маркированные кодами, выпущенными Операторами государств-членов ЕАЭС

**ofdInn

string

ИНН ОФД

**documentNumber

string

Номер фискального документа

**documentDateTime

string

Дата и время фискального документа

**receiptDateTime

string

Дата и время чека

**receiptFiscalDocumentFormatVer

string

Версия фискального документа

**receiptOperationType

string

Тип операции чека

Возможные значения:

1 — приход;
2 — возврат прихода;
3 — расход;
4 — возврат расхода

**did

string

Идентификатор чека

**receiptCode

string

Код формы фискального документа (чека)

Возможные значения:

3 — чек;
4 — бланк строгой отчётности;
31 — чек коррекции;
82 — уведомление о реализации КМ

**kktRegId

string

Регистрационный идентификатор ККТ

**fiscalDriveNumber

string

Заводской номер фискального накопителя

**receiptDocumentNumber

string

Номер чека ККТ

**receiptUserInn

string

ИНН продавца

**receiptBuyerInn

string

ИНН покупателя

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

Примечание

При ошибках с кодом 4xx требуется исправить запрос перед повторной отправкой. При ошибке с кодом 500 (внутренняя ошибка сервиса) требуется повторить запрос. Минимальное значение (в секундах) указано в параметре заголовка ответного сообщения — Retry-After. Если значение параметра Retry-After отсутствует — минимум через 30 секунд

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

{
    "code": 400,
    "error_message": "Отсутствует тело запроса"
}

Код 400: отсутствуют фильтры.

{
    "code": 400,
    "error_message": "Не заполнен ни один параметр filter"
}

Код 400: доступ запрещён.

{
    "code": 400,
    "error_message": "Доступ запрещен"
}

Код 400: значения параметров «receiptUserInns» («ИНН продавца») и «receiptBuyerInns» («ИНН покупателя») совпадают.
```
{
    "code": 400,
    "error_message": "ИНН продавца и покупателя совпадают"
}
```

Код 400: диапазон поиска по дате превышает 90 дней.

{
    "code": 400,
    "error_message": "Период <название_параметра> более 90 дней"
}

Код 400: количество значений превышает 50.

{
    "code": 400,
    "error_message": "Значений в <название_параметра> более 50"
}

Код 400: превышено максимально допустимое количество значений в параметре «transactionIds» («Идентификатор результирующей квитанции»).
```
{
    "code": 400,
    "error_message": "Количество значений в <transactionIds> превышает максимально допустимое значение"
}
```
Код 400: не заполнен ни один из параметров «transactionIds» («Идентификатор результирующей квитанции»), «resultDocDate» («Дата и время формирования результирующей квитанции»), «sourceDocDate» («Дата и время создания исходного документа») или «receiptDateTime» («Дата и время формирования чека в ОФД»).
```
{
    "code": 400,
    "error_message": "Должен быть заполнен как минимум один из обязательных параметров <transactionIds>, <resultDocDate>, <sourceDocDate>, <details.receiptDateTime>"
}
```

Код 401: невалидный токен.

{
    "code": 401,
    "error_message": "Для доступа к этому ресурсу требуется полная аутентификация. Проверьте токен"
}

Код 403: отсутствует действующий договор по запрашиваемой товарной группе.
```
{
    "code": 403,
    "error_message": "Отсутствует действующий договор по ТГ"
}
```
Код 500: внутренняя ошибка сервиса.

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

Для товарной группы «Духи и туалетная вода» метод возвращает в ответе только КИ из тела документа (см. «Справочник «Типы документов»») без отражения информации о КИ дочерних вложений, входящих в состав агрегирующих КИ: параметры «count_children» и «children» в ответе остаются скрытыми.

URL: /api/v4/true-api/doc/{docId}/info

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

Метод: GET

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

curl -X GET "<url стенда v4>/doc/f111111e-11fa-11d1-111d-1cf1c1f1111c/info?pg=lp&body=true"
-H "accept: application/json"
-H "Authorization: Bearer <Токен>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

docId

string

ID документа, формируемый в ГИС МТ, или ИдФайл для УД

body

boolean

Признак необходимости в теле ответа содержимого документа

Возможные значения:

«true» — содержимое отправленного документа возвращается в ответе метода;
«false» — содержимое отправленного документа не возвращается в ответе метода. Значение по умолчанию = «false»

По умолчанию установлен лимит — в ответе передаётся информация о 50 дочерних КМ

content

boolean

Признак необходимости контента документа в теле ответа

Возможные значения:

«true» — контент документа возвращается в ответе метода;
«false» — контент документа не возвращается в ответе метода. Значение по умолчанию = «false»

string

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

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

Параметр обязательный для товарной группы «Товары из натурального меха»

limit

integer

Количество кодов в теле документа

Значение по умолчанию 36000

pageNumber

integer

Лимит вывода информации по кодам

Значение по умолчанию 1.

Указывается для вывода информации по кодам только для универсальных документов УПД (UNIVERSAL_TRANSFER_DOCUMENT), УПДи (UNIVERSAL_TRANSFER_DOCUMENT_FIX), УКД (UNIVERSAL_CORRECTION_DOCUMENT), УКДи (UNIVERSAL_CORRECTION_DOCUMENT_FIX). Для других типов документов значение, указанное в параметре «pageNumber» («Лимит вывода информации по кодам») будет игнорироваться. Если параметр «pageNumber» («Лимит вывода информации по кодам») не указан, то в ответе возвращаются первые 36 000 значений кодов по документу (для всех типов документов). Пример: если «pageNumber» = 1 и «limit» = 10 000, то в ответе вернутся первые 10 000 кодов по документу, для запроса следующих 10 000 кодов в параметре «pageNumber» указать соответствующее по счёту значение

Пример ответа с ошибкой:

[
    {
        "number": "50f6b645-09a8-4ee1-8bb4-e426274e82ee",
        "docDate": "2024-03-29T13:28:35.615Z",
        "receivedAt": "2024-03-29T13:28:35.615Z",
        "type": "LP_INTRODUCE_GOODS",
        "status": "PARSE_ERROR",
        "senderInn": "0000000000",
        "senderName": "string",
        "receiverInn": null,
        "receiverName": null,
        "invoiceNumber": null,
        "invoiceDate": null,
        "relatedDocId": null,
        "body": {},
        "input": false,
        "errors": [
            "29: Недопустимый формат передаваемого файла JSON."
        ],
        "commonErrors": [
            {
                "errorCode": "INTRO_ERROR",
                "errorMessage": "29: Недопустимый формат передаваемого файла JSON.",
                "errorObject": "50f6b645-09a8-4ee1-8bb4-e426274e82ee"
            }
        ],
        "productGroup": [
            "lp"
        ],
        "productGroupId": [
            1
        ]
    }
]

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

Параметр

Тип

Обяз.

Описание

Комментарий

number

string

ID документа

Указывается полное наименование файла для УД

docDate

string (date-time)

Дата и время документа

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

receivedAt

string (date-time)

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

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

type

string

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

status

string

Статус обработки документа

См. «Коды возвращаемых ошибок при обработке документов ЭДО и чеков»

senderInn

string

ИНН отправителя документа

senderName

string

Наименование отправителя документа

senderMod

object

Информация о МОД отправителя

Возвращается для документов «УПД (отгрузка продукции)» (FIXATION), «УПД» (UNIVERSAL_TRANSFER_DOCUMENT), «УПДи» (UNIVERSAL_TRANSFER_DOCUMENT_FIX), «УКД» (UNIVERSAL_CORRECTION_DOCUMENT), «УКДи» (UNIVERSAL_CORRECTION_DOCUMENT_FIX)

receiverInn

string

ИНН получателя документа

receiverName

string

Наименование получателя документа

receiverMod

object

Информация о МОД получателя

invoiceNumber

string

Номер счёта-фактуры, УКД

Если номер отсутствует, то возвращается значение «null»

invoiceDate

string (date-time)

Дата счёта-фактуры, УКД

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

relatedDocId

string

ID документа отгрузки или приёмки

Возвращается для документов «Приёмка» (LP_ACCEPT_GOODS) и «Отгрузка» (LP_SHIP_GOODS, LP_SHIP_GOODS_CSV, LP_SHIP_GOODS_XML)

easCrossborderExportAcceptance

string

Номер приёмки

Возвращается для документов «Приёмка в ЕАЭС» (EAS_CROSSBORDER_EXPORT_ACCEPTANCE), «Приёмка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT_ACCEPTANCE). Параметр заполняется автоматически только при статусе «ACCEPTED» («Принят») документов «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT), «Отгрузка в ЕАЭС (ОСУ)» (EAS_GTIN_CROSSBORDER_EXPORT). Параметр не возвращается, если не заполнен

turnoverType

string

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

Возвращается для «УПД» (UNIVERSAL_TRANSFER_DOCUMENT), «УПДи» (UNIVERSAL_TRANSFER_DOCUMENT_FIX), «УКД» (UNIVERSAL_CORRECTION_DOCUMENT) и для документа «Аннулирование УД» (UNIVERSAL_CANCEL_DOCUMENT)

body

object

Тело документа

Возвращается для типов документов прямой подачи сведений (см. «Справочник «Типы документов»»), «УПД», «УПДи», «УКД», «УКДи», «Аннулирование УД». По документу прямой подачи сведений параметры данного объекта соответствуют параметрам, указанным при создании документа (состав и описание параметров см. в описании соответствующего типа документа)

*cisesList

array[string]

Массив кодов

Массив кодов в теле документа. Возвращается для типов документов «Формирование упаковки» (AGGREGATION_DOCUMENT, AGGREGATION_DOCUMENT_XML) и «Списание» (WRITE_OFF) для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»

content

string

Содержимое документа

Содержимое отправленного документа в формате * .json с набором полей, специфичных для каждого типа документа. См. «Справочник «Типы документов»»

input

boolean

Признак входящего документа

Возможные значения:

true — документ является входящим;
false — документ является исходящим

errors

array of string

Ошибки

Значение параметра возвращается при наличии ошибки в объекте

commonErrors

array of objects

Список общих ошибок обработки документа

Значение параметра возвращается при наличии ошибки всех типов документов прямой подачи и УПД, УПДи, УКД, УКДи

*errorCode

string

Код ошибки

Значение параметра возвращается при наличии ошибки. Для УПД, УПДи, УКД, УКДи и чеков возвращается числовое значение, для документов прямой подачи возвращается ERROR_<числовое значение>

*errorMessage

string

Текст ошибки

*errorObject

string

Значение параметра, в котором обнаружена ошибка

productGroup

array of string

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

См. «Справочник «Список поддерживаемых товарных групп»». Если товарная группа не была заполнена, параметр вернётся со значением «null»

productGroupId

array of integer

ID товарной группы

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

eliminationReason

string

Причина выбытия

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

Пример тела («body») УПД, УПДи:

{
    "body": {
        "sumNds": "777777777",
        "knd": "1111111",
        "function": "СЧФДОП",
        "sellerInfo": {
            "name": "string",
            "inn": "3333333333",
            "kpp": "000000000",
            "address": "string",
            "edoOperatorName": "string"
        },
        "buyerInfo": {
            "name": "string",
            "inn": "9999999999",
            "kpp": "000000001",
            "address": "string"
        },
        "upd": "66666666",
        "updDate": "2020-06-17T00:00:00Z",
        "products": [
            {
                "code": "0104601653034600211rR!RRr8001111000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 1
            },
            {
                "code": "010460165303460021zZZ4;j8005555000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 1
            },
            {
                "code": "0104601653034600211R!r!?!8002222000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 1
            },
            {
                "code": "010460043334000521IIII6i,8003330000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 2
            },
            {
                "code": "0104600439990009219wW/WWW8001110000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 2
            },
            {
                "code": "010460043664000621B%bbB:!8008880000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 2
            },
            {
                "code": "010460620310323221Nn2nnNN8002222000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 3
            },
            {
                "code": "010460620310323221u9Uuu=,8004444000",
                "name": "string",
                "codeType": "EXEMPLARY",
                "strNum": 3
            },
            {
                "code": "000000000000000000000",
                "name": "string",
                "codeType": "OSU",
                "gtin": "04690000000000",
                "quantity": "120",
                "strNum": 4
            },
            {
                "code": "022222222222222222222",
                "name": "string",
                "codeType": "OSU",
                "gtin": "04690000000000",
                "quantity": "100",
                "strNum": 5
            },
            {
                "code": "044444444444444444420",
                "name": "string",
                "codeType": "OSU",
                "gtin": "04690000000000",
                "quantity": "720",
                "strNum": 5
            }
        ],
        "productsTotal": 11
    }
}

Параметры тела («body») УПД, УПДи:

Параметр

Тип

Обяз.

Описание

Параметр в документе в формате * .xml (приказ 736)

Комментарий

*contract

string

Идентификатор государственного контракта

Документ.СвСчФакт.ДопСвФХЖ1.ИдГосКон

*sumNds

string

Сумма с НДС

Документ.ТаблСчФакт.ВсегоОпл.СтТовУчНалВсего

*tax

string

Сумма акциза

Документ.ТаблСчФакт.СведТов.Акциз — суммированное значение акциз

*knd

string

Код документа по КНД

Документ.КНД

*function

string

Функция документа

Документ.Функция

Документы с функциями «СЧФДОП» и «ДОП» (первичный документ), состоящие из двух файлов обмена (файла «Информации продавца» и файла «Информации покупателя»)

*sellerInfo

object

Продавец

**name

string

Наименование продавца

СвПрод.ИдСв.СвЮЛУч.НаимОрг;
СвПрод.ИдСв.СвИП.ФИО;
СвПрод.ИдСв.НаимОрг

**inn

string

ИНН продавца

СвПрод.ИдСв.СвЮЛУч.ИННЮЛ;

СвПрод.ИдСв.СвИП.ИННФЛ

**kpp

string

КПП продавца

СвПрод.ИдСв.СвЮЛУч.КПП

**address

string

Адрес продавца

СвПокуп.Адрес

**edoOperatorName

string

Наименование оператора ЭДО продавца

СвОЭДОтпр.НаимОрг

*buyerInfo

object

Покупатель

**name

string

Наименование покупателя

СвПокуп.ИдСв.СвЮЛУч.НаимОрг;
СвПокуп.ИдСв.СвИП.ФИО;
СвПокуп.ИдСв.НаимОрг

**inn

string

ИНН покупателя

СвПокуп.ИдСв.СвЮЛУч.ИННЮЛ;
СвПокуп.ИдСв.СвИП.ИННФЛ

**kpp

string

КПП покупателя

СвПокуп.ИдСв.СвЮЛУч.КПП

**address

string

Адрес покупателя

СвПокуп.Адрес

**edoOperatorName

string

Наименование оператора ЭДО покупателя

*acceptanceCode

string

Код итога приёмки

*upd

string

Номер УПД

Документ.СвСчФ.СчФакт.НомерСчФ

*updFix

string

Номер УПДи

Документ.СвСчФакт.ИспрСчФ.НомИспрСчФ

*updDate

string (date-time)

Дата УПД

Документ.СвСчФакт.ДатаСчФ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*updFixDate

string (date-time)

Дата УПДи

Документ.СвСчФакт.ИспрСчФ.ДатаИспрСчФ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*products

array of objects

Сведения по кодам

При экземплярном учёте в ответе возвращаются сведения по КИ, при объёмно-сортовом учёте возвращаются сведения по кодам товара (GTIN)

**name

string

Наименование товара по документу УПД, УПДи

Документ.ТаблСчФакт.СведТов.НаимТов

**article

string

Артикул товара

Файл.Документ.ТаблСчФакт.СведТов.ДопСведТов.КодТов

**code

string

Код из документа УПД, УПДи

Файл.Документ.ТаблСчФакт.СведТов.ДопСведТов.НомСредИдентТов.ИдентТрансУпак;
Файл.Документ.ТаблСчФакт.СведТов.ДопСведТов.НомСредИдентТов.НомУпак;
Файл.Документ.ТаблСчФакт.СведТов.ДопСведТов.НомСредИдентТов.КИЗ

Может быть указан КИ для экземплярного учёта и код товара (GTIN) для объёмно-сортового учёта. Коды в ответе отображаются последовательно, как были указаны в документе УПД, УПДи

**codeType

string

Тип кода

Возможные значения:

«EXEMPLARY» — экземплярный учёт;
«OSU» — объёмно-сортовой учёт.

Информация об объёме и сорте товара передаётся в УД в виде регулярного выражения: 02[gtin]37[count]3103[netWeight], где gtin — <код товара> (14 цифр), count — количество товара в единице измерения упаковки (от 1 до 8 цифр), netWeight — переменный вес в килограммах (9 цифр. Первые 6 цифр — килограммы, последние 3 цифры — граммы. Недостающие позиции заполняются лидирующими нулями)

**gtin

string

Код товара

Параметр возвращается только при объёмно-сортовом учёте. Код товара (GTIN) может быть как потребительской упаковки, так и агрегата (набора, групповой упаковки)

**quantity

string

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

Параметр возвращается только при объёмно-сортовом учёте (учёт оборота товаров в разрезе номенклатурной позиции товара (кода товара), который основан на контроле количественных показателей товаров на балансе участника оборота товаров по сведениям универсальных передаточных документов или иных документов, содержащих сведения об операциях с товарами)

**strNum

integer

Номер строки таблицы «Сведения о товаре (работе, услуге), имущественном праве» (Таблица 5.12)

Файл.Документ.ТаблСчФакт.СведТов.НомСтр

*productsTotal

integer

Общее количество кодов в документе

Общее количество кодов всех объектов:
Файл.Документ.ТаблСчФакт.СведТов.ДопСведТов.НомСредИдентТов.ИдентТрансУпак;
Файл.Документ.ТаблСчФакт.СведТов.ДопСведТов.НомСредИдентТов.НомУпак;
Файл.Документ.ТаблСчФакт.СведТов.ДопСведТов.НомСредИдентТов.КИЗ

При экземплярном учёте в ответе возвращается общее количество КИ, при объёмно-сортовом учёте возвращается общее количество кодов товара (GTIN)

Пример тела («body») УКД, УКДи:

{
    "body": {
        "sumNds": "4000.00",
        "knd": "1111111",
        "function": "КСЧФДИС",
        "sellerInfo": {
            "name": "Компания, ООО",
            "inn": "7777777777",
            "kpp": "700000000",
            "address": "000000 ул. Наименование улицы 2",
            "edoOperatorName": "ООО \"Компания \""
        },
        "buyerInfo": {
            "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"Компания\"",
            "inn": "2500000000",
            "kpp": "250111111",
            "address": "000000 г. Город ул. Наименование улицы 1"
        },
        "ucd": "53000000000000000",
        "ucdDate": "2022-07-28T00:00:00Z",
        "upd": "53222222222222222",
        "updDate": "2022-07-28T00:00:00Z",
        "products": [
            {
                "code": "020464004340021000007",
                "name": "string",
                "elementType": "BEFORE",
                "codeType": "OSU",
                "gtin": "04640000000006",
                "quantity": "220",
                "strNum": 1
            },
            {
                "code": "020464004340021000005",
                "name": "string",
                "elementType": "BEFORE",
                "codeType": "OSU",
                "gtin": "04640000000005",
                "quantity": "205",
                "strNum": 1
            },
            {
                "code": "020464434666666665",
                "name": "string",
                "elementType": "BEFORE",
                "codeType": "OSU",
                "gtin": "04640000000004",
                "quantity": "300",
                "strNum": 1
            },
            {
                "code": "010290000970906621sssSsS?s2\":SS",
                "name": "string",
                "elementType": "BEFORE",
                "codeType": "EXEMPLARY",
                "strNum": 1
            },
            {
                "code": "02046400434666666664",
                "name": "string",
                "elementType": "BEFORE",
                "codeType": "OSU",
                "gtin": "04640000000003",
                "quantity": "10",
                "strNum": 1
            },
            {
                "code": "02046400434666666663",
                "name": "string",
                "elementType": "AFTER",
                "codeType": "OSU",
                "gtin": "04640000000002",
                "quantity": "215",
                "strNum": 1
            },
            {
                "code": "02046400434666666662",
                "name": "string",
                "elementType": "AFTER",
                "codeType": "OSU",
                "gtin": "04640000000009",
                "quantity": "250",
                "strNum": 1
            },
            {
                "code": "010290000970900000gggGgG?g2\":GG",
                "name": "string",
                "elementType": "AFTER",
                "codeType": "EXEMPLARY",
                "strNum": 1
            },
            {
                "code": "02046400434666666661",
                "name": "string",
                "elementType": "AFTER",
                "codeType": "OSU",
                "gtin": "04640000000008",
                "quantity": "200",
                "strNum": 1
            },
            {
                "code": "02046400434666666660",
                "name": "string",
                "elementType": "AFTER",
                "codeType": "OSU",
                "gtin": "04640000000007",
                "quantity": "10",
                "strNum": 1
            }
        ],
        "productsTotal": 10
    }
}

Параметры тела («body») УКД, УКДи:

Параметр

Тип

Обяз.

Описание

Параметр в документе в формате * .xml (приказ 736)

Комментарий

*contract

string

Идентификатор государственного контракта

Документ.СвКСчФ.ДопСвФХЖ1.ИдГосКон

*sumNds

string

Сумма с НДС

Разница между значениями, указанными в Документ.ТаблСчФакт.ВсегоУвел.СтТовУчНалВсего и Документ.ТаблСчФакт.ВсегоУм.СтТовУчНалВсего.

Если указано одно значение, то в ответе возвращается это значение

*tax

string

Сумма акциза

Документ.ТаблСчФакт.СведТов.АкцизПосле — суммированное значение акциз

*baseDocument

string

Документ основание

Документ.СодФХЖ3.ДокумОснКор

*knd

string

Код документа по КНД

Документ.КНД

*function

string

Функция документа

Документ.Функция

Документы с функциями «КСЧФДИС» и «ДИС», состоящие из двух файлов обмена (файл «Информация продавца» и файл «Информация покупателя»)

*sellerInfo

object

Продавец

**name

string

Наименование продавца

СвПродПокТип.ИдСв.СвЮЛУч.НаимОрг;
СвПродПокТип.ИдСв.СвИП.ФИО;
СвПродПокТип.ИдСв.НаимОрг

**inn

string

ИНН продавца

СвПродПокТип.ИдСв.СвЮЛУч.ИННЮЛ;
СвПродПокТип.ИдСв.СвИП.ИННФЛ

**kpp

string

КПП продавца

СвПродПокТип.ИдСв.СвЮЛУч.КПП

**address

string

Адрес продавца

СвПродПокТип.Адрес

**edoOperatorName

string

Наименование оператора ЭДО продавца

СвОЭДОтпр.НаимОрг

*buyerInfo

object

Покупатель

**name

string

Наименование покупателя

СвПродПокТип.ИдСв.СвЮЛУч.НаимОрг;
СвПродПокТип.ИдСв.СвИП.ФИО;
СвПродПокТип.ИдСв.НаимОрг

**inn

string

ИНН покупателя

СвПродПокТип.ИдСв.СвЮЛУч.ИННЮЛ;
СвПродПокТип.ИдСв.СвИП.ИННФЛ

**kpp

string

КПП покупателя

СвПродПокТип.ИдСв.СвЮЛУч.КПП

**address

string

Адрес покупателя

СвПродПокТип.Адрес

**edoOperatorName

string

Наименование оператора ЭДО покупателя

*uсd

string

Номер УКД

Документ.СвКСчФ.НомерКСчФ

*upd

string

Номер УПД

Документ.СвКСчФ.СчФ.НомерСчФ

*updFix

string

Номер УПДи

Документ.СвКСчФ.СчФ.ИспрСчФ.НомИспрСчФ

*ucdFix

string

Номер УКДи

Документ.СвКСчФ.ИспрКСчФ.НомИспрКСчФ

*updDate

string (date-time)

Дата УПД

Документ.СвКСчФ.СчФ.ДатаСчФ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*updFixDate

string (date-time)

Дата УПДи

Документ.СвКСчФ.СчФ.ИспрСчФ.ДатаИспрСчФ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*ucdFixDate

string (date-time)

Дата УКДи

Документ.СвКСчФ.ИспрКСчФ.ДатаИспрКСчФ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*ucdDate

string (date-time)

Дата УКД

Документ.СвКСчФ.ДатаКСчФ

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*products

array of objects

Сведения по кодам

При экземплярном учёте в ответе возвращаются сведения по КИ, при объёмно-сортовом учёте возвращаются сведения по кодам товаров (GTIN)

**name

string

Наименование товара по документу УКД, УКДи

Документ.ТаблКСчФ.СведТов.НаимТов

**article

string

Артикул товара

Файл.Документ.ТаблКСчФ.СведТов.ДопСведТов.КодТов

**elementType

string enum

Тип элемента

BEFORE:
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовДо.ИдентТрансУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовДо.НомУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовДо.КИЗ.

AFTER:

Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовПосле.ИдентТрансУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовПосле.НомУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовПосле.КИЗ

Возможные значения:

«BEFORE» — КИ товаров из элемента <НомСредИдентТовДо> до изменения сведений в отношении отгруженного маркированного товара;
«AFTER» — КИ товаров из элемента <НомСредИдентТовПосле> после изменения сведений в отношении отгруженного маркированного товара

**code

string

Код из документа УКД, УКДи

Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовДо.ИдентТрансУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовДо.НомУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовДо.КИЗ;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовПосле.ИдентТрансУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовПосле.НомУпак;
Файл.Документ.ТаблКСчФ.СведТов.НомСредИдентТовПосле.КИЗ

Может быть указан КИ для экземплярного учёта и код товара (GTIN) для объёмно-сортового учёта. Коды в ответе отображаются последовательно, как были указаны в документе УКД, УКДи

**codeType

string

Тип кода

Возможные значения:

«EXEMPLARY» — экземплярный учёт;
«OSU» — объёмно-сортовой учёт.

**gtin

string

Код товара

**quantity

string

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

**strNum

integer

Номер строки таблицы «Сведения о товаре (работе, услуге), имущественном праве» (Таблица 5.12)

Файл.Документ.ТаблСчФакт.СведТов.НомСтр

*productsTotal

integer

Общее количество кодов в документе

Общее количество кодов всех объектов:

Пример тела («body») универсального документа отмены:

{
    "cancelledDocumentId": "ON_NSCHFDOPPRMARK_2BBbb77b7bb777777bb777b7bb7777777b7_2BB7777b777777777b7b7bb7b7b77b77b77_77777777_7A777777-7B77-7D77-8223-777C77A77777"
}

Параметры тела («body») универсального документа отмены:

Параметр

Тип

Обяз.

Описание

Параметр в документе в формате * .xml (приказ 736)

Комментарий

cancelledDocumentId

string

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

Документ.СвПредАн.СведАнФайл.ИмяАнФайла

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

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

URL: /api/v4/true-api/receipt/{receiptId}/info

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

Метод: GET

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

curl -X GET "<url стенда v4>/receipt/{receiptId}/info"
 -H "accept: */*"
-H "Authorization: Bearer <Токен>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

receiptId

string

Идентификатор чека

string

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

body

boolean

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

Возможные значения:

true - содержимое отправленного чека возвращается в ответе метода;
false - содержимое отправленного чека не возвращается в ответе метода. Значение по умолчанию = false

content

boolean

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

Возможные значения:

true - контент чека возвращается в ответе метода;
false - контент чека не возвращается в ответе метода. Значение по умолчанию = false

limit

integer

Количество кодов в теле чека

Значение по умолчанию 5000

Пример ответа для чека с кодом формы «3» (ФФД 1.05):

{
  "documentId": "0000000000000000000",
  "docDate": "2020-12-20T21:43:00.000Z",
  "receivedAt": "2021-04-13T05:04:32.013Z",
  "type": "RECEIPT",
  "status": "CHECKED_NOT_OK",
  "senderInn": "7777777777",
  "senderName": "string",
  "receiverInn": "2222222222",
  "receiverName": "string",
  "total": 55555,
  "vat": 55555,
  "body": {
    "receipt": {
      "dateTime": 1608500580,
      "indicationfiscalSign": 0,
      "provisionSum": 0,
      "fiscalDocumentFormatVer": 2,
      "code": 3,
      "fiscalDriveNumber": "9999999999999999",
      "shiftNumber": 12,
      "ofdINN": "6666666666",
      "operator": "string",
      "ofdName": "string",
      "requestNumber": 10,
      "fnsUrl": "www.nalog.ru",
      "ecashTotalSum": 0,
      "fiscalDocumentNumber": 100,
      "nds18": 18889,
      "taxationType": 1,
      "userInn": "2222222222",
      "kktRegId": "0000000000000000",
      "creditSum": 0,
      "cashTotalSum": 113333,
      "totalSum": 113333,
      "retailAddress": "Not Found",
      "operationType": 1,
      "prepaidSum": 0,
      "items": [
        {
          "quantity": 1,
          "productCode": "RE0ENgVwP0tTL0kqMlZPUWRFJUYl",
          "price": 55555,
          "name": "ТОВАР 2",
          "sum": 55555,
          "nds": 1,
          "productType": 1,
          "paymentType": 4,
          "productUnitMeasure": 0
        },
        {
          "quantity": 1,
          "productCode": "MDEwNDcwMTEwMjUwOTIzNjIxS0FKRzd0bGxlckNmMQ==",
          "price": 55555,
          "name": "ТОВАР 3",
          "sum": 55555,
          "nds": 1,
          "productType": 1,
          "paymentType": 4,
          "packageType": "UNIT",
          "uit": "000000000000000000KqJG0vllerCf0",
          "productUnitMeasure": 0
        }
      ],
      "user": "string",
      "retailPlace": "string"
    }
  },
  "content": "{\"receipt\":{\"dateTime\":1608500580,\"indicationfiscalSign\":0,\"provisionSum\":0,\"fiscalDocumentFormatVer\":2,\"code\":3,\"fiscalDriveNumber\":\"9999999999999999\",\"shiftNumber\":12,\"ofdINN\":\"6666666666\",\"operator\":\"string\",\"ofdName\":\"string\",\"requestNumber\":10,\"fnsUrl\":\"www.nalog.ru\",\"ecashTotalSum\":0,\"fiscalDocumentNumber\":100,\"nds18\":18889,\"taxationType\":1,\"userInn\":\"2222222222\",\"kktRegId\":\"0000000000000000\",\"creditSum\":0,\"cashTotalSum\":113333,\"totalSum\":113333,\"retailAddress\":\"Not Found\",\"operationType\":1,\"prepaidSum\":0,\"items\":[{\"quantity\":1.0,\"productCode\":\"RE0ENgVwP0tTL0kqMlZPUWRFJUYl\",\"price\":55555,\"name\":\"ТОВАР 2\",\"sum\":55555,\"nds\":1,\"productType\":1,\"paymentType\":4},{\"quantity\":1.0,\"productCode\":\"MDEwNDcwMTEwMjUwOTIzNjIxS3FKRzd2bGxlckNmMQ==\",\"price\":55555,\"name\":\"ТОВАР 3\",\"sum\":55555,\"nds\":1,\"productType\":1,\"paymentType\":4}],\"user\":\"string\",\"retailPlace\":\"string\"}}",
  "commonErrors": [
    {
      "errorCode": "ERROR_104",
      "errorMessage": "Код Маркировки неподдерживаемого формата",
      "errorObject": "RE0ENgVwP0tTL0kqMlZPUWRFJUYl"
    },
    {
      "errorCode": "ERROR_85",
      "errorMessage": "Тип упаковки Кода Маркировки 000000000000000000KqJG0vllerCf0 не соответствует выполняемой операции",
      "errorObject": "000000000000000000KqJG0vllerCf0"
    }
  ],
  "productGroup": null,
  "productGroupId": null
}

Пример ответа для чека с кодом формы «82» (ФФД 1.2):

[
   {
      "documentId":"string",
      "docDate":"2025-03-20T11:26:42.000Z",
      "receivedAt":"2025-03-20T11:26:45.363Z",
      "type":"RECEIPT",
      "status":"CHECKED_NOT_OK",
      "senderInn":"7777777777",
      "senderKpp":"111111111",
      "total":2424,
      "vat":444,
      "body":{
         "receipt":{
            "ofdINN":"1234567890",
            "indicationfiscalSign":0,
            "code":3,
            "retailAddress":"string",
            "items":[
               {
                  "productCode":"string",
                  "name":"string",
                  "price":2479,
                  "quantity":1,
                  "nds":1,
                  "productType":2,
                  "paymentType":4,
                  "sum":2479,
                  "uit":"string"
               }
            ],
            "fiscalDriveNumber":"string",
            "kktRegId":"string",
            "userInn":"string",
            "fiscalDocumentNumber":12345677,
            "dateTime":1742470002,
            "shiftNumber":2,
            "requestNumber":3,
            "operationType":1,
            "totalSum":2479,
            "operator":"Администратор",
            "nds0":1,
            "nds18":496,
            "taxationType":1,
            "fnsSiteUrl":"nalog.ru",
            "cashTotalSum":2479,
            "ecashTotalSum":0,
            "prepaidSum":0,
            "creditSum":0,
            "provisionSum":0,
            "fiscalDocumentFormatVer":4
         }
      },
      "content":"{}",
      "cisTotal":1,
      "productGroup":[
         "lp"
      ],
      "productGroupId":[
         1
      ],
      "commonErrors":[

      ]
   }
]

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

Параметр

Тип

Обяз.

Описание

Комментарий

documentId

string

ID чека

docDate

string (date-time)

Дата и время чека

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

receivedAt

string (date-time)

Дата и время получения чека

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

type

string

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

Возможные значения:
RECEIPT – чек;
RECEIPT_RETURN – чек возврата

status

string

Статус обработки документа

senderName

string

Наименование отправителя

senderInn

string

ИНН отправителя

senderKpp

string

КПП отправителя

receiverInn

string

ИНН получателя

receiverName

string

Наименование получателя

receiverKpp

string

КПП отправителя

total

integer

Общая сумма документа

Значение указывается в копейках

vat

integer

Сумма документа с учётом НДС

Значение указывается в копейках

body

string[object]

Содержимое отправленного чека

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

*receipt

object

Содержимое чека

**ofdINN

string

ИНН ОФД

**indicationfiscalSign

number

Признак наличия реквизита ФПД

0 — отсутствует тег 1192 или тег 1192 пустой в версии протокола 1.05;
1 — присутствует тег 1192, который не является пустым.

Признак формируется ОФД и необходим для однозначной идентификации корректирующего чека в протоколе 1.05 относительно чека возврата

**code

number

Код документа для "receipt"

Возможные значения:
3 — для онлайн-ККТ;
4 — бланк строгой отчётности;
31 — кассовый чек коррекции;
41 — бланк строгой отчётности коррекции.

Код документа для "bso":
4 — бланк строгой отчётности

**retailAddress

string

Адрес расчётов (по ФИАС)

Если с ККТ поступил адрес, то передаётся данный адрес, иначе адрес указывается из отчёта о регистрации или перерегистрации ККТ

**items

array of objects

Наименование товара

***productCode

string

Код продукта

***name

string

Наименование предмета расчёта

Параметр может быть пустым (если тег 1214 = 3, а также для ИП со значение тега 1055 = {2,3,8,16,32}, при условии, что тег 1212 != 1 до 01.02.2021)

***price

number

Цена за единицу с учётом скидок и наценок

Параметр может быть пустым. Если отсутствует в ФД, то значение = -1. Если ФД не предусматривает наличие тега, то добавляется со значением -1

***quantity

number

Количество товарных позиций

Параметр не может быть пустым. Если отсутствует в ФД, то значение = -1

***nds

number

Ставка НДС

Возможные значения:
1 — НДС 20%;
2 — НДС 10%;
3 — НДС 20/120;
4 — НДС 10/110;
5 — НДС 0%;
6 — НДС не облагается;
7 — НДС 5%;
8 — НДС 7%;
9 — НДС 5/105;
10 — НДС 7/107;
11 — НДС 22%;
12 — НДС 22/122

***productType

number

Признак предмета расчёта

***paymentType

number

Признак способа расчёта

***sum

number

Стоимость товара с учётом скидок и наценок

Произведение значения реквизита «Цена за единицу», помноженное на значение реквизита «Количество»

***packageType

string

Тип упаковки

***uit

string

Код товара

Возвращается, если в чеке указан закодированный код товара (например, в формате BASE64) и он успешно декодирован

***unitCount

number

Количество товара, шт.

***productGroup

number

Код товарной группы

***innerUnitCount

number

Количество товара в потребительской упаковке, шт.

***productUnitMeasure

integer

Мера количества предмета расчёта

Возможные значения:
«0» — применяется для предметов расчёта, которые могут быть реализованы поштучно или единицами;
«10» — грамм;
«11» — килограмм;
«12» — тонна;
«20» — сантиметр;
«21» — дециметр;
«22» — метр;
«30» — квадратный сантиметр;
«31» — квадратный дециметр;
«32» — квадратный метр;
«40» — миллилитр;
«41» — литр;
«42» — кубический метр;
«50» — киловатт-час;
«51» — гигакалория;
«70» — сутки (день); «71» — час;
«72» — минута;
«73» — секунда;
«80» — килобайт;
«81» — мегабайт;
«82» — гигабайт;
«83» — терабайт;
«255» — применяется при использовании иных единиц измерения, не поименованных в пунктах выше

***codeString

string

Код маркировки с криптохвостом

**fiscalDriveNumber

string

Заводской номер фискального накопителя

**kktRegId

string

Регистрационный номер ККТ

**userInn

string (Unicode)

ИНН пользователя

**fiscalDocumentNumber

number

Порядковый номер ФД

**fiscalSign

string

Фискальный признак документа

**dateTime

number

Дата и время ФД

Реальное время по месту осуществления расчётов. Значение возвращается в формате Unix time

**shiftNumber

number

Номер смены

**requestNumber

number

Номер чека за смену

**operationType

number

Признак расчёта

Возможные значения:
1 — приход;
2 — возврат прихода;
3 — расход;
4 — возврат расхода

**totalSum

number

Сумма расчёта в рублях

**operator

number

Оператор

**nds0

number

Сумма НДС чека

**nds18

number

Сумма НДС чека по ставке 22%

**user

string

Наименование пользователя

**taxationType

number

Применяемая система налогообложения

Возможные значения:
1 — ОСН;
2 — УСН доход;
4 — УСН доход — расход;
8 — ЕНВД;
16 — ЕСХН;
32 — патент

**fnsSiteUrl

string

Адрес сайта ФНС

**cashTotalSum

number

Сумма уплаченная наличными в рублях

Не может быть пустым, если значения нет, то равно 0

**ecashTotalSum

number

Сумма уплаченная безналичными, в рублях

Не может быть пустым, если значения нет, то равно 0

**prepaidSum

number

Сумма предоплаты (авансами)

**creditSum

number

Сумма постоплаты (кредитами)

**provisionSum

number

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

**fiscalDocumentFormatVer

number

Версия формата фискальных данных

**receiptDocumentNumber

number

Номер чека ККТ

**internetPayment

number

Признак расчёта в интернете

Возможные значения:
0 — не интернет;
1 — интернет;
-1 — нет информации

**timeZone

number

Часовая зона

Возможные значения для часовых поясов:
«1» — UTC+2
«2» — UTC+3
«3» — UTC+4
«4» — UTC+5
«5» — UTC+6
«5» — UTC+7
«7» — UTC+8
«8» — UTC+9
«9» — UTC+10
«10» — UTC+11
«11» — UTC+12
«-1» — нет данных

content

string

Контент чека

commonErrors

array of objects

Список ошибок обработки чека

Значение параметра возвращается при наличии ошибки

*errorCode

string

Код ошибки

Значение параметра возвращается при наличии ошибки. Возвращается ERROR_<числовое значение>

*errorMessage

string

Текст ошибки

См. «Коды возвращаемых ошибок при обработке документов ЭДО и чеков». Значение параметра возвращается при наличии ошибки

*errorObject

string

Значение параметра, в котором обнаружена ошибка

cisTotal

integer

Количество КМ в чеке

productGroup

array of string

Наименование товарных групп

Возвращается список для мультитоварных чеков в рамках одного контура (для товарных групп «Молочная продукция», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Табачная продукция», «Упакованная вода»).

Если товарная группа не была заполнена, параметр вернётся со значением null

productGroupId

array of integer

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

Cм. «Справочник «Список поддерживаемых товарных групп»». Возвращается список для мультитоварных чеков в рамках одного контура (для товарных групп «Молочная продукция», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Табачная продукция», «Упакованная вода»)

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

Данный метод используется для отправки документов УПД, УКД, УПД(и), УКД(и) и УПД (отгрузка продукции), ранее загруженных в ГИС МТ, на повторную обработку после исправления ошибки, найденной при предыдущей обработке документа.

Возможна повторная загрузка следующих типов документов: UNIVERSAL_TRANSFER_DOCUMENT, UNIVERSAL_CORRECTION_DOCUMENT, UNIVERSAL_TRANSFER_DOCUMENT_FIX, UNIVERSAL_CORRECTION_DOCUMENT_FIX, FIXATION (см. Справочник «Типы документов»). При загрузке иных типов документов будет выдана ошибка.

После того как документ будет отправлен и принят на повторную обработку статус документа изменится на «IN_PROGRESS» - «Проверяется» (см. «Справочник «Статусы документов»»).

Повторная обработка недоступна для документов в статусах: CHECKED_OK, CANCELLED, PROCESSING_ERROR, IN_PROGRESS (см. «Справочник «Статусы документов»»).

Документ не будет обработан повторно, если по результату его первой обработки в ГИС МТ были зафиксированы следующие типы ошибок:

03 — Проверка формата значения (Недопустимо указывать скобки для идентификаторов применения AI 01, 21, 8005 для кода маркировки <значение кода идентификации>);
4 — Проверка отсутствия регистрации УД (Документ <идентификатор документа> не может быть повторно обработан);
46 — Проверка имени файла и титулов УД (Имя или структура документа некорректны);
54 — Проверка заполненной даты исправления (Дата Исправления УПД(и) имеет пустое значение или имеет неверный формат);
69 — Проверка кода итога приёмки товаров (работ, услуг, прав). Поле «КодИтога» Титула Покупателя (если указан) заполнено некорректным значением;
71 — Проверка наличия сведений о маркированных товарах в УД. Проверка заполнения полей в УД (Содержание документа некорректно. Некорректные данные: <причина отклонения>);
72 — Проверка по типу документа (Некорректный тип документа: <тип документа>);
76 — Проверка ID документа (Документ с id <идентификатор документа> не найден);
79 — Коды идентификации имеют длину менее 18 символов либо содержат недопустимые символы;
103 — Документ не содержит Кодов Маркировки;
107 — Ошибка валидации подписи.

Код ошибки возвращается в параметре «code» («Уникальный код ошибки»).

Повторная обработка документа возможна не ранее, чем через 4 часа.

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

URL: /document/reprocess

Метод: POST

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

curl -X POST "<url стенда>/document/reprocess?pg=shoes"
Content-Type: application/json
Authorization: Bearer <ТОКЕН>

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

{
  "documentId": "string"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

documentId

string

Идентификатор универсального документа (ИдФайл)

Для документа «УПД (отгрузка продукции)» (FIXATION) необходимо указывать идентификатор документа с префиксом «FIX_»

string

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

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

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

В случае успеха 200:

{
   "code":0,
   "description":"Ok",
   "resultDocId":"UTXMNGR00000000000000000013-9339",
   "sourceDocId":"UUD00000000000000000007-5340",
   "nextTimeToReprocess":"2021-02-24T18:33:49.110Z"
}

В случае ошибки 401: «Для доступа к этому ресурсу требуется полная аутентификация»:
```
{
  "error": "string",
  "error_description": "string"
}
```

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

Параметр

Тип

Обяз.

Описание

Комментарий

code

string

Уникальный код ошибки

description

string

Описание кода ошибки

sourceDocId

string

Внутренний идентификатор документа в ГИС МТ

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

resultDocId

string

Внутренний идентификатор квитанции в ГИС МТ

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

nextTimeToReprocess

(date-time)

Следующее время обработки

Возвращается при использовании токена с правами оператора. Значение возвращается в UTC

error

string

Код ошибки

error_description

string

Описание кода ошибки

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

После подачи УПД на стороне ГИС МТ выполняются следующие действия:

проверка регистрации продавца и покупателя УД в ГИС МТ;
проверка валидности УД и отсутствия дублирования в ГИС МТ;
проверка корректности КИ в УД и наличия сведений о маркированных товарах в УД и ГИС МТ;
проверка статусов КИ / агрегатов УД и статуса участника оборота товаров;
проверка наличия товара в объёмно-сортовом учёте по коду товара и возможности указания кода в объёмно-сортовом учёте для товарной группы, к которой относится товар;
проверка наличия допустимого сочетания товарных групп в УД;
проверка формата указания кодов в объёмно-сортовом учёте (без скобок);
проверка наличия положительного ответа по переданному коду товара в Национальном каталоге;
проверка полномочий продавца на операции с КИ.

Описание ошибок, которые возвращаются в случае, если проверка не пройдена, см. в документе «Описание ошибок обработки документов в личном кабинете и по API» и в «Методических рекомендациях по описанию сведений о передаче маркированных товаров при оформлении электронных документов для уведомления ГИС МТ об обороте маркированной продукции» в разделе «Описание кодов ошибки при проверке документов и КИ».

На проверку могут быть отправлены только документы УПД и УПДи до осуществления приёмки продукции со стороны покупателя.

Данный метод поддерживает два типа аутентификационного токена: участника оборота товаров и Оператора ЭДО.

Тип приватности: публичный

URL: /doc/validator/create

Метод: POST

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

curl -X POST "<url стенда>/doc/validator/create"
-H "accept: application/json"
-H "Content-Type: application/json"
--data-raw "{\"id\":\"string\",\"content\":\"string\",\"documentType\":\"string\",\"documentFormat\":\"string\"}"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

ID документа

content

string

Документ, закодированный в base64

Для документа должна использоваться кодировка Windows-1251

documentType

string

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

Поддерживается только тип UPD (универсальный передаточный документ)

documentFormat

string

Формат документа

Поддерживается только формат XML

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

В случае успеха.
```
{
   "message":"string"
}
```
В случае ошибок:

2.1. Код 401: "Невалидный токен".
```
{
   "error_message":"Текст ошибки"
}
```
2.2. Код 409: "Проверяемый документ находится в несуществующем статусе".
```
{
   "error_message":"Текст ошибки"
}
```
2.3. Код 500: "Внутренняя ошибка сервиса".
```
{
   "error_message":"Текст ошибки"
}
```

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

Параметр

Тип

Обяз.

Описание

Комментарий

message

string

Сообщение о том, что подаваемый документ успешно отправлен в ГИС МТ

В случае ошибки выводится сообщение об ошибке

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

Метод предназначен для получения текущего статуса проверки документов УПД и УПДи, направленных в ГИС МТ до проведения первичной отгрузки товаров. Данный метод не используется для получения статуса проверки УКД и УКДи. В успешном ответе возвращается параметр "status" ("Статус проверки") со значением одного из приведённых ниже кодов статусов:

Код

Описание

VERIFIED

Проверка завершена успешно

NOT_VALID

Ошибка проверки

NOT_FOUND

Не найден

IN_PROGRESS

В обработке

AWAITING

В ожидании

Данный метод поддерживает два типа аутентификационного токена: участника оборота товаров и Оператора ЭДО.

Тип приватности: публичный

URL: /doc/validator/status

Метод: POST

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

curl -X POST "/api/v3/true-api/doc/validator/status"
-H "accept: application/json"
-H "Content-Type: application/json"
--data-raw "{\"id\":\"string\"}"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

ID документа

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

В случае успеха.

{
   "status":"VERIFIED",
   "description":"Успешно проверен"
}

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

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

{
   "error_message":"Текст ошибки",
   "error_description":"Описание ошибки"
}

2.2. Код 404: "Документ не найден".

{
   "error_message":"Текст ошибки",
   "error_description":"Описание ошибки"
}

2.3. Код 500: "Внутренняя ошибка сервера".

{
   "error_message":"Текст ошибки",
   "error_description":"Описание ошибки"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

status

string

Статус проверки

errors

array of objects

Ошибка обработки документа

Обязательный, если "status" ("Статус проверки") принимает значение "NOT_VALID" ("Ошибка проверки")

*code

number

Код ошибки

*description

string

Текстовое сообщение с результатом проверки

*cis

string

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

Проверка вложений в КИН/КИТ/КИГУ/КИТУ не осуществляется. Возвращаются КИ/КИН/КИТ/КИГУ/КИТУ (без указания вложений), по которым выявлены ошибки

Выполняется проверка документа на наличие ошибок (см "Коды возвращаемых ошибок при обработке документов ЭДО и чеков"). Ограничение по количеству возвращаемых ошибок по документу: 1000.

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

Метод используется для получения списка КИ и кодов товара по ID документа, обработанного успешно или обработанного с ошибкой. В запросе может быть указан только один ID документа. Метод не предназначен для запроса информации по УПД и УКД. Метод возвращает до 30000 КИ (ограничение для документов прямой подачи 30000 КИ в одном документе), верхний уровень агрегатов не возвращается.

Метод доступен для следующих типов документов: «Списание», «Отгрузка», «Приёмка», «Ввод в оборот. Производство РФ», «Ввод в оборот. Контрактное производство», «Ввод в оборот. Трансграничная торговля», «Ввод в оборот. Производство вне ЕАЭС», «Ввод в оборот. Полученных от физических лиц», «Ввод в оборот. Импорт с ФТС», «Ввод в оборот. Остатки», «Перемаркировка», «Расформирование упаковки», «Трансформация упаковки», «Формирование АТК», «Расформирование АТК», «Вывод из оборота», «Возврат в оборот», «Отгрузка из ЕАЭС с признанием КИ», «Отгрузка из ЕАЭС», «Приёмка отгрузки из ЕАЭС».

URL: /doc/cises

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

Метод: GET

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

curl -X GET "<url стенда v3>/doc/cises?documentId=1ff1f1f1-1111-1111-1f11-11111111ff11&productGroup=shoes"
-H "accept: */*"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

documentId

string

ID документа

productGroup

string

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

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

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

{
   "senderInn":"string",
   "senderName":"string",
   "receiverInn":"string",
   "receiverName":"string",
   "type":"string",
   "status":"string",
   "receivedAt":"2021-05-14T09:29:01.120Z",
   "documentId":"string",
   "turnoverType":"SELLING",
   "relatedDocId":null,
   "cisList":[
      "0000000000000000000000000",
      "1111111111111111111111111",
      "2222222222222222222222222"
   ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

senderInn

string

ИНН отправителя документа

senderName

string

Наименование отправителя документа

receiverInn

string

ИНН получателя документа

receiverName

string

Наименование получателя документа

type

string

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

status

string

Статус обработки документа

Сведения об ошибках обработки документов

receivedAt

string (date-time)

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

documentId

string

ID документа

turnoverType

string

Код типа отгрузки

Возможные значения:

«SELLING» — «Продажа»;
«CONTRACT» — «Передача по АКС»

relatedDocId

string

ID документа «Отгрузка»

Для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция» всегда возвращается значение «null»

cisList

array of string

Массив КИ

Если данный массив не возвращается для типа документа, то возвращается массив «products» («Массив КИ с параметрами»)

products

array of objects

Массив кодов товаров с параметрами

Массив возвращается для типа документа «Перемаркировка»

*cis

string

КИ

*prevCis

string

Предыдущий КИ

Возвращается только для типа документа «Перемаркировка»

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

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

Квитанция по результатам обработки документов ЭДО содержит перечень из первых 10 ошибок по документу. Для получения полного перечня ошибок необходимо использовать "Получение ошибок по результатам обработки документов".

Метод возвращает квитанцию результата обработки документов (УПД, УПД(и), УКД, УКД(и), УПД (отгрузка продукции) и предложения об аннулировании УД) в ГИС МТ, которые были отправлены с 15 июля 2020 года. Запрос направляется по одному документу.

URL: /documents/edo/tpr/ud

Метод: GET

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

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

curl -X GET "<url стенда>/documents/edo/tpr/ud?fileId=ON_NSCHF_...6FA0"
-H "accept: application/json"
-H "Authorization: Bearer <Токен>

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

Параметр

Тип

Обяз.

Описание

Комментарий

fileId

string

Полное имя из "ИдФайл" XML направленного документа

Для документа «УПД (отгрузка продукции)» (FIXATION) необходимо указывать в качестве fileId "FIX_ИдФайл…"

Примечание: метод возвращает только 10 КИ, имеющих одинаковую ошибку. Для получения полного списка КИ, содержащих ошибку, в документе используется метод "Получение ошибок по результатам обработки документов"

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

Пример положительной квитанции:

{
    "resultDocId": "UINT04TXMNGR00000000000000000004-0093",
    "resultDocDate": 1585320802931,
    "sourceDocId": "URCPT00000000000000000005-0031",
    "sourceDocDate": 1585320802315,
    "state": "SUCCESS",
    "code": 0,
    "description": "Document was successfully processed",
    "operations": [
        {
            "operationId": "f817bf34-5d7a-4bc0-842e-a06c873e6d8d",
            "operationDate": 1585320802352,
            "operationType": "DOCUMENT_VALIDATION",
            "details": {
                "successful": "true",
                "tpInternalId": "UCMS00000000000000000018-1476",
                "documentType": "UNIVERSAL_TRANSFER_DOCUMENT",
                "documentName": "ON_NSCHFDOPPRMARK_2EV-600000555_2EV-600000749_20200414_051fc5fc-91e7-48c0-a091-f4f3cba39410",
                "documentNumber": "тест-1",
                "documentDateTime": "14.04.2020"
            }
        },
        {
            "operationId": "773e9985-3bfe-476e-b62d-6e00f8e69166",
            "operationDate": 1585320802398,
            "operationType": "DOCUMENT_ROUTED",
            "details": {
                "productGroups": ["tobacco"]
            }
        },
        {
            "operationId": "a1045297-0cdc-420d-b5e3-b0984ba0e567",
            "operationDate": 1585320802696,
            "operationType": "DOCUMENT_PROCESSED_AT_PRODUCT_GROUP_TOBACCO",
            "details": {"successful": true}
        }
    ]
}

Пример отрицательной квитанции:

{
    "resultDocId": "UINT04TXMNGR00000000000000000004-0093",
    "resultDocDate": 1585320802931,
    "sourceDocId": "URCPT00000000000000000005-0031",
    "sourceDocDate": 1585320802315,
    "state": "FAILED",
    "code": 1,
    "description": "Document processing was failed",
    "operations": [
        {
            "operationId": "f817bf34-5d7a-4bc0-842e-a06c873e6d8d",
            "operationDate": 1585320802352,
            "operationType": "DOCUMENT_VALIDATION",
            "details": {
                "successful": "true",
                "tpInternalId": "UCMS00000000000000000018-1477",
                "documentType": "UNIVERSAL_TRANSFER_DOCUMENT",
                "documentName": "ON_NSCHFDOPPRMARK_2EV-600000555_2EV-600000749_20200414_051fc5fc-91e7-48c0-a091-f4f3cba39410",
                "documentNumber": "тест-1",
                "documentDateTime": "14.04.2020"
            }
        },
        {
            "operationId": "773e9985-3bfe-476e-b62d-6e00f8e69166",
            "operationDate": 1585320802398,
            "operationType": "DOCUMENT_ROUTED",
            "details": {
                "productGroups": ["tobacco"]
            }
        },
        {
            "operationId": "a1045297-0cdc-420d-b5e3-b0984ba0e567",
            "operationDate": 1585320802696,
            "operationType": "DOCUMENT_PROCESSED_AT_PRODUCT_GROUP_TOBACCO",
            "details": {
                "successful": false,
                "errors": [
                    {
                        "code": 22,
                        "text": "Коды маркировки 000000462106543zdK0IB не найдены в ГИС МТ",
                        "error": {
                            "CisNotExists": {},
                          "details": "Текстовое описание ошибки"
                        },
                        "data": {
                            "cis": ["000000462106543zdK0IB"],
                            "count": 1,
                            "tpe": "CisErrorData"
                        }
                    }
                ]
            }
        }
    ]
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

resultDocId

string

Идентификатор результирующей квитанции (цепочки операций)

Значение соответствует значению из атрибута /Квитанция/ГИСМТ/ЛС/@ИдТК транспортной квитанции

resultDocDate

number

Дата формирования результирующей технологической квитанции

sourceDocId

string

Идентификатор логического сообщения в ГИС МТ

Значение соответствует значению атрибута /Квитанция/ГИСМТ/ЛС/@ИдЛС Внутренней транспортной квитанции

sourceDocDate

number

Дата получения входящего логического сообщения

Дата формате UnixDataTime (в миллисекундах)

state

string

Результат обработки исходного документа (УПД, УКД)

Возможные значения:

SUCCESS – документ обработан успешно, получен положительный ответ от всех товарных групп;
FAILED – документ обработан. Ответ получен от всех товарных групп, но в процессе обработки возникли ошибки;
IN_PROGRESS – документ находится в процессе обработки;

code

number

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

Возможные значения:

0 – при state = SUCCESS
1 – при state = FAILED
2 – при state = IN_PROGRESS

description

string

Текстовое описание результата обработки

operations

object[]

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

*operationId

string

Идентификатор операции в ГИС МТ

*operationDate

number

Дата совершения операции в ГИС МТ

Дата формате UnixDataTime (в миллисекундах)

*operationType

string

Тип операции

Возможные значения:

DOCUMENT_VALIDATION – операция валидации документа;
DOCUMENT_ROUTED – операция маршрутизации. Документ отправлен \ не отправлен в товарную группу;
DOCUMENT_PROCESSED_AT_PRODUCT_GROUP_<наименование товарной группы> – получен ответ от товарной группы о результате обработки документа

*docId

string

Идентификатор документа (внутренней квитанции) в ГИС МТ

*docDate

number

Дата формирования документа (внутренней квитанции) в ГИС МТ

Дата формате UnixDataTime (в миллисекундах)

*docHash

string

Хеш документа (внутренней квитанции) в ГИС МТ

*details

object[]

Детали

**productGroups

array of string

Товарные группы

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

**successful

string

Флаг обработки документа на данной стадии

Возможные значения:

true – обработан успешно;
false – обработка завершилась с ошибкой

**tpInternalId

string

Идентификатор транспортного пакета (ТП) в ГИС МТ. Совпадает со значением /Квитанция/ГИСМТ/@ИдТПВнутренний из транспортной квитанции (ТрК)

**documentType

string

Тип входящего документа, на который формируется квитанция

Возможные значения:

UNIVERSAL_TRANSFER_DOCUMENT – УПД;
UNIVERSAL_CORRECTION_DOCUMENT – УКД

**documentName

string

Имя файла УПД\УКД без расширения

Возможные значения:

для УПД - значение из атрибута /Файл/@ИдФайл Титула продавца (ON_NSCHFDOPPRMARK);
для УКД - значение из атрибута /Файл/@ИдФайл Титула продавца (ON_KORSCHFDOPPR)

**documentnumber

string

Номер входящего документа

Возможные значения:

для УПД — значение из атрибута /Файл/Документ/СвСчФакт/@НомерСчФ;
для УКД — значение из атрибута /Файл/Документ/СвКСчФ/@НомерКСчФ

**documentDateTime

string

Дата входящего документа

Формат: ДД.ММ.ГГГГ

Возможные значения:

для УПД — значение из атрибута /Файл/Документ/СвСчФакт/@ДатаСчФ Титула продавца (ON_NSCHFDOPPRMARK);
для УКД — значение из атрибута /Файл/Документ/СвКСчФ/@ДатаКСчФ Титула продавца (ON_KORSCHFDOPPR)

**errors

array of object[]

Объект описания ошибок обработки документа

***code

number

Код ошибки

***text

string

Текстовое описание кодов ошибок

***error

object[]

Содержит внутри себя текстового значение кода ошибки

****CisNotExists

array of string

Значение из столбца "Тестовое описание кода ошибки" таблицы "Коды возвращаемых ошибок при обработке документов ЭДО и чеков"

*****details

string

Текстовое описание ошибки

Поле обязательно для кода ошибки 106 и 107

***data

object[]

Содержит внутри себя детали ошибки

Описание ошибок описано в таблице "Коды возвращаемых ошибок при обработке документов ЭДО и чеков"

****participant

array of string

ИНН участника оборота товаров. Для кодов ошибок: 13 и 102

****cis

array of string

Список кодов идентификации, из-за которых возникла ошибка обработки документа. Для кодов ошибок: 22, 23, 24 и 79

****pack

array of string

Список кодов упаковок, из-за которых возникла ошибка обработки документа. Для кодов ошибок: 22, 23, 24 и 79

****invoice

array of string

Номер документа. Для кодов ошибок: 16, 63 и 64

**** invoiceDate

array of string

Дата документа. Для кодов ошибок: 16, 63 и 64

****fixnumber

array of string

Номер исправления. Для кода ошибки 82

****fixDate

array of string

Дата исправления. Для кода ошибки 82

****count

number

Количество значений в массиве вышестоящего поля

****tpe

string

Служебная информация

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

Метод предназначен для получения квитанции по ID чека, обработанного в ГИС МТ. Получение квитанции по ID чека мелкооптовой продажи доступно как продавцу, так и покупателю, если ИНН из токена совпадает с ИНН продавца или покупателя из чека для всех товарных групп, которым доступна работа с чеками, кроме «Алкоголь» и «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки» (для продукции в кегах).

Тип приватности: публичный

URL: /receipt/documents

Метод: GET

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

curl -X GET "<url стенда v3>/receipt/documents?id=000000000000000001"
-H "Authorization: Bearer <ТОКЕН>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

ID чека

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

Код 200: в случае успеха.

{
   "resultDocId":"UTXMNGR00000000000000000011-1111",
   "resultDocDate":"2021-03-19T09:20:52.105Z",
   "sourceDocId":"URCPT00000000000000000022-2222",
   "sourceDocDate":"2021-03-18T16:10:57.190Z",
   "state":"IN_PROGRESS",
   "code":2,
   "description":"Document in processing",
   "operations":[
      {
         "operationId":"3dd33333-3333-3333-3333-33d333d33d33",
         "operationType":"RECEIPT_VALIDATION",
         "operationDate":"2021-03-18T16:10:57.219Z",
         "details":{
            "ofdInn":"7777777777",
            "successful":"true",
            "documentType":"TICKET",
            "documentNumber":"19",
            "documentDateTime":"1564744080"
         }
      },
      {
         "operationId":"4aa44444-4444-4444-4444-44a444a44a44",
         "operationType":"RECEIPT_ROUTED",
         "operationDate":"2021-03-18T16:10:57.411Z",
         "details":{
            "productGroups":[
               "shoes"
            ],
            "successful":"true"
         }
      }
   ]
}

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

2.1. Код 401: для доступа к ресурсу требуется полная аутентификация.

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

2.2. Код 403: документ недоступен.

{
   "code":403,
   "timestamp":1595487274974,
   "error_message":"Отсутствует доступ к ресурсу"
}

2.3. Код 404: запрашиваемая информация не найдена в ГИС МТ либо допущена ошибка в указании URL метода.

{
   "code":404,
   "description":"Document with id 123 is missing"
}

2.4. Код 500: внутренняя ошибка сервиса.

{
   "code":500,
   "timestamp":1595487274974,
   "error_message":"Ошибка при выполнении запроса"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

resultDocId

string

Уникальный ID квитанции в ГИС МТ

resultDocDate

string

Дата и время окончания обработки документа

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

sourceDocId

string

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

sourceDocDate

string

Дата и время приёма исходного документа

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

state

string

Результат обработки документа

Возможные значения:
SUCCESS - документ обработан успешно;
FAILED - документ обработан с ошибкой;
PARTIALLY - документ обработан частично

code

number

Код обработки документа

Возможные значения:
0 - документ обработан успешно;
1 - документ обработан с ошибкой;
2 - документ обработан частично

description

string

Описание результата обработки документа

operations

array

Список операций, связанных с обработкой документа

*operationId

string

ID операции, присвоенный в ГИС МТ

*operationType

string

Тип операции

Возможные значения:
RECEIPT_VALIDATION - операция валидации документа;
RECEIPT_ROUTED - операция маршрутизации. Документ отправлен/не отправлен в товарную группу;
RECEIPT_SENT_TO_FALLBACK - операция маршрутизации для документа не определена товарная группа. Документ отправлен в очередь документов с неопределённой товарной группой

Получен ответ от товарной группы о результате обработки документа:

RECEIPT_PROCESSED_AT_PRODUCT_GROUP_TOBACCO; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_SHOES; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_LP; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_ELECTRONICS; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_PERFUMERY; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_BICYCLE; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_TIRES; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_WHEELCHAIR; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_WATER; RECEIPT_PROCESSED_AT_PRODUCT_GROUP_MILK

*operationDate

string(date-time)

Дата и время операции

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

*details

array

Дополнительная информация

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

**successful

boolean

Признак успешной обработки

**errors

array

Дополнительная информация об ошибке

Возвращается в случае ошибки

***code

number

Код ошибки

Возвращается в случае ошибки

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

См. в документе «Описание ошибок обработки документов в личном кабинете и по API».

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

В данном разделе описана последовательность формирования выгрузки из ГИС МТ сведений больших объёмов. При работе с методами формирования выгрузок данных из ГИС МТ при запросе в URL указывать v3 (<адрес стенда>/api/v3/true-api/<url метода>).

Участнику оборота товаров предоставляется возможность создания однократных заданий на выгрузку с возможностью скачивания результата в формате * .csv. В результате успешной обработки задания на формирования выгрузки на адрес электронной почты, указанный в личном кабинете участника оборота товаров, приходит уведомление о готовности выгрузки.

Срок хранения сформированных заданий на выгрузку данных из отчёта составляет 10 дней (не относится к другим видам выгрузок). После истечения указанного срока выгрузка данных из отчёта недоступна.

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

с даты удаления файла-выгрузки в успешно сформированном однократном задании на выгрузку;
с даты создания однократного / регулярного типа задания на выгрузку, выполненного с ошибкой;
с даты окончания отправки регулярной выгрузки и удаления последнего файла-выгрузки в успешно сформированном задании на выгрузку.

Формирование выгрузок из ГИС МТ сведений больших объёмов осуществляется согласно следующей последовательности:

Шаг 1. Создание нового задания на выгрузку («Метод создания нового задания на выгрузку») и получение идентификатора задания на выгрузку, используемого на последующих шагах работы с выгрузкой.

Шаг 2. Проверка статуса готовности задания на выгрузку по идентификатору задания на выгрузку («Метод получения статуса задания на выгрузку»).

Шаг 3. Получение результирующего идентификатора для задания на выгрузку в статусе «COMPLETED» («Выполнено») («Метод получения результирующих ID выгрузок данных»).

Шаг 4. Получение сформированного файла выгрузки данных по полученному на третьем шаге результирующему идентификатору выгрузки («Метод получения ZIP-файла выгрузки»). Если выгрузка перемещена в архив или отменена, необходимо сформировать выгрузку повторно.

8.1. Доступность выгрузок по товарным группам

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

Название выгрузки

Кодовое название

Товарные группы

Ограничения доступности по типу организации

Лимит выгрузок в сутки для одной товарной группы

DOCUMENTS_ERRORS

Все, кроме «Кабельно-проводниковая продукция», «Мясные изделия», «Полимерные трубы», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина»

—

2000

Получение списка КИ, принадлежащих участнику оборота товаров

FILTERED_CIS_REPORT

Все, кроме «Кабельно-проводниковая продукция», «Мясные изделия», «Полимерные трубы», «Радиоэлектронная продукция. Ноутбуки и смартфоны»

—

1000

Данные о кодах идентификации, переданных и полученных по агентско-комиссионной схеме

CIS_ACS

«Автозапчасти и комплектующие транспортных средств»,
«Альтернативная табачная продукция»,
«Бакалейная продукция»,
«Велосипеды и велосипедные рамы»,
«Ветеринарные препараты»,
«Духи и туалетная вода»,
«Игры и игрушки для детей»,
«Консервированная продукция»,
«Корма для животных»,
«Косметика, бытовая химия и товары личной гигиены»,
«Молочная продукция»,
«Моторные масла»,
«Натуральный мех»,
«Никотиносодержащая продукция»,
«Обувные товары»

«Оптоволокно и оптоволоконная продукция»,
«Отопительные приборы»,
«Печатная продукция»,
«Пиротехника и огнетушащее оборудование»,
«Полуфабрикаты и замороженные продукты»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Радиоэлектронная продукция»,
«Растительные масла»,
«Сладости и кондитерские изделия»,
«Строительные материалы»,
«Табачная продукция»,

«Титановая металлопродукция»,
«Товары для дома и интерьера»,
«Удобрения в потребительской упаковке»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые»

—

100

Документы, на основании которых была оформлена передача и получение кодов идентификации по агентско-комиссионной схеме (УПД, УКД, УПДи, УКДи)

ACS_DOCUMENTS

«Печатная продукция»,
«Пиротехника и огнетушащее оборудование»,
«Полуфабрикаты и замороженные продукты»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Радиоэлектронная продукция»,
«Растительные масла»,
«Сладости и кондитерские изделия»,
«Строительные материалы»,
«Табачная продукция»,

—

100

Сведения об отклонениях

VIOLATIONS

Все, кроме «Кабельно-проводниковая продукция», «Моторные масла», «Мясные изделия», «Натуральный мех», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Товары для дома и интерьера», «Удобрения в потребительской упаковке»

—

8.2. Доступность выгрузок с типом отчёта по товарным группам

Доступность выгрузок с типом отчёта по товарным группам представлена в таблице ниже.

Название выгрузки

Товарные группы

Ограничения доступности по типу организации

Лимит выгрузок в сутки для одной товарной группы

Кодовое название «REPORT»

Оптовые и розничные продажи в разрезе ИНН *

«Альтернативная табачная продукция»,
«Антисептики и дезинфицирующие средства»,
«Безалкогольное пиво»,
«Велосипеды и велосипедные рамы»,
«Ветеринарные препараты»,
«Духи и туалетная вода»,
«Консервированная продукция»,
«Медицинские изделия»,
«Молочная продукция»,
«Морепродукты»,
«Никотиносодержащая продукция»,
«Обувные товары»,
«Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Растительные масла»,
«Соковая продукция и безалкогольные напитки»,
«Специализированная пищевая продукция и БАД к пище»,
«Табачная продукция»,
«Упакованная вода»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые»

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

См. примечание после таблицы

Оборачиваемость товара *

«Альтернативная табачная продукция»,
«Антисептики и дезинфицирующие средства»,
«Безалкогольное пиво»,
«Велосипеды и велосипедные рамы»,
«Духи и туалетная вода»,
«Консервированная продукция»,
«Медицинские изделия»,
«Молочная продукция»,
«Морепродукты»,
«Никотиносодержащая продукция»,
«Обувные товары»,
«Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Растительные масла»,
«Соковая продукция и безалкогольные напитки»,
«Специализированная пищевая продукция и БАД к пище»,
«Табачная продукция»,
«Упакованная вода»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые»

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

См. примечание после таблицы

Объём розничных продаж в разрезе по ИНН и адресам *

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

См. примечание после таблицы

Средневзвешенная цена в разрезе по GTIN *

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

См. примечание после таблицы

Перечень гтин без определённого производителя *

«Безалкогольное пиво»,
«Консервированная продукция»,
«Молочная продукция»,
«Морепродукты»,
«Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»,
«Соковая продукция и безалкогольные напитки»,
«Упакованная вода»

Доступно только для типов организации: «PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

См. примечание после таблицы

Отчёт по ошибкам в чеках

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

Доступно только для типов организации:

«RETAIL» («Розница и иное»)

100

«Альтернативная табачная продукция»,
«Антисептики и дезинфицирующие средства»,
«Велосипеды и велосипедные рамы»,
«Ветеринарные препараты»
«Духи и туалетная вода»,
«Медицинские изделия»,
«Молочная продукция»,
«Морепродукты»,
«Никотиносодержащая продукция»,
«Обувные товары»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Специализированная пищевая продукция и БАД к пище»,
«Табачная продукция»,
«Упакованная вода»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые»

—

100

Отчёт по ошибкам в УПД

«Альтернативная табачная продукция»,
«Антисептики и дезинфицирующие средства»,
«Бакалейная продукция»,
«Безалкогольное пиво»,
«Велосипеды и велосипедные рамы»,
«Духи и туалетная вода»,
«Игры и игрушки для детей»,
«Корма для животных»,
«Косметика, бытовая химия и товары личной гигиены»,
«Медицинские изделия»,
«Молочная продукция»,
«Морепродукты»,
«Моторные масла»,
«Никотиносодержащая продукция»,
«Обувные товары»,
«Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Соковая продукция и безалкогольные напитки»,
«Специализированная пищевая продукция и БАД к пище»,
«Табачная продукция»,
«Упакованная вода»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые»

—

100

Отчёт по карточкам товаров
(получение сведений по карточкам товаров c ограниченным набором данных)

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

—

100

Отчёт по карточкам товаров – обязательные атрибуты
(получение сведений по карточкам товаров с полным набором данных)

«Антисептики и дезинфицирующие средства»,
«Велосипеды и велосипедные рамы»,
«Духи и туалетная вода»,
«Игры и игрушки для детей»,
«Медицинские изделия»,
«Молочная продукция»,
«Моторные масла»,
«Обувные товары»,
«Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Специализированная пищевая продукция и БАД к пище»,
«Упакованная вода»,
«Шины и покрышки пневматические резиновые новые»

—

100

Сведения по товарам и их владельцам, которые используют зарегистрированные товарные знаки

«Альтернативная табачная продукция»,
«Антисептики и дезинфицирующие средства»,
«Духи и туалетная вода»,
«Консервированная продукция»,
«Медицинские изделия»,
«Молочная продукция»,
«Морепродукты»,
«Никотиносодержащая продукция»,
«Обувные товары»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Соковая продукция и безалкогольные напитки»,
«Специализированная пищевая продукция и БАД к пище»,
«Табачная продукция»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

100

Количество и объём введённых в оборот товаров

«Молочная продукция»,
«Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»,
«Упакованная вода»

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

100

«Антисептики и дезинфицирующие средства»,
«Духи и туалетная вода»,
«Медицинские изделия»,
«Обувные товары»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Специализированная пищевая продукция и БАД к пище»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые»

—

100

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

«Антисептики и дезинфицирующие средства»,
«Корма для животных»
«Молочная продукция»,
«Морепродукты»,
«Растительные масла»,
«Соковая продукция и безалкогольные напитки»,
«Специализированная пищевая продукция и БАД к пище»,
«Упакованная вода»

—

100

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

«Молочная продукция»

—

100

Отчёт по акцизам

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

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

100

Сверочный отчёт по рассчитанному акцизу

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

Доступно только для типов организации:

«PRODUCER» («Производитель товара»),
«IMPORTER» («Импортёр товара»)

100

Сведения по эмиссии и нанесению кодов маркировки

Все, кроме «Автозапчасти и комплектующие транспортных средств», «Мясные изделия», «Натуральный мех», «Полимерные трубы», «Полуфабрикаты и замороженные продукты», «Радиоэлектронная продукция. Ноутбуки и смартфоны», «Радиоэлектронная продукция. Электронные системы доставки никотина», «Сладости и кондитерские изделия», «Товары для дома и интерьера», «Товары из натурального меха», «Удобрения в потребительской упаковке»

—

100

Сведения по начислениям за коды маркировки

—

100

Продажи по аномальным ценам

«Антисептики и дезинфицирующие средства»,
«Альтернативная табачная продукция»,
«Безалкогольное пиво»,
«Велосипеды»,
«Ветпрепараты»,
«Духи и туалетная вода»
«Упакованная вода»,
«Медицинские изделия»,
«Меховые изделия»,
«Молочная продукция»,
«Морепродукты»,
«Никотиносодержащая продукция»,
«Обувные товары»,
«Предметы одежды, бельё постельное, столовое, туалетное и кухонное»,
«Пиво и слабоалкогольные напитки»,
«Соки и безалкогольные напитки»,
«Специализированная пищевая продукция и БАД к пище»,
«Табачная продукция»,
«Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»,
«Шины и покрышки пневматические резиновые новые»

—

100

Примечание: В совокупности по следующим методам: «Получение сведений об оптовых и розничных продажах в разрезе ИНН», «Получение сведений об оборачиваемости товара», «Получение сведений об объёме розничных продаж в разрезе по ИНН и адресам», «Получение сведений о средневзвешенной цене в разрезе по GTIN», «Получение перечня кодов товаров без определённого производителя» максимальное количество созданных заданий на выгрузку для одной товарной группы составляет 10 за сутки. При достижении указанного ограничения создание заданий на выгрузку станет доступно на следующие сутки.

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

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

Формат ответа имеет единую структуру для всех заданий на выгрузку («Пример ответа для всех формируемых запросов на выгрузку»).

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

В разделе описано формирование запроса на детализированную выгрузку ошибок по результатам обработки документов ЭДО. Ограничение по количеству запрашиваемых документов: 1000.

Выгрузка предназначена для запроса сведений по ошибкам обработки документов прямой подачи сведений и ЭДО. В параметрах запроса необходимо передать массив идентификаторов документов. Ограничение по количеству запрашиваемых документов: 1000. Для документов ЭДО передаётся полный идентификатор, равный значению, указываемому в "ИдФайл" документа * .xml. Для документов прямой подачи сведений передаётся идентификатор, присвоенный ГИС МТ.

URL: dispenser/tasks

Тип приватности: публичный

Метод: POST

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

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

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

{
   "format":"CSV",
   "name":"DOCUMENTS_ERRORS",
   "params":"{\"documentId\": [\"uuid\", \"uuid\"]}",
   "periodicity":"SINGLE",
   "productGroupCode":"2"
}

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

Параметр

Тип

Обяз.

Описание

Комментарий

format

string

Формат файла

Допустимое значение:

«CSV»

name

string

Наименование выгрузки

Допустимое значение:

«DOCUMENTS_ERRORS» — «Сведения об ошибках обработки документов»

params

string

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

Пример заполнения:
«{"documentId": ["uuid"]}»

periodicity

string

Вид периодичности выгрузки

Допустимое значение:

«SINGLE» — «Однократная»

productGroupCode

string

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

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

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

Выгрузка предназначена для получения сведений о КИ, находящихся на балансе у участника оборота товаров. У участника оборота товаров, запрашивающего данные из ГИС МТ должен быть подписан договор по товарной группе, указанной в параметре «productGroupCode» («Товарная группа»).

Примечание

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

Вывод сведений о КИ осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате * .json»).

URL: dispenser/tasks

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

приватный;
Оператор.

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
  "format": "CSV",
  "name": "FILTERED_CIS_REPORT",
  "periodicity": "SINGLE",
  "productGroupCode": "2",
  "params": "{\"participantInn\":\"1111111111\",\"packageType\":[\"UNIT\",\"LEVEL1\"],\"status\":\"INTRODUCED\",\"appliedPeriod\":{\"start\": \"2020-01-01T08:02:30.577395Z\",\"end\":\"2020-12-09T08:02:30.577395Z\"},\"emissionPeriod\":{\"start\":\"2020-01-01T08:02:30.577395Z\",\"end\":\"2020-12-09T08:02:30.577395Z\"},\"productionPeriod\":{\"start\":\"2020-01-01T08:02:30.577395Z\",\"end\":\"2020-12-09T08:02:30.577395Z\"},\"includeGtin\": [\"00000000000000\"],\"emissionTypes\":[\"LOCAL\"],\"turnoverTypes\":[\"SELLING\"]}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

format

string

Формат файла

Допустимое значение:

«CSV»

name

string

Наименование выгрузки

Допустимое значение:

«FILTERED_CIS_REPORT» — «Получение списка КИ, принадлежащих участнику оборота товаров»

params

string

Строка параметров задания на выгрузку в формате * .json

*participantInn

string

ИНН участника

*includeGtin

array of strings

Код товара, по которому осуществляется поиск

*packageType

array of strings

Тип упаковки

*status

string

Статус КМ

Необязательный, если заполнен «permitDocIndx» («Индексы разрешительных документов»). В остальных случаях обязательный. Возможные значения см. в разделе «Справочник «Статусы КИ»»

*vsd

string

Идентификатор ВСД

Формат:

[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12};
[A-F0-9]{8}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{12};
[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4};
[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}-[A-F0-9]{4}

*emissionPeriod

string (date-time)

Период отбора по дате эмиссии

**start

string (date-time)

Дата начала периода отбора по дате эмиссии

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

**end

string (date-time)

Дата окончания периода отбора по дате эмиссии

Формат: yyyy-MM-ddTHH:mm:ss.SSS’Z

*productionPeriod

string (date-time)

Период производства

**start

string (date-time)

Дата начала периода отбора по дате производства

**end

string (date-time)

Дата окончания периода отбора по дате производства

*appliedPeriod

string (date-time)

Период отбора по дате нанесения

**start

string (date-time)

Дата начала периода отбора по дате нанесения

**end

string (date-time)

Дата окончания периода отбора по дате нанесения

*emissionTypes

array of strings

Тип эмиссии

Возможные значения см. в «Справочник «Типы эмиссии КИ»»

*turnoverTypes

array of strings

Вид товарооборота

Возможные значения:

«SELLING» — «Продажа / передача товара»;
«CONTRACT» — «Передача по АКС»;
«CONTRACT_RETURN» — «Обратная передача по АКС (возврат)»;
«NOT_SALE» — «Возврата товара от покупателя продавцу»;
«DUPLICATE_TRANSFER» — «Перемещение между участниками не для последующей реализации»;
«DUPLICATE_WAREHOUSE_TRANSFER» — «Перемещение на основании чека мелкого опта»

*statusExt

array of strings

Особое состояние кода

*producerInns

array of strings

Производитель / Импортёр

*eliminationReasons

array of strings

Причина вывода из оборота

См. «Справочник «Список поддерживаемых товарных групп»»

*orderIds

array of strings

Номер заказа в СУЗ

*permitDocIndx

array of integers

Индексы разрешительных документов

Указывается индекс, полученный в ответе метода «Метод получения информации о разрешительном документе по его номеру» (/rd/list) в параметре «indx» («Индекс, присвоенный разрешительному документу»).

Максимально допустимое количество значений — 1000

periodicity

string

Вид периодичности выгрузки

Допустимое значение:
«SINGLE» — «Однократная»

productGroupCode

string

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

8.3.3. Получение данных о движении кодов идентификации по агентско-комиссионной схеме

Выгрузка отображает информацию о передачах и возвратах товаров на основании универсальных документов (УПД, УКД, УПДи, УКДи) и документов прямой подачи сведений «Отгрузка», «Приёмка» (подача документов отключена 01.03.2022) от принципала / комитента агенту / комиссионеру или от агента / комиссионера субагенту / субкомиссионеру.

Примечание

Вывод сведений осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате * .json»).

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
   "format":"CSV",
   "name":"CIS_ACS",
   "periodicity":"SINGLE",
   "params":"{\"inn\": [\"7777777777\"],\"typeOfMovement\": \"SENT\",\"reportType\": \"ALL\"}",
   "productGroupCode":2
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

format

string

Формат файла

Допустимое значение:

«CSV»

name

string

Наименование выгрузки

Допустимое значение:

«CIS_ACS» — «Данные о кодах идентификации, переданных и полученных по агентско-комиссионной схеме»

dataStartDate

string (date)

Дата начала периода

Параметр является обязательным, если «reportType» («Источник сбора данных по кодам») равно «UD» («Сведения только на основании передачи кодов по УД»). Формат: yyyy-MM-dd.

Диапазон: текущая дата минус один год. Например, если текущая дата — 07.05.2024, то допустимой будет любая дата между 07.05.2023 и 07.05.2024.

Максимально допустимое значение периода между датами «dataStartDate» («Дата начала периода») и «dataEndDate» («Дата окончания периода») составляет 90 дней (включительно)

dataEndDate

string (date)

Дата окончания периода

downloadFormat

enum

Формат файла для скачивания

Возможное значение: «XLSX».

Если не указан, выгрузка формируется в формате * .csv.

Для получения выгрузки в формате * .xlsx указать одновременно «format» = «CSV» и «downloadFormat» = «XLSX»

periodicity

string

Вид выгрузки

Допустимое значение:

«SINGLE» — «Однократная»

params

string

Строка параметров задания на выгрузку в формате * .json

*typeOfMovement

enum

Вид движения

Возможные значения:

«SENT» — «Переданные коды от собственника»;
«RECEIVED» — «Полученные коды агентом»

*inn

array of strings

Массив ИНН отправителей или получателей товаров

Участнику оборота товаров доступен запрос выгрузки только по тем кодам идентификации, участником обмена которых он является

*reportType

enum

Источник сбора данных по кодам

Возможные значения:

«UD» — «Сведения только на основании передачи кодов по УД»;
«ALL» — «Сведения с учётом кодов, ранее переданных через отгрузки-приёмки».

Если параметр не передан или передан «null», то значение по умолчанию — «UD» («Сведения только на основании передачи кодов по УД»)

*gtins

array of strings

Список кодов товаров

Заполняется только для «reportType» («Источник сбора данных по кодам») = «ALL» («Сведения с учетом кодов, ранее переданных через отгрузки-приёмки»)

*statuses

array of strings

Список статусов кодов идентификации

Заполняется только для «reportType» («Источник сбора данных по кодам») = «ALL» («Сведения с учетом кодов, ранее переданных через отгрузки-приёмки»). Возможные значения:

«APPLIED» — «Нанесён»;
«INTRODUCED» — «В обороте»;
«INTRODUCED_RETURNED» — «В обороте»;
«WRITTEN_OFF» — «Списан»;
«RETIRED» — «Выбыл» (для всех товарных групп, кроме «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»);
«WITHDRAWN» — «Выбыл» (только для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»);
«DISAGGREGATION» — «Расформирован» (для всех товарных групп, кроме «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»);
«DISAGGREGATED» — «Расформирован» (только для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»)

*packageTypes

array of strings

Список типов упаковок

«UNIT» — «Единица товара»;
«GROUP» — «Групповая упаковка»;
«BOX» — «Транспортная упаковка»;
«ATK» — «АТК»;
«BUNDLE» — «Комплект»;
«SET» — «Набор»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы. См. «Справочник «Список поддерживаемых товарных групп»»

8.3.4. Получение документов по агентско-комиссионной схеме

Выгрузка отражает информацию об универсальных документах (УПД, УКД, УПДи, УКДи), на основании которых была оформлена передача и возврат товаров от принципала / комитента агенту / комиссионеру или от агента / комиссионера субагенту / субкомиссионеру.

Вывод сведений о документах осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате * .json»).

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "format": "CSV",
    "name": "ACS_DOCUMENTS",
    "dataStartDate": "2022-01-01",
    "dataEndDate": "2022-01-02",
    "downloadFormat": "XLSX",
    "params": "{\"receiverInn\": [\"000000000001\"],\"status\": [\"CHECKED_OK\", \"CHECKED_NOT_OK\",\"CANCELLED\"]}",
    "productGroupCode": 3
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

format

string

Формат файла

Возможные значения:

«CSV»

name

string

Наименование выгрузки

Возможные значения:

«ACS_DOCUMENTS» — «Документы, на основании которых была оформлена передача и получение кодов идентификации по агентско-комиссионной схеме» (УПД, УКД, УПДи, УКДи)

dataStartDate

string (date)

Дата начала периода

Дата начала периода, по которому формируется выгрузка (включительно). Формат: yyyy-MM-dd.

dataEndDate

string (date)

Дата окончания периода

Дата окончания периода, по которому формируется выгрузка (включительно). Формат: yyyy-MM-dd.

downloadFormat

enum

Формат файла для скачивания

Допустимые значения:

«XLSX».

Если не указан, выгрузка формируется в формате * .csv.

Для получения выгрузки в формате * .xlsx указать одновременно «format» = «CSV» и «downloadFormat» = «XLSX»

params

string

Строка параметров задания на выгрузку в формате * .json

*senderInn

[string]

Массив ИНН отправителей товара

Обязательный, если не указан «receiverInn» («Массив ИНН получателей товара»). Строго не заполнен, если указан «receiverInn» («Массив ИНН получателей товара»).

Если указан, то в выгрузке будут возвращены все документы, в которых организация, формирующая запрос, указана в качестве получателя, а организация, указанная в параметре «senderInn» («Массив ИНН отправителей товара») — в качестве отправителя

*receiverInn

[string]

Массив ИНН получателей товара

Обязательный, если не указан «senderInn» («Массив ИНН отправителей товара»). Строго не заполнен, если указан «senderInn» («Массив ИНН отправителей товара»).

Если указан, то в выгрузке будут возвращены все документы, в которых организация, формирующая запрос, указана в качестве отправителя товара, а организация, указанная в параметре «receiverInn» («Массив ИНН получателей товара») — в качестве получателя

*status

[string]

Статус обработки документа

Возможные значения:

«CHECKED_OK» — «Обработан»; «CHECKED_NOT_OK» — «Обработан с ошибками»; «CANCELLED» — «Аннулирован».

По умолчанию выгрузка формируется по всем перечисленным статусам

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

8.3.5. Получение сведений об оптовых и розничных продажах в разрезе ИНН

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
   "name":"Оптовые и розничные продажи в разрезе ИНН 00.00.2025",
   "taskTypeShortName":"REPORT",
   "format":"CSV",
   "periodicity":"SINGLE",
   "reportId":"ppr-1955-1-gismt-c",
   "productGroupCode": 1,
   "params":"{\"1023_IC_Period_Week_Single_gismt\":\"2733\"}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в ЛК ГИС МТ. Пример: «Оптовые и розничные продажи в разрезе ИНН 00.00.2025»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение: «REPORT» («Отчёт»)

russianColumns

boolean

Колонки отчёта в формате * csv на русском языке

Возможные значения:

«true» — получение отчёта с названием колонок на русском языке в формате * csv;
«false» — получение отчёта с названием колонок на английском языке в формате * csv. Значение по умолчанию = true

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможные значения:

«ppr-1955-1-gismt-c» — «Оптовые и розничные продажи в разрезе ИНН» (для штучных товарных групп «Антисептики и дезинфицирующие средства», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Медицинские изделия», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Специализированная пищевая продукция и БАД к пище», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые»);

«ppr-1955-1-gismt-w» – «Оптовые и розничные продажи в разрезе ИНН» (для весовых товарных групп «Консервированная продукция», «Молочная продукция», «Соковая продукция и безалкогольные напитки», «Упакованная вода»);

«ppr-1955-1-gismt-cw» – «Оптовые и розничные продажи в разрезе ИНН» (для смешанных товарных групп «Безалкогольное пиво», «Морепродукты», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»);

«ppr-1955-1-gismt-tob» — «Оптовые и розничные продажи в разрезе ИНН» (для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»)

productGroupCode

integer

Товарная группа

Обязательный, если «reportId» = «ppr-1955-1-gismt-c» / «ppr-1955-1-gismt-w» / «ppr-1955-1-gismt-cw» / «ppr-1955-1-gismt-tob».

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*1023_IC_Period_Week_Single_gismt

string

Период выгрузки (номер недели)

Указать период выгрузки в виде порядкового номера недели при отсчёте с 1 января 1970 года.

Формула для расчёта:
(год_выгрузки - 1970) * 52,1786 + номер_недели_в_году_выгрузки.
Полученное при расчёте число всегда округляется до целого в меньшую сторону.

Например, для задания периода выгрузки «16.05.2022 — 22.05.2022» (20 неделя 2022 года) указать значение «2733»:
(2022 - 1970) * 52,1786 + 20 = 2733,2872

*1113_IC_Product_group_tobacco

array of strings

Табачная товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «Альтернативная табачная продукция»;
«16» — «Никотиносодержащая продукция»

8.3.6. Получение сведений об оборачиваемости товара

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
   "name":"Оборачиваемость товара 00.00.2025",
   "taskTypeShortName":"REPORT",
   "format":"CSV",
   "periodicity":"SINGLE",
   "reportId":"ppr-1955-2-gismt-c",
   "productGroupCode": 1,
   "params":"{\"0151_IC_Agg_116_ppr_1955_2\":\"IC_Period_Week\",\"1013_IC_Period_Day\":\"2025-05-13\"}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в ЛК ГИС МТ. Пример: «Оборачиваемость товара 00.00.2025»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

russianColumns

boolean

Колонки отчёта в формате * csv на русском языке

Возможные значения:

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможные значения:

«ppr-1955-2-gismt-c» — «Оборачиваемость товара» (для штучных товарных групп «Альтернативная табачная продукция», «Антисептики и дезинфицирующие средства», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Медицинские изделия», «Никотиносодержащая продукция», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Специализированная пищевая продукция и БАД к пище», «Табачная продукция», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые»);

«ppr-1955-2-gismt-w» – «Оборачиваемость товара» (для весовых товарных групп «Консервированная продукция», «Молочная продукция», «Соковая продукция и безалкогольные напитки», «Упакованная вода»);

«ppr-1955-2-gismt-cw» – «Оборачиваемость товара» (для смешанных товарных групп «Безалкогольное пиво», «Морепродукты», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»)

productGroupCode

integer

Товарная группа

Обязательный, если «reportId» = «ppr-1955-2-gismt-c» / «ppr-1955-2-gismt-w» / «ppr-1955-2-gismt-cw».

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0151_IC_Agg_116_ppr_1955_2

string

Вид периода

Возможные значения:

«IC_Period_Week» — «По периоду реализации»;
«IC_Period_Month» — «По месяцу производства»

*1013_IC_Period_Day

string

Период выгрузки

Обязательный, если «0151_IC_Agg_116_ppr_1955_2» = «IC_Period_Week». В остальных случаях не заполняется. Данные формируются на указанную дату, включая 6 предшествующих дней.

Формат: yyyy-MM-dd

*1018_IC_Period_Month_Single_rolling

string

Период выгрузки (номер месяца)

Обязательный, если «0151_IC_Agg_116_ppr_1955_2» = «IC_Period_Month». В остальных случаях не заполняется.

Указать период выгрузки в виде порядкового номера месяца.

Формула для расчёта:
текущий_год * 12 + номер_месяца_в_году_выгрузки.

Например, для задания периода выгрузки «Декабрь 2021» (12-й месяц 2021 года) указать значение «24264»:
2021 * 12 + 12 = 24264

*1113_IC_Product_group_tobacco

array of strings

Табачная товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «Альтернативная табачная продукция»;
«16» — «Никотиносодержащая продукция»

8.3.7. Получение сведений об объёме розничных продаж в разрезе по ИНН и адресам

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
   "name":"Объем розничных продаж в разрезе по ИНН и адресам 00.00.2025",
   "taskTypeShortName":"REPORT",
   "format":"CSV",
   "periodicity":"SINGLE",
   "reportId":"ppr-1955-3-gismt-c",
   "productGroupCode": 1,
   "params":"{\"1025_IC_Period_Week_Single_gismt\":\"2733\"}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в ЛК ГИС МТ. Пример: «Объем розничных продаж в разрезе по ИНН и адресам 00.00.2025»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

russianColumns

boolean

Колонки отчёта в формате * csv на русском языке

Возможные значения:

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение: «SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможные значения:

«ppr-1955-3-gismt-c» – «Объем розничных продаж в разрезе по ИНН и адресам» — (для штучных товарных групп «Антисептики и дезинфицирующие средства», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Медицинские изделия», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Специализированная пищевая продукция и БАД к пище», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые»);

«ppr-1955-3-gismt-w» – «Объем розничных продаж в разрезе по ИНН и адресам» (для весовых товарных групп «Консервированная продукция», «Молочная продукция», «Соковая продукция и безалкогольные напитки», «Упакованная вода»);

«ppr-1955-3-gismt-cw» – «Объем розничных продаж в разрезе по ИНН и адресам» (для смешанных товарных групп «Безалкогольное пиво», «Морепродукты», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»);

«ppr-1955-3-gismt-tob» — «Объем розничных продаж в разрезе по ИНН и адресам» (для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»)

productGroupCode

integer

Товарная группа

Обязательный, если «reportId» = «ppr-1955-3-gismt-c» / «ppr-1955-3-gismt-w» / «ppr-1955-3-gismt-cw» / «ppr-1955-3-gismt-tob».

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*1025_IC_Period_Week_Single_gismt

string

Период выгрузки (номер недели)

Указать период выгрузки в виде порядкового номера недели при отсчёте с 1 января 1970 года.

Формула для расчёта:
(год_выгрузки - 1970) * 52,1786 + номер_недели_в_году_выгрузки.

Например, для задания периода выгрузки «16.05.2022 — 22.05.2022» (20 неделя 2022 года) указать значение «2733»:
(2022 - 1970) * 52,1786 + 20 = 2733

*1113_IC_Product_group_tobacco

array of strings

Табачная товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «Альтернативная табачная продукция»;
«16» — «Никотиносодержащая продукция»

8.3.8. Получение сведений о средневзвешенной цене в разрезе по GTIN

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "Средневзвешенная цена в разрезе по GTIN 00.00.2025",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "ppr-1955-4-gismt-c",
    "productGroupCode": 1,
    "params": "{\"0150_IC_Agg_116_ppr_1955\": \"IC_Period_Week\", \"0179_IC_Agg_116_ppr_1955_4_gis\": \"Agg_Total___0150\", \"1018_IC_Period_Month_Single_rolling\": \"2822\"}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в ЛК ГИС МТ. Пример: «Средневзвешенная цена в разрезе по GTIN 00.00.2025»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

russianColumns

boolean

Колонки отчёта в формате * csv на русском языке

Возможные значения:

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Допустимое значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможные значения:

«ppr-1955-4-gismt-c» — «Средневзвешенная цена в разрезе GTIN» (для штучных товарных групп «Альтернативная табачная продукция», «Антисептики и дезинфицирующие средства», «Велосипеды и велосипедные рамы», «Ветеринарные препараты», «Духи и туалетная вода», «Медицинские изделия», «Никотиносодержащая продукция», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Растительные масла», «Специализированная пищевая продукция и БАД к пище», «Табачная продукция», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые»);

«ppr-1955-4-gismt-w» – «Средневзвешенная цена в разрезе GTIN» (для весовых товарных групп «Консервированная продукция», «Молочная продукция», «Соковая продукция и безалкогольные напитки», «Упакованная вода»);

«ppr-1955-4-gismt-cw» – «Средневзвешенная цена в разрезе GTIN» (для смешанных товарных групп «Безалкогольное пиво», «Морепродукты», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»)

productGroupCode

integer

Товарная группа

Обязательный, если «reportId» = «ppr-1955-4-gismt-c» / «ppr-1955-4-gismt-w» / «ppr-1955-4-gismt-cw».

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0150_IC_Agg_116_ppr_1955

string

Вид периода

Возможные значения:

«IC_Period_Week» — «Выгрузка за неделю»;
«IC_Period_Month» — «Выгрузка за месяц»

*0179_IC_Agg_116_ppr_1955_4_gis

string

Вид отчёта

Возможные значения:

«Agg_Total___0150» — «Средневзвешенная цена в разрезе по GTIN без детализации до ИНН выбытия»;
«Agg_Detail___0150» — «Средневзвешенная цена в разрезе по GTIN»

*1013_IC_Period_Day

string

Период выгрузки

Обязательный, если «0150_IC_Agg_116_ppr_1955» = «IC_Period_Week». В остальных случаях не заполняется. Данные формируются на указанную дату, включая 6 предшествующих дней.

Формат: yyyy-MM-dd

*1018_IC_Period_Month_Single_rolling

string

Период выгрузки (номер месяца)

Обязательный, если «0150_IC_Agg_116_ppr_1955» = «IC_Period_Month». В остальных случаях не заполняется.

Указать период выгрузки в виде порядкового номера месяца.

Формула для расчёта:
текущий_год * 12 + номер_месяца_в_году_выгрузки.

Например, для задания периода выгрузки «Декабрь 2021» (12-й месяц 2021 года) указать значение «24264»:
2021 * 12 + 12 = 24264

*1113_IC_Product_group_tobacco

array of strings

Табачная товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «Альтернативная табачная продукция»;
«16» — «Никотиносодержащая продукция»

8.3.9. Получение перечня кодов товаров без определённого производителя

Метод предназначен для вывода сведений о товарах, по которым со старта обязательной маркировки были зафиксированы данные о более чем одном производителе / импортёре.

Сведения о товарах формируются только для потребительской упаковки. При этом в расчётах не учитываются данные, связанные с перемаркированными товарами и остатками товаров.

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "Перечень гтин без определенного производителя 00.00.2025",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "ppr-1955-5-gismt-w",
    "productGroupCode": 13,
    "params": "{}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в ЛК ГИС МТ. Пример: «Перечень гтин без определенного производителя 00.00.2025»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

russianColumns

boolean

Колонки отчёта в формате * csv на русском языке

Возможные значения:

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«ppr-1955-5-gismt-w» – «Перечень гтин без определенного производителя» (для весовых товарных групп «Консервированная продукция», «Молочная продукция», «Соковая продукция и безалкогольные напитки», «Упакованная вода»);

«ppr-1955-5-gismt-cw» – «Перечень гтин без определенного производителя» (для смешанных товарных групп «Безалкогольное пиво», «Морепродукты», «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»)

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

8.3.10. Получение сведений об ошибках в чеках

URL: dispenser/tasks

Тип приватности:

приватный;
Оператор.

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "receipt-error",
    "productGroupCode": 19,
    "params": "{\"0155_IC_Agg_117_receipt_error\":\"agg_statistics\",\"1133_IC_Product_group_all_ss\":\"19\",\"0308_IC_Error_type_receipt\":[\"2\",\"3\",\"4\",\"5\",\"6\",\"8\",\"9\"],\"0202_IC_Date_From\":\"2022-05-01\",\"0203_IC_Date_To\":\"2022-06-30\"}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Задание на выгрузку отображается в ЛК ГИС МТ под указанным названием

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» — «Отчёт»

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«receipt-error» – «Отчёт по ошибкам в чеках»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0155_IC_Agg_117_receipt_error

string

Вид отчёта

Возможные значения:

«agg_statistics» — «Статистика по ошибкам в чеках»;
«agg_dynamics» — «Динамика ошибок в чеках»;
«agg_errors» — «Динамика чеков с ошибками и без»

*1133_IC_Product_group_all_ss

string

Товарная группа

Цифровой код товарной группы.

Возможные значения:

0 — «Все»;
1 — «Предметы одежды, бельё постельное, столовое, туалетное и кухонное»;
2 — «Обувные товары»;
3 — «Табачная продукция»;
4 — «Духи и туалетная вода";
5 — «Шины и покрышки пневматические резиновые новые»;
6 — «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки»;
8 — «Молочная продукция»;
9 — «Велосипеды и велосипедные рамы»;
10 — «Медицинские изделия»;
12 — «Альтернативная табачная продукция»;
13 — «Упакованная вода»;
15 — «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»;
16 — «Никотиносодержащая продукция»;
17 — «Специализированная пищевая продукция и БАД к пище»;
19 — «Антисептики»;
21 — «Морепродукты»;
26 — «Ветеринарные препараты»

*0308_IC_Error_type_receipt

array of strings

Тип ошибки

Цифровой код ошибки.

Возможные значения:

2 — «Код маркировки неподдерживаемого формата»;
3 — «Ошибка валидации дополнительных свойств в чеке»;
4 — «Чек из будущего»;
5 — «Чек из прошлого»;
6 — «Адрес не заполнен»;
8 — «Не заполнена сумма за позицию маркированного товара в чеке»;
9 — «Количество товаров не равно единице»;
11 — «Ошибка верификации КМ»;
12 — «КМ не найдены в ГИС МТ»;
13 — «У участника нет полномочий на выполнение операции с КМ»;
14 — «Статус КМ не соответствует выполняемой операции»;
15 — «Документ с таким номером уже зарегистрирован в ГИС МТ»;
16 — «Недопустимые значения полей в чеке относительно ФФД»;
17 — «Содержание документа некорректно, имеется логическая ошибка»;
18 — «Поля не прошли валидацию на входе ккт-онлайн»;
19 — «Тип упаковки КИ не соответствует выполняемой операции»;
20 — «Код КИ не может быть возвращен в оборот, так как причина вывода не соответствует розничной реализации»;

31 — «Инверсия регистра в КМ»;
32 — «Инверсия регистра в Криптохвосте»;
33 — «Верхний регистр в КМ»;
34 — «Нижний регистр в КМ»;
35 — «Передано несколько КМ без разделителя»;
36 — «Криптохвост обрезан»;
37 — «Криптохвост содержит последовательность символов 930104»;
38 — «Криптохвост содержит последовательность символов 933»;
39 — «Серийный номер больше ожидаемой длины»;
40 — «Передан КМ без криптохвоста»;
41 — «КИ с криптохвостом не найден»;
42 — «Без разделителя GS»

*0202_IC_Date_From

string

Начало периода

Формат: yyyy-MM-dd

*0203_IC_Date_To

string

Окончание периода

Формат: yyyy-MM-dd

productGroupCode

string

Товарная группа

8.3.11. Получение сведений об ошибках в УД

Данный метод позволяет получить сведения об ошибках в УД, выявленных в ГИС МТ.

URL: dispenser/tasks

Тип приватности:

приватный;
Оператор.

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "Отчёт по ошибкам в УПД_00.00.2022",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "upd-error",
    "productGroupCode": 19,
    "params": "{\"0156_IC_Agg_120_upd_error\":\"agg_statistics\",\"0309_IC_Error_type_upd\":[\"4\",\"10\",\"12\",\"13\"],\"0202_IC_Date_From\":\"2022-00-00\",\"0203_IC_Date_To\":\"2022-00-00\"}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Задание на выгрузку отображается в ЛК ГИС МТ под указанным названием

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» — «Отчёт»

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«upd-error» – «Отчёт по ошибкам в УД»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0156_IC_Agg_120_upd_error

string

Вид отчёта

Возможные значения:

«agg_statistics» — «Статистика по ошибкам в УД»
«agg_dynamics» — «Динамика ошибок в УД»;
«agg_errors» — «Динамика УД с ошибками и без»

*0309_IC_Error_type_upd

array of strings

Тип ошибки

Цифровой код ошибки.

Возможные значения:

03 — «Недопустимо указывать скобки для идентификаторов применения AI 01, 21, 8005 для кода маркировки <значение кода идентификации>»;
06 — «Код товара <код товара> не найден в базе данных»;
06 — «Данные по указанным ИНН <искомый ИНН> и КПП <искомый КПП> не найдены»;
4 — «Документ <идентификатор документа> зарегистрирован ранее»;
7 — «Последний успешный УД не найден для счёт-фактуры №: <номер счёт-фактуры>, дата: <дата счёт-фактуры>»;
8 — «08: Значение поля "<наименование параметра>" не найдено в списке допустимых»;
10 — «Продавец не идентифицирован (не зарегистрирован)»;
12 — «Покупатель не идентифицирован (не зарегистрирован)»;
13 — «Участник <номер ИНН> не идентифицирован (не зарегистрирован)»;

14 — «УПД <идентификатор документа> для счет-фактуры №: <номер счёт-фактуры>, дата: <дата счёт-фактуры> зарегистрирован ранее»;
16 — «В ГИС МТ ранее был успешно обработан УКД/УКД(и) с такими же № и датой УКД»;
18 — «Код Маркировки <значение кода идентификации> был изменён более поздним документом: <идентификатор документа>»;
19 — «Отсутствуют записи в истории по Коду Маркировки: <значение кода идентификации>»;
20 — «Последняя запись в истории Кода Маркировки: <значение кода идентификации> не соответствует изменению по документу. ИД документа не указан»;
21 — «Код Маркировки <значение кода идентификации> с родителем <значение текущего кода идентификации агрегата> нельзя агрегировать в <новое значение кода идентификации агрегата>»;
22 — «Коды Маркировки <значение кода идентификации> не найден(ы)»;
23 — «На момент обработки документа поставщик не является владельцем указанного КИ»;

24 — «Статус КИ или их состояние не соответствуют выполняемой операции»;
25 — «Коды идентификации <значение кода идентификации> не принадлежат товарной группе "<наименование товарной группы>"»;
26 — «Участник <номер ИНН> не зарегистрирован в ЕГРИП/ЕГРЮЛ как действующее лицо»;
27 — «Для УД (счет-фактура №: <номер счёт-фактуры>, дата: <дата счёт-фактуры>) не найдены истории КМ»;
38 — «Код идентификации не имеет вложений»;
41 — «Недостаточное описание товара»; 44 — «Ошибка валидации документа <идентификатор документа> по XSD-схеме»;
46 — «Содержание или имя документа некорректно»;
54 — «Дата Исправления УПД(и) имеет пустое значение или имеет неверный формат»;
60 — «Продукция с указанным GTIN не описано в Национальном каталоге»;
63 — «В ГИС МТ ранее был успешно обработан УПД с такими же номером и датой УПД»;
64 — «В ГИС МТ ранее был успешно обработан УПД(и) с № и датой УПД или с № и датой исправления позже, чем у текущего направленного УПД(и)»;

68 — «Код маркировки не оплачен»;
69 — «Содержание или имя документа некорректно»;
71 — «Содержание документа некорректно»;
75 — «Код маркировки имеет некорректный тип эмиссии";
76 — «Документ с id не найден»;
77 — «Документ, аннулирующий УПД, не валидный»;
79 — «Неверный код маркировки»;
81 — «Код маркировки отсутствует в цепочке универсальных документов»;
82 — «В ГИС МТ ранее был успешно обработан УПДи с такими же номером и датой УПДи»; 83 — «Некорректная последовательность УД для кода маркировки»;
103 — «Документ не содержит кодов маркировки»;
104 — «В документе указаны КИ неподдерживаемого формата»;
106 — «Ошибка валидации документа»;
107 — «Ошибка валидации подписи»;
108 — «Произошла сервисная ошибка»;

109 — «Документ находится в обработке. Повторная обработка возможна после завершения текущего процесса»;
111 — «Произошла ошибка маршрутизации документа»;
116 — «В документе указаны КИ, не введенные в оборот»;
117 — «Передан КМ, не введённый в оборот»;
123 — «Документ основание обработан с ошибкой или не найден»;
125 — «Некорректный префикс документа»;
141 — «Товарная группа в карточке товара не подходит для Объемно-сортового учёта»;
142 — «В документе невозможно одновременно использовать поэкземплярный и сортовой разрез сведений»;
143 — «Сведения о маркированных товарах в документе должны передаваться аналогично родительскому УПД»;
146 — «Код маркировки уже отгружен/продан»;
177 — «Попытка возврата продавцу кода маркировки проданного покупателем»;
178 — «Наличие в УКД сведений об идентификаторе гос.контракта отличается от наличия сведений в документе-основании»;

179 — «Невозможно определить сведения о выбытии на основании полученного УКД»;
189 — «МОД <значение КПП> заблокирован в ЕГАИС»;
190 — «Ошибка формата данных, применяемых при указании ОСУ»;
196 — «Кода ФИАС <значение> нет в списке МОД для данной организации c ИНН <значение>»;
215 — «Документ не поддерживает вывод из оборота для объемно-сортового учёта (ОСУ) в данной товарной группе»;
261 — «Операция недоступна в связи с отсутствием лицензии на указанный вид продукции или вид деятельности»;
262 — «Операция недоступна в связи с отсутствием указанного адреса в лицензии»; 263 — «Операция недоступна в связи с отсутствием активных лицензий для указанного вида деятельности или вида продукции»;
270 — «Товарная группа <название товарной группы> не подходит для Объемно-сортового учёта при перемещении между УОТ»;
271 — «МОД грузополучателя не соответствует сведениям, указанным в исходном документе»;

273 — «КМ <значение кода идентификации> не отгружен»;
274 — «КМ <значение кода идентификации> уже отгружен»;
275 — «ИНН продавца должен соответствовать ИНН грузоотправителя»;
275 — «ИНН покупателя должен соответствовать ИНН грузополучателя»;
277 — «Содержание документа отличается от исходного, указанного при отгрузке»;
282 — «Не удалось идентифицировать МОД грузоотправителя/грузополучателя»;
294 — «ТГ <товарная группа> в документе не поддерживает передачу по АКС»

*0310_IC_Doc_Type_120

array of strings

Тип документа

Возможные значения:

«УПД»;
«УПД(и)»;
«УКД»;
«УКД(и)»;
«Аннулирование»

*0312_IC_Doc_direction

array of strings

Направление документа

Возможные значения:

«in_direction» — «Входящие документы»;
«out_direction» — «Исходящие документы»

*0202_IC_Date_From

string

Начало периода

Формат: yyyy-MM-dd

*0203_IC_Date_To

string

Окончание периода

Формат: yyyy-MM-dd

8.3.12. Получение сведений по карточкам товаров

URL: dispenser/tasks

Тип приватности:

приватный;
Оператор.

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "product-cards",
    "productGroupCode": 1,
    "params": "{\"1133_IC_Product_card_type\": [\"комплект\"], \"1134_IC_Product_good_mark\": [\"нет\"], \"1135_IC_Product_good_turn\": [\"не применимо\"], \"1136_IC_Product_group_all_ms\":[\"1\",\"2\",\"3\",\"4\"], \"products\": [\"77777777777777\"]}"
}

Параметры запроса:

Параметр Тип Обяз. Описание Комментарий

name

string

Наименование задания на выгрузку

Задание на выгрузку отображается в ЛК ГИС МТ под указанным названием

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» — «Отчёт»

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможные значения:

Получение сведений по карточкам товаров c ограниченным набором данных:

«product-cards» – «Отчёт по карточкам товаров».

Получение сведений по карточкам товаров с полным набором данных:

«product-cards-beer» – «Отчёт по карточкам товаров — обязательные атрибуты (пиво)» (для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»);
«product-cards-fashion» – «Отчёт по карточкам товаров — обязательные атрибуты (одежда и бельё)»;
«product-cards-milk» – «Отчёт по карточкам товаров — обязательные атрибуты (молоко)»;

«product-cards-perfume» – «Отчёт по карточкам товаров — обязательные атрибуты (парфюмерия)» (для товарной группы «Духи и туалетная вода»);
«product-cards-shoes» – «Отчёт по карточкам товаров — обязательные атрибуты (обувь)»;
«product-cards-tires» – «Отчёт по карточкам товаров — обязательные атрибуты (шины)»;
«product-cards-water» – «Отчёт по карточкам товаров — обязательные атрибуты (упакованная вода)»;

«product-cards-bio» – «Отчёт по карточкам товаров – обязательные атрибуты (БАД)»;
«product-cards-antiseptic» – «Отчёт по карточкам товаров – обязательные атрибуты (Антисептики)»;
«product-cards-wheelchairs» – «Отчёт по карточкам товаров – обязательные атрибуты (Медицинские изделия)»;
«product-cards-wheelchairs-actual» – «Отчёт по карточкам товаров – обязательные атрибуты (Кресла-коляски)»;
«product-cards-autofluids» – «Отчёт по карточкам товаров – обязательные атрибуты (Моторные масла)»;
«product-cards-bicycle» – «Отчёт по карточкам товаров – обязательные атрибуты (Велосипеды)»;
«product-cards-toys» – «Отчёт по карточкам товаров – обязательные атрибуты (Игры и игрушки для детей)»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания в формате * .json

*1136_IC_Product_group_all_ms

array of strings

Товарная группа

Указывается, если «reportId» = «product-cards». Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

*0202_IC_Date_From

string

Начало периода

Указывается, если «reportId» ≠ «product-cards».

Формат: yyyy-MM-dd

*0203_IC_Date_To

string

Окончание периода

Указывается, если «reportId» ≠ «product-cards».

Формат: yyyy-MM-dd

*1133_IC_Product_card_type

array of strings

Тип карточки

Возможные значения:

единица товара;
остатки (короткая схема);
групповая упаковка;
набор;
комплект;
техническая карточка

*1134_IC_Product_good_mark

array of strings

Готов к заказу КМ

Возможные значения:

да;
нет;
не применимо

*1135_IC_Product_good_turn

array of strings

Готов к вводу в оборот

Возможные значения:

да;
нет;
не применимо

*1137_IC_Product_card_status

array of strings

Статус карточки

Указывается, если «reportId» ≠ «product-cards». Возможные значения:

«published» — «Опубликована»;
«draft» — «Не опубликована»;
«archived» — «В архиве»

*products

array of strings

Код товара (GTIN) / Наименование товара

Коды товаров следует указывать через запятую, без пробелов. Для получения информации по всем кодам товаров необходимо указать параметр с пустым значением ("products":"")

8.3.13. Получение сведений по товарам и их владельцам, которые используют зарегистрированные товарные знаки

Данный метод позволяет участнику оборота товаров получить подробные сведения по своим товарным знакам.

В ответе метода возвращается информация только по опубликованным карточкам товаров: «goodStatus» («Статус карточки товара из НК») = «published» («Опубликованная карточка товара»).

Вывод сведений о документах осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания в формате * .json»).

URL: dispenser/tasks

Тип приватности: публичный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
   "name":"string",
   "taskTypeShortName":"REPORT",
   "format":"CSV",
   "periodicity":"SINGLE",
   "reportId":"brand-2-inn",
   "productGroupCode": 19,
   "params":"{\"0818_IC_Participant_brand_owner\":[\"4222222222\",\"4333333333\",\"4355555555\"],\"0819_IC_Participant_in_circulation\":[\"1111111111\",\"1100000000\",\"1555555555\"],\"1137_IC_Product_brand2inn\":[\"artic\",\"architect architect\",\"bfgoodrich\",\"baby go\",\"beauty bomb\",\"горошинка\",\"рик\",\"рус\",\"тройка\",\"тошка\",\"шуз\",\"ява\"]}"
}

Параметры тела запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Задание на выгрузку отображается в ЛК ГИС МТ под указанным названием

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» — «Отчёт»

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«brand-2-inn» — «Сведения по товарам и их владельцам, которые используют зарегистрированные товарные знаки»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания в формате * .json

*1137_IC_Product_brand2inn

array of strings

Товарные знаки

Указываются значения, которые применяются в фильтре отчёта в ЛК ГИС МТ

*0818_IC_Participant_brand_owner

array of strings

Владелец кода товара

Указывается ИНН владельца товара

*0819_IC_Participant_in_circulation

array of strings

ИНН участника оборота товаров, осуществившего ввод в оборот

8.3.14. Получение сведений о количестве и объёме введённых в оборот товаров

Данный метод позволяет участнику оборота товаров получить сведения о количестве и объёме товаров, введённых в оборот с момента запуска обязательной маркировки. Учитываются только единицы товара.

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "put-in-circulation-beer",
    "productGroupCode": 15,
    "params": "{\"0202_IC_Date_From\": \"2024-04-27\", \"0203_IC_Date_To\": \"2024-04-27\"}"
}

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в ЛК ГИС МТ. Пример: «Количество и объём введённых в оборот товаров 00.00.2024»

taskTypeShortName

string

Краткое название типа выгрузки

Допустимое значение:

«REPORT» («Отчёт»)

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможные значения:

«put-in-circulation-beer» — «Количество и объём введённых в оборот товаров» (для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»);
«milk-put-in-circulation» — «Количество и объём введённых в оборот товаров» (для товарной группы «Молочная продукция»);
«put-in-circulation-water» — «Количество и объём введённых в оборот товаров» (для товарной группы «Упакованная вода»);
«put-in-circulation-lp» — «Количество и объём введённых в оборот товаров» (для товарных групп «Антисептики и дезинфицирующие средства», «Духи и туалетная вода», «Медицинские изделия», «Обувные товары», «Предметы одежды, бельё постельное, столовое, туалетное и кухонное», «Специализированная пищевая продукция и БАД к пище», «Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки», «Шины и покрышки пневматические резиновые новые»)

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0202_IC_Date_From

string

Начало периода

Формат: yyyy-MM-dd

*0203_IC_Date_To

string

Окончание периода

Формат: yyyy-MM-dd

8.3.15. Получение сведений об отклонениях

Выгрузка предназначена для получения следующих сведений об отклонениях:

вид отклонения, результат его проверки, дата и время регистрации отклонения;
код идентификации, по которому зарегистрировано отклонение, и товарная группа, которой он принадлежит;
субъект РФ и адрес места фиксации отклонения;
номер документа и регистрационный номер ККТ;
идентификатор ВСД;
дата и время выполнения операции, в результате которой было выявлено отклонение.

Вывод сведений осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате * .json»). Если по заданным фильтрам не было найдено ни одно ограничение, то выгрузка будет пустой.

URL: dispenser/tasks

Тип приватности: приватный

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "VIOLATIONS",
    "dataStartDate": "2023-01-01",
    "dataEndDate": "2023-01-02",
    "format": "CSV",
    "periodicity": "SINGLE",
    "params": "{\"violationCategory\":[1,2,4,5,6,7,8,9,10],\"violationKind\":[1,2,5,12,13,3,24,25,6,7,10,11,14,15,16,17,18,19,20,21,22,23,26]}",
    "productGroupCode": 2
}

Параметры тела запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Возможное значение:

«VIOLATIONS» («Отклонения»)

dataStartDate

string (date)

Дата начала периода

Дата начала периода, по которому формируется выгрузка (включительно). Формат: yyyy-MM-dd.

Максимально допустимое значение периода между датами «dataStartDate» («Дата начала периода») и «dataEndDate» («Дата окончания периода») составляет 91 день (включительно), минимальное — 1 день

dataEndDate

string (date)

Дата окончания периода

Дата окончания периода, по которому формируется выгрузка (включительно). Формат: yyyy-MM-dd.

format

string

Формат файла

Возможное значение: «CSV»

params

string

Строка параметров задания на выгрузку в формате * .json

*gtin

string

Код товара

Длина значения: 14 цифр

*violationCategory

array of integer

Категория отклонений

Возможные значения:

«1» — «Нарушения установленных цен»;
«4» — «Документы соответствия ТР ТС»;
«5» — «Товары с незарегистрированными кодами»;
«6» — «Контроль ВСД»;
«7» — «Ненадлежащий статус участника»;
«8» — «Оборот с несоответствующим статусом»;
«9» — «Реализация товаров, не подлежащих реализации»;
«10» — «Оборот товаров с некорректным сроком годности»;
«11» — «Повторные продажи»;
«12» — «Разрешительный режим»;
«13» — «Оборот товаров с истёкшим сроком годности в объёмных показателях»;
«14» — «Оборот товаров, заблокированных по решению ОГВ»

*violationKind

array of integer

Вид отклонений

Возможные значения:

«1» — «Превышение МРЦ»;
«2» — «Ниже МРЦ более 25%»;
«5» — «Цена отличается от МРЦ и ниже ЕМЦ»;
«12» — «Цена отличается от МРЦ, но не ниже ЕМЦ»;
«13» — «Реализация по МРЦ, которая ниже ЕМЦ»;
«24» — «Повторные продажи у одного продавца»;
«25» — «Повторные продажи у разных продавцов»;
«7» — «Оборот товаров с некорректными документами соответствия ТР ТС»;
«10» — «Товары с незарегистрированными кодами»;
«11» — «Превышение объема ввода в оборот относительно ВСД»;
«14» — «Оборот незарегистрированным участником»;
«15» — «Оборот участником, прекратившим деятельность»;
«16» — «Отсутствуют сведения о вводе в оборот РФ»;
«17» — «Отсутствуют сведения о разрешении выпуска от ФТС»;
«18» — «Отрицательное решение о выпуске от ФТС»;
«19» — «Отсутствуют сведения о ввозе в РФ из ЕАЭС»;
«20» — «Ранее выбыл по другим причинам»;
«21» — «Не завершена перемаркировка»;
«22» — «Не завершена передача товаров»;
«23» — «Продажа товаров, не подлежащих возврату»;
«26» — «Реализация товаров с истекшим сроком годности»

*violationResult

array of integer

Результат выявления отклонения

Возможные значения:
«1» — «Цена реализации превышает МРЦ»;
«2» — «Цены реализации более чем на 25% меньше МРЦ»;
«5» — «Цена реализации отличается от МРЦ и ниже ЕМЦ»;
«6» — «Ввод в оборот товара с недостаточным описанием»;
«7» — «Оборот товара с недостаточным описанием»;
«8» — «Вывод из оборота товара с недостаточным описанием»;
«9» — «Возврат в оборот товара с недостаточным описанием»;
«10» — «Отсутствует документ, подтверждающий соответствие ТР ТС / ЕАЭС»;
«11» — «Документ соответствия ТР ТС / ЕАЭС не зарегистрирован в ФГИС Росаккредитации»;
«12» — «Документ соответствия ТР ТС / ЕАЭС содержит некорректные сведения»;
«13» — «Продажа товара с КИ, незарегистрированными в ГИС»;
«14» — «Объем введенного в оборот товара более чем на 5%, относительно объема, указанного в ВСД»;
«15» — «Мера выпуска ВСД отличается от фактической меры выпуска»;
«16» — «Цена реализации отличается от МРЦ, но не ниже ЕМЦ»;
«17» — «Реализация по МРЦ, которая ниже ЕМЦ»;
«18» — «Передача сведений о розничной реализации маркированных товаров от участника оборота товаров (УОТ) незарегистрированного в ГИС МТ»;
«19» — «Передача сведений о розничной реализации маркированных товаров от участника оборота товаров (УОТ) незарегистрированного в товарной группе (ТГ), к которой относится оборачиваемый товар»;
«20» — «Оборот маркированных товаров участником в статусе «Исключен»»;

«21» — «Оборот маркированных товаров участником в статусе «Заблокирован»»;
«22» — «Отсутствуют сведения о вводе в оборот товаров, произведенных в РФ»;
«23» — «Товар находится на контроле ФТС или ожидает подтверждения ФТС»;
«24» — «Нет запросов в ФТС о проверке товара»;
«25» — «Отрицательное решение о выпуске от ФТС»;
«26» — «Отсутствуют сведения о ввозе из ЕАЭС с признанием КМ ЕАЭС»;
«27» — «Отсутствуют сведения о ввозе из ЕАЭС без признанием КМ ЕАЭС»;
«28» — «Ранее выбыл по причинам, отличным от розничной продажи»;
«29» — «Продажа кода групповой упаковки после выбытия»;
«30» — «Товар в обороте, ожидает перемаркировку»;
«31» — «Код со способом ввода в оборот «Перемаркировка» в статусах «Эмитирован, выпущен», «Эмитирован, нанесен (получен)»», где статус КИ «Эмитирован, выпущен» = EMITTED («Эмитирован»), статус КИ «Эмитирован, нанесен (получен)» = APPLIED («Нанесен»);
«32» — «Ожидается передача собственнику»;
«33» — «Ожидается подтверждение приемки»;
«34» — «Повторная реализация товаров, не подлежащих возврату»;
«35» — «Повторные продажи у одного продавца менее 30 минут»;
«36» — «Повторные продажи у одного продавца более или равно 30 минут»;
«37» — «Повторные продажи у разных продавцов»;
«38» — «Реализован товар с истекшим сроком годности»;
«39» — «В обороте товар со сроком годности меньше указанного в ВСД»;
«40» — «В обороте товар со сроком годности больше указанного в ВСД»;
«48» — «Продажа товара без проверки КМ»

*operationType

array of integer

Тип операции, на основании которой было выявлено отклонение

Возможные значения:

«0» — «Эмиссия» (EMISSION);
«1» — «Нанесение» (APPLIED);
«2» — «Смена владельца» (OWNER_CHANGING);
«3» — «Агрегация» (AGGREGATION);
«4» — «Расформирование» (DISAGGREGATION);
«5» — «Расформирование» (AUTODISAGGREGATION);
«6» — «Вывод из оборота» (WITHDRAW);
«8» — «Возврат в оборот по чеку» (RETURN_TO_TURNOVER) — только для табачных товарных групп;
«9» — «Аннулирование КИ» (CANCELLATION);
«10» — «Исправление» (DOCUMENT_FIX);
«11» — «Корректировка» (DOCUMENT_CORRECTION);
«12» — «Ввод в оборот» (TRADE_STARTING);
«13» — «Отгрузка. Продажа» (SHIPMENT);
«14» — «Отказ в приемке» (NOT_ACCEPTED);
«15» — «Перемаркировка» (REMARK);
«17» — «Заказ КМ» (ORDERED);
«19» — «Оплата» (PAYMENT);
«21» — «Аннулирование КИ» (KM_CANCELLATION);
«22» — «Ввод в оборот от ФЛ» (TRADE_STARTING_INDI);
«24» — «Подключён к оборудованию для розлива» (CONNECT_TAP) — только для товарной группы «Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки»;
«31» — «Обработан отчет о приемке КиЗ» (ACCEPTED) — только для товарной группы «Товары из натурального меха»;
«32» — «Обработан документ индивидуализации КиЗ» (ACCEPTED_INDIVIDUAL) — только для товарной группы «Товары из натурального меха»;

«33» — «Откат изменений по КМ из-за ошибки обработки документа» (ROLLBACK_PARTIALLY_PROCESSED);
«34» — «Ввод в оборот при трансграничной торговле» (EAS_REQUEST_3_WAITING) — только для товарной группы «Товары из натурального меха»;
«35» — «Отправлен запрос в ЕАЭС» (EAS_REQUEST_3) — только для товарной группы «Товары из натурального меха»;
«36» — «Получен положительный ответ от ЕАЭС» (EAS_RESPOND_OK) — только для товарной группы «Товары из натурального меха»;
«37» — «Получен отрицательный ответ от ЕАЭС» (EAS_RESPOND_NOT_OK) — только для товарной группы «Товары из натурального меха»;
«40» — «Отправлен запрос 3 в ФТС без индивидуализации КиЗ» (FTS_REQUEST_3_WITHOUT_INDIVIDUAL) — только для товарной группы «Товары из натурального меха»;
«43» — «Получен положительный ответ 3 от ФТС без индивидуализации КиЗ» (FTS_RESPOND_OK_WITHOUT_INDIVIDUAL) — только для товарной группы «Товары из натурального меха»;
«44» — «Получен отрицательный ответ 3 от ФТС без индивидуализации КиЗ» (FTS_RESPOND_NOT_OK_WITHOUT_INDIVIDUAL) — только для товарной группы «Товары из натурального меха»;
«100» — «Ошибка ответа ЕАЭС» (EAS_RESPOND_ERROR) — только для товарной группы «Товары из натурального меха»;
«103» — «Списание не нанесенных КМ» (CANCELLATION_NOT_APPLIED);

«104» — «Списание нанесенных КМ» (CANCELLATION_APPLIED);
«105» — «Трансформация транспортной упаковки» (TRANSFORMATION);
«106» — «Возврат в оборот» (RETURN);
«107» — «Приемка продукции на агента/комиссионера» (AGENT_CHANGING);
«108» — «Отгрузка при трансграничной торговле» (CROSSBORDER);
«111» — «Получен запрос 1 от ФТС» (FTS_REQUEST_1);
«112» — «Отправлен запрос 3 в ФТС» (FTS_REQUEST_3);
«113» — «Получен положительный ответ от ФТС на запрос 3» (FTS_RESPOND_OK);
«114» — «Получен отрицательный ответ от ФТС на запрос 3» (FTS_RESPOND_NOT_OK);
«115» — «Ввод в оборот при трансграничной торговле через ЦСД» (CROSSBORDER_CSD);
«116» — «Обработка отчета о закрытии периода для серой зоны» (GRAY_ZONE_FORMED);
«117» — «Отмена документа «Отгрузка»» (SHIPMENT_CANCELLATION);
«118» — «Событие реализации в розницу от невладельца кода» (SALE_ATTEMPT);
«119» — «Получена ошибка от ФТС на запрос 3» (FTS_RESPOND_ERROR);
«120» — «Отмена операции по документу» (DOC_CANCELLATION);
«121» — «Запрос статуса ВСД отправлен в ФГИС «ВетИС»» (VSD_STATUS_REQUEST);
«122» — «Проверка статуса ВСД в ФГИС «ВетИС» пройдена с ошибкой» (VSD_RESPONSE_NOT_OK);
«123» — «Проверка статуса ВСД в ФГИС «ВетИС» успешно пройдена» (VSD_RESPONSE_OK);
«127» — «Внесение дополнительных сведений КИ» (CIRCULATION_INFORMATION)

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» («Однократная»)

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

8.3.16. Получение сведений по виртуальному складу, включая партионный учёт

Вывод сведений по виртуальному складу осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате *.json»).

Тип приватности: приватный

URL: dispenser/tasks

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "virtual-warehouse-water",
    "productGroupCode": 19,
    "params": "{\"0157_IC_Agg_112_virtual_warehouse\": \"agg_detail\", \"0202_IC_Date_From\": \"2024-06-25\", \"0203_IC_Date_To\": \"2024-06-25\", \"1137_IC_Product_card_holder_type\": [\"Показывать кроме собственных\"], \"IC_search_string_gtin\":\"\", \"products\": [\"00000011011110\"]}"
}

Параметры тела запроса:

Параметр Тип Обяз. Описание Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в личном кабинете Системы маркировки. Пример: «Отчёт по виртуальному складу 01.01.2024»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможные значения:

«virtual-warehouse-lp» — «Отчёт по виртуальному складу» (для товарных групп «Антисептики и дезинфицирующие средства», «Специализированная пищевая продукция и БАД к пище»);
«virtual-warehouse-milk» — «Отчёт по виртуальному складу» (для товарных групп «Молочная продукция» и «Растительные масла»);
«virtual-warehouse-water» — «Отчёт по виртуальному складу» (для товарной группы «Упакованная вода»);
«virtual-warehouse-softdrinks» — «Отчёт по виртуальному складу» (для товарной группы «Соковая продукция и безалкогольные напитки»);
«virtual-warehouse-seafood» — «Отчёт по виртуальному складу» (для товарных групп «Морепродукты», «Корма для животных»);
«virtual-warehouse-part-milk» — «Отчёт по виртуальному складу. Партионный учёт» (для товарной группы «Молочная продукция»)

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0157_IC_Agg_112_virtual_warehouse

string

Вид отчёта

Возможные значения:

«agg_total» — «Без детализации»;
«agg_detail» — «С детализацией»

*0202_IC_Date_From

string

Начало периода

Формат: yyyy-MM-dd

*0203_IC_Date_To

string

Окончание периода

Формат: yyyy-MM-dd

*1137_IC_Product_card_holder_type

array of strings

Признак владельца карточки

Возможные значения:

«Показывать только собственные»;
«Показывать кроме собственных»

*1300_IC_Product_PartNumber

string

Номер партии

Может быть заполнен, если «reportId» = «virtual-warehouse-part-milk»

*IC_search_string_gtin

string

Код товара (GTIN)

Коды товаров следует указывать через запятую, без пробелов. Для получения информации по всем кодам товаров необходимо указать параметр с пустым значением ("IC_search_string_gtin":"")

*products

array of strings

GTIN или наименование

Указывается код товара или наименование товара

8.3.17. Получение сведений по акцизам

Вывод сведений по акцизам осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате *.json»).

Тип приватности: приватный

URL: dispenser/tasks

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "taxes",
    "productGroupCode": 12,
    "params": "{\"0134_IC_Agg_048_taxes\": \"agg_total_1115\",\"1004_IC_Period_Month_01-2018\": \"24292\", \"1102_IC_Product_ALL_name_gtin\": [\"string\"], \"1115_IC_Product_group_single\": \"12\"}"
}

Параметры тела запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в личном кабинете Системы маркировки. Пример: «Отчёт по акцизам 01.01.2024»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«taxes» — «Отчёт по акцизам»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0134_IC_Agg_048_taxes

string

Вид отчёта

Возможные значения:

«agg_total_1115» — «Сводный отчёт»;
«agg_excise_1115» — «Суммы акциза по товарам РФ»;
«agg_import_1115» — «Сумма акциза по импортным товарам»;
«agg_document_1115» — «Отчёт по документам РФ»;
«agg_document_total_1115» — «Сводный отчёт по документам РФ»;
«agg_document_import_1115» — «Отчёт по документам импорта»;
«agg_document_import_total_1115» — «Сводный отчёт по документам импорта»;
«agg_deduction_1115» — «Суммы акциза, возможные к налоговому вычету»

*1004_IC_Period_Month_01-2018

string

Месяц

Указать период выгрузки в виде порядкового номера месяца.

Формула для расчёта: требуемый_год * 12 + номер_месяца_в_году_выгрузки.

Например, для задания периода выгрузки «Декабрь 2021» (12-й месяц 2021 года) указать значение «24264»:
2021 * 12 + 12 = 24264

*1102_IC_Product_ALL_name_gtin

array of strings

Наименование товара или GTIN

Указывается код товара или наименование товара

*1115_IC_Product_group_single

string

Товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «АТП» («Альтернативная табачная продукция»);
«16» — «НСП» («Никотиносодержащая продукция»)

8.3.18. Получение сведений по рассчитанному акцизу

Вывод сведений по рассчитанному акцизу осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате *.json»).

Тип приватности: приватный

URL: dispenser/tasks

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "check-doc-excise",
    "productGroupCode": 16,
    "params": "{\"0202_IC_Date_From\": \"2024-12-12\", \"0203_IC_Date_To\": \"2024-12-12\"}"
}

Параметры тела запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в личном кабинете Системы маркировки. Пример: «Сверочный отчёт по рассчитанному акцизу 01.01.2024»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«check-doc-excise» — «Сверочный отчёт по рассчитанному акцизу»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0202_IC_Date_From

string

Начало периода

Формат: yyyy-MM-dd

*0203_IC_Date_To

string

Окончание периода

Формат: yyyy-MM-dd

8.3.19. Получение сведений по эмиссии и нанесению кодов маркировки

Вывод сведений по эмиссии и нанесению кодов маркировки осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате *.json»).

Тип приватности: приватный

URL: dispenser/tasks

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "emitted-applied-cis-gismt",
    "productGroupCode": 19,
    "params": "{\"0103_IC_Agg_051_pay_for_cis\": \"Agg_Total___1003\", \"1003_IC_Period_Type_051_pay_for_cis\": \"IC_Period_Month\", \"1021_IC_Period_Month_06_2021\": \"24300\", \"1105_IC_Product_Pack_type_gismt\": [\"Транспортная упаковка\"], \"products\": [\"00000000000000\"]}"
}

Параметры тела запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в личном кабинете Системы маркировки. Пример: «Отчёт по эмиссии и нанесению кодов маркировки 13.05.2025»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«emitted-applied-cis-gismt» — «Отчёт по эмиссии и нанесению кодов маркировки»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0103_IC_Agg_051_pay_for_cis

string

Тип агрегации

Возможные значения:

«Agg_Total___1003» — «Сводный отчёт»;
«Agg_Detail_by_item___1003» — «Детализация по товару»;
«Agg_Detail_by_date___1003» — «Детализация по товару и дате»

*1003_IC_Period_Type_051_pay_for_cis

string

Вариант задания периода

Возможные значения:

«IC_Period_Day» — «День»;
«IC_Period_Month» — «Месяц»;
«IC_Period_Year» — «Год»

*1013_IC_Period_Day

string

День

Обязательный, если «1003_IC_Period_Type_051_pay_for_cis» = «IC_Period_Day». В остальных случаях не заполняется.

Формат: yyyy-MM-dd

*1021_IC_Period_Month_06_2021

string

Месяц

Обязательный, если «1003_IC_Period_Type_051_pay_for_cis» = «IC_Period_Month». В остальных случаях не заполняется.

Указать период выгрузки в виде порядкового номера месяца.

Формула для расчёта: требуемый_год * 12 + номер_месяца_в_году_выгрузки.

Например, для задания периода выгрузки «Декабрь 2021» (12-й месяц 2021 года) указать значение «24264»:
2021 * 12 + 12 = 24264

*1022_IC_Period_Year_2021

string

Год

Обязательный, если «1003_IC_Period_Type_051_pay_for_cis» = «IC_Period_Year». В остальных случаях не заполняется

*1105_IC_Product_Pack_type_gismt

array of strings

Уровень упаковки

Возможные значения:

«Потребительская упаковка»;
«Комплект»;
«Групповая упаковка»;
«Набор»;
«Транспортная упаковка»;
«АТК»

*1113_IC_Product_group_tobacco

array of strings

Товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «Альтернативная табачная продукция»;
«16» — «Никотиносодержащая продукция»

*products

array of strings

GTIN или наименование товара

Указывается код товара или наименование товара

8.3.20. Получение сведений по начислениям за коды маркировки

Вывод сведений по начислениям за коды маркировки осуществляется с учётом установленных фильтров в параметре «params» («Строка параметров задания на выгрузку в формате *.json»).

Тип приватности: приватный

URL: dispenser/tasks

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "paid-cis-gismt",
    "productGroupCode": 19,
    "params": "{\"0181_IC_Agg_134_gismt_paid_cis\": \"Agg_Total___1035\", \"1035_IC_Period_Type_134_gismt_paid_cis\": \"IC_Period_Month\",  \"1021_IC_Period_Month_06_2021\": \"24300\"}"
}

Параметры тела запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Рекомендуется указывать соответствующее наименование задания на выгрузку с датой выгрузки, которое отображается в личном кабинете Системы маркировки. Пример: «Отчёт по начислениям за коды маркировки 13.05.2025»

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«paid-cis-gismt» — «Отчёт по начислениям за коды маркировки»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0181_IC_Agg_134_gismt_paid_cis

string

Тип агрегации

Возможные значения:

«Agg_Total___1035» — «Сводный отчёт»;
«Agg_Detail_by_item___1035» — «Детализация по товару»;
«Agg_Detail_by_date___1035» — «Детализация по товару и дате»

*1035_IC_Period_Type_134_gismt_paid_cis

string

Вариант задания периода

Возможные значения:

«IC_Period_Day» — «День»;
«IC_Period_Week» — «Неделя»;
«IC_Period_Month» — «Месяц»;
«IC_Period_Year» — «Год»

*1013_IC_Period_Day

string

День

Обязательный, если «1035_IC_Period_Type_134_gismt_paid_cis» = «IC_Period_Day». В остальных случаях не заполняется.

Формат: yyyy-MM-dd

*1023_IC_Period_Week_Single

string

Неделя

Обязательный, если «1035_IC_Period_Type_134_gismt_paid_cis» = «IC_Period_Week». В остальных случаях не заполняется.

Указать период выгрузки в виде порядкового номера недели при отсчёте с 1 января 1970 года.

Формула для расчёта:
(год_выгрузки - 1970) * 52,1786 + номер_недели_в_году_выгрузки.

*1021_IC_Period_Month_06_2021

string

Месяц

Обязательный, если «1035_IC_Period_Type_134_gismt_paid_cis» = «IC_Period_Month». В остальных случаях не заполняется.

Указать период выгрузки в виде порядкового номера месяца.

Формула для расчёта: требуемый_год * 12 + номер_месяца_в_году_выгрузки.

Например, для задания периода выгрузки «Декабрь 2021» (12-й месяц 2021 года) указать значение «24264»:
2021 * 12 + 12 = 24264

*1022_IC_Period_Year_2021

string

Год

Обязательный, если «1035_IC_Period_Type_134_gismt_paid_cis» = «IC_Period_Year». В остальных случаях не заполняется

*1113_IC_Product_group_tobacco

array of strings

Товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «Альтернативная табачная продукция»;
«16» — «Никотиносодержащая продукция»

*products

array of strings

GTIN или наименование товара

Указывается код товара или наименование товара

8.3.21. Продажи по аномальным ценам

Тип приватности: приватный

URL: dispenser/tasks

Метод: POST

Пример строки запроса:

curl -X POST '<url стенда>/dispenser/tasks"
-H 'Authorization: Bearer <ТОКЕН>'
-H "Content-Type: application/json" -d

Пример тела запроса:

{
    "name": "string",
    "taskTypeShortName": "REPORT",
    "format": "CSV",
    "periodicity": "SINGLE",
    "reportId": "abnormal-prices-gismt",
    "productGroupCode": 19,
    "params": "{\"0202_IC_Date_From\": \"2025-10-13\", \"0203_IC_Date_To\": \"2025-10-13\", \"1113_IC_Product_group_tobacco\": [\"11\"], \"producers\": [\"0000200100\"]}"
}

Параметры тела запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

name

string

Наименование задания на выгрузку

Задание на выгрузку отображается с указанным названием

taskTypeShortName

string

Краткое название типа выгрузки

Возможное значение:

«REPORT» («Отчёт»)

format

string

Формат файла

Возможное значение:

«CSV»

periodicity

string

Вид периодичности выгрузки

Возможное значение:

«SINGLE» — «Однократная»

reportId

string

Идентификатор типа выгрузки

Возможное значение:

«abnormal-prices-gismt» — «Продажи по аномальным ценам»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

params

string

Строка параметров задания на выгрузку в формате * .json

*0202_IC_Date_From

string (date)

Начало периода

Формат: yyyy-MM-dd

*0203_IC_Date_To

string (date)

Окончание периода

Формат: yyyy-MM-dd

*1102_IC_Product_ALL_name_gtin

array of strings

Наименование товара или GTIN

Указывается код товара или наименование товара

*1113_IC_Product_group_tobacco

array of strings

Товарная группа

Возможные значения:

«3» — «Сигареты и папиросы» («Табачная продукция»);
«12» — «АТП» («Альтернативная табачная продукция»);
«16» — «НСП» («Никотиносодержащая продукция»)

8.4. Пример ответа для всех формируемых запросов на выгрузку

В ответе метода «Метод создания нового задания на выгрузку» возвращается идентификатор задания на выгрузку, необходимый для дальнейшей работы с методами сервиса выгрузок.

Пример ответа:

{
   "id":"string",
   "name":"string",
   "createDate":"2020-06-19T14:44:27.968",
   "currentStatus":"PREPARATION",
   "orgInn":"string",
   "periodicity":"SINGLE",
   "timeoutSecs":0
}

Параметры ответа:

Параметр

Тип

Обяз.

Описание

Комментарий

createDate

string (date-time)

Дата создания

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS

string

Идентификатор задания на выгрузку

Необходим для работы с другими методами сервиса выгрузок

name

string

Наименование задания

currentStatus

string

Текущий статус задания на выгрузку

Возможные значения:

«PREPARATION» — «Подготовка»;
«COMPLETED» — «Выполнено»;
«CANCELED» — «Отменено»;
«ARCHIVE» — «Архив»;
«FAILED» — «Ошибка»

dataStartDate

string (date)

Дата начала периода выгрузки

Возвращается только для заданий c «periodicity» («Вид периодичности выгрузки») = «SINGLE» («Однократная»). Возвращается в формате yyyy-mm-dd.

Не возвращается для заданий с типом «taskTypeShortName» («Краткое название типа выгрузки») = «REPORT» («Отчёт»)

dataEndDate

string (date)

Дата окончания периода выгрузки

Не возвращается для заданий с типом «taskTypeShortName» («Краткое название типа выгрузки») = «REPORT» («Отчёт»)

orgInn

string

ИНН организации

period

string

Периодичность регулярной выгрузки

Возвращается только для заданий c «periodicity» («Вид периодичности выгрузки») = «REGULAR» («Регулярная»).

Возможные значения:

«HALF_MIN» — «Полминуты»;
«TEN_MINUTES» — «10 минут»;
«DAY» — «День»;
«WEEK» — «Неделя»;
«MONTH» — «Месяц»;
«QUARTER» — «Квартал»;
«YEAR» — «Год»

periodicity

string

Вид периодичности выгрузки

Возможные значения:

«SINGLE» — «Однократная»;
«REGULAR» — «Регулярная»

productGroupCode

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

timeoutSecs

integer

Таймаут (в секундах)

Временной интервал, при истечении которого выгрузка по данному заданию считается выполненной

8.5. Метод получения статуса задания на выгрузку

Метод предназначен для получения статуса задания на выгрузку по идентификатору задания, полученному в ответе метода «Метод создания нового задания на выгрузку».

URL: dispenser/tasks/{taskId}

Тип приватности: публичный

Метод: GET

Пример запроса:

curl -X GET "<url стенда>/dispenser/tasks/11aaa1a1-11a1-1111-a1a1-aa11a11a11a1?pg=2"
-H "Authorization: Bearer <ТОКЕН>"

Параметры запроса:

Параметр

Тип

Обяз.

Описание

taskId

string

Идентификатор задания на выгрузку.

Идентификатор возвращается в ответе метода «Метод создания нового задания на выгрузку»

string

Товарная группа.

Кодовое значение товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»). Значение должно соответствовать значению параметра «productGroupCode» («Товарная группа») задания на выгрузку, идентификатор которой указан в параметре «taskId» («Идентификатор задания на выгрузку»). Если при формировании задания на выгрузку параметр «productGroupCode» («Товарная группа») не передавался, то в данном запросе параметр указывать не требуется

Пример ответа:

{
  "id": "string",
  "name": "string",
  "createDate": "string",
  "currentStatus": "string",
  "orgInn": "string",
  "productGroupCode": 0,
  "downloadingStorageDays": 0,
  "productGroups": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "timeoutSecs": 0
}

Параметры ответа:

Параметр

Тип

Обяз.

Описание

string

Идентификатор задания на выгрузку

name

string

Наименование выгрузки

createDate

string (date-time)

Дата создания задания на выгрузку.

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS

currentStatus

string

Текущий статус задания на выгрузку.

Возможные значения:

«PREPARATION» — «Подготовка»;
«COMPLETED» — «Выполнено»;
«CANCELED» — «Отменено»;
«ARCHIVE» — «Архив»;
«FAILED» — «Ошибка»

orgInn

string

ИНН организации.

Возвращается ИНН организации, отправившей запрос на создание задачи на выгрузку

productGroupCode

integer

Товарная группа.

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»)

downloadingStorageDays

integer

Время хранения выгрузки в днях

productGroups

object

Доступные товарные группы для текущего типа задач

*id

integer

Идентификатор текущей задачи

*name

string

Наименование товарной группы

timeoutSecs

integer

Таймаут (в секундах).

Временной интервал, при истечении которого выгрузка по данному заданию считается выполненной

8.5.1. Метод получения статусов заданий на выгрузку

URL: dispenser/tasks

Тип приватности: приватный

Метод: GET

Пример запроса:

curl -X GET "<url стенда>/dispenser/tasks?page=0&size=4&pg=2"
-H "accept: application/json"

Параметры запроса:

Параметр

Тип

Обяз.

Описание

page

string

Номер страницы (отсчёт с 0)

size

string

Количество записей на странице

integer

Товарная группа.

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»). Указанное значение должно совпадать с «productGroupCode» («Товарная группа»), сформированных ранее заданий на выгрузку. Если при формировании задания на выгрузку параметр «productGroupCode» («Товарная группа») не передавался, то в данном запросе параметр указывать не требуется

Пример ответа:

{
  "list":[
      {
         "id":"string",
         "name":"string",
         "createDate":"string",
         "currentStatus":"string",
         "dataStartDate":"string",
         "dataEndDate":"string",
         "orgInn":"string",
         "period":"string",
         "periodicity":"string",
         "productGroups":[
            {
               "id":"string",
               "name":"string"
            }
         ],
         "timeoutSecs":0
      }
   ]
}

Параметры ответа:

Параметр

Тип

Обяз.

Описание

Комментарий

list

object

Результат запроса

*id

string

Идентификатор задания на выгрузку

*name

string

Наименование выгрузки

*createDate

string

Дата создания

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS

*currentStatus

string

Текущий статус задания на выгрузку

Возможные значения:

«PREPARATION» — «Подготовка»;
«COMPLETED» — «Выполнено»;
«CANCELED» — «Отменено»;
«ARCHIVE» — «Архив»;
«FAILED» — «Ошибка»

*dataStartDate

string

Дата начала периода выгрузки

Возвращается в формате yyyy-MM-dd

*dataEndDate

string

Дата окончания периода выгрузки

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*orgInn

string

ИНН организации

Возвращается ИНН организации, отправившей запрос на создание задачи на выгрузку

*period

string

Периодичность регулярной выгрузки

Возвращается только для заданий c «periodicity» («Вид периодичности выгрузки») = «REGULAR» («Регулярная»).

Возможные значения:

*periodicity

string

Вид периодичности выгрузки

Возможные значения:

«SINGLE» — «Однократная»;
«REGULAR» — «Регулярная»

*productGroups

object

Товарные группы

Доступные товарные группы для текущего типа задач

*timeoutSecs

integer

Таймаут (в секундах)

Временной интервал, при истечении которого выгрузка по данному заданию считается выполненной

8.6. Метод получения результирующих ID выгрузок данных

Данный метод позволяет получить список результирующих идентификаторов выгрузок для скачивания сформированных файлов с данными.

URL: dispenser/results

Тип приватности: публичный

Метод: GET

Пример запроса:

curl -X GET "<url стенда>dispenser/results?page=1&pg=1&size=12"
-H "Authorization: Bearer <ТОКЕН>"

Параметры запроса:

Параметр

Тип

Обяз.

Описание

page

string

Номер страницы (отсчёт с «0»)

size

string

Количество записей на странице

integer

Товарная группа.

task_ids

array of strings

Список идентификаторов заданий на выгрузку

Пример ответа:

{
  "list": [
    {
      "id": "string",
      "archiveSize": 0,
      "available": "string",
      "dataStartDate": "string",
      "dataEndDate": "string",
      "downloadStatus": "string",
      "downloadingTime": 0,
      "downloadFormat": "XLSX",
      "errorMessage": "string",
      "fullErrorMessage": "string",
      "fileDeleteDate": "string",
      "generationStartDate": "string",
      "generationEndDate": "string",
      "notEditable": true,
      "taskId": "00000000-0000-0000-0000-000000000000",
      "fileFormat": "CSV"
    }
  ]
}

Параметры ответа:

Параметр

Тип

Обяз.

Описание

Комментарий

list

array of objects

Результат запроса

*id

string

Идентификатор выгрузки

Данный идентификатор необходим для скачивания файла выгрузки

*archiveSize

integer

Размер архива выгрузки в байтах

*available

string

Доступность загрузки файла

Возможные значения:

AVAILABLE — доступен;
NOT_AVAILABLE — недоступен

*dataStartDate

string (date-time)

Дата-время начала периода, по которому сформирована выгрузка

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*dataEndDate

string (date-time)

Дата-время окончания периода, по которому сформирована выгрузка

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*downloadStatus

string

Статус

Возможные значения:
SUCCESS – успешно;
PREPARATION – в обработке;
FAILED – неуспешно

*downloadingTime

integer

Длительность выполнения выгрузки в секундах

*downloadFormat

enum

Формат файла выгрузки

*errorMessage

string

Сообщение об ошибке

Параметр возвращается при наличии ошибки

*fullErrorMessage

string

Информация об ошибке

*fileDeleteDate

string (date-time)

Дата-время запланированного удаления файла выгрузки с сервера

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*generationStartDate

string (date-time)

Дата и время начала генерации выгрузки

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*generationEndDate

string (date-time)

Дата и время окончания генерации выгрузки

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

*notEditable

boolean

Признак, указывающий на возможность удаления или продления выгрузки

*taskId

string

Идентификатор задания на выгрузку

*fileFormat

enum

Формат файла выгрузки

*resultFilePartsSize

integer

Число частей файла выгрузки

Если выгрузка не мультифайловая, то возвращается «0»

*resultFileParts

array of objects

Информация о частях файла выгрузки

**id

string

Идентификатор дополнительного файла выгрузки

**filePath

string

Путь к дополнительному файлу выгрузки

Возвращается для выгрузок с идентификатором «ppr-1955-3-tobacco» — «Объём розничных продаж в разрезе по ИНН и адресам» (для товарных групп «Альтернативная табачная продукция», «Никотиносодержащая продукция», «Табачная продукция»), созданных с 12.12.2023.
Параметр может не заполняться, если файл удалён

**archivePartSize

integer

Размер архива с дополнительным файлом выгрузки

**fileNumber

integer

Номер дополнительного файла выгрузки

8.7. Метод получения ZIP-файла выгрузки

Метод предоставляет возможность скачивания выгрузки в статусе «COMPLETED» («Выполнено») по идентификатору выгрузки, полученному в ответе метода «Метод получения результирующих ID выгрузок данных».

URL: dispenser/results/{resultId}/file

Тип приватности: публичный

Метод: GET

Пример запроса:

curl -X GET "<url стенда>dispenser/results/00000000-0000-0000-0000-000000000000/file?pg=3"
-H "accept: */*"
-H "Authorization: Bearer <ТОКЕН>"

Параметры запроса:

Параметр

Тип

Обяз.

Описание

Комментарий

result_id

string

Идентификатор выгрузки

Идентификатор возвращается в ответе метода «Метод получения результирующих ID выгрузок данных»

integer

Товарная группа

Цифровой код товарной группы (см. «Справочник «Список поддерживаемых товарных групп»»). Значение должно совпадать с «productGroupCode» («Товарная группа») задания на выгрузку. Если при формировании задания на выгрузку параметр «productGroupCode» («Товарная группа») не передавался, то в данном запросе параметр указывать не требуется

downloadFormat

string

Формат выгрузки файла

Применимо только для выгрузок:

«ACS_DOCUMENTS» («Документы, на основании которых была оформлена передача и получение кодов идентификации по агентско-комиссионной схеме»);
«CIS_ACS» («Данные о кодах идентификации, переданных и полученных по агентско-комиссионной схеме»).

Если не указан, выгрузка формируется в формате * .csv.

Допустимое значение: «XLSX»

resultFilePartId

string

Идентификатор дополнительного файла выгрузки

Параметр заполняется для выгрузки, состоящей из нескольких файлов

8.7.1. Метод получения CSV ошибок по результатам обработки документов

В ответ возвращается ZIP-файл с выгрузкой из запроса в формате * .csv. Для агрегатов выводится список вложенных КИ первого слоя. Сформированный архив будет доступен для скачивания в течение 30 дней.

Пример структуры выгрузки ошибок:

<id УД в ГИС>
№ <Порядковый номер УД> от <Дата УД>
Отправитель <Наименование Отправителя УД>, <ИНН Отправителя УД>
Получатель <Наименование Получателя УД>, <ИНН Получателя УД>
<Код типа ошибки1>: <описание ошибки1>
"<КИ/КИТУ/КИГУ1 1>"
"<КИ/КИТУ/КИГУ1 2>"

Пример ответа для сформированной выгрузки ошибок по документам ЭДО:

"document_id","status","document_number","document_date","sender_inn","receiver_inn","cis","error_code","error_text"
"7f4c6249-976e-43d5-b25f-afccc9e8cf42","IN_PROGRESS","7f4c6249-976e-43d5-b25f-afccc9e8cf42",,,,,,
"ON_NSCHFDOP_Test_prng-777-300342343243","IN_PROGRESS","7202323234433",,,,,,
"7a2fba8a-4d14-45ad-a10b-9b53c7003cf5","CHECKED_NOT_OK","7a2fba8a-4d14-45ad-a10b-9b53c7003cf5","2020-09-02 15:24:10.947","7724211288",,,,"Не пройдена проверка подписи"
"1efce0ec-09f6-4987-b4b1-f9d056c44e7b","CHECKED_NOT_OK","1efce0ec-09f6-4987-b4b1-f9d056c44e7b","2020-09-11 08:45:46.463","7724211288",,,"INTRO_ERROR","41: Недостаточное описание товара, указанного в документе ""Ввод в оборот"" cI046902297902"
"8032b556-cd82-4e05-876b-da0a5cbfcb34","CHECKED_NOT_OK","8032b556-cd82-4e05-876b-da0a5cbfcb34","2020-09-09 14:44:57.619","7724211288",,,"INTRO_ERROR","07: Недопустимое количество символов в значении поля ""КИ"" ""010463003407001221BM(__Рѕ__)G0E3"" в документе ""Ввод в оборот""."
"09252711-e901-482d-963a-544ad4fe4a29","CHECKED_NOT_OK","09252711-e901-482d-963a-544ad4fe4a29","2020-09-07 20:13:16.729","7724211288",,,"INTRO_ERROR","06: Значение поля ""КИТУ"" ""214623467234823423"" в документе ""Ввод в оборот"" не найдено в базе данных."
"e2a942c6-252e-4114-8d89-49b04f4f5ddb","PARSE_ERROR","e2a942c6-252e-4114-8d89-49b04f4f5ddb","2020-07-20 13:11:18.056","7724211288",,"20.07.2020 04:11",,"REM_ERR","28: Передаваемый файл XML не соответствует XSD-схеме."

Подробное описание кодов ошибок см. в "Описание ошибок, возникающих при обработке документов прямой подачи сведений в Государственной информационной системе мониторинга за оборотом товаров".

8.7.2. Метод получения CSV по списку КИ участника оборота товаров по заданному фильтру

В ответе формируется ZIP-файл с выгрузкой из запроса в формате * .csv со сведениями о КИ, которые находятся на балансе у участника оборота товаров. Вывод сведений о КИ осуществляется с учётом установленных фильтров. Сформированный архив будет доступен для скачивания в течение 30 дней.

Пример содержимого выгрузки:

"Filter(participantInn=7711111112, productGroup=WATER, packageType=[UNIT, LEVEL3, LEVEL4, LEVEL1], status=null, statusExt=[], includeGtin=[], excludeGtin=[], appliedPeriod=null, emissionPeriod=null, emissionTypes=[], productionPeriod=null, vsd=null, turnoverTypes=[], producerInns=[], eliminationReasons=[], orderIds=[], declarationRegistrationNumbers=[], permitDocIndx=[200513])"
"requestedCis","gtin","tnVedEaes","tnVedEaesGroup","maxRetailPrice","parent","producerInn","ownerInn","prVetDocument","productName","brand","ownerName","producerName","introducedDate","receiptDate","status","statusEx","emissionType","withdrawReason","packageType","productGroup","applicationDate","emissionDate","expirationDate","child","setGtin","setDescription","productionDate","aggregationType","orderId","turnoverType","kpp","fiasId","declarationRegistrationNumbers","permitDocs"
"0104640076801111211E+iiiIII1ii0","04640076801111",,,,,"7711111112","7711111113",,,,"ООО ""ТЕСТ1""","ООО ""ТЕСТ2""",,,"APPLIED",,"LOCAL",,"UNIT","WATER","2025-04-25T07:43:43.279Z","2025-04-25T07:43:39.199Z",,"[]",,,,,"6050cf19-5555-55c1-5b5c-d5af5e55ffe5",,,,,"{""permitDocs"":[{""dateFrom"":""2015-02-14"",""type"":13,""number"":""BY.70.06.01.007.Е.001111.02.15"",""indx"":200513,""statusGroup"":1,""active"":true}]}"

Параметр

Тип

Обяз.

Описание

Комментарий

requestedCis

string

КИ потребительских / групповых / транспортных упаковок

При наличии параметра в ответе (если найдены КИ по запросу)

gtin

string

Код товара

Если код товара менее 14 символов, то дополняется ведущими нулями

tnVedEaes

string

10 значный код ТН ВЭД

tnVedEaesGroup

string

4-х значный код ТН ВЭД

maxRetailPrice

number

Максимальная розничная цена в копейках

В текущей реализации возможно выведение параметра «mrp», который в последующих версиях будет заменён на «maxRetailPrice»

parent

string

Родительский КИ

producerInn

string

ИНН производителя

Не возвращается для агрегатов, кроме товарных групп «Табачная продукция» и «Альтернативная табачная продукция»

ownerInn

string

ИНН собственника товара

Данный параметр возвращается только владельцу продукции, ФОИВ и Оператору. Возвращение данных о владельце настраивается параметром конфигурации. Параметр не возвращается для товарной группы «Табачная продукция»

prVetDocument

string

Идентификатор ВСД

productName

string

Наименование продукции

ownerName

string

Наименование собственника товара

Данный параметр возвращается только владельцу продукции, ФОИВ и Оператору. Отображение данных о владельце настраивается параметром конфигурации. Параметр не возвращается для товарной группы «Табачная продукция»

producerName

string

Наименование производителя

introducedDate

string (date-time)

Дата ввода товара в оборот или формирование агрегата

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

emissionDate

string (date-time)

Дата эмиссии

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

emissionType

string

Тип эмиссии

maxRetailPrice

number

Максимальная цена розничной продажи

Только для единицы товара и групповой упаковки

applicationDate

string (date-time)

Дата нанесения

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

receiptDate

string (date-time)

Дата вывода из оборота

Возвращается в формате yyyy-MM-ddTHH:mm:ss.SSS’Z

withdrawReason

string

Причина выбытия