Funcionalidades principales
El sistema ofrece una solución completa para la gestión comercial y tributaria de empresas peruanas, con todas las herramientas necesarias para operar bajo la normativa SUNAT.Facturación electrónica
Facturas electrónicas
Emisión de facturas (tipo 01) con envío síncrono a SUNAT vía SOAP. Generación automática de XML firmado digitalmente y recepción de CDR.
Boletas de venta
Boletas de venta (tipo 03) con Resumen Diario automático. Compatible con ventas al contado y crédito con cuotas.
Notas de crédito
Notas de crédito (tipo 07) vinculadas a documentos de venta. Incluye motivos SUNAT: anulación, descuentos, devoluciones, etc.
Notas de débito
Notas de débito (tipo 08) para aumentar el importe de facturas. Motivos: intereses por mora, aumentos en operaciones, penalidades.
Generación de XML y firma digital
El sistema utiliza el servicioSunatService.php (~700+ líneas) que maneja toda la lógica SUNAT:
Los archivos XML y CDR se almacenan en
storage/app/sunat/ organizados por RUC:xml/{ruc}/para documentos XML generadoscdr/{ruc}/para constancias de recepción de SUNAT
Guías de remisión electrónicas
GRE - Guía remitente
Guías de remisión electrónicas (tipo 09) mediante API REST de SUNAT. Flujo asíncrono con tickets y consulta de estado.
Motivos de traslado
Compatible con todos los motivos SUNAT: venta, compra, traslado entre establecimientos, devolución, consignación, etc.
Flujo asíncrono GRE
Las guías utilizan OAuth 2.0 y retornan un ticket que debe consultarse:La API GRE requiere credenciales OAuth separadas configuradas en
SUNAT_GRE_CLIENT_ID y SUNAT_GRE_CLIENT_SECRET.Gestión de productos e inventario
Control de stock
Gestión de inventario por almacén con stock en tiempo real. Movimientos automáticos en compras y ventas.
Productos y servicios
Catálogo completo con código, nombre, precio, unidades SUNAT, categorías y códigos de barras.
Movimientos de stock
Registro de entradas, salidas, ajustes y transferencias. Trazabilidad completa con usuario y fecha.
Importación Excel
Carga masiva de productos desde Excel. Plantilla descargable con validación de datos.
Servicio de productos
ElProductoService.php maneja toda la lógica de stock:
Gestión comercial
Ventas
Registro de ventas con múltiples productos y servicios. Soporte para descuentos, IGV, percepciones y detracciones.
Compras
Control de compras a proveedores con ingreso automático al stock. Compatible con facturas y boletas de proveedores.
Cotizaciones
Sistema de cotizaciones con conversión a ventas. Estados: pendiente, aceptada, rechazada, vencida.
Clientes y proveedores
Registro completo con RUC/DNI, dirección, contacto. Búsqueda automática en SUNAT/RENIEC.
Formas de pago
Soporte para ventas al contado y crédito:Reportes y exportaciones
PDFs personalizados
Generación de PDFs con mPDF en formatos A4 y ticket térmico. Plantillas personalizables por empresa.
Exportación Excel
Reportes de ventas, compras y productos con formato SUNAT (PLE). Estilos personalizados con PhpSpreadsheet.
Registro de ventas (RVTA)
Exportación TXT formato SUNAT para Libro Electrónico de Ventas (PLE-VENTAS).
Reportes de ganancias
Análisis de rentabilidad por producto, período y cliente. Exportación a Excel con gráficos.
Endpoints de exportación
Operaciones SUNAT avanzadas
Resumen Diario
Envío de Resumen Diario de boletas (RC). Proceso asíncrono con generación de ticket y consulta posterior.
Comunicación de Baja
Anulación de documentos electrónicos mediante Comunicación de Baja. Compatible con facturas, notas y guías.
Consulta de comprobantes
Verificación de validez de comprobantes en SUNAT. Consulta por RUC, tipo, serie y número.
Modo beta y producción
Cambio fácil entre entorno de pruebas (beta) y producción. Certificados y credenciales por empresa.
Resumen Diario
Las boletas requieren un proceso adicional:Sistema de permisos
Roles y permisos
Sistema granular de permisos por recurso y acción:
ventas.create, productos.view, reportes.export, etc.Usuarios multi-empresa
Cada usuario puede pertenecer a múltiples empresas y cambiar entre ellas sin cerrar sesión.
Middleware de permisos
El rol Admin (rol_id=1) tiene acceso completo a todos los recursos sin verificación de permisos.
Configuración empresarial
Multi-empresa
Gestión de múltiples empresas con RUC, razón social, dirección y logo. Cada empresa con sus propios certificados SUNAT.
Series de documentos
Configuración de series para cada tipo de documento: F001 (facturas), B001 (boletas), T001 (guías), FC01/BC01 (notas).
Plantillas de impresión
Personalización de PDFs por empresa: logo, colores, footer, datos de contacto y textos legales.
Certificados digitales
Gestión de certificados .pem por empresa. Soporte para modo beta con certificado de prueba compartido.
Cambio de empresa activa
Dashboard y estadísticas
Dashboard ejecutivo
Vista general con ventas del día, mes y año. Gráficos de evolución y productos más vendidos.
Estadísticas en tiempo real
Totales de comprobantes emitidos, estado SUNAT, pendientes de envío y anulados.
Integración frontend
El frontend React está organizado por features:Cada módulo sigue el patrón:
page.jsx → columns/ → hooks/ → servicios API. Los hooks llaman a servicios en resources/js/services/ que manejan fetch con tokens.Características técnicas adicionales
- Autenticación Sanctum: Tokens Bearer almacenados en
localStorage - PDF con tokens en URL: Middleware
TokenFromQuerypermite?token=para descargas - Búsqueda SUNAT/RENIEC: Integración para validar y autocompletar datos de RUC/DNI
- Ubigeos INEI: Base de datos completa de departamentos, provincias y distritos
- Validaciones SUNAT: Formato de RUC, series, numeración correlativa
- Timezone Perú: Todos los DateTime en America/Lima para correcta generación XML
- Code formatting: Laravel Pint para backend, Prettier para frontend
Ver documentación API
Explora todos los endpoints disponibles con ejemplos de request/response.