Medidas dos produtos (metacampos)
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.
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#
- No admin da Shopify, abra Configurações e clique em Metacampos e metaobjetos.
- Em Metacampos, clique em Variantes.
- Clique em Adicionar definição.
- Em Nome, escreva
Altura. A Shopify mostra embaixo o identificador do campo, o namespace.chave, algo comocustom.altura. Anote: é ele que vai no app. - Em Selecionar tipo, escolha Dimensão e deixe marcado Valor único.
- Escolha a unidade em que você mede os produtos. Centímetros é o mais comum.
- Clique em Salvar.
- Repita os passos 3 a 7 para
LarguraeComprimento.
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#
- Em Produtos, abra um produto.
- Na seção Variantes, clique na variante.
- Role até Metacampos e preencha Altura, Largura e Comprimento com as medidas do produto embalado.
- Clique em Salvar.
- 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#
- No Cota Frete, abra TransportadorasCaixas.
- 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.larguraecustom.comprimento, que já vêm preenchidos. - Confira a caixa padrão nos campos Fallback de altura, Fallback de largura e Fallback de comprimento, em centímetros.
- 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.

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ção | O que o app faz |
|---|---|
| Variante com as três medidas maiores que zero | Usa as medidas da variante |
| Variante incompleta, produto com as três | Usa as medidas do produto |
| Item sem as três medidas em lugar nenhum | Nas 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 jarda | Converte para centímetros e arredonda para cima |
| Número sem unidade | Lê como centímetros |
| A Shopify não responde a tempo | Cota 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.