Ferramentas MCP

get_top_sales_reps — Top vendedores (RCAs) por período

Ranking de vendedores por valor de venda em um período — inclui faturamento líquido de devoluções (net_revenue) e devoluções (return_value) por RCA; valores em R$.

list_invoices — Notas fiscais (faturas) do período

Lista de notas fiscais de saída em um período, com valor, custo e margem.

list_invoice_items — Itens de venda (linhas) do período

Linhas de venda (itens de nota) em um período, com receita, custo e margem por linha.

get_sales_summary — Resumo de vendas do período

Resumo do faturamento em um período: valor faturado, faturamento líquido de devoluções (net_revenue), devoluções, custo, margem (R$ e %), nº de NFs, clientes e ticket médio.

get_sales_by_supplier — Vendas por fornecedor (indústria)

Faturamento e margem por fornecedor em um período: valor, faturamento líquido de devoluções (net_revenue), devoluções, margem (R$ e %), NFs, clientes e SKUs.

get_sales_by_supervisor — Vendas por supervisor (equipe)

Faturamento por SUPERVISOR em um período — inclui faturamento líquido de devoluções (net_revenue), devoluções, margem, NFs e clientes da equipe.

get_team_of_supervisor — Equipe de um supervisor (roster)

Lista os vendedores (RCAs) do roster — nome, supervisor e flag de bloqueio.

get_sales_by_customer — Vendas por cliente

Faturamento e margem por cliente em um período: valor, margem (R$ e %), NFs e SKUs.

get_top_products — Top produtos por venda

Produtos mais vendidos em um período: valor, volume, margem e nº de clientes.

get_gross_margin_by_branch — Margem bruta por filial

Faturamento e margem bruta por filial em um período: valor, margem (R$ e %), NFs e clientes.

get_rep_ticket_avg — Ticket médio por vendedor (RCA)

Ticket médio por nota fiscal de cada vendedor (RCA) em um período, com nº de NFs e faturamento.

get_worst_margin_customers — Clientes de pior margem

Clientes com a MENOR margem percentual em um período — onde a rentabilidade aperta.

find_below_cost_sales — Vendas abaixo do custo (margem negativa)

Notas fiscais com margem NEGATIVA em um período (receita < custo).

list_products — Produtos (cadastro vendável)

Lista/pesquisa o cadastro de produtos VENDÁVEIS (ativos, não fora de linha, não proibidos).

get_monthly_sales_trend — Tendência de faturamento por período

Evolução do faturamento ao longo do tempo, em meses (padrão), semanas ou dias: valor, margem (R$ e %), NFs, clientes e ticket médio por período.

get_catalog_margin_quality — Qualidade da margem de cadastro (8133)

Margem de CADASTRO por produto para uma região e UF de destino, como a rotina 8133 do Winthor: (PTABELA − ICMS de tabela − custo próxima compra) ÷ PTABELA.

get_realized_net_margin_by_supplier — Margem realizada líquida por fornecedor (8128)

Margem REALIZADA por fornecedor principal num período, como a rotina 8128 do Winthor: venda líquida (faturamento − devoluções − ST/FECP), custo líquido e margem % SEM e COM verba (rebate do fornecedor).

get_realized_net_margin_by_product — Margem realizada líquida por produto (8128)

Margem REALIZADA por PRODUTO num período, como a rotina 8128 no grão produto: venda líquida (faturamento − devoluções − ST/FECP), custo líquido e margem %.

find_negative_realized_margin — Produtos com margem realizada NEGATIVA (caça-prejuízo 8128)

Produtos cuja margem líquida REALIZADA (rotina 8128) ficou ABAIXO de um limiar no período — por padrão, abaixo de 0% (prejuízo real: vendeu, devolveu ou custou mais do que a venda líquida).

list_customers — Clientes (cadastro)

Lista/pesquisa o cadastro de clientes ativos: nome, fantasia, documento (CGCENT), município, RCA principal, bloqueio.

get_rep_portfolio — Carteira oficial por vendedor (RCA)

Carteira de clientes de um RCA pela união oficial (rotina 8066: CODUSUR1∪2∪3 ∪ PCUSURCLI).

get_customer_rfm — RFM por cliente (recência, frequência, valor)

Clientes ordenados por valor (monetário) em 12 meses, com última compra (recência), nº de NFs e meses ativos (frequência).

find_inactive_customers — Clientes inativos (carteira em risco)

Clientes sem comprar há N dias (padrão 90), com última compra, dias inativos e valor de 12 meses — a carteira em risco.

get_portfolio_size_by_rep — Tamanho da carteira por RCA

Tamanho da carteira por vendedor: total de clientes, ativos (compraram nos últimos 12m) e inativos.

