Referência de variáveis de notificações

As notificações enviadas pela loja são renderizadas com Liquid, a linguagem de programação simples e fácil de usar da Shopify. É a mesma linguagem usada na criação dos temas da Theme Store.

Para editar as notificações enviadas pela loja, você pode fazer personalizações básicas nos modelos de notificação. Para acessar a lista completa de notificações personalizáveis, acesse a página Notificações no admin da Shopify.

Para receber ajuda com alterações mais avançadas ou para fazer alterações em modelos de notificação personalizados, entre em contato com a comunidade em nossos fóruns ou contrate um parceiro da Shopify para fazer as personalizações. Saiba mais sobre como contratar um parceiro da Shopify.

Nesta página

Propriedades do pedido

Muitas propriedades de um pedido estão disponíveis diretamente com o Liquid e nos modelos.

Descrições das propriedades do Liquid que podem ser usadas com o objeto de pedido em modelos de notificação.
Propriedade	Descrição
`id`	Um ID exclusivo do pedido em todo o sistema para uso interno. Use o exemplo a seguir para gerar um link para o pedido na seção do admin da loja. Por exemplo, no modelo Novo pedido, adicione o seguinte código: `Ver pedido`
`email`	O e-mail associado ao pedido.
`name`	Normalmente, é um símbolo de cerquilha seguido pelo `order_number`. Exemplo: #1004
`order_name`	Igual a name.
`order_number`	Número exclusivo do pedido na loja, sem o prefixo de cerquilha (#) nem qualquer prefixo ou sufixo adicionado ao ID do pedido pelo lojista nas preferências da loja. Exemplo: 1004
`confirmation_number`	Um identificador alfanumérico do pedido, gerado aleatoriamente, que pode ser exibido ao cliente em vez do nome sequencial do pedido. Não há garantia de que esse valor seja exclusivo. Exemplo: XPAV284CT
`created_at`	A data e a hora em que o cliente criou o pedido. É possível formatar essas informações com o filtro de data. Exemplo: 2009-05-30T17:43:51+02:00
`payment_terms`	Os termos de pagamento especificam a data de vencimento do pagamento de um pedido. Saiba como adicionar termos de pagamento às faturas de pedidos. Para mais informações, consulte a referência do Liquid para payment_terms.
`destination`	O destino para onde os itens devem ser enviados.
`tags`	Retorna uma matriz com todas as tags do pedido. As tags são retornadas em ordem alfabética. As tags aplicadas dinamicamente por apps ou recursos da plataforma, como a tag do `Shopify Collective`, podem não estar disponíveis quando o e-mail de notificação é gerado. Para detectar itens de um recurso específico, verifique as tags no nível do produto em cada item de linha. Consulte a documentação de referência do Liquid para ver mais detalhes.
`transactions`	Retorna uma matriz de transações do pedido.
`tax_price`	O valor combinado dos tributos de todos os itens do pedido.
`tax_lines`	Tributos divididos por tipo de tributação: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	O nome do tributo. Por exemplo, QST ou IVA.
`tax_line.price`	O valor do tributo.
`tax_line.rate`	A alíquota em formato decimal. Retornará 0,175 se for 17,5%.
`tax_line.rate_percentage`	A alíquota em formato legível. Retornará 17,5 se a alíquota for 0,175.
`customer`	Objeto do cliente que contém as características 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 loja.
`shop.phone`	Número de telefone da loja.
`subtotal_price`	Soma dos preços dos itens de linha do pedido após a dedução de qualquer desconto de item de linha ou de carrinho. O subtotal não inclui tributos (a menos que os tributos estejam inclusos nos preços), custos de frete nem gorjetas.
`discounts`	Uma lista de descontos.
`discounts_amount`	O valor do desconto aplicado por todos os descontos. Exemplo: +$5,00
`discounts_savings`	O valor da economia gerada por todos os descontos. Exemplo: -$5,00
`total_price`	Total do pedido (subtotal + custo de frete - desconto de frete + tributo).
`financial_status`	O status do pagamento atual. Um dos seguintes: nil, `pending`, `authorized`, `paid`, `voided`, `refunded`.
`requires_shipping`	(booleano) Retornará verdadeiro se houver pelo menos um item no pedido que exija frete.
`shipping_method.title`	Nome da taxa de frete. Nas notificações para o cliente, o nome da taxa de frete é traduzido para o idioma que o cliente usou na finalização da compra quando esse idioma é diferente do idioma-padrão da loja. Exemplo: Frete padrão
`shipping_method.price`	O preço do frete, incluindo qualquer desconto de frete. Exemplo: `{{ shipping_method.price \| money }}`
`shipping_price`	Preço do 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 no 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.
`line_items_including_zero_quantity`	Lista de todos os itens de linha do pedido, incluindo os que têm quantidade zero. Os itens de linha têm quantidade zero quando são totalmente reembolsados.
`line_item_groups`(Orders and POS only)	Lista de todos os grupos de itens de linha que contêm componentes de itens de linha no pedido.
`item_count`	Soma das quantidades de todos os itens.
`fulfillment_status`	O status de processamento do pedido atual. Um dos seguintes: `unfulfilled`, `partial` ou `fulfilled`.
`note`	A observação anexada ao pedido. A observação pode ser obtida do cliente e/ou editada na tela de informações do pedido no painel do admin.
`attributes`	Quaisquer características que foram anexadas ao pedido. Exemplo: `{{ attributes.gift-note }}`
`metafields`	Quaisquer metacampos no pedido. Use a seguinte sintaxe: metafields.NAMESPACE.KEY
`referring_site`	Contém o URL do referenciador que levou o cliente para a loja. Exemplo: `https://www.google.com/?s=great+products`
`landing_site`	Contém o caminho do site de destino que o cliente usou. Essa é a primeira página que o cliente viu quando chegou à loja. Exemplo: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	Analisa o site de destino e extrai um parâmetro de referência dele. Os parâmetros de referência podem ser: `ref`, `source` ou `r`. Se o `landing_site` for `/products/great-product?ref=my-tracking-token`, então o valor `landing_site_ref` é `my-tracking-token`. É possível realizar uma determinada ação se a ref for igual a um determinado valor: `{% if landing_site_ref == 'my-tracking-token' %} Minha ação... {% endif %}`
`cancelled`	(booleano) Retornará verdadeiro se o pedido tiver sido cancelado.
`cancelled_at`	A hora em que o pedido foi cancelado.
`cancel_reason`	O motivo selecionado ao cancelar o pedido. Um dos seguintes: `inventory`, `customer`, `declined`, `fraud` ou `other`.
`has_high_risks?`(deprecated)	Retornará verdadeiro se o pedido tiver risco alto.
`unique_gateways`	Retorna uma lista de provedores de pagamento únicos em um pedido. Por exemplo, se alguém pagou com Visa, Mastercard e dinheiro, a lista retornada será `shopify_payments, cash`.
`location`(POS only)	Exibe o local físico do pedido. Há várias propriedades de local disponíveis, listadas aqui. É possível configurar locais na área de Locais do admin.
`order_status_url`	Retorna o link para a página de status do pedido.
`fulfilled_line_items`(deprecated)	Lista de itens de linha que foram processados.
`unfulfilled_line_items`(deprecated)	Lista de itens de linha que ainda 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 o nome da empresa, o local da empresa e o endereço nos e-mails. Por exemplo, em pedidos B2B, é possível adicionar um cabeçalho a um modelo com as seguintes informações: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	A empresa para a qual você vende em um pedido B2B.
`company.name`	O nome da empresa em um pedido B2B.
`company.id`	O ID da empresa em um pedido B2B.
`company_location`	O local da empresa em um pedido B2B. Uma empresa que compra de você pode ter mais de um local.
`company_location.name`	O nome do local da empresa em um pedido B2B.
`company_location.id`	O número de ID do local da empresa em um pedido B2B.
`company_location.shipping_address`	O endereço de entrega do local da empresa em um pedido B2B.
`company_location.billing_address`	O endereço de faturamento do local da empresa em um pedido B2B.
`customer_order_url`	A nova página de status do pedido para o qual um cliente solicitou uma devolução usando contas de cliente.

Propriedades de rascunho de pedido

Descrições de propriedades do Liquid que podem ser usadas com o objeto de rascunho de pedido em modelos de notificação
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é a qual os itens de linha no rascunho ficam reservados. Por exemplo: `2015-05-30T17:43:51+02:00`. É possível formatar datas com o filtro de data do Liquid.
`user`	O último membro da equipe que modificou o rascunho de pedido.
`user.name`	O nome do último membro da equipe que modificou o rascunho de pedido.
`user.email`	O endereço de e-mail do último membro da equipe que modificou o rascunho de pedido.
`email`	O endereço de e-mail associado ao rascunho de pedido.
`name`	O exclusivo `number` do rascunho de pedido, com o prefixo de cerquilha `#`.
`number`	O número exclusivo do rascunho de pedido sem o prefixo ou sufixo.
`created_at`	A data e a hora em que o cliente criou o rascunho de pedido. Por exemplo: `2009-05-30T17:43:51+02:00`. É possível formatar datas com o filtro de data do Liquid.
`tags`	Retorna uma matriz com todas as tags do pedido. As tags são retornadas em ordem alfabética. Consulte a documentação de referência do Liquid para ver mais detalhes.
`tax_price`	O total de tributos de todos os itens do rascunho de pedido.
`tax_lines`	Tributos divididos 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`	O nome do tributo. Exemplos: QST ou IVA
`tax_line.price`	O valor do tributo.
`tax_line.rate`	A alíquota em formato decimal. Por exemplo, uma alíquota de 17,5% retornará `0,175`.
`tax_line.rate_percentage`	A alíquota em formato de porcentagem. Por exemplo, uma `alíquota` de 0,175 retornará `17,5`.
`customer`	Objeto do cliente que contém as características da saída do cliente.
`billing_address`	O endereço de faturamento do rascunho de pedido.
`billing_address.first_name`	O 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 loja.
`subtotal_price`	A soma dos preços dos itens de linha do rascunho de pedido após a dedução de qualquer desconto de item de linha ou do carrinho. O subtotal não inclui tributos (a menos que já estejam inclusos nos preços) nem custos de frete.
`discounts`	Uma lista de descontos.
`discounts_amount`	Valor total dos descontos aplicados. Exemplo: +$5,00
`discounts_savings`	Valor da economia gerada por todos os descontos. Exemplo: -$5,00
`total_price`	O preço total do pedido (subtotal + custo de frete - desconto de frete + tributos).
`amount_due_now`	O valor devido na fatura do rascunho de pedido.
`requires_shipping`	Retorna `true` `true` se houver pelo menos um item no rascunho de pedido que exija frete. Retorna `false` `false` se nenhum item no rascunho de pedido exigir frete.
`shipping_method.title`	O nome da taxa de frete. Exemplo: Frete padrão
`shipping_method.price`	O preço da forma de frete. Retorna a mesma informação que `shipping_price`.
`shipping_price`	Preço do frete. É possível formatar esse valor usando os filtros de moeda do Liquid.
`shipping_address`	O endereço de entrega. Observação: ao contrário dos pedidos normais, 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`	A soma das quantidades de todos os itens no rascunho de pedido.
`note`	A observação anexada ao rascunho de pedido. A observação pode ser obtida com o cliente e também editada na tela de informações do rascunho de pedido no admin da Shopify.
`metafields`	Quaisquer metacampos no rascunho de pedido. Use a seguinte sintaxe: metafields.NAMESPACE.KEY
`location`	O local físico do pedido. Há várias propriedades de local disponíveis. É possível configurar locais na página Locais do admin da Shopify.
`b2b?`	Retorna “true” se o pedido for B2B. Use a propriedade com variáveis B2B para exibir informações relevantes, como o nome da empresa, o local da empresa e o endereço nos e-mails. Por exemplo, em pedidos B2B, é possível adicionar um cabeçalho a um modelo com as seguintes informações: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	A empresa para a qual você vende em um pedido B2B.
`company.name`	O nome da empresa em um pedido B2B.
`company.id`	O ID da empresa em um pedido B2B.
`company_location`	O local da empresa em um pedido B2B. Uma empresa que compra de você pode ter mais de um local.
`company_location.name`	O nome do local da empresa em um pedido B2B.
`company_location.id`	O número de ID do local da empresa em um pedido B2B.
`company_location.shipping_address`	O endereço de entrega do local da empresa em um pedido B2B.
`company_location.billing_address`	O endereço de faturamento do local da empresa em um pedido B2B.
`payment_methods`	Uma lista de formas de pagamento salvas disponíveis para processar o valor total do rascunho.
`payment_method.payment_instrument`	O instrumento de pagamento, que contém informações sobre a forma de pagamento salva.
`payment_method.payment_instrument.payment_type`	O tipo de forma de pagamento salva. Por exemplo, “credit_card, apple_pay”.
`payment_method.payment_instrument.credit_card_brand`	A marca do cartão, quando `payment_type` é “credit_card”
`payment_method.payment_instrument.credit_card_company`	A empresa do cartão, quando `payment_type` é “credit_card”
`payment_method.payment_instrument.credit_card_company`	Os 4 últimos dígitos do cartão, quando `payment_type` é “credit_card”

Propriedades do cronograma de pagamento

Descrições das propriedades do Liquid que podem ser usadas com o objeto de cronograma de pagamento em modelos de notificação
Propriedade	Descrição
`payment_schedule.amount_due`	O valor a ser pago por um cronograma de pagamento. É possível formatar valores com moedas usando o filtro de moeda do Liquid.
`payment_schedule.due_at`	A data de vencimento do cronograma de pagamento. É possível formatar datas com o filtro de data do Liquid.
`payment_schedule.due_in_days`	O número de dias até a data de vencimento se o cronograma de pagamento ainda estiver em aberto (não pago).
`payment_schedule.due_later?`	Retorna true se um cronograma de pagamento não tiver sido pago e a data de vencimento for futura.
`payment_schedule.number_of_days_overdue?`	O número de dias a partir da data de vencimento quando um cronograma de pagamento está vencido.
`payment_schedule.overdue?`	Retorna true se um cronograma de pagamento não tiver sido pago e já tiver passado da data de vencimento.

Propriedades do status de pagamento

Descrições das propriedades do Liquid que podem ser usadas com o objeto de status de pagamento em modelos de notificação
Propriedade	Descrição
`has_pending_payment`	(booleano) Retorna true se o pedido tiver uma transação com pagamento pendente. Saiba mais sobre pagamentos pendentes.
`buyer_action_required`	(booleano) Retorna true se um pedido tiver uma transação com um pagamento pendente, e uma ação do comprador for necessária para desbloquear o pagamento. Quando esse valor retorna true e a forma de pagamento é compatível com as instruções de pagamento, o `buyer_pending_payment_instructions` fornece informações que o cliente pode usar para concluir a compra offline. Saiba mais sobre o objeto de transação do Liquid.

Propriedades do componente de pacote

Cada bundle_component na lista de line_item.bundle_components tem as seguintes propriedades. (Apenas rascunhos de pedido)

Descrições de propriedades do Liquid que podem ser usadas com o objeto de componente de pacote em modelos de notificação
Propriedade	Descrição
`bundle_component.image_url`	O URL da imagem do componente de pacote.
`bundle_component.product.title`	O título do produto do componente do pacote.
`bundle_component.quantity`	Quantidade do componente de pacote.
`bundle_component.variant.title`	Os nomes atuais dos valores da opção da variante do componente de pacote, unidos por caracteres `/`. Exemplo: pequeno / vermelho

Propriedades do componente

Cada componente na lista de line_item.components tem as seguintes propriedades. (Apenas em checkouts abandonados) `

Descrições de propriedades do Liquid que podem ser usadas com o objeto de componente em modelos de notificação
Propriedade	Descrição
`component.image_url`	O URL da imagem do componente.
`component.product.title`	O título do produto do componente.
`component.quantity`	Quantidade do componente.
`component.variant.title`	Os nomes atuais dos valores da opção da variante do componente, unidos por caracteres `/`. Exemplo: pequeno / vermelho

Propriedades do item de linha

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

Descrições de propriedades do Liquid que podem ser usadas com o objeto de item de linha em modelos de notificação
Propriedade	Descrição
`line.applied_discounts`(POS and draft orders only)	Lista de descontos aplicados a este item (cada desconto tem as propriedades `title`, `code`, `amount`, `savings` e `type`).
`line.bundle_components`(Draft orders only)	Lista de itens de linha que são componentes de pacote deste item. Só retorna uma lista se este item de linha for um produto de pacote.
`line.bundle_parent?`(Draft orders only)	(booleano) Retorna true se o item de linha for um produto de pacote.
`line.components`(Abandoned checkout only)	Lista de itens de linha que são componentes deste item.
`line.parent?`(Abandoned checkout only)	(booleano) Retorna true se o item de linha tiver componentes.
`line.custom`(Draft orders only)	(booleano) Retorna true se o item for um item de linha personalizado para um rascunho de pedido.
`line.delivery_agreement`	O Contrato de Entrega associado a este item de linha.
`line.grams`	Peso de um único item.
`line.groups`	Grupo de itens de linha do item.
`line.image`	Retorna o URL da imagem associada a este item de linha. Também é possível usar o filtro img_url para obter tamanhos de imagem específicos. Por exemplo: `{{ line.image \| img_url: 'small' }}`
`line.line_price`	O preço multiplicado pela quantidade do 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 itens no item de linha, incluindo todos os valores de desconto no nível da linha.
`line.pre_tax_price`	O preço antes dos tributos para os itens de linha, multiplicado pela quantidade do item de linha comprado.
`line.price`	O preço de um único item.
`line.product.metafields`	Quaisquer metacampos no nível do produto. Use a seguinte sintaxe: line.product.metafields.NAMESPACE.KEY
`line.product.title`	O nome atual do produto.
`line.product.vendor`	O fabricante do item.
`line.properties`	Retorna uma matriz de informações personalizadas para um item. As propriedades do item de linha são especificadas pelo cliente na página do produto antes de adicionar um produto ao carrinho.
`line.quantity`	Quantidade desse item.
`line.current_quantity`	A quantidade atual do item após as remoções.
`line.requires_shipping`	(booleano) Retorna true se a variante do item tiver a configuração Produto físico ativada na página do produto.
`line.selling_plan_allocation`	Retorna um objeto `selling_plan_allocation`, que descreve como um plano de venda, como uma assinatura, afeta o item de linha.
`line.taxable`	(booleano) Retorna true se a variante do item estiver com a caixa de seleção “Cobrar tributos sobre este produto” marcada na página do produto.
`line.title`	O nome do produto no momento da venda, seguido por um hífen e o nome da variante no momento da venda. O nome da variante não é incluído quando é um “Título padrão”. Em notificações para o cliente, o nome do produto e o nome da variante são traduzidos para o idioma em que o cliente finalizou a compra, quando o idioma é diferente do padrão da loja.
`line.url`	A URL relativa da variante do item de linha. A URL relativa não inclui a URL raiz da loja (`mystore.myshopify.com`).
`line.variant.barcode`	O código de barras associado à variante do produto.
`line.variant.compare_at_price`	O preço de comparação associado à variante do produto.
`line.variant.image`	A imagem da variante do produto. Retorna uma imagem somente 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`	O SKU associado à variante do produto.
`line.variant.title`	Os nomes atuais dos valores da opção da variante, unidos por caracteres `/`. Exemplo: pequeno / vermelho
`line.refunded.quantity`(within refund notifications)	A quantidade de um item a ser reembolsado. É possível usar essa propriedade para adicionar um identificador a itens reembolsados em um pedido. Por exemplo: `{% if line.refunded_quantity > 0 %}Refunded line identifier{% endif %}`

Detectar itens do Shopify Collective em modelos de notificação

A tag do Shopify Collective é aplicada a um pedido depois que o e-mail de confirmação de pedido é enviado, portanto, {% if tags contains 'Shopify Collective' %} nunca é true em um modelo de confirmação de pedido. Para detectar itens do Shopify Collective, verifique as tags no nível do produto em cada item de linha:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Propriedades do grupo de itens de linha

Cada line_item_group na lista de line_item_groups tem as seguintes propriedades.

Descrições de propriedades do Liquid que podem ser usadas com o objeto de grupo de itens de linha em modelos de notificação.
Propriedade	Descrição
`line_item_group.display_title`	O título do grupo de itens de linha.
`line_item_group.components`	Lista de componentes de item de linha que pertencem ao grupo.
`line_item_group.image`	A imagem do grupo de itens de linha.
`line_item_group.product_id`	O ID do produto do grupo de itens de linha.
`line_item_group.variant`	O objeto da variante do grupo de itens de linha.
`line_item_group.variant_id`	O ID da variante do grupo de itens de linha.

Propriedades de reembolsos

Descrições de propriedades do Liquid que podem ser usadas com o objeto de reembolso em modelos de notificação.
Propriedade	Descrição
`amount`	O valor reembolsado.
`refund_line_items`	Uma lista de itens de linha de reembolso a serem reembolsados.

Propriedades de item de linha de reembolso

Cada refund_line na lista de refund_line_items tem as seguintes propriedades:

Descrições de propriedades do Liquid que podem ser usadas com o objeto de itens de linha de reembolso em modelos de notificação.
Propriedade	Descrição
`refund_line.line_item`	O line_item que está sendo reembolsado. Ele tem acesso a todas as propriedades do line_item.
`refund_line.quantity`	A quantidade do item de linha a ser reembolsado.

Propriedades de processamento de pedidos

Descrições de propriedades do Liquid que podem ser usadas com o objeto de processamento de pedidos em modelos de notificação.
Propriedade	Descrição
`service_name`	O nome do serviço personalizado conforme definido na página Configurações > Frete e entrega. (Somente solicitação de processamento de pedidos)
`fulfillment.estimated_delivery_at`	Uma data de entrega estimada com base no número de rastreamento (se disponível) fornecido por uma das seguintes transportadoras: USPS, FedEx, UPS, Canada Post (apenas no Canadá). Essa propriedade só fica 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 processados.
`fulfillment.item_count`	A soma das quantidades de todos os itens. O número total de itens sendo processados.
`fulfillment.requires_shipping`	(booleano) Retorna “true” se esta solicitação de processamento de pedidos 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)	Uma lista de itens de linha que devem ser processados por este serviço personalizado de processamento de pedidos específico. (apenas para solicitação de processamento)
`items_to_fulfill_count`(deprecated)	O número total de itens a serem processados por esta solicitação. (apenas para solicitação de processamento)

