MCP App Store
by KeenEthics
movmais icon

movmais MCP Server for ChatGPT

By movmais

Overview

Mov+ is a multi-tenant business platform for Brazilian companies: sales analytics over the company's ERP, customers, products and price tables, sales orders, technical assistance, finance, CRM, projects and boards. This app connects ChatGPT to YOUR Mov+ workspace so you can ask questions in plain language and get answers computed by Mov+ itself (the same numbers as the Mov+ screens), instead of guessing from exports. What you can do: - Sales analytics: sales for a period, over time, by customer, product, representative, state, city and portfolio; the sales ranking. - Customers: search customers, open a customer record, list customers who stopped buying (base active in the last 12 months by default), customers with overdue invoices, a customer PDF. - Products and prices: search the catalog, see a product, get the price for a specific customer, current commercial rules. - Orders: search orders, order details, a PDF or spreadsheet of an order, and create a DRAFT that repeats a previous order. Creating or editing a draft never touches your ERP. Sending an order is a separate, explicit step; only companies that turned on direct sending in Mov+ have the order forwarded to the ERP (as an unconfirmed order). Mov+ never confirms, invoices or deletes anything in your ERP. - Technical assistance: search claims, indicators, media and the claim PDF. - Finance, CRM, projects, boards, documents and files: list and summarize; create records when writes are enabled. - Alerts and daily tips: create alerts, summaries and daily tips and manage the notifications you receive. How access works: - You sign in to Mov+ with your own account and choose the workspace and the modules to share. Authorization uses OAuth 2.1 with PKCE; there are no API keys to copy. - The app can only see what YOUR Mov+ user is allowed to see (permissions, branch and sales-scope rules are the same as in the Mov+ screens). - Write tools are OFF by default. They appear only if you turn on writes in the authorization screen. Every write is recorded in the Mov+ audit log. - You can revoke access at any time in Mov+ (Settings > MCP) and the connection stops immediately. Requirements: an active Mov+ account with a workspace, and the permission to manage MCP credentials (settings.actions.manage_mcp) to authorize the connection. Mov+ is available in Portuguese (Brazil). Amounts are in Brazilian reais.

How to connect

  1. ChatGPT: Open the movmais listing in the ChatGPT app directory and choose Connect. ChatGPT listing movmais exposes 71 tools here.

Tools

analytics.clientes_com_titulo_vencido

ChatGPT
Clientes com TÍTULO A RECEBER VENCIDO em aberto — o atraso FINANCEIRO (inadimplência), não o atraso no ciclo de compra (esse é analytics.clientes_parados). Mesma carteira e mesmo alcance (filial + escopo comercial) das telas de clientes: o universo são os clientes COM ALGUMA COMPRA no ERP dentro do alcance de quem pergunta. Cada linha traz código e nome, cidade/UF, representante e supervisor da última compra, telefone (só nos assistentes do app; o MCP não devolve telefone), qtdTitulosVencidos, valorVencido (R$, saldo em aberto vencido), maiorAtraso (dias do título vencido mais antigo), emAberto (tudo em aberto, vencido ou a vencer) e limite (limite de crédito, quando o ERP o traz). Ordenada por valorVencido decrescente (padrão), ou maiorAtraso. Exige a permissão de ver o crédito do cliente (clientes.fields.credito): sem ela financeiro.permitido é false e a lista vem VAZIA — diga que falta a permissão, não que ninguém deve. financeiro.mapeado: false = a integração não tem o financeiro (títulos) mapeado: não há como saber, NÃO afirme que ninguém deve. Redes de clientes não são unidas (o título é de cada cadastro). A lista é completa (prévia + conjuntoId, incompleto, faltam); dados.combinar pagina, filtra ou exporta planilha/PDF. A filial é a da conversa, salvo unitId. Valores em REAIS. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.clientes_parados

ChatGPT
Clientes em ATRASO NO CICLO DE COMPRA / parados (sem comprar) — por representante, supervisor, time, carteira, estado, município ou filial. ATENÇÃO: "em atraso" aqui NÃO é título vencido (inadimplência): é o cliente que passou de 1,5× o intervalo médio entre as compras dele. Se a pessoa pediu "clientes em atraso", "inadimplentes" ou "devendo" e não ficou claro, pergunte UMA vez: "financeiro (título vencido) ou ciclo de compra?" — financeiro é analytics.clientes_com_titulo_vencido; se o contexto deixar claro, escolha e diga na PRIMEIRA frase qual significado usou. Calculado no servidor com a MESMA regra da Análise de Clientes: diasSemComprar é contado até HOJE, cicloMedio é o intervalo médio entre compras e situacao é "no ciclo", "atenção" (passou do ciclo) ou "em atraso" (mais de 1,5× o ciclo); sem_ciclo = comprou em um dia só; vendas12m são as vendas dos últimos 12 meses em REAIS. POR PADRÃO traz só a BASE ATIVA (comprou nos últimos 12 meses), ordenada por vendas12m decrescente (quem mais vale primeiro; para "o mais tempo parado" use ordenarPor: "diasSemComprar"). Os clientes sem compra há mais de 12 meses ficam FORA, mas são contados em universo.foraDaBaseAtiva — diga isso em uma frase e ofereça incluí-los (incluirTodos: true; diasSemComprarMin ou ultimaCompraAntesDe também desligam o corte). Cada linha traz código e nome, cidade/UF, representante e supervisor da última compra, telefone (só nos assistentes do app; o MCP não devolve telefone), última compra, dias sem comprar, ciclo, vendas e pedidos de 12 meses, a situação e, para quem pode ver crédito e tem o financeiro mapeado, qtdTitulosVencidos e valorVencido. A lista é COMPLETA: a resposta mostra uma prévia e traz conjuntoId, incompleto e faltam — se incompleto for true NÃO diga "todos"; use dados.combinar para paginar, filtrar ou exportar planilha/PDF. Redes de clientes que o workspace agrupou (unirRedes, padrão ligado) aparecem como UMA linha (tipo: "grupo", membros), sem cidade, telefone nem financeiro; cadastros que o workspace não agrupou continuam linhas separadas — nunca una por nome parecido. Quem nunca comprou não entra: o universo são os clientes COM ALGUMA COMPRA no ERP dentro do alcance de quem pergunta (não é "clientes ativos" do cadastro) — a resposta traz universo; diga esse critério e o total. Para achar o representanteId pelo nome use analytics.vendas_por_representante com busca e um período de 12 meses (incluirSemVenda: true acha também quem não vendeu). Sem filtro de representante/carteira/time, vale tudo o que a pessoa alcança. A filial é a da conversa, salvo unitId. Filtros do servidor: diasSemComprarMin, ultimaCompraAntesDe, situacao, busca. escopoComercial diz o que a pessoa pode ver: com tipo: "nenhum" a lista vazia é FALTA DE ACESSO — diga isso. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.clientes_por_mes

ChatGPT
Cliente × MÊS, calculado no servidor. É a ferramenta de: "quantos clientes compraram em cada mês", "clientes NOVOS por mês", "quantos clientes compraram TODOS os meses", "quantos compraram nos últimos 3 meses SEGUIDOS" (recorrência, fidelidade) e "quais são eles". Nenhuma outra ferramenta responde isso: analytics.vendas_por_cliente lista quem comprou ALGUMA vez no período, o que é outro número. Meses de calendário: de vira o dia 1 do seu mês e ate no futuro vira hoje (o que foi ajustado vem em ajustes). Máximo de 24 meses. Resposta: porMes[] com clientesQueCompraram (distintos), clientesNovos, pedidos e total de cada mês; clientesNoPeriodo (distintos no período todo); compraramEmTodosOsMeses (compraram em CADA mês do período); clientesPorMaiorSequencia (quantos clientes têm cada maior sequência de meses colados). Com mesesSeguidos: N (2 em diante), mesesSeguidos.clientes = quantos compraram em cada um dos N meses que TERMINAM no último mês do período — para "nos últimos 3 meses seguidos" use ate = hoje e mesesSeguidos: 3. Atenção com mês em andamento: se o último mês é parcial, mesesSeguidos.fechados = { meses, clientes } traz a contagem dos N meses FECHADOS anteriores a ele (ex.: ago, set e out) e ESSA é a resposta principal de "últimos N meses seguidos"; mesesSeguidos.clientes inclui o mês em andamento (número menor, quase zero nos primeiros dias do mês) e entra só como segunda frase. Se o período pedido não tem os N meses fechados, a ferramenta recua de o que faltar (vem em ajustes; os números por mês e "todos os meses" valem para o período ampliado). Com listar: N vem a lista (até 200, as maiores compras primeiro) de quem comprou em todos os meses, em clientesDeTodosOsMeses; listaCortada: true diz que há mais. DEFINIÇÕES (também em definicoes — repita-as quando o número puder ser lido de outro jeito): cliente NOVO no mês é o que fez a PRIMEIRA compra de toda a história da empresa naquele mês (não "novo no período"); comprar no mês é ter ao menos um pedido de venda nele, no mesmo recorte de filial e de acesso das outras ferramentas de vendas. Mês em andamento vem com parcial: true e avisoDeMesParcial: avise em linguagem simples ("novembro ainda está em andamento") e não trate como queda. Se escopoComercial for "nenhum", o zero é falta de acesso. Os valores vêm em REAIS. Exemplos: "clientes novos por mês de janeiro a outubro" → {"de":"2026-01-01","ate":"2026-10-31"}; "compraram nos últimos 3 meses seguidos" → {"de":"2026-09-01","ate":"<hoje>","mesesSeguidos":3}; "fizeram pedido todos os meses nos últimos 12 meses" → {"de":"<mesmo mês, ano passado>-01","ate":"<hoje>"} e leia compraramEmTodosOsMeses. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Fonte: o ERP sincronizado (fonte: "erp" na resposta) — NÃO inclui as vendas do marketplace (lojas Tray). Pergunta sobre marketplace, venda online ou "ao vivo" é de marketplace.vendas_ao_vivo / marketplace.vendas_do_mes; nunca apresente o número do ERP como se fosse o do marketplace. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.pdf_do_cliente

