rckrdmrd db4bf55c31 Changes on workspace projects, new project platform_marketing_content

2025-12-08 18:33:25 -06:00

9.6 KiB

Raw Blame History

EPICA: EPIC-CL-008 - Facturación

Metadata

Campo	Valor
ID	EPIC-CL-008
Nombre	Facturación
Modulo	facturacion
Fase	Fase 1 - MVP
Prioridad	P0 (Critico)
Estado	Backlog
Story Points	38
Sprint(s)	Sprint 8-9

Descripcion

Sistema de facturación para servicios médicos. Incluye cobro de consultas, procedimientos, estudios de laboratorio, medicamentos y facturación a aseguradoras. Generación de CFDI 4.0 y notas de crédito.

Objetivo de Negocio

Cobro oportuno de servicios
Facturación correcta a aseguradoras
Cumplimiento fiscal
Control de cuentas por cobrar
Reportes financieros

Historias de Usuario

ID	Historia	Prioridad	SP	Estado
US-CL008-001	Como cajero, quiero generar cuenta del paciente con servicios prestados	P0	5	Backlog
US-CL008-002	Como cajero, quiero cobrar consulta con múltiples formas de pago	P0	5	Backlog
US-CL008-003	Como cajero, quiero facturar a nombre del paciente con sus datos fiscales	P0	5	Backlog
US-CL008-004	Como admin, quiero facturar a aseguradora con expediente de reclamación	P0	8	Backlog
US-CL008-005	Como cajero, quiero generar nota de crédito por cancelación o error	P0	3	Backlog
US-CL008-006	Como paciente, quiero pagar mi cuenta desde el portal web	P1	5	Backlog
US-CL008-007	Como admin, quiero ver cuentas por cobrar pendientes	P0	3	Backlog
US-CL008-008	Como admin, quiero configurar precios de servicios y procedimientos	P0	2	Backlog
US-CL008-009	Como admin, quiero ver reporte de ingresos por período	P1	2	Backlog

Total Story Points: 38 SP

Flujo de Facturación

COBRO DIRECTO (Paciente paga)

┌─────────────┐
│   CUENTA    │  ← Servicios prestados
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   COBRO     │  ← Efectivo/Tarjeta
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   CFDI      │  ← Timbrado
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  ENTREGADO  │  ← PDF + XML al paciente
└─────────────┘


COBRO A ASEGURADORA

┌─────────────┐
│   CUENTA    │  ← Servicios prestados
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  EXPEDIENTE │  ← Documentos requeridos
│ RECLAMACIÓN │     (notas, estudios, etc.)
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   ENVÍO     │  ← A la aseguradora
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ SEGUIMIENTO │  ← Pendiente de pago
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   COBRADO   │  ← Pago recibido
└──────┬──────┘
       │
       ▼
┌─────────────┐
│    CFDI     │  ← Factura a aseguradora
└─────────────┘

Cuenta del Paciente

┌─────────────────────────────────────────────────────────┐
│              CUENTA - PACIENTE: Juan Pérez              │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  SERVICIOS                                              │
│  ┌────────────────────────────────────┬───────────────┐ │
│  │ Concepto                           │ Importe       │ │
│  ├────────────────────────────────────┼───────────────┤ │
│  │ Consulta medicina general          │       $800.00 │ │
│  │ Biometría hemática                 │       $350.00 │ │
│  │ Química sanguínea 6 elementos      │       $450.00 │ │
│  │ Paracetamol 500mg x 20             │       $120.00 │ │
│  │ Amoxicilina 500mg x 21             │       $280.00 │ │
│  ├────────────────────────────────────┼───────────────┤ │
│  │ SUBTOTAL                           │     $2,000.00 │ │
│  │ IVA (16%)                          │         $0.00 │ │
│  │ ─────────────────────────────────────────────────  │ │
│  │ TOTAL                              │     $2,000.00 │ │
│  └────────────────────────────────────┴───────────────┘ │
│                                                         │
│  COBERTURA SEGURO                                       │
│  ├── Aseguradora: GNP Seguros                           │
│  ├── Póliza: 1234567                                    │
│  ├── Cobertura consulta: 100%                           │
│  ├── Cobertura laboratorio: 80%                         │
│  └── Copago paciente: $160.00                           │
│                                                         │
│  FORMA DE PAGO                                          │
│  ├── Cargo a seguro: $1,840.00                          │
│  └── Copago paciente: $160.00 (Pagado TDC)              │
│                                                         │
└─────────────────────────────────────────────────────────┘

