cte_uuidpath · stringObligatorioUUID público del CT-e.
Restricciones
{
"type": "string",
"format": "uuid"
}← InicioFleetPay / API
Cerrar un CIOT
Parámetros, estructura de datos y respuestas del contrato versionado.
POST
/fiscal/cte/{cte_uuid}/ciot/encerramentoLas descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.
Modo simulado en homologación. Esta operación no tiene un proveedor de CIOT contratado: en homologación, FleetPay genera una respuesta determinista sin efecto regulatorio. No se registra nada ante ANTT y ningún CIOT gestionado aquí tiene validez legal.
El contrato de solicitud y respuesta ya es definitivo: puede integrar ahora. Cuando se incorpore el proveedor real, el comportamiento dejará de ser simulado sin cambiar el contrato.
Autenticación
[
{
"oauth2": []
},
{
"chaveApi": []
}
]La disponibilidad depende del entorno, los permisos habilitados y el proveedor. Esta referencia no ejecuta solicitudes ni recibe credenciales.
Parámetros
Cuerpo de la Solicitud
Obligatorio
application/json
peso_carganumber · doubleObligatorioorigem_destinoarray | nullOpcionalminItems1maxItems20Respuestas
200 Respuesta HTTP
Operación de CIOT concluida.
application/json
dataobjectObligatorioenvironmentobjectObligatorioHeaders
X-Request-IdIdentificador de correlación de la llamada.
202 Respuesta HTTP
Operación de CIOT aún pendiente o ambigua; consulta de nuevo.
application/json
dataobjectObligatorioenvironmentobjectObligatorioHeaders
X-Request-IdIdentificador de correlación de la llamada.
401 Respuesta HTTP
Clave de API FleetPay ausente o no válida.
Headers
X-Request-IdIdentificador de correlación de la llamada.
403 Respuesta HTTP
Ámbito fiscal deshabilitado en la clave, o clave sin transportista activo.
Headers
X-Request-IdIdentificador de correlación de la llamada.
404 Respuesta HTTP
Recurso no encontrado en el tenant autenticado.
Headers
X-Request-IdIdentificador de correlación de la llamada.
422 Respuesta HTTP
Payload inválido, requisito pendiente o regla de negocio.
Headers
X-Request-IdIdentificador de correlación de la llamada.
429 Respuesta HTTP
Límite por transportista excedido.
Headers
X-Request-IdIdentificador de correlación de la llamada.
Retry-AfterSegundos hasta un nuevo intento.
500 Respuesta HTTP
Fallo interno sin detalles de las integraciones operativas.
Headers
X-Request-IdIdentificador de correlación de la llamada.
Definición Completa de la Operación
{
"tags": [
"CIOT"
],
"summary": "Encerrar CIOT",
"operationId": "closeCiot",
"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/CiotClosingInput"
}
}
}
},
"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/encerramento",
"parameters": [
{
"$ref": "#/components/parameters/CteUuid"
}
]
}