Simulador de Risco Cambial e Contingência

Capítulo 01

Visão geral do sistema

O simulador estima, em bases probabilísticas, quanto a variação do câmbio pode custar a um contrato com insumos, equipamentos ou serviços atrelados a moeda estrangeira — e converte essa incerteza em um valor de contingência defensável.

O problema que o sistema resolve

Em contratos com parcela indexada a moeda estrangeira, o custo futuro depende de uma variável que ninguém controla. A prática usual — adotar um único câmbio "provável" — produz um número isolado, sem informar a probabilidade de ele ser insuficiente. O simulador substitui esse número único por uma distribuição de resultados: milhares de trajetórias de câmbio são geradas, cada uma aplicada ao cronograma de desembolso, gerando milhares de impactos financeiros possíveis.

Dessa distribuição extraem-se as respostas úteis: qual a chance de haver perda, qual reserva cobre 80% ou 95% dos cenários, e qual a perda média nos casos em que a reserva é estourada.

Fluxo de trabalho em cinco passos

1

Dados do contratoValor total, parcela exposta ao câmbio, moeda, horizonte, câmbio-base e fator de repasse.

2

Cronograma de exposiçãoDistribuição da exposição ao longo dos meses, com o percentual de hedge de cada parcela.

3

Modelo estatísticoEscolha entre lognormal, triangular, cenários discretos ou bootstrap histórico.

4

SimulaçãoNúmero de iterações, percentil alvo, semente aleatória e configuração do histograma.

5

Leitura e registroInterpretação dos indicadores, exportação em CSV e impressão do relatório em PDF.

O que o sistema não faz

Não prevê o câmbio futuro. Ele organiza a incerteza a partir das premissas que você informa.
Não substitui política de hedge, parecer econômico-financeiro nem análise jurídica do contrato.
Não modela correlação com outros riscos (inflação de insumos, atraso de cronograma, risco de crédito).
Não considera tributos, custos financeiros da operação de hedge nem efeitos de repactuação contratual.

Sugestão de primeiro uso: feche este manual, clique em Carregar exemplo e depois em Calcular. Volte aqui e percorra os capítulos 2 a 7 comparando cada explicação com a tela.

Capítulo 02

Conceitos essenciais

Sete conceitos sustentam todas as telas do sistema. Compreendidos estes, o restante do manual é apenas detalhamento operacional.

Exposição cambialParcela do contrato, em reais, cujo custo varia com a moeda estrangeira. Não é o valor total do contrato: é apenas a fração efetivamente indexada.

Repasse (pass-through)Proporção da variação cambial que efetivamente chega ao custo. Fornecedores com estoque nacional, componentes locais ou preços travados repassam menos de 100%.

HedgeFração de uma parcela protegida por instrumento financeiro ou cláusula contratual. No modelo, a parcela protegida é liquidada ao câmbio-base, com impacto zero.

ContingênciaReserva financeira dimensionada para absorver o risco. Aqui é sempre não negativa: ganhos cambiais não reduzem a reserva necessária.

Percentil (VaR)P80 é o valor que não é superado em 80% dos cenários simulados. É o "valor em risco" no nível de confiança escolhido.

CVaRMédia das perdas além do percentil. Responde: quando a reserva estourar, quanto tende a faltar em média.

Monte CarloMétodo que substitui o cálculo analítico por repetição massiva de sorteios. Cada iteração é um futuro possível; o conjunto forma a distribuição.

Por que separar impacto líquido e perda

O sistema mantém duas séries distintas. O impacto econômico líquido admite valores negativos, representando ganho quando o câmbio cai — é a visão econômica correta do resultado do contrato. A série de perdas converte todo resultado favorável em zero, porque uma reserva de contingência não pode ser dimensionada assumindo que o câmbio vai ajudar. Todas as reservas (P50 a P99 e CVaR) derivam da segunda série; os indicadores econômicos (média, desvio, assimetria) derivam da primeira.

🧪 Laboratório 1 — o impacto de uma parcela

