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

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

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

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

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

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

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

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

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

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

💡 Съвет: Всички функции от таб „Още" отварят съответния екран в браузъра. Те не са самостоятелни 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 план или по-висок.

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

Готови, стъпка по стъпка ръководства за свързване с популярни счетоводни програми и държавни системи.

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

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

Счетоводни програми

Microinvest Делта Pro

1. Отиди на Фактури → Експорт → избери „Microinvest Delta" → задай период → Изтегли.
2. Отвори Microinvest Делта Pro и влез в базата данни.
3. Операции → Импорт на операции → Импорт от текстов файл.
4. Избери изтегления .txt файл.
5. При „кракозябри" — провери настройката за кодиране и избери Windows-1251 (CP1251).
6. Потвърди импорта и провери записите.

⚠️ Внимание: Файлът е в кодиране CP1251 (Windows-1251), не UTF-8. Ако виждаш грешни символи, промени настройката за кодиране в Делта преди импорта.

Плюс Минус

1. Фактури → Експорт → „Плюс Минус" → период → Изтегли.
2. В Плюс Минус: Файл → Трансфер → Четене (Import).
3. Избери .txt файла. Задължително избери кодиране CP1251 и разделител точка-запетая (;).
4. Провери и потвърди.

⚠️ Внимание: Кодирането CP1251 е задължително за Плюс Минус — при UTF-8 всички кирилски символи ще се появят грешно.

Ажур (Бизнес Софт)

1. Фактури → Експорт → „Ажур" → период → Изтегли.
2. В Ажур: Помощни → Импорт данни → Текстов файл.
3. Избери файла, прегледай preview-то и потвърди.

Бизнес Навигатор

1. Фактури → Експорт → „Бизнес Навигатор" → период → Изтегли.
2. В програмата: Файл → Импорт → XML формат → избери файла → провери mapping → Импорт.

WorkFlow (Бизнес Софт)

1. Фактури → Експорт → „WorkFlow" → период → Изтегли.
2. Модул Операции → Импорт → Текстов файл → избери .txt файла.
3. Провери данните и потвърди.

⚠️ Внимание: WorkFlow използва кодиране CP1251.

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. Изтегли трите файла: PRODAJ.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

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

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

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

Webhooks (Business)

Webhooks изпращат HTTP заявка към твоя сървър в реално време при настъпване на събитие в Fakturka.bg — без нужда от периодично опитване (polling).

Достъп: Настройки → „Webhooks"

Конфигурация

1. Настройки → „Webhooks" → Нов endpoint.
2. Въведи HTTPS URL на твоя сървър.
3. Избери кои събития да получаваш.
4. Запази — системата генерира таен ключ (secret) автоматично.

⚠️ Внимание: URL адресът трябва да е HTTPS. HTTP адреси не се приемат.

Поддържани събития

Проверка на подписа

Всяка заявка съдържа подпис в заглавката X-Fakturka-Signature: sha256=.... Провери го преди обработка:

1. Вземи тайния ключ (secret) от настройките на webhook-а.
2. Изчисли HMAC-SHA256 на тялото на заявката с този ключ.
3. Сравни резултата с подписа от заглавката.
4. Ако съвпадат — обработи събитието. Ако не — откажи заявката.

Retry политика

При неуспешна доставка (не-2xx отговор или timeout от 10 секунди) системата прави 3 опита с нарастващо изчакване между тях. След изчерпване на опитите доставката се счита за неуспешна.

💡 Съвет: Отговаряй с HTTP 200 OK веднага след получаване и обработвай събитието асинхронно — бавен endpoint може да доведе до многократни retry-та.

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

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

Получавам грешката „Скенерът не може да се отвори" Функцията работи само в инсталирания 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-овете на ключа включват нужния ресурс.

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

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

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

• Разходи и покупки — ръчно добавяне и управление на разходи
• PEPPOL и B2G — електронно фактуриране към бизнес и държавата
• Сигурност и достъп — двуфакторна автентикация, роли, одитен лог
• Абонамент и планове — сравнение на плановете и надграждане
• AI функции — автоматично разпознаване на документи и AI асистент