O payload de configuração do módulo aceita apenas duas chaves no nível superior: title e fields. Qualquer outra chave — description, blocksMovement, slug, uiComponent, active ou rules — é rejeitada com erro 400.
Nenhum item de fields deve incluir a chave active, mesmo que a consulta da configuração retorne essa informação para cada campo — reenviá-la é rejeitado com erro 400 tanto na criação quanto na atualização.
As opções de campos do tipo seleção (select, radio, checkList) são sempre uma lista simples de strings (["Sim", "Não"]) — nunca um objeto com label e value.
A configuração do parecer é única por fluxo, não por fase, ainda que o caminho da API inclua um identificador de fase. Para usar o parecer em múltiplas fases de um mesmo fluxo, crie a configuração uma única vez e habilite o módulo em cada fase por meio da ação de fase correspondente.
Quando o fluxo ainda não tem parecer configurado, a consulta da configuração retorna sucesso com um corpo vazio, em vez de um erro de recurso não encontrado.
Criar a configuração do módulo não é suficiente, por si só, para que o parecer apareça para os usuários na fase — é necessário também habilitar o módulo por meio de uma ação de fase com action: opinion.
A atualização da configuração (PUT) substitui integralmente a lista de campos complementares. Reenviar um campo existente exige seu id original; omiti-lo não o remove definitivamente — a API marca o campo como inativo (exclusão lógica). Ao montar o payload de atualização a partir de uma consulta anterior, descarte os campos já inativos antes de reenviar.
No registro do parecer do card, value (o valor aprovado) é obrigatório sempre que status for approved — sua ausência é rejeitada.
O registro do parecer do card não aceita as chaves limit nem comment.
Os valores dos campos complementares no parecer do card são identificados pelo id de cada campo (obtido na configuração do módulo), não pelo nome. Para campos do tipo seleção, o valor é sempre enviado como array, mesmo quando apenas uma opção é selecionada.
Uma segunda chamada de criação de parecer para o mesmo card e fase falha, pois o parecer já existe — use a chamada de atualização para revisá-lo.
