Como integrar sua loja com a Adsomos via Olist
Siga o passo a passo para integrar seus produtos e começar a vender com mais eficiência:
Solicite os dados de autenticação da API
Assim que sua loja iniciar a parceria com a Olist, solicite os dados de acesso à API. Eles são essenciais para que seus produtos possam ser enviados à plataforma Olist.
Cadastre os dados de autenticação
Com os dados em mãos, preencha as informações a seguir:
- Client ID: fornecido pela Olist no momento da solicitação.
- Client Secret: fornecido juntamente com o Client ID.
- E-mail: o mesmo e-mail cadastrado na Olist. É por ele que os tokens de acesso serão gerados.
- Autorização: habilite as permissões para envio e exclusão de produtos.
- Origem: preencha com o nome da sua loja, sem espaços. Esse campo será utilizado para identificar a origem dos produtos nos marketplaces.
Importante: Certifique-se de preencher todas as informações corretamente para garantir o funcionamento da integração.
Como gerar os tokens de integração na Olist via Adsomos
Para integrar corretamente sua loja, você precisará gerar três tokens com permissões específicas para acessar as APIs da Olist.
Onde encontrar:
- Acesse o caminho: E-Commerce > Marketplace > Olist > Tokens
Passo a passo para gerar os tokens:
- Clique em “Gerar novo token”.
- Repita esse processo três vezes — cada token será usado para uma finalidade diferente:
- Products (produtos)
- Fullfilment (rastreamento de pedidos)
- Orders (pedidos)
- Após gerar os tokens, atribua corretamente a função de cada um:
- Token 1: selecione Products
- Token 2: selecione Fullfilment
- Token 3: selecione Orders
- Feita a configuração de atribuição, clique em “Salvar” (no canto superior esquerdo da tela).
Dica: Organize os tokens de forma que você consiga identificá-los facilmente no futuro, conforme sua finalidade.
Autenticação inicial ao gerar token
Na primeira vez que você clicar em “Gerar token”, será necessário fazer uma autenticação manual.
Isso acontece porque é preciso fazer o login em uma conta que tenha autorização para enviar e excluir produtos na Olist via API.
- Uma nova janela será aberta para o login.
- Faça o login com a conta autorizada.
- Após a autenticação, você pode fechar essa janela.
- Nas próximas gerações de token, essa autenticação não será mais solicitada.
Configuração dos Status de Pedidos
Acesse o caminho: E-Commerce > Market Place > Olist > Campos
Neste local, você poderá configurar os status dos pedidos que chegam na plataforma diretamente da Olist.
Tabela de Log
Para acompanhar os processos das sincronizações, acesse:
E-Commerce > Market Place > Olist > Logs
Nessa tabela, você visualizará informações sobre:
- Notificações de rastreio
- Pedidos
- Produtos
- Erros que possam ocorrer durante a integração
Importante: Os erros exibidos nessa tabela estão relacionados aos retornos da Olist via API, principalmente sobre produtos e pedidos.
Por exemplo, se um produto não for aprovado na revisão por conter campos faltantes ou incorretos, o erro aparecerá aqui para que você possa fazer os ajustes necessários.
Sincronização de Produtos e Preço
Para habilitar um produto para sincronização, acesse a aba Market Place e marque a opção Status na Olist.
O preço do produto pode ser enviado diferentemente para cada marketplace, porém recomendamos enviar o preço apenas para o canal Mercado Livre. Após a publicação do anúncio neste canal, o preço será replicado automaticamente para os demais marketplaces.
Status dos Produtos Sincronizados
Na tabela de logs, é possível acompanhar o status de cada produto habilitado para sincronização:
- created: Produto registrado e pronto para envio à moderação.
- moderation: Produto aguardando moderação da Olist.
- aprovado: Produto aprovado pela equipe de revisão, será enviado para moderação nos canais de venda.
- moderation_by_channel: Produto em moderação nos canais de venda.
- published: Produto aprovado e publicado nos canais.
- rejected: Produto rejeitado em alguma etapa da moderação. Verifique a tabela de logs para entender os motivos.
