Initial commit: User documentation for Invoicing.top

- security.md: Why Invoicing.top is the most secure invoicing platform
  - MongoDB audit log for full change tracking
  - Bank certificate attachment for IBAN verification
- bank-certificate-guide.md: Step-by-step guide for setting up bank certificates
- README.md: Documentation index

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
InvTop VPS
2026-01-08 00:01:29 +00:00
commit 0ff74d1af2
3 changed files with 323 additions and 0 deletions

146
bank-certificate-guide.md Normal file
View File

@@ -0,0 +1,146 @@
# Ръководство: Банков сертификат за сигурност
## Какво е банков сертификат?
Банковият сертификат е PDF документ, който потвърждава, че дадена банкова сметка принадлежи на вашата фирма. Той се прикачва автоматично към всяка изпратена фактура и позволява на получателите да верифицират легитимността на сметката.
## Какви документи може да използвате
### Вариант 1: Банково удостоверение (препоръчително)
- Официален документ от банката
- Съдържа: име на фирмата, IBAN, BIC
- Издава се от всяка банка при поискване
- Обикновено с банков печат или електронен подпис
### Вариант 2: Декларация с квалифициран електронен подпис (КЕП)
- Документ, подписан с КЕП на МОЛ или упълномощено лице
- Декларира, че сметката е на фирмата
- Може да бъде създаден от вас
### Вариант 3: Извлечение от търговски регистър + банкови данни
- Комбинация от документи, потвърждаващи собствеността
---
## Стъпки за настройка
### Стъпка 1: Подгответе PDF документа
1. Вземете банково удостоверение от банката, или
2. Създайте декларация и я подпишете с КЕП
**Изисквания към файла:**
- Формат: PDF
- Максимален размер: 5 MB
- Да съдържа IBAN-а, за който се отнася
### Стъпка 2: Отворете настройките на банковата сметка
1. Влезте в системата
2. Отидете на **Настройки** (иконка зъбче в менюто)
3. Изберете таб **Банкови сметки**
4. Намерете сметката, за която искате да добавите сертификат
5. Кликнете на иконката **молив** (Редактирай)
### Стъпка 3: Качете сертификата
1. В диалоговия прозорец за редакция, превъртете надолу
2. Намерете секция **Банково удостоверение (PDF)**
3. Кликнете **Избери файл** и изберете PDF-а
4. Кликнете **Качи**
5. Ще видите потвърждение "Сертификатът е качен успешно"
### Стъпка 4: Проверете
- В таблицата с банкови сметки ще видите зелена икона (щит) до сметката
- Това означава, че сертификатът е активен
---
## Как работи при изпращане на фактура
1. Създавате фактура и избирате банкова сметка
2. Финализирате фактурата
3. Кликвате **Изпрати по имейл**
4. Въвеждате имейл адреса на получателя
5. Кликвате **Изпрати**
**Получателят получава:**
- Фактура (PDF)
- Банково удостоверение (PDF) - автоматично прикачено
- (Опционално) UBL XML файл за ERP системи
---
## Подмяна на сертификат
Ако банката ви издаде нов сертификат или искате да качите актуализиран:
1. Отворете редакция на банковата сметка
2. Кликнете **Изтрий** до текущия сертификат
3. Качете новия файл
**Важно:** Старият сертификат се изтрива автоматично. Системата съхранява само един сертификат на сметка.
---
## Изтриване на сертификат
Ако искате да спрете прикачването на сертификат:
1. Отворете редакция на банковата сметка
2. Кликнете **Изтрий** до сертификата
3. Потвърдете изтриването
След това фактурите ще се изпращат само с PDF на фактурата (без сертификат).
---
## Често задавани въпроси
### Трябва ли задължително да кача сертификат?
Не, това е опционална функция за допълнителна сигурност. Ако не качите сертификат, фактурите ще се изпращат нормално, само без допълнителния файл.
### Мога ли да кача различни сертификати за различни сметки?
Да, всяка банкова сметка има свой отделен сертификат.
### Какво става ако сменя банката?
Качете нов сертификат за новата банкова сметка. Старите фактури (вече изпратени) не се променят.
### Виждат ли клиентите ми кой е качил сертификата?
Не, клиентите виждат само съдържанието на PDF файла (банковото удостоверение).
### Мога ли да видя история на качените сертификати?
Всяка промяна се записва в audit log-а. Администраторът може да види кога е качен/изтрит сертификат.
---
## Примерен текст за декларация (ако ползвате КЕП)
```
ДЕКЛАРАЦИЯ
Долуподписаният/ата [Име на МОЛ], в качеството си на
управител на [Име на фирмата], ЕИК [номер],
ДЕКЛАРИРАМ, ЧЕ:
Банкова сметка с IBAN: [IBAN номер]
в [Име на банката], BIC: [BIC код]
е официална банкова сметка на дружеството и всички плащания
към нея са валидни плащания към [Име на фирмата].
Дата: [дата]
Електронен подпис: [КЕП]
```
---
## Техническа информация
- Файловете се съхраняват криптирано в облачно хранилище (S3-compatible)
- Път: `bank-certificates/{company_id}/{IBAN}.pdf`
- При ново качване старият файл се презаписва
- Максимален размер: 5 MB
- Поддържан формат: само PDF