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和行为准则以获取更多详细信息。

变更日志

请查看变更日志以获取有关最近更改的更多信息。

测试

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

安全

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

鸣谢

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

许可证

此包可在LGPLv3或MIT许可证（MIT）下使用。有关更多信息，请参阅许可证文件。