PHPackages inteligenceeerp/sped-gnre2 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. inteligenceeerp/sped-gnre2 ActiveLibrary inteligenceeerp/sped-gnre2 ========================== API para a emissão de guias GNRE para a SEFAZ 0851↓50%PHP Since Sep 22Pushed 7mo agoCompare [ Source](https://github.com/marciotullio/sped-gnre)[ Packagist](https://packagist.org/packages/inteligenceeerp/sped-gnre2)[ RSS](/packages/inteligenceeerp-sped-gnre2/feed)WikiDiscussions ierp Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) [![Build status (PHP Composer)](https://github.com/nfephp-org/sped-gnre/actions/workflows/php.yml/badge.svg)](https://github.com/nfephp-org/sped-gnre/actions/workflows/php.yml)[![Coverage Status](https://camo.githubusercontent.com/d7cdd9dfdd3e53ed9d24adb8e699c23ef12f2dbb2b18d0c76f81567ecbe115cb/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6d617261626573692f676e72657068702f62616467652e737667)](https://coveralls.io/r/nfephp-org/sped-gnre)[![Total Downloads](https://camo.githubusercontent.com/fad4700098b14253ce65ad11c4c3c244392bace4b293b77c928cead25f93fec3/68747470733a2f2f706f7365722e707567782e6f72672f6d617261626573692f676e72652f646f776e6c6f616473)](https://packagist.org/packages/nfephp-org/sped-gnre)[![Latest Stable Version](https://camo.githubusercontent.com/1101a1e50f54004a2748f7628029fef3541dd5531e572daec61b7a5c8c184314/68747470733a2f2f706f7365722e707567782e6f72672f6d617261626573692f676e72652f762f737461626c65)](https://packagist.org/packages/nfephp-org/sped-gnre)[![Latest Unstable Version](https://camo.githubusercontent.com/cff9ff298c427df104eb46b2dad9d473bbe16127ead896f1907851d495c6e317/68747470733a2f2f706f7365722e707567782e6f72672f6d617261626573692f676e72652f762f756e737461626c652e706e67)](https://packagist.org/packages/nfephp-org/sped-gnre)[![License](https://camo.githubusercontent.com/068404a2220b0aa141db6a46ff95fd83599bd8edd14bf4921bbe4f6d8cab7519/68747470733a2f2f706f7365722e707567782e6f72672f6d617261626573692f676e72652f6c6963656e7365)](https://packagist.org/packages/nfephp-org/sped-gnre) Atenção!! ========= [](#atenção) Caso encontre algum estado que possua uma regra especial para gerar uma GNRE por favor informar abrindo uma **issue**. Dessa forma podemos manter a API atualizada e ajudar a todos que utlizam a GNRE PHP Atenção 2!! =========== [](#atenção-2) Se você possui um certificado da certisign e está com o erro "Bad request" veja a solução encontrada pelo [renandelmonico](https://github.com/renandelmonico) utilizando as classes da sped-common nesse [link](https://groups.google.com/d/msg/gnrephp/kbNWB3aEBbs/0g067FKlBgAJ) Os certificados da certisign possuem algum problema em que não é possível extrair a cadeia de certificação, portanto é necessário fazer o download da cadeia manualmente nesse [link](https://www.certisign.com.br/duvidas-suporte/downloads/hierarquias/icp-brasil/ac-instituto-fenacon-rfb) (Hierarquia V5). Após o download é necessário extrair usando o openssl, copiar o conteúdo gerado pelos 3 certificados e colar em um novo arquivo .pem. ``` openssl x509 -inform der -in ARQUIVO.cer -pubkey -noout > ARQUIVO.pem ``` Depois de realizar o processo acima, é necessário utilizar o método addCurlOption da classe Sped\\Gnre\\Webservice\\Connection para alterar algumas configurações e informar manualmente a cadeia de certificação. ``` $webService->addCurlOption([ CURLOPT_SSL_VERIFYHOST => 2, CURLOPT_SSL_VERIFYPEER => 1, CURLOPT_SSLVERSION => CURL_SSLVERSION_TLSv1, CURLOPT_CAINFO => 'ARQUIVO.pem' ]); ``` Versões suportadas ================== [](#versões-suportadas) PHPGNREPHP 5.60.1.4HHVM0.1.4PHP 7.00.1.5PHP 7.30.1.6Antes de usar a API =================== [](#antes-de-usar-a-api) - Verifique se seu certificado digital não foi expedido através da [certisign](https://www.certisign.com.br), pois existe um problema na cadeia do certificado que impossibilita a emissão de guias GNRE. Certificados expedidos através do [SERASA](https://serasa.certificadodigital.com.br/) funcionam normalmente para a emissão (até agora nenhum erro foi relatado). - É permitido utilizar o mesmo certificado utilizado para emitir NF-e. - É necessário entrar em contato com a SEFAZ de cada estado pedindo liberação do serviço de emissão de GNRE. - Leita todos os tópicos no FAQ oficial em . Os tópicos abordados são muito úteis para quem está começando nesse serviço. GNRE PHP ======== [](#gnre-php) Objetivo -------- [](#objetivo) API possibilita a comunicação com a SEFAZ para a emissão da nota GNRE (Guia Nacional de Recolhimento de Tributos Estaduais). A API GNRE tem como maior inspiração a API NFEPHP que você pode encontrar através do link Dependências ------------ [](#dependências) - [Apache](http://httpd.apache.org/) / [Nginx](http://nginx.org/) - [PHP 5.3+](http://php.net) - Extensões PHP - [DOMDocument](http://br2.php.net/manual/en/domdocument.construct.php) - [cURL](http://br2.php.net/manual/book.curl.php) - \[GD (Utilizada para renderizar o código de barras)\] ([http://php.net/manual/pt\_BR/book.image.php](http://php.net/manual/pt_BR/book.image.php)) --- Road-map -------- [](#road-map) Atualmente estamos utilizando o trello para gerenciar o que será implementado nas próximas versões e melhorias na API, esse road map poe ser acessado em --- Informações úteis ----------------- [](#informações-úteis) DescriçãoEndereçoGrupo de discussãoSite oficial do governoSite do ProjetoWiki, onde é possível encontrar maiores informações de como utilizar a APISite oficial da SEFAZ de todo os estados1. Antes de gerar qualquer guia GNRE com o seu certificado, tenha **CERTEZA** que você possui autorização para isso. A geração de GNRE depende de cada estado, ou seja, se você deseja gerar a guia para o Acre (com destino ao Acre) tenha certeza que já pediu a liberação do certificado no SEFAZ Acre e repita esse processo para cada estado. Documentação ------------ [](#documentação) - Documentação da GNRE PHP gerada com o PHPDOC pode ser visualizada [aqui](http://nfephp-org.github.io/sped-gnre//doc/namespaces/Gnre.html) - Nosso wiki de como utilizar a API e gerar as GNRES está disponível [aqui no github](https://github.com/nfephp-org/sped-gnre/wiki) - Exemplos com código fonte são encontrados na pasta [exemplos/](https://github.com/nfephp-org/sped-gnre/tree/master/exemplos) Instalação via composer ----------------------- [](#instalação-via-composer) Adicionando a GNRE PHP em um projeto existente com o composer Caso você não possua o composer veja [esse link](https://getcomposer.org/doc/01-basic-usage.md) antes de prosseguir Adicione a dependência da GNRE PHP no arquivo composer.json : Para PHP <= 5.5 ``` { "nfephp-org/sped-gnre": "0.1.1" } ``` Para PHP = 5.6 ``` { "nfephp-org/sped-gnre": "0.1.4" } ``` Para PHP >= 7.0 ``` { "nfephp-org/sped-gnre": "0.1.5" } ``` Atualize suas depedências existentes no composer : ``` composer update ``` --- Possíveis erros --------------- [](#possíveis-erros) Erro : **unable to use client certificate (no key found or wrong pass phrase?)** Se você está obtendo essa mensagem após enviar a requisição para o web service da SEFAZ verifique a senha que você está utilizando, pois esse erro ocorre quando a senha informada não bate com a senha do certificado utilizado Erro: **\[InvalidArgumentException\] Could not find package marabesi/gnre at any version for your minimum-stability (stable). Check the package spelling or your minimum-stability** Esse problema ocorre pois não estamos informando ao composer qual a versão mínima que queremos utilizar, para resolver esse problema basta adicionar a seguinte linha no seu arquivo composer.json ``` { "minimum-stability": "dev" } ``` --- Quick start ----------- [](#quick-start) Clone o repositório do projeto ``` git clone https://github.com/nfephp-org/sped-gnre.git ``` Vá para a pasta de exemplos ``` cd exemplos/ ``` Rode o servidor built-in do PHP ``` php -S localhost:8181 ``` Abra o seu navegador e digite a seguinte URL ``` http://localhost:8181/gerar-xml.php ``` --- Caso queira ver outros exemplos utilizados pela API acesse esse link ### Health Score 22 — LowBetter than 22% of packages Maintenance44 Moderate activity, may be stable Popularity19 Limited adoption so far Community8 Small or concentrated contributor base Maturity15 Early-stage or recently created project Bus Factor1 Top contributor holds 89.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/f9a64a98553e4394ffdf57e70ca14da9eda89b2350457ed465c443c445ea21d2?d=identicon)[leonescode](/maintainers/leonescode) --- Top Contributors [![leonesoliveira](https://avatars.githubusercontent.com/u/50273318?v=4)](https://github.com/leonesoliveira "leonesoliveira (34 commits)")[![marciotullio](https://avatars.githubusercontent.com/u/11054626?v=4)](https://github.com/marciotullio "marciotullio (4 commits)") ### Embed Badge ![Health badge](/badges/inteligenceeerp-sped-gnre2/health.svg) ``` [![Health](https://phpackages.com/badges/inteligenceeerp-sped-gnre2/health.svg)](https://phpackages.com/packages/inteligenceeerp-sped-gnre2) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)