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="
   }
}
Previous8. Выплата в пользу самозанятого от юридического лицаNext10. Регистрацию дохода самозанятого в ФНС (offline режим)

Last updated