Mis Documentos de Ventas

Mis Documentos de Ventas es la vista personal del usuario autenticado dentro del modulo de Facturacion. Muestra unicamente los comprobantes de venta (boletas y facturas) que el propio usuario ha creado, filtrados automaticamente por su creator_id. A diferencia de Documentos de Ventas, esta pantalla no incluye integracion con SUNAT, no maneja guias de remision ni notas de credito, y cuenta con un sistema de estados diferente.

Ruta de navegacion

Inicio > Facturacion > Mis Documentos de Ventas

Barra de herramientas

En la parte superior de la pantalla se muestra una barra de menu horizontal (p-menubar) con las siguientes opciones:

Opcion	Sub-opcion	Icono	Descripcion
Nuevo	Comprobante	pi-plus	Abre el formulario para crear un nuevo comprobante de venta
Actualizar	—	pi-refresh	Recarga la lista de documentos desde el servidor
Exportar a	Exportar a excel	pi-file-excel	Exporta a Excel (funcion no implementada en esta version)
Exportar a	Exportar a pdf	pi-file-pdf	Exporta a PDF (funcion no implementada en esta version)
Exportar a	Exportar a csv	pi-file	Exporta a CSV (funcion no implementada en esta version)
Eliminar	—	pi-trash	Eliminar (funcion no implementada en esta version)

Filtros de busqueda

Debajo de la barra de herramientas se encuentra el panel de busqueda y filtros avanzados.

Busqueda por texto libre

A la izquierda hay un campo de texto con icono de lupa (pi-search). Escribe cualquier texto para buscar de forma libre entre todos los campos del documento. La busqueda se ejecuta al presionar el boton Buscar.

Filtros avanzados

A la derecha del campo de texto se muestran los chips de filtros activos y los botones de control:

Boton	Icono	Descripcion
Agregar filtro	pi-filter	Abre el panel de filtros avanzados
Quitar filtros	pi-filter-slash	Elimina todos los filtros activos y limpia el campo de busqueda
Buscar	pi-search	Ejecuta la busqueda con los filtros aplicados

Al presionar Agregar filtro, se abre un panel superpuesto (p-overlayPanel) de 450 px de ancho con un formulario para configurar el filtro.

Tipos de filtro disponibles

El campo Filtro es un dropdown obligatorio con las siguientes opciones:

Filtro	Valor	Campos que muestra	Consulta generada
FECHA	1	Fecha inicio + Fecha fin (ambos obligatorios, tipo date)	fecha:[YYYY-MM-DD TO YYYY-MM-DD]
SERIE	2	Serie (texto, obligatorio)	serie:\{valor\}
NUMERO	3	Numero (texto, obligatorio)	numero:\{valor\}
SOLICITANTE	4	Dropdown de colaboradores con busqueda (obligatorio)	solicitante_id:\{id\}
PARTIDA PRESUPUESTARIA	5	Texto libre (obligatorio)	partida_presupuestaria:\{valor\}
ESTADOS	6	Multi-seleccion de estados (obligatorio)	estados:\{valores separados por coma\}

Estados disponibles en el filtro

Estado	Valor
NUEVO	0
EN PROCESO	1
CERRADO	2
ATENDIDO	3
BAJA	4

Validaciones del filtro

Campo	Regla	Mensaje de error
Filtro	Obligatorio	* Obligatorio
Fecha inicio	Obligatorio cuando filtro = FECHA	* Obligatorio
Fecha fin	Obligatorio cuando filtro = FECHA	* Obligatorio
Serie	Obligatorio cuando filtro = SERIE	* Obligatorio
Numero	Obligatorio cuando filtro = NUMERO	* Obligatorio
Solicitante	Obligatorio cuando filtro = SOLICITANTE	* Obligatorio
Partida presupuestaria	Obligatorio cuando filtro = PARTIDA PRESUPUESTARIA	* Obligatorio
Estados	Obligatorio cuando filtro = ESTADOS	* Obligatorio

