Ajuda

Esta página apresenta orientações sobre funcionalidade de envio em lotes de notificações de segurança operacional de aviação civil por meio do Portal Único de Notificações.


Publicado em 15/12/2025     |     Atualizado em 11/02/2026 às 08:45

Introdução

A funcionalidade de envio em lote foi desenvolvida para permitir a submissão de um grande volume de notificações de segurança operacional de maneira padronizada, sem a necessidade de preencher individualmente os formulários para cada ocorrência.

As notificações enviadas por meio dessa funcionalidade atendem integralmente aos requisitos do programa de reportes mandatórios, mas também podem ser utilizadas para o envio de reportes voluntários. É fundamental que, após o envio, o usuário verifique o status do processo para garantir que não houve erros durante o processamento das notificações.

Além disso, assim como no envio tradicional via formulário, o envio em lote também permite a inclusão de arquivos auxiliares (como imagens, vídeos e documentos) que podem ilustrar ou complementar as informações de cada notificação, oferecendo um contexto adicional para a análise dos eventos reportados.

Benefícios do envio padronizado

O envio padronizado possui diversos benefícios. Dentre eles, estão:

  • Agilidade: diversas notificações são transmitidas em uma única operação.
  • Processo Assíncrono: após enviar um lote, usuário pode sair da página e realizar outras atividades no Portal Único.
  • Rastreabilidade: cada notificação possui um número de identificação única.
  • Acompanhamento: o status do envio em lote pode ser consultado a qualquer momento.

Quando utilizar?

A utilização do envio em lote é indicada para usuários que desejam enviar uma grande de notificações dispensando a necessidade de preenchimento individual de formulários para cada uma delas.

Fluxo do Processo

Esta seção descreve, de forma detalhada, o fluxo completo do envio em lote, desde a preparação do arquivo até a confirmação de recebimento pelo sistema da ANAC. O objetivo é garantir que o usuário compreenda cada etapa reduzindo erros e assegurando a rastreabilidade do processo.

Passo a passo

O processo de envio em lote segue quatro etapas principais:

  1. Preparar o arquivo JSON: montar o arquivo conforme o formato definido pela ANAC. Esta etapa é obrigatória.
  2. Preparar Arquivos Auxiliares (Anexos): imagens, vídeos ou documentos relacionados as notificações presentes no arquivo JSON. Esta etapa é obrigatória.
  3. Enviar o(s) arquivo (s): realizar upload via portal.
  4. Acompanhar o Resultado (Obrigatório): verificar o retorno do sistema e o status de processamento.

Diagrama Ilustrativo

Abaixo, está descrito um diagrama que exemplifica o fluxo a ser seguido.

Preparar arquivo de Dados (Obrigatório)
→
Preparar Arquivos Auxiliares - Anexos (Opcional)
→
Enviar (Obrigatório)
→
Acompanhar o Resultado (Obrigatório)

A seguir é apresentando o detalhamento de cada etapa do fluxo do processo:

1. Preparar arquivo de Dados (Obrigatório)

Esta seção apresenta as especificações técnicas para preparação do arquivo de dados aceito pelo Portal Único para a funcionalidade do envio em lote.

Formato
  • O arquivo de dados deve possuir formato JSON válido.
  • O arquivo de dados deve utilizar codificação UTF-8.
Tamanho
  • O arquivo de dados pode conter de 1 até 100 notificações.
  • O tamanho máximo permitido do arquivo de dados é 2 MB.
Estrutura
  • Um arquivo JSON é composto por um conjunto de chaves, organizadas de forma hierárquica, e seus respectivos valores.
  • É importante ressaltar que todas as chaves devem estar presentes no arquivo JSON, mesmo que o seu valor seja nulo (NULL)
  • A chaves necessárias no arquivo são aquelas descritas abaixo na seção Exemplo do Arquivo de Dados

2. Preparar Arquivos Auxiliares - Anexos (Opcional)

