Files
inv-docs/09-document-validator.md
2026-01-07 11:14:37 +00:00

118 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Валидатор на документи
Валидаторът позволява на получателите на фактури да проверят автентичността на документа.
## Какво е валидаторът?
Когато издадете фактура, тя получава уникален код за валидация. Получателят може да провери дали фактурата е истинска и непроменена.
## Достъп до валидатора
Валидаторът е достъпен на публичен адрес без нужда от вход:
**[invoicing.top/verify](https://invoicing.top/verify)**
![Валидатор](images/validator-main.png)
## Как да проверите фактура
### Метод 1: QR код
1. Отворете валидатора
2. Сканирайте QR кода от фактурата с камерата
3. Резултатът ще се покаже автоматично
### Метод 2: Въвеждане на код
1. Отворете валидатора
2. Въведете кода за валидация от фактурата
3. Натиснете **Провери**
### Метод 3: Директен линк
Всяка фактура съдържа линк за валидация:
```
https://invoicing.top/verify?code=XXXX-XXXX-XXXX
```
## Резултати от проверката
### Валиден документ ✅
Показва се информация за документа:
| Поле | Описание |
|------|----------|
| Номер | Номер на фактурата |
| Дата | Дата на издаване |
| Издател | Име на фирмата издател |
| Получател | Име на клиента |
| Сума | Обща сума с ДДС |
| Статус | Финализиран/Платен |
![Валиден документ](images/validator-valid.png)
### Невалиден документ ❌
Ако документът не е намерен или кодът е грешен:
- "Документът не е намерен"
- "Невалиден код за проверка"
Възможни причини:
- Грешно въведен код
- Документът е анулиран
- Документът не съществува
### Анулиран документ ⚠️
Ако документът е анулиран, ще се покаже предупреждение:
- "Този документ е анулиран"
- Дата на анулиране
- Причина за анулиране
## Къде се намира кодът за валидация?
Кодът за валидация се намира на фактурата:
1. В долния край на фактурата
2. Като QR код
3. Като текст под QR кода
![Код за валидация](images/validator-code-location.png)
## Сигурност
### Как работи валидацията?
1. При финализиране на фактура се генерира уникален код
2. Кодът се криптира и записва в базата данни
3. При проверка системата сравнява кода
4. Резултатът показва дали документът е автентичен
### Защита от фалшификации
- Всеки код е уникален
- Кодът не може да бъде предугаден
- Промяна на документа прави кода невалиден
## За издателите
### Активиране на валидация
Валидацията е активна по подразбиране за всички финализирани документи.
### QR код във фактурите
QR кодът се добавя автоматично при:
- Генериране на PDF
- Печат на фактура
### Персонализация
В настройките можете да:
- Промените позицията на QR кода
- Добавите лого до кода
- Изберете размер на кода