ChatGPT
ENTREGA o PDF da ficha de UM cliente (o mesmo do botão "Baixar PDF" da gaveta do cliente na Análise de Clientes: indicadores, categorias, produtos, pedidos recentes e os últimos 12 meses): no chat vira um cartão com botão de baixar; no WhatsApp chega como documento. clienteId é a chave cli: de analytics.vendas_por_cliente. NÃO devolve o conteúdo da ficha — para ler os números use as ferramentas de vendas. Efeito: gera e guarda um PDF da ficha do cliente na caixa de arquivos da pessoa (temporária; expira sozinha) — não altera dados do negócio e nunca sobrescreve nem apaga nada. Chamar de novo gera outro arquivo.

analytics.ranking_vendas

ChatGPT
Ranking de vendas do período por SUPERVISOR e por REPRESENTANTE: posição (e a do período comparado), vendas por categoria de produto (categorias[].categoria é o NOME da categoria de 1º nível da árvore do workspace quando ela está configurada — somando a subárvore inteira —, ou o nome cru do ERP quando o grupo não está mapeado; esse mesmo nome serve como filtro categoria nas outras ferramentas, e agregada: true marca os baldes "Outras"/"Sem categoria"/"Sem itens", que NÃO servem de filtro), participação no total, pedidos, ticket médio, clientes, clientes novos, base ativa (clientes da base que compraram), mix (categorias e itens por pedido), carteira em risco (vendas de 12 meses dos clientes em atraso), dias sem pedido e a META de cada um. Use para "quem bateu a meta?", "quem está mais longe da meta?", "como está o ranking do mês?" ou "quem tem mais clientes parados?". Vendas em REAIS; a meta em CENTAVOS (meta.centavos), com atingimento e ritmo em % (ritmo só com o período em curso). Informe compararDe/compararAte para a posição e as vendas anteriores. Os representantes vêm do maior para o menor, cortados em limit; totalDeRepresentantes diz quantos são — o universo são os representantes que VENDERAM no período mais os que têm META no período (não os "ativos" do cadastro); diga esse critério ao contar. baseAtiva = clientes da base que compraram: a base é a CARTEIRA do representante ou, sem carteira, quem comprou nos 12 meses (origem). O representanteId de uma linha, quando não é nulo, filtra as outras ferramentas. Com carteiraId, grupoId, clienteId, uf ou municipioIbge, a base ativa e a carteira em risco contam só os clientes do filtro (uf/municipioIbge = quem comprou ali), e quem não vendeu no filtro só aparece (zerado, pela meta) se tem cliente do filtro na base — mesmo a pessoa pedida em representanteId/timeId. Com categoria, produtoId, representanteId, supervisorId, timeId, novosNaEmpresa ou transferidos (e nenhum dos filtros de cliente acima), quem não vendeu no filtro não aparece — exceto a pessoa pedida em representanteId/timeId, que aparece zerada. A meta do total é sempre a de todos, com ou sem filtro. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_por_carteira

ChatGPT
Vendas, pedidos e clientes por carteira de clientes no período. Cada venda conta para a carteira em que o cliente está HOJE — quem herda um cliente recebe o histórico inteiro dele. A linha com carteira nula é "Sem carteira". A lista inteira fica guardada no servidor: a resposta mostra uma prévia (limite, ou limit) e traz conjuntoId, incompleto e faltam — se incompleto for true NÃO diga que a lista está completa; use dados.combinar com o conjuntoId para ordenar, filtrar, somar, cruzar com outra consulta ou exportar CSV. ordenarPor/ordem ordenam no servidor. Com compararCom ("ano_anterior" ou "periodo_anterior") ou compararDe+compararAte, cada linha traz totalAnterior, diferenca e variacaoPercentual. Só passe como filtro (representanteId, timeId, carteiraId) um id cuja linha tenha filtravel: true — as demais são vendas visíveis de quem está fora do escopo da pessoa, e o filtro seria recusado. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_por_cliente

ChatGPT
Clientes que compraram no período, das maiores vendas para as menores: total e número de pedidos. Cada linha é UM cliente de UMA integração: o mesmo código em duas integrações são dois clientes, e a linha diz a integração (integracao, nula quando só uma integração é consultada). clienteId é uma chave opaca; codigo é o código do cliente no ERP. cliente é o nome EFETIVO — o que o workspace deu ao cliente, quando deu, senão o do ERP — e nomeNoErp é sempre o nome como está no ERP. Aceita busca pelo nome (o do workspace e o do ERP) ou pelo código. Informe compararDe/compararAte (ou compararCom) para receber, em cada linha, totalAnterior e pedidosAnterior — as vendas e os pedidos DAQUELE cliente no período comparado (0 quando ele não comprou); a ordem e a paginação continuam as do período atual. A comparação exige AS DUAS datas — compararDe e compararAte; informar só uma delas é recusado. Cada linha também traz qtdeCategorias (quantas categorias distintas ele comprou no período — contadas no MESMO vocabulário do resto do módulo: com a árvore do workspace configurada, categorias de 1º nível, e não as grafias cruas do ERP, então o número é MENOR do que a contagem de descrições do ERP), ultimaCompra (a mais recente dentro do período) e representante — o que MAIS vendeu a ele no período, com id na MESMA chave opaca de analytics.vendas_por_representante (rep:/erp:) e nome; null sem representante nas vendas do período. Use para "quem são os maiores clientes?" ou para conferir um cliente específico. Para "quem está sem comprar" use analytics.clientes_parados. A resposta traz total com a CONTAGEM COMPLETA. A lista inteira fica guardada no servidor: a resposta mostra uma prévia (limite, ou limit) e traz conjuntoId, incompleto e faltam — se incompleto for true NÃO diga que a lista está completa; use dados.combinar com o conjuntoId para ordenar, filtrar, somar, cruzar com outra consulta ou exportar CSV. ordenarPor/ordem ordenam no servidor. Com compararCom ("ano_anterior" ou "periodo_anterior") ou compararDe+compararAte, cada linha traz totalAnterior, diferenca e variacaoPercentual. Sem completo: true a lista vem na ordem das maiores vendas e só até o limite. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_por_estado

ChatGPT
Vendas por estado (UF) no período. Use para perguntas de geografia comercial ("onde vendemos mais?", "quanto vendemos no Ceará?"). Uma linha com uf nulo significa venda cujo endereço a integração não descreve — ela NÃO é um estado, e somá-la a um estado real seria inventar dado. Cada linha traz também, do IBGE: populacao (estimada para o ano mais recente), densidade (habitantes por km², população do Censo 2022 ÷ área territorial do Censo 2022), pibPerCapita (R$, PIB dos Municípios 2023 ÷ população do Censo 2022), rendaMedia (rendimento médio mensal domiciliar per capita, R$, Censo 2022) e vendaPorMilHabitantes (o total ÷ populacao × 1000, em R$). Vêm nulos quando o lugar não é identificado (sem UF, município sem código do IBGE) — nulo é "sem dado", nunca zero. A lista inteira fica guardada no servidor: a resposta mostra uma prévia (limite, ou limit) e traz conjuntoId, incompleto e faltam — se incompleto for true NÃO diga que a lista está completa; use dados.combinar com o conjuntoId para ordenar, filtrar, somar, cruzar com outra consulta ou exportar CSV. ordenarPor/ordem ordenam no servidor. Com compararCom ("ano_anterior" ou "periodo_anterior") ou compararDe+compararAte, cada linha traz totalAnterior, diferenca e variacaoPercentual. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_por_municipio

ChatGPT
Vendas por município. Exemplo: {"de":"2026-01-01","ate":"2026-10-29","uf":["CE"],"limite":10}. COM uf ou uma lista de estados: dentro deles ("quais cidades do Ceará?"). SEM uf: o ranking NACIONAL de cidades ("quais cidades mais compram?") — cada linha traz o estado dela (uf), então não chute estados. O codigoIbge devolvido é o que identifica o município em outros filtros — o NOME não serve, o país tem cinco "Bom Jesus". Cada linha traz também, do IBGE: populacao (estimada para o ano mais recente), densidade (habitantes por km², população do Censo 2022 ÷ área territorial do Censo 2022), pibPerCapita (R$, PIB dos Municípios 2023 ÷ população do Censo 2022), rendaMedia (rendimento médio mensal domiciliar per capita, R$, Censo 2022) e vendaPorMilHabitantes (o total ÷ populacao × 1000, em R$). Vêm nulos quando o lugar não é identificado (sem UF, município sem código do IBGE) — nulo é "sem dado", nunca zero. A lista inteira fica guardada no servidor: a resposta mostra uma prévia (limite, ou limit) e traz conjuntoId, incompleto e faltam — se incompleto for true NÃO diga que a lista está completa; use dados.combinar com o conjuntoId para ordenar, filtrar, somar, cruzar com outra consulta ou exportar CSV. ordenarPor/ordem ordenam no servidor. Com compararCom ("ano_anterior" ou "periodo_anterior") ou compararDe+compararAte, cada linha traz totalAnterior, diferenca e variacaoPercentual. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_por_produto

ChatGPT
Produtos vendidos no período, das maiores vendas para as menores: quantidade, número de pedidos, total e a categoria de cada um — o NOME da categoria de 1º nível da árvore do workspace quando ela está configurada (o mesmo vocabulário de analytics.ranking_vendas), ou o nome cru do ERP quando o grupo não está mapeado; null quando a integração não descreve a categoria do item. Esse nome serve como filtro categoria nesta e nas outras ferramentas. O total de cada produto é a FATIA do valor do pedido (o valor do cabeçalho rateado pelos itens): a soma dos produtos fecha com as vendas do período, e os pedidos sem itens ficam de fora. Aceita busca por nome ou código. A resposta traz total com a CONTAGEM COMPLETA do filtro, independente de limit — para responder "quantos produtos?" leia o total, não aumente o limite. Vazio quando a integração não descreve itens de pedido: é ausência de configuração, não ausência de venda. A lista inteira fica guardada no servidor: a resposta mostra uma prévia (limite, ou limit) e traz conjuntoId, incompleto e faltam — se incompleto for true NÃO diga que a lista está completa; use dados.combinar com o conjuntoId para ordenar, filtrar, somar, cruzar com outra consulta ou exportar CSV. ordenarPor/ordem ordenam no servidor. Com compararCom ("ano_anterior" ou "periodo_anterior") ou compararDe+compararAte, cada linha traz totalAnterior, diferenca e variacaoPercentual. Sem completo: true a lista vem na ordem das maiores vendas e só até o limite. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_por_representante

