Documentos de Ventas

Que es Documentos de Ventas

El modulo Documentos de Ventas permite emitir comprobantes electronicos a partir de las ventas registradas en Sistema de Gestión Comercial. Soporta facturas, boletas de venta, documentos internos, guias de remision remitente y notas de credito. Incluye el flujo completo de envio electronico a SUNAT, consulta de estados, descarga de archivos UBL (XML) y CDR (ZIP), generacion de PDF y exportacion a Excel.

---

Acceso

Breadcrumb: Inicio > Facturacion > Mis documentos de Ventas

• Inicio redirige a /.
• Facturacion redirige a /facturacion.
• Mis documentos de Ventas es la pagina actual (sin enlace).

Titulo de pagina: "Documentos de Ventas" Subtitulo: "Muestra el listado y las herramientas para gestionar los documentos de ventas"

---

Barra de herramientas

Boton	Icono	Estilo	Descripcion
Exportar	pi pi-file-excel	Outlined	Abre el dialogo de exportacion a Excel. Requiere filtro de fecha obligatorio.
Actualizar	pi pi-refresh	Outlined, secundario	Recarga la tabla de documentos.
Nuevo	pi pi-plus	Raised, primario	Abre un menu popup con las opciones de creacion.

Menu "Nuevo"

Al presionar el boton Nuevo se despliega un menu con tres opciones:

Opcion	Icono	Descripcion
Comprobante	pi pi-plus	Abre el formulario para crear un nuevo comprobante de venta (Factura, Boleta o Documento interno).
Guia remision	pi pi-plus	Abre el formulario para crear una guia de remision remitente.
Nota de Credito	pi pi-plus	Abre el formulario para crear una nota de credito.

---

Barra de busqueda y filtros

Debajo de la barra de herramientas se ubica el componente de busqueda con los siguientes elementos:

Campo de busqueda de texto libre

Campo de texto con icono de busqueda (pi pi-search). Ocupa 4 columnas (33% del ancho).

Chips de filtros activos

Cada filtro aplicado se muestra como un chip removible. Al hacer clic en un chip se puede editar el filtro. Al presionar la X del chip se elimina el filtro.

Botones de filtros

Boton	Icono	Descripcion
Agregar filtro	pi pi-filter	Abre un overlay panel (350px) para configurar un nuevo filtro.
Quitar filtros	pi pi-filter-slash	Elimina todos los filtros activos y recarga la tabla con search=**.
Buscar	pi pi-search	Ejecuta la busqueda con los filtros configurados.

Tipos de filtros disponibles

Al presionar "Agregar filtro" se abre un panel con un dropdown para seleccionar el tipo de filtro:

#	Filtro	Valor	Campos mostrados	Descripcion
1	FECHA	1	Fecha inicio + Fecha fin (inputs tipo date)	Filtra por rango de fechas. Genera query: fecha:[YYYY-MM-DD TO YYYY-MM-DD].
2	SERIE	2	Serie (input texto)	Filtra por serie del comprobante. Genera query: serie:VALOR.
3	NUMERO	3	Numero (input texto)	Filtra por numero del comprobante. Genera query: numero:VALOR.
4	CLIENTE	4	Dropdown de clientes con busqueda remota	Filtra por cliente. Genera query: cliente_id:ID.
5	ESTADOS	5	MultiSelect con opciones de estado	Filtra por estado del documento. Genera query: estado:(0 OR 4 OR 5).
6	TIPOS DE DOCUMENTOS	6	MultiSelect con tipos de documento	Filtra por tipo. Genera query: tipo_documento:(1 OR 3 OR 7 OR 9).
7	ESTADOS DE ENVIOS SUNAT	7	MultiSelect con estados de envio	Filtra por estado de envio SUNAT.
8	ESTADOS DE BAJA ENVIOS SUNAT	8	MultiSelect con estados de baja	Filtra por estado de baja en SUNAT.
9	RUC EMISOR	9	Dropdown de unidades de negocio	Filtra por RUC del emisor.

Cada filtro tiene validacion obligatoria (* Obligatorio) y un boton Guardar para aplicarlo.

Busqueda remota de clientes en filtros

