README

这是一个由Saipos开发团队维护的仓库（https://www.saipos.com.br/）。在这里将进行BUG修正和必要功能的实现，以确保库的正常运行。任何希望贡献的开发者都欢迎！

有关原始仓库的更多信息（https://github.com/nfephp-org/nfephp）。

NFePHP

NFePHP是一个用于管理NFe发行人与各州SEFAZ服务之间通信的API。完全用PHP构建，可在任何操作系统上运行。要开始，请查看我们的Wiki页面nossas páginas Wiki。

不要错过在NFePHP讨论组注册！

稳定版

由于国家立法、各州SEFAZ和web服务提供商不断变化schema、webservice和法规，MASTER版本和最新的TAG是最稳定和功能齐全的版本。

使用Composer安装

通过终端进入项目根目录，并执行

composer require saipos/saipos-nfephp

这将使您的composer.json文件添加API依赖。API将被下载并放置在“vendor”文件夹中，并将更新autoload.php文件。

条件

使用此API需要PHP编程知识，了解当前语言标准以及税收法规基础。强烈建议学习以下网站的内容。

• NFe系统操作文档SEFAZ NFe
• CTe系统操作文档SEFAZ CTe
• MDFe系统操作文档SEFAZ MDfe
• Composer文档Documentação构建composer.json
• 重要PHP do Jeito Certo
• 编码风格指南PSR-2
• 自动加载PSR-4

注意：NFSe电子服务发票没有统一的格式，API仅提供了一些用于此目的的系统构建示例，但没有真正适用于此类发票的API。

目标

该API允许NFe发行程序与SEFAZ通信。API不是为自身发行NFe而创建的，考虑到需要大量信息和每个发行者的特征和特定要求。

依赖项

• composer https://getcomposer.org.cn/
• Apache: https://httpd.apache.ac.cn/
• PHP 5.5+: https://php.ac.cn
• 第三方库
• FPDF：暂时用于生成PDF文档。请参阅http://www.fpdf.org/。应替换为ZendPdf类（由于PSR标准趋势，它被更积极地维护和通过composer分发）。
• zendframework/zend-mail (v.2.x)：用于向电子税务文件收件人发送电子邮件。
• zendframework/zend-barcode (v.2.x)：用于在PDF税务文件中生成128位条码。
• soundasleep/html2text (v.0.2)：用于将电子邮件的HTML消息转换为纯文本。用于电子邮件发送类。
• endroid/qrcode (v.1.x)：用于在NFCe上打印QRCode。
• PHP扩展
• cURL：通常与PHP 5.3+一起启用。请参阅http://br2.php.net/manual/book.curl.php和http://curl.haxx.se/。
• OpenSSL：通常与PHP 5.3+一起启用。请参阅http://br2.php.net/manual/book.openssl.php和http://www.openssl.org/。
• mcrypt：通常与PHP 5.3+一起启用。请参阅https://php.ac.cn/manual/book.mcrypt.php。
• imap：通常与PHP 5.3+一起启用。请参阅https://php.ac.cn/manual/book.imap.php
• GD：通常与PHP 5.3+一起启用。请参阅https://php.ac.cn/manual/book.image.php
• ZIP：下载SEFAZ的NFe所必需。请参阅https://php.ac.cn/manual/en/book.zip.php
• Zlib：下载NFe后解压缩所必需。请参阅https://php.ac.cn/manual/en/book.zlib.php

安装

有关安装的更多详细信息，请参阅https://github.com/nfephp-org/nfephp/wiki/Instalação。

快速入门

使用git clone --branch=develop https://github.com/Saipos/saipos-nfephp.git克隆存储库。

$ composer install
$ ./vendor/bin/phpunit

开发

对于所有开发、错误修复、添加和测试，应使用分支develop。在分支master中将是被认为是稳定的代码。可能会根据需要出现新的分支，无论是为了维护旧版本还是为了建立错误修复。但是，只有这两个已建立的分支将永久维护。

错误跟踪器

发现了错误？在此处GitHub上告诉我们！

https://github.com/nfephp-org/nfephp/issues