Към съдържанието

Mobile и интеграции

Fakturka.bg работи изцяло в браузъра, но разполага и с мобилно приложение за Android (версията за iOS е в подготовка), с което добавяш разходи,…

Fakturka.bg работи изцяло в браузъра, но разполага и с мобилно приложение за Android (версията за iOS е в подготовка), с което добавяш разходи, сканираш касови бележки и следиш фактурите — навсякъде, без компютър. За по-напреднали нужди платформата предлага REST API, Webhooks и готови ръководства за свързване с популярни счетоводни програми.

Достъп: Разходи · Настройки · Ръководства за интеграция · PEPPOL

Какво включва тази статия

ФункцияМинимален план
Мобилно приложение — преглед на фактури и клиентиFree
Биометрично влизане (Face ID / пръстов отпечатък)Free
Push известияPro
Сканиране на касови бележки с AIFree (до 5/месец; за регистрации от 26.10.2026: 3), Pro (неограничено до 30.11.2026; от 01.12.2026: 150/месец)
Входящ имейл (inbox адрес за комуникации)Pro
Вход с GoogleВсички планове
Enterprise SSO (SAML 2.0 / OIDC)Business
API ключовеBusiness
WebhooksBusiness

Мобилното приложение

Приложението е налично за Android (APK инсталация). Версията за iOS е в подготовка. Ако нямаш достъп до линк за изтегляне, провери имейла, с който се е регистрирал акаунтът ти, или се свържи с поддръжката от Контакти.

⚠️ Внимание: Приложението не е публикувано в Google Play Store или Apple App Store. Инсталирай го само от официалния линк, предоставен от Fakturka.bg.

Навигация — 5 долни таба

При отваряне виждаш пет таба в долната лента:

ТабИконаСъдържание
Начало🏠Табло с резюме, последни фактури, бърз достъп до „Добави разход“
Фактури📄Списък с фактури, статус, детайли
Разходи🧾Списък с разходи, добавяне, опашка
Клиенти👥Списък с клиенти и детайли
Още☰Отчети, ДДС дневник, Заплати, Банкова интеграция, PEPPOL, API, Настройки

💡 Съвет: Всички функции от таб „Още“ отварят съответния екран в браузъра. Те не са самостоятелни native екрани — нужна е интернет връзка.

Биометрично влизане

При първото влизане приложението предлага да активираш биометрична идентификация:

  • iOS — Face ID или Touch ID
  • Android — пръстов отпечатък
  1. Влез с имейл и парола.
  2. При появата на въпроса „Искате ли да използвате Face ID / пръстов отпечатък?“ — натисни Да, активирай.
  3. При следващо отваряне приложението ще те разпознае автоматично.

Ако пропуснеш стъпката, можеш да я активираш като излезеш от профила и влезеш отново.

💡 Съвет: Биометричните данни се съхраняват само в защитеното хранилище на телефона — никога не напускат устройството.

Push известия (Pro+)

При влизане приложението поисква разрешение за известия. Ако го разрешиш, ще получаваш известия за:

  • Нова фактура, маркирана като платена
  • Предстоящ краен срок на плащане
  • Нов разход, добавен от друг потребител в акаунта

При натискане на известието приложението отваря директно съответния екран.

⚠️ Внимание: Push известията изискват Pro план или по-висок. При Free план разрешението се пита, но известия не се изпращат.

Сканиране на касова бележка

Най-бързият начин да добавиш разход — насочваш камерата към касовата бележка или фактура и AI попълва данните вместо теб. Free планът включва до 5 сканирания на месец; Pro планът — без ограничение.

Достъп: Таб „Разходи“ → бутон + → „Добави разход“

Стъпки за една страница

  1. Натисни Сканирай — камерата се отваря с автоматично кадриране на документа.
  2. Снимай касовата бележка или фактурата.
  3. Виждаш предварителен преглед на снимката (ImageReview екран) — провери дали е четлива.
  4. Натисни Потвърди → — AI анализира документа (обикновено 3–8 секунди).
  5. Формата се отваря с предзапълнени: описание, сума, дата, доставчик.
  6. Провери данните и натисни Запази разхода.

Ако не искаш да сканираш, имаш две алтернативи от същия екран:

  • От галерия — избираш съществуваща снимка или PDF от телефона (до 10 файла наведнъж).
  • Ръчно — отваря форма за директно въвеждане без снимка.

Сканиране на много страници (до 10)

Ако документът е на повече от една страница:

  1. Избери Сканирай или От галерия и маркирай повече от един файл.
  2. Виждаш преглед с thumbnail мрежа — всяка страница е номерирана.
  3. При нужда натисни + Добави страница (от камера или галерия) или ✕ до страница, за да я премахнеш.
  4. Натисни Анализирай → — AI обработва всички страници заедно.

⚠️ Внимание: Ако AI не разпознае документа, получаваш опции „Опитай пак“ или „Ръчно въвеждане“ — никога не губиш снимката.

