lknpd-nalog-api-reworked

Fork библиотеки для работы с непубличным API сервиса "Мой налог" (lknpd.nalog.ru), переписанный с fetch на axios.

Установка

npm install lknpd-nalog-api-reworked

Требования

• Node.js 14+

Что изменено в форке

• Переписано с fetch на axios
• Добавлена поддержка прокси для запросов к API

Быстрый старт

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

const nalogApi = new NalogApi({
  inn: 123456789012,
  password: "your-password",
  proxy: "http://host:port:username:password", // optional
});

async function run() {
  const user = await nalogApi.getUserInfo();
  console.log(user.inn);

  const receipt = await nalogApi.addIncome({
    name: "Тестовая услуга",
    amount: 1999.99,
    quantity: 1,
  });

  console.log("Receipt:", receipt);
}

run().catch(console.error);

Авторизация

Можно использовать один из двух вариантов:

1. По ИНН и паролю

new NalogApi({ inn: 123456789012, password: "your-password" });

2. По номеру телефона (с подтверждением SMS)

new NalogApi({ phone: 79001112233 });

Прокси

Параметр proxy опциональный.

Поддерживаемые форматы:

• http://host:port:username:password
• https://host:port:username:password
• http://username:password@host:port
• https://username:password@host:port

Пример:

new NalogApi({
  inn: 123456789012,
  password: "your-password",
  proxy: "http://host:port:username:password",
});

Методы API

getUserInfo(): Promise<INalogProfile>

Возвращает профиль пользователя.

addIncome(services, date?): Promise<string>

Создает чек и возвращает approvedReceiptUuid.

• services: IServiceIncome или IServiceIncome[]
• date (optional): дата операции, по умолчанию new Date()

cancelIncome(receiptUuid, comment): Promise<INalogCancelIncomeResponse["incomeInfo"]>

Отменяет чек.

getApprovedIncome(receiptUuid, format?): Promise<INalogReceiptIncome | Blob>

Возвращает информацию о чеке.

• format: "json" (default) -> JSON
• format: "print" -> Blob (PDF)

callMethod(methodPath, body?): Promise<any>

Универсальный вызов метода API.

• Если body не передан, используется GET
• Если body передан, используется POST

Типы

Основные типы доступны в src/types/index.ts:

• INalogApiInitParams
• IServiceIncome
• INalogProfile
• INalogReceiptIncome

Важно

API lknpd.nalog.ru непубличный и может меняться без предупреждения.

License

MIT