MCP App Store
by KeenEthics
Alvore Finance icon

Alvore Finance MCP Server for Claude and ChatGPT

By Alvore Consultoria

Overview

O Alvore Finance conecta o Claude à plataforma da Alvore Consultoria, onde empresas (PJ) e pessoas (PF) acompanham o próprio financeiro com dados do Open Finance e do ERP. Para quem é: consultores da Alvore, titulares de empresas clientes e clientes pessoa física com conta na plataforma. Cada um enxerga só o que a própria conta já vê no app. O que dá para ler: - Empresas: DRE, indicadores, visão geral do mês, orçamento, fluxo de caixa e transações bancárias categorizadas; plano de contas e regras de categorização; dados do ERP conectado (títulos em aberto, produtos, ficha técnica, estoque). - Pessoa física: visão geral do mês, orçamento familiar, transações e o veredito "posso fazer esta compra?" pelo método da Alvore. - Projetos: briefings e artefatos HTML da consultoria. O que dá para escrever (só com os escopos concedidos na tela de consentimento): - Projetos, artefatos HTML e novas versões. O que a consultoria escreve só chega ao cliente depois de um clique humano na plataforma. - Classificação de transações e ajustes do plano de contas, com simulação antes e desfazer depois. - Cadastro de produtos, fichas técnicas e movimentos de estoque (livro só de acréscimo, correção por estorno). - Propostas de ação no ERP, executadas somente após aprovação humana. O conector não movimenta dinheiro: nenhuma ferramenta inicia pagamento, transferência ou compra. A autenticação é OAuth 2.1 com consentimento por escopo, e as leituras de dado financeiro ficam registradas em trilha de auditoria.

How to connect

  1. Claude: Open the Alvore Finance listing in the Claude connectors directory and choose Connect. Claude listing Alvore Finance exposes 45 tools here.
  2. ChatGPT: Open the Alvore Finance listing in the ChatGPT app directory and choose Connect. ChatGPT listing Alvore Finance exposes 81 tools here.

Tools

abrir_chamado

ChatGPT
Registra um chamado na fila de suporte da Alvore em nome da empresa, com título, relato e, quando houver, a tela, os passos, o resultado esperado e o que aconteceu. Devolve o número do chamado. O mesmo título aberto pela empresa nas últimas 24 horas devolve o chamado já aberto, e há um teto de 5 chamados por empresa em 24 horas. O chamado é triado pela equipe da Alvore; esta tool não devolve resposta ao relato.

alterar_plano_contas

ChatGPT
Altera o plano de contas PJ. operacao: "papel_grupo" troca o papel DRE de um grupo (grupoId, papel — string do enum ou null para "Automático"). operacao: "mover_categoria" move uma categoria para outro grupo (categoriaId, novoGrupoId). operacao: "papel_subcategoria" troca o budgetRole de uma subcategoria (subcategoriaId, budgetRole). operacao: "mover_subcategoria" move uma única subcategoria (com todas as suas transações) para outra categoria (subcategoriaId, novaCategoriaId) — é como levar só "PIS e COFINS" para "Deduções" sem arrastar o resto de "Impostos". Toda chamada devolve o efeito na DRE dos últimos 12 meses (transações e soma por mês que mudam de papel), calculado sobre o estado anterior à alteração. simular: true calcula e devolve o mesmo efeito sem gravar nada, como prévia do impacto da alteração.

alterar_regra

ChatGPT
(Des)ativa uma regra TENANT (aprendida desta empresa) das automações de categorização. Regra GLOBAL (curada pela consultoria) responde 403 — não é editável por aqui. Não afeta transações já classificadas, só os syncs futuros. A resposta traz regra.id e regra.enabled.

aplicar_patch

ChatGPT
Grava uma nova versão de um artefato trocando só trechos do HTML, sem reenviar o documento inteiro: cada substituição {old, new} é aplicada em sequência sobre o resultado da anterior, e old tem de ocorrer exatamente uma vez no HTML-base (trecho que se repete é recusado como ambíguo). Tudo-ou-nada: se alguma falhar, nada é gravado e a resposta diz qual (índice 0-based) e quantas ocorrências achou (0 = não existe, 2+ = ambíguo). A base é a versão de trabalho da consultoria: o último rascunho pendente escrito pela consultoria, se houver, senão a corrente. Proposta do cliente (autorTipo "CLIENTE") não entra como base: ela fica no histórico até um humano publicá-la ou não. O HTML de qualquer versão, inclusive a versão-base, sai de ler_artefato com version; versaoBase na resposta confirma qual versão foi usada. Payload total (old + new) até 1 MB. Em artefato em RASCUNHO a nova versão vira a corrente. Em artefato PUBLICADO ela é gravada como rascunho pendente (rascunhoPendente: true na resposta): o cliente continua vendo a versão atual até um humano publicar a nova no histórico da plataforma. É assim que um artefato já publicado recebe correção sem gerar um segundo artefato. A resposta traz linkNoApp (endereço do artefato na plataforma) e proximoPasso (frase curta de status do que foi gravado, pronta para o usuário). A referência de formato do HTML (identidade visual Alvore, ponte de estado e os modelos checklist, acompanhamento e painel; com o módulo Produtos ligado, também os modelos das telas de lugar) está em ler_guia_artefato.

atualizar_contexto_projeto

ChatGPT
Substitui o briefing do engajamento de um projeto (markdown livre, até 20000 caracteres). É texto da consultoria, não do cliente: ele não aparece na plataforma do cliente. A substituição é integral, sem merge: o valor enviado passa a ser o briefing inteiro, e o texto anterior não fica guardado (não há histórico para desfazer). O texto atual é o campo contexto de listar_projetos. String vazia apaga o contexto.

avaliar_compra_pf

ChatGPT
Calcula se uma compra (à vista ou parcelada) cabe no orçamento do cliente pessoa física, mês a mês; responde a perguntas do tipo "posso fazer esta compra?". Para cada mês em que a parcela cai, devolve a folga antes e depois da parcela e se cabe, além do primeiro mês que fica negativo e da menor folga. Folga de um mês futuro = renda planejada − fixas orçadas − parcelas e dívidas já registradas para o mês − meta de aporte − variável típico (média de 90 dias) + entradas − saídas de lançamentos futuros cadastrados. No mês corrente, no lugar do variável típico, desconta o maior entre o variável já gasto e a projeção de fim de mês. O saldo em conta não entra no cálculo e a meta de aporte não conta como folga. Com token do titular, entram só as dívidas manuais que ele mesmo cadastrou; com token de consultor, todas. Se primeiroMes for anterior ao mês corrente, ou a última parcela passar do horizonte de 36 meses contado a partir do mês corrente, a resposta marca horizonteInsuficiente e cabe = false.

classificar_transacao

