Открытый проект для малого бизнеса

Деловые документы без лишней сложности.

Создавайте счета, предложения и заказы в понятной настольной форме. LuaBill сочетает аккуратную вёрстку LuaLaTeX со структурированным экспортом счетов; формулы помогают объяснить содержание технических работ.

Версия 0.1.30 · Windows, Linux и macOS · Apache License 2.0

Пример документа
01 · PDF / XRechnung / ZUGFeRD 02 · Windows / Linux / macOS03 · DE / EN / FR / IT / RU
01 / LuaBill

Хорошие документы должны быть доступны с самого начала.

Когда вы начинаете своё дело, важны и аккуратный счёт клиенту, и возможность управлять своими данными и инструментами.

LuaBill создаётся для начинающих предпринимателей и небольших компаний. Наша цель — дать понятный и бесплатный способ готовить деловые документы с качественной вёрсткой, открытыми исходниками и файлами, которые остаются у вас.

Основной рынок — Германия. Текущая версия предназначена для немецкого поставщика; клиенты могут находиться в Германии, других странах ЕС или за его пределами. Язык документа и валюта выбираются независимо от страны клиента.

Мы сосредоточились прежде всего на качестве готовых документов и удобных, понятных формах ввода. В основе – LuaLaTeX: подход к вёрстке технических и научных публикаций доступен теперь и в повседневных деловых документах, включая математические формулы. Развивать формы, шаблоны и переводы мы хотим вместе с пользователями.

Настольный интерфейс LuaBill. Языки интерфейса и документа выбираются отдельно.

Руководство ↗
Настольный интерфейс LuaBill. Языки интерфейса и документа выбираются отдельно.
LuaBill 0.1.30 · Русский · Пример документа
02 / LuaBill

От первого предложения до готового счёта

Заполняйте данные в форме, проверяйте результат и сохраняйте проект для следующего изменения.

Профессиональная вёрстка с LuaLaTeX

Единое оформление, таблицы позиций, многостраничные документы и шрифты Unicode. Техническую работу по созданию PDF выполняет LuaLaTeX.

Десять видов документов

Предложения, счета, накладные, подтверждения заказов, проформы, заказы на закупку, кредит-ноты, сторнирующие счета, запросы предложений и письма.

PDF, XML, XRechnung и ZUGFeRD

Обычные PDF для деловой переписки и структурированный XML для счетов. ZUGFeRD объединяет PDF/A-3 и встроенный XML. LuaBill проверяет активные правила и сохраняет протоколы, версии и контрольные суммы рядом с результатами.

Пять языков и разные валюты

Выбирайте EN, DE, FR, IT или RU отдельно для интерфейса и документа. В суммах используются разделители выбранного языка. Для поддерживаемых валют в примечаниях обязательно указываются код, полное название и символ, в том числе для EUR, USD, RUB и CNY.

НДС с учётом выбранной операции

Предусмотрены немецкие внутренние операции, поставки товаров и обычных B2B-услуг в ЕС и за его пределы, а также режим малого предприятия по §19 UStG. Пояснения и ссылки формируются по указанным данным.

Проверка VAT ID покупателя через VIES

Запустите проверку VIES во вкладке «Покупатель». LuaBill запишет результат и дату из ответа. Актуальная положительная проверка добавляет зелёную галочку у VAT ID в программе и PDF, даже если счёт датирован раньше проверки.

Общие расчёты для PDF и XML

Количество, цена, скидки в процентах, группы НДС и фактически полученные авансы участвуют в расчёте итогов и остатка к оплате. Одни данные используются для печатного и электронного документа.

Понятные данные клиента

Отдельные поля для имени, должности, email, телефона, мобильного, факса и сайта. В PDF контакты располагаются по строкам, а email, сайт и телефон становятся ссылками. Номер клиента сохраняет начальные нули.

Оплата, подпись и печать

Включайте и отключайте изображения подписи и печати флажками. Добавляйте проектные примечания и QR-код EPC/SEPA для подходящих счетов в EUR. Изображение подписи не является криптографической электронной подписью.

