PHPackages platinum-place/laravel-dgii - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. platinum-place/laravel-dgii ActiveLibrary[API Development](/categories/api) platinum-place/laravel-dgii =========================== Integration package for DGII (Electronic Invoicing e-CF) Dominican Republic. Automated signature, authentication, and submission for standard, consumption, and range cancellation documents. v1.3.10(1mo ago)83473MITBladePHP ^8.2CI passing Since Feb 16Pushed 1mo agoCompare [ Source](https://github.com/platinum-place/laravel-dgii)[ Packagist](https://packagist.org/packages/platinum-place/laravel-dgii)[ RSS](/packages/platinum-place-laravel-dgii/feed)WikiDiscussions main Synced 2d ago READMEChangelogDependencies (45)Versions (88)Used By (0) Laravel DGII ============ [](#laravel-dgii) [![Latest Version on Packagist](https://camo.githubusercontent.com/e9c475443f0771e718c0db58612c13a1145e28c59ccf8a5bd7f8003cf41c0697/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f706c6174696e756d2d706c6163652f6c61726176656c2d646769692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/platinum-place/laravel-dgii)[![Total Downloads](https://camo.githubusercontent.com/0e32d94a5084b8d000c72b0073e1344bf1feed42bc7f242ff2baca29d2701d27/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f706c6174696e756d2d706c6163652f6c61726176656c2d646769692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/platinum-place/laravel-dgii)[![GitHub License](https://camo.githubusercontent.com/4ee0de1a77d991a9a9f7c90eec293eada88207ee6c6de11342785534b3529d99/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f706c6174696e756d2d706c6163652f6c61726176656c2d646769692e7376673f7374796c653d666c61742d737175617265)](LICENSE) --- Filosofía del Paquete --------------------- [](#filosofía-del-paquete) Este paquete sigue una **filosofía de facilitador (enabler)**: - **El que sabe usar la DGII sabe usar el paquete.** - No intentamos "esconder" ni duplicar las validaciones o flujos de la DGII bajo modelos complejos o DTOs pesados. - El paquete es **100% libre de estado (stateless)** y no almacena credenciales ni claves en el archivo de configuración. Todo (entornos, tokens de acceso) se suministra en tiempo de ejecución por quien consume el método. - Facilitamos únicamente las partes complejas de la integración: 1. El **renderizado de los XMLs** requeridos por la DGII (e-CF estándar, de consumo, anulaciones y acuses) mediante plantillas Blade listas y optimizadas. 2. La **autenticación** mediante el flujo de intercambio Semilla -> Token de acceso. 3. La **comunicación HTTP** nativa optimizada con macros de Laravel para subir y consultar e-CF. Note La **firma digital PKCS#12** de los XMLs es responsabilidad de la aplicación que consume este paquete. Esto permite mantener la base del paquete ligera y libre de estado. --- Estructura de Directorios ------------------------- [](#estructura-de-directorios) - **Services (`src/Services/`):** Contiene los servicios internos encargados del renderizado de los XMLs (`DgiiXmlRender`) y del envío de peticiones HTTP a los servidores web de la DGII (`DgiiClient`). - **DgiiService (`src/Services/DgiiService.php`):** Gateway minimalista expuesto mediante el Facade `Dgii` que inyecta y orquesta los servicios internos para exponer firmas de métodos limpias. - **Templates (`resources/views/`):** Vistas Blade opcionales para la estructuración de XMLs de e-CF estándar, de consumo, anulaciones y acuses. --- Instalación ----------- [](#instalación) Instala el paquete mediante Composer: ``` composer require platinum-place/laravel-dgii ``` Publica el archivo de configuración opcional para endpoints y dominios: ``` php artisan vendor:publish --tag=dgii-config ``` --- Uso Rápido (vía Facades) ------------------------ [](#uso-rápido-vía-facades) Toda interacción pública se realiza a través del Facade `Dgii`. ### 1. Obtener Semilla y Autenticarse [](#1-obtener-semilla-y-autenticarse) ``` use PlatinumPlace\LaravelDgii\Facades\Dgii; // 1. Obtener semilla limpia desde la DGII $seedXml = Dgii::getSeed('testecf'); // testecf (sandbox), certecf (certificación), ecf (producción) // 2. [Tu aplicación] Firma digitalmente el XML de la semilla y guárdalo en un archivo. // 3. Intercambiar la semilla firmada por un access token oficial $authInfo = Dgii::verifySeed('testecf', '/ruta/a/semilla_firmada.xml'); $accessToken = $authInfo['token']; ``` ### 2. Generar Facturas (e-CF) [](#2-generar-facturas-e-cf) Puedes usar las plantillas Blade del paquete para renderizar tus e-CF a formato XML crudo. ``` use PlatinumPlace\LaravelDgii\Facades\Dgii; $invoiceData = [ 'IdDoc' => ['TipoeCF' => 31, 'eNCF' => 'E310000000001', ...], 'Emisor' => [...], 'Comprador' => [...], 'DetallesItems' => [...] ]; // Genera el XML limpio listo para ser firmado por tu aplicación $xml = Dgii::renderInvoice($invoiceData); // [Tu aplicación] Aplica la firma digital PKCS#12 al XML generado y guárdalo. ``` Para generar facturas de consumo (RFCE): ``` // Genera el XML de consumo limpio (requiere el código de seguridad e-CF de la firma original) $consumerXml = Dgii::renderConsumerInvoice($securityCode, $invoiceData); ``` ### 3. Enviar e-CF y Consultar Estatus [](#3-enviar-e-cf-y-consultar-estatus) ``` use PlatinumPlace\LaravelDgii\Facades\Dgii; // 1. Enviar el XML firmado a la DGII (especificando el ambiente, token y archivo) $result = Dgii::sendInvoice('testecf', $accessToken, '/ruta/al/comprobante_firmado.xml'); $trackId = $result['trackId']; // 2. Consultar el estado de procesamiento del comprobante mediante el trackId $status = Dgii::findInvoice('testecf', $accessToken, $trackId); ``` ### 4. Consultar Estatus de Servicios de la DGII [](#4-consultar-estatus-de-servicios-de-la-dgii) Para estos métodos de disponibilidad, asegúrate de tener configurada tu `DGII_API_KEY` en tu `.env`. ``` use PlatinumPlace\LaravelDgii\Facades\Dgii; // Consulta el estado general de disponibilidad de los servicios de la DGII $services = Dgii::getServiceStatus(); // Consulta las ventanas de mantenimiento programadas por la DGII $maintenance = Dgii::getMaintenanceWindows(); ``` --- Soporte y Consultoría --------------------- [](#soporte-y-consultoría) Si necesitas asistencia técnica con la implementación de este paquete o tienes dudas generales sobre el ecosistema de **Facturación Electrónica en la República Dominicana**, puedes contactarme directamente. Ofrezco servicios de consultoría especializada para empresas que buscan certificar sus sistemas ante la DGII. - **Contacto:** Mis métodos de contacto actualizados están disponibles en mi **[Perfil de GitHub](https://github.com/platinum-place)**. - **Issues:** Para errores del paquete, por favor abre un issue en este repositorio. --- Licencia -------- [](#licencia) Este proyecto está bajo la Licencia MIT. Consulta el archivo [LICENSE](LICENSE) para más detalles. ### Health Score 49 — FairBetter than 94% of packages Maintenance93 Actively maintained with recent releases Popularity19 Limited adoption so far Community8 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 87 Last Release 33d ago Major Versions v1.3.1 → v2.0.02026-05-10 ### Community Maintainers ![](https://www.gravatar.com/avatar/f286145bde27a2fe542f247d9a955ff93d55995c0497edd13a3a60347905a373?d=identicon)[platinum-place](/maintainers/platinum-place) --- Top Contributors [![platinum-place](https://avatars.githubusercontent.com/u/28694430?v=4)](https://github.com/platinum-place "platinum-place (158 commits)") --- Tags apidgiidgii-ecfdominican-republicfacturacion-electronicalaravellaravelfacturacion-electronicadgiie-CFdominican-republic ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/platinum-place-laravel-dgii/health.svg) ``` [![Health](https://phpackages.com/badges/platinum-place-laravel-dgii/health.svg)](https://phpackages.com/packages/platinum-place-laravel-dgii) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[defstudio/telegraph A laravel facade to interact with Telegram Bots 816333.9k3](/packages/defstudio-telegraph)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 77022.3M151](/packages/laravel-mcp)[api-platform/laravel API Platform support for Laravel 58171.6k14](/packages/api-platform-laravel)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.0k](/packages/simplestats-io-laravel-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)