Към съдържанието
Пробвайте с ваш документПроба

OCR API за фактури и стокови разписки: вградете четенето в своя софтуер

Изпращате файл, получавате данните. Клиентите ви не преписват фактури и не излизат от вашата програма, а документите им остават в България.

REST API
JSON, Azure-съвместим, XML, UBL, CSV, Excel
Партиди
Асинхронно, с приоритет и проследяване
Ключове
Жива, тестова среда и разработка
Данни
На наш сървър в България

Една заявка, един отговор

PDF или изображение до 15 MB; многостраничен PDF се чете целият. Отговорът носи всички реквизити, редовете и увереността, за да решите кое да покажете на клиента за преглед.

curl https://ocrauto.ai/api/v1/extract \
  -H "X-API-Key: вашият ключ" \
  -F "file=@faktura.pdf"
{
  "invoice_number": "0000012345",
  "issue_date": "2026-09-15",
  "supplier": {"name": "Доставчик ЕООД", "eik": "175074752"},
  "amounts": {"net": 100.0, "vat": 20.0, "total": 120.0},
  "line_items": [
    {"description": "Масло 5W30 1л", "quantity": 4, "unit": "бр", "total": 60.0}
  ],
  "quality": {"confidence": "high", "needs_review": false}
}

Какво получавате

Всичко, което OCRauto прави в портала, е достъпно и през API.

Формати
Собствен JSON, Azure-съвместим (лесна смяна от Azure Document Intelligence), XML, UBL, CSV, Excel.
Зони
По желание: къде на страницата стои всяка стойност, за да осветите полето в своя екран.
Партиди и ZIP
Асинхронно, с проследяване на хода и резултати по партида.
Приоритет
Спешно, висок или по реда, на заявка. Партидите не задържат спешните документи.
Стокови разписки
Отделна крайна точка с баркод, партида и срок на годност.
Корекции
Връщате поправения резултат; той подобрява разчитането за вашите документи.
SAF-T
Месечният файл на фирмата клиент, през API.

От името на клиента

Вие сте софтуерът, клиентът остава собственик на документите си.

Два ключа
Заявката носи вашия ключ и ключа на фирмата клиент; без втория не може да подавате от нейно име.
Неговият архив
Документите влизат в архива на клиента и се броят към неговия пакет.
Смяна на ключ без прекъсване
Старият ключ работи още 24 часа и може да бъде спрян веднага.

Въпроси от разработчици

Какви формати връща API-то?

Собствен JSON с всички полета и редове, Azure-съвместим формат (за лесна смяна от Azure Document Intelligence), XML, UBL, CSV и Excel. По желание и зоните: къде на страницата стои всяка стойност.

Синхронно или асинхронно?

И двете. Един документ се чете синхронно; партидите и ZIP архивите вървят асинхронно с проследяване и резултати по номер на партидата. Приоритетът се задава в заявката.

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

Заявката носи вашия ключ и ключа на фирмата клиент; документите влизат в нейния архив и се броят към нейния пакет.

Има ли тестов ключ?

Да: тестов ключ с 1 000 документа без договор. Отделни ключове за жива, тестова среда и разработка; смяна на ключ без прекъсване.

Къде е документацията?

Пълната документация с OpenAPI описание и Sandbox е в портала, след регистрация на софтуерна фирма.

Тестов ключ с 1 000 документа, без договор

Регистрирайте софтуерна фирма и вземете ключ; документацията и Sandbox са в портала.