Локальные проекты и настройки

Документы создаются на вашем компьютере без обязательной облачной учётной записи. Проекты .luabill и результаты хранятся отдельно; язык интерфейса и папка вывода относятся к настройкам пользователя.

Открытый рабочий процесс

Импортируйте существующие .bill, включая прежние структуры, используйте форму Python/PySide6 или запускайте генерацию из командной строки. Установщик Windows и пакеты установки из исходников для Linux/macOS используют один код приложения.

Формулы и оформление текста

Remarks поддерживает выделение текста и формулы LaTeX, включая интегралы, суммы и дроби. Заполненное поле «Документ → Проект» выводится первым с жирным заголовком на языке документа; то же примечание попадает в XML. Пустое поле не добавляет автоматическое примечание, а совпадающие стандартные примечания о проекте выводятся один раз. PDF отображает формулы; XML сохраняет исходный LaTeX. Вступительный текст выводится только в PDF.

Мастер настройки компонентов

Выберите PDF, XML/XRechnung или ZUGFeRD, проверьте план и запустите подготовку. Мастер использует установленные программы, подготавливает пакеты TeX и частные шрифты Noto, а перед сообщением об успехе проверяет создание документа на демонстрационных данных.

LuaLaTeX · PDF · XML

Счёт на инженерные работы — с формулами

Технические пояснения могут оставаться частью понятного делового документа.

Одностраничный пример на английском: разработка и проверка аналогового ПИД-регулятора и цифрового ПИ-регулятора. В редактируемом проекте можно посмотреть заполненные поля и использовать его структуру для своих работ.

  • Аналоговый ПИД: интегральная и дифференциальная составляющие, фильтрованное дифференцирующее звено с Tf = 35 мс.
  • Цифровой ПИ: рекуррентная формула по неявному методу Эйлера с периодом дискретизации Ts = 10 мс.
  • 86 часов; 8 650,00 EUR без НДС; НДС 19% (1 643,50 EUR); итого 10 293,50 EUR.
  • EPC/SEPA QR-код с подписью «Pay with Code» и демонстрационная печать 35 мм поверх подписи.
\(\displaystyle u(t)=K_p e(t)+K_i\int_0^t e(\tau)\,d\tau-K_d\frac{dy(t)}{dt}\)

\[u[k]=u[k-1]+K_p(e[k]-e[k-1])+K_i T_s e[k]\]

Скачать исходный файл .bill ↓

Скачать все семь примеров (ZIP) ↓

Те же семь примеров входят в установщик: редактируемые проекты .luabill, исходники .bill и готовые PDF. ZIP также содержит демонстрационные изображения подписи и печати. Перед открытием проекта распакуйте архив. SHA-256

Предпросмотр одностраничного английского счёта на разработку аналогового ПИД- и цифрового ПИ-регуляторов с формулами
Только для демонстрации: компании, люди и банковские реквизиты вымышлены. Пример документа — на английском, валюта — EUR.
03 / LuaBill

Первый документ за шесть шагов

Для повседневной работы писать код LaTeX или Lua не требуется.

  1. Установите LuaBill

    Выберите пакет для своей системы. Windows-пакет содержит Python и Qt; в Linux/macOS нужны совместимый Python и Интернет для загрузки PySide6 в отдельную среду LuaBill.

  2. Подготовьте и проверьте компоненты

    Откройте «Справка → Подготовить создание документов», выберите профиль форматов и нажмите «Подготовить выбранные компоненты». Дождитесь настройки пакетов и тестовых документов. Подходящие установленные инструменты используются повторно; полный LaTeX в пакет LuaBill не входит.

  3. Начните с примера

    Создайте новый документ или откройте пример. Замените демонстрационные реквизиты, задайте номер, даты, язык, валюту, продавца и клиента.

  4. Добавьте позиции и условия

    Введите товары или услуги, цены, скидки и НДС. Укажите примечания, условия оплаты и только действительно полученные авансы.

  5. Проверьте данные

    Нажмите F7 для проверки итогов. Сохраните редактируемый проект .luabill и исправьте сообщения об ошибках до выпуска документа.

  6. Создайте и просмотрите результат

    Выберите формат и нажмите F9. Просмотрите PDF и результат проверки электронного счёта. Передайте клиенту нужный PDF или XML согласованным способом, а оба протокола проверки и сведения о версиях сохраните вместе с выпущенным документом.

