phpcfdi / cfdi-expresiones
Genera expresiones de CFDI 4.0, CFDI 3.3, CFDI 3.2, RET 1.0 y RET 2.0
Installs: 51 526
Dependents: 5
Suggesters: 3
Security: 0
Stars: 4
Watchers: 1
Forks: 3
Open Issues: 0
Requires
- php: >=7.3
- ext-dom: *
- ext-mbstring: *
Requires (Dev)
- ext-json: *
- phpunit/phpunit: ^9.5
README
Genera expresiones de CFDI 4.0, CFDI 3.3, CFDI 3.2, RET 1.0 y RET 2.0
🇺🇸 The documentation of this project is in spanish as this is the natural language for intended audience.
🇲🇽 La documentación del proyecto está en español porque ese es el lenguaje principal de los usuarios.
Esta librerÃa contiene objetos de ayuda para crear expresiones de CFDI 3.2, CFDI 3.3, CFDI 4.0, RET 1.0 y RET 2.0 de acuerdo a la información técnica del SAT en el Anexo 20.
Estas expresiones se utilizan principalmente para dos motivos:
- Generar el código QR de una representación impresa de un CFDI o RET.
- Consultar el WebService del SAT de estado de un CFDI.
Ejemplo de expresión para CFDI 3.3 y CFDI 4.0:
Estas especificaciones comparten el mismo estándar.
https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=CEE4BE01-ADFA-4DEB-8421-ADD60F0BEDAC&re=POT9207213D6&rr=DIM8701081LA&tt=2010.01&fe=/OAgdg==
Ejemplo de expresión para CFDI 3.2:
?re=AAA010101AAA&rr=COSC8001137NA&tt=0000001234.567800&id=CEE4BE01-ADFA-4DEB-8421-ADD60F0BEDAC
Ejemplo de expresión para RET 1.0:
?&re=XAXX010101000&nr=12345678901234567890%tt=1234567890.123456&id=ad662d33-6934-459c-a128-BDf0393f0f44
Ejemplo de expresión para RET 2.0:
https://prodretencionverificacion.clouda.sat.gob.mx/?id=AAAAAAAA-BBBB-CCCC-DDDD-000000000000&re=Ñ&A010101AAA&nr=0000000000000000000X&tt=123456.78&fe=qsIe6w==
Instalación
Usa composer
composer require phpcfdi/cfdi-expresiones
Ejemplo básico de uso
<?php use PhpCfdi\CfdiExpresiones\DiscoverExtractor; // creamos el extractor $extractor = new DiscoverExtractor(); // abrimos el documento en un DOMDocument $document = new DOMDocument(); $document->load('archivo-cfdi.xml'); // obtenemos la expresión $expression = $extractor->extract($document); // y también podemos obtener los valores individuales $values = $extractor->obtain($document);
Soporte
Puedes obtener soporte abriendo un ticket en Github.
Adicionalmente, esta librerÃa pertenece a la comunidad PhpCfdi, asà que puedes usar los mismos canales de comunicación para obtener ayuda de algún miembro de la comunidad.
Compatibilidad
Esta librerÃa se mantendrá compatible con al menos la versión con soporte activo de PHP más reciente.
También utilizamos Versionado Semántico 2.0.0 por lo que puedes usar esta librerÃa sin temor a romper tu aplicación.
Cambiar de la versión 2.0.0 a la versión 3.0.0
La versión 3.0.0
agrega un método a la interfaz ExpressionExtractorInterface
por lo que es necesario crear una
versión mayor. Puedes actualizar con confianza si no generaste alguna clase que implemente ExpressionExtractorInterface
.
Contribuciones
Las contribuciones con bienvenidas. Por favor lee CONTRIBUTING para más detalles y recuerda revisar el archivo de tareas pendientes TODO y el archivo CHANGELOG.
Copyright and License
The phpcfdi/cfdi-expresiones
library is copyright © PhpCfdi
and licensed for use under the MIT License (MIT). Please see LICENSE for more information.