Envio de alterações

Método e rota

Solicitação (POST): /frete/lote/operacaoTransporte/alterar/:enterpriseId
- Onde o {enterpriseID} é o CNPJ da contratante

Corpo

O payload JSON deve seguir a estrutura da referência, representando a operação de transporte a ser alterada com os seguintes campos:

Dados identificadores da operação
- cnpj : cnpj da contratante;
- numeroCiot : numero da operação de transporte;
- codigoVerificadorCiot código verificador da operação de transporte (informar ‘XXXX’ em caso de contingência);
- motivo: Justificativa para as alterações.

Layout

Nome do campo	Tipo	Obrigatório?	Observação
`cnpj`	String(14)	Sim (1)	CNPJ da Contratante (14 dígitos).
`numeroCiot`	String(12)	Sim (1)	Código Identificador da OT (até 12).
`codigoVerificadorCiot`	String(4)	Sim (1)	Protocolo de autorização da OT na ANTT (4 caracteres). Usar `XXXX` em contingência.
`motivo`	String(1–1000)	Sim (1)	Motivo da alteração.
`operacao`	Object	Não	Dados para alteração na ANTT. Pode conter validade, carga, veículos e tarifas.
`dataInicio` (em `operacao`)	Date	Sim (1) se `dataFim`	Formato `AAAA-MM-DD`.
`dataFim` (em `operacao`)	Date	Sim (1) se `dataInicio`	Formato `AAAA-MM-DD`.
`codigoSH` (em `operacao`)	number	Sim (1) se `quantidade`	Natureza da carga (4 dígitos).
`quantidade` (em `operacao`)	decimal	Sim (1) se `codigoSH`	Quantidade em Kg (2 casas decimais).
`veiculos` (em `operacao`)	Object	Não (0–1)	Dados dos veículos a alterar.
`veiculo` (em `veiculos`)	Array	Sim (1–N)	Cada item representa um veículo.
`placa` (em `veiculo`)	String(7)	Sim (1)	Placa do veículo.
`RNTRCTransportador` (em `veiculo`)	number(9)	Sim (1)	RNTRC do transportador responsável.
`cadastro` (em `veiculo`)	Object	Não (0–1)	Dados do veículo para cadastro.
`modelo` (em `cadastro`)	String(100)	Sim (1)	Modelo do veículo.
`kmLitroModelo` (em `cadastro`)	decimal	Não (0–1)	KM/L do modelo (2 decimais).
`tipo` (em `cadastro`)	number	Sim (1)	1 = Tração, 2 = Reboque.
`kmLitroVeiculo` (em `cadastro`)	decimal	Não (0–1)	KM/L do veículo (2 decimais).
`tarifas`	Object	Sim (1)	Dados de tarifas associadas à OT.
`quantidadeTotalTarifas` (em `operacao`)	number	Não (0–1)	Quantidade total de tarifas.
`documentos`	Object	Não (0–1)	Lista de documentos originários.
`documentoOriginario` (em `documentos`)	Array	Sim (1–N)	Cada item representa um documento.
`tipo` (em `documentoOriginario`)	String(40)	Sim (1)	Tipo de documento (ex.: NF-e).
`numero` (em `documentoOriginario`)	String(44)	Sim (1)	Número do documento.
`camposAdicionais`	Object	Não (0–1)	Dados adicionais para impressão.
`campo` (em `camposAdicionais`)	Array	Sim (1–N)	Cada item representa um campo adicional.
`nome` (em `campo`)	String(255)	Sim (1)	Nome do campo.
`valor` (em `campo`)	String	Sim (1)	Valor do campo (string livre).
`valores`	Object	Sim (1)	Alteração da OT sem movimentação financeira.
`frete` (em `valores`)	decimal	Não (0–1)	Valor do frete (1–15,2).
`combustivel` (em `valores`)	decimal	Não (0–1)	Valor do combustível (1–15,2).
`pedagio` (em `valores`)	decimal	Não (0–1)	Valor do pedágio (1–15,2).
`quantidadeTotalTarifas` (em `valores`)	number	Sim (1)	Quantidade total de tarifas.
`valorTotalTarifas` (em `tarifas`)	decimal	Sim (1)	Valor total das tarifas.
`despesas` (em `valores`)	Object	Não (0–1)	Dados das despesas.
`valor` (em `despesas`)	decimal	Sim (1)	Valor total das despesas (1–15,2).
`descricao` (em `despesas`)	String(2000)	Sim (1)	Descrição das despesas.
`retencoes` (em `valores`)	Object	Não (0–1)	Dados de retenções (IRRF, INSS, SEST/SENAT).
`irrf` (em `retencoes`)	decimal	Sim (1)	Mesmo que zero.
`inss` (em `retencoes`)	decimal	Sim (1)	Mesmo que zero.
`sestsenat` (em `retencoes`)	decimal	Sim (1)	Mesmo que zero.
`desconto` (em `valores`)	Object	Não (0–1)	Dados do desconto.
`nome` (em `desconto`)	String(50)	Sim (1)	Nome do desconto.
`valor` (em `desconto`)	decimal	Sim (1)	Valor do desconto (1–15,2).
`rubrica` (em `desconto`)	number	Sim (1)	1 = Frete, 2 = Combustível, 3 = Despesa, 4 = Tarifa.
`descricao` (em `desconto`)	String(255)	Não (0–1)	Informação adicional do desconto.
`condutores`	Array	Não	Alteração de condutores.
`condutor` (em `condutores`)	Object	Sim (1–N)	Cada item representa um condutor.
`cpf` (em `condutor`)	number(11)	Sim (1)	CPF do condutor.
`tipoAlteracao` (em `condutor`)	number	Sim (1)	1 = Adição, 2 = Remoção.
`informacoes` (em `condutor`)	Object	Não (0–1)	Dados para cadastro do condutor.
`nomeCompleto` (em `informacoes`)	String(150)	Sim (1)	Nome completo do condutor.
`nomeMae` (em `informacoes`)	String(150)	Sim (1)	Nome da mãe.
`nomePai` (em `informacoes`)	String(150)	Não (0–1)	Nome do pai.
`dataNascimento` (em `informacoes`)	Date	Sim (1)	Formato `AAAA-MM-DD`.
`identidade` (em `informacoes`)	String(20)	Sim (1)	RG do condutor.
`CNH` (em `informacoes`)	String(15)	Não (0–1)	Número da CNH.
`dataEmissaoCNH` (em `informacoes`)	Date	Não (0–1)	Formato `AAAA-MM-DD`.
`dataRenovacaoCNH` (em `informacoes`)	Date	Não (0–1)	Formato `AAAA-MM-DD`.
`telefone` (em `informacoes`)	number	Sim (1)	Celular (10 ou 11 dígitos).
`RNTRCTransportador` (em `informacoes`)	number(9)	Não (0–1)	Obrigatório se houver cartão vinculado.
`cpfCnpjTransportador` (em `informacoes`)	String(14)	Não (0–1)	CPF ou CNPJ do transportador.
`endereco` (em `informacoes`)	Object	Sim (1)	Dados de endereço do condutor.
`UF` (em `endereco`)	String(2)	Sim (1)	Sigla da UF.
`codigoMunicipio` (em `endereco`)	String(50)	Não (0–1)	Código do município.
`cidade` (em `endereco`)	String(100)	Sim (1)	Nome do município.
`bairro` (em `endereco`)	String(255)	Sim (1)	Bairro.
`logradouro` (em `endereco`)	String(255)	Sim (1)	Logradouro.
`numero` (em `endereco`)	String	Não (0–1)	Número do endereço.
`CEP` (em `endereco`)	String(8)	Não (0–1)	CEP do condutor.
`complemento` (em `endereco`)	String(255)	Não (0–1)	Complemento do endereço.