Al presionar Guardar en el panel de filtros, el filtro se agrega como un chip visible. Si ya existe un filtro del mismo tipo, se reemplaza automaticamente. Puedes hacer clic en un chip existente para editar sus valores, o presionar la X del chip para eliminarlo.

Formato del chip segun filtro:

Filtro	Formato del chip
FECHA	Fecha desde DD/MM/YYYY hasta DD/MM/YYYY
SERIE	Serie == \{valor\}
NUMERO	Numero == \{valor\}
SOLICITANTE	Solicitante == \{apellido_paterno\} \{apellido_materno\} \{nombres\}
PARTIDA PRESUPUESTARIA	Partida presupuestaria == \{valor\}
ESTADOS	Estados == \{nombres separados por coma\}

Tabla de documentos

La tabla principal muestra los comprobantes de venta del usuario con las siguientes columnas:

#	Columna	Descripcion	Formato
1	Fecha	Fecha y hora de emision del documento	DD/MM/YYYY hh:mm AM/PM
2	Tipo comprobante	Tipo de comprobante emitido	BOLETA o FACTURA
3	Serie - Numero	Serie y numero correlativo	\{serie\}-\{numero\}
4	DNI & RUC	Numero de documento del cliente	Texto
5	Cliente	Nombre completo o razon social del cliente	Persona: \{apellido_paterno\} \{apellido_materno\} \{nombres\} / Empresa: \{razon_social\}
6	Num. Venta	Serie y numero de la venta de referencia	\{serie\}-\{numero\}
7	Total	Monto total del comprobante	Numerico
8	Estado	Estado actual del documento (etiqueta de color)	Ver tabla de estados
9	ACCIONES	Boton de menu contextual (tres puntos ···)	Ancho fijo 80 px

Tipos de comprobante

Solo se manejan dos tipos de comprobante en esta vista:

Tipo	Valor interno	Etiqueta
Factura	1	FACTURA
Boleta	3	BOLETA

Estados del documento

Cada documento tiene un estado representado con una etiqueta de color (p-tag):

Estado	Valor	Clase CSS	Descripcion
Nuevo	0	estado-0	Documento recien creado, pendiente de verificacion
Verificado con errores	1	estado-1	Se verifico el documento y tiene errores
Verificado correctamente	2	estado-2	Se verifico el documento exitosamente
Cerrado	3	estado-3	Documento cerrado, sin mas acciones posibles
Baja	4	estado-4	Documento dado de baja

Paginacion

Debajo de la tabla se muestra un indicador de paginacion:

Mostrando pagina {N} con {cantidad} registros de {total} entradas

La paginacion incluye controles de navegacion:

Boton	Icono	Accion
Ir al inicio	pi-angle-double-left	Va a la primera pagina
Anterior	pi-angle-left	Va a la pagina anterior
Selector de pagina	Dropdown	Muestra \{pagina actual\} de \{total paginas\} con busqueda
Siguiente	pi-angle-right	Va a la siguiente pagina
Ir al final	pi-angle-double-right	Va a la ultima pagina

El tamano de pagina es de 50 registros por defecto.

Menu contextual por estado

Al hacer clic derecho sobre una fila o presionar el boton de tres puntos (···), se despliega un menu contextual cuyas opciones varian segun el estado del documento:

Estado 0 — Nuevo

Opcion	Icono	Accion
Detalles	pi-eye	Abre la pantalla de detalles del documento
Reporte	pi-file-pdf	Abre el visor de reporte PDF del comprobante
Baja	pi-lock	Cambia el estado del documento a Baja (4)

Estado 1 — Verificado con errores

Opcion	Icono	Accion
Ver detalles	pi-eye	Abre la pantalla de detalles del documento
Editar	pi-pencil	Abre el formulario de edicion del comprobante
Eliminar	pi-times	Elimina el documento
—	—	Separador
Baja	pi-lock	Cambia el estado del documento a Baja (4)
—	—	Separador
Registor de actividades	pi-lock	Registro de actividades (sin funcionalidad implementada)

Estado 2 — Verificado correctamente

