Dokumentacja zmiennych powiadomień

Powiadomienia wysyłane z Twojego sklepu są renderowane przy użyciu języka Liquid. Liquid to prosty, łatwy w użyciu język programowania Shopify. Jest to ten sam język programowania, na którym oparte są szablony z Theme Store.

Aby edytować powiadomienia wysyłane z Twojego sklepu, możesz wprowadzić podstawowe dostosowania w szablonach powiadomień. Aby uzyskać dostęp do pełnej listy powiadomień, które możesz dostosować, przejdź na stronę Powiadomienia w panelu administracyjnym Shopify.

W celu uzyskania pomocy przy wprowadzaniu bardziej zaawansowanych zmian lub modyfikacji niestandardowych szablonów powiadomień możesz skontaktować się ze społecznością na naszych forach lub zatrudnić partnera Shopify, który wykona te dostosowania. Dowiedz się więcej o zatrudnianiu partnera Shopify.

Na tej stronie

Właściwości zamówienia

Wiele właściwości zamówienia jest dostępnych bezpośrednio przy użyciu języka Liquid i w szablonach.

Opisy właściwości Liquid, których można używać z obiektem zamówienia w szablonach powiadomień
Właściwość	Opis
`id`	Unikalne w całym systemie ID zamówienia do użytku wewnętrznego. Użyj poniższego przykładu, aby wygenerować link do zamówienia w sekcji panelu administracyjnego sklepu. Na przykład w szablonie Nowe zamówienie możesz dodać następujący kod: `Wyświetl zamówienie`
`email`	Adres e-mail powiązany z zamówieniem.
`name`	Zazwyczaj jest to symbol #, po którym następuje `order_number`. Przykład: #1004
`order_name`	Tak samo jak `name`.
`order_number`	Unikalny numer zamówienia w sklepie, bez prefiksu # ani żadnego prefiksu lub sufiksu dodanego do ID zamówienia przez właściciela sklepu w preferencjach sklepu. Przykład: 1004
`confirmation_number`	Losowo generowany identyfikator alfanumeryczny zamówienia, który może być wyświetlany klientowi zamiast sekwencyjnej nazwy zamówienia. Ta wartość nie musi być unikalna. Przykład: XPAV284CT
`created_at`	Data i godzina złożenia zamówienia przez klienta. Możesz sformatować tę wartość za pomocą filtra daty. Przykład: 2009-05-30T17:43:51+02:00
`payment_terms`	Terminy płatności określają datę, do której należy dokonać płatności za zamówienie. Dowiedz się, jak dodać terminy płatności do faktur za zamówienie. Więcej szczegółów znajdziesz w dokumentacji Liquid dla payment_terms.
`destination`	Miejsce docelowe, do którego powinny zostać wysłane pozycje.
`tags`	Zwraca tablicę wszystkich tagów zamówienia. Tagi są zwracane w porządku alfabetycznym. Tagi stosowane dynamicznie przez aplikacje lub funkcje platformy, takie jak tag `Shopify Collective`, mogą być niedostępne w momencie generowania powiadomienia e-mail. Aby wykryć pozycje pochodzące z określonej funkcji, zamiast tego sprawdź tagi na poziomie produktu w każdej pozycji pojedynczej. Więcej szczegółów znajdziesz w dokumentacji referencyjnej Liquid.
`transactions`	Zwraca tablicę transakcji z zamówienia.
`tax_price`	Suma podatków od wszystkich pozycji w zamówieniu.
`tax_lines`	Podatki z podziałem na rodzaj opodatkowania: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Nazwa podatku. Na przykład QST lub VAT.
`tax_line.price`	Kwota podatku.
`tax_line.rate`	Stawka podatku w postaci ułamka dziesiętnego. Zwróci wartość 0,175, jeśli stawka wynosi 17,5%.
`tax_line.rate_percentage`	Stawka podatku w formie czytelnej dla człowieka. Zwróci wartość 17,5, jeśli stawka wynosi 0,175.
`customer`	Obiekt klienta zawierający atrybuty klienta.
`billing_address`	Adres rozliczeniowy.
`billing_address.first_name`	Imię klienta.
`billing_address.last_name`	Nazwisko klienta.
`billing_address.company`	Nazwa firmy do celów rozliczeniowych.
`billing_address.phone`	Numer telefonu z adresu rozliczeniowego.
`shop.name`	Nazwa sklepu.
`shop.phone`	Numer telefonu sklepu.
`subtotal_price`	Suma cen pozycji pojedynczych zamówienia po odjęciu rabatu na pozycję lub rabatu na koszyk. Suma częściowa nie obejmuje podatków (chyba że podatki są wliczone w ceny), kosztów wysyłki ani napiwków.
`discounts`	Lista rabatów.
`discounts_amount`	Łączna kwota zastosowanych rabatów. Przykład: +5,00 $
`discounts_savings`	Kwota oszczędności uzyskana dzięki wszystkim rabatom. Przykład: -5,00 $
`total_price`	Suma zamówienia (suma częściowa + koszt wysyłki - rabat na wysyłkę + podatek).
`financial_status`	Bieżący status płatności. Jedna z następujących wartości: nil, `pending`, `authorized`, `paid`, `voided`, `refunded`.
`requires_shipping`	(wartość logiczna) Zwraca wartość 'true', jeśli w zamówieniu znajduje się co najmniej jedna pozycja wymagająca wysyłki.
`shipping_method.title`	Nazwa stawki wysyłki. W powiadomieniach dla klientów nazwa stawki wysyłki jest tłumaczona na język, w którym klient sfinalizował zakup, jeśli jest on inny niż domyślny język sklepu. Przykład: Wysyłka standardowa
`shipping_method.price`	Cena wysyłki z uwzględnieniem ewentualnego rabatu na wysyłkę. Przykład: `{{ shipping_method.price \| money }}`
`shipping_price`	Cena wysyłki. Przykład: `{{ shipping_price \| money }}`
`shipping_address`	Adres wysyłki.
`shipping_address.first_name`	Imię podane w adresie wysyłki.
`shipping_address.company`	Nazwa firmy podana w adresie wysyłki.
`shipping_address.phone`	Numer telefonu z adresu wysyłki.
`line_items`	Lista wszystkich pozycji pojedynczych w zamówieniu.
`line_items_including_zero_quantity`	Lista wszystkich pozycji pojedynczych w zamówieniu, w tym tych o zerowej ilości. Pozycje pojedyncze mają zerową ilość, gdy dokonano ich pełnego zwrotu.
`line_item_groups`(Orders and POS only)	Lista wszystkich grup pozycji pojedynczych zawierających elementy pozycji pojedynczych w zamówieniu.
`item_count`	Suma ilości wszystkich pozycji.
`fulfillment_status`	Bieżący status realizacji zamówienia. Jedna z wartości: `unfulfilled`, `partial`, `fulfilled`.
`note`	Notatka dołączona do zamówienia. Notatkę można otrzymać od klienta i/lub edytować na ekranie szczegółów zamówienia w panelu administracyjnym.
`attributes`	Wszelkie atrybuty dołączone do zamówienia. Przykład: `{{ attributes.gift-note }}`
`metafields`	Wszelkie metapola w zamówieniu. Użyj następującej składni: metafields.NAMESPACE.KEY
`referring_site`	Zawiera adres URL strony odsyłającej, która sprowadziła klienta do sklepu. Przykład: `https://www.google.com/?s=great+products`
`landing_site`	Zawiera ścieżkę strony docelowej, której użył klient. Jest to pierwsza strona, którą klient zobaczył po wejściu do sklepu. Przykład: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	Analizuje stronę docelową i wyodrębnia z niej parametr odniesienia. Parametrami odniesienia mogą być: `ref`, `source`, `r`. Jeśli `landing_site` ma wartość `/products/great-product?ref=my-tracking-token`, to `landing_site_ref` ma wartość `my-tracking-token`. Możesz wykonać określoną akcję, jeśli parametr ref jest równy określonej wartości: `{% if landing_site_ref == 'my-tracking-token' %} Moja akcja... {% endif %}`
`cancelled`	(wartość logiczna) Zwraca wartość 'true', jeśli zamówienie zostało anulowane.
`cancelled_at`	Czas anulowania zamówienia.
`cancel_reason`	Powód wybrany podczas anulowania zamówienia. Jedna z następujących wartości: `inventory`, `customer`, `declined`, `fraud` lub `other`.
`has_high_risks?`(deprecated)	Zwraca wartość 'true', jeśli zamówienie jest obarczone wysokim ryzykiem.
`unique_gateways`	Zwraca listę unikalnych dostawców płatności w zamówieniu. Na przykład, jeśli ktoś zapłacił za pomocą karty Visa, Mastercard i gotówki, zwrócona lista będzie zawierać `shopify_payments, cash`.
`location`(POS only)	Wyświetla fizyczną lokalizację zamówienia. Dostępnych jest kilka właściwości lokalizacji, które są wymienione tutaj. Lokalizacje można skonfigurować w obszarze Lokalizacje w panelu administracyjnym.
`order_status_url`	Zwraca link do strony statusu dla tego zamówienia.
`fulfilled_line_items`(deprecated)	Lista pozycji pojedynczych, które zostały zrealizowane.
`unfulfilled_line_items`(deprecated)	Lista pozycji pojedynczych, które nie zostały w pełni zrealizowane.
`b2b?`	Zwraca wartość „true”, jeśli zamówienie jest zamówieniem B2B. Użyj tej właściwości ze zmiennymi B2B, aby wyświetlić odpowiednie informacje, takie jak nazwa firmy, lokalizacja firmy i adres w wiadomościach e-mail. Na przykład w przypadku zamówień B2B możesz dodać do szablonu nagłówek z następującymi informacjami: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Firma, której sprzedajesz w ramach zamówienia B2B.
`company.name`	Nazwa firmy w zamówieniu B2B.
`company.id`	ID firmy w zamówieniu B2B.
`company_location`	Lokalizacja firmy w zamówieniu B2B. Firma, która dokonuje u Ciebie zakupów, może mieć więcej niż jedną lokalizację.
`company_location.name`	Nazwa lokalizacji firmy w zamówieniu B2B.
`company_location.id`	Numer ID lokalizacji firmy w zamówieniu B2B.
`company_location.shipping_address`	Adres wysyłki lokalizacji firmy w zamówieniu B2B.
`company_location.billing_address`	Adres rozliczeniowy lokalizacji firmy w zamówieniu B2B.
`customer_order_url`	Nowa strona statusu zamówienia dla zamówienia, dla którego klient zażądał zwrotu za pomocą kont klientów.

