Como configurar os serviços de frete (logísticas)
Atualizado em 22/10/2026
Configurar um frete na Braavo acontece em duas etapas: primeiro você guarda as credenciais da transportadora, depois cria o serviço que o cliente vê no checkout. As duas começam em Fretes > Serviços.
Etapa 1: as credenciais da transportadora
Antes de oferecer o frete de uma transportadora, é preciso conectar a loja a ela. Clique em Ajustes e, no grupo Transportadoras, clique em Configurar na linha da empresa desejada. O selo de cada linha mostra a situação da integração, como Não configurada, Desligada, Ativa em testes ou Ativa.
As telas das transportadoras seguem o mesmo desenho:
- O interruptor de uso — liga a transportadora na loja (na Mandaê, Usar a Mandaê na cotação do frete). Desligado, a loja deixa de cotar por ela e, nas empresas que postam e rastreiam, a postagem e o rastreio dos pedidos ficam indisponíveis.
- As credenciais — os dados que a transportadora fornece no painel dela, normalmente um token e um identificador de cliente. Por segurança, tokens, senhas e chaves nunca voltam para a tela: o campo aparece vazio, com a confirmação "Chave gravada". Deixar o campo em branco ao gravar mantém o valor atual.
- Os serviços ou modalidades — os níveis de serviço que a loja oferece, quando a empresa tem mais de um.
- A caixa de postagem — as dimensões da caixa padrão, nas empresas que precisam de medidas (a seção se chama Caixa padrão de postagem ou Embalagem de postagem, conforme a empresa).
Na Mandaê, por exemplo, você informa o Token e o Customer ID e marca os Serviços Rápido ou Econômico (sem nenhum marcado, a loja oferece os dois).
Atenção: a tela não liga a transportadora sem os dados obrigatórios, como o token. Ela aponta o campo que falta e não grava, para a loja nunca ficar com uma integração ligada que não consegue cotar.
Algumas transportadoras têm o interruptor Usar o ambiente de testes, que troca o endereço da API (e, em algumas, a credencial) pelo de testes da empresa. O ambiente de testes não gera envios reais, e a integração ligada nele aparece com o selo amarelo Ativa em testes, para você não esquecer de voltar para produção antes de vender.
Etapa 2: o serviço que aparece no checkout
Com as credenciais gravadas, você cria o serviço de frete em si. Em Fretes > Serviços, clique em Adicionar. O formulário tem quatro seções:
- Status e visibilidade — o Status do serviço e o interruptor Visível somente para administradores. Ligado, o checkout esconde o serviço dos clientes, e só quem entra na loja como administrador o vê. É o jeito de a equipe testar um frete novo antes de liberar.
- Serviço de frete — o campo Serviço lista só os serviços que a loja ainda não cadastrou. Depois de gravado, o serviço não muda: para trocar, cadastre outro.
- No checkout — o Nome no checkout e a Descrição no checkout, o que o cliente lê na hora de escolher a entrega. O nome pode ser algo como "Entrega Rápida" ou "Frete Econômico", e a descrição, uma linha curta como "Entrega em até 2 dias úteis". Algumas integrações completam o nome com a modalidade cotada, e outras mostram o nome que a transportadora devolve. Nas lojas com inglês ou espanhol ativos, a seção ganha o nome e a descrição nesses idiomas.
- Prazo de entrega — o Prazo adicional, em dias, somado ao prazo de cada cotação do serviço, para considerar o tempo de preparar o pedido antes do envio.
Feito isso, o cálculo passa a ser automático: durante o checkout, a Braavo consulta a transportadora para trazer preço e prazo, e o cliente escolhe a opção que preferir. A mesma lógica vale para qualquer transportadora integrada, e o Simular Frete confirma se a cotação está respondendo.
Bom saber: na listagem de Fretes > Serviços, o menu de ações que abre no nome de cada serviço leva aos Ajustes da transportadora e às Regras de cotação do serviço, que alteram o preço e o prazo que ela devolve.