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

Разработка

Е-фактури по EN 16931 в PHP: UBL или CII и валидиране

  • PN Scripts
  • 9 мин четене

Електронните фактури в ЕС излизат от обществените поръчки и навлизат в ежедневната търговия. Белгия ги направи задължителни между фирми от началото на 2026 г., Франция започна на 1 септември 2026 г., преходният период за издаване в Германия изтича през 2027 и 2028 г., а полската система KSeF стана задължителна на етапи през 2026 г. Ако пишете на PHP онлайн магазин, ERP или система за фактуриране и имате клиенти в тези държави, рано или късно ще трябва да издавате фактури по европейския стандарт EN 16931 и да проверявате, че са валидни, преди да ги изпратите.

В статията ще намерите сроковете, разликата между двата разрешени синтаксиса (UBL и CII), нивата на валидиране и най-честите грешки в бизнес правилата. Текстът е за разработчици и не е правен или данъчен съвет: какво трябва да съдържа фактурата и как се третира ДДС зависи от държавата и от бизнеса ви.

#Сроковете по държави

Датите са от официалните държавни страници в източниците, проверени на 5 октомври 2026 г. Правилата се променят, затова ги проверете отново, преди да планирате версия.

Държава Какво важи Срок
Белгия Структурирани е-фактури между белгийски фирми, регистрирани по ДДС От 1 януари 2026 г.; властите обявиха толеранс през първите три месеца на 2026 г.
Франция Получаване на е-фактури: всички фирми. Издаване и е-отчитане: големи и средни фирми 1 септември 2026 г.
Франция Издаване и е-отчитане: малки и микро фирми 1 септември 2027 г.
Германия Получаване на е-фактури по EN 16931: всички местни фирми От 1 януари 2025 г.
Германия Хартия или други формати за издаване все още са допустими (със съгласие на получателя) До 31 декември 2026 г.; до 31 декември 2027 г. за фирми с оборот до 800 000 евро за предходната година
Полша KSeF за големите фирми и за получаване на фактури 1 февруари 2026 г.
Полша KSeF за всички останали фирми, без най-малките 1 април 2026 г.
Полша KSeF за фирми с месечни продажби до 10 000 злоти 1 януари 2027 г.

На ниво ЕС пакетът „ДДС в цифровата ера“ (Директива (ЕС) 2025/516 на Съвета) въвежда е-фактури по EN 16931 и цифрово отчитане на вътреобщностните сделки между фирми, които се прилагат от 1 юли 2030 г.

Две практически бележки. Германия приема като формати по EN 16931 XRechnung и ZUGFeRD от версия 2.0.1 нататък, без профилите MINIMUM и BASIC-WL. Полската KSeF ползва собствена национална XML структура FA(3), а не UBL или CII, така че библиотека за EN 16931 сама по себе си не я покрива.

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

EN 16931-1 е семантичен модел на данните: списък от бизнес термини (BT-1 номер на фактурата, BT-2 дата на издаване, BT-109 обща сума без ДДС и т.н.), групи от термини (BG-25 ред от фактурата) и бизнес правила (BR-*), които казват кои данни са задължителни и как трябва да се сумират. Сам по себе си стандартът не определя XML формат. CEN/TS 16931-2 посочва синтаксисите, които пренасят модела, а Комисията ги публикува с Решение за изпълнение (ЕС) 2017/1870:

  • UN/CEFACT Cross Industry Invoice (CII), XML схеми D16B;
  • OASIS UBL 2.1, документи Invoice и CreditNote.

Държавите и мрежите добавят CIUS спецификации отгоре: по-строги или по-конкретни правила в рамките на стандарта. Най-известните са XRechnung (Германия) и Peppol BIS Billing 3.0.

#UBL 2.1 или CII D16B

И двата синтаксиса пренасят едни и същи данни. Разликата е в структурата и в това къде се използват.

UBL 2.1 CII D16B
Основен елемент Invoice или CreditNote (два вида документ) rsm:CrossIndustryInvoice (един вид документ; кодът на типа различава фактура от кредитно известие)
Структура Сравнително плоска; страните и сумите са близо до началото Вложена в блокове за документа, търговското споразумение, доставката и плащането
Обичайна употреба Мрежата Peppol, много публични портали Factur-X / ZUGFeRD (XML, вграден в PDF/A-3), разпространени във Франция и Германия
XRechnung Поддържа се Поддържа се

