PHPackages datitecnologia/nfephp - 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. datitecnologia/nfephp ActiveLibrary[API Development](/categories/api) datitecnologia/nfephp ===================== NFePHP é uma API para gerenciamento das comunicações entre o emitente de NFe e os serviços dos SEFAZ estaduais. Inteiramente construido em PHP para rodar sob qualquer sistema operacional. v1.0.0(3y ago)04GPL-3.0+PHPPHP >=5.5.0 Since Oct 27Pushed 3y agoCompare [ Source](https://github.com/datitecnologia/nfephp)[ Packagist](https://packagist.org/packages/datitecnologia/nfephp)[ Docs](https://github.com/nfephp-org/nfephp)[ RSS](/packages/datitecnologia-nfephp/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (7)Versions (2)Used By (0) NFePHP ====== [](#nfephp) [![Build Status](https://camo.githubusercontent.com/ba51b778e8e832f6b6fe546e36aaf8dd3c262326fb7e0f0233ec686f0ac9e54a/68747470733a2f2f7472617669732d63692e6f72672f6e66657068702d6f72672f6e66657068702e737667)](https://travis-ci.org/nfephp-org/nfephp)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/967980493b1faa1dbcd2a85bc175cc33313e74583e66a70264c7d9dfec7c4cf5/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6e66657068702d6f72672f6e66657068702f6261646765732f7175616c6974792d73636f72652e706e67)](https://scrutinizer-ci.com/g/nfephp-org/nfephp/)[![Code Coverage](https://camo.githubusercontent.com/a058d3486852b2c9306e1fb8da0a7b701ef53a35767666c9cd6e319366cb7e42/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6e66657068702d6f72672f6e66657068702f6261646765732f636f7665726167652e706e67)](https://scrutinizer-ci.com/g/nfephp-org/nfephp/)[![License](https://camo.githubusercontent.com/f65a3e91cd79ba35302f23975149bd0b8307aa33798bd5adbd2182037554df47/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e737667)](https://packagist.org/packages/nfephp-org/nfephp)[![Latest Stable Version](https://camo.githubusercontent.com/a6ebf228ae78674866d5995a4d4b337294ab5b66e5274b5f8e60fb8daf77a37b/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f762f737461626c652e737667)](https://packagist.org/packages/nfephp-org/nfephp)[![Latest Unstable Version](https://camo.githubusercontent.com/30937cbf56a66f3ac1cfab4ac7b02cb5b2019293fdfb27db357bb589ec6e8f6d/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f762f756e737461626c652e737667)](https://packagist.org/packages/nfephp-org/nfephp)[![Total Downloads](https://camo.githubusercontent.com/e26664827e7476ace9db98777121d8ae9b987d7f2bfa715a2cf9ca97505dafb1/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f646f776e6c6f616473)](https://packagist.org/packages/nfephp-org/nfephp) ESTA VERSÃO ESTÁ DESCONTINUADA (NÃO UTILIZE !!) PREFIRA [sped-nfe](https://github.com/nfephp-org/sped-nfe) ========================================================================================================== [](#esta-versão-está-descontinuada-não-utilize--prefira-sped-nfe) NFePHP é uma API para gerenciamento das comunicações entre o emitente de NFe e os serviços dos SEFAZ estaduais. Inteiramente construído em PHP para rodar sob qualquer sistema operacional. Para começar veja [nossas páginas Wiki](https://github.com/nfephp-org/nfephp/wiki). Não deixe de se cadastrar no [grupo de discussão do NFePHP](http://groups.google.com/group/nfephp)! PULL REQUESTS (REPOSIÓRIO nfephp tem sua VERSÃO CONGELADA, não será mais atualizada) ------------------------------------------------------------------------------------ [](#pull-requests-reposiório-nfephp-tem-sua-versão-congelada-não-será-mais-atualizada) **Srs. neste repositório somente serão aceitos "PULL REQUESTS" relativos a BUGS e correções derivadas de mudanças promovidas pelas SEFAZ.** Não mais serão aceitas alterações, melhorias no código ou inclusões de novos recursos ou de novos serviços, todas essas melhorias deverão ser encaminhadas para o novo repositório SPED-XXX. > Em breve (até meados de 2017), este repositório deixará de receber qualquer contribuição e será descontinuado, em favor dos novos repositórios !!! Para manter a integridade da API nessa nova versão (4.1.x-dev), estão sendo mantidos os "namespaces", as chamadas de métodos e seus parametros, que não deverão ser alterados a não ser por motivo de "força maior", como mudanças da SEFAZ que forcem essa situação. No uso da nova versão, atenção deve ser dedicada a nomenclatura de classes, que foi simplificada, e nos recursos como impressão que foram deslocados para outro repositório. REESTRUTURAÇÃO DE REPOSITÓRIOS ------------------------------ [](#reestruturação-de-repositórios) **As estruturas de CTe, MDFe e outras foram removidas deste repositório e levadas a seus novos repositórios veja:** [SPED NFe](https://github.com/nfephp-org/sped-nfe) Novo repositório da classes de NFe (em fase de testes) [SPED CTe](https://github.com/nfephp-org/sped-cte) Novo repositório das classes de CTe (em desenvolvimento) [SPED MDFe](https://github.com/nfephp-org/sped-mdfe) Novo repositório das classes de MDFe (em desenvolvimento) [SPED NFSe](https://github.com/nfephp-org/sped-nfse) Novo repositório das classes de NFSe (em desenvolvimento) Os demais componentes também terão repositórios novos, mas por ora ainda permanecem neste. [SPED COMMON](https://github.com/nfephp-org/sped-common) Novo repositório das classes comuns usadas por todos ou vários projetos. [SPED DA](https://github.com/nfephp-org/sped-da) Novo repositório das classes que geram a impressão dos documentos. [POSPRINT](https://github.com/nfephp-org/posprint) Framework para impressão com impressoras térmicas POS (em desenvolvimento) [SPED GNRE](https://github.com/nfephp-org/sped-gnre) Repositório da classes de GNRE (versão estável) Além desses outros repositórios estão em construção ou já dispõem de bibliotecas [SPED EFD](https://github.com/nfephp-org/sped-efinanceira) Repositório da classes de Sped EFD fiscal (em desenvolvimento) [SPED RESTFUL](https://github.com/nfephp-org/sped-restful) Aplicativo RestFul para geração de documentos Sped (em desenvolvimento) [SPED CONSOLE](https://github.com/nfephp-org/sped-console) Conjunto de recursos em linha de comando (em desenvolvimento) [SPED DOCS](https://github.com/nfephp-org/sped-docs) Conjunto da documentação dos pacotes NFePHP (ultrapassado, incompleto e parcial) [SPED EMISSOR](https://github.com/nfephp-org/sped-emissor) Aplicativo "front-end" para emissão de documentos (não iniciado) [SPED eSOCIAL](https://github.com/nfephp-org/sped-esocial) Repositório das classes para eSocial (apenas documentação) [SPED SERIALIZER](https://github.com/nfephp-org/sped-esocial) Repositorio de classes para serialização de XML (conceito) Outros projetos relacionados, mas com finalidade especifica: [SPED eFINANCEIRA](https://github.com/nfephp-org/sped-efinanceira) Repositório da classes de eFinanceira (versão estável) [SPED eSFINGE](https://github.com/nfephp-org/sped-esfinge) Framework para integração com o sistema eSfinge do TCE/SC (versão estável) CONTRIBUINDO ============ [](#contribuindo) Este é um projeto totalmente *OpenSource*, para usa-lo e modifica-lo você não paga absolutamente nada. Porém para continuarmos a mante-lo é necessário qua alguma contribuição seja feita, seja auxiliando na codificação, na documentação ou na realização de testes e identificação de falhas e BUGs. Mas também, caso você ache que qualquer informação obtida aqui, lhe foi útil e que isso vale de algum dinheiro e está disposto a doar algo, sinta-se livre para enviar qualquer quantia através de : [![Doar com Paypal](https://camo.githubusercontent.com/1c212254bf14c516a7571bbb8b8a1679967080453a6ba3a222491e973b6877dd/68747470733a2f2f7777772e70617970616c6f626a656374732e636f6d2f70745f42522f42522f692f62746e2f62746e5f646f6e61746543435f4c472e676966)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=linux%2erlm%40gmail%2ecom&lc=BR&item_name=NFePHP%20OpenSource%20API&item_number=nfephp¤cy_code=BRL&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest)\[!\[\]([https://stc.pagseguro.uol.com.br/public/img/botoes/doacoes/209x48-doar-assina.gif)\](https://pag.ae/bkXPq4](https://stc.pagseguro.uol.com.br/public/img/botoes/doacoes/209x48-doar-assina.gif)](https://pag.ae/bkXPq4)) IMPORTANTE: ----------- [](#importante) A partir desta versão o numero das versões seguirá uma sequencia própria da API e não mais irá se referir as versões de layout da NFe, CTe, etc. Nesta versão (4.0.x) apenas a NFe é funcional, para CTe, e MDFe deve ser usado a TAG 3.10-Obsoleta, pelo menos até que outros colaboradores se disponham a auxiliar na refatoração Versão de Desenvolvimento ------------------------- [](#versão-de-desenvolvimento) Versão 4.0.x-dev (observa a versão de layout 3.10 da SEFAZ) Versão Estável -------------- [](#versão-estável) Devido as constantes alterações, dos schemas, webservices e legislações, promovidas pelo Congresso Nacional, pelas SEFAZ estaduais e pelos provedores dos webservices, a versão em MASTER e a última TAG são as mais estáveis e funcionais. Instalação com Composer ----------------------- [](#instalação-com-composer) Pelo terminal vá até a raiz de seu projeto e lá execute : ``` composer require nfephp-org/nfephp ``` Isso fará com que o SEU arquivo composer.json seja acrescido da dependência da API. A API será baixada e colocada na pasta "vendor" e o arquivo autoload.php sejá atualizado. Condicionantes -------------- [](#condicionantes) Para usar essa API é necessário conhecimento em programação PHP, bem como conhecer os padrões atuais da linguagem e ter bases de legislação fiscal. É extremanente recomendável que seja estudado o conteúdo dos seguintes sites. - Documentação do Funcionamento do sistema de NFe [SEFAZ NFe](http://www.nfe.fazenda.gov.br/portal/principal.aspx) - Documentação do Funcionamento do sistema de CTe [SEFAZ CTe](http://www.cte.fazenda.gov.br/listaSubMenu.aspx?Id=tW+YMyk/50s=) - Documentação do Funcionamento do sistema de MDFe [SEFAZ MDfe](https://mdfe-portal.sefaz.rs.gov.br/) - Composer [Documentação](https://getcomposer.org/doc/) Construção do [composer.json](http://composer.json.jolicode.com/) - IMPORTANTE [PHP do Jeito Certo](http://br.phptherightway.com/) - Coding Style Guide [PSR-2](http://www.php-fig.org/psr/psr-2/) - Autoload [PSR-4](http://www.php-fig.org/psr/psr-4/) > NOTA: A NFSe Nota Fiscal de Serviços Eletrônica, não tem padrão único, e a API tem somente alguns exemplos de montagem de um sistema para esse fim, mas nenhuma API realmente funcional para esse tipo de documentos fiscais. Objetivo -------- [](#objetivo) A API permite que um programa emissor de NFe se comunique com a SEFAZ. A API não foi criada para ela própria emitir a NFe tendo em vista a enorme quantidade de informações necessárias e as características e especificidades de cada emitente. Dependências ------------ [](#dependências) - composer - Apache: - PHP 5.5+: - Bibliotecas de terceiros - FPDF: Provisóriamente usada para gerar os documentos em PDF. Veja .Deverá ser substituida pela classe ZendPdf (devido ao tendimento dos padrões PSR e ser mais ativamente mantida e distribuida via composer. - zendframework/zend-mail (v.2.x) Usada para envio dos emails aos destinátarios dos docuemntos fiscais eletrônicos. - zendframework/zend-barcode (v.2.x) Usada para gerar os codigos de barras 128 presente nos documentos fiscais em PDF. - soundasleep/html2text (v.0.2) Usada para converter as mensagens Htlm dos emails em seu equivalente em texto puro. Usada na classe de envio dos emails. - endroid/qrcode (v.1.x) Usada para gerar o QRCode impresso nas NFCe - Extensões PHP - cURL: Normalmente já vem habilitado com o PHP 5.3+. Veja e . - OpenSSL: Normalmente já vem habilitado com o PHP 5.3+. Veja e . - mcrypt: Normalmente já vem habilitado com o PHP 5.3+. Veja . - imap: Normalmente já vem habilitado com o PHP 5.3+. Veja - GD: Normalmente já vem habilitado com o PHP 5.3+. Veja - ZIP: Necessário para o download de NFe da SEFAZ. Veja - Zlib: Necessária para descompactar NFe após download. Veja Instalação ---------- [](#instalação) Para mais detalhes sobre a instalação, veja [https://github.com/nfephp-org/nfephp/wiki/Instalação](https://github.com/nfephp-org/nfephp/wiki/Instala%C3%A7%C3%A3o). Quick start ----------- [](#quick-start) Clone o repositório com `git clone --branch=develop https://github.com/nfephp-org/nfephp.git` ou [baixe a última versão estável](https://github.com/nfephp-org/nfephp/downloads). ``` $ composer install $ ./vendor/bin/phpunit ``` Versionamento ------------- [](#versionamento) Para fins de transparência e discernimento sobre nosso ciclo de lançamento, e procurando manter compatibilidade com versões anteriores, o número de versão da NFePHP será mantida, tanto quanto possível, respeitando o padrão abaixo. As liberações serão numeradas com o seguinte formato: `..` E serão construídas com as seguintes orientações: - Quebra de compatibilidade com versões anteriores, avança o ``. - Adição de novas funcionalidades sem quebrar compatibilidade com versões anteriores, avança o ``. - Correção de bugs e outras alterações, avança ``. Para mais informações, por favor visite . Desenvolvimento --------------- [](#desenvolvimento) Para todo o desenvolvimento, correções de bugs, inclusões e testes deverá ser usada branch `develop`. Na branch `master`estarão os códigos considerados como estáveis. Novas branches poderão surgir em função das necessidades que se apresentarem, seja para manter versionamentos anteriores seja para estabelecer correções de bugs. Mas apenas essas duas branches estabelecidas é que serão permanentente mantidas. Bug tracker ----------- [](#bug-tracker) Encontrou um bug? Informe-nos aqui no GitHub! Mantenedores (em revisão) ------------------------- [](#mantenedores-em-revisão) - NFe - `Roberto L. Machado` - NFCe - `Roberto L. Machado` - NFSe - `não definido` - CTe - `não definido` - MDFe - `não definido` - CLe - `não definido` Pull Request ------------ [](#pull-request) Para que seu Pull Request seja aceito ele deve estar seguindo os padrões descritos neste documento ### Health Score 21 — LowBetter than 19% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity3 Limited adoption so far Community19 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 83.2% 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 Unknown Total 1 Last Release 1290d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5fc4226053874ee0c66dedd2042d26aa818ce3c70ac5850b07a5331524da5c33?d=identicon)[datitecnologia](/maintainers/datitecnologia) --- Top Contributors [![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (1431 commits)")[![tonicospinelli](https://avatars.githubusercontent.com/u/966337?v=4)](https://github.com/tonicospinelli "tonicospinelli (73 commits)")[![rspadim](https://avatars.githubusercontent.com/u/2468782?v=4)](https://github.com/rspadim "rspadim (43 commits)")[![marcosdiez](https://avatars.githubusercontent.com/u/297498?v=4)](https://github.com/marcosdiez "marcosdiez (19 commits)")[![eduardokum](https://avatars.githubusercontent.com/u/2566340?v=4)](https://github.com/eduardokum "eduardokum (15 commits)")[![walkeralencar](https://avatars.githubusercontent.com/u/459481?v=4)](https://github.com/walkeralencar "walkeralencar (14 commits)")[![chinnonsantos](https://avatars.githubusercontent.com/u/3258293?v=4)](https://github.com/chinnonsantos "chinnonsantos (11 commits)")[![olavocneto](https://avatars.githubusercontent.com/u/568745?v=4)](https://github.com/olavocneto "olavocneto (10 commits)")[![DennyLoko](https://avatars.githubusercontent.com/u/635014?v=4)](https://github.com/DennyLoko "DennyLoko (9 commits)")[![mmorote](https://avatars.githubusercontent.com/u/2536588?v=4)](https://github.com/mmorote "mmorote (8 commits)")[![binhoouropreto](https://avatars.githubusercontent.com/u/8726894?v=4)](https://github.com/binhoouropreto "binhoouropreto (8 commits)")[![thicolares](https://avatars.githubusercontent.com/u/849493?v=4)](https://github.com/thicolares "thicolares (8 commits)")[![betoeu](https://avatars.githubusercontent.com/u/2381323?v=4)](https://github.com/betoeu "betoeu (8 commits)")[![diogobd](https://avatars.githubusercontent.com/u/6982060?v=4)](https://github.com/diogobd "diogobd (6 commits)")[![LUCASNDIAS](https://avatars.githubusercontent.com/u/6611215?v=4)](https://github.com/LUCASNDIAS "LUCASNDIAS (6 commits)")[![andreustimm](https://avatars.githubusercontent.com/u/811102?v=4)](https://github.com/andreustimm "andreustimm (5 commits)")[![jscorrea](https://avatars.githubusercontent.com/u/1138653?v=4)](https://github.com/jscorrea "jscorrea (5 commits)")[![brunoporto](https://avatars.githubusercontent.com/u/1410633?v=4)](https://github.com/brunoporto "brunoporto (4 commits)")[![psaraiva](https://avatars.githubusercontent.com/u/1416537?v=4)](https://github.com/psaraiva "psaraiva (4 commits)")[![JulianoAmaralChaves](https://avatars.githubusercontent.com/u/4882986?v=4)](https://github.com/JulianoAmaralChaves "JulianoAmaralChaves (4 commits)") --- Tags nfenfephpsped ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/datitecnologia-nfephp/health.svg) ``` [![Health](https://phpackages.com/badges/datitecnologia-nfephp/health.svg)](https://phpackages.com/packages/datitecnologia-nfephp) ``` ### Alternatives [nfephp-org/sped-cte API para geração e comunicação da CTe com as SEFAZ autorizadoras. 113227.7k1](/packages/nfephp-org-sped-cte)[nfephp-org/sped-nfse-ginfes API para geração e comunicação de RPS e NFSe no padão Ginfes. 434.7k](/packages/nfephp-org-sped-nfse-ginfes)[nfephp-org/sped-mdfe API para geração e comunicação da MDFe com as SEFAZ autorizadoras. 50135.1k](/packages/nfephp-org-sped-mdfe)[nfephp-org/sped-ibpt API para a comunicação com o servidor Restful do IBPT. 3079.2k2](/packages/nfephp-org-sped-ibpt)[cloud-dfe/sdk-php SDK para comunicação com a API CloudDFe. 1718.5k](/packages/cloud-dfe-sdk-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)