PHPackages                             saipos/saipos-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. saipos/saipos-nfephp

ActiveLibrary[API Development](/categories/api)

saipos/saipos-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.

v4.0.69(9y ago)017GPL-3.0+PHPPHP &gt;=5.5.0

Since Apr 5Pushed 8y agoCompare

[ Source](https://github.com/Saipos/saipos-nfephp)[ Packagist](https://packagist.org/packages/saipos/saipos-nfephp)[ Docs](https://github.com/nfephp-org/nfephp)[ RSS](/packages/saipos-saipos-nfephp/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (7)Versions (33)Used By (0)

Versão mantida pela equipe Saipos
=================================

[](#versão-mantida-pela-equipe-saipos)

Este é um repositório mantida pela equipe de desenvolvimento da Saipos (). Onde serão feitas correções de BUGs e implementações necessárias para o bom funcionamento da biblioteca conforme a necessidade das nossas ferramentas. Qualquer desenvolvedor que deseje contribuir, seja bem vindo!

Para maiores informações do repositório original ().

NFePHP
======

[](#nfephp)

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)!

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 saipos/saipos-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/Saipos/saipos-nfephp.git`.

```
$ composer install
$ ./vendor/bin/phpunit
```

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!

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 82.9% 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 ~10 days

Total

30

Last Release

3378d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/41ece7f9f5a2cf33814fec26a070e7955cafa08f8d21a00ed7643d2ae325a2d2?d=identicon)[ericalves](/maintainers/ericalves)

---

Top Contributors

[![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (1429 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)")[![thicolares](https://avatars.githubusercontent.com/u/849493?v=4)](https://github.com/thicolares "thicolares (8 commits)")[![binhoouropreto](https://avatars.githubusercontent.com/u/8726894?v=4)](https://github.com/binhoouropreto "binhoouropreto (8 commits)")[![betoeu](https://avatars.githubusercontent.com/u/2381323?v=4)](https://github.com/betoeu "betoeu (8 commits)")[![mmorote](https://avatars.githubusercontent.com/u/2536588?v=4)](https://github.com/mmorote "mmorote (8 commits)")[![ericalves](https://avatars.githubusercontent.com/u/2515487?v=4)](https://github.com/ericalves "ericalves (7 commits)")[![LUCASNDIAS](https://avatars.githubusercontent.com/u/6611215?v=4)](https://github.com/LUCASNDIAS "LUCASNDIAS (6 commits)")[![diogobd](https://avatars.githubusercontent.com/u/6982060?v=4)](https://github.com/diogobd "diogobd (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)")[![rodrigocandido](https://avatars.githubusercontent.com/u/13019139?v=4)](https://github.com/rodrigocandido "rodrigocandido (4 commits)")[![psaraiva](https://avatars.githubusercontent.com/u/1416537?v=4)](https://github.com/psaraiva "psaraiva (4 commits)")

---

Tags

nfenfephpsped

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/saipos-saipos-nfephp/health.svg)

```
[![Health](https://phpackages.com/badges/saipos-saipos-nfephp/health.svg)](https://phpackages.com/packages/saipos-saipos-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)
