claude-plugins/crm-ops/skills/orcamento/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
orcamento	Criação sistemática de orçamentos Descomplicar baseados nos itens oficiais do Desk CRM. Suporta StarterWP, CorporateWP, CareWP, eCommerceWP, Marketing 360, Manutenção, AcceleratorX, DeskCRM e Chatbots. Variantes -MEN (mensal) e -TRI (trimestral).	true

Skill /orcamento - Criacao Sistematica de Orcamentos

Skill para criar orcamentos profissionais baseados nos itens oficiais do Desk CRM, com integracao directa ao CRM.

Fonte de Verdade

IMPORTANTE: A fonte de verdade para precos e servicos e o Desk CRM (tblitems + tblitems_groups).

• 651 itens em 14 grupos: Websites, DeskCRM, Licencas, Tecnologia, Servicos, Chatbots, Marketing, Suporte, Comunicacao, Design, Estrategia, Mobile, IA, Alojamento
• Cada servico pode ter variantes de facturacao: Investimento, Anuidade, Trimestral, Mensalidade
• Os precos no CRM sao actualizados pela equipa e reflectem-se automaticamente nos orcamentos

Grupos de Itens (tblitems_groups)

ID	Grupo	Total Itens	Tipo Principal
1	Websites	183	Pacotes WP + funcionalidades + anuidades
14	DeskCRM	127	Pacotes CRM + modulos
8	Licencas	108	Plugins WP + renovacoes
3	Tecnologia	63	AcceleratorX + WhatSMS
2	Servicos	62	Packs de horas
13	Chatbots	46	Chatbots + integracoes
4	Marketing	34	Packs SEO, Email, Ads
9	Suporte	8	Bancos de horas
5	Comunicacao	5	Packs copywriting
6	Design	5	Branding
7	Estrategia	5	Consultoria, coaching
10	Mobile	3	App React Native
12	IA	2	Agentes virtuais
11	Alojamento Web	—	Incluido nos websites

Como Consultar Itens

# Listar itens por grupo
mcp__desk-crm-v3__price_management action="get_pricing_insights" params={"group": "Websites"}

# Pesquisar item especifico via SQL (ssh server)
mysql -u root ealmeida_desk24 -e "
  SELECT i.description, i.rate, i.unit, g.name as grupo
  FROM tblitems i
  JOIN tblitems_groups g ON i.group_id = g.id
  WHERE i.description LIKE '%StarterWP%'
  ORDER BY i.description;"

# Listar todos os itens de um grupo (ex: grupo 1 = Websites)
mysql -u root ealmeida_desk24 -e "
  SELECT i.description, i.rate, i.unit
  FROM tblitems i
  WHERE i.group_id = 1
  AND i.unit NOT IN ('mensalidade','trimestral','anuidade')
  ORDER BY i.description;"

Variantes de Facturacao

Cada servico recorrente tem 4 variantes no CRM. Por defeito, o estimate usa o item base. Com os flags -MEN ou -TRI, os itens recorrentes sao incluidos directamente na variante pretendida.

Tipo	Sufixo no CRM	Flag	Quando usar
Investimento/Projeto	(sem sufixo)	(nenhum)	Projectos unicos
Anuidade	"Anuidade ..."	(nenhum)	Servicos com renovacao anual
Trimestral	"Trimestral ..."	-TRI	Cliente quer facturacao trimestral
Mensalidade	"Mensalidade ..."	-MEN	Cliente quer facturacao mensal

Regra por defeito (sem flag): No estimate, incluir o item base. Ao converter para invoice, seleccionar a variante de facturacao acordada.

Regra com flag -MEN ou -TRI: Pesquisar itens recorrentes pela variante correspondente (prefixo "Mensalidade ..." ou "Trimestral ..."). Itens pontuais (setup, configuracao) mantêm-se inalterados. Apenas itens com unit "anuidade" sao substituidos pela variante equivalente.

Mapeamento de Variantes

Ao usar -MEN ou -TRI, para cada item recorrente (unit = "anuidade"):

1. Pesquisar no CRM o item equivalente com o prefixo da variante:
   • -MEN: WHERE description LIKE 'Mensalidade %' AND description LIKE '%[NOME_ITEM]%'
   • -TRI: WHERE description LIKE 'Trimestral %' AND description LIKE '%[NOME_ITEM]%'
2. Se encontrado, usar o preco e unit da variante
3. Se nao encontrado, manter item base e avisar o utilizador

Calculo de valores com variantes:

Flag	Unit no estimate	Qty	Calculo
(nenhum)	ano	1	Valor anual
-TRI	trimestral	1	Valor trimestral (tipicamente anuidade / 4 * 1.05-1.10)
-MEN	mensalidade	1	Valor mensal (tipicamente anuidade / 12 * 1.10-1.15)