Após seleção de um arquivo JSON no Portal Único, será habilitada a opção de seleção de arquivos auxiliares. Tais arquivos podem ser imagens, vídeos ou documentos que contribuam para o entendimento de uma ou mais notificações presentes no arquivo JSON.

O envio de arquivos auxiliares é opcional.

Formatos permitidos dos anexos
  • Imagens: *.jpeg, .jpg, .png, .bmp, .gif
  • Vídeos/Áudios: *.mov, .mkv, .mp4, .avi, .mp3
  • Documentos: *.pdf, .txt, .doc, .docx, .xls, xlsx
Tamanho
  • É possível associar até 20 arquivos por notificação.
  • O tamanho máximo permitido do arquivo de dados é 20 MB.
Nomenclatura dos arquivos anexos

O nome de cada arquivo auxiliar deve ser um texto dividido em duas partes separadas por “_”. A primeira parte corresponde ao identificador da notificação a qual o arquivo auxiliar se refere (ID_RELATORIO_LOTE) e a segunda parte corresponde um valor sequencial com valor inicial 1, por exemplo:

  • 1_1.png
  • 1_2.docx
  • 1_3.pdf
  • 2_1.jpeg
  • 2_2.avi
  • 3_1.pdf
  • 3_2.avi

3. Enviar (Obrigatório)

  • Somente um arquivo de dados JSON pode ser enviado de cada vez, podendo conter até 100 notificações.
  • Após clicar em enviar, o lote será processado podendo demorar alguns minutos.

4. Acompanhar o Resultado (Obrigatório)

  • Durante o processamento do lote, o usuário poderá consultar o status na tela de processamento através do menu "Minhas Notificações"
  • Em caso de falha, o usuário deverá enviar novamente o lote.
  • O email de confirmação somente é enviado após o lote ter sido processado com sucesso.

Estrutura Geral Esperada

O arquivo JSON enviado deve conter um objeto raiz com a seguinte estrutura. Este objeto principal engloba os metadados do lote de envio e o array onde as ocorrências individuais serão listadas.

Todas as chaves devem estar presentes no arquivo mesmo que o valor seja nulo (NULL).

Veja na seção abaixo Detalhamento das Chaves e Valores as regras para desenvolver o conteúdo.

Evento Geral

Copiar Expandir 


