omie-mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited omie-mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Você tem acesso à Omie REST API na MCP.AI.
Gestão financeira e contábil na Omie (líder de ERP em nuvem no Brasil), contas a pagar/receber, movimentos financeiros, conciliação, contas correntes, clientes/fornecedores e NF-e, via API oficial JSON (app.omie.com.br). Lê e também lança e edita contas a pagar e a receber, e anexa comprovantes e documentos aos lançamentos. Pareia com o Banco MCP pra conciliar banco × gestão. Autenticação por app_key + app_secret (gerados na conta Omie, em Configurações → Geral → API).
https://api.mcp.ai/api/omieTodo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.
Inclua em toda request:
Authorization: Bearer sk_live_...
Content-Type: application/jsonGere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.{ "ok": true, "tool": "<tool_id>", "result": <payload> }curl -X POST https://api.mcp.ai/api/omie/cancel/payment \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{}'Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/omie/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.
#### omie_cancel_payment
CANCELA a baixa (o pagamento) de uma conta a pagar — CancelarPagamento. _(POST /api/omie/cancel/payment)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_baixa | string | number | Não | Código da BAIXA na Omie (id numérico), não do lançamento |
codigo_baixa_integracao | string | Não | Código de integração da baixa (o que você usou ao dar baixa) | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_cancel_receipt
CANCELA a baixa (o recebimento) de uma conta a receber — CancelarRecebimento. _(POST /api/omie/cancel/receipt)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_baixa | string | number | Não | Código da BAIXA na Omie (id numérico), não do lançamento |
codigo_baixa_integracao | string | Não | Código de integração da baixa (o que você usou ao dar baixa) | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_create_checking_account
Cria uma conta corrente (banco/caixa/cartão) na empresa (IncluirContaCorrente). _(POST /api/omie/create/checking/account)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload da conta corrente como JSON string |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_create_checking_account_entry
Cria um LANÇAMENTO avulso de conta corrente (IncluirLancCC): tarifa, rendimento, aplicação, resgate, ajuste. _(POST /api/omie/create/checking/account/entry)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload do lançamento como JSON string |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_create_customer
Cadastra um cliente ou fornecedor (IncluirCliente). _(POST /api/omie/create/customer)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload do cliente/fornecedor como JSON string |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_create_payable
Lança (cria) uma conta a pagar (IncluirContaPagar). _(POST /api/omie/create/payable)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload da conta a pagar como JSON string |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_create_receivable
Lança (cria) uma conta a receber (IncluirContaReceber). _(POST /api/omie/create/receivable)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload da conta a receber como JSON string |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_delete_attachment
Remove um anexo de um documento (ExcluirAnexo). _(POST /api/omie/delete/attachment)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
tabela | string | Sim | Tabela do documento dono do anexo (ex.: "conta-pagar") (cliente, produto, servico, pedido-venda, remessa-produto, ordem-servico, contrato-servico, pedido-compra, nota-entrada, ordem-producao, conta-pagar, conta-receber, conta-corrente, conta-corrente-lancamento, crm-contas, crm-contatos, crm-oportunidades, com-recebimento) | |
id | string | number | Sim | Id do documento na tabela (ex.: codigo_lancamento_omie da conta a pagar) |
id_anexo | string | number | Não | Id do anexo na Omie (nIdAnexo, veja omie_list_attachments) |
codigo_integracao | string | Não | Código de integração do anexo (cCodIntAnexo), se você definiu um | |
file_name | string | Não | Nome do arquivo, alternativa ao id_anexo/codigo_integracao | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. | |
ids | string | number[] | Não | Bulk mode: multiple values for id |
#### omie_delete_checking_account_entry
APAGA/estorna um LANÇAMENTO de conta corrente (ExcluirLancCC) — movimentos da conta corrente como transferências, aplicações, resgates e tarifas, diferente de conta a pagar/receber (use omie_delete_pa _(POST /api/omie/delete/checking/account/entry)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
nCodLanc | string | number | Não | Código do lançamento de conta corrente na Omie (id interno) |
cCodIntLanc | string | Não | Código de integração (chave externa, máx. 20 chars) do lançamento de conta corrente | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_delete_payable
APAGA (exclui em definitivo) uma conta a pagar (ExcluirContaPagar). _(POST /api/omie/delete/payable)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_lancamento_omie | string | number | Não | Código do lançamento na Omie (id interno) |
codigo_lancamento_integracao | string | Não | Código de integração (chave externa) do lançamento | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_delete_receivable
APAGA (exclui em definitivo) uma conta a receber (ExcluirContaReceber). _(POST /api/omie/delete/receivable)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_lancamento_omie | string | number | Não | Código do lançamento na Omie (id interno) |
codigo_lancamento_integracao | string | Não | Código de integração (chave externa) do lançamento | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_get_attachment
Devolve o LINK DE DOWNLOAD de um anexo (ObterAnexo) — cLinkDownload, válido até dDtExpiracao. _(POST /api/omie/get/attachment)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
tabela | string | Sim | Tabela do documento dono do anexo (ex.: "conta-pagar") (cliente, produto, servico, pedido-venda, remessa-produto, ordem-servico, contrato-servico, pedido-compra, nota-entrada, ordem-producao, conta-pagar, conta-receber, conta-corrente, conta-corrente-lancamento, crm-contas, crm-contatos, crm-oportunidades, com-recebimento) | |
id | string | number | Sim | Id do documento na tabela (ex.: codigo_lancamento_omie da conta a pagar) |
id_anexo | string | number | Não | Id do anexo na Omie (nIdAnexo, veja omie_list_attachments) |
codigo_integracao | string | Não | Código de integração do anexo (cCodIntAnexo), se você definiu um | |
file_name | string | Não | Nome do arquivo, alternativa ao id_anexo/codigo_integracao | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. | |
ids | string | number[] | Não | Bulk mode: multiple values for id |
#### omie_get_checking_account_balance
EXTRATO BANCÁRIO e SALDO ATUAL de uma conta corrente (ListarExtrato). _(POST /api/omie/get/checking/account/balance)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
conta | string | number | Não | Conta corrente por NOME (descrição) OU id (nCodCC). Alternativa a nCodCC/cCodCCInt. |
nCodCC | string | number | Não | Código da conta corrente na Omie (id interno). |
cCodCCInt | string | Não | Código de integração (chave externa) da conta corrente. | |
data_inicial | string | Não | Início do período (AAAA-MM-DD ou DD/MM/AAAA). Default hoje. | |
data_final | string | Não | Fim do período (AAAA-MM-DD ou DD/MM/AAAA). Default hoje. | |
incluir_movimentos | boolean | Não | Se true, retorna também a lista de movimentos do período (default false = só os saldos). | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_get_checking_account_entry
Detalha um lançamento de conta corrente (ConsultaLancCC). _(POST /api/omie/get/checking/account/entry)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
nCodLanc | string | number | Não | Código do lançamento de conta corrente na Omie (id interno) |
cCodIntLanc | string | Não | Código de integração (chave externa, máx. 20 chars) do lançamento de conta corrente | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_get_customer
Detalha um cliente/fornecedor (ConsultarCliente). _(POST /api/omie/get/customer)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_cliente_omie | string | number | Não | Código do cliente na Omie (id interno) |
codigo_cliente_integracao | string | Não | Código de integração (chave externa) do cliente | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_get_payable
Detalha uma conta a pagar (ConsultarContaPagar). _(POST /api/omie/get/payable)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_lancamento_omie | string | number | Não | Código do lançamento na Omie (id interno) |
codigo_lancamento_integracao | string | Não | Código de integração (chave externa) do lançamento | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_get_receivable
Detalha uma conta a receber (ConsultarContaReceber). _(POST /api/omie/get/receivable)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_lancamento_omie | string | number | Não | Código do lançamento na Omie (id interno) |
codigo_lancamento_integracao | string | Não | Código de integração (chave externa) do lançamento | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_lancar
Atalho: lança uma conta a PAGAR ou a RECEBER em UMA chamada, resolvendo os códigos por NOME no servidor (fornecedor/cliente, categoria e conta corrente). _(POST /api/omie/lancar)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
tipo | string | Sim | "pagar" (conta a pagar) ou "receber" (conta a receber) (pagar, receber) | |
fornecedor | string | number | Sim | Cliente/fornecedor: nome (resolve por razão social/fantasia/CNPJ) OU código Omie (número). |
categoria | string | number | Sim | Categoria: nome (ex.: Fornecedores) OU código (ex.: 1.01.02). |
conta_corrente | string | number | Sim | Conta corrente: nome (ex.: Itaú) OU id (nCodCC). |
valor | number | Sim | Valor do documento (ex.: 500.00). | |
vencimento | string | Sim | Data de vencimento (AAAA-MM-DD ou DD/MM/AAAA). | |
data_previsao | string | Não | Previsão de pagamento/recebimento (default = vencimento). | |
numero_documento | string | Não | Nº do documento (opcional). | |
observacao | string | Não | Observação (opcional). | |
codigo_lancamento_integracao | string | Não | Sua chave de integração única (opcional; gerada se ausente). | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_accounts
Lista as empresas (CNPJ) Omie conectadas a este install — id, label. _(POST /api/omie/list/accounts)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_attachments
Lista os anexos de um documento (ListarAnexo). _(POST /api/omie/list/attachments)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
tabela | string | Sim | Tabela do documento (ex.: "conta-pagar") (cliente, produto, servico, pedido-venda, remessa-produto, ordem-servico, contrato-servico, pedido-compra, nota-entrada, ordem-producao, conta-pagar, conta-receber, conta-corrente, conta-corrente-lancamento, crm-contas, crm-contatos, crm-oportunidades, com-recebimento) | |
id | string | number | Sim | Id do documento na tabela |
page | integer | Não | Página (default 1) | |
page_size | integer | Não | Registros por página (default 50, máx 500) | |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. | |
ids | string | number[] | Não | Bulk mode: multiple values for id |
#### omie_list_categories
Lista as categorias / plano de contas da empresa (ListarCategorias). _(POST /api/omie/list/categories)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_checking_account_entries
Lista lançamentos de conta corrente (ListarLancCC). _(POST /api/omie/list/checking/account/entries)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_checking_accounts
Lista as contas correntes (bancos/caixa) cadastradas na empresa (ListarContasCorrentes). _(POST /api/omie/list/checking/accounts)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_customers
Lista clientes/fornecedores/transportadoras (ListarClientes). _(POST /api/omie/list/customers)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_departments
Lista os departamentos / centros de custo da empresa (ListarDepartamentos). _(POST /api/omie/list/departments)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_document_types
Lista os tipos de documento (dinheiro, boleto, cartão, transferência etc.) — PesquisarTipoDocumento. _(POST /api/omie/list/document/types)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
codigo | string | Não | Filtra um código específico (ex.: TRA); vazio = todos |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_financial_movements
Lista movimentos financeiros — lançamentos/baixas de contas a pagar, a receber e conta corrente (ListarMovimentos). _(POST /api/omie/list/financial/movements)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_invoices
Lista notas fiscais (NF-e) emitidas (ListarNF). _(POST /api/omie/list/invoices)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_payables
Lista contas a pagar (ListarContasPagar). _(POST /api/omie/list/payables)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
status | string | Não | Filtro simples de situação (default todos). Prefira este ao filtrar_por_status cru: o da Omie devolve CANCELADO junto com PAGO/LIQUIDADO. (aberto, pago, cancelado, todos) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_projects
Lista os projetos da empresa (ListarProjetos). _(POST /api/omie/list/projects)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_list_receivables
Lista contas a receber (ListarContasReceber). _(POST /api/omie/list/receivables)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Página (default 1) |
page_size | integer | Não | Registros por página (default 50, máx 500) |
filters | string | Não | Filtros extras como JSON string, mesclados no param da chamada Omie (ex.: {"filtrar_por_data_de":"01/01/2026","filtrar_por_data_ate":"31/01/2026","filtrar_por_status":"ABERTO"}). Datas no padrão Omie DD/MM/AAAA. |
status | string | Não | Filtro simples de situação (default todos). Prefira este ao filtrar_por_status cru: o da Omie devolve CANCELADO junto com PAGO/LIQUIDADO. (aberto, pago, cancelado, todos) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_reconcile_receipt
Marca a baixa de um recebimento como CONCILIADA (ConciliarRecebimento). _(POST /api/omie/reconcile/receipt)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_baixa | string | number | Não | Código da BAIXA na Omie (id numérico), não do lançamento |
codigo_baixa_integracao | string | Não | Código de integração da baixa (o que você usou ao dar baixa) | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_settle_payable
Dá baixa (liquida/paga) uma conta a pagar (LancarPagamento). _(POST /api/omie/settle/payable)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload da baixa como JSON string (inclua a chave do lançamento) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_settle_receivable
Dá baixa (liquida/recebe) uma conta a receber (LancarRecebimento). _(POST /api/omie/settle/receivable)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload da baixa como JSON string (inclua a chave do lançamento) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_transfer_between_accounts
TRANSFERE dinheiro entre DUAS contas correntes da própria empresa (IncluirLancCC com bloco transferencia). _(POST /api/omie/transfer/between/accounts)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
conta_origem | string | number | Sim | Conta de ORIGEM (de onde sai): nome (ex.: Itaú) OU id (nCodCC). |
conta_destino | string | number | Sim | Conta de DESTINO (pra onde vai): nome OU id (nCodCC). |
valor | number | Sim | Valor da transferência (ex.: 1500.00). | |
data | string | Não | Data do lançamento (default: hoje). | |
observacao | string | Não | Observação do lançamento (opcional). | |
tipo_documento | string | Não | Tipo de documento (cTipo). Default TRA (Transferência); veja outros em omie_list_document_types. | |
categoria | string | number | Não | Categoria: nome OU código. Omita para a plataforma usar a categoria de transferência do seu plano de contas (a Omie marca com transferencia: S). |
codigo_integracao | string | Não | Sua chave única do lançamento (cCodIntLanc, máx. 20; gerada se ausente). | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_unreconcile_receipt
Desfaz a conciliação de uma baixa de recebimento (DesconciliarRecebimento). _(POST /api/omie/unreconcile/receipt)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
codigo_baixa | string | number | Não | Código da BAIXA na Omie (id numérico), não do lançamento |
codigo_baixa_integracao | string | Não | Código de integração da baixa (o que você usou ao dar baixa) | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_update_checking_account
Edita uma conta corrente existente (AlterarContaCorrente). _(POST /api/omie/update/checking/account)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload como JSON string (inclua nCodCC ou cCodCCInt) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_update_checking_account_entry
Edita um lançamento de conta corrente (AlterarLancCC). _(POST /api/omie/update/checking/account/entry)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload como JSON string (inclua nCodLanc ou cCodIntLanc) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_update_customer
Edita um cliente/fornecedor existente (AlterarCliente). _(POST /api/omie/update/customer)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload como JSON string (inclua codigo_cliente_omie ou codigo_cliente_integracao) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_update_payable
Edita uma conta a pagar existente (AlterarContaPagar). _(POST /api/omie/update/payable)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload como JSON string (inclua codigo_lancamento_omie ou codigo_lancamento_integracao) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_update_receivable
Edita uma conta a receber existente (AlterarContaReceber). _(POST /api/omie/update/receivable)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Payload como JSON string (inclua codigo_lancamento_omie ou codigo_lancamento_integracao) |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_upload_attachment
Anexa um arquivo (comprovante, boleto, NF em PDF/PNG…) a um documento da Omie — IncluirAnexo. _(POST /api/omie/upload/attachment)_
| Parâmetro | Tipo | Obrigatório | Descrição | |
|---|---|---|---|---|
tabela | string | Sim | Tabela do documento que recebe o anexo (ex.: "conta-pagar") (cliente, produto, servico, pedido-venda, remessa-produto, ordem-servico, contrato-servico, pedido-compra, nota-entrada, ordem-producao, conta-pagar, conta-receber, conta-corrente, conta-corrente-lancamento, crm-contas, crm-contatos, crm-oportunidades, com-recebimento) | |
id | string | number | Sim | Id do documento na tabela (ex.: codigo_lancamento_omie da conta a pagar) |
file_url | string | Não | URL para baixar o arquivo | |
file_base64 | string | Não | Conteúdo do arquivo em base64 (arquivos pequenos) | |
upload_id | string | Não | Id de um upload já enviado (ex.: "upl_…"). Chame a tool sem arquivo pra receber o comando de upload. | |
file_path | string | Não | Caminho do arquivo anexado pelo usuário (ex.: /mnt/user-data/uploads/comprovante.pdf). Usado só pra montar o comando de upload, o servidor NÃO lê o seu disco. | |
upload_code | string | Não | Legado: código do relay antigo via curl (ex.: "file-a1b2c3d4") | |
file_name | string | Não | Nome do arquivo com extensão (ex.: comprovante.pdf); obrigatório com file_url/file_base64 | |
codigo_integracao | string | Não | Sua chave de integração do anexo (cCodIntAnexo, máx. 20 chars) pra localizá-lo depois | |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. | |
ids | string | number[] | Não | Bulk mode: multiple values for id |
upload_ids | string[] | Não | Bulk mode: multiple values for upload_id |
#### omie_upsert_payables_batch
Cria OU atualiza VÁRIAS contas a pagar numa chamada (UpsertContaPagarPorLote). _(POST /api/omie/upsert/payables/batch)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | JSON string {"lote":N,"conta_pagar_cadastro":[…]} |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
#### omie_upsert_receivables_batch
Cria OU atualiza VÁRIAS contas a receber numa chamada (UpsertContaReceberPorLote). _(POST /api/omie/upsert/receivables/batch)_
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | JSON string {"lote":N,"conta_receber_cadastro":[…]} |
account | string | Não | Quando há múltiplas empresas Omie conectadas: id ou label da conexão. Veja omie_list_accounts. |
Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_omie — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.