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="
   }
}