Registrar voto de aprovação

Registra um novo voto de aprovação para um card, na fase indicada. A chamada é usada pelo aprovador atual dentro da alçada configurada para a fase — a fase precisa ter ao menos uma regra de aprovação já cadastrada; caso contrário, a chamada retorna erro por não localizar uma regra aplicável ao card.

Os três campos do payload são obrigatórios: status (approved, rejected ou approved_with_reservations), value (número maior ou igual a zero) e comment (texto não vazio). Diferente de outros módulos de decisão sobre o card, aqui o comentário é sempre obrigatório, mesmo em aprovações simples.

Quando status é rejected, o valor de value deve ser exatamente zero — valores de aprovação (value maior que zero) só se aplicam quando status é approved, representando o limite ou valor aprovado.

Um mesmo aprovador não vota duas vezes na mesma alçada: uma segunda tentativa de voto retorna um erro informando que a votação já foi concluída. Caso uma chamada anterior tenha retornado um erro inesperado, recomendamos consultar o registro de aprovação do card antes de tentar novamente — o voto pode já ter sido persistido apesar do erro reportado.

Registrar voto de aprovação

Requisição

Respostas