Referência de variáveis da guia de remessa

As guias de remessa são renderizadas com Liquid, uma linguagem de modelo criada pela Shopify.

É possível fazer alterações nos modelos de guia de remessa clicando em Modelo de guia de remessa na seção Documentos da página Frete e entrega no admin da Shopify.

Nesta página

Variáveis da loja

Use as variáveis desta tabela para adicionar informações sobre a loja à guia de remessa. As informações da loja podem ser encontradas e editadas na página de configurações Gerais do admin da Shopify.

Descrição das variáveis de loja do Liquid que podem ser usadas nos modelos de guia de remessa
Variável	Descrição
shop.name	O nome da sua loja.
shop.email	O endereço de e-mail da sua loja.
shop.domain	O domínio da sua loja.

Variáveis de endereço da loja

Use as variáveis desta tabela para adicionar o endereço da sua loja à guia de remessa. Você pode encontrar e editar as informações do endereço na seção Origem do frete da página Frete e entrega no admin da Shopify.

Descrição das variáveis de endereço da loja do Liquid que você pode usar nos modelos de guia de remessa
Variável	Descrição
shop_address.address1	O endereço da sua loja.
shop_address.address2	O apartamento ou a sala da sua loja.
shop_address.company	O nome da sua empresa.
shop_address.city	A cidade da sua loja
shop_address.province_code	O código do estado ou da província da sua loja. Por exemplo, o código da província de Ontário é ON.
shop_address.province	O estado ou a província da sua loja
shop_address.zip	O CEP ou código postal da sua loja.
shop_address.country_code	O código de país da sua loja. Por exemplo, o código do Canadá é CA.
shop_address.country	O país da sua loja.
shop_address.summary	O endereço completo da sua loja.

Variáveis do pedido

Use as variáveis desta tabela para adicionar informações sobre o pedido à guia de remessa. É possível ver uma lista de pedidos na página Pedidos do admin da Shopify.

Descrição das variáveis de pedido do Liquid que você pode usar nos modelos de guia de remessa
Variável	Descrição
order.order_number	O número do pedido sem prefixos ou sufixos. Por exemplo, `1004`.
order.name	O número do pedido, incluindo prefixos ou sufixos definidos na página de configurações Gerais do admin da Shopify. Por exemplo, `#1004`.
order.note	A anotação associada ao pedido, se houver.
order.created_at	A data e a hora de criação do pedido. Por exemplo, `2009-05-30T17:43:51+02:00`. Use o filtro de data para alterar o formato.

Variáveis do cliente

Use as variáveis desta tabela para adicionar as informações do cliente à guia de remessa. É possível ver uma lista de pedidos na página Clientes do admin da Shopify.

Descrição das variáveis do cliente do Liquid que você pode usar nos modelos de guia de remessa
Variável	Descrição
customer.first_name	O nome do cliente.
customer.last_name	O sobrenome do cliente.
customer.name	O nome completo do cliente.
customer.email	O e-mail do cliente.

Variáveis de endereço de entrega e faturamento do cliente

Use as variáveis desta tabela para adicionar o endereço de entrega ou de faturamento do cliente à guia de remessa. É possível ver uma lista de pedidos na página Clientes do admin da Shopify.

Descrição das variáveis de endereço do cliente do Liquid que você pode usar nos modelos de guia de remessa
Variável	Descrição
shipping_address.address1 billing_address.address1	O endereço do cliente.
shipping_address.address2 billing_address.address2	O apartamento ou a sala do cliente.
shipping_address.first_name billing_address.first_name	O nome do cliente.
shipping_address.last_name billing_address.last_name	O sobrenome do cliente.
shipping_address.name billing_address.name	O nome completo do cliente.
shipping_address.phone billing_address.phone	O número de telefone do cliente.
shipping_address.company billing_address.company	O nome da empresa do cliente para o endereço de entrega.
shipping_address.city billing_address.city	A cidade do cliente.
shipping_address.province_code billing_address.province_code	O código do estado ou da província do cliente. Por exemplo, o código da província de Ontário é ON.
shipping_address.province billing_address.province	O estado ou a província do cliente.
shipping_address.zip billing_address.zip	O CEP ou o código postal do cliente.
shipping_address.country_code billing_address.country_code	O código de país do cliente. Por exemplo, o código do Canadá é CA.
shipping_address.country billing_address.country	O país do cliente.
shipping_address.summary billing_address.summary	O endereço completo do cliente.