Alteração operacional do CIOT — Exemplo

(Alteração de validade e dados de carga – permitida até 24 horas após a emissão)

{
		"cnpj": "12345678901234",
    "numeroCiot": "123456789012",
    "codigoVerificadorCiot": "ABCD",
    "motivo": "Alterações necessárias para a OT.",
    "operacao": {
        "dataInicio": "2025-01-01",
        "dataFim": "2025-01-05",
        "codigoSH": "1234",
        "quantidadeCarga": 100.50,
        "veiculos": [
            {
                "placa": "ABC1234",
                "rntrcTransportador": "123456789",
                "cadastro": {
                    "modelo": "Caminhão 19.320",
                    "kmLitroModelo": 3.5,
                    "tipo": 1,
                    "kmLitroVeiculo": 3.2
                }
            }
        ],
        "categoriaPedagio": 0,
        "quantidadeTotalTarifas": 2
    },
}

Inclusão de documentos no CIOT — Exemplo

{
    "cnpj": "12345678901234",
    "numeroCiot": "123456789012",
    "codigoVerificadorCiot": "ABCD",
    "motivo": "Alterações necessárias para a OT.",
    "documentos": [
        {
            "tipo": "Documento Orig Fin",
            "numero": "ABC789"
        }
    ]
}

Inclusão de campos adicionais personalizados no CIOT - Exemplo

{
    "cnpj": "12345678901234",
    "numeroCiot": "123456789012",
    "codigoVerificadorCiot": "ABCD",
    "motivo": "Alterações necessárias para a OT.",
    "camposAdicionais": [
        {
            "nome": "Campo1",
            "valor": "Valor1"
        },
        {
            "nome": "Campo2",
            "valor": "Valor2"
        }
    ]
}

Alteração de dados de valores sem pagamento NDD Cargo — Exemplo

{
    "cnpj": "12345678901234",
    "numeroCiot": "123456789012",
    "codigoVerificadorCiot": "ABCD",
    "motivo": "Alterações necessárias para a OT.",
    "valores": {
        "frete": 1000.0,
        "combustivel": 300.0,
        "pedagio": 50.0,
        "quantidadeTotalTarifas": 2,
        "valorTotalTarifas": 30.0,
        "despesas": {
            "valor": 200.0,
            "descricao": "Despesa de viagem"
        },
        "retencoes": {
            "irrf": 0.0,
            "inss": 0.0,
            "sestsenat": 0.0
        },
        "descontos": {
            "nome": "Desconto Exemplo",
            "valor": 20.0,
            "rubrica": 1,
            "descricao": "Informações adicionais"
        }
    }
}

