# 7.2 Medidas dos produtos (metacampos)

> Como criar os metacampos de altura, largura e comprimento na Shopify, preencher as medidas e informar ao app quais metacampos ler.

Fonte: https://www.cotafrete.app/manual/produtos-e-caixas/medidas-metacampos/
Planos: Widget, Basic, Business
No app: Transportadoras → Caixas
Atualizado em 25/10/2026

---

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](https://www.cotafrete.app/manual/produtos-e-caixas/tela-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](https://www.cotafrete.app/manual/produtos-e-caixas/tela-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](https://www.cotafrete.app/manual/gateways-de-frete/frenet/) 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 **Transportadoras → Caixas**.
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](https://www.cotafrete.app/manual/images/manual/transportadoras-caixas.webp)

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](https://www.cotafrete.app/manual/produtos-e-caixas/tela-caixas/) 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](https://www.cotafrete.app/manual/produtos-e-caixas/tela-caixas/) em que a loja despacha. Sem pelo menos uma caixa ativa, as transportadoras continuam cotando com a caixa padrão.