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