Translation. Original: faktury/weryfikacja-faktury.md

Верифікація рахунку-фактури

09.04.2026

Рахунок-фактура, що надсилається до системи KSeF, підлягає ряду технічних та семантичних перевірок. Верифікація включає наступні критерії:

Відповідність XML

Рахунок-фактура має одночасно відповідати таким вимогам:

• має бути підготований як коректний документ XML, відповідно до правил XML 1.0,
• має бути закодований у UTF-8 без символу BOM (перші 3 байти 0xEF 0xBB 0xBF),
• має відповідати задекларованій схемі, вказаній при відкритті сесії,
• може містити пролог XML, однак якщо він присутній, він не може вказувати кодування інше, ніж UTF-8,
• не може містити інструкцій обробки XML (processing instructions),
• не може містити небажаних символів Unicode, визначених у специфікації XML W3C, тобто символів з діапазонів:
  [#x7F-#x84], [#x86-#x9F], [#xFDD0-#xFDEF],
  [#x1FFFE-#x1FFFF], [#x2FFFE-#x2FFFF], [#x3FFFE-#x3FFFF],
  [#x4FFFE-#x4FFFF], [#x5FFFE-#x5FFFF], [#x6FFFE-#x6FFFF],
  [#x7FFFE-#x7FFFF], [#x8FFFE-#x8FFFF], [#x9FFFE-#x9FFFF],
  [#xAFFFE-#xAFFFF], [#xBFFFE-#xBFFFF], [#xCFFFE-#xCFFFF],
  [#xDFFFE-#xDFFFF], [#xEFFFE-#xEFFFF], [#xFFFFE-#xFFFFF],
  [#x10FFFE-#x10FFFF].

Недотримання будь-якої з наведених вище вимог призведе до відхилення рахунку-фактури.

Унікальність рахунку-фактури

• KSeF виявляє дублікати рахунків-фактур глобально, на основі даних, що зберігаються в системі. Критерієм ідентифікації дубліката є комбінація:
  1. NIP продавця (Podmiot1:NIP)
  2. Тип рахунку-фактури (RodzajFaktury)
  3. Номер рахунку-фактури (P_2)
• У випадку дубліката повертається код помилки 440 («Дублікат рахунку-фактури»).
• Унікальність рахунку-фактури підтримується в KSeF протягом 10 повних років, що відраховуються з кінця календарного року, в якому рахунок-фактура була виставлена.
• Критерій унікальності завжди стосується продавця (Podmiot1:NIP). У випадку, коли від імені того ж суб'єкта рахунки-фактури виставляють різні підрозділи (наприклад, відділення, організаційні одиниці JST, інші уповноважені суб'єкти), вони мають узгодити правила нумерації для уникнення дублікатів.

Валідація дат

Дата виставлення рахунку-фактури (P_1) не може бути пізнішою за дату прийняття документа до системи KSeF.

Валідація номера NIP

• Перевірка контрольної суми NIP для: Podmiot1, Podmiot2, Podmiot3 та PodmiotUpowazniony (якщо присутній).
• Стосується тільки продуктивного середовища.

Валідація номера NIP у внутрішньому ідентифікаторі

• Перевірка контрольної суми NIP у внутрішньому ідентифікаторі (InternalId) для Podmiot3 - якщо цей ідентифікатор присутній.
• Стосується тільки продуктивного середовища.

Розмір файлу

• Максимальний розмір рахунку-фактури без додатків: 1 MB * (1 000 000 байтів).
• Максимальний розмір рахунку-фактури з додатками: 3 MB * (3 000 000 байтів).

Кількісні обмеження

• Максимальна кількість рахунків-фактур в одній сесії (як інтерактивній, так і пакетній) становить 10 000 *.
• У межах пакетного відправлення можна надіслати максимум 50 файлів ZIP; розмір кожного файлу до шифрування не може перевищувати 100 MB (100 000 000 байтів), а загальний розмір пакета ZIP - 5 GB (5 000 000 000 байтів).

Правильне шифрування

• Рахунок-фактура має бути зашифрований алгоритмом AES-256-CBC (симетричний ключ 256 біт, IV 128 біт, з доповненням (padding) PKCS#7).
• Симетричний ключ зашифрований алгоритмом RSAES-OAEP (SHA-256/MGF1).

Відповідність метаданих рахунку-фактури в інтерактивній сесії

• Обчислення та верифікація хешу рахунку-фактури разом з розміром файлу.
• Обчислення та верифікація хешу зашифрованого рахунку-фактури разом з розміром файлу.

Обмеження щодо додатків

• Відправка рахунків-фактур з додатками дозволена тільки в пакетному режимі.
  Виняток: У випадку надсилання технічного виправлення офлайн рахунку-фактури допустиме використання інтерактивної сесії.
• Можливість відправки рахунків-фактур з додатками вимагає попереднього заявлення цієї опції в сервісі e-Urząd Skarbowy.

Вимоги щодо повноважень

Надсилання рахунку-фактури до KSeF вимагає наявності відповідних повноважень для її виставлення в контексті даного суб'єкта.

* Увага: Якщо у бізнес-сценаріях організації доступні ліміти є недостатніми, просимо зв'язатися з відділом підтримки KSeF для проведення індивідуального аналізу та підбору відповідного рішення.