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 2019.001 v1.60 创建和更新验证规则
• NT 2023.004 v1.00 财务对账事件（缺少财务对账事件！！！）
• NT 2023.005 v1.00 交付失败事件

注意：这些NT主要影响TXT转换为XML的使用，即使这些字段目前还没有被要求。

待办事项：与SEBRAE标准的转换仍不完整！！

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

支持的州

NFe（模型55）全部

NFCe（模型65）全部

NFe与eCPF（个人发票开具人）

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）下提供。有关更多信息，请参阅许可文件。