Bienvenido a Santo Domingo Facturación Electrónica
Sistema completo de facturación electrónica diseñado específicamente para empresas peruanas, con integración directa con SUNAT para emitir facturas, boletas, notas de crédito/débito y guías de remisión electrónicas.Características Principales
Facturación SUNAT
Emisión de facturas y boletas electrónicas con envío directo a SUNAT
Guías Electrónicas
Guías de remisión remitente y transportista vía API GRE
Gestión de Inventario
Control completo de stock con movimientos automáticos
Finanzas Integradas
Caja, bancos, cuentas por cobrar/pagar en un solo lugar
Cotizaciones
Sistema de cotizaciones con conversión automática a ventas
Reportes y Analytics
Reportes detallados en Excel, PDF y formatos TXT contables
Módulos del Sistema
Facturación Electrónica
Facturación Electrónica
Emisión de facturas (01) y boletas (03) electrónicas con generación automática de XML, firma digital y envío a SUNAT. Incluye generación de códigos QR, PDFs personalizables y resumen diario para boletas.
Notas de Crédito y Débito
Notas de Crédito y Débito
Emisión de notas de crédito (07) para anulaciones, descuentos o devoluciones, y notas de débito (08) para aumentos de valor. Vinculadas automáticamente al documento original.
Guías de Remisión
Guías de Remisión
Guías de remisión electrónicas (09) vía GRE API de SUNAT. Soporta guías de remitente y transportista con consulta asíncrona de tickets.
Gestión de Compras
Gestión de Compras
Registro de compras con generación automática de cuentas por pagar, cronogramas de pago y control de días de crédito.
Inventario y Stock
Inventario y Stock
Control de productos con movimientos automáticos en ventas y compras, ajustes de inventario, kardex y alertas de stock bajo.
Módulo Financiero
Módulo Financiero
Sistema completo de caja con apertura/cierre, arqueo de billetes, gestión de cuentas bancarias, métodos de pago configurables y reportes de utilidades.
Integración con SUNAT
El sistema utiliza la biblioteca Greenter para comunicación con SUNAT:- SOAP API: Para facturas, boletas, notas de crédito/débito (envío sincrónico)
- GRE API REST: Para guías de remisión electrónicas (envío asíncrono con tickets)
- Resumen Diario: Para legalización de boletas ante SUNAT
- Comunicación de Baja: Para anulación de documentos ya aceptados
El sistema soporta tanto el ambiente de pruebas (BETA) como producción de SUNAT. Para pruebas, use el RUC
20000000001 con credenciales SOL MODDATOS/moddatos.Stack Tecnológico
Backend
Laravel 12 + PHP 8.2
Frontend
React 19 + Vite + Tailwind CSS
Base de Datos
MySQL
Bibliotecas Principales
- greenter/lite: Generación de XML y comunicación con SUNAT
- mpdf/mpdf: Generación de PDFs para documentos tributarios
- chillerlan/php-qrcode: Códigos QR para facturas electrónicas
- phpoffice/phpspreadsheet: Exportación e importación de Excel
- Laravel Sanctum: Autenticación API con tokens
- TanStack React Query: Gestión de estado y caché en frontend
Arquitectura del Sistema
El sistema sigue un patrón de arquitectura híbrida:- Backend API RESTful: Laravel gestiona la lógica de negocio, base de datos e integración con SUNAT
- Frontend React: Componentes montados en vistas Blade (no es un SPA tradicional)
- Navegación: Cargas de página completas, no enrutamiento del lado del cliente
- Servicios: Capa de servicios para lógica de negocio compleja (
SunatService,ProductoService,CajaService)
Este proyecto es un fork de
factura_ilidesava adaptado específicamente para Santo Domingo con una única empresa (id_empresa = 1) y esquema de colores personalizado (rojo #ef370f y crema #f79d72).Próximos Pasos
Inicio Rápido
Instala y configura el sistema en minutos
Primera Venta
Emite tu primera factura electrónica
Configurar SUNAT
Configura certificados digitales y credenciales SOL
Referencia API
Explora los endpoints disponibles
Soporte y Recursos
- Repositorio: github.com/Magus-Technologies/facturacion_santoDomingo
- SUNAT Documentación: cpe.sunat.gob.pe
- Greenter Docs: greenter.dev