Translation. Original: faktury/weryfikacja-faktury.md

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

15.01.2026

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

Відповідність схемі XSD

Рахунок-фактура має бути підготований у форматі XML, закодований у UTF-8 без символу BOM (перші 3 байти 0xEF 0xBB 0xBF), відповідно до заявленої схеми, вказаної при відкритті сесії.

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

• 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 для проведення індивідуального аналізу та підбору відповідного рішення.