Facturacion por Lotes de Membresias

Modulo: Membresias Tipo: Process Estado: Implementado Fecha Creacion: 2026-01-27 Fecha Implementacion: 2026-01-27

---

Descripcion

Problema que resuelve

El modulo de membresias requiere generar facturas de forma periodica para todos los socios activos. Realizar esta facturacion de manera individual seria extremadamente ineficiente y propenso a errores, considerando el volumen de socios que la organizacion gestiona.

Sin un proceso de facturacion masiva, la organizacion enfrenta:

• Ineficiencia operativa: El usuario deberia generar manualmente cada factura para cada socio, consumiendo un tiempo considerable
• Errores de omision: Es facil olvidar facturar a uno o varios socios en un proceso manual
• Inconsistencia en calculos: Los calculos de deuda, bonificaciones y conceptos asociados a cada socio pueden variar segun su categoria, disciplinas y grupo familiar, lo cual es dificil de gestionar manualmente
• Demora en la integracion fiscal: Cada factura debe ser autorizada por ARCA (organismo fiscal) para obtener el CAE correspondiente, proceso que debe realizarse de forma eficiente
• Falta de correccion masiva: Cuando se detectan errores en la facturacion de un periodo, no existe un mecanismo para corregirlos de forma sistematica

Solucion implementada

Se implemento un proceso integral de facturacion por lotes que permite:

1. Facturacion masiva: Generar facturas para un rango de socios en un periodo determinado, agrupando automaticamente por grupos familiares
2. Calculo automatico de deuda: Determinar los items a facturar segun la categoria, disciplinas y productos asociados a cada socio
3. Integracion fiscal automatica: Enviar lotes de comprobantes a ARCA para obtener el CAE de forma masiva
4. Visualizacion de resultados: Mostrar el detalle de la facturacion realizada, incluyendo estados por socio, errores y estadisticas
5. Re-facturacion: Permitir corregir la facturacion de un periodo mediante la emision de Notas de Credito y nuevas Facturas

Valor de negocio

• Eficiencia operativa: Un solo proceso genera todas las facturas del periodo, reduciendo drasticamente el tiempo de facturacion
• Precision en calculos: El sistema calcula automaticamente la deuda de cada socio segun su configuracion (categoria, disciplinas, productos, bonificaciones)
• Cumplimiento fiscal: La integracion automatica con ARCA garantiza que cada factura cuente con su CAE valido
• Trazabilidad: Cada factura queda registrada en el modulo de Ventas con todos sus datos fiscales y comerciales
• Flexibilidad de correccion: El mecanismo de re-facturacion permite corregir errores sin perder la trazabilidad contable
• Agrupacion familiar: Los grupos familiares se facturan de forma consolidada al titular, simplificando la gestion de cobro

Contexto del sistema

Esta funcionalidad se integra con los siguientes componentes existentes:

• Modulo de Ventas: Las facturas generadas se registran como comprobantes de venta
• ARCA (Organismo Fiscal): Servicio externo para la autorizacion de comprobantes electronicos y obtencion del CAE
• Gestion de Socios: Maestro de socios con sus categorias, disciplinas y grupos familiares
• Cuenta Corriente: Las facturas generadas se registran con condicion de venta Cuenta Corriente a 30 dias

---

Proceso de Negocio

Componente 1: Generacion de Facturacion Masiva

El proceso de facturacion masiva genera facturas para un rango de socios en un periodo especifico, automatizando el calculo de la deuda y la integracion fiscal.

Flujo de facturacion masiva