Ако получателите ви са в Peppol, ще издавате UBL. Ако клиентите искат PDF, който хората четат, а програмите обработват, обикновено това е Factur-X или ZUGFeRD с CII вътре. Много системи имат нужда и от двата. Затова е по-добре да имате един вътрешен модел и да записвате от него в който синтаксис ви трябва, вместо да сглобявате XML от низове на две места.

#Трите нива на валидиране

Фактурата може да се провали на няколко нива и всяко има нужда от различен инструмент.

1. Правилно оформен и безопасен за четене XML. Фактурите често идват отвън, затова ги третирайте като недоверени данни. Отказвайте DOCTYPE декларации и не позволявайте на парсера да зарежда външни обекти или да тегли нещо от мрежата. В PHP зареждайте с LIBXML_NONET и отхвърляйте всеки документ с DOCTYPE, преди да продължите.

2. XML схема (XSD). Проверява структурата и типовете данни спрямо официалните схеми на UBL 2.1 или CII D16B: имена и ред на елементите, задължителни елементи, формати на дати и числа. В PHP това става с DOMDocument::schemaValidate(). Успешната XSD проверка значи, че документът има правилна форма, но не казва нищо за това дали сумите излизат.

3. Бизнес правилата на EN 16931. Официалните артефакти за валидиране, поддържани за CEN/TC 434 в хранилището ConnectingEurope/eInvoicing-EN16931, описват правилата BR- на Schematron*. За да ги изпълните, ви трябва XSLT 2.0 процесор като Saxon; вграденото в PHP разширение ext-xsl поддържа само XSLT 1.0. CIUS като XRechnung или Peppol BIS добавя и собствен Schematron.

Готова за изпращане е само фактура, която минава и трите нива, плюс правилата на CIUS за мрежата на получателя.

#Най-честите грешки BR-*

Тези грешки се появяват отново и отново, когато фактурата се генерира от данни на магазин или ERP:

  • BR-CO-10: сборът от нетните суми по редове (BT-106) не е равен на сбора от редовете (BT-131). Обикновено причината е, че всеки ред се закръгля различно от общата сума.
  • BR-CO-13 и BR-CO-15: общата сума без ДДС или с ДДС не е равна на частите, от които се образува. Често значи, че отстъпки или надбавки на ниво документ са пропуснати в едно от изчисленията.
  • BR-CO-14 и BR-CO-17: общият ДДС не е равен на сбора от разбивката по ставки, или сумата в разбивката не е данъчната основа по ставката, закръглена до два знака.
  • BR-S-08: при стандартна ставка данъчната основа за всяка ставка в разбивката не съвпада с редовете, отстъпките и надбавките по тази ставка.
  • BR-E-10 и BR-AE-10: разбивка за освободена доставка или обратно начисляване без код или текст на основанието.
  • BR-CO-09: ДДС номер без валиден префикс на държавата (за Гърция е EL).
  • BR-CO-25: положителна сума за плащане без падеж или условия за плащане.
  • BR-16: фактура без нито един ред.

Повечето грешки в изчисленията изчезват, ако никога не пазите сумите отделно: изчислявайте разбивката по ДДС и общите суми от редовете, с точна десетична аритметика (bcmath или библиотека за десетични числа), никога с float.

#Пример: PN Scripts Invoice

PN Scripts прави PN Scripts Invoice, безплатна PHP библиотека с лиценз MIT, която не зависи от конкретна рамка. Има я в GitHub и в Packagist като pnscripts/pn-invoice и изисква PHP 8.3 или по-нов с разширенията dom, libxml и bcmath.

composer require pnscripts/pn-invoice

Какво прави спрямо нивата по-горе:

  • Типизиран модел на фактура и кредитно известие с точни десетични числа. Сумите и разбивката по ДДС винаги се изчисляват от редовете, отстъпките и надбавките, така че правилата за изчисления BR-CO се спазват по конструкция.
  • Запис в UBL 2.1 и CII D16B от един и същ модел.
  • Валидиране на нива: безопасност на XML (без мрежов достъп, отказ на DOCTYPE), XSD с вградени официални схеми за работа без интернет и документиран набор от 104 бизнес правила на EN 16931 на чист PHP. Всеки резултат има код на правилото, сериозност, ниво, съобщение и XPath.
  • Незадължителен адаптер, който пуска официалния Schematron през външен XSLT 2.0 процесор, за пълна проверка на съответствието.
  • Проверка от командния ред: vendor/bin/pn-invoice validate invoice.xml.