Opcion	Icono	Accion
Ver detalles	pi-eye	Abre la pantalla de detalles del documento
Eliminar	pi-times	Elimina el documento
—	—	Separador
Cerrar	pi-thumbs-down	Cambia el estado a Cerrado (3)
Baja	pi-lock	Cambia el estado a Baja (6)
—	—	Separador
Registor de actividades	pi-lock	Registro de actividades (sin funcionalidad implementada)

Estado 3 — Cerrado

Opcion	Icono	Accion
Ver detalles	pi-eye	Abre la pantalla de detalles del documento
—	—	Separador
Registor de actividades	pi-lock	Registro de actividades (sin funcionalidad implementada)

Estado 4 — Baja

Opcion	Icono	Accion
Ver detalles	pi-eye	Abre la pantalla de detalles del documento
Eliminar	pi-times	Elimina el documento
—	—	Separador
Quitar baja	pi-lock	Devuelve el estado del documento a Nuevo (0)
—	—	Separador
Registor de actividades	pi-lock	Registro de actividades (sin funcionalidad implementada)

Nuevo comprobante de venta

Al seleccionar Nuevo > Comprobante desde la barra de herramientas, o Editar desde el menu contextual de un documento con estado 1, se abre un dialogo a pantalla completa con el formulario de creacion/edicion.

Ruta de navegacion del formulario

Facturacion > Mis documentos de ventas > Nuevo

Titulo: Nuevo comprobante de venta Subtitulo: Aqui puede editar la lista de mis comprobantes

Pantalla de carga

Mientras se cargan los datos necesarios se muestra un mensaje de carga con barra de progreso indeterminada:

• Mensaje: Cargando sus datos
• Indicador: spinner animado + barra de progreso

Seccion 1: Venta

Campo	Tipo	Obligatorio	Tooltip	Placeholder	Mensaje de error
Venta	Autocompletado (p-autoComplete) con dropdown	Si	Seleccione una venta	Buscar...	* Seleccione una venta

El campo Venta busca ventas en el sistema al escribir texto. Los resultados se presentan con el siguiente formato:

Serie: {serie}  Numero: {numero}
Fecha: DD/MM/YYYY a horas de hh:mm:ss AM/PM
Cliente: {nombre del cliente}

El label del item seleccionado se muestra como: \{serie\} - \{numero\} - DD/MM/YYYY

Al presionar el boton de limpiar (X) en el campo de Venta, se ocultan todas las secciones siguientes y se resetean los datos.

Seccion 2: Detalles de comprobante

Esta seccion solo se muestra despues de seleccionar una venta.

Campo	Tipo	Obligatorio	Tooltip	Placeholder	Mensaje de error
Tipo Documento	Dropdown (p-dropdown)	Si	Seleccione el tipo de documento	Seleccione	* Seleccione tipo documento valido
Serie	Dropdown (p-dropdown)	Si	Ingrese la serie	Seleccione	* Ingrese la serie
Numero	Texto (solo lectura)	Si	Ingrese el numero	Automatico	* Ingrese el numero

Opciones de Tipo Documento

Opcion	Valor interno
Boleta	3
Factura	1

Logica de series

Al seleccionar un Tipo Documento, el sistema filtra las series disponibles segun los parametros del usuario:

• Si se selecciona Boleta, se buscan parametros con code SERIE-BOLETA
• Si se selecciona Factura, se buscan parametros con code SERIE-FACTURA

Los parametros se filtran por los principals del usuario (su creator_id y los puntos de venta asociados a traves del parametro PUNTOS-VENTAS).

Si hay series disponibles, la primera se selecciona automaticamente.

El campo Numero es de solo lectura y muestra Automatico — el numero se genera al momento de guardar el comprobante.

Seccion 3: Datos del cliente

Esta seccion solo se muestra despues de seleccionar una venta.

Campo	Tipo	Obligatorio	Tooltip	Placeholder	Mensaje de error
Cliente	Autocompletado (p-autoComplete) con dropdown	Si	Ingrese el clinete (sic)	Buscar...	* Ingrese el cliente

El cliente se carga automaticamente al seleccionar la venta, pero puede ser cambiado buscando otro cliente. El autocompletado muestra:

