Atributos gravados no pedido
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_transportadoraecotafrete_servicocontinuam 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
- Usar os atributos no ERP
- Mostrar a transportadora ao cliente, com exemplo de Liquid
- Renomear: como mostrar no nome do frete qual gateway cotou