Към съдържанието
PN Scripts

API

PN Invoice

Безплатна PHP библиотека, която създава и проверява електронни фактури и кредитни известия по EN 16931 в UBL 2.1 и UN/CEFACT CII D16B. Работи без фреймуърк, с лиценз MIT.

  • PHP 8.3+
  • ext-dom
  • ext-libxml
  • ext-bcmath
  • UBL 2.1

Какъв проблем решава

Празнината

Фактурата по EN 16931 трябва да е коректен XML в UBL 2.1 или CII и освен това да спазва бизнес правилата на стандарта. Проверката на двете от PHP приложение обикновено минава през отделни инструменти.

Какво представлява

PN Invoice изгражда фактурата или кредитното известие в PHP, записва го като UBL 2.1 или CII D16B и го проверява на нива: безопасност на XML, XSD спрямо приложените официални схеми и 104 бизнес правила от EN 16931 на чист PHP.

Как се използва

Добавете го с composer require pnscripts/pn-invoice или проверете готов файл с bin/pn-invoice validate.

Технически инструмент за разработчици. Проверява документирано подмножество на бизнес правилата на EN 16931, а не пълно съответствие, и не е правен или данъчен съвет.

За кого е

Използвайте го когато

  • PHP приложение, което трябва да издава фактури или кредитни известия по EN 16931.
  • Проверка на UBL или CII файлове, преди да бъдат обработени.

Направено за

  • PHP разработчици с какъвто и да е фреймуърк или без такъв.
  • Екипи, които правят софтуер за фактуриране или счетоводство.

Какво прави

Два синтаксиса, един модел

Изграждате фактурата или кредитното известие веднъж и го записвате като UBL 2.1 или UN/CEFACT CII D16B.

Първо безопасен XML

Входът се чете без достъп до мрежата, а документ с DOCTYPE се отказва.

Проверка по схема

Документите се проверяват спрямо официалните XSD схеми, които идват с пакета.

104 бизнес правила на PHP

Документирано подмножество на бизнес правилата на EN 16931 работи на чист PHP. Това не е пълно съответствие със стандарта.

Schematron, когато ви трябва

Адаптер по избор пуска Schematron проверка чрез Saxon.

Команден ред

bin/pn-invoice validate проверява файл от терминала.

Публикувано и какво следва

v0.1.0 е първата версия. Всичко в колоната „Планирано“ още не е в нея.

Налично сега

  • Фактури и кредитни известия в UBL 2.1 и CII D16B
  • Безопасност на XML, XSD и 104 бизнес правила от EN 16931
  • Адаптер за Schematron чрез Saxon по избор
  • bin/pn-invoice validate

Планирано

  • Изпращане през Peppol
  • XRechnung
  • Factur-X и ZUGFeRD

Спецификации

Разработчик
PN Scripts
Вид
Пакет
Платформи
PHP
Последна версия
v0.1.0
Ценообразуване
Безплатно
Лиценз
MIT
Внедряване
Composer пакет
Зрялост
v0.1.0, публикувана на 04.10.2026
Поддръжка
Общност

Съвместимост

Платформа или среда Поддържани версии Тествано до
PHP 8.3 или по-нова 8.5

Стек

  • PHP 8.3+
  • ext-dom
  • ext-libxml
  • ext-bcmath
  • UBL 2.1
  • UN/CEFACT CII D16B

Вземете PN Invoice

Инсталирайте го с composer require pnscripts/pn-invoice или клонирайте публичното хранилище. Безплатно, с лиценз MIT.

Въпроси

Не. Проверява по XSD схемите и прилага 104 бизнес правила от EN 16931, документирано подмножество на стандарта. Адаптер по избор може да пусне и Schematron проверка чрез Saxon.

PHP 8.3 или по-нов с разширенията dom, libxml и bcmath. Не зависи от фреймуърк. CI пуска 823-те му теста на PHP 8.3, 8.4 и 8.5.

Още не. Изпращането през Peppol, XRechnung и Factur-X/ZUGFeRD са планирани и не са част от v0.1.0.

Не. PN Invoice е технически инструмент. Дали една фактура отговаря на правилата, които важат за вас, потвърждавате вие с вашия счетоводител или данъчен консултант.