Criterios de Aceptacion de la Epica

Funcionales:

Generar cuenta con servicios
Cobrar con múltiples formas de pago
Facturación CFDI 4.0
Facturación a aseguradoras
Notas de crédito
Portal de pagos
Cuentas por cobrar
Reportes de ingresos

No Funcionales:

Timbrado < 5 segundos
Historial de 5 años
Cumplimiento fiscal

Tecnicos:

Integración con PAC
Integración con todos los módulos
Pasarela de pagos
Reportes financieros

Dependencias

Esta epica depende de:

Epica/Modulo	Estado	Bloqueante
EPIC-CL-001 Fundamentos	Backlog	Si
EPIC-CL-002 Pacientes	Backlog	Si
EPIC-CL-003 Citas	Backlog	Parcial
EPIC-CL-004 Consultas	Backlog	Parcial
EPIC-CL-006 Laboratorio	Backlog	Parcial
EPIC-CL-007 Farmacia	Backlog	Parcial

Desglose Tecnico

Database:

Schema: billing
Tablas: 8 (accounts, account_items, payments, invoices, invoice_items, insurance_claims, price_lists, services)
Funciones: 3 (calculate_account, generate_invoice, process_payment)
Indices: Por paciente, fecha, estado, aseguradora

Backend:

Modulo: billing
Entities: 7 (Account, AccountItem, Payment, Invoice, InvoiceItem, InsuranceClaim, Service)
Endpoints: 15
Tests: 30

Frontend:

Paginas: 5 (Accounts, Checkout, InvoiceList, InsuranceClaims, Reports)
Componentes: 12 (AccountSummary, PaymentForm, InvoiceViewer, ClaimTracker, etc.)
Stores: 1 (billingStore)

Endpoints API

Metodo	Endpoint	Descripcion
GET	/api/billing/accounts/:patientId	Cuenta del paciente
POST	/api/billing/accounts/:id/items	Agregar servicio
POST	/api/billing/accounts/:id/pay	Registrar pago
POST	/api/billing/invoices	Generar factura
GET	/api/billing/invoices/:id/pdf	Descargar PDF
POST	/api/billing/invoices/:id/cancel	Cancelar factura
POST	/api/billing/credit-notes	Crear nota de crédito
POST	/api/billing/insurance-claims	Crear reclamación
GET	/api/billing/pending	Cuentas por cobrar
GET	/api/billing/reports/income	Reporte de ingresos

Riesgos

Riesgo	Probabilidad	Impacto	Mitigacion
Rechazo de aseguradora	Media	Alto	Expediente completo
Errores en facturación	Media	Alto	Validaciones antes de timbrar
Morosidad	Media	Medio	Seguimiento de cuentas

Definition of Ready (DoR)

Historias de usuario definidas
Criterios de aceptacion claros
Dependencias identificadas
Estimacion completada
Lista de precios definida
Convenios con aseguradoras documentados

Definition of Done (DoD)

Flujo de cobro funcionando
Facturación CFDI operativa
Facturación a aseguradoras
Reportes financieros
Tests de integración pasando
Documentación de API

Historial

Fecha	Cambio	Autor
2025-12-08	Creacion de epica	Claude-Agent

Creada por: Claude-Agent Fecha: 2025-12-08 Ultima actualizacion: 2025-12-08

9.6 KiB Raw Blame History