Documentación del Sistema

Appearance

Referencias Contables - Resource ​

DOCUMENTACION RETROSPECTIVA - Generada a partir de codigo implementado el 2026-02-09

Modulo: Ventas Tipo: Resource Estado: Implementado Fecha: 2026-02-09 URL: ?loc=mvrc

Descripcion General ​

Las Referencias Contables son un recurso de mantenimiento del modulo de Ventas que permite clasificar los articulos/productos segun su naturaleza contable. Cada referencia contable vincula un codigo y denominacion con cuentas contables especificas del plan de cuentas, tanto para imputacion de ventas como de compras.

Su proposito principal es automatizar la imputacion contable durante la facturacion: cuando se vende o compra un producto, el sistema determina automaticamente a que cuenta contable debe imputarse la operacion segun la referencia contable asignada al producto.

Frontend (Perspectiva de Usuario) ​

Vistas ​

  1. Listado de referencias contables: Vista principal con tabla que muestra todas las referencias registradas. Incluye columnas de codigo, nombre, imputacion de ventas e imputacion de compras. Permite exportar a Excel y PDF.

  2. Formulario de alta/modificacion: Modal que se abre para crear o editar una referencia contable. Contiene campos para codigo, denominacion, imputacion de ventas e imputacion de compras.

Interacciones del usuario ​

  • Crear nueva referencia contable: Mediante boton "Nva. Ref. Cont." o atajo de teclado Alt+A, se abre el formulario modal en modo alta.
  • Modificar referencia contable: Mediante boton de edicion en la columna de acciones de la tabla.
  • Buscar cuenta contable: Los campos de imputacion utilizan autocompletado que busca cuentas contables por numero o nombre (solo cuentas con saldo propio).
  • Exportar datos: Botones de exportacion a Excel y PDF disponibles en la tabla.

Permisos ​

  • VENTAS_BASES_REF-CONT (id=15): Acceso al listado, alta y modificaciones de referencias contables. Es un permiso de nivel 3 que depende del permiso padre VENTAS_BASES (id=2).
  • modulo_compras: Condiciona la habilitacion del campo de imputacion de compras. Si el usuario no tiene acceso al modulo de compras, el campo se deshabilita.

Estados de UI ​

  • Carga inicial: La tabla se carga automaticamente al ingresar a la vista con scope completo (incluyendo datos de cuentas contables).
  • Carga exitosa - tabla con datos: Muestra la tabla con las referencias registradas.
  • Carga exitosa - tabla vacia: Tabla sin filas.
  • Registro exitoso: Notificacion toast de exito ("Referencia contable creada").
  • Modificacion exitosa: Notificacion toast de exito ("Referencia modificada exitosamente").
  • Error de duplicado: Si se intenta crear una referencia con un codigo ya existente, se muestra error.
  • Indicador de carga: Popup de "Registrando cambios" durante operaciones de guardado.
  • Autocompletado: Busqueda en tiempo real de cuentas contables con formato "numero | nombre".

Backend (Perspectiva de Datos de Negocio) ​

Entidades de negocio ​

Referencia Contable: Clasificacion contable que vincula un codigo alfanumerico con cuentas del plan de cuentas.

Datos necesarios ​

DatoDescripcionObligatorio
CodigoCodigo alfanumerico de identificacion, hasta 3 caracteres. Se convierte automaticamente a mayusculas.Si
Denominacion (Nombre)Nombre descriptivo de la referencia, hasta 20 caracteres.Si
Imputacion de VentasCuenta contable del plan de cuentas para imputacion en operaciones de venta.Si
Imputacion de ComprasCuenta contable del plan de cuentas para imputacion en operaciones de compra.Condicional (solo si modulo compras esta habilitado)