Al escribir en el dropdown de clientes se ejecuta:

GET /v2.0.2/erpx/comercial/clientes/?search=*\{TEXTO_MAYUSCULAS\}*&from=0&size=10

El formato del cliente es: numero_documento - razon_social (para RUC) o numero_documento - apellido_paterno apellido_materno nombres (para DNI).

---

Tabla de documentos

La tabla utiliza p-table con lazy loading, columnas redimensionables y scroll dinamico.

Columnas

#	Columna	Descripcion
1	FECHA	Fecha del documento en formato DD/MM/YYYY hh:mm A (12 horas con AM/PM).
2	RUC EMISOR	RUC de la unidad de negocio emisora (ruc_emisor).
3	TIPO COMPROBANTE	Tipo de documento formateado desde el enum.
4	SERIE - NUMERO	Concatenacion serie-numero del comprobante.
5	DNI & RUC	Numero de documento del cliente (cliente.numero_documento).
6	CLIENTE	Nombre del cliente: si es PERSONA con DNI muestra apellido_paterno apellido_materno nombres; si tiene RUC o es EMPRESA muestra razon_social.
7	NUM. VENTA	Serie y numero de la venta de referencia (referencia_venta.serie - referencia_venta.numero) o de la nota de credito referenciada.
8	TOTAL	Monto total del documento (monto_total).
9	ESTADO	Badge con el estado del documento (ver tabla de estados).
10	ENVIO SUNAT	Badge con el estado de envio a SUNAT. Si el documento esta en BAJA, muestra el estado de baja. Muestra spinner si hay una actualizacion en curso.
11	ACCIONES	Icono de tres puntos (pi pi-ellipsis-h, ancho fijo 80px) que abre el menu contextual.

Tipos de documento

Tipo	Valor	Nombre mostrado
Factura	1	FACTURA
Boleta	3	BOLETA
Nota de Credito	7	NOTA DE CREDITO
Guia de Remision	9	GUIA REMISION
Documento Interno	1001	DOCUMENTO INTERNO

Estados del documento

Estado	Valor	Color del badge
VALIDO	0	Azul (bgblue)
BAJA	4	Rojo (bgred)
ANULADO CON NC	5	Rosa (bgpink)

Estados de envio SUNAT

Estado	Valor	Color del badge
NO ENVIADO	0	Amarillo (bgyellow)
PENDIENTE	1	Naranja (bgorange)
ENVIADO SUNAT OK	2	Verde (bggreen)
CON ERRORES	3	Rojo (bgred)

Estados de baja en SUNAT

Estado	Valor	Color del badge
NO ENVIADO	0	Amarillo (bgyellow)
PENDIENTE	1	Naranja (bgorange)
ENVIADO SUNAT OK	2	Verde (bggreen)
CON ERRORES	3	Rojo (bgred)

Mensaje vacio

Cuando no hay registros: "No se encontraron datos" con icono pi pi-exclamation-triangle.

Indicador superior

"Mostrando pagina {N} con {X} registros de {Z} entradas"

---

Menu contextual

El menu contextual cambia dinamicamente segun el estado del documento y el estado de envio a SUNAT. Se activa con clic derecho o con el icono de tres puntos.

Documento VALIDO + No enviado a SUNAT

Opcion	Icono	Descripcion
Detalles	pi pi-eye	Ver detalles del documento (abre dialogo segun tipo).
—	—	(separador)
Baja	pi pi-lock	Dar de baja el documento.
—	—	(separador)
Documento PDF	pi pi-file-pdf	Generar y visualizar el PDF del documento.
—	—	(separador)
Enviar a Sunat	pi pi-send	Enviar el comprobante a SUNAT.

Documento VALIDO + Envio SUNAT Pendiente

Opcion	Icono	Descripcion
Detalles	pi pi-eye	Ver detalles.
—	—	(separador)
Baja	pi pi-lock	Dar de baja.
—	—	(separador)
Documento PDF	pi pi-file-pdf	Generar PDF.
—	—	(separador)
Actualizar estado SUNAT	pi pi-replay	Consultar el estado actual en SUNAT y actualizar.