Nota: Os precos das variantes sao definidos no CRM e podem incluir markup sobre o valor anual. Consultar SEMPRE o CRM, nunca calcular por divisao simples.

Quando Usar

• Criar orcamento para cliente novo ou existente
• Gerar proposta comercial (estimate)
• Consultar precos oficiais de produtos/servicos
• Calcular valores com IVA e anuidades
• Integrar orcamento directamente no CRM

Quando NAO Usar

• Para analise estrategica de lead (usar /lead-approach)
• Para operacoes CRM genericas (usar /crm-ops)

---

Contexto NotebookLM

ANTES de executar, consultar notebooks para contexto especializado:

Notebook	ID	Consultar quando
Estratégia e Empreendedorismo	79d43410	Para enquadramento estratégico de preços

mcp__notebooklm__notebook_query({
  notebook_id: "79d43410-0e29-4be1-881d-84db6bdc239a",
  query: "<adaptar ao contexto do pedido do utilizador>"
})

Integrar insights do NotebookLM nas recomendações e decisões.

Procedimentos Relacionados

• PROC-Catalogo-Codificacao-Produtos.md — Codificação e catálogo de produtos
• PROC-CRM-Operacoes.md — Operações CRM padrão

---

Protocolo

Sintaxe

/orcamento [cliente] [tipo] [-MEN|-TRI]

Parametros:

• cliente - Nome ou ID do cliente (opcional, sera solicitado se omitido)
• tipo - Tipo de orcamento (opcional, sera apresentado menu se omitido)
• -MEN - Variante mensal: usa itens com unit "mensalidade" e calcula valor/mes
• -TRI - Variante trimestral: usa itens com unit "trimestral" e calcula valor/trimestre
• (sem flag) - Comportamento actual: item base (Investimento/Projeto/Anual)

Tipos disponiveis:

Codigo	Tipo	Grupo CRM
starter	StarterWP	Websites
corporate	CorporateWP	Websites
care	CareWP (Clinicas)	Websites
ecom	eCommerceWP	Websites
mkt	Marketing Digital 360	Marketing
man	Manutencao	Suporte
deskcrm	DeskCRM	DeskCRM
chatbot	Chatbot	Chatbots
acceleratorx	AcceleratorX	Tecnologia

Fase 1: Identificacao do Cliente

1. Se cliente fornecido, pesquisar no CRM:

   mcp__desk-crm-v3__search_customers query="[nome]" fields="company,vat"
   

2. Se nao encontrado ou nao fornecido, solicitar dados:

   • Nome da empresa
   • NIF (opcional)
   • Email contacto

3. Validar cliente existe ou criar novo:

   mcp__desk-crm-v3__create_customer company="..." vat="..." ...
   

Fase 2: Seleccao de Template

1. Se tipo fornecido, carregar template correspondente
2. Se nao fornecido, apresentar menu interactivo:
   • StarterWP | CorporateWP | CareWP | eCommerceWP
   • Marketing 360 | Manutencao
   • DeskCRM | Chatbot | AcceleratorX

Fase 3: Consultar Precos no CRM

OBRIGATORIO: Consultar precos actualizados no Desk CRM antes de calcular.

Sem variante (comportamento actual)

# Buscar preco do pacote base
mysql -u root ealmeida_desk24 -e "
  SELECT description, rate, unit FROM tblitems
  WHERE group_id = [GROUP_ID]
  AND description LIKE '%[PACOTE]%'
  AND unit NOT IN ('mensalidade','trimestral','anuidade')
  ORDER BY description;"

Com -MEN (variante mensal)

# Buscar itens base (setup/pontuais - mantêm-se iguais)
mysql -u root ealmeida_desk24 -e "
  SELECT description, rate, unit FROM tblitems
  WHERE group_id = [GROUP_ID]
  AND description LIKE '%[PACOTE]%'
  AND unit NOT IN ('mensalidade','trimestral','anuidade')
  ORDER BY description;"

# Buscar itens recorrentes na variante mensal
mysql -u root ealmeida_desk24 -e "
  SELECT description, rate, unit FROM tblitems
  WHERE group_id = [GROUP_ID]
  AND description LIKE 'Mensalidade%[PACOTE]%'
  ORDER BY description;"

Com -TRI (variante trimestral)

# Buscar itens base (setup/pontuais - mantêm-se iguais)
mysql -u root ealmeida_desk24 -e "
  SELECT description, rate, unit FROM tblitems
  WHERE group_id = [GROUP_ID]
  AND description LIKE '%[PACOTE]%'
  AND unit NOT IN ('mensalidade','trimestral','anuidade')
  ORDER BY description;"