ChatGPT
Ranking da equipe comercial no período (exemplo: {"de":"2026-10-01","ate":"2026-10-31","limite":10}): vendas e pedidos por representante, com o supervisor de cada um, e o bloco porTime (vendas por time comercial). Use para "quem mais vendeu?", "como está a equipe?", "como foi o time Norte?", "quem NÃO vendeu?" (incluirSemVenda: true acrescenta os representantes ATIVOS NO CADASTRO, dentro do alcance de quem pergunta, com total 0 — sem filtros de estado/categoria/cliente/etc.; o cadastro pode ter ex-representantes ainda marcados como ativos, então para "quem parou/não vende mais" acrescente somenteComVendaRecenteDias: 90, que restringe o universo aos ativos que venderam nos últimos N dias) ou para comparar pessoas e períodos. busca filtra pelo nome (para achar o representanteId de "o Antonio"). O representanteId de cada linha é a chave para filtrar as outras ferramentas; o timeId de porTime também (a linha com timeId nulo é quem não está em time nenhum). Quem está em dois times conta nos dois. A resposta traz universo (criterio, total, comVenda, semVenda): SEMPRE diga à pessoa o critério e o tamanho do universo ao contar ou listar representantes ("considerei os 64 ativos no cadastro"). A lista inteira fica guardada no servidor: a resposta mostra uma prévia (limite, ou limit) e traz conjuntoId, incompleto e faltam — se incompleto for true NÃO diga que a lista está completa; use dados.combinar com o conjuntoId para ordenar, filtrar, somar, cruzar com outra consulta ou exportar CSV. ordenarPor/ordem ordenam no servidor. Com compararCom ("ano_anterior" ou "periodo_anterior") ou compararDe+compararAte, cada linha traz totalAnterior, diferenca e variacaoPercentual. Só passe como filtro (representanteId, timeId, carteiraId) um id cuja linha tenha filtravel: true — as demais são vendas visíveis de quem está fora do escopo da pessoa, e o filtro seria recusado. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_resumo

ChatGPT
Vendas, número de pedidos, clientes únicos (clientes distintos), ticket médio, clientes novos, itens vendidos e produtos distintos de um período, direto do ERP sincronizado. Use para perguntas de panorama comercial ("qual foi a venda esse mês?", "quanto faturamos em agosto?"). Exemplo de chamada: {"de":"2026-10-01","ate":"2026-10-31","compararCom":"periodo_anterior"}. Informe compararCom ("ano_anterior"/"periodo_anterior") ou compararDe/compararAte para receber também o período anterior e a variação. Os valores vêm em REAIS (não em centavos, ao contrário do módulo financeiro). escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

analytics.vendas_serie

ChatGPT
A SÉRIE de vendas no tempo, em ordem cronológica: um ponto por DIA, por SEMANA (segunda a domingo) ou por MÊS, direto do ERP. É a ferramenta de "vendas do mês" (dia a dia, do dia 1 até hoje), "vendas da semana", "evolução das vendas", "vendas dos últimos 6 meses" e de todo gráfico de linha/barra no tempo — analytics.vendas_resumo devolve UM total e não serve para gráfico. Escolha granularidade: dia para até ~3 meses (o padrão de "vendas do mês" e "da semana"), semana para trimestres, mes para meio ano ou mais. Exemplos: "vendas do mês" → {"de":"2026-10-01","ate":"<hoje>","granularidade":"dia"}; "últimos 6 meses" → {"de":"2026-05-01","ate":"<hoje>","granularidade":"mes"}. Cada ponto traz rotulo (eixo X), de/ate, total e, com compararCom, totalAnterior (o ponto da MESMA posição no período anterior); parcial: true marca a semana/mês ainda em andamento (não é queda). Dia sem venda aparece com total 0. Máximo de 120 pontos. Os valores vêm em REAIS. Para gráfico, copie rotulo como categoria e total como valor, na ordem recebida. escopoComercial diz o que a pessoa pode ver das vendas: com tipo: "nenhum" o zero é FALTA DE ACESSO — diga isso, não afirme que não houve venda. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

assistencia.buscar_assistencias

ChatGPT
As assistências técnicas (reclamações de produto com defeito) que a pessoa pode ver: código AT, situação, cliente, loja, produto, defeito, natureza (estético/externo ou interno), peças e as datas de abertura e encerramento. busca aceita o código (AT000123), o nome da loja ou a descrição do produto — NUNCA o nome do consumidor. de/ate (AAAA-MM-DD) recortam pelo dia do envio, em São Paulo. NUNCA traz dado do consumidor nem os anexos. total é a contagem completa; 25 por página. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

assistencia.indicadores

ChatGPT
A taxa de assistência (peças PROCEDENTES ÷ peças vendidas, em CENTÉSIMOS de ponto percentual: 83 = 0,83%) por cliente, representante, UF e geral, com a faixa (VERDE/AMARELO/VERMELHO) e a curva da empresa, e o ranking de defeitos por produto, mês e UF — num período de meses inteiros (de/ate em AAAA-MM, até 24 meses). Responde "qual cliente está no vermelho" e "qual o defeito campeão de um produto". integracoesForaDaTaxa lista as integrações cujo mapeamento não traz os itens vendidos (SEM_ITENS): os clientes delas aparecem com taxa NULA, o que quer dizer "sem como calcular", NUNCA "taxa zero" nem "sem venda" — diga isso ao responder. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

assistencia.midias_da_assistencia

ChatGPT
ENTREGA as evidências de uma assistência técnica como arquivos — até 6 por chamada, no chat como cartões com prévia e no WhatsApp como imagens/documentos. quais escolhe o que entregar: "imagens" (padrão: as FOTOS — etiqueta e produto —, SEM o PDF da nota e SEM vídeo), "documentos" (o PDF da nota fiscal), "videos" (só link com validade: vídeo é grande demais para ir como arquivo) ou "todos". Pediu "imagens"/"fotos" → "imagens"; pediu a nota → "documentos"; "evidências"/"tudo" → "todos". codigo é o AT000123 de assistencia.buscar_assistencias. omitidos diz quantas ficaram de fora do teto. Os arquivos chegam à pessoa pelo canal: NÃO cole links nem diga que já enviou — o canal confirma. Efeito: gera e guarda cópias das fotos e do PDF da nota na caixa de arquivos da pessoa (temporária; expira sozinha) — não altera dados do negócio e nunca sobrescreve nem apaga nada; vídeo sai só como link com validade e não é copiado. Chamar de novo gera outros arquivos.

assistencia.pdf_da_assistencia

ChatGPT
ENTREGA o PDF da ficha de uma assistência técnica (o mesmo do botão de PDF da tela, com o QR das evidências): no chat vira um cartão com botão de baixar; no WhatsApp chega como documento. Use quando a pessoa pedir o PDF/a ficha de uma assistência. codigo é o AT000123 de assistencia.buscar_assistencias. NÃO devolve o conteúdo da ficha. Efeito: gera e guarda um PDF da ficha da assistência na caixa de arquivos da pessoa (temporária; expira sozinha) — não altera dados do negócio e nunca sobrescreve nem apaga nada. Chamar de novo gera outro arquivo.

boards.attach_file

ChatGPT
Vincula um arquivo JÁ ENVIADO (obtido em workspace.list_pending_files) a um item de um board. Obtenha o boardId com boards.list_boards e o itemId com boards.list_items (ou crie um novo com boards.create_item). Não serve para enviar arquivo — só para vincular um que a pessoa já enviou. Efeito: vincula o arquivo a um item de board e o tira da lista de arquivos pendentes (workspace.list_pending_files); nada do que já existe é alterado, sobrescrito ou removido. Repetir a chamada com o mesmo arquivo é recusado (já vinculado).

boards.create_item

ChatGPT
Cria um item (linha) dentro de um grupo de um board. Exige o boardId e o groupId de destino — obtenha ambos com boards.list_items antes. Confirme com o usuário: o agente não tem ferramenta para excluir o que criou. Efeito: cria um item no grupo do board; nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

boards.list_boards

ChatGPT
Lista os boards (quadros de trabalho com grupos, colunas e itens) a que o usuário tem acesso, já filtrados pela visibilidade de cada um. Use para descobrir o boardId antes de ler ou criar itens. Omita unitId para a visão consolidada. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

boards.list_items

ChatGPT
Abre um board e devolve seus grupos, colunas e itens (paginado). Use depois de descobrir o boardId com boards.list_boards. Só devolve boards que o usuário pode de fato ver. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

clientes.buscar_clientes

ChatGPT
Procura clientes do cadastro do ERP que a pessoa pode ver — pelo nome (o que o workspace deu, a razão social e o nome fantasia do ERP) ou pelo código do cliente. Cada linha é UM cliente de UMA integração (integracao diz qual; nula com uma só) e traz clienteId, a chave que clientes.ver_cliente e clientes.criar_anotacao pedem. nome é o nome efetivo; nomeNoErp, o do ERP. vendas12m é as vendas dos últimos 12 meses (nulo fora do escopo de vendas da pessoa). Sem busca, devolve os que mais compraram. total é a CONTAGEM COMPLETA. escopoComercial diz o que a pessoa pode ver: com tipo: "nenhum" a lista vazia é FALTA DE ACESSO — diga isso, não afirme que o cliente não existe. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

clientes.cadastros_em_andamento