Propriedades do item de linha de processamento de pedidos

Cada fulfillment_line na lista de fulfillment_line_items tem as seguintes propriedades.

Descrições de propriedades do Liquid que podem ser usadas com o objeto de itens de linha de processamento de pedidos em modelos de notificação.
Propriedade	Descrição
`fulfillment_line.line_item`	O line_item que está sendo processado. Ele tem acesso a todas as propriedades do line_item.
`fulfillment_line.quantity`	A quantidade do item de linha que está sendo processado.

Propriedades do pacote preparado

Um pacote preparado inclui os itens marcados como prontos para retirada.

Descrições de propriedades do Liquid que podem ser usadas com o objeto de pacote preparado em modelos de notificação.
Propriedade	Descrição
`item_count`	A soma de todas as quantidades de itens no pacote preparado.
`prepared_package_line_items`	Uma lista de itens de linha do pacote preparado.

Propriedades do item de linha de pacote preparado

Cada prepared_package_line_item na lista de prepared_package_line_items tem as seguintes propriedades.

Descrições de propriedades do Liquid que podem ser usadas com o objeto de item de linha de pacote preparado em modelos de notificação.
Propriedade	Descrição
`line_item`	O line_item associado. Ele tem acesso a todas as propriedades do line_item.
`quantity`	A quantidade do item de linha que foi marcado como pronto para retirada.

