API Честный знак. Как провести реализацию товара?

IRagnarok · Регистрация: 06.03.2014

Студворк — интернет-сервис помощи студентам

Здравствуйте, ув. форумчане!

Мне нужно каким то образом научиться отправлять API запросы в "Честный знак", чтобы зарегистрировать продажу маркированного товара.
Вся проблема в том, что у них запутанная документация в отличии от стандартных.
Так же нужно получить как то ключ сессии после формирования подписания. Нашёл вот такой вариант создания подписи к API Запросу:
________________________________________ ________________________________

Code
1
2
3
4
5
6
7
8
9
10
11
12
1. Подготавливаем данные, куда будем сохранять токен и отпечаток подписи, которой подписываем документ.
2. Get запросом получаем строку для подписи, сохраняем её в файл и запоминаем её uuid.
3. Подписываем строку с помощью утилиты csptest.exe
Для этого запускаем её с ключами:
C:\Program Files\Crypto Pro\CSP\csptest.exe -sfsign -sign -in <файл со строкой для подписи> -my <отпечаток подписи> -out <файл с подписанной строкой> -addsigtime -base64 -add
4. В файле с подписанной строкой удаляем все пробелы и переводы строк.
5. Составляем JSON файл:
{
"uuid" : "<запомненный в п. 2 uuid>",
"data" : "<подписанная строка без пробелов и переводов строк>"
}
5. Post запросом отправляем полученный JSON и в ответ получаем токен.

________________________________________ __________________________________

Повторяю, я программировать умею но тут просто трындец.
В итоге мне нужно написать на C# сначала получение подписи, потом API Запрос.
Мог бы кто нибудь пролить свет на это тьму?
Если найдётся смельчак который сопроводит меня до решения всей задачи то смогу отблагодарить не только словами.

@Usaga · 18.09.2023, 12:15

Сообщение от IRagnarok

Мне нужно каким то образом научиться отправлять API запросы

Смотри документацию на класс HttpClient

IRagnarok · 18.09.2023, 12:53 **[ТС]**

нет нет.

Именно API запросы из C# я умею делать и много раз делал. Разбирал даже самые разные документации.
Документация именно с Честным знаком мне не понятна. Сам путь реализации похож на лабиринт.

Во первых - список API справочников у них невероятно огромен.

API Честный знак. Как провести реализацию товара?

Во вторых - я скачал пару справочников не нашёл у них API запрос на продажу/реализацию товара. (прикладываю 2 инструкции)

Посему, хотел бы найти человека, который уже с этим сталкивался.

IRagnarok · 18.09.2023, 12:57 **[ТС]**

Нет нет.

Именно API запросы я умею отправлять и разбирал самые разные справочники и писал код.
Однако только в "Честном знаке" всё очень запутано.

Во первых - у них очень большой список справочников (Список API.jpg )
Во вторых - я скачал пару справочников и не нашёл API запрос на уведомление продажи/реализации товара (приложил 2 pdf файла)

А так же нужно научиться делать саму подпись к API запросу. (все данные я могу взять у моей фирмы, которая заходит на сайт через ЭЦП)
Поэтому я хотел бы найти человека, который уже имел некий опыт работы с "Честным знаком"

@Dr9vik · 18.09.2023, 13:03

Не по теме:

фотка монитора?

IRagnarok · 18.09.2023, 13:33 **[ТС]**

ага

Это сфоткала наш бухгалтер.
У меня лично ЭЦП нет просто и только она может в кабинет зайти посмотреть информацию какие API есть.

Это список документаций API всего "Честного знака" и не смог я там найти нужной мне процедуры либо толкового объяснения что делать.

@IamRain · 18.09.2023, 13:57

Сообщение от IRagnarok

ага

Не по теме:

IRagnarok, и что ты хочешь, чтобы мы за тебя твою работу делали?

IRagnarok · 18.09.2023, 13:59 **[ТС]**

конечно хочу,

А ты что то можешь по этой теме грамотно ответить? или только по клавишам стучать горазд?

@Andrey-MSK · 18.09.2023, 14:03

IRagnarok, А что по этому поводу говорит служба техподдержки данного API?

@IamRain · 18.09.2023, 14:07

