---
name: omie-mcp
description: Skill da REST API do Omie na MCP.AI: 44 endpoints em /api/omie. 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). Autentique com workspace API key (sk_live) gerada em app.mcp.ai/settings/api-keys. Use quando o usuário pedir algo coberto pelos endpoints.
---

# Omie — REST API skill

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

## Base URL

```
https://api.mcp.ai/api/omie
```

Todo endpoint é um **POST** na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

## Autenticação

Inclua em toda request:

```
Authorization: Bearer sk_live_...
Content-Type: application/json
```

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

## Formato de resposta

```json
{ "ok": true, "tool": "<tool_id>", "result": <payload> }
```

## Exemplo cURL

```bash
curl -X POST https://api.mcp.ai/api/omie/cancel/payment \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Reportar problemas

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.

## Endpoints (44)

#### `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](../../README.md). A skill acima é pra consumir a **REST API** direto (agente próprio / código).