# Buscar itens recorrentes na variante trimestral
mysql -u root ealmeida_desk24 -e "
  SELECT description, rate, unit FROM tblitems
  WHERE group_id = [GROUP_ID]
  AND description LIKE 'Trimestral%[PACOTE]%'
  ORDER BY description;"

Ou via MCP:

mcp__desk-crm-v3__price_management action="get_pricing_insights" params={"group": "[GRUPO]", "search": "[PACOTE]"}

Fase 4: Personalizacao

1. Apresentar questoes de personalizacao especificas do tipo
2. Adicionar funcionalidades conforme requisitos
3. Para cada funcionalidade, buscar item correspondente no CRM

Fase 5: Geracao do Orcamento

1. Calcular valores finais:

   • Subtotal por item (precos do CRM)
   • IVA 23%
   • Total
   • Recorrencia (anuidade, trimestral ou mensal conforme variante)

2. Ajustar items conforme variante:

   • Sem flag: Itens base + anuidade separada
   • -MEN: Itens setup + itens "Mensalidade ..." do CRM (unit: "mensalidade")
   • -TRI: Itens setup + itens "Trimestral ..." do CRM (unit: "trimestral")

3. Criar estimate no CRM:

   mcp__desk-crm-v3__create_estimate
     client_id=[id]
     date=[hoje]
     expiry_date=[hoje + 30 dias]
     items=[items calculados]
     terms="[termos ajustados a variante]"
   

4. Termos ajustados por variante:

   • Sem flag: "Condicoes de Pagamento: 50% na adjudicacao + 50% na entrega"
   • -MEN: "Condicoes de Pagamento: Setup - 50% na adjudicacao + 50% na entrega | Recorrencia - facturacao mensal antecipada"
   • -TRI: "Condicoes de Pagamento: Setup - 50% na adjudicacao + 50% na entrega | Recorrencia - facturacao trimestral antecipada"

5. Apresentar resumo ao utilizador com link para CRM

Pacotes Principais (referencia rapida)

Nota: Estes valores sao referencia. Consultar SEMPRE o CRM para precos actualizados.

Websites

Produto	Setup	Anuidade	Prazo
StarterWP	700	250	3-5 sem
CorporateWP	900	299	4-6 sem
eCommerceWP	1100	349	7-9 sem
ChallengeWP	700	250	8-10 sem
CareWP	1300	350	4-6 sem

DeskCRM

Produto	Setup	Anuidade
DeskCRM Starter	(ver CRM)	400
DeskCRM Profissional	(ver CRM)	800
DeskCRM Avancado	(ver CRM)	1500
DeskCRM Enterprise	(ver CRM)	3000

AcceleratorX

Produto	Setup
WP ProCMS	650
e-Commerce	750
Membership	450
Booking	450
Care	750
Meet	650
School Manager	850

Chatbots

Produto	Setup
Chatbot Basico	350
Chatbot Avancado	850
Chatbot Care	850

Design/Branding

Produto	Valor
Branding WOW Digital	400
Branding WOW Essencial	850
Branding Completo	1100
Pack Rebranding	1500
Pack Premium 360	5000

Estrutura de Items para API

Cada item do orcamento segue o formato:

{
  "description": "Descricao do servico",
  "qty": 1,
  "rate": 700,
  "unit": "un"
}

Unidades:

• un - Unidade (projecto/item unico)
• mes ou mensalidade - Mes (servico recorrente mensal, usado com -MEN)
• trimestral - Trimestre (servico recorrente trimestral, usado com -TRI)
• ano ou anuidade - Ano (anuidade, comportamento por defeito)

Termos e Condicoes Padrao

CONDICOES DE PAGAMENTO

1. Projectos: 50% na adjudicacao + 50% na entrega
2. Servicos recorrentes: facturacao mensal antecipada

VALIDADE

Orcamento valido por 30 dias a partir da data de emissao.

ANUIDADE

A anuidade inclui:
- Alojamento Premium SSD NVMe
- Certificado SSL
- Actualizacoes de seguranca
- Suporte tecnico basico

Descomplicar Crescimento Digital
NIF: 514 623 168 | descomplicar.pt

Checklist de Execucao

• Cliente identificado/criado no CRM
• Tipo de orcamento seleccionado
• Precos consultados no CRM (tblitems)
• Funcionalidades adicionais identificadas
• Valores calculados (subtotal + IVA)
• Recorrencia calculada (anuidade/trimestral/mensal conforme variante)
• Estimate criado no CRM (status: Draft)
• Resumo apresentado ao utilizador

MCPs Utilizados

mcp__desk-crm-v3__search_customers  - Pesquisar cliente
mcp__desk-crm-v3__get_customer      - Obter detalhes cliente
mcp__desk-crm-v3__create_customer   - Criar cliente novo
mcp__desk-crm-v3__create_estimate   - Criar orcamento
mcp__desk-crm-v3__get_estimates     - Listar orcamentos existentes
mcp__desk-crm-v3__price_management  - Consultar precos e itens