Documento VALIDO + Enviado SUNAT OK

Opcion	Icono	Descripcion
Detalles	pi pi-eye	Ver detalles.
—	—	(separador)
Baja	pi pi-lock	Dar de baja.
—	—	(separador)
Documento PDF	pi pi-file-pdf	Generar PDF.
—	—	(separador)
Archivo UBL	pi pi-cloud-download	Descargar el archivo XML (UBL) del comprobante.
Archivo CDR	pi pi-cloud-download	Descargar el archivo ZIP (CDR) de respuesta SUNAT.
—	—	(separador)
Enviar correo	pi pi-send	Enviar el documento por correo electronico.
Enviar Whatsapp	pi pi-send	Enviar el documento por WhatsApp.

Documento VALIDO + Envio con errores

Opcion	Icono	Descripcion
Detalles	pi pi-eye	Ver detalles.
—	—	(separador)
Baja	pi pi-lock	Dar de baja.
—	—	(separador)
Documento PDF	pi pi-file-pdf	Generar PDF.
—	—	(separador)
Enviar a Sunat	pi pi-send	Reintentar el envio a SUNAT.

Documento en BAJA + Baja no enviada

Opcion	Icono	Descripcion
Ver detalles	pi pi-eye	Ver detalles.
—	—	(separador)
Enviar a Sunat	pi pi-send	Enviar la comunicacion de baja a SUNAT.

Documento en BAJA + Baja pendiente

Opcion	Icono	Descripcion
Detalles	pi pi-eye	Ver detalles.
—	—	(separador)
Actualizar estado SUNAT	pi pi-replay	Consultar estado de baja en SUNAT.

Documento en BAJA + Baja enviada OK

Opcion	Icono	Descripcion
Ver detalles	pi pi-eye	Ver detalles.
Documento PDF	pi pi-file-pdf	Generar PDF.

Documento en BAJA + Baja con errores

Opcion	Icono	Descripcion
Detalles	pi pi-eye	Ver detalles.
—	—	(separador)
Actualizar estado SUNAT	pi pi-replay	Consultar estado de baja en SUNAT.

---

Paginacion

Cada pagina muestra 50 registros (size: 50). Misma estructura de paginacion que otros modulos:

Control	Icono	Descripcion
Primera	pi pi-angle-double-left	Ir a la primera pagina.
Anterior	pi pi-angle-left	Ir a la pagina anterior.
Dropdown	—	Selector "X de Y" con filtro.
Siguiente	pi pi-angle-right	Ir a la pagina siguiente.
Ultima	pi pi-angle-double-right	Ir a la ultima pagina.

---

Crear comprobante de venta

Al seleccionar Comprobante del menu Nuevo se abre un p-dialog a pantalla completa (100% ancho y alto, no modal).

Titulo: "Nuevo documento de venta" Subtitulo: "Aqui puede editar la lista de documento de venta"

Estado de carga

Mientras carga los datos: "Cargando sus datos" con spinner y barra de progreso.

Datos iniciales

Se ejecutan multiples consultas en paralelo (forkJoin):

1. Ventas: GET /v2.0.2/erpx/comercial/ventas/?search=**&from=0&size=10
2. Impuestos IGV: GET /v2.0.1/erpx/contabilidad/impuestos/?search=** AND tipo:IGV&from=0&size=1000
3. Impuestos ISC: GET /v2.0.1/erpx/contabilidad/impuestos/?search=** AND tipo:ISC&from=0&size=1000
4. Unidades SUNAT: GET /v2.0.1/erpx/global/unidades-sunat/?search=**&from=0&size=1000
5. Clientes: GET /v2.0.2/erpx/comercial/clientes/?search=**&from=0&size=10
6. Conceptos: GET /v2.0.1/erpx/facturacion/documentos-ventas-conceptos/?search=**&from=0&size=1000
7. Series del colaborador

Campos principales del formulario