ChatGPT
Classifica uma transação bancária PJ e, conforme o escopo, propaga a mesma classificação para as outras transações do estabelecimento. escopo: "transacao" grava só esta linha e a trava (a propagação por estabelecimento e a reclassificação em lote passam a pulá-la). escopo: "estabelecimento" aprende uma regra pela identidade da contraparte e reclassifica retroativamente as outras transações do mesmo estabelecimento (exceto as travadas e as de sinal incompatível com a subcategoria). A subcategoria vai em subcategoriaId ou em subcategoriaNome, exatamente um dos dois; os dois juntos, ou nenhum, respondem 400. transacaoId vem de ler_transacoes (modo "linhas", campo id). simular: true não grava nada — devolve a transação-alvo (subcategoria atual → nova, se já está travada) e, em escopo "estabelecimento", uma prévia de quantas outras transações seriam reclassificadas (afetadas), quebra por mês, quantas seriam puladas por trava ou por sinal (puladasPorTrava, puladasPorSinal) e uma amostra de até 20 linhas; serve para medir o alcance de uma propagação por estabelecimento antes de gravá-la. A execução real (sem simular) devolve loteId, o identificador que desfazer_classificacao aceita para reverter esta chamada.

criar_artefato

ChatGPT
Cria um artefato HTML dentro de um projeto, com a versão 1 do conteúdo. O artefato nasce como RASCUNHO. Publicar é sempre um clique humano na plataforma. Com lugar, o artefato é a tela de um lugar do menu de um módulo (ex.: Produtos › Ficha técnica): ele nasce RASCUNHO no projeto de sistema dos módulos, chega como prévia na página do lugar e só passa a valer quando o administrador da empresa ou a consultoria toca em "Usar esta tela" na plataforma. O HTML é um documento completo e autocontido (até 5.000 KB); ele roda em iframe sandbox sem rede. A resposta traz linkNoApp (endereço do artefato na plataforma) e proximoPasso (frase curta de status do que foi gravado, pronta para o usuário). A referência de formato do HTML (identidade visual Alvore, ponte de estado e os modelos checklist, acompanhamento e painel; com o módulo Produtos ligado, também os modelos das telas de lugar) está em ler_guia_artefato.

criar_projeto

ChatGPT
Cria um projeto da consultoria na empresa e devolve o projectId. Cada chamada cria um projeto novo, exceto o replay do mesmo clientRequestId. Não há checagem de projeto com tema parecido; os projetos existentes estão em listar_projetos.

desfazer_classificacao

ChatGPT
Desfaz um lote de classificação manual (loteId devolvido por classificar_transacao ou por ler_historico_classificacao): reverte cada transação para o estado anterior e, se o lote tinha aprendido/tocado uma regra, desfaz essa ação também ("CREATED" desativa; "UPDATED"/"DISABLED" restaura o estado anterior). Transação alterada depois deste lote, ou que não existe mais, é listada em conflitos (com motivo) e não é revertida; com conflitos não vazio a reversão é parcial, e o lote fica marcado como desfeito mesmo assim (as transações em conflito não voltam mais por este lote). O campo regra vem "desativada", "restaurada", "conflito" (a regra mudou depois do lote e ficou como está) ou null (o lote não tocou regra). simular: true só conta revertidas/conflitos/regra, sem gravar nada. Lote já desfeito responde 409, então a mesma chamada repetida não desfaz duas vezes. Também respondem 409 o lote do par com a caixinha (origem CAIXA) e o desfazer dele, que só a tela Caixa do app reverte, o lote da categoria do título ERP conciliado (origem ERP) e o desfazer dele, que só a própria conciliação reverte, e o lote que tocou a transação de banco de um par ativo com a caixinha, enquanto o par estiver ativo.

encerrar_run

ChatGPT
Fecha um run aberto por iniciar_run com status 'done' ou 'failed' e um resumo de uma frase do que foi feito, exibido no cockpit. A contagem de tokens do modelo e o custo são opcionais e informados por quem chama; o servidor não os mede. Um run já encerrado devolve o estado gravado, sem sobrescrever. Um run aberto com um token OAuth renovado depois pode ser encerrado com o token renovado da mesma conexão (mesmo dono, mesmo aplicativo e mesmo alvo) quando o agente e a empresa informados são os do run.

estornar_movimento_estoque

ChatGPT
Estorna um movimento do livro de estoque nativo: grava um movimento do tipo ESTORNO com a quantidade oposta, datado de hoje (BRT), no mesmo local e apontando para o original, que não é alterado nem apagado. O livro não tem edição nem exclusão; a correção de um lançamento é o estorno seguido de um novo lançamento. Cada movimento aceita um único estorno (um segundo responde 409). Um movimento do tipo ESTORNO não pode ser estornado, e movimentos de ordem de produção (CONSUMO_OP, PRODUCAO_OP) são recusados (422). O estorno é aceito também em movimento de produto arquivado.

excluir_plano_contas

ChatGPT
Exclui do plano de contas PJ um grupo (nivel: "grupo", grupoId), uma categoria (nivel: "categoria", categoriaId) ou uma subcategoria (nivel: "subcategoria", subcategoriaId), ids de ler_plano_contas. A exclusão é em cascata: o grupo leva as categorias dele e a categoria leva as subcategorias dela. As transações classificadas no que sai voltam a não classificadas (pendentes, fora da DRE até serem classificadas de novo); as regras de categorização e o de-para ERP que apontavam para essas subcategorias são removidos (os títulos do ERP voltam a "a Identificar"). Não há desfazer. Subcategoria com lançamento na caixinha de dinheiro físico é recusada (409): o livro da caixinha só se corrige por estorno. A resposta traz quantos grupos, categorias, subcategorias, transações, regras e de-para ERP foram afetados; simular: true devolve as mesmas contagens sem excluir nada.

importar_plano_contas

ChatGPT
Deixa o plano de contas PJ da empresa igual a um plano gerencial (ex.: o do ERP do cliente), em lote: cria, renomeia, reordena e reativa grupos, categorias e subcategorias, e grava o codigoExterno (código da classe no ERP, único por empresa) em cada subcategoria. A subcategoria é identificada pelo codigoExterno (sem código, adota a de mesmo nome na categoria); categoria e grupo, pelo nome ou por categoriaId/grupoId para renomear. A ordem das linhas é a ordem da árvore. Entrada: csv (texto com separador ;, colunas grupo, papel, categoria, codigo, subcategoria, sinal, budgetRole, atividade — o cabeçalho casa por prefixo) OU linhas. dePara move as transações de uma subcategoria antiga (subcategoriaId de ler_plano_contas) para a nova (codigoExterno), com histórico desfazível em desfazer_classificacao (o desfazer devolve as transações; regras TENANT e de-para ERP levados junto ficam na conta nova), e leva junto regras TENANT e de-para ERP; transação cujo sinal o destino não aceita, ou casada com a caixinha, fica onde está e é contada. Subcategoria antiga que esvazia é INATIVADA, nunca apagada, e as regras TENANT dela são desligadas; inativarAusentes: true inativa também as ausentes do arquivo sem histórico (com histórico seguem ativas, listadas em mantidasComHistorico). Arquivo com qualquer erro é recusado inteiro, com a lista de erros. Receita financeira (budgetRole *_INCOME) em grupo DESPESA_FINANC é coerente: o "(±) Resultado Financeiro" da DRE soma com sinal. Toda chamada devolve criados, renomeados, inativados e o efeito na DRE dos últimos 12 meses (por mês e por papel), calculado sobre o estado anterior; simular: true devolve o mesmo resultado sem gravar.

