README

用于生成与授权的SEFAZ通信的NFe，并旨在提供生成、签名和发送SEFAZ Sped NFe项目数据的手段。

更新

• NT 2020.006 中间商
• NT 2020.007 NFe中的运输相关方事件 - 运输者
• NT 2021_001 交付证明事件
• NT 2021.004 v1.20 验证规则和新字段（自2022年5月16日起在生产中有效）
• NT 2023.001 v1.10 创建和更新验证规则以符合ICMS单一税制（自2023年3月30日起有效）
• NT 2023.001 v1.20 燃料单一税制（于2023年4月20日通过测试并在2023年5月1日投入生产）

注意：即使字段尚未要求，这些NT主要影响TXT到XML的转换。

待办：SEBRAE标准的转换仍然不完整！！

请使用Gitter聊天室开始关于此包开发的特定讨论。

支持州

NFe（模型55）全部

NFCe（模型65）全部

带有eCPF的NFe（个人实体发行人）

CE、PR和SP州不支持eCPF的发行

AM和GO因通信问题无法验证

所有其他州（似乎）已接受通过eCPF的发行

此包符合PSR-1、PSR-2和PSR-4标准。如果您发现任何不符合规范的地方，请通过pull request发送补丁。

不要错过NFePHP讨论组的注册，以跟踪开发并参与讨论和提问！

安装

此包在Packgist上列出，是为使用Composer开发的，因此不会说明任何其他安装选项。

应使用以下命令安装：

composer require nfephp-org/sped-nfe

或者还可以通过更改您的应用程序的composer.json来安装

"require": {
    "nfephp-org/sped-nfe" : "^5.0"
}

要使用开发版（master分支）的包，应使用以下命令安装

composer require nfephp-org/sped-nfe:dev-master

或者还可以通过更改您的应用程序的composer.json来安装

"require": {
    "nfephp-org/sped-nfe" : "dev-master"
}

注意：在开发版本中使用此包时，请务必更改您的应用程序的composer.json，将"minimum-stability"属性从"stable"更改为"dev"，以接受开发包。

"minimum-stability": "dev"

要求

为了使此包能够运行，需要以下PHP和其他依赖包的要求。

• PHP 7.x（最低PHP 7.4，请始终查看徽章）
• ext-curl
• ext-dom
• ext-json
• ext-gd
• ext-mbstring
• ext-mcrypt
• ext-openssl
• ext-soap
• ext-xml
• ext-zip
• sped-common

对于SPED的其他必要操作，可以（可选地）使用其他包，例如

• sped-da 生成打印文档（DANFE，DACTE等）
• sped-mail 通过电子邮件发送发票和其他税务文件
• sped-ibpt 查询消费者销售预估税
• sped-gnre 生成GNRE
• posprint POS打印机文档打印

如何在项目中使用此API？

首先，此API使用PHP的最新资源进行类和对象，因此以下是一个错误的示例

require 'sped-nfe/src/Make.php';

$nfe = new Make();

因此，您必须首先了解，为了使用此API，您需要与NAMESPACES一起工作，因为此API使用NAMESPACES。

现在您知道NAMESPACES是必需的，上面示例的正确使用方法如下

// VENDOR_DIR = pasta vendor da sua instalação composer
require VENDOR_DIR . 'autoload.php';

use NFePHP\NFe\Make;

$nfe = new Make();

捐赠

我们正在寻找捐赠者和赞助商来帮助资助此包和其他包的部分开发，有兴趣的请通过电子邮件联系作者 linux.rlm@gmail.com

这是一个完全的开源项目，为了使用、复制或修改它，您绝对不需要支付任何费用。但是，为了继续适当维护它，需要一些贡献，无论是编码、文档、测试和错误识别和BUG修复。

但如果你认为这里获得的信息对你有所帮助，并且你认为这值得一些钱，你愿意捐赠一些东西，你可以自由地发送任何数额，无论是直接给作者还是通过PayPal和PagSeguro。

致谢

• 感谢所有以某种方式为此API的持续开发做出贡献的同事们。

文档

文档过程仍在初期，但已经有一些有用的文档。

文档

贡献

要为BUG修复、代码改进、文档、测试或任何其他技术编程援助做出贡献，请参阅CONTRIBUTING和行为准则以获取更多详细信息。

变更日志

关注CHANGELOG以获取有关最近更改的更多信息。

测试

所有测试都是为与PHPUNIT一起运行而开发的。

安全

如果您发现任何安全问题，请直接向包维护者发送电子邮件，而不是打开一个ISSUE。

鸣谢

Roberto L. Machado（所有者和开发者）

许可证

此包可在LGPLv3或MIT许可证（MIT）下使用。阅读许可证文件以获取更多信息。