Właściwości wersji roboczej zamówienia

Opisy właściwości Liquid, których można używać z obiektem wersji roboczej zamówienia w szablonach powiadomień
Właściwość	Opis
`id`	Unikalne ID wersji roboczej zamówienia do użytku wewnętrznego.
`invoice_url`	Link, za pomocą którego klient może zapłacić za fakturę, korzystając z bezpiecznej realizacji zakupu Shopify.
`reserve_inventory_until`	Data i godzina, do której zarezerwowane są pozycje pojedyncze w wersji roboczej, na przykład `2015-05-30T17:43:51+02:00`. Daty można formatować za pomocą filtra daty Liquid.
`user`	Ostatni pracownik, który zmodyfikował wersję roboczą zamówienia.
`user.name`	Imię i nazwisko ostatniego pracownika, który zmodyfikował wersję roboczą zamówienia.
`user.email`	Adres e-mail ostatniego pracownika, który zmodyfikował wersję roboczą zamówienia.
`email`	Adres e-mail powiązany z wersją roboczą zamówienia.
`name`	Unikalna `number` wersji roboczej zamówienia, poprzedzona znakiem numeru `#`.
`number`	Unikalny numer wersji roboczej zamówienia bez prefiksu i sufiksu zamówienia.
`created_at`	Data i godzina utworzenia wersji roboczej zamówienia przez klienta, na przykład `2009-05-30T17:43:51+02:00`. Daty można formatować za pomocą filtra daty Liquid.
`tags`	Zwraca tablicę wszystkich tagów zamówienia. Tagi są zwracane w porządku alfabetycznym. Więcej szczegółów znajdziesz w dokumentacji Liquid.
`tax_price`	Suma podatków od wszystkich pozycji w wersji roboczej zamówienia.
`tax_lines`	Podatki z podziałem na rodzaj podatku: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Nazwa podatku. Przykłady: QST lub VAT
`tax_line.price`	Kwota podatku.
`tax_line.rate`	Stawka podatku w formie dziesiętnej. Na przykład stawka podatku w wysokości 17,5% zwróci wartość `0,175`.
`tax_line.rate_percentage`	Stawka podatku w formie procentowej. Na przykład dla `stawki` 0,175 zwrócona zostanie wartość `17,5`.
`customer`	Obiekt klienta zawierający atrybuty klienta.
`billing_address`	Adres rozliczeniowy dla wersji roboczej zamówienia.
`billing_address.first_name`	Imię klienta.
`billing_address.last_name`	Nazwisko klienta.
`billing_address.company`	Nazwa firmy w adresie rozliczeniowym.
`billing_address.phone`	Numer telefonu w adresie rozliczeniowym.
`shop.name`	Nazwa sklepu.
`shop.phone`	Numer telefonu sklepu.
`subtotal_price`	Suma cen pozycji pojedynczych wersji roboczej zamówienia po odjęciu rabatu na pozycję lub rabatu na koszyk. Suma częściowa nie obejmuje podatków (chyba że podatki są wliczone w ceny) ani kosztów wysyłki.
`discounts`	Lista rabatów.
`discounts_amount`	Łączna kwota zastosowanych rabatów. Przykład: +5,00 $
`discounts_savings`	Kwota oszczędności wynikająca ze wszystkich rabatów. Przykład: -5,00 $
`total_price`	Cena całkowita zamówienia (suma częściowa + koszt wysyłki - rabat na wysyłkę + podatek).
`amount_due_now`	Kwota wymagana na fakturze za wersję roboczą zamówienia.
`requires_shipping`	Zwraca `true` jeśli w wersji roboczej zamówienia znajduje się co najmniej jedna pozycja, która wymaga wysyłki. Zwraca `false` jeśli żadne pozycje w wersji roboczej zamówienia nie wymagają wysyłki.
`shipping_method.title`	Nazwa stawki wysyłki. Przykład: Wysyłka standardowa
`shipping_method.price`	Cena metody wysyłki. Zwraca te same informacje co `shipping_price`.
`shipping_price`	Cena wysyłki. Tę kwotę można sformatować za pomocą filtrów pieniędzy Liquid.
`shipping_address`	Adres wysyłki. Uwaga: W przeciwieństwie do zwykłych zamówień adres wysyłki wersji roboczej zamówienia może być niekompletny.
`shipping_address.first_name`	Imię podane w adresie wysyłki.
`shipping_address.company`	Nazwa firmy w adresie wysyłki.
`shipping_address.phone`	Numer telefonu w adresie wysyłki.
`line_items`	Lista wszystkich pozycji pojedynczych w wersji roboczej zamówienia.
`item_count`	Suma wszystkich ilości pozycji w wersji roboczej zamówienia.
`note`	Notatka dołączona do wersji roboczej zamówienia. Notatkę można uzyskać od klienta, a także edytować na ekranie szczegółów wersji roboczej zamówienia w panelu administracyjnym Shopify.
`metafields`	Wszelkie metapola w wersji roboczej zamówienia. Użyj następującej składni: metafields.NAMESPACE.KEY
`location`	Fizyczna lokalizacja zamówienia. Dostępnych jest kilka właściwości lokalizacji. Możesz skonfigurować lokalizacje na stronie Lokalizacje w panelu administracyjnym Shopify.
`b2b?`	Zwraca wartość „true”, jeśli zamówienie jest zamówieniem B2B. Użyj tej właściwości ze zmiennymi B2B, aby wyświetlić odpowiednie informacje, takie jak nazwa firmy, lokalizacja firmy i adres w wiadomościach e-mail. Na przykład w przypadku zamówień B2B możesz dodać do szablonu nagłówek z następującymi informacjami: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Firma, której sprzedajesz w ramach zamówienia B2B.
`company.name`	Nazwa firmy w zamówieniu B2B.
`company.id`	ID firmy w zamówieniu B2B.
`company_location`	Lokalizacja firmy w zamówieniu B2B. Firma, która dokonuje u Ciebie zakupów, może mieć więcej niż jedną lokalizację.
`company_location.name`	Nazwa lokalizacji firmy w zamówieniu B2B.
`company_location.id`	Numer ID lokalizacji firmy w zamówieniu B2B.
`company_location.shipping_address`	Adres wysyłki lokalizacji firmy w zamówieniu B2B.
`company_location.billing_address`	Adres rozliczeniowy lokalizacji firmy w zamówieniu B2B.
`payment_methods`	Lista zapisanych metod płatności dostępnych do przetworzenia sumy wersji roboczej.
`payment_method.payment_instrument`	Instrument płatniczy zawierający szczegóły dotyczące zapisanej metody płatności.
`payment_method.payment_instrument.payment_type`	Typ zapisanej metody płatności. Np. „credit_card, apple_pay”
`payment_method.payment_instrument.credit_card_brand`	Marka karty, gdy `payment_type` to „credit_card”
`payment_method.payment_instrument.credit_card_company`	Firma obsługująca kartę, gdy `payment_type` to „credit_card”
`payment_method.payment_instrument.credit_card_company`	Ostatnie 4 cyfry numeru karty, gdy `payment_type` to „credit_card”