• Encabezado del dropdown: Boton "Agregar cliente +" que abre el formulario de nuevo cliente
• Cada resultado: Nombre o razon social del cliente + Numero de documento

Formato del label del cliente seleccionado:

• Persona: \{numero_documento\} - \{nombres\} \{apellido_paterno\} \{apellido_materno\}
• Empresa: \{numero_documento\} - \{razon_social\}
• Persona con RUC: \{numero_documento\} - \{razon_social\}

Seccion 4: Detalles de venta

Esta seccion solo se muestra despues de seleccionar una venta.

Titulo: Detalles de venta Subtitulo: Muestra los detalles de comprobante a emitir.

Boton Agregar

El boton Agregar (icono pi-plus) abre un dialogo de seleccion de detalles donde puedes elegir que productos de la venta original incluir en el comprobante.

Dialogo de seleccion de detalles

Se abre un dialogo con titulo "Detalles de venta" y subtitulo "Aqui puede seleccionar los detalles que desea emitir en la venta seleccionada."

La tabla de seleccion tiene las siguientes columnas:

#	Columna	Descripcion
1	Checkbox	Casilla de seleccion individual o total (encabezado)
2	Producto	\{codigo\} - \{nombre\} del producto del catalogo
3	Unidad	\{codigo\} - \{nombre\} de la unidad
4	Cantidad	Cantidad del detalle
5	Valor unitario	Valor unitario sin impuestos
6	Precio unitario	Precio unitario con impuestos
7	Valor de venta	(vacio en esta tabla)
8	Descuento	Monto del descuento
9	Impuesto	Monto del impuesto
10	Sub Total	Precio de venta total

Botones del dialogo:

• Cancelar: Cierra sin seleccionar
• Seleccionar: Confirma la seleccion y carga los detalles en la tabla principal

Tabla de detalles del comprobante

#	Columna	Descripcion	Editable
1	Producto	\{codigo\} - \{nombre\}	No
2	Unidad	\{codigo\} - \{nombre\}	No
3	Cantidad	Cantidad del producto (ancho 120 px)	Si — campo numerico (p-inputNumber) con 10 decimales, formato es-PE, minimo 1
4	Valor unitario	Valor sin impuestos	No
5	Precio unitario	Precio con impuestos	No
6	Valor de venta	Valor calculado	No
7	Impuesto	Impuesto calculado	No
8	Sub Total	Precio de venta total calculado	No
9	Acciones	Icono X para eliminar el detalle (ancho 80 px)	—

Calculos automaticos al cambiar la cantidad:

Los valores se recalculan automaticamente con precision de 10 decimales usando la libreria BigNumber:

1. precio_venta = cantidad × precio_unitario
2. valor_venta = precio_venta / (precio_unitario + 1)
3. total_impuesto = precio_venta - valor_venta

Resumen de montos

Debajo de la tabla se muestra un resumen alineado a la derecha:

Concepto	Valor
Total valor de venta:	Suma de valor_unitario de todos los detalles
Total valor de impuestos:	Suma de precio_unitario de todos los detalles
Total monto:	Suma de precio_venta de todos los detalles

Validacion de Factura con RUC

Al guardar un comprobante de tipo Factura (valor 1), el sistema valida que el cliente tenga un numero de documento tipo RUC. Si el cliente no tiene RUC, se muestra:

• Titulo: Alerta
• Mensaje: Revise bien, no puede emitir un comprobante sin un numero de RUC, intentelo nuevamente.
• Duracion: 5 segundos

Confirmacion de emision

Antes de guardar, el sistema muestra un dialogo de confirmacion en la parte inferior de la pantalla:

• Mensaje: Recuerda que al emitir no podra volver a modificarlo, si esta de acuerdo confirme.
• Titulo: Confirmacion
• Icono: pi-info-circle
• Boton aceptar: Si, estoy de acuerdo
• Boton rechazar: No

Proceso de guardado

Al confirmar, el sistema ejecuta los siguientes pasos en secuencia:

Notificacion de exito al crear:

