Como integrar com o Melhor Envio?
Configure transportadoras por meio do hub Melhor Envio na sua loja virtual.
Pré-requisito
Antes de iniciar, confirme que você possui cadastro ativo no Melhor Envio.
Para mais informações, consulte o conteúdo criado pela Melhor Envio.
Criando o tipo de frete
Para iniciar a configuração:
- Acesse Configuração > Tipos de frete.
- Clique em Criar tipo de frete.
- Selecione a opção Melhor Envio.
Entendendo as abas de configuração
A configuração está dividida nas seguintes abas:
- Geral
- Canais
- Configurações do frete
- Expedição
- Regras de exibição
- Performance
Preenchendo a aba Geral
Na aba Geral, informe:
- Nome interno: usado apenas para identificação interna
- Nome: exibido ao cliente
- Ativado: define se o frete ficará disponível
- Descrição: campo interno para observações
Preenchendo a aba Canais
Na aba Canais, selecione os canais que utilizarão esse tipo de frete.
Preenchendo a aba Configurações do frete
Na aba Configurações do frete, configure a autenticação, os parâmetros de envio e os dados necessários para remessa.
Dados de autenticação
No campo Autenticar, a plataforma redireciona você para o Melhor Envio para concluir a autenticação.
Enviar para entrega ao fechar remessa
Esse campo define o comportamento da remessa no Melhor Envio:
- Não: a remessa será adicionada ao carrinho no Melhor Envio
- Sim: a remessa será adicionada ao carrinho e finalizada automaticamente
ao ativar essa opção, o valor da etiqueta será descontado do saldo do Melhor Envio no momento do fechamento da remessa.
Embalagem
Preencha:
- Largura
- Altura
- Comprimento
Se você não tiver uma embalagem padrão, utilize os valores sugeridos pela plataforma.
No campo Peso adicional, recomendamos informar 100 g como margem de segurança.
Prazo
No campo Adicional de prazo, informe uma margem de segurança.
Exemplo: se a transportadora calcular 3 dias e você adicionar 3 dias, o cliente verá o prazo total de 6 dias.
Valor
Você pode configurar margens de segurança no valor do frete.
Adicional fixo de preço
Use esse campo para somar um valor fixo ao frete calculado.
Exemplo: R$ 10,00 + R$ 5,00 = R$ 15,00.
Adicional percentual de preço
Use esse campo para aplicar um percentual sobre o valor do frete.
Exemplo: R$ 10,00 + 20% = R$ 12,00.
Frete grátis a partir de
Se desejar, informe um valor mínimo de carrinho para oferecer frete grátis.
Entender a soma de adicional fixo e percentual
Se você preencher os campos de adicional fixo e adicional percentual, o percentual será aplicado sobre a soma do valor base com o adicional fixo.
Exemplo:
- valor retornado pela transportadora: R$ 10,00
- adicional fixo: R$ 10,00
- subtotal: R$ 20,00
- adicional percentual de 20%: R$ 4,00
- valor final: R$ 24,00
Informações de envio
Preencha todos os campos com os dados da sua operação.
Apenas o campo Complemento é opcional.
Se os dados não forem preenchidos corretamente, não será possível fechar a remessa.
Preenchendo a aba expedição
Na aba Expedição, você encontra três campos.
Habilitar envio automático de pedidos
Ao ativar essa opção, a plataforma envia o pedido automaticamente para a transportadora assim que uma nota fiscal for vinculada ao pedido.
O comportamento varia conforme o tipo de integração:
- em transportadoras com integração direta, como Correios e J&T, o envio ocorre via API
- em transportadoras sem integração direta, a plataforma envia automaticamente um e-mail com o XML da NF-e
Nesse momento, a plataforma também pode gerar o link ou o código de rastreamento, quando a transportadora oferece esse recurso.
Contato para notificação
Esse campo é opcional.
Use essa opção para selecionar um contato já cadastrado que receberá, por e-mail, os XMLs das notas fiscais dos pedidos.
Esse recurso deve ser usado apenas quando a transportadora não possui integração logística via API. Quando a integração existe, a plataforma faz o envio automaticamente, sem necessidade de notificação manual.
Criar remessa automaticamente
Ao ativar essa opção, a plataforma adiciona automaticamente os pedidos a uma remessa de postagem da transportadora, desde que eles atendam aos critérios abaixo:
- pagamento confirmado
- sem nota fiscal vinculada
- criado há no máximo 7 dias
Depois de ativar esse campo, a plataforma exibe configurações adicionais da remessa, como nome da remessa, dias de criação e horário limite.
Preenchendo a aba Regras de exibição
Configure quando o frete ficará disponível.
- Região: selecione onde o frete será exibido
- Grupos de clientes: selecione grupos específicos ou deixe em branco para todos
- Ocultar quando não conseguir calcular o frete: defina o comportamento em caso de erro
- Categoria de frete: restrinja o frete a categorias específicas, se necessário
- Regra da categoria: configure apenas se uma categoria for selecionada
- Visibilidade: limite por preço, peso ou volume
Preenchendo a aba Performance
Na aba Performance, configure regras para contingência em caso de falha ou lentidão.
Tempo máximo de resposta
Informe o tempo limite, em segundos, para retorno do cálculo.
Exemplo: 30 segundos.
Tipo de frete de contingência
Selecione um frete alternativo para ser exibido caso a transportadora não responda dentro do tempo definido.
Finalizando a configuração
Depois de preencher todos os campos, clique em Criar.
Validando a integração
Após a configuração, faça um pedido de teste para verificar se o frete está calculando corretamente.