Руководство ↗
04 / LuaBill

Скачать LuaBill 0.1.30

Пакет LuaBill остаётся компактным, а инструменты создания документов подготавливаются через Интернет. Новый мастер использует подходящие установленные программы и загружает компоненты для выбранных форматов.

Готовое приложение

Windows

Скачать для Windows

v0.1.30 · 84.7 MB · EXE

Windows 10 версии 1809 и новее или Windows 11, x64. Python, PySide6/Qt и Mustang включены; отдельно устанавливать Python не нужно.

Подробнее
  1. Скачайте и запустите установщик LuaBill для своего пользователя. Python, PySide6/Qt и Mustang включены; отдельно устанавливать Python не нужно.
  2. При необходимости выберите ярлык на рабочем столе и открытие файлов .luabill. В конце установки оставьте отмеченной подготовку компонентов для создания документов.
  3. В мастере выберите PDF, PDF + XML/XRechnung или ZUGFeRD, проверьте план и нажмите «Подготовить выбранные компоненты». Недостающие программы скачиваются отдельно; нужен Интернет.
  4. Дождитесь двух проходов теста LuaLaTeX и проверки примера выбранного формата. Затем откройте пример из комплекта, замените демонстрационные реквизиты и сохраните свой проект .luabill.

Windows-установщик пока не подписан сертификатом Authenticode. Проверяйте источник загрузки и SHA-256 файла.

Установка из исходников

Linux

Скачать для Linux

v0.1.30 · 58.5 MB · GZ

Графическая сессия, Python 3.10–3.15 с venv и pip, Интернет для установки PySide6. x86-64: glibc 2.34+; ARM64: glibc 2.39+. Для новой установки рекомендуются Python 3.12 или 3.13. Alpine/musl не поддерживается.

Подробнее
  1. Установите совместимый Python с venv/pip и системные библиотеки графической среды, необходимые Qt. Архив содержит исходники приложения, а не автономный Linux-бинарник с Python/Qt.
  2. Распакуйте полный архив и выполните в его папке sh install.sh --setup-components --language ru. На этапе установки PySide6 загружается в отдельную среду, после чего открывается мастер компонентов.
  3. Выберите профиль и начните подготовку. В Ubuntu/Debian используется apt в отдельном терминале; существующая отдельная установка TUG TeX Live использует собственный tlmgr. Если потребуется пароль, введите его в терминале.
  4. Дождитесь проверки примеров и запустите LuaBill из меню приложений. По умолчанию файлы программы находятся в $XDG_DATA_HOME/LuaBill, если переменная содержит абсолютный путь, иначе в ~/.local/share/LuaBill.

Python устанавливается отдельно и должен оставаться в системе. Пакет не является автономным бинарным приложением; успешная установка и работа на Linux пока не подтверждены нативной проверкой.

Установка из исходников

macOS

Скачать для macOS

v0.1.30 · 58.5 MB · ZIP

macOS 14.4+, Python 3.10–3.15 соответствующей архитектуры и Интернет для установки PySide6. Для новой установки рекомендуются Python 3.12 или 3.13.

Подробнее
  1. Установите совместимый Python 3.10–3.15 для macOS 14.4 или новее. Рекомендуются Python 3.12 или 3.13; установщик из исходников загружает PySide6 в отдельную среду.
  2. Распакуйте полный ZIP и откройте Install_LuaBill.command. Чтобы сразу после установки открыть мастер, выполните в Terminal sh Install_LuaBill.command --setup-components --language ru.
  3. Выберите профиль и начните подготовку. Уже установленный Homebrew может установить BasicTeX и нужные Java/Ghostscript; пакеты TeX подготавливаются собственным tlmgr этой установки в Terminal. Сам Homebrew автоматически не устанавливается.
  4. Дождитесь тестовых документов и откройте ~/Applications/LuaBill.app. Файлы программы находятся в ~/Library/Application Support/LuaBill. Подходящие установленные TeX, Java и Ghostscript используются повторно.