• Titulo: Alerta
• Mensaje: Registrado con exito
• Duracion: 5 segundos

Notificacion de exito al editar:

• Titulo: Alerta
• Mensaje: Se ha actualizado con exito
• Duracion: 5 segundos

Notificacion de error en validacion:

• Titulo: Alerta
• Mensaje: Revise bien, hay formularios por validar.
• Duracion: 5 segundos

Botones del formulario

Boton	Icono	Accion
Cancelar	pi-times	Cierra el dialogo sin guardar
Guardar	pi-check (spinner al procesar)	Valida y guarda el comprobante. Se deshabilita durante el proceso de guardado

Ver detalles del documento

Al seleccionar Detalles o Ver detalles desde el menu contextual, se abre un dialogo a pantalla completa con la informacion del comprobante.

Ruta de navegacion

Facturacion > Documentos de ventas > Nuevo

Titulo: Nuevo comprobante de venta Subtitulo: Aqui puede editar la lista de comprobantes

Seccion: Detalles de comprobante

Muestra los datos principales del documento en formato de solo lectura:

Campo	Tooltip	Descripcion
Tipo Documento	Tipo de documento emitido	BOLETA o FACTURA
Serie	Serie con la que el documento se emitio	Serie del comprobante
Numero	Numero con la que el documento se emitio	Numero del comprobante

Seccion: Venta

Muestra los datos de la venta de referencia:

Campo	Tooltip	Descripcion
Serie - Numero	Serie y Numero de venta	\{serie\} - \{numero\} de la venta
Cliente	Cliente	\{tipo_documento\} - \{numero_documento\} - \{nombre\} \{apellido_paterno\} \{apellido_materno\}

Seccion: Detalles de venta

Tabla de solo lectura con las mismas columnas que el formulario de creacion, pero sin la columna de Acciones y sin campo editable de cantidad:

#	Columna
1	Producto
2	Unidad
3	Cantidad
4	Valor unitario
5	Precio unitario
6	Valor de venta
7	Impuesto
8	Sub Total

Debajo de la tabla se muestra el resumen de montos (Total valor de venta, Total valor de impuestos, Total monto).

Todos los valores numericos se muestran con 10 decimales de precision.

Seccion: Observaciones

Permite agregar observaciones al documento. Se muestra una tabla editable con las siguientes columnas:

#	Columna	Tipo	Descripcion
1	N°	Texto (ancho 40 px)	Numero secuencial de la observacion
2	Fecha	Calendario p-calendar (ancho 130 px)	Fecha de la observacion, formato DD/MM/YYYY, solo lectura (no se puede escribir manualmente)
3	Comentario	Textarea	Texto de la observacion
4	Acciones	Icono (ancho 80 px)	Icono X para eliminar la observacion

Boton Agregar: Debajo de la tabla hay un boton Agregar (icono pi-plus) que agrega una nueva fila con la fecha actual y el autor_id del usuario autenticado.

Confirmacion de guardado de detalles

Al presionar Guardar en la pantalla de detalles, se valida que existan observaciones. Si no hay observaciones, se muestra:

• Titulo: Alerta
• Mensaje: Revise bien, hay formularios por validar.
• Duracion: 5 segundos

Luego se muestra un dialogo de confirmacion en la parte inferior:

• Misma estructura que la confirmacion de nuevo comprobante

Al confirmar, se envia un PATCH al endpoint /v2.0.1/erpx/facturacion/documentos-ventas/\{id\} con el id del documento y las observaciones.

Notificacion de exito:

• Titulo: Alerta
• Mensaje: Se ha actualizado con exito
• Duracion: 5 segundos

Botones de la pantalla de detalles

Boton	Icono	Accion
Cancelar	pi-times	Cierra el dialogo sin guardar
Guardar	pi-check (spinner al procesar)	Valida y guarda las observaciones

Reporte PDF

Al seleccionar Reporte desde el menu contextual (solo disponible en estado Nuevo), se abre un dialogo a pantalla completa que muestra el comprobante en formato PDF.

Ruta de navegacion