Właściwości harmonogramu płatności

Opisy właściwości Liquid, których można używać z obiektem harmonogramu płatności w szablonach powiadomień
Właściwość	Opis
`payment_schedule.amount_due`	Kwota do zapłaty dla harmonogramu płatności. Możesz formatować kwoty z walutami za pomocą filtra money Liquid.
`payment_schedule.due_at`	Termin płatności dla harmonogramu płatności. Daty można formatować za pomocą filtra daty Liquid.
`payment_schedule.due_in_days`	Liczba dni do terminu płatności, jeśli płatność w ramach harmonogramu jest nadal należna (nieopłacona).
`payment_schedule.due_later?`	Zwraca wartość true, jeśli płatność w ramach harmonogramu płatności nie została dokonana, a jej termin płatności przypada w przyszłości.
`payment_schedule.number_of_days_overdue?`	Liczba dni od terminu płatności, jeśli płatność w ramach harmonogramu płatności jest opóźniona.
`payment_schedule.overdue?`	Zwraca wartość true, jeśli płatność w ramach harmonogramu płatności nie została dokonana i upłynął jej termin płatności.

Właściwości statusu płatności

Opisy właściwości Liquid, których można używać z obiektem statusu płatności w szablonach powiadomień
Właściwość	Opis
`has_pending_payment`	(wartość logiczna) Zwraca wartość true, jeśli zamówienie ma transakcję z płatnością oczekującą. Dowiedz się więcej o płatnościach oczekujących.
`buyer_action_required`	(wartość logiczna) Zwraca wartość true, jeśli zamówienie ma transakcję z płatnością oczekującą i do odblokowania płatności wymagane jest działanie kupującego. Gdy ta wartość zwraca true, a metoda płatności obsługuje instrukcje dotyczące płatności, `buyer_pending_payment_instructions` udostępnia szczegóły, których klient może użyć do sfinalizowania zakupu w trybie offline. Dowiedz się więcej o obiekcie transaction Liquid.

