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.
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 em127.0.0.1:5432
, nome do banco, usuário e senha, são todos o padrãopostgres
.
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.
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;
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/
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;
*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.