Altere os campos e observe a fórmula operando em tempo real. Este é exatamente o cálculo que o motor repete para cada parcela, em cada uma das milhares de iterações.

Exposição da parcela (R$)

Câmbio-base

Câmbio na data da parcela

Repasse (%)

Hedge (%)

Variação cambial

+12,50%

Impacto financeiro

R$ 125.000,00

Sobre a parcela

12,50%

Leia assim: com hedge de 40%, apenas 60% da parcela permanece exposta; com repasse de 70%, apenas 70% da variação chega ao custo. Os dois fatores são multiplicativos e reduzem o impacto de forma independente.

Capítulo 03

Passo 1 — Dados do contrato

O primeiro cartão define a escala do problema. Erros aqui deslocam todos os resultados proporcionalmente, sem que o sistema tenha como detectá-los.

Campo	Significado	Como preencher
Projeto / contrato	Identificação livre.	Use um rótulo que apareça no CSV e no PDF, incluindo número do processo quando houver.
Valor total (R$)	Base de referência para os percentuais dos resultados.	Valor global contratado. Serve de denominador em todos os indicadores "% do contrato".
Parcela exposta (R$)	Fração indexada à moeda estrangeira.	Levante item a item na planilha orçamentária. Deve ficar entre zero e o valor total.
Moeda	USD, EUR ou CNY.	Define a moeda consultada na busca online de séries históricas.
Horizonte (meses)	Prazo máximo de exposição, entre 1 e 120.	Normalmente o prazo até o último desembolso indexado, não o prazo total da obra.
Câmbio-base	Cotação de referência do orçamento.	Use a cotação da data-base do orçamento. É o ponto de partida de todas as trajetórias.
Câmbio determinístico	Cenário único de comparação.	A cotação que seria adotada em uma análise tradicional. Aparece como linha vermelha no histograma.
Fator global de repasse (%)	Quanto da variação chega ao custo.	100% para importação direta; menos quando há nacionalização parcial ou preço travado.

Regras de validação aplicadas

Valor total maior que zero.
Parcela exposta entre zero e o valor total.
Horizonte entre 1 e 120 meses.
Câmbio-base e câmbio determinístico positivos.
Repasse entre 0% e 100%.

Mensagens em vermelho no campo Revise bloqueiam o cálculo; mensagens em âmbar são avisos e não impedem a simulação.

Erro frequente: lançar o valor total do contrato como parcela exposta. Isso multiplica a contingência pela razão entre os dois valores. Se apenas 25% do orçamento é importado, a parcela exposta é 25% — e não o valor global.

Relação entre câmbio-base e data-base: se o orçamento foi elaborado meses antes e o câmbio já se moveu, atualizar apenas o câmbio-base sem reduzir o horizonte superestima o risco remanescente, porque parte da variação já se materializou.

Capítulo 04

Passo 2 — Cronograma de exposição

O cronograma é o coração do modelo. O risco cambial não depende do prazo do contrato, mas do momento em que cada desembolso indexado ocorre.

Por que o mês importa mais do que o horizonte

Em processos de difusão, a dispersão do câmbio cresce com a raiz quadrada do tempo. Um desembolso no mês 4 carrega desvio-padrão proporcional a √4; no mês 36, proporcional a √36 — três vezes maior. Ampliar o horizonte de 12 para 60 meses sem mover as parcelas não altera o risco simulado: as parcelas continuam ocorrendo cedo, e o intervalo adicional simplesmente não é usado por nenhuma exposição.

Por isso o sistema emite aviso quando a última parcela ocorre antes de 60% do horizonte, e oferece o botão Estender ao horizonte, que redistribui as parcelas uniformemente até o último mês.

🧪 Laboratório 2 — o efeito do prazo sobre a dispersão

Com o modelo lognormal, informe tendência e volatilidade anuais e observe como o intervalo provável do câmbio se abre à medida que a parcela se afasta no tempo.

Câmbio-base

Tendência anual (%)

Volatilidade anual (%)

