cte_uuidpath · stringRequiredPublic CT-e UUID.
Constraints
{
"type": "string",
"format": "uuid"
}← HomeFleetPay / API
Issue a CIOT
Parameters, data structure and responses from the versioned contract.
POST
/fiscal/cte/{cte_uuid}/ciot/emissaoTechnical descriptions are translated from the versioned contract. Original identifiers and JSON are preserved; data examples are omitted.
For a 202 response, query the CIOT before repeating any command.
Simulated sandbox mode. This operation has no contracted CIOT provider behind it: in the sandbox environment, FleetPay generates a deterministic response with no regulatory effect — nothing is registered with ANTT, and no CIOT handled here has legal validity.
The request and response contract is already final: you can integrate now. When the real provider is introduced, behavior stops being simulated without a contract change.
Authentication
[
{
"oauth2": []
},
{
"chaveApi": []
}
]Availability depends on the environment, enabled scopes and provider. This reference does not execute requests or collect credentials.
Parameters
Responses
201 HTTP Response
CIOT registered.
application/json
dataobjectRequiredenvironmentobjectRequiredHeaders
X-Request-IdCall correlation identifier.
202 HTTP Response
Issuance submitted and not yet completed.
application/json
dataobjectRequiredenvironmentobjectRequiredHeaders
X-Request-IdCall correlation identifier.
401 HTTP Response
FleetPay API key missing or invalid.
Headers
X-Request-IdCall correlation identifier.
403 HTTP Response
Fiscal scope disabled for the key, or no active carrier associated with the key.
Headers
X-Request-IdCall correlation identifier.
404 HTTP Response
Resource not found in the authenticated tenant.
Headers
X-Request-IdCall correlation identifier.
422 HTTP Response
An outstanding requirement or business rule prevented the operation.
Headers
X-Request-IdCall correlation identifier.
429 HTTP Response
Per-carrier limit exceeded.
Headers
X-Request-IdCall correlation identifier.
Retry-AfterSeconds until another attempt.
500 HTTP Response
Internal failure without operational integration details.
Headers
X-Request-IdCall correlation identifier.
Complete Operation Definition
{
"tags": [
"CIOT"
],
"summary": "Emitir CIOT",
"description": "Em 202, consulte o CIOT antes de repetir qualquer comando.\n\n**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",
"operationId": "issueCiot",
"responses": {
"201": {
"$ref": "#/components/responses/CiotCreated"
},
"202": {
"description": "Emissão enviada e ainda não concluída.",
"headers": {
"X-Request-Id": {
"$ref": "#/components/headers/RequestId"
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CiotOperationEnvelope"
}
}
},
"links": {
"ConsultarCiot": {
"operationId": "queryCiot",
"parameters": {
"cte_uuid": "$request.path.cte_uuid"
}
}
}
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"422": {
"$ref": "#/components/responses/BusinessRuleFailed"
},
"429": {
"$ref": "#/components/responses/RateLimited"
},
"500": {
"$ref": "#/components/responses/InternalError"
}
},
"method": "POST",
"path": "/fiscal/cte/{cte_uuid}/ciot/emissao",
"parameters": [
{
"$ref": "#/components/parameters/CteUuid"
}
]
}