Orientações e respostas da equipe da Direct Data

/api/ANTTConsultaRegularidadeTransportadora

💡 O endpoint /api/ANTTConsultaRegularidadeTransportadora permite consultar informações sobre veículos habilitados pela ANTT (Agência Nacional de Transportes Terrestres) ao Transporte Rodoviário Internacional de Cargas (TRIC). A API fornece dados relacionados ao veículo consultado e ao transportador associado, sendo útil para compliance, ESG e prevenção de autuações fiscais.

Introdução

A API ANTT - Consulta de Regularidade da Transportadora facilita a obtenção de dados sobre transportadores e veículos registrados, incluindo informações como:

• RNTRC (Registro Nacional de Transportadores Rodoviários de Carga);
• Documentos do transportador;
• Localização e situação do veículo e transportador.

Essa API é ideal para empresas que necessitam verificar a regularidade de transportadores em processos de onboarding de clientes e fornecedores ou na prevenção de penalidades fiscais.

URL Base

A API está hospedada no seguinte endereço:

https://apiv3.directd.com.br

Endpoint

GET /api/ANTTConsultaRegularidadeTransportadora

Esse endpoint retorna informações detalhadas sobre transportadores e veículos cadastrados na ANTT.

Regras

1. Apenas um documento (CPF ou CNPJ) pode ser enviado por requisição.
2. É possível incluir a geração de um comprovante PDF por um custo adicional.

Autenticação

A autenticação é feita utilizando um TOKEN. Sem um token válido, o acesso será negado (401).

Regras de Autenticação

1. O TOKEN deve ser incluído como parâmetro obrigatório.
2. Caso o token seja inválido ou expirado, entre em contato pelo e-mail: suporte@directd.com.br.

Campos da API

Dados Retornados

• Transportador: Nome do transportador.
• Documento: CPF ou CNPJ do transportador.
• RNTRC: Registro Nacional de Transportadores Rodoviários de Carga.
• Data de Emissão: Data de emissão da consulta.
• Data de Consulta: Data em que a consulta foi realizada.
• Localização: UF e município associados ao transportador.
• Categoria: Categoria do veículo.
• Situação: Situação do registro do transportador (Ativo/Inativo).
• Apto: Indica se o transportador está habilitado.
• Status: Status atual da consulta.
• Observação: Informações adicionais sobre o registro.
• Protocolo: Identificador único da consulta.

Parâmetros

Exemplo de Requisição

Usando cURL

curl -X 'GET' \
  'https://apiv3.directd.com.br/api/ANTTConsultaRegularidadeTransportadora?CPF=12345678945&TOKEN=68ADA2C3-8016-47DA-ADE6-13AE239308FE&GERARCOMPROVANTE=habilitar' \
  -H 'accept: application/json'

Respostas

Sucesso (200)

A consulta foi realizada com sucesso e retorna os dados do transportador.

{
  "metaDados": {
    "consultaNome": "ANTT - Consulta de Regularidade da Transportadora",
    "consultaUid": "direct-123456",
    "mensagem": "Consulta realizada com sucesso.",
    "resultado": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 200
  },
  "retorno": {
    "transportador": "Transportadora Exemplo",
    "documento": "12345678000123",
    "rntrc": 123456789,
    "dataEmissao": "01/01/2024",
    "dataConsulta": "01/01/2024",
    "localizacao": {
      "uf": "SP",
      "municipio": "São Paulo"
    },
    "categoria": "Caminhão",
    "situacao": "Ativo",
    "apto": true,
    "status": "Regular",
    "observacao": "Nenhuma pendência registrada.",
    "protocolo": "abc123"
  }
}

Erros Comuns

Notas Importantes

• Apenas um documento (CPF ou CNPJ) deve ser enviado por consulta.
• O parâmetro GERARCOMPROVANTE é opcional e, se ativado, gera um PDF do comprovante.
• Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.