Omie (ERP brasileiro)

Conecta ao Omie pra ler/escrever clientes, pedidos, financeiro, NFe.

Pré-requisito

Conta Omie com API. Na área do desenvolvedor Omie, gera App Key + App Secret.

Configurar

App → Integrações → Omie:

• App Key
• App Secret

Usar — invoke pattern

Omie usa POST com call (nome da operação) e path do recurso:

const clientes = await integrations.omie.invoke(
  "ListarClientes",                    // call
  "/api/v1/geral/clientes/",           // path
  { pagina: 1, registros_por_pagina: 50 }  // body params
);

const pedidos = await integrations.omie.invoke(
  "ListarPedidos",
  "/api/v1/produtos/pedido/",
  { pagina: 1, filtrar_apenas_pendente: "S" }
);

const novoCliente = await integrations.omie.invoke(
  "IncluirClienteResumido",
  "/api/v1/geral/clientes/",
  { codigo_cliente_integracao: "ABC123", razao_social: "Acme LTDA", email: "..." }
);

Endpoints comuns

• /api/v1/geral/clientes/ — clientes
• /api/v1/produtos/pedido/ — pedidos
• /api/v1/financas/contapagar/ — contas a pagar
• /api/v1/financas/contareceber/ — contas a receber

Documentação Omie API

Diferença vs Bling

• Bling: REST tradicional (GET/POST/PUT/DELETE com paths)
• Omie: SOAP-style RPC (POST com call no body)

A integração esconde isso, mas as conventions são diferentes.