Como integrar Envios da Olist à Bagy 3.0
Com a integração entre Envios da Olist e Bagy, você oferece as nossas opções de frete diretamente no seu site. Siga o passo a passo abaixo para configurar e disponibilizar as cotações nos seus produtos.
Atenção: a integração funciona apenas para clientes Bagy que já migraram para a Bagy 3.0. Se não souber se a migração foi realizada, verifique a página de login da Bagy: https://bagy.com.br/login.
Bagy + ERP Olist
Importante: se você utiliza a Bagy de forma avulsa (sem integração de sistema de gestão Olist), consulte a seção Bagy + Envios Olist.
Passo a Passo
- Na plataforma Bagy, vá em Configurações > Frete e envio > Geral.

- Clique em "Integrações Externas" para configurar a integração com o Envios da Olist.

- Na primeira etapa da configuração, insira um nome para a integração, como "Envios da Olist", e clique em Continuar. Esse campo é obrigatório para avançar e habilitar a próxima etapa.

- Na segunda etapa, insira a URL do Webservice do Envios da Olist e o seu Token e clique em "Salvar". A nossa URL e o seu Token estão ao lado direito na página de integração Bagy para você copiar.

- Volte na primeira etapa clicando na aba "Principal", marque "Sim" para habilitar a integração e deixá-la ativa e clique em "Continuar".

Pronto! Sua integração está configurada, e as opções de frete do Envios da Olist já estão disponíveis no seu site.
Importante: retornamos apenas duas opções de frete: a mais barata e a mais rápida. Isso evita oferecer inúmeras opções e melhora a experiência no seu site. Se a opção mais barata também for a mais rápida, apenas ela será exibida.
Como Mapear Transportadoras do Olist Envios
Para que os pedidos do seu site selecionem automaticamente a transportadora no ERP da Olist, é necessário mapear as transportadoras do Envios da Olist na integração com sua plataforma, utilizando os códigos necessários para realizar a configuração.
Códigos para mapeamento:
- Olist Envios J&T Express
- Olist Envios Correios SEDEX
- Olist Envios Loggi
- Olist Envios Jadlog
- Olist Envios Patrus
- Olist Envios Correios PAC
- Olist Envios LigCargas
- Olist Envios Total Express
- Olist Envios Rede Sul
- Olist Envios GFL
- Olist Envios Pax
Bagy + Envios Olist
Como Integrar
- Na plataforma Bagy, vá em Aplicativos > Instalar novos aplicativos.

- Busque por "Envios da Olist" e clique em Instalar aplicativo.

- Você será redirecionado para uma página para autorizar a integração. Clique em Autorizar.

- Retorne à plataforma de Envios em Integrações > Bagy.
- Insira a URL do seu site no campo à direita, clique em Autorizar integração e, em seguida, em Acessar site.

Pronto! Sua integração está configurada e as opções de frete de Envios da Olist já estão disponíveis no seu site
Como funciona a contratação de etiquetas
Sempre que um pedido na Bagy for realizado com frete de Envios da Olist, após a aprovação do pagamento e emissão da nota fiscal, importaremos o pedido para a plataforma de Envios para contratar a etiqueta.
Você poderá verificar as etiquetas contratadas na plataforma de Envios da Olist, imprimir os documentos para preparar o pacote e enviar com a nossa coleta.

Como identificar erros na contratação de etiquetas
Sempre que um pedido (dentro dos critérios de frete da Envios da Olist, pagamento aprovado e nota fiscal emitida) não tiver a etiqueta contratada, ele aparecerá na área de Pendências com o motivo do erro:
- Erro de falta de créditos: adicione os créditos necessários e clique em Tentar novamente.
- Outros erros: acione o suporte de Envios da Olist para que o time responsável atue na resolução.

Sincronização de status com a Bagy
Para que o Envios da Olist atualize seus pedidos automaticamente na Bagy, não exclua ou altere estes três status:
- Aguardando envio: identifica pedidos prontos para processar.
- Enviado: confirma que o pacote está em rota.
- Finalizado: indica a conclusão da entrega.

Manter esses nomes evita falhas de comunicação entre as plataformas e garante que sua operação siga sem intervenções manuais.
Dica: para rastreamento detalhado você e seu cliente podem conferir o trajeto completo (coleta, trânsito e ocorrências) pelo Rastreamento da Olist: envios.olist.com/rastreios/.