Cadastrando via Frete Barato
Configure transportadoras por meio do hub Frete Barato na sua loja virtual.
Pré-requisito
Antes de iniciar, confirme que você possui contrato ativo com a Frete Barato.
Para mais informações, acesse o site da Frete barato.
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 Frete Barato.

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
- Rastreamento
- 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 integração e os parâmetros de envio.

Configuração de integração
No campo Apikey, informe a chave fornecida pela Frete Barato.
Se você não tiver essa informação, solicite a chave diretamente à Frete Barato.
Embalagem
Preencha:
- Largura
- Altura
- Comprimento
- Peso adicional
Se você não tiver uma embalagem padrão, use 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 para o prazo de entrega.
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.
Entendendo 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
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 a região em que o frete será exibido.
Você pode usar regiões padrão ou criar regiões personalizadas.
Grupos de clientes
Selecione grupos específicos ou deixe o campo em branco para disponibilizar o frete a todos os clientes.
Ocultar quando não conseguir calcular o frete
Defina se o frete será exibido ou ocultado quando ocorrer erro no cálculo.
Categoria de frete
Use esse campo para restringir o frete a categorias específicas, se necessário.
Regra da categoria
Configure esse campo apenas se uma categoria de frete estiver selecionada.
Visibilidade
Limite a exibição do frete por:
- preço
- peso
- volume
Preenchendo a aba Rastreamento
Na aba Rastreamento, informe o link de rastreio disponibilizado pela Frete Barato.
No campo Entregue se existirem as palavras, você pode informar palavras que indiquem entrega concluída. Separe os termos com ponto e vírgula.

Preenchendo a aba Performance
Na aba Performance, configure regras para contingência em caso de falha ou lentidão da transportadora.
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.




