Librería Comunitaria de Facturación Electrónica para Ecuador en PHP (v1.2.3) SRI Toolkit (matiz-studio-creative/sri-toolkit) es una librería comunitaria de código abierto (open-source) y framework-agnostic para PHP 8.2+ diseñada para implementar de principio a fin la Ficha Técnica de Comprobantes Electrónicos del Servicio de Rentas Internas (SRI) del Ecuador en esquema offline.
⚠️ Aviso importante (Proyecto No Oficial): Esta es una librería independiente desarrollada y mantenida por la comunidad. No es un producto oficial, ni está afiliada, patrocinada, respaldada ni mantenida por el Servicio de Rentas Internas (SRI) ni por ninguna entidad gubernamental del Ecuador.
¿Qué incluye la versión 1.2.3? El paquete está estructurado en módulos desacoplados bajo el namespace MTZ\Toolkit:
AccessKeyGenerator: Generación de la clave de acceso de 49 dígitos exigida en Ecuador con cálculo automático del dígito verificador (Módulo 11).
XMLMaker + Aritmética Exacta (brick/money): Constructores tipados para los 6 tipos de comprobantes electrónicos del Ecuador: Factura (01), Liquidación de Compra (03), Nota de Crédito (04), Nota de Débito (05), Guía de Remisión (06) y Comprobante de Retención (07), garantizando precisión decimal exacta en subtotales, descuentos e impuestos (IVA, ICE, IRBPNR).
XsdValidator: Validación offline del XML frente a los esquemas XSD técnicos del SRI Ecuador antes del firmado y envío.
Certificates & Signer: Lectura de certificados PKCS#12 (.p12 / .pfx) emitidos por entidades certificadoras acreditadas en Ecuador y firmado electrónico nativo en estándar XMLDSig / XAdES-BES.
Sender (SOAP Gateway): Cliente SOAP tipado para conectarse a los Web Services de Pruebas (celcer.sri.gob.ec) y Producción (cel.sri.gob.ec) con clasificación clara de respuestas y errores.
RideGenerator (RIDE en PDF): Renderizado automático del RIDE (Representación Impresa de Documento Electrónico) en formato PDF mediante Twig y Dompdf.
DocumentStore (Almacenamiento Local / S3): Guardado estructurado de XMLs (generados, firmados, autorizados) y PDFs RIDE en disco Local o Amazon S3 / Cloudflare R2.
Pipeline (Orquestador End-to-End): Ejecuta en un solo flujo la generación de clave, creación de XML, validación XSD, firma XAdES-BES, autorización SOAP, creación del RIDE PDF y almacenamiento.
¿Para quién es?
Desarrolladores PHP en Ecuador (Laravel, Symfony o PHP nativo) que buscan integrar facturación electrónica local en sistemas ERP, POS, SaaS o e-commerce sin depender de intermediarios de pago por documento.
¿Cómo se usa?
Instala el paquete con Composer: composer require matiz-studio-creative/sri-toolkit
Configura los datos del contribuyente ecuatoriano (RUC, establecimiento, punto de emisión, ambiente y archivo .p12).
Usa los módulos por separado o invoca Pipeline para completar todo el proceso en una sola llamada.
Descargo de responsabilidad: El nombre "SRI" se utiliza únicamente con fines descriptivos de compatibilidad técnica con el estándar de facturación electrónica del Ecuador. El uso de esta librería y el cumplimiento de las obligaciones tributarias vigentes son responsabilidad exclusiva del implementador y del contribuyente.
