Riferimento alle variabili del documento di trasporto

I documenti di trasporto vengono visualizzati tramite Liquid, un linguaggio per modelli creato da Shopify.

Puoi apportare modifiche ai modelli dei documenti di trasporto cliccando su Modello di documento di trasporto nella sezione Documenti della pagina Spedizione e consegna del pannello di controllo Shopify.

Variabili del negozio

Utilizza le variabili in questa tabella per aggiungere i dettagli sul negozio al documento di trasporto. Puoi trovare e modificare le informazioni sul negozio nella pagina delle impostazioni Generali del pannello di controllo Shopify.

Descrizione delle variabili Liquid del negozio che puoi utilizzare nei modelli dei documenti di trasporto
VariabileDescrizione
shop.name
Il nome del tuo negozio.
shop.email
Indirizzo email del negozio.
shop.domain
Dominio del negozio.

Variabili dell'indirizzo del negozio

Usa le variabili in questa tabella per aggiungere l'indirizzo del negozio al documento di trasporto. Puoi trovare e modificare i dati dell'indirizzo nella sezione Origine della spedizione della pagina Spedizione e consegna del pannello di controllo Shopify.

Descrizione delle variabili Liquid dell'indirizzo del negozio che puoi utilizzare nei modelli dei documenti di trasporto
VariabileDescrizione
shop_address.address1
Indirizzo del negozio.
shop_address.address2
Appartamento o interno del negozio.
shop_address.company
Nome dell’azienda.
shop_address.city
Città del negozio
shop_address.province_code
Codice dello stato o della provincia del negozio. Ad esempio, il codice della provincia dell'Ontario è ON.
shop_address.province
Stato o provincia del negozio
shop_address.zip
Codice ZIP o codice postale del negozio.
shop_address.country_code
Codice del paese del negozio. Ad esempio, il codice del Canada è CA.
shop_address.country
Paese del negozio.
shop_address.summary
Indirizzo completo del negozio.

Variabili dell'ordine

Usa le variabili in questa tabella per aggiungere i dettagli sull'ordine al documento di trasporto. Puoi visualizzare un elenco degli ordini nella pagina Ordini del pannello di controllo Shopify.

Descrizione delle variabili Liquid dell'ordine che puoi utilizzare nei modelli dei documenti di trasporto
VariabileDescrizione
order.order_number
Il numero d'ordine senza prefissi o suffissi. Ad esempio, 1004.
order.name
Il numero d'ordine inclusi eventuali prefissi o suffissi impostati nella pagina delle impostazioni Generali del pannello di controllo Shopify. Ad esempio, #1004.
order.note
La nota associata all'ordine, se presente.
order.created_at
La data e l'ora di creazione dell'ordine. Ad esempio, 2009-05-30T17:43:51+02:00. Usa il filtro data per modificare il formato.

Variabili del cliente

Usa le variabili in questa tabella per aggiungere le informazioni del cliente al documento di trasporto. Puoi visualizzare un elenco di ordini nella pagina Clienti del pannello di controllo Shopify.

Descrizione delle variabili Liquid del cliente che puoi utilizzare nei modelli dei documenti di trasporto
VariabileDescrizione
customer.first_name
Nome del cliente.
customer.last_name
Cognome del cliente.
customer.name
Nome completo del cliente.
customer.email
Email del cliente.

Variabili dell'indirizzo di spedizione e fatturazione del cliente

Usa le variabili in questa tabella per aggiungere l'indirizzo di spedizione o di fatturazione del cliente al documento di trasporto. Puoi visualizzare un elenco di ordini nella pagina Clienti del pannello di controllo Shopify.

Descrizione delle variabili Liquid dell'indirizzo del cliente che puoi utilizzare nei modelli dei documenti di trasporto
VariabileDescrizione

shipping_address.address1

billing_address.address1

Indirizzo del cliente.

shipping_address.address2

billing_address.address2

Appartamento o interno del cliente.

shipping_address.first_name

billing_address.first_name

Nome del cliente.

shipping_address.last_name

billing_address.last_name

Cognome del cliente.

