A consulta ao RNTRC é uma operação somente leitura. O SDK não realiza cadastro, alteração ou cancelamento de registros RNTRC — essas operações são realizadas diretamente pelo transportador junto à ANTT.
Consultando um transportador
Construa o comando com o CNPJ ou CPF do transportador e execute via handler:Cpf no lugar de Cnpj:
Dados disponíveis no Result
Quando$result->isSuccess() retorna true, o objeto retornado por $result->getData() contém:
| Campo | Tipo | Descrição |
|---|---|---|
numeroRntrc | string | Número do registro RNTRC |
situacaoCadastral | string | Situação do registro (ex.: ATIVO, INATIVO, SUSPENSO) |
validadeRegistro | DateTimeImmutable | Data de validade do registro |
categoria | string | Categoria do transportador (ex.: ETC, CTC, TAC) |
nomeRazaoSocial | string | Nome ou razão social registrada |
uf | string | UF de registro do transportador |
Os campos disponíveis dependem do tipo de transportador (pessoa jurídica ou autônomo) e da resposta retornada pela ANTT. Campos opcionais podem ser
null quando não informados pela ANTT.Quando consultar
Integre a consulta ao RNTRC no fluxo da sua aplicação nos seguintes momentos:- Cadastro de fornecedores — valide o RNTRC antes de registrar um novo transportador na sua base
- Antes de emitir o CIOT — confirme que o transportador está ativo antes de registrar a operação
- Verificação periódica — transportadores habilitados podem ter seu registro suspenso ou vencido; consulte regularmente se a sua operação exige isso
- Auditoria e conformidade — registre o resultado da consulta junto ao histórico da operação para fins de comprovação
Consulte a página de Resultados para entender o modelo completo de
Result, rejeições esperadas e InfrastructureException.