uuidpath · stringObrigatórioUUID ou ID numérico do caso de auditoria.
Restrições
{
"type": "string"
}Parâmetros, estrutura de dados e respostas do contrato versionado.
/embarcador/auditoria-frete/casos/{uuid}/decisaoDescrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.
Aprova integralmente (approve_full), aceita valor faturado (accept_charged), envia contraproposta (counterproposal, validada contra o piso mínimo da ANTT) ou rejeita (reject), disparando webhook auditoria.caso_decidido. Exige escopo operacao.
operacao — Operação[
{
"oauth2": []
},
{
"chaveApi": []
}
]uuidpath · stringObrigatórioUUID ou ID numérico do caso de auditoria.
{
"type": "string"
}Obrigatório
Decisão comercial sobre o caso de auditoria.
application/jsondecisionstringObrigatório"approve_full" · "accept_charged" · "counterproposal" · "reject"counterproposal_amountnumber | nullOpcionalObrigatório quando decision = counterproposal.
notesstring | nullOpcional200 Resposta HTTPOperação processada com sucesso.
application/jsondata—Opcionalmetaobject | nullOpcionaladditionalPropertiestrueambientestringOpcional"homologacao" · "producao"401 Resposta HTTPCredencial ausente, inválida ou de outro ambiente.
403 Resposta HTTPEscopo do painel não habilitado ou recurso fora do escopo da company.
404 Resposta HTTPCaso não encontrado.
422 Resposta HTTPViolação do piso ANTT ou transição inválida.
{
"tags": [
"Auditoria de Frete"
],
"operationId": "decidirCasoAuditoriaFrete",
"summary": "Registrar decisão comercial ou contestação em caso de auditoria",
"description": "Aprova integralmente (`approve_full`), aceita valor faturado (`accept_charged`), envia contraproposta (`counterproposal`, validada contra o piso mínimo da ANTT) ou rejeita (`reject`), disparando webhook `auditoria.caso_decidido`. Exige escopo `operacao`.",
"parameters": [
{
"name": "uuid",
"in": "path",
"required": true,
"description": "UUID ou ID numérico do caso de auditoria.",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"required": true,
"description": "Decisão comercial sobre o caso de auditoria.",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"decision"
],
"properties": {
"decision": {
"type": "string",
"enum": [
"approve_full",
"accept_charged",
"counterproposal",
"reject"
]
},
"counterproposal_amount": {
"type": [
"number",
"null"
],
"description": "Obrigatório quando decision = counterproposal."
},
"notes": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"responses": {
"200": {
"description": "Operação processada com sucesso.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
]
},
"meta": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"ambiente": {
"type": "string",
"enum": [
"homologacao",
"producao"
]
}
}
}
}
}
},
"401": {
"description": "Credencial ausente, inválida ou de outro ambiente."
},
"403": {
"description": "Escopo do painel não habilitado ou recurso fora do escopo da company."
},
"404": {
"description": "Caso não encontrado."
},
"422": {
"description": "Violação do piso ANTT ou transição inválida."
}
},
"x-fleetpay-scope": "operacao",
"x-fleetpay-module": "faturas-auditoria",
"x-fleetpay-profiles": [
"embarcador",
"gestor"
],
"method": "POST",
"path": "/embarcador/auditoria-frete/casos/{uuid}/decisao"
}