Conectar o Olist ERP (Tiny)

Com o Olist ERP conectado, os pedidos dos seus canais de venda chegam ao Paylog prontos para separação e envio, e o código de rastreio e o status retornam automaticamente ao Olist e aos marketplaces.

#Antes de começar

Confira se:

1. sua conta possui permissão para gerenciar integrações;
2. seu plano do Olist inclui Integrações via API — planos de entrada não incluem (na dúvida, confira a página de planos ou pergunte ao suporte Olist);
3. você consegue entrar no Olist com um usuário administrador com acesso aos módulos de Produtos, Pedidos e Notas Fiscais.

#1. Criar o aplicativo na sua conta Olist

1. No Olist, instale a extensão "Gestão de Aplicativos" (grátis) pela Loja de extensões, se ainda não tiver — a tela de Aplicativos só aparece depois de instalar a extensão. Busque por "apli" e clique em Instalar.

   

   

2. Acesse a tela de Aplicativos API (Configurações → aba Geral → Aplicativos) e clique em + Novo aplicativo.

3. Dê um nome ao aplicativo (por exemplo, "Paylog").

4. No campo URL de Redirecionamento, cole a URL exibida no Paylog em Ferramentas → Integrações → Olist ERP (Tiny) (passo "Aplicativo" do assistente).

5. Em Permissões do aplicativo, marque exatamente:

   Leitura e Incluir e editar:

   • Pedidos
   • Expedição
   • Notas Fiscais

   Somente Leitura:

   • Contatos
   • Produtos
   • Forma de Envio
   • Forma de Pagamento
   • Informações da Conta
   Importante

   Qualquer módulo faltando faz a conexão falhar depois de você autorizar (a mensagem de erro indica qual módulo corrigir). "Excluir" não é necessário em nenhum módulo. Se alterar as permissões depois, basta salvar no Olist e conectar novamente — não é preciso gerar novas chaves.

6. Clique em Salvar — as chaves são geradas após salvar. Na seção Chaves de acesso, copie o Client ID e o Client Secret.

#2. Colar as chaves no Paylog

1. No Paylog, acesse Ferramentas → Integrações → Olist ERP (Tiny). A página tem três abas: Configurações (assistente de conexão e opções), Mapeamento de SKUs (a fila de códigos do Olist) e Webhooks (histórico dos eventos recebidos).
2. Na aba Configurações, no painel Aplicativo da sua conta Olist, cole o Client ID e o Client Secret copiados do Olist.
3. Clique em Salvar credenciais.
4. (Opcional) Clique em Testar credenciais para confirmar que o Olist reconheceu o seu aplicativo.

#3. Autorizar a conexão

1. Clique em Conectar Olist.
2. Entre com um usuário administrador da sua conta Olist e confirme as permissões solicitadas.
3. De volta ao Paylog, o cartão da integração muda para Conectado e exibe a empresa vinculada.

Depois de autorizar uma única vez, o Paylog renova a autorização automaticamente — você não precisa entrar de novo. Só será necessário reconectar se as chaves do aplicativo forem regeneradas ou se a conexão for desconectada.

#4. Registrar o webhook (recomendado — pedidos em tempo real)

Recomendamos registrar o webhook para os pedidos chegarem imediatamente. Sem ele, os pedidos ainda entram pela sincronização periódica (a cada 15 minutos) — o webhook só muda a velocidade, não a cobertura.

1. No Paylog, copie a sua URL de Webhook exclusiva — ela aparece no passo Webhook do assistente assim que você salva as credenciais (e também nas configurações da conexão, quando ativa).
2. No Olist, instale o aplicativo "Webhooks" pela Loja de extensões, se ainda não tiver. Ele está disponível apenas em planos específicos — consulte o suporte Olist caso não apareça.
3. Acesse Menu ☰ → Configurações → aba Geral → Outras configurações → Webhooks.
4. Ative e cole a URL copiada nos campos Receber notificações de vendas e Receber notificações de notas fiscais autorizadas.
5. Se você ainda não autorizou a conexão, volte ao assistente e clique em Tudo pronto — Conectar Olist no próprio passo Webhook (ou em Conectar Olist no passo Conectar) — enquanto a autorização não é concluída, o cartão da integração mostra Aguardando autorização.

#Depois de conectado

• Seu catálogo do Olist é importado automaticamente: cada SKU vira um mapeamento e, quando o código coincide com um produto seu no Paylog (código da plataforma, código de barras ou GTIN), o vínculo já sai pronto — os pedidos chegam prontos para envio.
• Kits: produtos do tipo kit entram como "pendentes" na aba Mapeamento de SKUs — ao abrir, a composição vem pré-preenchida com os produtos de dentro do kit; confira e confirme (assim cada pedido de kit expede todos os itens internos, como no Bling).
• Os SKUs que não coincidirem automaticamente ficam aguardando na aba Mapeamento de SKUs desta mesma página.
• Os pedidos dos canais configurados no Olist passam a ser importados automaticamente.
• As configurações da conexão (situações importadas, canais excluídos, embalagem padrão e webhook) ficam no painel direito do cartão da integração.

#Usar o Olist como emissor de NF-e

Depois de conectar, abra a aba Configurações e ative Usar Olist como emissor de NF-e somente se a sua operação emite as notas pelo próprio Olist.

Quando essa opção estiver ligada, o Paylog cria e autoriza a NF-e no Olist antes da etiqueta para os pedidos que chegaram por essa conexão Olist, usando os produtos e os dados fiscais configurados nela. Antes de emitir, o Paylog confere se o pedido já possui uma nota no Olist para não criar uma segunda NF-e.

Essa escolha não transforma o Olist no emissor de toda a conta: pedidos e produtos vindos de outras integrações continuam seguindo o emissor fiscal configurado pelo produtor (como Notazz, Spedy ou Bling). Se você desativar a opção, os pedidos Olist também passam a seguir esse emissor configurado da conta.

#Problemas comuns