Tabela de decisão

O nó Tabela de decisão (grupo Fluxo da paleta) guarda uma régua de negócio numa grade, em vez de uma escada de IFs espalhada pelo canvas: "até 30 dias de atraso, desconto de 10% e prazo de 5 dias; acima disso, sem desconto e vai para o Financeiro". Cada linha é uma regra, as colunas da esquerda são as perguntas e as da direita, as respostas.

Ele não separa caminhos: uma decisão devolve valores, não rota. As colunas de saída são acrescentadas ao item e seguem adiante — se você quiser rotear pelo resultado, ligue um Switch depois. É por isso que a mesma tabela consegue decidir o desconto, o responsável e o prazo de uma vez.

Montando a grade

No campo Regras você monta a tabela com três botões:

• ＋ Coluna de entrada — o que a régua olha. Cada coluna tem um nome (para você ler a tabela) e o campo de onde vem o valor, escrito como {{ … }}; você também pode arrastar o campo do painel de dados para dentro.
• ＋ Coluna de saída — o que a régua responde. Informe o nome com que o valor entra no item, por exemplo desconto. Coluna sem nome não sai.
• ＋ Regra — uma linha da tabela.

A grade fica dividida em Quando (as entradas) e Então (as saídas). Em cada célula de Quando você escolhe o operador e escreve o valor:

Uma regra casa quando todas as suas células casam. Célula deixada em qualquer valor não atrapalha — por isso acrescentar uma coluna nova não invalida as regras que já estavam escritas.

Cada regra tem ainda uma anotação à direita, opcional: um texto curto que volta junto do resultado e explica por que aquela regra existe.

Os valores também aceitam {{ … }}, tanto nas condições quanto nas saídas. Célula de saída em branco devolve valor vazio, e valor numérico volta como número — um 10 chega ao próximo nó como dez, não como o texto "10".

Quando mais de uma regra casar

A opção Única é o que separa uma tabela de decisão de uma escada de IFs: a sobreposição aparece na hora em que acontece, em vez de a régua escolher uma regra por ordem de digitação e o valor errado seguir caminho.

Com Todas, aparece o campo Como juntar os valores: Nenhum — devolve a lista de valores, Soma, Menor valor, Maior valor ou Quantidade de regras que casaram.

Em Quando nenhuma regra casar você escolhe entre Segue com as saídas em branco (o padrão) e Interrompe com erro.

O que sai do nó

O item segue com todos os seus campos, mais uma coluna de saída para cada coluna que você definiu e um campo _decisao com as regras que casaram (pelo número da linha) e a anotação. Quando o valor sair diferente do esperado, é ali que se vê qual linha decidiu.

Publicar a decisão para outros sistemas

Preencha Publicar como (opcional) com um nome — por exemplo regua-desconto — e a mesma régua passa a responder por fora do fluxo: qualquer sistema pergunta e recebe a resposta, sem copiar a regra para dentro dele. Deixe em branco para usar a tabela só dentro do fluxo.

O que é preciso saber antes:

• O nome usa letras, números, _ e -, até 64 caracteres, e é único na sua instância — se outro fluxo já publicou esse nome, o editor avisa ao salvar.
• O fluxo precisa estar ativo. Fluxo desativado deixa a decisão indisponível.
• Perguntar não executa o fluxo: só a tabela é avaliada. Não entra no histórico de execuções nem depende da fila.
• A publicação também deixa a decisão disponível como ferramenta para um assistente de IA, pelo mesmo caminho das ferramentas MCP.

Autenticação

As chamadas usam o token de integração da sua instância — o mesmo que atende os demais endereços de integração do NEXUS Flow — no cabeçalho Authorization: Bearer …. Peça-o ao suporte. Sem ele, ou com um valor errado, a resposta é 401.

Listar as decisões publicadas

Serve para o outro sistema descobrir o que existe e o que cada régua espera receber:

GET /api/v1/decisoes
Authorization: Bearer SEU-TOKEN

{
  "ok": true,
  "decisoes": [
    {
      "chave": "regua-desconto",
      "descricao": "Régua de desconto",
      "fluxo": "Negociação de dívidas",
      "contrato": {
        "entradas": ["Dias de atraso", "Valor"],
        "saidas": ["desconto", "responsavel"],
        "hit": "unique",
        "regras": 4
      }
    }
  ]
}

O contrato é o resumo da tabela: os nomes das colunas de entrada, os nomes das saídas, a política de acerto e quantas regras existem.

Perguntar a uma decisão

Envie os valores de entrada no corpo, com os mesmos nomes que as colunas de entrada leem no item:

POST /api/v1/decisoes/regua-desconto/avaliar
Authorization: Bearer SEU-TOKEN
Content-Type: application/json

{ "dias_atraso": 20, "valor": 1500 }

{
  "ok": true,
  "saidas": { "desconto": 10, "responsavel": "financeiro" },
  "regras": [2],
  "anotacao": "Política aprovada em jan/2026"
}

regras traz o número das linhas que casaram e anotacao, o texto da regra escolhida — a mesma explicação que você vê dentro do fluxo.

Quando algo não fecha, a resposta diz o quê:

Como a régua da tela e a régua da pergunta são a mesma tabela, editar as regras no editor muda a resposta para todo mundo assim que o fluxo é salvo — não existe uma segunda cópia para manter em dia.