Propriedades da entrega

Descrições de propriedades do Liquid que podem ser usadas com o objeto de entrega em modelos de notificação.
Propriedade	Descrição
`delivery_agreements`	Lista de todos os Contratos de Entrega do pedido.
`delivery_instructions`	Informações de entrega local para compartilhar com o cliente. Essas informações são controladas pelo campo Informações de entrega nas configurações de entrega local.
`consolidated_estimated_delivery_time`	Informações das datas de entrega do pedido para compartilhar com o cliente. Essas informações são controladas pela configuração Tempo de processamento definida na página Frete e entrega. Quando o pedido tem várias formas de entrega, uma lista de formas e datas de entrega é exibida.
`has_multiple_delivery_methods`	(boolean) Retorna true se o pedido tiver várias formas de entrega.

Propriedades do contrato de entrega

Descrições de propriedades do Liquid que você pode usar com o objeto de contrato de entrega em modelos de notificação
Propriedade	Descrição
`delivery_agreement.delivery_method_type`	O tipo da forma de entrega.
`delivery_agreement.delivery_method_name`	O tipo da forma de entrega traduzido para o idioma que o comprador usou na finalização da compra, quando o idioma é diferente do padrão da loja.
`delivery_agreement.line_item_groups`	Lista de todos os grupos de itens de linha com os componentes de item de linha de pacotes no contrato de entrega.
`delivery_agreement.line_items`	Lista de todos os itens de linha associados a este contrato de entrega.