💡 Съвет: За най-добри резултати снимай при добро осветление и задръж телефона неподвижно над документа. Избелели термохартиени бележки сканирай на тъмен фон.

⚠️ Внимание: Free планът позволява до 5 сканирания на месец. При достигане на лимита бутонът „Сканирай“ се деактивира до началото на следващия месец — използвай опцията „Ръчно“ или надгради до Pro за неограничено сканиране.

Опашка за офлайн разходи

Ако добавяш разход без интернет връзка, той се запазва локално в опашката и се синхронизира автоматично при следващо свързване.

Достъп: Таб „Разходи“ → бутон Опашка (появява се само ако има неизпратени записи)

В екрана „Опашка за разходи“ виждаш:

  • Списък с чакащи и неуспешни записи
  • Статус на всеки запис: Чакащ (жълт) или Неуспешен (червен)
  • Бутони Опитай пак и Изтрий за всеки запис
  • Бутон Синхронизирай всички в долната лента

💡 Съвет: Неуспешен запис означава, че е имало грешка при изпращането след свързване. Натисни „Опитай пак“ — ако проблемът продължава, провери дали данните са коректни, след което го въведи ръчно от уеб версията.

Вход с Google и Enterprise SSO

Вход с Google (всички планове)

На екрана за вход натисни „Влез с Google“ и избери своя Google акаунт. Не е нужна отделна парола за Fakturka.bg.

Enterprise SSO — SAML 2.0 / OIDC (Business)

За организации с централизирано управление на потребителите (Active Directory, Okta, Azure AD):

  1. Влез в Настройки → раздел „Сигурност“ → „Enterprise SSO“.
  2. Въведи метаданните на твоя Identity Provider.
  3. Потребителите на организацията влизат чрез корпоративния им акаунт.

⚠️ Внимание: Enterprise SSO изисква Business план. Входът с Google е наличен за всички планове без допълнителна конфигурация.

Входящ имейл — inbox адрес (Pro+)

Всеки акаунт получава уникален имейл адрес от вида:

inbox-[16 символа]@fakturka.bg

Изпращай кореспонденция от клиенти или доставчици към този адрес — съобщенията се записват автоматично в историята на съответния клиент.

Достъп: Настройки → „Входящ имейл“ → виждаш своя уникален адрес

Как работи

  1. Намери своя inbox адрес в Настройки.
  2. Сподели го с клиенти или счетоводители, на които искаш да изпращат документи.
  3. При получен имейл системата го съпоставя с клиент по имейл адреса на подателя.
  4. Съобщението се появява в историята на клиента в Fakturka.bg.

💡 Съвет: Адресът се генерира автоматично при първото отваряне на настройката. Ако искаш нов адрес (напр. след изтичане или компрометиране), свържи се с поддръжката.

⚠️ Внимание: Входящият имейл не е инструмент за автоматичен импорт на банкови извлечения. За банков импорт използвай Банкова интеграция.

⚠️ Внимание: Функцията изисква Pro план или по-висок.

Ръководства за интеграция

Ръководства за експорт на файлове към счетоводителя и за държавни системи. За Microinvest, Плюс Минус, Ажур, Бизнес Навигатор и WorkFlow нямаме вграден формат на програмата: ползвай Excel/CSV или универсален файл и ги импортирай с картиране на колоните.

Достъп: Ръководства за интеграция

Ръководствата са организирани в три категории и включват вградена търсачка. Натисни картата на програмата, за да видиш стъпките. Можеш да отидеш директно към конкретно ръководство с URL от вида /dashboard/integration-guides#microinvest.

Файлове за счетоводната програма

Универсален TXT или XML (за ръчно картиране)

Тези файлове са собствено оформление на Fakturka.bg, а не вграденият формат на Microinvest Делта Pro, Плюс Минус, Ажур, Бизнес Навигатор или WorkFlow. Не гарантираме, че програма ги приема без картиране на колоните.

  1. Отиди на Фактури → Експорт → избери един от универсалните файлове → задай период → Изтегли.
  2. В счетоводната програма ползвай нейния ръчен импорт от текстов или XML файл и посочи коя колона какво е.
  3. Текстовите файлове са без заглавен ред (11 или 13 полета с разделител |) или със заглавен ред (разделител | или ;). Типове документи: 1 = фактура, 2 = кредитно известие, 3 = дебитно известие, 9 = проформа.
  4. При „нечетими символи“ избери кодиране Windows-1251 (CP1251).
  5. Провери записите преди потвърждение.

⚠️ Внимание: Файлът не съдържа сметки за осчетоводяване; счетоводителят ги задава в своята програма.

Microsoft Excel

  1. Фактури → Експорт → „Excel“ → период → Изтегли.
  2. Двойно кликни върху .xlsx файла — отваря се директно в Excel.
  3. Данните са в таблица: Номер, Дата, Тип, Клиент, ЕИК, Сума, ДДС, Общо, Валута.

