Comércio exterior brasileiro (comex)¶
O comex-fetcher coleta as estatísticas de comércio exterior em dados abertos do Ministério do Desenvolvimento, Indústria, Comércio e Serviços (MDIC), por meio da Secretaria de Comércio Exterior (SECEX). Os arquivos são a base do sistema Comex Stat e dos dados usados para construir a balança comercial brasileira. O fetcher os converte para o lake em Parquet.
Página da fonte: https://www.gov.br/mdic/pt-br/assuntos/comercio-exterior/estatisticas/base-de-dados-bruta
| Dataset | O que é | Período | Página |
|---|---|---|---|
exp |
Exportações por NCM, país, UF do produto, via e URF | 1997 em diante | exp |
imp |
Importações por NCM, com frete e seguro | 1997 em diante | imp |
exp-mun |
Exportações por município da empresa e posição SH4 | 1997 em diante | exp-mun |
imp-mun |
Importações por município da empresa e posição SH4 | 1997 em diante | imp-mun |
exp-nbm |
Exportações pela NBM (série histórica) | 1989 a 1996 | exp-nbm |
imp-nbm |
Importações pela NBM (série histórica) | 1989 a 1996 | imp-nbm |
auxiliary-tables |
Tabelas de códigos e classificações (NCM, SH, CUCI, ISIC, países, UF, municípios, via, URF...) | sem período | auxiliary-tables |
ncm-vigente |
NCM vigente, com todos os níveis e a vigência | vigente em 2026-11-05 | ncm-vigente |
repetro |
Exportações e importações REPETRO, destacadas da balança | 2001 em diante | repetro |
validacao |
Totais de linhas e valores de cada arquivo anual | 1997 em diante | validacao |
Como o MDIC publica¶
- Um arquivo CSV por ano e por direção (
EXP_AAAA.csv,IMP_AAAA.csv, e as versões_MUNe_NBM), com separador ponto e vírgula e cabeçalho. A página afirma que os arquivos reúnem todos os dados usados na construção da balança comercial e que os arquivos são grandes: o uso em planilhas pode perder linhas. - A página não declara periodicidade. O arquivo do ano corrente cresce com os meses divulgados. Em 2025, o MDIC deixou de oferecer os arquivos únicos com todos os anos (
*_COMPLETA.zip), com o aviso de que os anos anteriores estão congelados e de que basta baixar o ano mais recente (Informativo SECEX 029/2025). - As tabelas de códigos saem em CSV e reunidas em uma planilha. A série REPETRO e os totais para validação saem em arquivos próprios. A página também publica um calendário de dias úteis e correlações das classificações antigas, que o fetcher não baixa.
- O fetcher guarda cada versão baixada com a data de última modificação do servidor no nome (
<arquivo>@AAAAMMDD). O lake converte a versão mais recente de cada arquivo.
Como os conjuntos se relacionam¶
- NCM × município.
expeexp-mun(eimpeimp-mun) trazem o mesmo total de valor FOB e peso líquido por ano (conferido pelos totais de validação de 1997, 2005, 2010, 2015, 2020, 2024 e 2025); os arquivos municipais abrem o total pela empresa e pela posição SH4, sem NCM, via e URF. Use um ou outro, nunca a soma. - NBM × NCM.
exp-nbmeimp-nbmcobrem 1989 a 1996 eexpeimpcomeçam em 1997. A tabelanbm_ncm(emauxiliary-tables) converte uma classificação na outra. - REPETRO.
repetronão compõe a balança divulgada nem os arquivosexp/imp, segundo a fonte. - Códigos. Os códigos dos dados de comércio são descritos por
auxiliary-tables; ancm-vigentetraz a hierarquia atual da NCM. - Validação.
validacaopermite conferir o número de linhas e os totais de cada arquivo anual.
Quebras e avisos que valem para todos os conjuntos¶
| Desde | Mudança | Afeta |
|---|---|---|
| 1997-01 | A classificação passa da NBM para a NCM | exp, imp e as séries NBM |
| 2025-06 | O MDIC descontinua os arquivos únicos (*_COMPLETA.zip) |
coleta |
- Todas as medidas e códigos vêm do CSV como texto: as colunas de dados de comércio são
VARCHARno lake. Converta antes de somar. - A página do MDIC e a licença: o rodapé do site declara Creative Commons Atribuição-SemDerivações 3.0 Não Adaptada (CC BY-ND 3.0) para o conteúdo do site, e a página dos dados não traz licença própria. Cite a fonte e não redistribua versões modificadas sem confirmar com o MDIC.
- Os dados são agregados por operação; não há dado pessoal nos arquivos.