Facturacion > Documentos de ventas > Reporte

Titulo: Reporte comprobante de venta Subtitulo: Reporte de comprobante de venta

El visor PDF usa la libreria ngx-extended-pdf-viewer y muestra el contenido del archivo almacenado en el File Server (base64). Incluye las siguientes herramientas:

Herramienta	Disponible
Barra de herramientas	Si
Boton de barra lateral	Si
Buscar en PDF	Si
Paginacion	Si
Zoom	Si
Modo presentacion	Si
Abrir archivo	No
Imprimir	Si
Descargar	Si
Menu secundario	Si
Rotar	Si
Herramienta de mano	Si
Scroll	Si
Vista doble pagina	Si
Propiedades	Si
Dibujo	No
Editor de texto	No

Boton del dialogo:

• Salir (pi-times): Cierra el visor PDF

Nuevo cliente

Desde el formulario de nuevo comprobante, al presionar "Agregar cliente +" en el dropdown de clientes, se abre un dialogo de 70% del ancho de la ventana para registrar un nuevo cliente.

Ruta de navegacion

Facturacion > Documentos de Ventas > Nuevo documento > Nuevo cliente

Titulo: Nuevo cliente Subtitulo: Aqui puede editar la lista de clientes

Tipo de cliente

Opcion	Valor	Descripcion
Persona	PERSONA	Cliente persona natural
Empresa	EMPRESA	Cliente persona juridica

Al cambiar el tipo de cliente, se muestran u ocultan campos segun corresponda.

Detalles de cliente

Campo	Tipo	Obligatorio	Tooltip	Mensaje de error
Tipo Documento	Dropdown	Si	Seleccione el tipo de documento	* Seleccione tipo documento valido
Numero Documento	Texto con boton de busqueda RENIEC/SUNAT	Si	Ingrese el numero de documento, y realice una busqueda previa	* Ingrese un numero valido / * No se encuentra el numero

Tipos de documento disponibles

Para Persona:

Tipo	Longitud minima	Longitud maxima
DNI	8	8
PASAPORTE	8	12
CARNET EXTRANJERIA	8	12
RUC	11	11

Para Empresa:

Tipo	Longitud minima	Longitud maxima
RUC	11	11

Al presionar el boton de busqueda (pi-search) o presionar Enter en el campo de numero de documento:

• Si el tipo es DNI, se consulta RENIEC: GET /api/v1/reniec/personas/\{numero\}
• Si el tipo es RUC, se consulta SUNAT: GET /api/v1/sunat/empresas/\{numero\}
• Los datos retornados se autocompletan en los campos del formulario

Campos para Persona (DNI, PASAPORTE, CARNET EXTRANJERIA)

Campo	Tipo	Obligatorio	Tooltip	Mensaje de error
Nombres	Texto	Si	Ingrese los nombres	* Ingrese los nombres
Apellido paterno	Texto	Si	Ingrese el apellido paterno	* Ingrese el apellido paterno
Apellido materno	Texto	Si	Ingrese el apellido materno	* Ingrese el apellido materno
Fecha nacimiento	Calendario (p-calendar)	Si	Seleccione una fecha de nacimiento	* Seleccione la fecha de nacimiento
Genero	Radio buttons	Si	Seleccione el genero	* Seleccione el genero

Opciones de genero:

• Masculino (valor M)
• Femenino (valor F)

Campos para Empresa (RUC) o Persona con RUC

Campo	Tipo	Obligatorio	Tooltip	Mensaje de error
Razon Social	Texto	Si	Ingrese la razon social	* Ingrese los razon social

Seccion: Ubicacion

Componente de ubigeo para registrar la direccion del cliente (pais, departamento, provincia, distrito, direccion).

Seccion: Telefonos

Tabla editable para registrar multiples telefonos del cliente. Incluye boton para agregar filas.

Seccion: Correos

Tabla editable para registrar multiples correos electronicos del cliente. Incluye boton para agregar filas.

Seccion: Detalles de cliente (adicionales)

