Documentación del Sistema

Appearance

Conceptos de Notas de Credito y Debito - Resource ​

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

Modulo: Ventas Tipo: Resource Estado: Implementado Fecha: 2026-02-09

Descripcion ​

Los Conceptos de Notas permiten gestionar los motivos o razones por los cuales se emiten notas de credito y notas de debito dentro del modulo de ventas. Cada concepto define una descripcion, un tipo de operacion y opcionalmente una cuenta contable asociada.

Los conceptos se utilizan como catalogo durante la emision de notas de credito/debito en el proceso de facturacion. Al emitir un comprobante de nota, el usuario selecciona el concepto que describe el motivo de la operacion (ej: "Por anulacion de factura", "Por devolucion de mercaderias", "Por intereses pago fuera de termino").

Existe una separacion entre conceptos de nota de credito y conceptos de nota de debito, cada grupo con su propio catalogo independiente.

Frontend (Perspectiva de Usuario) ​

Vistas ​

  • Listado de conceptos de notas: Vista principal con tabla que muestra los conceptos. Incluye un selector de tipo (Nota Credito / Nota Debito) que alterna entre ambos catalogos.
  • Formulario de alta/modificacion: Modal que permite crear un nuevo concepto o editar uno existente.

Interacciones del usuario ​

  • Alternar entre catalogos: El usuario puede cambiar entre "Nota Credito" y "Nota Debito" usando radio buttons.
  • Crear nuevo concepto: Boton "Nva. Concepto de Nota" (atajo Alt+A) abre el formulario modal.
  • Editar concepto existente: Boton de edicion en cada fila de la tabla abre el formulario modal precargado con los datos.
  • Eliminar concepto: Boton de eliminacion en cada fila con confirmacion previa ("No podras revertir esta accion").
  • Exportar datos: Botones de exportacion a Excel y PDF.
  • Busqueda de cuenta contable: Autocompletado que busca cuentas contables por numero o nombre (solo visible si el modulo de contabilidad esta habilitado).

Permisos ​

  • VENTAS_BASES_CONCEPTOS-NOTAS: Permiso que controla el acceso completo al listado, alta y modificaciones de conceptos de notas. La opcion en el sidebar de ventas solo se muestra si el usuario posee este permiso.

Estados de UI ​

  • Carga inicial: Indicador de "Cargando datos" mientras se obtienen ambos catalogos (credito y debito).
  • Registro exitoso: Notificacion toast de exito ("Nota creado con exito").
  • Modificacion exitosa: Notificacion toast de exito ("Nota modificado exitosamente").
  • Eliminacion exitosa: Indicador de "Eliminando Nota" durante el proceso + toast de exito.
  • Error de carga: Toast de error ("Error al cargar los Notas").
  • Error de eliminacion del ultimo registro: Mensaje de error indicando que no se puede eliminar el ultimo concepto.

Backend (Perspectiva de Datos de Negocio) ​

Entidades de negocio ​

  • Concepto de Nota de Credito: Concepto que describe el motivo de emision de una nota de credito.
  • Concepto de Nota de Debito: Concepto que describe el motivo de emision de una nota de debito.

Ambas entidades comparten la misma estructura de datos pero se almacenan de forma independiente.

Datos necesarios ​

Cada concepto de nota contiene:

DatoObligatorioDescripcion
IdentificadorSi (generado)Identificador unico autoincremental
Descripcion (nombre)SiTexto descriptivo del concepto (max 50 caracteres)
Tipo de conceptoSiClasificacion del concepto (max 1 caracter): S=Sin detalle, D=Con articulos, C=Cancelacion
Cuenta contableNoNumero de cuenta contable asociada. Visible solo si el modulo de contabilidad esta habilitado
Fecha de eliminacionNo (sistema)Marca temporal para eliminacion logica (soft delete)

Relaciones de negocio ​

  • Un concepto de nota de credito se asocia a uno o mas comprobantes de nota de credito (campo concep en los comprobantes).
  • Un concepto de nota de debito se asocia a uno o mas comprobantes de nota de debito.
  • Un concepto de nota puede asociarse a una cuenta contable del plan de cuentas.
  • Los conceptos se utilizan en el proceso de generacion de minutas contables (asientos automaticos) para determinar la cuenta contable de imputacion.

Validaciones de negocio ​

  • La descripcion es obligatoria y no puede superar 50 caracteres.
  • El tipo es obligatorio y debe ser un unico caracter.
  • La cuenta contable, si se proporciona, debe ser un numero entero valido.
  • No se puede eliminar el ultimo concepto activo del catalogo. Siempre debe existir al menos un concepto disponible.
  • Para notas de debito, el tipo "Con articulos" (D) no esta disponible.

Reglas de negocio ​

  • Regla 1: Separacion de catalogos por tipo de comprobante

    • Condicion: Al solicitar el listado, se debe indicar el codigo de tipo de comprobante (codigos ARCA).
    • Accion: El sistema retorna los conceptos del catalogo correspondiente (credito si codigo es 3, 8 o 13; debito si codigo es 2, 7 o 12).

  • Regla 2: Restriccion de tipos por tipo de nota

    • Condicion: Al crear/editar un concepto de nota de debito.
    • Accion: El tipo "Con articulos" (D) no esta disponible como opcion.

  • Regla 3: Proteccion del ultimo registro

    • Condicion: Al intentar eliminar un concepto.
    • Accion: Si es el ultimo concepto activo (no eliminado) del catalogo, la operacion se rechaza con mensaje de error.

  • Regla 4: Integracion con contabilidad condicional

    • Condicion: Si la empresa tiene habilitado el modulo de contabilidad.
    • Accion: Se muestra y permite asignar cuenta contable a cada concepto. En el listado, se enriquece cada concepto con los datos de la cuenta (numero y nombre).

  • Regla 5: Concepto de anulacion por defecto

    • Condicion: En procesos automaticos de anulacion de comprobantes.
    • Accion: El sistema busca automaticamente un concepto de nota de credito cuya descripcion contenga "anulacion". Si no lo encuentra, usa el primer concepto activo disponible. Si no hay ninguno, el proceso falla con error.

  • Regla 6: Eliminacion logica (soft delete)

    • Condicion: Al eliminar un concepto.
    • Accion: El registro no se borra fisicamente, se marca con fecha de eliminacion. Los conceptos eliminados no aparecen en listados ni estan disponibles para seleccion.