Сообщение от IRagnarok

конечно хочу,

IRagnarok, это из тех работ, которую надо брать и делать. Условно тебе сказали помыть гору посуды, берешь и моешь.
А ты вышел на крыльцо покурить и начинаешь обсуждать - а какими средствами пользоваться, а вот бухгалтер наш вот такую фоточку мне отправил и тд. и тп. Берешь и изучаешь API, тебе за это платят.

IRagnarok · 18.09.2023, 14:18 **[ТС]**

Andrey-MSK
там в основном менеджеры сидят.
Они ни словом ни духом не в курсе что даже советовать

Добавлено через 4 минуты

Не нужно за меня писать код.
Мне нужно знать цепочку-правило-стандар отправки API Честному знаку.
Пример:
1.взять инфо с личного кабинета
2.скомпилировать в эцп/ключ сессии
3.Каким API отправить и где указывать ключ сессии
ЭТО НЕ ТОЧНЫЙ ПОРЯДОК КОТОРЫЙ ПРИМЕРНО НУЖНО ДЕЛАТЬ, ТАК КАК Я НЕ ЗНАЮ ЧТО ОТ МЕНЯ ТРЕБУЕТСЯ.
ПОЭТОМУ МНЕ НУЖЕН ЧЕЛОВЕК, КОТОРЫЙ УЖЕ ИМЕЛ ОПЫТ И СМОГ БЫ ПОДСКАЗАТЬ КАКИМ ПУТЕМ ИДТИ.

ДЛЯ ТЕБЯ IamRain ЧТО В ТАНКЕ ПЕРСОНАЛЬНО!
Тебе сказали помыть посуду но не сказали где раковина, моющее средство и губка.

@Usaga · 18.09.2023, 16:18

IRagnarok, ну слушай, ты же приложил PDF, где по порядку последовательность действий описана. Даже примеры с запросами через Postman.

Или это тоже тяжеловато для тебя?

IRagnarok · 18.09.2023, 17:01 **[ТС]**

На всякий случай в общем проясню для чего пишется апи.
Апи - это набор команд для дальнейших действий сервера в зависимости от команды.
В основном в базах данных которые принимают API есть команды которые могут: открывать карточку товара, изменять данные в карточке, помечать поступление/перемещение товара, отмечать продажу товара, отменять продажу товара ... и тд и тп и многое другое.

В связи с этим у меня 2 вопроса:
1. Какую именно API команду(название) Честного знака нужно использовать при продажи/реализации товара
2.Как формируется подпись для этой команды

@Dr9vik · 18.09.2023, 21:48

Сообщение от IRagnarok

1. Какую именно API команду(название) Честного знака нужно использовать при продажи/реализации товара
2.Как формируется подпись для этой команды

в описание апи посмотрите

@Usaga · 19.09.2023, 08:06

Сообщение от IRagnarok

В связи с этим у меня 2 вопроса:

Так ты документы к этой теме приаттачил для чего? Ты сам их почитай, там же много чего расписано. Даже со скриншотами.

IRagnarok · 19.09.2023, 14:58 **[ТС]**

думаете если бы там было что то нужное мне написано я бы создал здесь тему?
вы действительно настолько суеверны в моей глупости

В общем долблю поддержку по телефону и емайл. ответа пока нет. как что то решу - скину всё инфо сюда в тему, вдруг кому то ещё пригодится.

@Usaga · 19.09.2023, 15:22

IRagnarok, боюсь, что тут вряд найдётся человек, который с этим апи работал. А сидеть и разбираться в документах этих… Ну ты понял)

Тут еще надо в предметной области понимать. Я открыл, посмотрел, и понял, что технически все понимаю, но что делает каждый эндпоинт мне не понятно)

IRagnarok · 19.09.2023, 16:22 **[ТС]**

ну вот и я о том же)
Всё понятно и нифига не понятно. API написано для того, чтобы просто написать API. Как сайт "Госуслуги" среди нормальных сайтов.

IRagnarok · 26.09.2023, 11:08 **[ТС]**

Выведу сюда ответ от службы поддержки (наверно стандартный какой то)
Понял что проще всего при продаже отмечать в самом ККТ и у новых ККТ сейчас есть какой то параметр/галочка "Маркировка", куда ещё можно указать список считанного QR-кода с товара.
________________________________________ _______________