Campo	Tipo	Obligatorio	Descripcion
Venta	AutoComplete con busqueda remota	Si	Busca ventas por serie-numero. Al seleccionar una venta, se precargan todos los datos del comprobante.
Tipo documento	Dropdown	Si	FACTURA, BOLETA o DOCUMENTO INTERNO. La serie se asigna automaticamente segun el tipo.
Serie	Solo lectura	—	Se genera automaticamente segun el tipo de documento y la configuracion de series.
Numero	Solo lectura	—	Se genera automaticamente.
Fecha	Calendario con hora (DD/MM/YY, 12h)	Si	Fecha y hora de emision.
Moneda	Dropdown	Si	PEN (Soles) o USD (Dolares).
Cliente	Dropdown con busqueda remota	Si	Selecciona el cliente. Se preselecciona desde la venta.
Observacion	Textarea	No	Observaciones del documento.

Tabla de detalles (productos/servicios)

Cada detalle del comprobante contiene:

Campo	Descripcion
Concepto	Dropdown de conceptos (productos/servicios).
Descripcion	Descripcion del concepto.
Unidad	Unidad de medida SUNAT.
Cantidad	Cantidad de unidades.
Precio unitario	Precio por unidad.
IGV	Impuesto General a las Ventas.
Sub total	Cantidad x Precio unitario.

Resumen de totales

Campo	Descripcion
Sub total	Suma de subtotales de los detalles.
IGV	Total del IGV calculado.
Total	Sub total + IGV.
Total en letras	Monto total convertido a texto (ej: "CIEN CON 00/100 SOLES").

Botones del formulario

Boton	Icono	Descripcion
Cancelar	pi pi-times	Cierra el formulario sin guardar.
Guardar	pi pi-check	Valida y guarda el comprobante. Muestra spinner.

Endpoints de creacion segun tipo

Tipo	Endpoint
Factura	POST /v2.0.1/erpx/facturacion/documentos-ventas-facturas/
Boleta	POST /v2.0.1/erpx/facturacion/documentos-ventas-boletas/
Documento interno	POST /v2.0.1/erpx/facturacion/documentos-ventas-documentos-internos/

Resultado al guardar

Resultado	Severity	Mensaje	Duracion
Creacion exitosa	success	"Creado con exito"	5 segundos
Error de validacion	error	"Revise bien, hay formularios por validar."	5 segundos

---

Crear guia de remision

Al seleccionar Guia remision se abre un formulario a pantalla completa para crear una guia de remision remitente.

Campos principales

Campo	Tipo	Obligatorio	Descripcion
Serie	Input texto	Si	Serie de la guia.
Tipo documento	Solo lectura	—	Siempre "Guia de Remision Remitente".
Fecha	Calendario	Si	Fecha de emision.
Motivo de traslado	Dropdown	Si	Motivo del traslado de mercaderia.
Peso	Input numerico	Si	Peso total de la carga.
Numero de bultos	Input numerico	Si	Cantidad de bultos.

Seccion: Direccion de salida

Campo	Tipo	Obligatorio
Ubigeo	Cascada departamento/provincia/distrito	Si
Direccion	Input texto	Si

Seccion: Direccion de llegada

Campo	Tipo	Obligatorio
Ubigeo	Cascada departamento/provincia/distrito	Si
Direccion	Input texto	Si

Seccion: Transportista

Campo	Tipo	Obligatorio
Transportista	Dropdown con busqueda	Si
Conductor	Dropdown con busqueda	Si
Vehiculo	Dropdown con busqueda	Si

Endpoint

POST /v2.0.2/erpx/facturacion/guias-remisiones-remitentes/

---

Crear nota de credito

Al seleccionar Nota de Credito se abre un formulario para crear una nota de credito vinculada a un documento existente.

Campos principales

Campo	Tipo	Obligatorio	Descripcion
Documento referencia	AutoComplete	Si	Busca el comprobante al que se aplica la nota de credito.
Tipo	Dropdown	Si	Tipo de nota de credito (anulacion, correccion, etc.).
Motivo	Textarea	Si	Motivo de la nota de credito.
Monto	Input numerico	Si	Monto de la nota de credito.

Endpoint

POST /v2.0.2/erpx/facturacion/notas-creditos/

---

Dar de baja un documento

Al seleccionar Baja en el menu contextual se abre un dialogo modal de confirmacion (ancho 50vw).

