Будет обновлена логика получения единого токена аутентификации в формате UUID. Эта доработка позволит совершить переход с формата JWT на токен в более коротком формате UUID.
Поддержка токена в формате JWT будет сохранена до конца 2026 года.
|
Обратите внимание
|
|
Планируется:
Реализовано:
▪️ Подробный отчёт по карточкам товаров для стройматериалов.
Описание реализации см. в True API v.644.0 от 03.04.2026.
Для просмотра полной истории изменений по документу перейдите в раздел «Изменения в предыдущих версиях документа».
Затронутые товарные группы
Все товарные группы
Бизнес-контекст
Будет обновлена логика получения единого токена аутентификации в формате UUID. Эта доработка позволит совершить переход с формата JWT на токен в более коротком формате UUID.
Поддержка токена в формате JWT будет сохранена до конца 2026 года.
Изменение в True API
🔄 Изменения в методах:
«Запрос авторизации при единой аутентификации» (/auth/key)
«Получение ключа сессии при единой аутентификации» (/auth/simpleSignIn)
Подробности
Изменения, планируемые к реализации, в методе «Запрос авторизации при единой аутентификации» (/auth/key):
для получения токена авторизации в формате UUID необходимо будет запрашивать получение уникальной пары c помощью метода «Запрос авторизации при единой аутентификации» (/auth/key): UUID (идентификатора текущей аутентификации) и сгенерированные случайные данные, которые подписываются УКЭП пользователя организации, отправляющего запрос;
поддержка текущей логики для токена в формате UUID (без предварительного запроса на получение уникальной пары методом «Запрос авторизации при единой аутентификации» (/auth/key)) сохранится до сентября 2026 года.
Изменения, планируемые к реализации, в методе «Получение ключа сессии при единой аутентификации» (/auth/simpleSignIn):
для пользователей, которые используют токен в формате JWT и только будут переходить на получение токена авторизации в формате UUID:
изменятся требования к заполнению параметра тела запроса для получения токена:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
inn | string | - | ИНН организации, под которой требуется авторизация. Длина значения: 10 или 12 цифр | Обязательно указывается ИНН организации, если у физического лица (пользователя организации) есть действующая МЧД для получения доступа к ГИС МТ. В остальных случаях параметр необязателен |
будет добавлен параметр тела запроса:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
unitedToken | boolean | - | Признак запроса единого токена в виде uuid | Обязательно заполнен при получении токена в формате UUID. Возможные значения: true — запрос токена в формате UUID (единый токен аутентификации); |
будут добавлены параметры ответа:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
uuidToken | string | - | Аутентификационный токен в виде uuid | Возвращается в случае успешного ответа при запросе токена в формате UUID |
expireDate | string | - | Дата и время истечения срока действия токена | Возвращается только при запросе токена в формате UUID. Формат: yyyy-MM-ddTHH:mm:ss.SSSZ Пример: 2026-10-10T00:00:00.123Z |
для пользователей, которые уже перешли на получение токена авторизации в формате UUID:
изменятся требования к заполнению параметров тела запроса для получения токена:
| Параметр | Тип | Описание | Как есть (для UUID) | Как будет (для UUID) |
|---|---|---|---|---|
uuid | string | Уникальный идентификатор подписанных случайных данных | Необязательный | Обязательный |
data | string | Подписанные УКЭП зарегистрированного участника оборота товаров случайные данные в base64 (присоединённая электронная подпись) | Если «unitedToken» = «true», передаётся одно из значений:
| Передаётся подписанная |
inn | string | ИНН организации, под которой требуется авторизация пользователя. Длина значения: 10 или 12 цифр | При «unitedToken» = «true» строго не заполнен | Обязательно указывается ИНН организации, если у физического лица (пользователя организации) есть действующая МЧД для получения доступа к ГИС МТ. В остальных случаях параметр необязателен |
будет добавлен параметр ответа:
| Параметр | Тип | Об яз. | Описание | Комментарий |
|---|---|---|---|---|
expireDate | string | - | Дата и время истечения срока действия токена | Возвращается только при запросе токена в формате UUID. Формат: yyyy-MM-ddTHH:mm:ss.SSSZ Пример: 2026-10-10T00:00:00.123Z |
какие ещё особенности работы с токеном будут реализованы:
cрок действия токена в формате UUID будет составлять 10 часов с момента получения. При этом срок не сможет превышать дату и время окончания срока действия УКЭП и / или МЧД. Если МЧД, на основании которой пользователю будет предоставлен доступ к системе, будет отозвана, токен будет автоматически аннулирован;
при каждом запросе будет выдаваться новый токен (продления срока действия существующего токена не будет).
Описание методов см. в True API.
Затронутые товарные группы
Биологически активные добавки к пище (17 / bio)
Ветеринарные препараты (26 / vetpharma)
Духи и туалетная вода (4 / perfumery)
Косметика, бытовая химия и товары личной гигиены (35 / chemistry)
Бизнес-контекст
Будет доступен импорт из Республики Армения в режиме взаимного признания кодов идентификации. Это значит, что Система маркировки будет обеспечивать получение, обработку и признание кодов маркировки, эмитированных в Системе маркировки Республики Армения, указанных в документе трансграничной отгрузки, полученном от Оператора Республики Армения.
Импорт будет реализован следующим образом:
Экспортёр из ЕАЭС формирует документ «Отгрузка из ЕАЭС с признанием КИ» (EAS_CROSSBORDER), в котором указывает передаваемые коды маркировки и их атрибуты.
Импортёр в РФ на основании полученного документа отгрузки формирует документ «Приёмка отгрузки из ЕАЭС» (LP_ACCEPT_GOODS) в одном из следующих вариантов:
полная приёмка;
частичная приёмка;
отказ от приёмки.
Импортёр в РФ может отредактировать в документе «Приёмка отгрузки из ЕАЭС» (LP_ACCEPT_GOODS) атрибуты по каждому коду маркировки, переданному в документе отгрузки.
При успешной обработке документа «Приёмка отгрузки из ЕАЭС» (LP_ACCEPT_GOODS) импортёр становится владельцем кодов маркировки, а статус кодов меняется на В обороте.
Изменение в True API
✅ Откроется документ: «Приёмка отгрузки из ЕАЭС» (LP_ACCEPT_GOODS) на документ «Отгрузка из ЕАЭС с признанием КИ» (EAS_CROSSBORDER)
Подробности
Отличительные особенности, планируемые к реализации:
параметр certificate_document_data (Массив, содержащий данные документов, подтверждающих соответствие) будет обязательным для товарных групп «Биологически активные добавки к пище» и «Ветеринарные препараты»;
подача документа будет доступна только в формате * .json.
Описание документов см. в True API.
Затронутые товарные группы
Биологически активные добавки к пище (17 / bio)
Ветеринарные препараты (26 / vetpharma)
Духи и туалетная вода (4 / perfumery)
Косметика, бытовая химия и товары личной гигиены (35 / chemistry)
Бизнес-контекст
Будет реализован новый п роцесс экспорта в режиме взаимного признания кодов маркировки в Республику Армения:
Маркированный товар передаётся экспортёром на территории РФ с помощью документа «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT) в формате * .json.
Импортёр из страны ЕАЭС подаёт документ приёмки, который содержит сведения о принимаемых товарах, указанных в документе отгрузки. После успешной обработки документа принятые коды маркировки становятся доступны для оборота на территории страны ЕАЭС, а экспортёру из РФ для просмотра доступен документ «Приёмка в ЕАЭС» (EAS_CROSSBORDER_EXPORT_ACCEPTANCE).
Изменение в True API
✅ Откроется документ «Отгрузка в ЕАЭС» (EAS_CROSSBORDER_EXPORT)
Подробности
Отличительные особенности, планируемые к реализации:
в массив объектов products (Массив, содержащий список передаваемых КИ) будут добавлены параметры:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
*batch_number | string | - | Номер серии товара | Обязательный для товарной группы «Ветеринарные препараты». Для остальных товарных групп — строго не заполнен. Значение не более 30 символов с учётом пробелов (цифры, буквы (латиница, кириллица), спецсимволы (/ . , -)) |
*alco_content | decimal | - | Фактическое содержание этилового спирта | Обязательный для товарной группы «Косметика, бытовая химия и товары личной гигиены», для остальных товарных групп — строго не заполнен. Формат:
Если этиловый спирт отсутствует, указывается значение «0» |
параметр production_date (Дата производства) обязательный для товарных групп «Биологически активные добавки к пище», «Ветеринарные препараты», «Косметика, бытовая химия и товары личной гигиены» и необязательный для товарной группы «Духи и туалетная вода»;
параметр expiration_date (Дата истечения срока годности) обязательный для товарных групп «Биологически активные добавки к пище», «Ветеринарные препараты», «Косметика, бытовая химия и товары личной гигиены» и строго не заполнен для товарной группы «Духи и туалетная вода»;
параметр certificate_document_data (Массив, содержащий данные документов, подтверждающих соответствие) обязательный для товарной группы «Ветеринарные препараты»;
подача документа будет доступна только в формате * .json.
Описание документов см. в True API.
Затронутые товарные группы
Игры и игрушки для детей (27 / toys)
Бизнес-контекст
Будет включена проверка наличия и статуса разрешительных документов при вводе в оборот остатков. Это позволит поддерживать актуальность сведений о разрешительных документах, содержащихся в Системе маркировки, для кодов.
Изменение в True API
🔄 Изменения в документе: «Ввод в оборот. Остатки» (LP_INTRODUCE_OST)
Подробности
При вводе в оборот остатков единиц товаров, в том числе вложенных в агрегат, будет проверяться наличие и статус разрешительного документа.
Проверка будет осуществляться последовательно:
Сначала разрешительный документ проверяется в документе «Ввод в оборот. Остатки» (LP_INTRODUCE_OST).
При отсутствии сведений в документе — проверяются уже существующие данные о разрешительных документах, указанные в Системе маркировки для кода.
Если данных о разрешительных документах нет ни в документе, ни в Системе маркировки, будет происходить проверка сведений в карточке товара в НКМТ. Если в карточке товара в параметре «Требования подтверждения соответствия отсутствуют; основание» — значение «ДА», проверки будут отсутствовать.
Ввод в оборот завершится с ошибкой, если хотя бы для одного кода разрешительный документ:
не будет найден ни на одном из этапов;
будет недействительным.
Описание документа см. в True API.
Затронутые товарные группы
Молочная продукция (8 / milk)
Бизнес-контекст
При формировании групповой упаковки будет проверяться номер партии товара: он должен быть идентичным у всех вложений. Это исключит вероятность добавления единиц товаров с разными номерами партий и позволит автоматически присвоить номер партии для сформированной групповой упаковки.
Изменение в True API
🔄 Изменение в документе: «Формирование упаковки» (AGGREGATION_DOCUMENT)
Затронутые товарные группы
Моторные масла (43 / autofluids)
Бизнес-контекст
Планируется реализация упрощённого процесса импорта моторных масел в Российскую Федерацию из Кыргызской Республики.
Будет реализована следующая схема для импорта товаров:
Экспортёр из Кыргызской Республики описывает товар в Национальном каталоге и заказывает российские коды маркировки через Систему маркировки Кыргызской Республики.
Далее экспортёр наносит коды маркировки на товары и подаёт в Систему маркировки Кыргызской Республики сведения о трансграничном перемещении товаров. Эти сведения импортёр сможет посмотреть в Системе маркировки РФ в документе «Отгрузка из ЕАЭС» (LP_SHIP_GOODS_CROSSBORDER).
Импортёр подаёт в Систему маркировки РФ документ «Приёмка» (LP_ACCEPT_GOODS), который содержит сведения о приёмке товаров, указанных в документе отгрузки. После успешной обработки документа приёмки принятые коды маркировки будут введены в оборот.
Изменение в True API
✅ Откроется документ: «Приёмка отгрузки из ЕАЭС» (LP_ACCEPT_GOODS) на документ «Отгрузка из ЕАЭС» (LP_SHIP_GOODS_CROSSBORDER)
Подробности
Тре бования к заполнению параметров в документе «Приёмка отгрузки из ЕАЭС» (LP_ACCEPT_GOODS) аналогичны требованиям, применимым при импорте товаров из Республики Беларусь.
Описание документов см. в True API.
Затронутые товарные группы
Консервированная продукция (32 / conserve)
Бизнес-контекст
Для консервов станет доступно получение сведений по виртуальному складу с помощью метода формирования выгрузки через True API. Это позволит участникам оборота товаров контролировать остатки и отслеживать движение товаров на складе.
Изменение в True API
✅ Откроется метод: «Получение сведений по виртуальному складу, включая партионный учёт» (dispenser/tasks)
Затронутые товарные группы
Все товарные группы
Бизнес-контекст
При формировании запроса списка документов необходимо будет задать период, за который запрашиваются данные, либо указать дополнительные параметры отбора.
Изменение направлено на повышение стабильности и производительности метода при работе с большими объёмами документов.
Изменение в True API
🔄 Изменения в методе: «Метод получения списка загруженных документов в ГИС МТ» (/api/v4/true-api/doc/list)
Подробности
Изменяется логика использования параметров строки запроса dateFrom (Дата документа, от) и dateTo (Дата документа, до):
Параметры должны будут передаваться только вместе. Указание только одного из них недопустимо.
Параметры будут обязательными, если в строке запроса:
не указан ни один из параметров: documentStatus (Статус документа), documentType (Тип документа), number (Идентификатор документа);
а также не указана пара documentFormat (Формат документа) и senderInn (ИНН отправителя документа) или documentFormat и receiverInn (ИНН получателя документа).
Кроме того, диапазон между dateFrom и dateTo будет ограничен.
При невыполнении этих условий метод вернёт ошибку.
Описание метода см. в True API.
Затронутые товарные группы
Молочная продукция (8 / milk)
Бизнес-контекст
На виртуальном складе будет добавлена информация о партиях, что позволит отслеживать молочную продукцию по конкретному номеру партии.
Изменение в True API
🔄 Изменения в методах:
«Метод получения актуального баланса на складе» (/warehouse/balance)
«Метод получения списка операций на складе» (/warehouse/operations)
Подробности
В метод «Метод получения актуального баланса на складе» (/warehouse/balance) будут добавлены:
опциональные параметры запроса:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
partNumbers | array of strings | - | Массив номеров партий | Применяется для товарной группы «Молочная продукция». Максимальное количество номеров партий — 50 |
customGroupBy | array of strings | - | Массив cо значениями признаков группировки | Применяется для товарной группы «Молочная продукция». Обязательно заполнен, если заполнен |
опциональный параметр ответа в массив balances:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
*partNumber | string | - | Номер партии | Возвращается, если в теле запроса был заполнен |
В метод «Метод получения списка операций на складе» (/warehouse/operations) будут добавлены:
опциональные параметры запроса:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
partNumbers | array of strings | - | Массив номеров партий | Применяется для товарной группы «Молочная продукция». Максимальное количество номеров партий — 50 |
customGroupBy | array of strings | - | Массив cо значениями признаков группировки | Применяется для товарной группы «Молочная продукция». Обязательно заполнен, если заполнен |
опциональный параметр ответа в массив operations:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
*partNumber | string | - | Номер партии | Возвращается, если в теле запроса был заполнен |
Описание методов см. в True API.
Затронутые товарные группы
Молочная продукция (8 / milk)
Бизнес-контекст
Сейчас учёт молочной продукции происходит через систему, ориентированную на прослеживаемость отдельных единиц продукции (например, каждая бутылка). В ближайшее время станет возможным использовать партионный учёт. Это значит, что можно будет отслеживать целые партии товара (например, весь объём молока, произведённый за определённый день из одной партии сырья).
Скоро вы сможете:
сгенерировать номера партий автоматически, либо указать вручную уже созданные номера из своей учётной системы;
отслеживать свои номера зарезервированных партий товаров в Системе маркировки.
Это нужно, чтобы вы могли:
планировать производство: заранее резервировать номера партий для будущего учёта продукции;
указывать собственные номера: использовать свои внутренние номера партий, которые удобны вам для внутреннего учёта;
автоматизировать процесс: в некоторых случаях автоматически генерировать уникальные номера партий в системе;
видеть свои партии: отслеживать зарезервированные, но не использованные партии.
Изменение в True API
✅ Открываются методы:
Метод предназначен для автоматической генерации номеров партий в Системе маркировки.
|
Важно
| Максимальный размер резерва — 1 000 партий. Если вы захотите удалить партии из резерва, то нужно будет обратиться в службу технической поддержки по телефону 8 (800) 222-15-23 или по электронной почте support@crpt.ru |
Тип приватности: приватный
Метод: POST
Пример тела запроса:
{
"pg": "milk",
"partyNumberInfo": [
{
"gtin": "04811111111111",
"productionDate": "2025-07-14T00:00:00.000Z",
"count": 1
},
{
"gtin": "04875777777777",
"productionDate": "2025-07-14T00:00:00.000Z",
"count": 1
}
]
}
Параметры тела запроса:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
pg | string | + | Товарная группа | Возможное значение: |
partyNumberInfo | array of objects | + | Набор параметров для генерации партий | Максимально допустимое значение — 50 |
*gtin | string | + | Код товара | |
*productionDate | string | + | Дата и время производства | Формат: yyyy-MM-ddTHH:mm:ss.SSSZ |
*count | integer | + | Количество номеров партий для генерации |
Пример ответа с кодом 200 в случае успеха:
{
"inn":"111111111111",
"receivedAt":"2025-07-14T00:00:00.000Z",
"partyNumberInfo":[
{
"partyNumber":"04867777774906140225JiMTBbbbJ6zB",
"gtin":"04811111111111",
"productionDate":"2025-07-14T00:00:00.000Z"
},
{
"partyNumber":"04865555554906140225JiMTMmMmJ6zB",
"gtin":"04875777777777",
"productionDate":"2025-07-14T00:00:00.000Z"
}
]
}
Примеры ответов в случае ошибок:
Код 400, если отсутствует обязательный параметр тела запроса:
{
"error_message": "Отсутствует обязательный параметр <название параметра>"
}
Код 400, если неверная структура * .json в теле запроса:
{
"error_message": "Некорректный JSON"
}
Код 401, если указан невалидный токен или валидный, но просроченный токен:
{
"error_message": "Токен не действителен. Необходимо получить новый токен аутентификации"
}
Код 403, если отсутствует доступ к ресурсу:
{
"error_message":"Отсутствует доступ к ресурсу"
}
Код 5XX: внутренняя ошибка сервиса.
Параметры ответа:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
inn | string | + | ИНН участника оборота товаров | |
receivedAt | string | - | Дата и время получения запроса | Формат: yyyy-MM-ddTHH:mm:ss.SSSZ |
partyNumberInfo | array of objects | - | Массив партий | |
*partyNumber | string | - | Номер партии | Номер партии состоит из трёх групп данных:
|
*gtin | string | - | Код товара | |
*productionDate | string | - | Дата и время производства | Формат: yyyy-MM-ddTHH:mm:ss.SSSZ |
errorMessage | string | - | Описание ошибки | Возвращается только при наличии ошибки при выполнении запроса |
errorResult | object | - | Результат обработки с ошибками | |
*partyNumber | array of strings | + | Список номеров партий | |
*gtin | array of strings | + | Список кодов товаров |
Метод предназначен для резервирования сгенерированных номеров партий вне Системы маркировки.
Тип приватности: приватный
Метод: POST
Пример тела запроса:
{
"pg": "milk",
"partyNumber": [
"04867777774906140225JiMTBbbbJ6zB",
"04865555554906140225JiMTMmMmJ6zB"
]
}
Параметры тела запроса:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
pg | string | + | Товарная группа | Возможное значение: |
partyNumber | array of strings | + | Список сгенерированных номеров партий | Максимально допустимое значение — 50. Номер партии состоит из трёх групп данных:
|
Пример ответа с кодом 200 в случае успеха:
{
"inn":"111111111111",
"receivedAt":"2025-07-14T00:00:00.000Z",
"partyNumberInfo":[
{
"partyNumber":"04867777774906140225JiMTBbbbJ6zB",
"gtin":"04811111111111",
"productionDate":"2025-07-14T00:00:00.000Z"
},
{
"partyNumber":"04865555554906140225JiMTMmMmJ6zB",
"gtin":"04875777777777",
"productionDate":"2025-07-14T00:00:00.000Z"
}
]
}
Примеры ответов в случае ошибок:
Код 400, если указаны неуникальные номера партий в теле запроса:
{
"errorMessage": "Переданы не уникальные номера партий",
"errorResult": [
{
"partyNumber": [
"04867777774906140225JiMTBbbbJ6zB",
"0000000000000000000055DMm40JnvJ0"
]
}
],
"inn": "111111111111",
"receivedAt": "2025-07-14T00:00:00.000Z"
}
Код 400, если отсутствует обязательный параметр тела запроса:
{
"error_message": "Отсутствует обязательный параметр <название параметра>"
}
Код 400, если указан некорректный тип данных параметра тела запроса:
{
"error_message": "Некорректный формат параметра запроса <название параметра>"
}
Код 400, если неверная структура * .json в теле запроса:
{
"error_message": "Некорректный JSON"
}
Код 401, если указан невалидный токен или валидный, но просроченный токен:
{
"error_message": "Токен не действителен. Необходимо получить новый токен аутентификации"
}
К од 403, если отсутствует доступ к ресурсу:
{
"error_message":"Отсутствует доступ к ресурсу"
}
Код 5XX: внутренняя ошибка сервиса.
Параметры ответа:
| Параметр | Тип | Обяз. | Описание | Комментарий |
|---|---|---|---|---|
inn | string | + | ИНН участника оборота товаров | |
receivedAt | string | - | Дата и время получения запроса | Формат: yyyy-MM-ddTHH:mm:ss.SSSZ |
partyNumberInfo | array of objects | - | Массив партий | |
*partyNumber | string | - | Номер партии | |
*gtin | string | - | Код товара | |
*productionDate | string | - | Дата и время производства | Формат: yyyy-MM-ddTHH:mm:ss.SSSZ |
errorMessage | string | - | Описание ошибки | Возвращается только при наличии ошибки при выполнении запроса |
errorResult | object | - | Результат обработки с ошибками | |
*partyNumber | array of strings | + | Список номеров партий | |
*gtin | array of strings | + | Список кодов товаров |
Метод предназначен для по лучения списка зарезервированных номеров партий.
Тип приватности: приватный
Метод: GET
Пример ответа с кодом 200 в случае успеха:
{
"partyNumberInfo":[
{
"createdDateTime":"2025-08-14T22:00:00.000Z",
"gtin":"04611111111111",
"partyNumber":"0104855555555555215NnNNn",
"productGroups":[
"milk"
],
"productionDate":"2024-12-25"
},
{
"createdDateTime":"2025-08-14T22:00:00.000Z",
"gtin":"04622222222222",
"partyNumber":"0104855555555555215NnNNn",
"productGroups":[
"milk"
],
"productionDate":"2024-12-25"
}
]
}
Примеры ответов в случае ошибок:
Код 400, если ошибка при получении данных:
{
"error_message": "Ошибка получения данных"
}
Код 401, если указан невалидный токен или валидный, но просроченный токен:
{
"error_message": "Токен не действителен. Необходимо получить новый токен аутентификации"
}
Код 403, если не соответствует роль:
{
"error_message":"Доступ запрещен. Роль не соответствует допустимой"
}
Код 429, если превышено количество запросов (количество запросов в секунду не должно превышать 10 от одного участник оборота товаров):
{
"error_message":"Превышен лимит запросов. Попробуйте повторить попытку через несколько минут."
}