Firmador de XML especializado para cumplir con los estándares de Facturación Electrónica (e-CF) de la Dirección General de Impuestos Internos (DGII) en la República Dominicana.

Read in English 🇺🇸

• Estándar XMLDSig: Implementación robusta basada en selective/xmldsig.
• Canonicalización Especial: Ajustes técnicos en la normalización C14N requeridos por el validador oficial de la DGII.
• Soporte Certificados: Compatible con archivos .p12 y .pfx.
• Ligero: Diseñado para ser integrado fácilmente en cualquier proyecto PHP o framework (Laravel, Symfony, etc.).

Este proyecto se basa directamente en las especificaciones del Instructivo sobre Facturación Electrónica: Firmado de e-CF publicado por la DGII.

Para la implementación técnica, utilizamos como base la librería selective/xmldsig. Esta librería es la recomendada (e ilustrada) por la DGII en sus manuales para desarrolladores PHP. Sin embargo, para lograr una validación exitosa en los servidores oficiales, es necesario realizar ajustes manuales que no están detallados de forma explícita en la documentación general.

Aunque la documentación de la DGII proporciona ejemplos, existen detalles críticos en la implementación de la librería base que deben ajustarse para que el XML sea aceptado.

Según el instructivo de la DGII, es imperativo modificar la clase XmlSigner.php de la librería selective/xmldsig para forzar una canonicalización sin comentarios.

1. Ajuste de Canonicalización General: En la clase XmlSigner, se debe asegurar que el método C14N se llame con los parámetros correctos para excluir comentarios:

   // Cambiar de:
   $canonicalData = $element->C14N(true, false);
   // A:
   $canonicalData = $element->C14N(false, false);

2. Ajuste en SignedInfo (Línea 179 aprox.): Para la firma del bloque SignedInfo, se requiere una normalización aún más estricta:

   // Cambiar de:
   $c14nSignedInfo = $signedInfoElement->C14N(true, false);
   // A:
   $c14nSignedInfo = $signedInfoElement->C14N();

Nota: Este paquete ya incluye estas correcciones aplicadas de forma nativa en su clase XmlSigner, por lo que no necesitas modificar nada en tu carpeta vendor.

La documentación menciona que la librería fue probada en PHP versiones 8.1.12 y 8.1.13, si utilizas el paquete en una version mas reciente, como 8.4 o 8.5, la validación falla debido a que el cifrado RC2-40-CBC utilizado en los archivos .p12 cambió en las versiones más recientes de OpenSSL, que normalmente vienen con PHP 8.2 en adelante.

Para solucionarlo, debemos modificar el archivo openssl.cnf para que admita el cifrado que necesitamos, cambiando la configuración por defecto al modo "legacy".

1. Edita el archivo openssl.cnf con el siguiente comando:

   sudo nano /etc/ssl/openssl.cnf

2. Busca la sección [default_sect] y cámbiarla a:

    [default_sect]
    activate = 1

3. Luego, busca la sección [legacy_sect] y cámbiarla a:

    [legacy_sect]
    activate = 1

4. Por último, busca la sección [provider_sect] y cámbiarla a:

    [provider_sect]
    default = default_sect
    legacy = legacy_sect

5. Finalmente, guardar los cambios, salir del archivo y reiniciar el entorno.

composer require platinum-place/php-dgii-xml-signer

use PlatinumPlace\DgiiXmlSigner\SignManager;

$signer = new SignManager();

// Leer el certificado
$certContent = file_get_contents('path/to/certificate.p12');
$password = 'tu_password';

// XML a firmar
$xml = '<root>...</root>';

// Firmar
$signedXml = $signer->sign($certContent, $password, $xml);

file_put_contents('signed_invoice.xml', $signedXml);

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.
• Issues: Para errores del paquete, por favor abre un issue en este repositorio.

• Documentación Oficial DGII - Facturación Electrónica: Portal principal con toda la normativa y documentación técnica.
• Instructivo de Firmado de e-CF (PDF): Guía técnica detallada sobre el proceso de firma digital.
• Librería Base: selective/xmldsig: Repositorio de la librería utilizada como motor de firma.

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.