README

生成 CFDI 4.0、CFDI 3.3、CFDI 3.2、RET 1.0 和 RET 2.0 的表达式

🇺🇸 本项目的文档使用西班牙语编写，因为这是目标受众的自然语言。

🇲🇽 本项目的文档使用西班牙语，因为那是主要用户群体的语言。

这个库包含用于创建 CFDI 3.2、CFDI 3.3、CFDI 4.0、RET 1.0 和 RET 2.0 表达式的辅助对象，这些对象根据 SAT 技术附件 20 的信息。

这些表达式主要用于以下两个目的

1. 生成 CFDI 或 RET 打印表示的 QR 码。
2. 查询 SAT 的 CFDI 状态 WebService。

CFDI 3.3 和 CFDI 4.0 的表达式示例

这些规范具有相同的标准。

https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=CEE4BE01-ADFA-4DEB-8421-ADD60F0BEDAC&re=POT9207213D6&rr=DIM8701081LA&tt=2010.01&fe=/OAgdg==

CFDI 3.2 的表达式示例

?re=AAA010101AAA&rr=COSC8001137NA&tt=0000001234.567800&id=CEE4BE01-ADFA-4DEB-8421-ADD60F0BEDAC

RET 1.0 的表达式示例

?&re=XAXX010101000&nr=12345678901234567890%tt=1234567890.123456&id=ad662d33-6934-459c-a128-BDf0393f0f44

RET 2.0 的表达式示例

https://prodretencionverificacion.clouda.sat.gob.mx/?id=AAAAAAAA-BBBB-CCCC-DDDD-000000000000&re=Ñ&A010101AAA&nr=0000000000000000000X&tt=123456.78&fe=qsIe6w==

安装

使用 composer

composer require phpcfdi/cfdi-expresiones

基本使用示例

<?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);

支持

您可以通过在 Github 上创建一个工单来获得支持。

此外，这个库属于 PhpCfdi 社区，因此您可以使用相同的沟通渠道来从社区成员那里获得帮助。

兼容性

本库将保持与最新 PHP 支持版本 的兼容性。

我们也使用 语义化版本 2.0.0，因此您可以使用这个库而无需担心破坏您的应用程序。

从版本 2.0.0 切换到版本 3.0.0

版本 3.0.0 为 ExpressionExtractorInterface 接口添加了一个方法，因此需要创建一个更大的版本。如果您没有创建实现 ExpressionExtractorInterface 的任何类，您可以放心地更新。

贡献

欢迎贡献。请阅读 CONTRIBUTING 以获取更多详细信息，并请记得检查待办事项列表 TODO 和 CHANGELOG 文件。

版权和许可证

phpcfdi/cfdi-expresiones 库版权所有 © PhpCfdi，并根据 MIT 许可证（MIT）许可使用。有关更多信息，请参阅 LICENSE。