|
|
содержание .. 3 4 5
Параметр
Тип
Обяз.
Описание
Комментарий
*primary_documen
string
-
Наименование
Формат: 2020-01-
t_custom_name
первичного документа
14T00:00:00.000Z. Диапазон:
текущая дата минус 5
календарных лет ← дата ←
текущая дата. Параметр
является обязательным, если не
заполнен в массиве "products"
("Массив, содержащий список
КИ"). Значение параметра имеет
более высокий приоритет перед
значением параметра
"document_date" ("Дата
первичного документа"), не
указанном в массиве "products"
("Массив, содержащий список
КИ"). Параметр строго не
заполнен при "action" ("Причина
вывода из оборота") =
"STATE_SECRET" ("Продажа по
сделке, составляющей гос.
тайну")
Параметры "destination_country_code" ("Код страны назначения") и "importer_id" ("ИНН (или
аналог) импортёра") являются уникальными для документа в формате * .json и неприменимы
для документов в формате * .xml и * .csv.
Пример тела документа в формате * .csv и * .xml:
ИНН участника оборота,Причина вывода из оборота,Другая причина вывода из оборота,Дата
вывода из оборота,Тип первичного документа,Номер первичного документа,Дата первичного
документа,Наименование первичного документа,Регистрационный номер ККТ,Идентификатор
госконтракта,Версия
7700000000,"Продажа по сделке, составляющей гостайну",,2021-08-
10,,,,,,1010101010101010101010101,6
Параметры товаров
КИ,Цена за единицу,Тип первичного документа,Номер первичного документа,Дата первичного
документа,Наименование первичного документа
"010464444444444421FFFFFFFFFFFFF",,,,,
Пример тела документа в формате * .xml:
404
<?xml version="1.0" encoding="UTF-8"?>
<withdrawal version="7">
<trade_participant_inn>1111111111</trade_participant_inn>
<withdrawal_type>OTHER</withdrawal_type>
<withdrawal_type_other>Any text up to 255 characters</withdrawal_type_other>
<withdrawal_date>2021-10-20</withdrawal_date>
<primary_document_type>OTHER</primary_document_type>
<primary_document_number>56783</primary_document_number>
<primary_document_date>2021-10-20</primary_document_date>
<primary_document_custom_name>Also any text up to 255
characters</primary_document_custom_name>
<kkt_number>1111111111111111</kkt_number>
<products_list>
<product>
<cis>010464444444444421FFFFFFFFFFFFF</cis>
<cost>100500</cost>
</product>
<product>
<cis>010464444444444421LLLLLLLLLLLLL</cis>
<cost>100500</cost>
</product>
<product>
<cis>010464444444444421KKKKKKKKKKKKK</cis>
<cost>100500</cost>
</product>
<product>
<cis>010464444444444421MMMMMMMMMMMMM</cis>
<cost>100500100500</cost>
</product>
</products_list>
</withdrawal>
3.2.10. Списание КИ
3.2.10.1. Списание не нанесённых КИ с/без СИ
Создание документа доступно для товарных групп "Антисептики и дезинфицирующие
средства", "Биологически активные добавки к пище", "Велосипеды и велосипедные рамы",
"Духи и туалетная вода", "Кресла-коляски", "Молочная продукция", "Обувные товары", "Пиво,
напитки, изготавливаемые на основе пива, слабоалкогольные напитки", "Предметы одежды,
бельё постельное, столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые
новые".
Применяется для КИ в статусе APPLIED ("Эмитирован. Получен"), когда участнику оборота
товаров не требуются полученные из СУЗ КМ и их необходимо списать в ГИС МТ.
Для товарных групп "Молочная продукция", "Упакованная вода" доступно списание только
нанесённых КМ, так как в СУЗ обязательно выполняется подача отчёта о нанесении, после чего
КИ в ГИС МТ переходит из статуса из EMITTED ("Эмитирован. Выпущен") в APPLIED
("Эмитирован. Получен"). Доступно указание только нанесённых КИ в статусе APPLIED
405
("Эмитирован. Получен").
Тип документа:
Тип
Описание
LK_KM_CANCELLATION
Списание не нанесённых КИ. JSON
LK_KM_CANCELLATION_XML
Списание не нанесённых КИ. XML
LK_KM_CANCELLATION_CSV
Списание не нанесённых КИ. CSV
Пример тела документа в формате * .json:
{
"cancellation_doc_date": "2020-01-23" ,
"cancellation_doc_number": "string" ,
"cancellation_reason": "string" ,
"km_list": [
{
"cancellation_reason": "string" ,
"uit": "string" ,
"uitu": "string"
}
] ,
"pdfFile": "string" ,
"trade_participant_inn": "string"
}
Параметры документа:
Параметр
Тип
Обяз.
Описание
Комментарий
cancellation_doc_d
string
+
Дата списания
Значением параметра является
ate
строка с отформатированными
датой и временем
cancellation_doc_n
string
+
Номер первичного
umber
документа на списание
cancellation_reaso
string
+
Причина списания
Возможные значения:
n
KM_SPOILED - испорчен;
KM_LOST - утерян;
KM_DESTROYED - уничтожен
km_list
array
+
Список данных о КМ
*uit
string
-
Уникальный КИ/КИН
Обязательный, если не
указан "uitu" ("Уникальный
идентификатор транспортной
упаковки"). Списание КИН и
КИГУ возможно только при
отсутствии в вложений
406
Параметр
Тип
Обяз.
Описание
Комментарий
*uitu
string
-
Уникальный
Обязательный, если не
идентификатор
указан "uit" ("Уникальный
транспортной
КИ/КИН ")
упаковки
*cancellation_reas
string
+
Код причины списания
Возможные значения:
on
KM_SPOILED - испорчен;
KM_LOST - утерян;
KM_DESTROYED - уничтожен
pdfFile
string
-
Приложенный PDF
файл в Base64
trade_participant_i
string
+
ИНН участника
nn
оборота товара
Примечание: чтобы списать КИ в статусе EMITTED ("Эмитирован. Выпущен"), необходимо
закрыть заказ в СУЗ, тем самым все нанесенные КИ перейдут в статус APPLIED ("Эмитирован.
Получен"), а остальные спишутся автоматически, либо дождаться, когда КИ спишутся
автоматически по сроку годности.
Пример тела документа в формате * .csv
ИНН участника оборота,Причина списания кода маркировки,Дата документа подтверждающего
списание,Номер документа подтверждающего списание,Версия
0000000000,Испорчен,12.04.2019,123,2
Параметры кодов маркировки
КИ,КИТУ,Причина списания кода маркировки
"00000000000000000000000000000000000000",,Испорчен
Пример тела документа в формате * .xml
<?xml version="1.0" encoding="UTF-8"?>
<km_cancellation action_id="14" version="2">
<trade_participant_inn>7726739740</trade_participant_inn>
<cancellation_reason>KM_SPOILED</cancellation_reason>
<cancellation_document_date>20.01.2021</cancellation_document_date>
<cancellation_document_number>6742</cancellation_document_number>
<km_list>
<km>
<kit>010464004346033921(JlWKDvQDT4K*</kit>
<cancellation_reason>KM_SPOILED</cancellation_reason>
</km>
</km_list>
</km_cancellation>
3.2.10.2. Списание нанесённых КИ с СИ
Создание документа доступно для товарных групп "Антисептики и дезинфицирующие
407
средства", "Биологически активные добавки к пище", "Велосипеды и велосипедные рамы",
"Духи и туалетная вода", "Кресла-коляски", "Обувные товары", "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые
новые".
Применяется для КМ в статусе INTRODUCED ("В обороте"), когда участнику оборота товаров
необходимо списать КМ, находящийся в обороте, но не выводить тем самым из оборота. КМ
получает "Статус" ("status") = WRITTEN_OFF ("Списан") и дополнительный "Статус" (statusEx)
= WAIT_REMARK ("Товар ожидает перемаркировку или КИ списан после нанесения на товар").
Следовательно, полученный КМ ("statusEx" ("Статус") = WAIT_REMARK ("Товар ожидает
перемаркировку или КИ списан после нанесения на товар")) можно будет потом использовать в
схеме LK_REMARK ("Перемаркировка") с причиной перемаркировки = причине "Списания
КМ" в схеме LK_APPLIED_KM_CANCELLATION ("Списание нанесённых КИ").
Тип документа:
Тип
Описание
LK_APPLIED_KM_CANCELLATION
Списание нанесённых КМ. JSON (MANUAL)
LK_APPLIED_KM_CANCELLATION_CSV
Списание нанесённых КМ. CSV
LK_APPLIED_KM_CANCELLATION_XML
Списание нанесённых КМ. XML
Пример тела документа в формате * .json:
{
"cancellation_doc_date": "2020-01-23",
"cancellation_doc_number": "string",
"cancellation_reason": "string",
"km_list": [
{
"cancellation_reason": "string",
"uit": "string",
"uitu": "string"
}
],
"pdfFile": "string",
"trade_participant_inn": "string"
}
Параметры документа:
Параметр
Тип
Обяз.
Описание
Комментарий
cancellation_doc_d
string
+
Дата списания
Задаётся в формате yyyy-MM-dd
ate
cancellation_doc_n
string
+
Номер первичного
umber
документа на списание
408
Параметр
Тип
Обяз.
Описание
Комментарий
cancellation_reaso
string
+
Причина списания
Возможные значения:
n
KM_SPOILED - испорчен;
KM_LOST - утерян;
KM_DESTROYED - уничтожен
km_list
array
+
Список данных о КИ
*uit
string
-
Уникальный КИ/КИН
Обязательный, если не
указано "uitu" ("Уникальный
идентификатор транспортной
упаковки"). Списание КИН и
КИГУ возможно только при
отсутствии вложений
*uitu
string
-
Уникальный
Обязательный, если не
идентификатор
указано "uit" ("Уникальный
транспортной
КИ/КИН ")
упаковки
*cancellation_reas
string
+
Код причины списания
Возможные значения:
on
KM_SPOILED - испорчен;
KM_LOST - утерян;
KM_DESTROYED - уничтожен
pdfFile
string
-
Приложенный * .pdf
файл в Base64
trade_participant_i
string
+
ИНН участника
nn
оборота товара
Примечание: чтобы списать КМ в статусе EMITTED ("Эмитирован. Выпущен"), необходимо
закрыть заказ в СУЗ, тем самым все нанесенные КМ перейдут в статус APPLIED ("Эмитирован.
Получен"), а остальные спишутся автоматически, либо дождаться, когда КМ спишутся
автоматически по сроку годности.
Пример тела документа в формате * .csv:
ИНН участника оборота,Причина списания кода маркировки,Дата документа подтверждающего
списание,Номер документа подтверждающего списание,Версия
0000000000,Испорчен,12.04.2019,123,2
Параметры кодов маркировки
КИ,КИТУ,Причина списания кода маркировки
"00000000000000000000000000000000000000",,Испорчен
Пример тела документа в формате * .xml:
409
<?xml version="1.0" encoding="UTF-8"?>
<km_cancellation action_id="14" version="2">
<trade_participant_inn>7777777777</trade_participant_inn>
<cancellation_reason>KM_SPOILED</cancellation_reason>
<cancellation_document_date>20.01.2021</cancellation_document_date>
<cancellation_document_number>6742</cancellation_document_number>
<km_list>
<km>
<kit>010464004346033921(JlWKDvQDT4K*</kit>
<cancellation_reason>KM_SPOILED</cancellation_reason>
</km>
</km_list>
</km_cancellation>
3.2.11. Предоставление дополнительных сведений об РД для ввода товара в оборот
Создание документа доступно для товарных групп "Альтернативная табачная продукция" и
"Шины и покрышки пневматические резиновые новые". Для товарной группы "Шины и
покрышки пневматические резиновые новые" ввод в оборот по УПД недоступен, но
предоставление сведений об РД является доступным.
После нанесения СИ с КИ на товар и регистрации сведений о нанесении СИ в ГИС МТ,
участник оборота товаров формирует список товаров для передачи сведений в ГИС МТ о РД,
дополнительных сведениях для ввода товара в оборот перед вводом товара в оборот по УПД.
Тип документа:
Тип
Описание
CIRCULATION_INFORMATION
Дополнительные сведения для ввода в оборот.
JSON
Пример тела запроса:
410
{
"documentType": "CIRCULATION_INFORMATION",
"participantInn": "string",
"codes": [
{
"code": "9863812735381253",
"permitDocInfo": {
"permitDocDate": "01.01.2021",
"permitDocNumber": "12312312",
"permitDocType": 1
}
},
{
"code": "6875875385476423",
"permitDocInfo": {
"permitDocDate": "02.01.2021",
"permitDocNumber": "4214124124",
"permitDocType": 1
}
}
]
}
Параметры документа:
Параметр
Тип
Обяз.
Описание
Комментарий
documentType
string
+
Вид документа
participantInn
string(10
+
ИНН участника
,12)
оборота товаров
codes
array
+
Массив КИ и
присваиваемых им РД
*code
string
+
КИ или агрегат, к
КИ должен быть в статусе
которым
"APPLIED" ("Эмитирован.
осуществляется
Получен") или "INTRODUCED"
загрузка РД
("В обороте"), если сведения об
РД предоставляет производитель
или импортёр данного КИ. Если
сведения об РД предоставляет
собственник данного КИ (не
производитель, не импортёр), то
КИ должен быть в статусе
"INTRODUCED" ("В обороте").
Возможные значения способа
выпуска товара в оборот см.
"Справочник "Типы эмиссии
КИ""
411
Параметр
Тип
Обяз.
Описание
Комментарий
*permitDocInfo
object
+
Реквизиты
разрешительного
документа
**permitDocType
integer(1
+
Вид документа
Возможные
значения:
-1)
обязательной
CONFORMITY_CERTIFICATE -
сертификации
сертификат соответствия;
CONFORMITY_DECLARATIO
N - декларация о соответствии
**permitDocNumb
string(1-
+
Номер документа
er
4000)
**permitDocDate
string
+
Дата документа
Формат даты: dd.mm.yyyy
Примечание: в ответе возвращается уникальный идентификатор документа в ГИС МТ в формате
URDХХХХХХХХХХХХХХХХХХХХ-ХХХХ.
3.2.12. Перемаркировка
Создание документа доступно для товарных групп "Антисептики и дезинфицирующие
средства", "Биологически активные добавки к пище", "Велосипеды и велосипедные рамы",
"Духи и туалетная вода", "Кресла-коляски", "Обувные товары", "Предметы одежды, бельё
постельное, столовое, туалетное и кухонное", "Упакованная вода", "Фотокамеры (кроме
кинокамер), фотовспышки и лампы-вспышки", "Шины и покрышки пневматические резиновые
новые".
Краткое описание причин перемаркировки
• испорчено либо утеряно СИ с КМ (KM_SPOILED) - участник оборота товаров, являющийся
собственником товара, планирует перемаркировать товар, который находится в обороте.
Указание данной причины возможно с указанием или без указания предыдущего КИ.
Указанный предыдущий КИ должен быть в статусе "В обороте"/"Выбыл" по причине
списания КИ;
• выявлены ошибки описания товара (DESCRIPTION_ERRORS) - участник оборота товаров,
являющийся собственником товара, планирует перемаркировать товар, который находится в
обороте. Указание данной причины возможно только с указанием предыдущего КИ в статусе
"В обороте"/"Выбыл" по причине списания КИ;
• возврат товаров с повреждённым СИ/без СИ при розничной реализации (в ЛК ГИС МТ
"Возврат от розничного покупателя" (RETAIL_RETURN))
- участник оборота товара,
являющийся собственником товара, планирует перемаркировать товар, возвращённый после
розничной реализации (например: чек возврата без КИ). Указание данной причины возможно
с указанием или без указания предыдущего КИ. Указанный предыдущий КИ должен быть в
статусе "Выбыл" по причине розничной реализации;
• возврат товаров с повреждённым СИ/без СИ при дистанционном способе продажи (в ЛК
ГИС МТ "Возврат в случае дистанционной продажи" (REMOTE_SALE_RETURN))
-
участник оборота товара, являющийся собственником товара, планирует перемаркировать
товар, возвращённый после дистанционного способа продажи. Указание данной причины
возможно с указанием или без указания предыдущего КИ. Указанный предыдущий КИ
должен быть в статусе "Выбыл" по причине дистанционного способа продажи;
412
• возврат от конечного покупателя (юр. лица/ИП) (LEGAL_RETURN) - участник оборота
товара, являющийся собственником товара, планирует перемаркировать товар, возвращённый
после реализации ЮЛ/ИП. Указание данной причины возможно как с указанием
предыдущего КИ, так и без него. Указанный предыдущий КИ должен быть в статусе
"Выбыл" по причине исполнения государственного контракта безвозмездной передачи,
использования товара для собственных нужд покупателем;
• решение о реализации товаров, приобретённых в целях, не связанных с их реализацией
(INTERNAL_RETURN) - участник оборота товара, являющийся собственником товара,
планирует перемаркировать ранее приобретённый товар с целью дальнейшей реализации.
Указание данной причины возможно как с указанием предыдущего КИ, так и без него.
Указанный предыдущий КИ должен быть в статусе "Выбыл" по причине использования
товара для собственных нужд. КИ был выведен из оборота путём отгрузки с выводом из
оборота или через УПД с выводом из оборота;
• возврат ранее экспортированного в ЕАЭС (EEC_EXPORT_RETURN) - участник оборота
товара, являющийся последним собственником товара, планирует перемаркировать ранее
приобретённый товар, который возвращён после экспорта в страны ЕЭАС. Указание данной
причины возможно как с указанием предыдущего КИ, так и без него. Указанный
предыдущий КИ должен быть в статусе "Выбыл" по причине экспорта в страны ЕАЭС.
Условия перемаркировки:
• новый КИ может быть только в статусе "Эмитирован. Получен" (APPLIED) с типом эмиссии
"Перемаркировка" (REMARK);
• перемаркировка осуществляется для предыдущего КИ только в статусе "В обороте"
(INTRODUCED) или "Выбыл" (RETIRED);
• участник оборота товаров, осуществляющий перемаркировку, должен быть владельцем
предыдущего КИ;
• обязательно указание предыдущего КИ в поле "last_uin" для причины перемаркировки
"Выявлены ошибки описания товара". При указании предыдущего КИ данные о цвете,
размере и стране производства берутся из указанного предыдущего КИ, даже если при
формировании документа были указаны данные, отличные от данных предыдущего КИ;
• КИ агрегата и КИ товара, входящего в состав агрегата, в параметре "new_uin" не
указывается. При указании КИ, входящего в состав агрегата в статусе "Сформирован",
агрегат расформировывается;
• причина выбытия КИ соответствует причине перемаркировки;
• тип упаковки нового КИ должен соответствовать типу упаковки предыдущего КИ.
Условия перемаркировки КИН:
• обязательно указание предыдущего КИН в поле "last_uin" для всех причин перемаркировки;
• предыдущий КИН находится в статусе "В обороте" (INTRODUCED) для причины
перемаркировки "Испорчено либо утеряно СИ с КМ" (KM_SPOILED)) и в статусе "Выбыл"
(RETIRED) для причин перемаркировки "Возврат товаров с повреждённым СИ/без СИ при
розничной реализации" (RETAIL_RETURN), "Возврат товаров с повреждённым СИ/без СИ
при дистанционном способе продажи" (REMOTE_SALE_RETURN), "Возврат ранее
экспортированного в ЕАЭС" (EEC_EXPORT_RETURN), "Решение о реализации товаров,
приобретённых в целях, не связанных с их реализацией" (INTERNAL_RETURN), "Возврат от
конечного покупателя (юр. лица/ИП)" (LEGAL_RETURN));
413
• статус предыдущего КИН соответствует статусу вложенных КИ и должен иметь значение "В
обороте" (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_CSV
Перемаркировка. CSV
LK_REMARK_XML
Перемаркировка. XML
Пример тела документа в формате * .json:
414
{
"participant_inn":"7777777777",
"remarking_date":"2021-10-10",
"remarking_cause":"string",
"products":[
{
"last_uin":"010461111111111121LLLLLLLLLLLLL",
"new_uin":"010463333333333321FFFFFFFFFFFFF",
"tnved_code":"0000000000",
"production_country":"string",
"color":"string",
"product_size":"string",
"certificate_document_data":[
{
"certificate_document_type":"CONFORMITY_CERTIFICATE",
"certificate_document_number":"326",
"certificate_document_date":"2021-10-10"
},
{
"certificate_document_type":"CONFORMITY_CERTIFICATE",
"certificate_document_number":"123",
"certificate_document_date":"2021-10-10"
}
]
}
]
}
Параметры документа:
Параметр
Тип
Обяз.
Описание
Комментарий
participant_inn
string
+
ИНН участника
оборота товаров
remarking_date
string
-
Дата перемаркировки
Параметр обязательный, если не
указан одноимённый параметр
на уровне товаров. Диапазон:
текущая дата минус 5
календарных лет ← дата ←
текущая дата. Формат:
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd
415
Параметр
Тип
Обяз.
Описание
Комментарий
remarking_cause
string
+
Причина
Возможные значения:
перемаркировки
KM_SPOILED - испорчено либо
утеряно СИ с КМ;
DESCRIPTION_ERRORS -
выявлены ошибки описания
товара;
RETAIL_RETURN - возврат
товаров с повреждённым СИ/без
СИ при розничной реализации
(возврат от розничного
покупателя);
REMOTE_SALE_RETURN -
возврат товаров с
повреждённым СИ/без СИ при
дистанционном способе
продажи (возврат в случае
дистанционной продажи);
LEGAL_RETURN - возврат от
конечного покупателя (юр.
лица/ИП);
INTERNAL_RETURN - решение
о реализации товаров,
приобретённых в целях, не
связанных с их реализацией;
EEC_EXPORT_RETURN -
возврат ранее
экспортированного в ЕАЭС
products
array of
+
Массив
Должна быть указана хотя бы
objects
перемаркируемых КИ
одна запись списка
416
Параметр
Тип
Обяз.
Описание
Комментарий
*last_uin
string
-
Предыдущий
Параметр обязателен, если
КИ/КИК/КИН
"remarking_cause" ("Код
причины перемаркировки") =
DESCRIPTION_ERRORS
("Выявлены ошибки описания
товара"). Для КИН параметр
обязателен, если
"remarking_cause" ("Код
причины перемаркировки")
принимает любое из следующих
значений:
KM_SPOILED - испорчено либо
утеряно СИ с КМ;
DESCRIPTION_ERRORS -
выявлены ошибки описания
товара;
RETAIL_RETURN - возврат
товаров с повреждённым СИ/без
СИ при розничной реализации
(возврат от розничного
покупателя);
REMOTE_SALE_RETURN -
возврат товаров с
повреждённым СИ/без СИ при
дистанционном способе
продажи (возврат в случае
дистанционной продажи);
LEGAL_RETURN - возврат
товара от конечного покупателя
ЮЛ/ИП;
INTERNAL_RETURN - решение
о реализации приобретённого
ранее товара без цели
дальнейшей реализации;
EEC_EXPORT_RETURN -
экспорт в страны ЕАЭС.
Предыдущий КИ должен быть в
статусе "В обороте"
(INTRODUCED) или "Выбыл"
(RETIRED)
*new_uin
string
+
Новый КИ/КИК/КИН
Повторный ввод в оборот
возможен, если не указаны
предыдущие КИ/КИК. Новый
КИ/КИК/КИН должен быть
только в статусе "Эмитирован.
Получен" (APPLIED) с типом
эмиссии "Перемаркировка"
(REMARK)
417
Параметр
Тип
Обяз.
Описание
Комментарий
*primary_documen
enum
-
Вид первичного
Параметр не заполняется или
t_type
документа
заполняется вместе с
параметрами
"primary_document_number"
("Номер первичного
документа") и
"primary_document_date" ("Дата
первичного документа").
Возможные значения, если
"remarking_cause" ("Код
причины перемаркировки") =
RETAIL_RETURN ("Возврат
товаров с повреждённым СИ/без
СИ при розничной реализации")
или REMOTE_SALE_RETURN
("Возврат товаров с
повреждённым СИ/без СИ при
дистанционном способе
продажи"):
RECEIPT - кассовый чек;
SALES_RECEIPT - товарный
чек;
OTHER - прочее.
Возможные значения, если
"remarking_cause" ("Код
причины перемаркировки") =
LEGAL_RETURN ("Возврат от
конечного покупателя") или
EEC_EXPORT_RETURN
("Возврат ранее
экспортированного в ЕАЭС"):
CONSIGNMENT_NOTE -
товарная накладная;
UTD - универсальный
передаточный документ;
OTHER - прочее
*primary_documen
string
-
Наименование
t_custom_name
первичного документа
*primary_documen
string
-
Дата первичного
Формат:
t_date
документа
yyyy-MM-ddTHH:mm:ss.SSSZ;
yyyy-MM-ddTHH:mm:ssZ;
dd.MM.yyyy;
dd.MM.yyyy HH:mm;
yyyy-MM-dd
418
Параметр
Тип
Обяз.
Описание
Комментарий
*primary_documen
string
-
Номер первичного
t_number
документа
*tnved_10
string
+
Код ТН ВЭД ЕАЭС
Не указывается для КИН. Для
товара
товарных групп "Антисептики и
дезинфицирующие средства",
"Биологически активные
добавки к пище", "Предметы
одежды, бельё постельное,
столовое, туалетное и кухонное"
и "Фотокамеры (кроме
кинокамер), фотовспышки и
лампы-вспышки" доступно
указание как устаревших
(действительных до 31.01.2022),
так и новых кодов ТН ВЭД
ЕАЭС (действительных с
01.01.2022)
*paid
boolean
-
Товар оплачен
Признак оплаты товара:
true - оплачен;
false - не оплачен.
Параметр устаревший и в
дальнейшем будет удалён
*production_countr
string
-
Страна производства
Не заполняется для КИН.
y
Указывается код страны в
соответствии с ОКСМ
(например: 112 - Республика
Беларусь).
Параметр не указывается для
товарной группы "Шины и
покрышки пневматические
резиновые новые"
*color
string
-
Цвет
Указывается значение цвета,
содержащее от 1 до 1024
буквенных символа на
английском или русском языке.
Параметр используется только
для товарной группы "Обувные
товары"
419
Параметр
Тип
Обяз.
Описание
Комментарий
*product_size
string
-
Размер
Указывается значение размера
обувных товаров, содержащее от
1 до 1024 буквенных символа, на
английском или русском языке
(например: 37RUS/6US).
Возможно указание одного
размера, указание диапазона
размеров недоступно. Параметр
используется только для
товарной группы "Обувные
товары"
*certificate_docum
string
-
Код вида документа
Данный параметр считается
ent
обязательной
устаревшим, сохраняется для
сертификации
обратной совместимости.
Возможные значения:
CONFORMITY_CERTIFICATE -
сертификат соответствия;
CONFORMITY_DECLARATION
- декларация соответствия
*certificate_docum
string(1-
-
Номер документа
Данный параметр считается
ent_number
255)
обязательной
устаревшим, сохраняется для
сертификации
обратной совместимости
*certificate_docum
string
-
Дата документа
Данный параметр считается
ent_date
обязательной
устаревшим, сохраняется для
сертификации
обратной совместимости.
Нижняя допустимая граница
даты - 01.01.2000, верхняя
допустимая граница даты -
текущая дата. Формат:
YYYY-MM-DD;
yyyy-MM-ddTHH:mm:ss;
dd.MM.yyyy HH:mm;
yyyy-MM-ddTHH:mm:ss.SSS;
yyyy-MM-dd
420
Параметр
Тип
Обяз.
Описание
Комментарий
*certificate_docum
array of
-
Массив, содержащий
Данные могут быть указаны
ent_data
objects
данные документов,
либо внутри массива
подтверждающих
"certificate_document_data"
соответствие
("Массив, содержащий данные
документов, подтверждающих
соответствие") либо в
параметрах
"certificate_document" ("Вид
документа, подтверждающего
соответствие"),
"certificate_document_number"
("Номер документа,
подтверждающего
соответствие"),
"certificate_document_date"
("Дата документа,
подтверждающего
соответствие"). Одновременно
должны быть заполнены либо
все три параметра массива, либо
все три не заполнены
**certificate_type
string
-
Вид документа
Возможные значения:
разрешительной
документации
CONFORMITY_CERTIFICATE -
сертификат соответствия;
CONFORMITY_DECLARATION
- декларация соответствия
Возможные значения для
товарных групп "Биологически
активные добавки к пище",
"Молочная продукция",
"Упакованная вода":
CONFORMITY_CERTIFICATE -
сертификат соответствия;
CONFORMITY_DECLARATION
- декларация соответствия;
STATE_REGISTRATION_CERT
IFICATE - свидетельство
государственной регистрации
**certificate_numb
string
-
Номер документа
er
разрешительной
документации
421
Параметр
Тип
Обяз.
Описание
Комментарий
**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
Пример тела документа в формате * .csv:
ИНН участника оборота,Дата перемаркировки,Причина перемаркировки,Версия
7777777777,10.10.2021,"Возврат ранее экспортированного в ЕАЭС",6
Параметры товаров
Предыдущий КИ,Новый КИ,Код товарной номерклатуры,Дата перемаркировки,Товар оплачен,Тип
первичного документа,Наименование первичного документа,Номер первичного документа,Дата
первичного документа,"Вид документа, подтверждающего соответствие","Номер документа,
подтверждающего соответствие","Дата документа, подтверждающего соответствие",Страна
производства, Цвет, Размер
"010461111111111121LLLLLLLLLLLLL","010463333333333321FFFFFFFFFFFFF",0000000000,10.10.2
021,,Товарная накладная,435,4526,10.10.2021,,,,156,RED,20.5
"","010463333333333321NNNNNNNNNNNNN",0000000000,10.10.2021,,,,,,,,,156,RED,20.5
Пример тела документа в формате * .xml:
422
<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>
3.3. УПД на отгрузку
Работа с УПД описана в документе API ЭДО lite.
3.4. Заказ КМ. СУЗ
Работа с КМ описана в документе Станция управления заказами. Спецификация API.
Список сокращений, условных обозначений и
терминов
Сокращение
Описание
API
Application Programming Interface (Интерфейс программирования
приложений)
Base64
Стандарт кодирования двоичных данных при помощи только 64
символов ASCII
423
Сокращение
Описание
CSV
(Comma-Separated Values) текстовый формат, предназначенный для
представления табличных данных
GTIN
Код товара
JSON
JavaScript Object Notation (текстовый формат обмена данными,
основанный на JavaScript)
MIME
Multipurpose Internet Mail Extensions (стандарт, описывающий
передачу различных типов данных по электронной почте)
pdf
Portable Document Format (межплатформенный открытый формат
электронных документов)
RFC
Request for Comments (документ из серии пронумерованных
информационных документов Интернета, содержащих
технические спецификации и стандарты, широко применяемые во
всемирной сети)
SGTIN
Serialized Global Trade Item Number (индивидуальный
идентификационный код потребительской упаковки для
прослеживаемости в (GTIN + индивидуальный серийный номер
вторичной (потребительской) упаковки или первичной упаковки, в
случае отсутствия вторичной)
URL
Uniform Resource Locator (единый указатель ресурса)
UTF-8
Unicode Transformation Format, 8-bit (формат преобразования
Юникода, 8-бит)
UUID
Universally unique identifier. Универсальный уникальный
идентификатор участника оборота товаров. Записывается в виде
последовательности шестнадцатеричных цифр в нижнем регистре,
разделённых знаками минуса на несколько групп, в следующем
порядке: группа из 8 цифр, три группы из 4 цифр и группа из 12
цифр, что в сумме составляет 32 цифры и представляет 128 бит.
Пример UUID: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11
XML
eXtensible Markup Language (расширяемый язык разметки)
XSD
XML Schema definition (язык описания структуры XML
документа)
АТК
Агрегированный таможенный код
АСУТП
Автоматизированная система управления технологическим
процессом
БД
База данных
ВСД
Ветеринарный сопроводительный документ (транспортный
сопроводительный документ)
ГИС МТ
Государственная информационная система мониторинга за
оборотом товаров
ЕНВД
Единый налог на вменённый доход
424
Сокращение
Описание
ЕСХН
Единый сельскохозяйственный налог
ДИС
Документ об изменении стоимости отгруженных товаров
(выполненных работ, оказанных услуг), переданных
имущественных прав
ДОП
Первичный документ. Например: накладная или акт
ДТ
Декларация на товары
ДС
Декларация о соответствии
ЕАЭС
Евразийский экономический союз
ЕГРИП
Единый государственный реестр индивидуальных
предпринимателей
ЕГРЮЛ
Единый государственный реестр юридических лиц
ИНН
Идентификационный номер налогоплательщика
ИП
Индивидуальный предприниматель
КИ
Код идентификации
КИГУ
Код идентификации групповой упаковки
КИК
Код идентификации комплекта
КИН
Код идентификации набора (указывается по аналогии с КИ)
КИТУ
Код идентификации транспортной упаковки (указывается от 18 до
74 символов включительно: цифры, буквы латинского алфавита,
спецсимволы: A-Z a-z 0-9 % & ' " ( ) * + , - _ . / : ; < = > ? !)
КМ
Код маркировки
КСЧФ
Корректировочная счет-фактура, применяемая при расчетах по
налогу на добавленную стоимость
КСЧФ ДИС
Корректировочная счет-фактура, применяемая при расчетах по
налогу на добавленную стоимость, и документ об изменении
стоимости отгруженных товаров (выполненных работ, оказанных
услуг), переданных имущественных прав
МОД
Места осуществления деятельности
МОТП
Мониторинг оборота табачной продукции
МОД
Место осуществления деятельности
НДС
Налог на добавленную стоимость
НК
Национальный каталог
НМПТ
Наименование места происхождения товара
ОКСМ
Общероссийский классификатор стран мира
ОСН
Общая система налогообложения
425
Сокращение
Описание
РАФП
Реестр аккредитованных филиалов, представительств
иностранных юридических лиц
РБ
Республика Беларусь
РД
Разрешительная документация
РЭ
Регистратор эмиссии
СГР
Свидетельство о государственной регистрации
СКПТ
Код подакцизного товара
СС
Сертификат соответствия
СУЗ
Станция управления заказами
СЧФ
Счёт-фактура
СЧФ ДОП
См. УПД
ТГ
Товарная группа
ТН ВЭД ЕАЭС
Товарная номенклатура внешнеэкономической деятельности
Евразийского экономического союза
ТСР
Технические средства реабилитации
УД
Универсальный документ
УКД
Универсальный корректировочный документ
УКДи
Исправленный универсальный корректировочный документ
УКЭП
Усиленная квалифицированная электронная подпись
УНП
Учётный номер плательщика
УОТ
Участник оборота товара
УПД
Универсальный передаточный документ
УПДи
Исправленный универсальный передаточный документ
УСН
Упрощённая система налогообложения
ФД
Фискальный документ
ФТС
Федеральная таможенная служба
ФОИВ
Федеральные органы исполнительной власти
ФПД
Фискальный признак документа
ФРАП
Федеральная служба по регулированию алкогольного рынка
ЦРПТ
Центр развития перспективных технологий
ЭДО
Электронный документооборот
ЮЛ
Юридическое лицо
426
Справочники
Справочник "Список поддерживаемых товарных групп"
Код в БД
Наименование
Описание
1
lp
Предметы одежды, бельё постельное, столовое, туалетное и
кухонное
2
shoes
Обувные товары
3
tobacco
Табачная продукция
4
perfumery
Духи и туалетная вода
5
tires
Шины и покрышки пневматические резиновые новые
6
electronics
Фотокамеры (кроме кинокамер), фотовспышки и лампы-
вспышки
8
milk
Молочная продукция
9
bicycle
Велосипеды и велосипедные рамы
10
wheelchairs
Кресла-коляски
12
otp
Альтернативная табачная продукция
13
water
Упакованная вода
14
furs
Товары из натурального меха
15
beer
Пиво, напитки, изготавливаемые на основе пива,
слабоалкогольные напитки
16
ncp
Никотиносодержащая продукция
17
bio
Биологические активные добавки к пище
19
antiseptic
Антисептики
Справочник "Типы документов"
Код
Наименование
Формат
AGGREGATION_DOCUMENT
Агрегация
JSON
AGGREGATION_DOCUMENT_CSV
Агрегация
CSV
AGGREGATION_DOCUMENT_XML
Агрегация
XML
SETS_AGGREGATION
Формирование наборов
JSON
SETS_AGGREGATION_CSV
Формирование наборов
CSV
SETS_AGGREGATION_XML
Формирование наборов
XML
DISAGGREGATION_DOCUMENT
Расформирование агрегата
JSON
DISAGGREGATION_DOCUMENT_CSV
Расформирование агрегата
CSV
DISAGGREGATION_DOCUMENT_XML
Расформирование агрегата
XML
427
Код
Наименование
Формат
REAGGREGATION_DOCUMENT
Трансформация агрегата
JSON
REAGGREGATION_DOCUMENT_XML
Трансформация агрегата
XML
REAGGREGATION_DOCUMENT_CSV
Трансформация агрегата
CSV
LP_INTRODUCE_GOODS
Ввод в оборот. Производство РФ
JSON
LP_INTRODUCE_GOODS_CSV
Ввод в оборот. Производство РФ
CSV
LP_INTRODUCE_GOODS_XML
Ввод в оборот. Производство РФ
XML
LP_SHIP_GOODS
Отгрузка
JSON
LP_SHIP_GOODS_CSV
Отгрузка
CSV
LP_SHIP_GOODS_XML
Отгрузка
XML
LP_SHIP_RECEIPT
Отгрузка с выводом из оборота
JSON
LP_SHIP_RECEIPT_CSV
Отгрузка с выводом из оборота
CSV
LP_SHIP_RECEIPT_XML
Отгрузка с выводом из оборота
XML
LP_SHIP_GOODS_CROSSBORDER
Отгрузка при трансграничной торговле
JSON
EAS_GTIN_CROSSBORDER_EXPORT
Отгрузка в государствах-членах ЕАЭС с
JSON
признанием КИ при объёмно-сортовом
учёте (экспорт)
EAS_GTIN_CROSSBORDER_EXPORT_C
Отгрузка в государствах-членах ЕАЭС с
CSV
SV
признанием КИ при объёмно-сортовом
учёте (экспорт)
EAS_GTIN_CROSSBORDER_IMPORT
Отгрузка из государств-членов ЕАЭС с
JSON
признанием КИ при объёмно-сортовом
учёте (импорт)
EAS_CROSSBORDER
Отгрузка из ЕАЭС с признанием КИ
JSON
LP_ACCEPT_GOODS
Приёмка
JSON
LP_ACCEPT_GOODS_CSV
Приёмка
CSV
LP_ACCEPT_GOODS_XML
Приёмка
XML
LP_ACCEPT_GOODS_CSV
Приёмка
CSV
EAS_GTIN_CROSSBORDER_ACCEPTAN
Приёмка отгрузки из государств-членов
JSON
CE
ЕАЭС с признанием КИ при объёмно-
сортовом учёте
EAS_GTIN_CROSSBORDER_ACCEPTAN
Приёмка отгрузки из государств-членов
CSV
CE_CSV
ЕАЭС с признанием КИ при объёмно-
сортовом учёте
LK_REMARK
Перемаркировка
JSON
LK_REMARK_CSV
Перемаркировка
CSV
LK_REMARK_XML
Перемаркировка
XML
428
Код
Наименование
Формат
LP_GOODS_IMPORT
Ввод в оборот. Производство вне ЕАЭС
JSON
LP_GOODS_IMPORT_CSV
Ввод в оборот. Производство вне ЕАЭС
CSV
LP_GOODS_IMPORT_XML
Ввод в оборот. Производство вне ЕАЭС
XML
LP_CANCEL_SHIPMENT
Отмена отгрузки
JSON
LP_CANCEL_SHIPMENT_CROSSBORDE
Отмена отгрузки при трансграничной
JSON
R
торговле
LK_KM_CANCELLATION
Списание не нанесённых КИ
JSON
LK_KM_CANCELLATION_XML
Списание не нанесённых КИ
XML
LK_KM_CANCELLATION_CSV
Списание не нанесённых КИ
CSV
LK_APPLIED_KM_CANCELLATION
Списание нанесённых КИ
JSON
LK_APPLIED_KM_CANCELLATION_X
Списание нанесённых КИ
XML
ML
LK_APPLIED_KM_CANCELLATION_CS
Списание нанесённых КИ
CSV
V
LK_CONTRACT_COMMISSIONING
Ввод в оборот товара. Контрактное
JSON
производство РФ
LK_CONTRACT_COMMISSIONING_CS
Ввод в оборот товара. Контрактное
CSV
V
производство РФ
LK_CONTRACT_COMMISSIONING_XM
Ввод в оборот товара. Контрактное
XML
L
производство РФ
LK_INDI_COMMISSIONING
Ввод в оборот товара. Полученных от
JSON
физических лиц
LK_INDI_COMMISSIONING_CSV
Ввод в оборот товара. Полученных от
CSV
физических лиц
LK_INDI_COMMISSIONING_XML
Ввод в оборот товара. Полученных от
XML
физических лиц
LP_RETURN
Возврат в оборот
JSON
LP_RETURN_CSV
Возврат в оборот
CSV
LP_RETURN_XML
Возврат в оборот
XML
OST_DESCRIPTION
Описание остатков товара
JSON
OST_DESCRIPTION_CSV
Описание остатков товара
CSV
OST_DESCRIPTION_XML
Описание остатков товара
XML
LP_INTRODUCE_OST
Ввод в оборот. Маркировка остатков
JSON
LP_INTRODUCE_OST_CSV
Ввод в оборот. Маркировка остатков
CSV
LP_INTRODUCE_OST_XML
Ввод в оборот. Маркировка остатков
XML
CROSSBORDER
Ввод в оборот. Трансграничная торговля
JSON
429
Код
Наименование
Формат
CROSSBORDER_CSV
Ввод в оборот. Трансграничная торговля
CSV
CROSSBORDER_XML
Ввод в оборот. Трансграничная торговля
XML
LK_RECEIPT
Вывод из оборота
JSON
LK_RECEIPT_CSV
Вывод из оборота
CSV
LK_RECEIPT_XML
Вывод из оборота
XML
LP_INTRODUCE_GOODS_CROSSBORD
Ввод в оборот. На территории стран ЕАЭС
JSON
ER_CSD
(контрактное производство)
LP_INTRODUCE_GOODS_CROSSBORD
Ввод в оборот. На территории стран ЕАЭС
XML
ER_CSD_XML
(контрактное производство)
LP_INTRODUCE_GOODS_CROSSBORD
Ввод в оборот. На территории стран ЕАЭС
CSV
ER_CSD_CSV
(контрактное производство)
LP_FTS_INTRODUCE
Ввод в оборот. Импорт с ФТС
JSON
LP_FTS_INTRODUCE_XML
Ввод в оборот. Импорт с ФТС
XML
LP_FTS_INTRODUCE_CSV
Ввод в оборот. Импорт с ФТС
CSV
LP_FTS_INTRODUCE_RESPONSE
Декларация на товары
JSON
ATK_AGGREGATION
Формирование АТК
JSON
ATK_AGGREGATION_CSV
Формирование АТК
CSV
ATK_AGGREGATION_XML
Формирование АТК
XML
ATK_TRANSFORMATION
Трансформация АТК
JSON
ATK_TRANSFORMATION_CSV
Трансформация АТК
CSV
ATK_TRANSFORMATION_XML
Трансформация АТК
XML
ATK_DISAGGREGATION
Расформирование АТК
JSON
ATK_DISAGGREGATION_CSV
Расформирование АТК
CSV
ATK_DISAGGREGATION_XML
Расформирование АТК
XML
RECEIPT
Чек
Формир
уется
операто
ром
фискаль
ных
данных
RECEIPT_RETURN
Чек возврата
Формир
уется
операто
ром
фискаль
ных
данных
430
Код
Наименование
Формат
AGGREGATION_DOCUMENT
Документ агрегации (для товарных групп
JSON
"Табачная продукция" и "АТП")
AGGREGATION_DOCUMENT
Документ агрегации (для товарных групп
XML
"Табачная продукция" и "АТП")
WRITE_OFF
Документ списания (для товарных групп
JSON
"Табачная продукция" и "АТП")
WRITE_OFF
Документ списания (для товарных групп
XML
"Табачная продукция" и "АТП")
EAS_CROSSBORDER_EXPORT
Отгрузка в ЕАЭС с признанием КИ
JSON
(экспорт)
EAS_CROSSBORDER_EXPORT_CSV
Отгрузка в ЕАЭС с признанием КИ
CSV
(экспорт)
EAS_CROSSBORDER_EXPORT_ACCEP
Приёмка отгрузки в ЕАЭС с признанием
JSON
TANCE
КИ (экспорт)
Для создания универсальных документов необходимо использовать Описание API ЭДО Lite.
Документы поступают от коммерческого ЭДО.
Наименование универсального документа
Код
УПД ДОП (накладная)
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_FI
накладной)
X
УКД(и) КСЧФ (исправление корректировочной
UNIVERSAL_CORRECTION_DOCUMENT_FI
счет-фактуры)
X
УКД(и) КСЧФ ДИС
UNIVERSAL_CORRECTION_DOCUMENT_FI
X
Универсальный документ отмены
UNIVERSAL_CANCEL_DOCUMENT
Справочник "Статусы проверок УПД"
Код
Наименование
431
VERIFI
Успешно проверен
ED
NOT_V
Ошибка проверок
ALID
NOT_F
Не найден
OUND
IN_PRO
В обработке
GRESS
AWAITI
В ожидании
NG
Справочник "Типы договоров"
Код в
Наименование
БД
-2
Договор о подключении к ГИС МТ
-3
Договор по предоставлению РЭ
-4
Договор на услуги по предоставлению КИ
-5
Договор по предоставлению РВ
-6
Договор ЭДО
-7
Договор безвозмездного пользования движимым имуществом
-8
Договор по предоставлению РЭ УОТ путем УД
-9
Заявка Участника о предоставлении Оборудования РВ
-10
Заявка Участника о предоставлении Оборудования РЭ
-11
Заявка УОТ о предоставлении РЭ путем УД
-12
Акт приема-передачи Оборудования
-13
Акт возврата Оборудования
-14
Акт проверки состояния и условий эксплуатации Оборудования
-15
Акт выполненных работ
-16
Уведомление о предоставлении Участнику права пользования Оборудованием путем
предоставления УД
-17
Дополнительное соглашение
-18
Дополнительное соглашение (нерезидент)
-19
Соглашение об электронном взаимодействии
-20
Письмо об осуществлении оплаты третьей стороной
-21
Договор на оказание возмездных услуг по предоставлению КИ (с нерезидентом)
-22
Договор по предоставлению РЭ (с нерезидентом)
432
-23
Договор по предоставлению РЭ УОТ путем УД (с нерезидентом)
-24
Информационное письмо
-25
Уведомление от Оператора
-26
Заявка Участника о предоставлении Оборудования РЭ (нерезидент)
-27
Заявка Участника о предоставлении РЭ путем УД (нерезидент)
-28
Уведомление Участника о передаче РВ
-29
Акт о невозможности исполнения обязательств
-100
Счет на оплату
-10000
Акт сверки
Справочник "Типы эмиссии КИ"
Код
Описание
LOCAL
Производство РФ
FOREIGN
Ввезён в РФ
REMAINS
Маркировка остатков;
CROSSBORDER
Ввезён из стран ЕАЭС
REMARK
Перемаркировка
COMMISSION
Принят на комиссию от физического лица
Справочник "Статусы КИ"
Актуальные статусы
Код
Описание
EMITTED
Эмитирован. Выпущен
APPLIED
Эмитирован. Получен
INTRODUCED
В обороте
WRITTEN_OFF
Списан
RETIRED
Выбыл
WITHDRAWN
Выбыл (только для ТГ "Табачная продукция" и "Альтернативная табачная
продукция")
INTRODUCED_R
Возвращён в оборот (только для ТГ "Табачная продукция" и
ETURNED
"Альтернативная табачная продукция")
DISAGGREGATI
Расформирован (только для КИТУ, АТК и набора всех ТГ, кроме "Табачная
ON
продукция" и "Альтернативная табачная продукция")
DISAGGREGATE
Расформирован (только для КИТУ и АТК ТГ "Табачная продукция" и
D
"Альтернативная табачная продукция")
433
Актуальные особые состояния
Код
Описание
Актуальный
статус
EMPTY
Значение отсутствует
RESERVED_NOT_USED
Зарезервировано. Не использовать
INTRODUCED
INDIVIDUAL
КиЗ индивидуализирован (только для ТГ
EMITTED,
"Товары из натурального меха")
APPLIED
NON_INDIVIDUAL
КиЗ не индивидуализирован (только для ТГ
EMITTED,
"Товары из натурального меха")
APPLIED
WAIT_SHIPMENT
Ожидает подтверждения приёмки
INTRODUCED
EXPORTED
Используется для документов экспорта
LOAN_RETIRED
Выведен из оборота по договору рассрочки
RETIRED
REMARK_RETIRED
Выведен из оборота при перемаркировке
WRITTEN-OFF
WAIT_TRANSFER_TO_O
Ожидает передачу собственнику (контрактное
INTRODUCED
WNER
производство)
WAIT_REMARK
Товар ожидает перемаркировку или КИ списан
WRITTEN_OFF
после нанесения на товар
RETIRED_CANCELLATIO
Списание
WRITTEN_OFF
N
RETIRED_DONATION
Безвозмездная передача, применяется в
RETIRED
документе "Отгрузка"
RETIRED_STATE_ENTER
Приобретение государственным предприятием,
RETIRED
PRISE
применяется в документе "Отгрузка"
RETIRED_NO_RETAIL_US
Использование для собственных нужд
RETIRED
E
покупателем, применяется в документе
"Отгрузка"
RETIRED_BEYOND_EEC_
Экспорт за пределы стран ЕАЭС, применяется
RETIRED
EXPORT
в документе Вывод из оборота
RETIRED_REMOTE_SALE
Продажа по образцам, дистанционный способ
RETIRED
продажи, применяется в документе "Вывод из
оборота"
RETIRED_EEC_EXPORT
Экспорт в страны ЕАЭС, применяется в
RETIRED
документе "Вывод из оборота"
RETIRED_RETURN
Возврат физическому лицу, применяется в
RETIRED
документе "Вывод из оборота"
RETIRED_DAMAGE_LOSS
Утрата или повреждение, применяется в
RETIRED
документе "Вывод из оборота"
RETIRED_DESTRUCTION
Уничтожение, применяется в документе
RETIRED
"Вывод из оборота"
434
Код
Описание
Актуальный
статус
RETIRED_CONFISCATION
Конфискация, применяется в документе
RETIRED
"Вывод из оборота"
RETIRED_LIQUIDATION
Ликвидация предприятия, применяется в
RETIRED
документе "Вывод из оборота"
RETIRED_ENTERPRISE_U
Использование для собственных нужд
RETIRED
SE
FTS_RESPOND_NOT_OK
Отрицательное решение ФТС
APPLIED
FTS_RESPOND_WAITING
Ожидает подтверждение ФТС
APPLIED
FTS_CONTROL
На контроле ФТС
APPLIED
IN_GRAY_ZONE
Находится в Серой зоне
APPLIED
Справочник "Типы производства"
Код
Описание
LOCAL
Производство РФ
FOREIGN
Ввезен в РФ
Справочник "Типы упаковки"
Код
Описание
Ограничение
Примечание для
Примечание для
использования в
товарных групп
прочих
зависимости от товарной
"Альтернативна
товарных групп
группы
я табачная
продукция",
"Никотиносодер
жащая
продукция",
"Табачная
продукция"
UNIT
Единица товара
Пачка
Потребительская
упаковка
GROUP
Групповая
Используется только для
упаковка
товарных групп "Молочная
продукция", "Упакованная
вода"
LEVEL1
Упаковка 1-го
Блок
уровня
LEVEL2
Упаковка 2-го
Коробка
Транспортная
уровня
упаковка (SSCC)
LEVEL3
Упаковка 3-го
Паллета
уровня
435
Код
Описание
Ограничение
Примечание для
Примечание для
использования в
товарных групп
прочих
зависимости от товарной
"Альтернативна
товарных групп
группы
я табачная
продукция",
"Никотиносодер
жащая
продукция",
"Табачная
продукция"
LEVEL4
Упаковка 4-го
уровня
LEVEL5
Упаковка 5-го
уровня
BUNDL
Комплект
Используется только для
E
товарных групп "Духи и
туалетная вода", "Предметы
одежды, бельё постельное,
столовое, туалетное и
кухонное", "Фотокамеры
(кроме кинокамер),
фотовспышки и лампы-
вспышки"
АТК
Агрегированный
Вложенность
таможенный код
типов КИ зависит
от товарной
группы
SET
Набор
Используется только для
товарных групп "Духи и
туалетная вода", "Молочная
продукция", "Предметы
одежды, бельё постельное,
столовое, туалетное и
кухонное", "Фотокамеры
(кроме кинокамер),
фотовспышки и лампы-
вспышки"
Справочник "Статусы заказов"
Код
Описание
NEW
Зарегистрирован
PRODUCTION
Производство
VALIDATION_FAILED
Ошибка в проверке
IN PROGRESS
Заказ в процессе выполнения
SUCCESS
Заказ выполнен
436
Код
Описание
ERROR
При выполнении заказа возникла ошибка
RESULT_EXPIRED
Заказ устарел
Справочник "Статусы документов"
Код
Описание
Комментарий
IN_PROGRESS
Проверяется
CHECKED_OK
Обработан
CHECKED_NOT_
Обработан с
OK
ошибками
PROCESSING_ER
Техническая
ROR
ошибка
ACCEPTED
Принят
Только для документа "Отгрузка"
CANCELLED
Аннулирован
Только для документа "Отгрузка" и документов ЭДО
WAIT_ACCEPTA
Ожидает приёмку
Только для документа "Отгрузка". Устанавливается при
NCE
успешной обработке документа "Отгрузка"
PARSE_ERROR
Обработан с
ошибками
WAIT_PARTICIP
Ожидает
Только для документа "Отгрузка". Устанавливается при
ANT_REGISTRA
регистрации
успешной обработке документа "Отгрузка товара" в
TION
участника в ГИС
сторону незарегистрированного участника
МТ
WAIT_FOR_CON
Ожидает
TINUATION
продолжения
обработки
документа
Справочник "Причины вывода из оборота"
Код
Описание
RETAIL
Розничная реализация
DAMAGE_LOSS
Утрата
DEFECT
Повреждение / брак
DESTRUCTION
Утилизация или уничтожение
LIQUIDATION
Ликвидация
CONFISCATION
Конфискация
ENTERPRISE_USE
Использование для собственных нужд
DEMO_SAMPLES
Демонстрационные образцы
437
Код
Описание
EXPIRY
Истечение срока
QA_SAMPLES
Лабораторные образцы
PRODUCT_TESTING
Тестовые образцы
PRODUCT_RECALL
Отзыв с рынка
COMPLAINTS
Рекламации
EEC_EXPORT
Экспорт в страны ЕАЭС
BEYOND_EEC_EXPORT
Экспорт за пределы стран ЕАЭС
RETURN
Возврат физическому лицу (значение не используется для
товарной группы "Молочная продукция")
REMOTE_SALE
Продажа по образцам, дистанционный способ продажи
DAMAGE_LOSS
Утрата или повреждение
STATE_SECRET
Продажа по сделке, составляющей гос. тайну
OTHER
Другое
Справочник "Статусы ответов"
Код в
Наименование
Описание
Формат сообщения об ошибке
БД
200
ОК
Статус ответа в случае
-
успеха
201
CREATED
Статус ответа в случае
успеха
202
ACCEPTED
Статус ответа в случае
успеха
438
Код в
Наименование
Описание
Формат сообщения об ошибке
БД
400
ERROR
Ошибка в параметрах
1 Для НК-методов:
Bad Request
запроса (отсутствует
1.1. При отсутствии параметра apikey
обязательный параметр)
или feed:
{ "error_message": "Отсутствует
обязательный
параметр:
<имя
обязательного параметра>" }
1.2. При отсутствии остальных
параметров:
{ "error_message": "Ошибка в
параметрах запроса" }
2 Для всех методов, кроме НК:
{ "error_message": "Отсутствует
обязательный
параметр:
<имя
обязательного параметра>" }
Ошибка в параметрах
1 Для НК-методов:
запроса (неверный тип
параметра)
{ "error_message": "Ошибка в
параметрах запроса" }
2 Для всех методов, кроме НК:
{ "error_message": "Параметр <имя
параметра> требует значение типа
<требуемый тип параметра>" }
401
ERROR
Ошибка авторизации
1 Для всех методов, требующих
токен, кроме НК-методов:
{
"error_message":"
1.1. Указан устаревший токен:
Для доступа к
<InvalidTokenException>
этому
ресурсу
требуется полная
<error>invalid_token</error>
аутентификация"
<error_description>Access
token
expired: <токен></error_description>
}
</InvalidTokenException>
1.2. Не указан токен:
<UnauthorizedException>
<error>unauthorized</error>
<error_description>Full authentication
is
required
to
access
this
resource</error_description>
</UnauthorizedException>
439
Код в
Наименование
Описание
Формат сообщения об ошибке
БД
402
ERROR
Ошибка в атрибутивном
составе тела запроса
403
ERROR
Доступ запрещён
1 Для всех методов, кроме НК:
Forbidden
1.1. Если пользователь (УОТ) не
имеет доступа к конкретному
удаленному сервису:
{ "error_message": "Отсутствует
доступ к ресурсу" }
2 Для всех НК-методов:
2.1. Если указан неправильный ключ
API
{ "error_message": "Отсутствует
доступ к ресурсу" }
404
ERROR
Запрашиваемая
1 Для всех НК-методов:
Not Found
информация не найдена в
ГИС МТ
{ "error_message": Данные не
найдены> не найден"
}
2 Для всех методов, кроме НК:
{
"error_message":
"<Описание
параметра> не найден" }
Ошибка в указании URL
{
"error_message":
"Метод
с
метода
указанным URL не найден" }
409
ERROR
Запрос не может быть
выполнен из-за
конфликтного обращения к
ресурсу
410
ERROR
Ресурс ранее был доступен
по указанному URL, но
сейчас он удалён и
недоступен
414
ERROR
Превышен допустимый
{ "error_message": "Слишком
размер тела запросаa
большой запрос" }
422
ERROR
Ошибка проверки подписи
{ "error_message": "Ошибка проверки
подписи" }
440
Код в
Наименование
Описание
Формат сообщения об ошибке
БД
500
ERROR
Внутренняя ошибка
{ "error_message": "Ошибка при
Internal
server
удалённых систем
выполнении запроса" }
Error
(технически
детализированное описание
не возвращается)
502
ERROR
Сервер временно
Bad gateway
недоступен или
Nginx
заблокирован
503
ERROR
Проблема с доступом к
{
"error_message":
"Удаленная
Service
удалённой системе
система недоступна" }
Unavailable
504
ERROR
Ошибка при получении
{ error_message: "Отсутствует ответ
ответа системы
системы" }
Справочник "Типы организаций"
Код в БД
Код
Описание
1
TRADE_PARTICIPANT
Участник оборота товаров
2
PRODUCER
Производитель товара
3
IMPORTER
Импортер товара
4
WHOLESALER
Оптовая торговля
5
RETAIL
Розничная торговля
6
IS_MP_OPERATOR
Оператор ГИС МТ
8
OGV
Орган государственной власти
9
EMITENT
Эмитент
Справочник "Статусы УОТ"
Код
Описание
REGISTERED
Зарегистрирован
NOT_REGISTERED
Не зарегистрирован
REMOVED
Удален
RESTORED
Восстановлен
BLOCKED
Заблокирован
Справочник "Статусы заявки на регистрацию УОТ"
441
№
Код
Описание
1
IN_PROGRESS
На рассмотрении (проверяется)
2
CHECKED_OK
Оформлен
3
REGISTERED
Документ зарегистрирован (принят системой)
4
CHECKED_NOT_
Ошибка
OK
5
PROSECCING_E
Ошибка при обработке
RROR
6
UNDEFINED
Не определен
Справочник "Статусы документа в жизненном цикле SD"
Код в БД
Описание
10
Новый
20
Согласование
40
Подписание
50
Активация
60
Активен
100
Недействителен
Справочник "Статусная модель"
Для каждого статуса указано, к каким типам документов он применим:
Код в БД
Статусы
Статусы входящих документов
исходящих
документов
0
Черновик
-
11
Ожидается
-
отправка
1
Отправлен
-
2
Доставлен
Подпись не требуется
(подпись не
требуется)
12
Просмотрен
Подпись не требуется (документ просмотрен)
(подпись не
требуется)
3
Доставлен
Требуется подпись
(ожидается
подпись)
442
Код в БД
Статусы
Статусы входящих документов
исходящих
документов
13
Просмотрен
Требуется подпись (документ просмотрен)
(ожидается
подпись)
4
Подписан
Подписан
5
Отклонен
Отклонен
15
Отклонен (запрос
Отклонен (запрос просмотрен)
просмотрен)
6
Отозван
Отозван
16
Запрошено
Ожидается аннулирование
аннулирование
17
Ожидается
Запрошено аннулирование
аннулирование
18
Аннулирован
Аннулирован
19
В аннулировании
В аннулировании отказано
отказано
7
Уточнён
Уточнён
8
Требуется
Ожидается уточнение
уточнение
14
Требуется
Запрос на уточнение просмотрен (ожидается уточнение)
уточнение (запрос
на уточнение
просмотрен)
9
Ошибка в
Ошибка в подписи
подписи
10
Ошибка доставки
Ошибка доставки
Справочник "Дополнительные параметры в ответе в
зависимости от товарных групп"
Дополнительные параметры возвращаются в ответе при условии указания сведений в карточке
описания товара в НК.
Дополнительные параметры для ТГ "Альтернативная табачная продукция" и
"Табачная продукция"
Параметр
Описание
Примечание
tobaсcoType
Тип табачного
продукта
okpd2Group
Код ОКПД2
443
Параметр
Описание
Примечание
okpd2Code
Код ОКПД2
Опционально
exciseProduct
Акцизный товар
exciseProductCode
Код подакцизного
товара (СКПТ)
quantityInPack
Единица
измерения по
атрибуту
"Количество
единиц
употребления в
потребительской
упаковке" (только
"АТП")
weight
Заявленный вес
(АТП)
rawTobaccoWeight
Масса табачного
сырья (только
"АТП")
Дополнительные параметры для ТГ "Обувные товары"
Параметр
Описание
Примечание
productType
Вид обуви
productTypeDesc
Вид обуви
productSize
Размер в
штихмассовой
системе
color
Цвет изделия
materialUpper
Материал верха
materialLining
Материал
подкладки
materialDown
Материал низа /
подошвы
country
Страна
производства
color
Цвет
size
Размер
sizes
Размер
Массив уникальных значений размера в штихмассовой
системе (значения, указанные в НК и полученные из
ГИС МТ)
444
Параметр
Описание
Примечание
model
Модель/артикул
производителя
Дополнительные параметры для ТГ "Предметы одежды, бельё постельное,
столовое, туалетное и кухонное"
Параметр
Описание
Примечание
type
Тип изделия
size
Размер одежды
color
Цвет
textileType
Тип текстиля
structure
Состав
consumerAge
Возраст
потребителя
gender
Целевой пол
country
Страна
производства
structure
Состав изделия
standardNumber
Номер регламента
или стандарта
productKind
Вид товара
productAreaSize
Размер изделия
model
Модель/артикул
производителя
Дополнительные параметры для ТГ "Фотокамеры (кроме кинокамер),
фотовспышки и лампы-вспышки"
Параметр
Описание
Примечание
type
Вид товара
standardNumber
Номер регламента
/ стандарта
country
Страна
производства
standardNumber
Номер регламента
или стандарта
productKind
Вид товара
model
Модель/артикул
производителя
445
Дополнительные параметры для ТГ "Велосипеды и велосипедные рамы"
Параметр
Описание
Примечание
productKind
Вид товара
productionYear
Год производства
engineType
Тип двигателя
enginePower
Мощность
двигателя
electricEnginePow
Мощность
er
электродвигателя,
Вт
frameSize
Размер рамы
weightGross
Конструктивная
масса, кг
frameMaterial
Материал рамы
rimDiameter
Номинальный
посадочный
диаметр обода,
дюйм
sectionWidth
Ширина профиля
шины (камеры),
дюйм
brakeSystemType
Тип тормозной
системы
frontForkType
Тип передней
вилки
country
Страна
производства
rimDiameter
Номинальный
посадочный
диаметр обода,
дюйм
gearType
Тип привода в
движение
codeTSR
Код ТСР
Дополнительные параметры для ТГ "Кресла-коляски"
Параметр
Описание
Примечание
productKind
Вид товара
weightGross
Конструктивная
масса, кг
446
Параметр
Описание
Примечание
maximumLoad
Максимальная
нагрузка, кг
seatDepth
Глубина сиденья
seatWidth
Ширина сиденья
seatHeight
Высота сиденья
backHeight
Высота спинки
country
Страна
производства
productKind
Вид товара
gearType
Тип привода в
движение
codeTSR
Код ТСР
model
Модель/артикул
производителя
weightMaxUnequi
Максимальная
pped
масса изделия без
дополнительного
оснащения, не
более
Дополнительные параметры для ТГ "Духи и туалетная вода"
Параметр
Описание
Примечание
perfumeryType
Тип парфюмерии
volume
Заявленный
объём
packMaterial
Материал
упаковки
country
Страна
производства
standardNumber
Номер регламента
или стандарта
packMaterial
Материал
упаковки
quantityInPack
Единица
измерения по
атрибуту
"Заявленный
объём"
447
Дополнительные параметры для ТГ "Шины и покрышки пневматические
резиновые новые"
Параметр
Описание
Примечание
tireSectionWidth
Ширина профиля
шины (камеры),
мм/дюйм
heightWidthRatio
Номинальное
отношение
высоты профиля
шины к его
ширине, %
frameConstruction
Тип конструкции
Type
каркаса шины
tireLoadIndex
Индекс нагрузки
на шину
speedCategory
Категория
скорости
seasonality
Сезонность
frameSealingType
Тип шины по
способу
герметизации
rimDiameter
Посадочный
диаметр обода,
дюйм
sectionWidth
Ширина профиля,
мм/дюйм
model
Модель/артикул
производителя
Дополнительные параметры для ТГ "Молочная продукция"
Параметр
Описание
Примечание
milkProductType
Тип продукта
rawOrigin
Происхождение
сырья
fat
Жирность, %
volume
Заявленный
объём
volumeWeight
Заявленный
объём / вес нетто
448
Параметр
Описание
Примечание
vetisId
Идентификатор
товара в ФГИС
ВетИС
babyFoodProduct
Продукция для
детского питания
structure
Состав
packMaterial
Материал
упаковки
veterinaryControl
Подлежит
ветеринарному
контролю
(надзору)
isShelfLife40Days
Срок хранения до
40 суток
(включительно)
isSpecializedFoodP
Специализирован
roduct
ная пищевая
продукция
compositionOption
Вариант состава
declNumber
Номер
декларации о
соответствии
regNumber
Номер
свидетельства о
государственной
регистрации
certNumber
Номер
сертификата
соответствия
paymentGroup
Группа платности
в соответствии с
кодом ТН ВЭД
Дополнительные параметры для ТГ "Упакованная вода"
Параметр
Описание
Примечание
productType
Тип продукта
structure
Состав
packMaterial
Материал
упаковки
volume
Заявленный
объём
449
Параметр
Описание
Примечание
babyFoodProduct
Продукция для
детского питания
mineralization
Общая
минерализация
carbonationMethod
Метод
газирования
goodOriginPlace
Наименование
места
происхождения
товара
Дополнительные параметры для ТГ "Товары из натурального меха"
Параметр
Описание
Примечание
isCombinedProduc
Комбинированное
t
меховое изделие
furType
Тип меха
otherFurType
Остальные виды
меха
isDyedFur
Является ди мех
крашеным
size
Размер изделия из
натурального
меха
color
Цвет
Дополнительные параметры для ТГ "Пиво, напитки, изготавливаемые на основе
пива, слабоалкогольные напитки"
Параметр
Описание
Примечание
massСoncentrationSuga
Массовая концентрация сахаров
rs
isPasteurized
Является ли пастеризованным
filtrationType
Тип фильтрации
volumeFractionEthylAlc
Объёмная доля этилового спирта
ohol
alcoholicProductTypeC
Код вида алкогольной продукции
ode
consumerPackageVolu
Объём продукции в единице упаковки
me
shelfLife
Срок годности, дней
450
Параметр
Описание
Примечание
implementationPeriod
Срок реализации, дней
frap
Код ФРАП
Дополнительные параметры для ТГ "Антисептики и дезинфицирующие средства"
Параметр
Описание
Примечание
productPurpose
Назначение
товара
form
Форма /
состояние /
формат
Примеры аутентификации по УКЭП /
Подписание документов
Пример получения токена при авторизации с
прикрепленной подписью / подписание документов с
открепленной подписью на 1С
// sThumbprint - отпечаток сертификата, используемого для подписи; строка,
// представляющая отпечаток в шестнадцатеричном виде
// пример 195934d72dcdf69149901d6632aca4562d8806d8
// ТекстДляПодписи должен быть в Base64
// bDetached - Истина/Ложь - откреплённая(для подписания документов)/прикреплённая(для
получения токена авторизации) подпись
Функция ПодписатьТекст(ТекстДляПодписи, sThumbprint, bDetached)
CADESCOM_BASE64_TO_BINARY = 1; // Входные данные пришли в Base64
CADESCOM_CADES_TYPE = 1; // Тип усовершенствованной подписи
CAPICOM_AUTHENTICATED_ATTRIBUTE_SIGNING_TIME = 0; // Атрибут штампа времени подписи
oSigner = Новый COMОбъект("CAdESCOM.CPSigner");
// Объект, задающий параметры создания и содержащий информацию об усовершенствованной
подписи.
oSigner.Certificate = ПолучитьСертификатПоОтпечатку(sThumbprint);
oSigningTimeAttr = Новый COMОбъект("CAdESCOM.CPAttribute");
oSigningTimeAttr.Name = CAPICOM_AUTHENTICATED_ATTRIBUTE_SIGNING_TIME;
oSigningTimeAttr.Value = ТекущаяДата();
oSigner.AuthenticatedAttributes2.Add(oSigningTimeAttr);
ТекстДляПодписи = СокрЛП(ТекстДляПодписи);
oSignedData = Новый COMОбъект("CAdESCOM.CadesSignedData");
// Объект CadesSignedData предоставляет свойства и методы для работы с
451
усовершенствованной подписью.
oSignedData.ContentEncoding = CADESCOM_BASE64_TO_BINARY;
SignedData.Content = СокрЛП(ТекстДляПодписи);
EncodingType = 0;
sSignedMessage = oSignedData.SignCades(oSigner, CADESCOM_CADES_TYPE, bDetached,
EncodingType);
// Метод добавляет к сообщению усовершенствованную подпись.
Возврат sSignedMessage; // Подпись в формате Base64
КонецФункции
//Отпечаток - строка HEX
Функция ПолучитьСертификатПоОтпечатку(ОтпечатокСтр)
Рез = Неопределено; // Найденный сертификат (Com-объект)
CAPICOM_CURRENT_USER_STORE = 2;
//2 - Искать сертификат в ветке "Личное" хранилища.
CAPICOM_MY_STORE = "My";
// Указываем, что ветку "Личное" берем из хранилища текущего пользователя
CAPICOM_STORE_OPEN_READ_ONLY = 0; // Открыть хранилище только на чтение
oStore = Новый COMОбъект("CAdESCOM.Store"); // Объект описывает хранилище сертификатов
oStore.Open(CAPICOM_CURRENT_USER_STORE, CAPICOM_MY_STORE,
CAPICOM_STORE_OPEN_READ_ONLY); // Открыть хранилище сертификатов
// 1 вариант: поиск сертификата по отпечатку
CAPICOM_CERTIFICATE_FIND_SHA1_HASH = 0;
Certificates = oStore.Certificates.Find(CAPICOM_CERTIFICATE_FIND_SHA1_HASH,
ОтпечатокСтр);
Рез = Certificates.Item(1);
//2 вариант: обходом по коллекции и сравнение с отпечатком
//Для Каждого ТекСертификат Из oStore.Certificates Цикл
//ТекОтпечаток = ТекСертификат.Thumbprint; // возвращается отпечаток в
шестнадцатеричном виде
//Если ВРЕГ(ТекОтпечаток) = ВРЕГ(ОтпечатокСтр) Тогда //Рез = ТекСертификат;
//Прервать;
//КонецЕсли;
//КонецЦикла;
oStore.Close(); // Закрыть хранилище сертификатов и освободить объект 61
Возврат Рез;
КонецФункции
Пример получения токена при авторизации REACT JS
452
import { CadesPluginer as anyName } from "@crpt/cades-pluginer"; //or
import CadesPluginer from "@crpt/cades-pluginer";
//usually you will need 2 methods
CadesPluginer.getFinalCertsArray().then(certs => {
console.log("certs", certs);
CadesPluginer.signMessage("lalala", certs[0].certificate).then(signed =>
console.log("signed", signed);
);
});
Пример получения токена при авторизации с помощью
прикрепленной подписи / подписание документов с
помощью открепленной подписи на Java
453
String data = ...//получение кода для авторизации
boolean detached = false;
// false - прикреплённая(для получения токена авторизации) подпись
// true - откреплённая(для подписания документов) подпись
//Формирование подписи
KeyStore keyStore = loadKeyStore();//инициализация хранилища ключей
List<X509CertificateHolder> chain = new ArrayList<>();
List<Certificate> certs = Arrays.asList(keyStore.getCertificateChain(alias));
certs.forEach(cert -> {
try {
chain.add(new X509CertificateHolder(cert.getEncoded()));
} catch (IOException | CertificateEncodingException e) {
log.error("Error while building certificate chain", e);
}
});
PrivateKey privateKey = (PrivateKey) (keyStore.getKey(alias, password));
ByteArrayOutputStream out = new ByteArrayOutputStream();
CAdESSignature signature = new CAdESSignature(detached);
signature.setCertificateStore(new CollectionStore(chain));
final Hashtable table = new Hashtable();
Attribute attr = new Attribute(CMSAttributes.signingTime,
new DERSet(new Time(new Date()))); // устанавливаем время подписи
table.put(attr.getAttrType(), attr);
AttributeTable attrTable = new AttributeTable(table);
//Добавление подписанта. Алгоритмы могут отличаться в зависимости от требований
signature.addSigner(JCP.PROVIDER_NAME,
JCP.GOST_DIGEST_OID,
JCP.GOST_EL_DH_OID,
privateKey,
certs,
CAdESType.CAdES_BES,
null,
false,
attrTable,
null);
signature.open(out);
signature.update(data);
signature.close();
byte[] signedCode = out.toByteArray();
//Использовать подписанный код для получение токена / сформированную открепленную
подпись УКЭП документа вместе с самим документом
Описание методов плагина
454
Метод
Описание
getFinalCertsArray(): Promise<Cert[]>
Init plugin, create store, . Cert: \{certificate: \{},
info: [] }, certificate is an original cadesplugin
Certificate object, info is an array [name,
date_from, date_to, serial_number].
signMessage(message, cert, detached): Promise
Sign message with selected certificate
455
|