sqginfo/sped-nfe

API 用于生成和与授权的 SEFAZ 通信的 NFe 和 NFCe。


README

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

待办事项:与 SEBRAE 标准的转换仍然不完整!!

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

Chat Build Status Coverage Status Quality Score

Latest Stable Version Latest Version on Packagist License Total Downloads

Issues Forks Stars

服务州

NFe(型号 55)全部

NFCe(型号 65)全部,除 SC 外

  • SC 目前尚未参与(预计 2020 年使用,使用 SP 的 SAT@ECF 财务设备)。

NFe 与 eCPF(个人实体发行人)

CE、PR 和 SP 各州不接受 eCPF 发行

由于通信问题,AM 和 GO 无法验证

其他所有州(似乎)都已接受通过 eCPF 发行

此包符合 PSR-1PSR-2PSR-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.2)
  • 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。

Doar com Paypal Doar PagSeguro

致谢

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

文档

文档过程仍在开始阶段,但已经存在一些有用的文档。

文档

贡献

为了对BUG进行修正、改善代码、编写文档、制定测试或提供其他技术和技术编程帮助,请参阅CONTRIBUTING行为准则以获取更多详细信息。

变更日志

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

测试

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

安全

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

鸣谢

Roberto L. Machado(所有者和开发者)

许可证

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