PHPackages                             brunoalvim/sped-efd - 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. brunoalvim/sped-efd

ActiveLibrary[API Development](/categories/api)

brunoalvim/sped-efd
===================

API para geração dos arquivos para SPED EFD

1.0.0(3w ago)02↑1400%GPL-3.0-or-laterPHPPHP &gt;= 7.4

Since May 18Pushed 3w agoCompare

[ Source](https://github.com/brunoalvim/sped-efd)[ Packagist](https://packagist.org/packages/brunoalvim/sped-efd)[ Docs](https://github.com/brunoalvim/sped-efd)[ RSS](/packages/brunoalvim-sped-efd/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (1)Dependencies (6)Versions (2)Used By (0)

sped-efd
========

[](#sped-efd)

- Contrib/M215
- Contrib/M615
- Contrib/Z1601

EM DESENVOLVIMENTO
------------------

[](#em-desenvolvimento)

Classes para a geração do SPED EFD (fiscal ICMS IPI) e para o SPED EFD contribuições

### EFD ICMS IPI v3.1.3 Leiaute 17 - válido a partir de 01 de janeiro de 2022/abril de 2023.

[](#efd-icms-ipi-v313-leiaute-17---válido-a-partir-de-01-de-janeiro-de-2022abril-de-2023)

### EFD Contribuições v1.35 Leiaute 6 - válido a partir de 01 de janeiro de 2019.

[](#efd-contribuições-v135-leiaute-6---válido-a-partir-de-01-de-janeiro-de-2019)

IMPORTANTE
----------

[](#importante)

> **NOTA: Os elementos não mais irão retornar Exceptions, e sim carregar uma propriedade pública errors\[\], contendo todos os erros identificados em cada elemento.**

> **NOTA: As classes dos blocos e as próprias classes EFD herdarão os errros\[\] de seus elementos constituintes em propriedade pública errors\[\] de cada uma dessas classes.**

Controle de Versões de Layouts do EFD
-------------------------------------

[](#controle-de-versões-de-layouts-do-efd)

O controle de versões é feito com jsons na pasta storage.

#### storage/layouts/ICMSIPI/vigencias.json

[](#storagelayoutsicmsipivigenciasjson)

Este json contêm o codigo de leyout, versão, data inicial e a data final de vigência, obtido nas tabelas do Sped (vide portal Sped)

Deve ser passado uma string com o codigo do layaut no construtor de cada bloco, este por sua vez irão passar esse codigo e os demais dados de vigencia para cada elemento que pertença a esse bloco.

As estruturas construtivas de cada elemento e versão, deverão ser salvos como json na pasta denominada pelo codigo da versão. por exemplo:

- storage/layouts/ICMSIPI/v017

Ao ser criado ou editado o elemento internamente ele deve conter a estrutura referente a ultima versão existente.

Caso se necessite de versões anteriores a 017, estas deverão ser criadas como json elemente por elemento na pasta adequada.

DETALHES
--------

[](#detalhes)

- A finalidade desse projeto é APENAS fornecer os meios para criar os arquivos EFD ICMS/IPI e contribuições a partir de dados formecidos pelo sistema ERP.
- É necessario que os dados já estejam previamente tratados e consolidados internamente no ERP antes da geração dos arquivos de transmissão.
- Para entender o processo de montagem dos arquivos de envio, é OBRIGATÓRIO o conhecimento sobre esses dados e o estudo da documentação da Receita Federal.
- Haverão centenas de classes !!! uma para cada elemento de um bloco, esses elementos poderão ser unicos, varios, obrigatórios ou não dependendo de uma série de condições, que não serão gerenciadas por esse construtor.
- O processo de montagem dos blocos é complexo e irá requerer tempo de processamento e memória, tendo em vista o volume de dados que poderá existir.
- Após a geração do arquivo o mesmo deve ser validado pelo validador oficial da Receita e transmitido pelo Receitanet, não é possivel a validação automática nem o envio automatico por webservice

*Utilize o chat do Gitter para iniciar discussões específicas sobre o desenvolvimento deste pacote.*

[![Chat](https://camo.githubusercontent.com/445d620f465679229fca473137bf37506a0bc714bfdc57a55948c4814980d679/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4749545445522d3425323075736572732532306f6e6c696e652d677265656e2e7376673f7374796c653d666c61742d737175617265)](https://gitter.im/nfephp-org/sped-efd?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[![Actions](https://github.com/nfephp-org/sped-efd/actions/workflows/ci.yml/badge.svg)](https://github.com/nfephp-org/sped-efd/actions/workflows/ci.yml/badge.svg)[![Coverage Status](https://camo.githubusercontent.com/0f399590c04a99f3c10234f4a0924b72cc688f6227942fd8815b5399c672c29d/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f6e66657068702d6f72672f737065642d6566642e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/nfephp-org/sped-efd/code-structure)[![Quality Score](https://camo.githubusercontent.com/9d865b6845dd44a63c4552789324244b7dea7776c002efb42c10c73abfa431c3/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6e66657068702d6f72672f737065642d6566642e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/nfephp-org/sped-efd)

[![Latest Stable Version](https://camo.githubusercontent.com/05cb51d0c89cf6ecf5f4bcb26d7c9b68d622ce9327c6bea57b52cba0e6ad70e8/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f737065642d6566642f76657273696f6e)](https://packagist.org/packages/nfephp-org/sped-efd)[![Latest Version on Packagist](https://camo.githubusercontent.com/bf78df8e25531783a4addb3d3cd6491281a36ec9d2f149ba4fca3ad8bcdcb926/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e66657068702d6f72672f737065642d6566642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-efd)[![License](https://camo.githubusercontent.com/e0273385d246b6a90332d858facac88177613ea018b9a21e402ffad0d613f302/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-efd)[![Total Downloads](https://camo.githubusercontent.com/00c9839cd6e0dc362e644a65bba4ee64511134da335d701c18a22ec43b52c4d2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e66657068702d6f72672f737065642d6566642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-efd)

[![Issues](https://camo.githubusercontent.com/d14e103b29f401c4ec004e4b79fdf52c68f91ab05b6c2f9b5c60b7851c50efd8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e66657068702d6f72672f737065642d6566642e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-efd/issues)[![Forks](https://camo.githubusercontent.com/70fb4ab5a3dac7c8bd97803950b4e3fde9df2df0954eb9e1326f5e9cf564ea3d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e66657068702d6f72672f737065642d6566642e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-efd/network)[![Stars](https://camo.githubusercontent.com/c7a1a3f5a86364505bd8b98552a96109aee21c9dae3ec984899bbe50ff4390b1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e66657068702d6f72672f737065642d6566642e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-efd/stargazers)

Detalhes dos Campos
-------------------

[](#detalhes-dos-campos)

Todos os campos "C" strings apenas com caracteres ASCII, não são permitidos outro charsets, preferencialmente em "MAIUSCULAS"

Todos os campos "N" apenas numericos como:

$ 1.129.998,99 =&gt; 1129998,99

1.255,42 =&gt; 1255,42

234,567 =&gt; 234,567

10.000 =&gt; 10000

10.000,00 =&gt; 10000 ou 10000,00

17,00 % =&gt; 17,00 ou 17

18,50 % =&gt; 18,5 ou 18,50

30 =&gt; 30

1.123,456 Kg =&gt; 1123,456

0,010 litros =&gt; 0,010

0,00 =&gt; 0 ou 0,00

0 =&gt; 0

campo vazio =&gt;

Observando o numero de decimais em cada caso

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

37

—

LowBetter than 81% of packages

Maintenance95

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 79% 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

22d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6748e3be48c0069ed7527583fd0fd10980cff39655e726ccb24159b30eabed8f?d=identicon)[balvim](/maintainers/balvim)

---

Top Contributors

[![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (305 commits)")[![erickmff](https://avatars.githubusercontent.com/u/5818522?v=4)](https://github.com/erickmff "erickmff (11 commits)")[![joyltonmaciel](https://avatars.githubusercontent.com/u/46999691?v=4)](https://github.com/joyltonmaciel "joyltonmaciel (11 commits)")[![eduardokum](https://avatars.githubusercontent.com/u/2566340?v=4)](https://github.com/eduardokum "eduardokum (8 commits)")[![smallsoft-gustavo](https://avatars.githubusercontent.com/u/77071812?v=4)](https://github.com/smallsoft-gustavo "smallsoft-gustavo (8 commits)")[![guicalabria](https://avatars.githubusercontent.com/u/2413349?v=4)](https://github.com/guicalabria "guicalabria (7 commits)")[![lidani](https://avatars.githubusercontent.com/u/29063458?v=4)](https://github.com/lidani "lidani (7 commits)")[![guicouto](https://avatars.githubusercontent.com/u/8810377?v=4)](https://github.com/guicouto "guicouto (5 commits)")[![chrisbckr](https://avatars.githubusercontent.com/u/23089916?v=4)](https://github.com/chrisbckr "chrisbckr (5 commits)")[![brunoalvim](https://avatars.githubusercontent.com/u/24271696?v=4)](https://github.com/brunoalvim "brunoalvim (3 commits)")[![guicoutohub](https://avatars.githubusercontent.com/u/230244156?v=4)](https://github.com/guicoutohub "guicoutohub (3 commits)")[![cristiano-linvix](https://avatars.githubusercontent.com/u/54996308?v=4)](https://github.com/cristiano-linvix "cristiano-linvix (2 commits)")[![peixinhu130](https://avatars.githubusercontent.com/u/12190783?v=4)](https://github.com/peixinhu130 "peixinhu130 (2 commits)")[![davidvrsantos](https://avatars.githubusercontent.com/u/9995481?v=4)](https://github.com/davidvrsantos "davidvrsantos (2 commits)")[![GABRIELTERRIBILE](https://avatars.githubusercontent.com/u/80511716?v=4)](https://github.com/GABRIELTERRIBILE "GABRIELTERRIBILE (2 commits)")[![walkeralencar](https://avatars.githubusercontent.com/u/459481?v=4)](https://github.com/walkeralencar "walkeralencar (1 commits)")[![eumanito](https://avatars.githubusercontent.com/u/3042269?v=4)](https://github.com/eumanito "eumanito (1 commits)")[![f3lpz](https://avatars.githubusercontent.com/u/21207887?v=4)](https://github.com/f3lpz "f3lpz (1 commits)")[![paseto](https://avatars.githubusercontent.com/u/1163778?v=4)](https://github.com/paseto "paseto (1 commits)")[![andersonalvesdev](https://avatars.githubusercontent.com/u/68432255?v=4)](https://github.com/andersonalvesdev "andersonalvesdev (1 commits)")

---

Tags

nfephpspedefd

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/brunoalvim-sped-efd/health.svg)

```
[![Health](https://phpackages.com/badges/brunoalvim-sped-efd/health.svg)](https://phpackages.com/packages/brunoalvim-sped-efd)
```

###  Alternatives

[nfephp-org/sped-nfe

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

1.5k1.5M14](/packages/nfephp-org-sped-nfe)[nfephp-org/sped-cte

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

118247.7k2](/packages/nfephp-org-sped-cte)[nfephp-org/sped-mdfe

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

52150.8k](/packages/nfephp-org-sped-mdfe)[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)[nfephp-org/sped-nfse-ginfes

API para geração e comunicação de RPS e NFSe no padão Ginfes.

445.1k](/packages/nfephp-org-sped-nfse-ginfes)[lucas-simoes/php-nfse

API para geração e comunicação da NFSe com as Prefeituras. Este é um fork do projeto nfephp-org/sped-nfse que foi descontinuado

562.3k](/packages/lucas-simoes-php-nfse)

PHPackages © 2026

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