Mês da parcela	Desvio acumulado	Câmbio mediano	Câmbio P80	Câmbio P95

Colunas da tabela

Coluna	Função
Mês	Momento em que a exposição se materializa. Limitado automaticamente ao horizonte informado; ao reduzir o horizonte, meses excedentes são ajustados e destacados temporariamente.
Participação (%)	Fração da exposição total alocada naquele mês. A soma de todas as linhas deve ser exatamente 100%.
Hedge (%)	Percentual daquela parcela protegido. A fração protegida é liquidada ao câmbio-base e não gera impacto.

Os três botões auxiliares

Adicionar parcela — insere uma linha nova no último mês do horizonte, com participação zero.
Distribuir igualmente — divide 100% entre as linhas existentes, sem alterar os meses.
Estender ao horizonte — reposiciona os meses uniformemente até o horizonte e recalcula.

Boa prática: derive o cronograma do cronograma físico-financeiro real, não de uma divisão uniforme por conveniência. Equipamentos importados costumam ter desembolso concentrado em poucos marcos (pedido, embarque, entrega), o que muda materialmente a contingência.

Atenção ao hedge: o hedge é aplicado por parcela, não globalmente. Proteger 100% da primeira parcela e nada das demais é muito diferente de proteger 33% de cada uma — mesmo que a fração total protegida coincida, porque as parcelas ocorrem em momentos de risco diferentes.

Capítulo 05

Passo 3 — Os quatro modelos estatísticos

A escolha do modelo define como as trajetórias de câmbio são geradas. Não existe modelo universalmente melhor: existe o modelo compatível com a informação disponível.

1. Lognormal por volatilidade

Simula trajetórias mensais completas por movimento browniano geométrico, o padrão de mercado para preços de ativos. A cada mês:

S_m = S_m−1 · exp[ (μ − σ²/2)·Δt + σ·√Δt·Z ] com Δt = 1/12 e Z ~ N(0,1)

Parâmetros: tendência anual (μ), a deriva esperada da moeda, e volatilidade anual (σ), o desvio-padrão dos retornos logarítmicos. O termo −σ²/2 é a correção de Itô, que garante que a tendência informada corresponda ao crescimento esperado do logaritmo do câmbio.

Quando usar: situação padrão, quando há estimativa razoável de volatilidade (implícita em opções, histórica, ou referência de mercado). É o único modelo em que a trajetória mensal é genuinamente estocástica, e portanto o único que reage corretamente ao reposicionamento das parcelas no tempo.

2. Triangular por cenários

Sorteia o câmbio terminal de uma distribuição triangular definida por mínimo, mais provável e máximo, e interpola a trajetória de forma log-linear entre o câmbio-base e o valor sorteado.

S_m = S₀ · exp[ ln(S_T/S₀) · m/H ] S_T sorteado da triangular

Quando usar: quando não há série histórica nem estimativa de volatilidade, mas há julgamento técnico sobre limites plausíveis — por exemplo, a partir de projeções de instituições financeiras.

Limitação: o histograma tende a reproduzir a forma triangular, porque o impacto é uma transformação praticamente linear do câmbio sorteado. A distribuição resultante reflete o julgamento inserido, não uma propriedade estatística do mercado.

3. Cenários discretos ponderados

Um conjunto finito de cotações terminais, cada uma com probabilidade atribuída. O sorteio escolhe um cenário conforme os pesos e a trajetória é interpolada como na triangular. As probabilidades devem somar 100%.

Quando usar: quando a análise já está estruturada em cenários nomeados (otimista, base, adverso, extremo), o que facilita a comunicação com instâncias decisórias e a documentação da premissa adotada.

Consequência técnica: como só existem poucos valores terminais possíveis, o histograma exibe agrupamentos discretos, e percentis intermediários podem coincidir. Com quatro cenários, todo P entre 75% e 95% pode retornar o mesmo valor.

4. Bootstrap histórico

Calcula os retornos logarítmicos mensais da série informada e sorteia esses retornos com reposição para montar trajetórias:

r_i = ln( S_i / S_i−1 ) → S_m = S_m−1 · exp( r_sorteado )

A vantagem é dispensar hipótese de normalidade: caudas pesadas, assimetria e saltos observados historicamente são reproduzidos na simulação. A limitação é o pressuposto de que o passado representa o futuro e de que os retornos são independentes entre si.

Origem dos dados

Banco Central — PTAX: cotação de venda do boletim de fechamento; o sistema retém a última observação de cada mês.
Frankfurter: série agregada de bancos centrais, usada também como alternativa automática caso a consulta PTAX falhe.
Importação manual: colagem ou arquivo CSV/TXT, aceitando um valor por linha ou o formato data;valor. Linhas iniciadas por # são ignoradas e a vírgula é tratada como separador decimal.

São exigidas no mínimo 12 observações mensais. Entre 12 e 24 observações, e entre 24 e 60, o sistema emite avisos de incerteza crescente. Retornos extremos isolados também geram alerta, porque podem inflar artificialmente a cauda da distribuição.

Situação	Modelo recomendado
Há série histórica longa e representativa	Bootstrap histórico
Há estimativa confiável de volatilidade	Lognormal
Há apenas limites plausíveis de julgamento	Triangular
A decisão será comunicada em cenários nomeados	Cenários discretos
Deseja-se testar a robustez da reserva	Rodar dois modelos e comparar o P80

Capítulo 06

Passo 4 — Simulação e visualização

Este cartão controla a precisão numérica, o nível de confiança da reserva e a legibilidade dos gráficos.

Iterações

Cada iteração é uma trajetória completa de câmbio. O erro de Monte Carlo cai com 1/√N: quadruplicar as iterações reduz o erro pela metade. Percentis centrais (P50) estabilizam rapidamente; percentis de cauda (P95, P99) e o CVaR exigem muito mais amostras, porque dependem de poucos cenários extremos.

Iterações	Uso adequado
1.000 a 5.000	Exploração rápida de premissas, ajuste de cronograma.
20.000 a 50.000	Análise de trabalho, valor padrão do sistema (30.000).
100.000 a 500.000	Resultado final documentado, especialmente com P95/P99 ou bootstrap.

Percentil alvo

Define o nível de confiança da contingência e alimenta simultaneamente o cartão Contingência alvo, o CVaR, o marcador do histograma e as linhas tracejadas da curva acumulada. P80 significa: em 80% dos cenários simulados, a reserva é suficiente.

Como escolher: P50 é a mediana e cobre metade dos cenários — em geral insuficiente para reserva. P80 é o uso corrente em análise de risco de projetos. P90 e P95 aplicam-se quando a consequência da insuficiência é grave (paralisação, aditivo inviável, risco reputacional).

Configuração do histograma

Histograma de — alterna entre o impacto econômico líquido (com ganhos e perdas) e a série de perdas não negativas, usada para contingência.
Escala — frequência relativa (proporção por classe), absoluta (contagem) ou densidade (proporção dividida pela largura da classe, comparável entre configurações diferentes).
Classes — automático pela regra de Freedman–Diaconis, que define a largura como 2·IQR/∛n, ou manual entre 10 e 100 classes.

Recorte da cauda

Um único cenário extremo esticaria o eixo horizontal e comprimiria 99% dos dados em uma barra única. O sistema recorta a janela visível no percentil 99,5%; os valores acima são agrupados na última classe, destacada em tom avermelhado, com nota indicando o valor de corte e o percentual agrupado. O recorte é apenas visual: todos os indicadores, percentis e o CVaR continuam calculados sobre a amostra completa.

Semente aleatória

O gerador é um PRNG determinístico (mulberry32) inicializado por um hash do texto informado. A mesma semente, com as mesmas premissas, reproduz exatamente os mesmos resultados — condição essencial para auditabilidade e para comparação entre alternativas.