Relaciones de negocio ​

  • Referencia Contable -> Cuentas Contables: Cada referencia se vincula con hasta dos cuentas del plan de cuentas (una para ventas, una para compras).
  • Producto -> Referencia Contable: Cada producto tiene asignada una referencia contable (mediante el codigo). Al crear una referencia por primera vez, los productos sin referencia se actualizan automaticamente.
  • Referencia Contable -> Facturacion: Durante la facturacion de ventas y compras, la referencia contable del producto determina la cuenta contable de imputacion.

Validaciones de negocio ​

  • El codigo debe ser unico entre todas las referencias contables.
  • El codigo tiene un maximo de 3 caracteres alfanumericos.
  • El nombre tiene un maximo de 20 caracteres.
  • Las cuentas contables seleccionadas deben ser cuentas con saldo propio (cuentas analiticas, no de agrupacion).

Reglas de negocio ​

  • Regla 1: Unicidad de codigo

    • Condicion: Al crear o modificar una referencia contable.
    • Accion: El sistema verifica que no exista otra referencia con el mismo codigo. Si existe, rechaza la operacion.

  • Regla 2: Imputacion de compras condicional

    • Condicion: El campo de imputacion de compras solo se habilita si el usuario tiene permiso del modulo de compras.
    • Accion: Si el modulo de compras no esta habilitado, el campo se deshabilita en el formulario.

  • Regla 3: Cuentas contables con saldo propio

    • Condicion: Al seleccionar cuentas contables para imputacion.
    • Accion: Solo se muestran cuentas contables que tienen saldo propio (cuentas analiticas), no cuentas de agrupacion.

  • Regla 4: Asignacion automatica a productos (seed)

    • Condicion: Al crear la primera referencia contable en el sistema.
    • Accion: Todos los productos que no tengan referencia contable asignada reciben automaticamente la primera referencia disponible.

  • Regla 5: Referencia por defecto "GEN"

    • Condicion: Instalacion inicial del sistema.
    • Accion: Se crea automaticamente una referencia "GEN" (General) con cuenta contable 41150 para ventas y compras.

  • Regla 6: Conversion a mayusculas

    • Condicion: Al ingresar el codigo en el formulario.
    • Accion: El codigo se convierte automaticamente a mayusculas.

Casos de uso ​

Caso 1: Crear nueva referencia contable ​

Actor: Usuario con permiso VENTAS_BASES_REF-CONT

Precondiciones:

  • El usuario debe estar autenticado y tener permiso de acceso a referencias contables.
  • Debe existir al menos una cuenta contable con saldo propio en el plan de cuentas.

Flujo principal:

  1. El usuario accede al listado de referencias contables.
  2. El usuario hace clic en "Nva. Ref. Cont." o presiona Alt+A.
  3. Se abre el formulario modal con titulo "Nueva referencia contable".
  4. El usuario ingresa el codigo (se convierte a mayusculas automaticamente).
  5. El usuario ingresa la denominacion.
  6. El usuario busca y selecciona una cuenta contable para imputacion de ventas.
  7. Si tiene permiso de compras, busca y selecciona una cuenta contable para imputacion de compras.
  8. El usuario hace clic en "Aceptar".
  9. El sistema valida unicidad del codigo.
  10. El sistema registra la nueva referencia contable.
  11. Se muestra notificacion de exito y la nueva fila aparece en la tabla.

Postcondiciones:

  • La referencia contable queda registrada y disponible para asignar a productos.

Flujos alternativos:

  • Codigo duplicado: El sistema muestra error "Ya existe una referencia contable con ese codigo."
  • Campos vacios: El formulario impide el envio si faltan campos obligatorios.

Caso 2: Modificar referencia contable existente ​

Actor: Usuario con permiso VENTAS_BASES_REF-CONT

Precondiciones:

  • Debe existir al menos una referencia contable registrada.

Flujo principal:

  1. El usuario visualiza el listado de referencias contables.
  2. El usuario hace clic en el boton de edicion de la referencia deseada.
  3. Se abre el formulario modal con titulo "Modificacion de referencia contable" con los datos precargados.
  4. El usuario modifica los campos deseados.
  5. El usuario hace clic en "Aceptar".
  6. El sistema valida que el nuevo codigo no entre en conflicto con otra referencia.
  7. El sistema actualiza la referencia contable.
  8. Se muestra notificacion de exito y la fila se actualiza en la tabla.

