company_goal
Meta do mês da empresa (filial) · domínio Metas · escopo mcp:goals
O que faz
Meta x realizado da empresa por mês (nível FL): meta, realizado, % atingido. Sem mês informado, traz os meses mais recentes. Use para 'estou batendo a meta do mês?'.
Exemplo de pergunta
“estou batendo a meta do mês?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
month | data (YYYY-MM-DD) | não | — | Mês (YYYY-MM-01); opcional |
top | integer (1–36) | não | 12 |
O que você recebe
period— Períodogoal_level— Nível da metarep_code— Vendedor (RCA)target_value— Meta (R$)realized_value— Realizado bruto (R$)pct_attained— % atingido (bruto)gap_value— Falta para a meta (R$)realized_net_value— Realizado líquido (R$)pct_attained_net— % atingido (líquido)customers_target— Meta de positivaçãocustomers_realized— Positivação realizada
Cuidados ao ler o resultado
Leia antes de interpretar
- Nível empresa (TIPOMETA='FL', headline). Não somar com outros níveis (G12a).
- pct_attained usa o realizado BRUTO (convenção 8055); pct_attained_net abate devoluções — declare a base ao responder.
- customers_target/customers_realized = meta e realizado de POSITIVAÇÃO da empresa.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/goals da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.
Esta página ajudou? Conte para a gente — lemos tudo.