Puntos de Venta

Vision general

Un punto de venta representa una ubicacion fisica (sucursal, consultorio, tienda) desde donde se registran y emiten ventas en el sistema. Cada punto de venta tiene un codigo unico, un nombre, una ubicacion geografica opcional, uno o mas almacenes vinculados para control de stock, y series de documentos de venta configurables (boletas, facturas, notas de credito, guias).

Los puntos de venta se asignan a los vendedores a traves de Parametros de Vendedores. Un vendedor solo puede operar desde los puntos de venta que tenga asignados. Al crear una venta en Ventas Salud o Mis Ventas Salud, el sistema utiliza las series de documentos del punto de venta seleccionado.

---

Precondiciones

Precondicion	Descripcion	Donde se configura
Almacenes registrados	Debe existir al menos un almacen (elemento de infraestructura tipo 3) en el sistema	Modulo de Infraestructura
Ubigeos cargados	Los datos de departamentos, provincias y distritos deben estar en el almacenamiento local del navegador (erpx-global-ubigeos)	Se cargan automaticamente al iniciar sesion
Paises registrados	Debe haber al menos un pais registrado en el sistema	Modulo Global
Perfil de administrador	Solo usuarios con perfil de administrador pueden gestionar puntos de venta	Perfiles y Roles
Sesion activa	Debes tener una sesion activa en Davix	Iniciar sesion

---

Acceder a la configuracion

1. En el menu principal, ingresa a Sistema de Gestión Comercial
2. Selecciona Configuracion
3. Selecciona Puntos de ventas
4. Davix muestra la pagina Puntos de ventas con el listado de puntos registrados

---

Descripcion de la pantalla principal

Barra de navegacion

Breadcrumb: Comercial / Puntos de ventas. El enlace "Comercial" te lleva al menu principal del modulo.

Titulo y descripcion

• Titulo: Puntos de ventas
• Descripcion: "Muestra el listado y las herramientas para gestionar los puntos de ventas"

Barra de menu superior

Opcion	Descripcion
Nuevo > Punto de venta	Abre el formulario para crear un nuevo punto de venta
Actualizar	Recarga la lista desde el servidor
Exportar a > Excel	Descarga la lista en formato .xlsx
Exportar a > PDF	Descarga la lista en formato PDF
Exportar a > CSV	Descarga la lista en formato CSV
Eliminar	Elimina los registros seleccionados con las casillas de verificacion

Indicador de registros

Debajo de la barra de menu: "Mostrando pagina [N] con [X] registros de [total] entradas"

Tabla de puntos de venta

Columna	Descripcion
Casilla de seleccion	Permite seleccionar registros. La casilla del encabezado selecciona o deselecciona todos
Codigo	Codigo identificador del punto de venta (ordenable)
Nombre	Nombre descriptivo del punto de venta (ordenable)
Almacenes	Lista de almacenes vinculados en formato codigo-nombre, separados por comas (ordenable)
Acciones	Boton de menu (tres puntos) con opciones para el registro

Las columnas son redimensionables y ordenables. Si no hay registros, la tabla muestra: "No se encontraron datos". La tabla soporta carga diferida (lazy loading) con 50 registros por pagina.

Menu contextual (clic derecho)

Opcion	Descripcion
Punto de venta	Abre el formulario para crear un nuevo punto de venta
Editar	Abre el formulario de edicion del punto seleccionado
Eliminar	Elimina el punto de venta seleccionado

El mismo menu aparece al hacer clic en el icono de tres puntos (...) en la columna Acciones.

Paginacion

Control	Descripcion
Primera pagina (doble flecha izquierda)	Va a la primera pagina
Pagina anterior (flecha izquierda)	Retrocede una pagina
Selector de pagina (desplegable)	Permite saltar a una pagina especifica. Formato "X de Y" con filtro de busqueda
Pagina siguiente (flecha derecha)	Avanza una pagina
Ultima pagina (doble flecha derecha)	Va a la ultima pagina

50 registros por pagina.

---

Flujo principal: Crear un punto de venta

Descripcion

Este flujo registra una nueva ubicacion fisica de venta en el sistema, con sus almacenes, ubicacion geografica y series de documentos.

Pasos

1. En la barra de menu, selecciona Nuevo > Punto de venta (o usa el menu contextual)
2. Davix abre un formulario a pantalla completa con el titulo Nuevo punto de venta
3. Breadcrumb del formulario: Comercial / Comercial / Nuevo
4. Davix muestra un indicador de carga ("Cargando sus datos") mientras obtiene paises, almacenes y ubigeos del servidor
5. Una vez cargado, completa las 4 secciones del formulario (detalladas abajo)
6. Selecciona Guardar
7. Davix valida todos los campos. Si hay errores, muestra: "Revise bien, hay formularios por validar."
8. Si todo es correcto, Davix guarda el registro, muestra: "Registrado con exito" y cierra el formulario
9. La tabla del listado se actualiza automaticamente con el nuevo registro

Para cancelar sin guardar, selecciona Cancelar en la parte inferior izquierda.

---

Seccion 1: Detalles de punto de venta

