anexar_arquivo
ChatGPTAnexa um arquivo (nota fiscal, boleto, comprovante) a um lançamento do cliente, em DUAS chamadas. O arquivo NUNCA vai como argumento nem volta em resposta: ele vai direto ao armazenamento, por um comando de envio que a tool entrega pronto. Requer autorização de escrita (lancamentos:write) e altera dados reais; o perfil Somente relatórios não anexa, e o perfil Lançamentos por usuário só anexa em lançamento que criou. (1) PEDIR O ENVIO: informe lancamento_id, nome_arquivo (com a extensão) e tamanho_bytes (de 1 byte a 5 MB (5242880 bytes)). Nada é anexado ainda: a tool devolve status 'envio_pendente' com envio_id, url, campos, valido_ate (o envio vale 10 minutos) e exemplo_de_comando, um curl com os campos reais. (2) ENVIAR: se você consegue executar comandos (shell com acesso à rede, como no Claude Code ou em agentes com terminal), execute o exemplo_de_comando por conta própria, trocando <caminho do arquivo> pelo caminho real do arquivo; o esperado é HTTP 204. (3) CONFIRMAR: chame de novo com lancamento_id e envio_id (sem nome_arquivo nem tamanho_bytes). A tool confere que o arquivo chegou, registra o anexo e devolve status 'anexado' com o anexo criado. O envio_id vale 1 hora e uma confirmação só. SEM SHELL OU SEM REDE (comum em apps de conversa): se você não consegue executar o comando, NÃO insista, NÃO tente outro caminho e NÃO afirme que anexou: nada foi anexado até a confirmação devolver 'anexado'. Explique ao usuário e oriente-o a anexar o arquivo pela tela do lançamento no Granatum. Se a confirmação voltar com codigo 'arquivo_nao_enviado' (o arquivo não chegou, o link venceu ou o envio já foi confirmado), peça UM envio novo (chamada sem envio_id) e envie de novo; se falhar outra vez, oriente o usuário a anexar pela interface. SÉRIE: se o lançamento é de série e escopo_serie não vem na confirmação, a tool NÃO anexa e devolve status 'escopo_necessario' com a posição e o tamanho da série; pergunte ao usuário e chame de novo (o arquivo já enviado e o envio_id continuam valendo). 'so_este' anexa só a esse lançamento; 'este_e_proximos' põe o mesmo arquivo, sem enviá-lo de novo, nesse lançamento e nos seguintes da série, e a resposta diz em quantos lançamentos o anexo entrou (lancamentos_alcancados); esta escolha grava de uma vez, sem prévia, então não a faça por conta própria. url, campos e envio_id são credenciais temporárias: não os mostre ao usuário nem os repita.
anexar_arquivo_direto
ChatGPTAnexa a um lançamento do cliente um arquivo que o USUÁRIO ANEXOU NESTA CONVERSA do ChatGPT (nota fiscal, boleto, comprovante). O ChatGPT entrega o arquivo no argumento arquivo (download_url e file_id) e o Granatum o baixa sozinho: você não envia bytes nem roda comando. Requer autorização de escrita (lancamentos:write) e altera dados reais; o perfil Somente relatórios não anexa, e o perfil Lançamentos por usuário só anexa em lançamento que criou. SÓ para arquivo que o usuário anexou nesta conversa: não invente nem reaproveite link, e file_id é identificador do ChatGPT, nunca um id de anexo do Granatum. (1) Com arquivo: o arquivo é baixado e anexado na mesma chamada e a tool devolve status 'anexado' com o anexo criado (lancamentos_alcancados diz em quantos lançamentos ele entrou). Repetir a chamada com o mesmo arquivo não duplica o anexo: devolve o que já foi criado (repetido: true). NADA é anexado sem a resposta: só afirme que anexou quando a resposta trouxer status 'anexado'; qualquer erro quer dizer que NADA foi anexado. SÉRIE: se o lançamento é de série e escopo_serie não vem, a tool não baixa nem anexa e devolve status 'escopo_necessario' com a posição e o tamanho da série; pergunte ao usuário e chame de novo com os mesmos argumentos mais escopo_serie. 'so_este' anexa só a esse lançamento. 'este_e_proximos' põe o mesmo arquivo nesse lançamento e nos seguintes da série e NÃO anexa na primeira vez: baixa o arquivo e devolve status 'confirmacao_necessaria' com a quantidade de lançamentos que receberiam o anexo (quantidade_a_anexar), quais são (lancamentos_afetados) e um envio_id. Apresente isso ao usuário e pergunte explicitamente se deve prosseguir; só confirme APÓS o sim explícito dele — nunca autoconfirme. (2) CONFIRMAR a prévia: chame de novo com lancamento_id, envio_id, escopo_serie e confirmado: true, SEM o argumento arquivo: o arquivo já foi baixado e a confirmação não depende do link do ChatGPT (o envio_id vale 1 hora; confirmar de novo com o mesmo envio_id não duplica o anexo e devolve o que já foi criado). Se o arquivo não chegar (argumento ausente, ou texto como "chat_upload" no app de celular), a tool recusa sem baixar nada: peça ao usuário para anexar o arquivo de novo pelo ChatGPT na web. Arquivo maior que 5 MB (5242880 bytes) não pode ser anexado. envio_id é credencial temporária: não o mostre ao usuário. Para ler um anexo depois use obter_anexo com o id do anexo.
anexar_arquivo_por_url
ChatGPTAnexa a um lançamento do cliente um arquivo que está num LINK HTTPS (nota fiscal, boleto, comprovante): por exemplo o link de download que o usuário passou, ou que você obteve numa ferramenta já autorizada (Basecamp, Drive...). O Granatum baixa o arquivo sozinho: você não envia bytes nem roda comando. Em DUAS chamadas. Requer autorização de escrita (lancamentos:write) e altera dados reais; o perfil Somente relatórios não anexa, e o perfil Lançamentos por usuário só anexa em lançamento que criou. Essas conferências, a do lançamento e a do nome vêm ANTES de baixar. O LINK precisa ser HTTPS público ou assinado e baixar o arquivo com um GET simples: sem login, cookie, token ou cabeçalho. Link que abre uma página (login, visualização) não serve e é recusado se devolver HTML no lugar do arquivo; só use um link que o usuário deu ou que você obteve em contexto autorizado, nunca invente nem troque o link. Se não houver link de download, oriente o usuário a anexar pela tela do lançamento no Granatum. Para o arquivo que o usuário anexou na conversa do ChatGPT use anexar_arquivo_direto, não esta tool. (1) IMPORTAR: informe lancamento_id, url e nome_arquivo (com a extensão, como deve aparecer no lançamento). Nada é anexado ainda: a tool baixa o arquivo (até 5 MB (5242880 bytes)) e devolve status 'envio_pendente' com envio_id, nome_arquivo, tamanho_bytes e a validade (1 hora). Não há comando a executar. (2) CONFIRMAR: chame de novo com lancamento_id e envio_id (sem url nem nome_arquivo). A tool registra o anexo e devolve status 'anexado' com o anexo criado; o arquivo não é baixado outra vez. O envio_id vale 1 hora e uma confirmação só. NADA é anexado até a confirmação devolver 'anexado': só afirme que anexou quando a resposta trouxer esse status; qualquer erro quer dizer que NADA foi anexado. NÃO é idempotente por link: dois pedidos iguais criam dois envios pendentes, e confirmar os dois anexaria o arquivo duas vezes. Não repita o pedido por conta própria depois de um erro ou de uma resposta perdida: confira antes com obter_lancamentos (campos_adicionais: ["anexos"]). SÉRIE: se o lançamento é de série e escopo_serie não vem na confirmação, a tool NÃO anexa e devolve status 'escopo_necessario' com a posição e o tamanho da série; pergunte ao usuário e chame de novo com lancamento_id, envio_id e escopo_serie. 'so_este' anexa só a esse lançamento; 'este_e_proximos' põe o mesmo arquivo nesse lançamento e nos seguintes da série e NÃO anexa na primeira vez: devolve status 'confirmacao_necessaria' com a quantidade de lançamentos que receberiam o anexo (quantidade_a_anexar) e quais são (lancamentos_afetados). Apresente isso ao usuário e pergunte explicitamente se deve prosseguir; só reenvie, com os mesmos argumentos mais confirmado: true, APÓS resposta humana explícita — nunca autoconfirme. Com 'so_este' não há confirmação. url e envio_id são credenciais temporárias: não os mostre ao usuário nem os repita. Para ler um anexo depois use obter_anexo com o id do anexo.
atualizar_lancamento
ChatGPTAtualiza 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.
buscar_pessoas
ChatGPTBusca 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'.
conciliar
ChatGPTConcilia (em lote, de 1 a 100 pares) movimentos do extrato bancário com lançamentos: cada par {movimento_id, lancamento_id} liga o movimento ao lançamento e, quando preciso, baixa o lançamento. Requer autorização de escrita (lancamentos:write). Altera dados reais do cliente e só vale para os perfis Administrador e Lançamentos. Um par vale quando o movimento está pendente (sem vínculo e não ignorado) e o lançamento está sem vínculo, em aberto ou já pago, com o mesmo sinal e o valor exato ao centavo, de qualquer conta; não precisa ter sido sugerido por obter_conciliacoes_pendentes. O que cada par faz no lançamento: se já está pago no mesmo dia e na mesma conta do movimento, só liga (o lançamento não muda); se está em aberto, dá baixa com a data do movimento e a conta do extrato; se já está pago em outra data ou conta, a data do pagamento e a conta passam a ser as do movimento. O movimento importado por CSV não se concilia pelo MCP (fica para a tela do Granatum): o par é recusado. Quando o lançamento muda, vale o caixa fechado: com a data antiga ou a nova até a data de bloqueio de caixa da empresa o par é recusado. CONFIRMAÇÃO: sem confirmado: true a chamada NÃO grava: devolve status 'confirmacao_necessaria' com a quantidade e o que cada par faria (acao: vincular, baixar, mudar_data_do_pagamento, mudar_conta, mudar_data_do_pagamento_e_conta). Na ação baixar de um lançamento de outra conta (conta_antes_id diferente de conta_depois_id), diga ao usuário que a baixa leva o lançamento para a conta do extrato. Fluxo: leia com obter_conciliacoes_pendentes, conte as confiáveis ao usuário (isso só informa); o pedido dele para conciliar autoriza só a prévia (conciliar sem confirmado); mostre a prévia, termine a resposta ali perguntando "concilio estes N?" e só confirme depois do sim dele à prévia; nunca concilie um movimento revisar ou bloqueado sem antes mostrar o movimento, o motivo e o(s) candidato(s) e o usuário escolher o lançamento; só depois da escolha chame a prévia. Nunca mande parâmetro opcional vazio ou zero: omita. Mostre isso ao usuário e só reenvie, com os mesmos pares mais confirmado: true, numa resposta seguinte a uma mensagem nova do usuário que veio DEPOIS da prévia e a aceita; um "pode", "sim" ou "confirma" dito antes da prévia não vale; nunca chame conciliar duas vezes na mesma resposta; nunca autoconfirme. A confirmação confere cada par de novo na hora de gravar. LOTE: todo par do pedido é alvo. Se algum estiver impedido (caixa fechado, movimento ou lançamento já conciliado, par que deixou de valer, id de outra empresa ou inexistente), o pedido INTEIRO é recusado, nada é gravado, e a resposta lista cada par impedido com o motivo (status erro, codigo alvos_impedidos, impedidos). Isso acontece quando algo mudou entre a leitura e o sim. Diga ao usuário "N mudaram desde a consulta: motivos; concilio as outras M?" e, se ele aceitar, refaça sem os impedidos, mostrando a prévia nova antes de confirmar. Não faz (fica na tela do Granatum): valor diferente, vários lançamentos para um movimento, criar lançamento a partir do movimento, ignorar movimento e voltar a data de bloqueio. Perfis sem acesso à conciliação (só Administrador e Lançamentos a usam) recebem a recusa "Seu perfil nesta empresa não dá acesso à conciliação": não insista.
criar_categoria
ChatGPTCria uma categoria do plano de contas na empresa, para usar o id como categoria_id em criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_categorias: o Granatum aceita a mesma descrição repetida e duplicaria o cadastro. Sem parent_id a categoria nasce na raiz e o tipo é obrigatório; com parent_id ela é filha, herda o tipo e a cor do pai (o tipo informado é ignorado) e o pai passa a não aceitar lançamento. Se o pai já tem lançamentos diretos, sem migrar_para_nova nem migracao_id nada é criado e a resposta traz a quantidade (status recusado): pergunte ao usuário para onde movê-los. Com o destino, a primeira chamada NÃO grava: devolve a prévia (confirmacao_necessaria, com quantos lançamentos seriam movidos e os impedidos) e só cria e move com confirmado: true, depois que o usuário disser sim. A resposta traz a categoria criada no formato de listar_categorias.
criar_centro_custo_lucro
ChatGPTCria um centro de custo/lucro na empresa, para usar o id como centro_custo_lucro_id em criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_centros_custo_lucro: o Granatum aceita a mesma descrição repetida e duplicaria o cadastro. Com parent_id o centro é filho dele (o pai continua aceitando lançamento). A resposta traz o centro criado no formato de listar_centros_custo_lucro.
criar_forma_pagamento
ChatGPTCria uma forma de pagamento na empresa, para usar o id como forma_pagamento_id em criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_formas_pagamento: o Granatum aceita a mesma descrição repetida e duplicaria o cadastro. A resposta traz a forma criada no formato de listar_formas_pagamento.
criar_lancamento
ChatGPTCria 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.
criar_pessoa
ChatGPTCadastra um cliente ou um fornecedor nos livros do cliente, para usar o id dele em criar_lancamento (pessoa_id). 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, use SEMPRE buscar_pessoas (por nome): se a pessoa já existe, use o id dela e NÃO cadastre de novo. O Granatum ACEITA o mesmo nome repetido e duplicaria o cadastro. papel diz o que a pessoa é neste cadastro: 'fornecedor' (você paga a ela; vale em despesa) ou 'cliente' (ela paga você; vale em receita). tambem_outro_papel: true quando ela também é o outro (cliente que também é fornecedor, ou o inverso); false (padrão) quando é só um. Só nome é obrigatório; contato e endereço são opcionais, mas informe só o que o usuário disse. A resposta traz a pessoa no formato de buscar_pessoas, com o id. Dados inválidos (e-mail, CEP) voltam como erro_validacao com o nome do campo, sem cadastrar nada. Editar e excluir pessoa não existem aqui.
criar_tag
ChatGPTCria uma tag (etiqueta livre) na empresa, para usar o id em tag_ids de criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_tags: a tag que já existe (viva, ativa ou inativa; sem diferença de maiúscula, acento ou espaço no fim) é recusada, e você deve usar o id dela. A resposta traz a tag criada no formato de listar_tags.
desconciliar
ChatGPTDesfaz a conciliação (em lote, de 1 a 100, por movimento_ids OU por lancamento_ids, nunca os dois) de movimentos do extrato bancário; quando o usuário falar do lançamento ("desfaz a conciliação daquele pagamento"), use lancamento_ids: cada lançamento resolve para o movimento do seu vínculo ativo, e o que não está conciliado é recusado com o motivo "o lançamento não está conciliado": remove o vínculo de cada movimento e, se o lançamento não tiver outro vínculo ativo, restaura pelo estado de antes da conciliação a data de pagamento (a que era em aberto volta a em aberto), o vencimento e o valor. Requer autorização de escrita (lancamentos:write). Altera dados reais do cliente e só vale para os perfis Administrador e Lançamentos. A conta do lançamento NÃO volta: a resposta diz em que conta ele ficou. Vínculo antigo, sem o estado de antes, só tem o vínculo removido: o lançamento continua pago, e reabrir é o estorno (registrar_pagamento com pago: false). A restauração segue o caixa fechado: se ela mudar uma data até a data de bloqueio de caixa da empresa, o movimento é recusado. Lançamento conciliado no mesmo dia volta igual. CONFIRMAÇÃO: sem confirmado: true a chamada NÃO grava: devolve status 'confirmacao_necessaria' com o que cada vínculo desfeito faria. Mostre ao usuário e só reenvie com confirmado: true numa resposta seguinte a uma mensagem nova do usuário que veio DEPOIS da prévia e a aceita; um "pode" ou "sim" dito antes da prévia não vale; nunca chame desconciliar duas vezes na mesma resposta; nunca autoconfirme. LOTE: todo movimento do pedido é alvo. Um movimento impedido (não conciliado, de outra empresa, inexistente, caixa fechado) recusa o pedido INTEIRO, nada é gravado, e a resposta lista cada impedido com o motivo; refaça sem eles, com prévia nova. Com o estado de antes da conciliação (snapshot), a restauração volta a data de pagamento (nula volta a em aberto), o vencimento e o valor. Sem ele (vínculo antigo), só o vínculo sai: diga ao usuário que o lançamento continua pago e que reabrir é o estorno.
excluir_anexo
ChatGPTExclui um anexo de lançamento (exclusão lógica; o arquivo só sai do armazenamento quando nenhum lançamento o usa mais). Requer autorização de escrita (lancamentos:write) e apaga dados reais; antes de chamar, confirme com o usuário qual anexo será excluído. O anexo_id vem de obter_lancamentos com campos_adicionais: ["anexos"]. O perfil Somente relatórios não exclui; o perfil Lançamentos por usuário só exclui anexo de lançamento que criou. ANEXO DE SÉRIE: um anexo que foi posto em vários lançamentos da série (este_e_proximos ao anexar) exige escopo_serie; sem ele a tool NÃO exclui e devolve status 'escopo_necessario'. 'so_este' exclui o anexo só do lançamento pedido e os outros continuam com ele; 'este_e_proximos' exclui o anexo desse lançamento e dos seguintes da série. CONFIRMAÇÃO: escopo_serie 'este_e_proximos' alcança mais de um lançamento e NÃO exclui na primeira vez: devolve status 'confirmacao_necessaria' com a quantidade de anexos a excluir, os lançamentos afetados (lancamentos_afetados) e se o arquivo sairia do armazenamento (arquivo_sera_apagado). Apresente isso ao usuário e pergunte explicitamente se deve prosseguir; só reenvie, com os mesmos argumentos mais confirmado: true, APÓS resposta humana explícita — nunca autoconfirme. A segunda chamada exclui e devolve o resultado real, que pode diferir da prévia se algo mudou no intervalo. Com 'so_este' ou com anexo de um lançamento só não há confirmação. Em anexo de lançamento fora de série, ou que não foi posto em vários lançamentos, não informe escopo_serie: ele é recusado.
excluir_lancamento
ChatGPTExclui 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.
ignorar_movimentos
ChatGPTIgnora (em lote, de 1 a 100) movimentos do extrato bancário que não precisam de conciliação, ou, com desfazer: true, restaura os já ignorados. O movimento ignorado deixa de aparecer em obter_conciliacoes_pendentes; restaurar o devolve às pendências. Requer autorização de escrita (lancamentos:write). Altera dados reais do cliente e só vale para os perfis Administrador e Lançamentos. Só muda o movimento no extrato (e o status da importação de que ele veio: 2 sem movimento pendente, 1 com algum, recalculado para cada importação tocada): nenhum lançamento, vínculo ou saldo muda. Recusas por movimento: de outra empresa ou inexistente (movimento_nao_encontrado), já ignorado ao ignorar (movimento_ja_ignorado), não ignorado ao restaurar (movimento_nao_ignorado), conciliado (movimento_conciliado: desconcilie antes) e de origem que o MCP não trata (importação CSV, ou origem não registrada: movimento_de_importacao_csv, fica na tela do Granatum). CONFIRMAÇÃO: sem confirmado: true a chamada NÃO grava: devolve status 'confirmacao_necessaria' com a quantidade e cada movimento (data, descrição, valor). Mostre ao usuário e só reenvie, com os mesmos movimentos mais confirmado: true, numa resposta seguinte a uma mensagem nova do usuário que veio DEPOIS da prévia e a aceita; um "pode", "sim" ou "confirma" dito antes da prévia não vale; nunca chame ignorar_movimentos duas vezes na mesma resposta; nunca autoconfirme. A confirmação confere cada movimento de novo na hora de gravar. Nunca mande parâmetro opcional vazio: omita. LOTE: todo movimento do pedido é alvo. Se algum estiver impedido, o pedido INTEIRO é recusado, nada é gravado, e a resposta lista cada impedido com o motivo (status erro, codigo alvos_impedidos, impedidos); diga ao usuário e, se ele aceitar, refaça sem os impedidos, mostrando a prévia nova antes de confirmar. Perfis sem acesso à conciliação (só Administrador e Lançamentos a usam) recebem a recusa "Seu perfil nesta empresa não dá acesso à conciliação": não insista.
listar_categorias
ChatGPTLista as categorias do plano de contas da empresa autenticada. 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.
listar_centros_custo_lucro
ChatGPTLista 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.
listar_contas
ChatGPTLista 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.
listar_empresas
ChatGPTLista 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.
listar_formas_pagamento
ChatGPTLista 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.
listar_tags
ChatGPTLista 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"].
obter_anexo
ChatGPTDevolve o link temporário para baixar um anexo de lançamento (válido por 30 minutos), com nome, tipo e tamanho do arquivo. Somente leitura. O anexo_id vem de obter_lancamentos com campos_adicionais: ["anexos"]. Você recebe só o link, não o conteúdo do arquivo. O link dá acesso ao arquivo a quem o tiver: entregue-o apenas ao usuário que o pediu, não o repita nem o guarde para outros usos; vencido, peça outro. Todos os perfis com acesso ao Financeiro podem, inclusive Somente relatórios; o perfil Lançamentos por usuário só baixa anexos de lançamentos que ele criou.
obter_conciliacoes_pendentes
ChatGPTLê os movimentos do extrato bancário que ainda esperam conciliação (sem vínculo com lançamento e não ignorados) e sugere o lançamento de cada um. Só lê: não concilia nada; quem concilia é a tool conciliar, e só depois do sim do usuário. SEM conta_id devolve o resumo por conta: quantos movimentos pendentes há, quantos por grau (confiavel, revisar, sem_sugestao) e quantos estão bloqueados (os bloqueados já contam em revisar). Comece por aqui quando o usuário perguntar quais conciliações estão pendentes. COM conta_id e periodo_inicio e periodo_fim devolve os movimentos pendentes da conta, paginados (pagina, limite, proxima_pagina, total_disponivel; filtro opcional grau), cada um com: grau (confiavel, revisar ou sem_sugestao), motivo escrito, bloqueio (quando existir: motivo e opções) e até 5 candidatos (lancamento_id, valor, datas, conta, pessoa, acao). O grau e o bloqueio vêm do servidor: confiavel é só o que pode ser gravado agora (um único candidato confiável, da mesma conta do extrato); o movimento bloqueado nunca é confiavel e não entra no filtro grau=confiavel. Não reclassifique: não promova revisar a confiavel nem conte como confiável o que o servidor não marcou. Como usar: com as confiaveis, diga ao usuário quantas são ("38 confiáveis, concilio?") e só então chame conciliar com os pares movimento_id e lancamento_id do primeiro candidato. As bloqueadas, mostre o motivo e as opções do bloqueio (voltar a data de bloqueio de caixa na tela do Granatum e pedir de novo; deixar pendente; conciliar com outro candidato quando a opção trouxer lancamento_ids). As de revisar, ANTES de qualquer conciliar mostre o movimento, o motivo e o(s) candidato(s) e peça a escolha ao usuário; só depois da escolha chame a prévia de conciliar. As sem_sugestao, não há lançamento na janela (em aberto com vencimento a até 30 dias, ou já pago a até 3 dias): tente obter_lancamentos (pela data e valor do movimento) antes de dizer que fica para a tela, porque conciliar aceita qualquer lançamento válido, não só o sugerido (mesmo sinal, valor exato ao centavo, sem vínculo). Movimento importado por CSV não se concilia pelo MCP: vem em revisar com bloqueio (conciliar_na_tela) e sem candidatos; encaminhe o usuário à tela de conciliação do Granatum. Fica na tela do Granatum, não no MCP: valor diferente (ajustar, diferença, baixa parcial), vários lançamentos para um movimento ou juntar movimentos, criar lançamento ou transferência a partir do movimento, ignorar e restaurar movimento, e voltar a data de bloqueio. Só os perfis Administrador e Lançamentos usam a conciliação; os outros recebem a recusa "Seu perfil nesta empresa não dá acesso à conciliação": não insista, informe o usuário.
obter_dre
ChatGPTResumo dinâmico da DRE com árvore de tópicos, valores assinados, análises (variação/participação/base), resumos por nível, principais categorias e alertas de mapeamento. Quando não houver filtros, utilize periodicidade 'mensal', quantidade_periodos 6 e considere como período de referência o mês imediatamente anterior (YYYY-MM). Procure destacar movimentos relevantes de receita, custos e margens, explicando impactos no EBITDA e resultado líquido.
obter_fluxo_caixa
ChatGPTResumo do fluxo de caixa com períodos contíguos (recebido/pago/líquido, saldos inicial/final/acumulado, principais categorias e comparações). Se nenhum filtro for informado, utilize periodicidade 'mensal', quantidade_periodos 6 e período de referência igual ao mês imediatamente anterior (formato YYYY-MM). Destaque entradas vs. saídas, evolução do saldo acumulado e categorias que mais impactaram o período.
obter_lancamentos
ChatGPTLista lançamentos (recebimentos/pagamentos) de uma empresa em um período. Use para listagem livre ("lançamentos de abril") ou drill-down após obter_dre/obter_fluxo_caixa (passando os categoria_ids da linha que o usuário quer investigar). Todos os filtros além de período são opcionais — sem nenhum filtro, retorna todos os lançamentos da janela, paginados.
registrar_pagamento
ChatGPTRegistra o pagamento de lançamentos nos livros do cliente: dá baixa, corrige a data de pagamento de quem já está pago ou estorna a baixa. Requer autorização de escrita (lancamentos:write). Chama o banco do Granatum em nome do usuário autenticado e altera dados reais. Antes de chamar, confirme com o usuário os lançamentos e a data do pagamento: nunca presuma que 'pagou hoje'. O parâmetro pago decide a operação: (1) pago: true e data_pagamento DÁ BAIXA em quem está em aberto; (2) pago: true e data_pagamento em quem JÁ ESTÁ PAGO só TROCA a data do pagamento (sem estorno; valor e conta não mudam); (3) pago: false ESTORNA a baixa (limpa a data de pagamento; não leva data_pagamento). BAIXA COM VALOR DIFERENTE: valor_pago (só com um id): igual ao valor do lançamento quita; MAIOR é juros e multa (na competência aberta a diferença fica no valor do lançamento; na competência fechada ela vira lançamento próprio, veja a regra a seguir); COMPETÊNCIA FECHADA (até a data de bloqueio de competência da empresa): o valor do lançamento NÃO muda; o juros, a multa e o desconto nascem como um lançamento próprio, pago na data do pagamento, com a competência nessa data e o vencimento do original, na conta e na categoria do original (do tipo do original no juros e na multa, do tipo contrário no desconto), e a resposta traz lancamentos_da_diferenca com os ids criados (e lancamento_composto_das_diferencas_id quando formam um dividido novo); a data do pagamento não pode cair até a data de bloqueio de competência. REGRA: pagar MENOR exige desconto: true; pagar MAIOR, na competência fechada, cria o lançamento de juros sem nenhuma flag; gerar_restante na competência fechada é recusado (pague o valor cheio ou com desconto: true). Na competência aberta, MENOR tem duas saídas, e quem escolhe é o usuário: desconto: true (a diferença vira desconto e o lançamento fica pago pelo valor informado) OU gerar_restante: true (BAIXA PARCIAL: o lançamento fica pago pelo valor informado e a diferença nasce como um novo lançamento em aberto, o saldo restante, 'Diferença ref.: ...', com o mesmo vencimento, categoria, pessoa, centro, tags e demais dados do original). desconto e gerar_restante se excluem; pagar menos sem nenhum dos dois é recusado. O restante é um lançamento comum e INDEPENDENTE do original: não há vínculo entre os dois, e estornar a baixa do original não o apaga. Em dividido nasce um restante por item que ficou com diferença, e com dois ou mais restantes eles nascem agrupados num dividido novo (sem ligação com o do original; com um só, ele é avulso). A resposta da baixa diz valor_original (o valor do lançamento antes desta baixa, não necessariamente o original histórico), valor_pago e diferenca (tratamento 'juros', 'desconto' ou 'parcial'); na baixa parcial traz também valor_restante e lancamentos_restantes (os ids criados; lancamento_composto_dos_restantes_id quando formam um dividido novo). valor_pago NÃO vale em lançamento que já está pago: estorne antes (pago: false) e dê a baixa de novo. ESTORNO: limpa só a data de pagamento; o valor do lançamento NÃO VOLTA ao que era antes da baixa (na competência aberta, juros, desconto e baixa parcial reescrevem o valor, e o valor anterior está no histórico do lançamento; na competência fechada o valor do lançamento não mudou na baixa e a diferença é outro lançamento, que o estorno não toca). Todo estorno responde com o mesmo aviso, sem número: o estorno não sabe se a baixa teve juros, desconto ou restante. Avise o usuário e não afirme um valor anterior; um restante gerado pela baixa continua em aberto e é independente, e a diferença de uma competência fechada continua paga. SÉRIE: paga ou estorna só a ocorrência pedida, nunca as próximas, e não há escopo_serie. DIVIDIDO: o id de qualquer item paga o lançamento dividido INTEIRO, mas só os itens em aberto: um item já pago fica como está (data e valor); e estorna o lançamento dividido INTEIRO. Recusas, com o motivo e o que fazer: data futura, até a data de bloqueio de caixa ou anterior ao saldo inicial da conta; lançamento conciliado; transferência (não tem baixa …