RF-MGN-002-005: Plantillas de Configuración por País

Módulo: MGN-002 - Empresas y Organizaciones Prioridad: P1 (Post-MVP) Story Points: 8 Estado: Definido Fecha: 2025-11-23

Descripción

El sistema debe proveer plantillas de configuración por país que faciliten la creación de empresas con plan de cuentas, impuestos y configuraciones predefinidas según legislación local.

Actores

Actor Principal: Administrador de Sistema
Actores Secundarios: Sistema (carga automática de plantillas)

Precondiciones

Plantillas por país deben estar cargadas en sistema
Usuario debe estar creando nueva empresa
País debe estar seleccionado

Flujo Principal

Administrador inicia creación de nueva empresa
Administrador selecciona país (ej: México)
Sistema detecta plantilla disponible para país
Sistema ofrece: "¿Usar plantilla de México con CFDI y SAT?"
Administrador acepta usar plantilla
Sistema carga configuración predefinida:
- Plan de cuentas estándar (Código Agrupador SAT)
- Impuestos comunes (IVA 16%, ISR, IEPS)
- Journals (Ventas, Compras, Banco, Diario)
- Términos de pago típicos (Contado, 30 días, 60 días)
- Régimen fiscal por defecto
Sistema crea empresa con configuración precargada
Administrador puede personalizar después

Flujos Alternativos

FA-1: Creación Manual (Sin Plantilla)

Si país no tiene plantilla o administrador no quiere usarla
Sistema crea empresa vacía
Administrador configura todo manualmente

FA-2: Plantillas Disponibles

México:
- Plan de cuentas según Código Agrupador SAT
- Impuestos: IVA 16%, ISR, IEPS
- Configuración CFDI (Facturación Electrónica)
USA:
- Plan de cuentas GAAP básico
- Sales Tax por estados
Colombia:
- Plan de cuentas PUC
- IVA 19%, Retención en la fuente

FA-3: Actualización de Plantillas

Sistema recibe actualización de plantilla (nuevo impuesto, cambio legislación)
Administrador puede aplicar cambios a empresas existentes
Sistema muestra diferencias (diff)
Administrador aprueba cambios
Sistema actualiza configuración de empresas

Reglas de Negocio

RN-1: Plantillas son opcionales (no obligatorias)
RN-2: Plantilla se aplica solo al crear empresa (no automático después)
RN-3: Configuración cargada desde plantilla puede personalizarse
RN-4: Plantillas incluyen: plan de cuentas, impuestos, journals, términos de pago
RN-5: Plantillas por país deben mantenerse actualizadas con legislación

Criterios de Aceptación

Sistema detecta plantilla disponible al seleccionar país
Administrador puede elegir usar o no plantilla
Plantilla carga plan de cuentas predefinido
Plantilla carga impuestos comunes del país
Plantilla carga journals estándar
Configuración cargada puede personalizarse después
Sistema soporta plantillas para múltiples países
Plantillas pueden actualizarse sin afectar empresas existentes

Entidades Involucradas

Principales:
- core.company_templates (plantillas por país)
- core.companies (empresa creada)
Relacionadas:
- financial.accounts (plan de cuentas)
- financial.taxes (impuestos)
- financial.journals (journals)

Referencias

Notas Técnicas

Patrón Odoo: l10n_* modules (localization packages)
Almacenamiento: JSON o SQL con templates versionados

Ejemplo Template JSON:

{
  "country": "MX",
  "name": "México - CFDI",
  "chart_of_accounts": {
    "accounts": [
      {"code": "101-01", "name": "Caja", "type": "asset"},
      {"code": "102-01", "name": "Bancos", "type": "asset"}
    ]
  },
  "taxes": [
    {"name": "IVA 16%", "rate": 16, "type": "sales"},
    {"name": "ISR Ret", "rate": 10, "type": "retention"}
  ],
  "journals": [
    {"name": "Ventas", "type": "sale", "code": "VEN"},
    {"name": "Compras", "type": "purchase", "code": "COM"}
  ]
}

Versionamiento: Templates tienen versión para actualizaciones
Backend: NestJS CompanyTemplateService
Frontend: Wizard de creación con opción de plantilla

Dependencias

RF Dependientes:
- RF-MGN-002-001 (Gestión de Empresas)
- RF-MGN-004-001 (Plan de Cuentas)
Bloqueante para: Ninguno (facilita creación, no es bloqueante)

4.6 KiB Raw Permalink Blame History