phpcfdi / cfdi-expresiones
Genera expresiones de CFDI 4.0, CFDI 3.3, CFDI 3.2, RET 1.0 y RET 2.0
Installs: 45 983
Dependents: 5
Suggesters: 3
Security: 0
Stars: 3
Watchers: 2
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.