# 17.4 Atributos gravados no pedido

> Os seis atributos que o Cota Frete grava em cada pedido da Shopify, o que cada um contém, quando cada um aparece e onde ler: admin, ERP, API, webhooks e Liquid.

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

---

Quando o cliente escolhe no checkout um frete cotado pelo Cota Frete, o app grava no pedido a transportadora, o gateway, o serviço, o código do serviço, a previsão de entrega e a campanha de desconto, como **atributos do pedido**. Não há tela nem configuração: acontece sozinho.

Os atributos dependem da cotação no checkout. O app guarda as opções que devolveu para a Shopify e, quando o pedido é criado, procura nelas o frete escolhido pelo código e pelo preço. Por isso, uma loja que só tem o widget na página do produto e no carrinho, sem cotação no checkout, não recebe esses atributos.

Eles existem porque o nome do frete não carrega tudo isso. O nome do serviço fica fixo, para não criar um método de envio novo no ERP a cada data ou campanha, e o que varia vai para os atributos.

## Os seis atributos

| Atributo | O que contém | Exemplo |
|---|---|---|
| `cotafrete_transportadora` | A transportadora por trás do serviço escolhido, mesmo quando uma regra de renomear ou agrupar trocou o nome que o cliente viu | `Correios` |
| `cotafrete_gateway` | O gateway de frete que cotou o serviço, pelo nome dele no Cota Frete. Só aparece quando o frete veio de um gateway | `Frenet` |
| `cotafrete_servico` | O nome do serviço como a transportadora ou o gateway entrega, nunca o nome de uma regra | `SEDEX` |
| `cotafrete_codigo_servico` | O código interno do serviço, que nunca muda | `correios_03220` |
| `cotafrete_previsao_entrega` | A data prevista de entrega calculada na cotação, em dias úteis | `27/08/2026` |
| `cotafrete_desconto` | O título da campanha de desconto que ganhou a cotação, de qualquer percentual | `Frete Grátis Inverno` |

## Quem recebe o quê

Campos sem valor não são gravados. Na prática:

| Origem do frete escolhido | Atributos gravados | O que fica de fora |
|---|---|---|
| Transportadora integrada (Correios, Jadlog...) | Transportadora, serviço, código e previsão | Gateway, porque não há gateway; desconto, quando nenhuma campanha ganhou |
| Gateway de frete (Melhor Envio, Frenet...) | Os seis | Desconto, quando nenhuma campanha ganhou |
| Serviço sem prazo informado | Os demais | Previsão de entrega |
| Entrega local, em Fretes Próprios | Serviço e código | Transportadora, gateway e previsão |
| Tabela de frete própria | Transportadora, serviço, código e previsão (os dois primeiros com o nome da tabela) | Gateway |

Mais três comportamentos que valem saber:

- **Com uma regra de agrupar ou renomear**, o nome do frete no pedido é o nome da regra ("Econômico"), mas `cotafrete_transportadora` e `cotafrete_servico` continuam dizendo o serviço real.
- **Os atributos chegam alguns segundos depois** de o pedido ser criado. Uma integração que lê o pedido no mesmo instante pode pegá-lo sem eles.
- **Na dúvida, o app não grava.** Se não encontra a cotação exata (mesmo código e mesmo preço), o pedido fica sem os atributos, em vez de receber os de outra compra.

Para mapear no ERP, use `cotafrete_codigo_servico`. Os campos de nome são textos visíveis e podem mudar; o código não.

## Onde ler

| Onde | Como os atributos aparecem |
|---|---|
| Admin da Shopify | Bloco de informações adicionais do pedido |
| API Admin GraphQL | Campo `customAttributes` do `Order` (`key` e `value`) |
| API REST | Array `note_attributes` do pedido |
| Webhooks de pedido (`orders/create`, `orders/paid` e os demais) | `note_attributes` no payload |
| Liquid no tema e nas páginas de pedido | `order.attributes.cotafrete_transportadora` |
| Liquid nos templates de notificação | `attributes.cotafrete_transportadora` (sem o `order.`) |

O app só troca as próprias chaves (`cotafrete_*`) e preserva os atributos que o tema ou outros apps gravaram no pedido.

## Para saber mais

- [Transportadora e serviço no pedido](https://www.cotafrete.app/manual/pedidos/transportadora-no-pedido/)
- [Usar os atributos no ERP](https://www.cotafrete.app/manual/pedidos/atributos-no-erp/)
- [Mostrar a transportadora ao cliente](https://www.cotafrete.app/manual/pedidos/transportadora-para-o-cliente/), com exemplo de Liquid
- [Renomear](https://www.cotafrete.app/manual/regras-de-frete/renomear/): como mostrar no nome do frete qual gateway cotou