Riferimenti variabili di notifica
Le notifiche inviate dal tuo negozio vengono visualizzate utilizzando Liquid. Liquid è il linguaggio di programmazione di Shopify semplice e facile da utilizzare. Si tratta dello stesso linguaggio di programmazione con cui sono costruiti i temi del Theme Store.
Per modificare le notifiche che vengono inviate dal tuo negozio, puoi realizzare delle personalizzazioni di base ai modelli di notifica. Per accedere all'elenco completo delle notifiche che puoi personalizzare, vai alla pagina Notifiche nel pannello di controllo Shopify.
Per ottenere assistenza riguardo alle modifiche più avanzate o per apportare modifiche ai modelli per le notifiche personalizzati, puoi contattare la community sui nostri forum oppure rivolgerti a un Partner di Shopify perché si occupi delle tue personalizzazioni. Scopri di più su come contattare un Partner di Shopify.
Su questa pagina
- Proprietà dell'ordine
- Proprietà delle bozze di ordini
- Proprietà del programma di pagamento
- Proprietà dello stato del pagamento
- Proprietà delle voci
- Proprietà dei rimborsi
- Proprietà di evasione
- Proprietà del pacco preparato
- Proprietà di consegna
- Proprietà dello sconto
- Proprietà dell'abbonamento
- Proprietà "notifiche via email"
Proprietà dell'ordine
Molte proprietà di un ordine sono disponibili direttamente utilizzando Liquid nei modelli email e negli script aggiuntivi.
Proprietà | Descrizione |
---|---|
id |
Un ID dell'ordine univoco nel sistema, per uso interno. Utilizza l'esempio seguente per generare un link all'ordine nella sezione del pannello di controllo del tuo negozio. Ad esempio, nel modello di email Nuovo ordine puoi aggiungere il codice seguente: <a href="{{ shop.url }}/admin/orders/{{ id }}">Visualizza ordine</a> |
L'email associata all'ordine. | |
name |
Normalmente è formato dal simbolo del cancelletto seguito da Esempio: #1004 |
order_name | Lo stesso del nome. |
order_number |
Numero univoco del negozio per l'ordine, senza il simbolo del cancelletto # come prefisso o qualsiasi altro prefisso o suffisso aggiunto all'ID ordine dal proprietario del negozio nelle preferenze del negozio. Esempio: 1004 |
confirmation_number |
Un identificatore alfanumerico generato in modo casuale per l'ordine che potrebbe essere mostrato al cliente al posto del nome dell'ordine sequenziale. Non è garantito che questo valore sia univoco. Esempio: XPAV284CT |
created_at |
La data e l'ora in cui il cliente ha creato l'ordine. La formattazione può essere effettuata utilizzando il filtro della data. Esempio: 2009-05-30T17:43:51+02:00 |
payment_terms |
I termini di pagamento specificano la data di scadenza del pagamento di un ordine. Scopri come aggiungere termini di pagamento alle fatture per gli ordini. Per maggiori informazioni, consulta payment_termsnella guida di riferimento Liquid. |
destination | La destinazione in cui devono essere inviati gli articoli. |
tags | Restituisce una serie di tutti i tag dell'ordine. I tag vengono elencati in ordine alfabetico. Per maggiori dettagli, consulta la documentazione di riferimento su Liquid. |
transactions | Restituisce una serie di transazioni dell'ordine. |
tax_price | Le imposte complessive di tutti gli articoli nell'ordine. |
tax_lines |
Le imposte suddivise per tipo di tassazione:
|
tax_line.title |
Il nome dell'imposta. Esempi: QST o IVA |
tax_line.price | L'importo. |
tax_line.rate | L'aliquota. Sarà equivalente a 0,175 se è pari al 17,5%. |
tax_line.rate_percentage | L'aliquota fiscale in formato leggibile. Sarà equivalente a 17,5 se l'aliquota è pari a 0,175. |
customer | Oggetto cliente contenente gli attributi dell'output del cliente. |
billing_address | L'indirizzo di fatturazione. |
billing_address.first_name | Il nome del cliente. |
billing_address.last_name | Il cognome del cliente. |
billing_address.company | Il nome dell'azienda per la fatturazione. |
billing_address.phone | Il numero di telefono indicato nell'indirizzo di fatturazione. |
shop.name | Il nome del tuo negozio. |
shop.phone | Il numero di telefono del tuo negozio. |
subtotal_price | La somma dei prezzi degli articoli dell'ordine dopo la detrazione di eventuali sconti su articoli o sul carrello. Il subtotale non include le imposte (salvo che le imposte non siano incluse nei prezzi), i costi di spedizione o le mance. |
discounts | Un elenco degli sconti. |
discounts_amount |
L'importo dello sconto applicato da tutti gli sconti. Esempio: + 5,00 $ |
discounts_savings |
L'importo dei risparmi derivanti da tutti gli sconti. Esempio: -5,00 $ |
total_price |
Il totale dell'ordine (subtotale + costi di spedizione - sconto di spedizione + imposte). |
financial_status | Lo stato attuale del pagamento. Può essere nil, pending , authorized , paid , voided , refunded . |
requires_shipping | (booleano) Restituisce TRUE se c'è almeno un articolo nell'ordine che richiede la spedizione. |
shipping_method.title |
Il nome della tariffa di spedizione. Nelle notifiche destinate al cliente, la tariffa di spedizione viene tradotta nella lingua in cui il cliente ha effettuato il check-out, quando è diversa dalla lingua predefinita del negozio. Esempio: spedizione standard |
shipping_method.price |
Il prezzo di spedizione comprensivo di eventuali sconti di spedizione. Esempio: |
shipping_price |
Il prezzo di spedizione. Esempio: |
shipping_address | L'indirizzo di spedizione. |
shipping_address.first_name | Il nome per l'indirizzo di spedizione. |
shipping_address.company | Il nome dell'azienda per l'indirizzo di spedizione. |
shipping_address.phone | Numero di telefono indicato nell'indirizzo di fatturazione. |
line_items | Elenco di tutte le voci nell'ordine. |
line_items_including_zero_quantity | Elenco di tutte le voci dell'ordine, comprese quelle con quantità pari a zero. Le voci hanno una quantità pari a zero quando vengono completamente rimborsate. |
item_count | Una somma di tutte le quantità degli articoli. |
fulfillment_status | L'attuale stato di evasione. Può essere: inevaso , parzialmente evaso , evaso . |
note | La nota allegata all'ordine. La nota può essere inviata dal cliente e/o modificata nella schermata con i dettagli dell'ordine all'interno dell'interfaccia del tuo pannello di controllo. |
attributes |
Ogni attributo che è stato allegato all'ordine. Esempio: |
referring_site |
Contiene l'URL del referrer che ha portato il cliente al tuo negozio. Esempio: |
landing_site |
Contiene il percorso del landing site utilizzato dal cliente. Si tratta della prima pagina che il cliente ha visto una volta arrivato sul tuo negozio. Esempio: |
landing_site_ref |
Controlla il landing site e ne estrae un parametro di riferimento. I parametri di riferimento possono essere: Se il {% if landing_site_ref == 'my-tracking-token' %} La mia azione... {% endif %} |
cancelled | (booleano) Restituisce TRUE se l'ordine è stato annullato. |
cancelled_at | L'ora in cui l'ordine è stato annullato. |
cancel_reason | Il motivo selezionato al momento dell'annullamento dell'ordine. Può essere inventory , customer , declined , fraud o other . |
has_high_risks?(deprecated) | Restituisce TRUE se l'ordine ha un rischio elevato. |
unique_gateways |
Fornisce un elenco di gestori univoci dei pagamenti per un ordine. Ad esempio, se qualcuno pagasse con una carta VISA, una Mastercard e in contanti, l'elenco restituito sarebbe |
location (POS only) |
Mostra la sede fisica dell'ordine. Esistono diverse proprietà di sedi disponibili qui elencate. Puoi configurare le sedi nell'area Sedi del pannello di controllo. |
order_status_url |
Fornisce il link alla pagina di stato dell'ordine relativa a questo ordine. |
fulfilled_line_items(deprecated) | Elenco delle voci che sono state evase. |
unfulfilled_line_items(deprecated) | Elenco delle voci che non sono state completamente evase. |
b2b? |
Restituisce TRUE se l'ordine è un ordine B2B. Utilizza la proprietà con le variabili B2B per mostrare informazioni rilevanti nelle email, come il nome, la sede e l'indirizzo dell'azienda. Ad esempio, negli ordini B2B puoi aggiungere un header a un modello con le seguenti informazioni:
|
company |
L'azienda a cui stai vendendo in un ordine B2B. |
company.name | Il nome dell'azienda in un ordine B2B. |
company.id | L'ID dell'azienda in un ordine B2B. |
company_location |
La sede dell'azienda in un ordine B2B. Un'azienda che acquista da te può avere più di una sede. |
company_location.name | Il nome della sede dell'azienda su un ordine B2B. |
company_location.id | Il numero ID della sede dell'azienda in un ordine B2B. |
company_location.shipping_address |
L'indirizzo di spedizione della sede dell'azienda in un ordine B2B. |
company_location.billing_address |
L'indirizzo di fatturazione della sede dell'azienda in un ordine B2B. |
customer_order_url |
La nuova pagina dei dettagli dell'ordine di un ordine per il quale il cliente ha richiesto il reso, utilizzando i nuovi account cliente. |
Proprietà delle bozze di ordini
Proprietà | Descrizione |
---|---|
id | Un ID univoco della bozza di ordine per uso interno. |
invoice_url | Un link che il cliente può seguire per pagare la fattura utilizzando il check-out sicuro di Shopify. |
reserve_inventory_until |
La data e l'ora fino a quando le voci presenti nell'bozza di ordine sono prenotate, ad esempio Puoi formattare le date utilizzando il filtro della data Liquid. |
user | L'ultimo membro dello staff che ha modificato la bozza di ordine. |
user.name | Il nome dell'ultimo membro dello staff che ha modificato la bozza di ordine. |
user.email | L'indirizzo email dell'ultimo membro dello staff che ha modificato la bozza di ordine. |
L'indirizzo email associato alla bozza di ordine. | |
name | Valore number univoco della bozza di ordine, con un cancelletto # come prefisso. |
number | Il numero univoco della bozza di ordine senza il prefisso o suffisso dell'ordine. |
created_at |
La data e l'ora in cui il cliente ha creato l'bozza di ordine, ad esempio, Puoi formattare le date utilizzando il filtro della data Liquid. |
tags | Restituisce una serie di tutti i tag dell'ordine. I tag vengono elencati in ordine alfabetico. Per maggiori dettagli, consulta la documentazione di riferimento su Liquid. |
tax_price | Le imposte complessive di tutti gli articoli nella bozza di ordine. |
tax_lines |
Le imposte suddivise per tipo di imposta: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %} |
tax_line.title |
Il nome dell'imposta. Esempi: QST o IVA |
tax_line.price | L'importo dell'imposta. |
tax_line.rate | L'aliquota fiscale in formato decimale. Ad esempio, un'aliquota fiscale del 17,5% risulterà 0,175 . |
tax_line.rate_percentage | L'aliquota fiscale in formato percentuale. Ad esempio, un'aliquota dello 0,175 risulterà 17,5 . |
customer | Oggetto cliente contenente gli attributi dell'output del cliente. |
billing_address | L'indirizzo di fatturazione per la bozza di ordine. |
billing_address.first_name | Il nome del cliente. |
billing_address.last_name | Il cognome del cliente. |
billing_address.company | Il nome dell'azienda indicato nell'indirizzo di fatturazione. |
billing_address.phone | Il numero di telefono indicato nell'indirizzo di fatturazione. |
shop.name | Il nome del tuo negozio. |
shop.phone | Il numero di telefono del tuo negozio. |
subtotal_price | La somma dei prezzi degli articoli dell'bozza di ordine dopo la detrazione di eventuali sconti su articoli o sul carrello. Il subtotale non include le imposte (salvo che le imposte non siano incluse nei prezzi) o i costi di spedizione. |
discounts | Un elenco degli sconti. |
discounts_amount |
L'importo dello sconto applicato per tutti gli sconti. Esempio: + 5,00 $ |
discounts_savings |
L'importo dei risparmi derivante da tutti gli sconti applicati. Esempio: -5,00 $ |
total_price | Il prezzo totale dell'ordine (subtotale + costo di spedizione - sconto di spedizione + imposte). |
amount_due_now | L'importo richiesto dalla fattura per bozza d'ordine. |
requires_shipping | Restituisce true se nella bozza di ordine c'è almeno un articolo che richiede la spedizione. Restituisce false se nella bozza di ordine non ci sono articoli che richiedono la spedizione. |
shipping_method.title |
Il nome della tariffa di spedizione. Esempio: spedizione standard |
shipping_method.price | Il prezzo del metodo di spedizione. Restituisce le stesse informazioni di shipping_price . |
shipping_price |
Il prezzo di spedizione. Puoi formattare questo importo utilizzando i filtri dell'importo Liquid. |
shipping_address |
Nota: A differenza degli ordini standard, l'indirizzo di spedizione di una bozza di ordine potrebbe essere incompleto. |
shipping_address.first_name | Il nome per l'indirizzo di spedizione. |
shipping_address.company | Il nome dell'azienda indicato nell'indirizzo di spedizione. |
shipping_address.phone | Il numero di telefono indicato nell'indirizzo di spedizione. |
line_items | Un elenco di tutti gli articoli nella bozza di ordine. |
item_count | Una somma di tutte le quantità degli articoli nella bozza di ordine. |
note | La nota allegata alla bozza di ordine. La nota può essere inviata al cliente e anche modificata nella schermata con i dettagli dell'bozza di ordine all'interno del tuo pannello di controllo Shopify. |
location |
La posizione fisica dell'ordine. Esistono diverse proprietà di posizione disponibili. Puoi configurare le sedi nella pagina Sedi del tuo pannello di controllo Shopify. |
b2b? |
Restituisce TRUE se l'ordine è un ordine B2B. Utilizza la proprietà con le variabili B2B per mostrare informazioni rilevanti nelle email, come il nome, la sede e l'indirizzo dell'azienda. Ad esempio, negli ordini B2B puoi aggiungere un header a un modello con le seguenti informazioni:
|
company | L'azienda a cui stai vendendo in un ordine B2B. |
company.name | Il nome dell'azienda in un ordine B2B. |
company.id | L'ID dell'azienda in un ordine B2B. |
company_location | La sede dell'azienda in un ordine B2B. Un'azienda che acquista da te può avere più di una sede. |
company_location.name | Il nome della sede dell'azienda su un ordine B2B. |
company_location.id | Il numero ID della sede dell'azienda in un ordine B2B. |
company_location.shipping_address | L'indirizzo di spedizione della sede dell'azienda in un ordine B2B. |
company_location.billing_address | L'indirizzo di fatturazione della sede dell'azienda in un ordine B2B. |
Proprietà del programma di pagamento
Proprietà | Descrizione |
---|---|
payment_schedule.amount_due |
L'importo da pagare per un programma di pagamento. Puoi formattare gli importi con le valute utilizzando il filtro dell'importo Liquid. |
payment_schedule.due_at |
La data di scadenza del programma di pagamento. Puoi formattare le date utilizzando il filtro della data Liquid. |
payment_schedule.due_in_days |
Il numero di giorni fino alla data di scadenza se il programma di pagamento è ancora dovuto (non pagato). |
payment_schedule.due_later? |
Restituisce true se un programma di pagamento non è stato pagato e la data di scadenza è successiva. |
payment_schedule.number_of_days_overdue? |
Il numero di giorni successivi alla data di scadenza in cui un programma di pagamento è scaduto. |
payment_schedule.overdue? |
Restituisce true se un programma di pagamenti non è stato pagato ed è passata la data di scadenza. |
Proprietà dello stato del pagamento
Proprietà | Descrizione |
---|---|
has_pending_payment |
(booleano) Restituisce TRUE se l'ordine ha una transazione con un pagamento in attesa. Scopri di più sui pagamenti in attesa. |
buyer_action_required |
(booleano) Restituisce TRUE se un ordine ha una transazione con un pagamento in attesa e per sbloccare il pagamento è necessaria un'azione dell'acquirente. Quando questo valore restituisce TRUE e il metodo di pagamento supporta le istruzioni di pagamento, il Scopri di più sull'oggetto transazione Liquid. |
Proprietà delle voci
Ogni line
nell'elenco line_items
o subtotal_line_items
ha le seguenti proprietà.
Proprietà | Descrizione |
---|---|
line.applied_discounts(POS and draft orders only) | Elenco degli sconti applicati a questo articolo (ciascuno sconto ha le proprietà: titolo , codice , importo , risparmio e tipo ). |
line.bundle_components(Draft orders only) | L'elenco delle voci che sono componenti del pacchetto di questo articolo. Restituisce un elenco solo se questa voce è un prodotto del pacchetto. |
line.bundle_parent?(Draft orders only) | (booleano) Restituisce VERO se la voce è un prodotto del pacchetto. |
line.custom(Draft orders only) | (booleano) Restituisce VERO se la voce è personalizzata per una bozza di ordine. |
line.delivery_agreement | L'accordo di consegna associato a questo articolo. |
line.grams | Il peso di un singolo articolo. |
line.image | Restituisce l'URL dell'immagine associata a questa voce. È possibile utilizzare anche il filtro img_url per ottenere dimensioni di immagine specifiche, per esempio {{ line.image | img_url: 'small' }}
|
line.line_price | Il prezzo moltiplicato per la quantità di quell'articolo. |
line.original_line_price | Il prezzo complessivo della quantità di articoli inclusi nella voce, prima dell'applicazione degli sconti. |
line.final_line_price | Il prezzo complessivo di tutti gli articoli nella voce, inclusi tutti gli importi degli sconti per voce. |
line.pre_tax_price | Il prezzo privo di imposte per le voci dell'ordine, moltiplicato per la quantità della voce acquistata. |
line.price | Il prezzo di un singolo articolo. |
line.product.metafields |
I metafield a livello di prodotto. Utilizza la sintassi seguente: line.product.metafields.NAMESPACE.KEY |
line.product.title | Il nome attuale del prodotto. |
line.product.vendor | Il fornitore dell'articolo. |
line.properties | Restituisce una serie di informazioni personalizzate su una voce. Le proprietà delle voci vengono specificate dal cliente sulla pagina del prodotto, prima di aggiungere un prodotto al carrello. |
line.quantity | La quantità di quell'articolo. |
line.current_quantity | La quantità attuale dell'articolo dopo la rimozione. |
line.requires_shipping | (booleano) Restituisce true se la variante dell'articolo ha la casella di spunta Questo è un prodotto fisico selezionata nella pagina del prodotto. |
line.selling_plan_allocation | Restituisce un oggetto selling_plan_allocation , che descrive le modalità con cui un piano di vendita, ad esempio un abbonamento, influisce sulla voce. |
line.taxable | (booleano) Restituisce VERO se la variante di quell'articolo ha la casella di spunta "Applica imposte su questo prodotto" selezionata sulla pagina del prodotto. |
line.title |
Il nome del prodotto al momento della vendita, seguito da un trattino e dal nome della variante al momento della vendita. Il nome della variante non viene incluso quando si tratta di un "Titolo predefinito". Nelle notifiche destinate al cliente, il nome del prodotto e il nome della variante vengono tradotti nella lingua in cui il cliente ha effettuato il check-out, quando è diversa dalla lingua predefinita del negozio. |
line.url | L'URL relativo della variante della voce. L'URL relativo non include l'URL root del negozio (mystore.myshopify.com ). |
line.variant.barcode | Codice a barre associato alla variante di prodotto. |
line.variant.compare_at_price | Il prezzo di confronto associato alla variante di prodotto. |
line.variant.image | L'immagine della variante di prodotto. Restituisce un'immagine solo se c'è un'immagine specifica assegnata alla variante nella voce. |
line.variant.metafields |
I metafield a livello di variante. Utilizza la sintassi seguente: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku | La SKU associata alla variante di prodotto. |
line.variant.title |
I nomi attuali dei valori opzione della variante, uniti dai caratteri Esempio: small/red |
line.refunded.quantity(within refund notifications) |
La quantità di un articolo da rimborsare. Puoi utilizzare questa proprietà per aggiungere un codice identificativo agli articoli rimborsati in un ordine. Ad esempio: |
Proprietà dei rimborsi
Proprietà | Descrizione |
---|---|
amount | L'importo di denaro rimborsato. |
refund_line_items | Un elenco di voci di rimborso da rimborsare. |
Proprietà refund_line_item
Ogni refund_line
nell'elenco refund_line_items
ha le seguenti proprietà:
Proprietà | Descrizione |
---|---|
refund_line.line_item | L'articolo che è in fase di rimborso. Questo ha accesso a tutte le proprietà del line_item. |
refund_line.quantity | La quantità della voce da rimborsare. |
Proprietà di evasione
Proprietà | Descrizione |
---|---|
service_name | Il nome del servizio personalizzato così come definito su Impostazioni > pagina Spedizione. (Solo richiesta di evasione) |
fulfillment.estimated_delivery_at | Una data di consegna prevista in base al numero di tracking (se disponibile) fornito da uno dei seguenti corrieri: USPS, FedEx, UPS, Canada Post (solo in Canada). Questa proprietà è disponibile esclusivamente quando sono in uso le tariffe calcolate dal corriere. |
fulfillment.fulfillment_line_items | Un elenco delle voci di evasione da evadere. |
fulfillment.item_count | Una somma di tutte le quantità degli articoli. Il numero totale di articoli in fase di evasione. |
fulfillment.requires_shipping | (booleano) Restituisce VERO se questa richiesta di evasione necessita della spedizione. |
fulfillment.tracking_company | La società che effettua il tracking. |
fulfillment.tracking_numbers | Un elenco dei numeri di tracking. |
fulfillment.tracking_urls | Un elenco degli URL di tracking. |
items_to_fulfill(deprecated) | L'elenco delle voci che devono essere evase da questo specifico servizio logistico personalizzato. (Solo richiesta di evasione) |
items_to_fulfill_count(deprecated) | Il numero totale di articoli da evadere secondo questa richiesta. (Solo richiesta di evasione) |
Proprietà fulfillment_line_item
Ogni fulfillment_line
nell'elenco fulfillment_line_items
ha le proprietà seguenti.
Proprietà | Descrizione |
---|---|
fulfillment_line.line_item | Il line_item in fase di evasione. Questo ha accesso a tutte le proprietà del line_item. |
fulfillment_line.quantity | La quantità della voce che è in fase di evasione. |
Proprietà del pacco preparato
Un pacco preparato include gli articoli contrassegnati come pronti per il ritiro.
Proprietà | Descrizione |
---|---|
item_count | Una somma di tutte le quantità degli articoli nel pacco preparato. |
prepared_package_line_items | Un elenco degli articoli del pacco preparato. |
Prepared_package_line_item proprietà
Ogni prepared_package_line_item
nell'elenco prepared_package_line_items
ha le proprietà seguenti.
Proprietà | Descrizione |
---|---|
line_item | Il line_item associato. Questo ha accesso a tutte le proprietà del line_item. |
quantity | La quantità dell'articolo contrassegnato come pronto per il ritiro. |
Proprietà di consegna
Proprietà | Descrizione |
---|---|
delivery_agreements | Elenco di tutti gli accordi di consegna relativi all'ordine. |
delivery_instructions | Informazioni sulla consegna locale da condividere con il cliente. Queste informazioni sono controllate tramite il campo Informazioni sulla consegna all'interno delle impostazioni di consegna locale. |
consolidated_estimated_delivery_time | Informazioni sulle date di consegna dell'ordine da condividere con il cliente. Queste informazioni sono controllate dall'impostazione Tempo di elaborazione che hai configurato nella pagina Spedizione e consegna. Quando l'ordine dispone di più metodi di consegna, viene visualizzato un elenco di metodi e date di consegna. |
has_multiple_delivery_methods | (booleano) Restituisce TRUE se l'ordine ha più metodi di consegna. |
Proprietà dell'accordo di consegna
Proprietà | Descrizione |
---|---|
delivery_agreement.delivery_method_type | Il tipo di metodo di consegna. |
delivery_agreement.delivery_method_name | Il tipo di metodo di consegna tradotto nella lingua in cui l'acquirente ha effettuato il check-out, quando la lingua è diversa da quella predefinita del negozio. |
delivery_agreement.line_items | Elenco di tutte le voci associate a questo accordo di consegna. |
Proprietà dello sconto
Esistono due tipi di proprietà "sconto".
discount_applications
descrive il motivo per cui un articolo è stato scontato e con quali modalità.
discount_allocations
descrive il modo in cui un determinato sconto influisce su una voce e ne riduce il prezzo. Utilizza questa proprietà a livello della voce.
Puoi combinare le due proprietà per mostrare informazioni sugli sconti a livello della voce o dell'ordine.
Esempio
Questo esempio verifica se è stato applicato uno sconto alla voce. Se lo sconto non è stato applicato a livello dell'ordine (all
), verranno visualizzati il nome e l'importo dello sconto.
Il risultato potrebbe essere simile a questo:
Proprietà discount_allocation
Ogni discount_allocation
nell'elenco discount_allocations
ha le proprietà seguenti.
Proprietà | Descrizione |
---|---|
discount_allocation.amount | L'importo di denaro risparmiato dal cliente su una voce. Per autorizzare più codici sconto l'importo deve essere inserito in un ciclo. |
discount_allocation.discount_application | L'applicazione di sconto che assegna l'importo alla voce. |
Proprietà discount_application
Ogni discount_application
nell'elenco discount_applications
ha le proprietà seguenti.
Proprietà | Descrizione |
---|---|
discount_application.target_selection |
Descrive le modalità con cui uno sconto seleziona le voci da scontare nel carrello. Può essere:
|
discount_application.target_type | Il tipo di articolo a cui si applica uno sconto (line_item o shipping_line ). |
discount_application.title |
Il nome dello sconto mostrato ai clienti. Esempi: Welcome10 o CBBWQQAKYBYY |
discount_application.total_allocated_amount | L'importo totale dedotto dal prezzo di un ordine tramite sconto. |
discount_application.type | Il tipo di sconto. Può essere automatic , discount_code , manual o script . |
discount_application.value | Il valore dello sconto. |
discount_application.value_type | Il tipo di valore dello sconto. Può essere fixed_amount o percentage . |
Proprietà dell'abbonamento
I dettagli di un contratto di abbonamento, il ciclo di fatturazione attuale e le relative voci, il metodo di consegna e il metodo di pagamento sono disponibili per tutti i modelli di email di abbonamento.
Per modificare i modelli di notifica di abbonamento, installa l'app Shopify Subscriptions e trova il modello nella sezione Impostazioni > Notifiche nella sezione Abbonamenti.
Proprietà del ciclo di fatturazione del contratto di abbonamento
Per accedere alle proprietà del contratto di abbonamento e del relativo ciclo di fatturazione, usa l'oggetto subscription_contract_billing_cycle
.
Esempio
Risultato:
Proprietà
Proprietà | Descrizione |
---|---|
status |
Lo stato del contratto. Uno tra active , paused , cancelled , failed , expired , stale .
|
delivery_method |
Il metodo di consegna dell'abbonamento. Se l'abbonamento si riferisce a un servizio o un prodotto digitale, allora nilviene restituito. |
billing_frequency | La frequenza con la quale viene addebitato il costo dell'abbonamento. |
delivery_frequency | La frequenza con cui viene consegnato l'abbonamento. |
origin_order |
L'ordine originale che ha creato per la prima volta l'abbonamento. Se l'abbonamento non è stato creato da un ordine Shopify, viene restituito nil .
|
customer | Il cliente in abbonamento. |
line_items | Le voci del ciclo di fatturazione dell'abbonamento. |
product_names | Un elenco dei nomi dei prodotti inclusi nel ciclo di fatturazione dell'abbonamento. |
update_payment_method_url | L'URL che il cliente può usare per aggiornare il metodo di pagamento per questo contratto. |
shipping_address |
L'indirizzo di spedizione dell'abbonamento. Se l'abbonamento si riferisce a un servizio o un prodotto digitale, viene restituito nil .
|
billing_address | L'indirizzo di fatturazione dell'abbonamento. |
subtotal_price | Il prezzo subtotale delle voci dell'abbonamento. |
shipping_price | Il prezzo di spedizione dell'abbonamento. |
total_tax | L'imposta totale dell'abbonamento. |
total_price | Il prezzo totale dell'abbonamento. |
total_discounts | Gli sconti totali dell'abbonamento. |
customer_self_serve_url | L'URL self-service che il cliente può utilizzare per gestire gli abbonamenti. |
billing_attempt_expected_date | La data di fatturazione di questo ciclo di fatturazione. |
next_billing_date | La prossima data di fatturazione non saltata dopo questo ciclo di fatturazione. |
last_attempted_billing_date | La data dell'ultimo tentativo di fatturazione per il ciclo di fatturazione. |
days_overdue | Il numero di giorni di ritardo per la fatturazione di questo ciclo di fatturazione. |
payment_instrument | Lo strumento di pagamento associato al contratto di abbonamento. Questo strumento di pagamento viene usato per addebitare il prezzo dell'abbonamento al cliente. |
Proprietà delle voci del contratto di abbonamento
Le proprietà di ogni voce inclusa nel ciclo di fatturazione. Accedi alle proprietà delle voci del contratto tramite la proprietà principale subscription_contract_billing_cycle.line_items
.
Esempio
Proprietà | Descrizione |
---|---|
url | L'URL che indirizza alla pagina dei dettagli del prodotto per la variante di prodotto della voce. |
requires_shipping | Se la voce si riferisce a un articolo che richiede la spedizione fisica. |
unit_price_measurement | La misura del prezzo unitario dell'articolo. |
selling_plan_allocation | L'allocazione del piano di vendita dell'articolo. |
Proprietà del metodo di consegna del contratto di abbonamento
Le proprietà del metodo di consegna usato in questo ciclo di fatturazione. Accedi alle proprietà del metodo di consegna tramite la proprietà principale subscription_contract_billing_cycle.delivery_method
.
Esempio
Proprietà | Descrizione |
---|---|
title | Il titolo dell'opzione di spedizione associata al metodo di consegna. |
type |
Il tipo di metodo di consegna. Uno tra shipping , local o pick-up .
|
Proprietà dello strumento di pagamento per il contratto di abbonamento
Dettagli sullo strumento di pagamento per il contratto di abbonamento. Questo strumento di pagamento viene usato per addebitare il prezzo dell'abbonamento al cliente. Accedi alle proprietà del strumento di pagamento tramite la proprietà principale subscription_contract_billing_cycle.payment_instrument
.
Esempio
Proprietà | Descrizione |
---|---|
payment_type |
Il tipo di metodo di pagamento costituito dallo strumento di pagamento. Usa i filtri di pagamento per generare l'URL di un'immagine o il relativo file SVG. |
credit_card_brand | Il brand della carta di credito. |
credit_card_company | Il nome dell'istituto che ha emesso la carta di credito. |
credit_card_last_four_digits | Le ultime quattro cifre della carta di credito. |
Proprietà "notifiche via email"
Proprietà | Descrizione |
---|---|
shop.email_logo_url | L'URL del logo specificato nella sezione Personalizza modelli di email del pannello di controllo. |
shop.email_logo_width | La larghezza del logo (pixel) specificato nella sezione Personalizza modelli di email del pannello di controllo. |
shop.email_accent_color | Il codice HEX per il colore in risalto specificato nella sezione Personalizza modelli di email del pannello di controllo. |