🏗️ Архитектура системы

🔧 Компоненты системы

Payment Controller
Обработка платежей
Fiscal Service
Фискализация 54-ФЗ
Debt Management
Управление задолженностью
Contractor Service
Работа с контрагентами

📁 Источники формирования счетов

  • Из визита: автоматическое формирование на основе оказанных услуг
  • Из пациента: внесение авансов и предоплат
  • Из плана лечения: предоплата за утвержденный план
  • Из реестра: погашение дебиторской задолженности

👨‍💻 Для разработчиков

🔗 API endpoints

POST /api/v1/payments/create-receipt
Создание кассового чека
// Пример запроса на создание чека
{
  "patient_id": "12345",
  "visit_id": "67890",
  "amount": 15000,
  "payment_type": "full",
  "payment_method": 1,
  "items": [
    {
      "name": "Консультация врача",
      "price": 2000,
      "quantity": 1,
      "payment_method": 4
    }
  ],
  "cashier": {
    "name": "Иванова А.С.",
    "inn": "123456789012"
  }
}
GET /api/v1/debts/unpaid-invoices
Получение реестра незакрытых счетов
POST /api/v1/advances/create
Создание аванса/предоплаты

💾 Модели данных

// Модель счета
interface Invoice {
  id: string;
  patient_id: string;
  visit_id?: string;
  amount: number;
  paid_amount: number;
  status: 'draft' | 'issued' | 'paid' | 'partially_paid' | 'overdue';
  due_date?: Date;
  payer_type: 'individual' | 'legal' | 'insurance';
  created_at: Date;
  items: InvoiceItem[];
}

👥 Для сотрудников

💰 Оплата из визита

1 Карта пациента → Визиты
2 Выберите визит → "Создать счет"
3 Проверьте услуги → "Оплатить"
4 Выберите способ оплаты

🏦 Внесение аванса

1 Карта пациента → "Внести аванс"
2 Введите сумму аванса
3 Пробивается чек с признаком "3-Аванс"
4 Средства зачисляются на счет пациента

📋 Погашение задолженности

1 Реестр счетов → "Неоплаченные"
2 Найдите пациента → "Погасить"
3 Внесите платеж (полностью или частично)
4 Чек с признаком "7-Оплата кредита"

🧾 Фискализация 54-ФЗ

📋 Признаки способа расчета (тег 1214)

Код Название Сценарий использования Пример
1 Предоплата 100% Полная оплата утвержденного плана лечения Пациент оплатил весь план заранее
2 Предоплата Частичная оплата конкретных услуг Внесение 50% за известные услуги
3 Аванс Внесение депозита на будущее лечение Депозит 10 000 руб. без конкретных услуг
4 Полный расчет Оплата при оказании услуг Оплата после консультации
5 Частичный расчет и кредит Частичная оплата + рассрочка Внесение 30%, остальное в кредит
6 Передача в кредит Оказание услуги с отсрочкой оплаты Услуга оказана, оплата позже
7 Оплата кредита Погашение задолженности по расписке Внесение платежа по долгу

✅ Требуется фискализация

  • Расчеты с физическими лицами
  • Авансы и предоплаты
  • Оплата кредитов/рассрочек
  • Возвраты средств
  • Комбинированные оплаты (часть физ.лица)

❌ Без фискализации

  • Расчеты с юр.лицами (ДМС)
  • Гарантийные письма
  • Бартерные операции
  • Услуги сотрудникам
  • ОМС (реестры в ТФОМС)

💰 Типы оплат и расчетов

💵 Прямая оплата

  • Наличные средства
  • Банковские карты
  • Электронные кошельки
  • Признак расчета: 4 (Полный расчет)

🏦 Авансы и предоплаты

  • Аванс (депозит) - признак 3
  • Предоплата 100% - признак 1
  • Частичная предоплата - признак 2
  • Зачет при оказании услуг

🔄 Кредиты и рассрочки

  • Внутренний кредит (расписка)
  • Банковская рассрочка
  • Признаки 5,6,7
  • Контроль графика платежей