[
	{
	"ID_RELATORIO_LOTE": 1, 
	"IDENTIFICACAO_RELATORIO": 3, 
	"DATA_HORA_LOCAL": "24/10/2019 11:00",
	"DATA_HORA_UTC": null,
	"PAIS_AREA_OCORRENCIA": 1, 
	"FASE_OCORRENCIA": 12,
	"OBSERVACAO_DETECCAO": null,
	"TIPO_DA_OCORRENCIA": null,
	"DADOS_AERODROMO": [{	
						 "OCORRENCIA_AERODROMO_ENTORNO":1, 
						 "AERODROMO":"rj0002", 
						 "NOME_LOCAL":null, 
						 "UF":null, 
						 "CIDADE":null,
						 "LATITUDE":null,  
						 "PONTO_CARDEAL_LATITUDE":null,
						 "LONGITUDE":null,
						 "PONTO_CARDEAL_LONGITUDE":null,
						 "ALTITUDE":null, 
						 "STATUS":null,
						 "TIPO":null,
						 "CABECEIRA":null,
						 "LOCALIZACAO_NO_AERODROMO":null 
					   }],
	"NARRATIVA_DO_EVENTO": "teste2", 
	"DADOS_AERONAVE":[{ 
					   "MARCA":0, 
					   "MARCA_OUTRO": 1,
					   "NOME_MARCA_OUTRO":"marca 1",
					   "DANO_A_AERONAVE":1, 
					   "AERONAVE_MILITAR":0,
					   "PAIS_DE_REGISTRO_OUTRO":75,
					   "NUMERO_SERIE_OUTRO":null,
					   "FABRICANTE_OUTRO":null,
					   "MODELO_OUTRO":null,
					   "ANO_DE_FABRICACAO_OUTRO":null,
					   "PESO_MAX_DECOLAGEM_OUTRO":null,
					   "TIPO_ICAO_OUTRO":null,
					   "NUMERO_DE_MOTORES_OUTRO":null,
					   "TIPO_DE_MOTOR_OUTRO":null,
					   "QUANTIDADE_DE_ASSENTOS_OUTRO":null,
					   "QUANTIDADE_MAX_PASSAGEIROS_OUTRO":null,
					   "NUMERO_VOO":null,
					   "TIPO_VOO":1,
					   "REGRA_VOO_OCORRENCIA":null,
					   "CONDICOES_VOO":null, 
					   "CNPJ_CPF_OPERADOR":null,
					   "NOME_OPERADOR_OUTRO":"NOME_OPERADOR_OUTRO",
					   "TIPO_OPERACAO":1, 
					   "ORIGEM_CONHECIDA":0,
					   "PAIS_ORIGEM":23, 
					   "AERODROMO_ORIGEM": "df0001", 
					   "NOME_AERODROMO_ORIGEM":null, 
					   "DESTINO_CONHECIDO":1,
					   "PAIS_DESTINO":1, 
					   "AERODROMO_DESTINO": "pa0021",
					   "NOME_AERODROMO_DESTINO":null,
					   "DADOS_TRIPULANTES":[{"TRIPULANTE_DESCONHECIDO":1,
											 "CANAC_TRIPULANTE":null, 
											 "FUNCAO":null,
											 "NIVEL_LESAO":1
											}]
					}],
	"LESOES_DANOS": [{
					  "LESOES_PASSAGEIROS_FATAIS": null,
					  "LESOES_PASSAGEIROS_GRAVE": null,
					  "LESOES_PASSAGEIROS_LEVE": null,
					  "LESOES_PESSOAS_SOLO_FATAIS": null,
					  "LESOES_PESSOAS_SOLO_GRAVE": null,
					  "LESOES_PESSOAS_SOLO_LEVE": null,
					  "DANOS_TERCEIROS_NIVEL": null,
					  "DANOS_A_TERCEIROS": null,
					  "TIPO_INFRAESTRUTURA_OBJETO_DANIFICADO": null
					}]
	}
]

Fauna