iniciar_run

ChatGPT
Abre um run (execução) de um agente sobre uma empresa e devolve o runId. Indicada para marcar o início de um trabalho do agente. Enquanto houver run aberto (até encerrar_run), as leituras auditadas, as propostas, os projetos e as versões de artefato feitos com o mesmo token ficam ligados, no cockpit, ao run aberto mais recente desse token. Abrir um run encerra como 'failed' o run ainda aberto do mesmo token e do mesmo agente. Repetir o mesmo clientRequestId devolve o run já criado (replay: true), e o campo status indica se ele ainda está aberto; um run encerrado não é reaberto, e um clientRequestId diferente abre outro run.

lancar_movimento_estoque

ChatGPT
Lança um movimento (ENTRADA, SAIDA, AJUSTE ou SALDO_INICIAL) no livro de estoque nativo de um produto ativo (produtoId ou codigo, exatamente um); produto arquivado é recusado (422). ENTRADA, SAIDA e SALDO_INICIAL recebem quantidade positiva e o tipo define o sinal. AJUSTE recebe a diferença contada, com sinal e diferente de zero. SALDO_INICIAL só é aceito quando o produto não tem nenhum movimento naquele local. data em YYYY-MM-DD, não posterior a hoje (BRT). O livro é só de acréscimo: esta tool não edita nem apaga movimentos, e a correção de um lançamento é o estorno dele seguido de um novo lançamento. Saldo negativo é aceito e sinalizado em alertas. extras guarda campos livres do lançamento (fornecedor, destino, motivo) e o estorno não os copia.

ler_artefato

ChatGPT
Devolve o HTML de um artefato (a versão corrente, ou a versão indicada em version — inclusive o rascunhoPendente de listar_artefatos). Funciona para rascunho e publicado.

ler_caixinhas_pf

ChatGPT
Caixinhas (metas) do cliente pessoa física: reserva de emergência, projetos de vida e PGBL, com meta, valor atual (investido, em conta ou manual), percentual atingido, prazo e aporte mensal necessário para chegar à meta no prazo. Os valores são os da tela de Caixinhas.

ler_capacidade

ChatGPT
Minutos livres e ocupados por profissional em cada dia do período, a partir da grade, das ausências, dos negócios marcados no CRM e das entregas agendadas. Negócios sem profissional aparecem em semVinculo. Período de até 366 dias.

ler_categorias_pf

ChatGPT
Taxonomia de categorias do cliente pessoa física: grupos e subcategorias (as da base e as criadas para ele), com o papel no orçamento de cada uma, e as regras de classificação próprias do cliente. Regra por contraparte aparece pelo nome da contraparte; o documento não é devolvido.

ler_compromissos_pf

ChatGPT
O que o cliente pessoa física tem a pagar e a receber nos próximos 30 dias, dia a dia: faturas de cartão, contas fixas, assinaturas, dívidas, lançamentos pontuais e entradas de renda previstas, com o total de saídas, a entrada prevista e a sobra. É a mesma fila de 'Próximos 30 dias' da Visão Geral e do Fluxo de Caixa.

ler_conexoes_pf

ChatGPT
Conexões bancárias (Open Finance) ativas do cliente pessoa física: instituição, situação, se precisa reconectar, se o banco limitou a consulta, quando a conexão foi atualizada e a data da transação mais recente. Conexão desconectada de propósito não aparece. É a mesma lista da tela de Contas conectadas do app.

ler_configuracao_servicos

ChatGPT
Configuração do módulo Serviços da empresa: ponto de partida (base: SESSAO, PACOTE, PROJETO ou HORAS), formas de contrato oferecidas no formulário do CRM, regraFaltaPadrao dos contratos novos (CONTA ou NAO_CONTA), duracaoPadraoMin de atendimento sem duração definida, avisoPacoteRestante (pacote acabando quando restar até esse número), diasParado e diasVencendo dos filtros de contrato. version é a versão da configuração; 0 indica empresa sem configuração salva (vale o padrão). propostaPendente traz a sugestão de configuração ainda não conferida na tela, ou null. O catálogo e a equipe estão em ler_servicos e ler_equipe.

ler_contexto_empresa

ChatGPT
Devolve o contexto cadastral e de classificação de uma empresa: identidade (CNPJ, razão social, nome fantasia, CNAE, descrição do CNAE e segmento estimado a partir do CNAE), até 30 grupos do plano de contas PJ (id textual do grupo, nome e papel na DRE; não são ids de subcategoria) e até 15 descrições de saída mais recorrentes nas transações. Para consultor e agente, inclui também regrasHumanas: até 20 regras de categorização do tenant (padrão → nome da subcategoria), sem filtro de aprovação nem de ativação, o que inclui propostas do agente ainda não revisadas e regras desativadas; para o titular da empresa esse campo não é devolvido. Indicada quando a análise precisa da identidade, do plano de contas, dos fornecedores recorrentes ou das regras de categorização da empresa.

ler_contratos_servico

ChatGPT
Contratos de serviço da empresa (avulso, pacote, recorrente, projeto) com o saldo de cada serviço: contratado, consumido e restante. Filtros: parados, vencendo, acabando. Com contratoId, devolve um contrato com itens, saldo e as 20 entregas mais recentes; sem ele, uma página por cursor, do mais recente ao mais antigo. No RECORRENTE o saldo é o do mês corrente (dia de Brasília).

ler_dados_bling

ChatGPT
Linhas de um recurso de leitura sincronizado do Bling, da data mais recente à mais antiga, cada uma com sourceId, data, titulo, valor e dados. recurso aceita 'canais_venda', 'vendedores', 'formas_pagamento', 'situacoes', 'pedidos_compra', 'notas_fiscais', 'notas_consumidor', 'notas_servico', 'caixas', 'contas_financeiras', 'propostas', 'contratos', 'ordens_servico', 'produtos_loja', 'anuncios', 'remessas' e 'fornecedores_produto'. Recurso ainda sem dado responde total: 0. Pedidos de venda ficam em ler_pedidos_venda_erp.

ler_diagnostico_da_conta

ChatGPT
Devolve o diagnóstico da conta da empresa na Alvore: a situação (anda sozinha, falta passo ou parada) e cada passo para a empresa andar sozinha (banco conectado, transações classificadas nos últimos 30 dias, ERP para quem usa, IA conectada), com o estado de cada um e, nos pendentes, o que resolve e a tela da Alvore onde se resolve. Só contagens e estados, sem valores financeiros. Indicada para responder dúvidas de uso e de configuração da conta.

ler_dividas_pf

ChatGPT
Painel de dívidas do cliente pessoa física, o mesmo da aba Dívidas: quanto compromete por mês e a fração da renda, contratos aprovados com saldo, parcela, CET e custo acima da referência de mercado, ordem de ataque sugerida, contratos do Open Finance aguardando aprovação e posição líquida investimentos × dívidas. Com token de consultor, as dívidas manuais incluem as que a consultoria cadastrou.

