# Changelog of Brazil Flight Delays & Cancellations — Voos ANAC (`matheus_dev_natal/brazil-flight-delays-anac`) Actor

- **URL**: https://apify.com/matheus_dev_natal/brazil-flight-delays-anac/changelog.md
- **Full Actor documentation**: https://apify.com/matheus_dev_natal/brazil-flight-delays-anac.md

## Changelog

Todas as mudanças visíveis ao usuário deste actor ficam registradas aqui.
O formato segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/).

### \[0.1] — 2026-08-24

Primeira versão.

#### Adicionado

- **Modo `flights`** — registros de voo individuais, com horário previsto e
  realizado, atraso em minutos e a classificação oficial de atraso da ANAC.
  Filtros por companhia (código ICAO ou IATA), número de voo, aeroporto de
  origem e destino (código ICAO ou trecho do nome/cidade), janela de datas,
  atraso mínimo, situação do voo e tipo de serviço.
- **Modo `ranking`** — pontualidade agregada por companhia, aeroporto ou rota:
  percentual de pontualidade, de atraso acima de 30, 60 e 240 minutos, de
  cancelamento, além de atraso médio e mediano. Cada linha publica também os
  denominadores usados, para que as taxas possam ser auditadas.
- **Modo `trend`** — a mesma agregação mês a mês, para acompanhar a evolução do
  conjunto filtrado.
- Cobertura de **janeiro de 2010 até o mês mais recente publicado**, sem meses
  faltando. O mês mais recente é descoberto a cada execução, porque a ANAC
  publica o VRA com 4 a 8 semanas de defasagem.
- Enriquecimento a partir dos cadastros oficiais da ANAC: código IATA da
  companhia e município/UF dos aeroportos brasileiros.
- Fallback automático para o espelho de dados abertos da ANAC quando a fonte
  completa está indisponível. Nele, nome da companhia, modelo de aeronave,
  assentos e a classificação oficial de atraso vêm nulos, e o campo
  `sourceVariant` de cada registro diz qual fonte foi usada.

#### Notas sobre o dado

- A classificação oficial de atraso é **repassada da ANAC**, não recalculada.
  Ela não é reproduzível exatamente a partir dos horários publicados, porque a
  ANAC calcula com segundos enquanto o arquivo publica minutos truncados. O
  atraso que este actor calcula vai em campos próprios (`*DelayMinutes`).
- Os horários saem em **horário de Brasília, sem conversão**, exatamente como a
  fonte publica, acompanhados do campo `utcOffset` com o deslocamento válido
  naquela data — que não é constante, porque o Brasil teve horário de verão até
  2019\.
- O campo `justification` só existe até abril de 2020, quando a IAC 1504 foi
  revogada e a ANAC deixou de coletar o motivo do atraso.
- O campo `codeshareFlights` só existe a partir de 2025, quando a coluna passou
  a ser publicada.
- Voos de 2000 a 2009 estão **fora** desta versão: a ANAC publica esse período
  num layout incompatível, sem nome de companhia, sem aeronave e sem a
  classificação oficial de atraso.

#### Cobrança

- Pagamento por resultado entregue, usando exclusivamente o evento nativo da
  plataforma. Sem taxa de início de execução.