LuaBill · Разделы документации

Создание ZUGFeRD

ZUGFeRD объединяет привычный PDF для человека и структурированный XML для автоматической обработки в одном файле.

Что содержится внутри файла

Обычный PDF показывает страницу, но не становится электронным счётом только из-за имени файла или печатного заголовка. В ZUGFeRD используется контейнер PDF/A-3 со встроенным XML CII.

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

Сравнить PDF, XML и гибридный формат →

Подготовьте компоненты и создайте счёт

Для ZUGFeRD нужны LuaLaTeX и пакеты шаблона, шрифты, Java 17+, Mustang и Ghostscript. Выберите профиль ZUGFeRD в мастере подготовки компонентов и дождитесь успешной тестовой генерации.

Заполните структурированные данные счёта, сохраните .luabill и выберите ZUGFeRD на вкладке вывода. LuaBill подготавливает PDF/A-3, встраивает XML и проверяет итоговый контейнер. В выпуске 0.1.31 ресурсы Mustang соответствуют ZUGFeRD 2.5.2 / Factur-X 1.09.2.

Установка компонентов →

Проверьте вложение и передайте PDF

После успешной генерации откройте PDF и проверьте суммы, реквизиты и вид документа. В средстве просмотра PDF, которое поддерживает вложения, можно увидеть встроенный XML. Итоговое сообщение LuaBill и протоколы показывают результат проверки контейнера.

Если получатель принимает ZUGFeRD, передавайте созданный гибридный PDF: XML уже внутри. Отдельный экспортированный XML полезно сохранять вместе с проектом и протоколами; отправляйте его дополнительно, когда этого требует получатель.

Изображение подписи или печати в PDF не является криптографической электронной подписью и не определяет наличие встроенного XML.

Пример электронного счёта →Если проверка не пройдена →
← Вернуться к документации