chinnonsantos / sql-paises-estados-cidades

SQL de todos os Países e Nações (c/ Código do Portal do Comércio Exterior ou BACEN) + Estados e Federações Brasileiras (c/ DDD e Código do IBGE) + Cidades e Municípios Brasileiros (c/ Código do IBGE), incluindo as 31 regiões administrativas do DF, Ilhas e Áreas Remotas do Mundo.
MIT License
903 stars 304 forks source link
areas-df bacen cidades cidades-sql codigos-bacen estados estados-sql ibge ilhas-remotas municipios mysql paises paises-estados-cidades paises-sql sql tabela-de-cidades tabela-de-estados tabela-de-pais tabela-de-uf tabelas-sql

SQL COM TODOS OS PAÍSES (BACEN) + TODOS OS ESTADOS E CIDADES DO BRASIL (IBGE)

SQL de todos os Países e Nações (c/ Código do Portal do Comércio Exterior ou BACEN) + Estados e Federações Brasileiras (c/ DDD e Código do IBGE) + Cidades e Municípios Brasileiros (c/ Código do IBGE), incluindo as 31 regiões administrativas do DF, Ilhas e Áreas Remotas do Mundo.

Obs.: A tabela de Países está sofrendo atualizações na coluna do Código BACEN, priorizando o código do País através da tabela de países do Portal do Comércio Exterior, sendo assim em alguns casos o código BACEN do País está recebendo o Código do Portal de Comércio Exterior, levando em consideração que a Receita Federal está exigindo essa tabela em relação ao BACEN em seus documentos fiscais. Vide Nota Técnica 2018.003 no portal da nota fiscal eletrônica.

Teste local utilizando container (Docker)

Suba as dependências (necessário Docker e Docker Compose instalado)

cd docker/postgres
docker-compose up -d

Nota: No momento só há suporte a testes para scripts do PostgreSQL

Acesse o terminal do container e conecte ao banco postgres com a CLI psql

docker exec -it postgres bash
# 0bafe7328a2d:/# 

psql -U postgres -h localhost -p 5432 -d postgres
# psql (16.3)
# Type "help" for help.

# postgres=#

Liste os bancos de dados

\l
#                                                       List of databases
#    Name    |  Owner   | Encoding | Locale Provider |  Collate   |   Ctype    | ICU Locale | ICU Rules |   Access privileges   
# -----------+----------+----------+-----------------+------------+------------+------------+-----------+-----------------------
#  postgres  | postgres | UTF8     | libc            | en_US.utf8 | en_US.utf8 |            |           | 
#  template0 | postgres | UTF8     | libc            | en_US.utf8 | en_US.utf8 |            |           | =c/postgres          +
#            |          |          |                 |            |            |            |           | postgres=CTc/postgres
#  template1 | postgres | UTF8     | libc            | en_US.utf8 | en_US.utf8 |            |           | =c/postgres          +
#            |          |          |                 |            |            |            |           | postgres=CTc/postgres
# (3 rows)

Liste as tabelas

\dt
#          List of relations
#  Schema |  Name  | Type  |  Owner   
# --------+--------+-------+----------
#  public | cidade | table | postgres
#  public | estado | table | postgres
#  public | pais   | table | postgres
# (3 rows)

Liste os registros

select * from cidade order by id desc limit 3;
#   id  |       nome       | uf |  ibge   |                 lat_lon                 | cod_tom 
# ------+------------------+----+---------+-----------------------------------------+---------
#  5610 | Angicos          | 20 | 2400802 | (-5.661865760608609,-36.60085204710061) |    1615
#  5609 | Pescaria Brava   | 24 | 4212650 | (-28.3966007232666,-48.8863983154297)   |       0
#  5608 | Balneário Rincão | 24 | 4220000 | (-28.8313999176025,-49.2351989746094)   |       0
# (3 rows)
select * from pais order by id asc limit 3;
#  id |    nome     |        nome_pt        | sigla | bacen | ddi 
# ----+-------------+-----------------------+-------+-------+-----
#   1 | Brazil      | Brasil                | BR    |  1058 |  55
#   2 | Afghanistan | Afeganistão           | AF    |   132 |    
#   3 | Albania     | Albânia, Republica da | AL    |   175 |    
# (3 rows)

Nota: Os scripts .sql são importados automaticamente após a criação do container. O banco de dados também está disponível em 127.0.0.1:5432, nome do banco, usuário e senha, são todos o padrão postgres.

Dicas e Sugestões de Uso

Todos os Estados/Distritos e Cidades/Municípios Brasileiros possui um código único de identificação do IBGE, porém nem todos os Países e Nações do mundo possui um código único de identificação do BACEN, devido ao BACEN só catalogar Países dos quais ele possui ligação financeira (agências ou correspondentes bancários), geralmente esses países (ou espaços governados por outras nações) ausentes são ilhas inabitadas ou regiões inabitadas próximas das Antártida, não se preocupe com isso, provavelmente sua aplicação nunca irá precisar utilizar essas localizações.

A tabela de 'pais' possui todos os Países e Nações possíveis com ou sem sigla, com ou sem Código do BACEN, com nome original e nome traduzido para o Português.

Validações

Validação do Código de Município

O Código de Município do IBGE tem a composição que segue:

Validação possível:

Obs 1: Considerar a soma dos algarismos no somatório dos produtos dos pesos. Ou seja, se o produto for superior a 9 os dois algarismos devem ser somados.

Obs 2: Se o resto da divisão for zero, considerar o dígito verificador igual a zero.

O código de Município do IBGE dos seguintes Municípios tem o DV - dígito verificador inválido:

4305871 - Coronel Barros/RS;
2201919 - Bom Princípio do Piauí/PI;
2202251 - Canavieira /PI;
2201988 - Brejo do Piauí/PI;
2611533 - Quixaba/PE;
3117836 - Cônego Marinho/MG;
3152131 - Ponto Chique/MG;
5203939 - Buriti de Goiás/GO;
5203962 - Buritinópolis/GO;

Validação do Código de Município - Código TOM

O campo Código TOM possui 4 dígitos e se refere ao código usado para tratamento de arquivos da Receita da Federal do Brasil (RFB) ou Secretarias da Fazenda (SEFAZ). Arquivos do SIMPLES NACIONAL como PGDASD, DAF607 entre outros usam essa codificação.

Os dados foram extraídos do portal da SEFAZ MG: http://www.fazenda.mg.gov.br/governo/assuntos_municipais/codigomunicipio/

Validação do Código de País

Composição do Código de País:

Validação possível:

Obs.: Se o resto da divisão for zero ou 1, considerar o dígito verificador igual a zero.

O código de País do BACEN dos seguintes países tem o DV - dígito verificador inválido:

1504 - GUERNSEY, ILHA DO CANAL (INCLUI ALDERNEY E SARK);
1508 - JERSEY, ILHA DO CANAL;
3595 - MAN, ILHA DE;
4985 - MONTENEGRO;
6781 - SAINT KITTS E NEVIS;
7370 - SERVIA;

Contribuições

*Caso deseje contribuir com sugestões, correções ou adaptando o código SQL para outro tipo de SGBD será sempre bem-vindo, faça sempre um Pull Request.

Fontes