Postcondiciones:

  • La referencia contable queda actualizada.
  • [REQUIERE VALIDACION] No esta claro si al cambiar el codigo de una referencia ya asignada a productos se actualiza la relacion automaticamente, ya que productos referencian por codigo (no por ID).

Caso 3: Uso en facturacion (contabilizacion automatica) ​

Actor: Sistema (proceso automatico durante facturacion)

Precondiciones:

  • El producto facturado debe tener una referencia contable asignada.

Flujo principal:

  1. Durante una operacion de venta, el sistema obtiene el producto.
  2. El sistema lee la referencia contable asignada al producto.
  3. De la referencia contable, obtiene la cuenta de imputacion de ventas.
  4. El sistema usa esa cuenta para la contabilizacion automatica del comprobante.

Postcondiciones:

  • La operacion de venta queda imputada a la cuenta contable correcta.

Consideraciones ​

Seguridad ​

  • El acceso esta protegido por autenticacion JWT.
  • El permiso especifico VENTAS_BASES_REF-CONT controla el acceso al recurso.
  • El campo de imputacion de compras esta condicionado por el permiso del modulo de compras.

Auditoria ​

  • [REQUIERE VALIDACION] No se detecta implementacion de auditoria para operaciones de creacion y modificacion de referencias contables. Los cambios no quedan registrados en el log de auditoria del sistema.

Rendimiento ​

  • El listado carga todas las referencias en una sola consulta.
  • En modo scope=max, se realizan consultas adicionales por cada referencia para obtener los datos de las cuentas contables (potencial N+1).
  • El autocompletado de cuentas contables limita los resultados para mantener la performance.

Dependencias ​

Funcionalidades relacionadas ​

  • Plan de Cuentas (Contabilidad): Provee las cuentas contables disponibles para imputacion.
  • Articulos/Productos (Ventas): Cada producto tiene una referencia contable asignada que determina su imputacion.
  • Facturacion Electronica (Ventas): Utiliza la referencia contable del producto para la contabilizacion automatica.
  • Comprobantes de Compra (Compras): Utiliza la imputacion de compras de la referencia contable para contabilizar compras.
  • Movimiento de Ganancias (CtaCte): Utiliza la imputacion de compras de la referencia para determinar cuentas contables.

Servicios externos ​

  • No se identificaron integraciones con servicios externos.

Criterios de aceptacion ​

  • [x] AC-001: El usuario puede ver un listado de todas las referencias contables con codigo, nombre, cuenta de ventas y cuenta de compras.
  • [x] AC-002: El usuario puede crear una nueva referencia contable con codigo unico de hasta 3 caracteres.
  • [x] AC-003: El usuario puede modificar una referencia contable existente.
  • [x] AC-004: El sistema impide crear referencias con codigos duplicados.
  • [x] AC-005: El autocompletado de cuentas contables solo muestra cuentas con saldo propio.
  • [x] AC-006: El campo de imputacion de compras se deshabilita cuando el usuario no tiene permiso del modulo de compras.
  • [x] AC-007: El codigo se convierte automaticamente a mayusculas.
  • [x] AC-008: Se puede exportar el listado a Excel y PDF.
  • [ ] AC-009: [REQUIERE VALIDACION] Las operaciones de creacion y modificacion quedan registradas en el log de auditoria.

Preguntas Pendientes ​

Informacion Faltante: Hay preguntas sobre esta funcionalidad que requieren validacion. Ver: Preguntas sobre Referencias Contables

Referencias Tecnicas ​

NOTA IMPORTANTE: Esta documentacion fue generada automaticamente analizando el codigo implementado. Se recomienda validar con stakeholders de negocio para confirmar que refleja fielmente los requisitos originales.