| listar_fornecedoresB | Lista fornecedores cadastrados no OMIE com paginação e filtros. |
| consultar_fornecedorA | Consulta detalhes de um fornecedor específico. Informe ao menos um dos identificadores. |
| incluir_fornecedorC | Cadastra um novo fornecedor no OMIE. |
| alterar_fornecedorB | Altera dados de um fornecedor existente no OMIE. |
| listar_contas_pagarC | Lista contas a pagar com filtros de status, período e fornecedor. |
| consultar_conta_pagarC | Consulta detalhes de uma conta a pagar específica. |
| incluir_conta_pagarC | Cria uma nova conta a pagar no OMIE. |
| lancar_pagamentoB | Registra o pagamento (baixa) de uma conta a pagar. |
| cancelar_pagamento_conta_pagarA | Cancela/estorna o pagamento de uma conta a pagar, revertendo a baixa.
Identifica a baixa (retornada por lancar_pagamento), não o título.
|
| excluir_conta_pagarA | Exclui uma conta a pagar do OMIE (apenas títulos em aberto). |
| listar_contas_receberB | Lista contas a receber com filtros de status, período e cliente. |
| consultar_conta_receberC | Consulta detalhes de uma conta a receber específica. |
| incluir_conta_receberC | Cria uma nova conta a receber no OMIE. |
| lancar_recebimentoC | Registra o recebimento (baixa) de uma conta a receber. |
| cancelar_recebimentoA | Cancela/estorna o recebimento de uma conta a receber, revertendo a baixa.
Identifica a baixa (retornada por lancar_recebimento), não o título.
|
| excluir_conta_receberB | Exclui uma conta a receber do OMIE (apenas títulos em aberto). |
| listar_lancamentos_bancariosC | Lista lançamentos/transações bancárias em conta corrente. |
| consultar_lancamento_bancarioC | Consulta detalhes de um lançamento bancário específico. |
| incluir_lancamento_bancarioB | Cria um lançamento manual em conta corrente (débito ou crédito). |
| excluir_lancamento_bancarioC | Exclui um lançamento bancário em conta corrente. |
| listar_tipos_conta_correnteA | Lista os tipos de conta corrente do OMIE — os valores aceitos no campo de
tipo ao cadastrar uma conta corrente (ex: CC Conta Corrente, CP Conta
Poupança, CR Cartão de Crédito, CX Caixinha).
Cada item traz `cCodigo` (o valor a usar), `cDescricao` e `cGrupo`, onde o
grupo é a família da conta: CB (bancária), CX (caixa), CV (carteira
virtual), CR (cartão) ou AC (administradora de cartões) — o mesmo domínio do
campo `tipo` em listar_bancos.
A tabela tem 13 registros e cabe numa página; a API do OMIE é somente
leitura para ela.
|
| listar_contas_correntesC | Lista todas as contas correntes/bancárias cadastradas no OMIE. |
| consultar_conta_correnteC | Consulta detalhes de uma conta corrente específica. |
| consultar_extrato_bancarioA | Consulta o extrato bancário de uma conta corrente em um período.
Retorna todos os lançamentos e o saldo do período.
Informe codigo_conta_corrente ou codigo_integracao_conta — o OMIE exige um deles.
Use listar_contas_correntes para descobrir o código (nCodCC).
|
| consultar_fluxo_caixaA | Consulta o fluxo de caixa do mês, comparando valores previstos vs realizados
por categoria financeira. |
| obter_resumo_financeiroA | Obtém o resumo financeiro consolidado numa data de referência, incluindo
totais de contas a pagar, a receber e saldo bancário.
Observação: o OMIE calcula este resumo para um único dia, não para um período.
|
| listar_titulos_em_abertoA | Lista os títulos financeiros em aberto (não liquidados) de um tipo.
O OMIE atende um tipo por chamada: use PAGAR ou RECEBER.
|
| pesquisar_lancamentos_financeirosA | Pesquisa lançamentos financeiros de forma unificada (contas a pagar + a receber).
Ideal para visão consolidada das finanças. |
| listar_categoriasB | Lista o plano de categorias financeiras do OMIE (receitas e despesas).
Cada categoria traz o vínculo com a conta do DRE em `codigo_dre`/`dadosDRE`,
o grupo em `categoria_superior` e as flags `totalizadora`, `transferencia`,
`conta_receita`, `conta_despesa` e `conta_inativa`.
Convenção de códigos do OMIE: códigos que começam com 1 são receitas e
com 2 são despesas.
|
| consultar_categoriaA | Consulta os detalhes de uma categoria pelo código, incluindo os dados da
conta do DRE vinculada (`dadosDRE`).
|
| listar_grupos_categoriaA | Lista os grupos totalizadores de categoria — exatamente os valores aceitos
em `categoria_superior` ao criar uma categoria com incluir_categoria.
O OMIE não oferece um filtro para isso, então esta tool varre o plano de
categorias e devolve as entradas com `totalizadora = S` e código de 4
caracteres (formato "9.99").
|
| listar_tipos_categoriaA | Lista os tipos de categoria — os valores aceitos em `tipo_categoria` ao
incluir ou alterar uma categoria.
Cada item traz `cCodigo` (o valor a usar), `cDescricao`, `cGrupo` e `cTipo`,
onde cTipo é P (gasto) ou R (receita). O `cTipo` precisa ser compatível com
a categoria: código/grupo iniciando em 1 exige cTipo R, iniciando em 2 exige
cTipo P.
|
| incluir_categoriaA | Cria uma nova categoria financeira no OMIE.
O OMIE valida os vínculos e rejeita a inclusão se eles não fecharem:
- `categoria_superior` precisa ser um grupo totalizador (use
listar_grupos_categoria). Grupo iniciando em 1 cria receita, em 2 despesa.
- `tipo_categoria` precisa ter cTipo compatível: R para grupo iniciando em 1,
P para grupo iniciando em 2 (use listar_tipos_categoria).
- `codigo_dre` só aceita contas com nivelDRE = 3, naoExibirDRE = N e
totalizaDRE = N (use listar_contas_dre com apenas_vinculaveis=True).
Retorna `codigo_status` ("0" = sucesso), `descricao_status` e o `codigo`
gerado para a categoria.
|
| alterar_categoriaA | Altera uma categoria existente. Apenas os campos informados são enviados.
Mesmas regras de vínculo de incluir_categoria, aplicadas sobre o `codigo`:
código iniciando em 1 exige tipo_categoria com cTipo R, em 2 exige cTipo P;
`codigo_dre` só aceita contas de nivelDRE 3, não totalizadoras e exibíveis.
Não existe método de exclusão de categoria na API do OMIE — para retirar uma
categoria de uso, chame esta tool com inativar=True.
|
| incluir_grupo_categoriaA | Cria um grupo totalizador de categorias — o nível que depois é usado como
`categoria_superior` das categorias.
O OMIE gera o código do grupo automaticamente ("1.xx" para receita,
"2.xx" para despesa) e o devolve em `codigo`.
|
| alterar_grupo_categoriaA | Altera um grupo totalizador de categorias.
O OMIE não permite trocar o tipo (receita/despesa) de um grupo já criado. |
| listar_contas_dreA | Lista a estrutura de contas do DRE (Demonstrativo de Resultados do Exercício).
Este endpoint não é paginado: devolve a estrutura inteira em `dreLista`, com
`codigoDRE`, `descricaoDRE`, `nivelDRE` (1 a 3), `sinalDRE` (+ ou -),
`totalizaDRE` e `naoExibirDRE`.
Níveis 1 e 2 são totalizadores da apresentação do relatório; só o nível 3
recebe categorias. Use apenas_vinculaveis=True para obter direto os códigos
válidos em incluir_categoria/alterar_categoria.
A API do OMIE é somente leitura para o DRE: a estrutura é mantida no ERP,
não há métodos de inclusão, alteração ou exclusão de contas do DRE.
|
| listar_tipos_documentoA | Lista os tipos de documento do OMIE — os códigos usados no tipo de documento
(tag cCodigo/cTipo) ao lançar contas a pagar, contas a receber e lançamentos
bancários. Ex: BOL (Boleto), NF (Nota Fiscal), ADI (Adiantamento).
O endpoint do OMIE devolve a tabela inteira de uma vez (~290 registros) e não
tem filtro por descrição, então o filtro e o limite são aplicados aqui, sobre
uma cópia em memória da tabela. O campo `total_encontrado` informa quantos
casaram antes do corte por `limite`.
A tabela é mantida pelo OMIE: a API é somente leitura, não há inclusão,
alteração nem exclusão de tipos de documento.
|
| consultar_tipo_documentoA | Consulta um tipo de documento pelo código exato.
Use listar_tipos_documento com o filtro `descricao` quando não souber o código.
|
| listar_bancosA | Lista os bancos e instituições financeiras do OMIE — a tabela de onde vem o
código de banco usado no cadastro de contas correntes.
A base tem mais de 1.200 instituições, então filtre por `nome` em vez de
paginar tudo. O filtro por `nome` já é feito pelo OMIE (busca parcial).
Cada registro traz `codigo` (código de compensação, 3 caracteres), `nome` e
`tipo`. A tabela é mantida pelo OMIE: a API é somente leitura.
|
| consultar_bancoA | Consulta uma instituição financeira pelo código, com os detalhes de
integração: `obank_*` (integração via API para PIX, pagamentos, extratos e
boletos), `cnab_*` (remessas CNAB), `cwr_*` (crawler), `cod_ispb` e
`cod_compen`. Útil para saber se um banco suporta extrato ou cobrança
automática antes de configurar a conta corrente.
Cuidado ao interpretar o erro: para um código inexistente o OMIE responde
"Código do banco não informado na tag [codigo]", e não que o banco não existe.
|