Python устанавливается отдельно и должен оставаться в системе. Локально создаваемая оболочка .app не подписана сертификатом Apple Developer ID и не прошла нотаризацию Apple; нативная установка и работа на macOS пока не подтверждены проверкой.

Компактный пакет и мастер настройки документов →

Для Windows подготовлен установщик готового приложения. Linux и macOS предлагаются как предварительные пакеты установки из исходников. Перед загрузкой ознакомьтесь с требованиями и состоянием проверки вашей платформы.

Что нужно для создания документов

Мастер подготавливает компоненты для выбранных форматов. Проверьте план и запустите подготовку кнопкой: простое открытие мастера или запуск LuaBill не начинает загрузки.

LuaLaTeX и texlua

Для формирования документов

Используйте один дистрибутив TeX с командами lualatex и texlua. В Windows мастер может установить Basic MiKTeX и подготовить 19 прямых пакетов шаблона, их зависимости и языковые данные EN/DE/FR/IT/RU. Подходящий установленный TeX используется повторно. Сообщение о версии LuaHBTeX нормально; команду lualatex заменять не нужно.

Ghostscript

Для ZUGFeRD; необязателен для обычного PDF

Ghostscript подготавливает PDF/A-3 для ZUGFeRD и может сжимать обычные PDF. Мастер добавляет его, когда это требуется профилю ZUGFeRD, либо использует подходящую установленную копию.

Java 17 или новее

Для электронных счетов

Совместимая Java 17+ запускает Mustang для проверки XML и упаковки/проверки ZUGFeRD. Для новой установки в Windows предлагается Temurin JRE 21; вариант с Homebrew в macOS использует Temurin 21 JDK. Обычный PDF не требует Java.

Python и PySide6/Qt

Для настольного интерфейса

В Windows-пакете уже включены. Для Linux, macOS и ручной установки сначала установите совместимый Python; сценарий создаст отдельную среду и загрузит PySide6.

Частные шрифты Noto для документов

Подготавливаются для всех пяти языков

Мастер загружает проверенный набор Noto Sans и Noto Sans Mono с исходной лицензией в пользовательскую папку LuaBill. Программа использует эти файлы напрямую, без регистрации шрифтов в операционной системе. Существующие системные шрифты остаются запасным вариантом.

Полный TeX в установщик не входит. При первой подготовке могут загружаться инструменты TeX, пакеты, шрифты и необходимые для профиля Java/Ghostscript. Мастер проверяет все пять языков и создание тестового документа выбранного формата; обычный отчёт компонентов подтверждает только часть условий.

Компактный пакет и мастер настройки документов

В LuaBill 0.1.27 появился мастер подготовки на пяти языках. Подготовьте инструменты один раз, затем создавайте документы локально: включать полный LaTeX в установщик LuaBill не требуется.

  1. Выберите нужные форматы

    Откройте «Справка → Подготовить создание документов» или оставьте отмеченным запуск подготовки в конце установки Windows. Выберите PDF, XML/XRechnung или ZUGFeRD.

  2. Проверьте найденные программы

    Мастер находит подходящие TeX, Java и Ghostscript и показывает план подготовки. Нажмите «Подготовить выбранные компоненты», чтобы начать загрузки и установку.

  3. Подготовьте пакеты и шрифты

    В Windows можно начать с Basic MiKTeX. Мастер подготавливает 19 прямых пакетов LaTeX с зависимостями и пятью языками документов, а также частные файлы Noto Sans и Noto Sans Mono. Java и Ghostscript добавляются по выбранному профилю.

  4. Создайте проверенный пример

    Мастер компилирует отдельный тест LaTeX дважды и создаёт фиктивный счёт через выбранный путь генерации. После завершения откройте тестовый PDF. При ошибке можно открыть папку журналов или скопировать диагностику.

