clinica-veterinaria/docs/04-fase-saas/MGN-016-billing/README.md

---
id: MGN-016-billing-vet
title: "Modulo Billing - Facturacion Veterinaria"
type: ModuleOverview
status: Draft
version: 1.0.0
created_date: 2026-01-13
updated_date: 2026-01-13
module: billing
priority: P0
source: erp-core/MGN-016-billing
---

# MGN-016: Billing - Sistema de Facturacion para Clinicas Veterinarias

## Resumen Ejecutivo

El modulo Billing implementa el sistema de facturacion y suscripciones para clinicas veterinarias, integrando Stripe Billing como proveedor de pagos. Permite gestionar suscripciones mensuales y anuales para clinicas, facturacion de servicios veterinarios y paquetes de bienestar animal.

---

## Normativas Aplicables

- **NOM-064-ZOO-2000**: Lineamientos para la clasificacion y prescripcion de productos farmaceuticos veterinarios
- **SENASICA**: Servicio Nacional de Sanidad, Inocuidad y Calidad Agroalimentaria
- **SAT**: Facturacion electronica (CFDI) para servicios veterinarios

---

## Objetivos

### Objetivo Principal

Implementar un sistema de billing completo para clinicas veterinarias que permita:
- Suscripciones mensuales y anuales para clinicas
- Facturacion de servicios (consultas, cirugia, hospitalizacion)
- Facturacion de productos (medicamentos, alimentos, accesorios)
- Paquetes de vacunacion y desparasitacion
- Planes de bienestar por mascota

### Objetivos Secundarios

- Sincronizacion bidireccional con Stripe via webhooks
- Soporte para periodos de prueba (14 dias)
- Manejo de pagos fallidos y dunning
- Historial de facturas por propietario de mascota
- Facturacion recurrente para planes de bienestar

---

## Planes para Clinicas Veterinarias

| Plan | Precio/mes | Mascotas | Veterinarios | Funcionalidades |
|------|-----------|----------|--------------|-----------------|
| **Basico** | $499 MXN | 100 | 2 | Expedientes, Citas, Vacunacion basica |
| **Profesional** | $999 MXN | 500 | 5 | + Hospitalizacion, Laboratorio, WhatsApp |
| **Clinica** | $1,999 MXN | Ilimitadas | 10 | + IA, Reportes avanzados, Integraciones |
| **Hospital** | $3,999 MXN | Ilimitadas | Ilimitados | + Multi-sucursal, API, Soporte prioritario |

---

## Servicios Facturables

### Consultas y Atencion

| Servicio | Precio Sugerido | Notas |
|----------|----------------|-------|
| Consulta general | $350-500 MXN | Todas las especies |
| Consulta de emergencia | $500-800 MXN | 24/7 |
| Vacunacion (aplicacion) | $150-300 MXN | + costo de vacuna |
| Desparasitacion | $100-200 MXN | + costo de producto |

### Hospitalizacion

| Servicio | Precio Sugerido | Notas |
|----------|----------------|-------|
| Hospitalizacion canino/dia | $400-800 MXN | Segun tamano |
| Hospitalizacion felino/dia | $300-500 MXN | |
| Hospitalizacion exotico/dia | $500-1000 MXN | Requiere equipo especial |

### Cirugia

| Servicio | Precio Sugerido | Notas |
|----------|----------------|-------|
| Esterilizacion canino macho | $800-1500 MXN | Segun peso |
| Esterilizacion canino hembra | $1200-2500 MXN | Segun peso |
| Esterilizacion felino | $600-1200 MXN | |
| Limpieza dental | $800-1500 MXN | + anestesia |

---

## Paquetes de Bienestar

### Plan Cachorro/Gatito

Paquete anual para mascotas de 0-1 anio:
- 4 consultas de seguimiento
- Esquema completo de vacunacion
- 4 desparasitaciones
- Esterilizacion incluida
- **Precio:** $3,500-4,500 MXN/anio

### Plan Adulto

Paquete anual para mascotas de 1-7 anios:
- 2 consultas de chequeo
- Vacunas anuales de refuerzo
- 2 desparasitaciones
- Limpieza dental con 20% descuento
- **Precio:** $2,000-3,000 MXN/anio

### Plan Senior

Paquete anual para mascotas mayores de 7 anios:
- 4 consultas de seguimiento
- Vacunas anuales de refuerzo
- 4 desparasitaciones
- Examenes geriatricos (sangre, orina)
- **Precio:** $4,000-5,500 MXN/anio

---

## Arquitectura

### Flujo de Pago de Suscripcion

```
1. Clinica selecciona plan en frontend
   |
2. Frontend llama POST /billing/checkout
   |
3. Backend crea Checkout Session en Stripe
   |
4. Clinica completa pago en Stripe
   |
5. Stripe envia webhook: checkout.session.completed
   |
6. Backend activa suscripcion de clinica
   |
7. Clinica puede registrar mascotas y facturar
```

---

## Dependencias

### Modulos Prerequisito

| Modulo | Tipo | Descripcion |
|--------|------|-------------|
| MGN-001-auth | Requerido | Autenticacion JWT |
| MGN-002-users | Requerido | Usuario veterinario/propietario |
| MGN-004-tenants | Requerido | Contexto multi-tenant (por clinica) |

### Servicios Externos

| Servicio | Proposito | Requerido |
|----------|-----------|-----------|
| Stripe | Billing y pagos | Si |
| SAT | CFDI (factura electronica) | Opcional |

---

## Seguridad

| Medida | Implementacion |
|--------|----------------|
| PCI Compliance | No almacenar datos de tarjeta (Stripe) |
| Webhook Signature | Verificar Stripe-Signature header |
| Datos Sensibles | Encriptar informacion financiera de propietarios |
| Audit Trail | Log de todos los pagos y cambios de plan |

---

## Indices

- [Requerimientos Funcionales](requerimientos/INDICE-RF-BILLING.md)
- [Especificaciones Tecnicas](especificaciones/INDICE-ET-BILLING.md)
- [Historias de Usuario](historias-usuario/INDICE-US-BILLING.md)
- [Trazabilidad](implementacion/TRACEABILITY.yml)

---

*Modulo: MGN-016-billing-vet | Version: 1.0.0 | Estado: Draft*
*Propagado desde: erp-core/MGN-016-billing*
*Adaptado para: Dominio veterinario*
*Actualizado: 2026-01-13*