Loja Virtual: frete — por que não aparece, por que vem diferente e o que o sistema faz com peso e medidas

Esta fonte é sobre a CONTA do frete na loja virtual: o que o sistema manda para os Correios, por que o valor sai diferente do que você esperava e por que uma opção de frete some do checkout. O cadastro em si das formas de envio — as formas que já vêm prontas, os campos Nome, Valor mínimo e Ativo, CEP de origem, prazo e frete adicional, limite de peso e regiões — está na fonte de meios de envio da Loja Virtual e não se repete aqui.

NOS CORREIOS SÃO DOIS SERVIÇOS, E SÓ ESSES DOIS
A lista é fechada: SEDEX e PAC. O sistema tem um código de serviço para cada um e não cota nenhum outro. SEDEX 10, SEDEX Hoje, Mini Envios, Carta registrada e afins não existem na loja virtual. Não adianta renomear a forma de envio para "SEDEX 10": o serviço cotado vem do tipo da forma, não do nome; o nome muda na tela e a cotação continua a mesma. A conexão com os Correios é feita pelo próprio sistema — você não cadastra contrato, cartão de postagem nem senha dos Correios na loja, e por isso também não dá para usar o desconto de um contrato seu.

O QUE O SISTEMA FAZ COM AS MEDIDAS ANTES DE COTAR
A loja manda altura, largura, comprimento e peso do pacote, em metros e quilos. Antes de perguntar o preço aos Correios, o sistema arruma esses números, porque os Correios só aceitam centímetros inteiros dentro de uma faixa. Ele faz, nesta ordem: converte as medidas de metros para centímetros e arredonda cada uma PARA CIMA até o centímetro inteiro (20,8 vira 21); aplica os mínimos — largura nunca abaixo de 10 e comprimento nunca abaixo de 15; aplica o teto — nenhuma das três passa de 100; soma as três e, se a soma passar de 200, reduz as três proporcionalmente até caber. O peso é convertido para gramas, em número inteiro.
É essa normalização que explica as duas reclamações clássicas. A primeira: "o frete do site não bate com o site dos Correios". No simulador dos Correios você digita a medida real; na loja a medida vai arredondada e espremida dentro dos limites, então o preço muda. A segunda: "produto pequeno cotando como caixa grande". Um item com 3 cm de largura é cotado com 10, e com 5 cm de comprimento é cotado com 15 — o sistema não está errando, está mandando o mínimo que os Correios aceitam.
Uma medida ZERADA é a exceção: o sistema não aplica mínimo nenhum sobre ela, então ela continua zero e o pacote sai zerado para os Correios. Peso, altura, largura e comprimento são cadastro do produto no ERP, e se resolvem pelas fontes de produtos.

VALOR MÍNIMO: A FORMA SOME DO CHECKOUT SEM MENSAGEM
Na cotação dos Correios, antes de perguntar o preço, o sistema compara o Valor mínimo da forma de envio com o valor do pedido. Se o valor mínimo for MAIOR que o pedido, a cotação volta vazia. E vazia não é erro: a opção simplesmente não aparece para o cliente, sem nenhuma mensagem explicando o motivo. Essa é a causa campeã de "sumiu uma opção de frete" e de "só some para alguns clientes" — some para quem tem carrinho pequeno. Se você não quer mínimo nenhum, deixe o campo zerado.

MELHOR ENVIO: A COTAÇÃO SÓ ENTRA SE O SERVIÇO BATER
Nas formas SEDEX e PAC, o sistema tenta primeiro uma cotação pelo Melhor Envio. Ela só é aproveitada se o parceiro devolver um serviço cujo nome seja igual ao tipo da forma — SEDEX com SEDEX, PAC com PAC; maiúsculas e minúsculas não importam, nome diferente não vale. Não batendo nenhum, o sistema segue com a cotação dos Correios e é esse valor que aparece, sem nenhum aviso de que o Melhor Envio ficou de fora. Por isso um "valor estranho com Melhor Envio ativo" costuma ser, na verdade, um valor dos Correios. Como o Melhor Envio é contratado e ligado à loja, e a cotação, etiqueta e rastreio dele, têm fonte própria — esta aqui só trata do encaixe com a forma de envio.

