cte_uuidpath · stringObrigatórioUUID público do CT-e.
Restrições
{
"type": "string",
"format": "uuid"
}← InícioFleetPay / API
Retificar CIOT
Parâmetros, estrutura de dados e respostas do contrato versionado.
POST
/fiscal/cte/{cte_uuid}/ciot/retificacaoDescrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.
Modo simulado em homologação. Esta operação não tem provedor de CIOT contratado por trás: em homologação a resposta é gerada pela FleetPay, é determinística e não tem efeito regulatório — nada é registrado na ANTT e nenhum CIOT tratado por aqui tem valor legal.
O contrato de request e response já é o definitivo: integre agora. Quando o provedor real entrar, o comportamento deixa de ser simulado sem mudança de contrato.
Autenticação
[
{
"oauth2": []
},
{
"chaveApi": []
}
]A disponibilidade depende do ambiente, dos escopos habilitados e do provedor. Esta referência não executa chamadas nem recebe credenciais.
Parâmetros
Corpo da Requisição
Obrigatório
application/json
valor_fretenumber | null · doubleOpcionaldata_fim_viagemstring | null · dateOpcionalorigem_destinoarray | nullOpcionalminItems1maxItems20dados_cargaobjectOpcionalRespostas
200 Resposta HTTP
Operação de CIOT concluída.
application/json
dataobjectObrigatórioenvironmentobjectObrigatórioHeaders
X-Request-IdIdentificador de correlação da chamada.
202 Resposta HTTP
Operação de CIOT ainda pendente ou ambígua; consulte novamente.
application/json
dataobjectObrigatórioenvironmentobjectObrigatórioHeaders
X-Request-IdIdentificador de correlação da chamada.
401 Resposta HTTP
Chave de API FleetPay ausente ou inválida.
Headers
X-Request-IdIdentificador de correlação da chamada.
403 Resposta HTTP
Escopo fiscal desabilitado na chave, ou chave sem transportadora ativa.
Headers
X-Request-IdIdentificador de correlação da chamada.
404 Resposta HTTP
Recurso não encontrado no tenant autenticado.
Headers
X-Request-IdIdentificador de correlação da chamada.
422 Resposta HTTP
Payload inválido, pendência ou regra de negócio.
Headers
X-Request-IdIdentificador de correlação da chamada.
429 Resposta HTTP
Limite por transportadora excedido.
Headers
X-Request-IdIdentificador de correlação da chamada.
Retry-AfterSegundos até uma nova tentativa.
500 Resposta HTTP
Falha interna sem detalhes de integrações operacionais.
Headers
X-Request-IdIdentificador de correlação da chamada.
Definição Completa da Operação
{
"tags": [
"CIOT"
],
"summary": "Retificar CIOT",
"operationId": "rectifyCiot",
"description": "**Modo simulado em homologação.** Esta operação não tem provedor de CIOT contratado por\ntrás: em homologação a resposta é gerada pela FleetPay, é determinística e **não tem\nefeito regulatório** — nada é registrado na ANTT e nenhum CIOT tratado por aqui tem\nvalor legal.\n\nO contrato de request e response já é o definitivo: integre agora. Quando o provedor real\nentrar, o comportamento deixa de ser simulado **sem mudança de contrato**.\n",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CiotRectificationInput"
}
}
}
},
"responses": {
"200": {
"$ref": "#/components/responses/CiotOk"
},
"202": {
"$ref": "#/components/responses/CiotPending"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"422": {
"$ref": "#/components/responses/ValidationOrBusinessRuleFailed"
},
"429": {
"$ref": "#/components/responses/RateLimited"
},
"500": {
"$ref": "#/components/responses/InternalError"
}
},
"method": "POST",
"path": "/fiscal/cte/{cte_uuid}/ciot/retificacao",
"parameters": [
{
"$ref": "#/components/parameters/CteUuid"
}
]
}