Referência de variáveis de notificação

As notificações da loja são processadas com o Liquid, a linguagem de programação simples e fácil de usar da Shopify. É a mesma usada no desenvolvimento de temas disponíveis na Loja de temas.

Para editar as notificações enviadas da sua loja, você pode fazer personalizações básicas nos seus modelos de notificação.

Para receber ajuda relacionada a modificações mais avançadas ou realizar alterações nos modelos de notificação personalizados, entre em contato com a Comunidade nos fóruns ou contrate um Especialista da Shopify para fazer as personalizações.

A seguir, apresentamos uma lista de modelos de notificação do Liquid que podem ser personalizados no admin da Shopify:

  • Carrinho abandonado
  • Fale com o cliente
  • Convite de conta de cliente
  • Boas-vindas da conta de cliente
  • Redefinição de senha da conta de cliente
  • Criar fatura do pedido
  • Solicitação de processamento
  • Cartão-presente criado
  • Novo pedido
  • Novo pedido (móvel)
  • Pedido cancelado
  • Confirmação de pedido
  • PDV e comprovante móvel
  • Reembolso do pedido
  • Confirmação de envio
  • Atualização de envio

Todos eles têm acesso às propriedades do pedido correspondente.

Propriedades do pedido

Muitas propriedades de um pedido estão disponíveis diretamente usando o Liquid, em modelos e em scripts adicionais.

As propriedades de um pedido estão disponíveis nos seguintes modelos:

  • Confirmação de pedido
  • Novo pedido
  • Novo pedido (móvel)
  • Confirmação de envio
  • Atualização de envio
  • Scripts adicionais
  • Solicitação de processamento
Descrição das propriedades do pedido
Propriedade Descrição
id

Um ID exclusivo do pedido para uso interno em todo o sistema. Utilize o exemplo a seguir e gere um link para o pedido na seção admin da loja. Por exemplo, no modelo Novo pedido, adicione o seguinte código:

<a href="{{ shop.url }}/admin/orders/{{ id }}">Ver pedido</a>
email
O e-mail associado ao pedido.
name

