Технически типове данни и номенклатури

Защо въобще ви трябва тази глава

До момента говорихме за кои полета са задължителни и кога. Тук говорим за нещо по-приземено, но също толкова важно: какъв формат приема всяко поле - защото схемата налага строги граници на дължина и точност, и надвишаването им не е "предупреждение", а причина за отрязване на данни или отхвърляне на файла.

Пълният списък технически типове (SimpleTypes)

Всяко поле в SAF-T е дефинирано чрез един от следните 17 базови типа - вижте пълния речник (глава по глава, секция "Технически типове") за конкретен пример при всеки. Диаграмата по-долу показва всичките 17, с точния формат и граница на всеки.

Десетичният разделител е винаги точка

Независимо от българския писмен навик (запетая като десетичен разделител), XML стандартът зад SAF-T изисква точка (.) навсякъде, без изключение - за паричните суми, количествата, обменния курс, всичко от тип Decimal. Това не е избор на НАП, а изискване на самия XML/XSD технически стандарт - и се отнася еднакво за SAFmonetaryType, SAFquantityType, SAFweightType и обикновения Decimal тип.

Обменният курс - винаги към еврото

Курсът в ExchangeRate (използван в CurrencyAmount x ExchangeRate = Amount, виж глава 5) е винаги изразен от чуждата валута към EUR - не към лева, и не по избор на счетоводната програма.

Датите и часовете - ISO 8601, без изключения

Всички дати във файла следват формат ГГГГ-ММ-ДД (напр. 2026-07-22), а часовете - 24-часов формат ЧЧ:ММ (напр. 15:03), без значение колко рядко се среща полето от тип Time в практиката (появява се почти изцяло само където схемата изрично изисква час, отделно от дата - например MovementPostingTime при движение на стоки). Български формат на дата (22.07.2026) или 12-часов формат с "AM"/"PM" не се приемат никъде във файла.

Кодовете по ISO стандарти

Държавите се изписват с двубуквен код по ISO 3166-1 alpha-2 (BG, DE, FR) - не трибуквения вариант (BGR), който също съществува като стандарт, но не е този, който SAF-T очаква. Валутите се изписват с трибуквен код по ISO 4217 (EUR, USD) - символи като € или $ не са валидни стойности за полето.

Номенклатурите, които трябва да мапирате

Отделно от техническите типове по-горе, SAF-T разчита на официални номенклатури на НАП - вашите вътрешни кодове трябва да бъдат съпоставени с тях преди подаване, не използвани директно. Общо номенклатурите са 14 - пълният списък е в диаграмата по-долу.

Само пет от тях изискват реално, ръчно мапиране на вашите собствени вътрешни кодове за месечно подаване: сметкоплан, продукти, данъчни кодове, мерни единици и видове документи. Останалите девет (механизми за плащане, видове движение на стоки/активи, вид на материалния запас, данъчни режими, IBAN, кодове на държави/области, валути) се прилагат от софтуера автоматично, като референция или валидация - вие не мапирате нищо свое към тях.

От петте реални мапирания обемът и времето за всяко се различават драстично:

• Продукти (NC8_TARIC, около 9 900 записа общо) - обичайно най-времеемката част, ако фирмата има богат продуктов каталог. Не заради обема на самата номенклатура (мапирате само артикулите, които реално продавате или купувате, не целия списък), а защото продуктовите описания във вашата счетоводна програма рядко са стандартизирани - всеки артикул реално изисква отделна преценка.
• Сметкоплан на НАП (NRA_Nom_Accounts, обичайно 250-350 кода) - идва на второ място по обем работа. Колко точно зависи пряко от това колко аналитичен е вашият собствен вътрешен сметкоплан спрямо номенклатурата на НАП - плитък вътрешен сметкоплан (малко на брой, общи сметки) означава повече ръчна преценка при мапиране на всяка сметка, не по-малко.
• Данъчни кодове, мерни единици и видове документи - списъците им са къси, но мапирането им е реално и задължително, не просто декоративна стъпка.

Какво да запомните от тази глава

• 17 базови технически типа стоят зад всяко поле в схемата - вижте диаграмата по-горе за пълния списък граници.
• Десетичният разделител е винаги точка, никога запетая - за всички числови типове.
• Текстовите полета имат различни максимални дължини (9/18/35/70/256 знака) според типа им - надвишаването е причина за отхвърляне при валидация; дали софтуерът ви ви предпазва от това (например чрез мълчаливо съкращаване) или не, зависи от инструмента, не от схемата.
• Обменният курс е винаги към еврото, независимо от навика да се мисли в лева.
• Датите следват ISO 8601 (ГГГГ-ММ-ДД), часовете - 24-часов формат - без изключения.
• Общо 14 номенклатури, но само 5 изискват реално мапиране на вашите вътрешни кодове (сметкоплан, продукти, данъчни кодове, мерни единици, видове документи) - останалите 9 се прилагат автоматично като референция.
• Продуктите, не сметкопланът, обичайно отнемат най-много време при богат продуктов каталог; сметкопланът е на второ място, а обемът му зависи от това колко аналитичен е вашият вътрешен сметкоплан спрямо номенклатурата на НАП.

Следващата глава разглежда специфичните случаи - международни операции, данък при източника и трите сектора с особени облекчения (банки, застрахователи, лечебни заведения).