# 13.1 Transportadora e serviço no pedido

> Os seis atributos que o Cota Frete grava no pedido (transportadora, gateway, serviço, código, previsão e campanha), quando eles são gravados e onde ver no admin da Shopify.

Fonte: https://www.cotafrete.app/manual/pedidos/transportadora-no-pedido/
Planos: Basic, Business · no checkout, requer o Carrier Calculated Shipping (CCS) da Shopify
Atualizado em 25/10/2026

---

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](https://www.cotafrete.app/manual/pedidos/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](https://www.cotafrete.app/manual/regras-de-frete/agrupar/), o cliente escolhe "Econômico", mas `cotafrete_transportadora` diz qual transportadora ganhou aquela cotação. O mesmo vale para uma regra de [renomear](https://www.cotafrete.app/manual/regras-de-frete/renomear/): `cotafrete_servico` guarda 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_gateway` diz 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](https://www.cotafrete.app/manual/descontos/criar-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](https://www.cotafrete.app/manual/fretes-proprios/quando-usar-tabela/) | Transportadora e serviço (os dois com o nome da tabela), código e previsão |
| [Entrega local](https://www.cotafrete.app/manual/fretes-proprios/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)](https://www.cotafrete.app/manual/como-funciona/carrier-calculated-shipping/).
- **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

1. No admin da Shopify, abra o pedido.
2. Procure o bloco **Informações adicionais**, na lateral do pedido.
3. Os atributos `cotafrete_*` aparecem ali, cada um com o seu valor.


![Bloco de detalhes adicionais de um pedido no admin da Shopify com os atributos cotafrete_transportadora, cotafrete_gateway, cotafrete_servico, cotafrete_codigo_servico e cotafrete_previsao_entrega (admin em inglês)](https://www.cotafrete.app/manual/images/manual/shopify-pedido-atributos.webp)

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](https://www.cotafrete.app/manual/pedidos/atributos-no-erp/): mapear pelo código do serviço e ler pela API.
- [Mostrar a transportadora ao cliente](https://www.cotafrete.app/manual/pedidos/transportadora-para-o-cliente/): Liquid na página do pedido e nos e-mails.
- [Atributos gravados no pedido](https://www.cotafrete.app/manual/referencia/atributos-do-pedido/): a tabela de consulta.