API FMS

 Gostaríamos de reforçar uma atualização importante em nossa API de emissão de CIOT
que entrará em vigor no dia 10/06/2026.

Ação obrigatória – Alteração na estrutura de Origem e Destino

A partir de 10/06/2026, o sistema deixará de aceitar os campos origin_address e
destination_address para emissões de CIOT Padrão (Lotação).
Será obrigatória a utilização da nova estrutura routes, conforme exemplo abaixo:
{
"routes": [
{
"origin": {
"street": "string",
"number": "string",
"complement": "string",
"neighborhood": "string",
"city": "string",
"state": "string",
"country": "Brasil",
"zip_code": "string",
"city_code": "string",
"latitude": 0,
"longitude": 0
},
"destination": {
"street": "string",
"number": "string",
"complement": "string",
"neighborhood": "string",
"city": "string",
"state": "string",
"country": "Brasil",
"zip_code": "string",
"city_code": "string",
"latitude": 0,
"longitude": 0
},
"distance_travelled": 0
}
]}
Como preencher o array routes
Sempre que houver um novo ponto de coleta, parada ou entrega, deverá ser enviada uma
nova rota contendo:
● Origem;
● Destino;
● Distância percorrida entre os pontos (distance_travelled).
Importante:
● O campo distance_travelled não pode ser enviado com valor 0.
● Deve ser enviada a distância calculada da rota.
● Caso a distância ainda não esteja disponível, não há necessidade enviar o campo.

Sem esta adequação, a emissão de CIOTs Padrão (Lotação) passará a ser rejeitada a
partir de 10/06/2026.
Reforço das alterações implementadas para
atendimento à Nova Lei do Frete Mínimo
Além da alteração de endereços, seguem os principais ajustes já disponibilizados e que
devem ser observados nas integrações:
1. Quantidade de eixos (Obrigatório)
Campo obrigatório para todos os veículos informados:
"vehicles": [
{
"plate": "string",
"category": "st",
"rntrc": "string",
"axle_quantity": 0
}
]
2. Indicadores Operacionais (Obrigatórios para CIOT Padrão/Lotação)
Os indicadores abaixo devem ser enviados com valor true ou false:
"operational_indicators": {
"vehicle_composition": false,
"auto_performance": false,
"empty_return": false
}
Campos:
● vehicle_composition (Composição Veicular)
● auto_performance (Alto Desempenho)
● empty_return (Retorno Vazio)
3. Tipo de Carga (Obrigatório)
Deve ser informado o campo cargo_type_code, com valores válidos de 1 a 12.
"cargoes": [
{
"load_weight": 0,
"nature_code": "0001",
"cargo_type_code": 1
}
]
4. Latitude e Longitude
Embora não sejam obrigatórios, recomendamos fortemente o envio dos campos de latitude
e longitude nos endereços.
Essa informação reduz significativamente ocorrências de rejeição da ANTT relacionadas a
CEPs não cadastrados ou inconsistentes.
5. Tipo de Pagamento
Passou a ser obrigatório informar a modalidade de pagamento do frete:
● À vista;
● A prazo.
6. Pertence à Frota
Campo opcional e informativo, sem impacto nas validações atuais.
7. Novo Tipo Operacional – Fracionado
Foi disponibilizado o novo tipo de operação:
● 2 – Fracionado
Os detalhes de preenchimento e exemplos completos de payload encontram-se na
documentação.
Documentação

A documentação completa da API, incluindo todas as alterações necessárias para
atendimento à Nova Lei do Frete Mínimo, está disponível em:
https://ciot.api.homolog.truckpad.io/docs#/

Recomendamos que as adequações sejam realizadas o quanto antes para evitar impactos
na emissão de CIOTs após a entrada em vigor das novas validações.
Em caso de dúvidas, nosso time está à disposição.


Atenciosamente,
Equipe TruckPad