Documentación del Sistema

Appearance

Tipos de Documento (ARCA) ​

Módulo: General
Tipo: Resource
Estado: Implementado
Fecha: 2026-03-26

Descripción ​

tipo_documento es el catálogo oficial de tipos de documento de identificación de personas físicas y jurídicas, definido por ARCA (ex-AFIP). Provee los códigos estandarizados que el sistema utiliza para registrar y validar la identificación fiscal de proveedores, clientes y cualquier entidad con relación fiscal.

Valor para el negocio:

  • Garantiza que los tipos de documento utilizados en operaciones fiscales estén alineados con la normativa vigente de ARCA.
  • Evita la creación de códigos arbitrarios que podrían invalidar declaraciones juradas o comprobantes ante organismos de control.
  • Permite que múltiples módulos (Compras, CRM, etc.) compartan un catálogo único y centralizado, sin duplicar definiciones.

Contexto:

  • Los códigos son fijos y provienen de la tabla oficial de ARCA. El sistema no los genera ni los modifica.
  • Este catálogo es obligatorio en cualquier operación que requiera identificar a una persona ante ARCA: SICORE, declaraciones juradas, retenciones, percepciones, y registros de proveedores y clientes.
  • La tabla es compartida por toda la empresa (no varía por sucursal).

Catálogo de Tipos de Documento ​

Los 12 tipos de documento reconocidos por ARCA (todos con código >= 80):

CódigoDescripciónActivo por defecto
80CUITSí
86CUILSí
87CDINo
89LIBRETA DE ENROLAMIENTONo
90LIBRETA CIVICANo
91CI EXTRANJERANo
92EN TRAMITENo
93ACTA DE NACIMIENTONo
94PASAPORTESí
95BS AS RNPNo
96DOCUMENTO NACIONAL DE IDENTIDADSí
99SIN IDENTIFICAR / VENTA GLOBAL DIARIANo (sentinel)

Activos por defecto (4 tipos): CUIT (80), CUIL (86), PASAPORTE (94), DNI (96).

El código 99 es un valor especial de uso interno. Ver sección Valor Sentinel.

Reglas de Negocio ​

RN-001: Catálogo cerrado — sin altas ni bajas

  • Los tipos de documento son definidos por ARCA. El sistema no permite crear nuevos tipos ni eliminar los existentes.
  • Las operaciones de alta (POST) y baja (DELETE) no están disponibles.

RN-002: Código oficial ARCA

  • El código de cada tipo de documento es el código oficial de ARCA. No es generado por el sistema.
  • No se permite modificar el código ni la descripción de ningún tipo.

RN-003: Control de visibilidad mediante activo

  • El campo activo controla si un tipo aparece disponible para selección en formularios.
  • Desactivar un tipo no lo elimina del sistema; sólo lo oculta en los selectores de alta/edición.
  • El único dato que puede modificarse por operación de gestión es el estado activo/inactivo.

RN-004: Filtrado por módulos consumidores

  • Todos los módulos que presenten un selector de tipo de documento (proveedores, clientes, etc.) deben filtrar por activo = verdadero para mostrar únicamente los tipos habilitados.
  • La lista completa (incluyendo inactivos) está disponible sólo para consultas administrativas.

RN-005: Obligatoriedad en operaciones fiscales

  • El tipo de documento es un dato obligatorio al registrar entidades con relación fiscal ante ARCA: proveedores (SICORE), clientes, declaraciones juradas, retenciones y percepciones.

Valor Sentinel: Código 99 ​

El código 99 ("SIN IDENTIFICAR / VENTA GLOBAL DIARIA") es un valor especial de fallback para situaciones donde una entidad no tiene tipo de documento asignado.

Comportamiento:

  • El código 99 está presente en el catálogo pero se mantiene inactivo (activo = falso) por defecto.
  • No aparece en los selectores de formulario durante alta o edición de entidades.
  • Los módulos que necesitan manejar proveedores o clientes sin tipo de documento asignado usan 99 como valor por defecto interno (fallback), nunca como selección explícita del usuario.

Quién lo aplica:

  • La lógica del fallback la implementa cada módulo consumidor (ej.: Compras al registrar un proveedor), no el catálogo en sí.

Operaciones Disponibles ​

Consultar lista de tipos de documento ​

Devuelve el catálogo completo de tipos de documento.

  • Filtro opcional por estado activo: se puede solicitar únicamente los tipos habilitados (útil para poblar selectores en formularios).
  • El resultado se entrega ordenado por código de forma ascendente.

Consultar tipo de documento por código ​

Devuelve un tipo de documento específico dado su código ARCA.

  • Si el código no existe en el catálogo, se informa que no fue encontrado.
  • Funciona para cualquier código, incluyendo inactivos y el sentinel 99.

Habilitar o deshabilitar un tipo de documento ​

Permite cambiar el estado activo/inactivo de un tipo de documento.

  • Solo se puede modificar el estado (activo). Cualquier intento de modificar código o descripción es rechazado.
  • Si el código no existe, se informa que no fue encontrado.