AO SALVAR UM MEIO DE ENVIO, O SISTEMA PODE CRIAR UMA TRANSPORTADORA
Ao salvar um meio de envio, o sistema procura no ERP uma transportadora com exatamente o mesmo nome da forma. Se não existir, ele cria uma, como pessoa jurídica, com código próprio, e amarra à forma de envio. É a resposta de "apareceu uma transportadora que eu não cadastrei": ela nasceu do meio de envio da loja virtual. Duas exceções: o meio Melhor Envio não gera transportadora, e Retirada na loja também não gera ao ser editada. Antes de excluir achando que é duplicidade, veja se aquela transportadora é a do meio de envio. O cadastro de transportadoras em si — dados, endereço, uso em pedidos e notas — é do ERP e se responde pelas fontes dele.

SALVAR A FORMA APAGA AS REGIÕES E REGRAVA
Nas formas por região, cada faixa guarda CEP inicial, CEP final, peso inicial, peso final, valor e prazo de entrega. Ao editar e salvar a forma, o sistema APAGA todas as regiões dela e grava de novo as que vieram na tela. A consequência é direta: salvar com a lista de regiões vazia perde as faixas, e elas não voltam sozinhas. Pior, o apagamento acontece ANTES da gravação — se o salvamento falhar depois, as regiões já se foram. Se você abriu a forma só para trocar o nome ou ativar, confira se as regiões continuam na tela antes de salvar.
Outro detalhe da tela de edição: uma forma inativa que nunca foi editada abre com Ativo já marcado. Marcado na tela não é ativo na loja — só passa a valer depois que você salvar.

AS LISTAS SÃO FECHADAS
O sistema tem duas listas de prazo, e as duas têm exatamente o mesmo conjunto de números: mesmo dia, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45 e 60. Uma aparece como "N dias úteis" (prazo de entrega) e a outra como "mais N dias" (prazo adicional). Não existe outro valor; não dá para digitar 12.
Limite de peso, lista completa: até 1 kg, até 5 kg, até 10 kg, até 20 kg, até 30 kg e até 40 kg. São seis opções e nada além delas — não existe "até 15 kg" nem limite livre.

O QUE COSTUMA DAR ERRADO
O frete não aparece no checkout. Confira nesta ordem: Valor mínimo da forma acima do valor do pedido (a cotação volta vazia e a opção some calada); forma desativada; nas formas por região, nenhuma faixa cobrindo o CEP do cliente ou o peso do carrinho; produto sem peso e sem medidas.
O frete veio diferente do esperado. Nos Correios, quase sempre é a normalização das medidas: arredondamento para cima, mínimos de largura e comprimento, teto de 100 e a redução proporcional quando a soma passa de 200. Compare a medida cadastrada no produto com a medida que você digitou no simulador dos Correios.
O Melhor Envio não traz cotação nenhuma. O serviço devolvido pelo parceiro não bateu com o tipo da forma de envio; o pedido acaba cotado pelos Correios, sem aviso. Se o Melhor Envio nem chega a ser consultado, é assunto da fonte do Melhor Envio.
Apareceu uma transportadora que ninguém cadastrou. Foi o meio de envio que a criou, com o mesmo nome.
As faixas de região sumiram. A forma foi salva com a lista de regiões vazia.

ONDE NÃO FICA
Peso, dimensões e CEP: cadastro de produtos e de loja no ERP. Contratação, cotação, etiqueta e rastreio do Melhor Envio: fonte do Melhor Envio. Formas prontas, campos da forma e a regra de que sem meio de envio ativo o cliente não fecha o pedido: fonte de meios de envio da Loja Virtual.