PHPackages                             ixc-soft/ixc-nfe - 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. ixc-soft/ixc-nfe

ActiveLibrary[API Development](/categories/api)

ixc-soft/ixc-nfe
================

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

v1.34.1(4mo ago)12.4k↓27.3%LGPL-3.0-or-laterPHPPHP &gt;= 7.4

Since Jul 29Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/IXC-Soft/ixc-nfe)[ Packagist](https://packagist.org/packages/ixc-soft/ixc-nfe)[ Docs](https://github.com/IXC-Soft/ixc-nfe)[ RSS](/packages/ixc-soft-ixc-nfe/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (8)Versions (14)Used By (0)

SPED-NFE
========

[](#sped-nfe)

Biblioteca para geração e comunicação das NFe com as SEFAZ autorizadoras, e visa fornecer os meios para gerar, assinar e enviar os dados relativos ao projeto Sped NFe das SEFAZ.

Atualizado
----------

[](#atualizado)

- Nota Técnica 2025.001 v.1.00 Divulga Simplificação Operacional: NFC-e: Leiaute do QR-Code versão 3 NF-e
- Nota Técnica 2025.002 v.1.01 Nota técnica de adequação dos leiautes da NF-e e da NFC-e Reforma Tributária do Consumo - RTC.
- Nota Técnica Conjunta 2025.001 Divulga orientações sobre implementação do CNPJ alfanumérico nos documentos fiscais eletrônicos
- Nota Técnica 2024.003 v.1.04 Alteração nas regras de validação
- Nota Técnica 2021.003 v.1.40 Validação GTIN
- Nota Técnica 2024.003 v.1.05 Informações de Produtos da Agricultura, Pecuária e Produção Florestal e Alteração de regra de validação
- Nota Técnica 2023.001 v.1.60 Tributação Monofásica sobre Combustíveis
- Nota Técnica 2025.001 v.1.00 Simplificação Operacional: NFC-e (QR-Code versão 3) (Envio sincrono NFe)
- Nota Técnica 2025.002-RTC v.1.10 Reforma Tributária do Consumo – Adequações NF-e / NFC-e
- Schema PL\_010v1.10b de 09/06/2025
- Nota Técnica 2025.002-RTC v.1.20 Reforma Tributária do Consumo – Adequações NF-e / NFC-e
- Schema PL\_010v1.20b de 30/07/2025

[![PHP Supported Version](https://camo.githubusercontent.com/b81f3fb713c876c1c315539e9fdee10b96395a838e7e1a3acae9276659af76a3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e66657068702d6f72672f737065642d6461)](https://camo.githubusercontent.com/b81f3fb713c876c1c315539e9fdee10b96395a838e7e1a3acae9276659af76a3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e66657068702d6f72672f737065642d6461)[![Actions](https://github.com/nfephp-org/sped-nfe/actions/workflows/ci.yml/badge.svg)](https://github.com/nfephp-org/sped-nfe/actions/workflows/ci.yml/badge.svg)[![codecov](https://camo.githubusercontent.com/bebfaa1aaee2522a6ec42547eb61df41267efce459bca746a915d10c31b2cb03/68747470733a2f2f636f6465636f762e696f2f67682f6e66657068702d6f72672f737065642d6e66652f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d55735a6e6a544e4b4b68)](https://codecov.io/gh/nfephp-org/sped-nfe)

[![Latest Stable Version](https://camo.githubusercontent.com/9e9d3576b641b81910488b6ea9595d2f4e128a1c5f7934ee126f9a2d7bcc6756/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f737065642d6e66652f76657273696f6e)](https://packagist.org/packages/nfephp-org/sped-nfe)[![Latest Version on Packagist](https://camo.githubusercontent.com/65f8d62d2aee1aefad5363e202dc0a13d0fea7f7e99ebc983a581cd69f78c337/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-nfe)[![License](https://camo.githubusercontent.com/e0273385d246b6a90332d858facac88177613ea018b9a21e402ffad0d613f302/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-nfe)[![Total Downloads](https://camo.githubusercontent.com/28f98b3485d41399f2ba0ae2796bb2227524001cdd1f383ddb79009ddc1c46af/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-nfe)

[![Issues](https://camo.githubusercontent.com/f0cb60f3d731818d45f360745375b98c0b1bb5777eb3db91d797643360063317/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-nfe/issues)[![Forks](https://camo.githubusercontent.com/408efd3d0f2388831156582b3cd6c99753bd6aaa48364eb24df62d41e770c12e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-nfe/network)[![Stars](https://camo.githubusercontent.com/465da61151e0df2c773003e867fa7ed4c9d5ae97e2a3161255565c341427be24/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e66657068702d6f72672f737065642d6e66652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-nfe/stargazers)

Estados atendidos
-----------------

[](#estados-atendidos)

### NFe (modelo 55) TODOS

[](#nfe-modelo-55-todos)

### NFCe (modelo 65) Todos

[](#nfce-modelo-65-todos)

### NFe com eCPF (emissor pessoa física)

[](#nfe-com-ecpf-emissor-pessoa-física)

> Os estados de **CE**, **PR** e **SP** **NÃO ACEITAM EMISSÃO com eCPF**

> AM e GO não foi possível verificar por problemas na comunicação

> Todos os demais estados (aparentemente) já aceitam emissão por eCPF

Este pacote é aderente com os [PSR-1](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md), [PSR-2](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md) e [PSR-4](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader.md). Se você observar negligências de conformidade, por favor envie um patch via pull request.

Não deixe de se cadastrar no [grupo de discussão do NFePHP](http://groups.google.com/group/nfephp) para acompanhar o desenvolvimento e participar das discussões e tirar dúvidas!

Install
-------

[](#install)

**Este pacote está listado no [Packgist](https://packagist.org/) foi desenvolvido para uso do [Composer](https://getcomposer.org/), portanto não será explicitada nenhuma alternativa de instalação.**

*E deve ser instalado com:*

```
composer require nfephp-org/sped-nfe
```

Ou ainda alterando o composer.json do seu aplicativo inserindo:

```
"require": {
    "nfephp-org/sped-nfe" : "^5.0"
}
```

*Para utilizar o pacote em desenvolvimento (branch master) deve ser instalado com:*

```
composer require nfephp-org/sped-nfe:dev-master
```

*Ou ainda alterando o composer.json do seu aplicativo inserindo:*

```
"require": {
    "nfephp-org/sped-nfe" : "dev-master"
}
```

> NOTA: Ao utilizar este pacote na versão em desenvolvimento não se esqueça de alterar o composer.json da sua aplicação para aceitar pacotes em desenvolvimento, alterando a propriedade "minimum-stability" de "stable" para "dev".
>
> ```
> "minimum-stability": "dev"
> ```

Requirements
------------

[](#requirements)

Para que este pacote possa funcionar são necessários os seguintes requisitos do PHP e outros pacotes dos quais esse depende.

- PHP 7.x (minimo PHP 7.4 veja sempre nos badges)
- ext-curl
- ext-dom
- ext-json
- ext-gd
- ext-mbstring
- ext-mcrypt
- ext-openssl
- ext-soap
- ext-xml
- ext-zip
- [sped-common](https://github.com/nfephp-org/sped-common)

> Para outras ações necessárias ao SPED, podem ser usados (opcionalmente) outros pacotes, como:

> - [sped-da](https://github.com/nfephp-org/sped-da) Geração dos documentos impressos (DANFE, DACTE, etc.)
> - [sped-mail](https://github.com/nfephp-org/sped-mail) Envio de email com as notas e outros documentos fiscais
> - [sped-ibpt](https://github.com/nfephp-org/sped-ibpt) Consulta dos impostos aproximados na venda a consumidor
> - [sped-gnre](https://github.com/nfephp-org/sped-gnre) Geração do GNRE
> - [posprint](https://github.com/nfephp-org/posprint) Impressão de documentos em impressoras térmicas POS

Como eu faço uso desta biblioteca no meu projeto?
-------------------------------------------------

[](#como-eu-faço-uso-desta-biblioteca-no-meu-projeto)

Primeiro, esta biblioteca faz uso dos recursos mais atuais do PHP para classes e objetos, portanto abaixo vai um exemplo ERRADO de uso:

```
require 'sped-nfe/src/Make.php';

$nfe = new Make();

```

Portanto, você deve primeiro entender que para usar esta biblioteca você precisará trabalhar com NAMESPACES pois trabalhamos com NAMESPACES.

Agora que você sabe que NAMESPACES é requerido, o uso correto para o exemplo acima seria:

```
// VENDOR_DIR = pasta vendor da sua instalação composer
require VENDOR_DIR . 'autoload.php';

use NFePHP\NFe\Make;

$nfe = new Make();

```

Acknowledgments
---------------

[](#acknowledgments)

- A todos os colegas que colaboram de alguma forma com o desenvolvimento contínuo desta biblioteca.

Documentation
-------------

[](#documentation)

O processo de documentação ainda está no inicio, mas já existem alguns documentos úteis.

[Documentação](docs/Funcionalidades.md)

### Para tirar suas duvidas não inicie uma ISSUE, mas se inscreva no grupo do google [NFePHP](http://groups.google.com/group/nfephp).

[](#para-tirar-suas-duvidas-não-inicie-uma-issue-mas-se-inscreva-no-grupo-do-google-nfephp)

Contributing
------------

[](#contributing)

Para contribuir com correções de BUGS, melhoria no código, documentação, elaboração de testes ou qualquer outro auxílio técnico e de programação por favor observe o [CONTRIBUTING](CONTRIBUTING.md) e o [Código de Conduta](CONDUCT.md) para maiores detalhes.

### Etapas para contribuir com Código

[](#etapas-para-contribuir-com-código)

1. Faça um fork do projeto em sua conta no GitHub
2. Baixe a biblioteca na sua maquina de desenvolvimento a partir do seu próprio fork
3. Execute o composer install na raiz do projeto (prefira usar o PHP 8.2 ou 8.3)
4. Crie uma relação com o projeto original usando o git, com isso criará um bloco denominado "upstream" com uma cópia do projeto original

```
git remote add upstream git@github.com:nfephp-org/sped-nfe.git

```

5. Antes de começar a codar sobre sua cópia sempre sincronize o projeto com o repositório principal

```
git fetch upstream
git merge upstream/master
git push

```

6. Agora pode codar sobre sua cópia da biblioteca
7. Ao terminar, sempre teste suas alterações para garantir o funcionamento, para isso recomendo criar uma pasta denominada "local" na raiz, e esta pasta não será enviada ao repositório, então poderá ter dados sensíveis.
8. Sempre, antes de fazer envio ao seu repositório execute os comandos abaixo, a partir de raiz do projeto na sua maquina:

```
composer phpcbf
composer phpcs
composer stan
composer test

```

9. Se nenhum erro for indicado pos esses testes, pode enviar ao seu repositório, lá serão executados os comandos do GitHub Actions
10. Se passar nos testes, pode fazer um pull request para o projeto original.
11. Se o PR for aceito, não esqueça de repetir os comandos do passo 5.

Change log
----------

[](#change-log)

Acompanhe o [CHANGELOG](CHANGELOG.md) para maiores informações sobre as alterações recentes.

Testing
-------

[](#testing)

Todos os testes são desenvolvidos para operar com o PHPUNIT

Security
--------

[](#security)

Caso você encontre algum problema relativo a segurança, por favor envie um email diretamente aos mantenedores do pacote ao invés de abrir um ISSUE.

Credits
-------

[](#credits)

Roberto L. Machado (owner and developer)

License
-------

[](#license)

Este pacote está diponibilizado sob LGPLv3 ou MIT License (MIT). Leia [Arquivo de Licença](LICENSE.md) para maiores informações.

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance74

Regular maintenance activity

Popularity23

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80.6% 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 ~18 days

Recently: every ~29 days

Total

9

Last Release

143d ago

Major Versions

v0.0.6 → v1.022025-09-25

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/48370677?v=4)[Marcos Marcolin](/maintainers/marcosmarcolin)[@marcosmarcolin](https://github.com/marcosmarcolin)

---

Top Contributors

[![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (1722 commits)")[![gersonfs](https://avatars.githubusercontent.com/u/293154?v=4)](https://github.com/gersonfs "gersonfs (101 commits)")[![eduardokum](https://avatars.githubusercontent.com/u/2566340?v=4)](https://github.com/eduardokum "eduardokum (58 commits)")[![olavocneto](https://avatars.githubusercontent.com/u/568745?v=4)](https://github.com/olavocneto "olavocneto (40 commits)")[![Maykon-JDS](https://avatars.githubusercontent.com/u/62573242?v=4)](https://github.com/Maykon-JDS "Maykon-JDS (24 commits)")[![SuportecTL](https://avatars.githubusercontent.com/u/48482204?v=4)](https://github.com/SuportecTL "SuportecTL (20 commits)")[![joaoroyosilva](https://avatars.githubusercontent.com/u/6354258?v=4)](https://github.com/joaoroyosilva "joaoroyosilva (16 commits)")[![lidani](https://avatars.githubusercontent.com/u/29063458?v=4)](https://github.com/lidani "lidani (15 commits)")[![lucianoconforto](https://avatars.githubusercontent.com/u/26275891?v=4)](https://github.com/lucianoconforto "lucianoconforto (14 commits)")[![smallsoft-gustavo](https://avatars.githubusercontent.com/u/77071812?v=4)](https://github.com/smallsoft-gustavo "smallsoft-gustavo (13 commits)")[![duzzk1](https://avatars.githubusercontent.com/u/115682186?v=4)](https://github.com/duzzk1 "duzzk1 (12 commits)")[![p4bl04p](https://avatars.githubusercontent.com/u/16137068?v=4)](https://github.com/p4bl04p "p4bl04p (10 commits)")[![eduardopinto1](https://avatars.githubusercontent.com/u/133913986?v=4)](https://github.com/eduardopinto1 "eduardopinto1 (10 commits)")[![NewtonMan](https://avatars.githubusercontent.com/u/4259752?v=4)](https://github.com/NewtonMan "NewtonMan (9 commits)")[![GustavoSantarosa](https://avatars.githubusercontent.com/u/60905574?v=4)](https://github.com/GustavoSantarosa "GustavoSantarosa (8 commits)")[![ogabrielsantos](https://avatars.githubusercontent.com/u/5789536?v=4)](https://github.com/ogabrielsantos "ogabrielsantos (7 commits)")[![thmrdev](https://avatars.githubusercontent.com/u/41805723?v=4)](https://github.com/thmrdev "thmrdev (6 commits)")[![victorvilella](https://avatars.githubusercontent.com/u/11229358?v=4)](https://github.com/victorvilella "victorvilella (5 commits)")[![jalesc](https://avatars.githubusercontent.com/u/140724308?v=4)](https://github.com/jalesc "jalesc (5 commits)")[![lpj145](https://avatars.githubusercontent.com/u/11980109?v=4)](https://github.com/lpj145 "lpj145 (5 commits)")

---

Tags

nfenfephpspednfce

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ixc-soft-ixc-nfe/health.svg)

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

###  Alternatives

[nfephp-org/sped-nfe

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

1.4k1.4M10](/packages/nfephp-org-sped-nfe)[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-gtin

Classes for validation of GTIN codes.

17981.7k11](/packages/nfephp-org-sped-gtin)[nfephp-org/sped-efdreinf

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

3013.0k](/packages/nfephp-org-sped-efdreinf)

PHPackages © 2026

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