Campo	Tipo	Obligatorio	Descripcion
Matriz	Dropdown con busqueda	No	Seleccion de cliente matriz
Actividad del consumidor	Dropdown con busqueda	No	Actividad economica del cliente
Canal	Dropdown con busqueda	No	Canal comercial
Sub-Canal	Dropdown con busqueda	No	Sub-canal comercial (depende del canal seleccionado)
Canal venta	Dropdown con busqueda	No	Canal de venta

Seccion: Puntos de ventas

Tabla editable para registrar los puntos de venta asociados al cliente.

Botones del formulario de cliente

Boton	Icono	Accion
Cancelar	pi-times	Cierra el dialogo sin guardar
Guardar y seleccionar	pi-check (spinner al procesar)	Guarda el cliente y lo selecciona automaticamente en el formulario de comprobante

Endpoints

Todos los endpoints usan la base URL \{ms-server\}/v2.0.1/erpx y requieren los headers:

• Authorization: Bearer \{token\}
• enterprise-id: \{enterprise_id\}
• accept: application/json

Documentos de Ventas

Metodo	Ruta	Descripcion
GET	/facturacion/documentos-ventas/?search=\{filtros\} AND creator_id:\{id\}&from=\{n\}&size=\{n\}&sort=	Lista documentos del usuario autenticado
GET	/facturacion/documentos-ventas/\{id\}	Obtiene un documento por ID
POST	/facturacion/documentos-ventas/	Crea un nuevo documento
PUT	/facturacion/documentos-ventas/\{id\}	Actualiza un documento completo
PATCH	/facturacion/documentos-ventas/\{id\}	Actualiza campos parciales (observaciones)
DELETE	/facturacion/documentos-ventas/\{id\}	Elimina un documento

Ventas

Metodo	Ruta	Descripcion
GET	/comercial/ventas/?search=*\{texto\}*&from=0&size=1000	Busca ventas para el autocompletado
GET	/comercial/ventas/\{id\}	Obtiene una venta por ID

Clientes

Metodo	Ruta	Descripcion
GET	/comercial/clientes/?search=*\{texto\}*&from=0&size=1000	Busca clientes para el autocompletado
GET	/comercial/clientes/\{id\}	Obtiene un cliente por ID

Clientes Personas

Metodo	Ruta	Descripcion
GET	/comercial/clientes-personas/?search=\{filtros\}&from=\{n\}&size=\{n\}	Lista clientes persona
GET	/comercial/clientes-personas/\{id\}	Obtiene un cliente persona por ID
POST	/comercial/clientes-personas/	Crea un nuevo cliente persona
PUT	/comercial/clientes-personas/\{id\}	Actualiza un cliente persona
DELETE	/comercial/clientes-personas/\{id\}	Elimina un cliente persona

Clientes Empresas

Metodo	Ruta	Descripcion
GET	/comercial/clientes-empresas/?search=\{filtros\}&from=\{n\}&size=\{n\}	Lista clientes empresa
GET	/comercial/clientes-empresas/\{id\}	Obtiene un cliente empresa por ID
POST	/comercial/clientes-empresas/	Crea un nuevo cliente empresa
PUT	/comercial/clientes-empresas/\{id\}	Actualiza un cliente empresa
DELETE	/comercial/clientes-empresas/\{id\}	Elimina un cliente empresa

Parametros

Metodo	Ruta	Descripcion
GET	/global/params/?search=principals:\{creator_id\},\{punto_venta_id\}&size=100	Obtiene parametros de series

Secuencias

Metodo	Ruta	Descripcion
POST	/global/secuences/nextval/	Genera el siguiente numero de secuencia

Puntos de Venta

Metodo	Ruta	Descripcion
GET	/comercial/puntos-ventas/?search=**&from=0&size=10	Lista puntos de venta

Reportes

Metodo	Ruta	Descripcion
GET	/reports/?search=\{filtros\}&from=\{n\}&size=\{n\}	Lista reportes
GET	/reports/\{id\}	Obtiene un reporte por ID
POST	/reports/	Crea un nuevo reporte
PUT	/reports/\{id\}	Actualiza un reporte
PATCH	/reports/\{id\}	Actualiza campos parciales de un reporte
DELETE	/reports/\{id\}	Elimina un reporte