Normalmente, trata-se de um antífen (#, que equivale a "nº") seguido por order_number.

Exemplo: #1004

order_name
O mesmo que o nome.
order_number

Número exclusivo do pedido na loja, sem o # ou outro prefixo ou sufixo adicionado ao ID de pedido pelo titular nas preferências.

Exemplo: 1004

created_at

Data e hora em que o cliente fez o pedido. É possível formatar usando o filtro de data.

Exemplo: 2009-05-30T17:43:51+02:00

tags Retorna uma matriz de todas as tags do pedido em ordem alfabética. Veja mais informações na documentação de referência do Liquid.
transactions Retorna uma matriz de transações do pedido.
tax_price
Os tributos combinados de todos os itens no pedido.
tax_lines

Tributos discriminados por tipo:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title

Nome do tributo.

Exemplos: QST ou IVA

tax_line.price
Quantidade.
tax_line.rate
A taxa. Retornará 0,175 se for 17,5%.
tax_line.rate_percentage
A taxa de tributo em forma legível para humanos. Ele retornará 17,5 se a taxa for 0,175.
customer
Objeto de cliente que contém os atributos da saída do cliente.
billing_address
O endereço de faturamento.
billing_address.first_name
Primeiro nome do cliente.
billing_address.last_name
Sobrenome do cliente.
billing_address.company
Nome da empresa para faturamento.
billing_address.phone
Número de telefone do endereço de faturamento.
shop.name
Nome da sua loja.
shop.phone
Número de telefone da sua loja.
subtotal_price
Soma dos preços de item de linha do pedido após a dedução de desconto no produto ou no carrinho. O subtotal não inclui tributos (a menos que incluídos nos preços), custos de frete ou gorjetas.
discounts
Uma lista de descontos.
discounts_amount

Valor total aplicado por todos os descontos.

Exemplo: +US$ 5,00

discounts_savings

Valor economizado devido aos descontos.

Exemplo: -US$ 5,00

total_price

Total da encomenda (subtotal + custo de frete - desconto de frete + tributo).

financial_status
O status atual do pagamento. Pode ser: nulo, pendente, autorizado, pago, anulado, reembolsado.
requires_shipping
(boolean) Retorna "true" se houver pelo menos um item no pedido que requer frete.
shipping_method.title

Nome da taxa de frete.

Exemplo: padrão

shipping_method.price

O preço do frete, incluindo qualquer desconto de frete existente.

Exemplo: {{ shipping_method.price | money }}

shipping_price

O preço de frete.

Exemplo: {{ shipping_price | money }}

shipping_address
O endereço de entrega.
shipping_address.first_name
O primeiro nome do endereço de entrega.
shipping_address.company
Nome da empresa do endereço de entrega.
shipping_address.phone
Número de telefone do endereço de entrega.
line_items
Lista de todos os itens de linha no pedido.
item_count
Uma soma de todas as quantidades dos itens.
fulfillment_status
O status de processamento do pedido atual. Pode ser: não processado, parcial, processado.
note
A observação anexada ao pedido. A observação pode ser obtida do cliente e/ou editada na tela de detalhes do pedido em sua interface administrativa.
attributes

Os atributos anexados ao pedido.

Exemplo: {{ attributes.gift-note }}

referring_site

Contém o URL do referenciador que levou o cliente à sua loja.

Exemplo: https://www.google.com/?s=great+products

landing_site

Contém o caminho do site que o cliente usou. Esta é a primeira página que o cliente viu quando chegou à loja.

Exemplo: /products/great-product?ref=my-tracking-token

landing_site_ref

Olha para o local de pouso e extrai um parâmetro de referência dele. Os parâmetros de referência podem ser: ref, source, r.

Caso landing_site seja /products/great-product?ref=my-tracking-token, então landing_site_ref será my-tracking-token. É possível realizar uma determinada ação caso 'ref' seja igual a um certo valor:

{% if landing_site_ref == 'my-tracking-token' %} Minha ação... {% endif %}
cancelled
(boolean) Retorna "true" se o pedido foi cancelado.
cancelled_at
A hora em que o pedido foi cancelado.
cancel_reason
Motivo selecionado para o cancelamento do pedido. Pode ser: estoque, cliente, recusado, fraude ou outro.
has_high_risks?

Retorna "true" se o pedido tiver alto risco

translate="no"
unique_gateways

Retorna uma lista de provedores de pagamento exclusivos em um pedido. Por exemplo, se alguém pagou com um Visa, um Mastercard e dinheiro, a lista retornada seria shopify_payments, cash.

location (POS only)

Exibe o local físico do pedido. Há várias propriedades disponíveis e listadas aqui. É possível configurar na área Locais do admin.

order_status_url

Retorna o link para a página de status do pedido em questão.

fulfilled_line_items
(obsoleta)
Lista de itens de linha que foram atendidos.
unfulfilled_line_items
(obsoleta)
Lista de itens de linha que não foram totalmente processados.

Propriedades do rascunho de pedido

As propriedades do rascunho de pedido estão disponíveis no modelo de e-mail Fatura de rascunho de pedido, que notifica seus clientes sobre faturas pendentes.

Descrição das propriedades de rascunho de pedido
Propriedade Descrição
id
Um ID exclusivo do rascunho de pedido para uso interno.
invoice_url
Um link que o cliente pode seguir para pagar a fatura usando o checkout seguro da Shopify.
reserve_inventory_until

A data e a hora até as quais os itens de linha no rascunho são reservados, por exemplo, 2015-05-30T17:43:51+02:00.

Use o filtro de datas do Liquid para formatar as datas.

user
O último membro da equipe que alterou o rascunho de pedido.
user.name
O nome do último membro da equipe que alterou o rascunho de pedido.
user.email
O e-mail do último membro da equipe que alterou o rascunho de pedido.
email
O e-mail associado ao rascunho de pedido.
name
O número (number) exclusivo do rascunho de pedido, prefixado por um sinal # (que equivale a "nº").
number
O número exclusivo do rascunho de pedido sem o prefixo ou sufixo do pedido.
created_at

A data e hora em que o cliente criou o rascunho de pedido, por exemplo, 2009-05-30T17:43:51+02:00.

Use o filtro de datas do Liquid para formatar as datas.

tags Retorna uma matriz de todas as tags do pedido em ordem alfabética. Veja mais informações na documentação de referência do Liquid.
tax_price
Os tributos combinados de todos os itens no rascunho de pedido.
tax_lines

Tributos discriminados por tipo:

{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title

Nome do tributo.

Exemplos: QST ou IVA

tax_line.price
O valor do imposto.
tax_line.rate
A taxa de tributo na forma decimal. Por exemplo, uma taxa de tributo de 17,5% retornará 0,175.
tax_line.rate_percentage
A taxa de imposto na forma de porcentagem. Por exemplo, uma taxa de 0,175 retornará 17,5.
customer
Objeto de cliente que contém os atributos da saída do cliente.
billing_address
O endereço de faturamento do rascunho de pedido.
billing_address.first_name
O primeiro nome do cliente.
billing_address.last_name
O sobrenome do cliente.
billing_address.company
O nome da empresa no endereço de faturamento.
billing_address.phone
O número de telefone no endereço de faturamento.
shop.name
O nome da sua loja.
shop.phone
Número de telefone da sua loja.
subtotal_price
Soma dos preços de item de linha do pedido após qualquer desconto de item de linha ou desconto de carrinho ter sido deduzido. O subtotal não inclui impostos (a menos que impostos sejam incluídos nos preços) ou custos de frete.
discounts
Uma lista de descontos.
discounts_amount

Valor total aplicado por todos os descontos.

Exemplo: +US$ 5,00

discounts_savings

Valor economizado devido aos descontos.

Exemplo: -US$ 5,00

total_price
O preço total da encomenda (subtotal + custo de frete - desconto de frete + tributo).
requires_shipping
Retorna true se pelo menos um item no rascunho de pedido exigir frete. Retorna false se nenhum item no rascunho de pedido exigir frete.
shipping_method.title

Nome da taxa de frete.

Exemplo: padrão

shipping_method.price
O preço da forma de frete. Retorna as mesmas informações em shipping_price.
shipping_price

O preço de frete.

Use os filtros de dinheiro do Liquid para formatar esse valor.

shipping_address

O endereço de entrega.

Observação: Ao contrário de pedidos regulares, o endereço de entrega de um rascunho de pedido pode estar incompleto.

shipping_address.first_name
O primeiro nome do endereço de entrega.
shipping_address.company
O nome da empresa no endereço de entrega.
shipping_address.phone
O número de telefone no endereço de entrega.
line_items
Uma lista de todos os itens de linha no rascunho de pedido.
item_count
Uma soma de todas as quantidades do item no rascunho de pedido.
note
A observação anexada ao rascunho de pedido. A observação pode ser obtida do cliente e também editada na tela de detalhes do rascunho de pedido no seu admin da Shopify.
location

O local físico do pedido. Existem várias propriedades de local disponíveis.

Você pode configurar locais na página Locais de seu admin da Shopify.

propriedades do item

Cada line na lista de line_items ou subtotal_line_items tem as seguintes propriedades.

Descrição das propriedades do item de linha
Propriedade Descrição
line.applied_discounts
(apenas PDV e rascunhos de pedido)
Lista de descontos aplicados a este item (cada desconto tem as propriedades título, código, quantidade, economia e tipo).
line.custom
(apenas rascunhos de pedido)
(boolean) Retorna true se o item for um item de linha personalizado para um rascunho de pedido.
line.grams
Peso de um único item.
line.image
Retorna o URL da imagem associada ao item de linha. Também é possível usar o filtro img_url para obter tamanhos de imagem específicos, como {{ line.image | img_url: 'small' }}
line.line_price
O preço multiplicado pela quantidade desse item.
line.original_line_price
O preço combinado da quantidade de itens incluídos na linha, antes da aplicação de descontos.
line.final_line_price
O preço combinado de todos os produtos no item de linha, incluindo todos os valores de desconto.
line.price
O preço de um único item.
line.product.metafields

Os metacampos no nível do produto. Use a sintaxe a seguir:

line.product.metafields.NAMESPACE.KEY

line.product.title
O nome do produto.
line.product.vendor
Fabricante do item.
line.properties
Retorna uma matriz das informações personalizadas de um item. O cliente especifica as propriedades do item de linha na página do produto antes da inclusão no carrinho.
line.quantity
Quantidade para esse item.
line.requires_shipping
(booleano) Retorna "true" se a variante do item tiver a caixa de seleção Este produto é físico marcada na página do produto.
line.selling_plan_allocation
Retorna um objeto selling_plan_allocation, que descreve o impacto de um plano de venda, como assinatura, no item de linha.
line.taxable
(booleano) Retorna verdadeiro se a variante do item tiver marcado a caixa de seleção "Cobrar tributos sobre este produto" na página do produto.
line.title
O nome do produto seguido por um traço e o nome da variante. O nome da variante não é incluído quando é "Título padrão".
line.url
O URL relativo da variante do item de linha. Ela não inclui o URL de raiz da loja (mystore.myshopify.com).
line.line_item.variant.barcode
O código de barras associado à variante do produto.
line.variant.compare_at_price
Comparação de preços relacionada à variante do produto.
line.variant.image
A imagem da variante do produto. Só retorna uma imagem se houver uma imagem específica atribuída à variante no item de linha.
line.variant.metafields

Os metacampos no nível da variante. Use a seguinte sintaxe:

line.variant.metafields.NAMESPACE.KEY

line.variant.sku
SKU associada à variante de produto.
line.variant.title

Os valores da opção da variante, unidos por /.

Exemplo: pequeno/vermelho

Propriedades de reembolsos

Essas propriedades adicionais estão disponíveis no modelo de e-mail Reembolsos. Esse modelo de e-mail é usado para notificar seus clientes de que um reembolso (completo ou parcial) foi aplicado aos pedidos deles. Utilize qualquer variável disponível para o modelo de notificação de e-mail de pedido, além das seguintes variáveis:

Descrição das propriedades de reembolsos
Propriedade Descrição
amount
A quantia de dinheiro reembolsada.
refund_line_items
Uma lista de itens de linha de reembolso a serem ressarcidos.

Refund_line_item properties

Cada refund_line na lista de refund_line_items tem as seguintes propriedades:

Descrição das propriedades do item de linha de reembolso
Propriedade Descrição
refund_line.line_item
O line_item que está sendo reembolsado. Tem acesso a todas as propriedades do line_item.
refund_line.quantity
A quantidade do item de linha a ser reembolsado.

Propriedades de processamento

Essas propriedades adicionais estão disponíveis nos modelos de e-mail de Confirmação de envio, Atualização de envio e solicitação de processamento.

A Confirmação de envio e a Atualização de envio são usadas para notificar seus clientes de que alguns ou todos os itens em seu pedido foram processados ou atualizados com novas informações de envio.

O modelo de e-mail de Solicitação de processamento de pedidos é usado para serviços personalizados do tipo definidos no admin da loja. Para adicionar um deles, acesse Configurações > Frete e role a tela para baixo até Processamento de pedidos/dropshipping.

Descrição das propriedades de processamento
Propriedade Descrição
service_name
O nome do serviço personalizado, conforme definido na página Configurações > Frete. . (Apenas solicitações de processamento de pedidos)
fulfillment.estimated_delivery_at
Uma data prevista de entrega com base no número de rastreamento (se disponível) fornecido por uma das seguintes transportadoras: USPS, FedEx, UPS, Canada Post (somente Canadá). Esta propriedade só está disponível quando as taxas calculadas pela transportadora estão em uso.
fulfillment.fulfillment_line_items
Uma lista de itens de linha de processamento de pedidos a serem executados.
fulfillment.item_count
Uma soma de todas as quantidades dos itens. O número total de itens sendo atendidos.
fulfillment.requires_shipping
(boolean) Retorna true se essa solicitação de preenchimento exigir frete.
fulfillment.tracking_company
A empresa que faz o rastreamento.
fulfillment.tracking_numbers
Uma lista de números de rastreamento.
fulfillment.tracking_urls
Uma lista de URLs de rastreamento.
items_to_fulfill
(obsoleta)
Lista de itens de linha que precisam passar pelo serviço de processamento de pedidos personalizado específico. (Apenas solicitações de processamento de pedidos)
items_to_fulfill_count
(obsoleta)
O número total de itens a serem atendidos por essa solicitação. (Apenas solicitações de processamento)

Propriedades de Fulfillment_line_item

Cada fulfillment_line na lista de fulfillment_line_items tem as seguintes propriedades.

Descrição das propriedades do item de linha de processamento
Propriedade Descrição
fulfillment_line.line_item
O line_item sendo processado. Tem acesso a todas as propriedades do line_item.
fulfillment_line.quantity
A quantidade do item de linha que está sendo processada.

Propriedades de entrega

Descrição das propriedades de entrega
Propriedade Descrição
delivery_instructions
Informações de entrega local a serem compartilhadas com o cliente. Os dados são controlados pelo campo Informações de entrega nas configurações de entrega local.

Propriedades de desconto

Existem dois tipos de propriedades de desconto.

discount_applicationsdescreve por que e como um item foi descontado.

discount_allocations descreve o impacto de um desconto específico em um item de linha e a redução no preço. Use essa propriedade no item de linha.

É possível combinar as propriedades para exibir informações de desconto em um item de linha ou no pedido.

Exemplo

Verifica se um desconto foi aplicado ao item de linha. Caso não tenha sido utilizado no nível do pedido (all), o nome e o valor dele serão exibidos.

{% if line.discount_allocations %}
    {% for discount_allocation in line.discount_allocations %}
        {% if discount_allocation.discount_application.target_selection != 'all' %}
            {{ discount_allocation.discount_application.title | upcase }}
            (-{{ discount_allocation.amount | money }})
        {% endif %}
    {% endfor %}
{% endif %}

O resultado pode ser assim:

SPRING5 (-$5.00)

Propriedades discount_allocation

Cada discount_allocation na lista de discount_allocations tem as seguintes propriedades.

Descrição das propriedades discount_allocation
Propriedade Descrição
discount_allocation.amount
O valor economizado pelo cliente em um item de linha. É necessário que seja inserido em uma repetição caso queira permitir vários códigos de desconto.
discount_allocation.discount_application
A aplicação de desconto que aloca o valor no item de linha.

Propriedades discount_application

Cada discount_application na lista de discount_applications tem as seguintes propriedades.

Descrição das propriedades discount_application
Propriedade Descrição
discount_application.target_selection

Descreve como os itens de linha são selecionados no carrinho para a aplicação de desconto. Pode ser:

  • all: o desconto é aplicado a todos os itens de linha.
  • entitled: o desconto é aplicado a um subconjunto específico de itens de linha, geralmente, definidos por um estado.
  • explicit: o desconto é aplicado a um item de linha ou frete especificamente selecionados.
discount_application.target_type
Tipo de item ao qual um desconto é aplicado (line_item ou shipping_line).
discount_application.title

Nome do desconto exibido ao cliente.

Exemplos: Boas-vindas10 ou CBBWQQAKYBYY

discount_application.total_allocated_amount
Valor total do desconto aplicado ao preço do pedido.
discount_application.type
Tipo de desconto. Pode ser: automático, discount_code, manual ou script.
discount_application.value
Valor do desconto.
discount_application.value_type
Tipo de valor do desconto. Pode ser: fixed_amount ou percentual.

Propriedades de notificação por e-mail

Descrição das propriedades de notificação por e-mail
Propriedade Descrição
shop.email_logo_url
A URL do logo especificado na seção Personalizar modelos de e-mail do admin.
shop.email_logo_width
A largura do logo (pixels) especificada na seção Personalizar modelos de e-mail do admin.
shop.email_accent_color
O código hexadecimal para a cor de destaque especificada na seção Personalizar modelos de e-mail do admin.

Tudo pronto para começar a vender com a Shopify?

Experimente de graça