Propriedades de desconto

Existem dois tipos de propriedades de desconto.

discount_applications descreve por que e como um item recebeu desconto.

discount_allocations descreve como um desconto específico afeta um item de linha e como ele reduz o preço. Use essa propriedade no nível do item de linha.

É possível combinar essas propriedades para exibir informações de desconto no nível do item de linha ou do pedido.

Exemplo

Este exemplo verifica se um desconto foi aplicado ao item de linha. Se o desconto não foi aplicado no nível do pedido (all), o nome e o valor do desconto 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 semelhante a este:

SPRING5 (-$5.00)

Propriedades de discount_allocation

Cada discount_allocation na lista de discount_allocations tem as seguintes propriedades.

Descrições das propriedades do Liquid que podem ser usadas com o objeto discount_allocation em modelos de notificação
Propriedade	Descrição
`discount_allocation.amount`	O valor que o cliente economizou em um item de linha. Precisa ser inserido em um loop caso você 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 de discount_application

Cada discount_application na lista de discount_applications tem as seguintes propriedades.

Descrições das propriedades do Liquid que podem ser usadas com o objeto discount_application em modelos de notificação
Propriedade	Descrição
`discount_application.target_selection`	Descreve como um desconto seleciona os itens de linha no carrinho para receber o desconto. Uma das seguintes opções: `all`: o desconto se aplica a todos os itens de linha. `entitled`: o desconto se aplica a um subconjunto específico de itens de linha, geralmente definido por uma condição. `explicit`: o desconto se aplica a um item de linha ou linha de frete especificamente selecionado.
`discount_application.target_type`	O tipo de item ao qual um desconto se aplica (`line_item` ou `shipping_line`).
`discount_application.title`	O nome do desconto para o cliente. Exemplos: BEMVINDO10 ou CBBWQQAKYBYY
`discount_application.total_allocated_amount`	O valor total de redução do preço de um pedido pelo desconto.
`discount_application.type`	O tipo do desconto. Um dos seguintes: `automatic`, `discount_code`, `manual` ou `script`.
`discount_application.value`	O valor do desconto.
`discount_application.value_type`	O tipo de valor do desconto. Um dos seguintes: `fixed_amount` ou `percentage`.

