Transportadora e serviço no pedido
Quando um pedido entra na Shopify, o frete chega como uma linha com nome e valor: “Jadlog Package, R$ 24,90”. Para quem embala o pacote, isso basta. Para o ERP, para a API e para o cliente, falta informação. Qual transportadora está por trás de um frete chamado “Econômico”? Por qual gateway a etiqueta precisa ser comprada? Qual a data prevista? Que campanha deu frete grátis?
O Cota Frete responde gravando esses dados no próprio pedido, como atributos do pedido. Não há tela nem configuração: acontece sozinho, segundos depois de o pedido ser criado.
O que é um atributo do pedido#
A Shopify permite guardar no pedido pares de nome e valor, além dos campos padrão. São os atributos do pedido (em inglês, note attributes ou custom attributes). Eles aparecem no admin, vão junto com o pedido na API e nos webhooks e podem ser lidos pelo Liquid do tema e dos e-mails.
É o lugar certo para dado que varia de pedido para pedido, porque não mexe no nome do frete. A página Usar os atributos no ERP explica por que isso importa.
Os seis atributos#
| Atributo | O que guarda | Exemplo |
|---|---|---|
cotafrete_transportadora | A transportadora por trás do serviço escolhido | Correios |
cotafrete_gateway | O gateway de frete que cotou o serviço, quando foi um gateway | Frenet |
cotafrete_servico | O nome do serviço como a transportadora entrega | SEDEX |
cotafrete_codigo_servico | Código interno do serviço, que nunca muda | correios_03220 |
cotafrete_previsao_entrega | Data prevista de entrega calculada na cotação, em dias úteis | 27/08/2026 |
cotafrete_desconto | Título da campanha de desconto que venceu a cotação, se houve | Frete Grátis Inverno |
Quatro detalhes ajudam a ler os valores:
- A transportadora é sempre a real. Com uma regra de agrupar, o cliente escolhe “Econômico”, mas
cotafrete_transportadoradiz qual transportadora ganhou aquela cotação. O mesmo vale para uma regra de renomear:cotafrete_servicoguarda o nome original do serviço, não o nome que você deu a ele. - O gateway separa contas. Um gateway revende outras transportadoras, então dois gateways podem cotar “Correios” no mesmo pedido.
cotafrete_gatewaydiz por qual conta comprar a etiqueta. Ele não aparece quando o frete veio de uma transportadora conectada direto. - O desconto vale para qualquer campanha. Um desconto de 30% grava o título do mesmo jeito que um frete grátis. Veja Criar um desconto.
- Campo vazio não é gravado. Cada atributo é preenchido de forma independente, e o que não existe para aquele frete simplesmente não aparece.
O que cada tipo de frete recebe#
| Frete escolhido pelo cliente | Atributos gravados |
|---|---|
| Transportadora conectada direto (Correios, Jadlog, J&T Express…) | Todos, menos cotafrete_gateway. cotafrete_desconto só quando uma campanha venceu |
| Serviço de um gateway (Melhor Envio, Frenet, Intelipost, SmartEnvios, SuperFrete) | Todos os seis. cotafrete_desconto só quando uma campanha venceu |
| Tabela de frete própria | Transportadora e serviço (os dois com o nome da tabela), código e previsão |
| Entrega local dos Fretes Próprios | Só serviço e código: não há transportadora nem prazo de transportadora por trás |
| Serviço sem prazo informado pela transportadora | O resto, sem cotafrete_previsao_entrega |
Quando os atributos são gravados#
Os atributos saem da cotação que o Cota Frete devolveu no checkout. Quando o pedido é criado, o app procura essa cotação e só grava os atributos se encontrar uma que bata exatamente com o pedido:
- os mesmos produtos e quantidades;
- o mesmo CEP de destino;
- o mesmo serviço escolhido;
- o mesmo valor de frete, centavo por centavo;
- cotada nos últimos 7 dias.
Se algo não bate, o pedido fica sem atributos. O app prefere não gravar nada a gravar o dado de outra cotação.
Na prática, isso tem duas consequências:
- Só pedidos com frete cotado no checkout recebem atributos. A cotação no checkout depende do Carrier Calculated Shipping (CCS, “cotação calculada pela transportadora”) da Shopify e faz parte dos planos Basic e Business. Uma loja no plano Widget, que cota só na página do produto e no carrinho, não recebe atributos. Veja Carrier Calculated Shipping (CCS).
- Frete alterado à mão não recebe atributos. Um pedido criado como rascunho, com o frete editado no admin, não corresponde a nenhuma cotação do checkout.
Onde ver na Shopify#
- No admin da Shopify, abra o pedido.
- Procure o bloco Informações adicionais, na lateral do pedido.
- Os atributos
cotafrete_*aparecem ali, cada um com o seu valor.
Os atributos entram alguns segundos depois de o pedido ser criado. Uma integração que puxa o pedido no mesmo instante pode pegá-lo ainda sem eles. A maioria dos ERPs sincroniza em intervalos e não sente essa diferença.
Se o pedido for criado de novo pela Shopify (por exemplo, numa reentrega do webhook), o app confere os atributos e não repete a gravação quando nada mudou. Atributos gravados por outro app ou pelo tema são mantidos: o Cota Frete só substitui as chaves cotafrete_*.
Para onde ir agora#
- Usar os atributos no ERP: mapear pelo código do serviço e ler pela API.
- Mostrar a transportadora ao cliente: Liquid na página do pedido e nos e-mails.
- Atributos gravados no pedido: a tabela de consulta.