Aprovações

Uma compra acima do limite espera a diretoria, um contrato espera o jurídico. No fluxo, isso é uma fase de aprovação: o card para nela até um dos aprovadores decidir. Nesta jornada, a TAI avisa quem precisa decidir — inclusive numa ferramenta sua —, e a decisão volta pela tela ou pela API.


Quando usar	Um processo precisa de aprovação, e você quer avisar ou decidir de fora da tela
Porta	Automação/webhook (aviso) · Webhook assinando eventos (decisão) · REST (configurar e decidir)
Você vai precisar	módulo `GESTAO_PROCESSOS`; permissão `PROCESSO` para configurar aprovadores; para decidir, o usuário precisa ser aprovador da fase (vinculado a um colaborador); JWT

Como funciona

card entra na fase "Aprovação" ──► gatilho Aprovação Pendente ──► Notificar | Enviar Email | Webhook
                                                                        │
aprovador decide ──► tela (Processos → Solicitações)                    │
                 └─► POST /card/{id}/aprovar  {resultado: APROVADO | REPROVADO}
                          │
       APROVADO ──► card avança para a próxima fase (e dispara as automações dela)
       REPROVADO ─► card fica na fase, com a decisão registrada

Passo a passo

Marque a fase e escolha os aprovadores. Na configuração do fluxo, aba Fases, marque Requer Aprovação (ou use o tipo Aprovação) e preencha Aprovadores. Pela API, os aprovadores de uma fase:
Terminal window
```
curl -s -X POST https://api.taitecnologia.com/phase/63/aprovadores \
  -H "Authorization: Bearer $TAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "colaboradorIds": [88, 91], "modo": "SUBSTITUIR" }'
```
modo: SUBSTITUIR (padrão — a lista enviada passa a ser a da fase), ADICIONAR ou REMOVER. Para ler: GET /phase/63/aprovadores. Qualquer um dos aprovadores decide, e a primeira decisão encerra a etapa.
Designe o aprovador de um card, se variar. Ao mover para a fase de aprovação, o parâmetro aprovadorDesignadoId escolhe quem aprova este card, no lugar da lista da fase:
Terminal window
```
curl -s -X POST "https://api.taitecnologia.com/card/90412/avancar?aprovadorDesignadoId=91" \
  -H "Authorization: Bearer $TAI_TOKEN"
```
Vale também em /card/{id}/mover/{phaseId} e no corpo de /card/{id}/submit.
Avise quem decide. Crie uma automação no fluxo com o gatilho Aprovação Pendente — ele dispara quando um card entra numa fase que pede aprovação, inclusive ao nascer nela. Ações úteis: Notificar o responsável, Enviar Email ou Webhook para a sua ferramenta de aprovações:
```
{
  "tipo": "aprovacao_pendente",
  "card": "{{card.id}}",
  "numero": "{{card.numero}}",
  "fluxo": "{{pipe.nome}}",
  "fase": "{{fase.nome}}",
  "valor": "{{campo.valor_total}}",
  "solicitante": "{{criador.nome}}"
}
```
Sem montar automação, os Avisos automáticos do fluxo (aba Geral) já avisam o aprovador quando um card espera por ele.

Liste o que espera decisão. Com o JWT do aprovador:

curl -s "https://api.taitecnologia.com/card/pendentes-aprovacao/page?page=0&size=50" \
  -H "Authorization: Bearer $TAI_TOKEN"

Decida.

curl -s -X POST https://api.taitecnologia.com/card/90412/aprovar \
  -H "Authorization: Bearer $TAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "resultado": "APROVADO", "observacao": "Dentro do orçamento do trimestre." }'

resultado é APROVADO ou REPROVADO. Aprovado, o card avança para a próxima fase — e quem aprova pode já designar o aprovador da fase seguinte com aprovadorDesignadoId. Reprovado, o card fica na fase com a decisão registrada.

Leia a decisão. GET /card/{id} traz em cardPhases cada passagem por fase, com resultado, observacao e dataDecisao, e em movimentacoes o histórico de fases.

Automatize

Depois da aprovação, a fase seguinte dispara as automações de Entrada na Fase — é aí que se avisa o ERP. Jornada completa em Avisar o ERP quando o pedido é aprovado.
Receba cada decisão no seu sistema. Toda decisão publica um evento: Um card é aprovado (CARD_APROVADO) ou Um card é reprovado (CARD_REPROVADO). Assine-os num webhook — sem automação no fluxo:
```
{
  "id": "evt_51902",
  "tipo": "CARD_REPROVADO",
  "descricao": "Um card é reprovado",
  "versao": 1,
  "ocorridoEm": "2026-10-06T15:10:44.020Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "cardId": 90412,
    "numero": 1287,
    "pipeId": 14,
    "pipeNome": "Compras",
    "faseId": 63,
    "faseNome": "Aprovação",
    "responsavelId": 88,
    "criadorId": 1043
  }
}
```
faseNome é a fase em que a decisão foi tomada. Os eventos valem para todos os fluxos: filtre por pipeId. A observacao de quem decidiu não vai em dados — leia em GET /card/{id} (cardPhases) ou marque Enviar também o registro completo. Para mandar a decisão num formato próprio (uma mensagem no Slack), use um fluxo automatizado com o bloco Chamar outro sistema — veja Da TAI para o seu sistema. Para avisar só as decisões de um fluxo, filtre no seu sistema por pipeId, ou use uma automação do próprio fluxo (gatilho Entrada na Fase da fase seguinte), que aceita condições sobre os campos do card.
Aprovação de documento. Uma fase de aprovação pode abrir sozinha a aprovação no GED dos arquivos do card; a decisão no GED aprova ou reprova o card. Veja Aprovação e assinatura de documentos.

Pelo seu agente de IA

“Quais solicitações esperam a minha aprovação?”

É leitura e funciona pelo MCP. Aprovar e reprovar são ações de confirmação forte: nenhum agente externo as executa, com nenhuma credencial. A decisão se toma na plataforma ou pela Tali, com prévia e confirmação — veja Escrita e segurança.

Cuidados

Só os aprovadores decidem. Nem o administrador nem o dono da conta aprovam no lugar deles: 403 — “Apenas os aprovadores desta fase podem aprovar/reprovar”.
A decisão é de quem chama. Uma aprovação feita pela API fica registrada no nome do usuário do token. Repassar decisões de outra ferramenta com um único usuário de integração faz dele o aprovador de tudo; para uma trilha de auditoria por pessoa, cada aprovador decide com a própria credencial, ou o nome de quem decidiu vai na observacao.
Fase sem aprovador trava o card: 400 — “Fase de aprovação sem aprovador configurado”.
Nada tira o card da fase sem aprovação — nem o mover da API, nem a ação Mover para Fase de uma automação: 400 até a decisão APROVADO.
Automação com o aviso amarelo “segue as regras de quando foi criada” não dispara por Aprovação Pendente: abra-a e salve de novo.

Referência gerada do contrato da API em 30 de outubro de 2026. taitecnologia.com · Termos de uso · Privacidade