> For the complete documentation index, see [llms.txt](https://docs.payanyway.ru/marketplace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payanyway.ru/marketplace/samozanyatye/scenarii-ispolzovaniya-npd-api/8.-registraciya-dokhoda-v-fns-i-8.-pechat-cheka.md). # 9. Регистрация дохода самозанятого в ФНС и отправка чека [**https://my.payanyway.ru/npdapi/registerincome**](https://my.payanyway.ru/npdapi/registerincome) Принимаемые параметры: * key - (security\_key) (строка, до 32-х символов) * amount - сумма за товар 1 (decimal, девять знаков до точки и 2 после) * amount1 - сумма за товар 2 - необязательный параметр * amount2 - сумма за товар 3 - необязательный параметр * amount3 - сумма за товар 4 - необязательный параметр * amount4 - сумма за товар 5 - необязательный параметр * customerInn - необязательный параметр - ИНН покупателя, если покупатель - юр.лицо - (строка до 12-ти символов) * customerOrganization - необязательный параметр - название организации, если покупатель - юр.лицо - (строка, до 255-ти символов) * desc - название товара 1 - (строка, text 16384 символа) * desc1 - название товара 2 - необязательный параметр * desc2 - название товара 3 - необязательный параметр * desc3 - название товара 4 - необязательный параметр * desc4 - название товара 5 - необязательный параметр * inn - ИНН самозанятого - (строка до 12-ти символов) * quantity - необязательный параметр - кол-во товара 1 - (целое, 5 знаков) * quantity1 - необязательный параметр - кол-во товара 2 * quantity2 - необязательный параметр - кол-во товара 3 * quantity3 - необязательный параметр - кол-во товара 4 * quantity4 - необязательный параметр - кол-во товара 5 * signature - подпись запроса (строка, до 32-х символов), рассчитывается по формуле: signature = md5(amount + desc + inn + SecretKey) * sync - необязательный параметр - синхронный (1) или автоматически повторяемый до успешной регистрации чек (0). Ответ на запрос: * requestId - ID запроса (число, до 11-ти знаков) * methodName - имя запроса (строка, до 32-х символов) * requestStatus - статус запроса - может иметь одно из значений: NEW (создан новый запрос), ACTIVE - запрос сработал, DONE - запрос завершен и NO\_MESSAGE\_ID (не был получен ID сообщения от АИС “Налог-3” - в этом случае запрос до АИС “Налог-3” будет повторяться автоматически до получения ID сообщения от АИС “Налог-3”) (строка, до 32-х символов) * methodId - ID сообщения от АИС “Налог-3” (строка, до 50-ти символов) - может не прийти в случае потери связи с АИС “Налог-3” * aisReceiptId - ID онлайн чека (приходит в ответе только в случае успешного формирования чека) - (строка, до 32-х символов) - может не прийти в случае потери связи с АИС “Налог-3” * aisReceiptLink - ссылка на онлайн чек (приходит в ответе только в случае успешного формирования чека) - (строка, до 255-ти символов) - может не прийти в случае потери связи с АИС “Налог-3” * debugData - данные для отладки - массив json, имеющий следующую структуру: * token - (строка, до 32-х символов) * userIdentity - (строка, до 255-ти символов) * result - данные с результатами выполнения запроса - массив json, имеющий следующую структуру: * requestId - ID запроса (число, до 11-ти знаков) * requestMessageId - ID сообщения от АИС “Налог-3” (строка, до 50-ти символов) - может не прийти в случае потери связи с АИС “Налог-3” * result - массив json - может не прийти в случае потери связи с АИС “Налог-3” * Body - массив json * GetMessageResponse - массив json * ProcessingStatus - (строка, до 32-х символов) * Message - массив json * PostIncomeResponse - массив json * ReceiptId - ID онлайн чека (приходит в ответе только в случае успешного формирования чека) - (строка, до 32-х символов) * Link - ссылка на онлайн чек (приходит в ответе только в случае успешного формирования чека) - (строка, до 255-ти символов) Пример успешного ответа на запрос: ``` { "requestId":16112, "methodName":"registerincome", "requestStatus":"DONE", "methodId":"bed48659-ae47-4255-b273-7c9ec4c3e9b3", "debugData":{ "token":"884a1d66ef2f4b4699b3750304781ed3", "userIdentity":"aW5zdGE=", "result":{ "requestId":16112, "requestMessageId":"bed48659-ae47-4255-b273-7c9ec4c3e9b3", "result":{ "Body":{ "GetMessageResponse":{ "ProcessingStatus":"COMPLETED", "Message":{ "PostIncomeResponse":{ "ReceiptId":"204cpexfvx", "Link":"https:\/\/lknpd.nalog.ru\/api\/v1\/receipt\/732814482115\/204cpexfvx\/print" } }, "FileLinks":[ ] } } }, "debugData":{ "token":"884a1d66ef2f4b4699b3750304781ed3", "userIdentity":"aW5zdGE=" } } }, "aisReceiptId":"204cpexfvx", "aisReceiptLink":"https:\/\/lknpd.nalog.ru\/api\/v1\/receipt\/732814482115\/204cpexfvx\/print" } ``` Если в ответе не пришли параметры: aisReceiptId, aisReceiptLink и methodId, значит серверы системы АИС “Налог-3” не работают, либо с ними нет связи. В этом случае, необходимо отправить запрос на регистрацию самозанятого в offline режиме (следующий запрос в данной документации). Параметры url-уведомления об успешно зарегистрированном чеке (не придет, если чек не был создан по причине отсутствия связи с системой АИС “Налог-3”): * requestId - ID запроса (число, до 11-ти знаков) * requestMessageId - ID сообщения от АИС “Налог-3” (строка, до 50-ти символов) * debugData - данные для отладки - массив json, имеющий следующую структуру: * token - (строка, до 32-х символов) * userIdentity - (строка, до 255-ти символов) * result - массив json * Body - массив json * GetMessageResponse - массив json * ProcessingStatus - массив json * Message - массив json * PostIncomeResponse - массив json * ReceiptId - ID онлайн чека (приходит в ответе только в случае успешного формирования чека) - (строка, до 32-х символов) * Link - ссылка на онлайн чек (приходит в ответе только в случае успешного формирования чека) - (строка, до 255-ти символов) Пример url-уведомления об успешно зарегистрированном чеке: ``` { "requestId":15944, "requestMessageId":"9940b4a6-40a4-413f-9bcd-e3576546a18c", "result":{ "Body":{ "GetMessageResponse":{ "ProcessingStatus":"COMPLETED", "Message":{ "PostIncomeResponse":{ "ReceiptId":"200hclcxa3", "Link":"https:\/\/lknpd.nalog.ru\/api\/v1\/receipt\/344213338444\/200hclcxa3\/print" } }, "FileLinks":[ ] } } }, "debugData":{ "token":"4bf48104295c41daa5772d7cc2e19102", "userIdentity":"aW5zdGE=" } } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.payanyway.ru/marketplace/samozanyatye/scenarii-ispolzovaniya-npd-api/8.-registraciya-dokhoda-v-fns-i-8.-pechat-cheka.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.