ler_equipe

ChatGPT
Profissionais da empresa com especialidades, grade semanal (dia da semana 0 = domingo, início e fim HH:MM) e ausências. custoHora só aparece para quem vê custo.

ler_estado

ChatGPT
Devolve o blob de estado que o time da empresa gravou no artefato (ex.: itens marcados num checklist). Só leitura: o estado é dado do cliente e não pode ser escrito por aqui.

ler_estoque

ChatGPT
Saldos do lote de estoque ativo, na data da última posição sincronizada (dataPosicao). codigo filtra um produto; ausente devolve a base inteira (até limite).

ler_estrutura

ChatGPT
Componentes da ficha técnica de um produto pai, do lote de estoque ativo. encontrado: false quando o código não tem nenhuma linha de estrutura no lote — não é o mesmo que "produto sem componentes".

ler_eventos

ChatGPT
Eventos de buffet da cópia sincronizada do ERP da empresa (hoje, BuffetMax), no lote ativo de títulos de cada conexão. cliente só com dígitos filtra pelo id do cliente no ERP (igualdade exata); outro texto busca no nome do cliente (sem diferenciar maiúsculas nem acentos). periodoDe/periodoAte filtram a data do evento (YYYY-MM-DD, inclusive). status filtra por lista. truncado: true quando há mais eventos do que limite.

ler_extrato_sem_lancamento_erp

ChatGPT
Movimentos do extrato bancário da empresa (conta corrente, status lançado) que ainda não têm título no Conta Azul, do mais recente para o mais antigo. Cada item traz id (o transactionId de conta_azul:criar_lancamento), data, valor, sentido, tipo ('pagar' ou 'receber'), descrição, contraparte, conta bancária, possivelBaixa (há título em aberto parecido no Conta Azul) e sugestoes de categoria, contato e conta financeira, com sugerido quando a sugestão é única. opcoes lista os ids aceitos na proposta: categorias por tipo, contatos e contas financeiras do Conta Azul. Sai da cópia sincronizada, sem chamar o Conta Azul. desde define o primeiro dia da janela (padrão 90 dias, máximo 365); truncado: true indica transações além do teto de leitura, e semLoteAtivo: true indica que o Conta Azul ainda não sincronizou (sem sugestões nem opções).

ler_faturas_cartao_pf

ChatGPT
Faturas dos cartões de crédito do cliente pessoa física, por cartão: a fechada a pagar (vencimento, total, mínimo, situação), a aberta em curso (total e composição) e as parcelas já conhecidas das próximas faturas, agregadas por vencimento. São os mesmos números do card de faturas da Visão Geral. Os valores são de caixa (data de vencimento).

ler_ficha_tecnica_alvore

ChatGPT
Ficha técnica vigente de um produto nativo (componentes, quantidades, perda, rendimento), identificado por produtoId ou codigo (exatamente um). ficha: null indica produto sem ficha. Com explodir: true, inclui a necessidade de insumos folha para quantidade (default 1) unidades do produto, até niveis (default 10); explosao: null quando o produto não tem ficha. Cada insumo da explosão traz custoUnitario, custo e origemCusto (padrao = custo padrão do produto; ultima_entrada = última entrada de estoque não estornada; null = sem custo), e a explosão traz custoTotal, custoPorUnidade e insumosSemCusto.

ler_financeiro

ChatGPT
Devolve uma visão financeira agregada da empresa (sem transações individuais). visao: "dre" (totais, quebra por classe e por mês, estágios), "indicadores" (DRE mensal + classificação fixo/variável), "visao_geral" (3 números do mês corrente + vencimentos dos próximos 30 dias), "orcamento" (meta × realizado por papel DRE) ou "fluxo_caixa" (DFC: saldo inicial → atividades (operacional/investimento/financiamento, com "a identificar" separado e as transferências internas do grupo já eliminadas) → saldo final, por mês; saldos vêm do saldo informado pelo banco quando há registro (saldoInicialOrigem/saldoFinalOrigem = "banco"; "calculado" = deduzido das transações), e o que as transações não explicam aparece no balde nao_explicado; e atividadesPorSubcategoria, a atividade configurada (ou padrão, quando a subcategoria nunca foi editada) de cada subcategoria que apareceu no período — é assim que o plano de contas expõe a atividade de fluxo de caixa no MCP. Consolidado do grupo (todas as contas da empresa, inclusive a de caixa de dinheiro físico quando houver), sem recorte por CNPJ. Todo valor monetário de fluxo_caixa é em centavos inteiros). meses: lista "YYYY-MM" (1 a 12); ausente = mês corrente. visao_geral é sempre do mês corrente (o mês pedido só é conferido, e observacao aparece quando difere). orcamento é mono-mês e usa o mês mais antigo da lista. dre, indicadores e fluxo_caixa aceitam vários meses; em dre e indicadores, se nenhum mês pedido tiver dado, a resposta traz todos os meses disponíveis (mesesSolicitados × selectedMonths mostra a diferença).

ler_guia_artefato

ChatGPT
Devolve a referência de formato do HTML de um artefato Alvore: identidade visual (cores, tipografia, CSS base), restrições da sandbox do iframe, o script da ponte que salva o que o usuário marca e um esqueleto HTML por tipo. Quando a empresa tem o módulo Produtos ligado, inclui também a API de dados (alvoreDados) e os modelos estoque, ficha_tecnica, ordem_producao e ordem_compra, que são também as telas dos lugares do menu Produtos (parâmetro lugar de criar_artefato); com o CRM ligado, os dados do CRM e o modelo contrato; com o módulo Serviços ligado, os dados de Serviços e os modelos contratos_servico, catalogo_servicos e equipe_servicos, que são também as telas dos lugares do menu Serviços. Serve para montar o HTML enviado a criar_artefato, nova_versao ou aplicar_patch. Sem tipo, devolve a referência geral e a lista de modelos. Não devolve o conteúdo de artefatos existentes (esse é o papel de ler_artefato).

ler_historico_classificacao

ChatGPT
Lista o histórico de classificação manual da empresa: lotes (tela, lote, MCP, caixa, ERP ou desfazer), mais recentes primeiro, com origem, escopo, autor (actorUserId), subcategoria nova (subcategoryIdNova), regra aprendida e a ação nela (ruleId, ruleAction, se houve) e se já foi desfeito. Com transacaoId, lista só as mudanças daquela transação, uma por lote que a tocou. loteId é o identificador aceito por desfazer_classificacao. desfazivel é false para lote já desfeito, para lote do par com a caixinha (origem CAIXA) e o desfazer dele, que só a tela Caixa do app desfaz, e para lote da categoria do título ERP conciliado (origem ERP) e o desfazer dele, que só a própria conciliação desfaz; lote com desfazivel: true que tocou a transação de banco de um par ativo com a caixinha ainda responde 409 em desfazer_classificacao.

ler_historico_pf

