Pranešimų kintamųjų žinynas
Iš Jūsų parduotuvės siunčiami pranešimai atvaizduojami naudojant Liquid. „Liquid“ yra paprasta, lengvai naudojama „Shopify“ programavimo kalba. Tai ta pati programavimo kalba, kuria pagrįstos temos iš „Theme Store“.
Norėdami redaguoti iš Jūsų parduotuvės siunčiamus pranešimus, galite atlikti pagrindinius pritaikymus savo pranešimų šablonuose. Norėdami pasiekti visą pranešimų, kuriuos galite tinkinti, sąrašą, eikite į puslapį Pranešimai savo „Shopify“ administratoriaus skydelyje.
Jei reikia pagalbos atliekant sudėtingesnius pakeitimus arba keičiant tinkintus pranešimų šablonus, galite kreiptis į bendruomenę mūsų forumuose arba galite įdarbinti „Shopify“ partnerį, kad jis atliktų pritaikymus už Jus. Sužinokite daugiau apie „Shopify“ partnerio įdarbinimą.
Šiame puslapyje
- Užsakymo ypatybės
- Užsakymo juodraščio ypatybės
- Mokėjimų grafiko ypatybės
- Mokėjimo būsenos ypatybės
- Rinkinio komponentų ypatybės
- Komponentų ypatybės
- Užsakymo eilutės ypatybės
- Užsakymo eilučių grupės ypatybės
- Pinigų grąžinimo ypatybės
- Užsakymo įvykdymo ypatybės
- Paruoštos siuntos ypatybės
- Pristatymo ypatybės
- Nuolaidos ypatybės
- Prenumeratos ypatybės
- El. pašto pranešimų ypatybės
- Parduotuvės kredito ypatybės
Užsakymo ypatybės
Daugelis užsakymo ypatybių yra prieinamos tiesiogiai naudojant „Liquid“ ir šablonuose.
| Ypatybė | Aprašymas |
|---|---|
id |
Unikalus visos sistemos užsakymo ID, skirtas vidiniam naudojimui. Naudokite šį pavyzdį, norėdami sugeneruoti nuorodą į užsakymą savo parduotuvės administratoriaus skydelyje. Pavyzdžiui, savo Naujo užsakymo šablone galite pridėti šį kodą: Peržiūrėti užsakymą
|
email | El. pašto adresas, susietas su užsakymu. |
name |
Paprastai tai yra grotelių simbolis, po kurio eina Pavyzdys: #1004 |
order_name | Tas pats, kas „name“. |
order_number |
Unikalus parduotuvės užsakymo numeris be grotelių (#) priešdėlio arba bet kokio kito priešdėlio ar priesagos, kuriuos parduotuvės savininkas pridėjo prie užsakymo ID savo parduotuvės nuostatose. Pavyzdys: 1004 |
confirmation_number | Atsitiktinai sugeneruotas raidinis ir skaitmeninis užsakymo identifikatorius, kuris gali būti rodomas klientui vietoj nuoseklaus užsakymo pavadinimo. Nėra garantijos, kad ši vertė bus unikali. Pavyzdys: XPAV284CT |
created_at |
Data ir laikas, kada klientas sukūrė užsakymą. Jūs galite tai formatuoti naudodami datos filtrą. Pavyzdys: 2009-05-30T17:43:51+02:00 |
payment_terms |
Mokėjimo sąlygose nurodoma data, iki kurios turi būti apmokėtas užsakymas. Sužinokite, kaip pridėti mokėjimo sąlygas prie užsakymo sąskaitų faktūrų. Daugiau informacijos rasite „Liquid“ dokumentacijoje apie payment_terms. |
destination | Paskirties vieta, į kurią turi būti išsiųsti daiktai. |
tags | Grąžina visų užsakymo žymų masyvą. Žymos pateikiamos abėcėlės tvarka. Žymos, kurias dinamiškai pritaiko programėlės ar platformos funkcijos, pvz., Shopify Collective žyma, gali būti nepasiekiamos generuojant pranešimo el. laišką. Norėdami aptikti konkrečios funkcijos prekes, verčiau tikrinkite produkto lygio žymas kiekvienoje prekių pozicijoje. Daugiau informacijos rasite „Liquid“ informacinėje dokumentacijoje. |
transactions | Pateikia užsakymo operacijų masyvą. |
tax_price | Bendra visų užsakymo prekių mokesčių suma. |
tax_lines |
Mokesčiai, suskirstyti pagal apmokestinimo tipą:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Mokesčio pavadinimas. Pavyzdžiui, QST arba PVM. |
tax_line.price | Mokesčio suma. |
tax_line.rate | Mokesčio tarifas dešimtaine trupmena. Bus pateikta 0,175, jei tarifas yra 17,5 %. |
tax_line.rate_percentage | Mokesčio tarifas žmonėms suprantamu formatu. Bus pateikta 17,5, jei tarifas yra 0,175. |
customer | Kliento objektas, apimantis kliento išvesties atributus. |
billing_address | Sąskaitos pateikimo adresas. |
billing_address.first_name | Kliento vardas. |
billing_address.last_name | Kliento pavardė. |
billing_address.company | Įmonės pavadinimas sąskaitai. |
billing_address.phone | Telefono numeris iš sąskaitos pateikimo adreso. |
shop.name | Jūsų parduotuvės pavadinimas. |
shop.phone | Jūsų parduotuvės telefono numeris. |
subtotal_price | Užsakymo prekių pozicijų kainų suma, atskaičius bet kokią prekių pozicijos ar krepšelio nuolaidą. Į tarpinę sumą neįtraukiami mokesčiai (nebent mokesčiai įtraukti į kainas), pristatymo išlaidos ar arbatpinigiai. |
discounts | Nuolaidų sąrašas. |
discounts_amount | Bendra visų pritaikytų nuolaidų suma. Pavyzdys: +5,00 $ |
discounts_savings | Sutaupyta suma pritaikius visas nuolaidas. Pavyzdys: –5,00 $ |
total_price |
Bendra užsakymo suma (tarpinė suma + siuntimo kaina – siuntimo nuolaida + mokesčiai). |
financial_status | Dabartinė mokėjimo būsena. Viena iš: nil, pending, authorized, paid, voided, refunded. |
requires_shipping | (Loginė reikšmė) Pateikia „true“ reikšmę, jei užsakyme yra bent viena prekė, kurią reikia išsiųsti. |
shipping_method.title | Siuntimo tarifo pavadinimas. Klientams skirtuose pranešimuose siuntimo tarifo pavadinimas išverčiamas į kalbą, kuria klientas atsiskaitė, kai ta kalba skiriasi nuo numatytosios parduotuvės kalbos. Pavyzdys: standartinis pristatymas |
shipping_method.price |
Siuntimo kaina, įskaitant bet kokią siuntimo nuolaidą. Pavyzdys: |
shipping_price |
Siuntimo kaina. Pavyzdys: |
shipping_address | Pristatymo adresas. |
shipping_address.first_name | Pristatymo adrese nurodytas vardas. |
shipping_address.company | Pristatymo adrese nurodytas įmonės pavadinimas. |
shipping_address.phone | Telefono numeris iš pristatymo adreso. |
line_items | Visų užsakymo prekių pozicijų sąrašas. |
line_items_including_zero_quantity | Visų užsakymo prekių pozicijų sąrašas, įskaitant tas, kurių kiekis yra nulis. Prekių pozicijų kiekis yra nulis, kai už jas visiškai grąžinami pinigai. |
line_item_groups(Orders and POS only) | Visų užsakymo prekių pozicijų grupių, kuriose yra prekių pozicijų komponentų, sąrašas. |
item_count | Bendra visų prekių kiekių suma. |
fulfillment_status | Dabartinė užsakymo vykdymo būsena. Viena iš: unfulfilled, partial, fulfilled. |
note | Prie užsakymo pridėta pastaba. Pastabą galima gauti iš kliento ir (arba) redaguoti užsakymo išsamios informacijos ekrane Jūsų administratoriaus sąsajoje. |
attributes |
Visi atributai, kurie buvo pridėti prie užsakymo. Pavyzdys: |
metafields |
Visi užsakymo metalaukai. Naudokite šią sintaksę: metafields.NAMESPACE.KEY |
referring_site |
Pateikiamas nukreipėjo URL adresas, kuris atvedė klientą į Jūsų parduotuvę. Pavyzdys: |
landing_site |
Pateikiamas kliento nukreipimo svetainės kelias. Tai pirmasis puslapis, kurį klientas pamatė atėjęs į parduotuvę. Pavyzdys: |
landing_site_ref |
Peržiūri nukreipimo svetainę ir iš jos išskiria nuorodos parametrą. Nuorodos parametrai gali būti: Jei
{% if landing_site_ref == 'my-tracking-token' %}
Mano veiksmas...
{% endif %}
|
cancelled | (Loginė reikšmė) Pateikia „true“ reikšmę, jei užsakymas buvo atšauktas. |
cancelled_at | Laikas, kada užsakymas buvo atšauktas. |
cancel_reason | Priežastis, pasirinkta atšaukiant užsakymą. Viena iš: inventory, customer, declined, fraud arba other. |
has_high_risks?(deprecated) | Pateikia „true“ reikšmę, jei užsakymas yra didelės rizikos. |
unique_gateways |
Grąžina unikalių mokėjimo paslaugų teikėjų sąrašą užsakyme. Pavyzdžiui, jei kas nors sumokėjo „Visa“, „Mastercard“ ir grynaisiais pinigais, tada grąžintame sąraše būtų |
location(POS only) |
Parodo fizinę užsakymo vietą. Yra kelios galimos vietos ypatybės, išvardytos čia. Vietas galite konfigūruoti administratoriaus skydelio srityje „Vietos“. |
order_status_url |
Grąžina nuorodą į šio užsakymo būsenos puslapį. |
fulfilled_line_items(deprecated) | Įvykdytų prekių pozicijų sąrašas. |
unfulfilled_line_items(deprecated) | Ne visiškai įvykdytų prekių pozicijų sąrašas. |
b2b? |
Grąžina „true“, jei užsakymas yra B2B užsakymas. Naudokite ypatybę su B2B kintamaisiais, kad el. laiškuose būtų rodoma aktuali informacija, pavyzdžiui, įmonės pavadinimas, įmonės padalinys ir adresas. Pavyzdžiui, B2B užsakymuose galite įtraukti antraštę į šabloną su šia informacija:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Įmonė, kuriai parduodate pagal B2B užsakymą. |
company.name | Įmonės pavadinimas B2B užsakyme. |
company.id | Įmonės ID B2B užsakyme. |
company_location | Įmonės padalinys B2B užsakyme. Iš jūsų perkanti įmonė gali turėti daugiau nei vieną padalinį. |
company_location.name | Įmonės padalinio pavadinimas B2B užsakyme. |
company_location.id | Įmonės padalinio ID numeris B2B užsakyme. |
company_location.shipping_address | Įmonės padalinio pristatymo adresas B2B užsakyme. |
company_location.billing_address | Įmonės padalinio sąskaitos pateikimo adresas B2B užsakyme. |
customer_order_url | Naujas užsakymo būsenos puslapis, skirtas užsakymui, kuriam klientas paprašė grąžinimo naudodamasis klientų paskyromis. |
Juodraštinio užsakymo ypatybės
| Ypatybė | Aprašymas |
|---|---|
id | Unikalus juodraštinio užsakymo ID, skirtas vidiniam naudojimui. |
invoice_url | Nuoroda, kurią klientas gali naudoti sąskaitai faktūrai apmokėti per saugų „Shopify“ atsiskaitymą. |
reserve_inventory_until |
Data ir laikas, iki kada rezervuojamos juodraščio prekių pozicijos, pavyzdžiui, Datas galite formatuoti naudodami „Liquid“ datos filtrą. |
user | Paskutinis darbuotojas, pakeitęs juodraštinį užsakymą. |
user.name | Paskutinio darbuotojo, pakeitusio juodraštinį užsakymą, vardas ir pavardė. |
user.email | Paskutinio darbuotojo, pakeitusio juodraštinį užsakymą, el. pašto adresas. |
email | El. pašto adresas, susietas su juodraštiniu užsakymu. |
name | Unikalus number juodraštinio užsakymo pavadinimas, prieš kurį nurodomas grotelių ženklas #. |
number | Unikalus juodraštinio užsakymo numeris be užsakymo prefikso ar sufikso. |
created_at |
Data ir laikas, kada klientas sukūrė juodraštinį užsakymą, pavyzdžiui, Datas galite formatuoti naudodami „Liquid“ datos filtrą. |
tags | Pateikia masyvą su visomis užsakymo žymomis. Žymos pateikiamos abėcėlės tvarka. Daugiau informacijos rasite „Liquid“ informacinėje dokumentacijoje. |
tax_price | Bendra mokesčių suma už visas prekes juodraštiniame užsakyme. |
tax_lines |
Mokesčiai pagal tipą:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Mokesčio pavadinimas. Pavyzdžiai: QST arba PVM |
tax_line.price | Mokesčio suma. |
tax_line.rate | Mokesčio tarifas dešimtaine išraiška. Pavyzdžiui, jei mokesčio tarifas yra 17,5 %, bus grąžinama reikšmė 0,175. |
tax_line.rate_percentage | Mokesčio tarifas procentine išraiška. Pavyzdžiui, jei tarifas yra 0,175, bus grąžinama reikšmė 17,5. |
customer | Kliento objektas, apimantis kliento išvesties atributus. |
billing_address | Juodraštinio užsakymo sąskaitos pateikimo adresas. |
billing_address.first_name | Kliento vardas. |
billing_address.last_name | Kliento pavardė. |
billing_address.company | Įmonės pavadinimas sąskaitos pateikimo adrese. |
billing_address.phone | Telefono numeris sąskaitos pateikimo adrese. |
shop.name | Jūsų parduotuvės pavadinimas. |
shop.phone | Jūsų parduotuvės telefono numeris. |
subtotal_price | Juodraštinio užsakymo prekių pozicijų kainų suma, atėmus bet kokią prekių pozicijos ar krepšelio nuolaidą. Į tarpinę sumą neįtraukiami mokesčiai (nebent mokesčiai įskaičiuoti į kainas) arba siuntimo kaina. |
discounts | Nuolaidų sąrašas. |
discounts_amount | Visų pritaikytų nuolaidų suma. Pavyzdys: +5,00 $ |
discounts_savings | Sutaupyta suma pritaikius visas nuolaidas. Pavyzdys: –5,00 $ |
total_price | Bendra užsakymo kaina (tarpinė suma + siuntimo kaina – pristatymo nuolaida + mokesčiai). |
amount_due_now | Reikalinga suma pagal juodraštinio užsakymo sąskaitą faktūrą. |
requires_shipping | Grąžina true jei juodraštiniame užsakyme yra bent viena prekė, kurią reikia pristatyti. Grąžina false jei juodraštiniame užsakyme nėra prekių, kurias reikia pristatyti. |
shipping_method.title | Siuntimo tarifo pavadinimas. Pavyzdys: standartinis pristatymas |
shipping_method.price | Siuntimo būdo kaina. Grąžina tą pačią informaciją, kaip ir shipping_price. |
shipping_price |
Siuntimo kaina. Šią sumą galite formatuoti naudodami „Liquid“ pinigų filtrus. |
shipping_address |
Pastaba: skirtingai nuo įprastų užsakymų, juodraštinio užsakymo pristatymo adresas gali būti nepilnas. |
shipping_address.first_name | Pristatymo adrese nurodytas vardas. |
shipping_address.company | Įmonės pavadinimas pristatymo adrese. |
shipping_address.phone | Telefono numeris pristatymo adrese. |
line_items | Visų juodraštiniame užsakyme esančių prekių pozicijų sąrašas. |
item_count | Visų prekių kiekių suma juodraštiniame užsakyme. |
note | Prie juodraštinio užsakymo pridėta pastaba. Pastabą galima gauti iš kliento, taip pat ją galima redaguoti juodraštinio užsakymo informacijos ekrane, jūsų „Shopify“ administratoriaus skydelyje. |
metafields |
Visi juodraštinio užsakymo metalaukai. Naudokite šią sintaksę: metafields.NAMESPACE.KEY |
location |
Fizinė užsakymo vieta. Yra kelios galimos vietos ypatybės. Vietas galite konfigūruoti savo „Shopify“ administratoriaus skydelio puslapyje Vietos. |
b2b? |
Grąžina „true“, jei užsakymas yra B2B užsakymas. Naudokite ypatybę su B2B kintamaisiais, kad el. laiškuose būtų rodoma aktuali informacija, pavyzdžiui, įmonės pavadinimas, įmonės padalinys ir adresas. Pavyzdžiui, B2B užsakymuose galite įtraukti antraštę į šabloną su šia informacija:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Įmonė, kuriai parduodate pagal B2B užsakymą. |
company.name | Įmonės pavadinimas B2B užsakyme. |
company.id | Įmonės ID B2B užsakyme. |
company_location | Įmonės padalinys B2B užsakyme. Iš jūsų perkanti įmonė gali turėti daugiau nei vieną padalinį. |
company_location.name | Įmonės padalinio pavadinimas B2B užsakyme. |
company_location.id | Įmonės padalinio ID numeris B2B užsakyme. |
company_location.shipping_address | Įmonės padalinio pristatymo adresas B2B užsakyme. |
company_location.billing_address | Įmonės padalinio sąskaitos pateikimo adresas B2B užsakyme. |
payment_methods | Išsaugotų mokėjimo būdų, kuriuos galima naudoti juodraščio bendrai sumai apdoroti, sąrašas. |
payment_method.payment_instrument | Mokėjimo priemonė, kurioje pateikiama išsami informacija apie išsaugotą mokėjimo būdą. |
payment_method.payment_instrument.payment_type | Išsaugoto mokėjimo būdo tipas. Pvz., „credit_card, apple_pay“ |
payment_method.payment_instrument.credit_card_brand | Kortelės prekės ženklas, kai `payment_type` yra „credit_card“ |
payment_method.payment_instrument.credit_card_company | Kortelės įmonė, kai `payment_type` yra „credit_card“ |
payment_method.payment_instrument.credit_card_company | Paskutiniai 4 kortelės skaitmenys, kai `payment_type` yra „credit_card“ |
Mokėjimų tvarkaraščio savybės
| Ypatybė | Aprašymas |
|---|---|
payment_schedule.amount_due |
Mokėtina suma pagal mokėjimų tvarkaraštį. Galite formatuoti sumas su valiutomis, naudodami `Liquid` pinigų filtrą. |
payment_schedule.due_at |
Mokėjimo terminas pagal mokėjimų tvarkaraštį. Datas galite formatuoti naudodami „Liquid“ datos filtrą. |
payment_schedule.due_in_days |
Dienų skaičius iki mokėjimo termino, jei mokėjimas pagal tvarkaraštį vis dar laukiamas (neapmokėtas). |
payment_schedule.due_later? |
Pateikia reikšmę „true“, jei pagal mokėjimų tvarkaraštį nebuvo sumokėta ir mokėjimo terminas yra ateityje. |
payment_schedule.number_of_days_overdue? |
Dienų skaičius nuo mokėjimo termino, kai mokėjimas pagal tvarkaraštį yra pradelstas. |
payment_schedule.overdue? |
Pateikia reikšmę „true“, jei pagal mokėjimų tvarkaraštį nebuvo sumokėta ir jo mokėjimo terminas praėjęs. |
Mokėjimo būsenos savybės
| Ypatybė | Aprašymas |
|---|---|
has_pending_payment |
(loginė reikšmė) Pateikia reikšmę „true“, jei užsakyme yra operacija su laukiamu mokėjimu. Sužinokite daugiau apie laukiamus mokėjimus. |
buyer_action_required |
(loginė reikšmė) Pateikia reikšmę „true“, jei užsakyme yra operacija su laukiamu mokėjimu ir mokėjimui atblokuoti reikalingas pirkėjo veiksmas. Kai ši reikšmė yra „true“ ir mokėjimo būdas palaiko mokėjimo nurodymus, Sužinokite daugiau apie `Liquid` operacijos objektą. |
Rinkinio komponento savybės
Kiekvienas bundle_component sąraše line_item.bundle_components turi šias savybes. (Tik juodraštiniams užsakymams)
| Ypatybė | Aprašymas |
|---|---|
bundle_component.image_url | Rinkinio komponento paveikslėlio URL. |
bundle_component.product.title | Rinkinio komponento produkto pavadinimas. |
bundle_component.quantity | Rinkinio komponento kiekis. |
bundle_component.variant.title | Rinkinio komponento varianto parinkčių reikšmių dabartiniai pavadinimai, sujungti Pavyzdys: mažas / raudona |
Komponento savybės
Kiekvienas component sąraše line_item.components turi šias savybes. (Tik paliktiems atsiskaitymams)
`
| Ypatybė | Aprašymas |
|---|---|
component.image_url | Komponento paveikslėlio URL. |
component.product.title | Komponento produkto pavadinimas. |
component.quantity | Komponento kiekis. |
component.variant.title | Komponento varianto parinkčių reikšmių dabartiniai pavadinimai, sujungti Pavyzdys: mažas / raudona |
Prekių pozicijos savybės
Kiekviena line sąraše line_items arba subtotal_line_items turi šias savybes.
| Ypatybė | Aprašymas |
|---|---|
line.applied_discounts(POS and draft orders only) | Šiam daiktui taikomų nuolaidų sąrašas (kiekviena nuolaida turi title, code, amount, savings ir type savybes). |
line.bundle_components(Draft orders only) | Prekių pozicijų, kurios yra šio daikto rinkinio komponentai, sąrašas. Sąrašas pateikiamas tik tuo atveju, jei ši prekių pozicija yra rinkinio produktas. |
line.bundle_parent?(Draft orders only) | (loginė reikšmė) Pateikia reikšmę „true“, jei prekių pozicija yra rinkinio produktas. |
line.components(Abandoned checkout only) | Prekių pozicijų, kurios yra šio daikto komponentai, sąrašas. |
line.parent?(Abandoned checkout only) | (loginė reikšmė) Pateikia reikšmę „true“, jei prekių pozicija turi komponentų. |
line.custom(Draft orders only) | (loginė reikšmė) Pateikia reikšmę „true“, jei daiktas yra pasirinktinė juodraštinio užsakymo prekių pozicija. |
line.delivery_agreement | Su šia prekių pozicija susijusi Pristatymo sutartis. |
line.grams | Vieno daikto svoris. |
line.groups | Užsakymo eilutės grupė daiktui. |
line.image | Pateikia su šia prekių pozicija susieto paveikslėlio URL. Taip pat galite naudoti img_url filtrą, kad gautumėte konkrečių dydžių paveikslėlius, pavyzdžiui, {{ line.image | img_url: 'small' }}. |
line.line_price | To daikto kaina, padauginta iš kiekio. |
line.original_line_price | Bendra prekių pozicijoje esančių daiktų kaina prieš pritaikant nuolaidas. |
line.final_line_price | Bendra visų prekių pozicijoje esančių daiktų kaina, įskaitant visas pozicijos lygio nuolaidų sumas. |
line.pre_tax_price | Prekių pozicijų kaina be mokesčių, padauginta iš nupirktos prekių pozicijos kiekio. |
line.price | Vieno daikto kaina. |
line.product.metafields | Visi metalaukai produkto lygmeniu. Naudokite šią sintaksę: line.product.metafields.NAMESPACE.KEY |
line.product.title | Dabartinis produkto pavadinimas. |
line.product.vendor | Daikto pardavėjas. |
line.properties | Pateikia pasirinktinės informacijos apie daiktą masyvą. Prekių pozicijos savybes klientas nurodo produkto puslapyje prieš pridedant produktą į krepšelį. |
line.quantity | To daikto kiekis. |
line.current_quantity | Dabartinis daikto kiekis po pašalinimų. |
line.requires_shipping | (loginė reikšmė) Pateikia reikšmę „true“, jei daikto variantui produkto puslapyje yra suaktyvintas nustatymas Fizinis produktas. |
line.selling_plan_allocation | Pateikia selling_plan_allocation objektą, kuris aprašo, kaip pardavimo planas, pavyzdžiui, prenumerata, paveikia prekių poziciją. |
line.taxable | (loginė reikšmė) Pateikia reikšmę „true“, jei daikto variantui produkto puslapyje yra pažymėtas žymimasis laukelis „Taikyti mokesčius šiam produktui“. |
line.title | Produkto pavadinimas pardavimo metu, po kurio eina brūkšnelis ir varianto pavadinimas pardavimo metu. Varianto pavadinimas neįtraukiamas, kai jis yra „Numatytasis pavadinimas“. Klientams skirtuose pranešimuose produkto ir varianto pavadinimai yra verčiami į kalbą, kuria klientas atsiskaitė, jei ji skiriasi nuo numatytosios parduotuvės kalbos. |
line.url | Santykinis prekių pozicijos varianto URL. Santykinis URL neapima Jūsų parduotuvės pagrindinio URL (mystore.myshopify.com). |
line.variant.barcode | Su produkto variantu susietas brūkšninis kodas. |
line.variant.compare_at_price | Su produkto variantu susieta palyginamoji kaina. |
line.variant.image | Produkto varianto vaizdas. Vaizdas pateikiamas tik tuo atveju, jei prekių pozicijoje variantui priskirtas konkretus vaizdas. |
line.variant.metafields | Visi metalaukai varianto lygmenyje. Naudokite šią sintaksę: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku | Su produkto variantu susietas SKU. |
line.variant.title | Dabartiniai varianto parinkčių reikšmių pavadinimai, sujungti Pavyzdys: mažas / raudona |
line.refunded.quantity(within refund notifications) | Grąžintinos prekės kiekis. Galite naudoti šią ypatybę, kad pridėtumėte identifikatorių prie užsakyme esančių grąžinamų prekių. Pavyzdžiui: |
„Shopify Collective“ prekių aptikimas pranešimų šablonuose
Shopify Collective žyma užsakymui pritaikoma išsiuntus užsakymo patvirtinimo el. laišką, todėl {% if tags contains 'Shopify Collective' %} niekada nėra true užsakymo patvirtinimo šablone. Norėdami aptikti „Shopify Collective“ prekes, verčiau tikrinkite produkto lygio žymas kiekvienoje prekių pozicijoje:
{% 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 %}Prekių pozicijų grupės ypatybės
Kiekviena line_item_group sąraše line_item_groups turi šias ypatybes.
| Ypatybė | Aprašymas |
|---|---|
line_item_group.display_title | Prekių pozicijų grupės pavadinimas. |
line_item_group.components | Grupei priklausančių prekių pozicijų komponentų sąrašas. |
line_item_group.image | Prekių pozicijų grupės vaizdas. |
line_item_group.product_id | Prekių pozicijų grupės produkto ID. |
line_item_group.variant | Prekių pozicijų grupės varianto objektas. |
line_item_group.variant_id | Prekių pozicijų grupės varianto ID. |
Pinigų grąžinimo ypatybės
| Ypatybė | Aprašymas |
|---|---|
amount | Grąžinta pinigų suma. |
refund_line_items | Grąžinamų pinigų už prekių pozicijas sąrašas. |
Refund_line_item ypatybės
Kiekviena refund_line sąraše refund_line_items turi šias ypatybes:
| Ypatybė | Aprašymas |
|---|---|
refund_line.line_item | Prekių pozicija (line_item), už kurią grąžinami pinigai. Suteikiama prieiga prie visų prekių pozicijos ypatybių. |
refund_line.quantity | Grąžinamos prekių pozicijos kiekis. |
Užsakymo įvykdymo ypatybės
| Ypatybė | Aprašymas |
|---|---|
service_name | Tinkintos paslaugos pavadinimas, nustatytas puslapyje Nustatymai > Siuntimas ir pristatymas. (Tik įvykdymo užklausoms) |
fulfillment.estimated_delivery_at | Numatoma pristatymo data, pagrįsta sekimo numeriu (jei yra), kurį pateikė vienas iš šių vežėjų: USPS, „FedEx“, UPS, Kanados paštas (tik Kanadoje). Ši ypatybė pasiekiama tik tada, kai naudojami vežėjo apskaičiuoti įkainiai. |
fulfillment.fulfillment_line_items | Vykdytinų prekių pozicijų sąrašas. |
fulfillment.item_count | Visų prekių kiekių suma. Bendras vykdomų prekių skaičius. |
fulfillment.requires_shipping | (loginė reikšmė) Pateikia „true“, jei šiai įvykdymo užklausai reikalingas pristatymas. |
fulfillment.tracking_company | Stebėjimą vykdanti įmonė. |
fulfillment.tracking_numbers | Sekimo numerių sąrašas. |
fulfillment.tracking_urls | Stebėjimo URL sąrašas. |
items_to_fulfill(deprecated) | Prekių pozicijų, kurias turi įvykdyti ši konkreti pritaikyta įvykdymo paslauga, sąrašas. (Tik įvykdymo užklausai) |
items_to_fulfill_count(deprecated) | Bendras prekių skaičius, kurias reikia įvykdyti pagal šią užklausą. (Tik įvykdymo užklausai) |
Vykdomos prekių pozicijos ypatybės
Kiekviena fulfillment_line fulfillment_line_items sąraše turi šias ypatybes.
| Ypatybė | Aprašymas |
|---|---|
fulfillment_line.line_item | Vykdoma prekių pozicija (line_item). Suteikiama prieiga prie visų prekių pozicijos ypatybių. |
fulfillment_line.quantity | Vykdomos prekių pozicijos kiekis. |
Paruoštos siuntos ypatybės
Paruoštą siuntą sudaro prekės, pažymėtos kaip paruoštos atsiimti.
| Ypatybė | Aprašymas |
|---|---|
item_count | Visų prekių kiekių suma paruoštoje siuntoje. |
prepared_package_line_items | Paruoštos siuntos prekių pozicijų sąrašas. |
Paruoštos siuntos prekių pozicijos ypatybės
Kiekviena prepared_package_line_item prepared_package_line_items sąraše turi šias ypatybes.
| Ypatybė | Aprašymas |
|---|---|
line_item | Susijusi prekių pozicija (line_item). Suteikiama prieiga prie visų prekių pozicijos ypatybių. |
quantity | Prekių pozicijos kiekis, pažymėtas kaip paruoštas atsiimti. |
Pristatymo ypatybės
| Ypatybė | Aprašymas |
|---|---|
delivery_agreements | Visų užsakymo pristatymo susitarimų sąrašas. |
delivery_instructions | Vietinio pristatymo informacija, skirta bendrinti su klientu. Ši informacija valdoma laukelyje Pristatymo informacija, esančiame Jūsų vietinio pristatymo nustatymuose. |
consolidated_estimated_delivery_time | Užsakymo pristatymo datų informacija, skirta bendrinti su klientu. Ši informacija valdoma apdorojimo laiko nustatymu, kurį nustatote savo puslapyje Siuntimas ir pristatymas. Kai užsakymas turi kelis pristatymo būdus, rodomas pristatymo būdų ir datų sąrašas. |
has_multiple_delivery_methods | (loginė reikšmė) Pateikia „true“, jei užsakymas turi kelis pristatymo būdus. |
Pristatymo susitarimo ypatybės
| Ypatybė | Aprašymas |
|---|---|
delivery_agreement.delivery_method_type | Pristatymo būdo tipas. |
delivery_agreement.delivery_method_name | Pristatymo būdo tipas, išverstas į kalbą, kuria pirkėjas atsiskaitė, jei ta kalba skiriasi nuo numatytosios parduotuvės kalbos. |
delivery_agreement.line_item_groups | Visų prekių pozicijų grupių, kuriose yra susietų prekių pozicijų komponentų pristatymo susitarime, sąrašas. |
delivery_agreement.line_items | Visų su šiuo pristatymo susitarimu susijusių prekių pozicijų sąrašas. |
Nuolaidos ypatybės
Yra dviejų tipų nuolaidų ypatybės.
discount_applications aprašo, kodėl ir kaip daiktui buvo pritaikyta nuolaida.
discount_allocations aprašo, kaip konkreti nuolaida paveikia prekių poziciją ir kaip ji sumažina kainą. Šią ypatybę turėtumėte naudoti prekių pozicijos lygmeniu.
Galite derinti šias ypatybes, kad parodytumėte nuolaidos informaciją prekių pozicijos arba užsakymo lygmeniu.
Pavyzdys
Šiame pavyzdyje tikrinama, ar prekių pozicijai buvo pritaikyta nuolaida. Jei nuolaida nebuvo pritaikyta užsakymo lygmeniu (all), rodomas nuolaidos pavadinimas ir suma.
{% 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 %}Rezultatas gali būti panašus į šį:
SPRING5 (-$5.00)„Discount_allocation“ ypatybės
Kiekvienas discount_allocation, esantis discount_allocations sąraše, turi šias ypatybes.
| Ypatybė | Aprašymas |
|---|---|
discount_allocation.amount | Pinigų suma, kurią klientas sutaupo pirkdamas prekių poziciją. Turi būti įvesta cikle, jei norite leisti naudoti kelis nuolaidų kodus. |
discount_allocation.discount_application | Nuolaidos taikymas, kuris paskirsto sumą prekių pozicijai. |
„Discount_application“ ypatybės
Kiekvienas discount_application, esantis discount_applications sąraše, turi šias ypatybes.
| Ypatybė | Aprašymas |
|---|---|
discount_application.target_selection |
Aprašo, kaip nuolaida pasirenka prekių pozicijas krepšelyje, kurioms bus taikoma nuolaida. Viena iš:
|
discount_application.target_type | Daikto tipas, kuriam taikoma nuolaida (line_item arba shipping_line). |
discount_application.title | Klientui rodomas nuolaidos pavadinimas. Pavyzdžiai: Welcome10 arba CBBWQQAKYBYY |
discount_application.total_allocated_amount | Bendra suma, kuria nuolaida sumažina užsakymo kainą. |
discount_application.type | Nuolaidos tipas. Vienas iš: automatic, discount_code, manual arba script. |
discount_application.value | Nuolaidos vertė. |
discount_application.value_type | Nuolaidos vertės tipas. Vienas iš: fixed_amount arba percentage. |
Prenumeratos ypatybės
Išsami informacija apie prenumeratos sutartį, dabartinį atsiskaitymo ciklą ir jo prekių pozicijas, pristatymo būdą ir mokėjimo būdą yra prieinama visuose prenumeratos el. laiškų šablonuose.
Norėdami redaguoti prenumeratos pranešimų šablonus, įdiekite „Shopify Subscriptions“ programėlę, tada raskite šabloną Nustatymų > Pranešimų dalyje Prenumeratos.
Prenumeratos sutarties atsiskaitymo ciklo ypatybės
Norėdami pasiekti prenumeratos sutarties ir jos atsiskaitymo ciklo ypatybes, naudokite objektą subscription_contract_billing_cycle.
Pavyzdys
{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.Rezultatas:
This contract is currently paused.Ypatybės
| Ypatybė | Aprašymas |
|---|---|
status |
Sutarties būsena. Viena iš: active, paused, cancelled, failed, expired, stale,
|
delivery_method |
Prenumeratos pristatymo būdas. Jei prenumeruojama paslauga arba skaitmeninis produktas, grąžinama nil.
|
billing_frequency | Prenumeratos atsiskaitymo dažnumas. |
delivery_frequency | Prenumeratos pristatymo dažnumas. |
origin_order |
Pirminis užsakymas, kuriuo sukurta prenumerata. Jei prenumerata nebuvo sukurta iš „Shopify“ užsakymo, grąžinama nil.
|
customer | Prenumeratos klientas. |
line_items | Prekių pozicijos abonemento atsiskaitymo cikle. |
product_names | Produktų, įtrauktų į abonemento atsiskaitymo ciklą, pavadinimų sąrašas. |
update_payment_method_url | URL, kurį klientas gali naudoti norėdamas atnaujinti šios sutarties mokėjimo būdą. |
shipping_address |
Prenumeratos pristatymo adresas. Jei prenumeruojama paslauga arba skaitmeninis produktas, grąžinama nil.
|
billing_address | Prenumeratos sąskaitos pateikimo adresas. |
subtotal_price | Tarpinė prenumeratos prekių pozicijų kaina. |
shipping_price | Prenumeratos pristatymo kaina. |
total_tax | Bendra prenumeratos mokesčių suma. |
total_price | Bendra prenumeratos kaina. |
total_discounts | Bendra prenumeratos nuolaidų suma. |
customer_self_serve_url | Savitarnos URL, kurį klientas gali naudoti norėdamas tvarkyti savo prenumeratas. |
billing_attempt_expected_date | Šio atsiskaitymo ciklo sąskaitos pateikimo data. |
next_billing_date | Kita nepraleista sąskaitos pateikimo data po šio atsiskaitymo ciklo. |
last_attempted_billing_date | Paskutinė bandyta sąskaitos pateikimo data atsiskaitymo ciklui. |
days_overdue | Dienų skaičius, kiek vėluojama apmokėti sąskaitą už šį atsiskaitymo ciklą. |
payment_instrument | Mokėjimo priemonė, susieta su prenumeratos sutartimi. Ši mokėjimo priemonė naudojama sąskaitai klientui pateikti. |
Prenumeratos sutarties prekių pozicijos ypatybės
Kiekvienos prekių pozicijos, įtrauktos į atsiskaitymo ciklą, ypatybės. Pasiekite sutarties prekių pozicijos ypatybes per pirminę ypatybę subscription_contract_billing_cycle.line_items.
Pavyzdys
{% for line_item in subscription_contract_billing_cycle.line_items %}
{{ line_item.url }}
{% endfor %}| Ypatybė | Aprašymas |
|---|---|
url | Prekių pozicijos gaminio varianto išsamios informacijos puslapio URL. |
requires_shipping | Ar prekių pozicijai reikalingas fizinis pristatymas. |
unit_price_measurement | Prekių pozicijos vieneto kainos matavimas. |
selling_plan_allocation | Prekių pozicijos pardavimo plano paskirstymas. |
Prenumeratos sutarties pristatymo būdo ypatybės
Pristatymo būdo, naudojamo šiame atsiskaitymo cikle, savybės. Pristatymo būdo savybes pasiekite per pirminę savybę subscription_contract_billing_cycle.delivery_method.
Pavyzdys
{% if subscription_contract_billing_cycle.delivery_method != blank %}
Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}| Ypatybė | Aprašymas |
|---|---|
title | Su pristatymo būdu susietos pristatymo parinkties pavadinimas. |
type |
Pristatymo būdo tipas. Vienas iš šių: shipping, local arba pick-up.
|
Prenumeratos sutarties mokėjimo priemonės savybės
Išsami informacija apie prenumeratos sutarties mokėjimo priemonę. Ši mokėjimo priemonė naudojama sąskaitoms klientui išrašyti. Mokėjimo priemonės savybes pasiekite per pirminę savybę subscription_contract_billing_cycle.payment_instrument.
Pavyzdys
{% 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 }}| Ypatybė | Aprašymas |
|---|---|
payment_type |
Mokėjimo priemonės nurodomas mokėjimo būdo tipas. Norėdami pateikti paveikslėlio URL arba SVG, naudokite mokėjimo filtrus. |
credit_card_brand | Kreditinės kortelės prekės ženklas. |
credit_card_company | Kreditinių kortelių įmonės pavadinimas. |
credit_card_last_four_digits | Paskutiniai 4 kreditinės kortelės skaitmenys. |
El. pašto pranešimų savybės
| Ypatybė | Aprašymas |
|---|---|
shop.email_logo_url | Logotipo URL, nurodytas administratoriaus skydelio skiltyje El. pašto šablonų pritaikymas. |
shop.email_logo_width | Logotipo plotis (pikseliais), nurodytas administratoriaus skydelio skiltyje El. pašto šablonų pritaikymas. |
shop.email_accent_color | Akcento spalvos HEX kodas, nurodytas administratoriaus skydelio skiltyje El. pašto šablonų pritaikymas. |
Parduotuvės kredito savybės
Savybės, kuriose pateikiama išsami informacija apie parduotuvės kredito išdavimą.
| Ypatybė | Aprašymas |
|---|---|
issued_store_credit.amount |
Išduoto parduotuvės kredito suma. Šią sumą galite formatuoti naudodami „Liquid“ pinigų filtrus. |
issued_store_credit.expires_at |
Išduoto parduotuvės kredito galiojimo pabaigos data ir laikas. Šią sumą galite formatuoti naudodami „Liquid“ datų filtrus. |
issued_store_credit.balance_after_transaction |
Parduotuvės kredito sąskaitos likutis po kredito išdavimo. Šią sumą galite formatuoti naudodami „Liquid“ pinigų filtrus. |
customer | Kliento objektas, apimantis kliento išvesties atributus. |