ChatGPT
Lista os CADASTROS DE CLIENTE NOVO que a pessoa alcança (os que ela fez e, conforme o perfil, os da carteira ou da equipe): código (CC000123), nome e razão social, cidade/UF, a integração, a situação (rascunho, aguardando aprovação, recusado, na fila de digitação, enviando ao ERP, erro no envio, no ERP, digitado, vinculado, cancelado), quem criou e quando — e, no cadastro RECUSADO, o motivo da devolução. Use quando a pessoa perguntar "como está o cadastro da Padaria X?", "meus cadastros de cliente", "algum cadastro foi recusado?", "o que está parado na digitação?". fila: todos (padrão), rascunhos (os rascunhos e recusados DELA), a_aprovar e a_digitar (só para quem aprova/digita; senão a ferramenta recusa), erro_no_envio, no_erp. situacao filtra por uma situação. busca = parte do nome, da razão social, o código do cadastro ou o CNPJ da empresa (14 dígitos) — NUNCA por documento de pessoa física (peça o nome). Até 25 por chamada (total conta todos; use pagina); contagemPorFila traz o total de cada fila. NÃO traz o documento da pessoa ou da empresa, telefone, e-mail nem endereço, e NÃO cria, envia, aprova nem cancela cadastro: isso é na tela (precisa do documento). Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

clientes.criar_anotacao

ChatGPT
Registra uma anotação interna na ficha de UM cliente (ex.: "pediu entrega só pela manhã"). Todos que veem o cliente leem a anotação. O texto é gravado como escrito, sem formatação, e o agente não marca pessoas. Use o clienteId de clientes.buscar_clientes. Pede confirmação antes de gravar. Efeito: cria uma anotação interna na ficha do cliente (todos que veem o cliente a leem); nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

clientes.ver_cliente

ChatGPT
O cadastro de UM cliente: nome efetivo e o do ERP, código, integração, os campos do cadastro (o valor que vale — o editado no workspace, senão o do ERP), os campos personalizados do workspace, o crédito dele (limite, em aberto, vencido, disponível, em reais — null sem a permissão de ver crédito; configurado: false quando o conector não tem o financeiro mapeado; credito.somenteLimite: true quando só o LIMITE está mapeado, sem títulos — limite vale, mas emAberto, vencido e disponivel são DESCONHECIDOS (os zeros são enchimento: nunca diga que o cliente não deve nada); credito.lidoEm é quando o ERP foi LIDO pela última vez nas tabelas do crédito, a mais antiga das duas — não quando cada título mudou; credito.limiteVencidoEm é a data da análise de crédito vencida: o limite continua valendo, com essa ressalva) e as 10 anotações mais recentes (texto truncado em 200 caracteres). Use com o clienteId de clientes.buscar_clientes. Conforme a política de dados do workspace: documento e endereço (CEP, rua, número, complemento, bairro) e o valor de campo personalizado só aparecem no modo de dados completo; e-mail, telefone, WhatsApp, nome de contato e autor da anotação só nos assistentes do app (o MCP não os devolve); cidade e o texto da anotação também ocultam no modo mais restrito. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

despesas.minhas_viagens

ChatGPT
Lista as VIAGENS (prestações de contas de despesas) da PRÓPRIA pessoa, da mais recente para a mais antiga: código, destino, assunto, período, situação (aberta, enviada, em revisão, aprovada, devolvida, fechada), quantos itens, quantos acima do limite, os totais (lançado, aprovado, aporte total) e o saldo (positivo = a empresa reembolsa; negativo = a pessoa devolve). Use quando a pessoa perguntar "como está minha prestação de contas?", "minhas viagens de outubro", "alguma viagem foi devolvida?", "quanto tenho a receber?". situacao filtra; de/ate (AAAA-MM-DD) filtram pelo início da viagem; busca procura no destino/assunto. Até 25 por chamada (total conta todas; use pagina). Para os itens de uma viagem use despesas.ver_viagem (o viagemId vem daqui). Só as viagens DELA: a fila de revisão do gestor é na tela. NÃO lança despesa, não cria viagem nem envia a prestação (isso é na tela, com o comprovante). Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

despesas.ver_viagem

ChatGPT
Mostra UMA viagem da pessoa por dentro: período, situação, totais e saldo; cada item (data, categoria, descrição, valor, se foi aprovado/contestado/recusado e por quanto, se está acima do limite, se tem comprovante ou se FALTA comprovante); o total por categoria; cada ADIANTAMENTO recebido (adiantamentos: data e valor, até 30) e os últimos eventos (enviada, devolvida…, com o comentário do gestor, aparado). Use depois de despesas.minhas_viagens (o viagemId vem de lá) quando a pessoa perguntar "o que tem nessa viagem?", "por que foi devolvida?", "falta algum comprovante?", "quanto recebi de adiantamento e quando?". Até 50 itens (totalDeItens conta todos). Viagem fora do alcance ou inexistente: "não encontrada". NÃO traz a imagem do comprovante, a forma de pagamento nem a descrição do adiantamento, e NÃO lança, edita nem envia nada. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

documents.attach_file

ChatGPT
Vincula um arquivo JÁ ENVIADO (obtido em workspace.list_pending_files) a um documento. Obtenha o documentId com documents.list_documents. Não serve para enviar arquivo — só para vincular um que a pessoa já enviou. Efeito: vincula o arquivo a um documento e o tira da lista de arquivos pendentes (workspace.list_pending_files); nada do que já existe é alterado, sobrescrito ou removido. Repetir a chamada com o mesmo arquivo é recusado (já vinculado).

documents.list_documents

ChatGPT
Lista os documentos que o usuário pode ver — a mesma lista da tela de Documentos. Use para descobrir o documentId antes de anexar um arquivo com documents.attach_file. Projeção mínima de propósito: a linha de um documento pode carregar o CONTEÚDO inteiro (texto rico), estado de colaboração e a identidade de quem criou — nada disso é devolvido aqui, só o suficiente para escolher qual documento. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

insights.alterar_notificacao

ChatGPT
Muda o nome, o horário/frequência, o fuso, os canais ou os destinatários de um aviso DA PRÓPRIA pessoa. O que for omitido fica como está. NÃO troca a métrica nem a condição (para isso, crie outro aviso e exclua este). Use o ruleId de insights.listar_notificacoes. Passar userIds/groupIds/teamIds substitui a lista de destinatários. Pelo WhatsApp só em avisos que são só da própria pessoa. Pede SIM com o resumo. Efeito: sobrescreve a configuração atual do aviso (nome, horário, fuso, canais, destinatários), substituindo os valores anteriores; a alteração não pode ser desfeita por esta ferramenta. Não cria nem apaga avisos.

insights.criar_alerta

ChatGPT
Cria um ALERTA por condição: confere num intervalo e avisa UMA vez por ocorrência quando algo passa a valer (ex.: "avisa quando um cliente passar 30 dias sem comprar" = métrica clientes.sem_comprar, campo diasSemComprar >= 30). Só reavisa se a ocorrência sair da situação e voltar. No primeiro envio manda UMA mensagem com o que já está na situação. Fluxo e regras iguais às de insights.criar_resumo: métrica e campos de insights.listar_metricas, SIM com resumo, só o próprio usuário pelo WhatsApp. Efeito: cria um aviso novo que, depois do SIM, passa a enviar mensagens (sino, e-mail ou WhatsApp) quando a condição vale, até ser pausado ou excluído; nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

insights.criar_dicas_do_dia

ChatGPT
Assina as DICAS DE DECISÃO DO DIA (as do Dashboard) por e-mail, WhatsApp ou sino, no horário que a pessoa escolher (ex.: "me manda as dicas do dia todo dia às 7h30 no WhatsApp"). Não usa IA nova: leva o que o Dashboard já calculou, com o acesso de cada destinatário, e por e-mail/WhatsApp vai só o resumo (quantas e de que tipo), sem nome de cliente. Exige que a pessoa possa ver as dicas. Mesmas regras de insights.criar_resumo. Efeito: cria uma assinatura nova das dicas do dia que, depois do SIM, passa a enviar mensagens (sino, e-mail ou WhatsApp) no horário combinado, até ser pausada ou excluída; nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

insights.criar_resumo

ChatGPT
Cria um RESUMO agendado: manda, no horário combinado, os números de uma ou mais métricas (ex.: "me avise todo dia às 8h as vendas de ontem"). Fluxo: 1) insights.listar_metricas para escolher a métrica e o período; 2) se for para outras pessoas, insights.listar_destinatarios; 3) chame esta ferramenta — a pessoa vê o resumo (o quê, quando, para quem, canais) e só então confirma com SIM. Cada destinatário recebe só o que o PRÓPRIO acesso mostra. Pelo WhatsApp só para a própria pessoa. Só inclua WHATSAPP nos canais se a pessoa pedir. Efeito: cria um aviso novo que, depois do SIM, passa a enviar mensagens (sino, e-mail ou WhatsApp) nos horários combinados até ser pausado ou excluído; nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

insights.excluir_notificacao

ChatGPT
Exclui um aviso DA PRÓPRIA pessoa (some da lista e para de enviar; o histórico de envios é mantido). Sempre pede SIM com o resumo do aviso. Se a pessoa só quer parar por um tempo, prefira insights.mudar_estado_notificacao (pausar). Pelo WhatsApp só em avisos que são só dela. Efeito: exclui o aviso: ele some da lista e deixa de enviar mensagens (o histórico de envios é mantido); a exclusão não pode ser desfeita por esta ferramenta.

insights.listar_destinatarios

ChatGPT
Lista pessoas, grupos de permissão e times comerciais do workspace que podem ser destinatários de um aviso. Só para quem pode criar avisos para outras pessoas. Use os ids em userIds, groupIds e teamIds ao criar. Para avisar só a própria pessoa não precisa chamar. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

insights.listar_metricas