ChatGPT
Resultado mês a mês do cliente pessoa física num período de 2 a 12 meses (de/ate "YYYY-MM"): quanto entrou, gastou, guardou e sobrou, e a composição dos gastos (contas fixas, dia a dia, parcelas, assinaturas). Os números são os mesmos da tela de Orçamento por período. O mês corrente vem marcado como parcial.

ler_liberdade_financeira_pf

ChatGPT
Projeção de liberdade financeira do cliente pessoa física a partir das premissas salvas no planejamento: idade atual e alvo, renda desejada, aporte, patrimônio investível e taxas; resultado com anos até a meta, patrimônio necessário, até que idade dura e saldo ano a ano. Sem premissas suficientes, a resposta diz o que falta.

ler_modelos_contrato

ChatGPT
Modelos de documento do contrato da empresa: os ativos, com finalidade (CONTRATO ou ADITIVO, derivada do texto) e versão; para quem administra a empresa, também as sugestões pendentes de propor_modelo_contrato. formato traz a sintaxe do texto, os limites e a lista fixa de variáveis aceitas. Com modeloId ou propostaId, inclui o texto daquele item. Modelo arquivado não aparece.

ler_movimentos_estoque

ChatGPT
Livro de movimentos de estoque nativo, do mais recente ao mais antigo, paginado por cursor. Aceita filtro por produto (produtoId ou codigo) e por período (de/ate, YYYY-MM-DD). estornado: true indica que já existe um estorno apontando para o movimento.

ler_opcoes_baixa_erp

ChatGPT
Consulta em tempo real, no ERP da empresa, as contas correntes (e, no Lote Mobile, as formas de pagamento) cadastradas, com os ids numéricos usados no payload de baixa. Só leitura: não altera o ERP nem movimenta dinheiro. Aceita provider 'lote_mobile' (devolve contasCorrentes e formasPagamento, ids de contaCorrenteId/formaPagamentoId; integracaoBancaria: true indica a conta que o ERP usa para remessa bancária) e 'omie' (devolve só contasCorrentes, cujo id é o contaCorrenteId de omie:baixar_conta_pagar e omie:incluir_conta_pagar; inativa: true é recusada na execução).

ler_orcamento_pf

ChatGPT
Orçamento do cliente pessoa física num mês: os 4 KPIs (renda, fixas, variáveis, sobra — planejado × realizado), o teto de gastos variáveis do mês (teto, gasto, disponível, status, projeção de fim de mês) e a árvore da DRE familiar podada (grupo → categoria → subcategoria, cada nó com meta, realizado e saldo). mes: "YYYY-MM"; ausente = mês corrente.

ler_ordens_compra

ChatGPT
Pedidos de compra nativos da empresa. O pedido é um registro interno: não movimenta o estoque e não é enviado ao fornecedor (a entrada da mercadoria é lançada no estoque à parte). Sem id: lista paginada por cursor, do mais recente ao mais antigo, com filtro por status, fornecedor (parte do nome) e busca (número do pedido, fornecedor ou código/descrição de produto de algum item); cada pedido traz totalItens e valorEstimado (soma de quantidade × preço combinado dos itens com preço, ou null). Com id: o pedido com itens (produto, quantidade na unidade do produto e custoUnitario combinado) e a version usada na edição.

ler_ordens_producao

ChatGPT
Ordens de produção nativas da empresa. Sem id: lista paginada por cursor, da mais recente à mais antiga, com filtro por status e produtoId. Com id: o detalhe de uma ordem, com movimentos (as linhas do livro de estoque ligadas a ela) e, quando PLANEJADA, consumoPrevisto: as matérias-primas que iniciar vai baixar (a ficha gravada na ordem, descendo pelas fichas vigentes dos semiacabados, sem os itens que não controlam estoque), cada uma com quantidade, saldo atual somado de todos os locais e falta (o que passa do saldo). Fora de PLANEJADA, consumoPrevisto vem vazio e o consumo real está em movimentos.

ler_parcelas_pf

ChatGPT
Compras parceladas e compromissos do cliente pessoa física, com o mesmo cálculo do painel de Dívidas: valor mensal, progresso, mês de término de cada parcela, quais aguardam aprovação e a linha do tempo dos próximos 12 meses com os meses em que o compromisso mensal cai. Devolve até 100 compras; a resposta informa o total e se houve corte.

ler_patrimonio_pf

ChatGPT
Patrimônio do cliente pessoa física, o mesmo da aba Meu Patrimônio: totais de ativos, passivos e patrimônio líquido, composição por tipo, passivos detectados ainda não aprovados (fora do líquido) e a lista de imóveis e bens móveis cadastrados. Em bem financiado, o saldo devedor fica em financiamento (parcela, parcelas restantes, saldo e mês do término) e saldoDevedor do bem é 0. Sem lista de investimentos e sem contratos.

ler_pedidos_venda_erp

ChatGPT
Pedidos de venda sincronizados do ERP (hoje o Bling) com data dentro do período, do mais recente ao mais antigo. Traz total de pedidos, somas por situação e por loja, e cada pedido com número, data, cliente, situação, loja, total, itens, parcelas e frete. Itens e parcelas chegam em rodadas: temDetalhe: false indica pedido ainda sem eles, e semDetalhe conta esses pedidos no período. As somas incluem todas as situações, inclusive cancelados. Situação e vendedor vêm com id e nome (situacaoNome, vendedorNome, nulos quando o cadastro ainda não sincronizou); a loja vem só como id. Sem período, usa o mês corrente.

ler_plano_contas

ChatGPT
Árvore do plano de contas PJ da empresa (grupos → categorias → subcategorias, com ids, papel DRE do grupo e budgetRole da subcategoria). Os ids devolvidos são os aceitos por alterar_plano_contas (grupoId, categoriaId, novoGrupoId, subcategoriaId, novaCategoriaId) e o subcategoriaId aceito por classificar_transacao.

ler_produtos

ChatGPT
Produtos do lote de estoque ativo (matéria-prima, semiacabado, acabado — a classificação vem do ERP, sem tradução nossa). codigo filtra por igualdade exata; busca casa código ou descrição (os dois podem coexistir).

ler_produtos_alvore

ChatGPT
Lista o catálogo nativo de produtos da empresa na Alvore (o cadastro nativo tem precedência sobre a cópia do ERP), paginado por cursor. busca casa código ou descrição; tipo filtra pelo tipo do cadastro nativo. Com incluirErp: true, e só quando a empresa tem a trilha de estoque do ERP liberada, a primeira página (sem cursor e sem tipo) inclui também os produtos da cópia do ERP ainda não importados, com origem: "erp"; os nativos vêm com origem: "nativo". O campo erpIncluido da resposta indica se a junção ocorreu.

ler_propostas

ChatGPT
Lista as propostas de escrita no ERP da empresa, criadas no cockpit ou por este conector, da mais recente para a mais antiga, com o status de cada uma ('proposed'/'awaiting_second'/'approved'/'rejected'/'executed'/'failed'/'reverted'). Devolve total e até limite itens; cada item traz ultimaExecucao ({id, status, errorMessage}, ou null se a proposta nunca foi executada). Serve para acompanhar o andamento de propostas já criadas.