1. Отметим, что для передачи сведений о розничной реализации товаров с помощью контрольно-кассовой техники (ККТ) через оператора фискальных данных (ОФД) в государственную информационную систему мониторинга за оборотом товаров (ГИС МТ) при использовании ФФД 1.05, ФФД 1.1 необходимо установить обновленную версию программного обеспечения ККТ, включающую расширенный алгоритм формирования тега 1162 "Код товара" с записью в него кода идентификации (КИ) реализуемого товара (подробнее в инструкции: Рекомендации при розничной реализации) согласно Постановлению Правительства РФ от 21.02.2019 № 174 "Об установлении дополнительного обязательного реквизита кассового чека и бланка строгой отчетности" и согласно Постановлению Правительства РФ от 16.04.2020 № 521 "О внесении изменений в постановление Правительства Российской Федерации от 21 февраля 2019 г. № 174".
При использовании ФФД 1.2 в запросе о коде маркировки и уведомлении о реализации маркированного товара необходимо обязательно передавать полные коды маркировки в теге 2000 "codeString". Требования к формам фискальных документов регламентируются приказом ФНС России от 14.09.2020 N ЕД-7-20/662@ "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию".
Участники оборота товаров, осуществляющие реализацию товаров в розницу, техническими средствами посредством ККТ сканируют и распознают средство идентификации продаваемого товара. Сведения о КИ товара включаются в фискальный документ «кассовый чек», формируемый ККТ в порядке, определенном ФНС России, при этом:
1. Реквизиты чека и реализуемой продукции посредством фискального накопителя ККТ передаются ОФД;
2. ОФД по поручению участника, осуществляющего розничную продажу товаров, осуществляет от имени указанного участника ежедневную передачу в режиме реального времени полученной от него информации в ГИС МТ по каждой реализованной товарной единице товаров.
Обратите внимание! В случае осуществления расчетов между организациями и (или) индивидуальными предпринимателями, при наличии в кассовом чеке реквизита "ИНН покупателя (клиента)" вывод товаров из оборота не осуществляется. При заполнении данного реквизита происходит передача товара между участниками оборота. О передаче товара между организациями и (или) индивидуальными предпринимателями - в инструкции: Передача товара (отгрузка и приёмка) - обувные товары, легкая промышленность, фототехника, шины и покрышки, духи и туалетная вода; Передача товара (отгрузка и приёмка) - упакованная вода.
3. При поступлении сведений о розничной реализации товаров в ГИС МТ от ОФД:
• Формируется документ со сведениями о выводе товара из оборота в разделе Документы, на вкладке Чеки со статусом загрузки «Обработан». При нажатии на номер документа открывается форма с информацией о фискальном документе и реализованных единицах товара.

2. Согласно Федеральному закону "О применении контрольно-кассовой техники при осуществлении расчетов в Российской Федерации" от 22.05.2003 № 54-ФЗ, реализация товаров должна производиться через контрольно-кассовую технику (ККТ). Формат продажи без ККТ не входит в зону ответственности ЦРПТ.

ФЗ № 54 статья 2, пункт 3: Организации и индивидуальные предприниматели, осуществляющие расчеты в отдаленных или труднодоступных местностях (за исключением городов, районных центров (кроме административных центров муниципальных районов, являющихся единственным населенным пунктом муниципального района), поселков городского типа), указанных в перечне отдаленных или труднодоступных местностей, утвержденном органом государственной власти субъекта Российской Федерации, вправе не применять контрольно-кассовую технику при условии выдачи покупателю (клиенту) по его требованию документа, подтверждающего факт осуществления расчета между организацией или индивидуальным предпринимателем и покупателем (клиентом), содержащего наименование документа, его порядковый номер, реквизиты, установленные абзацами четвертым - двенадцатым пункта 1 статьи 4.7 настоящего Федерального закона, и подписанного лицом, выдавшим этот документ.

