Appearance
Puntos de Venta (Múltiples)
Módulo: ventas Tipo: Resource Estado: Planificado Fecha: 2026-03-31
Descripción
Actualmente cada empresa o sucursal puede tener un único punto de venta AFIP/ARCA, configurado directamente en la ficha de la empresa (campo "sucursal"). Esta limitación impide operar con más de un punto de venta habilitado por sucursal o empresa.
Esta funcionalidad incorpora la posibilidad de registrar múltiples puntos de venta por empresa/sucursal, gestionarlos mediante un ABM y seleccionar cuál usar al momento de emitir comprobantes.
Valor para el negocio:
- Permite a empresas y sucursales operar con múltiples puntos de venta habilitados ante AFIP/ARCA sin intervención técnica
- Agiliza la emisión de comprobantes al proponer automáticamente el punto de venta por defecto
- Evita errores de numeración al asociar cada comprobante al punto de venta correcto
- Mantiene compatibilidad total con la configuración actual: si no se registran puntos de venta adicionales, el sistema opera exactamente igual que hoy
Contexto:
- La configuración de punto de venta actual (campo "sucursal" en la ficha de empresa) sigue funcionando para empresas/sucursales que no adopten esta funcionalidad
- Cada empresa y cada sucursal con schema propio gestiona su lista de puntos de venta de forma independiente
- El sistema verifica con ARCA que el punto de venta ingresado esté habilitado antes de permitir su alta
Frontend (Perspectiva de Usuario)
Vistas
- Pantalla de administración de puntos de venta: lista los puntos de venta configurados para la empresa/sucursal activa
- Formulario de alta/edición de punto de venta: permite ingresar nombre, identificador interno y número de punto de venta ARCA
- Indicador de punto de venta por defecto: resalta visualmente cuál es el predeterminado
- Integración en el formulario de facturación: selector de punto de venta al emitir comprobantes
Interacciones del Usuario
En el ABM de puntos de venta:
- Ver la lista de puntos de venta activos con su nombre, número ARCA y si es el predeterminado
- Filtrar la lista para incluir también los puntos de venta deshabilitados
- Dar de alta un nuevo punto de venta indicando nombre, identificador interno y número ARCA
- Al ingresar el número ARCA, el sistema verifica automáticamente si ese punto de venta está habilitado en ARCA; informa el resultado antes de confirmar el alta
- Editar el nombre o identificador interno de un punto de venta existente
- Marcar un punto de venta como predeterminado (solo puede haber uno a la vez; debe estar habilitado)
- Deshabilitar un punto de venta (con confirmación; no se puede deshabilitar el predeterminado si hay otros activos)
- Volver a habilitar un punto de venta deshabilitado
En la emisión de comprobantes (facturación):
- Si la empresa/sucursal tiene múltiples puntos de venta configurados, el formulario de facturación muestra un selector de punto de venta
- El selector propone automáticamente el punto de venta marcado como predeterminado
- El operador puede cambiar la selección antes de confirmar el comprobante
- En modo "Registro Manual" (comprobantes preimpresos), el selector incluye además una opción "Ingresar manualmente" que habilita el campo libre, manteniendo el comportamiento actual
- Si la empresa/sucursal no tiene puntos de venta registrados en la nueva tabla, no aparece ningún selector y el sistema toma el punto de venta de la configuración de la empresa como siempre
Estados de UI
- Indicador de verificación en curso al consultar ARCA durante el alta
- Mensaje de éxito si el punto de venta existe y está habilitado en ARCA
- Mensaje de advertencia si ARCA no reconoce el número ingresado (el operador puede igualmente decidir guardarlo)
- Confirmación visual al cambiar el punto de venta predeterminado
- Mensaje de error si se intenta deshabilitar el predeterminado mientras haya otros activos
- Distinción visual entre puntos de venta habilitados y deshabilitados en la lista filtrada
Backend (Perspectiva de Datos de Negocio)
Entidades de Negocio
- Punto de Venta: Registro de un punto de venta habilitado ante ARCA para una empresa o sucursal. Incluye nombre descriptivo, identificador interno del sistema, número oficial ARCA y si es el predeterminado
Datos Necesarios
- Nombre descriptivo del punto de venta (uso interno, ej: "Caja principal", "Mostrador 2")
- Identificador interno (uso operativo del sistema)
- Número de punto de venta ARCA (equivalente al campo "sucursal" actual, formato numérico)
- Indicador de predeterminado (verdadero/falso)
- Estado (habilitado / deshabilitado)
- Empresa/sucursal a la que pertenece (definido por el contexto del schema activo)
Relaciones de Negocio
- Un punto de venta pertenece a una empresa o sucursal (según el schema activo)
- Una empresa/sucursal puede tener cero, uno o múltiples puntos de venta registrados
- Solo un punto de venta puede ser el predeterminado por empresa/sucursal a la vez
- Los comprobantes emitidos quedan asociados al punto de venta utilizado en su emisión
Validaciones de Negocio
- El número ARCA del punto de venta no puede repetirse dentro de la misma empresa/sucursal, independientemente de su estado (habilitado o deshabilitado)
- Al marcar un punto de venta como predeterminado, se quita automáticamente esa marca al anterior predeterminado
- Solo un punto de venta habilitado puede ser el predeterminado
- No se puede deshabilitar el punto de venta predeterminado mientras existan otros puntos de venta activos
- El nombre descriptivo es obligatorio
- El selector en la facturación solo muestra puntos de venta habilitados
Reglas de Negocio
RN-001: Retrocompatibilidad con configuración actual
- Condición: La empresa/sucursal no tiene puntos de venta registrados en la nueva funcionalidad
- Acción: El sistema opera exactamente igual que hoy, usando el punto de venta de la ficha de empresa ("sucursal")
- Ejemplo: Una empresa con
empres.nrosuc = 1y sin puntos de venta registrados emite comprobantes igual que antes, sin cambios en la pantalla de facturación
RN-002: Activación del selector en facturación
- Condición: La empresa/sucursal tiene al menos un punto de venta habilitado en la nueva tabla
- Acción: El formulario de facturación muestra el selector de punto de venta; propone el predeterminado; solo lista los habilitados
- Ejemplo: Si hay 3 puntos de venta (2 habilitados, 1 deshabilitado) y el predeterminado es "Caja 1 - PdV 0002", el selector carga con esa opción y muestra solo los 2 habilitados
RN-003: Verificación ARCA al dar de alta
- Condición: El operador ingresa un número ARCA al crear o editar un punto de venta
- Acción: El sistema consulta ARCA para verificar que ese número esté habilitado e informa el resultado
- Restricción: La verificación es informativa; el operador puede completar el alta aunque la verificación falle (por problemas de conectividad o puntos de venta en sandbox)
RN-004: Punto de venta predeterminado único
- Condición: Se marca un punto de venta como predeterminado
- Acción: Se quita automáticamente la marca de predeterminado al que la tenía antes
- Ejemplo: Si "PdV 0001" es el predeterminado y se marca "PdV 0003", "PdV 0001" pierde el estado y "PdV 0003" lo adquiere
RN-005: Uso del predeterminado en facturación batch
- Condición: Se ejecuta la facturación por lotes (membresías) y la empresa/sucursal tiene múltiples puntos de venta registrados
- Acción: El proceso batch utiliza el punto de venta marcado como predeterminado para emitir todos los comprobantes del lote
- Excepción: Si no existe punto de venta predeterminado definido, el proceso batch utiliza el punto de venta de la ficha de empresa (comportamiento actual)
RN-006: Modo Registro Manual con múltiples puntos de venta
- Condición: Se opera en modo Registro Manual (comprobantes preimpresos) y hay puntos de venta registrados
- Acción: El selector incluye las opciones registradas más una opción "Ingresar manualmente" que habilita el campo libre de ingreso de número
- Resultado: El operador puede elegir un punto de venta de la lista o ingresar uno libre, igual que hoy
RN-007: Independencia por schema
- Condición: La empresa opera con sucursales que tienen schemas propios
- Acción: Cada schema gestiona su propia lista de puntos de venta de forma completamente independiente
- Ejemplo: Sucursal "Norte" puede tener PdV 0001 y 0002; Sucursal "Sur" puede tener PdV 0003 y 0004, sin interferencia entre sí
Casos de Uso
UC-001: Dar de alta un nuevo punto de venta
Actor: Usuario con permiso de configuración de empresa
Precondiciones:
- Usuario autenticado con permisos de acceso al ABM de puntos de venta
- El número ARCA que se desea registrar no está duplicado en la empresa/sucursal activa
Flujo principal:
- Usuario accede a la pantalla de administración de puntos de venta
- Sistema muestra la lista de puntos de venta existentes
- Usuario selecciona "Nuevo punto de venta"
- Sistema muestra el formulario de alta
- Usuario ingresa nombre descriptivo, identificador interno y número ARCA
- Sistema consulta a ARCA si el número está habilitado e informa el resultado
- Usuario confirma el alta
- Sistema guarda el nuevo punto de venta
- Sistema muestra el punto de venta en la lista
Flujos alternativos:
- 6a. ARCA informa que el número no está habilitado → Sistema muestra advertencia; usuario puede igualmente confirmar el alta o cancelar
- 6b. No se puede contactar a ARCA → Sistema informa el error de conectividad; usuario puede igualmente confirmar el alta
- 7a. El número ARCA ya existe para la empresa/sucursal → Sistema muestra error de duplicado, no permite guardar
- 7b. Usuario cancela → Sistema descarta el formulario sin guardar
Postcondiciones:
- Nuevo punto de venta registrado y disponible para selección en facturación
UC-002: Cambiar el punto de venta predeterminado
Actor: Usuario con permiso de configuración de empresa
Precondiciones:
- Al menos dos puntos de venta registrados en la empresa/sucursal activa
Flujo principal:
- Usuario accede a la pantalla de administración de puntos de venta
- Sistema muestra la lista con el punto de venta predeterminado identificado visualmente
- Usuario selecciona "Marcar como predeterminado" en otro punto de venta
- Sistema solicita confirmación del cambio
- Usuario confirma
- Sistema actualiza el predeterminado y quita la marca del anterior
- Sistema muestra la lista actualizada
Flujos alternativos:
- 5a. Usuario cancela → Sin cambios
Postcondiciones:
- Solo un punto de venta marcado como predeterminado
- La facturación y el proceso batch utilizarán el nuevo predeterminado
UC-003: Emitir un comprobante con selección de punto de venta
Actor: Usuario con permiso de facturación
Precondiciones:
- La empresa/sucursal activa tiene al menos un punto de venta registrado en la nueva tabla
Flujo principal:
- Usuario accede al formulario de emisión de comprobante
- Sistema muestra el selector de punto de venta con el predeterminado seleccionado
- Usuario completa el resto del comprobante normalmente
- Si necesita usar un punto de venta distinto, selecciona otra opción del selector
- Usuario confirma la emisión
- Sistema emite el comprobante usando el punto de venta seleccionado
Flujos alternativos:
- 4a. Usuario está en modo Registro Manual y necesita un número libre → Selecciona "Ingresar manualmente" y escribe el número directamente
Postcondiciones:
- Comprobante emitido y asociado al punto de venta seleccionado
UC-004: Deshabilitar un punto de venta
Actor: Usuario con permiso de configuración de empresa
Precondiciones:
- El punto de venta a deshabilitar existe y está habilitado
- Si es el predeterminado, no deben existir otros puntos de venta activos
Flujo principal:
- Usuario accede a la pantalla de administración de puntos de venta
- Usuario selecciona "Deshabilitar" en un punto de venta
- Sistema solicita confirmación
- Usuario confirma
- Sistema marca el punto de venta como deshabilitado; el registro se conserva
- Sistema muestra la lista actualizada (el punto de venta deshabilitado ya no aparece salvo que se active el filtro)
Flujos alternativos:
- 3a. El punto de venta es el predeterminado y existen otros activos → Sistema informa que no es posible deshabilitarlo mientras sea el predeterminado; el usuario debe primero asignar otro como predeterminado
- 3b. Es el único punto de venta activo → Sistema lo deshabilita; la empresa/sucursal vuelve a operar con el punto de venta de la ficha de empresa
- 4a. Usuario cancela → Sin cambios
Postcondiciones:
- Punto de venta deshabilitado; no aparece en el selector de facturación ni en el proceso batch
- El registro permanece y puede rehabilitarse en el futuro
UC-005: Rehabilitar un punto de venta deshabilitado
Actor: Usuario con permiso de configuración de empresa
Precondiciones:
- El punto de venta existe y está deshabilitado
Flujo principal:
- Usuario accede a la pantalla de administración de puntos de venta
- Usuario activa el filtro "Mostrar deshabilitados"
- Sistema muestra la lista completa con los puntos de venta deshabilitados identificados visualmente
- Usuario selecciona "Habilitar" en el punto de venta deshabilitado
- Sistema solicita confirmación
- Usuario confirma
- Sistema marca el punto de venta como habilitado
- Sistema muestra la lista actualizada
Flujos alternativos:
- 6a. Usuario cancela → Sin cambios
Postcondiciones:
- Punto de venta habilitado y disponible para selección en facturación
Consideraciones
Seguridad
- Solo usuarios con permiso de configuración de empresa pueden acceder al ABM de puntos de venta
- La selección de punto de venta en la emisión de comprobantes está disponible para cualquier usuario con permiso de facturación
- Los permisos se integran con el sistema de roles y permisos existente del sistema
Auditoría
- Se registra quién y cuándo creó, modificó, deshabilitó o rehabilitó cada punto de venta
- Se registra el punto de venta utilizado en cada comprobante emitido (ya ocurre hoy; no cambia el modelo de auditoría)
Rendimiento
- La lista de puntos de venta por empresa/sucursal es esperablemente pequeña (hasta 10 registros)
- La consulta de verificación a ARCA es asíncrona y no bloquea el formulario de alta
Dependencias
Módulos internos
- Configuración de empresa: El campo de punto de venta en la ficha de empresa sigue siendo la fuente de datos cuando no hay puntos de venta registrados en la nueva tabla
- Facturación electrónica: El proceso de emisión de comprobantes usa el punto de venta seleccionado como identificador ante ARCA
- Facturación batch (membresías): El proceso de lotes usa el punto de venta predeterminado registrado en la nueva tabla cuando corresponda
- Comprobantes manuales / Registro Manual: El modo de ingreso libre de número de punto de venta convive con el nuevo selector mediante la opción "Ingresar manualmente"
Servicios externos
- ARCA (AFIP): Consulta de verificación de puntos de venta habilitados al dar de alta un nuevo punto de venta. La verificación es informativa y no bloquea el alta
Criterios de Aceptación
- [ ] Un usuario con permisos puede dar de alta un nuevo punto de venta indicando nombre, identificador interno y número ARCA
- [ ] Al ingresar el número ARCA en el alta, el sistema consulta a ARCA e informa si está habilitado, sin bloquear la operación
- [ ] Solo puede existir un punto de venta marcado como predeterminado por empresa/sucursal
- [ ] Al cambiar el punto de venta predeterminado, el anterior deja de serlo automáticamente
- [ ] El formulario de facturación muestra el selector de punto de venta solo si la empresa/sucursal tiene registros en la nueva tabla; de lo contrario opera exactamente igual que hoy
- [ ] El selector de punto de venta en facturación propone el predeterminado al cargar el formulario
- [ ] En modo Registro Manual, el selector incluye la opción "Ingresar manualmente" además de los puntos de venta registrados
- [ ] El proceso de facturación batch (membresías) usa el punto de venta predeterminado cuando hay múltiples registrados
- [ ] Cada schema de empresa o sucursal gestiona su lista de puntos de venta de forma independiente
- [ ] No se puede deshabilitar el punto de venta predeterminado mientras existan otros activos
- [ ] Un punto de venta deshabilitado no aparece en el selector de facturación ni se usa en el proceso batch
- [ ] El número ARCA no puede repetirse en la misma empresa/sucursal, ni siquiera entre habilitados y deshabilitados
- [ ] El usuario puede filtrar la lista para ver los puntos de venta deshabilitados
- [ ] Un punto de venta deshabilitado puede rehabilitarse; vuelve a estar disponible en facturación
- [ ] Una empresa/sucursal sin puntos de venta en la nueva tabla opera exactamente igual que antes, sin cambios en pantalla ni comportamiento