Formulas de Calculo

Website Simples

Total = Base + Funcionalidades + Conteudos
Anuidade = Anuidade_Base + Anuidades_Funcionalidades

Exemplo: Website Corporativo com Agendamento (sem variante)

CorporateWP:           900 (item CRM: "CorporateWP")
EasyAppointment:       175 (item CRM: "EasyAppointment")
Chat da Pagina:         50 (item CRM: "Chat da Pagina")
Pixel + GTM:            50 (items CRM: "Configuracao Pixel Facebook" + "Configuracao GTM")
---------------------------------
Subtotal:              1175
IVA 23%:               270.25
TOTAL:                 1445.25

Anuidade:              299 + 50 + 50 = 399 (items CRM com unit "anuidade")

Exemplo: Mesmo orcamento com -MEN

SETUP (pagamento unico):
CorporateWP:           900
EasyAppointment:       175
Chat da Pagina:         50
Pixel + GTM:            50
---------------------------------
Subtotal Setup:        1175
IVA 23%:               270.25
TOTAL Setup:           1445.25

RECORRENCIA MENSAL (items CRM com prefixo "Mensalidade"):
Mensalidade CorporateWP:    29.90 (item CRM: "Mensalidade CorporateWP")
Mensalidade EasyAppointment:  5.90 (item CRM: "Mensalidade EasyAppointment")
Mensalidade Chat da Pagina:   4.90 (item CRM: "Mensalidade Chat da Pagina")
---------------------------------
Subtotal Mensal:        40.70
IVA 23%:                 9.36
TOTAL Mensal:           50.06/mes

Nota: precos mensais sao exemplificativos - consultar CRM para valores reais.

Referencias

• references/pricing-guide.md - Tabela de precos rapida (referencia, nao fonte de verdade)
• templates/website-corporativo.md - Templates StarterWP, CorporateWP, CareWP
• templates/e-commerce.md - Template eCommerceWP
• templates/marketing-digital.md - Template Marketing 360
• templates/manutencao.md - Template Manutencao

---

Datasets Dify (Consulta Complementar)

Dataset	ID	Prioridade
Servicos Descomplicar	bd65f36e-6004-4584-b478-129b2c21b4d2	1
Vendas	a7ba6005-517c-41ab-ac5e-da1c1a1c62ef	1
Marketing Digital	c1ec779f-4cb1-4ecf-ba11-6b39b93d4e24	2
Desenvolvimento de WebSites	c8489151-de94-42b2-8cee-c0b961cfac6d	2

Quando Consultar

• Justificar precos ao cliente
• Comparar funcionalidades entre pacotes
• Criar proposta de valor diferenciada
• Tecnicas de negociacao e fechamento

---

Instrumentacao Automatica

Baseline

Metrica	Valor
Tempo baseline	30 min
Tempo target	15 min
Melhoria esperada	-50%

Query para Gravar (executar no final da skill)

INSERT INTO tblskill_agent_metrics (
  type, name, duration_ms, status, staff_id,
  kb_consulted, kb_cache_hit, tool_calls, project_id
) VALUES (
  'skill', '/orcamento', {DURACAO_MS}, '{STATUS}', 25,
  {KB_CONSULTADO}, {CACHE_HIT}, {TOOL_CALLS}, {PROJECT_ID}
);

---

Changelog

v4.1.0 (2026-03-12)

• Suporte para variantes -MEN (mensal) e -TRI (trimestral) na sintaxe
• Fase 3 actualizada com queries especificas por variante
• Fase 5 actualizada com termos de pagamento ajustados por variante
• Mapeamento de variantes documentado (pesquisa por prefixo no CRM)
• Exemplo adicional com -MEN para demonstrar separacao setup/recorrencia
• Retrocompativel: sem flag = comportamento anterior (item base)

v4.0.0 (2026-03-05)

• BREAKING: Fonte de verdade migrada de CSVs para Desk CRM (tblitems + tblitems_groups)
• Removidas referencias a tabela-geral.csv, items-subscricao.csv, chatbots-precos.csv, items-faturacao-deskcrm.csv
• Adicionados grupos DeskCRM, Chatbots, AcceleratorX como tipos de orcamento
• Protocolo actualizado para consultar precos via MCP/SQL em vez de CSVs
• Tabela de referencia rapida mantida mas marcada como "nao fonte de verdade"
• Adicionada documentacao de variantes de facturacao (Investimento/Anuidade/Trimestral/Mensalidade)

v3.1.0 (2026-02-03)

• Instrumentacao automatica adicionada
• Datasets Dify integrados

---

Versao: 4.1.0 | Data: 2026-03-12 | Fonte de Verdade: Desk CRM (tblitems)