Copiar Expandir 


    [
  {
    "ID_RELATORIO_LOTE": 1,
    "TIPO_REPORTE": 1,
    "IDENTIFICACAO_RELATORIO": null,
    "DATA_HORA_LOCAL": "24/10/2019 10:00",
    "DATA_HORA_UTC": null,
    "PAIS_AREA_OCORRENCIA": 1,
    "FASE_OCORRENCIA": 12,
    "OBSERVACAO_DETECCAO": null,
    "TIPO_DA_OCORRENCIA": null,
    "DADOS_AERODROMO": [
      {
        "OCORRENCIA_AERODROMO_ENTORNO": 1,
        "AERODROMO": 1,
        "NOME_LOCAL": null,
        "UF": null,
        "CIDADE": null,
        "LATITUDE": null,
        "PONTO_CARDEAL_LATITUDE": null,
        "LONGITUDE": null,
        "PONTO_CARDEAL_LONGITUDE": null,
        "ALTITUDE": null,
        "STATUS": null,
        "TIPO": null,
        "CABECEIRA": null,
        "LOCALIZACAO_NO_AERODROMO": null
      }
    ],
    "NARRATIVA_DO_EVENTO": "Exemplo: Narrativa do evento",
    "DADOS_AERONAVE": [
      {
        "MARCA": "PRDPF",
        "MARCA_OUTRO": null,
        "NOME_MARCA_OUTRO": null,
        "DANO_A_AERONAVE": 1,
        "AERONAVE_MILITAR": 0,
        "PAIS_DE_REGISTRO_OUTRO": null,
        "NUMERO_SERIE_OUTRO": null,
        "FABRICANTE_OUTRO": null,
        "MODELO_OUTRO": null,
        "ANO_DE_FABRICACAO_OUTRO": null,
        "PESO_MAX_DECOLAGEM_OUTRO": null,
        "TIPO_ICAO_OUTRO": null,
        "NUMERO_DE_MOTORES_OUTRO": null,
        "TIPO_DE_MOTOR_OUTRO": null,
        "QUANTIDADE_DE_ASSENTOS_OUTRO": null,
        "QUANTIDADE_MAX_PASSAGEIROS_OUTRO": null,
        "NUMERO_VOO": null,
        "TIPO_VOO": 2,
        "REGRA_VOO_OCORRENCIA": null,
        "CONDICOES_VOO": null,
        "CNPJ_CPF_OPERADOR": "00394494001450",
        "NOME_OPERADOR_OUTRO": null,
        "TIPO_OPERACAO": 1,
        "ORIGEM_CONHECIDA": null,
        "PAIS_ORIGEM": 1,
        "AERODROMO_ORIGEM": null,
        "NOME_AERODROMO_ORIGEM": null,
        "DESTINO_CONHECIDO": null,
        "PAIS_DESTINO": 1,
        "AERODROMO_DESTINO": null,
        "NOME_AERODROMO_DESTINO": null,
        "DADOS_TRIPULANTES": [
          {
            "TRIPULANTE_DESCONHECIDO": 1,
            "CANAC_TRIPULANTE": null,
            "FUNCAO": null,
            "NIVEL_LESAO": 1
          }
        ]
      }
    ],
    "LESOES_DANOS": [
      {
        "LESOES_PASSAGEIROS_FATAIS": null,
        "LESOES_PASSAGEIROS_GRAVE": null,
        "LESOES_PASSAGEIROS_LEVE": null,
        "LESOES_PESSOAS_SOLO_FATAIS": null,
        "LESOES_PESSOAS_SOLO_GRAVE": null,
        "LESOES_PESSOAS_SOLO_LEVE": null,
        "DANOS_TERCEIROS_NIVEL": null,
        "DANOS_A_TERCEIROS": null,
        "TIPO_INFRAESTRUTURA_OBJETO_DANIFICADO": null
      }
    ],
    "FAUNA": {
      "LOCAL_EVENTO": {
        "AREA_SEGURANCA_AEROPORTUARIA": 0,
        "RADIAL_RELACAO_CABECEIRA_PISTA": null,
        "ALTURA_AGL": null,
        "DISTANCIA_PISTA": null,
        "VELOCIDADE_IAS": null
      },
      "CONDICOES_METEREOLOGICAS": [
        {
          "PARTE_DIA": 1,
          "CONDICAO_CEU": 1,
          "PRECIPITACAO": 1
        }
      ],
      "TRIPULACAO_ALERTADA": [1],
      "DADOS_MOTOR_AERONAVE": [
        {
          "FABRICANTE_MOTOR": null,
          "MODELO_MOTOR": null
        }
      ],
      "EFEITOS_VOO": [1],
      "EFEITOS_VOO_OUTRO": null,
      "PARTES_AERONAVE": [
        {
          "PARTES_ATINGIDAS": null,
          "OBSERVACOES_PARTES_ATINGIDAS": null,
          "PARTES_DANIFICADAS": null,
          "OBSERVACOES_PARTES_DANIFICADAS": null
        }
      ],
      "INGESTAO_MOTOR": null,
      "INGESTAO_MULTIPLA_MOTOR": null,
      "ESPECIMES_ENVOLVIDAS": [
        {
          "CODIGO_ESPECIME": 1,
          "QUANTIDADE_ANIMAIS": 1,
          "TAMANHO_ESTIMADO_ANIMAL": 1,
          "AMOSTRAS_COLETADAS_DNA": 0,
          "AMOSTRAS_ENVIADAS_DNA": 0,
          "FOTOGRAFADAS": 0,
          "FOTOS_ENVIADAS_IDENTIFICAR_ESPECIE": 0,
          "OBSERVACOES_SOBRE_ESPECIME": null
        }
      ],
      "DANOS_E_PREJUIZOS": [
        {
          "DANOS_PREJUIZOS": 1,
          "AERONAVE_INDISPONIVEL_POR": null,
          "CUSTO_DIRETO": null,
          "CUSTO_INDIRETO": null
        }
      ]
    }
  }
]