Variáveis de itens de linha na remessa

Use as variáveis desta tabela para adicionar informações do produto à guia de remessa. Para ver os produtos de um pedido, acesse a página Pedidos no admin da Shopify e clique no número do pedido.

Descrição das variáveis de itens de linha na remessa do Liquid que você pode usar nos modelos de guia de remessa
Variável	Descrição
line_items_in_shipment	Uma lista de itens de linha que pertencem a uma mesma remessa. É possível incluir itens de linha individuais dentro de um loop como line_item: `{% for line_item in line_items_in_shipment %} {{ line_item.image }} {{ line_item.title }} ... {% endfor %}` Todos os atributos disponíveis de line_item estão listados abaixo: `line_item.image` - A imagem do produto, se houver. `line_item.title` - O nome do produto. Se o produto tiver várias variantes, o nome da variante também será incluído. `line_item.variant_title` - O nome da variante do produto. `line_item.vendor` - O fabricante do produto. `line_item.sku` - O SKU do produto. `line_item.quantity` - A quantidade total desse produto. `line_item.shipping_quantity` - A quantidade desse produto que está sendo processada na remessa. `line_item.properties` - As propriedades do produto. `line_item.groups` - Uma lista de grupos de itens de linha aos quais o produto pertence, como pacotes ou complementos. Cada grupo tem os seguintes atributos: `group.title` - O título de exibição do grupo. `group.deliverable?` - Retorna `true` se o item de linha for um complemento de um produto principal, ou `false` se o item de linha fizer parte de um pacote.
includes_all_line_items_in_order	Booleano Se for `true`, todos os itens do pedido serão incluídos na remessa. Se for `false`, nem todos os itens do pedido serão incluídos na remessa.

Imagens

São permitidas apenas imagens do domínio https://cdn.myshopify.com/. Todas as outras são filtradas. É possível incluir qualquer imagem que você tenha enviado para a página Arquivos no admin da Shopify.

Para adicionar imagens ou miniaturas de produtos à guia de remessa, use a variável line_item.image.

Exemplos de variáveis da guia de remessa

Os exemplos a seguir mostram como usar algumas das variáveis da guia de remessa.

now

Use o formato a seguir para mostrar a hora e a data atuais:

{{ "now" | date: "%Y-%m-%d %H:%M" }}

O resultado é:

2018-09-10 14:23

line_items_in_shipment

A variável line_items_in_shipment exibe uma matriz de itens de linha que estão incluídos na remessa.

Por exemplo:

{% for line_item in line_items_in_shipment %}
  {{ line_item.title }}
  {{ line_item.variant_title }}
  ...
{% endfor %}

Os campos retornados em cada entrada line_item são os seguintes:

line_item.image
line_item.title
line_item.variant_title
line_item.sku
line_item.vendor
line_item.quantity
line_item.shipping_quantity
line_item.properties
line_item.groups

line_item.groups

Se a loja usa pacotes ou complementos, é possível exibir as informações do grupo para cada item de linha:

{% for group in line_item.groups %}
  {% if group.deliverable? %}
    Add-on for: {{ group.title }}
  {% else %}
    Part of: {{ group.title }}
  {% endif %}
{% endfor %}

line_item.image

É possível exibir imagens para os itens de linha usando o seguinte formato:

{% if line_item.image != blank %}
  {{ line_item.image | img_url: '58x58' | img_tag }}
{% endif %}

É possível exibir a quantidade e a quantidade da remessa dos itens de linha no seguinte formato:

{{ line_item.shipping_quantity }} of {{ line_item.quantity }}

Por exemplo, o resultado pode ser:

2 of 5

includes_all_line_items_in_order

Use esta variável para exibir uma mensagem se você estiver enviando apenas alguns itens de um pedido. Por exemplo:

{% unless includes_all_line_items_in_order %}
  There are other items from your order not included in this shipment.
{% endunless %}