В данном случае участник оборота товаров обязан самостоятельно передавать сведения в систему мониторинга ГИС МТ о продаже товара, в связи с чем в данных случаях возможно воспользоваться единым методом создания документов (4.1) из документации TAPI, при этом тип документа будет "LK_RECEIPT", а шаблон поля "product_document" находится в рамках пункта "4.2.8. Вывод из оборота". Вся необходимая документация для работы размещена в разделе "Помощь" личного кабинета государственной информационной системы мониторинга за оборотом товаров.
Подробная инструкция по предоставлению сведений о выводе товаров из оборота в ГИС МТ: Вывод из оборота размещена на сайте честныйзнак.рф и в разделе "Помощь" личного кабинета ГИС МТ.
Есть вопросы по выводу из оборота? Заходите в виртуальное обучающее пространство и за 5-10 минут пройдите все шаги!

Новые блоги и статьи Все статьи Все блоги /
Модель заражения группы наркоманов alhaos 17.04.2026 Условия задачи сформулированы тут Суть: - Группа наркоманов из 10 человек. - Только один инфицирован ВИЧ. - Колются одной иглой. - Колются раз в день. - Колются последовательно через. . .	Мысли в слух. Про "навсегда". kumehtar 16.04.2026 Подумалось тут, что наверное очень глупо использовать во всяких своих установках понятие "навсегда". Это очень сильное понятие, и я только начинаю понимать край его смысла, не смотря на то что давно. . .	My Business CRM MaGz GoLd 16.04.2026 Всем привет, недавно возникла потребность создать CRM, для личных нужд. Собственно программа предоставляет из себя базу данных клиентов, в которой можно фиксировать звонки, стадии сделки, а также. . .	Знаешь почему 90% людей редко бывают счастливыми? kumehtar 14.04.2026 Потому что они ждут. Ждут выходных, ждут отпуска, ждут удачного момента. . . а удачный момент так и не приходит.
Фиксация колонок в отчете СКД Maks 14.04.2026 Фиксация колонок в СКД отчета типа Таблица. Задача: зафиксировать три левых колонки в отчете. Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка) / / . . .	Настройки VS Code Loafer 13.04.2026 { "cmake. configureOnOpen": false, "diffEditor. ignoreTrimWhitespace": true, "editor. guides. bracketPairs": "active", "extensions. ignoreRecommendations": true, . . .	Оптимизация кода на разграничение прав доступа к элементам формы Maks 13.04.2026 Алгоритм из решения ниже реализован на нетиповом документе, разработанного в конфигурации КА2. Задачи, как таковой, поставлено не было, проделанное ниже исключительно моя инициатива. Было так:. . .	Контроль заполнения и очистка дат в зависимости от значения перечислений Maks 12.04.2026 Алгоритм из решения ниже реализован на примере нетипового документа "ПланированиеПерсонала", разработанного в конфигурации КА2. Задача: реализовать контроль корректности заполнения дат назначения. . .

@Dr9vik
	18.09.2023, 13:03
	Не по теме: фотка монитора? 0

IRagnarok 0 / 0 / 0 Регистрация: 06.03.2014 Сообщений: 16
	18.09.2023, 13:33 [ТС]
	ага Это сфоткала наш бухгалтер. У меня лично ЭЦП нет просто и только она может в кабинет зайти посмотреть информацию какие API есть. Это список документаций API всего "Честного знака" и не смог я там найти нужной мне процедуры либо толкового объяснения что делать. 0

IRagnarok 0 / 0 / 0 Регистрация: 06.03.2014 Сообщений: 16
	18.09.2023, 13:59 [ТС]
	конечно хочу, А ты что то можешь по этой теме грамотно ответить? или только по клавишам стучать горазд? 0

@Andrey-MSK 3360 / 2246 / 388 Регистрация: 14.08.2018 Сообщений: 7,593 Записей в блоге: 4
	18.09.2023, 14:03
	IRagnarok, А что по этому поводу говорит служба техподдержки данного API? 0

IRagnarok 0 / 0 / 0 Регистрация: 06.03.2014 Сообщений: 16
	18.09.2023, 14:18 [ТС]
	Andrey-MSK там в основном менеджеры сидят. Они ни словом ни духом не в курсе что даже советовать Добавлено через 4 минуты Не нужно за меня писать код. Мне нужно знать цепочку-правило-стандар отправки API Честному знаку. Пример: 1.взять инфо с личного кабинета 2.скомпилировать в эцп/ключ сессии 3.Каким API отправить и где указывать ключ сессии ЭТО НЕ ТОЧНЫЙ ПОРЯДОК КОТОРЫЙ ПРИМЕРНО НУЖНО ДЕЛАТЬ, ТАК КАК Я НЕ ЗНАЮ ЧТО ОТ МЕНЯ ТРЕБУЕТСЯ. ПОЭТОМУ МНЕ НУЖЕН ЧЕЛОВЕК, КОТОРЫЙ УЖЕ ИМЕЛ ОПЫТ И СМОГ БЫ ПОДСКАЗАТЬ КАКИМ ПУТЕМ ИДТИ. ДЛЯ ТЕБЯ IamRain ЧТО В ТАНКЕ ПЕРСОНАЛЬНО! Тебе сказали помыть посуду но не сказали где раковина, моющее средство и губка. 0

@Usaga 14318 / 9403 / 1356 Регистрация: 21.01.2016 Сообщений: 35,468
	18.09.2023, 16:18
	IRagnarok, ну слушай, ты же приложил PDF, где по порядку последовательность действий описана. Даже примеры с запросами через Postman. Или это тоже тяжеловато для тебя? 0

IRagnarok 0 / 0 / 0 Регистрация: 06.03.2014 Сообщений: 16
	18.09.2023, 17:01 [ТС]
	На всякий случай в общем проясню для чего пишется апи. Апи - это набор команд для дальнейших действий сервера в зависимости от команды. В основном в базах данных которые принимают API есть команды которые могут: открывать карточку товара, изменять данные в карточке, помечать поступление/перемещение товара, отмечать продажу товара, отменять продажу товара ... и тд и тп и многое другое. В связи с этим у меня 2 вопроса: 1. Какую именно API команду(название) Честного знака нужно использовать при продажи/реализации товара 2.Как формируется подпись для этой команды 0

IRagnarok 0 / 0 / 0 Регистрация: 06.03.2014 Сообщений: 16
	19.09.2023, 14:58 [ТС]
	думаете если бы там было что то нужное мне написано я бы создал здесь тему? вы действительно настолько суеверны в моей глупости В общем долблю поддержку по телефону и емайл. ответа пока нет. как что то решу - скину всё инфо сюда в тему, вдруг кому то ещё пригодится. 0

@Usaga 14318 / 9403 / 1356 Регистрация: 21.01.2016 Сообщений: 35,468
	19.09.2023, 15:22
	IRagnarok, боюсь, что тут вряд найдётся человек, который с этим апи работал. А сидеть и разбираться в документах этих… Ну ты понял) Тут еще надо в предметной области понимать. Я открыл, посмотрел, и понял, что технически все понимаю, но что делает каждый эндпоинт мне не понятно) 0

