Отключение устаревших методов True API «Честного ЗНАКа»: какие методы использовать вместо них

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

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

Обращения к устаревшим методам могут мешать получению сведений о кодах, товарах и документах. В результате сотрудникам придётся тратить время на выяснение причин недоступности данных и повторную проверку операций.

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

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

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

1. Получение списка 10-значных кодов ТН ВЭД.

   Устаревший метод: «Method of receiving a list of 10-digit FEACN codes» — GET /api/v3/true-api/facade/tnved/search.

   Замена: «Method of receiving a list of 10-digit FEACN codes» — POST /api/v4/true-api/tn-ved/search.

2. Получение краткой информации о списке кодов идентификации по заданному фильтру.

   Устаревший метод: «Method of receiving brief information on IC list by the set filter» — GET /api/v3/true-api/cises/listV2.

   Замена: «Method of receiving information on a list of identification codes by set filters» — POST /api/v4/true-api/cises/search.

3. Получение подробной информации о списке кодов идентификации товаров по заданному фильтру.

   Устаревший метод: «Method of receiving the detailed information on the list of goods identification codes by set filter» — GET /api/v3/true-api/products/listV2.

   Замена: «Method of receiving information on a list of identification codes by set filters» — POST /api/v4/true-api/cises/search.

4. Получение списка агрегированных кодов идентификации.

   Устаревший метод: «Requesting a list of aggregated identification codes» — GET /api/v3/true-api/cises/aggregated/list.

   Замена: «Method for getting a list of aggregated identification codes» — POST /api/v3/true-api/cises/aggregated/list.

5. Получение карточки товара по коду идентификации.

   Устаревший метод: «Method for getting a goods card by IC» — GET /api/v3/true-api/products/info.

   Замена зависит от того, какие сведения нужны.

   Для запроса информации о кодах указаны два метода:

   • «Method of receiving publicly available information on identification codes by list» — POST /api/v3/true-api/cises/info;
   • «Method of receiving publicly available information on identification codes by list (simplified set of attributes)» — POST /api/v3/true-api/cises/short/list. Этот вариант возвращает упрощённый набор атрибутов.

   Для запроса информации о товарах: «Method of receiving information on goods item by goods GTIN» — POST /api/v4/true-api/product/info.

6. Получение информации по списку кодов идентификации при наличии согласия на предоставление сведений.

   Устаревший метод: «Method of receiving IC information by IC list in the presence of a consent on the information provision» — POST /api/v3/true-api/km-owner-api/cises.

   Замена: «Method of receiving publicly available information on identification codes by list» — POST /api/v3/true-api/cises/info.

7. Получение содержимого документа по идентификатору: адрес doc.

   Устаревший метод: «Method for getting document content by identifier» — GET /api/v3/true-api/doc/{docId}/info.

   Замена: «Method for getting document content by identifier» — GET /api/v4/true-api/doc/{docId}/info.

8. Получение содержимого кассового чека по идентификатору.

   Устаревший метод: «Method of receiving CRE receipt content based on its identifier» — GET /api/v3/true-api/receipt/{receiptId}/info.

   Замена: «Method of receiving CRE receipt content based on its identifier» — GET /api/v4/true-api/receipt/{receiptId}/info.

9. Получение списка документов, загруженных в ГИС МТ.

   Устаревший метод: «Method of receiving a list of documents loaded in TT GIS» — GET /api/v3/true-api/doc/listV2.

   Замена: «Method of receiving a list of documents loaded in TT GIS» — GET /api/v4/true-api/doc/list.

10. Получение списка кассовых чеков, загруженных в ГИС МТ: метод версии v3.

    Устаревший метод: «Method of receiving a list of CRE receipts loaded in TT GIS» — GET /api/v3/true-api/receipt/listV2.

    Замена: «Method for obtaining a list of uploaded CRE receipts based on the processing receipts» — POST /api/v3/true-api/receipt/search. Это метод получения списка загруженных кассовых чеков по квитанциям обработки.

11. Получение содержимого документа по идентификатору: адрес documents.

    Устаревший метод: «Method for getting document content by identifier» — GET /api/v3/true-api/documents/{document_id}/info.

    Замена: «Method for getting document content by identifier» — GET /api/v4/true-api/doc/{docId}/info.

12. Создание заявки на регистрацию участника оборота товаров.

    Устаревший метод: «Method of creating a request for goods circulation participant registration» — POST /api/v3/true-api/elk/registration.

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

13. Проверка статуса заявки на регистрацию участника оборота товаров по идентификатору заявки.

    Устаревший метод: «Method of checking the status of the request for GCP registration by request ID» — GET /api/v3/true-api/elk/documents/status/{documentId}.

    В качестве альтернативы указана регистрация через интерфейс единого личного кабинета системы маркировки.

14. Получение информации о товаре по GTIN.

    Устаревший метод: «Method of receiving information on goods item by goods GTIN» — GET /api/v3/true-api/product/info.

    Замена: «Method of receiving information on goods item by goods GTIN» — POST /api/v4/true-api/product/info.

15. Списание для товарной группы «Табачная продукция».

    Устаревший метод: «Write-off (“Tobacco products”)» — POST /api/v3/true-api/documents/dropped-out/create.

    Замена: «Single method of document creation» — POST /api/v3/lk/documents/create с типом документа «Write-off (general document)» — «Списание (универсальный документ)», WRITE_OFF.

16. Получение кода товарной группы по коду товара GTIN.

    Устаревший метод: «Method of receiving goods groups code by goods identification code (GTIN)» — POST /api/v3/true-api/product/route/gtin.

    Замена: «Method of receiving information on goods item by goods GTIN» — POST /api/v4/true-api/product/info.

17. Получение списка кассовых чеков, загруженных в ГИС МТ: метод версии v4.

    Устаревший метод: «Method of receiving a list of CRE receipts loaded in TT GIS» — GET /api/v4/true-api/receipt/list.

    Замена: «Method for obtaining a list of uploaded CRE receipts based on the processing receipts» — POST /api/v3/true-api/receipt/search. Это метод получения списка загруженных кассовых чеков по квитанциям обработки.

18. Агрегирование упаковок: переход с XML на JSON.

    Устаревший вариант: «Aggregation of packaging» в формате *.xml — POST /documents/aggregation/create.

    Замена: «Aggregation of packaging» в формате JSON — POST /documents/aggregation/create. Адрес и HTTP-метод остаются прежними, меняется формат.

На что обратить внимание при проверке интеграции

Не во всех случаях достаточно заменить v3 на v4. Например, для списка агрегированных кодов меняется GET на POST при том же адресе, а для агрегирования упаковок — XML на JSON без изменения адреса и HTTP-метода. Для регистрации участника оборота вместо API указан интерфейс единого личного кабинета.

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

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

Практические советы по организации проверки

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

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

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