🚀
📋 Съдържание
- Въведение
- Архитектура на Екосистемата
- SKLAD-AI: AI–Базирана Обработка на Фактури
- RS-AC-BG (Ръст АС) : Професионално Счетоводство
- Интеграция и Работен Поток
- Технически Стек
- Реални Сценарии на Използване
- Заключение
Въведение
В съвременния бизнес среда, автоматизацията на счетоводните процеси не е просто удобство – това е необходимост. Представяме ви SKLAD-AI и RS-AC-BG – двойка взаимно допълващи се системи, които покриват пълния цикъл от първоначалното въвеждане на фактури до генерирането на официални декларации за НАП.
За какво става дума?
- SKLAD-AI – AI-базирана система за обработка на фактури с автоматично разпознаване (OCR)
- RS-AC-BG – Професионална счетоводна система с пълна поддръжка на български законови изисквания
Заедно те образуват комплетна екосистема за управление на счетоводството от А до Я.
Архитектура на Екосистемата
┌─────────────────────────────────────────────────────────────────┐
│ ПЪЛНА СЧЕТОВОДНА ЕКОСИСТЕМА │
└─────────────────────────────────────────────────────────────────┘
┌──────────────────────────┐ ┌──────────────────────────┐
│ SKLAD-AI │ │ RS-AC-BG │
│ (AI обработка) │────────▶│ (Счетоводство) │
├──────────────────────────┤ ├──────────────────────────┤
│ │ │ │
│ ✓ OCR на фактури │ │ ✓ Осчетоводяване │
│ ✓ AI извличане на данни │ │ ✓ ДДС декларации │
│ ✓ VIES валидация │ │ ✓ SAF-T експорт │
│ ✓ Управление контрагенти │ │ ✓ INTRASTAT │
│ ✓ S3 архивиране │ │ ✓ Дълготрайни активи │
│ ✓ Банкова интеграция │ │ ✓ Амортизации │
│ ✓ Мулти-компани │ │ ✓ Валутни операции │
│ │ │ ✓ Банки (XML импорт)
│
│ Java + React │ │ Rust + React │
│ PostgreSQL │ │ PostgreSQL │
└──────────────────────────┘ └──────────────────────────┘
Как работят заедно?
- SKLAD-AI – Първоначална обработка и валидация
- Експорт – Данни се предават към RS-AC-BG
- RS-AC-BG – Счетоводно осчетоводяване и генериране на декларации
- НАП – Автоматично генериране на файлове за подаване
SKLAD-AI: AI-Базирана Обработка на Фактури
🎯 Мисия
SKLAD-AI елиминира ръчното въвеждане на фактури чрез изкуствен интелект. Системата автоматично разпознава ключови данни от сканирани документи и ги валидира в реално време.
🔑 Ключови Функционалности
1. AI-Базиран OCR на Фактури
Поддържа три водещи AI доставчика:
- Mistral AI (Pixtral-12B) – Европейски multimodal модел
- Alibaba Cloud (Qwen-VL-Max) – Китайски vision модел
- Microsoft Azure OpenAI (GPT-4o) – Американски модел
Какво извлича автоматично:
- Номер на фактура
- Дата на издаване
- Доставчик (име, ЕИК, ДДС)
- Получател (име, ЕИК, ДДС)
- Нето сума, ДДС, обща сума
- Валута
// Пример за AI отговор
{
"invoiceNumber": "0000123",
"issueDate": "2025-10-05",
"supplier": {
"name": "Иберком - ЕООД",
"vatNumber": "BG207287380",
"eik": "207287380"
},
"totalAmount": 1200.00,
"vatAmount": 240.00,
"netAmount": 1000.00
}
2. VIES Валидация на ДДС Номера
Системата автоматично проверява всички европейски ДДС номера през официалния VIES API на Европейската комисия:
- Валидация в реално време – без ръчно търсене
- AI парсиране на адреси – автоматично разделяне на улица, град, пощенски код
- Кеширане – вече проверени контрагенти не се валидират отново
- ЕИК извличане – за български фирми извлича ЕИК от ДДС номера
Двойна стратегия за адреси:
| Режим | Описание | Точност |
|---|---|---|
| simple | Regex-базирано парсиране (без разходи) | 70-80% |
| mistral | AI парсиране с Mistral Tiny | 90-95% |
| alibaba | AI парсиране с Qwen-Turbo | 90-95% |
3. Управление на Контрагенти
Модерен UI за управление на доставчици и клиенти:
- Автоматично добавяне през VIES
- Batch AI обработка – масово парсиране на адреси
- VIES статус индикатори – валиден/невалиден
- AI confidence scoring – процент увереност при разпознаване
- Обновяване от VIES – refresh на остарели данни
// Добавяне на контрагент през VIES
const result = await validateVat("BG207287380");
// Автоматично създава запис в базата с парсиран адрес
4. S3 Cloud Storage Архивиране
Автоматично архивиране на всички документи:
- PDF оригинали – всички качени файлове
- PNG генериране – всяка страница на PDF (300 DPI)
- Организирана структура – по компания и месец
- S3-съвместимост – AWS S3, Hetzner, Backblaze B2
bucket/
├── 123456789/ # ЕИК
│ └── ABC_Ltd/
│ └── 08-2025/
│ ├── invoice_001.pdf
│ ├── invoice_001_page_1.png
│ └── invoice_001_page_2.png
5. Банкова Интеграция със Salt Edge
НОВ МОДУЛ (Октомври 2025) – автоматизирано свързване с банки:
- Salt Edge API – live банкови връзки
- OAuth свързване – сигурна автентикация
- Автоматична синхронизация на транзакции
- AI съпоставяне с фактури и контрагенти
- Workflow обработка – PENDING → MATCHED → APPROVED → PROCESSED
Основни компоненти:
- BankConnection – връзка към банка
- BankAccount – банкова сметка с баланс и IBAN
- BankTransaction – транзакция с AI разпознаване
- BankAccountMapping – настройки за автоматизация
// Инициализиране на банкова връзка
@PostMapping("/api/banks/connections/initiate")
public ResponseEntity<String> initiateConnection(
@RequestParam Long companyId,
@RequestParam String returnUrl
) {
String connectUrl = bankService.initiateBankConnection(companyId, returnUrl);
return ResponseEntity.ok(connectUrl);
}
6. Мулти-Компани Архитектура
- Управление на множество фирми от един акаунт
- Глобален селектор на компания в header
- Разделение покупки/продажби
- ДДС периоди по месеци
- Автоматичен български сметкоплан за всяка нова фирма
📊 Технически Стек
| Компонент | Технология |
|---|---|
| Backend | Spring Boot 3.2 (Java 17+) |
| Frontend | React 18 + TypeScript |
| Database | PostgreSQL 15+ |
| AI OCR | Mistral/Alibaba/Azure OpenAI |
| AI Адреси | Mistral Tiny/Qwen-Turbo |
| Storage | AWS S3 SDK |
| PDF Processing | Apache PDFBox |
| Encryption | AES-256 |
🔧 API Endpoints
# Фактури
POST /api/invoices/upload # AI обработка + S3
GET /api/invoices # Списък
POST /api/invoices/{id}/reprocess # Преобработка
# Контрагенти
GET /api/counterparties # Списък
POST /api/counterparties/process-addresses # Batch AI
# VIES Валидация
GET /api/v1/vat/validate/{vatNumber} # VIES проверка
# Банки
POST /api/banks/connections/initiate # Свързване
GET /api/banks/transactions # Транзакции
PUT /api/banks/transactions/{id}/status # Обработка
# Настройки
GET /api/settings # Системни настройки
POST /api/test/{provider} # AI тест
RS-AC-BG: Професионално Счетоводство
🎯 Мисия
RS-AC-BG е пълна счетоводна система, специализирана за българските законови изисквания. Построена на Rust за максимална производителност и надеждност.
🔑 Ключови Функционалности
1. Пълен Счетоводен План
- Класове 1-7 – всички счетоводни класове
- Йерархична структура – parent-child връзки
- ДДС атрибути – автоматични проводки за ДДС
- Аналитични сметки – многостепенна аналитика
2. ДДС Декларации (НАП)
Автоматично генериране на официални файлове за НАП:
Генерирани файлове:
DEKLAR.TXT– обобщена декларацияPOKUPKI.TXT– покупки за периодаPRODAGBI.TXT– продажби за периода
Формат:
- Windows-1251 кодиране
- Фиксирана дължина на полетата
- CRLF line endings
- Готови за качване в НАП портала
mutation {
generateVatFiles(companyId: 1, year: 2025, month: 10) {
success
deklarContent
pokupkiContent
prodagbiContent
}
}
3. SAF-T Експорт
Standard Audit File for Tax – международен стандарт за данъчни ревизии:
- XML формат съгласно OECD стандарт
- Пълна история на проводките
- Главна книга и помощни книги
- Готов за одит от НАП
4. INTRASTAT Декларации
Автоматизирано генериране на INTRASTAT декларации за вътреобщностни доставки:
- Автоматично мапване на стоки към CN8 кодове
- Валутни преизчисления – автоматично към лева
- Статистически данни – тегло, допълнителни единици
- XML експорт – готов за подаване към НСИ
Компоненти:
pub struct IntrastatDeclaration {
pub company_id: i32,
pub period: String, // YYYYMM
pub flow_type: String, // ARRIVAL/DISPATCH
pub items: Vec<IntrastatItem>,
}
pub struct IntrastatItem {
pub cn8_code: String,
pub country: String,
pub invoice_value: Decimal,
pub statistical_value: Decimal,
pub net_mass: Decimal,
}
5. Дълготрайни Активи и Амортизации
Пълно управление на дълготрайни активи:
- Различни методи – линеен, намаляващ остатък, и др.
- Автоматични амортизации – месечно начисляване
- Категории активи – структурирано групиране
- Счетоводни проводки – автоматично генериране
pub struct FixedAsset {
pub name: String,
pub category: String,
pub acquisition_cost: Decimal,
pub depreciation_method: DepreciationMethod,
pub useful_life_months: i32,
pub start_date: NaiveDate,
}
pub enum DepreciationMethod {
StraightLine, // Линеен
DecliningBalance, // Намаляващ остатък
SumOfYearsDigits, // Сума от годините
}
6. Валутни Операции
- Автоматични курсове – БНБ фиксинг
- Преоценки – по курс на БНБ
- Курсови разлики – автоматични проводки
- Multi-currency – всички валути
7. Банкови Операции (XML Импорт)
За разлика от SKLAD-AI (Salt Edge live), RS-AC-BG използва файлов импорт:
- MT940 – Swift формат
- CAMT053 – ISO 20022
- XML – банкови изписки
- CSV – собствени формати
pub enum BankImportFormat {
MT940,
CAMT053,
XML,
CSV,
}
pub async fn import_bank_statement(
db: &DatabaseConnection,
file_path: &str,
format: BankImportFormat,
) -> Result<Vec<BankTransaction>>
📊 Технически Стек
| Компонент | Технология |
|---|---|
| Backend | Rust (Axum/async-graphql) |
| Frontend | React + TypeScript |
| Database | PostgreSQL + SeaORM |
| API | GraphQL |
| Build | Cargo |
🔧 GraphQL Schema
type Query {
companies: [Company!]!
accounts(companyId: Int!): [Account!]!
journalEntries(companyId: Int!, period: String!): [JournalEntry!]!
counterparts(companyId: Int!): [Counterpart!]!
fixedAssets(companyId: Int!): [FixedAsset!]!
intrastatDeclarations(companyId: Int!): [IntrastatDeclaration!]!
}
type Mutation {
createJournalEntry(input: JournalEntryInput!): JournalEntry!
generateVatFiles(companyId: Int!, year: Int!, month: Int!): VatFiles!
generateSaftExport(companyId: Int!, year: Int!): SaftExport!
createIntrastatDeclaration(input: IntrastatInput!): IntrastatDeclaration!
importBankStatement(file: Upload!, format: String!): ImportResult!
}
Интеграция и Работен Поток
🔄 Пълен Цикъл на Обработка
┌─────────────────────────────────────────────────────────────────────────┐
│ РАБОТЕН ПОТОК │
└─────────────────────────────────────────────────────────────────────────┘
ФАЗА 1: ВХОДЯЩА ОБРАБОТКА (SKLAD-AI)
═══════════════════════════════════════
1. 📤 Качване на фактура (PDF/JPG/PNG)
↓
2. 🤖 AI OCR обработка (Mistral/Alibaba/Azure)
↓
3. ✅ VIES валидация на контрагенти
↓
4. 🏠 AI парсиране на адреси
↓
5. ☁️ S3 архивиране (PDF + PNG)
↓
6. 💾 Запис в PostgreSQL
↓
7. 👁️ Ръчна проверка и коригиране
ФАЗА 2: ЕКСПОРТ КЪМ RS-AC-BG
═══════════════════════════════
8. 📊 Експорт на валидирани данни
↓
│ JSON/XML/CSV формат
│ Контрагенти + Фактури + Суми
↓
ФАЗА 3: СЧЕТОВОДНО ОСЧЕТОВОДЯВАНЕ (RS-AC-BG)
════════════════════════════════════════════════
9. 📥 Импорт на данни от SKLAD-AI
↓
10. 📋 Създаване на проводки
↓
11. 💰 Автоматични ДДС проводки
↓
12. 🏦 Импорт на банкови изписки (XML)
↓
13. 🔄 Съпоставяне фактури ↔ плащания
ФАЗА 4: ДЕКЛАРАЦИИ И ЕКСПОРТИ (RS-AC-BG)
════════════════════════════════════════
14. 📑 Генериране ДДС декларация (DEKLAR.TXT)
↓
15. 🌍 Генериране INTRASTAT (за EU)
↓
16. 📊 SAF-T експорт (за одити)
↓
17. 📤 Подаване към НАП
🎯 Реални Сценарии
Сценарий 1: Обработка на Фактура за Покупка
SKLAD-AI:
1. Получавате фактура от доставчик по email
2. Качвате PDF в SKLAD-AI
3. AI извлича:
- Доставчик: "ABC ЕООД" (BG123456789)
- Нето: 1000 лв
- ДДС: 200 лв
- Обща сума: 1200 лв
4. VIES валидира BG123456789 ✅
5. AI парсира адрес: "София, ул. Витоша 15"
6. Архивира в S3: abc-ltd/10-2025/invoice_123.pdf
7. Чакате одобрение/корекция
RS-AC-BG:
8. Импортирате от SKLAD-AI
9. Генерират се проводки:
Dt 602 (Материали) - 1000 лв
Dt 4531 (ДДС за приспадане) - 200 лв
Ct 401 (Доставчици) - 1200 лв
10. Фактурата влиза в покупки за октомври
11. При генериране на ДДС декларация се включва автоматично
Сценарий 2: Вътреобщностна Доставка
SKLAD-AI:
1. Качвате фактура за продажба към Германия
2. AI извлича:
- Клиент: "Deutsche GmbH" (DE123456789)
- Стока: "Лаптопи"
- Сума: 5000 EUR
3. VIES валидира DE123456789 ✅
4. Маркира като "EU доставка"
RS-AC-BG:
5. Импортирате от SKLAD-AI
6. Генерират се проводки с 0% ДДС
7. Автоматично се създава INTRASTAT запис:
- CN8 код: 84713000 (лаптопи)
- Държава: DE
- Стойност: 9775 лв (5000 EUR x 1.955)
- Нето маса: автоматично от номенклатура
8. При генериране на INTRASTAT декларация - включен автоматично
Сценарий 3: Банкова Синхронизация
SKLAD-AI (Salt Edge):
1. Свързвате банкова сметка през Salt Edge
2. Автоматично се синхронизират транзакции
3. AI съпоставя плащане с фактура:
- Получено: 1200 лв от "ABC ЕООД"
- Confidence: 92%
- Статус: AUTO_MATCHED
4. Одобрявате съпоставянето
RS-AC-BG (XML импорт):
1. Експортирате банкови изписки като XML
2. Импортирате в RS-AC-BG
3. Ръчно съпоставяте с фактури
4. Генерират се проводки за плащане:
Dt 503 (Банкова сметка) - 1200 лв
Ct 401 (Доставчици) - 1200 лв
Технически Стек – Сравнение
Езици и Frameworks
| Аспект | SKLAD-AI | RS-AC-BG |
|---|---|---|
| Backend език | Java 17+ | Rust |
| Web framework | Spring Boot 3.2 | Axum |
| Frontend | React 18 + TypeScript | React + TypeScript |
| Database ORM | Hibernate/JPA | SeaORM |
| API тип | REST | GraphQL |
| Build tool | Maven | Cargo |
Защо различни технологии?
SKLAD-AI (Java):
- ✅ Богат екосистем от AI библиотеки
- ✅ Лесна интеграция с enterprise API
- ✅ Spring Boot ускорява разработката
- ✅ Добра поддръжка за PDF/изображения
RS-AC-BG (Rust):
- ✅ Максимална производителност
- ✅ Memory safety (критично за финанси)
- ✅ Нулеви runtime грешки
- ✅ Отлична concurrency за GraphQL
Производителност
| Метрика | SKLAD-AI | RS-AC-BG |
|---|---|---|
| Backend startup | ~5 секунди | ~1 секунда |
| API response (средно) | 50-100ms | 10-30ms |
| Memory usage | 500MB-1GB | 50-200MB |
| Concurrent users | 100+ | 1000+ |
Предимства на Екосистемата
✅ За SKLAD-AI
- AI автоматизация – 90%+ намаление на ръчно въвеждане
- VIES валидация – автоматична проверка на контрагенти
- S3 архивиране – организирано съхранение на документи
- Multi-provider AI – избор между 3 водещи AI доставчика
- Банкова интеграция – live синхронизация със Salt Edge
- Модерен UI – интуитивен React интерфейс
✅ За RS-AC-BG
- Пълна compliance – НАП, INTRASTAT, SAF-T
- Rust производителност – бързина и надеждност
- GraphQL API – гъвкави заявки
- Дълготрайни активи – автоматични амортизации
- Валутни операции – БНБ курсове
- Банкови импорти – MT940, CAMT053, XML
✅ За Интеграцията
- Разделение на отговорности – всяка система прави това, което прави най-добре
- Минимална дупликация – SKLAD-AI валидира, RS-AC-BG осчетоводява
- Гъвкавост – може да се използва всяка система самостоятелно
- Scalability – независимо мащабиране на компонентите
- Maintainability – по-лесна поддръжка на отделни модули
Кой е целевият потребител?
🏢 Малки и Средни Предприятия (SME)
- 10-100 служители
- 50-500 фактури месечно
- Необходимост от автоматизация
- Бюджетни ограничения
💼 Счетоводни Къщи
- Множество клиенти
- Нужда от централизирано управление
- Високи изисквания за точност
- Compliance с НАП
🌍 Компании с EU Дейност
- Вътреобщностни доставки
- INTRASTAT декларации
- VIES валидации
- Multi-currency операции
Инсталация и Deployment
SKLAD-AI Setup
# 1. Database
psql -U postgres
CREATE DATABASE sklad_ai;
# 2. Backend
cd sklad-ai/backend
mvn spring-boot:run
# 3. Frontend
cd sklad-ai/frontend
npm install
npm start
# 4. Конфигурация
# application.properties:
ai.provider=mistral
mistral.api.key=YOUR_KEY
saltedge.app-id=YOUR_SALT_EDGE_APP_ID
saltedge.secret=YOUR_SALT_EDGE_SECRET
s3.endpoint=https://your-s3.com
RS-AC-BG Setup
# 1. Database
psql -U postgres
CREATE DATABASE rs_ac_bg;
# 2. Backend
cd rs-ac-bg/backend
cargo build --release
./target/release/rs-ac-bg
# 3. Frontend
cd rs-ac-bg/frontend
npm install
npm start
# 4. Environment
export DATABASE_URL=postgresql://postgres:password@localhost/rs_ac_bg
export RUST_LOG=info
Docker Deployment
# docker-compose.yml
version: '3.8'
services:
postgres:
image: postgres:15
environment:
POSTGRES_PASSWORD: pas+123
volumes:
- pg_data:/var/lib/postgresql/data
sklad-ai-backend:
build: ./sklad-ai/backend
ports:
- "8080:8080"
depends_on:
- postgres
environment:
- SPRING_DATASOURCE_URL=jdbc:postgresql://postgres:5432/sklad_ai
sklad-ai-frontend:
build: ./sklad-ai/frontend
ports:
- "3000:3000"
rs-ac-bg-backend:
build: ./rs-ac-bg/backend
ports:
- "8081:8081"
depends_on:
- postgres
environment:
- DATABASE_URL=postgresql://postgres:pas+123@postgres/rs_ac_bg
rs-ac-bg-frontend:
build: ./rs-ac-bg/frontend
ports:
- "3001:3000"
volumes:
pg_data:
Сигурност
SKLAD-AI
- ✅ AES-256 криптиране на API ключове
- ✅ HTTPS за всички external API
- ✅ HMAC SHA256 за Salt Edge подписи
- ✅ S3 server-side encryption
- ✅ CORS конфигурация
RS-AC-BG
- ✅ Memory safety чрез Rust
- ✅ SQL injection защита чрез SeaORM
- ✅ Encrypted passwords (bcrypt)
- ✅ Audit trail за всички промени
- ✅ Role-based access control (RBAC)
Compliance
- ✅ GDPR – защита на лични данни
- ✅ PCI DSS – сигурни финансови данни
- ✅ SOC 2 – организационна сигурност
- ✅ НАП изисквания – законови файлове
Поддръжка и Документация
Документация
SKLAD-AI:
/sklad-ai/README.md– Основно ръководство/sklad-ai/docs/INTEGRATION_SUMMARY.md– AI интеграция/sklad-ai/docs/COUNTERPARTY_UI_GUIDE.md– Контрагенти/sklad-ai/docs/BANK_MODULE_GUIDE.md– Банков модул/sklad-ai/docs/SALTEDGE_SETTINGS_COMPLETE.md– Salt Edge настройки
RS-AC-BG:
/rs-ac-bg/backend/docs/VAT_NAP_EXPORT.md– НАП експорти/rs-ac-bg/README.md– Основно ръководство
Community & Support
- 📧 Email: support@sklad-ai.bg
- 🐛 Bug Reports: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📚 Wiki: Internal documentation
Заключение
SKLAD-AI и RS-AC-BG представляват най-модерното решение за счетоводство в България. Комбинацията от AI технологии (Mistral, Alibaba, Azure OpenAI), performance (Rust), cloud storage (S3) и пълна compliance (НАП, INTRASTAT, SAF-T) прави тази екосистема уникална на пазара.
Защо да изберете тази екосистема?
- ✅ AI автоматизация – 90% намаление на ръчна работа
- ✅ Пълна compliance – НАП, VIES, INTRASTAT, SAF-T
- ✅ Модерни технологии – Java, Rust, React, PostgreSQL
- ✅ Банкова интеграция – Salt Edge live + XML импорт
- ✅ Cloud-first – S3 архивиране на документи
- ✅ Open architecture – лесна интеграция с други системи
- ✅ Scalability – от 10 до 10,000 фактури месечно
- ✅ Cost-effective – по-евтино от SAP/Oracle
Следващи стъпки
- Опитайте SKLAD-AI – започнете с AI обработка на фактури
- Добавете RS-AC-BG – пълно осчетоводяване
- Настройте интеграцията – автоматизирайте процеса
- Свържете банките – Salt Edge или XML импорт
- Генерирайте декларации – НАП, INTRASTAT
🎉 Статус на Внедряването
Октомври 2025:
- ✅ SKLAD-AI – Production Ready
- ✅ RS-AC-BG – Production Ready
- ✅ Банков модул (Salt Edge) – Production Ready
- ✅ VIES интеграция – Production Ready
- ✅ S3 Cloud Storage – Production Ready
- ✅ AI Address Parsing – Production Ready
- ✅ Multi-provider AI – Production Ready
Всичко работи и е готово за употреба! 🚀
Документ създаден на 10 Октомври 2025
Версия: 1.0
Автор: Development Team