Teste de estabilidade: rode a mesma configuração com três sementes diferentes. Se o P80 variar pouco, a amostra é suficiente. Se variar de forma relevante, aumente as iterações antes de documentar o resultado.

Capítulo 07

Leitura dos resultados

O painel direito apresenta quatro indicadores de topo, dois gráficos, três tabelas e um resumo interpretativo. Cada um responde a uma pergunta distinta.

Os quatro cartões

Cartão	Pergunta que responde	Observação
Impacto determinístico	Quanto custaria no cenário único tradicional?	Calculado com a trajetória interpolada até o câmbio determinístico. Serve de referência comparativa.
Impacto líquido esperado	Qual o resultado médio considerando ganhos e perdas?	Média da distribuição econômica. Pode ser negativo, indicando ganho esperado.
Contingência alvo	Que reserva cobre o percentil escolhido?	Percentil da série de perdas. É o número que normalmente vai ao orçamento.
CVaR no percentil alvo	Se a reserva estourar, quanto falta em média?	Sempre maior ou igual à contingência. A diferença mede a severidade da cauda.

Indicadores estatísticos

Probabilidade de perda e de ganho — proporção de cenários com impacto positivo e negativo.
Perda média condicionada à perda — média apenas dos cenários desfavoráveis; sempre maior que a perda esperada global.
Desvio-padrão — dispersão do impacto líquido, em reais.
Assimetria — valores positivos indicam cauda direita alongada, típico de distribuições cambiais: perdas grandes são mais prováveis do que ganhos de mesma magnitude.
Curtose excedente — acima de zero indica caudas mais pesadas que a normal. Comum no bootstrap, quando a série contém crises.
FX terminal médio e mediano — a diferença entre eles é outra leitura da assimetria da distribuição do câmbio.

Os dois gráficos

O histograma mostra a forma da distribuição, com três marcadores verticais: média (azul), percentil alvo (verde) e cenário determinístico (vermelho). A posição relativa do marcador vermelho é reveladora — se ele cai bem à esquerda do verde, o cenário determinístico adotado na análise tradicional cobre uma fração pequena dos futuros possíveis.

A curva acumulada mostra, para cada valor de perda, a probabilidade de não ser ultrapassado. As linhas tracejadas identificam o percentil alvo. Ela responde diretamente à pergunta inversa: dada uma reserva já fixada, qual o nível de cobertura correspondente?

Registro do resultado

Exportar resumo CSV — premissas, indicadores, percentis e cronograma, em arquivo com BOM e separador ponto-e-vírgula, compatível com Excel em pt-BR.
Imprimir / PDF — imprime apenas o painel de resultados, sem os campos de entrada.
Premissas registradas — tabela que consolida tudo o que foi usado no cálculo, incluindo a semente. É a peça que garante a reprodutibilidade da análise.

Cuidado interpretativo: a contingência alvo não é "o que vai acontecer". É o valor que, sob as premissas adotadas, seria suficiente na proporção de cenários escolhida. Alterada a premissa, altera-se o número — por isso a tabela de premissas acompanha obrigatoriamente o resultado.

Capítulo 08

Matemática do motor de cálculo

Descrição completa do que ocorre entre o clique em Calcular e a exibição dos resultados.

Impacto de uma trajetória

Para uma trajetória de câmbio S = (S₀, S₁, …, S_H) e um cronograma de parcelas i, com participação w_i, hedge h_i e mês m_i:

I(S) = Σ_i [ E · w_i / S₀ ] · (1 − h_i) · ( S_{m_i} − S₀ ) · ρ E = parcela exposta em reais w_i = participação da parcela (Σ w_i = 1) h_i = hedge da parcela ρ = fator global de repasse S₀ = câmbio-base

O termo E·w_i/S₀ converte a parcela em moeda estrangeira ao câmbio-base — é a quantidade de moeda efetivamente necessária. A diferença (S_m − S₀) é o custo adicional por unidade de moeda. O resultado é positivo quando o câmbio sobe (perda) e negativo quando cai (ganho).

Sequência de execução

