Какие устаревшие методы True API отключены и чем их заменить

Если ваша учётная система обменивается данными с «Честным ЗНАКом» через True API, проверьте, не использует ли она устаревшие методы из списка ниже. Для каждого метода указана замена, а для регистрации участников — другой способ выполнения операции.

Поддержка перечисленных методов, отмеченных как «устаревшие», прекращена в сентябре 2023 года. Их техническая доступность ограничена для всех товарных групп на демонстрационном и промышленном контурах.

Если интеграция продолжает обращаться к этим методам, получение данных и связанные с ним рабочие операции могут прерываться. Сотрудникам придётся тратить время на выяснение причин и повторную обработку запросов.

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

Какие методы использовать вместо устаревших

Ниже сначала указан устаревший метод, затем — его альтернатива. При проверке интеграции сопоставляйте не только адрес запроса, но и HTTP-метод, версию API и формат данных: в некоторых случаях меняется не один параметр.

Коды ТН ВЭД и сведения о кодах идентификации

• Вместо «Метод получения списка десятизначных кодов ТН ВЭД» — GET /api/v3/true-api/facade/tnved/search — используйте «Метод получения списка десятизначных кодов ТН ВЭД» — POST /api/v4/true-api/tn-ved/search.

• Вместо «Метод получения краткой информации о списке КИ по заданному фильтру» — GET /api/v3/true-api/cises/listV2 — используйте «Метод получения информации о списке КИ по заданным фильтрам» — POST /api/v4/true-api/cises/search.

• Вместо «Метод получения подробной информации о списке КИ товаров по заданному фильтру» — GET /api/v3/true-api/products/listV2 — используйте «Метод получения информации о списке КИ по заданным фильтрам» — POST /api/v4/true-api/cises/search.

• Вместо «Запрос списка агрегированных КИ» — GET /api/v3/true-api/cises/aggregated/list — используйте «Метод запроса списка агрегированных КИ» — POST /api/v3/true-api/cises/aggregated/list.

Карточки товаров и информация по КИ и GTIN

Для устаревшего «Метод получения карточки товара по КИ» — GET /api/v3/true-api/products/info — замена зависит от того, какие сведения запрашиваются.

• Для запроса информации о коде используйте «Метод получения общедоступной информации о КИ по списку» — POST /api/v3/true-api/cises/info — или «Метод получения общедоступной информации о КИ по списку (упрощённый атрибутивный состав)» — POST /api/v3/true-api/cises/short/list.

• Для запроса информации о товаре используйте «Метод получения информации о товаре по GTIN товара» — POST /api/v4/true-api/product/info.

Для остальных запросов сведений о КИ и товарах предусмотрены следующие замены:

• Вместо «Метод получения информации о КИ по списку КИ при наличии согласия о предоставлении информации» — POST /api/v3/true-api/km-owner-api/cises — используйте «Метод получения общедоступной информации о КИ по списку» — POST /api/v3/true-api/cises/info.

Содержимое документов и чеков ККТ, списки загруженных документов

• Вместо «Метод получения содержимого документа по идентификатору» — GET /api/v3/true-api/doc/{docId}/info — используйте «Метод получения содержимого документа по идентификатору» — GET /api/v4/true-api/doc/{docId}/info.

• Вместо «Метод получения содержимого чека ККТ по идентификатору» — GET /api/v3/true-api/receipt/{receiptId}/info — используйте «Метод получения содержимого чека ККТ по идентификатору» — GET /api/v4/true-api/receipt/{receiptId}/info.

• Вместо «Метод получения списка загруженных документов в ГИС МТ» — GET /api/v3/true-api/doc/listV2 — используйте «Метод получения списка загруженных документов в ГИС МТ» — GET /api/v4/true-api/doc/list.

• Вместо «Метод получения списка загруженных чеков ККТ в ГИС МТ» — GET /api/v3/true-api/receipt/listV2 — используйте «Метод получения списка загруженных чеков ККТ на основании квитанций обработки» — POST /api/v3/true-api/receipt/search.

