Información General
El sistema proporciona múltiples endpoints para generar reportes y estadísticas de ventas, permitiendo exportar datos en formatos PDF, Excel y TXT para presentación a SUNAT. Todos los reportes están filtrados automáticamente por la empresa activa del usuario autenticado.Estadísticas del Dashboard
Obtiene las estadísticas principales para mostrar en el dashboard del sistema.Respuesta
Descripción de Estadísticas
Exportación TXT para SUNAT
Genera un archivo TXT en formato PLE 14.1 (Registro de Ventas e Ingresos) para presentar a SUNAT.Query Parameters
Ejemplo de Solicitud
Formato del Archivo
El archivo generado sigue el formato PLE SUNAT con 35 campos separados por pipe (|):
Nombre del Archivo
LE20612706702202402001401001111.TXT
Exportación a Excel
Exporta el registro de ventas en formato Excel con formato y estilos.Query Parameters
Ejemplo de Solicitud
Contenido del Excel
- Título: “REGISTRO DE VENTAS - ”
- Fecha de generación
- Columnas: Documento, Fecha, Cliente, RUC/DNI, Subtotal, IGV, Total, Moneda, Estado, SUNAT
- Filas alternadas con colores para mejor lectura
- Total general al final
- Formato numérico con decimales
Nombre del Archivo
ventas-2024-03.xlsx
Reporte RVTA (Registro de Ventas SUNAT)
Genera un reporte Excel en formato detallado según los estándares de SUNAT para el Registro de Ventas.Query Parameters
Características
- Incluye CUO (Código Único de Operación)
- Tipo de documento cliente según tabla 2 SUNAT
- Campos para base imponible, IGV, exonerado, inafecto
- Totales por columna
- Formato según PLE 14.1
Columnas del Reporte
| Columna | Descripción |
|---|---|
| CUO | Código Único de Operación |
| Fecha Emisión | Fecha del comprobante |
| Tipo Doc | Código SUNAT (01=Factura, 03=Boleta) |
| Serie | Serie del documento |
| Número | Número correlativo |
| Tipo Doc Cliente | 1=DNI, 6=RUC, 0=Otros |
| Nro Doc Cliente | Documento del cliente |
| Razón Social | Nombre/razón social |
| Base Imponible | Monto gravado |
| IGV | IGV calculado (18%) |
| Exonerado | Ventas exoneradas |
| Inafecto | Ventas inafectas |
| Total | Importe total |
| Moneda | PEN/USD |
| Estado | VIGENTE/ANULADO |
Reporte de Ventas por Producto
Genera un reporte Excel agrupado por producto con totales de cantidad y montos vendidos.Query Parameters
Datos Incluidos
- Código del producto
- Nombre/descripción
- Unidad de medida
- Cantidad total vendida
- Número de ventas que incluyen el producto
- Subtotal, IGV y Total
- Ordenado por monto total descendente
Ejemplo de Uso
Reporte de Ganancias
Genera un reporte Excel detallado con el análisis de ganancias por producto vendido.Query Parameters
Cálculo de Ganancia
Columnas del Reporte
- Documento (tipo y número)
- Fecha de venta
- Cliente
- Producto
- Cantidad
- Precio de venta unitario
- Costo unitario
- Total de la venta
- Ganancia (con color verde/rojo según sea positiva/negativa)
Totales Incluidos
- Total de ventas
- Costo total
- Ganancia total
- Porcentaje de margen
Nombre del Archivo
Exportación a PDF
Genera un reporte PDF de ventas en formato horizontal (landscape) usando mPDF.Query Parameters
Ejemplo de Uso
Características del PDF
- Formato A4 horizontal
- Logo de la empresa
- Tabla con todas las ventas del periodo
- Totales al final
- Generado con mPDF
Autenticación en Reportes
Endpoints API (JSON)
Usan autenticación Bearer estándar:Endpoints de Descarga (PDF/Excel/TXT)
Requieren el token como query parameter debido al middlewareTokenFromQuery:
Filtros y Alcance
Tipos de Documento Incluidos
Los reportes principales incluyen:- id_tido = 1: Facturas (01)
- id_tido = 2: Boletas (03)
Estados de Documentos
Estado General (campo estado)
| Valor | Descripción |
|---|---|
| 1 | Activa |
| 2 | Anulada |
| A | Anulada |
| 3 | Vendida |
Estado SUNAT (campo estado_sunat)
| Valor | Descripción |
|---|---|
| 0 | Pendiente de envío |
| 1 | Enviado y aceptado |
| 2 | Rechazado por SUNAT |
Monedas
Tipo de Moneda (campo tipo_moneda)
- PEN: Soles peruanos (S/)
- USD: Dólares americanos ($)
Conversión
Cuando se requiere convertir montos, se usa el campotipo_cambio almacenado en la venta.
Formatos Numéricos
En Excel
En JSON
Cálculos Comunes
IGV (18%)
Cambio Porcentual
Margen de Ganancia
Permisos Requeridos
La mayoría de los endpoints de reportes requieren el permiso:routes/api.php: