Granatum Financeiro

Atualiza um lançamento avulso existente nos livros do cliente. Requer autorização de escrita (lancamentos:write). Chama a API do Granatum em nome do usuário autenticado e altera dados reais. Antes de chamar, confirme com o usuário o lançamento e os campos que serão alterados. Opera somente em lançamento simples; séries, lançamentos compostos e transferências devem ser editados pela interface do Granatum.

Busca clientes e fornecedores da empresa autenticada por nome, nome fantasia ou documento. Cliente e fornecedor são atributos da mesma pessoa — uma pessoa pode ser ambos. Use para descobrir o pessoa_id ao criar um lançamento. O valor 0 representa 'sem pessoa vinculada'.

Cria um lançamento avulso (receita ou despesa) nos livros do cliente. Requer autorização de escrita (lancamentos:write). Chama a API do Granatum em nome do usuário autenticado — é uma escrita real, não simulação. Antes de chamar, confirme com o usuário os dados do lançamento. Se a resposta trouxer status 'confirmacao_necessaria', apresente os lancamentos_existentes ao usuário e pergunte explicitamente se deve criar mesmo assim; só reenvie com confirmar_duplicata: true após resposta humana explícita — nunca autoconfirme.

Exclui um lançamento avulso existente dos livros do cliente. Requer autorização de escrita (lancamentos:write). Chama a API do Granatum em nome do usuário autenticado e apaga dados reais. Antes de chamar, confirme explicitamente com o usuário. Opera somente em lançamento simples; séries, lançamentos compostos e transferências devem ser excluídos pela interface do Granatum.

Lista as categorias do plano de contas da empresa autenticada, com a hierarquia em caminho. Use para entender a estrutura contábil disponível, para descobrir IDs de categoria a usar em filtros de obter_dre, obter_fluxo_caixa ou obter_lancamentos, ou quando o usuário quiser ver/explicar a hierarquia de categorias. Para criar_lancamento, só use categoria-folha: itens com aceita_lancamento=true. Categoria-pai tem aceita_lancamento=false e a API do Granatum recusa lançamento nela.

Lista os centros de custo/lucro da empresa autenticada, com a hierarquia em caminho. Use para descobrir IDs a passar em centro_custo_lucro_ids nos filtros de obter_dre, obter_fluxo_caixa ou obter_lancamentos. O valor 0 representa 'sem centro de custo' e não é um item desta lista.

Lista as contas bancárias (corrente, poupança, cartão de crédito) da empresa autenticada. Use para descobrir IDs a passar em conta_ids nos filtros de relatório, ou para escolher a conta ao criar um lançamento. Só crie lançamentos em contas com permite_lancamento true.

Lista as empresas Granatum acessíveis pelo usuário autenticado. Chame esta tool quando o usuário não especificou qual empresa deseja analisar, ou quando quiser trocar de empresa durante a conversa. Use o wgi_conta_id retornado nas demais tools.

Lista as formas de pagamento cadastradas na empresa autenticada. Use para descobrir o forma_pagamento_id ao criar um lançamento. O valor 0 representa 'sem forma de pagamento' e não é um item desta lista.

Lista as tags (etiquetas livres) da empresa. Use para descobrir IDs a usar em tag_ids de obter_lancamentos, ou quando o usuário mencionar uma tag pelo nome. Tags não têm hierarquia. Para ver as tags de cada lançamento, use obter_lancamentos com campos_adicionais: ["tags"].