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.

• Arquivos separados por tipo de SGBD em Pastas.
• Arquivos separados por tabela.
• Cidades brasileiras com informações de Latitude e Longitude.
• Países com informações de DDI - Discagem Direta Internacional (em atualização!)
• Em breve será incluído estados e cidades estrangeiras.

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:

• Composição: UUNNNND Onde: UU = Código da UF do IBGE NNNN = Número de ordem dentro da UF; D = Dígito de Controle módulo 10

Validação possível:

• Extensão máxima: 7 dígitos;
• Extensão mínima: 7 dígitos;
• Código da UF: deve ser válido, conforme Tabela de UF do IBGE;
• Número de ordem dentro da UF: não pode ser zero;
• Dígito de Controle: módulo 10 (pesos 2 e 1)

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:

• NNND Onde: NNN = Número de ordem do Código do País; D = Dígito de Controle módulo 11.

Validação possível:

• Extensão máxima: 4 dígitos;
• Extensão mínima: 2 dígitos;
• Dígito de Controle: módulo 11, pesos 2 a 9

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

• @luizvaz - Luiz Vaz
• @brunotdantas - Bruno Dantas
• @gabrielozaki - Gabriel Ozaki
• @andersonls - Anderson Luiz Silvério
• @DenisonMartins - Michael Denison Lemos Martins
• @volneineves - Volnei Neves
• @leanmarqs - Lean Marqs
• E muitos outros...

*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

• Tabela de Países do Portal do Comércio Exterior (atualizada em 12/04/2019)
• Códigos BACEN
• Instruções de Preenchimento do Banco Central do Brasil - Março de 2016 - PDF
• Áreas dos Municípios do Brasil (vigente em 30/04/2018)
• Código IBGE das Unidade da Federação e Municípios do Brasil - 2018 - XLS
• Panorama IBGE dos Municípios do Brasil
• Lista de códigos telefónicos (DDI - Discagem Direta Internacional)