Cancela/estorna o pagamento de uma conta a pagar, revertendo a baixa.
    Identifica a baixa (retornada por lancar_pagamento), não o título.
    

    Cancela/estorna o recebimento de uma conta a receber, revertendo a baixa.
    Identifica a baixa (retornada por lancar_recebimento), não o título.
    

    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.
    

    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).
    

    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.
    

    Lista os títulos financeiros em aberto (não liquidados) de um tipo.
    O OMIE atende um tipo por chamada: use PAGAR ou RECEBER.
    

    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.
    

    Consulta os detalhes de uma categoria pelo código, incluindo os dados da
    conta do DRE vinculada (`dadosDRE`).
    

    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").
    

    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.
    

    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.
    

    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.
    

    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`.
    

    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.
    

    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.
    

    Consulta um tipo de documento pelo código exato.
    Use listar_tipos_documento com o filtro `descricao` quando não souber o código.
    

    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.
    

    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.