Компактный пакет и мастер настройки документов
LuaBill 0.1.30 · Пример документа

PDF

LuaLaTeX, texlua, пакеты шаблона и подходящие шрифты. Для формирования обычного PDF Java и Ghostscript не требуются.

PDF + XML / XRechnung

Компоненты PDF и Java 17+ для проверки XML с помощью Mustang. Для новой установки в Windows предлагается более компактная Temurin JRE 21.

ZUGFeRD

Компоненты PDF/XML и Ghostscript для подготовки PDF/A-3 со встроенным XML; полученный контейнер проходит проверку.

Пакет программы остаётся компактным, но недостающие инструменты требуют отдельных загрузок через Интернет. Все три профиля генерации успешно проверены в Windows с установленными компонентами. Полная подготовка чистого Windows-компьютера и нативная установка Linux/macOS ещё требуют отдельной проверки.

Скачать отдельный тест LaTeX ↓

Тест работает без LuaBill: выберите LuaLaTeX и выполните компиляцию дважды. Проверяются все 19 прямых пакетов, пять языков, формулы, значки, таблицы и шрифты. MiKTeX может дозагрузить пакеты при разрешённой установке «на лету»; вне мастера системные шрифты устанавливаются отдельно. Контрольные суммы SHA-256

Обновление, проверка компонентов и удаление

Устанавливайте текущий выпуск поверх существующей программы и проверяйте активные правила для счетов через меню «Справка». Семь редактируемых примеров с готовыми PDF включены в программу и доступны единым ZIP-архивом.

01

Устанавливайте новую версию поверх

Закройте LuaBill и запустите новый установщик в прежнюю папку. Удалять предыдущую версию перед обновлением не требуется.

  • В Windows сохраните прежнюю папку, которую предложит Setup.
  • В Linux/macOS укажите тот же --prefix, если выбирали нестандартную папку.
  • Проекты, результаты и настройки в пользовательских папках сохраняются.
Linuxsh install.sh
macOSsh Install_LuaBill.command

Ручные изменения файлов программы сохраните отдельно. При конфликте установщик Linux/macOS остановит обновление. После установки проверьте версии правил через «Справка → Стандарты электронных счетов и обновления». Устанавливать старую версию поверх новой не рекомендуется.

02

Подготовьте компоненты и проверьте пример

Откройте «Справка → Подготовить создание документов», выберите профиль, проверьте найденные инструменты и подготовьте недостающие компоненты.

  • В Windows Python/Qt включены. В Linux/macOS используется установленный Python, а Qt загружается в отдельную среду.
  • Для PDF нужны TeX и шрифты; для XML/XRechnung дополнительно Java 17+; для ZUGFeRD также Ghostscript.
  • Подготовка запускает отдельный тест LaTeX на пяти языках дважды, затем проверяет настоящий путь генерации и валидации выбранного профиля.

При открытии мастер только проверяет состояние. Кнопка «Подготовить выбранные компоненты» запускает загрузки и установку; также можно проверить существующую настройку. Журналы и тестовые PDF открываются из мастера.

03

Удаляйте файлы программы

Деинсталлятор из нового архива может удалить прежнюю установку без переустановки LuaBill.

  • Закройте LuaBill и укажите прежний --prefix для нестандартной папки.
  • Документы, настройки и изменённые или неизвестные файлы сохраняются.
  • Прочитайте итоговые предупреждения и список оставшихся файлов.
Linuxsh uninstall.sh
macOSsh Uninstall_LuaBill.command

Небольшой отдельный архив тоже удаляет уже установленную копию. Системные TeX, Java, Ghostscript и папка скачанного пакета сохраняются.

Отдельный деинсталлятор Linux/macOS ↓ ZIP · 23 KB

Контрольные суммы SHA-256

Руководство пользователя ↗

05 / LuaBill

Электронный счёт — это ещё и данные

Выбирайте формат по требованиям получателя. Внешний вид PDF сам по себе не подтверждает наличие структурированного электронного счёта.

