Integração com Melhor Envio

Fluxo de funcionamento da integração:

1. A cotação do frete pela Melhor Envio é exibida no carrinho.
2. A loja confirma o pedido no E-commerce.
3. As informações de entrega são enviadas para a Melhor Envio.
4. A loja emite a etiqueta na Melhor Envio.
5. A loja despacha o pacote.
6. O código de rastreio é gerado pela transportadora.
7. A Melhor Envio envia o código de rastreio para o E-commerce.
8. O código é vinculado ao pedido.
9. O e-mail de pedido enviado é disparado para o cliente automaticamente.

Funcionalidades incluídas:

• Nossa integração com a Melhor Envio conta com as seguintes funcionalidades:
• Cotação de frete no carrinho.
• Geração automática da etiqueta de postagem.
• Vínculo do código de rastreamento ao pedido.
• Notificação de postagem e entrega do pedido ao cliente por e-mail.

O processo de credenciamento com a Melhor Envio é realizado através do site. Basta clicar no link Cadastre-se na Melhor Envio e realizar seu cadastro.

Antes de iniciar a integração no painel, você precisa configurar os dados de envio diretamente no seu painel administrativo.

Para isso, acesse Configurações > Entrega > Configurações Gerais no Admin Ecommerce Olist e preencha as seguintes informações:

• CEP de origem: CEP do local de onde os produtos serão enviados.
• Dias da semana: Dias em que a sua loja realiza a postagem dos pedidos.
• Horários de corte: Definição do horário limite para postagem (pedidos realizados após esse horário contam como feitos no dia seguinte).

Após concluir o credenciamento e cadastrar esses dados no seu admin, você estará pronto para habilitar a integração seguindo o passo a passo abaixo.

No painel da Melhor Envio:

1. Acesse o menu Integrações e selecione a opção Área Dev.

2. Clique no botão Cadastrar aplicativo.
3. Preencha os campos da seguinte forma:

• Nome do aplicativo: Integração Vnda - Nome da loja
• Site da plataforma: URL da loja contendo https:// e / no final (exemplo: https://www.sualoja.com.br/)
• Email de contato: ajuda.ecommerce@olist.com
• Email de suporte: ajuda.ecommerce@olist.com
• URL de seu ambiente de testes: URL de staging da loja contendo https:// e / no final (exemplo: https://sualoja.vnda.dev/)
• URL onde vamos direcionar o cliente após instalação (callback): Inserir URL da loja + /api/v2/melhor_envio (exemplo: https://www.sualoja.com.br/api/v2/melhor_envio)
• Descrição: Integração Vnda

4. Clique em CADASTRAR.
5. Copie o Client ID e o Secret e salve-os em um local seguro, como um bloco de notas.

No admin Ecommerce Olist:

1. Acesse as Configurações da loja (ícone de engrenagem no canto inferior esquerdo) > Entrega > Integrações.
2. Clique no ícone de lápis ao lado de Melhor Envio.
3. Insira o Client ID e o Secret obtidos na etapa anterior nos respectivos campos.
4. Marque a opção Encaminhar consulta ao Melhor Envio e mude o ambiente para Produção.
5. Clique em Salvar.

6. Após salvar, clique em Autenticar.
7. Você será encaminhado para uma tela da Melhor Envio. Certifique-se de estar logado na conta correta.
8. Informe sua agência no respectivo campo da seção Agência de postagem e clique em Autorizar. Se tudo estiver correto, a página ficará em branco.
9. Cadastre os grupos de entrega acessando Configurações > Entrega > Grupos de Entrega. Crie um grupo de entrega para cada modalidade da Melhor Envio. Lembre-se de que o nome deve ser idêntico para o grupo e para a forma de entrega.

10. Clique no ícone "+" no canto superior direito e preencha com o nome do grupo de entrega. Após isso, habilite o grupo e clique em Salvar.
11. Adicione as formas de entrega acessando Configurações > Entrega > Formas de entrega.

12. Clique no ícone "+" no canto superior direito e preencha os seguintes campos:

• Nome: Nome da forma de entrega, exatamente conforme o grupo.
• Descrição: Nome da forma de entrega, exatamente conforme o grupo.
• Origem: Melhor Envio.
• Tipo de Entrega: Selecione o grupo de entrega criado.
• Código de serviço: Preencha de acordo com a modalidade. Ao posicionar o mouse sobre o ícone "?", as opções serão listadas.

Caso o código de serviço desejado não esteja na listagem, ele pode ser obtido simulando fretes no painel da Melhor Envio. O campo modalidade corresponde ao campo Código de serviço no e-commerce. 

As demais informações são individuais de cada operação.

Para as integrações de pré-postagem e rastreio pela Melhor Envio, solicite mais informações para a equipe Ecommerce Olist pelo e-mail ajuda.ecommerce@olist.com.

Assim que um pedido for feito com uma dessas formas de entrega, um novo carrinho é gerado na Melhor Envio. Esse carrinho deve ser "comprado" para a conclusão da entrega.

Quando houver novos pedidos, eles ficarão disponíveis como uma notificação no carrinho, localizado no canto superior direito da tela.

Realize a autenticação normalmente com uma das agências utilizadas. Após essa etapa, acesse o painel da Melhor Envio e siga as instruções:

1. No menu lateral esquerdo, selecione Integrações e clique em Catálogo.

2. No Painel de integrações, busque pela integração com a Olist E-commerce (autenticada anteriormente) e clique no ícone de engrenagem.

3. Acesse a opção Transportadoras e serviços.

4. Role a tela para baixo para visualizar todas as transportadoras ativas na sua integração. Para incluir novas opções, clique em Adicionar transportadoras e finalize as configurações conforme as orientações da Melhor Envio.