PHPackages                             mazinsw/nfe-api - 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. mazinsw/nfe-api

ActiveLibrary[API Development](/categories/api)

mazinsw/nfe-api
===============

API para geração e envio de notas fiscais eletrônicas brasileiras

4.3.8(1y ago)621.4k16MITPHPPHP >= 7.3.0CI failing

Since May 24Pushed 1y ago12 watchersCompare

[ Source](https://github.com/mazinsw/nfe-api)[ Packagist](https://packagist.org/packages/mazinsw/nfe-api)[ Docs](https://github.com/mazinsw/nfe-api)[ RSS](/packages/mazinsw-nfe-api/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (11)Versions (40)Used By (0)

NFe-API
=======

[](#nfe-api)

Bliblioteca para geração, transmissão e tratamento de eventos de notas fiscais eletrônicas
------------------------------------------------------------------------------------------

[](#bliblioteca-para-geração-transmissão-e-tratamento-de-eventos-de-notas-fiscais-eletrônicas)

[![Latest Version on Packagist](https://camo.githubusercontent.com/7938d557e5c0926016db597f030946a964f1026386479b33d029b8d3afff4d42/68747470733a2f2f706f7365722e707567782e6f72672f6d617a696e73772f6e66652d6170692f76657273696f6e)](https://packagist.org/packages/mazinsw/nfe-api)[![Build Status](https://camo.githubusercontent.com/b6f59f5c5ead816f7bcdceef0ea6406ac6ad81925f05aa65ae43c5840738e7c9/68747470733a2f2f6170692e7472617669732d63692e6f72672f6d617a696e73772f6e66652d6170692e737667)](https://travis-ci.org/mazinsw/nfe-api)[![Coverage Status](https://camo.githubusercontent.com/c315e12b67e7f91ce1e66be096740cda48de37fae646caa4d8750d979d8dab69/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d617a696e73772f6e66652d6170692f6261646765732f636f7665726167652e706e67)](https://scrutinizer-ci.com/g/mazinsw/nfe-api/code-structure)[![Quality Score](https://camo.githubusercontent.com/0ac6e49fbae9a3de9b14177d1d26b22144ace0c360a485e95a0d99b04e242378/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6d617a696e73772f6e66652d6170692f6261646765732f7175616c6974792d73636f72652e706e67)](https://scrutinizer-ci.com/g/mazinsw/nfe-api)[![Total Downloads](https://camo.githubusercontent.com/e85dd5b77d0454549004df7ee936ec955989fcf05066cfe2c0074aba6d3bd32a/68747470733a2f2f706f7365722e707567782e6f72672f6d617a696e73772f6e66652d6170692f642f746f74616c2e737667)](https://packagist.org/packages/mazinsw/nfe-api)

###### Essa biblioteca permite a geração, transmissão e tratamento de eventos de notas fiscais eletrônicas do Brasil

[](#essa-biblioteca-permite-a-geração-transmissão-e-tratamento-de-eventos-de-notas-fiscais-eletrônicas-do-brasil)

Vantagens
---------

[](#vantagens)

- Código bem estruturado e bem reaproveitado que permite a fácil manutenção
- Estrutura de código expansível para vários modelos de notas
- Fácil configuração e usabilidade (Só precisa implementar 2 classes para integração)
- Testes e cobertura de código que garantem melhor estabilidade
- Estrutura desvinculada do XML, atualizações quase não afetam em produção

Motivo do projeto
-----------------

[](#motivo-do-projeto)

As biliotecas de código aberto encontradas até o momento (2016) não fornecem uma estrutura sólida e de fácil utilização/manutenção, dessa forma surgiu a necessidade de criar uma bilioteca capaz de gerar notas fiscais em diversos modelos e que seja de fácil utilização

Ideia do projeto
----------------

[](#ideia-do-projeto)

A ideia é criar uma bilioteca em que as entidades da nota sejam implementadas em classes separadas, cada uma gerando seu próprio nó XML, no final da geração todos os nós são unificados assim gerando o XML por completo, dessa forma fica fácil a manutenção pois parte da ideia da divisão e conquista

Instalação
----------

[](#instalação)

Você precisará do [Composer](https://getcomposer.org) para instalar essa biblioteca.

Execute o comando abaixo na pasta do seu projeto

```
composer require mazinsw/nfe-api
```

Manutenção
----------

[](#manutenção)

Atualizar tabelas IBPT

```
# linux
./utils/update_IBPT.sh
```

```
REM Windows
utils\update_IBPT.bat
```

Documentação
------------

[](#documentação)

Acesse [aqui](../../wiki) para ver a documentação

Colaboração no projeto
----------------------

[](#colaboração-no-projeto)

Para melhoria do projeto envie suas implementações por meio de um Pull request

Solução de problemas
--------------------

[](#solução-de-problemas)

Caso tenha problemas ao utilizar a biblioteca, acesse o grupo no Discord:

Dependências
------------

[](#dependências)

- PHP 7.3 ou superior
- Extensão openssl para assinatura da nota
- Extensão curl para envio da nota

Limitações
----------

[](#limitações)

- Apenas o modelo NFC-e foi implementado e testado
- Só funciona com certificado digital modelo A1
- Não suporta duas versões da NF-e ao mesmo tempo

Licença
-------

[](#licença)

Por favor veja o [arquivo de licença](/LICENSE.txt) para mais informações.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity30

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 97.3% 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 ~73 days

Recently: every ~56 days

Total

37

Last Release

671d ago

Major Versions

1.0.5 → 2.0.02018-06-12

2.0.2 → 3.0.02018-09-03

3.0.4 → 4.0.02019-08-16

PHP version history (4 changes)1.0.0PHP >=5.3.0

1.0.5PHP >= 5.6.0

4.0.0PHP >= 7.1.0

4.1.0PHP >= 7.3.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7927014?v=4)[Francimar Alves](/maintainers/mazinsw)[@mazinsw](https://github.com/mazinsw)

![](https://www.gravatar.com/avatar/f06bda7f30092077c9b7b7084c7719c996b5acfd2b840e701e3dfa94f45943ce?d=identicon)[yuri.henrique](/maintainers/yuri.henrique)

---

Top Contributors

[![mazinsw](https://avatars.githubusercontent.com/u/7927014?v=4)](https://github.com/mazinsw "mazinsw (109 commits)")[![samuelcust](https://avatars.githubusercontent.com/u/27308595?v=4)](https://github.com/samuelcust "samuelcust (3 commits)")

---

Tags

nfcenfephpnfenfce

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mazinsw-nfe-api/health.svg)

```
[![Health](https://phpackages.com/badges/mazinsw-nfe-api/health.svg)](https://phpackages.com/packages/mazinsw-nfe-api)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[nfephp-org/sped-nfe

API para geração e comunicação da NFe e NFCe com as SEFAZ autorizadoras.

1.5k1.5M15](/packages/nfephp-org-sped-nfe)[nfephp-org/sped-ibpt

API para a comunicação com o servidor Restful do IBPT.

3085.7k6](/packages/nfephp-org-sped-ibpt)[nfephp-org/sped-efdreinf

API para geração e comunicação dos eventos relativos ao projeto EFD-Reinf da Receita Federal do Brasil.

3114.9k](/packages/nfephp-org-sped-efdreinf)[cloud-dfe/sdk-php

SDK para comunicação com a API CloudDFe.

1620.6k](/packages/cloud-dfe-sdk-php)[webmaniabr/nfe

PHP SDK da REST API de Nota Fiscal Eletrônica da WebmaniaBR®

149.3k](/packages/webmaniabr-nfe)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)