Casos de uso ​

Caso 1: Crear un nuevo concepto de nota ​

Actor: Usuario con permiso VENTAS_BASES_CONCEPTOS-NOTAS

Precondiciones:

  • El usuario esta autenticado y tiene el permiso correspondiente.
  • El usuario se encuentra en la vista de Conceptos de Notas.

Flujo principal:

  1. El usuario selecciona el tipo de catalogo (Nota Credito o Nota Debito).
  2. El usuario presiona "Nva. Concepto de Nota" (o Alt+A).
  3. Se abre el formulario modal con los campos vacios.
  4. El usuario ingresa la descripcion del concepto.
  5. El usuario selecciona el tipo de concepto (Sin detalle, Con articulos, Cancelacion).
  6. Opcionalmente, si el modulo de contabilidad esta habilitado, busca y selecciona una cuenta contable.
  7. El usuario presiona "Aceptar".
  8. El sistema valida los datos y crea el concepto.
  9. El nuevo concepto aparece en la tabla.

Postcondiciones:

  • El concepto queda registrado y disponible para su uso en emision de comprobantes.

Flujos alternativos:

  • Datos invalidos: Si la descripcion esta vacia o el tipo no es valido, el formulario no permite el envio.
  • Cancelacion: El usuario puede cerrar el modal sin guardar cambios.

Caso 2: Modificar un concepto existente ​

Actor: Usuario con permiso VENTAS_BASES_CONCEPTOS-NOTAS

Precondiciones:

  • Existe al menos un concepto en el catalogo seleccionado.

Flujo principal:

  1. El usuario selecciona el catalogo (credito o debito).
  2. Localiza el concepto a modificar en la tabla.
  3. Presiona el boton de edicion de la fila.
  4. Se abre el formulario modal precargado con los datos actuales.
  5. El usuario modifica los campos deseados.
  6. Presiona "Aceptar".
  7. El sistema actualiza el concepto.

Postcondiciones:

  • Los cambios se reflejan en la tabla y en futuros usos del concepto.

Caso 3: Eliminar un concepto ​

Actor: Usuario con permiso VENTAS_BASES_CONCEPTOS-NOTAS

Precondiciones:

  • Debe haber mas de un concepto activo en el catalogo seleccionado.

Flujo principal:

  1. El usuario localiza el concepto a eliminar.
  2. Presiona el boton de eliminacion.
  3. Se muestra confirmacion: "No podras revertir esta accion".
  4. El usuario confirma.
  5. El sistema realiza la eliminacion logica.
  6. El concepto desaparece de la tabla.

Postcondiciones:

  • El concepto queda marcado como eliminado y no aparece en listados futuros.

Flujos alternativos:

  • Ultimo concepto: Si es el unico concepto activo, se muestra error y no se permite la eliminacion.
  • Cancelacion: El usuario cancela la confirmacion y no se elimina nada.

Consideraciones ​

Seguridad ​

  • El acceso esta protegido por el permiso VENTAS_BASES_CONCEPTOS-NOTAS.
  • Solo usuarios autenticados con JWT valido pueden operar.

Auditoria ​

  • [REQUIERE VALIDACION] Actualmente no se detecta audit logging para las operaciones CUD de este recurso.

Rendimiento ​

  • El catalogo de conceptos es tipicamente pequeno (10-20 registros por tipo). Ambos catalogos se cargan al iniciar la vista.

Dependencias ​

Funcionalidades relacionadas ​

  • Facturacion de Ventas: Los conceptos se seleccionan al crear notas de credito/debito. El campo concep en los comprobantes referencia al concepto utilizado.
  • Minutas Contables: Los conceptos determinan la cuenta contable para la generacion automatica de asientos.
  • Plan de Cuentas (Contabilidad): Los conceptos pueden asociarse a cuentas contables del plan de cuentas.
  • Anulacion de comprobantes: El proceso de anulacion automatica busca un concepto de credito con descripcion "anulacion".

Servicios externos ​

  • No se identificaron integraciones con servicios externos.

Criterios de aceptacion ​

  • [x] AC-001: El usuario puede ver el listado de conceptos de nota de credito y nota de debito alternando entre ambos catalogos.
  • [x] AC-002: El usuario puede crear un nuevo concepto con descripcion obligatoria y tipo obligatorio.
  • [x] AC-003: El usuario puede editar un concepto existente y los cambios se reflejan inmediatamente.
  • [x] AC-004: El usuario puede eliminar un concepto con confirmacion previa, siempre que no sea el ultimo.
  • [x] AC-005: Si el modulo de contabilidad esta habilitado, se muestra y permite asignar cuenta contable.
  • [x] AC-006: Para notas de debito, la opcion "Con articulos" no esta disponible.
  • [x] AC-007: El sistema impide eliminar el ultimo concepto activo del catalogo.

Preguntas Pendientes ​

Informacion Faltante: Hay preguntas sobre esta funcionalidad que requieren validacion. Ver: Preguntas sobre Conceptos de Notas

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.