Documentos de Ventas Salud

Emision de comprobantes electronicos especializados para el sector salud: facturas, boletas, notas de credito, guias de remision, envio a SUNAT y exportacion a Excel

Documentos de Ventas Salud es la pantalla de facturacion electronica especializada para el sector salud. Permite emitir facturas, boletas y notas de credito a partir de ventas del modulo de salud, con integracion completa a SUNAT para el envio electronico, consulta de estado, descarga de archivos UBL y CDR. Tambien soporta la emision de guias de remision remitente.

Esta pantalla es la version especializada para el sector salud de Documentos de Ventas. Las ventas provienen del modulo de ventas salud y los clientes del modulo comercial v2.0.2. Verifica que tienes el perfil adecuado.

Ruta de navegacion

Inicio > Facturacion > Mis documentos de Ventas

Barra de herramientas

En la parte superior derecha de la pantalla se muestran tres botones principales:

Boton	Icono	Descripcion
Exportar	`pi-file-excel`	Exporta los documentos filtrados a Excel
Actualizar	`pi-refresh`	Recarga la lista de documentos desde el servidor
Nuevo	`pi-plus`	Despliega un menu popup con opciones de creacion

Al presionar Nuevo, se despliega un menu popup con las siguientes opciones:

Opcion	Icono	Descripcion
Comprobante	`pi-plus`	Abre el formulario para crear un nuevo comprobante (factura o boleta)
Nota de Credito	`pi-plus`	Abre el formulario para crear una nueva nota de credito

La opcion de Guia remision esta disponible en el codigo fuente pero se encuentra deshabilitada (comentada) en esta version.

Filtros de busqueda

Debajo de la barra de herramientas se encuentra el panel de busqueda y filtros avanzados, identico en estructura al de Documentos de Ventas.

Busqueda por texto libre

Campo de texto con icono de lupa (pi-search). La busqueda se ejecuta al presionar Buscar o al guardar un filtro.

Filtros avanzados

Boton	Icono	Descripcion
Agregar filtro	`pi-filter`	Abre el panel de filtros (muestra spinner de carga mientras se cargan los datos)
Quitar filtros	`pi-filter-slash`	Elimina todos los filtros y ejecuta busqueda automaticamente
Buscar	`pi-search`	Ejecuta la busqueda con los filtros aplicados

