github grandvan709/yookassa-to-mynalog 2.5.0

5 hours ago

🆕 Новый функционал

  • Email-уведомления — добавлена опциональная отправка HTML-писем по SMTP. В отличие от Telegram, письмо приходит только при наличии активности (новые платежи, возвраты или ошибки), чтобы не засорять inbox при пустых синхронизациях. Настраивается через переменные SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_FROM_EMAIL, SMTP_FROM_NAME, SMTP_TO_EMAIL, SMTP_USE_TLS, EMAIL_SUBJECT. Можно использовать параллельно с Telegram или отдельно.

  • Стартовое email-уведомление — при запуске контейнера на почту приходит письмо «🚀 YooKassa → Мой Налог запущен», аналогичное Telegram-уведомлению. Удобно для проверки, что SMTP настроен корректно.

🔧 Улучшения

  • Информативное логирование ошибок Telegram — раньше при сбое отправки в логе было Не удалось отправить уведомление в Telegram: без причины. Теперь добавлен тип исключения (например, [ConnectTimeout], [ProxyError]), что помогает быстро диагностировать проблему.

🔄 Внутренние изменения

  • Переменная окружения TELEGRAM_STARTUP_NOTIFY переименована в STARTUP_NOTIFY — единый флаг для всех каналов уведомлений. Изменение происходит автоматически, ручных действий не требуется.

⚙️ Новые переменные окружения

Переменная По умолчанию Описание
SMTP_HOST SMTP сервер (например smtp.gmail.com, smtp.yandex.ru)
SMTP_PORT 587 Порт SMTP
SMTP_USER Логин SMTP (обычно email)
SMTP_PASSWORD Пароль SMTP (для Gmail/Yandex — пароль приложения)
SMTP_FROM_EMAIL = SMTP_USER Email отправителя
SMTP_FROM_NAME Имя отправителя
SMTP_TO_EMAIL Email получателя уведомлений
SMTP_USE_TLS true STARTTLS (true для 587, false для 465)
EMAIL_SUBJECT Синхронизация чеков в налоговой Тема письма

⚠️ Важно

  • Email-уведомления полностью опциональны — если переменные не заданы, скрипт работает как прежде.
  • Если задана часть SMTP-переменных, но не все обязательные (SMTP_HOST, SMTP_USER, SMTP_PASSWORD, SMTP_TO_EMAIL) — контейнер не запустится с ошибкой конфигурации. Это сделано намеренно, чтобы вы не получили молча неработающий email.
  • Для Gmail и Yandex.Почта используйте пароль приложения, а не основной пароль аккаунта.

Don't miss a new yookassa-to-mynalog release

NewReleases is sending notifications on new releases.