Braxio

Move linhas e subárvores para a Lixeira do Braxio. Nunca exclui definitivamente e não restaura por esta conexão.

braxio_itens_de_orcamento_arquivar

WRITE ACTION: move de 1 a 100 receitas ou despesas do mesmo tipo para a Lixeira em uma única operação atômica. Arquive receitas e despesas em ações separadas. Nunca exclui definitivamente.

braxio_arquivar_lancamentos_financeiros

Move o lead para a Lixeira com CAS e retry idempotente. É recuperável pela interface; o agente nunca pode excluir definitivamente.

braxio_arquivar_lead

Move orçamentos para a Lixeira do Braxio em uma transação. Nunca exclui definitivamente e não restaura por esta conexão.

braxio_orcamentos_arquivar

Move pendências para a Lixeira do Braxio. Nunca exclui definitivamente e não restaura por esta conexão.

braxio_pendencias_de_obra_arquivar

Move o projeto para a Lixeira do Braxio com uma operação idempotente. É recuperável pela interface; este agente nunca pode excluir definitivamente nem esvaziar a Lixeira.

braxio_arquivar_projeto

Move a tarefa ou etapa e seus descendentes para a Lixeira do Braxio. É recuperável pela interface; este agente nunca pode excluir definitivamente nem esvaziar a Lixeira.

braxio_arquivar_tarefa

WRITE ACTION: move uma transferência para a Lixeira com controle de versão. Nunca exclui definitivamente.

braxio_arquivar_transferencia

Move a visita e suas capturas para a Lixeira. Preserva as pendências; nunca exclui definitivamente.

braxio_visita_de_obra_arquivar

Busca clientes por parte do nome, somente entre os cadastros visíveis para esta pessoa. Se o estado for escolha_necessaria, mostre as opções e pergunte qual delas a pessoa quis dizer; nunca escolha sozinho.

braxio_buscar_clientes

Busca fornecedores por parte do nome, somente entre os cadastros visíveis para esta pessoa. Se o estado for escolha_necessaria, mostre as opções e pergunte qual delas a pessoa quis dizer; nunca escolha sozinho.

braxio_buscar_fornecedores

Busca leads por parte do nome. A RLS devolve somente leads que esta pessoa pode acessar. Se o estado for escolha_necessaria, mostre as opções e pergunte qual delas a pessoa quis dizer; nunca escolha sozinho.

braxio_buscar_leads

Busca artigos oficiais para explicar como usar o Braxio. Use quando a pessoa perguntar como fazer algo; não use como fonte de dados do escritório.

braxio_ajuda_buscar

Busca membros ativos deste escritório por nome ou e-mail. Se o estado for escolha_necessaria, mostre as opções e pergunte qual delas a pessoa quis dizer; nunca escolha sozinho.

braxio_buscar_pessoas

Busca projetos por parte do nome. A RLS devolve somente projetos que esta pessoa pode acessar. Se o estado for escolha_necessaria, mostre as opções e pergunte qual delas a pessoa quis dizer; nunca escolha sozinho.

braxio_buscar_projetos

Busca etapas, tarefas e subtarefas por parte do nome, mantendo a identificação de onde cada item mora. A RLS devolve somente itens visíveis. Se o estado for escolha_necessaria, pergunte qual opção a pessoa quis dizer.

braxio_buscar_tarefas

Conclui somente a etapa, sem alterar tarefas ou subtarefas internas. Para concluir itens internos, resolva e edite cada tarefa explicitamente.

braxio_concluir_etapa

Lista as categorias válidas do escritório para criar ou editar fornecedor. Se a lista ainda estiver vazia, a consulta materializa os padrões server-owned.

braxio_catalogo_de_fornecedores

Lista categorias financeiras ativas e contas bancárias visíveis. Use antes de montar lançamentos quando a planilha não trouxer nomes exatos. Para criar categorias, use incluir_dre=true e percorra proxima_pagina mantendo o mesmo limite: esse modo também informa os subgrupos existentes da DRE. Reduza limite se o conteúdo for grande.

braxio_catalogo_financeiro

Lê dados operacionais e de contato de um cliente pelo id resolvido, sem CPF/CNPJ ou outros documentos fiscais. Só aparece para quem pode ler Cadastros.

braxio_obter_cliente

Devolve somente nome, telefone e e-mail do cliente vinculado. Exige acesso atual a Leads e Cadastros; não devolve documento nem endereço.

braxio_obter_contato_do_lead

Lê a descrição de grupo, item ou subitem em trechos de até 500 caracteres. Concatene até proximo_deslocamento=null. Se versao mudar entre trechos, releia desde zero.

braxio_consultar_descricao_de_item

Consulta itens, visitas ou pendências de um projeto. Só retorna projetos e linhas que a pessoa conectada pode acessar. Fotos e arquivos não são expostos.

braxio_obras_consultar

