PHPackages nfephp-org/sped-gnre - 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. [API Development](/categories/api) 4. / 5. nfephp-org/sped-gnre ActiveLibrary[API Development](/categories/api) nfephp-org/sped-gnre ==================== API para a emissão de guias GNRE para a SEFAZ 0.3.0(3y ago)648.5k↓33.3%66[4 PRs](https://github.com/nfephp-org/sped-gnre/pulls)GPL-3.0-or-laterPHPPHP >=7.3.0 Since Jan 11Pushed 3mo ago21 watchersCompare [ Source](https://github.com/nfephp-org/sped-gnre)[ Packagist](https://packagist.org/packages/nfephp-org/sped-gnre)[ RSS](/packages/nfephp-org-sped-gnre/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (9)Versions (13)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 46 — FairBetter than 93% of packages Maintenance53 Moderate activity, may be stable Popularity41 Moderate usage in the ecosystem Community27 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 72% 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. ### Release Activity Cadence Every ~266 days Recently: every ~398 days Total 11 Last Release 1114d ago PHP version history (4 changes)0.1.0PHP >=5.3.0 0.1.2PHP >=5.6.0 0.1.5PHP >=7.0.0 0.2.0PHP >=7.3.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/83b3feccdc04943c30ac9b785307cb73385c30d5b3ad8a7c700f7704416dc280?d=identicon)[robmachado](/maintainers/robmachado) --- Top Contributors [![marabesi](https://avatars.githubusercontent.com/u/2129872?v=4)](https://github.com/marabesi "marabesi (154 commits)")[![renandelmonico](https://avatars.githubusercontent.com/u/26630680?v=4)](https://github.com/renandelmonico "renandelmonico (13 commits)")[![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (11 commits)")[![llpereiras](https://avatars.githubusercontent.com/u/3936337?v=4)](https://github.com/llpereiras "llpereiras (8 commits)")[![luizkim](https://avatars.githubusercontent.com/u/7343768?v=4)](https://github.com/luizkim "luizkim (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (4 commits)")[![felipe-colussi](https://avatars.githubusercontent.com/u/66074971?v=4)](https://github.com/felipe-colussi "felipe-colussi (4 commits)")[![Luiz727](https://avatars.githubusercontent.com/u/153505851?v=4)](https://github.com/Luiz727 "Luiz727 (3 commits)")[![eduardoturconi](https://avatars.githubusercontent.com/u/4389868?v=4)](https://github.com/eduardoturconi "eduardoturconi (2 commits)")[![anteriovieira](https://avatars.githubusercontent.com/u/1490347?v=4)](https://github.com/anteriovieira "anteriovieira (1 commits)")[![mathmarques](https://avatars.githubusercontent.com/u/1610091?v=4)](https://github.com/mathmarques "mathmarques (1 commits)")[![dbemfica](https://avatars.githubusercontent.com/u/13237440?v=4)](https://github.com/dbemfica "dbemfica (1 commits)") --- Tags certificadognre-phpgovernogoverno-federalguiaphpsefazspedsped-fiscal ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/nfephp-org-sped-gnre/health.svg) ``` [![Health](https://phpackages.com/badges/nfephp-org-sped-gnre/health.svg)](https://phpackages.com/packages/nfephp-org-sped-gnre) ``` ### Alternatives [wheelpros/fitment-platform-api Magento 2 (Open Source) 12.1k1.2k](/packages/wheelpros-fitment-platform-api)[blocktrail/blocktrail-sdk The BlockTrail PHP SDK, for integration of Bitcoin functionality through the BlockTrail API 4921.1k3](/packages/blocktrail-blocktrail-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)