File Server

Metodo	Ruta	Descripcion
GET	/fserver/files/?search=\{filtros\}&from=\{n\}&size=\{n\}	Lista archivos
GET	/fserver/files/\{id\}	Obtiene un archivo por ID (contenido base64)
POST	/fserver/files/	Crea un nuevo registro de archivo
PUT	/fserver/files/\{id\}	Actualiza un archivo
PATCH	/fserver/files/\{id\}	Actualiza campos parciales de un archivo
DELETE	/fserver/files/\{id\}	Elimina un archivo

Consultas RENIEC / SUNAT

Metodo	Ruta	Descripcion
GET	/api/v1/reniec/personas/\{numero_documento\}?token=\{token\}	Consulta datos de persona en RENIEC
GET	/api/v1/sunat/empresas/\{numero_documento\}?token=\{token\}	Consulta datos de empresa en SUNAT

Zonas y Paises

Metodo	Ruta	Descripcion
GET	/global/paises/?search=\{filtros\}&from=\{n\}&size=\{n\}	Lista paises
GET	/global/zonas/?search=\{filtros\}&from=\{n\}&size=\{n\}	Lista zonas (ubigeo)

Mensajes de error del servidor

Codigo HTTP	Mensaje mostrado
400	Error de estructura de envio de datos. ERROR 400 (o mensajes especificos del servidor si estan disponibles)
401, 402, 403	Mensajes concatenados del array errors[].messague del servidor
404	No se encontro el servidor de respuestas, consulte con el Administrador. ERROR 404
500	Error interno del servidor. ERROR 500
Otros	Error 404 consulte con su admin.

Errores especificos de RENIEC/SUNAT

Codigo HTTP	Mensaje mostrado
400	No se encontraron datos para el numero ingresado. ERROR 400 (o mensajes del servidor si estan disponibles)
404	No se encontro el servidor de respuestas, consulte con el Administrador. ERROR 404
500	Error interno del servidor. ERROR 500
401, 402, 403	Mensajes concatenados del array errors[].messague del servidor

Problemas comunes

Problema	Causa	Solucion
No veo ningun documento en la lista	Solo se muestran documentos creados por tu usuario (creator_id)	Verifica que hayas creado documentos con tu sesion. Para ver todos los documentos usa Documentos de Ventas
No puedo seleccionar una serie	No tienes series asignadas para ese tipo de documento en tu punto de venta	Solicita al administrador que configure los parametros SERIE-BOLETA o SERIE-FACTURA para tu usuario
Error al emitir Factura con cliente sin RUC	Las facturas requieren que el cliente tenga numero de RUC	Selecciona un cliente con tipo de documento RUC o cambia el tipo de comprobante a Boleta
El numero del comprobante dice "Automatico"	El numero se genera automaticamente al guardar	Este es el comportamiento esperado; no es necesario ingresar el numero manualmente
Las opciones de exportar no funcionan	La funcionalidad de exportacion no esta implementada en esta version	Utilice la pantalla de Documentos de Ventas que si tiene exportacion a Excel
No puedo editar un documento en estado Cerrado	Los documentos cerrados no permiten edicion	Solo los documentos en estado Verificado con errores pueden editarse
Quiero reactivar un documento dado de baja	Use la opcion Quitar baja del menu contextual	Haga clic derecho sobre el documento en estado Baja y seleccione Quitar baja
No encuentro ventas al buscar	El buscador busca por texto libre en todos los campos de la venta	Intente buscar por serie, numero o nombre del cliente
El filtro de Solicitante esta vacio	El servicio de colaboradores no esta activo en esta version	Utilice otros filtros disponibles como Fecha, Serie o Estados

Paginas relacionadas

• Documentos de Ventas — vista general de todos los documentos con integracion SUNAT
• Sistema de Gestión Comercial — ventas y clientes que generan los comprobantes
• Finanzas — cobros asociados a los comprobantes
• Seguridad — permisos y perfiles de acceso