Inclusão/alteração de motoristas no CIOT — Exemplo

{
    "cnpj": "12345678901234",
    "numeroCiot": "123456789012",
    "codigoVerificadorCiot": "ABCD",
    "motivo": "Alterações necessárias para a OT.",
    "condutores": [
        {
            "cpf": "98765432100",
            "tipoAlteracao": 1,
            "informacoes": {
                "nomeCompleto": "Condutor Exemplo",
                "nomeMae": "Mae Condutor",
                "nomePai": "Pai Condutor",
                "dataNascimento": "1980-01-01",
                "identidade": "RG1234567",
                "CNH": "123456789012345",
                "dataEmissaoCNH": "2022-01-10",
                "dataRenovacaoCNH": "2032-01-10",
                "telefone": "11999999999",
                "RNTRCTransportador": "888999777",
                "cpfCnpjTransportador": "12345678901234",
                "endereco": {
                    "uf": "SP",
                    "codigoMunicipio": "3550300",
                    "cidade": "São Paulo",
                    "bairro": "Bairro Central",
                    "logradouro": "Rua A",
                    "numero": "string",
                    "cep": "01001000",
                    "complemento": "Apto 101"
                }
            }
        }
    ]
}

Payload Completo — POST de alteração de lote de OT

{
    "cnpj": "12345678901234",
    "numeroCiot": "123456789012",
    "codigoVerificadorCiot": "ABCD",
    "motivo": "Alterações necessárias para a OT.",
    "operacao": {
        "dataInicio": "2025-01-01",
        "dataFim": "2025-01-05",
        "codigoSH": "1234",
        "quantidadeCarga": 100.50,
        "veiculos": [
            {
                "placa": "ABC1234",
                "rntrcTransportador": "123456789",
                "cadastro": {
                    "modelo": "Caminhão 19.320",
                    "kmLitroModelo": 3.5,
                    "tipo": 1,
                    "kmLitroVeiculo": 3.2
                }
            }
        ],
        "categoriaPedagio": 0,
        "quantidadeTotalTarifas": 2
    },
    "valores": {
        "frete": 1000.0,
        "combustivel": 300.0,
        "pedagio": 50.0,
        "quantidadeTotalTarifas": 2,
        "valorTotalTarifas": 30.0,
        "despesas": {
            "valor": 200.0,
            "descricao": "Despesa de viagem"
        },
        "retencoes": {
            "irrf": 0.0,
            "inss": 0.0,
            "sestsenat": 0.0
        },
        "descontos": {
            "nome": "Desconto Exemplo",
            "valor": 20.0,
            "rubrica": 1,
            "descricao": "Informações adicionais"
        }
    },
    "documentos": [
        {
            "tipo": "Documento Orig Fin",
            "numero": "ABC789"
        }
    ],
    "condutores": [
        {
            "cpf": "98765432100",
            "tipoAlteracao": 1,
            "informacoes": {
                "nomeCompleto": "Condutor Exemplo",
                "nomeMae": "Mae Condutor",
                "nomePai": "Pai Condutor",
                "dataNascimento": "1980-01-01",
                "identidade": "RG1234567",
                "CNH": "123456789012345",
                "dataEmissaoCNH": "2022-01-10",
                "dataRenovacaoCNH": "2032-01-10",
                "telefone": "11999999999",
                "RNTRCTransportador": "888999777",
                "cpfCnpjTransportador": "12345678901234",
                "endereco": {
                    "uf": "SP",
                    "codigoMunicipio": "3550300",
                    "cidade": "São Paulo",
                    "bairro": "Bairro Central",
                    "logradouro": "Rua A",
                    "numero": "string",
                    "cep": "01001000",
                    "complemento": "Apto 101"
                }
            }
        }
    ],
    "camposAdicionais": [
        {
            "nome": "Campo1",
            "valor": "Valor1"
        },
        {
            "nome": "Campo2",
            "valor": "Valor2"
        }
    ]
}

Resposta do POST

Exemplo de resposta de sucesso:

{
  "sucesso": true,
  "guid": "6058d7d1-02e6-42a3-917c-b8b20bf1abf7",
  "codigo": "000",
  "mensagem": "Lote recebido para processamento."
}

Exemplo de resposta de erro:

{
  "sucesso": false,
  "guid": "00000000-0000-0000-0000-000000000000",
  "codigo": "400",
  "mensagem": "Erro na validação dos parâmetros do lote."
}

Próximos passos

Acesse a consulta da solicitação de alteração ou veja como obter comprovante do CIOT.

Método e rota​

Corpo​

Resposta do POST​

Próximos passos​

Método e rota

Corpo

Resposta do POST

Próximos passos