Restricciones ​

OperaciónPermitidaMotivo
Consultar listaSíAcceso de referencia para todos los módulos
Consultar por códigoSíAcceso unitario para validaciones
Habilitar/deshabilitarSíGestión de visibilidad en formularios
Crear nuevo tipoNoTabla cerrada — los códigos los define ARCA
Modificar descripciónNoLos datos son de normativa ARCA, no editables
Eliminar tipoNoNo se borra información fiscal de referencia

Casos de Uso ​

UC-001: Consultar tipos activos para un selector ​

Actor: Módulo consumidor (ej.: Compras al dar de alta un proveedor)

Precondiciones:

  • El catálogo tiene al menos un tipo con estado activo.

Flujo principal:

  1. El módulo solicita la lista de tipos de documento filtrando por activos.
  2. El sistema devuelve los tipos habilitados ordenados por código.
  3. El módulo presenta las opciones al usuario para que seleccione.
  4. El usuario elige el tipo de documento correspondiente a la entidad.

Postcondiciones:

  • El usuario seleccionó un tipo de documento válido y habilitado.

UC-002: Deshabilitar un tipo de documento poco usado ​

Actor: Administrador del sistema

Precondiciones:

  • El tipo de documento existe en el catálogo.
  • El tipo está actualmente habilitado.

Flujo principal:

  1. El administrador consulta el listado completo de tipos (incluyendo inactivos).
  2. El administrador identifica el tipo a deshabilitar (ej.: "LIBRETA DE ENROLAMIENTO").
  3. El administrador solicita deshabilitar ese tipo.
  4. El sistema actualiza el estado a inactivo.
  5. El tipo deja de aparecer en los selectores de formularios.

Flujos alternativos:

  • 3a. Si el código no existe → el sistema informa que no fue encontrado.

Postcondiciones:

  • El tipo queda inactivo y no aparece en formularios de alta/edición.
  • El tipo sigue existiendo en el catálogo; puede volver a habilitarse en cualquier momento.

UC-003: Registrar entidad sin tipo de documento conocido ​

Actor: Módulo consumidor (ej.: Compras al importar proveedores sin datos completos)

Precondiciones:

  • La entidad no tiene tipo de documento asignado.

Flujo principal:

  1. El módulo detecta que la entidad no tiene tipo de documento.
  2. El módulo asigna internamente el código 99 ("SIN IDENTIFICAR") como valor de fallback.
  3. La entidad queda registrada con código 99, que no se muestra en selectores al usuario final.
  4. El administrador puede actualizar luego el tipo de documento real de la entidad.

Postcondiciones:

  • La entidad queda registrada sin bloquear el flujo, utilizando el fallback 99.

Criterios de Aceptación ​

  • [ ] El catálogo contiene los 12 tipos de documento oficiales ARCA con sus códigos correctos.
  • [ ] Los tipos CUIT (80), CUIL (86), PASAPORTE (94) y DNI (96) están activos por defecto; el resto inactivos.
  • [ ] Los selectores de formulario en módulos consumidores muestran únicamente los tipos con estado activo.
  • [ ] El código 99 no aparece como opción seleccionable en formularios de alta/edición.
  • [ ] Un administrador puede habilitar o deshabilitar cualquier tipo de documento.
  • [ ] No es posible crear nuevos tipos de documento a través del sistema.
  • [ ] No es posible modificar el código ni la descripción de un tipo existente.
  • [ ] No es posible eliminar un tipo de documento del catálogo.
  • [ ] Cualquier módulo puede consultar la lista completa o filtrada por estado activo.
  • [ ] Consultar un código inexistente informa claramente que no existe.

Dependencias ​

Módulos consumidores ​

  • Compras / Proveedores: usa el catálogo para registrar el tipo de documento del proveedor. El valor fallback 99 se aplica aquí cuando no hay tipo conocido.
  • CRM / Clientes: usa el catálogo para registrar el tipo de documento de personas físicas y jurídicas.
  • Cualquier módulo con operaciones SICORE: el tipo de documento es requerido para retenciones y percepciones.

Servicios externos ​

  • ARCA (ex-AFIP): fuente de verdad de los códigos. Los datos del catálogo reflejan la tabla oficial y no deben alterarse arbitrariamente.

Dependencias de datos ​

  • Debe existir el catálogo cargado antes de que módulos como Compras o CRM puedan requerir tipo de documento en sus formularios.

Notas Adicionales ​

  • El catálogo se carga una sola vez durante la inicialización de la base de datos. Si el catálogo ya tiene datos, la carga se omite automáticamente para evitar duplicados.
  • ARCA podría en el futuro agregar nuevos códigos. En ese caso, la incorporación se realiza mediante una migración de datos controlada por el equipo técnico, no a través de operaciones de usuario.
  • El código 99 existe en ARCA con el nombre "SIN IDENTIFICAR / VENTA GLOBAL DIARIA" y se utiliza también en contextos de venta global diaria (sin identificación del comprador). En Sistema Bautista se lo usa únicamente como fallback interno.