Initial commit: User documentation

04-clients.md

@@ -0,0 +1,119 @@
+# Клиенти
+
+Управлението на клиенти ви позволява да поддържате база данни с всички ваши контрагенти.
+
+## Списък с клиенти
+
+### Преглед
+
+Страницата **Клиенти** показва всички регистрирани клиенти.
+
+![Списък клиенти](images/clients-list.png)
+
+### Информация в списъка
+
+| Колона | Описание |
+|--------|----------|
+| Име | Наименование на клиента |
+| ЕИК | Единен идентификационен код |
+| ДДС номер | Номер по ДДС (ако има) |
+| Държава | Код на държавата |
+| Имейл | Имейл за контакт |
+| Телефон | Телефон за контакт |
+
+### Търсене и филтриране
+
+- Търсене по име, ЕИК или ДДС номер
+- Филтър по държава
+- Филтър по статус (EU/Non-EU)
+
+## Добавяне на нов клиент
+
+### Ръчно въвеждане
+
+1. Натиснете **+ Нов клиент**
+2. Попълнете данните:
+
+| Поле | Задължително | Описание |
+|------|-------------|----------|
+| Име | Да | Пълно наименование |
+| ЕИК | Не | За български фирми |
+| ДДС номер | Не | С код на държава (BG, DE, etc.) |
+| Адрес | Да | Пълен адрес |
+| Град | Да | Населено място |
+| Пощенски код | Не | Пощенски код |
+| Държава | Да | Изберете от списъка |
+| Имейл | Не | За изпращане на фактури |
+| Телефон | Не | За контакт |
+| МОЛ | Не | Материално отговорно лице |
+
+![Нов клиент](images/client-new.png)
+
+### Импорт от VIES
+
+За EU клиенти можете автоматично да импортирате данни от VIES:
+
+1. Натиснете **+ Нов клиент**
+2. Въведете ДДС номера (напр. DE123456789)
+3. Натиснете **Провери в VIES**
+4. Ако номерът е валиден, данните ще се попълнят автоматично
+5. Запазете клиента
+
+![VIES импорт](images/client-vies.png)
+
+### Валидация на ДДС номер
+
+Системата автоматично проверява:
+
+- ✅ **Валиден** - номерът е активен в VIES
+- ❌ **Невалиден** - номерът не е намерен или е неактивен
+- ⚠️ **Грешка** - VIES услугата не е достъпна
+
+## Редактиране на клиент
+
+1. Кликнете върху клиента в списъка
+2. Редактирайте данните
+3. Натиснете **Запази**
+
+## Изтриване на клиент
+
+⚠️ **Внимание:** Клиент с издадени документи не може да бъде изтрит!
+
+1. Отворете клиента
+2. Натиснете **Изтрий**
+3. Потвърдете действието
+
+## Документи на клиент
+
+От страницата на клиента можете да видите:
+
+- Всички издадени документи
+- Обща сума на фактурите
+- Неплатени фактури
+
+## Типове клиенти
+
+### Български клиенти
+
+- Изисква се ЕИК
+- ДДС номер започва с BG
+
+### EU клиенти
+
+- ДДС номер от друга EU държава
+- Възможност за ВОД (без ДДС)
+- VIES валидация
+
+### Клиенти извън EU
+
+- Без ДДС валидация
+- Възможност за износ (без ДДС)
+
+## Експорт на клиенти
+
+За експорт на списъка с клиенти:
+
+1. Отидете в **Клиенти**
+2. Приложете желаните филтри
+3. Натиснете **Експорт**
+4. Изберете формат (CSV, Excel)