shipping_address.name

billing_address.name

Nome completo del cliente.

shipping_address.phone

billing_address.phone

Numero di telefono del cliente.

shipping_address.company

billing_address.company

Nome dell'azienda del cliente per l'indirizzo di spedizione.

shipping_address.city

billing_address.city

Città del cliente.

shipping_address.province_code

billing_address.province_code

Codice dello stato o della provincia del cliente. Ad esempio, il codice della provincia dell'Ontario è ON.

shipping_address.province

billing_address.province

Stato o provincia del cliente.

shipping_address.zip

billing_address.zip

Codice ZIP o codice postale del cliente.

shipping_address.country_code

billing_address.country_code

Codice del paese del cliente. Ad esempio, il codice del Canada è CA.

shipping_address.country

billing_address.country

Paese del cliente.

shipping_address.summary

billing_address.summary

Indirizzo completo del cliente.

Variabili delle voci nella spedizione

Usa le variabili in questa tabella per aggiungere i dettagli del prodotto al documento di trasporto. Per visualizzare i prodotti di un ordine, vai alla pagina Ordini del pannello di controllo Shopify e clicca sul numero d'ordine.

Descrizione delle variabili Liquid delle voci nella spedizione che puoi utilizzare nei modelli dei documenti di trasporto
VariabileDescrizione
line_items_in_shipment

Un elenco di voci che appartengono alla stessa spedizione. Le singole voci possono trovarsi all'interno di un loop come line_item:

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

Tutti gli attributi disponibili di line_item sono elencati di seguito:

line_item.image - L'immagine del prodotto, se presente.

line_item.title - Il nome del prodotto. Se il prodotto ha più varianti, viene incluso anche il nome della variante.

line_item.variant_title - Il nome della variante di prodotto.

line_item.vendor - Il venditore del prodotto.

line_item.sku - Lo SKU del prodotto.

line_item.quantity - La quantità totale per quel prodotto.

line_item.shipping_quantity - La quantità di quel prodotto che viene evasa nella spedizione.

line_item.properties - Le proprietà del prodotto.

line_item.groups: un elenco di gruppi di voci a cui appartiene il prodotto, come pacchetti o componenti aggiuntivi. Ogni gruppo ha i seguenti attributi:

  • group.title: il titolo visualizzato del gruppo.
  • group.deliverable?: restituisce true se la voce è un componente aggiuntivo di un prodotto principale o false se la voce fa parte di un pacchetto.
includes_all_line_items_in_order

Booleano

Se true, tutti gli articoli dell'ordine sono inclusi nella spedizione.

Se false, non tutti gli articoli dell'ordine sono inclusi nella spedizione.

Immagini

Sono consentite solo le immagini provenienti dal dominio https://cdn.myshopify.com/. Tutte le altre immagini vengono filtrate. Puoi includere qualsiasi immagine che hai caricato nella pagina File del pannello di controllo Shopify.

Per aggiungere immagini o miniature dei prodotti al documento di trasporto, usa la variabile line_item.image.

Esempi di variabili del documento di trasporto

Gli esempi seguenti mostrano come utilizzare alcune delle variabili del documento di trasporto.

now

Puoi utilizzare il formato seguente per mostrare la data e l'ora correnti:

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

L'output è:

2018-09-10 14:23

line_items_in_shipment

La variabile line_items_in_shipment mostra un array di voci incluse nella spedizione.

Ad esempio:

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

I campi restituiti in ogni voce line_item sono i seguenti:

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 il tuo negozio utilizza pacchetti o componenti aggiuntivi, puoi visualizzare le informazioni sul gruppo per ciascuna voce:

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

line_item.image

Puoi visualizzare le immagini per le voci utilizzando il formato seguente:

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

Puoi visualizzare la quantità e la quantità di spedizione per le voci utilizzando il formato seguente:

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

Ad esempio, potrebbe essere visualizzato:

2 of 5

includes_all_line_items_in_order

Puoi utilizzare questa variabile per visualizzare un messaggio se stai spedendo alcuni degli articoli di un ordine. Ad esempio:

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