FNS Receipt Service

Express-сервис на Node.js 22 для создания чеков через ФНС и отправки ссылки на чек по email.

Локальный запуск

npm install
cp .env.example .env
npm start

Сервис запустится на порту из PORT или на 4000 по умолчанию.

Docker

Сборка образа:

docker build -t fns-receipt-service .

Запуск контейнера:

docker run --env-file .env -p 3000:3000 fns-receipt-service

Переменные окружения

Заполните эти переменные в Timeweb Cloud в разделе переменных окружения:

INN=123456789012
PASSWORD=your_fns_password
APPNAME=Название проекта
ADMIN_EMAIL=admin@example.com
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=noreply@example.com
SMTP_PASS=email_app_password
SMTP_MAIL_FROM=noreply@example.com
API_PASS=strong_api_password
PORT=3000
HOST=0.0.0.0
FNS_TIMEOUT_MS=30000
SMTP_TIMEOUT_MS=15000

API_PASS должен совпадать с api_pass в запросах к POST /api/v1/create-receipt.

Timeweb Cloud

Что заполнить при Docker-деплое:

Поле	Значение
Dockerfile	`Dockerfile`
Порт	`3000`
Путь до директории проекта	`/fns-receipt-service`
Путь проверки состояния	`/health`

Команду запуска для Docker-деплоя отдельно указывать не нужно: она уже задана в Dockerfile как CMD ["node", "/app/server.js"].

API

Проверка состояния:

GET /health

Создание чека:

POST /api/v1/create-receipt
Content-Type: application/json

{
  "api_pass": "strong_api_password",
  "email": "client@example.com",
  "items": [
    {
      "id": "order-1",
      "name": "Услуга",
      "price": 1000,
      "quantity": 1
    }
  ]
}

Поле email обязательно: на этот адрес сервис отправит письмо со ссылкой на чек после успешного создания чека в ФНС.

Если чек создан в ФНС, но письмо клиенту не отправилось, API вернет success: true, receiptCreated: true, emailSent: false, receiptId, printLink и technicalError. Ошибка отправки сохранится в error.json.

2.5 KiB Raw Blame History Unescape Escape

FNS Receipt Service

Локальный запуск

Docker

Переменные окружения

Timeweb Cloud

API

2.5 KiB

Raw Blame History