Leitura e validação das entradas; erros bloqueiam, avisos apenas alertam.
Inicialização do PRNG com o hash FNV-1a da semente.
Para cada uma das N iterações: geração da trajetória conforme o modelo e cálculo de I(S).
Armazenamento paralelo de três séries — impacto líquido, perda (máx{0, I}) e câmbio terminal.
Ordenação das três séries e extração de percentis por interpolação linear entre observações adjacentes.
Cálculo do CVaR como média das observações iguais ou superiores ao percentil alvo.
Cálculo do impacto determinístico com a trajetória log-interpolada até o câmbio do cenário único.
Renderização de cartões, tabelas, gráficos e resumo interpretativo.

Trajetória determinística

S_m = S₀ · exp[ ln(S_det/S₀) · m/H ]

A interpolação é logarítmica, e não linear, para manter taxa de variação percentual constante ao longo do horizonte — coerente com a forma como o câmbio se comporta.

Percentis e CVaR

P_q = x_(k) + r · ( x_(k+1) − x_(k) ) com p = (n−1)·q, k = ⌊p⌋, r = p − k CVaR_q = média { x : x ≥ P_q }

Nota sobre independência: os retornos mensais são sorteados de forma independente em todos os modelos. Não há reversão à média nem correlação serial, o que é conservador para horizontes longos: modelos com reversão produziriam dispersão terminal menor.

Capítulo 09

Exemplos aplicados

Três casos completos. Cada botão preenche o sistema, executa a simulação e fecha o manual para que você veja o resultado imediatamente.

Caso 1 — Equipamentos importados, sem hedge

Contrato de R$ 12 milhões, com R$ 3 milhões em elevadores e equipamentos importados dos Estados Unidos. Desembolsos nos meses 3 (20%), 6 (35%) e 10 (45%), sem proteção cambial. Câmbio-base de 5,20 e volatilidade anual de 18%.

O que observar: a probabilidade de perda fica próxima de 60% — reflexo da tendência positiva informada — e a contingência P80 costuma superar o impacto do cenário determinístico, evidenciando a subestimação típica da análise de cenário único.

Caso 2 — Contrato longo com hedge parcial

Contrato de R$ 48 milhões, com R$ 15 milhões em equipamentos europeus, horizonte de 30 meses e repasse de 85%, porque parte do fornecimento é nacionalizada. Parcelas nos meses 6, 14, 22 e 30, com hedge de 50% e 40% nas duas primeiras. Percentil alvo P90.

O que observar: compare o efeito do hedge zerando as duas primeiras proteções. A redução da contingência é menor do que a intuição sugere, porque as parcelas protegidas são justamente as de menor risco temporal — as mais próximas.

Caso 3 — Triangular por julgamento técnico, moeda chinesa

Contrato de R$ 8 milhões com R$ 4,4 milhões em equipamentos chineses e horizonte de 14 meses, sem série histórica disponível. Adotam-se limites de julgamento: mínimo 0,65, mais provável 0,78 e máximo 0,95. Percentil alvo P95.

O que observar: o histograma reproduz a forma triangular, e a assimetria positiva decorre do intervalo superior mais largo que o inferior. É o comportamento esperado quando a premissa é julgamento, e não dado.

Exercício sugerido: aplique o caso 1, anote o P80, retorne e aplique o caso 1 novamente alterando apenas a volatilidade de 18% para 26%. A variação do P80 mostra a sensibilidade da reserva ao único parâmetro que costuma ser estimado com maior margem de erro.

Capítulo 10

Uso em contratos e alocação de risco

A saída do simulador só se torna útil quando conectada à estrutura contratual que trata do risco cambial.

Da distribuição à matriz de riscos

A matriz de alocação de riscos, prevista no art. 22 da Lei 14.133/2021, exige definir a quem cabe cada risco e, quando cabe à Administração, dimensioná-lo. O simulador fornece exatamente os dois elementos que essa definição costuma carecer: a probabilidade de materialização e a magnitude em faixas de confiança. Uma linha de matriz passa a poder registrar, por exemplo, que o risco cambial da parcela importada tem 58% de probabilidade de gerar custo adicional, com impacto de R$ 214 mil no P80 e R$ 351 mil no P95.