IRagnarok 0 / 0 / 0 Регистрация: 06.03.2014 Сообщений: 16
	19.09.2023, 16:22 [ТС]
	ну вот и я о том же) Всё понятно и нифига не понятно. API написано для того, чтобы просто написать API. Как сайт "Госуслуги" среди нормальных сайтов. 0

IRagnarok 0 / 0 / 0 Регистрация: 06.03.2014 Сообщений: 16
	26.09.2023, 11:08 [ТС]
	Выведу сюда ответ от службы поддержки (наверно стандартный какой то) Понял что проще всего при продаже отмечать в самом ККТ и у новых ККТ сейчас есть какой то параметр/галочка "Маркировка", куда ещё можно указать список считанного QR-кода с товара. ________________________________________ _______________ 1. Отметим, что для передачи сведений о розничной реализации товаров с помощью контрольно-кассовой техники (ККТ) через оператора фискальных данных (ОФД) в государственную информационную систему мониторинга за оборотом товаров (ГИС МТ) при использовании ФФД 1.05, ФФД 1.1 необходимо установить обновленную версию программного обеспечения ККТ, включающую расширенный алгоритм формирования тега 1162 "Код товара" с записью в него кода идентификации (КИ) реализуемого товара (подробнее в инструкции: Рекомендации при розничной реализации) согласно Постановлению Правительства РФ от 21.02.2019 № 174 "Об установлении дополнительного обязательного реквизита кассового чека и бланка строгой отчетности" и согласно Постановлению Правительства РФ от 16.04.2020 № 521 "О внесении изменений в постановление Правительства Российской Федерации от 21 февраля 2019 г. № 174". При использовании ФФД 1.2 в запросе о коде маркировки и уведомлении о реализации маркированного товара необходимо обязательно передавать полные коды маркировки в теге 2000 "codeString". Требования к формам фискальных документов регламентируются приказом ФНС России от 14.09.2020 N ЕД-7-20/662@ "Об утверждении дополнительных реквизитов фискальных документов и форматов фискальных документов, обязательных к использованию". Участники оборота товаров, осуществляющие реализацию товаров в розницу, техническими средствами посредством ККТ сканируют и распознают средство идентификации продаваемого товара. Сведения о КИ товара включаются в фискальный документ «кассовый чек», формируемый ККТ в порядке, определенном ФНС России, при этом: 1. Реквизиты чека и реализуемой продукции посредством фискального накопителя ККТ передаются ОФД; 2. ОФД по поручению участника, осуществляющего розничную продажу товаров, осуществляет от имени указанного участника ежедневную передачу в режиме реального времени полученной от него информации в ГИС МТ по каждой реализованной товарной единице товаров. Обратите внимание! В случае осуществления расчетов между организациями и (или) индивидуальными предпринимателями, при наличии в кассовом чеке реквизита "ИНН покупателя (клиента)" вывод товаров из оборота не осуществляется. При заполнении данного реквизита происходит передача товара между участниками оборота. О передаче товара между организациями и (или) индивидуальными предпринимателями - в инструкции: Передача товара (отгрузка и приёмка) - обувные товары, легкая промышленность, фототехника, шины и покрышки, духи и туалетная вода; Передача товара (отгрузка и приёмка) - упакованная вода. 3. При поступлении сведений о розничной реализации товаров в ГИС МТ от ОФД: • Формируется документ со сведениями о выводе товара из оборота в разделе Документы, на вкладке Чеки со статусом загрузки «Обработан». При нажатии на номер документа открывается форма с информацией о фискальном документе и реализованных единицах товара. 2. Согласно Федеральному закону "О применении контрольно-кассовой техники при осуществлении расчетов в Российской Федерации" от 22.05.2003 № 54-ФЗ, реализация товаров должна производиться через контрольно-кассовую технику (ККТ). Формат продажи без ККТ не входит в зону ответственности ЦРПТ. ФЗ № 54 статья 2, пункт 3: Организации и индивидуальные предприниматели, осуществляющие расчеты в отдаленных или труднодоступных местностях (за исключением городов, районных центров (кроме административных центров муниципальных районов, являющихся единственным населенным пунктом муниципального района), поселков городского типа), указанных в перечне отдаленных или труднодоступных местностей, утвержденном органом государственной власти субъекта Российской Федерации, вправе не применять контрольно-кассовую технику при условии выдачи покупателю (клиенту) по его требованию документа, подтверждающего факт осуществления расчета между организацией или индивидуальным предпринимателем и покупателем (клиентом), содержащего наименование документа, его порядковый номер, реквизиты, установленные абзацами четвертым - двенадцатым пункта 1 статьи 4.7 настоящего Федерального закона, и подписанного лицом, выдавшим этот документ. В данном случае участник оборота товаров обязан самостоятельно передавать сведения в систему мониторинга ГИС МТ о продаже товара, в связи с чем в данных случаях возможно воспользоваться единым методом создания документов (4.1) из документации TAPI, при этом тип документа будет "LK_RECEIPT", а шаблон поля "product_document" находится в рамках пункта "4.2.8. Вывод из оборота". Вся необходимая документация для работы размещена в разделе "Помощь" личного кабинета государственной информационной системы мониторинга за оборотом товаров. Подробная инструкция по предоставлению сведений о выводе товаров из оборота в ГИС МТ: Вывод из оборота размещена на сайте честныйзнак.рф и в разделе "Помощь" личного кабинета ГИС МТ. Есть вопросы по выводу из оборота? Заходите в виртуальное обучающее пространство и за 5-10 минут пройдите все шаги! 0