Właściwości komponentu pakietu

Każdy element bundle_component na liście line_item.bundle_components ma następujące właściwości. (Tylko wersje robocze zamówień)

Opisy właściwości Liquid, których można używać z obiektem komponentu pakietu w szablonach powiadomień
Właściwość	Opis
`bundle_component.image_url`	Adres URL obrazu komponentu pakietu.
`bundle_component.product.title`	Tytuł produktu komponentu pakietu.
`bundle_component.quantity`	Ilość dla komponentu pakietu.
`bundle_component.variant.title`	Bieżące nazwy wartości opcji wariantu komponentu pakietu, połączone znakami `/`. Przykład: mały / czerwony

Właściwości komponentu

Każdy komponent na liście line_item.components ma następujące właściwości. (Tylko porzucona realizacja zakupu) `

Opisy właściwości Liquid, których można używać z obiektem komponentu w szablonach powiadomień
Właściwość	Opis
`component.image_url`	Adres URL obrazu komponentu.
`component.product.title`	Tytuł produktu komponentu.
`component.quantity`	Ilość dla komponentu.
`component.variant.title`	Bieżące nazwy wartości opcji wariantu komponentu, połączone znakami `/`. Przykład: mały / czerwony

Właściwości pozycji pojedynczej

Każdy wiersz line na liście line_items lub subtotal_line_items ma następujące właściwości.

Opisy właściwości Liquid, których można używać z obiektem pozycji pojedynczej w szablonach powiadomień
Właściwość	Opis
`line.applied_discounts`(POS and draft orders only)	Lista rabatów zastosowanych do tej pozycji (każdy rabat ma właściwości `title`, `code`, `amount`, `savings` i `type`).
`line.bundle_components`(Draft orders only)	Lista pozycji pojedynczych, które są komponentami pakietu tej pozycji. Zwraca listę tylko wtedy, gdy ta pozycja pojedyncza jest produktem w pakiecie.
`line.bundle_parent?`(Draft orders only)	(wartość logiczna) Zwraca wartość true, jeśli pozycja pojedyncza jest produktem w pakiecie.
`line.components`(Abandoned checkout only)	Lista pozycji pojedynczych, które są komponentami tej pozycji.
`line.parent?`(Abandoned checkout only)	(wartość logiczna) Zwraca wartość true, jeśli pozycja pojedyncza ma komponenty.
`line.custom`(Draft orders only)	(wartość logiczna) Zwraca wartość true, jeśli pozycja jest niestandardową pozycją pojedynczą dla wersji roboczej zamówienia.
`line.delivery_agreement`	Umowa o dostawę powiązana z tą pozycją pojedynczą.
`line.grams`	Waga pojedynczej pozycji.
`line.groups`	Grupa pozycji pojedynczych tej pozycji.
`line.image`	Zwraca adres URL obrazu powiązanego z tą pozycją pojedynczą. Możesz również użyć filtra img_url, aby uzyskać obrazy o określonych rozmiarach, na przykład `{{ line.image \| img_url: 'small' }}`
`line.line_price`	Cena pomnożona przez ilość dla danej pozycji.
`line.original_line_price`	Łączna cena za ilość pozycji zawartych w wierszu przed zastosowaniem rabatów.
`line.final_line_price`	Łączna cena wszystkich pozycji w pozycji pojedynczej, z uwzględnieniem wszystkich kwot rabatów na poziomie pozycji.
`line.pre_tax_price`	Cena przed opodatkowaniem dla pozycji pojedynczych pomnożona przez ilość zakupionych pozycji pojedynczych.
`line.price`	Cena za pojedynczą pozycję.
`line.product.metafields`	Wszystkie metapola na poziomie produktu. Użyj następującej składni: line.product.metafields.NAMESPACE.KEY
`line.product.title`	Bieżąca nazwa produktu.
`line.product.vendor`	Dostawca dla pozycji.
`line.properties`	Zwraca tablicę niestandardowych informacji dla pozycji. Właściwości pozycji pojedynczej są określane przez klienta na stronie produktu przed dodaniem produktu do koszyka.
`line.quantity`	Ilość dla tej pozycji.
`line.current_quantity`	Bieżąca ilość pozycji po usunięciu.
`line.requires_shipping`	(wartość logiczna) Zwraca wartość true, jeśli wariant pozycji ma aktywowane ustawienie Produkt fizyczny na stronie produktu.
`line.selling_plan_allocation`	Zwraca obiekt `selling_plan_allocation`, który opisuje, w jaki sposób plan sprzedaży, taki jak subskrypcja, wpływa na pozycję pojedynczą.
`line.taxable`	(wartość logiczna) Zwraca wartość true, jeśli wariant dla pozycji ma zaznaczone pole wyboru „Pobierz podatki od tego produktu” na stronie produktu.
`line.title`	Nazwa produktu w momencie sprzedaży, po której następuje myślnik i nazwa wariantu w momencie sprzedaży. Nazwa wariantu nie jest uwzględniana, jeśli jest to „Default Title”. W powiadomieniach skierowanych do klientów nazwa produktu i nazwa wariantu są tłumaczone na język, w którym klient dokonał realizacji zakupu, jeśli język ten różni się od domyślnego języka sklepu.
`line.url`	Względny adres URL wariantu pozycji pojedynczej. Względny adres URL nie zawiera głównego adresu URL sklepu (`mystore.myshopify.com`).
`line.variant.barcode`	Kod kreskowy powiązany z wariantem produktu.
`line.variant.compare_at_price`	Cena porównawcza powiązana z wariantem produktu.
`line.variant.image`	Obraz wariantu produktu. Obraz jest zwracany tylko wtedy, gdy do wariantu w pozycji pojedynczej przypisano określony obraz.
`line.variant.metafields`	Wszelkie metapola na poziomie wariantu. Użyj następującej składni: line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	SKU powiązany z wariantem produktu.
`line.variant.title`	Aktualne nazwy wartości opcji wariantu, połączone znakami `/`. Przykład: mały / czerwony
`line.refunded.quantity`(within refund notifications)	Ilość pozycji, której koszt ma zostać zwrócony. Możesz użyć tej właściwości, aby dodać identyfikator do pozycji objętych zwrotem kosztów w zamówieniu. Na przykład: `{% if line.refunded_quantity > 0 %}Identyfikator pozycji objętej zwrotem kosztów{% endif %}`

Wykrywanie pozycji Shopify Collective w szablonach powiadomień

Tag Shopify Collective jest dodawany do zamówienia po wysłaniu e-maila z potwierdzeniem zamówienia, dlatego wyrażenie {% if tags contains 'Shopify Collective' %} nigdy nie ma wartości true w szablonie potwierdzenia zamówienia. Aby wykryć pozycje Shopify Collective, zamiast tego sprawdź tagi na poziomie produktu w każdej pozycji pojedynczej:

{% 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 %}

Właściwości grupy pozycji pojedynczych

Każda grupa line_item_group na liście line_item_groups ma następujące właściwości.

Opisy właściwości Liquid, których można używać z obiektem grupy pozycji pojedynczych w szablonach powiadomień
Właściwość	Opis
`line_item_group.display_title`	Tytuł grupy pozycji pojedynczych.
`line_item_group.components`	Lista elementów pozycji pojedynczej należących do grupy.
`line_item_group.image`	Obraz grupy pozycji pojedynczych.
`line_item_group.product_id`	ID produktu grupy pozycji pojedynczych.
`line_item_group.variant`	Obiekt wariantu grupy pozycji pojedynczych.
`line_item_group.variant_id`	ID wariantu grupy pozycji pojedynczych.

Właściwości zwrotów kosztów

Opisy właściwości Liquid, których można używać z obiektem zwrotu kosztów w szablonach powiadomień
Właściwość	Opis
`amount`	Zwrócona kwota pieniędzy.
`refund_line_items`	Lista pozycji pojedynczych zwrotu kosztów, których koszt ma zostać zwrócony.

Właściwości pozycji pojedynczej zwrotu kosztów

Każda pozycja refund_line na liście refund_line_items ma następujące właściwości:

Opisy właściwości Liquid, których można używać z obiektem pozycji pojedynczych zwrotu kosztów w szablonach powiadomień
Właściwość	Opis
`refund_line.line_item`	Pozycja line_item, której koszt jest zwracany. Zapewnia to dostęp do wszystkich właściwości line_item.
`refund_line.quantity`	Ilość pozycji pojedynczej, której koszt ma zostać zwrócony.

Właściwości realizacji

Opisy właściwości Liquid, których można używać z obiektem realizacji w szablonach powiadomień
Właściwość	Opis
`service_name`	Nazwa usługi niestandardowej zdefiniowana na stronie Ustawienia > Wysyłka i dostawa. (Tylko żądanie realizacji)
`fulfillment.estimated_delivery_at`	Szacowana data dostawy na podstawie numeru śledzenia (jeśli jest dostępny) podanego przez jednego z następujących przewoźników: USPS, FedEx, UPS, Canada Post (tylko w Kanadzie). Ta właściwość jest dostępna tylko wtedy, gdy używane są stawki obliczane przez przewoźnika.
`fulfillment.fulfillment_line_items`	Lista pozycji pojedynczych realizacji do zrealizowania.
`fulfillment.item_count`	Suma ilości wszystkich pozycji. Całkowita liczba realizowanych pozycji.
`fulfillment.requires_shipping`	(wartość logiczna) Zwraca wartość „true”, jeśli to żądanie realizacji wymaga wysyłki.
`fulfillment.tracking_company`	Firma zapewniająca śledzenie.
`fulfillment.tracking_numbers`	Lista numerów śledzenia.
`fulfillment.tracking_urls`	Lista adresów URL śledzenia.
`items_to_fulfill`(deprecated)	Lista pozycji pojedynczych, które mają być realizowane przez tę konkretną niestandardową usługę realizacji. (Tylko żądanie realizacji)
`items_to_fulfill_count`(deprecated)	Łączna liczba pozycji do zrealizowania w ramach tego żądania. (Tylko żądanie realizacji)

Właściwości pozycji pojedynczej realizacji

Każda pozycja fulfillment_line na liście fulfillment_line_items ma następujące właściwości.

Opisy właściwości Liquid, których można używać z obiektem pozycji pojedynczych realizacji w szablonach powiadomień
Właściwość	Opis
`fulfillment_line.line_item`	Pozycja line_item, która jest realizowana. Zapewnia to dostęp do wszystkich właściwości line_item.
`fulfillment_line.quantity`	Ilość pozycji pojedynczej, która jest realizowana.

Właściwości przygotowanej paczki

Przygotowana paczka zawiera pozycje oznaczone jako gotowe do odbioru.

Opisy właściwości Liquid, których można używać z obiektem przygotowanej paczki w szablonach powiadomień
Właściwość	Opis
`item_count`	Suma ilości wszystkich pozycji w przygotowanej paczce.
`prepared_package_line_items`	Lista pozycji pojedynczych przygotowanej paczki.

Właściwości pozycji pojedynczej przygotowanej paczki

Każda pozycja prepared_package_line_item na liście prepared_package_line_items ma następujące właściwości.

Opisy właściwości Liquid, których można używać z obiektem pozycji pojedynczej przygotowanej paczki w szablonach powiadomień
Właściwość	Opis
`line_item`	Powiązana pozycja line_item. Zapewnia to dostęp do wszystkich właściwości line_item.
`quantity`	Ilość pozycji pojedynczej, która została oznaczona jako gotowa do odbioru.

Właściwości dostawy

Opisy właściwości Liquid, których można używać z obiektem dostawy w szablonach powiadomień
Właściwość	Opis
`delivery_agreements`	Lista wszystkich umów dotyczących dostawy dla zamówienia.
`delivery_instructions`	Informacje o dostawie lokalnej do udostępnienia klientowi. Informacje te są kontrolowane przez pole Informacje o dostawie w ustawieniach dostawy lokalnej.
`consolidated_estimated_delivery_time`	Informacje o datach dostawy zamówienia do udostępnienia klientowi. Informacje te są kontrolowane przez ustawienie Czas przetwarzania skonfigurowane na stronie Wysyłka i dostawa. Jeśli zamówienie ma wiele metod dostawy, wyświetlana jest lista metod dostawy i dat.
`has_multiple_delivery_methods`	(wartość logiczna) Zwraca wartość „true”, jeśli zamówienie ma wiele metod dostawy.

Właściwości umowy dotyczącej dostawy

Opisy właściwości Liquid, których można używać z obiektem umowy dotyczącej dostawy w szablonach powiadomień
Właściwość	Opis
`delivery_agreement.delivery_method_type`	Typ metody dostawy.
`delivery_agreement.delivery_method_name`	Typ metody dostawy przetłumaczony na język, w którym kupujący zrealizował transakcję, jeśli jest on inny niż domyślny język sklepu.
`delivery_agreement.line_item_groups`	Lista wszystkich grup pozycji pojedynczych zawierających połączone w zestaw elementy pozycji pojedynczej w umowie dotyczącej dostawy.
`delivery_agreement.line_items`	Lista wszystkich pozycji pojedynczych powiązanych z tą umową dotyczącą dostawy.

Właściwości rabatu

Istnieją dwa rodzaje właściwości rabatu.

discount_applications opisują, dlaczego i w jaki sposób dana pozycja została objęta rabatem.

discount_allocations opisują, jak dany rabat wpływa na pozycję pojedynczą i jak obniża cenę. Tej właściwości należy używać na poziomie pozycji pojedynczej.

Możesz połączyć te właściwości, aby wyświetlić informacje o rabacie na poziomie pozycji pojedynczej lub zamówienia.

Przykład

W tym przykładzie sprawdzane jest, czy do pozycji pojedynczej zastosowano rabat. Jeśli rabat nie został zastosowany na poziomie zamówienia (all), wyświetlana jest nazwa i kwota rabatu.

{% 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 %}

Wynik może być podobny do następującego:

SPRING5 (-$5.00)

Właściwości discount_allocation

Każdy obiekt discount_allocation na liście discount_allocations ma następujące właściwości.

Opisy właściwości Liquid, których można używać z obiektem discount_allocation w szablonach powiadomień
Właściwość	Opis
`discount_allocation.amount`	Kwota pieniędzy zaoszczędzona przez klienta na pozycji pojedynczej. Należy wprowadzić ją w pętli, jeśli chcesz zezwolić na stosowanie wielu kodów rabatowych.
`discount_allocation.discount_application`	Zastosowanie rabatu, które alokuje kwotę do pozycji pojedynczej.

Właściwości discount_application

Każdy obiekt discount_application na liście discount_applications ma następujące właściwości.

Opisy właściwości Liquid, których można używać z obiektem discount_application w szablonach powiadomień
Właściwość	Opis
`discount_application.target_selection`	Opisuje, w jaki sposób rabat wybiera pozycje pojedyncze w koszyku do objęcia rabatem. Jedna z opcji: `all`: rabat ma zastosowanie do wszystkich pozycji pojedynczych. `entitled`: rabat ma zastosowanie do określonego podzbioru pozycji pojedynczych, często zdefiniowanego przez warunek. `explicit`: rabat ma zastosowanie do konkretnie wybranej pozycji pojedynczej lub pozycji wysyłki.
`discount_application.target_type`	Typ pozycji, do której odnosi się rabat (`line_item` lub `shipping_line`).
`discount_application.title`	Nazwa rabatu wyświetlana klientowi. Przykłady: Welcome10 lub CBBWQQAKYBYY
`discount_application.total_allocated_amount`	Całkowita kwota, o którą rabat obniża cenę zamówienia.
`discount_application.type`	Typ rabatu. Jedna z opcji: `automatic`, `discount_code`, `manual` lub `script`.
`discount_application.value`	Wartość rabatu.
`discount_application.value_type`	Typ wartości rabatu. Jedna z opcji: `fixed_amount` lub `percentage`.

Właściwości subskrypcji

Szczegóły umowy subskrypcyjnej, bieżący cykl rozliczeniowy oraz pozycje pojedyncze, metoda dostawy i metoda płatności są dostępne dla wszystkich szablonów e-maili dotyczących subskrypcji.

Aby edytować szablony powiadomień o subskrypcjach, zainstaluj aplikację Shopify Subscriptions, a następnie znajdź szablon w sekcji Ustawienia > Powiadomienia w sekcji Subscriptions.

Właściwości cyklu rozliczeniowego umowy subskrypcyjnej

Aby uzyskać dostęp do właściwości umowy subskrypcyjnej i jej cyklu rozliczeniowego, użyj obiektu subscription_contract_billing_cycle.

Przykład

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Wynik:

This contract is currently paused.

Właściwości

Opisy właściwości Liquid, których można używać z obiektem subscription_contract_billing_cycle w szablonach powiadomień
Właściwość	Opis
`status`	Status kontraktu. Jeden z następujących: `active`, `paused`, `cancelled`, `failed`, `expired`, `stale`,
`delivery_method`	Metoda dostawy subskrypcji. Jeśli subskrypcja dotyczy usługi lub produktu cyfrowego, zwracana jest wartość `nil`.
`billing_frequency`	Jak często subskrypcja jest rozliczana.
`delivery_frequency`	Jak często subskrypcja jest dostarczana.
`origin_order`	Oryginalne zamówienie, na podstawie którego utworzono subskrypcję. Jeśli subskrypcja nie została utworzona na podstawie zamówienia Shopify, zwracana jest wartość `nil`.
`customer`	Klient subskrypcji.
`line_items`	Pozycje pojedyncze w cyklu rozliczeniowym subskrypcji.
`product_names`	Lista nazw produktów zawartych w cyklu rozliczeniowym subskrypcji.
`update_payment_method_url`	Adres URL, za pomocą którego klient może zaktualizować metodę płatności dla tego kontraktu.
`shipping_address`	Adres wysyłki subskrypcji. Jeśli subskrypcja dotyczy usługi lub produktu cyfrowego, zwracana jest wartość `nil`.
`billing_address`	Adres rozliczeniowy subskrypcji.
`subtotal_price`	Suma częściowa ceny pozycji pojedynczych subskrypcji.
`shipping_price`	Cena wysyłki subskrypcji.
`total_tax`	Całkowity podatek od subskrypcji.
`total_price`	Całkowita cena subskrypcji.
`total_discounts`	Suma rabatów dla subskrypcji.
`customer_self_serve_url`	Samoobsługowy adres URL, za pomocą którego klient może zarządzać subskrypcjami.
`billing_attempt_expected_date`	Data rozliczenia dla tego cyklu rozliczeniowego.
`next_billing_date`	Następna niepominięta data rozliczenia po tym cyklu rozliczeniowym.
`last_attempted_billing_date`	Data ostatniej próby rozliczenia dla cyklu rozliczeniowego.
`days_overdue`	Liczba dni zaległości w płatnościach dla tego cyklu rozliczeniowego.
`payment_instrument`	Instrument płatniczy powiązany z umową subskrypcyjną. Ten instrument płatniczy jest używany do obciążania klienta.

Właściwości pozycji pojedynczej umowy subskrypcyjnej

Właściwości dla każdej pozycji pojedynczej zawartej w cyklu rozliczeniowym. Dostęp do właściwości pozycji pojedynczej umowy można uzyskać za pośrednictwem nadrzędnej właściwości subscription_contract_billing_cycle.line_items.

Przykład

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

Opisy właściwości Liquid, których można używać z obiektem pozycji pojedynczej umowy subskrypcyjnej w szablonach powiadomień
Właściwość	Opis
`url`	Adres URL strony szczegółów produktu dla wariantu produktu z pozycji pojedynczej.
`requires_shipping`	Określa, czy pozycja pojedyncza wymaga wysyłki fizycznej.
`unit_price_measurement`	Pomiar ceny jednostkowej pozycji pojedynczej.
`selling_plan_allocation`	Alokacja planu sprzedaży dla pozycji pojedynczej.

Właściwości metody dostawy umowy subskrypcyjnej

Właściwości metody dostawy używanej w tym cyklu rozliczeniowym. Dostęp do właściwości metody dostawy można uzyskać za pośrednictwem nadrzędnej właściwości subscription_contract_billing_cycle.delivery_method.

Przykład

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

Opisy właściwości Liquid, których możesz używać z obiektem metody dostawy umowy subskrypcyjnej w szablonach powiadomień.
Właściwość	Opis
`title`	Tytuł opcji wysyłki powiązanej z metodą dostawy.
`type`	Typ metody dostawy. Jedna z następujących wartości: `shipping`, `local` lub `pick-up`.

Właściwości instrumentu płatniczego umowy subskrypcyjnej

Szczegółowe informacje o instrumencie płatniczym dla umowy subskrypcyjnej. Ten instrument płatniczy jest używany do obciążania klienta. Dostęp do właściwości instrumentu płatniczego można uzyskać za pośrednictwem nadrzędnej właściwości subscription_contract_billing_cycle.payment_instrument.

Przykład

{% 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 }}

Opisy właściwości Liquid, których możesz używać z obiektem instrumentu płatniczego umowy subskrypcyjnej w szablonach powiadomień.
Właściwość	Opis
`payment_type`	Typ metody płatności reprezentowanej przez instrument płatniczy. Użyj filtrów płatności, aby wyświetlić adres URL obrazu lub plik SVG.
`credit_card_brand`	Marka karty kredytowej.
`credit_card_company`	Nazwa wydawcy karty kredytowej.
`credit_card_last_four_digits`	Ostatnie 4 cyfry numeru karty kredytowej.

Właściwości powiadomień e-mail

Opisy właściwości Liquid, których możesz używać z obiektem powiadomień e-mail w szablonach powiadomień.
Właściwość	Opis
`shop.email_logo_url`	Adres URL logo określony w sekcji Dostosuj szablony e-maili w panelu administracyjnym.
`shop.email_logo_width`	Szerokość logo (w pikselach) określona w sekcji Dostosuj szablony e-maili w panelu administracyjnym.
`shop.email_accent_color`	Kod HEX koloru akcentu określony w sekcji Dostosuj szablony e-maili w panelu administracyjnym.

Właściwości kredytów sklepowych

Właściwości zawierające szczegółowe informacje o przyznaniu kredytu sklepowego.

Opisy właściwości Liquid, których możesz używać z obiektem przyznanego kredytu sklepowego w szablonach powiadomień.
Właściwość	Opis
`issued_store_credit.amount`	Kwota przyznanego kredytu sklepowego. Tę kwotę można sformatować za pomocą filtrów pieniędzy Liquid.
`issued_store_credit.expires_at`	Data i godzina wygaśnięcia przyznanego kredytu sklepowego. Możesz sformatować tę wartość za pomocą filtrów dat Liquid.
`issued_store_credit.balance_after_transaction`	Saldo konta kredytowego sklepu po przyznaniu kredytu. Tę kwotę można sformatować za pomocą filtrów pieniędzy Liquid.
`customer`	Obiekt klienta zawierający atrybuty klienta.