clinica-veterinaria/docs/04-fase-saas/MGN-016-billing/README.md
rckrdmrd c4620ca4e9 [DOCS] feat: Add phase 04-SAAS and 05-IA documentation structure
- Update docs/_MAP.md with new phase references
- Add docs/04-fase-saas/ phase structure
- Add docs/05-fase-ia/ phase structure

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 00:28:18 -06:00

5.2 KiB

id title type status version created_date updated_date module priority source
MGN-016-billing-vet Modulo Billing - Facturacion Veterinaria ModuleOverview Draft 1.0.0 2026-01-13 2026-01-13 billing P0 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


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