ChatGPT
Lista as métricas que a pessoa pode usar num aviso (resumo ou alerta) — SÓ as que o acesso dela alcança. Chame ANTES de propor um aviso: o id da métrica, os campos comparáveis em alertas e os parâmetros vêm DAQUI, nunca invente. usos diz se serve a RESUMO, a CONDICAO (alerta) ou aos dois. Além delas existe a assinatura das dicas de decisão do dia (insights.criar_dicas_do_dia). Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

insights.listar_notificacoes

ChatGPT
Lista os avisos (resumos, alertas e assinaturas de dicas) da pessoa — nome, quando roda, canais, estado e a última execução. escopo: "todas" só para quem pode ver os avisos de toda a empresa. Use o ruleId ao editar, pausar ou excluir. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

insights.mudar_estado_notificacao

ChatGPT
Pausa um aviso (para de enviar, mantém tudo) ou o retoma. Use o ruleId de insights.listar_notificacoes. Retomar exige que a pessoa ainda tenha a permissão do aviso. Pelo WhatsApp só em avisos que são só da própria pessoa. Pede SIM. Efeito: sobrescreve o estado do aviso (ativo ou pausado) — um aviso pausado deixa de enviar mensagens até ser retomado; nada é apagado e esta mesma ferramenta desfaz a mudança, chamando-a com a ação contrária (acao: pausar ou retomar).

metas.buscar_metas

ChatGPT
A aba do Painel de Metas — meta, realizado, atingimento e situação de cada série do alvo escolhido (empresa, filiais, estados, supervisores, times, representantes, carteiras ou clientes), no MESMO alcance da tela (o escopo comercial e as filiais de quem pergunta). de/ate são o período da consulta: escolhem quais metas aparecem e é dentro dele que o realizado é somado — sempre o do alvo inteiro, sem recorte de filial, time ou representante. Cada linha mostra a meta de DUAS formas: meta é a parte da meta que cai no período pedido (proporcional aos dias — com ate = hoje, a meta até hoje), comparada com realizado em atingimento e julgada em situacao; metaCheia é a meta cadastrada inteira e vigencia o período inteiro dela. Com o período em curso, fechamentoProjetado diz quanto a meta fecha no ritmo atual (o realizado ÷ os dias já corridos × os dias da vigência) e atingimentoProjetado a fração disso sobre metaCheia; vêm null sem projeção (período encerrado, vigência que termina hoje ou que começa antes de de, e sempre em ACTIVE_CUSTOMERS — clientes distintos não crescem em linha reta). situacao, porém, com ate depois de hoje, é decidida por projecao — o ritmo até hoje estendido em linha reta até ate —, também em ACTIVE_CUSTOMERS, como nos outros indicadores: ali a reta tende a superestimar (quem compra de novo não soma), então a situação pode sair otimista. SALES_VALUE é o rótulo "Vendas" da tela: meta/metaCheia/realizado/falta/fechamentoProjetado vêm em CENTAVOS (Regra 2); os demais indicadores são contagens simples. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

metas.criar_meta

ChatGPT
Cadastra uma meta de venda para uma série (alvo + indicador, com filtro de categoria/produto opcional) num período. targetValue é o valor da meta em CENTAVOS para SALES_VALUE (o rótulo "Vendas" da tela; Regra 2), ou a contagem inteira para os demais indicadores. Recusa (400) se o alvo não existir, e não encontra (404) um alvo que quem pede não alcança — nunca cria meta fora do escopo comercial de quem pede. Meta idêntica (mesma série e mesmo período) já cadastrada é recusada (409). Efeito: cria uma meta de venda; nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

pedidos.aprovar_pedido

ChatGPT
APROVA o desconto de um pedido que está AGUARDANDO APROVAÇÃO (a fila a_aprovar de pedidos.buscar_pedidos), passado por pedidoId ou codigo (MV000123). Só quem tem a permissão de aprovar desconto e alcança o representante do pedido; o pedido que já foi decidido, ou que não está aguardando aprovação, é recusado. comentario (3 a 1000 caracteres) é OBRIGATÓRIO e é o da pessoa — pergunte antes, nunca invente. Depois da aprovação o pedido segue para o escritório digitar no ERP ou, nas integrações com envio direto, vai ao ERP. Devolve a situação do pedido depois da decisão. Efeito: envia o pedido adiante — ao escritório para digitar no ERP ou, nas integrações com envio direto, ao ERP — e avisa quem o criou; a aprovação não pode ser desfeita por esta ferramenta.

pedidos.buscar_pedidos

ChatGPT
Os pedidos de venda do sistema que a pessoa pode ver — todos, ou uma fila: rascunhos (os pedidos ainda não enviados e os que VOLTARAM com correção solicitada (situação CORRECAO_SOLICITADA — quem aprova ou o escritório pediu que o pedido seja corrigido e enviado de novo; o motivo está no histórico do pedido): os que a própria pessoa começou e os que voltaram de um representante DELA (o do portal é criado pelo lojista); com a permissão pedidos.actions.view_all_drafts, os de todos que ela alcança — mesma filial e escopo comercial de todos; cada linha traz criadoPor nos assistentes do app; o MCP não devolve o nome de quem criou), a_aprovar (aguardando aprovação: desconto acima do limite, item bonificado ou item sem preço vigente na tabela), a_digitar (esperando o escritório transcrever no ERP) ou a_conferir (sem ligação automática com o pedido do ERP). situacao filtra pela situação (só em todos). busca aceita o código (MV000123, também MV 123 ou com o sufixo da perna do ERP, como MV000123-01) ou o código do cliente no ERP. Filtros como os da tela: representanteIds (os representante.id das linhas), o período pela data de CRIAÇÃO (criadoDe/criadoAte), ligacao (com/sem/a_conferir) e pedidoErp (o nº do pedido no ERP ligado). Total em CENTAVOS (Regra 2). total é a contagem completa; 25 por página. **"ÚLTIMO pedido" / "pedido mais recente" = use enviados: true e pegue o primeiro da lista (do mais novo para o mais antigo): rascunho NÃO é pedido feito. Se a pessoa quer saber de rascunhos, ou se sem o filtro o primeiro for um rascunho, diga À PARTE ("há um rascunho mais recente, MV…, criado por X na filial Y"). Cada linha traz doUsuario (foi a própria pessoa que criou?), criadoPor (só nos assistentes do app) e filial — rascunho de OUTRA pessoa nunca é "o seu pedido". Para os ITENS de um pedido use pedidos.detalhe_do_pedido (a lista só traz a quantidade de itens). A linha com alteradoNoErp é de um pedido que o ERP ALTEROU depois do envio (total traz o valor do sistema e o do ERP, em centavos; itens/campos quantos mudaram): o que vale é o do ERP — diga isso, e use pedidos.detalhe_do_pedido para a lista do que mudou. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

pedidos.criar_pedido

ChatGPT
CRIA um RASCUNHO de pedido de venda do zero. Entrada: o cliente (clienteId, a chave cli:, ou cliente, o nome ou código como a pessoa disse), os itens — cada um com o produto (produtoId ou produto: nome/código), a medida dita (ex.: 138x188), a quantidade e, se pedido, descontoPct OU precoFinalCentavos (preço unitário em CENTAVOS), bonificacao, campanhaId — e, se pedido, representanteId, prazoPagamento, formaPagamento, frete, observacao e camposDoErp. O preço de cada item sai da tabela que vale para o cliente e para o representante; o desconto passa pela regra comercial do dia (teto da comercialização, campanhas) e, passando do limite, o pedido irá para a aprovação quando for enviado. O rascunho NÃO é enviado nem chega ao ERP. Quando cliente, produto ou medida casam com mais de uma opção, ou com nenhuma, nada é criado e a resposta lista as opções. Devolve o código do pedido (MV…), os itens com preço de tabela, desconto e subtotal, o total, os motivos de aprovação e os avisos (preço acima da tabela, campo do ERP obrigatório em falta). Valores em CENTAVOS (Regra 2). Efeito: cria um rascunho de pedido novo (nada é enviado nem chega ao ERP); nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

pedidos.detalhe_do_pedido

ChatGPT
O DETALHE de um pedido de venda: situação, filial, cliente (nome e código do ERP), representante, condição de pagamento, frete, e os ITENS um a um (produto, código, medida, quantidade, preço de tabela, desconto, preço final e total da linha), descontos e total. Use quando a pessoa pedir os itens, o conteúdo ou "como foi" um pedido — a lista (pedidos.buscar_pedidos) só diz QUANTOS itens há. Passe pedidoId (de pedidos.buscar_pedidos) ou codigo (MV000123). resumo é o texto pronto, em linhas: no WhatsApp, mostre-o como veio (lista curta, um item por linha), sem ids. Valores em CENTAVOS (Regra 2) nos campos numéricos; resumo já está em reais. alteradoNoErp só existe quando o ERP ALTEROU o pedido depois do envio (total, tipo de negociação, preço ou quantidade de linhas, linhas acrescentadas/removidas): o que vale é o do ERP — o restante do detalhe é o que o sistema gravou no envio. Diga isso à pessoa. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

pedidos.editar_rascunho

ChatGPT
ALTERA um pedido que ainda pode ser editado (rascunho, recusado ou com correção solicitada), passado por pedidoId ou codigo (MV000123). adicionar: itens novos, como em pedidos.criar_pedido. alterar: linhas existentes, achadas por produto (nome, código ou chave prd:) e, se preciso, medida, com a nova quantidade, descontoPct, precoFinalCentavos (CENTAVOS, unitário) ou bonificacao. remover: linhas achadas do mesmo jeito. Também troca prazoPagamento, formaPagamento, frete, observacao e camposDoErp. Os preços são recalculados pelo servidor; as demais linhas ficam como estão. Linha que casa com mais de uma, ou com nenhuma, não é alterada e a resposta lista as linhas do pedido. Não envia o pedido. Devolve o pedido como ficou, com os itens, o total e os avisos. Efeito: sobrescreve o conteúdo do rascunho — acrescenta, altera ou REMOVE linhas e troca as condições, substituindo o que havia; a alteração não pode ser desfeita por esta ferramenta. Não envia nada.

pedidos.enviar_pedido