Обычный PDF

.pdf

Документ для просмотра и печати, без встроенного XML электронного счёта.

Отправляйте PDF, когда этот формат подходит для вашей операции.

XML · EN 16931

.xml + PDF + протокол

Структурированный XML CII, его PDF-представление и результат проверки.

Передавайте XML согласованным каналом; PDF можно приложить для удобного просмотра.

XRechnung

XRechnung 3 CII XML

Структурированный XML с референсами и электронными адресами сторон, требуемыми профилем XRechnung.

Отправляйте XML на портал или адрес, указанный получателем, с переданным им значением поля «Ссылка покупателя / Leitweg-ID».

ZUGFeRD · EN 16931

PDF/A-3 со встроенным XML

Гибридный PDF с XML внутри. Отдельный XML в результатах содержит те же данные.

Обычно передают гибридный PDF. Потребность в отдельном XML согласуйте с получателем.

Что проверяет LuaBill

  • Каждый электронный результат проверяется актуальным проверенным набором правил EN 16931 CII. Mustang также проверяет схему XML и выбранный профиль с активным пакетом правил до публикации результата.
  • Для ZUGFeRD дополнительно проверяются PDF/A и контейнер, а извлечённый XML побайтно сравнивается с отдельным файлом. Сохраняйте .validation.xml, .validation-rules.xml и .validation-info.json вместе с выпущенными PDF/XML.
  • Проверка формата не подтверждает уникальность номера, факт поставки или право на налоговое освобождение. Электронный экспорт предназначен для счетов, кредит-нот и сторнирующих счетов; предложения и заказы создаются как PDF.
05.1 / LuaBill

Какие правила проверили ваш счёт

LuaBill 0.1.30 включает проверенный пакет актуальных правил CII. Активные версии видны в программе, а протоколы проверки сохраняются рядом с выпущенными документами.

Состав пакета правил LuaBill 0.1.30 проверен 28 октября 2026 года.

Пакет правил этого выпуска

Правила EN 16931 CII
1.3.17Официальные правила CEN запускаются отдельным обязательным этапом для каждого результата XML, XRechnung и ZUGFeRD.
XRechnung / Schematron
3.0.2 / 2.6.0Формат счёта и набор его проверочных правил имеют разные номера версий. Актуальные правила CII подключаются из проверенного пакета LuaBill.
ZUGFeRD / Factur-X
2.5.2 / 1.09.2Профиль EN 16931 объединяет читаемый PDF/A-3 и структурированный XML. При создании по-прежнему проверяются PDF/A и контейнер.
Mustang CLI / veraPDF
2.26.0 / 1.30.2Исходный JAR Mustang не изменён. Проверенный пакет правил имеет приоритет там, где он применяется; активные версии и исходные ресурсы JAR показаны отдельно.
Окно стандартов LuaBill с активными версиями правил и отдельными сведениями об исходных ресурсах JAR Mustang
Настоящее окно программы: активные правила, последняя проверка документа и результаты проверки обновлений доступны отдельно.

Сохраняйте счёт вместе с подтверждением проверки

Откройте «Справка → Стандарты электронных счетов и обновления» или нажмите «Версии при проверке» рядом с созданным результатом. Журнал создания и сохранённые сведения показывают версии правил и валидатора, SHA-256, профиль XML и результаты этапов проверки.

*.pdf
Документ для просмотра; для ZUGFeRD — гибридный счёт со встроенным XML.
*.xml
Структурированный счёт; для ZUGFeRD он идентичен встроенному XML.
*.validation.xml
Исходный протокол Mustang для XML и, когда применимо, PDF/A и контейнера.
*.validation-rules.xml
Протокол SVRL дополнительной проверки актуальными правилами EN 16931 CII.
*.validation-info.json
Сведения об активных и исходных правилах, контрольных суммах, профиле и результатах этапов.
06 / LuaBill

Частые вопросы

LuaBill действительно бесплатный?

