Sistema completo de facturación electrónica para SUNAT Perú desarrollado con Laravel 12 y la librería Greenter 5.1. Este proyecto implementa todas las funcionalidades necesarias para la generación, envío y gestión de comprobantes de pago electrónicos según las normativas de SUNAT.
- ✅ Facturas (Tipo 01)
- ✅ Boletas de Venta (Tipo 03)
- 🏢 Multi-empresa: Gestión de múltiples empresas y sucursales
- 🔐 Autenticación OAuth2 para APIs de SUNAT
- 📄 Generación automática de PDF con diseño profesional
- Framework: Laravel 12 con PHP 8.2+
- SUNAT Integration: Greenter 5.1
- Base de Datos: MySQL/PostgreSQL compatible
- PDF Generation: DomPDF con plantillas personalizadas
- QR Codes: Endroid QR Code
- Authentication: Laravel Sanctum
- Testing: PestPHP
- PHP 8.2 o superior
- Composer
- MySQL 8.0+ o PostgreSQL
- Certificado digital SUNAT (.pfx)
- Clonar el repositorio
git clone clone https://github.com/yorchavez9/Api-de-facturacion-electronica-sunat-Peru.git
cd Api-de-facturacion-electronica-sunat-Peru- Instalar dependencias
composer install- Configurar variables de entorno
cp .env.example .env
php artisan key:generate- Configurar base de datos en .env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=facturacion_sunat
DB_USERNAME=tu_usuario
DB_PASSWORD=tu_password- Ejecutar migraciones
php artisan migrate- Configurar certificados SUNAT
- Colocar certificado .pfx en
storage/certificates/ - Configurar rutas en el archivo .env
Si necesitas convertir tu certificado de formato .pfx a .pem, ejecuta el siguiente comando en terminal:
# Convertir de .PFX a .PEM
openssl pkcs12 -in certificado.pfx -out certificado_correcto.pem -nodesNota: Este comando te pedirá la contraseña de tu certificado .pfx y generará un archivo .pem que puedes usar directamente en el sistema.
- Company: Empresas emisoras
- Branch: Sucursales por empresa
- Client: Clientes y proveedores
- Invoice/Boleta/CreditNote/DebitNote: Documentos electrónicos
- DailySummary: Resúmenes diarios de boletas
- CompanyConfiguration: Configuraciones por empresa
- DocumentService: Lógica de negocio para documentos
- SunatService: Integración con APIs de SUNAT
- PdfService: Generación de documentos PDF
- FileService: Gestión de archivos XML/PDF
- TaxCalculationService: Cálculo de impuestos
- SeriesService: Gestión de series documentarias
Aprende a implementar el sistema paso a paso: 👉 Ver Playlist Completa en YouTube
Esta playlist incluye:
- Instalación completa del sistema
- Configuración de certificados SUNAT
- Ejemplos reales de implementación
- Casos de uso prácticos
- Resolución de problemas comunes
Documentación completa y actualizada: 👉 https://apigo.apuuraydev.com/
Ejemplos listos para usar:
En el directorio ejemplos-postman/ encontrarás colecciones completas listas para importar en Postman o herramientas similares, con ejemplos de:
- Facturas, boletas y notas
- Guías de remisión
- Consultas CPE
- Configuraciones avanzadas
Este proyecto es de uso libre bajo las siguientes condiciones:
- ✅ Puedes usar, modificar y distribuir el código libremente
- ✅ Puedes usarlo para proyectos comerciales y personales
⚠️ Todo el uso es bajo tu propia responsabilidad⚠️ No se ofrece garantía ni soporte oficial⚠️ Debes cumplir con las normativas de SUNAT de tu país
- Asegúrate de tener los certificados digitales válidos de SUNAT
- Configura correctamente los endpoints según tu ambiente (beta/producción)
- Realiza pruebas exhaustivas antes de usar en producción
- Mantén actualizadas las librerías de seguridad
Si este proyecto te ha sido útil y deseas apoyar su desarrollo:
Número: 920468502
Contacto: https://wa.link/z50dwk
- Fork el proyecto
- Crea una rama para tu feature
- Envía un pull request
Para consultas técnicas o colaboraciones:
- WhatsApp: https://wa.link/z50dwk
- Yape: 920468502
⚡ Desarrollado con Laravel 12 y Greenter 5.1 para la comunidad peruana
"Facilitando la facturación electrónica en Perú - Un documento a la vez"