cte_uuidpath · stringObrigatórioUUID público do CT-e.
Restrições
{
"type": "string",
"format": "uuid"
}Parâmetros, estrutura de dados e respostas do contrato versionado.
/fiscal/cte/{cte_uuid}/complementarDescrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.
Gera um CT-e Complementar de Valores (ide/tpCTe = 1, grupo <infCteComp>) a partir de
um CT-e próprio já autorizado pela SEFAZ (cStat = 100).
tpServ e regra tributária
da prestação original, sem vincular novas NF-es nem gerar novo MDF-e.valor_frete > 0 e/ou icms.v_icms > 0). Não é
permitido reduzir valores por CT-e complementar.emitir: false (padrão), responde 201 com o rascunho pronto para prévia ou emissão
posterior em POST /fiscal/cte/{cte_uuid}/emissao. Com emitir: true, inicia a transmissão
imediatamente e responde 202.fiscal — Fiscal[
{
"oauth2": []
},
{
"chaveApi": []
}
]cte_uuidpath · stringObrigatórioUUID público do CT-e.
{
"type": "string",
"format": "uuid"
}Obrigatório
application/jsonvalor_fretenumber | nullOpcionalValor do frete a acrescentar (vTPrest). Não pode ser negativo.
minimum0maximum999999.99valor_recebernumber | nullOpcionalValor a receber complementar (vRec). Ausente, assume valor_frete.
minimum0maximum999999.99componentesarray | nullOpcionalmaxItems20icmsobject | nullOpcionalCampos transacionais de ICMS para complemento puro de imposto ou CST 60/90.
natureza_operacaostring | nullOpcionalPadrão COMPLEMENTO DE VALORES DE TRANSPORTE.
maxLength60observacoesstring | nullOpcionalTexto livre de observações; o aviso obrigatório de pagamento é mantido automaticamente.
maxLength2000emitirboolean | nullOpcionalQuando true, reserva e inicia imediatamente a emissão junto ao provedor fiscal (202).
201 Resposta HTTPRascunho de CT-e complementar criado (emitir = false).
X-Request-IdIdentificador de correlação da chamada.
202 Resposta HTTPEmissão do CT-e complementar iniciada (emitir = true).
application/jsondataobjectObrigatórioenvironmentobjectObrigatórioX-Request-IdIdentificador de correlação da chamada.
401 Resposta HTTPChave de API FleetPay ausente ou inválida.
X-Request-IdIdentificador de correlação da chamada.
403 Resposta HTTPEscopo fiscal desabilitado na chave, ou chave sem transportadora ativa.
X-Request-IdIdentificador de correlação da chamada.
404 Resposta HTTPRecurso não encontrado no tenant autenticado.
X-Request-IdIdentificador de correlação da chamada.
422 Resposta HTTPPayload inválido, pendência ou regra de negócio.
X-Request-IdIdentificador de correlação da chamada.
429 Resposta HTTPLimite por transportadora excedido.
X-Request-IdIdentificador de correlação da chamada.
Retry-AfterSegundos até uma nova tentativa.
500 Resposta HTTPFalha interna sem detalhes de integrações operacionais.
X-Request-IdIdentificador de correlação da chamada.
{
"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"
}
]
}