# Política externa: comércio com o BRICS e projetos do NDB — notas de coleta

Extração em 5 de outubro de 2026, para o estudo de caso do BRICS (tema `politica_externa`). Todos os números vêm de fontes de nível 1: MDIC/Secex (Comex Stat) e Novo Banco de Desenvolvimento (NDB). Nenhum número vem de imprensa.

## Arquivos

| Arquivo | Conteúdo |
|---|---|
| [politica_externa_comercio.csv](politica_externa_comercio.csv) | Exportações, importações, corrente e saldo (US$ FOB correntes) e participação na corrente de comércio do Brasil (%), para 11 países, a UE, BRICS-5, BRICS-11 e o total do Brasil. Anos completos de 2002 a 2025 e acumulado de janeiro a agosto de 2025 e de 2026. 1.924 linhas |
| [politica_externa_ndb_projetos.csv](politica_externa_ndb_projetos.csv) | Os 36 projetos do NDB no Brasil listados no site: 34 aprovados entre 2016 e 2025 e 2 propostos |
| [politica_externa_ndb.csv](politica_externa_ndb.csv) | Número de projetos e valor aprovado por ano no Brasil (2016–2025) e desembolsos no Brasil (2023–2025) |
| `dados/brutos/comexstat/` | 17 respostas da API, intocadas, com `manifesto.csv` |
| `dados/brutos/ndb/` | 45 arquivos (3 páginas da lista, 36 páginas de projeto, 2 notícias e 4 relatórios anuais em PDF), com `manifesto.csv` |
| `fontes/fichas/politica_externa/` | Fichas de `exportacoes_usd`, `importacoes_usd`, `corrente_usd`, `saldo_usd` e `participacao_corrente` |
| `scripts/coletar_comex.py` | Coleta e tratamento do Comex Stat (`python3 scripts/coletar_comex.py`; `--so-tratar` refaz o CSV sem baixar) |

## 1. Comércio (Comex Stat)

### 1.1 Endpoints usados

Todos em `https://api-comexstat.mdic.gov.br`:

| Chamada | Para quê | Bruto |
|---|---|---|
| `GET /general/dates/updated` | Data da base e último mês com dado: atualizada em 2026-09-04, com dados até agosto de 2026 | `atualizacao_2026-10-05.json` |
| `GET /tables/countries?language=pt` | Códigos dos países (a resposta do `/general` traz o nome, não o código) | `tabela_paises_2026-10-05.json` |
| `GET /tables/economic-blocks?language=pt` | Confirma que o bloco 22 é "União Europeia - UE" | `tabela_blocos_2026-10-05.json` |
| `POST /general?language=pt` | Valores. 14 consultas: exportação e importação × (11 países, bloco UE, total) × (anos completos, acumulado), mais o bloco UE aberto por país nos dois fluxos | `exp_*` e `imp_*` |

Exemplo de corpo (exportações para os 11 países, anos completos):

```json
{"flow": "export", "monthDetail": false, "period": {"from": "2002-01", "to": "2025-12"},
 "filters": [{"filter": "country", "values": ["160", "676", "361", "756", "240", "253", "372", "244", "053", "365", "249"]}],
 "details": ["country"], "metrics": ["metricFOB"]}
```

O corpo exato de cada consulta está na coluna `consulta_url` do manifesto.

### 1.2 Comportamentos da API descobertos nos testes

A documentação no próprio host (`/docs` e variações) responde 403, bloqueada pelo Cloudflare. Os pontos abaixo vêm de testes e estão comentados no script.

