Integração com Melhor Envio

Ana N.
2025-12-17T13:55:36Z

A Melhor Envio é um hub logístico que conecta você a diferentes transportadoras. Ou seja, você pode utilizar os serviços dessas transportadoras contratando apenas a Melhor Envio.

A plataforma é intuitiva e leva apenas alguns segundos para fazer várias cotações ao mesmo tempo. Para saber mais, clique aqui.

Como funciona a integração com a Melhor Envio?

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.

Credenciamento

O processo de credenciamento com a Melhor Envio é realizado através do site. Basta clicar no botão abaixo e realizar seu cadastro:

Cadastre-se na Melhor Envio

Como ativar?

⚠️ Para realizar as configurações de entrega a seguir, é necessário que cadastrem as seguintes informações previamente no admin:

CEP de origem: CEP de onde estão os produtos;

Dias da semana em que os pedidos serão postados;

Horários de corte (pedidos realizados após esse horário contam como feitos no dia seguinte).

Esses ajustes devem ser feitos seguindo esse caminho no Admin Ecommerce Olist:

⚙️ Configurações → Entrega → Configurações Gerais.

Após a contratação e o envio dos documentos para a Melhor Envio, siga o passo a passo abaixo para habilitar a integração.

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 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

Clique em CADASTRAR;

Copie o Client ID e o Secret e salve-os em algum lugar, como um bloco de notas, por exemplo.

No admin Ecommerce Olist:

4. Cadastre a integração no admin da loja, conforme abaixo:

5. Acesse as Configurações da loja (engrenagem no canto inferior esquerdo) → Entrega → Integrações;

Clique no lápis ao lado de Melhor Envio;

Insira o Client ID e o Secret obtidos na etapa 3 nos respectivos campos;

Marque a opção Encaminhar consulta ao Melhor Envio, e mude o ambiente para Produção;

Clique em Salvar.

🚩 Atenção: As etapas abaixo devem ser feitas com a loja no ar. Se a sua loja estiver em Onboard, aguardar até homologação.

6. Após salvar, clique em Autenticar;

⚠️ Importante: você será encaminhado para uma tela da Melhor Envio. Certifique-se de que você está logado na conta correta.

7.Informe sua agência no respectivo campo da seção Agência de postagem e clique em Autorizar.

Se tudo estiver certo, a página ficará em branco. 😉

8. Cadastre os grupos de entrega, indo em Configurações → Entrega → Grupos de Entrega;

Para cada modalidade da Melhor Envio, crie um grupo de entrega. Lembre-se que o nome deve ser idêntico para o grupo e a forma de entrega;

9. Clique no ícone "+" no canto superior direito, e preencha com o nome do grupo de entrega. Após isso, habilite o grupo e salve;

10. Adicione as formas de entrega indo em Configurações → Entrega → Formas de entrega;

11. Clique no ícone "+" no canto superior direito, e preencha:

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: Preencher de acordo com a modalidade. Ao levar o mouse até o ícone "?" são listadas as opções;

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

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

Postagem e Código de Rastreio

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

💡 Fique ligado!

Nessa integração, o link de rastreio só passa a funcionar depois que o pacote do cliente é enviado. Assim, indicamos que o carrinho seja comprado na Melhor Envio, próximo da data de postagem do pedido.

Como posso emitir as etiquetas da Melhor Envio?

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

Ou seja, quando houver novos pedidos, eles ficarão em forma de notificação no carrinho no canto superior direito da tela, conforme mostramos abaixo:

O carrinho fica disponível para compra durante o período de 7 dias. Após esse prazo, não é possível realizar a confirmação e será necessário emitir a etiqueta manualmente.

Faço as postagens em mais de uma agência, como configurar?

Realize a autenticação normalmente, com uma das agências utilizadas.

Após isso, acesse o painel da Melhor Envio e siga as etapas abaixo:

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

Você irá acessar o Painel de integrações. Busque pela integração com a Olist E-commerce (que foi autenticada anteriormente), e clique no ícone de engrenagem;

Acesse Transportadoras e serviços;

Role a tela para baixo, você verá todas as transportadoras que estão habilitadas atualmente em sua integração. Para adicionar novas, clique em Adicionar transportadoras e finalize as configurações conforme orientações da Melhor Envio.

Ficou com alguma dúvida? A gente te ajuda! É só entrar em contato pelos nossos canais de atendimento.