ЗА ПРОИЗВОДИТЕЛИ НА СЧЕТОВОДЕН СОФТУЕР · ВЕРСИЯ 1.0

Универсален формат на Sortis

Sortis разчита фактури, кредитни и дебитни известия и касови бележки и ги дава на счетоводната програма като файл. Освен готовите файлове за Делта, АС2012, ЕДИС и Плюс Минус, Sortis прави и един общ файл — описан тук, за да може всяка програма да го внася. Описанието е отворено: ползвайте го свободно.

Два варианта с едни и същи данни: XML (sortis_universal_….xml) и CSV (sortis_universal_….csv). И двата са в UTF-8. Счетоводителят ги прави от Sortis с „Още ▾“ → „Направи файл в универсален формат“. Файлът се записва в папка _sorted до документите.

1. Общи правила

Дати — ГГГГ-ММ-ДД (напр. 2026-10-05). Празно, когато датата не е отпечатана на документа.
Суми — с точка и два знака след нея (137.40), без разделител за хилядите и без знак за валута.
Суми при кредитно известие — както са отпечатани, положителни. Дали документът намалява или увеличава, казва полето „Вид“ (credit / debit).
Ставка на ДДС — 20, 9 или 0. Празно, когато документът е с няколко ставки — тогава Sortis не гадае.
Празно поле значи „не е отпечатано или не е разчетено“. Sortis не измисля стойности.
Дубликатите и проформите не влизат във файла. Документи без дата, сума, номер или с неясна посока също не влизат — Sortis казва на счетоводителя колко са.

2. Полетата на документа

XML	CSV колона	Съдържание
`Direction`	Посока	`purchase` — покупка (фирмата е получател), `sale` — продажба (фирмата е издател)
`Type`	Вид	`invoice` фактура · `debit` дебитно известие · `credit` кредитно известие · `receipt` касова бележка · `protocol` протокол
`Number`	Номер	Номерът на документа, както е отпечатан (с водещите нули). При известие — номерът на известието.
`Date`	Дата	Дата на издаване
`DueDate`	Падеж	Дата на падеж / срок на плащане
`TaxEventDate`	ДанъчноСъбитие	Дата на данъчното събитие
`Supplier/Name`	ДоставчикИме	Наименование на доставчика
`Supplier/EIK`	ДоставчикЕИК	ЕИК / Булстат (само цифри); при чуждестранен доставчик — неговият данъчен номер
`Supplier/VATNumber`	ДоставчикДДС	ИН по ДДС с префикса на държавата (`BG204817368`); празно, ако доставчикът не е регистриран
`Supplier/Address`	ДоставчикАдрес	Адресът на доставчика, на един ред
`Recipient/Name`	ПолучателИме	Наименование на получателя
`Recipient/EIK`	ПолучателЕИК	ЕИК на получателя (само цифри)
`Recipient/VATNumber`	ПолучателДДС	Запазено за следваща версия — засега празно
`Currency`	Валута	ISO код: `EUR`, `USD`…
`AmountWithoutVAT`	СумаБезДДС	Данъчна основа на целия документ
`VATAmount`	ДДС	Сума на ДДС
`AmountWithVAT`	СумаСДДС	Сума за плащане
`VATRate`	СтавкаДДС	`20`, `9`, `0` или празно при няколко ставки
`PaymentMethod`	Плащане	`cash` в брой · `bank` по банка · `card` с карта · `mixed` смесено · празно, ако не е посочено
`SourceFile`	Файл	Името на файла на документа (PDF или снимка)

3. Редовете (позициите)

Редовете идват, когато Sortis ги е разчел: от цифров PDF, от фактура на Sortis Invoice или от сканиран документ, чиито редове счетоводителят е поискал. Документ без разчетени редове е без Line в XML и с празни колони „Ред…“ в CSV.

XML (в `Lines/Line`)	CSV колона	Съдържание
`No`	РедНомер	Пореден номер, от 1
`Code`	РедКод	Код на артикула, ако е отпечатан
`Name`	РедАртикул	Наименование на артикула / услугата
`Unit`	РедМярка	Мярка, както е отпечатана (`бр.`, `кг`…)
`Quantity`	РедКоличество	Количество (празно при услуги без количество)
`UnitPrice`	РедЕдиничнаЦена	Единична цена без ДДС
`AmountWithoutVAT`	РедБезДДС	Стойност на реда без ДДС
`VATRate`	РедСтавкаДДС	Ставката на документа; празно при няколко ставки
`AmountWithVAT`	РедСДДС	Стойност на реда с ДДС

4. XML

Коренът е <SortisDocuments version="1.0" company="ЕИК на фирмата">, а във него — по един <Document> на документ:

<Document>
  <Direction>purchase</Direction>  <Type>invoice</Type>
  <Number>0000001302</Number>  <Date>2026-10-05</Date>
  <DueDate>2026-10-19</DueDate>  <TaxEventDate>2026-10-05</TaxEventDate>
  <Supplier><Name>…</Name><EIK>204817368</EIK><VATNumber>BG204817368</VATNumber><Address>…</Address></Supplier>
  <Recipient><Name>…</Name><EIK>…</EIK><VATNumber/></Recipient>
  <Currency>EUR</Currency>  <AmountWithoutVAT>114.50</AmountWithoutVAT>
  <VATAmount>22.90</VATAmount>  <AmountWithVAT>137.40</AmountWithVAT>
  <VATRate>20</VATRate>  <PaymentMethod>bank</PaymentMethod>
  <SourceFile>0000001302.pdf</SourceFile>
  <Lines>
    <Line><No>1</No><Code>A1</Code><Name>Хартия А4</Name><Unit>пак</Unit><Quantity>10</Quantity>
          <UnitPrice>5.5</UnitPrice><AmountWithoutVAT>55.00</AmountWithoutVAT><VATRate>20</VATRate><AmountWithVAT>66.00</AmountWithVAT></Line>
  </Lines>
</Document>

5. CSV

UTF-8 с BOM, разделител ;, редовете завършват с CRLF, първият ред е заглавието с имената на колоните от таблиците горе — в реда Посока, Вид, Номер, Дата, Падеж, ДанъчноСъбитие, ДоставчикИме, ДоставчикЕИК, ДоставчикДДС, ДоставчикАдрес, ПолучателИме, ПолучателЕИК, ПолучателДДС, Валута, СумаБезДДС, ДДС, СумаСДДС, СтавкаДДС, Плащане, РедНомер, РедКод, РедАртикул, РедМярка, РедКоличество, РедЕдиничнаЦена, РедБезДДС, РедСтавкаДДС, РедСДДС, Файл.

Един ред във файла е една позиция; данните на документа се повтарят на всеки ред. Документ без позиции е един ред с празни колони „Ред…“. Документите се отделят по Посока + Номер + ДоставчикЕИК.

6. Примерни файлове

universalen-primer.xml · universalen-primer.csv — две примерни фактури (покупка с редове и кредитно известие за продажба), с измислени данни.

7. Връзка

Въпроси и предложения за следващата версия на формата: office@sortis.pro. Промени, които чупят съвместимостта, ще идват само с нов номер на версията (атрибутът version).

Микроинвест, Делта, Алгос, АС2012, ЕДИС-АСО, Плюс Минус, Ажур, Конто, Microsoft Excel и Windows са марки на съответните им притежатели. Sortis и Sortis Invoice са самостоятелни продукти на Пиксел Лаб ЕООД — не са свързани с тези фирми и не са одобрени от тях. Sortis чете само данните на потребителя, на неговия компютър и само за четене, а в счетоводната програма документите влизат през нейната собствена функция за импорт.