Propriedades da assinatura

Os detalhes de um contrato de assinatura, o ciclo de faturamento atual e seus itens de linha, forma de entrega e forma de pagamento estão disponíveis para todos os modelos de e-mail de assinatura.

Para editar os modelos de notificação de assinatura, instale o app Shopify Subscriptions e encontre o modelo em Configurações > Notificações, na seção Assinaturas.

Propriedades do ciclo de faturamento do contrato de assinatura

Para acessar as propriedades do contrato de assinatura e do ciclo de faturamento, use o objeto subscription_contract_billing_cycle.

Exemplo

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Resultado:

This contract is currently paused.

Propriedades

Descrições das propriedades do Liquid que podem ser usadas com o objeto do ciclo de faturamento do contrato de assinatura em modelos de notificação
Propriedade	Descrição
`status`	O status do contrato. Um dos seguintes: `active`, `paused`, `cancelled`, `failed`, `expired`, `stale`,
`delivery_method`	A forma de entrega da assinatura. Se a assinatura for de um serviço ou produto digital, `nil` será retornado.
`billing_frequency`	A frequência de faturamento da assinatura.
`delivery_frequency`	A frequência de entrega da assinatura.
`origin_order`	O pedido original que criou a assinatura. Se a assinatura não tiver sido criada a partir de um pedido da Shopify, `nil` será retornado.
`customer`	O cliente da assinatura.
`line_items`	Os itens de linha no ciclo de faturamento da assinatura.
`product_names`	Uma lista com os nomes dos produtos incluídos no ciclo de faturamento da assinatura.
`update_payment_method_url`	A URL que o cliente pode usar para atualizar a forma de pagamento deste contrato.
`shipping_address`	O endereço de entrega da assinatura. Se a assinatura for de um serviço ou produto digital, `nil` será retornado.
`billing_address`	O endereço de faturamento da assinatura.
`subtotal_price`	O preço do subtotal dos itens de linha da assinatura.
`shipping_price`	O preço do frete da assinatura.
`total_tax`	O total de tributos da assinatura.
`total_price`	O preço total da assinatura.
`total_discounts`	Os descontos totais da assinatura.
`customer_self_serve_url`	A URL de autoatendimento que o cliente pode usar para gerenciar as próprias assinaturas.
`billing_attempt_expected_date`	A data de faturamento deste ciclo de faturamento.
`next_billing_date`	A próxima data de faturamento não ignorada após este ciclo de faturamento.
`last_attempted_billing_date`	A última data de tentativa de faturamento para o ciclo de faturamento.
`days_overdue`	O número de dias de atraso no faturamento deste ciclo.
`payment_instrument`	O instrumento de pagamento associado ao contrato de assinatura. Ele é usado para cobrar o cliente.