Três usos distintos do mesmo resultado

Reserva de contingênciaO percentil alvo dimensiona a reserva orçamentária destinada a absorver a álea assumida pela Administração.

Decisão sobre hedgeComparar a contingência com e sem hedge indica quanto de reserva o instrumento de proteção efetivamente dispensa, contrapondo-se ao seu custo.

Análise de reequilíbrioDistinguir a álea ordinária, precificada na proposta, da variação extraordinária que fundamenta pedido de restabelecimento do equilíbrio econômico-financeiro.

Álea ordinária e extraordinária

A distribuição simulada oferece um critério objetivo para uma discussão frequentemente conduzida por impressão. Variações contidas no intervalo central — digamos, entre P10 e P80 — configuram oscilação previsível, própria do risco do negócio. Movimentos além da cauda superior aproximam-se do fato imprevisível ou previsível de consequências incalculáveis, hipótese do art. 124, II, "d", da Lei 14.133/2021. O simulador não decide a questão jurídica: fornece a base quantitativa sobre a qual ela é discutida, com a premissa registrada e a semente que permite reproduzir o cálculo.

Documentação mínima recomendada: anexe ao processo (i) a tabela de premissas registradas, (ii) a origem do câmbio-base e da série histórica, (iii) a justificativa do percentil adotado e (iv) o CSV exportado. Sem esses quatro elementos, o número perde rastreabilidade.

Limite de uso: a existência de reserva de contingência não autoriza, por si só, o pagamento de valores ao contratado. A reserva é instrumento de planejamento orçamentário; a alteração contratual segue o regime jurídico próprio e depende da demonstração concreta do desequilíbrio.

Capítulo 11

Solução de problemas

Situações mais comuns e o que fazer em cada uma.

Sintoma	Causa	Solução
Mensagem "as participações devem totalizar 100%"	Soma das participações diferente de 100%, com tolerância de 0,05%.	Use Distribuir igualmente ou ajuste manualmente. A etiqueta ao lado dos botões mostra o total corrente.
Aumentar o horizonte não muda os resultados	As parcelas continuam alocadas nos meses originais.	Clique em Estender ao horizonte. O risco depende de quando a exposição ocorre, não do prazo declarado.
Falha na busca online da série	Indisponibilidade da fonte, ausência de conexão ou restrição do navegador ao abrir o arquivo por `file://`.	Tente a outra fonte, sirva a página por HTTP local ou use a importação CSV/TXT. O sistema tenta a Frankfurter automaticamente quando a PTAX falha.
"O bootstrap requer no mínimo 12 observações"	Série colada com menos de 12 valores válidos ou em formato não reconhecido.	Verifique o separador: aceita-se `data;valor` ou um valor por linha, com vírgula decimal. Valores fora da faixa 0,01 a 1.000 são descartados.
Histograma com uma barra dominante	Concentração de massa em zero na série de perdas, comum quando a probabilidade de perda é baixa.	Alterne para o impacto líquido, que exibe também os cenários favoráveis, ou aumente o número de classes.
Nota vermelha de cauda agrupada	Valores acima do percentil 99,5% foram reunidos na última classe para preservar a escala.	Comportamento esperado. Nenhum indicador é afetado: o recorte é apenas visual.
Percentis repetidos entre P80 e P95	Modelo de cenários discretos com poucos valores terminais.	Acrescente cenários intermediários ou adote o modelo lognormal.
Os dados voltaram diferentes ao reabrir	O sistema restaura automaticamente o último estado salvo no navegador.	Use Limpar dados salvos, no rodapé do painel de resultados, para retornar ao exemplo padrão.
Resultados mudam a cada execução	Semente alterada entre execuções.	Fixe a semente. Com semente e premissas idênticas, o resultado é exatamente reproduzível.

Capítulo 12

