Cada informação tem um caminho
- Olist → Yavendió
- Produtos, variantes, preços e estoque. A Olist é a origem dos dados do catálogo importado.
- Yavendió → Olist
- Pedidos criados pelo vendedor, com os itens e os dados do cliente disponíveis no pedido. O envio usa a API da Olist.
- Olist → Yavendió, quando habilitado
- Notificações de alterações na situação dos pedidos. Esse retorno depende da configuração disponível para sua conta.
As atualizações dependem da conexão, das notificações configuradas e dos limites da Olist. Não são uma garantia de atualização instantânea nem de reserva de estoque entre todos os canais.
Conecte pela versão da sua conta
Use v2 se sua conexão pede token do app API do ERP. Use v3 se pede Client ID, Client Secret e autorização na Olist. Mudar de versão exige revisar a conexão e os vínculos do catálogo.
Olist v2 Token do API do ERP
1Abra a integração API do ERP
Na Olist, entre em Integrações, procure API do ERP e instale a integração. Se ela já existe para a Yavendió, abra Gerenciar.
2Conecte sua conta na Yavendió
Na aba Conexão da Olist, copie o token e o identificador da integração. Na Yavendió, escolha Olist v2 e informe os campos solicitados. Use os dados da mesma integração.
3Defina as regras de produtos
Conclua as opções de produtos e estoque no assistente da Olist. Confira como a sua operação trata produtos com variações e quais itens estarão disponíveis para envio.
4Escolha a fonte de preços
Na Yavendió, escolha o preço do catálogo ou uma lista de preços da Olist. Se usa uma lista, confira se os produtos que vai enviar estão nela.
5Revise pedidos e notificações
Conclua as regras de pedidos na Olist. Para produtos, preços e estoque, copie as URLs que a sua tela da Yavendió disponibiliza e cole nos campos correspondentes de Notificações da Olist. Salve também na Olist.
6Envie os produtos
No catálogo da Olist, selecione os produtos desejados e use a ação de envio para a integração API do ERP configurada. Como alternativa, escolha a importação pela API na Yavendió. As duas opções estão explicadas abaixo.
7Confira o resultado
Veja os produtos na Yavendió, confira preço, estoque e uma variante. Depois faça um pedido de teste, acompanhe em Pedidos sincronizados e confira o pedido dentro da Olist. Avançar o guia não confirma essas operações.
Se a Yavendió não mostrar uma URL de situação de pedidos ou uma opção de mapeamento, essa configuração não está disponível para sua conta. Não invente uma URL nem use a de rastreio ou nota fiscal. Continue os passos disponíveis e valide o envio do pedido pela API.
Olist v3 Aplicativo com OAuth
1Crie o aplicativo na sua Olist
Abra os aplicativos da Olist e crie um aplicativo para a Yavendió. Copie exatamente a URL de redirecionamento mostrada na conexão da Yavendió. A URL deve corresponder ao ambiente que você está usando.
2Autorize o acesso
Informe Client ID e Client Secret nos campos de conexão da Yavendió. Entre na Olist e autorize as permissões necessárias. Se alterar as permissões do aplicativo depois, autorize novamente.
3Configure preços e selecione produtos
Escolha catálogo ou lista de preços. Pesquise e marque os produtos na Yavendió, ou use Sincronizar todos para solicitar o catálogo completo.
4Acompanhe e valide
A importação consulta a API da Olist em etapas. Confira o resultado, as variantes e o envio de um pedido antes de colocar toda a operação em uso.
Em staging ou preview, copie a URL mostrada para esse ambiente. Uma URL antiga de preview ou de outro ambiente pode impedir a autorização. Se isso aparecer, peça suporte antes de salvar o aplicativo.
Você precisa de acesso administrativo à sua Olist e dos recursos de API/integração habilitados no plano. O nome do plano, sozinho, não confirma o acesso: confira na Olist.
Você escolhe os produtos que entram
Enviar pela Olist, na v2
Você seleciona os itens no ERP e manda para a integração API do ERP. A Olist entrega os produtos à URL configurada na Yavendió. Cadastrar a URL não envia sozinho os produtos que já existem.
Buscar pela Yavendió, na v2 ou v3
A Yavendió consulta a API, lista os produtos e permite pesquisar e selecionar. “Selecionar visíveis” marca os itens exibidos. “Sincronizar todos” solicita o catálogo completo e pode levar mais tempo.
Tem mais de 500 produtos?
O limite de 500 é por envio de seleção manual na Yavendió, não para o tamanho total do catálogo. Use “Sincronizar todos” ou envie seleções de até 500. Por exemplo, 600 itens podem ser enviados em grupos de 500 e 100. Na v2, a seleção feita no ERP é outro fluxo.
E os produtos com variantes?
Um produto pode trazer várias opções, como cor, tamanho ou estampa. Cada variante precisa manter seu próprio vínculo com a Olist. Um produto com quatro opções continua sendo um produto pai e quatro variantes; esses números podem aparecer separados no acompanhamento.
Antes de vender uma grade, confira uma opção na Yavendió e faça um pedido de teste. O item recebido na Olist deve ser a variante escolhida, com o SKU, a quantidade e o preço corretos.
Importações da Olist têm tratamento próprio da quota de produtos da Yavendió. Isso não remove os limites de API ou do plano contratado na Olist. Imagens podem aumentar o tempo de importação.
Preço escolhido e estoque conferido
- Catálogo ou lista de preços
- Escolha a fonte em Configurar preços. Ao usar uma lista, verifique seus itens e compare um preço após a importação. Se ela falhar ou não aparecer, revise a configuração antes de trocar de fonte.
- Zero não é uma consulta que falhou
- Estoque zero, estoque não controlado e falha ao consultar a Olist são situações diferentes. Se a quantidade estiver divergente, confira o produto no ERP e o resultado da sincronização.
- Atualizações posteriores
- Mantenha as notificações disponíveis configuradas. A sincronização também pode consultar a API periodicamente. Alterar preço ou estoque no ERP pode levar algum tempo para aparecer na Yavendió.
Do pedido ao registro no ERP
- O cliente confirma os itens e informa os dados necessários ao pedido.
- A Yavendió usa os vínculos dos produtos para enviar o pedido pela API da Olist.
- Em Gerenciar conexão → Pedidos sincronizados, confira o resultado. Depois localize o pedido na Olist.
O envio leva os dados preenchidos no pedido: nome, CPF/CNPJ, telefone e endereço, incluindo CEP, número e complemento quando informado. Quantidades, valores e frete também precisam estar corretos.
O webhook de situação não cria o pedido na Olist. Ele faz o caminho de volta e comunica mudanças de situação. Se um pedido não chegou ao ERP, confira o erro de envio e o vínculo dos itens.
A emissão de nota fiscal e o despacho são feitos na Olist conforme sua operação. Conectar o ERP não ativa emissão automática de notas nem exige uma configuração separada de coleta fiscal aqui.
Algo não saiu como esperado?
- A conexão falhou
- Na v2, confirme o token e o identificador da mesma integração. Na v3, confira a URL de redirecionamento, as credenciais e as permissões. Uma autorização revogada exige reconectar.
- A importação ficou lenta ou parou
- Confira o andamento e os erros mostrados na tela. Cada consulta consome o limite da conta Olist; receber os primeiros itens não significa que o catálogo terminou. Evite iniciar várias importações ao mesmo tempo.
- O pedido não chegou
- Abra Pedidos sincronizados e leia o motivo. Um item sem variante identificada pode impedir o envio mesmo quando o catálogo foi importado corretamente. Informe ao suporte a loja, o número do pedido, a versão v2/v3 e o horário.
- Deu timeout ou o resultado ficou incerto
- Procure o pedido na Olist antes de reenviar. Ele pode ter sido criado sem a confirmação chegar à Yavendió. Se houver dúvida, peça a conferência ao suporte para evitar duplicação.
Nunca envie token, Client Secret ou dados pessoais completos em prints de suporte. Após uma correção, retome os itens indicados na tela quando essa opção estiver disponível; confirme o resultado antes de repetir todo o catálogo.
Perguntas frequentes
Qual a diferença entre Olist v2 e v3?
A v2 usa o token do app API do ERP e permite enviar produtos selecionados a partir da Olist. A v3 usa Client ID, Client Secret e autorização OAuth; a seleção e a busca do catálogo acontecem na Yavendió. Ambas usam a API para enviar pedidos.
O catálogo pode ter mais de 500 produtos?
Sim. O limite de 500 vale para uma seleção manual enviada pela Yavendió. Use Sincronizar todos para solicitar o catálogo completo ou envie grupos de até 500 itens. O envio de produtos pelo ERP na v2 é um fluxo diferente.
Preciso do webhook de pedidos para enviar uma venda?
O envio da venda usa a API com a conexão da sua conta. O webhook de situação serve para a Olist devolver atualizações dos pedidos e só deve ser configurado quando estiver disponível na Yavendió.
A conexão em uma conta gratuita ou de teste funciona?
Depende dos recursos de API e integração liberados pela Olist para essa conta. Confira o acesso no ERP. Uma importação parcial, sozinha, não comprova que o plano é a causa; verifique os erros e o limite de requisições.
A integração emite nota fiscal automaticamente?
Não por conectar a conta. Os dados preenchidos no pedido são enviados ao ERP; a emissão da nota e as configurações fiscais ficam na Olist.
Posso desconectar ou trocar a versão?
Você pode desconectar pelo gerenciamento da integração. Antes de reconectar em outra versão, revise os vínculos do catálogo e os pedidos pendentes com o suporte. Não há migração automática entre v2 e v3.
Documentação oficial da Olist: webhooks da v2 e API v3.
Configure e confira com um primeiro pedido.
Comece por alguns produtos. Compare uma variante, preço, estoque e a chegada do pedido ao ERP.
Abrir minhas integrações