PHPackages                             nfephp-org/sped-ibge - 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. [Utility & Helpers](/categories/utility)
4. /
5. nfephp-org/sped-ibge

ActiveLibrary[Utility & Helpers](/categories/utility)

nfephp-org/sped-ibge
====================

Library to access the services of IBGE to obtain the codes used by the system SPED

v1.0.0(4y ago)75.4k↓50%7LGPL-3.0-or-laterPHPPHP >=7.0

Since Oct 13Pushed 4y ago1 watchersCompare

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

READMEChangelogDependencies (5)Versions (2)Used By (0)

sped-ibge
=========

[](#sped-ibge)

Esta classe usa a API do IBGE para buscar os estados e seus códigos e as cidades desses estados e seus codigos. Para uso dos projetos SPED da Receita Federal e das SEFAZ.

[![Actions Status](https://github.com/nfephp-org/sped-ibge/actions/workflows/ci.yml/badge.svg?style=flat-square)](https://github.com/nfephp-org/sped-gtin/actions)

[![Latest Stable Version](https://camo.githubusercontent.com/75dd3d26c983e1ed952a97462491e80aff0cd0c4228170dbe848b467acd1e030/68747470733a2f2f706f7365722e6f6b76706e2e6f72672f6e66657068702d6f72672f737065642d696267652f762f737461626c65)](https://packagist.org/packages/nfephp-org/sped-ibge)[![Latest Version on Packagist](https://camo.githubusercontent.com/9c81804c39ed24c89bcc9be7c29b9eaf1229d001e3633496f42969963842af7e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e66657068702d6f72672f737065642d696267652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-ibge)[![License](https://camo.githubusercontent.com/e0273385d246b6a90332d858facac88177613ea018b9a21e402ffad0d613f302/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-ibge)[![Total Downloads](https://camo.githubusercontent.com/83ab04236548cacf511aefcdfa76f4c021d2af4dbbaefb57622b8db243867a28/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f737065642d696267652f646f776e6c6f6164733f7374796c653d666c6174)](https://packagist.org/packages/nfephp-org/sped-ibge)

[![Issues](https://camo.githubusercontent.com/850981a7984a5b39b79b0c5b90de679c166ce5db9910c3a62696eab1684a5868/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e66657068702d6f72672f737065642d696267652e737667)](https://github.com/nfephp-org/sped-ibge/issues)[![Forks](https://camo.githubusercontent.com/e6b42d869547414b511496d4de38041cee84f6907d3656c7e7b688eeaf63c723/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e66657068702d6f72672f737065642d696267652e737667)](https://github.com/nfephp-org/sped-ibge/network)[![Stars](https://camo.githubusercontent.com/86bb1e7cd9b21377badd47a085d448afc1d4de1cce6c8b378ace8c1dd6c9dc21/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e66657068702d6f72672f737065642d696267652e737667)](https://github.com/nfephp-org/sped-ibge/stargazers)

O intuito desse projeto é prover uma fonte de dados para serem usados na manutenção das bases de dados dos aplicativos que emitem documentos para o projetos SPED.

> NOTA: Esse serviço do IBGE não deve ser acessado diretamente a cada consulta de seu cliente, pois será mais lento e instável que buscar isso na sua própria base de dados.

Esta classe possui 2 métodos principais e vários modificadores.

Métodos principais
==================

[](#métodos-principais)

[function estados()](Estados.md)
--------------------------------

[](#function-estados)

[function cidades($uf)](Municipios.md)
--------------------------------------

[](#function-cidadesuf)

> *IMPORTANTE: a pasta "storage" deve ter permissões de escrita pelo usuário que executa o PHP.*

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-ibge
```

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

```
"require": {
    "nfephp-org/sped-ibge" : "^1.0"
}
```

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

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

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

```
"require": {
    "nfephp-org/sped-ibge" : "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 PHP 7.x (recomendável PHP 7.2)
- ext-curl
- ext-json
- [league/flysystem](https://packagist.org/packages/league/flysystem)

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

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

1678d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/83b3feccdc04943c30ac9b785307cb73385c30d5b3ad8a7c700f7704416dc280?d=identicon)[robmachado](/maintainers/robmachado)

---

Top Contributors

[![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (26 commits)")

---

Tags

spedibgeMunicipiosEstatos

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nfephp-org-sped-ibge/health.svg)

```
[![Health](https://phpackages.com/badges/nfephp-org-sped-ibge/health.svg)](https://phpackages.com/packages/nfephp-org-sped-ibge)
```

###  Alternatives

[nfephp-org/sped-common

sped-common é parte do projeto NFePHP.

1051.7M64](/packages/nfephp-org-sped-common)[nfephp-org/sped-da

sped-da contêm as classes para criação dos documentos auxiliares referidos no projeto Sped.

145806.7k8](/packages/nfephp-org-sped-da)[nfephp-org/sped-esocial

e-Social library

18030.7k](/packages/nfephp-org-sped-esocial)[jansenfelipe/cidades-gratis

Com esse pacote você poderá consultar, gratuitamente, Cidades diretamente no site do IBGE.

423.5k](/packages/jansenfelipe-cidades-gratis)

PHPackages © 2026

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