Titulo: "Confirmacion" Icono: pi pi-exclamation-triangle (2rem) Mensaje: "Estas seguro de proceder a cambiar el estado BAJA?"

Campos adicionales para la baja

Campo	Tipo	Obligatorio	Mensaje de error
Fecha	Calendario con hora (DD/MM/YY, 12h)	Si	* Obligatorio
Motivo	Input texto	Si	* Obligatorio

El motivo se convierte a mayusculas automaticamente. La fecha se formatea como YYYY-MM-DD HH:mm:00.

Flujo de baja segun estado SUNAT

Botones

Boton	Estilo	Descripcion
No	Texto	Cierra sin dar de baja.
Si	Primario, con spinner	Ejecuta la baja.

Resultado

Resultado	Severity	Mensaje	Duracion
Baja exitosa	success	"Estado actualizado."	5 segundos
Error de validacion	error	"Revise bien, hay formularios por validar."	5 segundos

---

Enviar a SUNAT

Al seleccionar Enviar a Sunat se abre un dialogo modal de confirmacion (ancho 50vw).

Titulo: "Confirmacion" Icono: pi pi-exclamation-triangle (2rem) Mensaje: "Esta seguro de enviar a sunat el {TIPO}?" donde TIPO es "DOCUMENTO DE VENTA" o "DOCUMENTO DE GUIA".

Flujo de envio

Botones

Boton	Estilo	Descripcion
No	Texto	Cierra sin enviar.
Si	Primario, con spinner	Ejecuta el envio.

Resultado

Resultado	Severity	Mensaje	Duracion
Envio exitoso	success	"Documento venta enviado."	5 segundos
Envio de baja exitoso	success	"Estado actualizado."	5 segundos

---

Actualizar estado SUNAT

Al seleccionar Actualizar estado SUNAT el sistema:

1. Muestra un spinner en la columna ENVIO SUNAT del registro.
2. Consulta: GET /v2.0.2/erpx/facturacion/webhooks/obtener-estado/?token=\{envio_sunat_token\}
3. Actualiza el campo envio_sunat_estado (o baja_envio_sunat_estado si esta en BAJA) con PATCH.
4. Oculta el spinner y actualiza el badge.

---

Descargar archivos UBL y CDR

Archivo UBL (XML)

Al seleccionar Archivo UBL:

1. Si el archivo ya fue descargado previamente (envio_sunat_ubl_file_id no es nulo), se obtiene desde: GET /v2.0.1/erpx/fserver/files/\{id\} y se descarga directamente.
2. Si es la primera vez, se obtiene del webhook: GET /v2.0.2/erpx/facturacion/webhooks/obtener-ubl/?token=\{token\}, se guarda en el file server (POST /v2.0.1/erpx/fserver/files/) y se descarga.

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

Archivo CDR (ZIP)

Al seleccionar Archivo CDR:

1. Misma logica que UBL pero con envio_sunat_cdr_file_id y endpoint obtener-cdr.
2. Se descarga como archivo ZIP.

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

---

Exportar a Excel

Al presionar Exportar se valida:

1. Debe tener filtro de fecha: si no hay filtro de fecha, muestra: "Tiene que filtrar minimo por la fecha" (error, 5s).
2. Maximo 3 meses (365 dias): si el rango excede 365 dias, muestra: "El filtro por la fecha tiene como maximo 3 meses para exportaciones" (error, 5s).

Si pasa la validacion, se abre un dialogo modal (50vw) con:

Campo	Tipo	Descripcion
Customizar nombre de archivo	Input texto con boton refresh	Nombre del archivo Excel. El boton refresh restaura el nombre por defecto. Tooltip: "Puede customizar el nombre del archivo a exportar."
Exportar	Dropdown	Tipo de exportacion a realizar. Tooltip: "Seleccione la exportacion a realizar."

Botones

Boton	Descripcion
Cancelar	Cierra sin exportar.
Exportar	Genera el archivo Excel con los documentos filtrados.

---

Ver detalles

Al seleccionar Detalles se abre un dialogo a pantalla completa segun el tipo de documento:

