Pular para o conteúdo
Cota Frete Manual
7.2

Medidas dos produtos (metacampos)

Planos:WidgetBasicBusinessNo app:TransportadorasCaixas

A Shopify tem campo de peso, mas não tem campo de altura, largura e comprimento. Essas medidas ficam em metacampos: campos extras que você cria uma vez na Shopify e preenche em cada produto. Depois, na aba Caixas da tela Transportadoras, você diz ao app o nome desses campos.

Por que cadastrar as medidas#

A transportadora vende espaço no caminhão, não só quilos. Uma caixa de travesseiros ocupa o mesmo lugar que uma caixa de livros e pesa dez vezes menos. Por isso ela calcula o peso cubado, a partir do volume do pacote, e cobra pelo maior entre o peso real e o cubado.

Um exemplo: um edredom de 2,5 kg vai numa caixa de 60 × 40 × 30 cm. O volume é 0,072 m³. Com fator de cubagem 300, comum no rodoviário, o peso cubado é 21,6 kg. Se a loja cotou só com os 2,5 kg, o cliente pagou o frete de 2,5 kg e a fatura veio de 21,6 kg. A diferença sai da margem.

Sem medidas, o app cota todo pedido com uma caixa só: a caixa padrão, que fica na aba Caixas. Um item pequeno e cinco itens grandes saem com as mesmas medidas.

As medidas de cada produto entram na cotação de dois jeitos:

  • Nas transportadoras, depois que você cadastra pelo menos uma caixa ativa: o app escolhe a menor caixa em que o pedido cabe e, se nenhuma serve, usa as medidas dos próprios produtos. Veja A aba Caixas.
  • Nos gateways de frete (Melhor Envio, Frenet, Intelipost, SmartEnvios), assim que as variantes têm as três medidas: o app manda cada item com as suas medidas, e o próprio gateway escolhe a embalagem.

Antes de começar#

  • São três metacampos, um para cada medida: altura, largura e comprimento.
  • Crie os três do tipo Dimensão. É o tipo que a tela lista como sugestão e que guarda a unidade junto com o número.
  • As medidas são do produto já embalado, como ele sai para a transportadora.
  • Os mesmos três metacampos valem para todas as transportadoras e gateways.
Usa o app da Frenet na Shopify?

Se a loja usa o app da Frenet, as medidas já podem estar preenchidas nos metacampos dele: frenet.altura, frenet.largura e frenet.comprimento. Nesse caso, pule os passos 1 e 2 e informe esses três nomes no passo 3. Conectar a Frenet como gateway de frete dentro do Cota Frete não cria esses campos: quem cria é o app da Frenet.

1. Crie os três metacampos na Shopify#

  1. No admin da Shopify, abra Configurações e clique em Metacampos e metaobjetos.
  2. Em Metacampos, clique em Variantes.
  3. Clique em Adicionar definição.
  4. Em Nome, escreva Altura. A Shopify mostra embaixo o identificador do campo, o namespace.chave, algo como custom.altura. Anote: é ele que vai no app.
  5. Em Selecionar tipo, escolha Dimensão e deixe marcado Valor único.
  6. Escolha a unidade em que você mede os produtos. Centímetros é o mais comum.
  7. Clique em Salvar.
  8. Repita os passos 3 a 7 para Largura e Comprimento.

Os metacampos ficam na variante porque cada tamanho ou cor pode ter uma embalagem diferente. O app também lê metacampos do produto quando a variante não tem as três medidas, mas nunca mistura os dois: ou valem as três medidas da variante, ou as três do produto.

2. Preencha as medidas em cada produto#

  1. Em Produtos, abra um produto.
  2. Na seção Variantes, clique na variante.
  3. Role até Metacampos e preencha Altura, Largura e Comprimento com as medidas do produto embalado.
  4. Clique em Salvar.
  5. Repita para as outras variantes e os outros produtos.

Produto sem variante também tem uma variante, a padrão. O caminho é o mesmo.

Você não precisa corrigir o catálogo inteiro de uma vez. Comece pelos produtos que mais vendem: eles respondem pela maior parte do frete. Mas saiba que um único item sem medida faz o pedido inteiro ser cotado com a caixa padrão nas transportadoras (veja as regras abaixo).

3. Informe os metacampos no app#

  1. No Cota Frete, abra TransportadorasCaixas.
  2. Na seção Medidas dos produtos, preencha Metafield de altura, Metafield de largura e Metafield de comprimento com o namespace.chave de cada metacampo. Se você criou os campos com os nomes sugeridos, eles são custom.altura, custom.largura e custom.comprimento, que já vêm preenchidos.
  3. Confira a caixa padrão nos campos Fallback de altura, Fallback de largura e Fallback de comprimento, em centímetros.
  4. Clique em Salvar, no fim da seção.

Embaixo dos campos, a tela lista os metacampos do tipo Dimensão encontrados na loja (“Metacampos de medida encontrados na loja: …”), para você copiar o nome certo. O app não aceita o mesmo metacampo em duas medidas.

Aba Caixas com a seção Medidas dos produtos: os três metafields e os valores de fallback

Não há interruptor para ligar. As medidas passam a valer nas transportadoras quando a loja tem os três metafields informados e pelo menos uma caixa ativa. Nos gateways, valem assim que as variantes têm as três medidas.

Regras que valem a pena conhecer#

SituaçãoO que o app faz
Variante com as três medidas maiores que zeroUsa as medidas da variante
Variante incompleta, produto com as trêsUsa as medidas do produto
Item sem as três medidas em lugar nenhumNas transportadoras, o pedido inteiro é cotado com a caixa padrão. Nos gateways, o pedido vai como um volume só, com a caixa padrão
Unidade em mm, m, polegada, pé ou jardaConverte para centímetros e arredonda para cima
Número sem unidadeLê como centímetros
A Shopify não responde a tempoCota com a caixa padrão

A regra do item sem medida é a que mais pega. Vale conferir se a caixa padrão representa bem o seu pedido mais comum.

Quanto tempo leva para valer#

Trocar o nome dos metafields no app vale já na próxima cotação. Já as medidas de cada produto ficam guardadas pelo app por até 14 dias depois de lidas:

  • Um produto que ganha as três medidas aparece na próxima cotação.
  • Um produto que já tinha medidas e teve uma delas corrigida na Shopify pode levar até 14 dias para a correção chegar à cotação.

Por isso, vale cadastrar as medidas com cuidado na primeira vez.

Se a tela diz “Nenhum metacampo de medida encontrado”#

A loja ainda não tem metacampo do tipo Dimensão nas variantes ou nos produtos. Crie os três seguindo o passo 1 e recarregue a tela. Se você criou os campos como número, o app consegue lê-los se você informar o nome no passo 3 (número sem unidade vale como centímetros), mas eles não aparecem na lista de sugestões. Para a lista e para não errar a unidade, prefira o tipo Dimensão.

Próximo passo#

Com as medidas no lugar, cadastre as caixas em que a loja despacha. Sem pelo menos uma caixa ativa, as transportadoras continuam cotando com a caixa padrão.

Atualizado em 25/10/2026 Algo desatualizado nesta página? Avise a equipe