Какво е XSD и защо има значение
XSD (XML Schema Definition) описва каква структура трябва да има SAF-T файлът — кои елементи са задължителни, в какъв ред, с какви типове данни и формати. Преди да приеме файла, системата го валидира спрямо схемата. Ако нещо не отговаря, файлът се отхвърля изцяло — дори стойностите да са верни по същество. Затова коректната структура е толкова важна, колкото и верните данни.
Откъде да вземете схемата
Използвайте само официалната XSD схема, публикувана от НАП, и проверявайте за нейната актуална версия. Технически указания и образци се публикуват на страницата на НАП за системата за счетоводно отчитане (SAF-T).
Най-чести грешки при подаване
- Липсващи задължителни полета — напр. идентификатор на контрагент, данъчен код, отчетен период.
- Грешен формат на дати/числа — десетичен разделител, формат на датата, валута.
- Невалидни или непознати кодове — данъчни кодове извън номенклатурата.
- Несъответствие на салда — главна книга, която не се връзва с обобщените суми.
- Кодиране на символи — проблеми с UTF-8 и кирилица.
- Дублирани записи — повтарящи се идентификатори на фактури или контрагенти.
Как да валидирате преди реалното подаване
- Свалете актуалната XSD схема от официалния източник (НАП).
- Валидирайте експортирания XML спрямо схемата (вграден инструмент в ERP или отделен валидатор).
- Прегледайте съобщенията за грешка — те сочат точния елемент и ред.
- Коригирайте в системата-източник, не ръчно във файла, за да не се повтори грешката следващия път.
Превенция чрез чисти данни
Повечето XSD грешки идват не от схемата, а от непоследователни данни. Поддържането на единни номенклатури, валидни контрагенти и автоматизиран експорт от интегрирана система премахва голяма част от проблемите още преди валидацията. Това е особено важно заради гратисния период — той е време за тестване, а не за отлагане.