Referință variabile de notificare
Notificările trimise din magazinul dumneavoastră sunt redate folosind Liquid. Liquid este limbajul de programare simplu și ușor de utilizat de la Shopify. Este același limbaj de programare pe care sunt construite temele din Theme Store.
Pentru a edita notificările trimise din magazinul dumneavoastră, puteți efectua personalizări de bază la șabloanele de notificare. Pentru a accesa lista completă a notificărilor pe care le puteți personaliza, accesați pagina Notificări din panoul de administrare Shopify.
Pentru ajutor cu modificări mai avansate sau pentru a face modificări la șabloanele de notificare personalizate, puteți contacta comunitatea de pe forumurile noastre sau puteți angaja un partener Shopify care să efectueze personalizările pentru dumneavoastră. Aflați mai multe despre angajarea unui partener Shopify.
Pe această pagină
- Proprietăți comandă
- Proprietăți comandă preliminară
- Proprietăți program de plată
- Proprietăți stare plată
- Proprietăți componentă pachet
- Proprietăți componentă
- Proprietăți articol de linie
- Proprietăți grup de articole de linie
- Proprietăți rambursări
- Proprietăți onorare comandă
- Proprietăți pachet pregătit
- Proprietăți livrare
- Proprietăți reducere
- Proprietăți abonament
- Proprietăți notificare prin e-mail
- Proprietăți credit magazin
Proprietăți comandă
Multe proprietăți ale unei comenzi sunt disponibile direct prin Liquid și în șabloane.
| Proprietate | Descriere |
|---|---|
id |
Un ID unic la nivel de sistem al comenzii pentru uz intern. Utilizați exemplul următor pentru a genera un link către comandă în secțiunea de administrare a magazinului dumneavoastră. De exemplu, în șablonul dumneavoastră Comandă nouă, puteți adăuga următorul cod: Vizualizare comandă
|
email | E-mailul asociat comenzii. |
name |
De obicei, acesta este un simbol diez urmat de Exemplu: #1004 |
order_name | La fel ca name. |
order_number |
Numărul unic al comenzii în magazin, fără prefixul diez #, sau orice prefix sau sufix adăugat la ID-ul comenzii de către proprietarul magazinului în preferințele magazinului său. Exemplu: 1004 |
confirmation_number | Un identificator alfanumeric generat aleatoriu pentru comandă, care ar putea fi afișat clientului în locul denumirii secvențiale a comenzii. Nu se garantează că această valoare este unică. Exemplu: XPAV284CT |
created_at |
Data și ora la care clientul a creat comanda. Puteți formata acest lucru folosind filtrul de dată. Exemplu: 2009-05-30T17:43:51+02:00 |
payment_terms |
Condițiile de plată specifică data la care plata pentru o comandă este scadentă. Aflați cum să adăugați condițiile de plată la facturile comenzilor. Pentru mai multe detalii, consultați referința Liquid pentru payment_terms. |
destination | Destinația la care trebuie trimise articolele. |
tags | Returnează o matrice cu toate etichetele comenzii. Etichetele sunt returnate în ordine alfabetică. Este posibil ca etichetele care sunt aplicate dinamic de app-uri sau de funcțiile platformei, cum ar fi eticheta Shopify Collective, să nu fie disponibile la generarea e-mailului de notificare. Pentru a detecta articole asociate unei anumite funcții, verificați în schimb etichetele la nivel de produs pentru fiecare rând. Consultați documentația de referință Liquid pentru mai multe detalii. |
transactions | Returnează o matrice de tranzacții din comandă. |
tax_price | Taxele combinate pentru toate articolele din comandă. |
tax_lines |
Taxe defalcate în funcție de tipul de impozitare:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Numele taxei. De exemplu, QST sau TVA. |
tax_line.price | Valoarea taxei. |
tax_line.rate | Cota de impozitare ca zecimală. Va returna 0,175 dacă este de 17,5 %. |
tax_line.rate_percentage | Cota de impozitare în format lizibil. Va returna 17,5 dacă cota este 0,175. |
customer | Obiect client care conține atributele rezultatului client. |
billing_address | Adresa de facturare. |
billing_address.first_name | Prenumele clientului. |
billing_address.last_name | Numele de familie al clientului. |
billing_address.company | Numele societății pentru facturare. |
billing_address.phone | Numărul de telefon de pe adresa de facturare. |
shop.name | Numele magazinului dvs. |
shop.phone | Numărul de telefon al magazinului dvs. |
subtotal_price | Suma prețurilor rândurilor din comandă, după deducerea oricărei reduceri de rând sau de coș. Subtotalul nu include taxele (cu excepția cazului în care taxele sunt incluse în prețuri), costurile de transport sau bacșișurile. |
discounts | O listă de reduceri. |
discounts_amount | Valoarea reducerii aplicate de toate reducerile. Exemplu: +5,00 $ |
discounts_savings | Valoarea economiilor realizate datorită tuturor reducerilor. Exemplu: -5,00 $ |
total_price |
Totalul comenzii (subtotal + cost de transport - reducere de transport + taxă). |
financial_status | Starea actuală a plății. Una dintre: nil, pending, authorized, paid, voided, refunded. |
requires_shipping | (boolean) Returnează true dacă există cel puțin un articol în comandă care necesită expediere. |
shipping_method.title | Denumirea tarifului de transport. În notificările pentru clienți, denumirea tarifului de transport este tradusă în limba în care clientul a finalizat comanda, atunci când limba este diferită de limba implicită a magazinului. Exemplu: Expediere standard |
shipping_method.price |
Prețul de transport incluzând orice reducere de transport. Exemplu: |
shipping_price |
Prețul de transport. Exemplu: |
shipping_address | Adresa de livrare. |
shipping_address.first_name | Prenumele pentru adresa de livrare. |
shipping_address.company | Numele societății pentru adresa de livrare. |
shipping_address.phone | Numărul de telefon de la adresa de livrare. |
line_items | Lista tuturor rândurilor din comandă. |
line_items_including_zero_quantity | Lista tuturor rândurilor din comandă, inclusiv cele cu cantitate zero. Rândurile au cantitate zero atunci când sunt rambursate integral. |
line_item_groups(Orders and POS only) | Lista tuturor grupurilor de rânduri care conțin componente de rând în comandă. |
item_count | O sumă a tuturor cantităților articolelor. |
fulfillment_status | Starea curentă de onorare a comenzii. Una dintre: unfulfilled, partial, fulfilled. |
note | Nota care este atașată comenzii. Nota poate fi obținută de la client și/sau editată în ecranul cu detaliile comenzii din interfața dvs. de administrare. |
attributes |
Orice atribute care au fost atașate comenzii. Exemplu: |
metafields |
Orice metacâmpuri din comandă. Utilizați următoarea sintaxă: metafields.NAMESPACE.KEY |
referring_site |
Conține URL-ul sursei care a adus clientul în magazinul dvs. Exemplu: |
landing_site |
Conține calea paginii de destinație pe care a folosit-o clientul. Aceasta este prima pagină pe care a văzut-o clientul când a ajuns în magazin. Exemplu: |
landing_site_ref |
Examinează pagina de destinație și extrage un parametru de referință din aceasta. Parametrii de referință pot fi: Dacă
{% if landing_site_ref == 'my-tracking-token' %}
Acțiunea mea...
{% endif %}
|
cancelled | (boolean) Returnează true dacă comanda a fost anulată. |
cancelled_at | Ora la care a fost anulată comanda. |
cancel_reason | Motivul selectat la anularea comenzii. Unul dintre: inventory, customer, declined, fraud sau other. |
has_high_risks?(deprecated) | Returnează true dacă comanda are un risc ridicat |
unique_gateways |
Returnează o listă de furnizori unici de servicii de plată pentru o comandă. De exemplu, dacă cineva a plătit cu un card Visa, un Mastercard și numerar, atunci lista returnată va fi |
location(POS only) |
Afișează locația fizică a comenzii. Sunt disponibile mai multe proprietăți de locație, listate aici. Puteți configura locațiile în zona Locații din panoul de administrare. |
order_status_url |
Returnează linkul către pagina de stare a comenzii pentru această comandă. |
fulfilled_line_items(deprecated) | Listă de rânduri care au fost executate. |
unfulfilled_line_items(deprecated) | Listă de rânduri care nu au fost executate complet. |
b2b? |
Returnează „true” dacă este o comandă B2B. Utilizați proprietatea cu variabile B2B pentru a afișa informații relevante, cum ar fi numele societății, locația companiei și adresa în e-mailuri. De exemplu, în cazul comenzilor B2B, puteți adăuga un antet la un șablon cu următoarele informații:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Societatea căreia îi vindeți în cadrul unei comenzi B2B. |
company.name | Numele societății dintr-o comandă B2B. |
company.id | ID-ul societății dintr-o comandă B2B. |
company_location | Locația societății dintr-o comandă B2B. O societate care cumpără de la dumneavoastră poate avea mai mult de o locație. |
company_location.name | Numele locației companiei dintr-o comandă B2B. |
company_location.id | Numărul ID al locației companiei dintr-o comandă B2B. |
company_location.shipping_address | Adresa de livrare a locației companiei dintr-o comandă B2B. |
company_location.billing_address | Adresa de facturare a locației companiei dintr-o comandă B2B. |
customer_order_url | Noua pagină de stare a comenzii a unei comenzi pentru care un client a solicitat un retur folosind conturile de client. |
Proprietăți comandă provizorie
| Proprietate | Descriere |
|---|---|
id | Un ID unic al comenzii provizorii pentru uz intern. |
invoice_url | Un link pe care clientul îl poate accesa pentru a plăti factura, utilizând plata securizată Shopify. |
reserve_inventory_until |
Data și ora până la care sunt rezervate rândurile din comanda provizorie, de exemplu, Puteți formata datele folosind filtrul de dată Liquid. |
user | Ultimul membru al personalului care a modificat comanda provizorie. |
user.name | Numele ultimului membru al personalului care a modificat comanda provizorie. |
user.email | Adresa de e-mail a ultimului membru al personalului care a modificat comanda provizorie. |
email | Adresa de e-mail asociată comenzii provizorii. |
name | Unicul number al comenzii provizorii, prefixat de simbolul numeric #. |
number | Numărul unic al comenzii provizorii fără prefixul sau sufixul comenzii. |
created_at |
Data și ora la care clientul a creat comanda provizorie, de exemplu, Puteți formata datele folosind filtrul de dată Liquid. |
tags | Returnează o matrice cu toate etichetele comenzii. Etichetele sunt returnate în ordine alfabetică. Consultați documentația de referință Liquid pentru mai multe detalii. |
tax_price | Taxele combinate ale tuturor articolelor din comanda provizorie. |
tax_lines |
Taxe defalcate pe tip de taxă:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Numele taxei. Exemple: QST sau TVA |
tax_line.price | Valoarea taxei. |
tax_line.rate | Cota de impozitare în formă zecimală. De exemplu, o cotă de impozitare de 17,5% va returna 0,175. |
tax_line.rate_percentage | Cota de impozitare în formă procentuală. De exemplu, o rată de 0,175 va returna 17,5. |
customer | Obiect client care conține atributele rezultatului client. |
billing_address | Adresa de facturare pentru comanda provizorie. |
billing_address.first_name | Prenumele clientului. |
billing_address.last_name | Numele de familie al clientului. |
billing_address.company | Numele societății din adresa de facturare. |
billing_address.phone | Numărul de telefon din adresa de facturare. |
shop.name | Numele magazinului dumneavoastră. |
shop.phone | Numărul de telefon al magazinului dvs. |
subtotal_price | Suma prețurilor rândurilor comenzii provizorii după deducerea oricărei reduceri pe rând sau reduceri pentru coș. Subtotalul nu include taxele (cu excepția cazului în care taxele sunt incluse în prețuri) sau costurile de transport. |
discounts | O listă de reduceri. |
discounts_amount | Valoarea reducerii aplicate de toate reducerile. Exemplu: +5,00 $ |
discounts_savings | Valoarea economiilor generate de toate reducerile. Exemplu: -5,00 $ |
total_price | Prețul total al comenzii (subtotal + cost de transport - reducere de transport + taxă). |
amount_due_now | Suma solicitată prin factura comenzii provizorii. |
requires_shipping | Returnează true dacă există cel puțin un articol în comanda provizorie care necesită expediere. Returnează false dacă niciun articol din comanda provizorie nu necesită expediere. |
shipping_method.title | Numele tarifului de transport. Exemplu: Expediere standard |
shipping_method.price | Prețul metodei de transport. Returnează aceeași informație ca shipping_price. |
shipping_price |
Prețul de transport. Puteți formata această sumă folosind filtrele de bani Liquid. |
shipping_address |
Notă: spre deosebire de comenzile obișnuite, adresa de livrare a unei comenzi provizorii ar putea fi incompletă. |
shipping_address.first_name | Prenumele pentru adresa de livrare. |
shipping_address.company | Numele societății din adresa de livrare. |
shipping_address.phone | Numărul de telefon din adresa de livrare. |
line_items | O listă cu toate rândurile din comanda provizorie. |
item_count | O sumă a tuturor cantităților de articole din comanda provizorie. |
note | Nota atașată comenzii provizorii. Nota poate fi obținută de la client și, de asemenea, editată în ecranul de detalii al comenzii provizorii din panoul de administrare Shopify. |
metafields |
Orice metacâmpuri ale comenzii provizorii. Utilizați următoarea sintaxă: metafields.NAMESPACE.KEY |
location |
Locația fizică a comenzii. Sunt disponibile mai multe proprietăți de locație. Puteți configura locațiile în pagina Locații a panoului de administrare Shopify. |
b2b? |
Returnează „true” dacă este o comandă B2B. Utilizați proprietatea cu variabile B2B pentru a afișa informații relevante, cum ar fi numele societății, locația companiei și adresa în e-mailuri. De exemplu, în cazul comenzilor B2B, puteți adăuga un antet la un șablon cu următoarele informații:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Societatea căreia îi vindeți în cadrul unei comenzi B2B. |
company.name | Numele societății dintr-o comandă B2B. |
company.id | ID-ul societății dintr-o comandă B2B. |
company_location | Locația societății dintr-o comandă B2B. O societate care cumpără de la dumneavoastră poate avea mai mult de o locație. |
company_location.name | Numele locației companiei dintr-o comandă B2B. |
company_location.id | Numărul ID al locației companiei dintr-o comandă B2B. |
company_location.shipping_address | Adresa de livrare a locației companiei dintr-o comandă B2B. |
company_location.billing_address | Adresa de facturare a locației companiei dintr-o comandă B2B. |
payment_methods | O listă cu metodele de plată salvate disponibile pentru a procesa totalul comenzii provizorii. |
payment_method.payment_instrument | Instrumentul de plată, care conține detalii despre metoda de plată salvată. |
payment_method.payment_instrument.payment_type | Tipul metodei de plată salvate. De ex., „credit_card, apple_pay” |
payment_method.payment_instrument.credit_card_brand | Marca cardului, atunci când `payment_type` este „credit_card” |
payment_method.payment_instrument.credit_card_company | Societatea emitentă a cardului, atunci când `payment_type` este „credit_card” |
payment_method.payment_instrument.credit_card_company | Ultimele 4 cifre ale cardului, atunci când `payment_type` este „credit_card” |
Proprietăți plan de plăți
| Proprietate | Descriere |
|---|---|
payment_schedule.amount_due |
Suma de plată pentru un plan de plăți. Puteți formata sumele monetare folosind filtrul de bani Liquid. |
payment_schedule.due_at |
Data scadentă pentru planul de plăți. Puteți formata datele folosind filtrul de dată Liquid. |
payment_schedule.due_in_days |
Numărul de zile până la data scadentă, în cazul în care planul de plăți este încă scadent (neplătit). |
payment_schedule.due_later? |
Returnează „true” dacă un plan de plăți nu a fost achitat și data sa scadentă este în viitor. |
payment_schedule.number_of_days_overdue? |
Numărul de zile de la data scadentă atunci când un plan de plăți este restant. |
payment_schedule.overdue? |
Returnează „true” dacă un plan de plăți nu a fost achitat și a depășit data scadentă. |
Proprietăți stare plată
| Proprietate | Descriere |
|---|---|
has_pending_payment |
(boolean) Returnează „true” dacă comanda are o tranzacție cu o plată în așteptare. Aflați mai multe despre plățile în așteptare. |
buyer_action_required |
(boolean) Returnează „true” dacă o comandă are o tranzacție cu o plată în așteptare și este necesară o acțiune din partea cumpărătorului pentru a debloca plata. Atunci când această valoare returnează „true” și metoda de plată acceptă instrucțiuni de plată, Aflați mai multe despre obiectul tranzacție Liquid. |
Proprietăți componentă pachet
Fiecare bundle_component din lista line_item.bundle_components are următoarele proprietăți. (Doar comenzi provizorii)
| Proprietate | Descriere |
|---|---|
bundle_component.image_url | URL-ul imaginii componentei pachetului. |
bundle_component.product.title | Titlul produsului componentei pachetului. |
bundle_component.quantity | Cantitate pentru componenta pachetului. |
bundle_component.variant.title | Numele curente ale valorilor opțiunilor variantei componentei pachetului, unite prin caractere Exemplu: mic / roșu |
Proprietăți componentă
Fiecare component din lista line_item.components are următoarele proprietăți. (Doar la plata abandonată)
`
| Proprietate | Descriere |
|---|---|
component.image_url | URL-ul imaginii componentei. |
component.product.title | Titlul produsului componentei. |
component.quantity | Cantitate pentru componentă. |
component.variant.title | Numele curente ale valorilor opțiunilor variantei componentei, unite prin caractere Exemplu: mic / roșu |
Proprietăți rând
Fiecare line din lista line_items sau subtotal_line_items are următoarele proprietăți.
| Proprietate | Descriere |
|---|---|
line.applied_discounts(POS and draft orders only) | Lista de reduceri aplicate acestui articol (fiecare reducere are proprietățile title, code, amount, savings și type). |
line.bundle_components(Draft orders only) | Listă de rânduri care sunt componente de pachet ale acestui articol. Returnează o listă numai dacă acest rând este un produs pachet. |
line.bundle_parent?(Draft orders only) | (boolean) Returnează „true” dacă rândul este un produs pachet. |
line.components(Abandoned checkout only) | Listă de rânduri care sunt componente ale acestui articol. |
line.parent?(Abandoned checkout only) | (boolean) Returnează „true” dacă rândul are componente. |
line.custom(Draft orders only) | (boolean) Returnează „true” dacă articolul este un rând personalizat pentru o comandă provizorie. |
line.delivery_agreement | Acordul de livrare asociat cu acest rând. |
line.grams | Greutatea unui singur articol. |
line.groups | Grupul de rânduri al articolului. |
line.image | Returnează URL-ul imaginii asociate acestui rând. De asemenea, puteți utiliza filtrul img_url pentru a obține dimensiuni specifice ale imaginii, de exemplu {{ line.image | img_url: 'small' }} |
line.line_price | Prețul înmulțit cu cantitatea pentru articolul respectiv. |
line.original_line_price | Prețul cumulat al articolelor din rând, înainte de aplicarea reducerilor. |
line.final_line_price | Prețul cumulat al tuturor articolelor din rând, incluzând toate sumele reducerilor la nivel de rând. |
line.pre_tax_price | Prețul fără taxe al rândului, înmulțit cu cantitatea achiziționată. |
line.price | Prețul pentru un singur articol. |
line.product.metafields | Orice metacâmpuri la nivel de produs. Utilizați următoarea sintaxă: line.product.metafields.NAMESPACE.KEY |
line.product.title | Numele curent al produsului. |
line.product.vendor | Vânzătorul articolului. |
line.properties | Returnează o matrice de informații personalizate pentru un articol. Proprietățile rândului sunt specificate de client pe pagina de produs, înainte de a adăuga un produs în coș. |
line.quantity | Cantitate pentru acel articol. |
line.current_quantity | Cantitatea curentă a articolului după eliminări. |
line.requires_shipping | (boolean) Returnează „true” dacă varianta articolului are setarea Produs fizic activată pe pagina de produs. |
line.selling_plan_allocation | Returnează un obiect selling_plan_allocation, care descrie modul în care un plan de vânzări, cum ar fi un abonament, afectează rândul. |
line.taxable | (boolean) Returnează „true” dacă varianta articolului are caseta de selectare „Percepeți taxe pentru acest produs” bifată pe pagina de produs. |
line.title | Numele produsului la momentul vânzării, urmat de o cratimă și de numele variantei la momentul vânzării. Numele variantei nu este inclus atunci când este un „Titlu implicit”. În notificările pentru clienți, numele produsului și numele variantei sunt traduse în limba în care clientul a efectuat plata, atunci când limba este diferită de limba implicită a magazinului. |
line.url | URL-ul relativ al variantei rândului. URL-ul relativ nu include URL-ul rădăcină al magazinului dumneavoastră (mystore.myshopify.com). |
line.variant.barcode | Codul de bare asociat cu varianta de produs. |
line.variant.compare_at_price | Prețul de comparație asociat cu varianta de produs. |
line.variant.image | Imaginea pentru varianta de produs. Returnează o imagine doar dacă variantei îi este atribuită o imagine specifică în rând. |
line.variant.metafields | Orice metacâmpuri la nivel de variantă. Utilizați următoarea sintaxă: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku | Numărul de inventar asociat cu varianta de produs. |
line.variant.title | Numele curente ale valorilor opțiunilor variantei, unite prin caractere Exemplu: mic / roșu |
line.refunded.quantity(within refund notifications) | Cantitatea unui articol de restituit. Puteți utiliza această proprietate pentru a adăuga un identificator articolelor restituite dintr-o comandă. De exemplu: |
Detectarea articolelor Shopify Collective în șabloanele de notificare
Eticheta Shopify Collective este aplicată unei comenzi după trimiterea e-mailului de confirmare a comenzii, așadar {% if tags contains 'Shopify Collective' %} nu este niciodată true într-un șablon de confirmare a comenzii. Pentru a detecta articolele Shopify Collective, verificați în schimb etichetele la nivel de produs de pe fiecare rând:
{% 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 %}Proprietățile grupului de rânduri
Fiecare line_item_group din lista de line_item_groups are următoarele proprietăți.
| Proprietate | Descriere |
|---|---|
line_item_group.display_title | Titlul grupului de rânduri. |
line_item_group.components | Listă de componente de rând care aparțin grupului. |
line_item_group.image | Imaginea grupului de rânduri. |
line_item_group.product_id | ID-ul de produs al grupului de rânduri. |
line_item_group.variant | Obiectul variantă al grupului de rânduri. |
line_item_group.variant_id | ID-ul de variantă al grupului de rânduri. |
Proprietăți restituiri
| Proprietate | Descriere |
|---|---|
amount | Suma de bani restituită. |
refund_line_items | O listă cu rândurile de articole de restituit. |
Proprietăți rând de restituire
Fiecare refund_line din lista de refund_line_items are următoarele proprietăți:
| Proprietate | Descriere |
|---|---|
refund_line.line_item | Rândul de articol care este restituit. Acesta are acces la toate proprietățile rândului de articol. |
refund_line.quantity | Cantitatea rândului de rambursat. |
Proprietăți onorare comandă
| Proprietate | Descriere |
|---|---|
service_name | Numele serviciului personalizat, așa cum este definit în pagina Setări > Expediere și livrare. (Doar pentru solicitarea de procesare) |
fulfillment.estimated_delivery_at | O dată de livrare estimată, pe baza numărului de urmărire (dacă este disponibil) furnizat de unul dintre următorii transportatori: USPS, FedEx, UPS, Canada Post (doar în Canada). Această proprietate este disponibilă numai atunci când sunt utilizate tarifele calculate de transportator. |
fulfillment.fulfillment_line_items | O listă de rânduri de articole de onorat. |
fulfillment.item_count | O sumă a cantităților tuturor articolelor. Numărul total de articole care sunt onorate. |
fulfillment.requires_shipping | (boolean) Returnează „adevărat” dacă această solicitare de onorare a comenzii necesită expediere. |
fulfillment.tracking_company | Compania care efectuează urmărirea. |
fulfillment.tracking_numbers | O listă de numere de urmărire. |
fulfillment.tracking_urls | O listă de URL-uri de urmărire. |
items_to_fulfill(deprecated) | O listă de rânduri care trebuie onorate de acest serviciu personalizat de execuție a comenzii. (Doar pentru solicitarea de onorare a comenzii) |
items_to_fulfill_count(deprecated) | Numărul total de articole de onorat prin această solicitare. (Doar pentru solicitarea de onorare a comenzii) |
Proprietăți rând de onorare a comenzii
Fiecare fulfillment_line din lista de fulfillment_line_items are următoarele proprietăți.
| Proprietate | Descriere |
|---|---|
fulfillment_line.line_item | Rândul de articol care este onorat. Acesta are acces la toate proprietățile rândului de articol. |
fulfillment_line.quantity | Cantitatea rândului de articol care este onorat. |
Proprietăți pachet pregătit
Un pachet pregătit include articolele marcate ca fiind gata de ridicare.
| Proprietate | Descriere |
|---|---|
item_count | O sumă a tuturor cantităților de articole din pachetul pregătit. |
prepared_package_line_items | O listă de rânduri de articole din pachetul pregătit. |
Proprietăți rând de articol din pachetul pregătit
Fiecare prepared_package_line_item din lista de prepared_package_line_items are următoarele proprietăți.
| Proprietate | Descriere |
|---|---|
line_item | Rândul de articol asociat. Acesta are acces la toate proprietățile rândului de articol. |
quantity | Cantitatea rândului de articol care a fost marcat ca fiind gata de ridicare. |
Proprietăți livrare
| Proprietate | Descriere |
|---|---|
delivery_agreements | Lista tuturor acordurilor de livrare pentru comandă. |
delivery_instructions | Informații despre expedierea locală de partajat cu clientul. Aceste informații sunt controlate de câmpul Informații despre livrare din setările pentru expediere locală. |
consolidated_estimated_delivery_time | Informații despre datele de livrare ale comenzii, de partajat cu clientul. Aceste informații sunt controlate de setarea Timp de procesare pe care ați configurat-o în pagina Expediere și livrare. Atunci când comanda are mai multe metode de livrare, este afișată o listă cu metodele și datele de livrare. |
has_multiple_delivery_methods | (boolean) Returnează „adevărat” dacă comanda are mai multe metode de livrare. |
Proprietăți acord de livrare
| Proprietate | Descriere |
|---|---|
delivery_agreement.delivery_method_type | Tipul metodei de livrare. |
delivery_agreement.delivery_method_name | Tipul metodei de livrare, tradus în limba în care cumpărătorul a finalizat comanda, atunci când limba este diferită de limba implicită a magazinului. |
delivery_agreement.line_item_groups | Lista tuturor grupurilor de rânduri care conțin componente de rând la pachet în acordul de livrare. |
delivery_agreement.line_items | Lista tuturor rândurilor asociate cu acest acord de livrare. |
Proprietăți reducere
Există două tipuri de proprietăți de reducere.
discount_applications descriu de ce și cum a fost redus un articol.
discount_allocations descriu modul în care o anumită reducere afectează un rând și cum reduce prețul. Trebuie să utilizați această proprietate la nivelul rândului.
Puteți combina aceste proprietăți pentru a afișa informațiile despre reducere la nivel de rând sau de comandă.
Exemplu
Acest exemplu verifică dacă s-a aplicat o reducere la rând. Dacă reducerea nu a fost aplicată la nivel de comandă (all), atunci se afișează numele și valoarea reducerii.
{% 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 %}Rezultatul ar putea fi similar cu acesta:
SPRING5 (-$5.00)Proprietăți Discount_allocation
Fiecare discount_allocation din lista discount_allocations are următoarele proprietăți.
| Proprietate | Descriere |
|---|---|
discount_allocation.amount | Suma de bani economisită de client la un rând. Trebuie introdusă într-o buclă dacă doriți să permiteți mai multe coduri de reducere. |
discount_allocation.discount_application | Aplicația de reducere care alocă suma pe rând. |
Proprietăți Discount_application
Fiecare discount_application din lista discount_applications are următoarele proprietăți.
| Proprietate | Descriere |
|---|---|
discount_application.target_selection |
Descrie modul în care o reducere selectează rândurile din coș care urmează a fi reduse. Una dintre:
|
discount_application.target_type | Tipul de articol căruia i se aplică o reducere (line_item sau shipping_line). |
discount_application.title | Numele reducerii vizibil pentru client. Exemple: Welcome10 sau CBBWQQAKYBYY |
discount_application.total_allocated_amount | Suma totală cu care prețul unei comenzi este redus prin aplicarea reducerii. |
discount_application.type | Tipul reducerii. Unul dintre: automatic, discount_code, manual sau script. |
discount_application.value | Valoarea reducerii. |
discount_application.value_type | Tipul valorii reducerii. Unul dintre: fixed_amount sau percentage. |
Proprietăți de abonament
Detaliile unui contract de abonare, ciclul de facturare curent și rândurile, metoda de livrare și metoda de plată ale acestuia sunt disponibile pentru toate șabloanele de e-mail de abonament.
Pentru a edita șabloanele de notificare pentru abonamente, instalați aplicația Shopify Subscriptions, apoi găsiți șablonul în Setări > Notificări, în secțiunea Abonamente.
Proprietățile ciclului de facturare al contractului de abonare
Pentru a accesa proprietățile contractului de abonare și ale ciclului său de facturare, utilizați obiectul subscription_contract_billing_cycle.
Exemplu
{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.Rezultat:
This contract is currently paused.Proprietăți
| Proprietate | Descriere |
|---|---|
status |
Starea contractului. Una dintre: active, paused, cancelled, failed, expired, stale,
|
delivery_method |
Metoda de livrare a abonamentului. Dacă abonamentul este pentru un serviciu sau produs digital, atunci se returnează nil.
|
billing_frequency | Cât de des este facturat abonamentul. |
delivery_frequency | Cât de des este expediat abonamentul. |
origin_order |
Comanda inițială care a creat abonamentul. Dacă abonamentul nu a fost creat dintr-o comandă Shopify, atunci se returnează nil.
|
customer | Clientul abonamentului. |
line_items | Rândurile din ciclul de facturare al abonamentului. |
product_names | O listă a denumirilor produselor incluse în ciclul de facturare al abonamentului. |
update_payment_method_url | URL-ul pe care clientul îl poate utiliza pentru a actualiza metoda de plată pentru acest contract. |
shipping_address |
Adresa de livrare a abonamentului. Dacă abonamentul este pentru un serviciu sau produs digital, atunci se returnează nil.
|
billing_address | Adresa de facturare a abonamentului. |
subtotal_price | Prețul subtotal al rândurilor abonamentului. |
shipping_price | Prețul de expediere al abonamentului. |
total_tax | Taxa totală a abonamentului. |
total_price | Prețul total al abonamentului. |
total_discounts | Reducerile totale ale abonamentului. |
customer_self_serve_url | URL-ul de autoservire pe care clientul îl poate utiliza pentru a-și gestiona abonamentele. |
billing_attempt_expected_date | Data de facturare pentru acest ciclu de facturare. |
next_billing_date | Următoarea dată de facturare neomisă după acest ciclu de facturare. |
last_attempted_billing_date | Ultima dată de facturare încercată pentru ciclul de facturare. |
days_overdue | Numărul de zile de întârziere la plată pentru acest ciclu de facturare. |
payment_instrument | Instrumentul de plată asociat cu contractul de abonare. Acest instrument de plată este utilizat pentru a factura clientul. |
Proprietățile rândului din contractul de abonare
Proprietățile pentru fiecare rând inclus în ciclul de facturare. Accesați proprietățile rândului din contract prin proprietatea părinte subscription_contract_billing_cycle.line_items.
Exemplu
{% for line_item in subscription_contract_billing_cycle.line_items %}
{{ line_item.url }}
{% endfor %}| Proprietate | Descriere |
|---|---|
url | URL-ul către pagina de detalii a variantei de produs de pe rând. |
requires_shipping | Dacă rândul necesită expediere fizică. |
unit_price_measurement | Măsurarea prețului unitar al rândului. |
selling_plan_allocation | Alocarea planului de vânzare a rândului. |
Proprietățile metodei de livrare a contractului de abonare
Proprietățile pentru metoda de livrare utilizată în acest ciclu de facturare. Accesați proprietățile metodei de livrare prin proprietatea părinte subscription_contract_billing_cycle.delivery_method.
Exemplu
{% if subscription_contract_billing_cycle.delivery_method != blank %}
Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}| Proprietate | Descriere |
|---|---|
title | Titlul opțiunii de expediere asociate cu metoda de livrare. |
type |
Tipul metodei de livrare. Una dintre expediere, locală sau ridicare.
|
Proprietățile instrumentului de plată din contractul de abonare
Detalii despre instrumentul de plată pentru contractul de abonare. Acest instrument de plată este utilizat pentru a factura clientul. Accesați proprietățile instrumentului de plată prin proprietatea părinte subscription_contract_billing_cycle.payment_instrument.
Exemplu
{% 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 }}| Proprietate | Descriere |
|---|---|
payment_type |
Tipul metodei de plată reprezentat de instrumentul de plată. Utilizați filtrele de plată pentru a genera un URL de imagine sau un SVG. |
credit_card_brand | Brandul cardului de credit. |
credit_card_company | Numele societății emitente a cardului de credit. |
credit_card_last_four_digits | Ultimele 4 cifre ale cardului de credit. |
Proprietăți de notificare prin e-mail
| Proprietate | Descriere |
|---|---|
shop.email_logo_url | URL-ul pentru sigla specificată în secțiunea Personalizare șabloane de e-mail din panoul de administrare. |
shop.email_logo_width | Lățimea siglei (în pixeli) specificată în secțiunea Personalizare șabloane de e-mail din panoul de administrare. |
shop.email_accent_color | Codul HEX pentru culoarea de accent specificată în secțiunea Personalizare șabloane de e-mail din panoul de administrare. |
Proprietăți credit magazin
Proprietățile care conțin detalii despre emiterea unui credit magazin.
| Proprietate | Descriere |
|---|---|
issued_store_credit.amount |
Suma creditului de magazin care a fost emis. Puteți formata această sumă folosind filtrele de bani Liquid. |
issued_store_credit.expires_at |
Data și ora la care va expira creditul de magazin emis. Puteți formata această sumă utilizând filtrele de dată Liquid. |
issued_store_credit.balance_after_transaction |
Soldul contului de credit magazin după emiterea creditului. Puteți formata această sumă folosind filtrele de bani Liquid. |
customer | Obiect client care conține atributele rezultatului client. |