ler_regras

ChatGPT
Lista as regras determinísticas de categorização ativas e aprovadas desta empresa: o dicionário curado pela consultoria (origin: "GLOBAL") e as regras aprendidas da própria empresa (origin: "TENANT"). Regras desativadas não aparecem nesta lista. Regra por documento (CPF/CNPJ) não expõe o documento: o rótulo é o nome da contraparte ou um texto genérico. Nas demais regras, o rótulo é a descrição limpa de uma transação representativa ou, na falta dela, o próprio padrão de texto.

ler_saldo_estoque_alvore

ChatGPT
Saldo do estoque nativo por produto e local. Sem emData, devolve o saldo atual; com emData (YYYY-MM-DD), a soma do livro até aquele dia. Aceita filtro por produtoIds ou por busca (código/descrição) e por local. O saldo pode ser negativo, quando uma saída foi lançada antes da entrada correspondente. Cada linha traz estoqueMinimo do produto (null = sem mínimo), controlaEstoque e abaixoDoMinimo (true quando o produto controla estoque, tem mínimo e o saldo somado de todos os locais é menor que ele).

ler_servicos

ChatGPT
Catálogo de serviços da empresa, por código, paginado por cursor; busca casa parte do código ou do nome. Com servicoId, devolve um serviço com o roteiro vigente (etapas e insumos), as horas previstas e, para quem vê custo, custo das horas, custo dos insumos e margem.

ler_sugestao_compra

ChatGPT
Sugestão de compra calculada na hora, sem gravar nada. Entram os produtos ativos que controlam estoque e têm estoqueMinimo. Para cada um, projetado = saldo (todos os locais) − necessidadeOps (o que as ordens de produção PLANEJADAS vão baixar dele ao iniciar, descendo pelas fichas até as matérias-primas) + emPedidos (itens de pedidos de compra em RASCUNHO ou ENVIADA). Só aparece quem fica abaixo do mínimo; sugerido é a diferença, arredondada para cima no múltiplo de fatorEmbalagem quando o produto tem fator (com sugeridoEmbalagens). fornecedor é o primeiro fornecedor preferido do produto. Itens ordenados por fornecedor e descrição; fornecedores resume quantos itens há por fornecedor.

ler_tarefas_pf

ChatGPT
Tarefas e documentos do cliente pessoa física na jornada de consultoria, com o mesmo recorte da tela Tarefas e docs: tarefas atribuídas ao cliente (título, descrição, status, prioridade, vencimento) e a lista de documentos enviados (nome, tipo, etiquetas, data). Sem link de arquivo e sem conteúdo extraído dos documentos.

ler_titulos_em_aberto_erp

ChatGPT
Títulos e parcelas ainda não quitados (status open ou partial) da cópia sincronizada do ERP, do vencimento mais antigo ao mais novo. Cada linha traz titleSourceId, parcelaId, vencimento, valor, valor em aberto, status, contraparte e descrição; total conta todas as parcelas em aberto. titleSourceId/parcelaId são os identificadores aceitos numa proposta de baixa. kind padrão: 'payable' (a pagar). No Omie só há contas a pagar, e o título é a própria parcela (parcelaId = titleSourceId).

ler_transacoes

ChatGPT
Transações das contas da empresa (Open Finance e, quando houver, caixa de dinheiro físico) no mês mes. modo: "agregado" (default) devolve quantidade e total por categoria/papel mais os totais do mês, sem nenhuma linha. modo: "linhas" devolve linhas individuais (data desc, empate por id); nesse modo limite (1 a 200) é obrigatório e a paginação é por offset (default 0). A resposta traz total (após filtros), offset, devolvidas, truncado e proximoOffset (null quando não há mais linhas). Cada linha traz id (identificador da transação), subcategoriaId (id numérico da subcategoria, ou null) e travada (se a linha está travada contra reclassificação). O campo de documento (CPF/CNPJ) da contraparte não é devolvido, e CPF/CNPJ pontuado é removido da descrição. Filtros opcionais (valem nos dois modos, aplicados sobre o mês lido): conta (contém, sem acento/caixa, no nome da conta), subcategoriaId, categoria (nome exato da subcategoria, sem acento/caixa), semCategoria (só linhas sem subcategoria) e travada.

ler_transacoes_pf

ChatGPT
Transações bancárias (Open Finance) do cliente pessoa física num mês (mes "YYYY-MM"; ausente = mês corrente) ou num intervalo de até 366 dias (de e ate "YYYY-MM-DD", no lugar de mes), com filtros opcionais por texto, categoria, valor e sentido. modo: "agregado" (default) devolve quantidade e total por categoria/papel e os totais do período (os mesmos da tela do app, sem filtro; com filtro, a soma das linhas que casaram), sem linhas individuais. modo: "linhas" devolve linhas individuais em ordem de data decrescente, pagina por offset e exige limite (1 a 200); a resposta informa quantas linhas existem e se houve corte. O campo de documento da contraparte (CPF/CNPJ) não é devolvido nem pesquisado. Nos textos, CPF completo (11 dígitos, com ou sem pontuação) é removido; CNPJ e documentos parcialmente mascarados pelo banco podem aparecer na descrição ou no nome da contraparte.

ler_visao_geral_pf

ChatGPT
KPIs do mês corrente do cliente pessoa física — os mesmos da home do app: resultado até agora (receita, gasto, sobra e comparação com o mês anterior), teto de gastos variáveis (teto, gasto, disponível, projeção de fim de mês), fluxo do mês (entrou, fixas, variáveis) e as maiores categorias variáveis. Sem série diária e sem extrato.

listar_artefatos

ChatGPT
Lista os artefatos HTML da empresa (qualquer status), com artifactId, projectId, título, status, versão corrente e rascunhoPendente ({version, nota, createdAt, autorTipo}, ou null) — a versão gravada por nova_versao/aplicar_patch num artefato publicado que ainda espera o clique humano; autorTipo: "CLIENTE" indica proposta enviada pelo titular da empresa, não rascunho da consultoria. lugar ({id: "<MODULO>/<lugar>", estado: previa | em_uso | guardada}, ou null para artefato avulso) marca a tela de um lugar do menu de um módulo. O parâmetro opcional projectId restringe a lista a um projeto.

listar_clientes

ChatGPT
Lista os clientes pessoa física que este token pode ler, com clientId e nome. Com token de consultor, traz a carteira vinculada (a base inteira, se admin); com token do próprio titular, traz só ele. O clientId devolvido aqui é o parâmetro clientId das demais tools PF deste conector; o nome não é aceito no lugar dele.

listar_conexoes_erp

ChatGPT
Lista as conexões ERP da empresa: provider, status, data do último sync de títulos e do último sync de estoque e, no lote de estoque ativo (a versão vigente da cópia sincronizada), a contagem de produtos, linhas de ficha técnica, saldos e ordens de produção (zeradas quando o estoque nunca sincronizou). Mostra se há dado de estoque sincronizado para ler_produtos, ler_estrutura e ler_estoque, que leem esse lote.