🤝 Комбинированные оплаты

  • ГП + оплата пациента
  • Аванс + доплата
  • Кредит + первоначальный взнос
  • Частичная фискализация

📝 Особые случаи

Оплата третьим лицом:
  • Родственник оплачивает за пациента
  • Требуется заявление пациента
  • Фискализация обязательна
  • В чеке указывается плательщик
Гарантийные письма:
  • На сумму или конкретные услуги

📊 Управление задолженностью

📋 Реестр счетов

  • Все созданные счета
  • Фильтрация по статусам
  • Сортировка по датам
  • Быстрый поиск по пациентам
  • Экспорт в Excel

💳 Дебиторская задолженность

  • Неоплаченные счета
  • Просроченные платежи
  • Кредиты по распискам
  • Напоминания должникам
  • Автоматические уведомления

🏷️ Сортировка плательщиков

  • Физические лица
  • Юридические лица
  • Страховые компании
  • Банки-партнеры
  • ТФОМС (ОМС)

⏰ Контроль сроков

Срочные (1-3 дня):
  • Непробитые чеки
  • Ошибки фискализации
Краткосрочные (неделя):
  • Просроченные счета
  • Незакрытые авансы
Долгосрочные (месяц):
  • Статистика по оплатам
  • Анализ задолженности

📈 Контроль и дашборды

🚨 Непробитые чеки

  • Контроль ежедневно
  • Автоуведомления
  • ФИО ответственного
  • Время создания

⚠️ Ошибки фискализации

  • Сбои связи с АТОЛ
  • Ошибки валидации
  • Проблемы с ОФД
  • Автоповтор отправки

📊 Статистика оплат

  • По способам оплаты
  • По видам услуг
  • По врачам/отделениям
  • Динамика по периодам

💼 Реестр операций

  • Все финансовые операции
  • Фильтры по датам
  • Поиск по контрагентам
  • Выгрузка отчетов

🔔 Система уведомлений

Немедленные:
  • Ошибки фискализации
  • Сбои интеграции
Ежедневные:
  • Непробитые чеки
  • Итоги кассовой смены
Еженедельные:
  • Просроченная задолженность
  • Статистика за неделю

🔗 Интеграции

🏪 Интеграция с кассами АТОЛ

🖥️ Физические кассы

// Конфигурация
ATOL_PHYSICAL = {
  comPort: 'COM3',
  baudRate: 115200,
  driverPath: '/drivers/atol/'
}

☁️ Облачные кассы

// Конфигурация
ATOL_CLOUD = {
  baseURL: 'https://online.atol.ru/possystem/v4',
  groupCode: 'your-group-code',
  login: 'your-login',
  password: 'your-password'
}

🏦 Интеграция с Т-Банком

Схема 1 - Банк платит сам

  • Банк перечисляет со своего счета
  • Фискализация не требуется
  • Оформляется Акт выполненных работ
  • Учет в реестре контрагентов

Схема 2 - Деньги пациенту

  • Банк перечисляет на счет пациента
  • Пациент оплачивает клинике
  • Фискализация обязательна
  • Чек с признаком 4 (Полный расчет)

📋 Чек-лист внедрения

Техническая часть:
  • ☑️ Настройка интеграции с АТОЛ
  • ☑️ Реализация признаков расчета
  • ☑️ Настройка реестров и отчетов
  • ☑️ Тестирование всех сценариев
Организационная часть:
  • ☑️ Обучение сотрудников
  • ☑️ Настройка прав доступа
  • ☑️ Назначение ответственных
  • ☑️ Регламент работы с ошибками

📞 Техническая поддержка

При возникновении вопросов по работе модуля оплаты обращайтесь:

Email: tech-support@clinicsist.pro | Телефон: +7 (XXX) XXX-XX-XX

Версия документации: 2.0 | Последнее обновление: 2025 | Ответственный: Отдел разработки "КЛИНИЦИСТ"