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

---
name: orcamento
description: 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).
disable-model-invocation: 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)
```bash
# 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)
```bash
# 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)
```bash
# 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:

```json
{
  "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)

```sql
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)