• Factura/Boleta: componente details-documento-venta — muestra tipo documento, serie, numero, datos de la venta, cliente, detalles de productos/servicios, totales y observaciones.
• Guia de Remision: componente details-documento-guia — muestra datos de la guia, direcciones, transportista y observaciones.
• Nota de Credito: componente details-nota-credito — muestra documento de referencia, motivo, monto y observaciones.

Cada vista de detalle incluye una seccion de observaciones donde se pueden consultar las observaciones del documento.

---

Crear cliente persona

Desde el formulario de comprobante de venta se puede crear un nuevo cliente persona sin salir del flujo. El formulario incluye:

• Datos personales (tipo documento, numero, nombre, apellidos)
• Lookup RENIEC/SUNAT (consulta por DNI o RUC)
• Telefonos (FormArray dinamico)
• Correos (FormArray dinamico)
• Ubicacion (ubigeo en cascada: pais > departamento > provincia > distrito)
• Puntos de venta asignados
• Contactos adicionales

---

Endpoints del modulo

Documentos de Ventas

Metodo	Endpoint	Descripcion
GET	/v2.0.3/erpx/facturacion/documentos-ventas/?search=\{filtro\}&from=\{offset\}&size=\{tamano\}	Listar documentos
GET	/v2.0.3/erpx/facturacion/documentos-ventas/\{id\}	Obtener documento por ID
POST	/v2.0.3/erpx/facturacion/documentos-ventas/	Crear documento
PUT	/v2.0.3/erpx/facturacion/documentos-ventas/\{id\}	Actualizar documento
PATCH	/v2.0.3/erpx/facturacion/documentos-ventas/\{id\}	Actualizar parcialmente
PATCH	/v2.0.3/erpx/facturacion/documentos-ventas/\{id\}/baja	Dar de baja
DELETE	/v2.0.3/erpx/facturacion/documentos-ventas/\{id\}	Eliminar documento

Creacion por tipo

Metodo	Endpoint	Descripcion
POST	/v2.0.1/erpx/facturacion/documentos-ventas-facturas/	Crear factura
POST	/v2.0.1/erpx/facturacion/documentos-ventas-boletas/	Crear boleta
POST	/v2.0.1/erpx/facturacion/documentos-ventas-documentos-internos/	Crear documento interno

Notas de Credito

Metodo	Endpoint	Descripcion
POST	/v2.0.2/erpx/facturacion/notas-creditos/	Crear nota de credito
GET	/v2.0.2/erpx/facturacion/notas-creditos/\{id\}	Obtener nota por ID

Guias de Remision Remitente

Metodo	Endpoint	Descripcion
GET	/v2.0.2/erpx/facturacion/guias-remisiones-remitentes/?search=\{filtro\}	Listar guias
GET	/v2.0.2/erpx/facturacion/guias-remisiones-remitentes/\{id\}	Obtener guia por ID
POST	/v2.0.2/erpx/facturacion/guias-remisiones-remitentes/	Crear guia
PATCH	/v2.0.2/erpx/facturacion/guias-remisiones-remitentes/\{id\}	Actualizar guia

Envio a SUNAT (Webhooks)

Metodo	Endpoint	Descripcion
POST	/v2.0.2/erpx/facturacion/webhooks/send	Enviar factura/boleta a SUNAT
POST	/v2.0.2/erpx/facturacion/webhooks/guias/enviar	Enviar guia a SUNAT
POST	/v2.0.2/erpx/facturacion/webhooks/notas-creditos/send	Enviar nota credito a SUNAT
POST	/v2.0.2/erpx/facturacion/webhooks/baja	Enviar comunicacion de baja
GET	/v2.0.2/erpx/facturacion/webhooks/obtener-estado/?token=\{token\}	Consultar estado SUNAT
GET	/v2.0.2/erpx/facturacion/webhooks/obtener-ubl/?token=\{token\}	Obtener archivo UBL
GET	/v2.0.2/erpx/facturacion/webhooks/obtener-cdr/?token=\{token\}	Obtener archivo CDR

Otros endpoints consumidos

