← InicioFleetPay / Schema

ConsultaRntrc

Estructura preservada del contrato versionado de la API.

Las descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.

documentostringObligatorio

CPF o CNPJ del transportista consultado, solo dígitos.

rntrcstringObligatorio

El RNTRC consultado.

razao_socialstring | nullOpcional

Razón social (o nombre) del transportista en el registro de ANTT.

En homologación, donde la consulta funciona en modo simulado, no se devuelve el nombre real: el campo completo se sustituye por uno de dos valores fijos, según el documento consultado.

`documento`	`razao_social`
CNPJ (14 dígitos)	`TRANSPORTES SIMULADOS HML LTDA`
CPF (11 dígitos, transportista autónomo)	`TRANSPORTADOR AUTONOMO SIMULADO`

Este marcador indica que el dato no se consultó ante ANTT.

data_validadestring | null · dateOpcional

Fecha hasta la que es válido el registro RNTRC, en formato AAAA-MM-DD.

Es null cuando el proveedor no informa la vigencia: no equivale a vencido. Trate la ausencia de fecha y el vencimiento como casos distintos.

En homologación, donde la consulta funciona en modo simulado, la fecha se deriva del día de la consulta: un registro activo devuelve hoy + 1 año; el valor de prueba de registro inactivo (rntrc=000000000) devuelve hoy − 1 año, porque un RNTRC vencido es la causa más común de inactividad y una vigencia futura junto con ativo: false sería contradictoria.

Es el único campo de esta consulta que no permanece fijo entre días: los demás son deterministas y este sigue la fecha para no quedar desactualizado.

ativobooleanObligatorio

Indica si el RNTRC está activo en la ANTT.

tipostringObligatorio

Tipo de transportista: ETC (empresa), TAC (autónomo) o CTC (cooperativa).

"ETC" · "TAC" · "CTC"

equiparado_tacbooleanOpcional

Indica si el transportista está equiparado a un TAC.

Definición JSON Original (Descripciones en Portugués)

{
  "type": "object",
  "required": [
    "documento",
    "rntrc",
    "ativo",
    "tipo"
  ],
  "properties": {
    "documento": {
      "type": "string",
      "description": "CPF ou CNPJ do transportador consultado, somente dígitos."
    },
    "rntrc": {
      "type": "string",
      "description": "O RNTRC consultado."
    },
    "razao_social": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social (ou nome) do transportador no registro da ANTT.\n\nEm homologação, onde a consulta responde em modo simulado, o nome real **não é\ndevolvido**: o campo inteiro é substituído por um de dois valores fixos, conforme o\ndocumento consultado —\n\n| `documento` | `razao_social` |\n|---|---|\n| CNPJ (14 dígitos) | `TRANSPORTES SIMULADOS HML LTDA` |\n| CPF (11 dígitos, transportador autônomo) | `TRANSPORTADOR AUTONOMO SIMULADO` |\n\nÉ o marcador de que o dado não foi apurado na ANTT.\n"
    },
    "data_validade": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Até quando o registro no RNTRC é válido, em `AAAA-MM-DD`.\n\n`null` quando o provedor não informa a validade — o que **não** é o mesmo que\nvencido. Trate ausência e vencimento como casos distintos.\n\nEm homologação, onde a consulta responde em modo simulado, a data é derivada do\n**dia da consulta**: registro ativo devolve hoje + 1 ano; a sentinela de registro\ninativo (`rntrc=000000000`) devolve hoje − 1 ano, porque um RNTRC vencido é a\ncausa mais comum de inatividade e devolver validade futura junto de\n`ativo: false` seria uma resposta que se contradiz.\n\nÉ o único campo desta consulta que **não** é fixo entre dias: os demais são\ndeterminísticos, e este acompanha a data para não envelhecer.\n"
    },
    "ativo": {
      "type": "boolean",
      "description": "Se o RNTRC está ativo na ANTT."
    },
    "tipo": {
      "type": "string",
      "enum": [
        "ETC",
        "TAC",
        "CTC"
      ],
      "description": "Tipo do transportador: `ETC` (empresa), `TAC` (autônomo) ou `CTC` (cooperativa)."
    },
    "equiparado_tac": {
      "type": "boolean",
      "description": "Se o transportador é equiparado a TAC."
    }
  }
}