- **Só POST.** O `GET /general` com o filtro na URL responde 403.
- **`period` não é um intervalo contínuo.** Funciona como "anos de A a B, meses de M1 a M2 em cada ano". O pedido de 2024-01 a 2026-08 devolveu janeiro a agosto de 2024, 2025 e 2026. Com isso, o total exportado em 2025 aparece como US$ 227.407.790.484 (janeiro a agosto, `exp_total_parcial`), contra US$ 348.278.462.500 no ano cheio (`exp_total_anual`). Por isso os anos completos são pedidos de 2002-01 a 2025-12 e o acumulado de 2025-01 a 2026-08, o que entrega o mesmo recorte de meses nos dois anos.
- **Códigos com três dígitos, como texto.** O filtro com o inteiro `53` (Arábia Saudita) não devolve nada; `"053"` funciona. Num teste, antes da correção, isso zerou a Arábia Saudita sem nenhum erro. O script envia os códigos com três dígitos e para se algum parceiro não tiver dado em nenhum ano de uma consulta.
- **Linha omitida quando não há comércio.** Nesta extração não houve nenhum caso entre os parceiros.
- **Limite de requisições.** A API responde 429 ("tente novamente em 10 segundos") de forma irregular, às vezes mesmo com 20 segundos entre chamadas. O script espera 15 segundos entre chamadas e repete com espera crescente.
- **Download em massa não foi necessário.** A tabela de correspondência país–bloco do download em massa ([PAIS_BLOCO.csv](https://balanca.mdic.gov.br/balanca/bd/tabelas/PAIS_BLOCO.csv)) foi consultada à mão e traz os mesmos 38 códigos que a API soma na UE. O script não a baixa: o servidor `balanca.mdic.gov.br` não envia o certificado intermediário e o Python recusa a conexão (o curl do macOS aceita). O endereço antigo, `balanca.economia.gov.br`, não respondeu.

### 1.3 Decisões

1. **Participação na corrente como régua principal.** É a razão entre valores do mesmo ano, então dispensa deflacionar o dólar. Os valores em dólar ficam no CSV para rastreabilidade, sem deflação (`deflator: não se aplica` nas fichas).
2. **Agregados de composição fixa.** `brics5` = China, Rússia, Índia e África do Sul. `brics11` = esses quatro mais Egito, Etiópia, Irã, Emirados Árabes Unidos, Arábia Saudita e Indonésia. A composição é a mesma em todos os anos, inclusive antes da entrada de cada país. Por quê: mesma régua para todos os mandatos; um agregado com a composição de cada época mudaria de tamanho por adesão, não por comércio. O Brasil não entra nos agregados, porque é o denominador.
3. **China = código 160**, sem Hong Kong (351), Macau (447) e Taiwan (161). É como o Comex Stat registra: Hong Kong e Macau são territórios aduaneiros próprios.
4. **UE pelo bloco 22 da própria API**, que é a agregação oficial do Comex Stat. A composição também é fixa. São 38 códigos:
   - os 27 Estados-membros atuais, em todos os anos (a Croácia aparece desde 2002 e o Reino Unido não aparece em nenhum ano, nem antes do Brexit);
   - 9 regiões e territórios com código próprio: Ilhas Canárias, Madeira, Guadalupe, Guiana Francesa, Martinica, Reunião, Mayotte, São Martinho (parte francesa) e Ilhas Aland;
   - Andorra e San Marino, que não são membros da UE.

   O script confere, ano a ano, que a soma dos países do bloco é igual ao total do bloco.
5. **FOB nos dois fluxos.** As importações também vão em FOB, não CIF, para que corrente e saldo somem grandezas da mesma base. É a convenção da balança comercial oficial.
6. **Acumulado do ano com o mesmo período do ano anterior.** O ano corrente vai de janeiro a agosto de 2026 e é comparado com janeiro a agosto de 2025, não com 2025 inteiro, porque o comércio é sazonal (a soja concentra embarques no primeiro semestre). O id ganha `_parcial` antes do parceiro (`participacao_corrente_parcial__chn`). Assim vale a regra "parceiro no fim do id" e um `split("__")` separa medida e parceiro. As duas observações de cada série `_parcial` (2025 e 2026) são acumulados de janeiro a agosto.
7. **Resumo por mandato.** Média aritmética das participações anuais (D-007: nível), só com anos civis completos (D-006). Lula 3 usa 2023–2025, e 2026 aparece à parte, como acumulado. Bolsonaro também aparece sem 2020–21 (metodologia, seção 7).

### 1.4 Limitações

- **Membros do bloco mudaram.** A primeira cúpula, em 2009, teve os quatro países do BRIC. A África do Sul entrou no fim de 2010 e foi à cúpula de 2011 como membro. Egito, Etiópia, Irã e Emirados Árabes Unidos são membros desde janeiro de 2024, e a Indonésia desde janeiro de 2025. A Arábia Saudita foi convidada em 2023 e entra no `brics11` porque está na lista de 11 membros adotada no estudo, mas a formalização da adesão saudita é ambígua. Essas datas ainda precisam ser vinculadas às declarações oficiais das cúpulas antes da publicação. As séries por país permitem montar qualquer composição, inclusive a de cada ano ou um BRICS-11 sem a Arábia Saudita.
- **Atribuição de país e reexportações.** A exportação é atribuída ao país de destino declarado e a importação ao país de origem. Mercadorias que passam por centros de redistribuição (Hong Kong, Emirados, Países Baixos) podem ficar com o país intermediário. A estatística do parceiro (estatística espelho) não bate com a brasileira por frete, seguro, data de registro e atribuição de país.
- **Câmbio e preços.** Os valores estão em dólares correntes. Respondem à inflação americana e aos preços de commodities (soja, minério de ferro, petróleo), e o câmbio do real afeta volumes e preços negociados. A participação anula a inflação do dólar, mas não os preços relativos: uma alta do minério aumenta o peso da China sem mudança de volume.
- **Totais com operações especiais, a verificar.** O total do Brasil inclui todas as operações registradas. Operações especiais, como as de bens para exploração de petróleo no regime aduaneiro Repetro, podem alterar o denominador em anos específicos. O projeto não as exclui; falta verificar o tamanho do efeito.
- **Revisões.** O Comex Stat revisa meses recentes. O acumulado de 2026 é preliminar.

### 1.5 Tabela-resumo por mandato

Participação na corrente de comércio do Brasil, em %. Média aritmética das participações anuais. Fonte: [politica_externa_comercio.csv](politica_externa_comercio.csv), séries `participacao_corrente__chn`, `__brics5` e `__usa`.

| Mandato | Anos | China | BRICS-5 | EUA |
|---|---|---:|---:|---:|
| Lula 1 | 2003–2006 | 6,2 | 9,7 | 19,1 |
| Lula 2 | 2007–2010 | 11,5 | 15,5 | 13,6 |
| Bolsonaro | 2019–2022 | 26,0 | 30,0 | 14,5 |
| Bolsonaro, sem 2020–21 | 2019, 2022 | 24,6 | 28,6 | 15,2 |
| Lula 3 (parcial) | 2023–2025 | 26,9 | 31,3 | 13,2 |
| Acumulado 2025 (jan–ago) | 2025 | 27,7 | 32,1 | 13,7 |
| Acumulado 2026 (jan–ago) | 2026 | 28,8 | 33,9 | 11,5 |

## 2. Projetos do NDB no Brasil

### 2.1 Fontes

| Fonte | Uso | Bruto |
|---|---|---|
| [Lista de projetos do Brasil](https://www.ndb.int/projects/all-projects/?country=brazil), 3 páginas | Lista dos 36 projetos | `lista_projetos_brasil_p{1,2,3}_2026-10-05.html` |
| Página de cada projeto (36) | Nome, situação, área, tipo, data de aprovação do financiamento, limite do financiamento, tomador | `projeto_<slug>_2026-10-05.html` |
| [Relatório Anual 2025](https://www.ndb.int/wp-content/uploads/2026/07/NDB_AnnualReport2025.pdf), anexo "List of Projects Approved by NDB" (p. 181–189 do PDF) | Lista oficial das operações aprovadas por ano, com valor aprovado e notas de cancelamento, quitação e reestruturação | `relatorio_anual_2025_2026-10-05.pdf` |
| Relatórios anuais [2020](https://www.ndb.int/wp-content/uploads/2022/11/NDB-AR-2020_complete_v3.pdf), [2023](https://www.ndb.int/wp-content/uploads/2025/03/NDB_AnnualReport2023.pdf), [2024](https://www.ndb.int/wp-content/uploads/2025/12/NDB_AnnualReport2024_10Dec25.pdf) e 2025 | Gráficos de aprovações e de desembolsos por país | `relatorio_anual_<ano>_2026-10-05.pdf` |
| Notícias do NDB de [24/10/2019](https://www.ndb.int/news/ndb-board-directors-approves-two-projects-loans-aggregating-usd-800-mln/) e de [01/07/2021](https://www.ndb.int/news/ndb-board-of-directors-held-31st-meeting-approved-three-projects/) | Data de aprovação e reestruturação do Fundo Clima | `noticia_*_2026-10-05.html` |

Também foram consultados, sem uso como fonte de número, os relatórios anuais de [2016](https://www.ndb.int/wp-content/uploads/2022/11/NDB-ANNUAL-REPORT-2016.pdf), [2017](https://www.ndb.int/wp-content/uploads/2018/07/NDB_AR2017.pdf), [2018](https://www.ndb.int/wp-content/uploads/2019/11/NDB_ARA_pages.pdf), [2019](https://www.ndb.int/wp-content/uploads/2020/07/NDB_2019_ARA_1.pdf), [2021](https://www.ndb.int/wp-content/uploads/2022/10/NDB_AR_2021_complete.pdf) e [2022](https://www.ndb.int/wp-content/uploads/2023/12/NDB_AR_2022_complete-1.pdf).

### 2.2 Como os números foram lidos

Os PDFs foram lidos com um extrator de texto em Python puro que registra a posição (x, y) de cada trecho. Nos gráficos de barras, cada rótulo de valor foi associado ao país pela coordenada y, e cada leitura foi conferida com o total impresso no próprio gráfico:

| Gráfico | Soma das barras | Total impresso |
|---|---:|---:|
| Desembolsos no ano, RA 2023, p. 9 | 1.155 + 427 + 1.282 + 536 = 3.400 | 3.400 |
| Desembolsos no ano, RA 2024, p. 10 | 815 + 410 + 1.055 + 76 = 2.356 | 2.356 |
| Desembolsos no ano, RA 2025, p. 12 | 406 + 881 + 1.124 + 301 = 2.712 | 2.712 |
| Aprovações no ano, RA 2024, p. 7 | 412 + 1.012 + 781 + 1.986 + 320 = 4.511 | 4.511 |

Valores em US$ milhões, na ordem Brasil, Índia, China, África do Sul (e Bangladesh, no caso das aprovações de 2024). A Rússia não tem barra de desembolso nem de aprovação nesses anos, e as somas fecham sem ela. Páginas citadas pelo número da página no PDF.

### 2.3 Decisões

1. **Lista de projetos.** A lista é o anexo do Relatório Anual 2025, com 34 operações aprovadas para o Brasil entre 2016 e 2025, cruzada com o site, que tem 36 projetos (as mesmas 34 operações mais 2 propostas). A única divergência é o Fundo Clima. O site mostra "BNDES Clima" com data de 29/06/2021, que é a data da reestruturação. O empréstimo foi aprovado em 14/10/2019 como Fundo Clima, soberano, para a República (notícia do NDB de 24/10/2019). Em 2021, o tomador passou a ser o BNDES, com garantia da União (notícia de 01/07/2021). O relatório anual conta a operação em 2019 e não a repete em 2021. O CSV segue o relatório: data 2019-10-14, com nome e tomador explicando a reestruturação.
2. **`data_aprovacao`** = "Financing Approval Date" da página, que é a data de aprovação pelo Conselho de Diretores do NDB. Os 2 projetos propostos só têm "Concept Approval Date" e ficam com a data vazia.
3. **`valor` e `moeda`** = valor aprovado no anexo do Relatório Anual 2025, que o NDB publica em milhões arredondados. Quando a página traz o mesmo valor com mais casas, usa-se o da página: BRDE com EUR 134,64 milhões, Paraíba com US$ 60,95 milhões e Serra com US$ 57,6 milhões.
   - Brasília (Capital of Solar Lighting): o aprovado foi EUR 94 milhões (anexo de 2025 e Relatório Anual 2024), mas a página mostra hoje "Current Limit" de EUR 77 milhões. Vale o valor aprovado.
   - Moeda em código ISO 4217: CNY onde o NDB escreve RMB.
   - Nos projetos propostos, o valor é o limite proposto.
   - Os valores ficam na moeda original, sem conversão.
4. **`situacao`** é a da página em 05/10/2026, traduzida (aprovado, concluído, cancelado, proposto). Para cancelados, o ano do cancelamento vem das notas do anexo. O projeto de Brasília aparece cancelado no site, mas o anexo do Relatório Anual 2025 ainda não registra o cancelamento, então o ano não é informado.
5. **`governo_na_aprovacao`** é o mandato ([mandatos.csv](../../metodologia/mandatos.csv)) na data de aprovação pelo NDB. Indica quem governava, não quem decidiu: a aprovação é do Conselho do NDB. Operações de crédito externo de estados, municípios e estatais com garantia da União passam antes pela Comissão de Financiamentos Externos (Cofiex) e dependem de autorização do Senado, etapas que podem ter ocorrido em outro mandato. A coluna também não diz quem pediu os cancelamentos.
6. **`ndb_aprovacoes_brasil_usd`**, em US$ milhões, sem conversão feita pelo projeto.
   - Nos anos em que todas as aprovações foram em dólar (2016–2019 e 2021–2023), é a soma do anexo. A soma confere com os relatórios: 300 em 2016, 321 em 2018 e 900 em 2019 (RA 2020, p. 55) e 522 em 2023 (RA 2023, p. 6).
   - Nos anos com euro ou renminbi, usa-se o valor que o NDB publica no gráfico de aprovações por país do relatório do ano, convertido pelo câmbio de fim de ano: 2020 (US$ 3.325 milhões + EUR 135 milhões) = 3.491 (RA 2020, p. 55); 2024 (US$ 119 milhões + RMB 1.425 milhões + EUR 94 milhões) = 412 (RA 2024, p. 7); 2025 (US$ 1.020 milhões + RMB 3.550 milhões) = 1.528 (RA 2025, p. 9).
7. **`ndb_projetos_aprovados_brasil_n`** conta as operações do anexo por ano de aprovação, incluindo as canceladas depois (9 das 34).
8. **Conferência de completude.** A carteira que o NDB publica para o Brasil em 31/12/2025 é de US$ 6.690 milhões (RA 2025, p. 9). Ela soma as aprovações líquidas de cancelamentos e quitações. As operações ativas da lista somam US$ 5.710 milhões, EUR 229 milhões e RMB 4.975 milhões, o que é compatível com esse total. Isso indica que a lista está completa.

### 2.4 Limitações e lacunas

- **Desembolsos por país antes de 2023: lacuna.** Os relatórios de 2021 e 2022 trazem o gráfico de desembolsos por país sem rótulos de valor, só barras. Medir o comprimento das barras daria uma estimativa, não um dado, e não foi feito. Os relatórios de 2016 a 2020 informam só o total desembolsado pelo banco no ano. As demonstrações financeiras trazem estoques por país (por exemplo, empréstimos desembolsados ao Brasil de US$ 550 milhões em 31/12/2019, no RA 2020, p. 88), não fluxos anuais. Com isso, a série de desembolsos cobre só 2023–2025 e não permite comparar mandatos. O desembolso por projeto não é publicado nas páginas.
- **2026.** Até 05/10/2026, o site não mostra nenhuma aprovação de financiamento para o Brasil em 2026, só a aprovação de conceito do projeto da RGE Sul, em 05/07/2026. O resumo anual vai até 2025.
- **Desembolsos em US$** seguem a conversão do NDB pelo câmbio de fim de ano e incluem investimentos em participação (nota do gráfico do RA 2025).
- **Colunas não pedidas.** O tipo da operação (soberana ou não soberana) não está entre as colunas do CSV de projetos. Ele está nas páginas brutas e no anexo: 24 operações soberanas e 10 não soberanas entre as 34 aprovadas.
- **Casos particulares.**
  - O FONPLATA (banco de desenvolvimento de Argentina, Bolívia, Brasil, Paraguai e Uruguai) aparece no site como projeto no Brasil.
  - Patria Infrastructure Fund IV é um investimento em fundo, e a página traz "Fund Manager" em vez de "Borrower". Segundo o RA 2019 (nota 46), o financiamento do NDB seria usado só em investimentos no Brasil.
  - A operação com a Vale (2019) inclui até US$ 50 milhões que podiam ser entregues em renminbi (nota do anexo).

### 2.5 Resumo por governo na aprovação

Fonte: [politica_externa_ndb_projetos.csv](politica_externa_ndb_projetos.csv) e [politica_externa_ndb.csv](politica_externa_ndb.csv). Valor aprovado em US$ milhões, pela regra do item 2.3.6.

| Governo na aprovação | Anos | Projetos aprovados | Cancelados depois | Valor aprovado (US$ milhões) |
|---|---|---:|---:|---:|
| Dilma 2 | 2016 (até 11/05) | 1 | 0 | 300 |
| Temer | 2016 (desde 12/05)–2018 | 3 | 1 | 321 |
| Bolsonaro | 2019–2022 | 17 | 6 | 5.388 |
| Lula 3 (parcial) | 2023–2025 | 13 | 2 | 2.462 |

## 3. Pendências fora desta entrega

- Os dois CSVs do NDB foram montados por um script de trabalho a partir dos brutos listados acima. O script ainda não está em `scripts/`, e os indicadores do NDB ainda não têm ficha (seria `api: manual`, com a página de cada número).
- `scripts/coletar.py --tema politica_externa` pula estas fichas com o aviso "api desconhecida 'comexstat'". A coleta do comércio é feita por `scripts/coletar_comex.py`.
- As fontes documentais (relatórios anuais e notícias do NDB) não foram lançadas em `fontes/registro/politica_externa.csv`, e as decisões acima não foram registradas em `metodologia/decisoes.md`.