ChatGPT
ENVIA um pedido em rascunho (ou devolvido para correção), passado por pedidoId ou codigo (MV000123). O destino é decidido pelo sistema: AGUARDANDO APROVAÇÃO quando o desconto passa do teto, há item bonificado ou sem preço vigente (e a empresa exige aprovação); senão segue para o escritório digitar no ERP ou direto para o ERP, nas integrações com envio direto. justificativa (opcional, 3 a 1000 caracteres) é exigida quando o pedido vai para aprovação. Os preços são fixados no envio, pela regra do dia. Devolve a situação do pedido depois do envio e o destino. Pedido que não está em rascunho ou correção solicitada não pode ser enviado. Efeito: tira o pedido do rascunho e o entrega ao fluxo de aprovação ou de digitação — e, nas integrações com envio direto, ao ERP da empresa; o rascunho deixa de ser editável e o envio não pode ser desfeito por esta ferramenta.

pedidos.pdf_do_pedido

ChatGPT
ENTREGA o PDF de um pedido de venda (o mesmo do botão "Baixar PDF" da gaveta do pedido): no chat vira um cartão com botão de baixar; no WhatsApp chega como documento. Use quando a pessoa pedir o PDF, a cópia ou "me manda o pedido". pedidoId é o id de uma linha de pedidos.buscar_pedidos. NÃO devolve o conteúdo do pedido — para ler os dados use pedidos.buscar_pedidos; para uma planilha do pedido, pedidos.planilha_do_pedido. Efeito: gera e guarda um PDF do pedido na caixa de arquivos da pessoa (temporária; expira sozinha) — não altera dados do negócio e nunca sobrescreve nem apaga nada. Chamar de novo gera outro arquivo.

pedidos.planilha_do_pedido

ChatGPT
ENTREGA a planilha Excel (.xlsx) de um pedido de venda (a mesma do botão de planilha da gaveta do pedido; os números batem com o PDF). No chat vira um cartão com botão de baixar; no WhatsApp chega como documento. pedidoId é o id de uma linha de pedidos.buscar_pedidos. NÃO devolve o conteúdo do pedido. Efeito: gera e guarda uma planilha Excel do pedido na caixa de arquivos da pessoa (temporária; expira sozinha) — não altera dados do negócio e nunca sobrescreve nem apaga nada. Chamar de novo gera outro arquivo.

pedidos.recusar_pedido

ChatGPT
RECUSA o desconto de um pedido que está AGUARDANDO APROVAÇÃO (a fila a_aprovar de pedidos.buscar_pedidos), passado por pedidoId ou codigo (MV000123): o pedido volta para quem o criou, como RECUSADO, com o motivo, para ser corrigido e enviado de novo. Mesmas regras de pedidos.aprovar_pedido: só quem aprova desconto e alcança o representante do pedido; pedido já decidido é recusado. comentario (3 a 1000 caracteres) é OBRIGATÓRIO e é o motivo que a PESSOA deu — pergunte antes, nunca invente. Devolve a situação do pedido depois da decisão. Efeito: sobrescreve a situação do pedido (de aguardando aprovação para recusado), o devolve a quem o criou e avisa essa pessoa; a recusa não pode ser desfeita por esta ferramenta.

pedidos.regra_comercial_vigente

ChatGPT
A regra comercial que vale HOJE para um cliente, na filial dele: a COMERCIALIZAÇÃO (blocos de distância × faixas de valor; o teto de desconto pela MÉDIA do pedido é a cascata da faixa, em centésimos de %; VPC informativo; categorias de exceção) e as CAMPANHAS (preço ou desconto por produto — com faixa de km, preço por medida, cascata, kit e associação mínima —, desconto por valor ou distância, compre N leve M). Com comercialização vigente, só as campanhas de PRODUTO valem junto (a linha ganha por campanha fica fora do teto) e as de valor e distância não; sem nenhuma das duas, todo desconto vai para aprovação. NENHUMA campanha é aplicada sozinha (desde 12/10/2026): estas são as OPÇÕES — o representante escolhe a de produto em cada item e marca as de valor e distância no pedido; sem escolha, o item fica no preço de tabela. Valores em CENTAVOS (Regra 2). distanciaKm nulo = desconhecida, e semDistancia diz por quê. A distância é o trajeto por ESTRADA da filial até o endereço de entrega do cadastro do cliente (fonteDaDistancia: "rota"); quando o mapa falha, é a linha reta até a sede do município ("linha_reta", aproximada). ruaRecusada: true = o endereço tinha rua e o mapa não chegou nela: o km é o da rota até a CIDADE (ou o da linha reta) — peça para conferir o endereço de entrega; cidadeDaDistancia ({ cidade, uf }, só junto da marca) é a cidade até onde o km foi medido. mapa (13/10/2026): { km, fonte, ruaRecusada?, linkDoTrajeto, versao } — linkDoTrajeto abre o trajeto da filial até o destino no Google Maps (sem chave); null = sem desenho do trajeto. Os ITENS das campanhas por produto (preço promocional, compre N leve M) só vêm para os produtos passados em produtoIds — sem eles a campanha aparece com itens vazio, o que NÃO quer dizer que nenhum produto está em promoção. Use o clienteId de clientes.buscar_clientes ou de pedidos.buscar_pedidos e os produtoId de produtos.buscar_produtos. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

pedidos.replicar_pedido

ChatGPT
CRIA um RASCUNHO novo copiando um pedido existente (mesmo cliente, condições e itens, pelos preços de HOJE) — o "repetir o último pedido". NÃO envia nem aprova: o rascunho fica pronto para a pessoa conferir e enviar. O pedido original não muda. Chame ESTA ferramenta assim que a pessoa pedir para repetir/replicar/inserir — a confirmação é feita pelo sistema (ele mostra o pedido inteiro e pede o "sim"); NUNCA peça "responda SIM" em texto no lugar de chamá-la. Passe pedidoId (de pedidos.buscar_pedidos) ou codigo (MV000123). Itens sem preço hoje e o que não pôde ser copiado vêm em itensSemPreco/avisosDosItens/avisos — diga-os à pessoa. Efeito: cria um rascunho de pedido novo (nada é enviado nem aprovado); nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

produtos.buscar_produtos

ChatGPT
Procura produtos do catálogo do ERP — pelo nome (o que o workspace deu e o do ERP), código, SKU ou EAN. O catálogo é da empresa inteira, sem recorte por filial. Cada linha traz produtoId, a chave que produtos.ver_produto pede, além do nome efetivo (nome), o do ERP (nomeNoErp, só quando diferente), EAN, situação (ativo/inativo) e categoria. Filtre por situacao ou por venda (se já vendeu alguma vez no histórico sincronizado, ou nunca vendeu) quando útil. Sem busca, devolve os produtos do catálogo em qualquer ordem. total é a CONTAGEM COMPLETA, e fontesSemCatalogo lista integrações do tenant que ainda não têm o catálogo mapeado (produtos delas não aparecem aqui). Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

produtos.foto_do_produto

ChatGPT
ENTREGA a foto de UM produto (a mesma da gaveta do produto): no chat vira um cartão com prévia e botão de baixar; no WhatsApp chega como imagem. Use quando a pessoa pedir a foto/imagem de um produto. produtoId vem de produtos.buscar_produtos. Produto sem foto cadastrada responde semFoto: true — diga isso, não invente. Para várias fotos, chame uma vez por produto. Efeito: gera e guarda uma cópia da foto do produto na caixa de arquivos da pessoa (temporária; expira sozinha) — não altera dados do negócio e nunca sobrescreve nem apaga nada. Chamar de novo gera outro arquivo.

produtos.preco_para_cliente

ChatGPT
As tabelas de preço que valem para UM cliente (a escolhida primeiro, com o motivo: pelo cliente, pela carteira, pela UF, a tabela padrão…) e, com produtoId, o preço daquele produto em cada uma. Preços em CENTAVOS (Regra 2); null = a tabela não tem o produto. Numa tabela do ERP o preço já inclui o acréscimo definido no sistema para ela — ou o acréscimo PRÓPRIO do produto naquela tabela, que substitui o da tabela (é o preço que o representante vê no pedido). As regras por representante e time usam o representante de quem pergunta — sem vínculo, esses níveis ficam de fora (representante: null). Onde a restrição por representante está ligada, só entram as tabelas liberadas ao representante de quem pergunta (restricaoPorRepresentante). Use o clienteId de clientes.buscar_clientes e o produtoId de produtos.buscar_produtos. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

produtos.ver_produto

ChatGPT
O cadastro efetivo de UM produto: nome efetivo e o do ERP, código, categoria, situação, os quatro campos sobreponíveis (nome, EAN, peso, marca — cada um com o valor que vale, a origem "nosso" ou "erp", e um aviso quando o ERP mudou o valor por baixo) e os campos personalizados do workspace. Use com o produtoId de produtos.buscar_produtos. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.agenda_do_dia

ChatGPT
Mostra as visitas PLANEJADAS de um dia (da própria pessoa ou, com usuarioId, de alguém da equipe que ela alcança), na ordem do roteiro: cliente, cidade, se já foi feita ou está pendente e o resultado, (o POSSÍVEL CLIENTE que a pessoa pôs na agenda aparece com possivelCliente: true, só nome e cidade) mais a situação do roteiro (rascunho, em aprovação, aprovado ou devolvido para ajuste), o tipo do roteiro (venda ou cobrança) e o nome que a pessoa deu à rota do dia, quando deu (nomeDaRota; rotaFixa é outra coisa: a rota fixa de onde o dia foi montado). Use quando a pessoa perguntar "o que tenho na agenda hoje/amanhã?", "como está a rota do Fulano?", "meu roteiro já foi aprovado?", "quantas visitas já fiz hoje?". dia ausente = hoje (fuso de São Paulo). Máximo de 25 visitas. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.analise_das_rotas

