Skip to main content

​
Integração com Omie

O Omie é um ERP completo usado por e-commerces e empresas de diversos portes. A integração com o ERPulse importa pedidos, produtos e clientes automaticamente. A configuração tem 4 etapas:
  1. Obter as credenciais (App Key e App Secret) no portal do desenvolvedor Omie
  2. Criar a integração no ERPulse
  3. Configurar o webhook no Omie — etapa obrigatória para receber pedidos em tempo real
  4. Fazer a sincronização inicial

​
Passo 1: Obter as credenciais no Omie

A App Key e o App Secret são gerados na Área do Desenvolvedor do Omie:
  1. Faça login no Omie
  2. Abra uma nova guia no navegador e acesse o Developer Omie
  3. Na tela inicial, clique em Aplicativos
  4. Localize o aplicativo da sua empresa — a APP_KEY já aparece na listagem, e clicar sobre o aplicativo expande as informações (credenciais e webhooks configurados)
Lista de aplicativos no Developer Omie exibindo o aplicativo e a APP_KEY
  1. Copie a App Key e o App Secret
Se ainda não existe um aplicativo, crie um na própria tela de Aplicativos do Developer Omie antes de continuar.

​
Passo 2: Criar a integração no ERPulse

  1. Acesse Integrações → Nova Integração
  2. Selecione Omie
  3. Informe as credenciais da API (App Key e App Secret)
  4. Clique em Salvar
  5. A integração está ativa
Tela do ERPulse: form de configuração da integração Omie com App Key e App Secret

​
Passo 3: Configurar o webhook no Omie

Sem esse passo o ERPulse não recebe pedidos em tempo real — a importação só acontece na sincronização manual.
  1. Abra uma nova guia e acesse o Developer Omie
  2. Clique em Aplicativos
Tela inicial do Developer Omie com a opção Aplicativos destacada
  1. Clique no mesmo aplicativo usado no Passo 1 para expandir as informações
  2. Clique em ⚙️ Adicionar novo webhook
Aplicativo expandido no Developer Omie exibindo os webhooks configurados e o botão Adicionar novo webhook
  1. Cole a URL do endpoint do ERPulse no campo Endpoint:
Formulário de novo webhook no Omie com o campo Endpoint e a lista de assuntos
Essa URL também aparece na própria tela de configuração da integração Omie no ERPulse, no aviso “Importante sobre Webhooks”.
  1. Em Assuntos, ative os eventos que deseja receber (veja a tabela abaixo)
  2. Role até o final da página e clique em Salvar
Final da lista de assuntos do webhook no Omie com eventos marcados e o botão Salvar
As configurações de webhook só passam a valer para novas sessões do Omie. Após salvar, recarregue o aplicativo Omie (ou faça logout/login) antes de testar.

​
Eventos recomendados

Se a empresa vende por marketplace ou PDV, o Omie oferece os mesmos eventos com sufixo .marketplace ou .pdv (ex.: Produto.Alterado.marketplace) — o ERPulse também os reconhece, ative se aparecerem na sua listagem. Os demais eventos (finanças, CRM, compras, contratos etc.) não são utilizados pela integração.

​
Passo 4: Sincronização inicial

Após conectar, faça a sincronização inicial:
  1. Na lista de integrações, clique na integração Omie
  2. Clique em Sincronizar agora
  3. Aguarde — os pedidos recentes serão importados

​
O que é importado

​
Problemas comuns

​
Credenciais inválidas

Se a sincronização falhar com erro de autenticação:
  1. Verifique se a App Key e App Secret estão corretos no Developer Omie
  2. Acesse Integrações → clique na integração Omie → Editar
  3. Atualize as credenciais
  4. Salve e tente sincronizar novamente

​
Rate limit (429)

O Omie limita requisições por minuto. Se acontecer:
  • Aguarde alguns minutos
  • A sincronização retoma automaticamente

​
Pedidos não chegam

  1. Verifique se o webhook foi configurado no Developer Omie (Passo 3) e se os eventos VendaProduto.* estão ativos
  2. Verifique se a URL colada é exatamente https://api.erpulse.ai/v1/webhooks/omie
  3. Verifique se a assinatura está ativa
  4. Acesse Logs → Webhook Logs para ver se os webhooks estão chegando
  5. Se não chegarem, clique em Sincronizar agora para forçar a importação

​
Suporte

Precisa de ajuda? Envie um email para support@erpulse.ai ou acesse nossa página de contato.