cte_uuidpath · stringRequiredPublic CT-e UUID.
Constraints
{
"type": "string",
"format": "uuid"
}Parameters, data structure and responses from the versioned contract.
/fiscal/cte/{cte_uuid}/complementarTechnical descriptions are translated from the versioned contract. Original identifiers and JSON are preserved; data examples are omitted.
Generates a Value Complement CT-e (ide/tpCTe = 1, group <infCteComp>) from an own CT-e already authorized by SEFAZ (cStat = 100).
tpServ and tax rule from the original operation, without linking new NF-e or generating a new MDF-e.valor_frete > 0 and/or icms.v_icms > 0). Reducing values via complementary CT-e is not allowed.emitir: false (default), returns 201 with the draft ready for preview or later issuance at POST /fiscal/cte/{cte_uuid}/emissao. With emitir: true, starts transmission immediately and returns 202.fiscal — Tax & Fiscal[
{
"oauth2": []
},
{
"chaveApi": []
}
]cte_uuidpath · stringRequiredPublic CT-e UUID.
{
"type": "string",
"format": "uuid"
}Required
application/jsonvalor_fretenumber | nullOptionalFreight value to add (vTPrest). Cannot be negative.
minimum0maximum999999.99valor_recebernumber | nullOptionalComplementary receivable value (vRec). If omitted, defaults to valor_frete.
minimum0maximum999999.99componentesarray | nullOptionalmaxItems20icmsobject | nullOptionalTransactional ICMS fields for pure tax complement or CST 60/90.
natureza_operacaostring | nullOptionalDefaults to COMPLEMENTO DE VALORES DE TRANSPORTE.
maxLength60observacoesstring | nullOptionalFree-form notes text; the mandatory payment notice is automatically kept.
maxLength2000emitirboolean | nullOptionalWhen true, reserves and immediately initiates issuance with the fiscal provider (202).
201 HTTP ResponseComplementary CT-e draft created (emitir = false).
X-Request-IdCall correlation identifier.
202 HTTP ResponseComplementary CT-e issuance started (emitir = true).
application/jsondataobjectRequiredenvironmentobjectRequiredX-Request-IdCall correlation identifier.
401 HTTP ResponseFleetPay API key missing or invalid.
X-Request-IdCall correlation identifier.
403 HTTP ResponseFiscal scope disabled for the key, or no active carrier associated with the key.
X-Request-IdCall correlation identifier.
404 HTTP ResponseResource not found in the authenticated tenant.
X-Request-IdCall correlation identifier.
422 HTTP ResponseInvalid payload, outstanding requirement or business rule.
X-Request-IdCall correlation identifier.
429 HTTP ResponsePer-carrier limit exceeded.
X-Request-IdCall correlation identifier.
Retry-AfterSeconds until another attempt.
500 HTTP ResponseInternal failure without operational integration details.
X-Request-IdCall correlation identifier.
{
"tags": [
"CT-e"
],
"summary": "Criar ou emitir CT-e complementar de valores",
"description": "Gera um **CT-e Complementar de Valores** (`ide/tpCTe = 1`, grupo `<infCteComp>`) a partir de\num CT-e próprio já autorizado pela SEFAZ (`cStat = 100`).\n\n- O CT-e original permanece válido e inalterado (não é cancelado nem substituído).\n- O documento complementar recebe número, série, chave de acesso e protocolo próprios.\n- Mantém automaticamente remetente, destinatário, tomador, rota, `tpServ` e regra tributária\n da prestação original, sem vincular novas NF-es nem gerar novo MDF-e.\n- Informe somente a diferença a acrescentar (`valor_frete > 0` e/ou `icms.v_icms > 0`). Não é\n permitido reduzir valores por CT-e complementar.\n- Com `emitir: false` (padrão), responde `201` com o rascunho pronto para prévia ou emissão\n posterior em `POST /fiscal/cte/{cte_uuid}/emissao`. Com `emitir: true`, inicia a transmissão\n imediatamente e responde `202`.\n",
"operationId": "createComplementaryCte",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateComplementaryCteInput"
}
}
}
},
"responses": {
"201": {
"description": "Rascunho de CT-e complementar criado (`emitir = false`).",
"headers": {
"X-Request-Id": {
"$ref": "#/components/headers/RequestId"
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CteEnvelope"
}
}
}
},
"202": {
"description": "Emissão do CT-e complementar iniciada (`emitir = true`).",
"headers": {
"X-Request-Id": {
"$ref": "#/components/headers/RequestId"
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CteIssueEnvelope"
}
}
}
},
"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"
}
},
"x-fleetpay-scope": "fiscal",
"x-fleetpay-module": "fiscal-ciot",
"x-fleetpay-profiles": [
"gestor",
"agregado_empresarial",
"transportador_frotista"
],
"method": "POST",
"path": "/fiscal/cte/{cte_uuid}/complementar",
"parameters": [
{
"$ref": "#/components/parameters/CteUuid"
}
]
}