ChatGPT
Analisa o cumprimento das rotas da equipe num período, por pessoa: visitas planejadas × feitas × canceladas, visitas com e sem pedido, conversão, tempo médio na visita, visitas esquecidas ou longe da loja e as horas trabalhadas de quem registra jornada, mais os totais e os principais motivos de perda. Use quando a pessoa perguntar "como foi o cumprimento da equipe na semana?", "quem não está fazendo as visitas?", "quantas visitas o Fulano fez este mês?". Período padrão: os últimos 7 dias (de/ate, no máximo 31 dias). Com mes (AAAA-MM) a análise é do mês e traz também cumprimentoDoMes: o % de CUMPRIMENTO oficial (visitas feitas ÷ planejadas de roteiro aprovado, contra o mínimo do workspace) — sem mes, não calcule % de cumprimento: as feitas incluem visitas avulsas. usuarioId filtra uma pessoa da equipe (o id vem desta mesma ferramenta). Só enxerga a equipe que quem pergunta alcança, e só com a página Equipe. NÃO traz km percorridos (o sistema não registra o trajeto feito): não invente esse número — naoCalculado lista o que falta. pedidosLigadosAsVisitasCentavos é a soma dos pedidos do sistema ligados às visitas, em centavos — não é o faturamento do ERP. Máximo de 25 pessoas. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.aprovar_roteiro

ChatGPT
APROVA o roteiro de um dia que está aguardando aprovação (ou foi devolvido): roteiroId de rotina.roteiros_para_aprovar e a versao de rotina.ver_roteiro_para_aprovar — a do roteiro que a pessoa VIU; se ele mudou depois, a aprovação é recusada (409) e é preciso abrir de novo. Só quem aprova aquele roteiro (a equipe da pessoa, na filial, nunca o próprio). O roteiro de quem é dispensado de aprovação já está aprovado: a ferramenta diz isso e não faz nada. Confirma com a pessoa mostrando o roteiro e avisa quem o montou. Efeito: sobrescreve a situação do roteiro (para aprovado) — as paradas passam a valer para o cumprimento da rotina — e envia o aviso a quem o montou; a aprovação não pode ser desfeita por esta ferramenta.

rotina.buscar_possiveis_clientes

ChatGPT
Lista (ou busca por nome) os POSSÍVEIS CLIENTES da Rotina — quem ainda não está no ERP e foi (ou será) visitado — que a pessoa alcança: os dela e, para supervisor, os da equipe. Cada um vem com prospectId, nome, cidade/UF, situação (EM_PROSPECCAO, EM_CADASTRO, CONVERTIDO, NAO_DEU_CERTO), aceitaVisita (pode ir para a agenda), a integração, o dono (quem cadastrou), quantas visitas teve e quando foi a última. Use quando a pessoa perguntar "quais possíveis clientes eu tenho?", "acha a Padaria Nova Esperança", "quais estão em prospecção?", ou antes de rotina.colocar_na_agenda (prospectIds) e das ferramentas de editar, "não deu certo" e reabrir — o prospectId vem daqui. busca = parte do nome; situacao filtra; usuarioId só a pessoa da equipe indicada (fora do alcance a lista vem vazia). Até 25 por chamada (total conta todos; use pagina). NÃO traz telefone, e-mail, documento, endereço de rua nem coordenada — isso fica na tela do possível cliente. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.cadastrar_possivel_cliente

ChatGPT
CRIA um POSSÍVEL CLIENTE na Rotina — alguém que ainda não está no ERP e vai ser (ou foi) visitado: o «Novo cliente (sem cadastro)» do Planejar. Informe o nome (da pessoa ou da empresa) e ONDE ele fica: cidade + uf, ou o CEP/endereço — a tela exige a cidade e a UF. O resto é opcional: contato, telefone (com DDD), email, cep, logradouro, numero, bairro, observacao. integracao (o NOME da integração) só é preciso quando a pessoa alcança mais de uma; com mais de uma e sem dizer qual, nada é criado e a resposta lista as opções. Peça à pessoa o que falta em vez de inventar: nunca preencha telefone, e-mail nem endereço que ela não disse; o documento do possível cliente não se informa por aqui — fica na tela dele. Devolve o prospectId — use-o em rotina.colocar_na_agenda (prospectIds) para pôr o possível cliente na agenda. Isto NÃO cadastra cliente no ERP nem cria pedido: virar cliente é o cadastro de cliente, na tela. Telefone, e-mail e endereço não voltam na resposta. Efeito: cria um possível cliente novo na Rotina (registro do Mov+; nada é enviado ao ERP); nada do que já existe é alterado, sobrescrito ou removido. Não é idempotente: chamar de novo cria um registro adicional.

rotina.clientes_no_caminho

ChatGPT
Lista os clientes da carteira/alcance de quem pergunta que ficam NO CAMINHO entre uma origem e um destino, para visitar ou vender na viagem. Use quando a pessoa perguntar "estou indo para <cidade>, quem eu visito no caminho?", "quais clientes tenho na rota de A para B?". Informe destino (cidade+uf OU clienteId); a origem é opcional — sem ela vale o endereço-base da pessoa (se não houver, a ferramenta pede a cidade de origem). desvioMaximoKm (padrão 30, máximo 100) é o quanto o cliente pode ficar longe da linha reta origem→destino. A resposta vem do começo para o fim do caminho, com kmDesdeAOrigem e desvioKm; quando há mais clientes que o limite, vêm os de MENOR desvio. ATENÇÃO: todas as distâncias são em LINHA RETA (metodo: "linha_reta"), não pela estrada — diga isso ao citar km. precisao diz se o ponto é a loja/endereço ou só o centro da cidade (nesse caso o desvio é aproximado). semLocalizacao conta quem não pôde ser avaliado por não ter ponto no mapa. Máximo de 25 clientes. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.clientes_perto

ChatGPT
Lista os clientes da carteira/alcance de quem pergunta que ficam PERTO de um lugar (uma cidade, um cliente ou, sem centro, o endereço-base da pessoa), do mais perto ao mais longe. Use quando a pessoa perguntar "quem fica perto de <cidade>?", "que clientes tenho aqui por perto?", "quem visito perto desse cliente?". raioKm (padrão 20, máximo 150) é o raio. ATENÇÃO: as distâncias são em LINHA RETA (metodo: "linha_reta"), não pela estrada — diga isso ao citar km. precisao diz se o ponto é a loja/endereço ou só o centro da cidade (distância aproximada). semLocalizacao conta quem não pôde ser avaliado por não ter ponto no mapa. Máximo de 25 clientes. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.colocar_na_agenda

ChatGPT
Coloca clientes na agenda de visitas de UM dia (da própria pessoa ou, com usuarioId, de alguém da equipe que ela planeja), na ordem dada. Use quando a pessoa pedir "coloque esses clientes na minha agenda de hoje", "agende essas visitas para amanhã", "monte a agenda do Fulano com esses clientes" — os clienteIds vêm de rotina.clientes_no_caminho, rotina.clientes_perto, rotina.sugerir_rota, clientes.buscar_clientes ou rotina.oportunidades_da_carteira. substituir: false (padrão) ACRESCENTA ao que o dia já tem, sem duplicar parada e sem tirar as visitas existentes; substituir: true deixa só a lista dada (as visitas planejadas que ficarem de fora são canceladas). nome (opcional, até 60 caracteres) dá um nome à rota do dia, como no Planejar; ausente = o nome que o dia já tem fica como está (esta ferramenta nunca apaga o nome nem troca o tipo — venda ou cobrança — de um dia já salvo). dia ausente = hoje. As regras são as da tela: agenda de dia passado só o supervisor muda; para planejar a agenda de OUTRA pessoa é preciso a permissão de planejar e que ela esteja no seu alcance; cliente fora do seu alcance é recusado. Pede confirmação antes de gravar, mostrando os nomes. Devolve a agenda do dia como ficou e a situação do roteiro (o envio vai para a aprovação do supervisor). Máximo de 25 clientes por chamada. Efeito: grava a agenda do dia — com substituir: true sobrescreve a agenda e cancela as visitas planejadas que ficam de fora da lista ("Retirada da agenda"); ao acrescentar, as visitas existentes são mantidas, mas um roteiro já aprovado volta para a aprovação do supervisor, que é avisado. Isso não pode ser desfeito por esta ferramenta (a tela cancela visitas e o envio).

rotina.devolver_roteiro

ChatGPT
DEVOLVE para ajuste o roteiro de um dia que está aguardando aprovação, dizendo o que mudar: roteiroId de rotina.roteiros_para_aprovar, versao de rotina.ver_roteiro_para_aprovar (a que a pessoa VIU; se mudou depois, é recusado com 409) e observacao (3 a 1000 caracteres, OBRIGATÓRIA — é o que a pessoa disse que precisa mudar; pergunte, nunca invente). O roteiro volta a quem o montou, que é avisada com a observação. Só quem aprova aquele roteiro. Roteiro já aprovado (inclusive por dispensa) não pode ser devolvido. Efeito: sobrescreve a situação do roteiro (de aguardando aprovação para devolvido para ajuste), o devolve a quem o montou e a avisa com a observação; a devolução não pode ser desfeita por esta ferramenta.

rotina.editar_possivel_cliente

ChatGPT
EDITA os dados de um POSSÍVEL CLIENTE que a pessoa alcança (prospectId de rotina.buscar_possiveis_clientes): nome, contato, telefone (com DDD), email, cep, logradouro, numero, bairro, cidade, uf, observacao. Informe SÓ o que muda — o resto fica como está; a integração não muda. Use quando a pessoa pedir "corrija o telefone da Padaria", "mude a cidade do possível cliente X". Só vale para possível cliente em prospecção ou em cadastro (encerrado ou convertido é recusado). Vale a validação da tela (telefone com DDD, UF de 2 letras, CEP de 8 dígitos). O documento do possível cliente e a localização do aparelho NÃO se editam por aqui — ficam na tela. Peça à pessoa o que falta; nunca invente contato nem endereço. Pede confirmação antes de gravar; o telefone, o e-mail e o endereço que a pessoa disse são gravados mas NÃO voltam na confirmação nem na resposta. Efeito: sobrescreve os campos informados do possível cliente (registro do Mov+; nada vai ao ERP); o valor anterior não é guardado. Isso não pode ser desfeito por esta ferramenta (a tela edita de novo).