Metodo	Endpoint	Descripcion
GET	/v2.0.2/erpx/comercial/ventas/	Ventas para vincular
GET	/v2.0.2/erpx/comercial/clientes/	Clientes
GET	/v2.0.1/erpx/comercial/puntos-ventas/	Puntos de venta
GET	/v2.0.1/erpx/contabilidad/impuestos/	Impuestos IGV/ISC
POST	/v2.0.1/erpx/contabilidad/impuestos/calcular/	Calcular impuestos
GET	/v2.0.1/erpx/facturacion/documentos-ventas-conceptos/	Conceptos
GET	/v2.0.1/erpx/global/unidades-sunat/	Unidades de medida SUNAT
GET	/v2.0.1/erpx/global/unidades-negocios/	Unidades de negocio (RUC emisor)
GET	/v2.0.1/erpx/global/params/	Parametros de configuracion
GET	/v2.0.1/erpx/global/paises/	Paises
GET	/v2.0.1/erpx/global/zonas/	Zonas (ubigeo)
GET	/v2.0.1/erpx/global/qrcodes/generate/	Generar codigos QR
GET	/v2.0.1/erpx/fserver/files/\{id\}	Obtener archivo del file server
POST	/v2.0.1/erpx/fserver/files/	Guardar archivo en file server
POST	/v2.0.1/erpx/reports/factory/generate/	Generar reportes PDF
GET	/v2.0.1/erpx/logistica/proveedores/	Proveedores (transportistas)
GET	/v2.0.1/erpx/comercial/transportes-conductores/	Conductores
GET	/v2.0.1/erpx/comercial/transportes-vehiculos/	Vehiculos
GET	/v2.0.1/erpx/comercial/transportes-paquetes/	Paquetes

Headers requeridos: Authorization: Bearer \{token\}, enterprise-id: \{id\}, accept: application/json.

Parametros de facturacion electronica: se almacenan en localStorage bajo la clave params_fe con dominio CONFIG-ERPX-FACTURACION-FE.

---

Manejo de errores

Codigo HTTP	Mensaje mostrado
400, 402	Muestra directamente error.error.errors[0] (primer error del array)
404	"No se encontro el servidor de respuestas, consulte con el Administrador. ERROR 404"
500	"Error interno del servidor. ERROR 500"
Otro	"Error 404 consulte con su admin."

Todas las notificaciones de error usan: severity: 'error', summary: 'Error \{status\}', duracion 5 segundos.

---

Problemas comunes

Problema	Causa	Solucion
No puedo exportar a Excel	No hay filtro de fecha aplicado.	Agrega un filtro de tipo FECHA con rango de inicio y fin antes de exportar.
"El filtro por la fecha tiene como maximo 3 meses"	El rango de fechas excede 365 dias.	Reduce el rango de fechas a un maximo de 12 meses.
No aparece la opcion "Archivo UBL"	El documento no ha sido enviado a SUNAT o tiene errores.	Solo los documentos con estado "ENVIADO SUNAT OK" tienen disponibles los archivos UBL y CDR.
"Revise bien, hay formularios por validar"	Hay campos obligatorios sin completar en el formulario.	Completa todos los campos marcados con (*).
El badge de ENVIO SUNAT muestra spinner	Se esta consultando el estado a SUNAT.	Espera a que termine la consulta. Si persiste, recarga la pagina.
No encuentro la venta en el autocompletado	La venta no esta entre los primeros 10 resultados.	Escribe parte de la serie o numero de la venta para buscar remotamente.
"NESESITA DAR DE BAJA ESTOS DOCUMENTOS PREVIAMENTE"	El documento tiene notas de credito o guias vinculadas activas.	Da de baja primero los documentos vinculados y luego el documento principal.
No puedo dar de baja despues de enviar a SUNAT	Es el comportamiento esperado: se debe enviar la comunicacion de baja a SUNAT.	El sistema envia automaticamente la comunicacion de baja al confirmar.

---

Paginas relacionadas

• Mis Documentos de Ventas — vista personal del colaborador
• Documentos de Ventas Salud — comprobantes para el sector salud
• Sistema de Gestión Comercial — ventas que generan los documentos
• Finanzas — cobros asociados a los comprobantes
• Seguridad — permisos de acceso al modulo