Код LuaBill открыт под Apache License 2.0. Его можно использовать и для коммерческой работы в рамках этой лицензии. Сторонние компоненты сохраняют собственные лицензии; отдельная облачная подписка LuaBill не требуется.

Нужно знать LaTeX или программирование?

Для обычной работы достаточно настольной формы: вводите данные обычным текстом и создавайте PDF/XML. Исходники и формат .bill остаются доступны для настройки и автоматизации.

Нужно устанавливать полный дистрибутив LaTeX?

Нет. В Windows мастер может установить Basic MiKTeX и необходимые LuaBill пакеты. Основной пакет программы остаётся компактным, но подготовка недостающих инструментов требует Интернета и дополнительных загрузок. Пакеты Linux-дистрибутива могут объединять более крупные наборы шрифтов и пакетов; вариант с Homebrew в macOS использует BasicTeX с нужными дополнениями. Подходящая установленная TeX-система используется повторно.

Можно вставлять в документ формулы LaTeX?

Да. Во вкладке Remarks поддерживается ограниченный набор команд LaTeX для оформления текста и формул, включая интегралы, суммы и дроби. Формулы заключаются в \( ... \) или \[ ... \]; обычный текст не требует разметки. В PDF формулы отрисовываются. В экспортируемых в XML примечаниях остаётся исходный LaTeX как обычный текст: программа получателя не обязана отображать его как формулу. Вступительный текст выводится только в PDF. Произвольные пакеты и макросы не поддерживаются.

Для компаний из каких стран подходит текущая версия?

Сейчас поддерживается поставщик с местонахождением в Германии. Клиент может находиться в Германии, в другой стране ЕС или за его пределами. Наличие французского или итальянского интерфейса не означает поддержку налоговых правил поставщика из любой страны.

Язык программы и документа могут отличаться?

Да. Интерфейс и руководство выбираются отдельно от языка документа. Поддерживаются EN, DE, FR, IT и RU; ваши описания, названия и свободный текст автоматически не переводятся.

Поддерживаются USD и другие валюты?

Да, валюта не привязана к стране клиента. Используйте трёхбуквенный код, например EUR, USD, CHF, RUB или CNY. Пересчёт по обменному курсу не выполняется; QR-код оплаты EPC/SEPA предназначен для подходящих счетов в EUR.

Куда отправляются мои данные?

LuaBill создаёт документы локально и не загружает счета на сервис генерации. По нажатию «Проверить в VIES» VAT ID покупателя отправляется в сервис VIES Европейской комиссии. Подготовка компонентов загружает программы, пакеты и шрифты. Ручная или включённая еженедельная проверка обновлений читает открытые сведения о выпусках без передачи данных счетов, покупателей и XML. Способ отправки готового счёта выбираете вы.

Как работают проверка VIES и зелёная галочка VAT?

Укажите полный VAT ID ЕС с префиксом страны (XI для Северной Ирландии, EL для Греции) и нажмите «Проверить в VIES» во вкладке «Покупатель». Завершённый ответ записывает результат и дату; сохраните проект .luabill, чтобы записать их в файл. Отрицательный ответ снимает зелёную галочку. Ошибка сервиса или соединения сохраняет прежнюю запись. Заданный срок актуальности считается в календарных днях относительно сегодняшней даты, а для PDF — дня создания; дата счёта на него не влияет. Эта проверка не подтверждает имя и адрес покупателя и не определяет налоговый режим сделки.

Что отправлять клиенту: .luabill, PDF или XML?

.luabill — ваш редактируемый проект. Для XRechnung передают XML; для ZUGFeRD обычно гибридный PDF со встроенным XML. Для обычного документа подходит PDF, если это допускают условия операции и получатель.

LuaBill заменяет бухгалтерскую программу?

LuaBill предназначен для подготовки документов. Он не управляет единой нумерацией вашей компании, бухгалтерскими проводками, банковскими операциями или архивом выпущенных версий. Эти процессы вы организуете отдельно.

Как перенести документы на другой компьютер?

Скопируйте проект .luabill и используемые изображения подписи и печати. При необходимости выберите изображения заново. Папка вывода относится к настройкам нового компьютера и не переносится внутри проекта.