listar_empresas

ChatGPT
Lista as empresas (PJ) que este token pode operar, com empresaId, nome e CNPJ. O empresaId devolvido aqui (não o nome nem o CNPJ) é o identificador que as demais tools desta integração recebem no parâmetro empresaId.

listar_projetos

ChatGPT
Lista todos os projetos de uma empresa (ativos, concluídos e arquivados), com projectId, nome, status, visibilidade, origem ("CONSULTORIA" ou "CLIENTE", o espaço que o próprio cliente criou) e contexto: o briefing do engajamento em texto livre, escrito pela consultoria (objetivo, combinados com o cliente, o que evitar).

nova_versao

ChatGPT
Grava uma nova versão completa do HTML de um artefato; a anterior vira histórico. Em artefato em RASCUNHO a nova versão vira a corrente. Em artefato PUBLICADO ela é gravada como rascunho pendente (rascunhoPendente: true na resposta): o cliente continua vendo a versão atual até um humano publicar a nova no histórico da plataforma. É assim que um artefato já publicado recebe correção sem gerar um segundo artefato. Numa tela de lugar em uso, a versão nova chega como prévia na página do lugar; lugar, quando informado, confere que o artefato é a tela daquele lugar. Esta tool recebe o documento inteiro; aplicar_patch grava uma versão enviando só os trechos alterados, sem reenviar um HTML grande. A resposta traz linkNoApp (endereço do artefato na plataforma) e proximoPasso (frase curta de status do que foi gravado, pronta para o usuário). A referência de formato do HTML (identidade visual Alvore, ponte de estado e os modelos checklist, acompanhamento e painel; com o módulo Produtos ligado, também os modelos das telas de lugar) está em ler_guia_artefato.

propor_acao_erp

ChatGPT
Cria uma proposta de escrita no ERP, com status 'proposed'. A tool não aprova nem executa: aprovação e execução são feitas por uma pessoa no cockpit da Alvore. Pares provider:action ativos nesta instalação: conta_azul:baixa, omie:incluir_estrutura, omie:incluir_produto, omie:ajuste_estoque, lote_mobile:baixa, buffetmax:criar_orcamento, conta_azul:criar_lancamento; par não registrado ou desativado é recusado. Mesmo com o par ativo, a proposta é recusada se o título ou a parcela não existir na cópia sincronizada da empresa (404), se já houver proposta ativa para a mesma parcela ou execução de resultado desconhecido no mesmo alvo (409) ou, nos pares omie:*, se a empresa não tiver a trilha de estoque liberada (404). Baixa de título (ex.: lote_mobile:baixa, que no Lote Mobile existe só para contas a pagar): registra no ERP que um título já foi quitado. A execução exige que uma pessoa tenha aceitado a conciliação entre o título e a transação bancária do pagamento, com valor igual ao da parcela sincronizada, e envia ao ERP só o registro da baixa, sem chamada a banco nem ordem de pagamento. Campos da baixa: kind e titleSourceId juntos (400 se vier só um), mais parcelaId quando o ERP separa parcela, com os valores listados por ler_titulos_em_aberto_erp; no payload, beneficiario, valor, data (AAAA-MM-DD), conta (texto), contaCorrenteId e formaPagamentoId. Esses dois últimos são ids numéricos cadastrados no ERP, os mesmos listados por ler_opcoes_baixa_erp, e não são conferidos contra o ERP quando a proposta é criada. buffetmax:criar_orcamento propõe um orçamento novo para um cliente já cadastrado no BuffetMax: targetRef = idCliente e payload {idCliente, clienteNome?, dataEvento 'YYYY-MM-DD' (não retroativa), horarioInicio 'HH:MM', duracaoMinutos?, evento, convidados {adultos, criancas}, idLocal?, idTipoEvento?, idVendedor?, idPacotes? [ids], itens? [{idItem, idGrupo, qtd}], escolhasPacote? [idItem], obsExterna?, valorTotal (R$)} — é preciso ao menos idPacotes ou itens; ids são strings só de dígitos; chave desconhecida é recusada. conta_azul:criar_lancamento registra no Conta Azul, já quitado na conta financeira, um movimento do extrato bancário da empresa que não tem título lá: payload {transactionId, categoriaId?, contatoId?, contaFinanceiraId?}, os três ids sendo UUIDs do Conta Azul, e nenhuma outra chave é aceita. O valor, a data, o sentido (a pagar ou a receber) e a descrição do lançamento vêm da transação, não do payload, e o alvo da proposta é a própria transação (targetRef = tx:<transactionId>, sem kind/titleSourceId). Id ausente é preenchido pela sugestão do servidor quando ela é única; contraparte sem cadastro no Conta Azul, escolha ambígua ou id fora da cópia sincronizada são recusados (422) com a lista de candidatos (id e nome) na mensagem; uma transação tem no máximo uma proposta ativa (409). Sem desfazer pelo conector nem pelo cockpit depois de executadas: lote_mobile:baixa, buffetmax:criar_orcamento, omie:incluir_estrutura, omie:incluir_produto e omie:ajuste_estoque. A resposta traz proposalId e status, e a proposta criada aparece na listagem de ler_propostas.

propor_configuracao_produtos

ChatGPT
Grava uma proposta de configuração do módulo Produtos: os lugares ligados no menu Produtos (lugares, a lista inteira; estoque fica sempre e ordem_producao liga ficha_tecnica junto), prévias de tela de lugar que passam a valer (telas: artefato criado com criar_artefato e o parâmetro lugar, ainda em prévia; aba entra como aba nova no fim, substituir guarda as telas em uso do lugar) e nomes novos de telas de lugar (renomear). Com a proposta gravada, nada do que está em uso muda: ela fica pendente até um administrador conferir em Produtos › Configurar, mudança por mudança, e usar ou descartar. Cada empresa tem uma proposta pendente por vez; gravar outra substitui a anterior. Lugar desconhecido, artefato que não é prévia de lugar de Produtos desta empresa ou formato inválido não grava nada e responde 422 com os campos a corrigir. Só quem administra a empresa grava a proposta.

propor_configuracao_servicos

ChatGPT
Grava uma proposta de configuração do módulo Serviços: ajustes do modelo (base e modelo, no formato de ler_configuracao_servicos, só os campos que mudam), serviços do catálogo (por codigo: código novo cria, existente edita os campos enviados) e pessoas da equipe (por id, ou pelo nome quando ele já existe na equipe; senão, pessoa nova). Com a proposta gravada, nada do que está em uso muda: ela fica pendente até um administrador conferir na tela, mudança por mudança, e usar ou descartar. Cada empresa tem uma proposta pendente por vez; gravar outra substitui a anterior. ativo: false tira do catálogo ou da equipe (nada é apagado). Custo, roteiro e ausências não fazem parte da proposta. Formato inválido não grava nada e responde 422 com os campos a corrigir. salvar_servico e salvar_profissional continuam gravando direto, sem proposta. Só quem administra a empresa grava a proposta.