Campo	Descripcion	Obligatorio	Validacion
Codigo	Codigo identificador unico del punto de venta	Si	Si esta vacio: "Ingrese el codigo"
Nombre	Nombre descriptivo del punto de venta	Si	Si esta vacio: "Ingrese el nombre"

Cada campo tiene un asterisco rojo (*) que indica obligatoriedad y un icono de informacion (i) con tooltip descriptivo.

---

Seccion 2: Almacenes

Los almacenes representan las ubicaciones de inventario vinculadas al punto de venta. Se muestra como una lista dinamica con selectores de arbol (tree select).

Agregar un almacen

1. Selecciona el boton Agregar en la parte inferior de la seccion
2. Davix agrega una nueva fila con un selector de arbol
3. Haz clic en el selector para ver los almacenes disponibles
4. Puedes filtrar escribiendo en el campo de busqueda del selector
5. Selecciona el almacen. Los almacenes se muestran en formato codigo - nombre

Eliminar un almacen

• En la fila del almacen, selecciona el icono X (eliminar)
• La primera fila (indice 0) no muestra el boton de eliminar, garantizando que siempre exista al menos un almacen

Reordenar almacenes

Cada fila tiene dos iconos de flechas:

Icono	Descripcion
Flecha arriba	Mueve el almacen una posicion hacia arriba
Flecha abajo	Mueve el almacen una posicion hacia abajo

Validacion

Si no hay ningun almacen seleccionado al guardar, Davix muestra: "Ingrese almenos un item de almacen"

---

Seccion 3: Ubicacion

Define la ubicacion geografica del punto de venta. Todos los campos son opcionales, pero si completas cualquiera de ellos, debes completar todos.

Campo	Tipo	Habilitado	Validacion si incompleto
Direccion	Texto libre	Siempre	"Ingrese la direccion"
Pais	Desplegable con busqueda	Siempre	"Seleccione el pais"
Departamento	Desplegable con busqueda	Solo si pais = PERU	"Seleccione el Departamento"
Provincia	Desplegable con busqueda	Solo si departamento seleccionado	"Seleccione la provincia"
Distrito	Desplegable con busqueda	Solo si provincia seleccionada	"Seleccione el Distrito"

Comportamiento en cascada

1. Pais: al abrir el formulario, muestra todos los paises. Al seleccionar un pais:

   • Si es PERU: se habilita el campo Departamento
   • Si es otro pais: Departamento, Provincia y Distrito permanecen deshabilitados
   • Al cambiar de pais, se reinician Departamento, Provincia y Distrito

2. Departamento: al seleccionar un departamento, se habilita Provincia y se cargan solo las provincias de ese departamento. Se reinician Provincia y Distrito.

3. Provincia: al seleccionar una provincia, se habilita Distrito y se cargan solo los distritos de esa provincia. Se reinicia Distrito.

4. Distrito: campo final de la cascada.

---

Seccion 4: Datos del documento

Configura las series de documentos de venta asociadas al punto de venta. Esta seccion es opcional: puedes guardar un punto de venta sin ninguna serie configurada.

Agregar una serie de documento

1. Selecciona el boton Agregar en la parte inferior de la seccion
2. Davix agrega una nueva fila con 4 campos:

Campo	Descripcion	Restricciones
Documento	Tipo de documento (desplegable)	Obligatorio si la fila existe
Serie	Codigo de serie alfanumerico	Exactamente 4 caracteres, solo alfanumerico, se convierte a mayusculas
Minimo	Inicio del rango de correlativo	Numero entero, maximo 8 digitos, minimo 0
Maximo	Fin del rango de correlativo	Numero entero, maximo 8 digitos, minimo 0

Tipos de documento disponibles

Nombre en pantalla	Codigo interno	Letra inicial obligatoria de serie
BOLETA	SERIE-BOLETA	B
FACTURA	SERIE-FACTURA	F
NOTA DE CREDITO DE BOLETA	SERIE-NCB	B
NOTA DE CREDITO DE FACTURA	SERIE-NCF	F
NOTA DE DEBIDO DE BOLETA	SERIE-NDB	B
NOTA DE DEBITO DE FACTURA	SERIE-NDF	F
GUIA	SERIE-GUIA	T
DOCUMENTO INTERNO	SERIE-DI	Sin restriccion

Eliminar una serie de documento

• Selecciona el icono X a la derecha de la fila

Validaciones de series (al guardar)

Las validaciones se ejecutan fila por fila en orden. Si una fila falla, Davix detiene la validacion y muestra el error correspondiente:

Validacion	Mensaje de error
Documento o serie vacios	"Hay campos que necesitan rellenar en la fila N. [N]"
Minimo mayor que maximo	"El minimo no puede ser mayor al maximo en la fila N. [N]"
Minimo igual a maximo	"El minimo no puede ser igual al maximo en la fila N. [N]"
Serie con longitud distinta a 4	"La serie ingresada es incorrecta, debe de contener 4 digitos en la fila N. [N]"
Serie no empieza con la letra correcta	"El documento es [TIPO] y la serie debe empezar con [LETRA] en la fila N. [N]"

---

Flujo: Editar un punto de venta

