cte_uuidpath · stringObligatorioUUID público del CT-e.
Restricciones
{
"type": "string",
"format": "uuid"
}Parámetros, estructura de datos y respuestas del contrato versionado.
/fiscal/cte/{cte_uuid}/complementarLas descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.
Genera un CT-e Complementario de Valores (ide/tpCTe = 1, grupo <infCteComp>) a partir de un CT-e propio ya autorizado por SEFAZ (cStat = 100).
tpServ y regla tributaria de la prestación original, sin vincular nuevas NF-e ni generar nuevo MDF-e.valor_frete > 0 y/o icms.v_icms > 0). No se permite reducir valores mediante CT-e complementario.emitir: false (predeterminado), responde 201 con el borrador listo para vista previa o emisión posterior en POST /fiscal/cte/{cte_uuid}/emissao. Con emitir: true, inicia la transmisión de inmediato y responde 202.fiscal — Fiscal[
{
"oauth2": []
},
{
"chaveApi": []
}
]cte_uuidpath · stringObligatorioUUID público del CT-e.
{
"type": "string",
"format": "uuid"
}Obligatorio
application/jsonvalor_fretenumber | nullOpcionalValor del flete a añadir (vTPrest). No puede ser negativo.
minimum0maximum999999.99valor_recebernumber | nullOpcionalValor por cobrar complementario (vRec). Ausente, asume valor_frete.
minimum0maximum999999.99componentesarray | nullOpcionalmaxItems20icmsobject | nullOpcionalCampos transaccionales de ICMS para complemento puro de impuesto o CST 60/90.
natureza_operacaostring | nullOpcionalPredeterminado COMPLEMENTO DE VALORES DE TRANSPORTE.
maxLength60observacoesstring | nullOpcionalTexto libre de observaciones; el aviso obligatorio de pago se mantiene automáticamente.
maxLength2000emitirboolean | nullOpcionalCuando es true, reserva e inicia de inmediato la emisión ante el proveedor fiscal (202).
201 Respuesta HTTPBorrador de CT-e complementario creado (emitir = false).
X-Request-IdIdentificador de correlación de la llamada.
202 Respuesta HTTPEmisión de CT-e complementario iniciada (emitir = true).
application/jsondataobjectObligatorioenvironmentobjectObligatorioX-Request-IdIdentificador de correlación de la llamada.
401 Respuesta HTTPClave de API FleetPay ausente o no válida.
X-Request-IdIdentificador de correlación de la llamada.
403 Respuesta HTTPÁmbito fiscal deshabilitado en la clave, o clave sin transportista activo.
X-Request-IdIdentificador de correlación de la llamada.
404 Respuesta HTTPRecurso no encontrado en el tenant autenticado.
X-Request-IdIdentificador de correlación de la llamada.
422 Respuesta HTTPPayload inválido, requisito pendiente o regla de negocio.
X-Request-IdIdentificador de correlación de la llamada.
429 Respuesta HTTPLímite por transportista excedido.
X-Request-IdIdentificador de correlación de la llamada.
Retry-AfterSegundos hasta un nuevo intento.
500 Respuesta HTTPFallo interno sin detalles de las integraciones operativas.
X-Request-IdIdentificador de correlación de la llamada.
{
"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"
}
]
}