Autoavaliação

Seis questões sobre os pontos que mais geram erro de uso. Clique na alternativa que considera correta para receber a explicação.

1. Um contrato de R$ 20 milhões tem R$ 5 milhões em equipamentos importados. Qual valor deve ser lançado em "Parcela exposta ao câmbio"?

A parcela exposta é somente a fração cujo custo varia com a moeda estrangeira. O valor total serve apenas como denominador dos indicadores percentuais.

2. O horizonte foi ampliado de 12 para 48 meses, mas a contingência praticamente não mudou. Qual a explicação mais provável?

A dispersão cresce com o tempo até cada parcela. Se nenhuma exposição ocorre no intervalo acrescido, ele não é utilizado. O botão "Estender ao horizonte" reposiciona as parcelas.

3. A contingência P80 é R$ 400 mil e o CVaR P80 é R$ 620 mil. O que isso significa?

O CVaR é a média da cauda além do percentil, portanto sempre maior ou igual à contingência. A diferença mede a severidade dos cenários que a reserva não cobre.

4. Uma parcela tem hedge de 60% e o repasse global é de 50%. Qual fração da variação cambial chega ao custo dessa parcela?

Os fatores são multiplicativos: (1 − 0,60) × 0,50 = 0,20. Hedge e repasse atuam de forma independente sobre a mesma parcela.

5. Não há série histórica nem estimativa de volatilidade, mas a equipe técnica tem convicção sobre limites plausíveis do câmbio. Qual modelo é o mais adequado?

A triangular foi concebida para julgamento estruturado. Registre a origem dos três limites nas premissas, já que o resultado reflete o julgamento adotado.

6. O histograma exibe nota vermelha informando que a cauda acima de determinado valor foi agrupada à direita. O que fazer?

O recorte no percentil 99,5% existe para manter a escala legível. Percentis, CVaR e estatísticas continuam calculados sobre a amostra integral.

Acertos: 0 de 6

Capítulo 13

Atalhos, dados salvos e referências

Atalhos de teclado

Tecla	Ação
`F1`	Abre e fecha este manual
`Esc`	Fecha o manual ou encerra o tour guiado
`←` / `→`	Navega entre capítulos com o manual aberto
`Ctrl` + `P`	Imprime o painel de resultados

Dados salvos no navegador

Todas as entradas — incluindo cronograma, cenários e série histórica — são gravadas automaticamente no armazenamento local do navegador cerca de um segundo após cada alteração, e restauradas na próxima abertura. Nada é enviado a servidores; as únicas conexões externas são as consultas opcionais de cotações. O progresso de leitura deste manual e o resultado da autoavaliação também são guardados localmente.

Para retornar ao estado inicial, use Limpar dados salvos no rodapé do painel de resultados.

Fontes de dados cambiais

PTAX — Banco Central do Brasil: cotação de venda do boletim de fechamento, referência usual em contratos administrativos.
Frankfurter: agregador de séries de bancos centrais, utilizado como alternativa automática.

Referências conceituais

Movimento browniano geométrico e correção de Itô, aplicados à modelagem de preços de ativos.
Value at Risk e Conditional Value at Risk como medidas de risco de cauda; o CVaR é medida coerente, o VaR não é.
Regra de Freedman–Diaconis para largura de classe em histogramas.
Bootstrap de retornos, como método de reamostragem sem hipótese distributiva.
Lei 14.133/2021, art. 22 (matriz de alocação de riscos) e art. 124, II, "d" (restabelecimento do equilíbrio econômico-financeiro).

Aviso permanente: os resultados são estimativas probabilísticas condicionadas às premissas informadas. Não constituem previsão, garantia, recomendação de investimento nem aconselhamento financeiro, contábil ou jurídico. A decisão e a validação técnica permanecem sob responsabilidade do usuário.

Histograma

Curva acumulada das perdas

Indicadores estatísticos

Percentis e risco de cauda

Resumo interpretativo

Premissas registradas

Simulador de Risco Cambial