TaxLayer
УвійтиПочати безкоштовно
Інструменти2026-06-308 хв читанняавтор: TaxLayer Team

Валідатор KoSIT: покрокове керівництво з перевірки XRechnung та ZUGFeRD

Перш ніж завантажувати XRechnung на ZRE або відправляти ZUGFeRD-рахунок діловому партнеру, потрібно перевірити файл на відповідність EN 16931. Це запобігає дорогим відхиленням та затримкам платежів.

> Коротка відповідь: Валідатор KoSIT — офіційний Java-інструмент перевірки XRechnung. Для простішого способу використовуйте Валідатор TaxLayer: працює в браузері, без встановлення, підтримує XRechnung та ZUGFeRD.

Що таке KoSIT і навіщо потрібен валідатор?

KoSIT (Koordinierungsstelle für IT-Standards) — ІТ-координаційна рада земель Німеччини, що розробила стандарт XRechnung. Їхній валідатор — офіційний еталон перевірки для XRechnung.

Валідатор перевіряє:

  • Синтаксичну відповідність (XML-схема)
  • Семантичну відповідність (бізнес-правила EN 16931)
  • XRechnung CIUS (Core Invoice Usage Specification)
  • Коди помилок BR-DE-* (специфічні для Німеччини бізнес-правила)

Як використовувати офіційний валідатор KoSIT?

Крок 1: Встановлення Java

Валідатор KoSIT вимагає Java 11 або вище. Якщо Java не встановлена, завантажте з adoptium.net.

Крок 2: Завантаження валідатора

Завантажте актуальну версію валідатора KoSIT з GitHub. Завантажте файл validator-x.x.x-release.zip та розпакуйте його.

Крок 3: Завантаження сценаріїв перевірки

Додатково завантажте Validator Configuration (сценарії перевірки для XRechnung) з GitHub KoSIT.

Крок 4: Запуск перевірки

`bash

java -jar validationtool-x.x.x-standalone.jar \

-s scenarios.xml \

-o output/ \

your-invoice.xml

`

Крок 5: Інтерпретація результату

Валідатор створює XML- та HTML-звіт. Шукайте:

  • true — файл пройшов перевірку
  • false — знайдені помилки, дивіться блоки

Найбільш поширені повідомлення про помилки

Код помилкиЗначенняРішення
BR-DE-01BT-10 (Leitweg-ID) порожньоЗаповніть [Leitweg-ID](/blog/leitweg-id-poyasnennya)
BR-DE-02Відсутній специфічний для DE елементПеревірте обов'язкові поля
BR-DE-26BT-48 (VAT ID) відсутнійВкажіть ПДВ-номер постачальника
UBL-SR-01Недопустимий елемент UBL 2.1Перевірте XML-схему
PEPPOL-EN16931-R001Порушення правил EN 16931Перевірте [обов'язкові поля](/blog/en-16931-obovyazkovi-polya)

Альтернатива: Валідатор TaxLayer

Якщо Ви не хочете встановлювати Java і працювати з командним рядком, Валідатор TaxLayer — практична альтернатива:

Переваги перед KoSIT:

  • Працює прямо в браузері — без встановлення
  • Підтримує і XRechnung, і ZUGFeRD (пряме завантаження PDF)
  • Показує помилки зрозумілою мовою з BT-посиланнями
  • Додатково відображає дані рахунку як перегляд

Обидва валідатори працюють локально в браузері — Ваші рахунки не завантажуються на сервер.

Як перевірити ZUGFeRD за допомогою KoSIT?

Офіційний валідатор KoSIT розроблений для XML-файлів XRechnung. Для ZUGFeRD необхідно спочатку витягти вбудований XML:

  1. Відкрийте ZUGFeRD PDF в Adobe Acrobat або аналогічній програмі
  2. Перейдіть до Інструменти → Вкладення і завантажте factur-x.xml
  3. Запустіть цей XML через валідатор KoSIT

Простіше: Валідатор TaxLayer приймає ZUGFeRD PDF безпосередньо і автоматично витягує та перевіряє вбудований XML.

Що робити після успішної перевірки?

Після успішної перевірки:

  1. Для XRechnung: Завантажте файл на ZRE або відправте через OZG-RE
  2. Для ZUGFeRD: Відправте файл діловому партнеру електронною поштою

TaxLayer автоматично перевіряє кожен згенерований файл за EN 16931 перед завантаженням. Вам не потрібно запускати окремий валідатор — перевірка інтегрована в робочий процес. Перші 2 конвертації на місяць безкоштовно — спробуйте зараз.

Часті запитання

Що таке валідатор KoSIT?

Валідатор KoSIT — це офіційний інструмент перевірки для XRechnung від ІТ-координаційної ради (KoSIT). Він перевіряє XML-файли на відповідність EN 16931 та XRechnung CIUS. Доступний як Java-застосунок або через онлайн-сервіси.

Чи безкоштовний валідатор KoSIT?

Так, офіційний валідатор KoSIT з відкритим вихідним кодом і безкоштовний. Потрібна Java. Альтернативно: Валідатор TaxLayer працює в браузері без встановлення та також безкоштовний.

Чи може валідатор KoSIT перевіряти ZUGFeRD?

KoSIT розроблений для XRechnung та EN 16931. Для ZUGFeRD потрібно спочатку витягти вбудований XML, потім перевірити його. Валідатор TaxLayer перевіряє як XRechnung, так і ZUGFeRD-файли безпосередньо.

Що означає помилка BR-DE-01?

BR-DE-01 означає: поле BT-10 (Buyer Reference / Leitweg-ID) порожнє або відсутнє. Це обов'язкове поле для XRechnung при рахунках державним органам. Заповніть Leitweg-ID, отриманий від замовника.

Чи потрібно мені встановлювати Java для валідатора KoSIT?

Для офіційного Java-валідатора KoSIT — так. Для Валідатора TaxLayer нічого встановлювати не потрібно — він працює повністю в браузері.

Чи перевіряє валідатор, чи буде рахунок прийнятий на ZRE?

Якщо файл проходить перевірку KoSIT без помилок, він відповідає формальним вимогам. Фактичне прийняття ZRE також залежить від правильного Leitweg-ID та наявності отримувача в системі.

Конвертуйте PDF-рахунки прямо зараз

Спробуйте TaxLayer безкоштовно — 2 конвертації на місяць, кредитна картка не потрібна.

Почати