Consulta contas e saldos, DRE, fluxo de caixa e margem dos projetos. Use a consulta específica e peça somente os campos necessários. Para dre_detalhes, consulte primeiro a DRE e copie exatamente o campo detalhamento da linha desejada. fluxo_caixa aceita um período exato e agrega os lançamentos por mês.

braxio_financeiro_consultar

Lê dados operacionais e de contato de um fornecedor pelo id resolvido, sem CPF/CNPJ ou outros documentos fiscais. Só aparece para quem pode ler Cadastros.

braxio_obter_fornecedor

Consulta todas as células de linhas de orçamento, exceto a descrição, disponível em braxio_consultar_descricao_de_item. Percorra proximo_cursor até null. Use item_pai_id para a árvore e ordem para ordenar irmãos; a página pode trazer filhos antes de pais. Não é um snapshot entre chamadas.

braxio_consultar_itens_de_orcamento

Consulta opções ativas e inativas das listas do escritório. Na primeira consulta de uma lista sem opções, materializa os padrões server-owned; isso não altera opções existentes. Use valor ao classificar um registro; id identifica a opção. Categorias financeiras são consultadas em braxio_catalogo_financeiro. Tipos de item de orçamento são personalizáveis; status e forma de pagamento têm valores fixos. O catálogo segue a inicialização padrão do Braxio quando o escritório ainda não personalizou a lista. Percorra proxima_pagina mantendo o mesmo limite; reduza limite se o conteúdo for grande.

braxio_consultar_lista

Lista etapas, tags e motivos de perda válidos. A consulta de motivos pode materializar os padrões server-owned se a lista ainda estiver vazia. Consulte antes de criar, mover, editar tags ou perder um lead.

braxio_catalogo_de_leads

Lista etapas, tags e categorias válidas do escritório. Se a lista de categorias ainda estiver vazia, a consulta materializa os padrões server-owned. Consulte antes de informar etapa, tag ou categoria; use o valor, não invente nomes internos.

braxio_catalogo_de_projetos

Consulta os cabeçalhos de orçamentos de um Lead ou Projeto. Percorra proximo_cursor até null e use braxio_consultar_itens_de_orcamento para as linhas. Leituras podem refletir edições concorrentes.

braxio_consultar_orcamentos

Consulta horas apontadas ou aquisição de leads no período. O resumo traz os indicadores consolidados; dados traz as linhas visíveis para esta pessoa. Em horas, informe projeto por nome ou ID e pessoa por nome, e-mail ou ID; se houver homônimos, a ferramenta pede uma escolha segura.

braxio_relatorios_consultar

Lê a ficha operacional de um lead pelo id resolvido. Não devolve documento, telefone, e-mail nem endereço fiscal do cliente.

braxio_obter_lead

Mostra qual pessoa e qual escritório estão ligados a esta conexão e o nível efetivo dos módulos governados. Use antes de explicar o que esta conexão pode acessar. O escritório nunca vem de argumento do agente.

braxio_contexto

WRITE ACTION: cria uma categoria financeira, sem alterar lançamentos. Use somente após pedido explícito de criação; uma prévia não autoriza criar. Consulte braxio_catalogo_financeiro com incluir_dre=true para escolher um subgrupo existente da mesma natureza. Informe explicitamente se a categoria soma na DRE. Não cria subgrupos nem reativa categorias existentes. Se o resultado for indeterminado, releia o catálogo antes de tentar criar novamente.

braxio_criar_categoria_financeira

Cria um cliente com nome e contato básico. operacao_id é um UUID novo e permanece igual em todo retry; use editar para completar a ficha.

braxio_criar_cliente

WRITE ACTION: cria uma conta bancária idempotente no escritório atual.

braxio_criar_conta_bancaria

WRITE ACTION: use somente quando a pessoa pedir cadastrar um custo fixo mensal (aluguel, software, pró-labore). Grava um cadastro que pode gerar despesas mensais; não é uma prévia. Nunca use para preparar receitas, honorários, despesas avulsas, simulações ou registros inventados para testar ferramentas. Para a prévia de receitas/despesas, use braxio_preparar_lote_financeiro. A categoria aceita slug, nome exato ou id do catálogo financeiro; se houver ambiguidade a resposta traz as opções. Depois de criar, use braxio_gerar_despesas_de_custos_fixos para gerar as despesas do mês.

braxio_criar_custo_fixo

Cria uma etapa na raiz ou um serviço dentro de uma etapa, com retry idempotente. Etapa exige item_pai_id=null; serviço exige o UUID de uma etapa viva do mesmo projeto em item_pai_id.

braxio_item_de_obra_criar

Cria um evento na Agenda com membros internos já resolvidos por ID. Se a pessoa já configurou sincronização, também cria o evento no calendário externo conectado. Não aceita convidados externos nem envia convite por e-mail nesta fase. Endereços e localizações exatas são preenchidos somente na interface do Braxio.

braxio_criar_evento

Cria um fornecedor com contato básico e categoria válida. operacao_id permanece igual em todo retry; use editar para completar a ficha.

braxio_criar_fornecedor