propor_modelo_contrato

ChatGPT
Grava uma sugestão de modelo de documento do contrato (CONTRATO ou ADITIVO). Nenhum modelo é criado nem alterado: a sugestão fica pendente até quem administra a empresa conferir a prévia e aplicá-la ou descartá-la na tela de modelos. Com modeloId, a sugestão é uma nova versão desse modelo; sem ele, um modelo novo. Uma sugestão pendente por modelo (ou por nome, no modelo novo); gravar de novo substitui a anterior. Até 10 pendentes por empresa. O texto segue o formato de ler_modelos_contrato; variável fora da lista, chaves abertas ou variável de bloco fora de linha própria respondem 422 com linha, coluna e as variáveis válidas do grupo, e nada é gravado. Emitir documento, registrar aditivo, anexar e estornar não existem no conector. Só quem administra a empresa grava a sugestão.

salvar_contrato_servico

ChatGPT
Cria, edita ou muda a situação de um contrato de serviço; não gera cobrança. Sem id: cria em RASCUNHO (clienteId, forma, itens, inicio e clientRequestId obrigatórios; PROJETO exige fim). Com id + version (de ler_contratos_servico ou do atual de um 409): edita um contrato em RASCUNHO ou ATIVO; cliente e forma não mudam; itens substitui a lista inteira; version diferente da gravada responde 409 com o contrato atual. Com id + acao + clientRequestId: ativar, pausar, retomar, concluir ou cancelar; transição fora do caminho responde 409.

salvar_ficha_tecnica

ChatGPT
Grava uma nova versão da ficha técnica de um produto (produtoId ou codigo, exatamente um) e a torna a vigente. A versão anterior deixa de ser vigente e fica no histórico, sem ser apagada (este conector lê só a vigente). Cada item traz componenteId ou componenteCodigo (exatamente um) e quantidade > 0. Recusa componente repetido, o próprio produto como componente e ciclo entre fichas.

salvar_ordem_compra

ChatGPT
Cria ou edita um pedido de compra. O pedido é um registro interno: não movimenta o estoque, não altera custo e não é enviado ao fornecedor. Sem id: cria em RASCUNHO (fornecedorNome e itens obrigatórios, clientRequestId obrigatório); a numeração é sequencial por empresa; produto arquivado ou repetido no mesmo pedido é recusado (422). Com id + version (de ler_ordens_compra ou do atual de um 409): edita um pedido em RASCUNHO; cada campo enviado substitui o anterior e itens substitui a lista inteira; null em dataPrevista ou observacao limpa o campo. Pedido fora de RASCUNHO ou version diferente da gravada: nada é gravado e a resposta é 409 com o pedido atual. Na edição a proteção contra gravação em dobro é a version.

salvar_ordem_producao

ChatGPT
Cria uma ordem de produção PLANEJADA para um produto ativo (produtoId ou codigo, exatamente um) com ficha técnica vigente; produto sem ficha ou arquivado é recusado (422). A ordem guarda a versão da ficha vigente neste momento, e uma ficha salva depois não muda o que ela consome. Criar não movimenta o estoque: a baixa acontece ao iniciar, por transicionar_ordem_producao. A numeração é sequencial por empresa. Não há edição nem exclusão de ordem; uma ordem errada é cancelada.

salvar_produto

ChatGPT
Cria ou atualiza um produto do catálogo nativo. Sem id: cria (codigo e descricao obrigatórios). Com id + version (de ler_produtos_alvore ou do atual de um 409): atualiza só os campos enviados. Cada campo enviado substitui o valor anterior, exceto extras, que é mesclado por chave. Se a version enviada não for a gravada, inclusive quando a mesma atualização é repetida, nada é gravado e a resposta é 409 com o produto atual, que traz a version vigente. estoqueMinimo é o mínimo na unidade do produto (na atualização, null remove o mínimo) e controlaEstoque: false marca o item sem saldo controlado, que fica fora de abaixoDoMinimo. Na atualização, a proteção contra gravação em dobro é a version, e clientRequestId não é usado. ativo: false arquiva e true reativa. Nenhum produto é apagado: a remoção é o arquivamento, reversível.

salvar_profissional

ChatGPT
Cria ou edita um profissional da equipe, com grade semanal e ausências. Sem id: cria (clientRequestId obrigatório). Com id + version (de ler_equipe ou do atual de um 409): edita; version diferente da gravada responde 409 com o profissional atual e nada é gravado. grade e ausencias enviadas substituem as listas inteiras.

salvar_servico

ChatGPT
Cria ou edita um serviço do catálogo. Sem id: cria (clientRequestId obrigatório). Com id + version (de ler_servicos ou do atual de um 409): edita; version diferente da gravada responde 409 com o serviço atual e nada é gravado. entrega diz como o serviço é consumido: SESSAO, ETAPAS ou HORAS. roteiro enviado grava uma versão nova do roteiro (etapas com horas previstas e insumos do estoque); a anterior fica no histórico.

vincular_cobranca_servico

ChatGPT
Liga um título a receber já existente (nativo ou de qualquer ERP conectado) a um contrato de serviço ou a uma entrega. Não cria, não altera e não baixa título. O mesmo título no mesmo contrato ou entrega devolve o vínculo existente (repetido: true). Contrato com mais de um serviço exige servicoId. Título de outro cliente, título cancelado e entrega estornada ou cancelada respondem 422. Só quem administra a empresa (consultoria ou ADMIN) liga cobrança.

alterar_plano_contas

Claude

alterar_regra

Claude

aplicar_patch

Claude

atualizar_contexto_projeto

Claude

avaliar_compra_pf

Claude

classificar_transacao

Claude

criar_artefato

Claude

criar_projeto

Claude

desfazer_classificacao

Claude

encerrar_run

Claude

estornar_movimento_estoque

Claude

iniciar_run

Claude

lancar_movimento_estoque

Claude

ler_artefato

Claude

ler_contexto_empresa

Claude

ler_estado

Claude

ler_estoque

Claude

ler_estrutura

Claude

ler_eventos

Claude

ler_ficha_tecnica_alvore

Claude

ler_financeiro

Claude

ler_guia_artefato

Claude

ler_historico_classificacao

Claude

ler_movimentos_estoque

Claude

ler_opcoes_baixa_erp

Claude

ler_orcamento_pf

Claude

ler_plano_contas

Claude

ler_produtos

Claude

ler_produtos_alvore

Claude

ler_propostas

Claude

ler_regras

Claude

ler_saldo_estoque_alvore

Claude

ler_titulos_em_aberto_erp

Claude

ler_transacoes

Claude

ler_transacoes_pf

Claude

ler_visao_geral_pf

Claude

listar_artefatos

Claude

listar_clientes

Claude

listar_conexoes_erp

Claude

listar_empresas

Claude

listar_projetos

Claude

nova_versao

Claude

propor_acao_erp

Claude

salvar_ficha_tecnica

Claude

salvar_produto

Claude

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/alvore-finance"><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/alvore-finance)