Tipos de filtro disponibles

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\}`
CLIENTE	4	Dropdown de clientes con busqueda (obligatorio)	`cliente_id:\{id\}`
ESTADOS	5	Multi-seleccion de estados del documento (obligatorio)	`estados:\{valores separados por coma\}`
TIPOS DE DOCUMENTOS	6	Multi-seleccion de tipos de documento (obligatorio)	`tipos_documentos:\{valores separados por coma\}`
ESTADOS DE ENVIOS SUNAT	7	Multi-seleccion de estados de envio SUNAT (obligatorio)	`envio_sunat_estados:\{valores separados por coma\}`

El filtro de CLIENTE carga la lista completa de clientes del sistema. Cada opcion muestra:

Para RUC: \{numero_documento\} - \{razon_social\}
Para otros: \{numero_documento\} - \{apellido_paterno\} \{apellido_materno\} \{nombres\}

A diferencia de Documentos de Ventas, aqui si se carga la lista de clientes activamente.

Estados disponibles en el filtro

Se generan dinamicamente desde los enums del sistema:

Estado	Valor
VALIDO	0
BAJA	4
ANULADO CON NC	5

Tipos de documentos disponibles en el filtro

Tipo	Valor
FACTURA	1
BOLETA	3
NOTA DE CREDITO	7
GUIA REMISION	9

Estados de envio SUNAT disponibles en el filtro

Estado	Valor
NO ENVIADO	0
PENDIENTE	1
ENVIADO SUNAT OK	2
CON ERRORES	3

Comportamiento diferencial: Al guardar un filtro se ejecuta automaticamente la busqueda. Al eliminar un filtro (chip X) o al presionar Quitar filtros, tambien se ejecuta la busqueda automaticamente.

Tabla de documentos

La tabla principal muestra los documentos de venta con las siguientes columnas:

#	Columna	Descripcion	Formato
1	FECHA	Fecha y hora de emision	`DD/MM/YYYY hh:mm AM/PM`
2	TIPO COMPROBANTE	Tipo de documento emitido	Nombre del enum (ej: `FACTURA`, `BOLETA`, `NOTA DE CREDITO`, `GUIA REMISION`)
3	SERIE - NUMERO	Serie y numero correlativo	`\{serie\}-\{numero\}`
4	DNI & RUC	Numero de documento del cliente	Texto
5	CLIENTE	Nombre o razon social del cliente	Persona con DNI: `\{apellido_paterno\} \{apellido_materno\} \{nombres\}` / Otros: `\{razon_social\}`
6	NUM. VENTA	Serie y numero de la venta o documento de referencia	`\{serie\} - \{numero\}` (de `referencia_venta` o `nota_credito_documento_refercia`)
7	TOTAL	Monto total del comprobante	Numerico
8	ESTADO	Estado del documento (badge de color)	Ver tabla de estados
9	ENVIO SUNAT	Estado del envio a SUNAT (badge de color)	Ver tabla de envio SUNAT
10	ACCIONES	Boton de menu contextual (tres puntos `···`)	Ancho fijo 80 px

Estados del documento

Se muestran como badges (p-badge) con colores:

Estado	Valor	Color	Clase CSS
VALIDO	0	Azul	`bgblue`
BAJA	4	Rojo	`bgred`
ANULADO CON NC	5	Rosa	`bgpink`

Estados de envio SUNAT

Se muestran cuando el documento no esta en estado BAJA:

Estado	Valor	Color	Clase CSS
NO ENVIADO	0	Amarillo	`bgyellow`
PENDIENTE	1	Naranja	`bgorange`
ENVIADO SUNAT OK	2	Verde	`bggreen`
CON ERRORES	3	Rojo	`bgred`

Estados de baja envio SUNAT

Se muestran cuando el documento si esta en estado BAJA:

Estado	Valor	Color	Clase CSS
NO ENVIADO	0	Amarillo	`bgyellow`
PENDIENTE	1	Naranja	`bgorange`
ENVIADO SUNAT OK	2	Verde	`bggreen`
CON ERRORES	3	Rojo	`bgred`

Cuando se esta actualizando el estado SUNAT de un documento, se muestra un icono de spinner (pi-spin pi-spinner) junto al badge de estado de envio.

Paginacion

Debajo de la tabla se muestra:

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

Controles de navegacion identicos a Documentos de Ventas. Tamano de pagina: 50 registros.

Al hacer clic derecho o presionar los tres puntos (···), el menu contextual varia segun la combinacion de estado del documento + estado de envio SUNAT (o estado de baja envio SUNAT cuando esta en baja).

Estado VALIDO (0) + Envio SUNAT NO_ENVIADO (0)

Opcion	Icono	Accion
Detalles	`pi-eye`	Abre la pantalla de detalles
—	—	Separador
Baja	`pi-lock`	Cambia el estado a BAJA
—	—	Separador
Documento PDF	`pi-file-pdf`	Abre el reporte PDF
—	—	Separador
Enviar a Sunat	`pi-send`	Envia el documento a SUNAT

Estado VALIDO (0) + Envio SUNAT PENDIENTE (1)

Opcion	Icono	Accion
Detalles	`pi-eye`	Abre la pantalla de detalles
—	—	Separador
Baja	`pi-lock`	Cambia el estado a BAJA
—	—	Separador
Documento PDF	`pi-file-pdf`	Abre el reporte PDF
—	—	Separador
Actualizar estado SUNAT	`pi-replay`	Consulta y actualiza el estado desde SUNAT

Estado VALIDO (0) + Envio SUNAT ENVIADO_SUNAT_OK (2)

Opcion	Icono	Accion
Detalles	`pi-eye`	Abre la pantalla de detalles
—	—	Separador
Baja	`pi-lock`	Cambia el estado a BAJA
—	—	Separador
Documento PDF	`pi-file-pdf`	Abre el reporte PDF
—	—	Separador
Archivo UBL	`pi-cloud-download`	Descarga el archivo UBL (XML)
Archivo CDR	`pi-cloud-download`	Descarga el archivo CDR (ZIP)
—	—	Separador
Enviar correo	`pi-send`	Envia el documento por correo electronico
Enviar Whatsapp	`pi-send`	Envia el documento por WhatsApp

Estado VALIDO (0) + Envio SUNAT CON_ERRORES (3)

Opcion	Icono	Accion
Detalles	`pi-eye`	Abre la pantalla de detalles
—	—	Separador
Baja	`pi-lock`	Cambia el estado a BAJA
—	—	Separador
Documento PDF	`pi-file-pdf`	Abre el reporte PDF
—	—	Separador
Enviar a Sunat	`pi-send`	Reenvia el documento a SUNAT

Estado BAJA (4) + Baja Envio SUNAT NO_ENVIADO (0)

Opcion	Icono	Accion
Ver detalles	`pi-eye`	Abre la pantalla de detalles
—	—	Separador
Enviar a Sunat	`pi-send`	Envia la comunicacion de baja a SUNAT
—	—	Separador
Registor de actividades	`pi-lock`	Registro de actividades (sin funcionalidad implementada)

Estado BAJA (4) + Baja Envio SUNAT PENDIENTE (1)

Opcion	Icono	Accion
Detalles	`pi-eye`	Abre la pantalla de detalles
—	—	Separador
Actualizar estado SUNAT	`pi-replay`	Consulta y actualiza el estado de baja desde SUNAT
—	—	Separador
Registor de actividades	`pi-lock`	Registro de actividades (sin funcionalidad implementada)

Estado BAJA (4) + Baja Envio SUNAT ENVIADO_SUNAT_OK (2)

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

Estado BAJA (4) + Baja Envio SUNAT CON_ERRORES (3)

Opcion	Icono	Accion
Detalles	`pi-eye`	Abre la pantalla de detalles
—	—	Separador
Actualizar estado SUNAT	`pi-replay`	Actualiza el estado de baja desde SUNAT
—	—	Separador
Registor de actividades	`pi-lock`	Registro de actividades (sin funcionalidad implementada)

Detalles del documento

La accion Detalles abre una pantalla diferente segun el tipo de documento:

Factura o Boleta: Abre la pantalla de detalles del documento de venta (similar a Mis Documentos de Ventas)
Guia de Remision: Abre la pantalla de detalles de guia
Nota de Credito: Abre la pantalla de detalles de nota de credito

Reporte PDF

La accion Documento PDF abre un visor PDF diferente segun el tipo de documento:

Factura o Boleta: Visor de comprobante de venta
Guia de Remision: Visor de guia de remision
Nota de Credito: Visor de nota de credito

Todos los visores usan ngx-extended-pdf-viewer con las mismas herramientas descritas en Mis Documentos de Ventas.

Envio a SUNAT

Al seleccionar Enviar a Sunat, se muestra un dialogo de confirmacion:

Titulo: Confirmacion
Mensaje: Esta seguro de enviar a sunat el DOCUMENTO DE VENTA? (o DOCUMENTO DE GUIA para guias de remision)
Boton No: Cierra el dialogo
Boton Si: Procede con el envio (muestra spinner de carga)

Proceso de envio segun tipo de documento

Tipo	Endpoint	Descripcion
Factura (1)	`POST /webhooks/send`	Envio de factura electronica
Boleta (3)	`POST /webhooks/send`	Envio de boleta electronica
Guia Remision (9)	`POST /webhooks/guias/enviar`	Envio de guia de remision
Nota de Credito (7)	`POST /webhooks/notas-creditos/send`	Envio de nota de credito

El cuerpo del envio incluye:

\{
  "fe_cofigs": [parametros de facturacion electronica],
  "data": [datos completos del documento]
\}

Los parametros de facturacion electronica (fe_cofigs) se cargan al iniciar la pantalla desde el endpoint de parametros con domain CONFIG-ERPX-FACTURACION-FE y se almacenan en localStorage como params_fe.

Respuesta de envio

Al recibir la respuesta de SUNAT, se actualiza el documento con:

envio_sunat_token: Token del envio
envio_sunat_estado: Estado del envio (0-3)
envio_sunat_code: Codigo de respuesta
envio_sunat_message: Mensaje de respuesta

Notificacion de exito:

Titulo: Alerta
Mensaje: Documento venta enviado.
Duracion: 5 segundos

Envio de baja a SUNAT

Cuando un documento esta en estado BAJA y se selecciona Enviar a Sunat, el proceso es diferente:

Se envia la comunicacion de baja a SUNAT via POST /webhooks/baja
La respuesta actualiza los campos de baja:
- baja_envio_sunat_token
- baja_envio_sunat_estado
- baja_envio_sunat_message
Se actualiza el documento via PATCH /documentos-ventas/\{id\}/baja

Notificacion de exito:

Titulo: Alerta
Mensaje: Estado actualizado.
Duracion: 5 segundos

Actualizar estado SUNAT

Al seleccionar Actualizar estado SUNAT, el sistema:

Muestra un spinner junto al badge de estado de envio
Consulta el estado actual via GET /webhooks/obtener-estado/?token=\{token\}
Actualiza el documento con el nuevo estado
Si el documento esta en estado VALIDO, actualiza envio_sunat_estado
Si el documento esta en estado BAJA, actualiza baja_envio_sunat_estado

Descarga de archivos UBL y CDR

Archivo UBL (XML)

Al seleccionar Archivo UBL:

Si el documento ya tiene envio_sunat_ubl_file_id, descarga el archivo directamente desde el File Server
Si no lo tiene:
- Consulta GET /webhooks/obtener-ubl/?token=\{token\}
- Guarda el archivo en el File Server (POST /fserver/files/)
- Actualiza el documento con envio_sunat_ubl_file_id
- Descarga el archivo XML

Nombre del archivo: 20608424971-0\{tipo_documento\}-\{serie\}-\{numero\}.xml

Archivo CDR (ZIP)

Al seleccionar Archivo CDR:

Si el documento ya tiene envio_sunat_cdr_file_id, descarga el archivo directamente
Si no lo tiene:
- Consulta GET /webhooks/obtener-cdr/?token=\{token\}
- Guarda el archivo en el File Server
- Actualiza el documento con envio_sunat_cdr_file_id
- Descarga el archivo ZIP

Nombre del archivo: R-20608424971-0\{tipo_documento\}-\{serie\}-\{numero\}.zip

Cambio de estado (Baja)

Al seleccionar Baja desde el menu contextual, se muestra un dialogo con el mensaje: Estas seguro de proceder a cambiar el estado BAJA?

El formulario solicita dos campos obligatorios:

Campo	Tipo	Obligatorio	Mensaje de error
Fecha baja	Calendar (`p-calendar`)	Si	`* Obligatorio`
Motivo	Texto	Si	`* Obligatorio`

El motivo se convierte automaticamente a mayusculas antes de enviar.

Logica de baja segun estado de envio SUNAT

Si envio_sunat_estado = NO_ENVIADO (0): Solo se actualiza localmente via PATCH /documentos-ventas/\{id\}/baja con baja_envio_sunat_estado: 0
Si ya fue enviado a SUNAT: Se envia la comunicacion de baja a SUNAT via POST /webhooks/baja y luego se actualiza localmente con el token y estado recibidos

Baja de Nota de Credito

Cuando se da de baja una Nota de Credito (tipo_documento = 7), ademas del proceso normal, se actualiza el saldo del documento de referencia:

cobro_saldo = documento_referencia.cobro_saldo + nota_credito.monto_total

Esto restaura el saldo que fue reducido por la nota de credito original.

Notificacion de exito:

Titulo: Alerta
Mensaje: Estado actualizado.
Duracion: 5 segundos

Exportar a Excel

Al presionar el boton Exportar, el sistema valida:

Debe existir un filtro de fecha activo. Si no hay filtro de fecha:
- Titulo: Exportar a excel
- Mensaje: Tiene que filtrar minimo por la fecha
- Duracion: 5 segundos
El rango de fechas no debe superar 365 dias. Si excede:
- Titulo: Exportar a excel
- Mensaje: El filtro por la fecha tiene como maximo 3 meses para exportaciones
- Duracion: 5 segundos

Si la validacion es exitosa, se abre un dialogo para seleccionar el tipo de exportacion:

Tipo	Valor	Descripcion
LISTA DE DOCUMENTOS	1	Exporta la lista resumida de documentos
DETALLE DE DOCUMENTOS	2	Exporta los documentos con todos sus detalles

El archivo Excel se genera usando la libreria xlsx-js-style con formato y estilos aplicados.

Nuevo comprobante de venta (Factura / Boleta)

El formulario de nuevo comprobante es similar al descrito en Documentos de Ventas, con las siguientes particularidades para el sector salud:

Tipos de documento disponibles

Tipo	Valor
Boleta	3
Factura	1

Formas de pago

Forma	Valor
CONTADO	CONTADO
CREDITO	CREDITO

Fuente de ventas

Las ventas se buscan desde el endpoint de ventas salud (/v2.0.1/erpx/comercial/ventas-salud/) en lugar del endpoint de ventas regular.

Calculo de impuestos

El sistema utiliza el endpoint de impuestos (/v2.0.1/erpx/contabilidad/impuestos/calcular/) para calcular los montos de impuestos de cada detalle.

Generacion de QR

Se genera un codigo QR para el comprobante via POST /v2.0.1/erpx/global/qrcodes/generate/.

Conversion de montos a letras

Se utiliza la funcion NumeroALetras para convertir el monto total a texto en español (ej: "CIEN CON 00/100 SOLES").

Nueva nota de credito

Al seleccionar Nota de Credito desde el menu Nuevo, se abre un formulario a pantalla completa.

Titulo: Nuevo nota de credito Subtitulo: Aqui puede editar la lista de nota de credito

Campo principal

Campo	Tipo	Obligatorio	Placeholder	Mensaje de error
Documento venta	Autocompletado (`p-autoComplete`) con dropdown	Si	`Buscar...`	`* Obligatorio`

El autocompletado busca documentos de venta existentes y muestra: \{serie\}-\{numero\}.

Al seleccionar un documento de venta, se muestra:

Notas de credito generadas: Tabla con las notas de credito ya emitidas contra ese documento (columnas: SERIE, MONTO)
Datos del comprobante original
Formulario de la nota de credito con campos similares al comprobante de venta

Nuevo cliente

El formulario de nuevo cliente es identico al descrito en Mis Documentos de Ventas, permitiendo crear clientes tipo Persona o Empresa con todos sus sub-componentes (ubigeo, telefonos, correos, contactos, puntos de venta).

Endpoints

Los endpoints usan versiones especificas por recurso. Requieren los headers:

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