CSV (универсален)

  1. Фактури → Експорт → „CSV“ → период → Изтегли.
  2. Отвори в Excel, Google Sheets или друга програма.
  3. Файлът е UTF-8 с BOM — повечето програми го разпознават автоматично.

💡 Съвет: При грешни символи в Excel: Data → From Text/CSV → избери UTF-8 ръчно.

Държавни институции

НАП — Дневник на продажбите

  1. НАП Експорт → избери месец → Генерирай.
  2. Изтегли трите файла: PRODAGBI.TXT, POKUPKI.TXT, DEKLAR.TXT.
  3. Влез в портала на НАП → Подаване → Справка-декларация по ЗДДС.
  4. Прикачи трите файла и натисни Подай.

⚠️ Внимание: Файловете са в кодиране CP1251 — не ги отваряй и не ги записвай с друг редактор преди подаване, защото кодирането ще се повреди.

⚠️ Внимание: Генерирай файлове само за един данъчен период (месец) — НАП не приема файлове за диапазон от месеци.

Международни стандарти

PEPPOL — електронно фактуриране

  1. Фактури → отвори фактура → натисни Изпрати по PEPPOL.
  2. Фактурата се доставя автоматично до получателя чрез PEPPOL мрежата.

Виж пълното ръководство в статията PEPPOL и B2G.

API ключове (Business)

REST API позволява на твоя backend или скрипт да създава фактури, клиенти и разходи програмно.

Достъп: Настройки → „API достъп“

Създаване на API ключ

  1. Отиди в Настройки → „API достъп“ → Нов ключ.
  2. Въведи описание (напр. „Интеграция с ERP“) и избери scopes.
  3. Натисни Създай — ключът се показва само веднъж. Копирай го и го запази на сигурно място.

⚠️ Внимание: Ключът не може да бъде прегледан отново след затваряне на прозореца. При загуба трябва да създадеш нов.

Формат и употреба

Всеки ключ изглежда така: fak_live_ + 40 шестнадесетични символа (48 знака общо).

Изпращай го в HTTP заглавката на всяка заявка:

Authorization: Bearer fak_live_...

Достъпни scopes

При създаване избираш само нужните разрешения:

ScopeДостъп
invoicesФактури
clientsКлиенти
itemsАртикули и услуги
expensesРазходи
paymentsПлащания
reportsОтчети
warehouseСклад
contractsДоговори

💡 Съвет: Задавай само scopes, от които реално се нуждаеш — принципът на минималните права намалява риска при компрометиране на ключа.

Пълната документация на API-то е достъпна на https://fakturka.bg/api/docs.

🛠️ Често срещани проблеми

Сканирането не разпознава документа Провери: достатъчно ли е осветлението, телефонът неподвижен ли е, снимката четлива ли е в прегледа. При избелели термохартиени бележки снимай на тъмна подложка. При повторна неуспех натисни „Ръчно въвеждане“ и попълни данните сам.

Получавам грешката „Скенерът не може да се отвори“ Функцията работи само в инсталирания APK/IPA — не е достъпна в Expo Go. Провери дали приложението е официалната инсталация. Ако проблемът продължава, използвай „От галерия“.

Камерата или галерията поискаха достъп и отказах Отиди в системните Настройки на телефона → Приложения → Fakturka.bg → Разрешения → активирай „Камера“ и/или „Снимки“.

Не получавам push известия Провери: (1) планът ти е Pro или Business; (2) в системните настройки на телефона Fakturka.bg има разрешение за известия; (3) излез от профила и влез отново, за да се регистрира устройството отново.

Не намирам своя inbox адрес Отиди в Настройки → „Входящ имейл“. Адресът се генерира при първото отваряне — ако не го виждаш, обнови страницата. Ако функцията е скрита, акаунтът е на Free план (изисква Pro+).

Webhook не получава заявки Провери: (1) URL-ът е HTTPS; (2) сървърът отговаря с HTTP 200 в рамките на 10 секунди; (3) в историята на webhook-а (Настройки → Webhooks → иконата с часовник) виждаш дали е имало опити и какъв е отговорът.

API ключът връща грешка „401 Unauthorized“ Провери: (1) изпращаш ли заглавката Authorization: Bearer fak_live_...; (2) ключът не е изтрит от Настройки; (3) scope-овете на ключа включват нужния ресурс.

„Опашката за разходи“ не се синхронизира Отвори таб „Разходи“ → „Опашка“ → натисни Синхронизирай всички. Ако записите остават „Неуспешни“, провери интернет връзката. При постоянен проблем изтрий записа от опашката и въведи разхода ръчно от уеб версията.

При импорт на универсален TXT в счетоводна програма виждам грешни символи Файлът е в кодиране CP1251 (Windows-1251). В настройките за импорт на програмата избери изрично Windows-1251 — не разчитай на автоматично разпознаване.

Свързани теми