Descripcion

Este flujo permite modificar los datos de un punto de venta existente: detalles, almacenes, ubicacion y series de documentos.

Pasos

1. En la tabla, haz clic derecho sobre el punto de venta y selecciona Editar (o usa el boton de acciones)
2. Davix abre el formulario a pantalla completa
3. Davix muestra un indicador de carga ("Cargando sus datos") mientras obtiene los datos del punto de venta, paises, almacenes y ubigeos del servidor
4. Los campos se llenan automaticamente con los datos actuales:
   • Los almacenes previamente asignados aparecen preseleccionados en los selectores de arbol
   • Las series de documentos existentes se cargan en la seccion de datos del documento
   • La ubicacion geografica se reconstruye a partir del codigo de ubigeo almacenado
5. Modifica las secciones necesarias
6. Selecciona Guardar
7. Davix muestra: "Se ha actualizado con exito" y cierra el formulario
8. La tabla se actualiza automaticamente con los datos modificados

Resultado

El punto de venta se actualiza en el servidor con los nuevos datos, incluyendo almacenes y series de documentos.

---

Flujo: Eliminar un punto de venta

Descripcion

Este flujo elimina permanentemente un punto de venta del sistema.

Pasos

1. En la tabla, haz clic derecho sobre el punto de venta y selecciona Eliminar
2. Davix muestra un dialogo de confirmacion: "Estas seguro de proceder con la eliminacion?"
3. Selecciona Si para confirmar o No para cancelar
4. Si confirmas, Davix elimina el punto de venta y muestra: "Eliminado."
5. La fila se elimina automaticamente de la tabla

---

Flujo: Exportar la lista

Pasos

1. En la barra de menu, selecciona Exportar a
2. Elige el formato: Excel, PDF o CSV
3. Davix genera y descarga el archivo automaticamente

---

Flujo: Actualizar la lista

Pasos

1. En la barra de menu, selecciona Actualizar
2. La tabla muestra un indicador de carga
3. Davix recarga la lista de puntos de venta desde el servidor

---

Proceso de guardado: como se almacenan los datos

Datos del punto de venta

Al guardar, Davix envia al servidor:

• codigo, nombre, direccion
• pais_id: ID del pais seleccionado (o null)
• ubigeo: codigo de distrito seleccionado (o null)
• almacenes: lista de almacenes con su ID y prioridad (orden en la lista)

Series de documentos

Las series se guardan como parametros del sistema con dominio CONFIG-ERPX-FACTURACION-DOCUMENTOS-VENTAS. Por cada fila de documento, se crean 3 registros:

Registro	Codigo	Valor
Serie	SERIE-[TIPO]	Codigo de serie en mayusculas
Minimo	SERIE-[TIPO]-MIN	Valor minimo del rango
Maximo	SERIE-[TIPO]-MAX	Valor maximo del rango

Estos parametros se asocian al ID del punto de venta recien creado o actualizado.

---

Errores de conexion

Codigo HTTP	Comportamiento
400	Davix muestra los mensajes de error devueltos por el servidor
401, 402, 403	Davix muestra el mensaje de permisos devuelto por el servidor
404	"No se encontro el servidor de respuestas, consulte con el Administrador. ERROR 404"
500	"Error interno del servidor. ERROR 500"

---

Problemas comunes

Problema	Causa	Solucion
No aparecen almacenes en el selector	No hay elementos de infraestructura tipo 3 registrados	Solicita al administrador que registre almacenes en el modulo de Infraestructura
Los campos Departamento, Provincia y Distrito estan deshabilitados	No se ha seleccionado pais, o el pais no es PERU	Selecciona PERU como pais para habilitar la cascada de ubigeos
Error al guardar por ubicacion incompleta	Se completo parcialmente la seccion de ubicacion	Completa todos los campos de ubicacion o deja todos vacios
La serie no se acepta	La letra inicial no coincide con el tipo de documento	Verifica la tabla de letras iniciales por tipo de documento
"Revise bien, hay formularios por validar"	Hay campos obligatorios vacios	Revisa los campos marcados en rojo y completalos
El formulario se queda en "Cargando sus datos"	Error de conexion con el servidor	Recarga la pagina y verifica tu conexion
No aparecen series al editar	El punto de venta no tenia series configuradas	Agrega series con el boton Agregar en la seccion Datos del documento

---

Relacion con otros modulos

Modulo / Pantalla	Como se relaciona
Parametros de Vendedores	Asigna puntos de venta a vendedores
Vendedores	Los vendedores usan los puntos de venta asignados
Listas de Precios	Las listas de precios se asocian a puntos de venta
Ventas Salud	Cada venta se emite desde un punto de venta
Mis Ventas Salud	El vendedor configura su punto de venta por defecto
Modulo de Infraestructura	Los almacenes disponibles vienen del catalogo de infraestructura

---

Paginas relacionadas

• Parametros de Vendedores — asigna puntos de venta a vendedores
• Vendedores — lista de vendedores activos
• Listas de Precios — precios de productos y servicios
• Ventas Salud — cada venta se asocia a un punto de venta
• Mis Ventas Salud — ventas personales del vendedor