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 dos temas disponíveis na Loja de temas.
Para editar as notificações enviadas da loja, é possível fazer personalizações básicas nos modelos de notificação.
Para receber ajuda com mudanças 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 customizações. Saiba mais sobre a contratação de Especialistas da Shopify.
A seguir, apresentamos uma lista de modelos de notificação do Liquid que podem ser personalizados no admin da Shopify:
- Checkout abandonado
- Fale com o cliente
- Convite de conta de cliente
- Boas-vindas da conta de cliente
- Redefinição de senha da conta de cliente
- Fatura para rascunho de pedido
- Solicitação de processamento
- Cartão-presente criado
- Novo pedido
- Novo pedido (móvel)
- Fatura do pedido
- Pedido cancelado
- Confirmação de pedido
- Reembolso do pedido
- Lembrete de pagamento
- PDV e comprovante móvel
- 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)
- Fatura do pedido
- Confirmação de envio
- Atualização de envio
- Scripts adicionais
- Solicitação de processamento
- Lembrete de pagamento
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> |
O e-mail associado ao pedido. | |
name |
Normalmente, trata-se de um antífen (#, que equivale a "nº") seguido por 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 |
payment_terms |
Os termos de pagamento especificam a data em que um pedido deve ser pago. Saiba como adicionar condições de pagamento às faturas de pedido. Para saber mais, consulte a referência do Liquid para payment_terms. |
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:
|
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_price |
O preço de frete. Exemplo: |
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: |
referring_site |
Contém o URL do referenciador que levou o cliente à sua loja. Exemplo: |
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: |
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: Caso {% 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?(deprecated) |
Retorna "true" se o pedido tiver alto risco |
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 |
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(deprecated) |
Lista de itens de linha que foram atendidos. |
unfulfilled_line_items(deprecated) |
Lista de itens de linha que não foram totalmente processados. |
b2b? |
Retorna "true" se o pedido for B2B. Use a propriedade com variáveis B2B para exibir informações relevantes, como nome, local e endereço da empresa nos e-mails. Por exemplo, é possível adicionar um cabeçalho a um modelo com estas informações:
|
company |
A empresa para quem a venda é feita em um pedido B2B. |
company.name |
Nome da empresa em um pedido B2B. |
company.id |
ID da empresa em um pedido B2B. |
company_location |
Local da empresa em um pedido B2B. A empresa que compra de você pode ter mais de um local. |
company_location.name |
Nome do local da empresa em um pedido B2B. |
company_location.id |
Número do ID para o local da empresa em um pedido B2B. |
company_location.shipping_address |
Endereço de entrega para o local da empresa em um pedido B2B. |
company_location.billing_address |
Endereço de faturamento para o local da empresa em um pedido B2B. |
customer_order_url |
A página de informações sobre um novo pedido para o qual o cliente solicitou uma devolução com uma nova conta. |
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.
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, 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. |
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, 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 celular 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 |
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 celular 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. |
b2b? |
Retorna "true" se o pedido for B2B. Use a propriedade com variáveis B2B para exibir informações relevantes, como nome, local e endereço da empresa nos e-mails. Por exemplo, é possível adicionar um cabeçalho a um modelo com estas informações:
|
company |
A empresa para quem a venda é feita em um pedido B2B. |
company.name |
Nome da empresa em um pedido B2B. |
company.id |
ID da empresa em um pedido B2B. |
company_location |
Local da empresa em um pedido B2B. A empresa que compra de você pode ter mais de um local. |
company_location.name |
Nome do local da empresa em um pedido B2B. |
company_location.id |
Número do ID para o local da empresa em um pedido B2B. |
company_location.shipping_address |
Endereço de entrega para o local da empresa em um pedido B2B. |
company_location.billing_address |
Endereço de faturamento para o local da empresa em um pedido B2B. |
Propriedades de cronograma de pagamento
As propriedades do cronograma de pagamento estão disponíveis no modelo de e-mail Lembrete de pagamento, que notifica o cliente sobre a data de vencimento.
Propriedade | Descrição |
---|---|
payment_schedule.amount_due |
O valor a ser pago em um cronograma de pagamento. Use o filtro de dinheiro do Liquid para formatar os valores do moedas. |
payment_schedule.due_at |
A data de vencimento do cronograma de pagamento. Use o filtro de datas do Liquid para formatar as datas. |
payment_schedule.due_in_days |
O número de dias até a data de vencimento, caso o cronograma de pagamento ainda não esteja vencido (não pago). |
payment_schedule.due_later? |
Retorna "true" se um cronograma de pagamento não tiver sido pago e a data de vencimento estiver no futuro. |
payment_schedule.number_of_days_overdue? |
O número de dias desde a data de vencimento de um cronograma de pagamento já vencido. |
payment_schedule.overdue? |
Retorna "true" se um cronograma de pagamento não tiver sido pago e a data de vencimento estiver no passado. |
propriedades do item
Cada line
na lista de line_items
ou subtotal_line_items
tem as seguintes propriedades.
Propriedade | Descrição |
---|---|
line.applied_discounts(POS and draft orders only) |
Lista de descontos aplicados a este item (cada desconto tem as propriedades título , código , quantidade , economia e tipo ). |
line.custom(Draft orders only) |
(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 seguinte sintaxe: 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.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 |
line.refunded.quantity(within refund notifications) |
A quantidade de um item a ser reembolsado. Utilize esta propriedade para adicionar um identificador aos itens reembolsados em um pedido. Por exemplo: |
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. Use qualquer variável disponível para o modelo de notificação de e-mail de pedido, além das seguintes variáveis:
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:
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.
Propriedade | Descrição |
---|---|
service_name |
Nome do serviço personalizado definido na página Configurações > Frete. Apenas em 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(deprecated) |
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(deprecated) |
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.
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
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. |
consolidated_estimated_delivery_time |
Informações sobre datas de entrega de pedidos para compartilhar com o cliente. Essas informações são controladas pela configuração do Tempo de processamento definido na página Frete e entrega. |
Propriedades de desconto
Existem dois tipos de propriedades de desconto.
discount_applications
descreve 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.
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.
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:
|
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
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. |