ข้อมูลอ้างอิงเกี่ยวกับตัวแปรการแจ้งเตือน
การแจ้งเตือนที่ส่งออกจากร้านค้าของคุณจะแสดงผลโดยใช้ Liquid โดย Liquid คือภาษาโปรแกรมที่เรียบง่ายและใช้งานง่ายของ Shopify ซึ่งเป็นภาษาโปรแกรมเดียวกับที่ใช้สร้างธีมจาก Theme Store
หากต้องการแก้ไขการแจ้งเตือนที่ส่งจากร้านค้าของคุณ คุณสามารถปรับแต่งเทมเพลตการแจ้งเตือนของคุณในขั้นพื้นฐานได้ หากต้องการเข้าถึงรายการการแจ้งเตือนทั้งหมดที่คุณสามารถปรับแต่งได้ ให้ไปที่หน้าการแจ้งเตือนในส่วนผู้ดูแล Shopify ของคุณ
หากต้องการความช่วยเหลือเกี่ยวกับการเปลี่ยนแปลงขั้นสูง หรือต้องการเปลี่ยนแปลงเทมเพลตการแจ้งเตือนแบบกำหนดเอง คุณสามารถติดต่อชุมชนได้ในฟอรัมของเรา หรือคุณสามารถจ้าง Shopify Partner เพื่อปรับแต่งให้คุณได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการจ้าง Shopify Partner
ในหน้านี้
- คุณสมบัติของคำสั่งซื้อ
- คุณสมบัติของคำสั่งซื้อที่ยังไม่ชำระเงิน
- คุณสมบัติของกำหนดการชำระเงิน
- คุณสมบัติของสถานะการชำระเงิน
- คุณสมบัติของส่วนประกอบชุดสินค้า
- คุณสมบัติของส่วนประกอบ
- คุณสมบัติของสินค้าเฉพาะรายการ
- คุณสมบัติของกลุ่มสินค้าเฉพาะรายการ
- คุณสมบัติของการคืนเงิน
- คุณสมบัติของการจัดการคำสั่งซื้อ
- คุณสมบัติของบรรจุภัณฑ์ที่เตรียมไว้
- คุณสมบัติของการส่ง
- คุณสมบัติของส่วนลด
- คุณสมบัติของการสมัครใช้งาน
- คุณสมบัติของการแจ้งเตือนทางอีเมล
- คุณสมบัติของเครดิตร้านค้า
คุณสมบัติของคำสั่งซื้อ
คุณสมบัติของคำสั่งซื้อหลายรายการมีให้ใช้งานได้โดยตรงโดยใช้ Liquid และในเทมเพลต
| คุณสมบัติ | คำอธิบาย |
|---|---|
id |
ID ที่ไม่ซ้ำกันทั้งระบบของคำสั่งซื้อสำหรับการใช้งานภายใน ใช้ตัวอย่างต่อไปนี้เพื่อสร้างลิงก์ไปยังคำสั่งซื้อในส่วนผู้ดูแลของร้านค้าคุณ ตัวอย่างเช่น ในเทมเพลตคำสั่งซื้อใหม่ คุณสามารถเพิ่มรหัสต่อไปนี้ได้ ดูคำสั่งซื้อ
|
email | อีเมลที่เชื่อมโยงกับคำสั่งซื้อ |
name |
โดยปกติแล้วจะเป็นสัญลักษณ์ # ตามด้วย ตัวอย่าง: #1004 |
order_name | เหมือนกับ name |
order_number |
หมายเลขคำสั่งซื้อที่ไม่ซ้ำกันในร้านค้า โดยไม่มีคำนำหน้าเป็นสัญลักษณ์ # หรือไม่มีคำนำหน้า/คำต่อท้ายใดๆ ที่เจ้าของร้านค้าเพิ่มไว้ใน ID คำสั่งซื้อในการตั้งค่าร้านค้าของตน ตัวอย่าง: 1004 |
confirmation_number | ตัวระบุที่เป็นตัวอักษรและตัวเลขซึ่งสร้างขึ้นแบบสุ่มสำหรับคำสั่งซื้อที่อาจแสดงให้ลูกค้าเห็นแทนชื่อคำสั่งซื้อตามลำดับ โดยค่านี้ไม่รับประกันว่าจะไม่ซ้ำกัน ตัวอย่าง: XPAV284CT |
created_at |
วันที่และเวลาที่ลูกค้าสร้างคำสั่งซื้อ คุณสามารถจัดรูปแบบข้อมูลนี้ได้โดยใช้ตัวกรองวันที่ ตัวอย่าง: 2009-05-30T17:43:51+02:00 |
payment_terms |
เงื่อนไขการชำระเงินจะระบุวันที่ที่ต้องชำระเงินสำหรับคำสั่งซื้อ ดูวิธีเพิ่มเงื่อนไขการชำระเงินไปยังใบแจ้งหนี้ของคำสั่งซื้อ สำหรับรายละเอียดเพิ่มเติม โปรดดูข้อมูลอ้างอิง Liquid สำหรับpayment_terms |
destination | ปลายทางที่ควรจัดส่งรายการไป |
tags | ส่งคืนอาร์เรย์ของแท็กคำสั่งซื้อทั้งหมด โดยจะแสดงแท็กตามลำดับตัวอักษร แท็กที่เพิ่มแบบไดนามิกผ่านแอปหรือฟีเจอร์ของแพลตฟอร์ม เช่น แท็ก Shopify Collective อาจไม่มีให้ใช้งานเมื่อระบบสร้างอีเมลการแจ้งเตือน หากต้องการตรวจหารายการจากฟีเจอร์ใดฟีเจอร์หนึ่ง ให้ตรวจสอบแท็กระดับสินค้าในสินค้าเฉพาะรายการแต่ละรายการแทน ดูรายละเอียดเพิ่มเติมได้ในเอกสารอ้างอิง Liquid |
transactions | ส่งคืนอาร์เรย์ของธุรกรรมจากคำสั่งซื้อ |
tax_price | ภาษีรวมของทุกรายการในคำสั่งซื้อ |
tax_lines |
ภาษีที่จำแนกตามประเภทของการเก็บภาษีมีดังนี้
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | ชื่อของภาษี ตัวอย่างเช่น QST หรือ VAT |
tax_line.price | จำนวนภาษี |
tax_line.rate | อัตราภาษีในรูปแบบทศนิยม โดยจะส่งคืนค่า 0.175 หากเป็น 17.5% |
tax_line.rate_percentage | อัตราภาษีในรูปแบบที่อ่านเข้าใจง่าย โดยจะส่งคืนค่า 17.5 หากอัตราคือ 0.175 |
customer | อ็อบเจกต์ลูกค้าที่มีคุณลักษณะของเอาท์พุตลูกค้า |
billing_address | ที่อยู่สำหรับเรียกเก็บเงิน |
billing_address.first_name | ชื่อของลูกค้า |
billing_address.last_name | นามสกุลของลูกค้า |
billing_address.company | ชื่อบริษัทสำหรับการเรียกเก็บเงิน |
billing_address.phone | หมายเลขโทรศัพท์จากที่อยู่สำหรับเรียกเก็บเงิน |
shop.name | ชื่อร้านค้าของคุณ |
shop.phone | หมายเลขโทรศัพท์ของร้านค้าคุณ |
subtotal_price | ผลรวมราคาสินค้าเฉพาะรายการของคำสั่งซื้อหลังจากหักส่วนลดของสินค้าเฉพาะรายการหรือส่วนลดสำหรับตะกร้าสินค้าแล้ว ยอดรวมนี้ไม่รวมภาษี (เว้นแต่จะมีการรวมภาษีไว้ในราคา) ค่าจัดส่ง หรือทิป |
discounts | รายการส่วนลด |
discounts_amount | จำนวนส่วนลดทั้งหมดที่ใช้ ตัวอย่าง: +$5.00 |
discounts_savings | จำนวนเงินที่ประหยัดได้จากส่วนลดทั้งหมด ตัวอย่าง: -$5.00 |
total_price |
ยอดรวมของคำสั่งซื้อ (ยอดรวม + ค่าจัดส่ง - ส่วนลดค่าจัดส่ง + ภาษี) |
financial_status | สถานะการชำระเงินปัจจุบัน โดยจะเป็นสถานะใดสถานะหนึ่งจาก: nil, `pending`, `authorized`, `paid`, `voided`, `refunded` |
requires_shipping | (บูลีน) ส่งคืนค่าจริงหากมีสินค้าอย่างน้อยหนึ่งรายการในคำสั่งซื้อที่ต้องมีการจัดส่ง |
shipping_method.title | ชื่ออัตราค่าจัดส่ง ในการแจ้งเตือนที่แสดงต่อลูกค้า ชื่ออัตราค่าจัดส่งจะได้รับการแปลเป็นภาษาที่ลูกค้าใช้ระหว่างการชำระเงิน เมื่อภาษานั้นแตกต่างจากภาษาเริ่มต้นของร้านค้า ตัวอย่าง: Standard Shipping |
shipping_method.price |
ราคาค่าจัดส่งซึ่งรวมส่วนลดค่าจัดส่ง ตัวอย่าง: |
shipping_price |
ราคาค่าจัดส่ง ตัวอย่าง: |
shipping_address | ที่อยู่ที่จัดส่ง |
shipping_address.first_name | ชื่อสำหรับที่อยู่ที่จัดส่ง |
shipping_address.company | ชื่อบริษัทสำหรับที่อยู่ที่จัดส่ง |
shipping_address.phone | หมายเลขโทรศัพท์จากที่อยู่ที่จัดส่ง |
line_items | รายการสินค้าเฉพาะรายการทั้งหมดในคำสั่งซื้อ |
line_items_including_zero_quantity | รายการสินค้าเฉพาะรายการทั้งหมดในคำสั่งซื้อ ซึ่งรวมถึงรายการที่มีจำนวนเป็นศูนย์ ทั้งนี้ สินค้าเฉพาะรายการจะมีจำนวนเป็นศูนย์เมื่อได้รับการคืนเงินเต็มจำนวนแล้ว |
line_item_groups(Orders and POS only) | รายการกลุ่มสินค้าเฉพาะรายการทั้งหมดที่มีส่วนประกอบของสินค้าเฉพาะรายการในคำสั่งซื้อ |
item_count | ผลรวมของจำนวนรายการทั้งหมด |
fulfillment_status | สถานะการจัดการคำสั่งซื้อปัจจุบันของคำสั่งซื้อ โดยจะเป็นสถานะใดสถานะหนึ่งจาก: `unfulfilled`, `partial`, `fulfilled` |
note | โน้ตที่แนบมากับคำสั่งซื้อ โดยสามารถรับโน้ตจากลูกค้าและ/หรือแก้ไขในหน้าจอรายละเอียดคำสั่งซื้อในแผงผู้ดูแลของคุณได้ |
attributes |
คุณลักษณะใดๆ ที่แนบมากับคำสั่งซื้อ ตัวอย่าง: |
metafields |
เมตาฟิลด์ใดๆ ในคำสั่งซื้อ ใช้ไวยากรณ์ดังต่อไปนี้ metafields.NAMESPACE.KEY |
referring_site |
ประกอบด้วย URL ของช่องทางแนะนำที่นำลูกค้ามายังร้านค้าของคุณ ตัวอย่าง: |
landing_site |
ประกอบด้วยเส้นทางของเว็บไซต์เริ่มต้นที่ลูกค้าใช้ นี่คือหน้าแรกที่ลูกค้าเห็นเมื่อเข้ามาที่ร้านค้า ตัวอย่าง: |
landing_site_ref |
ตรวจสอบเว็บไซต์ที่เข้าชมและดึงพารามิเตอร์อ้างอิงออกมา พารามิเตอร์อ้างอิงได้แก่ หาก
{% if landing_site_ref == 'my-tracking-token' %}
My action...
{% endif %}
|
cancelled | (บูลีน) ส่งคืนค่าจริงหากคำสั่งซื้อถูกยกเลิกแล้ว |
cancelled_at | เวลาที่คำสั่งซื้อถูกยกเลิก |
cancel_reason | เหตุผลที่เลือกเมื่อยกเลิกคำสั่งซื้อ โดยจะเป็นเหตุผลใดเหตุผลหนึ่งจาก: `inventory`, `customer`, `declined`, `fraud` หรือ `other` |
has_high_risks?(deprecated) | ส่งคืนค่าจริงหากคำสั่งซื้อมีความเสี่ยงสูง |
unique_gateways |
แสดงรายการผู้ให้บริการการชำระเงินที่ไม่ซ้ำกันในคำสั่งซื้อ ตัวอย่างเช่น หากมีผู้ชำระเงินด้วย Visa, Mastercard และเงินสด รายการที่แสดงผลจะเป็น |
location(POS only) |
แสดงตำแหน่งที่ตั้งจริงของคำสั่งซื้อ มีคุณสมบัติตำแหน่งที่ตั้งให้ใช้งานอยู่หลายรายการซึ่งระบุไว้ที่นี่ คุณสามารถกำหนดค่าตำแหน่งที่ตั้งได้ในส่วนตำแหน่งที่ตั้งของแผงผู้ดูแล |
order_status_url |
แสดงลิงก์ไปยังหน้าแสดงสถานะคำสั่งซื้อสำหรับคำสั่งซื้อนี้ |
fulfilled_line_items(deprecated) | รายการสินค้าเฉพาะรายการที่จัดการแล้ว |
unfulfilled_line_items(deprecated) | รายการสินค้าเฉพาะรายการที่ยังจัดการไม่เสร็จสมบูรณ์ |
b2b? |
แสดงผลเป็น 'จริง' หากคำสั่งซื้อเป็นคำสั่งซื้อแบบ B2B ใช้คุณสมบัตินี้กับตัวแปร B2B เพื่อแสดงข้อมูลที่เกี่ยวข้อง เช่น ชื่อบริษัท ตำแหน่งที่ตั้งของบริษัท และที่อยู่ในอีเมล ตัวอย่างเช่น ในคำสั่งซื้อแบบ B2B คุณอาจเพิ่มส่วนหัวไปยังเทมเพลตพร้อมข้อมูลต่อไปนี้
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | บริษัทที่คุณขายสินค้าให้ในคำสั่งซื้อแบบ B2B |
company.name | ชื่อบริษัทในคำสั่งซื้อแบบ B2B |
company.id | ID ของบริษัทในคำสั่งซื้อแบบ B2B |
company_location | ตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B บริษัทที่ซื้อสินค้าจากคุณสามารถมีตำแหน่งที่ตั้งได้มากกว่าหนึ่งแห่ง |
company_location.name | ชื่อตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
company_location.id | หมายเลข ID ของตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
company_location.shipping_address | ที่อยู่ที่จัดส่งของตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
company_location.billing_address | ที่อยู่สำหรับเรียกเก็บเงินของตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
customer_order_url | หน้าแสดงสถานะคำสั่งซื้อใหม่ของคำสั่งซื้อที่ลูกค้าร้องขอการคืนสินค้าโดยใช้บัญชีลูกค้า |
คุณสมบัติของคำสั่งซื้อที่ยังไม่ชำระเงิน
| คุณสมบัติ | คำอธิบาย |
|---|---|
id | ID เฉพาะของคำสั่งซื้อที่ยังไม่ชำระเงินสำหรับการใช้งานภายใน |
invoice_url | ลิงก์ที่ลูกค้าสามารถคลิกเพื่อชำระเงินสำหรับใบแจ้งหนี้โดยใช้การชำระเงินอย่างปลอดภัยของ Shopify |
reserve_inventory_until |
วันที่และเวลาที่สินค้าเฉพาะรายการในคำสั่งซื้อที่ยังไม่ชำระเงินถูกสงวนไว้จนถึง ตัวอย่างเช่น คุณสามารถจัดรูปแบบวันที่ได้โดยใช้ตัวกรองวันที่ของ Liquid |
user | พนักงานคนล่าสุดที่แก้ไขคำสั่งซื้อที่ยังไม่ชำระเงิน |
user.name | ชื่อของพนักงานคนล่าสุดที่แก้ไขคำสั่งซื้อที่ยังไม่ชำระเงิน |
user.email | ที่อยู่อีเมลของพนักงานคนล่าสุดที่แก้ไขคำสั่งซื้อที่ยังไม่ชำระเงิน |
email | ที่อยู่อีเมลที่เชื่อมโยงกับคำสั่งซื้อที่ยังไม่ชำระเงิน |
name | ที่เป็นเอกลักษณ์ของ number คำสั่งซื้อที่ยังไม่ชำระเงิน ซึ่งนำหน้าด้วยเครื่องหมายตัวเลข # |
number | หมายเลขเฉพาะของคำสั่งซื้อที่ยังไม่ชำระเงินโดยไม่มีคำนำหน้าหรือคำต่อท้ายคำสั่งซื้อ |
created_at |
วันที่และเวลาที่ลูกค้าสร้างคำสั่งซื้อที่ยังไม่ชำระเงิน ตัวอย่างเช่น คุณสามารถจัดรูปแบบวันที่ได้โดยใช้ตัวกรองวันที่ของ Liquid |
tags | ส่งคืนอาร์เรย์ของแท็กทั้งหมดของคำสั่งซื้อ แท็กจะส่งคืนตามลำดับตัวอักษร โปรดดูเอกสารอ้างอิง Liquid สำหรับรายละเอียดเพิ่มเติม |
tax_price | ภาษีรวมของทุกรายการในคำสั่งซื้อที่ยังไม่ชำระเงิน |
tax_lines |
ภาษีที่แยกตามประเภทของภาษีดังนี้
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | ชื่อของภาษี ตัวอย่าง: QST หรือ VAT |
tax_line.price | จำนวนเงินภาษี |
tax_line.rate | อัตราภาษีในรูปแบบทศนิยม ตัวอย่างเช่น อัตราภาษี 17.5% จะแสดงผลเป็น 0.175 |
tax_line.rate_percentage | อัตราภาษีในรูปแบบเปอร์เซ็นต์ ตัวอย่างเช่น rate ที่ 0.175 จะแสดงผลเป็น 17.5 |
customer | อ็อบเจกต์ลูกค้าที่มีคุณลักษณะของเอาท์พุตลูกค้า |
billing_address | ที่อยู่สำหรับเรียกเก็บเงินสำหรับคำสั่งซื้อที่ยังไม่ชำระเงิน |
billing_address.first_name | ชื่อของลูกค้า |
billing_address.last_name | นามสกุลของลูกค้า |
billing_address.company | ชื่อบริษัทในที่อยู่สำหรับเรียกเก็บเงิน |
billing_address.phone | หมายเลขโทรศัพท์ในที่อยู่สำหรับเรียกเก็บเงิน |
shop.name | ชื่อร้านค้าของคุณ |
shop.phone | หมายเลขโทรศัพท์ของร้านค้าคุณ |
subtotal_price | ผลรวมของราคาสินค้าเฉพาะรายการของคำสั่งซื้อที่ยังไม่ชำระเงินหลังจากหักส่วนลดสินค้าเฉพาะรายการหรือส่วนลดสำหรับตะกร้าสินค้าแล้ว ยอดรวมนี้ไม่รวมภาษี (เว้นแต่จะรวมภาษีไว้ในราคาแล้ว) หรือค่าจัดส่ง |
discounts | รายการส่วนลด |
discounts_amount | จำนวนเงินส่วนลดที่ใช้จากส่วนลดทั้งหมด ตัวอย่าง: +$5.00 |
discounts_savings | ยอดเงินที่ประหยัดได้จากส่วนลดทั้งหมด ตัวอย่าง: -$5.00 |
total_price | ราคารวมของคำสั่งซื้อ (ยอดรวม + ค่าจัดส่ง - ส่วนลดค่าจัดส่ง + ภาษี) |
amount_due_now | ยอดที่ต้องชำระตามใบแจ้งหนี้ของคำสั่งซื้อที่ยังไม่ชำระเงิน |
requires_shipping | แสดงผลเป็น true true หากมีสินค้าในคำสั่งซื้อที่ยังไม่ชำระเงินที่ต้องจัดส่งอย่างน้อยหนึ่งรายการ แสดงผลเป็น false false หากไม่มีสินค้าในคำสั่งซื้อที่ยังไม่ชำระเงินที่ต้องจัดส่ง |
shipping_method.title | ชื่ออัตราค่าจัดส่ง ตัวอย่าง: การจัดส่งแบบมาตรฐาน |
shipping_method.price | ราคาของวิธีจัดส่ง แสดงข้อมูลเดียวกับ shipping_price |
shipping_price |
ราคาค่าจัดส่ง คุณสามารถจัดรูปแบบจำนวนเงินนี้ได้โดยใช้ตัวกรองเงินของ Liquid |
shipping_address |
หมายเหตุ: ที่อยู่ที่จัดส่งของคำสั่งซื้อที่ยังไม่ชำระเงินอาจไม่สมบูรณ์ ซึ่งแตกต่างจากคำสั่งซื้อปกติ |
shipping_address.first_name | ชื่อสำหรับที่อยู่ที่จัดส่ง |
shipping_address.company | ชื่อบริษัทในที่อยู่ที่จัดส่ง |
shipping_address.phone | หมายเลขโทรศัพท์ในที่อยู่ที่จัดส่ง |
line_items | รายการสินค้าเฉพาะรายการทั้งหมดในคำสั่งซื้อที่ยังไม่ชำระเงิน |
item_count | ผลรวมของจำนวนสินค้าทุกรายการในคำสั่งซื้อที่ยังไม่ชำระเงิน |
note | หมายเหตุที่แนบมากับคำสั่งซื้อที่ยังไม่ชำระเงิน คุณสามารถรับหมายเหตุได้จากลูกค้าและแก้ไขได้ในหน้าจอรายละเอียดคำสั่งซื้อที่ยังไม่ชำระเงินในส่วนผู้ดูแล Shopify ของคุณ |
metafields |
เมตาฟิลด์ใดๆ ในคำสั่งซื้อที่ยังไม่ชำระเงิน ใช้ไวยากรณ์ต่อไปนี้ metafields.NAMESPACE.KEY |
location |
ตำแหน่งที่ตั้งจริงของคำสั่งซื้อ มีคุณสมบัติตำแหน่งที่ตั้งให้ใช้งานอยู่หลายรายการ คุณสามารถกำหนดค่าตำแหน่งที่ตั้งได้ในหน้าตำแหน่งที่ตั้งของส่วนผู้ดูแล Shopify ของคุณ |
b2b? |
แสดงผลเป็น 'จริง' หากคำสั่งซื้อเป็นคำสั่งซื้อแบบ B2B ใช้คุณสมบัตินี้กับตัวแปร B2B เพื่อแสดงข้อมูลที่เกี่ยวข้อง เช่น ชื่อบริษัท ตำแหน่งที่ตั้งของบริษัท และที่อยู่ในอีเมล ตัวอย่างเช่น ในคำสั่งซื้อแบบ B2B คุณอาจเพิ่มส่วนหัวไปยังเทมเพลตพร้อมข้อมูลต่อไปนี้
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | บริษัทที่คุณขายสินค้าให้ในคำสั่งซื้อแบบ B2B |
company.name | ชื่อบริษัทในคำสั่งซื้อแบบ B2B |
company.id | ID ของบริษัทในคำสั่งซื้อแบบ B2B |
company_location | ตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B บริษัทที่ซื้อสินค้าจากคุณสามารถมีตำแหน่งที่ตั้งได้มากกว่าหนึ่งแห่ง |
company_location.name | ชื่อตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
company_location.id | หมายเลข ID ของตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
company_location.shipping_address | ที่อยู่ที่จัดส่งของตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
company_location.billing_address | ที่อยู่สำหรับเรียกเก็บเงินของตำแหน่งที่ตั้งของบริษัทในคำสั่งซื้อแบบ B2B |
payment_methods | รายการวิธีการชำระเงินที่บันทึกไว้ซึ่งพร้อมใช้งานเพื่อประมวลผลยอดรวมของคำสั่งซื้อที่ยังไม่ชำระเงิน |
payment_method.payment_instrument | เครื่องมือชำระเงิน ซึ่งประกอบด้วยรายละเอียดเกี่ยวกับวิธีการชำระเงินที่บันทึกไว้ |
payment_method.payment_instrument.payment_type | ประเภทของวิธีการชำระเงินที่บันทึกไว้ เช่น "credit_card, apple_pay" |
payment_method.payment_instrument.credit_card_brand | แบรนด์ของบัตรเมื่อ `payment_type` คือ "credit_card" |
payment_method.payment_instrument.credit_card_company | บริษัทผู้ออกบัตรเมื่อ `payment_type` คือ "credit_card" |
payment_method.payment_instrument.credit_card_company | เลข 4 ตัวท้ายของบัตรเมื่อ `payment_type` คือ "credit_card" |
คุณสมบัติของกำหนดเวลาชำระเงิน
| คุณสมบัติ | คำอธิบาย |
|---|---|
payment_schedule.amount_due |
จำนวนเงินที่ต้องชำระสำหรับกำหนดเวลาชำระเงิน คุณสามารถจัดรูปแบบจำนวนเงินด้วยสกุลเงินได้โดยใช้ตัวกรอง money ของ Liquid |
payment_schedule.due_at |
วันครบกำหนดสำหรับกำหนดเวลาชำระเงิน คุณสามารถจัดรูปแบบวันที่ได้โดยใช้ตัวกรองวันที่ของ Liquid |
payment_schedule.due_in_days |
จำนวนวันก่อนถึงวันครบกำหนดหากกำหนดเวลาชำระเงินยังคงค้างชำระ (ยังไม่ได้ชำระเงิน) |
payment_schedule.due_later? |
จะแสดงผลเป็น "จริง" หากยังไม่มีการชำระเงินตามกำหนดเวลาชำระเงินและวันครบกำหนดชำระยังมาไม่ถึง |
payment_schedule.number_of_days_overdue? |
จำนวนวันที่เกินจากวันครบกำหนดเมื่อกำหนดเวลาชำระเงินเกินกำหนด |
payment_schedule.overdue? |
จะแสดงผลเป็น "จริง" หากยังไม่มีการชำระเงินตามกำหนดเวลาชำระเงินและเลยวันครบกำหนดชำระแล้ว |
คุณสมบัติสถานะการชำระเงิน
| คุณสมบัติ | คำอธิบาย |
|---|---|
has_pending_payment |
(บูลีน) จะแสดงผลเป็น "จริง" หากคำสั่งซื้อมีธุรกรรมที่มียอดชำระเงินรอดำเนินการอยู่ ดูข้อมูลเพิ่มเติมเกี่ยวกับการชำระเงินที่รอดำเนินการ |
buyer_action_required |
(บูลีน) จะแสดงผลเป็น "จริง" หากคำสั่งซื้อมีธุรกรรมที่มียอดชำระเงินรอดำเนินการอยู่ และผู้ซื้อจำเป็นต้องดำเนินการบางอย่างเพื่อปลดบล็อกการชำระเงิน เมื่อค่านี้แสดงผลเป็น "จริง" และวิธีการชำระเงินรองรับคำแนะนำในการชำระเงิน ดูข้อมูลเพิ่มเติมเกี่ยวกับอ็อบเจกต์ธุรกรรมของ Liquid |
คุณสมบัติส่วนประกอบของชุดสินค้า
bundle_component แต่ละรายการในรายการของ line_item.bundle_components จะมีคุณสมบัติดังต่อไปนี้ (สำหรับคำสั่งซื้อที่ยังไม่ชำระเงินเท่านั้น)
| คุณสมบัติ | คำอธิบาย |
|---|---|
bundle_component.image_url | URL รูปภาพของส่วนประกอบของชุดสินค้า |
bundle_component.product.title | ชื่อของสินค้าที่เป็นส่วนประกอบของชุดสินค้า |
bundle_component.quantity | จำนวนสำหรับส่วนประกอบของชุดสินค้า |
bundle_component.variant.title | ชื่อปัจจุบันของค่าของตัวเลือกของตัวเลือกสินค้าที่เป็นส่วนประกอบของชุดสินค้า ซึ่งคั่นด้วยเครื่องหมาย ตัวอย่าง: เล็ก/สีแดง |
คุณสมบัติส่วนประกอบ
component แต่ละรายการในรายการของ line_item.components จะมีคุณสมบัติดังต่อไปนี้ (สำหรับการชำระเงินที่ยังไม่เสร็จสิ้นเท่านั้น)
`
| คุณสมบัติ | คำอธิบาย |
|---|---|
component.image_url | URL รูปภาพของส่วนประกอบ |
component.product.title | ชื่อของสินค้าที่เป็นส่วนประกอบ |
component.quantity | จำนวนสำหรับส่วนประกอบ |
component.variant.title | ชื่อปัจจุบันของค่าของตัวเลือกของตัวเลือกสินค้าที่เป็นส่วนประกอบ ซึ่งคั่นด้วยเครื่องหมาย ตัวอย่าง: เล็ก/สีแดง |
คุณสมบัติสินค้าเฉพาะรายการ
line แต่ละรายการในรายการของ line_items หรือ subtotal_line_items จะมีคุณสมบัติดังต่อไปนี้
| คุณสมบัติ | คำอธิบาย |
|---|---|
line.applied_discounts(POS and draft orders only) | รายการส่วนลดที่ปรับใช้กับรายการนี้ (ส่วนลดแต่ละรายการจะมีคุณสมบัติ title, code, amount, savings และ type) |
line.bundle_components(Draft orders only) | รายการสินค้าเฉพาะรายการที่เป็นส่วนประกอบของชุดสินค้าของรายการนี้ จะแสดงผลเป็นรายการก็ต่อเมื่อสินค้าเฉพาะรายการนี้เป็นสินค้าแบบชุดเท่านั้น |
line.bundle_parent?(Draft orders only) | (บูลีน) จะแสดงผลเป็น "จริง" หากสินค้าเฉพาะรายการเป็นสินค้าแบบชุด |
line.components(Abandoned checkout only) | รายการสินค้าเฉพาะรายการที่เป็นส่วนประกอบของรายการนี้ |
line.parent?(Abandoned checkout only) | (บูลีน) จะแสดงผลเป็น "จริง" หากสินค้าเฉพาะรายการมีส่วนประกอบ |
line.custom(Draft orders only) | (บูลีน) จะแสดงผลเป็น "จริง" หากรายการดังกล่าวเป็นสินค้าเฉพาะรายการแบบกำหนดเองสำหรับคำสั่งซื้อที่ยังไม่ชำระเงิน |
line.delivery_agreement | ข้อตกลงการจัดส่งที่เชื่อมโยงกับสินค้าเฉพาะรายการนี้ |
line.grams | น้ำหนักของหนึ่งรายการ |
line.groups | กลุ่มสินค้าเฉพาะรายการของรายการนั้นๆ |
line.image | แสดงผล URL ของรูปภาพที่เชื่อมโยงกับสินค้าเฉพาะรายการนี้ นอกจากนี้คุณยังสามารถใช้ตัวกรอง img_url เพื่อรับรูปภาพขนาดที่ต้องการได้อีกด้วย ตัวอย่างเช่น {{ line.image | img_url: 'small' }} |
line.line_price | ราคาคูณด้วยจำนวนของรายการนั้น |
line.original_line_price | ราคารวมของจำนวนรายการที่รวมอยู่ในสินค้าเฉพาะรายการก่อนที่จะใช้ส่วนลด |
line.final_line_price | ราคารวมของทุกรายการในสินค้าเฉพาะรายการ รวมถึงยอดส่วนลดระดับสินค้าเฉพาะรายการทั้งหมด |
line.pre_tax_price | ราคาก่อนภาษีสำหรับสินค้าเฉพาะรายการ คูณด้วยจำนวนของสินค้าเฉพาะรายการที่ซื้อ |
line.price | ราคาสำหรับหนึ่งรายการ |
line.product.metafields | เมตาฟิลด์ใดๆ ในระดับสินค้า ใช้ไวยากรณ์ต่อไปนี้ line.product.metafields.NAMESPACE.KEY |
line.product.title | ชื่อปัจจุบันของสินค้า |
line.product.vendor | ผู้ขายสำหรับรายการนั้น |
line.properties | แสดงผลอาร์เรย์ของข้อมูลที่กำหนดเองสำหรับรายการ โดยคุณสมบัติสินค้าเฉพาะรายการจะถูกระบุโดยลูกค้าบนหน้าสินค้าก่อนที่จะเพิ่มสินค้าลงในตะกร้าสินค้า |
line.quantity | จำนวนสำหรับรายการนั้น |
line.current_quantity | จำนวนปัจจุบันของรายการหลังจากการลบออก |
line.requires_shipping | (บูลีน) จะแสดงผลเป็น "จริง" หากตัวเลือกสินค้าสำหรับรายการนั้นเปิดใช้งานการตั้งค่าสินค้าที่จับต้องได้บนหน้าสินค้า |
line.selling_plan_allocation | จะแสดงผลอ็อบเจกต์ selling_plan_allocation ซึ่งอธิบายว่าแผนการขาย เช่น การสมัครสมาชิก ส่งผลต่อสินค้าเฉพาะรายการอย่างไร |
line.taxable | (บูลีน) จะแสดงผลเป็น "จริง" หากตัวเลือกสินค้าสำหรับรายการนั้นมีช่องทำเครื่องหมาย 'เรียกเก็บภาษีสำหรับสินค้านี้' ถูกเลือกบนหน้าสินค้า |
line.title | ชื่อของสินค้า ณ เวลาที่ขาย ตามด้วยขีดกลางและชื่อของตัวเลือกสินค้า ณ เวลาที่ขาย ชื่อตัวเลือกสินค้าจะไม่แสดงหากเป็น "Default Title" ในการแจ้งเตือนที่แสดงต่อลูกค้า ชื่อสินค้าและชื่อตัวเลือกสินค้าจะได้รับการแปลเป็นภาษาที่ลูกค้าใช้ในการชำระเงินเมื่อภาษานั้นแตกต่างจากภาษาเริ่มต้นของร้านค้า |
line.url | URL แบบสัมพัทธ์ของตัวเลือกสินค้าสำหรับสินค้าเฉพาะรายการ URL แบบสัมพัทธ์จะไม่รวม URL รากของร้านค้าของคุณ (mystore.myshopify.com) |
line.variant.barcode | บาร์โค้ดที่เชื่อมโยงกับตัวเลือกสินค้า |
line.variant.compare_at_price | ราคาเปรียบเทียบที่เชื่อมโยงกับตัวเลือกสินค้า |
line.variant.image | รูปภาพของตัวเลือกสินค้า จะส่งคืนรูปภาพก็ต่อเมื่อมีการกำหนดรูปภาพที่เฉพาะเจาะจงให้กับตัวเลือกสินค้าในสินค้าเฉพาะรายการ |
line.variant.metafields | เมตาฟิลด์ใดๆ ในระดับตัวเลือกสินค้า ใช้ไวยากรณ์ต่อไปนี้ line.variant.metafields.NAMESPACE.KEY |
line.variant.sku | SKU ที่เชื่อมโยงกับตัวเลือกสินค้า |
line.variant.title | ชื่อปัจจุบันของค่าตัวเลือกสำหรับตัวเลือกสินค้า ซึ่งเชื่อมกันด้วยเครื่องหมาย ตัวอย่าง: เล็ก/สีแดง |
line.refunded.quantity(within refund notifications) | จำนวนของรายการที่จะต้องคืนเงิน คุณสามารถใช้คุณสมบัตินี้เพื่อเพิ่มตัวระบุให้กับรายการที่ได้รับคืนเงินในคำสั่งซื้อ ตัวอย่างเช่น |
ตรวจหารายการ Shopify Collective ในเทมเพลตการแจ้งเตือน
ระบบจะติดแท็ก Shopify Collective ในคำสั่งซื้อหลังจากที่ส่งอีเมลการยืนยันคำสั่งซื้อแล้ว ดังนั้นโค้ด {% if tags contains 'Shopify Collective' %} จะไม่มีค่าเป็น true ในเทมเพลตการยืนยันคำสั่งซื้อ หากต้องการตรวจหารายการ Shopify Collective ให้ตรวจสอบแท็กระดับสินค้าในสินค้าเฉพาะรายการแต่ละรายการแทนดังนี้
{% 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 %}คุณสมบัติกลุ่มสินค้าเฉพาะรายการ
แต่ละ line_item_group ในรายการของ line_item_groups จะมีคุณสมบัติดังต่อไปนี้
| คุณสมบัติ | คำอธิบาย |
|---|---|
line_item_group.display_title | ชื่อของกลุ่มสินค้าเฉพาะรายการ |
line_item_group.components | รายการส่วนประกอบของสินค้าเฉพาะรายการที่เป็นของกลุ่ม |
line_item_group.image | รูปภาพของกลุ่มสินค้าเฉพาะรายการ |
line_item_group.product_id | ID สินค้าของกลุ่มสินค้าเฉพาะรายการ |
line_item_group.variant | อ็อบเจกต์ตัวเลือกสินค้าของกลุ่มสินค้าเฉพาะรายการ |
line_item_group.variant_id | ID ตัวเลือกสินค้าของกลุ่มสินค้าเฉพาะรายการ |
คุณสมบัติการคืนเงิน
| คุณสมบัติ | คำอธิบาย |
|---|---|
amount | จำนวนเงินที่คืน |
refund_line_items | รายการสินค้าเฉพาะรายการที่คืนเงินที่จะได้รับคืนเงิน |
คุณสมบัติสินค้าเฉพาะรายการที่คืนเงิน
แต่ละ refund_line ในรายการ refund_line_items จะมีคุณสมบัติดังต่อไปนี้
| คุณสมบัติ | คำอธิบาย |
|---|---|
refund_line.line_item | line_item ที่กำลังได้รับการคืนเงิน ซึ่งสามารถเข้าถึงคุณสมบัติของ line_item ทั้งหมดได้ |
refund_line.quantity | จำนวนของสินค้าเฉพาะรายการที่จะได้รับคืนเงิน |
คุณสมบัติการจัดการคำสั่งซื้อ
| คุณสมบัติ | คำอธิบาย |
|---|---|
service_name | ชื่อบริการแบบกำหนดเองตามที่กำหนดไว้ในหน้า การตั้งค่า > การจัดส่งและการส่งมอบ (เฉพาะคำขอจัดการคำสั่งซื้อเท่านั้น) |
fulfillment.estimated_delivery_at | วันที่จัดส่งโดยประมาณตามหมายเลขติดตามพัสดุ (หากมี) ที่ได้รับจากผู้ให้บริการขนส่งรายใดรายหนึ่งต่อไปนี้: USPS, FedEx, UPS, Canada Post (เฉพาะในแคนาดา) คุณสมบัตินี้จะใช้งานได้ก็ต่อเมื่อมีการใช้อัตราค่าจัดส่งที่คำนวณโดยผู้ให้บริการขนส่งอยู่ |
fulfillment.fulfillment_line_items | รายการสินค้าเฉพาะรายการที่ต้องจัดการที่จะต้องจัดการ |
fulfillment.item_count | ผลรวมจำนวนของรายการทั้งหมด จำนวนรายการทั้งหมดที่กำลังจัดการ |
fulfillment.requires_shipping | (บูลีน) ส่งคืนค่าจริงหากคำขอให้จัดการคำสั่งซื้อนี้ต้องมีการจัดส่ง |
fulfillment.tracking_company | บริษัทที่ดำเนินการติดตามพัสดุ |
fulfillment.tracking_numbers | รายการหมายเลขติดตามพัสดุ |
fulfillment.tracking_urls | รายการ URL การติดตาม |
items_to_fulfill(deprecated) | รายการสินค้าเฉพาะรายการที่จะต้องจัดการโดยบริการจัดการคำสั่งซื้อที่กำหนดเองรายนี้ (สำหรับคำขอให้จัดการคำสั่งซื้อเท่านั้น) |
items_to_fulfill_count(deprecated) | จำนวนรวมของสินค้าที่จะต้องจัดการตามคำขอนี้ (สำหรับคำขอให้จัดการคำสั่งซื้อเท่านั้น) |
คุณสมบัติสินค้าเฉพาะรายการที่ต้องจัดการ
แต่ละ fulfillment_line ในรายการของ fulfillment_line_items จะมีคุณสมบัติดังต่อไปนี้
| คุณสมบัติ | คำอธิบาย |
|---|---|
fulfillment_line.line_item | line_item ที่กำลังจัดการ ซึ่งสามารถเข้าถึงคุณสมบัติของ line_item ทั้งหมดได้ |
fulfillment_line.quantity | จำนวนของสินค้าเฉพาะรายการที่กำลังจัดการ |
คุณสมบัติบรรจุภัณฑ์ที่เตรียมไว้
บรรจุภัณฑ์ที่เตรียมไว้จะรวมสินค้าที่ทำเครื่องหมายว่าพร้อมให้รับ
| คุณสมบัติ | คำอธิบาย |
|---|---|
item_count | ผลรวมจำนวนของสินค้าทุกรายการในบรรจุภัณฑ์ที่เตรียมไว้ |
prepared_package_line_items | รายการสินค้าเฉพาะรายการในบรรจุภัณฑ์ที่เตรียมไว้ |
คุณสมบัติสินค้าเฉพาะรายการในบรรจุภัณฑ์ที่เตรียมไว้
แต่ละ prepared_package_line_item ในรายการ prepared_package_line_items จะมีคุณสมบัติดังต่อไปนี้
| คุณสมบัติ | คำอธิบาย |
|---|---|
line_item | line_item ที่เชื่อมโยง ซึ่งสามารถเข้าถึงคุณสมบัติของ line_item ทั้งหมดได้ |
quantity | จำนวนของสินค้าเฉพาะรายการที่ทำเครื่องหมายว่าพร้อมให้รับแล้ว |
คุณสมบัติการจัดส่ง
| คุณสมบัติ | คำอธิบาย |
|---|---|
delivery_agreements | รายการข้อตกลงในการจัดส่งทั้งหมดสำหรับคำสั่งซื้อ |
delivery_instructions | ข้อมูลการจัดส่งในพื้นที่เพื่อแชร์กับลูกค้า ข้อมูลนี้ควบคุมโดยช่องข้อมูลการจัดส่งในการตั้งค่าการจัดส่งในพื้นที่ของคุณ |
consolidated_estimated_delivery_time | ข้อมูลวันที่จัดส่งคำสั่งซื้อเพื่อแชร์กับลูกค้า ข้อมูลนี้ควบคุมโดยการตั้งค่าเวลาในการจัดการที่คุณตั้งค่าไว้ในหน้าการจัดส่งและการส่งมอบ เมื่อคำสั่งซื้อมีวิธีการจัดส่งหลายวิธี ระบบจะแสดงรายการวิธีการจัดส่งและวันที่ |
has_multiple_delivery_methods | (บูลีน) ส่งคืนค่าจริงหากคำสั่งซื้อมีวิธีการจัดส่งหลายวิธี |
คุณสมบัติข้อตกลงในการจัดส่ง
| คุณสมบัติ | คำอธิบาย |
|---|---|
delivery_agreement.delivery_method_type | ประเภทวิธีการจัดส่ง |
delivery_agreement.delivery_method_name | ประเภทวิธีการจัดส่งที่แปลเป็นภาษาที่ผู้ซื้อใช้ชำระเงิน เมื่อภาษาดังกล่าวแตกต่างจากภาษาเริ่มต้นของร้านค้า |
delivery_agreement.line_item_groups | รายการกลุ่มสินค้าเฉพาะรายการทั้งหมดที่มีส่วนประกอบของสินค้าเฉพาะรายการแบบรวมชุดอยู่ในข้อตกลงในการจัดส่ง |
delivery_agreement.line_items | รายการสินค้าเฉพาะรายการทั้งหมดที่เชื่อมโยงกับข้อตกลงในการจัดส่งนี้ |
คุณสมบัติส่วนลด
คุณสมบัติส่วนลดมีสองประเภท
discount_applications จะอธิบายว่าทำไมและอย่างไรที่รายการได้รับส่วนลด
discount_allocations จะอธิบายว่าส่วนลดรายการหนึ่งมีผลต่อสินค้าเฉพาะรายการอย่างไร และลดราคาได้อย่างไร คุณควรใช้คุณสมบัตินี้ที่ระดับสินค้าเฉพาะรายการ
คุณสามารถรวมคุณสมบัติเหล่านี้เพื่อแสดงข้อมูลส่วนลดที่ระดับสินค้าเฉพาะรายการหรือระดับคำสั่งซื้อ
ตัวอย่าง
ตัวอย่างนี้จะตรวจสอบว่ามีการใช้ส่วนลดกับสินค้าเฉพาะรายการหรือไม่ หากไม่มีการใช้ส่วนลดที่ระดับคำสั่งซื้อ (all) ก็จะมีการแสดงชื่อส่วนลดและจำนวนเงิน
{% 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 %}ผลลัพธ์อาจคล้ายกับตัวอย่างต่อไปนี้
SPRING5 (-$5.00)คุณสมบัติ Discount_allocation
discount_allocation แต่ละรายการในลิสต์ของ discount_allocations จะมีคุณสมบัติดังต่อไปนี้
| คุณสมบัติ | คำอธิบาย |
|---|---|
discount_allocation.amount | จำนวนเงินที่ลูกค้าประหยัดได้จากสินค้าเฉพาะรายการ ต้องป้อนข้อมูลในลูปหากคุณต้องการอนุญาตให้ใช้รหัสส่วนลดหลายรหัส |
discount_allocation.discount_application | การใช้ส่วนลดที่จัดสรรจำนวนเงินในสินค้าเฉพาะรายการ |
คุณสมบัติ Discount_application
discount_application แต่ละรายการในลิสต์ของ discount_applications จะมีคุณสมบัติดังต่อไปนี้
| คุณสมบัติ | คำอธิบาย |
|---|---|
discount_application.target_selection |
อธิบายวิธีที่ส่วนลดเลือกว่าจะลดราคาสินค้าเฉพาะรายการใดในตะกร้าสินค้า โดยจะเป็นค่าใดค่าหนึ่งต่อไปนี้
|
discount_application.target_type | ประเภทของรายการที่ส่วนลดมีผล (line_item หรือ shipping_line) |
discount_application.title | ชื่อส่วนลดที่แสดงให้ลูกค้าเห็น ตัวอย่าง: Welcome10 หรือ CBBWQQAKYBYY |
discount_application.total_allocated_amount | จำนวนเงินทั้งหมดที่ราคาของคำสั่งซื้อลดลงเนื่องจากส่วนลด |
discount_application.type | ประเภทของส่วนลด โดยจะเป็นค่าใดค่าหนึ่งต่อไปนี้: automatic, discount_code, manual หรือ script |
discount_application.value | มูลค่าของส่วนลด |
discount_application.value_type | ประเภทมูลค่าของส่วนลด โดยจะเป็นค่าใดค่าหนึ่งต่อไปนี้: fixed_amount หรือ percentage |
คุณสมบัติการสมัครใช้งาน
รายละเอียดของสัญญาการสมัครใช้งาน รอบการเรียกเก็บเงินปัจจุบัน และสินค้าเฉพาะรายการ วิธีการจัดส่ง และวิธีการชำระเงิน จะมีอยู่ในเทมเพลตอีเมลการสมัครใช้งานทั้งหมด
หากต้องการแก้ไขเทมเพลตการแจ้งเตือนการสมัครใช้งาน ให้ติดตั้งแอป Shopify Subscriptions จากนั้นค้นหาเทมเพลตได้ที่ใต้ส่วนการสมัครใช้งานในการตั้งค่า > การแจ้งเตือน
คุณสมบัติรอบการเรียกเก็บเงินของสัญญาการสมัครใช้งาน
หากต้องการเข้าถึงคุณสมบัติของสัญญาการสมัครใช้งานและรอบการเรียกเก็บเงิน ให้ใช้ออบเจ็กต์ subscription_contract_billing_cycle
ตัวอย่าง
{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.ผลลัพธ์:
This contract is currently paused.คุณสมบัติ
| คุณสมบัติ | คำอธิบาย |
|---|---|
status |
สถานะของสัญญา โดยจะเป็นค่าใดค่าหนึ่งต่อไปนี้: active, paused, cancelled, failed, expired, stale
|
delivery_method |
วิธีการจัดส่งของการสมัครใช้งาน หากการสมัครใช้งานมีไว้สำหรับบริการหรือสินค้าดิจิทัล ระบบจะส่งคืนค่า nil
|
billing_frequency | ความถี่ในการเรียกเก็บเงินสำหรับการสมัครใช้งาน |
delivery_frequency | ความถี่ในการจัดส่งสินค้าของการสมัครใช้งาน |
origin_order |
คำสั่งซื้อดั้งเดิมที่สร้างการสมัครใช้งานขึ้นเป็นครั้งแรก หากการสมัครใช้งานไม่ได้สร้างขึ้นจากคำสั่งซื้อของ Shopify ระบบจะส่งคืนค่า nil
|
customer | ลูกค้าของการสมัครใช้งาน |
line_items | สินค้าเฉพาะรายการในรอบการเรียกเก็บเงินของการสมัครใช้งาน |
product_names | ลิสต์ชื่อสินค้าที่รวมอยู่ในรอบการเรียกเก็บเงินของการสมัครใช้งาน |
update_payment_method_url | URL ที่ลูกค้าสามารถใช้เพื่ออัปเดตวิธีการชำระเงินสำหรับสัญญานี้ได้ |
shipping_address |
ที่อยู่ที่จัดส่งของการสมัครใช้งาน หากการสมัครใช้งานมีไว้สำหรับบริการหรือสินค้าดิจิทัล ระบบจะส่งคืนค่า nil
|
billing_address | ที่อยู่สำหรับเรียกเก็บเงินของการสมัครใช้งาน |
subtotal_price | ราคายอดรวมของสินค้าเฉพาะรายการที่สมัครใช้งาน |
shipping_price | ราคาค่าจัดส่งของการสมัครใช้งาน |
total_tax | ภาษีทั้งหมดของการสมัครใช้งาน |
total_price | ราคาทั้งหมดของการสมัครใช้งาน |
total_discounts | ส่วนลดทั้งหมดของการสมัครใช้งาน |
customer_self_serve_url | URL แบบบริการตนเองที่ลูกค้าสามารถใช้จัดการการสมัครใช้งานของตนเองได้ |
billing_attempt_expected_date | วันที่เรียกเก็บเงินสำหรับรอบการเรียกเก็บเงินนี้ |
next_billing_date | วันที่เรียกเก็บเงินครั้งถัดไปที่ไม่ถูกข้ามหลังจากรอบการเรียกเก็บเงินนี้ |
last_attempted_billing_date | วันที่เรียกเก็บเงินล่าสุดที่มีการพยายามเรียกเก็บสำหรับรอบการเรียกเก็บเงิน |
days_overdue | จำนวนวันที่เรียกเก็บเงินเกินกำหนดสำหรับรอบการเรียกเก็บเงินนี้ |
payment_instrument | เครื่องมือการชำระเงินที่เชื่อมโยงกับสัญญาการสมัครใช้งาน เครื่องมือการชำระเงินนี้ใช้เพื่อเรียกเก็บเงินจากลูกค้า |
คุณสมบัติสินค้าเฉพาะรายการของสัญญาการสมัครใช้งาน
คุณสมบัติสำหรับสินค้าเฉพาะรายการแต่ละรายการที่รวมอยู่ในรอบการเรียกเก็บเงิน เข้าถึงคุณสมบัติสินค้าเฉพาะรายการของสัญญาผ่านคุณสมบัติ subscription_contract_billing_cycle.line_items หลัก
ตัวอย่าง
{% for line_item in subscription_contract_billing_cycle.line_items %}
{{ line_item.url }}
{% endfor %}| คุณสมบัติ | คำอธิบาย |
|---|---|
url | URL ไปยังหน้ารายละเอียดสินค้าสำหรับตัวเลือกสินค้าเฉพาะรายการ |
requires_shipping | ระบุว่าสินค้าเฉพาะรายการจำเป็นต้องมีการจัดส่งแบบที่จับต้องได้หรือไม่ |
unit_price_measurement | หน่วยวัดราคาต่อหน่วยของสินค้าเฉพาะรายการ |
selling_plan_allocation | การจัดสรรแผนการขายของสินค้าเฉพาะรายการ |
คุณสมบัติวิธีการจัดส่งของสัญญาการสมัครใช้งาน
คุณสมบัติต่างๆ ของวิธีการจัดส่งที่ใช้ในรอบการเรียกเก็บเงินนี้ เข้าถึงคุณสมบัติวิธีการจัดส่งผ่านคุณสมบัติระดับบนสุด subscription_contract_billing_cycle.delivery_method
ตัวอย่าง
{% if subscription_contract_billing_cycle.delivery_method != blank %}
Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}| คุณสมบัติ | คำอธิบาย |
|---|---|
title | ชื่อตัวเลือกการจัดส่งที่เกี่ยวข้องกับวิธีการจัดส่ง |
type |
ประเภทวิธีการจัดส่ง หนึ่งใน shipping, local หรือ pick-up
|
คุณสมบัติเครื่องมือการชำระเงินสำหรับสัญญาการสมัครใช้งาน
รายละเอียดเกี่ยวกับเครื่องมือการชำระเงินสำหรับสัญญาการสมัครใช้งาน เครื่องมือการชำระเงินนี้จะใช้เพื่อเรียกเก็บเงินจากลูกค้า เข้าถึงคุณสมบัติของเครื่องมือการชำระเงินผ่านคุณสมบัติระดับบนสุด subscription_contract_billing_cycle.payment_instrument
ตัวอย่าง
{% 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 }}| คุณสมบัติ | คำอธิบาย |
|---|---|
payment_type |
ประเภทของวิธีการชำระเงินที่แสดงโดยเครื่องมือการชำระเงิน ใช้ตัวกรองการชำระเงินเพื่อแสดงผล URL ของรูปภาพหรือ SVG |
credit_card_brand | แบรนด์ของบัตรเครดิต |
credit_card_company | ชื่อบริษัทบัตรเครดิต |
credit_card_last_four_digits | เลข 4 ตัวสุดท้ายของบัตรเครดิต |
คุณสมบัติการแจ้งเตือนทางอีเมล
| คุณสมบัติ | คำอธิบาย |
|---|---|
shop.email_logo_url | URL สำหรับโลโก้ที่ระบุไว้ในส่วนปรับแต่งเทมเพลตอีเมลของแผงผู้ดูแล |
shop.email_logo_width | ความกว้างของโลโก้ (พิกเซล) ที่ระบุไว้ในส่วนปรับแต่งเทมเพลตอีเมลของแผงผู้ดูแล |
shop.email_accent_color | รหัส HEX สำหรับสีตกแต่งที่ระบุไว้ในส่วนปรับแต่งเทมเพลตอีเมลของแผงผู้ดูแล |
คุณสมบัติเครดิตร้านค้า
คุณสมบัติที่มีรายละเอียดเกี่ยวกับการออกเครดิตร้านค้า
| คุณสมบัติ | คำอธิบาย |
|---|---|
issued_store_credit.amount |
จำนวนเครดิตร้านค้าที่ออกให้ คุณสามารถจัดรูปแบบจำนวนเงินนี้ได้โดยใช้ตัวกรองเงินของ Liquid |
issued_store_credit.expires_at |
วันที่และเวลาที่เครดิตร้านค้าที่ออกให้จะหมดอายุ คุณสามารถจัดรูปแบบจำนวนนี้ได้โดยใช้ตัวกรองวันที่ของ Liquid |
issued_store_credit.balance_after_transaction |
ยอดคงเหลือของบัญชีเครดิตร้านค้าหลังจากที่ออกเครดิตให้แล้ว คุณสามารถจัดรูปแบบจำนวนเงินนี้ได้โดยใช้ตัวกรองเงินของ Liquid |
customer | อ็อบเจกต์ลูกค้าที่มีคุณลักษณะของเอาท์พุตลูกค้า |