README

注意!!

如果发现某个州有专门生成GNRE的规则，请通过打开一个问题来告知。这样我们可以保持API更新，并帮助所有使用GNRE PHP的人。

注意2!!

如果您拥有certisign证书并且遇到"Bad request"错误，请查看renandelmonico利用sped-common类在该链接中找到的解决方案。

certisign证书存在一些问题，无法提取证书链，因此需要在该链接（Hierarquia V5）手动下载证书链。

下载后，需要使用openssl提取，将3个证书生成的内容复制并粘贴到一个新的.pem文件中。

openssl x509 -inform der -in ARQUIVO.cer -pubkey -noout > ARQUIVO.pem

完成上述过程后，需要使用Sped\Gnre\Webservice\Connection类的addCurlOption方法来更改一些配置，并手动输入证书链。

$webService->addCurlOption([
    CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_SSL_VERIFYPEER => 1,
    CURLOPT_SSLVERSION => CURL_SSLVERSION_TLSv1,
    CURLOPT_CAINFO => 'ARQUIVO.pem'
]);

支持版本

在使用API之前

请检查您的数字证书是否不是由certisign签发的，因为证书链存在问题，无法发出GNRE指南。通过SERASA签发的证书可以正常用于发出（迄今为止没有报告错误）。
可以使用用于发出NF-e的相同证书。
需要与每个州的SEFAZ联系，请求发出GNRE服务的许可。
请阅读在http://www.gnre.pe.gov.br/gnre/portal/faq.jsp的官方FAQ中的所有主题。这些主题对刚开始使用该服务的人非常有用。

GNRE PHP

目标

API允许与SEFAZ通信，以发出GNRE（国家州级税收回收指南）的票据。GNRE API的最大灵感来自于您可以通过链接https://github.com/nfephp找到的NFEPHP API。

依赖

Apache / Nginx
PHP 5.3+
PHP扩展
DOMDocument
cURL
[GD (用于渲染条形码)] (https://php.ac.cn/manual/pt_BR/book.image.php)

路线图

我们目前正在使用trello来管理API未来的版本实施和改进，此路线图可通过https://trello.com/b/kNP1tvsi/gnre-api-github访问

有用信息

在用您的证书生成任何GNRE指南之前，请确信您有此权限。GNRE的生成取决于每个州，也就是说，如果您想要为阿cre（目的地为阿cre）生成指南，请确信您已经在阿cre的SEFAZ请求了证书的许可，并重复此过程为每个州。

文档

使用PHPDOC生成的GNRE PHP文档可在此处查看：这里
如何使用API和生成GNRES的wiki文档可在GitHub上找到：这里
带有源代码的示例可以在examples/文件夹中找到

通过composer安装

使用composer将GNRE PHP添加到现有项目中

如果您没有composer，请在继续之前查看此链接

在composer.json文件中添加GNRE PHP依赖项

对于PHP <= 5.5

{
    "nfephp-org/sped-gnre": "0.1.1"
}

对于PHP = 5.6

{
    "nfephp-org/sped-gnre": "0.1.4"
}

对于PHP >= 7.0

{
    "nfephp-org/sped-gnre": "0.1.5"
}

更新composer中现有的依赖项

composer update

可能的错误

错误： 无法使用客户端证书（未找到密钥或密码短语错误？）

如果您在向SEFAZ的web服务发送请求后收到此消息，请检查您正在使用的密码，因为此错误发生在提供的密码与使用的证书密码不匹配时

错误： [InvalidArgumentException] 无法找到版本号为您的最低稳定性的包 marabesi/gnre

此问题发生是因为我们没有告知composer我们想要使用哪个最低版本，要解决这个问题，只需在您的composer.json文件中添加以下行即可

{
    "minimum-stability": "dev"
}

快速开始

克隆项目仓库

git clone https://github.com/nfephp-org/sped-gnre.git

进入示例文件夹

cd exemplos/

运行PHP内置服务器

php -S localhost:8181

打开您的浏览器并输入以下URL

https://:8181/gerar-xml.php

如果您想查看API使用的其他示例，请访问此链接 https://github.com/nfephp-org/sped-gnre/tree/master/exemplos

marabesi / gnre

维护者

详细信息