use Pnscripts\Invoice\Validation\InvoiceValidator;
$result = (new InvoiceValidator())->validateFile('invoice.xml');
foreach ($result->errors() as $violation) {
    printf("%s [%s] %s at %s\n", $violation->ruleId, $violation->layer->value, $violation->message, $violation->location);
}

Прочетете и ограниченията. PN Scripts Invoice покрива документирано подмножество на EN 16931: в README са изброени правилата, които са реализирани, и тези, които още не са, например някои групи ДДС категории и правилата за десетични знаци и кодови списъци. Все още не включва XRechnung, Factur-X и специфичните правила на Peppol и не създава KSeF FA(3). Това, че фактурата минава проверките, не удостоверява, че тя отговаря на закона. Библиотеката е технически инструмент, а не правен или данъчен съвет; нека счетоводителят ви провери фактурите.

Изискванията и последната версия са на страницата на PN Scripts Invoice. Вижте също: Какво е нужно за надеждна API интеграция.

#Често задавани въпроси

UBL или CII да използвам?

Това, което очакват получателите ви и тяхната мрежа. Peppol използва UBL, а Factur-X и ZUGFeRD вграждат CII в PDF. И двата са разрешени синтаксиси на EN 16931, така че един вътрешен модел, който записва и в двата, ви оставя свобода.

Достатъчна ли е проверката по XSD?

Не. XSD проверява структурата и типовете данни. Бизнес правилата на EN 16931, например BR-CO-15 за сумите, се проверяват с официалния Schematron или с еквивалентна реализация, а CIUS като XRechnung добавя още правила.

Може ли PHP да изпълни официалния Schematron?

Не с вграденото XSL разширение, което поддържа само XSLT 1.0, докато официалните артефакти изискват XSLT 2.0. Обичайният подход е да извикате външен XSLT 2.0 процесор като Saxon или услуга за валидиране и да прочетете нейния SVRL отчет.

Покрива ли библиотека за EN 16931 полската KSeF?

Не сама по себе си. KSeF използва националната полска XML структура FA(3), затова ви трябват отделен запис в този формат и връзка с интерфейса на KSeF.

Сертифицирана ли е PN Scripts Invoice?

Не. Тя реализира документирано подмножество на бизнес правилата на EN 16931 и е тествана с официалните тестови случаи за правилата, които реализира. За пълно съответствие пуснете официалния Schematron през адаптера ѝ. Не е правен или данъчен съвет.

Още по темата

Още по темата

Коментари

Коментари

Все още няма коментари. Задайте въпрос или споделете какво проработи при вас.

Оставете коментар

показва се до коментара; може и псевдоним
по избор; само за известия за отговори, не се показва
Обикновен текст с **удебелен**, *наклонен*, `код`, > цитати и връзки.

Следваща стъпка

pnscripts.com/bg/contact

Пишете на екипа

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

Пишете ни

Семейството PN Scripts

Другите сайтове на PN Scripts

Хостингът, игрите и блогът имат свои сайтове, поддържани от същата компания.

  • pnscripts.com

    PN Scripts

    Софтуерно инженерство

    Уеб и мобилни приложения и API по поръчка, плюс нашите продукти и плъгини с отворен код.

  • games.pnscripts.com

    Игри

    Игри и игрови сървъри

    Домът на игрите на PN Scripts: безплатни браузърни игри, които се играят веднага, а игровите сървъри предстоят.

  • hosting.pnscripts.com

    Хостинг

    Хостинг и инфраструктура

    Споделен хостинг, KVM VPS, самостоятелни сървъри и домейни от същата компания, която изработва проекта ви.

  • blog.pnscripts.com

    Блог

    Статии и бележки

    Практични статии за разработка на софтуер, хостинг, отворен код и игри, писани с помощта на AI и проверени от хората, които ги създават.

    Вие сте тук