lknpd-nalog-api

API для самозанятых в РФ «Мой налог»

Автоматизирует отправку чеков в налоговую и другие операции. Используетcя непубличный API с сайта lknpd.nalog.ru

Установка

The package can be installed via npm:

npm install lknpd-nalog-api --save

Использование

1. Импортируем класс NalogApi.
2. Создаем экземпляр с передачей параметров авторизации.
3. Вызываем нужные методы.

Пример:

const { NalogApi } = require("lknpd-nalog-api");

const nalogApi = new NalogApi({ phone: 79101112222 });
// или
const nalogApi = new NalogApi({ inn: 1234567890, password: "myPassword" });

const income = {
  name: "Тестовый платеж",
  amount: 1999.99,
  quantity: 1,
};

nalogApi
  .addIncome(income)
  .then(receiptId => console.log(receiptId))
  .catch(error => console.log(error));

Авторизация и параметры для конструктора

Вы должны быть зарегистрированы как самозанятый и у вас должна быть учетная запись в приложении «Мой налог» или на сайте lknpd.nalog.ru. Передаем в качестве параметров конструктора объект с данными. Есть два варианта авторизации:

1. По номеру телефона:

const nalogApi = new NalogApi({ phone: 79101112222 });

| Prop | Type | Description | | ----- | ---- | ----------- | | phone | String | Number | Телефон, к которому привязана учетка в налоговой |

После запуска скрипта на ваш телефон будет отправлено SMS с кодом, который нужно будет ввести в терминале. Код живет всего 3 минуты. Если SMS по каким-то причинам не пришла или пришла, но поздно, перезапустите скрипт. Следите чтобы процесс не падал на сервере, иначе нужно будет снова вводить код. По этой причине надежнее будет использовать второй способ авторизации.

2. По ИНН и паролю:

const nalogApi = new NalogApi({ inn: 1234567890, password: "myPassword" });

| Prop | Type | Description | | ----- | --------------------------- | --------------- | | inn | String | Number | Ваш ИНН | | password | String | Ваш пароль (узнать можно в налоговой)|

Методы API

Экземпляр класса NalogApi содержит:

| Name | Description | Params | | ----------- | --------------- |-----------| | getUserInfo | Возвращает данные о самозанятом | ------------| | addIncome | Отправляет чек в налоговую | IServiceIncome | IServiceIncome[], Date (необязательно, по умолчанию текущая отметка времени) | | cancelIncome | Отменяет чек | receiptId: String - идентификатор чека | | getApprovedIncome | Возвращает информацию о чеке | receiptId: String - идентификатор чека, format - "json" | "print" (по умолчанию "json", "print" вернет Blob) | callMethod | Вызов произвольного метода* | methodPath - путь метода, body - тело запроса (если не передавать, будет GET, иначе POST)|

Объект параметров чека для addIncome. Метод принимает как один объект, так и массив объектов. Это не добавление нескольких чеков за раз, просто в одном чеке может быть несколько услуг или товаров.

interface IServiceIncome {
  name: string // название услуги
  amount: number | string // сумма - 00.00 | 00 | "00.00" | "00"
  quantity: number // количество (в чеке не отображается)
}

*callMethod позволяет обратится к любому методу API со своими параметрами. Если необходимо то, чего нет в библиотеке, идем на сайт lknpd.nalog.ru, отлавливаем http-запрос при нужных действиях, оттуда берем путь и параметры.

License

The MIT License.