Download the PHP package codersfree/laravel-greenter without Composer
On this page you can find all versions of the php package codersfree/laravel-greenter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download codersfree/laravel-greenter
More information about codersfree/laravel-greenter
Files in codersfree/laravel-greenter
Package laravel-greenter
Short Description Laravel package for Greenter
License MIT
Homepage https://github.com/codersfree/laravel-greenter
Informations about the package laravel-greenter
Laravel Greenter (v2)
Laravel Greenter es un paquete para emitir comprobantes electrónicos desde Laravel utilizando Greenter. Permite:
- Firmar comprobantes digitalmente
- Enviarlos a SUNAT (SEE o API REST)
- Gestionar respuestas estructuradas (CDRs)
- Generar XML firmados
- Generar su representación impresa en PDF (HTML y PDF)
📚 Tabla de Contenidos
- 📦 Requisitos
- 🚀 Instalación
- ⚙️ Configuración Inicial
- 🏢 Datos de la Empresa Emisora
- 🛠️ Cambiar a Producción
- 🧰 Uso Básico
- 🧾 Emisión de Comprobante Electrónico
- 📨 Estructura de la Respuesta
- 📤 Métodos disponibles (Getters)
- 🔄 Convertir a Array
- 🔁 Emisión Dinámica para Múltiples Empresas
- 🔏 Gestión de XML
- 🧾 Generar XML Firmado
- 📨 Enviar XML existente
- 🎨 Generar Representación Impresa
- 🧾 HTML
- 🛠️ Generar Reporte sin Enviar a SUNAT
- 📦 Otros Tipos de Comprobantes
- 🎨 Personalizar Plantillas
- 🧪 Facades Disponibles
- 🔐 Seguridad Recomendada
- 📄 Licencia
📦 Requisitos
Este paquete requiere:
- PHP >= 8.1 (Laravel 13 requiere PHP >= 8.3)
- Laravel 10.x, 11.x, 12.x o 13.x
- Extensiones PHP:
soap,openssl,dom,xml - wkhtmltopdf (opcional, para generación de PDF)
🚀 Instalación
Instala el paquete con Composer:
Publica los archivos de configuración y recursos:
Esto generará:
config/greenter.php: configuración principal del paquetepublic/images/logo.png: logo usado en PDFspublic/certs/certificate.pem: certificado digital de prueba
⚙️ Configuración Inicial
🏢 Datos de la Empresa Emisora
En config/greenter.php, configura los datos de la empresa emisora:
🛠️ Cambiar a Producción
Cuando estés listo para pasar a producción, edita el archivo config/greenter.php, cambia el valor de mode a 'prod' y reemplaza las credenciales de prueba por las credenciales reales proporcionadas por SUNAT:
⚠️ Importante: Nunca subas tus certificados o credenciales a tu repositorio. Usa variables de entorno.
🧰 Uso Básico
🧾 Emisión de Comprobante Electrónico
Primero define los datos del comprobante:
⚠️ Importante: Para saber qué datos debes enviar según el tipo de comprobante que estés emitiendo, te recomendamos revisar la documentación oficial de greenter
Envía el comprobante a SUNAT:
📨 Estructura de la Respuesta
El método Greenter::send() devuelve una instancia de SendResultDTO. Esta clase encapsula toda la información del proceso de firma y envío.
Métodos disponibles (Getters)
Puedes acceder a los objetos y valores utilizando los getters de cada DTO:
Convertir a Array
Para facilitar la creación de APIs, todos los DTOs implementan un método toArray(). Ejemplo:
🔁 Emisión Dinámica para Múltiples Empresas
Para cambiar de empresa, credenciales o personalizar parámetros del reporte en tiempo de ejecución, utiliza el helper config() de Laravel antes de llamar a los métodos de Laravel Greenter.
🔏 Gestión de XML
Si necesitas manipular el XML manualmente o enviarlo posteriormente.
Generar XML Firmado
Genera el XML sin enviarlo a SUNAT:
Enviar XML existente
Si ya tienes un XML firmado y deseas enviarlo:
🎨 Generar Representación Impresa
🧾 HTML
Es necesario tener wkhtmltopdf instalado en el sistema para generar archivos PDF. Una vez instalado, configura la ruta del ejecutable en el archivo config/greenter.php:
🛠️ Generar Reporte sin Enviar a SUNAT
Si necesitas visualizar el PDF antes de enviar el comprobante o simplemente para pruebas, debes construir el documento usando los Builders:
📦 Otros Tipos de Comprobantes
Además de facturas, puedes emitir:
| Tipo de Comprobante | Código | Descripción |
|---|---|---|
| Factura | invoice |
Factura electrónica (01) |
| Boleta | invoice |
Boleta de venta (03) |
| Nota de Crédito | note |
Nota de crédito electrónica (07) |
| Nota de Débito | note |
Nota de débito electrónica (08) |
| Guía de Remisión | despatch |
Guía de remisión electrónica |
| Resumen Diario | summary |
Resumen diario de boletas (RC) |
| Comunicación de Baja | voided |
Comunicación de baja (RA) |
| Retención | retention |
Comprobante de retención |
| Percepción | perception |
Comprobante de percepción |
Consulta la documentación de Greenter para ver los campos específicos de cada uno.
🎨 Personalizar Plantillas
Publica las plantillas del reporte:
Ubicación por defecto:
resources/views/vendor/laravel-greenter
Puedes personalizar y cambiar la ruta:
🧪 Facades Disponibles
| Alias | Función principal |
|---|---|
Greenter |
Firma y envía comprobantes electrónicos |
GreenterXml |
Genera únicamente el XML firmado a partir de los datos. |
GreenterReport |
Genera HTML o PDF de la representación impresa |
🔐 Seguridad Recomendada
- Usa
.envpara tus claves y certificados - Nunca subas archivos sensibles al repositorio
- Protege rutas usando
storage_path()oconfig_path() - Valida los datos antes de emitir comprobantes
📄 Licencia
Este paquete está bajo licencia MIT. Desarrollado por CodersFree
All versions of laravel-greenter with dependencies
codersfree/report Version ^1.0
greenter/htmltopdf Version ^5.1
greenter/lite Version ^5.1
illuminate/console Version ^10.0|^11.0|^12.0|^13.0
illuminate/contracts Version ^10.0|^11.0|^12.0|^13.0
illuminate/filesystem Version ^10.0|^11.0|^12.0|^13.0
illuminate/support Version ^10.0|^11.0|^12.0|^13.0
illuminate/view Version ^10.0|^11.0|^12.0|^13.0