Propriedades do item de linha do contrato de assinatura

As propriedades de cada item de linha incluído no ciclo de faturamento. Acesse as propriedades do item de linha do contrato pela propriedade principal subscription_contract_billing_cycle.line_items.

Exemplo

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

Descrições das propriedades do Liquid que podem ser usadas com o objeto do item de linha do contrato de assinatura em modelos de notificação
Propriedade	Descrição
`url`	A URL da página de informações do produto para a variante do produto do item de linha.
`requires_shipping`	Indica se o item de linha exige frete de produto físico.
`unit_price_measurement`	A medição do preço unitário do item de linha.
`selling_plan_allocation`	A alocação do plano de venda do item de linha.

Propriedades da forma de entrega do contrato de assinatura

As propriedades da forma de entrega usada neste ciclo de faturamento. Acesse as propriedades da forma de entrega por meio da propriedade principal subscription_contract_billing_cycle.delivery_method.

Exemplo

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

Descrições de propriedades do Liquid para usar com o objeto de forma de entrega do contrato de assinatura nos modelos de notificação.
Propriedade	Descrição
`title`	O título da opção de frete associada à forma de entrega.
`type`	O tipo de forma de entrega. Uma das seguintes opções: `frete`, `local` ou `retirada`.

Propriedades do instrumento de pagamento do contrato de assinatura

