analytics.clientes_com_titulo_vencido
ChatGPTClientes 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
ChatGPTClientes 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
ChatGPTCliente × 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
ChatGPTENTREGA 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
ChatGPTRanking 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
ChatGPTVendas, 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
ChatGPTClientes 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
ChatGPTVendas 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
ChatGPTVendas 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
ChatGPTProdutos 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
ChatGPTRanking 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
ChatGPTVendas, 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
ChatGPTA 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
ChatGPTAs 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
ChatGPTA 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
ChatGPTENTREGA 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
ChatGPTENTREGA 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
ChatGPTVincula 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
ChatGPTCria 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
ChatGPTLista 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
ChatGPTAbre 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
ChatGPTProcura 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
ChatGPTLista 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
ChatGPTRegistra 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
ChatGPTO 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
ChatGPTLista 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
ChatGPTMostra 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
ChatGPTVincula 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
ChatGPTLista 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
ChatGPTMuda 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
ChatGPTCria 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
ChatGPTAssina 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
ChatGPTCria 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
ChatGPTExclui 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
ChatGPTLista 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
ChatGPTLista 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
ChatGPTLista 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
ChatGPTPausa 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
ChatGPTA 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
ChatGPTCadastra 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
ChatGPTAPROVA 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
ChatGPTOs 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
ChatGPTCRIA 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
ChatGPTO 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
ChatGPTALTERA 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
ChatGPTENVIA 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
ChatGPTENTREGA 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
ChatGPTENTREGA 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
ChatGPTRECUSA 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
ChatGPTA 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
ChatGPTCRIA 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
ChatGPTProcura 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
ChatGPTENTREGA 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
ChatGPTAs 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
ChatGPTO 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
ChatGPTMostra 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
ChatGPTAnalisa 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
ChatGPTAPROVA 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
ChatGPTLista (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
ChatGPTCRIA 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
ChatGPTLista 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
ChatGPTLista 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
ChatGPTColoca 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
ChatGPTDEVOLVE 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
ChatGPTEDITA 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
ChatGPTMonta 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
ChatGPTAs 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
ChatGPTMarca 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
ChatGPTREABRE 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
ChatGPTMostra, 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
ChatGPTLista 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
ChatGPTA 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
ChatGPTMostra 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
ChatGPTAbre 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
ChatGPTLista 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
ChatGPTFiliais (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
ChatGPTDevolve 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.