rotina.montar_dia_pela_rota

ChatGPT
Monta a agenda de UM dia — ou da semana — a partir de uma ROTA FIXA da pessoa (as paradas da rota entram na agenda): o «Montar o dia pela Rota N» / «Montar a semana» do Planejar. O rotaId vem de rotina.rotas_fixas (as da pessoa e as compartilhadas com ela; com usuarioId, as dessa pessoa da equipe). Use quando a pessoa pedir "monte meu dia pela Rota 2", "monte a semana do Fulano pela rota dele". modo DIA (padrão) = só o dia inicio (ausente = hoje); SEMANA = os dias úteis a partir de inicio, até 5 dias, paradasPorDia em cada (padrão 8). O que o dia já tem FICA; a rota entra depois, sem repetir cliente, até o teto do dia; parada fora do seu alcance (filial, carteira) é pulada e contada — salvo, na rota COMPARTILHADA com você, o cliente de fora da sua carteira que o dono da rota alcança: ele entra no dia (marcado «Fora da carteira») e é contado em foraDaCarteiraQueEntraram. Cada dia é um roteiro normal: vai para a aprovação do supervisor (quem é dispensado de aprovação já fica aprovado). Para planejar a agenda de OUTRA pessoa (usuarioId) é preciso a permissão de planejar e que ela esteja no seu alcance. Agenda de dia passado só o supervisor muda. Pede confirmação antes de gravar. Devolve, por dia, quantas paradas entraram, quantas já estavam e quantas ficaram de fora pelo teto, e se algum dia foi recusado (com a frase da regra). Não cria nem edita a rota fixa (isso é na tela). Efeito: grava a agenda dos dias montados — acrescenta as paradas da rota ao que o dia já tem (nada é removido) e envia o roteiro à aprovação do supervisor (um roteiro já aprovado volta a pendente, e o supervisor é avisado). Isso não pode ser desfeito por esta ferramenta (a tela cancela visitas e o envio).

rotina.oportunidades_da_carteira

ChatGPT
As melhores oportunidades de venda da carteira de quem pergunta, calculadas pela plataforma (Rotina › Inteligência), ordenadas pelo score 0–100: cliente, cidade, tipo (Reativação, Reposição, Expandir mix ou Crescimento), potencial em R$ nos próximos 90 dias (quanto lojas do mesmo porte compram a mais, por categoria), os sinais em frases e os produtos recomendados com a chance estimada. Traz também o resumo da carteira, as categorias onde está o dinheiro e os produtos para focar. Valores em CENTAVOS. É uma leitura do cálculo diário: calculadoEm diz quando foi feito. disponivel: false traz o motivo (ex.: faltam categorias mapeadas) — nesse caso não há número a citar. Máximo de 10 clientes. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.possivel_cliente_nao_deu_certo

ChatGPT
Marca um POSSÍVEL CLIENTE como NÃO DEU CERTO, com o MOTIVO (obrigatório, de 3 a 500 caracteres): a pessoa decidiu que não vai virar cliente. prospectId de rotina.buscar_possiveis_clientes. Use quando a pessoa pedir "a padaria desistiu", "dê baixa nesse possível cliente — comprou do concorrente". Peça o motivo se ela não o deu; nunca invente. Só vale para possível cliente em prospecção ou em cadastro (já encerrado ou convertido é recusado). Pede confirmação antes de gravar. Efeito: sobrescreve a situação do possível cliente para «Não deu certo» e grava o motivo (registro do Mov+; nada vai ao ERP). Isso não pode ser desfeito por esta ferramenta (rotina.reabrir_possivel_cliente o reabre).

rotina.reabrir_possivel_cliente

ChatGPT
REABRE um POSSÍVEL CLIENTE que estava como NÃO DEU CERTO: ele volta a «Em prospecção» e o motivo da baixa é apagado. prospectId de rotina.buscar_possiveis_clientes (filtre situacao: NAO_DEU_CERTO). Use quando a pessoa pedir "reabra a padaria", "ele voltou a querer comprar". Só vale para quem está em «Não deu certo»; os outros são recusados. Pede confirmação antes de gravar. Efeito: sobrescreve a situação do possível cliente de «Não deu certo» para «Em prospecção» e apaga o motivo (registro do Mov+; nada vai ao ERP). Isso não pode ser desfeito por esta ferramenta (rotina.possivel_cliente_nao_deu_certo marca de novo, com novo motivo).

rotina.rotas_da_equipe

ChatGPT
Mostra, para UM dia, o que cada pessoa da equipe que quem pergunta alcança tem PLANEJADO: se tem roteiro, o nome da rota, quantas paradas, quantas já foram feitas e a situação da aprovação (rascunho, em aprovação, aprovado, devolvido para ajuste ou sem roteiro). Use quando a pessoa perguntar "quem tem roteiro hoje?", "quem ainda não montou a agenda de amanhã?", "o roteiro do pessoal já foi aprovado?". Quem TEM roteiro vem primeiro e resumo conta a equipe inteira (com e sem roteiro). dia ausente = hoje (fuso de São Paulo); vale dia passado, hoje ou futuro, aprovado ou não. NÃO traz o mapa nem as paradas de cada pessoa (nem endereço ou coordenada): para ver os clientes de UMA pessoa use rotina.agenda_do_dia com o usuarioId dela. Só enxerga a equipe que quem pergunta alcança, e só para quem pode planejar, ver todas as agendas ou aprovar roteiros. Até 50 linhas (a equipe lida chega a 300 pessoas; resumo conta todas). Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.rotas_fixas

ChatGPT
Lista as ROTAS FIXAS cadastradas (Rota 1 a 4 e a coringa de cobrança) da própria pessoa ou, com usuarioId, de alguém da equipe que ela alcança: nome, tipo (venda ou cobrança), posição e quantos clientes cada uma tem. Use quando a pessoa perguntar "quais são as minhas rotas?", "quantos clientes tem a Rota 2?", "que rotas o Fulano tem cadastradas?". Não lista os clientes de cada rota. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.roteiros_para_aprovar

ChatGPT
A FILA de quem aprova roteiros: os roteiros do dia que a equipe da pessoa (ou todos, com a permissão de ver tudo, na filial) mandou para APROVAÇÃO — nunca o roteiro da própria pessoa. Use quando perguntarem "tem roteiro para eu aprovar?", "quem mandou a agenda?", "o que está pendente na minha aprovação?". situacao: PENDENTE (padrão, aguardando), DEVOLVIDO, APROVADO ou TODAS; de/ate (AAAA-MM-DD, pelo dia do roteiro) e usuarioId (de uma linha desta lista ou de rotina.rotas_da_equipe) filtram. Cada linha traz roteiroId, o dia, quem montou, o nome da rota, quantas paradas e quantas feitas, a situação e se foi aprovado por DISPENSA (quem é dispensado de aprovação já tem o roteiro aprovado e não aparece em PENDENTE). Para ver as paradas e a versao use rotina.ver_roteiro_para_aprovar; para decidir, rotina.aprovar_roteiro ou rotina.devolver_roteiro. Só para quem tem a permissão de aprovar roteiros. 25 por página (total conta todos). Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.ver_possivel_cliente

ChatGPT
Mostra UM possível cliente da Rotina: situação, cidade/UF, integração, dono, o motivo do "não deu certo" (se houver), as últimas visitas (data, situação e resultado) e o que a pessoa pode fazer agora com ele (visitar, editar, "não deu certo", reabrir). Use depois de rotina.buscar_possiveis_clientes (o prospectId vem de lá) quando a pessoa quiser o histórico ou saber se ainda dá para visitar/editar. Fora do alcance da pessoa ou inexistente: "não encontrado". NÃO traz telefone, e-mail, documento, endereço de rua nem coordenada. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

rotina.ver_roteiro_para_aprovar

ChatGPT
Abre UM roteiro da fila de aprovação (o roteiroId de rotina.roteiros_para_aprovar): quem montou, o dia, o nome da rota, a observação, a situação da aprovação, as paradas na ordem (cliente, cidade e em que pé está — as CANCELADAS aparecem, para o aprovador ver o que saiu) e a versao, que rotina.aprovar_roteiro e rotina.devolver_roteiro exigem. podeAprovar/podeDevolver dizem o que ainda dá para fazer; aprovadoPorDispensa: true = a pessoa é dispensada de aprovação e o roteiro já está aprovado (não há o que aprovar). Fora de quem a pessoa aprova é 404. NÃO traz endereço nem coordenada. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

workspace.list_pending_files

ChatGPT
Lista os arquivos que a pessoa enviou e que ainda não foram vinculados a nenhum registro. Use para obter o fileId antes de anexar (a um lançamento financeiro, item de board, etc.). Lista vazia significa que ela ainda não enviou nada — peça que envie pelo campo de anexo do chat; você NÃO consegue enviar arquivo. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

workspace.list_units

ChatGPT
Filiais (unidades de negócio) às quais o usuário tem acesso neste workspace. Use para descobrir o unitId obrigatório ao criar registros e para restringir uma listagem a uma filial específica. Omitir unitId numa listagem significa visão consolidada. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

workspace.whoami

ChatGPT
Devolve o workspace (slug) e a filial ativa da sessão — e, nos assistentes do próprio app, o NOME e o id de quem está falando. Use quando a pessoa perguntar em qual workspace ou filial está, ou antes de uma ferramenta que dependa de "eu"/"minhas" (só nos assistentes do app) ou da filial atual; as demais ferramentas já respondem pelo acesso da própria pessoa, não é preciso chamar esta antes delas. Não devolve papel nem permissões: o acesso é decidido por grupo, e o que a pessoa pode fazer aparece no resultado de cada ferramenta. Pelo MCP não devolve nome nem identificadores de pessoa. Efeito: somente leitura — devolve dados do workspace da pessoa; não cria, altera nem apaga nada.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/movmais"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/movmais)