9. Регистрация дохода самозанятого в ФНС и отправка чека
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="
}
}
Last updated
Was this helpful?