• Вместо «Метод получения содержимого документа по идентификатору» — GET /api/v3/true-api/documents/{document_id}/info — используйте «Метод получения содержимого документа по идентификатору» — GET /api/v4/true-api/doc/{docId}/info.

Регистрация участника оборота товаров

Для двух устаревших методов регистрации вместо API используется интерфейс Единого личного кабинета Системы маркировки:

• «Метод создания заявки на регистрацию участника оборота товаров» — POST /api/v3/true-api/elk/registration. Регистрация осуществляется с использованием интерфейса Единого личного кабинета Системы маркировки.
• «Метод проверки статуса заявки УОТ на регистрацию по ID заявки» — GET /api/v3/true-api/elk/documents/status/{documentId}. Регистрация осуществляется с использованием интерфейса Единого личного кабинета Системы маркировки.

Информация о товаре по GTIN и списание табачной продукции

• Вместо «Метод получения информации о товаре по GTIN товара» — GET /api/v3/true-api/product/info — используйте «Метод получения информации о товаре по GTIN товара» — POST /api/v4/true-api/product/info.

• Вместо «Списание («Табачная продукция»)» — POST /api/v3/true-api/documents/dropped-out/create — используйте «Единый метод создания документов» — POST /api/v3/lk/documents/create — с типом документа «Списание (общий документ)» (WRITE_OFF).

• Вместо «Метод получения кода товарной группы по КИ товара (GTIN)» — POST /api/v3/true-api/product/route/gtin — используйте «Метод получения информации о товаре по GTIN товара» — POST /api/v4/true-api/product/info.

Список чеков ККТ и формирование упаковки

• Вместо «Метод получения списка загруженных чеков ККТ в ГИС МТ» — GET /api/v4/true-api/receipt/list — используйте «Метод получения списка загруженных чеков ККТ на основании квитанций обработки» — POST /api/v3/true-api/receipt/search.

• Вместо «Формирования упаковки» в формате *.xml — POST /documents/aggregation/create — используйте «Формирования упаковки» в формате .JSON — POST /documents/aggregation/create.

Обратите внимание: у формирования упаковки адрес и HTTP-метод остаются прежними, но меняется формат данных. Кроме того, наличие версии v4 в адресе само по себе не означает, что метод подходит: GET /api/v4/true-api/receipt/list также входит в перечень устаревших.

Как организовать проверку интеграции

Следующие приёмы — рекомендации по организации работы, а не дополнительные требования «Честного ЗНАКа».

• Подготовьте список фактически используемых запросов. Попросите специалиста, который сопровождает интеграцию, сопоставить их с перечнем выше. Так получится определить объём изменений до начала доработок и не проверять заново каждый рабочий сценарий.
• Фиксируйте замену целиком. Для каждой операции запишите старый и новый HTTP-метод, адрес и, где он указан, формат или тип документа. Такая памятка позволит передать задачу разработчику без повторного сбора сведений.
• Разделите результаты проверки по контурам. Отдельно отмечайте, какие обращения проверены на демонстрационном и промышленном контурах. Это поможет видеть состояние каждой настройки, а не делать вывод обо всей интеграции по одной проверке.

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

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

Совет эксперта: оценивайте результат не только по тому, что запрос заменён, но и по тому, получает ли сотрудник нужные сведения для своей операции. Для карточки товара по КИ особенно важно заранее определить цель запроса: информация о коде и информация о товаре вынесены в разные варианты замены.

Главный итог проверки — для каждого используемого устаревшего метода определена соответствующая альтернатива, а операции регистрации перенесены в интерфейс Единого личного кабинета Системы маркировки. Следующий вопрос — как связать работу с маркировкой со сборкой и отгрузкой заказов без лишнего ручного контроля. На демонстрации SelSup можно разобрать ваш сценарий, посмотреть проверку кодов при сборке и обсудить передачу данных маркетплейсам в поддерживаемых сценариях.