Informações sobre o instrumento de pagamento do contrato de assinatura. Esse instrumento é usado para cobrar o cliente. Acesse as propriedades do instrumento de pagamento pela propriedade principal subscription_contract_billing_cycle.payment_instrument.

Exemplo

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

Descrições de propriedades do Liquid que você pode usar com o objeto de instrumento de pagamento do contrato de assinatura em modelos de notificação
Propriedade	Descrição
`payment_type`	O tipo de forma de pagamento representado pelo instrumento de pagamento. Use os filtros de pagamento para gerar uma URL de imagem ou SVG.
`credit_card_brand`	A marca do cartão de crédito.
`credit_card_company`	O nome da empresa do cartão de crédito.
`credit_card_last_four_digits`	Os 4 últimos dígitos do cartão de crédito.

Propriedades da notificação por e-mail

Descrições de propriedades do Liquid para usar com o objeto de notificações por e-mail nos modelos de notificação.
Propriedade	Descrição
`shop.email_logo_url`	A URL do logo especificada na seção Personalizar modelos de e-mail do painel do admin.
`shop.email_logo_width`	A largura do logo (em pixels) especificada na seção Personalizar modelos de e-mail do painel do admin.
`shop.email_accent_color`	O código HEX da cor de destaque especificado na seção Personalizar modelos de e-mail do painel do admin.

Propriedades do crédito na loja

As propriedades que contêm informações sobre a emissão de crédito na loja.

Descrições de propriedades do Liquid para usar com o objeto de crédito na loja emitido nos modelos de notificação.
Propriedade	Descrição
`issued_store_credit.amount`	O valor do crédito na loja que foi emitido. É possível formatar esse valor usando os filtros de moeda do Liquid.
`issued_store_credit.expires_at`	A data e a hora em que o crédito na loja emitido expirará. É possível formatar este valor com os filtros de data do Liquid.
`issued_store_credit.balance_after_transaction`	O saldo da conta de crédito da loja após a emissão do crédito. É possível formatar esse valor usando os filtros de moeda do Liquid.
`customer`	Objeto do cliente que contém as características da saída do cliente.