Где найти инструкции и сведения о лицензиях?

В меню «Справка» доступны подробное руководство на языке интерфейса, проверка компонентов и сведения о сторонних компонентах и источниках. Руководства работают без Интернета и также входят в архив исходников. При ошибке создания документа откройте журнал и запустите проверку через «Справка → Подготовить создание документов»; мастер позволяет скопировать диагностику.

Нужно ли удалять LuaBill перед обновлением?

Нет. Закройте LuaBill и установите новую версию в ту же папку. В Linux/macOS используйте прежний --prefix, если устанавливали в нестандартное место. Пользовательские проекты, результаты и настройки сохраняются. Ручные изменения файлов программы сохраните отдельно: при конфликте установщик Unix остановит обновление.

Почему LuaLaTeX сообщает LuaHBTeX?

Сообщение «This is LuaHBTeX» нормально: LuaLaTeX использует этот движок в TeX Live. Запускать нужно команду lualatex; texlua также должна сохранять своё имя запуска. LuaBill 0.1.14 и новее правильно сохраняют эти ссылки. Используйте актуальный пакет, а не заменяйте lualatex прямым вызовом luahbtex.

Где увидеть, какими правилами проверен счёт?

Откройте «Справка → Стандарты электронных счетов и обновления» или нажмите «Версии при проверке» рядом с созданным результатом. Активные правила показаны отдельно от прежних ресурсов внутри исходного JAR Mustang. Сохраняйте .validation-info.json и оба XML-протокола вместе с выпущенным документом: они фиксируют профиль, версии правил, контрольные суммы и результаты этапов проверки.

LuaBill автоматически проверяет изменения правил для счетов?

Нажмите «Проверить обновления» в окне стандартов или включите необязательную еженедельную проверку при запуске. По умолчанию она выключена. Проверка сравнивает открытые технические выпуски, не передаёт данные счетов и не устанавливает правила. Новый выпуск предлагает проверить необходимость обновления LuaBill; сам по себе он не определяет юридические сроки и требования вашего получателя.

Почему после удаления остаются файлы?

LuaBill намеренно сохраняет документы, настройки и изменённые или неизвестные файлы. Отдельно установленные системные компоненты и папка скачанного архива тоже остаются. Деинсталлятор показывает предупреждения и оставшиеся пути. Сценарий из актуального архива может удалить старую установку без её переустановки.

07 / LuaBill

Сделаем LuaBill полезнее вместе

Открытый проект растёт благодаря реальным задачам пользователей, понятной обратной связи и небольшим улучшениям.

Расскажите о рабочем сценарии

Покажите, какой документ и какое поведение нужны вашему бизнесу. Для воспроизводимого примера замените личные и коммерческие данные вымышленными.

Улучшайте языки и инструкции

Помогайте сделать переводы, подсказки и руководства точнее и понятнее. Отдельно полезны реальные проверки терминов на каждом языке.

Проверяйте шаблоны и платформы

Проверяйте длинные таблицы, международные адреса, валюты и форматы электронных счетов. Нам важны результаты установки и работы на Linux и macOS.

Развивайте код

Изучайте исходники, предлагайте исправления, новые тесты и улучшения интерфейса. Архив исходников доступен вместе с пакетами выпуска.

Связаться с авторами можно по ссылкам на этой странице. Не передавайте реальные реквизиты, подписи и содержимое клиентских счетов в публичных примерах. Для использования LuaBill облачная учётная запись не требуется.

Open source · Apache License 2.0

Авторы проекта

Vsevolod Shashkov
Mikhail Shashkov

LuaBill вырос из повседневных деловых задач и используется в DIETZ automation GmbH. Мы создаём открытый инструмент для понятной работы с документами и приглашаем пользователей участвовать в его развитии.

DIETZ automation GmbH ↗

Copyright 2026 Vsevolod Shashkov & Mikhail Shashkov. Код LuaBill распространяется под Apache License 2.0; сторонние компоненты сохраняют свои лицензии.