{ "chave": "aprovacao-desconto-avisos", "nome": "Aprovação de desconto", "descricao": "Avisa quem aprova descontos, cuida da fila de aprovação e fecha o ciclo quando o desconto é decidido.", "versao": "3.7", "escopo": "por-tenant", "roles": [ { "nome": "botfn-desconto-aprovacao", "grants": [ "notificacao:emitir_ui", "tarefas:criar", "desconto:aprovar", "venda:cancel", "venda:read", "cliente:read:full", "usuario:read_nome", "notificacao:enviar", "tarefas:listar", "tarefas:mover" ] } ], "agentes": [ { "chave": "desconto_requer_aprovacao_aviso", "descricao": "Avisa quem aprova quando uma venda pede um desconto que precisa de aprovação.", "tipo": "script", "roles": [ "botfn-desconto-aprovacao" ], "triggers": [ { "event_type": "vendas.desconto_requer_aprovacao", "enabled": true } ], "config": { "script": "// Formata número em reais (18844.0 -> 18.844,00).\nfunction brl(v){ if(v===undefined||v===null||v==='') return '?';\n var n=Number(v); if(isNaN(n)) return String(v);\n var neg=n<0; n=Math.abs(n); var s=n.toFixed(2); var pp=s.split('.'); var ip=pp[0], dc=pp[1];\n var out='', c=0; for(var i=ip.length-1;i>=0;i--){ out=ip.charAt(i)+out; c++; if(c%3===0&&i>0) out='.'+out; }\n return (neg?'-':'')+out+','+dc; }\n// Avisa quem aprova, com paciente, valores, quem pediu e os itens da venda.\nvar subject = event.subject || {};\nvar safe = event.payload_safe || {};\nvar vendaId = subject.venda_id || subject.id;\nvar clienteId = subject.cliente_id;\nvar solicitante = subject.user_id;\nvar numero = safe.numero || vendaId || '?';\nvar pct = safe.desconto_percentual;\nvar valorTotal = safe.valor_total;\nvar alvoRole = config.alvo_role || 'administrador';\nvar basePath = config.base_path || '/financeiro/aprovacoes-desconto';\n\n// Venda: itens e valor do desconto.\nvar descontoValor = null;\nvar itens = [];\nif (vendaId) {\n var rv = call('buscar_venda', { venda_id: String(vendaId) });\n if (rv && rv.ok !== false && rv.body) {\n var venda = rv.body.data || rv.body;\n descontoValor = venda.desconto_valor;\n if (venda.valor_total !== undefined && venda.valor_total !== null) { valorTotal = venda.valor_total; }\n itens = venda.itens || [];\n } else { log('notificador: buscar_venda falhou (segue sem itens)'); }\n}\n\n// Paciente: sem acesso, o aviso sai sem o nome.\nvar paciente = null;\nif (clienteId) {\n var rc = call('buscar_cliente', { cliente_id: String(clienteId) });\n if (rc && rc.ok !== false && rc.body) {\n var cli = rc.body.data || rc.body;\n paciente = cli.nome;\n } else { log('notificador: buscar_cliente sem acesso (aviso sem nome do paciente)'); }\n}\n\n// Quem pediu: sem nome, mostra o próprio id.\nvar solicitanteNome = null;\nif (solicitante) {\n var ru = call('buscar_usuario', { user_id: String(solicitante) });\n if (ru && ru.ok !== false && ru.body) {\n var usr = ru.body.data || ru.body;\n solicitanteNome = usr.nome || usr.username || (usr.profissional && usr.profissional.nome) || null;\n } else { log('notificador: buscar_usuario falhou (solicitante sem nome)'); }\n}\n\nvar linhas = [];\nif (paciente) { linhas.push('**Paciente:** ' + paciente); }\nif (valorTotal !== undefined && valorTotal !== null) { linhas.push('**Total:** R$ ' + brl(valorTotal)); }\nvar descLinha = '**Desconto:** ' + ((pct !== undefined && pct !== null) ? (pct + '%') : '?');\nif (descontoValor !== undefined && descontoValor !== null) { descLinha = descLinha + ' (R$ ' + brl(descontoValor) + ')'; }\nlinhas.push(descLinha);\nif (solicitante) { linhas.push('**Solicitado por:** ' + (solicitanteNome || solicitante)); }\nif (itens && itens.length > 0) {\n linhas.push('');\n linhas.push('**Itens (' + itens.length + '):**');\n var max = (itens.length > 5) ? 5 : itens.length;\n for (var i = 0; i < max; i++) {\n var it = itens[i];\n var nomeItem = it.procedimento_nome || it.produto_nome || it.pacote_nome || 'Item';\n var q = it.quantidade || 1;\n linhas.push('- ' + q + 'x ' + nomeItem);\n }\n if (itens.length > max) { linhas.push('- _(+ ' + (itens.length - max) + ' item(ns))_'); }\n}\nvar corpo = 'A venda **' + numero + '** tem um desconto aguardando a sua aprovação.\\n\\n' + linhas.join('\\n');\n\n// Os botões levam a venda e o %: o clique só vale para este desconto.\n// Sem o %, o aviso sai só com o link para a tela de aprovações.\nvar botoes = [];\nif (vendaId && pct !== undefined && pct !== null) {\n var refs = { venda_id: String(vendaId), desconto_percentual: String(pct) };\n // Quem clica precisa ter a permissão que o vendas exige para decidir (desconto:aprovar),\n // e só o vendas usa o recibo do clique. Sem isso o aviso é recusado.\n var perm = 'desconto:aprovar';\n botoes.push({ label: 'Aprovar', estilo: 'primary', required_permission: perm, acao: { tipo: 'evento', event_type: 'desconto.aprovar', payload: refs, destino: 'vendas' } });\n botoes.push({ label: 'Rejeitar', estilo: 'danger', required_permission: perm, acao: { tipo: 'evento', event_type: 'desconto.rejeitar', payload: refs, destino: 'vendas' } });\n}\nbotoes.push({ label: 'Abrir aprovações', estilo: 'secondary', acao: { tipo: 'link', href: basePath } });\n\nvar r = call('emitir_ui', { type: 'diretiva_ui', ref: (vendaId ? ('venda:' + String(vendaId)) : undefined), kind: 'modal', titulo: 'Desconto aguardando aprovação', corpo: corpo, botoes: botoes, alvo: { role: alvoRole }, persistencia: 'persistente' });\nif (r && r.ok === false) { log('notificador: emitir_ui falhou HTTP ' + r.status_code); return { erro: 'emitir_ui', status: r.status_code }; }\nlog('notificador: aviso p/ role=' + alvoRole + ' (venda ' + numero + ', paciente=' + (paciente ? 'sim' : 'não') + ', itens=' + itens.length + ')');\nreturn { emitido: true, venda_id: vendaId ? String(vendaId) : null, itens: itens.length };\n", "alvo_role": "{{knob.alvo_role}}", "base_path": "/financeiro/aprovacoes-desconto", "acoes": [ { "nome": "emitir_ui", "capability": "notificacao.emitir_ui" }, { "nome": "buscar_venda", "capability": "vendas.buscar_venda" }, { "nome": "buscar_cliente", "capability": "clientes.buscar_cliente" }, { "nome": "buscar_usuario", "capability": "estabelecimento.buscar_usuario" } ] } }, { "chave": "desconto_classificador", "descricao": "Cria a tarefa de aprovação do desconto com a prioridade pela faixa de valor.", "tipo": "script", "roles": [ "botfn-desconto-aprovacao" ], "triggers": [ { "event_type": "vendas.desconto_requer_aprovacao", "enabled": true } ], "config": { "script": "// Abre a tarefa de aprovação, com a prioridade pela faixa do desconto.\nvar subject = event.subject || {};\nvar safe = event.payload_safe || {};\nvar vendaId = subject.venda_id || subject.id;\nif (!vendaId) { log('classificador: sem venda_id'); return { skip: 'sem_venda_id' }; }\nvendaId = String(vendaId);\nvar numero = safe.numero || vendaId;\nvar pct = Number(safe.desconto_percentual || 0);\nvar limAlta = Number(config.faixa_alta_pct || 20);\nvar limMedia = Number(config.faixa_media_pct || 10);\nvar prioridade = 'baixa';\nif (pct >= limAlta) { prioridade = 'alta'; } else if (pct >= limMedia) { prioridade = 'media'; }\n\nvar r = call('criar_tarefa', {\n titulo: 'Aprovar desconto de ' + pct + '% na venda ' + numero,\n descricao: 'Desconto acima do teto aguardando aprovação. Abra a fila de aprovações de desconto para decidir.',\n prioridade: prioridade,\n vinculos: [{ tipo: 'venda', ref_id: vendaId }]\n});\nif (r && r.ok === false) { log('classificador: criar_tarefa falhou HTTP ' + r.status_code); return { erro: 'criar_tarefa', status: r.status_code }; }\nlog('classificador: tarefa criada (venda ' + numero + ' prioridade ' + prioridade + ')');\nreturn { tarefa: true, venda_id: vendaId, prioridade: prioridade };\n", "faixa_media_pct": "{{knob.faixa_media_pct}}", "faixa_alta_pct": "{{knob.faixa_alta_pct}}", "acoes": [ { "nome": "criar_tarefa", "capability": "tarefas.criar" } ] } }, { "chave": "desconto_executor", "descricao": "Aprova ou recusa o desconto em nome de quem clicou no aviso.", "tipo": "script", "roles": [ "botfn-desconto-aprovacao" ], "triggers": [ { "event_type": "notificacao.diretiva_respondida", "enabled": true } ], "config": { "script": "// Aprova ou recusa o desconto em nome de quem clicou no aviso.\n// Sem saber quem clicou, sem o recibo do clique ou sem quem emitiu o aviso, não decide.\n// O recibo do clique vale uma vez só, e só para esta venda e este %.\nvar safe = event.payload_safe || {};\nvar subject = event.subject || {};\nvar intent = safe.intent || '';\nif (intent !== 'desconto.aprovar' && intent !== 'desconto.rejeitar') { return { skip: 'intent_alheio' }; }\nvar vendaId = subject.venda_id;\nif (!vendaId) { log('executor: sem venda_id'); return { skip: 'sem_venda_id' }; }\nvendaId = String(vendaId);\nvar autorizadoPor = subject.autorizado_por;\nif (!autorizadoPor) { log('executor: sem quem clicou (venda ' + vendaId + '), não decide', 'warning'); return { skip: 'sem_autorizado_por', venda_id: vendaId }; }\nvar reciboId = subject.recibo_id;\nif (!reciboId) { log('executor: sem recibo do clique (venda ' + vendaId + '), não decide', 'warning'); return { skip: 'sem_recibo', venda_id: vendaId }; }\nif (!subject.emitida_por) { log('executor: aviso sem emissor (venda ' + vendaId + '), não decide', 'warning'); return { skip: 'sem_emitida_por', venda_id: vendaId }; }\nvar acao = (intent === 'desconto.aprovar') ? 'aprovar_desconto' : 'rejeitar_desconto';\nvar payload = { venda_id: vendaId, em_nome_de: String(autorizadoPor) };\nif (intent === 'desconto.rejeitar') { payload.motivo = 'Rejeitado pelo gestor pelo aviso.'; }\nvar r = call(acao, payload, { recibo: String(reciboId) });\nif (r && r.ok === false) { log('executor: ' + acao + ' falhou HTTP ' + r.status_code); return { erro: acao, status: r.status_code }; }\nlog('executor: ' + acao + ' ok (venda ' + vendaId + ', em nome de quem clicou)');\nreturn { executado: acao, venda_id: vendaId };\n", "acoes": [ { "nome": "aprovar_desconto", "capability": "vendas.aprovar_desconto" }, { "nome": "rejeitar_desconto", "capability": "vendas.rejeitar_desconto" } ] } }, { "chave": "desconto_remediador", "descricao": "Quando o desconto é recusado, faz o que a clínica configurou para esse caso.", "tipo": "script", "roles": [ "botfn-desconto-aprovacao" ], "triggers": [ { "event_type": "vendas.desconto_rejeitado", "enabled": true } ], "config": { "script": "// Desconto recusado: faz o que a clínica configurou (manter ou cancelar a venda).\nvar subject = event.subject || {};\nvar vendaId = subject.venda_id || subject.id;\nif (!vendaId) { return { skip: 'sem_venda_id' }; }\nvendaId = String(vendaId);\nvar acaoConfig = config.acao_rejeicao || 'manter';\nif (acaoConfig === 'manter') { log('remediador: manter (venda ' + vendaId + '), desconto de volta ao teto'); return { acao: 'manter', venda_id: vendaId }; }\nif (acaoConfig === 'cancelar') {\n var r = call('cancelar', { venda_id: vendaId, motivo: 'Desconto recusado (política da clínica: cancelar).' });\n if (r && r.ok === false) { log('remediador: cancelar falhou HTTP ' + r.status_code); return { erro: 'cancelar', status: r.status_code }; }\n log('remediador: venda ' + vendaId + ' cancelada (desconto recusado)');\n return { acao: 'cancelar', venda_id: vendaId };\n}\nreturn { acao: acaoConfig, venda_id: vendaId, skip: 'acao_desconhecida' };\n", "acao_rejeicao": "{{knob.acao_rejeicao}}", "acoes": [ { "nome": "cancelar", "capability": "vendas.cancelar" } ] } }, { "chave": "desconto_fechador", "descricao": "Quando o desconto é decidido, fecha o aviso para toda a equipe, avisa quem decidiu e conclui a tarefa de aprovação. Se a venda for cancelada com o desconto pendente, fecha o aviso e a tarefa.", "tipo": "script", "roles": [ "botfn-desconto-aprovacao" ], "triggers": [ { "event_type": "vendas.desconto_aprovado", "enabled": true }, { "event_type": "vendas.desconto_rejeitado", "enabled": true }, { "event_type": "vendas.venda_cancelada", "enabled": true } ], "config": { "acoes": [ { "nome": "dismiss_diretiva", "capability": "notificacao.dismiss_diretiva" }, { "nome": "buscar_venda", "capability": "vendas.buscar_venda" }, { "nome": "buscar_usuario", "capability": "estabelecimento.buscar_usuario" }, { "nome": "notificar_grupo", "capability": "notificacao.notificar_grupo" }, { "nome": "listar_tarefas_vinculo", "capability": "tarefas.listar_por_vinculo" }, { "nome": "mudar_estado", "capability": "tarefas.mudar_estado" } ], "alvo_role": "{{knob.alvo_role}}", "script": "// Fecha o ciclo do desconto:\n// - decidido (aprovado ou recusado): fecha o aviso daquela venda para toda a equipe,\n// avisa quem decidiu e conclui a tarefa de aprovação;\n// - venda cancelada com o desconto ainda pendente: fecha o aviso e conclui a tarefa,\n// sem aviso de decisão.\n// Cada passo segue mesmo se outro falhar.\nvar subject = event.subject || {};\nvar safe = event.payload_safe || {};\nvar et = event.event_type ? String(event.event_type) : '';\nvar vendaId = subject.venda_id || subject.id;\nif (!vendaId) { return { skip: 'sem_venda_id' }; }\nvendaId = String(vendaId);\nvar cancelada = (et === 'vendas.venda_cancelada');\nvar aprovado = (et === 'vendas.desconto_aprovado');\nvar alvoRole = config.alvo_role || 'administrador';\nvar out = { venda_id: vendaId, dispensado: false, avisado: false, tarefas_concluidas: 0 };\n\n// Venda cancelada: só age se o desconto ainda aguardava aprovação.\nif (cancelada) {\n out.cancelada = true;\n var rv = call('buscar_venda', { venda_id: vendaId });\n if (!rv || rv.ok === false || !rv.body) {\n log('fechador: venda ' + vendaId + ' cancelada, mas não deu para ler o desconto (nada feito)');\n return { skip: 'venda_indisponivel', venda_id: vendaId, cancelada: true };\n }\n var venda = rv.body.data || rv.body;\n if (venda.desconto_aprovacao !== 'pendente') {\n return { skip: 'sem_desconto_pendente', venda_id: vendaId, cancelada: true };\n }\n}\n\n// Fecha o aviso daquela venda (e só dela) para toda a equipe.\nvar r = call('dismiss_diretiva', { ref: 'venda:' + vendaId });\nif (r && r.ok === false) { log('fechador: dismiss falhou HTTP ' + r.status_code); out.erro_dismiss = r.status_code || 'falha'; }\nelse { out.dispensado = true; log('fechador: aviso da venda ' + vendaId + ' fechado para todos'); }\n\n// Avisa o mesmo papel quem decidiu.\nif (!cancelada) {\n var decisor = aprovado ? (safe.aprovado_por || subject.user_id) : (safe.rejeitado_por || subject.user_id);\n var nome = null;\n if (decisor) {\n var ru = call('buscar_usuario', { user_id: String(decisor) });\n if (ru && ru.ok !== false && ru.body) {\n var usr = ru.body.data || ru.body;\n nome = usr.nome || usr.username || (usr.profissional && usr.profissional.nome) || null;\n } else { log('fechador: buscar_usuario falhou (aviso sem nome)'); }\n }\n if (!nome) { nome = 'alguém da equipe'; }\n\n var pctTxt = function (v) {\n if (v === undefined || v === null || v === '') { return null; }\n var n = Number(v); if (isNaN(n)) { return null; }\n var s = (Math.round(n * 100) / 100).toString();\n return s.replace('.', ',') + '%';\n };\n var pct = pctTxt(aprovado ? safe.desconto_percentual : safe.desconto_percentual_anterior);\n var numero = safe.numero ? String(safe.numero) : null;\n var texto = 'Desconto';\n if (pct) { texto = texto + ' de ' + pct; }\n if (numero) { texto = texto + ' da venda ' + numero; }\n texto = texto + (aprovado ? ' aprovado por ' : ' recusado por ') + nome;\n var message = { type: 'info', title: aprovado ? 'Desconto aprovado' : 'Desconto recusado', text: texto, icon: aprovado ? 'mdi-check-circle' : 'mdi-close-circle' };\n var rn = call('notificar_grupo', { type: 'mensagem', message: message, group_id: String(alvoRole) });\n if (rn && rn.ok === false) { log('fechador: notificar_grupo falhou HTTP ' + rn.status_code); out.erro_aviso = rn.status_code || 'falha'; }\n else { out.avisado = true; log('fechador: aviso de decisão p/ role=' + alvoRole + ' (venda ' + (numero || vendaId) + ')'); }\n}\n\n// Conclui a tarefa de aprovação desta venda aberta pelo time\n// (\"Aprovar desconto de ...% na venda ...\"); só as abertas, nunca outras tarefas da venda.\nfunction eDoTime(t) {\n if (!t || t.estado === 'done' || t.arquivada_em) { return false; }\n var titulo = String(t.titulo || '');\n if (titulo.indexOf('Aprovar desconto de ') !== 0 || titulo.indexOf('% na venda ') < 0) { return false; }\n var vs = t.vinculos || [];\n for (var i = 0; i < vs.length; i++) {\n if (vs[i] && vs[i].tipo === 'venda' && String(vs[i].ref_id) === vendaId) { return true; }\n }\n return false;\n}\nvar rl = call('listar_tarefas_vinculo', { vinculo_tipo: 'venda', vinculo_ref_id: vendaId });\nif (rl && rl.ok !== false && rl.body) {\n var corpo = rl.body.data || rl.body;\n var items = corpo.items || [];\n for (var j = 0; j < items.length; j++) {\n var t = items[j];\n if (!eDoTime(t)) { continue; }\n var rm = call('mudar_estado', { id: String(t.id), estado: 'done' });\n if (rm && rm.ok === false) { log('fechador: concluir tarefa falhou HTTP ' + rm.status_code); out.erro_tarefa = rm.status_code || 'falha'; }\n else { out.tarefas_concluidas = out.tarefas_concluidas + 1; }\n }\n log('fechador: ' + out.tarefas_concluidas + ' tarefa(s) de aprovação concluída(s) (venda ' + vendaId + ')');\n} else { log('fechador: listar tarefas falhou' + (rl ? (' HTTP ' + rl.status_code) : '')); out.erro_listar = (rl && rl.status_code) ? rl.status_code : 'falha'; }\n\nreturn out;\n" } } ], "knobs": [ { "chave": "alvo_role", "tipo": "string", "valor": "administrador", "descricao": "Papel que recebe o aviso/popup, aprova e é avisado de quem decidiu. Deve ter desconto:aprovar." }, { "chave": "faixa_media_pct", "tipo": "int", "valor": 10, "descricao": "A partir deste % a tarefa de aprovação nasce com prioridade média." }, { "chave": "faixa_alta_pct", "tipo": "int", "valor": 20, "descricao": "A partir deste % a tarefa nasce com prioridade alta." }, { "chave": "acao_rejeicao", "tipo": "string", "valor": "manter", "descricao": "O que fazer quando o desconto é recusado: 'manter' (a venda segue, com o desconto de volta ao teto) ou 'cancelar' a venda." } ] }