phpcfdi/cfdi-expresiones

Genera expresiones de CFDI 4.0, CFDI 3.3, CFDI 3.2, RET 1.0 y RET 2.0

v3.2.0 2022-06-27 17:02 UTC

This package is auto-updated.

Last update: 2024-11-09 21:32:32 UTC


README

Source Code Packagist PHP Version Support Discord Latest Version Software License Build Status Reliability Maintainability Code Coverage Violations Total Downloads

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:

  1. Generar el c贸digo QR de una representaci贸n impresa de un CFDI o RET.
  2. 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.