Detalhamento das Chaves e Valores

Esta seção apresenta as especificações técnicas do arquivo JSON aceito pela ANAC para o envio em lote. São explicadas as regras de codificação, estrutura básica, tamanho máximo e requisitos de conformidade. O propósito é orientar o usuário na preparação correta do arquivo antes da submissão.

Para cada Chave é possível consultar o nome padronizado do campo que deve ser utilizado no arquivo JSON, assim como a sua obrigatoriedade, formato, tamanho, descrição, exemplo e lista de valores aceitos.

Evento Geral

Fauna

Exemplos de Arquivos

Downloads

Baixe modelos prontos, que já estão dentro dos padrões estabelecidos:

Mensagens de Erro e Significado

Segue abaixo a lista de erros mais comuns que podem ocorrer ao enviar um arquivo de dados. As mensagens de erros críticos são apresentadas na tela para ajustes.

Em caso de erro, nenhuma das notificações contidas no arquivo do lote será enviada. Uma nova tentativa deverá ser realizada.

CódigoMensagemSignificado
A01Serviço indisponivel tente novamente mais tarde!Erro na resposta da API aeronaves (não retornou 200)
A02Serviço indisponivel tente novamente mais tarde!Erro na resposta da API aeronauta (não retornou 200)
A03Erro ao verificar operador de aeronave (marca)A API aeronaves retorna CNPJ/CPF nulo
A04Erro de serviço, tente novamente mais tarde!Outro erro de API (não previsto)
A05Dados não encontrados para o CANAC informadoAPI respondeu com erro 404 para o CANAC informado
B01.1B01.1 - Ocorreu um erro com dados do campo DATA_HORA_LOCAL!Erro retornado por banco de dados: DT_OCORRENCIA_LOCAL
B01.2Ocorreu um erro!Erro retornado por banco de dados: erro insert NOTIFICACAO
B01.3Ocorreu um erro com dados de CABECEIRAErro retornado por banco de dados: erro insert OCORRENCIA_LOCAL (cabeceira)
B01.4Ocorreu um erro com dados de local!Erro retornado por banco de dados: erro insert OCORRENCIA_LOCAL
B01.5Ocorreu um erro!Erro retornado por banco de dados: ATUALIZAR NOTIFICACAO COM ID_OCORRENCIA_LOCAL
  • 1 - 10

Controle de Versões do Padrão JSON

Esta seção apresenta o histórico de versões do padrão de envio em lote utilizado pela ANAC, permitindo que os usuários acompanhem eventuais alterações na estrutura, campos e regras de validação.

O controle de versão é essencial para garantir compatibilidade entre sistemas, rastreamento de mudanças e transparência na evolução do modelo de dados.

Versão Atual

VersãoData PublicaçãoDescrição
V1.011/02/2026Primeira versão pública do padrão JSON para envio em lote. Estrutura inicial e documentação base.
  • 1 - 1

Histórico de Versões

VersãoPrincipais alterações
V1.0Primeira versão pública do padrão JSON para envio em lote. Estrutura inicial e documentação base.
  • 1 - 1

Contato e Suporte

Em caso de dúvidas nos procure em nossos canais disponíveis no endereço: Fale com a Anac

Superintendência de Tecnologia da Informação - STI
Agência Nacional de Aviação Civil - ANAC