Описание API ГИС МТ (Версия 140.0)

"withdrawReason": "KM_SPOILED",

"packType": "UNIT",

"children": [

{

"cis": "string",

"gtin": "string",

"producerName": "string",

"status": "EMITTED",

"emissionDate": 0,

"emissionType": "string",

"producedDate": 0,

"packageType": "UNIT",

"ownerName": "string",

"ownerInn": "string",

"productName": "string",

"brand": "string",

"prevCises": [

"string"

"nextCises": [

"string"

"statusEx": "EMPTY",

"children": [

"string"

"childrenMap": {},

"countChildren": 0,

"parent": "string",

"lastDocId": "string",

"expireDate": 0,

"prVetDocument": "string",

"introducedDate": 0,

"exporterName": "string",

"exporterTaxpayerId": "string",

"agentName": "string",

"agentInn": "string",

"lastStatusChangeDate": 0,

"turnoverType": "SELLING",

"productGroup": "string",

"tnVed10": "string",

"veterinaryControl": true,

"markWithdraw": "TRUE"

}

"countChildren": 0,

"prevCises": [

"string"

"nextCises": [

"string"

200

"cisChildren": [

"string"

]

}

"total": 0,

"nextPage": true,

"docErrors": [

{

"additionalProp1": {},

"additionalProp2": {},

"additionalProp3": {}

}

]

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

object

Результат запроса

*cis

string

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

используемый для фильтрации

по списку КИ

*gtin

string

Код товара

*sgtin

string

Код товара и серийный номер

КИ

*productName

string

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

*tnVed

string

Код товарной номенклатуры

*producerName

string

Производитель товара

*producerInn

string

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

товара

*ownerName

string

Наименование собственника

товара

*ownerInn

string

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

*agentName

string

Наименование текущего

владельца товара

*agentInn

string

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

*previousAgentName

string

Наименование предыдущего

владельца товара

*previousAgentInn

string

ИНН предыдущего владельца

товара

201

Параметр

Тип

Обяз.

Описание

Комментарий

*turnoverType

enum

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

Возможные

значения:

SELLING

- продажа;

COMMISSION -

комиссия;

AGENT - агент

*status

enum

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

См. Справочник

"Статусы КИ"

*emissionDate

string

Дата эмиссии КИ

Возвращается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

*emissionType

string

Тип эмиссии

Возможные

значения:

LOCAL -

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

FOREIGN -

Ввезен в РФ;

REMAINS -

Маркировка

остатков;

CROSSBORDER

- Ввезен из стран

ЕАЭС

*withdrawReason

string

Причина выбытия

См. "Справочник

"Причины

выбытия""

*packType

string

Тип упаковки

Возможные

значения:

UNIT, BUNDLE,

SET, LEVEL1,

LEVEL2,

LEVEL3, ATK

(См. Справочник

"Типы упаковки")

*children:

[array]

КИ в агрегате

**cis

string

КИ товара

**gtin

string

Код товара

**producerName

string

Производитель товара

**status

enum

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

См. Справочник

"Статусы КИ"

202

Параметр

Тип

Обяз.

Описание

Комментарий

**emissionDate

string

Дата эмиссии

Задается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**producedDate

string

Дата ввода товара с КИ в оборот

Возвращается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**packageType

string

Тип упаковки

См. Справочник

"Типы упаковки"

**ownerName

string

Наименование собственника

товара

**ownerInn

string

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

**productName

string

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

этикетке

**brand

string

Бренд

**prevCises

[string]

Предыдущие номера КИ в

случае перемаркировки товара)

**nextCises

[string]

Следующие номера КИ в случае

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

**statusEx

enum

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

См. Справочник

КИ

"Статусы КИ"

**children

[string]

Все КИ в агрегате

Возвращается в

формате JSON-

массива

**childrenMap

[string]

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

КИ

**countChildren

integer

Количество дочерних КИ

**parent

string

Код идентификации упаковки, в

которую агрегирован товар

**lastDocId

string

Последний регистрационный

номер

документа,зафиксированный в

ГИС МТ по этому КИ

203

Параметр

Тип

Обяз.

Описание

Комментарий

**expireDate

string

Дата истечения срока годности

Возвращается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z (обязательный

для ТГ "Молочная

продукция")

**prVetDocument

string

ID производственного ВСД (для

Обязательный

продукции, произведённой в

параметр для ТГ

РФ) или ID транспортного ВСД

"Молочная

(для продукции, произведённой

продукция".

вне РФ)

Данный параметр

используется

вместо

устаревшего

"prVetDoc"

**introducedDate

string

Дата ввода в оборот с КИ в

Возвращается в

(date-

оборот

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**exporterName

string

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

**exporterTaxpayerId

string

Уникальный идентификатор

экспортёра в национальной

системе учета

налогоплательщиков

**agentName

string

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

**agentInn

string

Наименование текущего

владельца товара

**lastStatusChangeDate

string

Дата последнего изменения

Возвращается в

(date-

статуса

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**turnoverType

enum

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

Возможные

значения:

SELLING

- продажа;

COMMISSION -

комиссия;

AGENT - агент

**productGroup

string

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

См. Справочник

"Список

поддерживаемых

товарных групп"

204

Параметр

Тип

Обяз.

Описание

Комментарий

**tnVed10

string

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

**veterinaryControl

boolean

Признак подконтрольности

Возвращается

ВСД, означающий

только для ТГ

необходимость проверки ВСД в

"Молочная

"ВетИС"

продукция"

**markWithdraw

boolean

Признак выбытия от

Возвращается

невладельца

ИНН последнего

продавца. Если

ИНН последнего

продавца = ИНН

из токена, то

признак выбытия

от продавца = 1

иначе 0. Если

запрос без токена,

то параметр в

ответе

отсутствует.

*countChildren

integer

Количество дочерних КИ

*prevCises

[string]

Предыдущие номера КИ в

случае перемаркировки товара)

*nextCises

[string]

Следующие номера КИ в случае

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

*cisChildren

[string]

Список дочерних КИ

total

string

Количество вернувшихся

ответов

boolean

Признак наличия следующей

Возможные

страницы

значения:

true - имеется

страница;

false - следующая

страница

отсутствует

docErrors

[string]

Список ошибок обработки

Возвращается в

документа

случае ошибки

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

возможностью фильтрации

URL: /facade/agent/given/list

Метод: GET

Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в

205

разделе "Указание параметров в строке запроса при работе с большими агрегатами".

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

curl -X GET "<url

стенда>/facade/agent/given/list?cis=string&cisMatchMode=EQ&producerInn=string&agent=st

ring&prevAgent=string&emissionType=INVALID_VALUE&emissionDateFrom=0&emissionDateTo=0&g

tin=string&sn=string&turnoverType=SELLING&cisAggregationState=PACKED&statusExt=WAIT_SH

IPMENT&cisStatus=INTRODUCED&limit=0&page=0&pg=string"

-H "accept: */*" -H "Authorization: Bearer <Токен>"

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

Параметр

Тип

Обяз.

Описание

Комментарий

childrenPaging

boolean

Флаг, включающий пагинацию

При включённом

агрегатов

значении

возвращает

постранично

агрегаты только

первого слоя

через указанные

ниже параметры.

Значение по

умолчанию: false

childrenPage

number

Число страниц вложений

Значение по

агрегата первого слоя

умолчанию: 1

childrenLimit

number

Количество вложений на

Значение по

странице агрегата первого слоя

умолчанию: 50

cis

string

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

cisMatchMode

string

Режим фильтрации по КИ

Возможные

значения:

EQ - полностью

равен;

LIKE - содержит в

себе. Является

устаревшим и в

дальнейшем будет

удалён.

Рекомендуется

использовать

"START_WITH"

("Начинается с");

START_WITH -

начинается с

producerInn

string

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

agent

string

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

206

Параметр

Тип

Обяз.

Описание

Комментарий

prevAgent

string

ИНН предыдущего владельца

товара

emissionType

string

Тип эмиссии

Возможные

значения:

LOCAL -

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

FOREIGN -

Ввезен в РФ;

REMAINS -

Маркировка

остатков;

CROSSBORDER

- Ввезен из стран

ЕАЭС

emissionDateFrom

date-

Дата эмиссии, от

Задаётся в

time

формате yyyy-

MM-

ddTHH:mm:ss.SSS

’Z. Пример 2019-

01-

01T03:00:00.000Z

emissionDateTo

date-

Дата эмиссии, до

Задаётся в

time

формате yyyy-

MM-

ddTHH:mm:ss.SSS

’Z. Пример 2019-

01-

01T03:00:00.000Z

gtin

string

Код товара

string

Серийный номер

turnoverType

enum

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

Возможные

значения:

SELLING

- продажа;

COMMISSION -

комиссия;

AGENT - агент

207

Параметр

Тип

Обяз.

Описание

Комментарий

cisAggregationState

enum

Состояние КИ

Возможные

значения:

PACKED- в

агрегате

(агрегирован);

NOT_PACKED -

не в агрегате

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

ANY - любое

состояние

statusExt

enum

Дополнительный статус товара

WITHDRAW -

вывод из оборота;

WAIT_SHIPMEN

T - ожидает

подтверждения

приемки;

WAIT_TRANSFE

R_TO_OWNER -

ожидает передачу

собственнику

(производство по

контракту);

REMARK_RETIR

ED -

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

WAIT_REMARK

- КИ списан

после нанесения

на товар (товар

ожидает

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

cisStatus

string

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

См. справочник

"Актуальные

статусы"

limit

string

Значение устанавливает

количество записей в ответе, не

более 10000 записей (по

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

page

string

Номер страницы ответа,

начальное значение 0

string

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

Параметр

обязательно

указывать для

товарных групп:

milk - Молочная

продукция;

water - Вода

208

Параметр

Тип

Обяз.

Описание

Комментарий

withdrawReason

string

Причина выбытия

См. "Справочник

"Причины

выбытия""

aggregation

boolean

Показывать товары и товарные

упаковки только в одном статусе

для агрегации

packageTypes

string

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

См. "Справочник

"Типы упаковки"

remarkHistory

string

Фильтрация по истории

Возможные

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

значения:

ALL - (вся

история) -

выводятся

предыдущие и

новые КИ,

связанные с КИ,

указанным в

параметре "cis";

ENTERED -

(указанный) -

выводится только

указанный в

параметре "cis"

КИ;

ENTERED_AND_

LAST (указанный

и последний) -

выводится только

указанный в

параметре "cis"

КИ и последний в

истории

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

КИ

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

{

"results": [

{

"cis": "string",

"gtin": "string",

"sgtin": "string",

"productName": "string",

"tnVed": "string",

"producerName": "string",

"producerInn": "string",

"ownerName": "string",

209

"ownerInn": "string",

"agentName": "string",

"agentInn": "string",

"previousAgentName": "string",

"previousAgentInn": "string",

"turnoverType": "SELLING",

"status": "EMITTED",

"emissionDate": 0,

"emissionType": "INVALID_VALUE",

"packType": "UNIT",

"children": [

{

"cis": "string",

"gtin": "string",

"producerName": "string",

"status": "EMITTED",

"emissionDate": 0,

"producedDate": 0,

"packageType": "UNIT",

"ownerName": "string",

"ownerInn": "string",

"productName": "string",

"brand": "string",

"prevCises": [

"string"

"nextCises": [

"string"

"statusEx": "EMPTY",

"children": [

"string"

"childrenMap": {},

"countChildren": 0,

"parent": "string",

"lastDocId": "string",

"expireDate": 0,

"prVetDocument": "string",

"introducedDate": 0,

"exporterName": "string",

"exporterTaxpayerId": "string",

"agentName": "string",

"agentInn": "string",

"lastStatusChangeDate": 0,

"turnoverType": "SELLING",

"productGroup": "string",

"tnVed10": "string",

"veterinaryControl": true,

"markWithdraw": "TRUE"

}

210

"countChildren": 0,

"prevCises": [

"string"

"nextCises": [

"string"

"cisChildren": [

"string"

]

}

"total": 0,

"nextPage": true,

"docErrors": [

{

"additionalProp1": {},

"additionalProp2": {},

"additionalProp3": {}

}

]

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

object

Результат запроса

*cis

string

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

используемый для фильтрации

по списку КИ

*gtin

string

Код товара

*sgtin

string

Код товара и серийный номер

КИ

*productName

string

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

*tnVed

string

Код товарной номенклатуры

*producerName

string

Производитель товара

*producerInn

string

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

товара

*ownerName

string

Наименование собственника

товара

*ownerInn

string

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

*agentName

string

Наименование текущего

владельца товара

211

Параметр

Тип

Обяз.

Описание

Комментарий

*agentInn

string

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

*previousAgentName

string

Наименование предыдущего

владельца товара

*previousAgentInn

string

ИНН предыдущего владельца

товара

*turnoverType

enum

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

Возможные

значения:

SELLING

- продажа;

COMMISSION -

комиссия;

AGENT - агент

*status

enum

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

См. Справочник

"Статусы КИ"

*emissionDate

string

Дата эмиссии КИ

Возвращается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

*emissionType

string

Тип эмиссии

Возможные

значения:

LOCAL -

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

FOREIGN -

Ввезен в РФ;

REMAINS -

Маркировка

остатков;

CROSSBORDER

- Ввезен из стран

ЕАЭС

*packType

string

Тип упаковки

См. Справочник

"Типы упаковки"

*children:

[array]

КИ в агрегате

**cis

string

КИ товара

**gtin

string

Код товара

**producerName

string

Производитель товара

**status

enum

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

См. Справочник

"Статусы КИ"

212

Параметр

Тип

Обяз.

Описание

Комментарий

**emissionDate

string

Дата эмиссии

Задается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**producedDate

string

Дата ввода товара с КИ в оборот

Возвращается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**packageType

string

Тип упаковки

См. Справочник

"Типы упаковки"

**ownerName

string

Наименование собственника

товара

**ownerInn

string

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

**productName

string

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

этикетке

**brand

string

Бренд

**prevCises

[string]

Предыдущие номера КИ в

случае перемаркировки товара)

**nextCises

[string]

Следующие номера КИ в случае

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

**statusEx

enum

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

См. Справочник

КИ

"Статусы КИ"

**children

[string]

Все КИ в агрегате

Возвращается в

формате JSON-

массива

**childrenMap

[string]

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

КИ

**countChildren

integer

Количество дочерних КИ

**parent

string

Код идентификации упаковки, в

которую агрегирован товар

**lastDocId

string

Последний регистрационный

номер

документа,зафиксированный в

ГИС МТ по этому КИ

213

Параметр

Тип

Обяз.

Описание

Комментарий

**expireDate

string

Дата истечения срока годности

Возвращается в

(date-

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z (обязательный

для ТГ "Молочная

продукция")

**prVetDocument

string

ID производственного ВСД (для

Обязательный

продукции, произведённой в

параметр для ТГ

РФ) или ID транспортного ВСД

"Молочная

(для продукции, произведённой

продукция".

вне РФ)

Данный параметр

используется

вместо

устаревшего

"prVetDoc"

**introducedDate

string

Дата ввода в оборот с КИ в

Возвращается в

(date-

оборот

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**exporterName

string

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

**exporterTaxpayerId

string

Уникальный идентификатор

экспортёра в национальной

системе учета

налогоплательщиков

**agentName

string

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

**agentInn

string

Наименование текущего

владельца товара

**lastStatusChangeDate

string

Дата последнего изменения

Возвращается в

(date-

статуса

формате yyyy-

time)

MM-

ddTHH:mm:ss.SSS

’Z

**turnoverType

enum

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

Возможные

значения:

SELLING

- продажа;

COMMISSION -

комиссия;

AGENT - агент

**productGroup

string

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

См. Справочник

"Список

поддерживаемых

товарных групп"

214

Параметр

Тип

Обяз.

Описание

Комментарий

**tnVed10

string

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

**veterinaryControl

boolean

Признак подконтрольности

Возвращается

ВСД, означающий

только для ТГ

необходимость проверки ВСД в

"Молочная

"ВетИС"

продукция"

**markWithdraw

boolean

Признак выбытия от

Возвращается

невладельца

ИНН последнего

продавца. Если

ИНН последнего

продавца = ИНН

из токена, то

признак выбытия

от продавца = 1

иначе 0. Если

запрос без токена,

то параметр в

ответе

отсутствует.

*countChildren

integer

Количество дочерних КИ

*prevCises

[string]

Предыдущие номера КИ в

случае перемаркировки товара)

*nextCises

[string]

Следующие номера КИ в случае

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

*cisChildren

[string]

Список дочерних КИ

total

string

Количество вернувшихся

ответов

boolean

Признак наличия следующей

Возможные

страницы

значения:

true - имеется

страница;

false - следующая

страница

отсутствует

docErrors

[string]

Список ошибок обработки

Возвращается в

документа

случае ошибки

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

возможностью фильтрации

Метод является устаревшим и в дальнейшем будет отключён.

URL: /facade/agent/given/count

Метод: GET

215

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

curl -X GET "<url

стенда>/facade/agent/given/count?cis=string&cisMatchMode=EQ&producerInn=string&agent=s

tring&prevAgent=string&emissionType=INVALID_VALUE&emissionDateFrom=0&emissionDateTo=0&

gtin=string&sn=string&turnoverType=SELLING&cisAggregationState=PACKED&statusExt=WAIT_S

HIPMENT&cisStatus=INTRODUCED&limit=0&page=0&pg=string"

-H "accept: */*" -H "Authorization: Bearer <Токен>"

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

Параметр

Тип

Обяз.

Описание

cis

string

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

cisMatchMode

string

Режим фильтрации по КИ:

EQ - полностью равен;

LIKE - содержит в себе. Является устаревшим и в

дальнейшем

будет

удалён.

Рекомендуется

использовать "START_WITH"("Начинается с");

START_WITH - начинается с

producerInn

string

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

agent

string

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

prevAgent

string

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

emissionType

string

Тип эмиссии:

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

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

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

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

emissionDateFrom

date-

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

time

ddTHH:mm:ss.SSS’Z. Пример 2019-01-

01T03:00:00.000Z

emissionDateTo

date-

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

time

ddTHH:mm:ss.SSS’Z. Пример 2019-01-

01T03:00:00.000Z

gtin

string

Код товара

string

Серийный номер

turnoverType

enum

Вид

товарооборота:

SELLING

- продажа;

COMMISSION - комиссия; AGENT - агент

cisAggregationState

enum

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

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

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

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

216

Параметр

Тип

Обяз.

Описание

statusExt

enum

Дополнительный статус товара:

WITHDRAW - вывод из оборота;

WAIT_SHIPMENT - ожидает подтверждения

приемки;

WAIT_TRANSFER_TO_OWNER - ожидает

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

контракту);

REMARK_RETIRED - перемаркирован;

WAIT_REMARK - КИ списан после нанесения на

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

cisStatus

string

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

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

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

INTRODUCED - В обороте;

RETIRED - Выбыл;

DISAGGREGATION - расформирован

limit

string

Значение устанавливает количество записей в

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

записей)

page

string

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

string

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

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

групп:

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

water - Вода

withdrawReason

string

Причина выбытия. См. "Справочник "Причины

выбытия""

aggregation

boolean

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

одном статусе для агрегации

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

{

"count": 0

}

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

Параметр

Тип

Обяз.

Описание

count

integer

Количество полученных КИ

217

2.19. Запрос информации об участнике оборота товаров по

ИНН

В результате успешного выполнения запроса по одному ИНН участника оборота товаров в

ответе возвращается информация о запрашиваемом участнике оборота товаров.

Тип приватности: публичный

URL: /facade/participants/{inn}

Метод: GET

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

curl -X GET '<url стенда>/facade/participants/7777777777?pg=lp'

Authorization: Bearer <ТОКЕН>

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

Параметр

Тип

Обяз.

Описание

Комментарий

inn

array

ИНН участника

[string]

оборота товаров

string

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

См. "Справочник "Список

поддерживаемых товарных групп"".

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

товарных групп:

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

water - "Упакованная вода"

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

218

{

"id": 0,

"inn": "string",

"name": "string",

"shortName": "string",

"fullName": "string",

"type": "string",

"status": "string",

"kpp": "string",

"ogrn": "string",

"head": [

"string"

"legalAddress": "string",

"actualAddress": "string",

"email": "string",

"registrationDate": 0,

"organizationForm": "IP",

"emissionRegistrars": "string",

"dissolved": true,

"roles": [

"string"

"phone": "string"

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

integer

Идентификатор

inn

string

ИНН

name

string

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

shortName

string

Краткое

наименование

fullName

string

Полное

наименование

type

string

Тип организации

status

string

Статус

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

kpp

string

КПП

ogrn

string

ОГРН

head

[string]

Руководители

legalAddress

string

Юридический

адрес

219

Параметр

Тип

Обяз.

Описание

Комментарий

actualAddress

string

Фактический

адрес

string

registrationDa

integer

Регистрация

organizationF

string

Форма

orm

организации: ЮЛ,

ФЛ, ИП

emissionRegi

string

Регистратор

strars

эмиссии

dissolved

boolean

Признак

существования

организации

roles

[string]

Роли организации

phone

string

Телефон

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

идентификации по началу КИ

URL: /facade/identifytools/start_with

Метод: POST

Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в

разделе "Указание параметров в строке запроса при работе с большими агрегатами".

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

curl -X POST '<url стенда v4>/facade/identifytools/start_with"

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

-H "Content-Type: application/json" -d

"{"uit":"010405915570452921HXRNJW15asPkB2406405"}"

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

Параметр

Тип

Обяз.

Описание

Комментарий

childrenPagin

boolean

Флаг,

При включённом значении возвращает

включающий

постранично агрегаты только первого слоя

пагинацию

через указанные ниже параметры.

агрегатов

Значение по умолчанию: false

childrenPage

number

Число страниц

Значение по умолчанию: 1

вложений

агрегата первого

слоя

220

Параметр

Тип

Обяз.

Описание

Комментарий

childrenLimit

number

Количество

Значение по умолчанию: 50

вложений на

странице агрегата

первого слоя

string

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

Параметр обязательно указывается в

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

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

water - "Упакованная вода"

uit

string

Код

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

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

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

{

"uit": "string",

"cis": "string",

"gtin": "string",

"sgtin": "string",

"tnVedEaes": "string",

"tnVedEaesGroup": "string",

"productName": "string",

"emissionDate": 0,

"producedDate": 0,

"participantName": "string",

"participantInn": "string",

"producerName": "string",

"producerInn": "string",

"ownerName": "string",

"ownerInn": "string",

"statusEx": "EMPTY",

"lastDocId": "string",

"lastDocType": "UNKNOWN",

"emissionType": "string",

"receiptDate": "2021-05-07T00:00:00.000Z",

"withdrawReason": "string",

"prevCises": [

"string"

"nextCises": [

"string"

"status": "EMITTED",

"packType": "UNIT",

"children": [

null

221

"countChildren": 0,

"cisChildren": [

"string"

"uitu": "string",

"dateChange": 0,

"parent": "string",

"expireDate": 0,

"prVetDocument": "string",

"introducedDate": 0,

"agentName": "string",

"agentInn": "string",

"previousAgentName": "string",

"previousAgentInn": "string",

"exporterName": "string",

"exporterTaxpayerId": "string",

"turnoverType": "SELLING",

"lastStatusChangeDate": 0,

"productGroup": "string",

"setGtin": [

{

"gtin": "string",

"productName": "string",

"quantity": 0

}

"setDescription": "string",

"veterinaryControl": true

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

uit

string

КИ

Обязательный параметр, если не указан

"uitu"

cis

string

Код

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

используемый для

фильтрации по

списку КИ

gtin

string

Код товара

sgtin

string

Код товара и

серийный номер

КИ

tnVedEaes

string

Код товарной

номенклатуры (10

знаков)

222

Параметр

Тип

Обяз.

Описание

Комментарий

tnVedEaesGr

string

Код товарной

oup

позиции ТН ВЭД

ЕАС товара

productName

string

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

товара на этикетке

emissionDate

string

Дата эмиссии КИ

Возвращается в формате yyyy-MM-

(date-

ddTHH:mm:ss.SSS’Z

time)

producedDate

string

Дата ввода товара

Возвращается в формате yyyy-MM-

(date-

с КИ в оборот

ddTHH:mm:ss.SSS’Z

time)

participantInn

string

ИНН участника

оборота товара

participantNa

string

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

участника

оборота товаров

producerInn

string

ИНН

производителя

товар

producerNam

string

Производитель

товара

ownerInn

string

ИНН

собственника

товара

ownerName

string

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

собственника

товара

statusEx

enum

Актуальные

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

особые состояния

КИ

lastDocId

string

Последний

регистрационный

номер документа,

зафиксированный

в ГИС МТ по

этому КИ

lastDocType

string

Тип последнего

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

документа

emissionType

string

Тип эмиссии

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

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

223

Параметр

Тип

Обяз.

Описание

Комментарий

receiptDateTi

string

Дата вывода из

Возвращается в формате yyyy-MM-

оборота

ddTHH:mm:ss.SSS’Z. Поле "receiptDate"

является устаревшим

withdrawReas

string

Причина выбытия

См. "Справочник "Причины выбытия""

prevCises

[string]

Предыдущие

номера КИ в

случае

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

товара

nextCises

[string]

Следующие

номера КИ в

случае

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

товара

status

enum

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

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

packType

string

Тип упаковки

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

children

[string]

КИ в агрегате

*cis

string

КИ товара

*gtin

string

Код товара

*producerNa

string

Производитель

товара

*status

enum

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

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

*emissionDat

string

Дата эмиссии

Возвращается в формате yyyy-MM-

(date-

ddTHH:mm:ss.SSS’Z

time)

*producedDat

string

Дата нанесения

Возвращается в формате yyyy-MM-

(date-

ddTHH:mm:ss.SSS’Z

time)

*packageType

string

Тип упаковки

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

*ownerInn

string

ИНН

собственника

товара

*ownerName

string

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

собственника

товара

*productNam

string

Название

продукта

*brand

string

Бренд

224

Параметр

Тип

Обяз.

Описание

Комментарий

*prevCises

[string]

Предыдущие КИ

в случае

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

товара

*nextCises

[string]

Следующие

номера КИ в

случае

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

товара

*statusEx

enum

Актуальные

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

особые состояния

КИ

*children

[string]

Все Дочерние КИ.

Выглядит как

JSON массив

*childrenMap

[string]

Краткая

информация о

дочерних КИ

*countChildre

integer

Количество

дочерних КИ

*parent

string

Код

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

упаковки, в

которую

агрегирован товар

*lastDocId

string

Последний

регистрационный

номер документа,

зафиксированный

в ГИС МТ по

этому КИ

*expireDate

string

Дата истечения

Возвращается в формате yyyy-MM-

(date-

срока годности

ddTHH:mm:ss.SSS’Z (обязательный для

time)

ТГ "Молочная продукция")

*prVetDocum

string

Обязательный параметр для ТГ

ent

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

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

о ВСД (для

используется вместо устаревшего

продукции,

"prVetDoc"

произведённой в

РФ) или ID

транспортного

ВСД (для

продукции,

произведённой

вне РФ)

225

Параметр

Тип

Обяз.

Описание

Комментарий

*introducedD

string

Дата ввода в

Возвращается в формате yyyy-MM-

ate

(date-

оборот

ddTHH:mm:ss.SSS’Z

time)

*exporterNam

string

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

экспортера

*exporterTax

string

уникальный

payerId

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

экспортёра в

национальной

системе учета

налогоплательщи

ков

*agentInn

string

ИНН текущего

владельца товара

*agentName

string

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

текущего

владельца товара

*lastStatusCh

string

Дата последнего

Возвращается в формате yyyy-MM-

angeDate

(date-

изменения статуса

ddTHH:mm:ss.SSS’Z

time)

*sgtin

string

Код товара и

серийный номер

КИ

*turnoverTyp

enum

Вид

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

товарооборота

SELLING - продажа;

COMMISSION

(COMMISSIONAIRE_SALE - устар.) -

комиссия;

AGENT - агент

*productGrou

string

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

См. "Справочник "Список

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

countChildren

integer

Количество

(int32)

дочерних КИ

cisChildren

[string]

Список дочерних

КИ

uitu

string

КИТУ

Обязательный параметр, если не указан

"uit"

dateChange

string

Дата внесения

Возвращается в формате yyyy-MM-

(date-

изменений в

ddTHH:mm:ss.SSS’Z

time)

КИТУ

parent

string

КИТУ

вышестоящего

уровня

226

Параметр

Тип

Обяз.

Описание

Комментарий

expireDate

string

Дата истечения

Возвращается в формате yyyy-MM-

(date-

срока годности

ddTHH:mm:ss.SSS’Z (обязательный для

time)

ТГ "Молочная продукция")

prVetDocume

string

Обязательный параметр для ТГ

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

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

о ВСД (для

используется вместо устаревшего

продукции,

"prVetDoc"

произведённой в

РФ) или ID

транспортного

ВСД (для

продукции,

произведённой

вне РФ)

introducedDat

string

Дата ввода в

Возвращается в формате yyyy-MM-

(date-

оборот с КИ в

ddTHH:mm:ss.SSS’Z

time)

оборот

agentInn

string

ИНН текущего

владельца товара

agentName

string

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

текущего

владельца товара

previousAgen

string

ИНН

tInn

предыдущего

владельца товара

previousAgen

string

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

tName

предыдущего

владельца товара

exporterName

string

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

экспортёра

exporterTaxp

string

Уникальный

ayerId

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

экспортера в

национальной

системе учета

налогоплательщи

ков

turnoverType

enum

Вид

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

товарооборота

SELLING - продажа;

COMMISSION

(COMMISSIONAIRE_SALE - устар.) -

комиссия;

AGENT - агент

227

Параметр

Тип

Обяз.

Описание

Комментарий

lastStatusCha

string

Дата последнего

Возвращается в формате yyyy-MM-

ngeDate

(date-

изменения статуса

ddTHH:mm:ss.SSS’Z

time)

productGroup

string

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

См. "Справочник "Список

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

setGtin

[array]

Код набора

Массив всегда возвращается в ответе,

если "packType" = "SET"

*gtin

string

Код товара,

входящего в

набор

*productNam

string

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

товара

*quantity

integer

Количество кодов

товара, входящих

в набор

setDescription

string

Текстовое

Возвращается описание товара в составе

описание набора

набора, содержащее параметры,

специфичные для конкретного товара.

Данный параметр вернётся в том случае,

если он заполнен в карточке НК (см.

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

параметры в ответе в зависимости от

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

veterinaryCon

boolean

Признак

Возвращается только для ТГ "Молочная

trol

подконтрольности

продукция"

ВСД, означающий

необходимость

проверки ВСД в

"ВетИС"

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

URL: /facade/identifytools/aggregated

Метод: POST

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

<url стенда v4>/facade/identifytools/aggregated"

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

-H "Content-Type: application/json" -d

"{"cises":["000000462106549OOv1s0XzlzIFDjtcXJjz5cB"]}"

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

228

{

"000000462106549OOv1s0XzlzIFDjtcXJjz5cB": {

"0100000046210654214u4qrBQ": [

"00000046210654QuHCUeP",

"00000046210654kGS951L",

"00000046210654ndSJVa0",

"00000046210654HBTlASg",

"00000046210654RQL9x5W",

"000000462106548kkX4Wy",

"00000046210654KJEIVd4",

"00000046210654NAZQsBx",

"00000046210654SRHZnWr",

"00000046210654iVDjrm6"

"010000004621065421hYVhjnW": [

"000000462106542xb6Fiy",

"00000046210654u8fmz0X",

"000000462106542yUlHC9",

"00000046210654dBpPEZs",

"00000046210654yOTPFS6",

"00000046210654aewBPk4",

"00000046210654zSkKEBt",

"00000046210654EtTF0j8",

"00000046210654wXVWhUu",

"00000046210654a2xoPyp"

]

"00000004621065421oFTjHaM": {

"00000046210654PQgiuyT": [ ],

"00000046210654br263jz": [ ],

"00000046210654T8ilBVZ": [ ],

"00000046210654xp8JGKc": [ ],

"00000046210654et2bcCN": [ ],

"00000046210654qTR6MnF": [ ],

"000000462106547h0FAsR": [ ],

"00000046210654aEPiJFa": [ ],

"00000046210654qr0Cm3Q": [ ],

"00000046210654VVixsXU": [ ]

"00000046210654QuHCUeP": {}

}

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

идентификации (POST)

URL: /facade/identifytools/infolist

Метод: POST

230

Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в

разделе "Указание параметров в строке запроса при работе с большими агрегатами".

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

curl -X POST

'<url стенда v4>/facade/identifytools/infolist"

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

-H "Content-Type: application/json" -d

"{"cises":["000000462106549OOv1s0XzlzIFDjtcXJjz5cB"]}"

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

Параметр

Тип

Обяз.

Описание

Комментарий

childrenPagin

boolean

Флаг,

При включённом значении возвращает

включающий

постранично агрегаты только первого слоя

пагинацию

через указанные ниже параметры.

агрегатов

Значение по умолчанию: false

childrenPage

number

Число страниц

Значение по умолчанию: 1

вложений

агрегата первого

слоя

childrenLimit

number

Количество

Значение по умолчанию: 50

вложений на

странице агрегата

первого слоя

cises

string

КИ

string

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

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

товарных групп:

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

water - "Упакованная вода"

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

• В случае успеха:

[

{

"uit": "string",

"cis": "string",

"gtin": "string",

"sgtin": "string",

"tnVedEaes": "string",

"tnVedEaesGroup": "string",

"productName": "string",

"emissionDate": 0,

"producedDate": 0,

"participantName": "string",

231

"participantInn": "string",

"producerName": "string",

"producerInn": "string",

"ownerName": "string",

"ownerInn": "string",

"statusEx": "EMPTY",

"lastDocId": "string",

"lastDocType": "UNKNOWN",

"emissionType": "string",

"receiptDateTime": "2021-05-07T00:00:00.000Z",

"withdrawReason": "string",

"prevCises": [

"string"

"nextCises": [

"string"

"status": "EMITTED",

"packType": "UNIT",

"children": [

null

"countChildren": 0,

"cisChildren": [

"string"

"uitu": "string",

"dateChange": 0,

"parent": "string",

"expireDate": 0,

"prVetDocument": "string",

"introducedDate": 0,

"agentName": "string",

"agentInn": "string",

"previousAgentName": "string",

"previousAgentInn": "string",

"exporterName": "string",

"exporterTaxpayerId": "string",

"turnoverType": "SELLING",

"lastStatusChangeDate": 0,

"productGroup": "string",

"partialSaleInfo": {

"soldUnitCount": 10,

"rest": 10,

"correctRest": true

"setGtin": [

{

"gtin": "string",

"productName": "string",

"quantity": 0

232

}

"setDescription": "string",

"veterinaryControl": true

}

]

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

Параметр

Тип

Обяз.

Описание

Комментарий

uit

string

КИ,

Обязательный,

если не указан

uitu

cis

string

Код

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

используемый для

фильтрации по

списку КИ

gtin

string

Код товара

sgtin

string

Код товара и

серийный номер

КИ

tnVedEaes

string

Код товарной

номенклатуры (10

знаков)

tnVedEaesGr

string

Код товарной

oup

позиции ТН ВЭД

ЕАС товара

productName

string

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

товара на этикетке

emissionDate

string

Дата эмиссии КИ

Возвращается в формате yyyy-MM-

(date-

ddTHH:mm:ss.SSS’Z

time)

producedDate

string

Дата ввода товара

Возвращается в формате yyyy-MM-

(date-

с КИ в оборот

ddTHH:mm:ss.SSS’Z

time)

participantInn

string

ИНН участника

оборота товара

participantNa

string

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

участника

оборота товаров

producerInn

string

ИНН

производителя

товар

233

Параметр

Тип

Обяз.

Описание

Комментарий

producerNam

string

Производитель

товара

ownerInn

string

ИНН

собственника

товара

ownerName

string

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

собственника

товара

statusEx

enum

Актуальные

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

особые состояния

КИ

lastDocId

string

Последний

регистрационный

номер документа,

зафиксированный

в ГИС МТ по

этому КИ

lastDocType

string

Тип последнего

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

документа

emissionType

string

Тип эмиссии

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

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

receiptDateTi

string

Дата вывода из

Возвращается в формате yyyy-MM-

оборота

ddTHH:mm:ss.SSS’Z. Поле "receiptDate"

является устаревшим

withdrawReas

string

Причина выбытия

См. "Справочник "Причины выбытия""

prevCises

[string]

Предыдущие

номера КИ в

случае

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

товара

nextCises

[string]

Следующие

номера КИ в

случае

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

товара

status

enum

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

См. справочник "Актуальные статусы"

packType

string

Тип упаковки

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

children

[array]

Массив КИ в

агрегате

countChildren

integer

Количество

(int32)

дочерних КИ

234

Параметр

Тип

Обяз.

Описание

Комментарий

cisChildren

[string]

Список дочерних

КИ

uitu

string

КИТУ

Обязательный параметр, если не указан

"uit"

dateChange

string

Дата внесения

Возвращается в формате yyyy-MM-

(date-

изменений в

ddTHH:mm:ss.SSS’Z

time)

КИТУ

parent

string

КИТУ

вышестоящего

уровня

expireDate

string

Дата истечения

Возвращается в формате yyyy-MM-

(date-

срока годности

ddTHH:mm:ss.SSS’Z (обязательный для

time)

ТГ "Молочная продукция")

prVetDocume

string

Обязательный параметр для ТГ

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

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

о ВСД (для

используется вместо устаревшего

продукции,

"prVetDoc"

произведённой в

РФ) или ID

транспортного

ВСД (для

продукции,

произведённой

вне РФ)

introducedDat

string

Дата ввода в

Возвращается в формате yyyy-MM-

(date-

оборот с КИ в

ddTHH:mm:ss.SSS’Z

time)

оборот

agentInn

string

ИНН текущего

владельца товара

agentName

string

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

текущего

владельца товара

previousAgen

string

ИНН

tInn

предыдущего

владельца товара

previousAgen

string

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

tName

предыдущего

владельца товара

exporterName

string

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

экспортёра

235

Параметр

Тип

Обяз.

Описание

Комментарий

exporterTaxp

string

Уникальный

ayerId

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

экспортера в

национальной

системе учета

налогоплательщи

ков

turnoverType

enum

Вид

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

товарооборота

SELLING - продажа;

COMMISSION

(COMMISSIONAIRE_SALE - устар.) -

комиссия;

AGENT - агент

lastStatusCha

string

Дата последнего

Возвращается в формате yyyy-MM-

ngeDate

(date-

изменения статуса

ddTHH:mm:ss.SSS’Z

time)

productGroup

string

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

См. "Справочник "Список

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

partialSaleInf

object

Объект

Возвращается для ТГ "Духи и туалетная

параметров

вода" (наливная продукция)

частичного

выбытия

*soldUnitCou

number

Объем

Значением параметра является число

выведенного из

выбывших, в том числе от невладельцев,

оборота товара по

из оборота единиц употребления из всех

КИ, мл

чеков. Участнику оборота товаров

отображается информация только по

собственным чекам. ФОИВ доступна

информация по всем чекам

*rest

number

Объем товара,

Значением параметра является расчётный

доступного к

объём оставшихся в потребительской

выводу из

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

оборота по КИ,

участниками оборота товаров. Участнику

мл

оборота товаров отображается

информация только по собственным

чекам. ФОИВ доступна информация по

всем чекам

*correctRest

boolean

Корректность

Показатель корректности остатка товара

остатка товара

после вывода товара из оборота: false -

продано или возвращено больше

допустимого объема товара; true - продано

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

объема товара. Продажа товара в объеме,

превышающем заявленный, а также

превышение остатка товара более чем на

8%, считаются некорректными

236

Параметр

Тип

Обяз.

Описание

Комментарий

setGtin

[array]

Код набора

Массив всегда возвращается в ответе,

если "packType" = "SET"

*gtin

string

Код товара,

входящего в

набор

*productNam

string

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

товара

*quantity

integer

Количество кодов

товара, входящих

в набор

setDescription

string

Текстовое

Возвращается описание товара в составе

описание набора

набора, содержащее параметры,

специфичные для конкретного товара.

Данный параметр вернётся в том случае,

если он заполнен в карточке НК (см.

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

параметры в ответе в зависимости от

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

veterinaryCon

boolean

Признак

Возвращается только для ТГ "Молочная

trol

подконтрольности

продукция"

ВСД, означающий

необходимость

проверки ВСД в

"ВетИС"

• В случае ошибки 403:

{

"code": 403,

"description": "User has no access to requested CIS",

"error_message": "Доступ запрещен"

}

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

URL: /facade/cis/info

Метод: GET

Информацию по указанию параметров в строке запроса при работе с большими агрегатами см. в

разделе "Указание параметров в строке запроса при работе с большими агрегатами".

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

237

curl -X POST "<url стенда v4>/facade/cis/info?cisId=81635161684"

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

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

Параметр

Тип

Обяз.

Описание

Комментарий

childrenPagin

boolean

Флаг,

При включённом значении возвращает

включающий

постранично агрегаты только первого слоя

пагинацию

через указанные ниже параметры.

агрегатов

Значение по умолчанию: false

childrenPage

number

Число страниц

Значение по умолчанию: 1

вложений

агрегата первого

слоя

childrenLimit

number

Количество

Значение по умолчанию: 50

вложений на

странице агрегата

первого слоя

cisId

string

КИ

string

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

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

товарных групп:

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

water - "Упакованная вода"

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

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

238

{

"cis": "string",

"gtin": "string",

"producerName": "string",

"status": "EMITTED",

"emissionDate": 0,

"producedDate": 0,

"packType": "UNIT",

"ownerName": "string",

"ownerInn": "string",

"productName": "string",

"brand": "string",

"prevCises": [

"string"

"nextCises": [

"string"

"statusEx": "EMPTY",

"children": [

null

"countChildren": 0,

"parent": "string",

"lastDocId": "string",

"expireDate": 0,

"prVetDocument": "string",

"introducedDate": 0,

"exporterName": "string",

"exporterTaxpayerId": "string",

"agentName": "string",

"agentInn": "string",

"lastStatusChangeDate": 0,

"turnoverType": "SELLING",

"productGroup": "string",

"tnVed10": "string"

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

cis

string

КИ,

используемый для

фильтрации по

списку КИ

gtin

string

Код товара

producerNam

string

Производитель

товара

239

Параметр

Тип

Обяз.

Описание

Комментарий

status

enum

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

См. справочник "Актуальные статусы"

emissionDate

string

Дата выпуска КИ

Возвращается в формате yyyy-MM-

(date-

ddTHH:mm:ss.SSS’Z

time)

producedDate

string

Дата нанесения

Возвращается в формате yyyy-MM-

(date-

ddTHH:mm:ss.SSS’Z

time)

packType

string

Тип упаковки

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

ownerName

string

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

собственника

товара

ownerInn

string

ИНН

собственника

товара

productName

string

Название

продукта

brand

string

Бренд

prevCises

[string]

Предыдущие

номера КИ. В

случае

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

товара

nextCises

[string]

Следующие

номера КИ. В

случае

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

товара

statusEx

enum

Актуальные

См. справочник "Актуальные статусы"

особые состояния

КИ

children

[string]

КИ в агрегате

countChildren

integer

Количество

(int32)

дочерних КИ

parent

string

КИТУ

вышестоящего

уровня

lastDocId

string

Последний

регистрационный

номер документа,

зафиксированный

в ГИС МТ по

этому КИ

240

Параметр

Тип

Обяз.

Описание

Комментарий

expireDate

string

Дата истечения

(date-

срока годности.

time)

Возвращается в

формате yyyy-

MM-

ddTHH:mm:ss.SSS

’Z (обязательный

для ТГ "Молочная

продукция")

prVetDocume

string

Обязательный параметр для ТГ

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

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

о ВСД (для

используется вместо устаревшего

продукции,

"prVetDoc"

произведённой в

РФ) или ID

транспортного

ВСД (для

продукции,

произведённой

вне РФ)

introducedDat

string

Дата ввода в

Возвращается в формате yyyy-MM-

(date-

оборот с КИ в

ddTHH:mm:ss.SSS’Z

time)

оборот

exporterName

string

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

экспортёра

exporterTaxp

string

уникальный

ayerId

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

экспортера в

национальной

системе учёта

налогоплательщи

ков

agentInn

string

ИНН текущего

Возвращается при использовании токена

владельца товара

администратора

agentName

string

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

Возвращается при использовании токена

текущего

администратора

владельца товара

lastStatusCha

string

Дата последнего

Возвращается в формате yyyy-MM-

ngeDate

(date-

изменения статуса

ddTHH:mm:ss.SSS’Z

time)

turnoverType

enum

Вид

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

товарооборота

продажа; COMMISSION

(COMMISSIONAIRE_SALE - устар.) -

комиссия; AGENT - агент

241

Параметр

Тип

Обяз.

Описание

Комментарий

productGroup

string

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

Cм. "Справочник "Список

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

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

Данный метод отражает КИ, которые когда-либо были в документе, а также агрегаты, на которые

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

URL: /facade/cis/docNum/{docNum}

Метод: GET

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

curl -X GET '<url стенда v4>/facade/cis/docNum/186161351"

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

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

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

Параметр

Тип

Обяз.

Описание

docNum

string

Номер документа

string

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

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

групп:

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

water - "Упакованная вода"

В ответ возвращается список КИ по номеру документа

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

[

"string"

]

2.25. Метод поиска содержимого документа по

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

Для документа с типом LP_FTS_INTRODUCE_RESPONSE (см. "Справочник "Типы

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

типом IS_MP_OPERATOR (Оператор ГИС МТ) и OGV (Орган государственной власти), см

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

URL: /facade/doc/{docId}/content

242

Метод: GET

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

curl -X GET '<url стенда>/facade/doc/{docId}/content"

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

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

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

Параметр

Тип

Обяз.

Описание

docId

string

Номер документа

string

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

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

групп:

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

water - "Упакованная вода"

В ответ возвращается содержимое документа.

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

[

"string"

]

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

Метод осуществляет поиск товаров c учётом области видимости пользователя и возвращает

информацию о товаре.

URL: /product/search

Метод: GET

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

curl -X GET '<url стенда>/product/search?

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

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

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

Параметр

Тип

Обяз.

Описание

gtin

string

Код товара

243

Параметр

Тип

Обяз.

Описание

string

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

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

групп:

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

water - "Упакованная вода"

limit

integer

Значение устанавливает количество записей в

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

10 записей)

offset

integer

Позиция смещения в наборе результатов для

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

page

integer

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

direction

string

Сортировка:

ASC - устанавливает порядок сортирования во

возрастанию, от меньших значений к большим;

DECS - устанавливает порядок сортирования

по убыванию, от больших значений к меньшим

sort

string

Сортировка по полю

brand

string

Бренд

productTypeDesc

string

Текстовое описание вида обуви

inn

string

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

country

string

Страна производства

includeSubaccount

boolean

Признак отображения информации о товарах, к

которым участнику оборота товаров

предоставлен доступ

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

244

{

"results": [

{

"id": 15122219,

"name": "Набор духов 1",

"gtin": "09785845910745",

"brand": "Духи",

"packageType": "UNDEFINED",

"innerUnitCount": 1,

"inn": "0411168627",

"productGroupId": 4,

"goodSignedFlag": true,

"goodMarkFlag": true,

"goodTurnFlag": true,

"isKit": false,

"isTechGtin": false,

"isSet": true,

"setGtin": [

{

"gtin": "04664974393108",

"quantity": 2

{

"gtin": "04664974393436",

"quantity": 2

}

"fullName": "Набор духов 1",

"setDescription": "Описание",

"tnVedCode": "3303"

}

"total": 1,

"errorCode": null

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

results

array

Результат ответа

*id

integer

Уникальный

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

товара в БД КМТ

*name

string

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

товара

*gtin

string

Код товара

*brand

string

Бренд

245

Параметр

Тип

Обяз.

Описание

Комментарий

*packageType

string

Тип упаковки

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

*innerUnitCo

integer

Число

unt

экземпляров

товара

*inn

string

ИНН Российского

производителя

*productGrou

integer

Идентификатор

См. "Справочник "Список

pId

товарной группы

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

*goodSigned

boolean

Признак

Flag

подписания

карточки товара в

НК

*goodMarkFl

boolean

Признак

готовности к

маркировке

*goodTurnFla

boolean

Индикатор

Индикатор заполнения второго слоя

заполнения

карточки в НК. Если значение = true, то

второго слоя

можно заказать КМ и ввести товар в

карточки в НК

оборот

*isKit

boolean

Признак

"Комплект" по

карточке товара

*isTechGtin

boolean

Признак

"технологический

" по карточке

товара

*isSet

boolean

Признак "Набор"

по карточке

товара в НК

*setGtin

[array]

Код набора

Массив всегда возвращается в ответе,

если "packType" = "SET"

**gtin

string

Код товара,

входящего в

набор

**quantity

integer

Количество кодов

товара, входящих

в набор

*fullName

string

Полное

наименование

246

Параметр

Тип

Обяз.

Описание

Комментарий

*setDescriptio

string

Текстовое

Возвращается описание товара в составе

описание набора

набора, содержащее параметры,

специфичные для конкретного товара.

Данный параметр вернётся в том случае,

если он заполнен в карточке НК (см.

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

параметры в ответе в зависимости от

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

*tnVedCode

string

Код ТН ВЭД

total

number

Количество

найденных

карточек товара

errorCode

string

Код ошибки.При

наличии ошибки

3. Подача сведений в систему ГИС МТ через

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

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

URL: /lk/documents/create

Метод: POST

Тип приватности: приватный

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

POST <url стенда>/lk/documents/create?pg=lp

Authorization: Bearer <ТОКЕН>

Content-Type: application/json

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

Параметр

Тип

Обяз.

Описание

Комментарий

string

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

Cм. "Справочник "Список

поддерживаемых товарных

групп"". В параметре

указывается кодовый

идентификатор товарной группы

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

247

{

"document_format":"string",

"product_document":"<Документ в формате base64>",

"type":"string",

"signature":"<Открепленная УКЭП формата Base64>"

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

document_format

string

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

Значения:

MANUAL - формат * .json;

XML - формат * .xml;

CSV - формат * .csv

product_document

string

Тело формируемого

документа,

переведённое в base64

signature

string

Откреплённая подпись

(УКЭП) в формате

base64

signExt

string

Откреплённая УКЭП

Оператора РБ,

закодированная в

base64

type

string

Код типа документа

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

документов""

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

1. Код

200,

201. В случае успешного создания документа в ответ приходит уникальный

идентификатор документа в ГИС МТ.

2. В случае ошибок:

2.1. Код 401, если не указан токен:

{

"error_message":"Для доступа к этому ресурсу требуется полная аутентификация.

Проверьте токен"

}

2.2. Код 400 при неверной структуре JSON в теле запроса:

248

{

"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.4. Код 400 при отсутствии тела запроса:

{

"error_message": "Required request body is missing: <описание ошибки>"

}

2.5. Код 400, если не указана товарная группа:

{

"error_message": "Отсутствует обязательный параметр: pg"

}

2.6. Код 403 при недоступности функционала ТГ, когда есть тело ответа от ЛП-компонента:

249

{

"error_message": "Перемаркировка недоступна для товарной группы <Наименование

ТГ>"

}

2.7. Код 403 при недоступности функционала ТГ, когда нет тела ответа от компонента ТГ:

{

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

}

2.8. Код 400 при параметре URL запроса "pg" = "tobacco":

{

"error_message": "Метод не работает с товарной группой табак"

}

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

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

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

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

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

3.2.1.1. Агрегация

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

средства", "Безалкогольное пиво", "Биологически активные добавки к пище", "Велосипеды и

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

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

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

продукция и безалкогольные напитки", "Упакованная вода", "Фотокамеры (кроме кинокамер),

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

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

Тип

Описание

AGGREGATION_DOCUMENT

Агрегирование. JSON (MANUAL)

AGGREGATION_DOCUMENT_CSV

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

AGGREGATION_DOCUMENT_XML

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

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

250

{

"participantId": "string",

"aggregationUnits": [

{

"unitSerialNumber": "string",

"aggregationType": "string",

"sntins": [

"string"

]

}

]

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantId

string

ИНН участника

оборота товаров

aggregationUnits

array

Список формируемых

агрегатов

*unitSerialNumber

string

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

КИ может содержать от 18 до 74

агрегата

символов включительно: цифры,

буквы латинского алфавита,

спецсимволы (A-Z a-z 0-9 % & '

" ( ) * + , - _ . / : ; < = > ? !). В

рамках одного документа

указываются КИ агрегата одной

длины

*aggregationType

string

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

Значение может быть только

AGGREGATION ("Агрегация")

*sntins

array[stri

Список КИ, входящих

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

ng]

в агрегат

должны быть идентичны. В

рамках одного документа список

КИ, входящих в агрегат, могут

быть разной длины

Примечание:

• агрегация может осуществляться как до ввода в оборот, так и после ввода в оборот. Если

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

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

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

может осуществляться только после ввода в оборот;

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

составе КИТУ, то набор должен иметь вложения и быть в статусе "В обороте" или

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

• в одном документе указываются КИ агрегатов одной длины. Длина КИ вложений агрегатов

251

может отличаться.

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

Тип документа,ИНН участника оборота товаров,Версия

Документ на агрегацию,5834052090,2

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

УИТУ,Вложеннный УИТ/УИТУ

000000000000000002,000000000000000005

000000000000000002,00000000000000000000000000000000000000

000000000000000000,00000000000000000000000000000000000001

000000000000000001,00000000000000000000000000000000000002

000000000000000000,"010466007901460321&%*^$!?""'()*+-=/,;.:<>_1"

000000000000000002,"010466007901460321&%*^$!?""'()*+-=/,;.:<>_2"

000000000000000001,000000000000000002

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

<?xml version="1.0" encoding="UTF-8"?>

<unit_pack document_id="unit_pack_7FFF90D5-4785-7EC9-899E-534A7BAA2B71" VerForm="1.03"

file_date_time="2019-04-12T11:07:45+03:00" VerProg="VerProg1">

<Document operation_date_time="2019-06-05T14:28:14+03:00" document_number="157743-

20199">

<id_info>

<LP_info org_name="ООО ТорМаг" LP_TIN="5834052090" RRC="504801001" />

</id_info>

<location_address country_code="643" text_address="142305" />

</Address>

</organisation>

<pack_content>

<pack_code>000000000000000000</pack_code>

</pack_content>

<pack_content>

<pack_code>010464004346008721Wll2KePM3hlHCrXDM-+B</pack_code>

</pack_content>

</Document>

</unit_pack>

252

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

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

средства", "Безалкогольное пиво", "Биологически активные добавки к пище", "Велосипеды и

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

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

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

продукция и безалкогольные напитки", "Упакованная вода", "Фотокамеры (кроме кинокамер),

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

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

Тип

Описание

REAGGREGATION_DOCUMENT

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

REAGGREGATION_DOCUMENT_CSV

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

REAGGREGATION_DOCUMENT_XML

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

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

{

"participant_inn": "string" ,

"reaggregation_type": "string" ,

"uit_uitu_list": [

{

"uit_uitu": "string",

"name": "string"

}

] ,

"uitu": "string"

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника

оборота товара

reaggregation_type

string

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

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

REMOVING - изъятие;

ADDING - добавление

uitu

string

Код модифицируемого

агрегата

uit_uitu_list

array

Список агрегатов для

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

253

Параметр

Тип

Обяз.

Описание

Комментарий

*uit_uitu

string

КИ для

При трансформации агрегата,

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

содержащего КИ в статусе

APPLIED ("Эмитирован.

Получен"), тип эмиссии

добавляемых КИ должен

совпадать с типом эмиссии КИ,

вложенных в агрегат (см.

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

КИ""). КИ в агрегате должны

находиться в одном статусе (см.

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

КИ, находящиеся в особом

состоянии (см. "Актуальные

статусы"), нельзя агрегировать и

трансформировать

*name

string

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

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

ИНН участника оборота,Тип трансформации,Код идентификации трансформируемой

транспортной упаковки(КИТУ),Версия

0000000000,Изъятие,000000000000000000,2

Список транспортных упаковок или товаров

КИ,КИТУ

"00000000000000000000000000000000000000",

"11111111111111111111111111111111111111",

,"222222222222222222"

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

<?xml version="1.0" encoding="UTF-8"?>

<trade_participant_inn>0000000000</trade_participant_inn>

<reaggregation_type>REMOVING</reaggregation_type>

<reaggregating_kitu>000000000000000000</reaggregating_kitu>

<product_list>

<packing_product>

</packing_product>

<packing_product>

</packing_product>

<packing_product>

</packing_product>

</product_list>

</reaggregation>

254

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

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

средства", "Безалкогольное пиво", "Биологически активные добавки к пище", "Велосипеды и

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

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

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

продукция и безалкогольные напитки", "Упакованная вода", "Фотокамеры (кроме кинокамер),

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

Автоматическое расформирование агрегата происходит при любых действиях с КИ в составе

КИТУ, за исключением случаев подачи сведений о цвете и размере в документе ввода в оборот

импортного товара при взаимодействии с ФТС ("Ввод в оборот. Импорт с ФТС"). При агрегации

КИ не должен входить в состав агрегата.

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

Тип

Описание

DISAGGREGATION_DOCUMENT

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

DISAGGREGATION_DOCUMENT_CSV

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

DISAGGREGATION_DOCUMENT_XML

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

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

{

"participant_inn": "string",

"products_list": [

{

"uitu": "string"

}

]

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participant_inn

string

ИНН участника

оборота товара

products_list

array

Список сведений о

товарах

*uitu

string

Код

расформировываемого

агрегата

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

255

ИНН участника оборота,Версия

0000000000,2

Список транспортных упаковок

"000000000000000000"

"111111111111111111"

"222222222222222222"

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

<trade_participant_inn>0000000000</trade_participant_inn>

<packings_list>

</packing>

</packing>

</packing>

</packing>

</packing>

</packings_list>

</disaggregation>

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

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

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

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

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

Возможность создания КИН доступна только участнику оборота товаров, эмитировавшему коды

формируемого набора.

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

Тип

Описание

SETS_AGGREGATION

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

SETS_AGGREGATION_CSV

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

SETS_AGGREGATION_XML

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

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

256

{

"participantId":"7777777777",

"aggregationUnits":[

{

"unitSerialNumber":"010461111111111121LLLLLLLLLLLLL",

"aggregationType":"SETS_AGGREGATION",

"sntins":[

"010462111111111121NNNNNNNNNNNNN"

]

}

]

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

participantId

string

ИНН участника

оборота товаров

aggregationUnits

array

Список формируемых

Набор не может содержать

наборов

агрегат или другой набор

*unitSerialNumber

string

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

КИН должен быть в статусе

набора

"Эмитирован. Получен"

(APPLIED) для всех групп,

кроме товарной группы

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

товарной группы "Молочная

продукция" КИН должен быть в

статусе "Эмитирован. Получен"

(APPLIED) или "В обороте"

(INTRODUCED).

КИН может содержать от 18 до

74 символов включительно:

цифры, буквы латинского

алфавита, спецсимволы (A-Z a-z

0-9 % & ' " ( ) * + , - _ . / : ; < = >

? !).

В текущей реализации импорт

наборов не поддерживается

*aggregationType

string

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

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

SETS_AGGREGATION

("Формирование наборов")

257

Параметр

Тип

Обяз.

Описание

Комментарий

*sntins

array[stri

Список КИ и/или

В набор могут быть вложены

ng]

КИК, входящих в

только единица товара (UNIT)

набор

или комплект (BUNDLE).

Если КИН с типом эмиссии

"Произведен в РФ" (LOCAL),

или "Маркировка остатков"

(REMAINS), или "Принят на

комиссию от физического лица"

(COMMISSION), то КИ и/или

КИК, входящие в набор, могут

быть в статусе "Эмитирован.

Получен" (APPLIED) или "В

обороте" (INTRODUCED).

Если статус КИ и/или КИК,

входящих в набор, "Эмитирован.

Получен", то тип эмиссии КИН

и КИ и/или КИК должен

совпадать.

Если статус КИ и/или КИК,

входящих в набор, "В обороте",

то тип эмиссии КИН и КИ и/или

КИК может не совпадать. В

результате успешного

формирования такого набора

статус КИН будет изменён на "В

обороте".

Тип эмиссии "Принят на

комиссию от физического лица"

(COMMISSION) доступен для

товарной группы "Предметы

одежды, бельё постельное,

столовое, туалетное и

кухонное". Для товарных групп

"Духи и туалетная вода" и

"Фотокамеры (кроме

кинокамер), фотовспышки и

лампы-вспышки" при заказе КИ

для товаров, принятых на

комиссию от физического лица,

указывается тип эмиссии

"Произведен в РФ" (LOCAL).

Для товарной группы "Молочная

продукция" ВСД заполняется

только у дочерних КИ.

258

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

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

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

набор с ошибочно добавленными КИ и/или КИК, создать документ "Расформирование". После

расформирования набора с ошибочно добавленными КИ и/или КИК набор можно сформировать

повторно.

При поступлении чека или документа о продаже КИ, вложенных в КИН, происходит

автоматическое расформирование КИН. Вывод КИН из оборота производится только через авто

расформирование. Пустой КИН выводится из оборота путём подачи сведений о списании не

нанесённого КИ в ЛК или через API.

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

Тип документа,ИНН участника оборота товаров

Документ на формирование наборов,7777777777

УИТУ,Вложеннный УИТ/УИТУ

"010461111111111121?k+""""slCt/;XBJ-qa-bjO",010462111111111121oEyImWqXq;Lex'Li6-)L

010461111111111121hcpPtfseNdA&oUeZsY:A,010462111111111121SyFOHTMHt6OQ6/nAUS4F

"010461111111111121O>bA5F:aheNT-xWVLI'<","010462111111111121cP_+eTv+Y*BEe9DGTkbf"

При заполнении файла в формате * .csv в поле "УИТУ" указывается КИН. В поле "Вложенный

УИТ/УИТУ" указывается КИ или КИК, входящий в набор. Если несколько КИ и/или КИК входят

в один набор, то КИН дублируется в следующей строке с указанием нового КИ или КИК,

вложенного в этот набор.

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

259

<?xml version="1.0" encoding="UTF-8"?>

<unit_pack document_id="unit_pack_1FFF11D1-1111-1EC1-111E-111A1BAA1B11" VerForm="1.03"

file_date_time="2021-04-12T11:07:45+03:00" VerProg="VerProg1" action_id="30"

version="1">

<Document operation_date_time="2021-06-05T14:28:14+03:00" document_number="111111-

22222">

<id_info>

<LP_info org_name="ООО XXX" LP_TIN="7777777777" RRC="555555555" />

</id_info>

<location_address country_code="643" text_address="142305" />

</Address>

</organisation>

<pack_content>

<pack_code>0104611111111111LLLLLLLLLLLLl</pack_code>

<cis>010462111111111121NNNNNNNNNNNNn</cis>

</pack_content>

<pack_content>

<pack_code>0104611111111111LLLLLLLLLLLLL</pack_code>

<cis>010462111111111121NNNNNNNNNNNNN</cis>

</pack_content>

</Document>

</unit_pack>

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

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

Создание документа доступно для товарных групп "Альтернативная табачная продукция",

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

и туалетная вода", "Медицинские изделия", "Молочная продукция", "Никотиносодержащая

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

кухонное", "Табачная продукция", "Упакованная вода", "Фотокамеры (кроме кинокамер),

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

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

и "Табачная продукция" создание документа доступно только в форматах * .json и * .xml.

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

изменений в Решение Комиссии Таможенного союза "О форме декларации на товары и порядке

её заполнения" от 20.05.2010 № 257 (ред. от 17.12.2019).

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

Тип

Описание

ATK_AGGREGATION

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

ATK_AGGREGATION_CSV

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

260

Тип

Описание

ATK_AGGREGATION_XML

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

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

{

"trade_participant_inn": "1111111111",

"products_list": [

{

"ki": "11111111111111111111111111111111111111"

{

"ki": "22222222222222222222222222222222222222"

}

]

}

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

Параметр

Тип

Обяз.

Описание

Комментарий

trade_participant_i

string

ИНН участника

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

оборота товаров

быть с типом организации

"IMPORTER" ("Импортёр

товара") и являться

собственником КИ, КИГУ, КИК

products_list

array

Массив, содержащий

В массиве должен быть указан

список КИ, или КИК,

хотя бы один КИ, КИ должны

или КИГУ,

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

агрегируемых в АТК

одной товарной группе и иметь

один код ТН ВЭД ЕАЭС (первые

4 цифры)

261

Параметр

Тип

Обяз.

Описание

Комментарий

*ki

string

КИ

КИ должен быть с типом

эмиссии "FOREIGN" ("Ввезён в

РФ") и находиться в статусе

"APPLIED" ("Эмитирован.

Получен" для всех товарных

групп, кроме "Альтернативная

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

"Никотиносодержащая

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

продукция" / "Нанесён" для

товарных групп

"Альтернативная табачная

продукция",

"Никотиносодержащая

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

продукция") без особого

состояния или с особым

состоянием

"FTS_RESPOND_NOT_OK"

("Отрицательное решение

ФТС"). Допустимые типы КИ:

КИ, КИГУ, КИК.

Не допускается указание КИ,

КИГУ, КИК, вложенных в

другой агрегат

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

ИНН участника оборота,Версия

1111111111,1

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

КИ

11111111111111111111111111111111111111

22222222222222222222222222222222222222

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

• для документа в формате * .csv существует ограничение при подаче сведений о вводе в

оборот молочной продукции, ввезённой в РФ: доступно указание только КИ агрегатов,

вложения которых имеют признак подконтрольности "НЕТ", указанный при создании

карточки товара в "Национальном каталоге". Если вложения агрегатов имеют признак

подконтрольности "ДА", для подачи сведений использовать документы в формате * .json или

* .xml.

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

262

<atk_aggregation version="1">

<trade_participant_inn>1111111111</trade_participant_inn>

<product_list>

<packing_product>

</packing_product>

<packing_product>

</packing_product>

</product_list>

</atk_aggregation>

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