Skip to main content

​
Integração com Olist

Olist O Olist é um ERP completo para e-commerce. A integração com o ERPulse usa a API V3 com autenticação OAuth 2.0 via aplicativo privado.

​
Visão geral

O ERPulse integra com o Olist para:
  • Importar pedidos de venda automaticamente (polling a cada 15 minutos)
  • Sincronizar produtos e clientes
  • Imprimir etiquetas térmicas e DANFE
  • Sincronizar status de pedidos de volta ao ERP
  • Enviar código de rastreamento ao ERP
  • Listar transportadoras e formas de envio
A conexão é feita via aplicativo privado criado na sua conta Olist. Não há aplicativo público na loja — cada empresa cria o seu.

​
Pré-requisitos

  • Plano Construa ou superior no Olist ERP
  • Extensão Gestão de Aplicativos instalada na conta
  • Conta no ERPulse ativa

​
Passo 1: Criar o aplicativo no Olist

  1. No Olist, acesse menu → Configurações → aba Geral → Aplicativos
  2. Clique em + Novo aplicativo
  3. Em Nome do aplicativo, preencha ERPulse (ou outro nome que identifique a integração)
  4. Em URL de Redirecionamento, cole o endereço exibido na tela de configuração do ERPulse — ele é usado para autenticar o aplicativo
  5. Clique em Salvar
Formulário de novo aplicativo no Olist com os campos Nome do aplicativo e URL de Redirecionamento
Cada conta Olist pode ter no máximo 5 aplicativos configurados.

​
Passo 2: Copiar as chaves de acesso

Após salvar, edite o aplicativo recém-criado e copie as chaves na seção Chaves de acesso:
  • Client ID
  • Client Secret
Estas chaves são sensíveis. Não as divulgue — elas dão acesso total aos dados da conta. Se comprometidas, clique em Gerar novas chaves no Olist (a chave antiga é invalidada automaticamente).

​
Passo 3: Configurar permissões

Na seção Permissões do aplicativo, marque os módulos abaixo com pelo menos Leitura:
Para sincronizar status e rastreamento de volta ao ERP, marque Incluir e editar em Pedidos.
Sempre que alterar as permissões do aplicativo, clique em Gerar novas chaves e atualize a Client Secret no ERPulse — do contrário a integração falha com erro de conexão.

​
Passo 4: Conectar no ERPulse

Tela do ERPulse: Integrações → Nova Integração → form do Olist com Client ID/Secret
  1. No ERPulse, acesse Integrações → Nova Integração
  2. Selecione Olist
  3. Preencha o Client ID e Client Secret
  4. Defina a data de início da importação — pedidos a partir desta data serão importados
  5. Clique em Salvar configuração
  6. Clique em Autorizar no Olist — você será redirecionado ao Olist
  7. Após autorizar, clique em Testar conexão

​
Passo 5: Sincronização inicial

Após conectar, a sincronização automática ocorre a cada 15 minutos. Para a primeira carga:
  1. Na lista de integrações, clique na integração Olist
  2. Vá na aba Sincronização
  3. Clique em Sincronizar agora
  4. Aguarde — produtos e pedidos serão importados

​
O que é importado

​
Sincronização de status (escrita)

O ERPulse envia alterações de status de volta ao Olist quando você:
  • Imprime pedidos (configurável em Configurações → Impressão)
  • Marca pedidos como faturado
  • Envia código de rastreamento
O Olist não oferece webhooks com assinatura criptográfica documentada. Por isso, a integração usa polling autenticado em vez de webhooks inbound.

​
Migrando do Omie

Se você já usa o Omie e está migrando para o Olist:
  • Produtos não são duplicados — o sync do Olist matcheia por SKU e reaproveita o cadastro existente
  • Pedidos antigos permanecem no histórico vinculados à integração Omie
  • Pedidos novos chegam via Olist a partir da data de início configurada
  • A integração Omie é desativada (não deletada) para preservar o histórico
Entre em contato com o suporte (support@erpulse.ai) para auxiliar na migração.

​
Limites da API

A API V3 do Olist tem limites de requisições por minuto: O ERPulse respeita esses limites automaticamente. Em caso de excedente (HTTP 429), a sincronização pausa e retoma sozinha.
O limite é por conta, não por aplicativo — se houver mais de um aplicativo na conta Olist, eles compartilham o mesmo limite.

​
Problemas comuns

​
Erro 401 (não autorizado)

Duas causas possíveis:
  1. Token expirado — clique em Autorizar no Olist novamente para renovar
  2. Usuário sem permissão no módulo — a autenticação via API depende do usuário que autorizou o app ter acesso ao módulo (ex.: Pedidos). No Painel de Controle do Olist, verifique o perfil do usuário e libere o acesso ao módulo, depois tente novamente
Se você alterou as permissões do aplicativo recentemente, lembre-se de clicar em Gerar novas chaves no Olist e atualizar a Client Secret no ERPulse.

​
Erro 403 (proibido)

O aplicativo não tem as permissões necessárias. Volte no Olist → Configurações → Aplicativos → ERPulse e marque os módulos necessários.

​
Pedidos não chegam

  1. Verifique se a data de início da importação está correta
  2. Verifique se a integração está ativa e sync habilitado
  3. Aguarde o próximo ciclo de polling (15 minutos) ou dispare sync manual

​
Produtos duplicados

Os produtos são matcheados por SKU. Se um produto veio duplicado:
  1. Verifique se o SKU no Olist está preenchido e é igual ao do ERPulse
  2. Corrija o SKU no Olist ou no ERPulse
  3. Dispare uma nova sincronização

​
Suporte

Documentação oficial do Olist: Aplicativos API V3 — Configurações e Utilização. Precisa de ajuda? Envie um email para support@erpulse.ai ou acesse nossa página de contato.