Pular para o conteúdo principal

Consulta CIOT com averbação de carga - Seguro RCV

Esta API disponibiliza a listagem de CIOTs emitidos por data para consulta pelo sistema de averbação de carga, com foco no acompanhamento operacional e no faturamento dos clientes do NDD Averba. A consulta também permite aplicar filtro específico para CIOTs cancelados.

Premissa No momento da emissão do CIOT, a informação de que a viagem está averbada — ou seja, de que houve contratação de seguro — não é enviada. O controle dos contratantes com o serviço de averbação ativo é realizado por meio da configuração da contratante no portal do NDD Cargo. Atualmente, essa informação não é validada diretamente pelo sistema de averbação.

Método e rota

  • Consulta (GET): /consulta/AverbacaoCiotDiario

Estrutura da requisição

Cabeçalhos

  • Authorization: o token JWT deve ser enviado no header.

    Authorization: Bearer {token}

Corpo

Confira o exemplo abaixo e veja aqui a definição completa.

{
"cnpj": "43922134000127",
"data":   "2026-02-03T00:00:00",
"cancelados": "1"
}

Resposta do GET

Após o processamento da consulta, a API retornará um JSON com os seguintes dados:

Exemplo de resposta bem-sucedida:

[{
"cnpjSegurado": "cnpj",
"nomeSegurado": "nome",
"serie": "serie",
"numero": "numero",
"dataHoraAutorizacao": "2025-05-28",
"ProtocoloAutorizacaoANTT": "ciot+CodigoVerificador",
"DataInicioViagem": "2025:12:30"
"dataHoraCancelamento": "2025:12:20",
"protocoloCancelamento": "protocolo",
"OrigemUF": "SC",
"OrigemMunicipio": "Tigrinhos",
"OrigemCodIBGE": "454335",
"DestinoUF" : "SC",
"DestinoMunicipio" : "Central",
"DestinoCodIBGE" : "89176000",
"cpfCondutor": "94857301922",
"nomeCondutor": "nome Completo",
"placa": "AAA0A00"
}]

Códigos de Status HTTP

  • 200: Requisição processada com sucesso.
  • 400: Parâmetro ausente, inválido ou intervalo de datas incorreto.
  • 401: Não autorizado (token JWT ausente ou inválido).
  • 403: Requisição autenticada, porém sem permissão para acessar o recurso.
  • 404: Nenhum CIOT encontrado (opcional, depende da implementação).
  • 500: Erro interno do servidor durante o processamento da requisição.