get_positivacao_by_rep — Positivação por vendedor (RCA)

Positivação por RCA: clientes positivados no mês corrente sobre a base ativa (12m), com a taxa (%).

get_positivacao_by_supervisor — Positivação por supervisor (equipe)

Positivação por SUPERVISOR: clientes positivados no mês sobre a base ativa (12m) da carteira da equipe, com a taxa (%).

get_positivacao_summary — Positivação da empresa (consolidada)

Positivação consolidada da empresa: positivados no mês corrente sobre a base ativa (12m) e a taxa (%).

get_coverage_by_city — Cobertura por município

Cobertura por município: clientes cadastrados, ativos (12m), taxa de positivação e valor.

get_customer_profile — Ficha do cliente (360)

Ficha completa de um cliente: cadastro (nome, documento, cidade, RCA) + última compra e métricas dos últimos 90 dias (valor, NFs, SKUs, fornecedores).

get_churn_risk_by_rep — Carteira em risco por RCA (churn)

Carteira em risco por vendedor: clientes inativos (sem comprar há 12m), taxa de churn (%), e o valor anual em risco (faturamento do ano anterior dos clientes que pararam).

get_purchase_cadence — Cadência de compra por cliente

Clientes com seu intervalo médio entre compras (dias) e dias desde a última compra — para achar quem atrasou o ritmo.

get_active_base_trend — Tendência da base ativa de clientes

Evolução do nº de clientes que compraram por período (a base ativa), com NFs e valor — em meses (padrão), semanas ou dias.

get_order_pipeline — Pipeline de pedidos por status

Pedidos por status (faturado/bloqueado/pendente/cancelado) nos últimos N dias: quantidade e aging médio (dias).

list_orders — Pedidos (lista)

Lista de pedidos com filtros: período, status (status_code: 1=faturado, 2=bloqueado, 3=pendente, 4=cancelado), RCA, cliente, supervisor.

get_orders_by_rep — Pedidos por vendedor (RCA)

Pedidos por RCA em um período: quantidade, valor total, clientes distintos e pedidos de bonificação.

get_blocked_orders — Pedidos bloqueados agora

Pedidos bloqueados (POSICAO='B') nos últimos N dias, do mais antigo (maior idade) para o mais recente, com o motivo.

get_cancelled_orders — Pedidos cancelados

Pedidos cancelados (POSICAO='C') em um período, mais recentes primeiro, com data de cancelamento e motivo.

get_mix_penetration — Penetração de mix por cliente (fornecedor)

Para um fornecedor, quantos SKUs do portfólio cada cliente compra (penetração % e segmento MONO/PARCIAL/ALTO/COMPLETO).

get_supplier_penetration_scorecard — Scorecard de penetração por fornecedor

Por fornecedor: SKUs cadastrados (portfólio vendável) vs vendidos, a penetração (%), nº de clientes e valor (180 dias).

find_trade_white_space — Lacunas de trade (batalha naval produto×cliente)

Onde estão as oportunidades: para um fornecedor, cruza seus produtos mais vendidos com seus melhores clientes e devolve as LACUNAS — um cliente forte que ainda NÃO compra um produto forte.

get_receivables — Contas a receber (títulos em aberto)

Títulos em aberto (a receber), por valor.

find_overdue_receivables — Títulos vencidos (a receber em atraso)

Duplicatas em aberto JÁ vencidas, ordenadas pelo maior valor.

top_debtors — Maiores devedores (inadimplência por cliente)

Clientes com mais valor a receber, vencido e inadimplente (R$).

get_stock_position — Posição de estoque atual

Estoque atual por produto: quantidade disponível, custo e valor parado (R$).

find_stockouts — Produtos em ruptura (vendem mas zerados)

Produtos com estoque disponível ZERADO que ainda venderam nos últimos 90 dias — ruptura que custa venda.

find_dead_stock — Capital parado em estoque (sem giro)

Produtos com estoque em valor (R$) mas SEM vender há muito tempo — capital imobilizado.

rep_goal_attainment — Meta x realizado por vendedor (RCA)

Atingimento de meta de venda por vendedor (RCA) num mês: meta, realizado, % atingido e gap.

company_goal — Meta do mês da empresa (filial)

Meta x realizado da empresa por mês (nível FL): meta, realizado, % atingido.

supervisor_goal_attainment — Meta x realizado por supervisor

Atingimento de meta por SUPERVISOR num mês (nível SV): meta, realizado (bruto e líquido de devoluções), % atingido e meta/realizado de positivação da equipe.

supplier_goal_attainment — Meta x realizado por fornecedor

Atingimento de meta por FORNECEDOR num mês: meta (Σ das metas RCA×fornecedor, nível F), realizado (bruto e líquido), % atingido e nº de RCAs com meta.