flowchart TD
    subgraph FACTURACION["PROCESO DE FACTURACION MASIVA"]
        A["1. SOLICITUD DE FACTURACION
        - Usuario indica rango de IDs de socios
        - Usuario indica periodo (mes-ano)
        - Usuario confirma ejecucion"]

        B["2. OBTENCION DE MIEMBROS
        - Sistema obtiene todos los socios del rango indicado
        - Filtra socios activos y elegibles para facturacion"]

        C["3. AGRUPACION FAMILIAR
        - Sistema agrupa socios por grupos familiares
        - Identifica titular de cada grupo
        - Socios sin grupo se procesan individualmente"]

        D["4. ENRIQUECIMIENTO DE DATOS
        - Obtiene categoria de cada socio/grupo
        - Obtiene disciplinas contratadas
        - Obtiene productos asociados"]

        E["5. CALCULO DE DEUDA
        - Calcula items a facturar por cada socio/grupo
        - Aplica regla de Deuda con DDD
        - Determina importes segun categoria y disciplinas"]

        F["6. DETERMINACION DE TIPO DE COMPROBANTE
        - Evalua condicion IVA del cliente
        - Determina tipo de factura: A, B o C"]

        G["7. CONSTRUCCION DE LOTES ARCA
        - Agrupa comprobantes para envio a ARCA
        - Prepara datos fiscales de cada factura"]

        H["8. ENVIO A ARCA
        - Envia lote de comprobantes a ARCA
        - Obtiene CAE para cada comprobante autorizado"]

        I["9. REGISTRO EN VENTAS
        - Registra cada factura en el modulo de Ventas
        - Condicion de venta: Cuenta Corriente a 30 dias
        - Asocia CAE y datos fiscales"]

        J["10. RESPUESTA AL USUARIO
        - Retorna detalle por cada socio
        - Estado: Exitoso, Error u Omitido
        - Estadisticas agregadas del proceso"]
    end

    A --> B
    B --> C
    C --> D
    D --> E
    E --> F
    F --> G
    G --> H
    H --> I
    I --> J

Agrupacion por grupos familiares

El sistema maneja dos tipos de agrupacion:

Tipo de agrupacion	Descripcion	Comportamiento
Grupo real	Socios vinculados formalmente como grupo familiar en el sistema	Se factura al titular del grupo, incluyendo los conceptos de todos los miembros
Grupo simbolico	Socios que comparten una relacion pero no estan formalmente agrupados	Se aplican reglas especificas segun la configuracion del proveedor de agrupacion
Sin grupo	Socios individuales sin vinculacion familiar	Se facturan individualmente

Calculo de deuda con DDD

El calculo de la deuda de cada socio o grupo familiar considera:

• Categoria del socio: Determina el conjunto base de conceptos a facturar
• Disciplinas contratadas: Cada disciplina puede agregar items adicionales a la factura
• Productos asociados: Productos especificos vinculados al socio
• Regla DDD: Mecanismo de calculo de deuda que considera la acumulacion de periodos impagos

Determinacion del tipo de comprobante

El tipo de comprobante se determina segun la condicion fiscal del cliente:

Condicion IVA del cliente	Tipo de comprobante
Responsable Inscripto	Factura A
Monotributista	Factura B
Consumidor Final	Factura B
Exento	Factura C

Condicion de venta

Todas las facturas generadas por el proceso de facturacion masiva se registran con:

• Condicion de venta: Cuenta Corriente
• Plazo: 30 dias

Componente 2: Visualizacion de Resultados

Una vez finalizado el proceso de facturacion, el sistema presenta un modal con los resultados detallados.

Informacion presentada

Estadisticas agregadas del proceso:

Estadistica	Descripcion
Total de socios procesados	Cantidad total de socios incluidos en el rango
Facturas generadas exitosamente	Cantidad de facturas que obtuvieron CAE y fueron registradas
Socios con error	Cantidad de socios cuya facturacion fallo
Socios omitidos	Cantidad de socios que fueron omitidos (sin deuda, inactivos, etc.)

Detalle por socio:

Dato	Descripcion
Identificacion del socio	Nombre o razon social del socio/titular
Estado	Exitoso, Error u Omitido
Numero de comprobante	Tipo y numero de la factura generada (si exitoso)
CAE	Codigo de Autorizacion Electronica obtenido de ARCA
Fecha de comprobante	Fecha de emision de la factura
Items facturados	Detalle de los conceptos incluidos con sus precios
Error ARCA	Mensaje de error devuelto por ARCA (si aplica)

Estados posibles por socio

Estado	Descripcion	Accion del usuario
Exitoso	La factura fue generada, autorizada por ARCA y registrada correctamente	Ninguna requerida
Error	Ocurrio un error durante el proceso (rechazo de ARCA, error de calculo, etc.)	Revisar error y corregir datos del socio o reintentar
Omitido	El socio fue excluido del proceso (sin deuda, inactivo, ya facturado, etc.)	Verificar si la omision es correcta

Componente 3: Re-facturacion

La re-facturacion permite corregir facturas ya emitidas para un periodo, generando Notas de Credito para anular las facturas existentes y luego emitiendo nuevas facturas con los datos actualizados.

Flujo de re-facturacion

flowchart TD
    subgraph REFACTURACION["PROCESO DE RE-FACTURACION"]
        A["1. SOLICITUD DE RE-FACTURACION
        - Usuario indica rango de IDs de socios
        - Usuario indica periodo (mes-ano)
        - Usuario activa opcion de re-facturacion
        - Usuario confirma ejecucion"]

        B["FASE 1: ANULACION
        - Sistema identifica facturas existentes del periodo
        - Genera Notas de Credito por cada factura a anular
        - Envia NCs a ARCA para obtener CAE
        - Registra NCs en modulo de Ventas"]

        C["FASE 2: NUEVA FACTURACION
        - Sistema recalcula la deuda con datos actualizados
        - Genera nuevas facturas con importes corregidos
        - Envia nuevas facturas a ARCA
        - Registra nuevas facturas en modulo de Ventas"]

        D["3. RESULTADO
        - Retorna detalle de NCs generadas
        - Retorna detalle de nuevas facturas
        - Estadisticas del proceso completo"]
    end

    A --> B
    B --> C
    C --> D

Escenarios de re-facturacion

Escenario	Descripcion	Resultado
Cambio de precio	Se actualizo el precio de una categoria o disciplina despues de facturar	NC por factura original + nueva factura con precio actualizado
Cambio de categoria del socio	Un socio cambio de categoria despues de la facturacion del periodo	NC por factura original + nueva factura segun nueva categoria
Error en datos del socio	Se detectaron datos incorrectos que afectan la facturacion	NC por factura original + nueva factura con datos corregidos
Cambio de grupo familiar	Un socio fue agregado o removido de un grupo familiar	NC por factura(s) original(es) + nueva(s) factura(s) con agrupacion correcta

---

Frontend (Perspectiva de Usuario)

Vistas

Vista principal de facturacion por lotes

• Formulario para ingresar parametros de facturacion:
  • Rango de IDs de socios (desde - hasta)
  • Periodo de facturacion (mes y ano)
  • Opcion de re-facturacion (activar/desactivar)
• Boton para ejecutar el proceso de facturacion
• Indicador de progreso durante la ejecucion

Modal de resultados de facturacion

• Resumen estadistico del proceso (totales exitosos, errores, omitidos)
• Tabla detallada con resultado por socio:
  • Estado (Exitoso/Error/Omitido) con indicador visual
  • Datos del comprobante generado (tipo, numero, CAE, fecha)
  • Items facturados con precios
  • Mensaje de error ARCA si aplica
• Posibilidad de revisar el detalle de cada socio

Interacciones del usuario

Facturacion masiva

1. El usuario accede a la vista de facturacion por lotes del modulo de membresias
2. El usuario ingresa el rango de IDs de socios a facturar
3. El usuario selecciona el periodo (mes y ano)
4. El usuario confirma la ejecucion del proceso
5. El sistema muestra indicador de progreso mientras se ejecuta
6. Al finalizar, el sistema presenta el modal de resultados

Re-facturacion

1. El usuario accede a la vista de facturacion por lotes
2. El usuario ingresa el rango de IDs de socios a re-facturar
3. El usuario selecciona el periodo
4. El usuario activa la opcion de re-facturacion
5. El usuario confirma la ejecucion
6. El sistema ejecuta Fase 1 (Notas de Credito) y Fase 2 (Nuevas facturas)
7. Al finalizar, el sistema presenta el modal de resultados con ambas fases

Revision de resultados

1. Al completarse la facturacion, se muestra automaticamente el modal de resultados
2. El usuario puede revisar las estadisticas generales del proceso
3. El usuario puede consultar el detalle de cada socio (comprobante, CAE, items, errores)
4. El usuario puede identificar socios con error para tomar accion correctiva

Permisos

Permiso	Descripcion	Acciones permitidas
Facturacion masiva de membresias	Permite ejecutar el proceso de facturacion por lotes	Generar facturacion masiva, ver resultados
Re-facturacion de membresias	Permite ejecutar el proceso de re-facturacion	Generar NCs y nuevas facturas de correccion

Estados de UI

Estado	Descripcion	Elementos visuales
Formulario inicial	Vista lista para ingresar parametros	Campos vacios, boton de ejecucion habilitado
Validando parametros	Sistema verificando datos ingresados	Indicadores de validacion en campos
Procesando facturacion	Proceso en ejecucion	Indicador de progreso, botones deshabilitados, mensaje "Procesando facturacion..."
Resultados disponibles	Proceso finalizado exitosamente	Modal de resultados con estadisticas y detalle por socio
Error de proceso	Error general durante la ejecucion	Mensaje de error con descripcion del problema

---

Backend (Perspectiva de Datos de Negocio)

Entidades de negocio involucradas

Socio / Miembro

Entidad que representa a un socio o miembro de la organizacion.

Dato de negocio	Descripcion
Identificador	Identificador unico del socio
Nombre / Razon social	Nombre completo o razon social
Condicion IVA	Condicion fiscal del socio (RI, Monotributo, CF, Exento)
Categoria	Categoria de membresia del socio
Disciplinas	Disciplinas contratadas por el socio
Grupo familiar	Grupo familiar al que pertenece (si aplica)
Estado	Activo / Inactivo

Grupo Familiar

Agrupacion de socios que comparten una relacion familiar y se facturan consolidadamente.

Dato de negocio	Descripcion
Identificador	Identificador unico del grupo
Titular	Socio responsable de la facturacion del grupo
Miembros	Lista de socios que componen el grupo
Tipo de agrupacion	Real o simbolica

Factura de Membresia

Comprobante generado por el proceso de facturacion masiva.

Dato de negocio	Descripcion
Tipo de comprobante	Factura A, B o C segun condicion IVA
Numero de comprobante	Numero correlativo del comprobante
CAE	Codigo de Autorizacion Electronica otorgado por ARCA
Fecha de emision	Fecha de emision del comprobante
Periodo facturado	Mes y ano al que corresponde la facturacion
Socio / Titular	Socio o titular del grupo familiar facturado
Items	Detalle de conceptos facturados con precios
Total	Importe total de la factura
Condicion de venta	Cuenta Corriente a 30 dias (fija)

Nota de Credito de Re-facturacion

Comprobante generado durante la Fase 1 del proceso de re-facturacion para anular facturas existentes.

Dato de negocio	Descripcion
Tipo de comprobante	Nota de Credito A, B o C segun condicion IVA
Factura anulada	Referencia a la factura que se esta anulando
CAE	Codigo de Autorizacion Electronica otorgado por ARCA
Periodo	Periodo al que corresponde la anulacion
Total	Importe total de la Nota de Credito (igual al de la factura anulada)

Relaciones de negocio

• Un socio pertenece a una categoria de membresia
• Un socio puede estar inscripto en una o varias disciplinas
• Un socio puede pertenecer a un grupo familiar (como titular o como miembro)
• Un grupo familiar tiene un unico titular que recibe la facturacion
• La facturacion masiva genera una factura por cada socio o grupo familiar
• Cada factura se registra en el modulo de Ventas con condicion Cuenta Corriente
• Cada factura obtiene un CAE del servicio fiscal ARCA
• La re-facturacion genera Notas de Credito que anulan facturas existentes y nuevas facturas con datos corregidos

Validaciones de negocio

Validacion	Descripcion	Comportamiento si no cumple
Rango de socios valido	Los IDs de inicio y fin deben ser numeros validos y el inicio debe ser menor o igual al fin	Error: Rango de socios invalido
Periodo valido	El periodo debe ser un mes y ano validos	Error: Periodo de facturacion invalido
Socio activo	Solo se facturan socios con estado activo	El socio se omite del proceso (estado: Omitido)
Socio con deuda calculable	El socio debe tener categoria y datos suficientes para calcular la deuda	El socio se reporta con error o se omite
Autorizacion ARCA	Cada comprobante debe ser autorizado por ARCA	El socio se reporta con error ARCA y sin factura registrada
Re-facturacion: factura existente	Para re-facturar, debe existir una factura previa del periodo para el socio	El socio se omite de la Fase 1 si no tiene factura previa

---

Reglas de Negocio

RN-001: Agrupacion familiar para facturacion

Descripcion: Cuando un socio pertenece a un grupo familiar, la facturacion se emite a nombre del titular del grupo, consolidando los conceptos de todos los miembros del grupo en una unica factura.

Condicion: El socio pertenece a un grupo familiar con titular asignado.

Accion:

• Identificar al titular del grupo familiar
• Consolidar los conceptos de todos los miembros del grupo (categorias, disciplinas, productos)
• Emitir una unica factura a nombre del titular
• No emitir facturas individuales para los demas miembros del grupo

---

RN-002: Determinacion del tipo de comprobante segun condicion IVA

Descripcion: El tipo de factura a generar depende de la condicion fiscal del cliente (socio o titular del grupo).

Condicion: Se va a generar una factura para un socio.

Accion:

• Si el cliente es Responsable Inscripto: emitir Factura A
• Si el cliente es Monotributista o Consumidor Final: emitir Factura B
• Si el cliente es Exento: emitir Factura C

---

RN-003: Condicion de venta fija - Cuenta Corriente a 30 dias

Descripcion: Todas las facturas generadas por el proceso de facturacion masiva de membresias se registran con condicion de venta Cuenta Corriente a 30 dias.

Condicion: Se genera cualquier factura a traves del proceso de facturacion por lotes.

Accion:

• Registrar la factura con condicion de venta: Cuenta Corriente
• Establecer plazo de 30 dias
• Generar el movimiento correspondiente en la cuenta corriente del cliente

---

RN-004: Calculo de deuda con DDD

Descripcion: El calculo de los items a facturar para cada socio o grupo se realiza mediante el mecanismo de Deuda con DDD, que considera la categoria, disciplinas y productos del socio para determinar los conceptos e importes correspondientes.

Condicion: Se debe calcular la deuda de un socio o grupo para un periodo.

Accion:

• Obtener la categoria del socio o del grupo
• Obtener las disciplinas contratadas
• Obtener los productos asociados
• Aplicar el calculo DDD para determinar los items y sus importes
• Retornar la lista de items con sus precios para la factura

---

RN-005: Integracion obligatoria con ARCA para obtencion del CAE

Descripcion: Toda factura generada por el proceso de facturacion masiva debe ser autorizada por ARCA para obtener el Codigo de Autorizacion Electronica (CAE). Sin el CAE, la factura no se considera valida.

Condicion: Se construye un comprobante para un socio.

Accion:

• Construir el lote de comprobantes segun formato requerido por ARCA
• Enviar el lote a ARCA
• Si ARCA autoriza: registrar la factura con el CAE obtenido
• Si ARCA rechaza: reportar el error al usuario y no registrar la factura

---

RN-006: Registro en modulo de Ventas

Descripcion: Toda factura autorizada por ARCA debe ser registrada en el modulo de Ventas del sistema, integrando la facturacion de membresias con el flujo general de ventas y cuenta corriente.

Condicion: Una factura obtiene su CAE de ARCA exitosamente.

Accion:

• Registrar la factura como comprobante de venta
• Incluir todos los datos fiscales (CAE, numero, fecha, tipo)
• Incluir todos los items con sus precios
• Generar el movimiento de cuenta corriente correspondiente

---

RN-007: Re-facturacion en dos fases

Descripcion: El proceso de re-facturacion se ejecuta en dos fases secuenciales: primero anula las facturas existentes mediante Notas de Credito y luego genera nuevas facturas con datos actualizados.

Condicion: El usuario solicita re-facturar un periodo para un rango de socios.

Accion:

• Fase 1 - Anulacion: Para cada socio con factura existente en el periodo:
  • Generar una Nota de Credito que anule la factura original
  • Enviar la NC a ARCA para obtener su CAE
  • Registrar la NC en el modulo de Ventas
• Fase 2 - Nueva facturacion: Para cada socio del rango:
  • Recalcular la deuda con datos actualizados
  • Generar nueva factura con los importes corregidos
  • Enviar la factura a ARCA para obtener su CAE
  • Registrar la factura en el modulo de Ventas
• Ambas fases se ejecutan de forma secuencial (primero todas las NCs, luego todas las facturas)

---

RN-008: Socios sin deuda se omiten

Descripcion: Si al calcular la deuda de un socio el resultado es cero o no hay conceptos a facturar, el socio se omite del proceso de facturacion sin generar error.

Condicion: El calculo de deuda de un socio resulta en cero items o importe cero.

Accion:

• Omitir al socio del proceso de facturacion
• Reportar al socio con estado "Omitido" en los resultados
• Continuar con el siguiente socio del rango

---

Casos de Uso

CU-001: Facturacion masiva exitosa de un periodo

Actor: Usuario Administrador de Membresias

Objetivo: Generar las facturas mensuales para todos los socios activos de un rango

Precondiciones:

• Usuario autenticado con permiso de facturacion masiva de membresias
• Socios del rango con datos completos (categoria, condicion IVA)
• Servicio ARCA disponible
• Periodo aun no facturado para los socios del rango

Flujo principal:

1. El usuario accede a la vista de facturacion por lotes del modulo de membresias
2. El usuario ingresa el rango de IDs de socios (ejemplo: 1 a 500)
3. El usuario selecciona el periodo (ejemplo: enero 2026)
4. El usuario confirma la ejecucion
5. El sistema obtiene los socios del rango indicado
6. El sistema agrupa los socios por grupos familiares
7. El sistema enriquece los datos de cada socio/grupo (categoria, disciplinas, productos)
8. El sistema calcula la deuda de cada socio/grupo para el periodo
9. El sistema determina el tipo de comprobante segun la condicion IVA de cada cliente
10. El sistema construye los lotes de comprobantes para ARCA
11. El sistema envia los lotes a ARCA y obtiene los CAE correspondientes
12. El sistema registra cada factura autorizada en el modulo de Ventas
13. El sistema presenta el modal de resultados con estadisticas y detalle por socio

Postcondiciones:

• Cada socio/grupo con deuda tiene una factura registrada con CAE valido
• Las facturas estan registradas en el modulo de Ventas con condicion Cuenta Corriente a 30 dias
• Los movimientos de cuenta corriente estan generados
• El usuario puede consultar el detalle de la facturacion realizada

Flujos alternativos:

• Socio sin deuda: El socio se omite y se reporta como "Omitido" en los resultados
• Socio inactivo: El socio se omite y se reporta como "Omitido"
• Rechazo de ARCA: El socio se reporta con estado "Error" y el mensaje de error de ARCA
• Error de calculo: El socio se reporta con estado "Error" y la descripcion del problema

---

CU-002: Re-facturacion por cambio de precios

Actor: Usuario Administrador de Membresias

Objetivo: Corregir la facturacion de un periodo porque se actualizaron los precios de las categorias despues de haber facturado

Precondiciones:

• Usuario autenticado con permiso de re-facturacion de membresias
• El periodo ya fue facturado previamente para los socios del rango
• Los precios de las categorias fueron actualizados en el sistema
• Servicio ARCA disponible

Flujo principal:

1. El usuario accede a la vista de facturacion por lotes
2. El usuario ingresa el rango de IDs de socios afectados
3. El usuario selecciona el periodo a re-facturar
4. El usuario activa la opcion de re-facturacion
5. El usuario confirma la ejecucion
6. Fase 1: El sistema identifica las facturas existentes del periodo para cada socio
7. El sistema genera una Nota de Credito por cada factura existente
8. El sistema envia las NCs a ARCA y obtiene sus CAE
9. El sistema registra las NCs en el modulo de Ventas
10. Fase 2: El sistema recalcula la deuda con los precios actualizados
11. El sistema genera nuevas facturas con los importes corregidos
12. El sistema envia las nuevas facturas a ARCA y obtiene sus CAE
13. El sistema registra las nuevas facturas en el modulo de Ventas
14. El sistema presenta el modal de resultados con el detalle de NCs y nuevas facturas

Postcondiciones:

• Las facturas originales estan anuladas mediante Notas de Credito
• Nuevas facturas con precios actualizados estan registradas con CAE valido
• Los movimientos de cuenta corriente reflejan las NCs y las nuevas facturas
• El historial contable mantiene trazabilidad completa (factura original, NC, nueva factura)

Flujos alternativos:

• Socio sin factura previa: Se omite de la Fase 1 (no hay NC que generar) pero se incluye en la Fase 2
• Error ARCA en NC: Se reporta el error y el socio no continua a la Fase 2 para ese comprobante
• Error ARCA en nueva factura: Se reporta el error; la NC ya emitida queda registrada

---

CU-003: Consulta de resultados de facturacion

Actor: Usuario Administrador de Membresias

Objetivo: Revisar el resultado de una facturacion masiva recien ejecutada para identificar socios con errores

Precondiciones:

• Se acaba de ejecutar un proceso de facturacion masiva o re-facturacion
• El modal de resultados se muestra automaticamente

Flujo principal:

1. El sistema presenta el modal de resultados al finalizar la facturacion
2. El usuario revisa las estadisticas generales (total procesados, exitosos, errores, omitidos)
3. El usuario identifica que hay socios con estado "Error"
4. El usuario consulta el detalle de cada socio con error
5. El usuario observa el mensaje de error ARCA para cada caso
6. El usuario toma nota de los socios que requieren correccion de datos
7. El usuario cierra el modal de resultados

Postcondiciones:

• El usuario conoce el resultado completo de la facturacion
• El usuario identifica los socios que requieren atencion
• El usuario puede planificar las acciones correctivas necesarias

Flujos alternativos:

• Todos exitosos: El usuario verifica que no hay errores y cierra el modal
• Todos con error: El usuario identifica un problema sistematico y consulta con soporte

---

Consideraciones

Seguridad

Control de acceso:

• Solo usuarios con permisos especificos pueden ejecutar la facturacion masiva
• La re-facturacion requiere un permiso adicional independiente
• Las facturas generadas quedan asociadas al usuario que ejecuto el proceso

Datos sensibles:

• Las facturas contienen datos fiscales del cliente (CUIT, condicion IVA)
• Los importes facturados son informacion financiera sensible
• El CAE es un dato fiscal emitido por el organismo de recaudacion

Integridad:

• El proceso debe garantizar que cada factura autorizada por ARCA se registre en el modulo de Ventas
• En caso de error parcial, las facturas ya autorizadas deben quedar registradas

Auditoria

Operaciones a registrar:

Operacion	Informacion a capturar
Ejecucion de facturacion masiva	Usuario, fecha, rango de socios, periodo, cantidad de facturas generadas
Factura generada	Socio, tipo comprobante, numero, CAE, importe total
Ejecucion de re-facturacion	Usuario, fecha, rango de socios, periodo, cantidad de NCs y facturas generadas
Nota de Credito generada	Socio, tipo comprobante, numero, CAE, factura anulada, importe
Error de facturacion	Socio, tipo de error, mensaje ARCA si aplica

Trazabilidad:

• Desde cualquier factura de membresia debe poder identificarse el proceso de facturacion masiva que la genero
• En caso de re-facturacion, debe poder rastrearse la cadena: factura original, NC de anulacion, nueva factura
• Los comprobantes registrados en Ventas mantienen la trazabilidad fiscal con ARCA

Rendimiento

Volumenes esperados:

• Rango tipico de facturacion: entre 100 y 1000 socios por ejecucion
• Cada ejecucion puede generar cientos de comprobantes
• La comunicacion con ARCA se realiza en lotes para optimizar el tiempo

Tiempos esperados:

• El proceso de facturacion puede demorar varios minutos dependiendo del volumen
• La comunicacion con ARCA es el componente que mas tiempo consume
• El usuario debe estar informado del progreso durante la ejecucion

---

Dependencias

Funcionalidades relacionadas

• Gestion de Socios: Maestro de socios con datos personales, categoria, disciplinas y grupo familiar
• Categorias de Membresia: Configuracion de categorias que determinan los conceptos a facturar
• Disciplinas: Catalogo de disciplinas que pueden agregar items a la factura
• Grupos Familiares: Gestion de agrupaciones familiares con titular asignado
• Modulo de Ventas: Registro de comprobantes de venta donde se almacenan las facturas generadas
• Cuenta Corriente: Modulo que gestiona los movimientos de cuenta corriente generados por las facturas

Servicios externos

• ARCA (Organismo Fiscal): Servicio de facturacion electronica para la autorizacion de comprobantes y obtencion del CAE. Es obligatorio para la validez fiscal de las facturas emitidas

---

Criterios de Aceptacion

La funcionalidad se considera completa cuando:

Facturacion masiva

• [x] AC-001: El usuario puede ingresar un rango de IDs de socios y un periodo para ejecutar la facturacion
• [x] AC-002: El sistema agrupa automaticamente los socios por grupos familiares, facturando al titular
• [x] AC-003: El sistema calcula la deuda de cada socio/grupo utilizando el mecanismo DDD, considerando categoria, disciplinas y productos
• [x] AC-004: El sistema determina el tipo de comprobante (A, B o C) segun la condicion IVA del cliente
• [x] AC-005: El sistema envia los comprobantes a ARCA y obtiene el CAE para cada factura autorizada
• [x] AC-006: Las facturas autorizadas se registran en el modulo de Ventas con condicion Cuenta Corriente a 30 dias
• [x] AC-007: Los socios sin deuda o inactivos se omiten del proceso sin generar error

Visualizacion de resultados

• [x] AC-008: Al finalizar la facturacion, se muestra un modal con los resultados detallados
• [x] AC-009: El modal presenta estadisticas agregadas: total procesados, exitosos, errores y omitidos
• [x] AC-010: Para cada socio se muestra el estado (Exitoso/Error/Omitido) con detalle del comprobante o error
• [x] AC-011: Para socios exitosos se muestra: tipo y numero de comprobante, CAE, fecha, items facturados con precios
• [x] AC-012: Para socios con error se muestra el mensaje de error de ARCA si aplica

Re-facturacion

• [x] AC-013: El usuario puede activar la opcion de re-facturacion al ejecutar el proceso
• [x] AC-014: En Fase 1, el sistema genera Notas de Credito para anular las facturas existentes del periodo
• [x] AC-015: Las Notas de Credito son autorizadas por ARCA y registradas en el modulo de Ventas
• [x] AC-016: En Fase 2, el sistema genera nuevas facturas con datos actualizados
• [x] AC-017: Las nuevas facturas son autorizadas por ARCA y registradas en el modulo de Ventas
• [x] AC-018: El resultado de la re-facturacion muestra el detalle de NCs y nuevas facturas generadas

---

Notas Adicionales

Consideraciones sobre grupos familiares

El proceso de agrupacion familiar maneja dos proveedores de agrupacion:

• Agrupacion real: Grupos familiares formalmente constituidos en el sistema, donde el titular esta claramente definido
• Agrupacion simbolica: Relaciones entre socios que se agrupan segun reglas de negocio especificas

Ambos tipos de agrupacion convergen en el mismo resultado: una unica factura emitida al titular del grupo.

Condicion de venta fija

A diferencia de otros procesos de facturacion del sistema donde el usuario puede seleccionar la condicion de venta, en la facturacion de membresias la condicion es siempre Cuenta Corriente a 30 dias. Esto se debe a la naturaleza del negocio de membresias, donde los socios generan deuda que luego se gestiona a traves de la cuenta corriente.

Re-facturacion y trazabilidad contable

El proceso de re-facturacion no "modifica" las facturas originales. En su lugar, genera Notas de Credito que anulan las facturas existentes y luego emite nuevas facturas. Esto garantiza la trazabilidad contable completa y cumple con las normativas fiscales que requieren que los comprobantes electronicos autorizados por ARCA no sean alterados.

Comunicacion con ARCA en lotes

La comunicacion con ARCA se realiza en lotes (batch) en lugar de comprobante por comprobante. Esto optimiza significativamente el tiempo de procesamiento cuando se facturan grandes volumenes de socios, reduciendo la cantidad de comunicaciones con el servicio fiscal externo.

---

Historial de Cambios

Fecha	Version	Autor	Descripcion
2026-01-27	1.0	Sistema	Creacion del documento - Documentacion de funcionalidad ya implementada en produccion