Lấy dữ liệu đơn hàng
Trong các dòng công việc yêu cầu dữ liệu đơn hàng, bạn có thể sử dụng thao tác Lấy dữ liệu đơn hàng để lấy thông tin đơn hàng từ cửa hàng.
Trên trang này
Cấu hình
Trường
Thao tác Lấy dữ liệu đơn hàng chứa các trường sau để xây dựng truy vấn:
| Trường | Mô tả |
|---|---|
| Sắp xếp dữ liệu theo | Bắt buộc. Các tham số dùng để sắp xếp dữ liệu do truy vấn tìm kiếm trả về. |
| Số lượng kết quả tối đa | Bắt buộc. Số lượng kết quả tối đa mà truy vấn tìm kiếm bạn chọn có thể trả về. Bạn có thể nhận tối đa 100 kết quả một lần. |
| Truy vấn | Bắt buộc. Chọn từ các truy vấn phổ biến hoặc chọn Nâng cao để tự tạo truy vấn. |
Chuỗi truy vấn
Đây là truy vấn ví dụ để lấy các đơn hàng đã được cập nhật trong ngày qua:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Biến updated_at là bộ lọc có trong truy vấn đơn hàng và có thể được sử dụng nhiều lần hoặc kết hợp với các biến khác. Biến Liquid scheduledAt có trong các dòng công việc đã sử dụng yếu tố kích hoạt thời gian đã lên lịch. Thẻ Liquid date_minus là thẻ Flow đặc biệt cho phép bạn trừ thời gian từ một ngày.
Một số thông tin hữu ích cần biết khi truy vấn dữ liệu:
- Danh sách các bộ lọc đơn hàng có sẵn
- Truy vấn phải tuân theo cú pháp nhất định
- Không phải lúc nào các giá trị của trường truy vấn cũng được ghi trong tài liệu. Trong một số trường hợp, bạn có thể tìm giá trị bằng cách xem tài liệu API. Ngoài ra, bạn thường có thể tìm thấy giá trị trường trong URL của bảng điều khiển quản trị khi lọc. Ví dụ: để tìm một số giá trị truy vấn Đơn hàng, hãy lọc trang Đơn hàng trong bảng điều khiển quản trị, sau đó kiểm tra URL.
- Bạn có thể chạy hoặc kiểm tra truy vấn trong cửa hàng của mình bằng cách sử dụng ứng dụng Shopify GraphiQL.
- Lưu ý điều gì sẽ xảy ra nếu truy vấn không thành công. Thường thì API sẽ trả về mọi kết quả (thay vì không trả về kết quả nào).
Dữ liệu trả về
Mọi thao tác Lấy dữ liệu đều trả về danh sách chứa từ 0 đến 100 tài nguyên. Tùy vào trường hợp sử dụng, bạn có thể muốn dùng dữ liệu này theo nhiều cách khác nhau:
- Nếu cần xử lý riêng từng mục trong danh sách, chẳng hạn như thêm thẻ cho từng mục, bạn có thể sử dụng thao tác For each.
- Nếu cần tổng hợp dữ liệu, chẳng hạn như đếm số lượng kết quả trả về, bạn có thể sử dụng thao tác Count hoặc Sum.
- Nếu cần xuất danh sách, chẳng hạn như gửi email có tất cả các mục, bạn có thể trực tiếp sử dụng dữ liệu trả về trong những thao tác tiếp theo.
Để truy cập dữ liệu trả về trong các bước theo sau thao tác này, hãy sử dụng biến có tên Lấy dữ liệu đơn hàng, là danh sách đơn hàng. Bạn có thể sử dụng biến này ở cả điều kiện và thao tác. Ví dụ: bạn có thể gửi danh sách đơn hàng trong thao tác Gửi email nội bộ như sau:
{% for single_order in GetOrderData %}
* {{ single_order.name }}
{% endfor %}Yếu tố kích hoạt
Bạn có thể sử dụng thao tác này trong bất kỳ dòng công việc nào, bao gồm cả yếu tố kích hoạt Thời gian đã lên lịch. Trong dòng công việc sử dụng yếu tố kích hoạt Thời gian đã lên lịch, dòng công việc bắt đầu vào thời gian bạn chỉ định thay vì do kết quả của một sự kiện. Do không có sự kiện cụ thể nào trong cửa hàng hoặc từ ứng dụng kích hoạt dòng công việc, nên không có dữ liệu nào được tự động đưa vào.
Chi tiết API
Mẫu
Hủy đơn hàng của những khách hàng thường xuyên trả hàng
Hủy đơn hàng của những khách hàng đã trả lại hàng từ 5 lần trở lên trong 6 tháng qua. Mẫu này truy xuất dữ liệu đơn hàng, đếm số lần trả hàng và hủy đơn hàng hiện tại, phát hành khoản hoàn tiền và nhập lại kho mặt hàng. Bạn có thể sử dụng mẫu này để: giảm thiểu thiệt hại do người thường xuyên trả hàng gây ra, hợp lý hóa quy trình quản lý đơn hàng bằng cách xử lý trước rủi ro trả hàng và duy trì lợi nhuận bằng cách ngăn chặn tình trạng trả hàng quá nhiều. Xem mẫu
Hủy đơn hàng nếu khách hàng đặt hơn 5 đơn hàng trong hôm nay
Hủy đơn hàng nếu khách hàng đặt hơn 5 đơn hàng trong một ngày. Mẫu này sẽ kiểm tra số lượng đơn hàng do khách hàng đặt trong 24 giờ qua và hủy những đơn hàng vượt quá giới hạn này, đồng thời gắn thẻ khách hàng vì có khả năng gian lận. Xem mẫu
Tạm dừng đơn hàng cần hoàn tất đối với những khách hàng có khoản bồi hoàn
Khi một đơn hàng đã sẵn sàng để hoàn tất, dòng công việc sẽ truy xuất mọi đơn hàng của cùng một khách hàng trong 60 ngày qua có khoản bồi hoàn. Nếu có bất kỳ đơn hàng nào như vậy, hệ thống sẽ tạm dừng hoàn tất đối với từng lô hàng và gửi email nội bộ để thông báo cho đội ngũ vận hành. Xem mẫu
Tạm dừng hoàn tất đơn hàng nếu khách hàng đặt nhiều đơn hàng trong 24 giờ
Kiểm tra xem khách hàng có đặt nhiều đơn hàng trong khoảng thời gian 24 giờ hay không. Nếu có, tạm dừng hoàn tất đơn hàng và hợp nhất việc vận chuyển. Xem mẫu
Tạm dừng đơn hàng nếu khách hàng đặt hơn 1 đơn hàng trong 24 giờ qua
Khi có đơn hàng mới được tạo, kiểm tra xem khách hàng có đặt đơn hàng nào khác trong 24 giờ qua hay không. Nếu có, tạm dừng mọi đơn hàng. Xem mẫu
Gửi thông báo khi số lượng đơn hàng ít hơn 10 trong giờ qua
Gửi thông báo tình trạng đơn hàng. Mỗi giờ, lấy tối đa 10 đơn hàng đã tạo và đếm số lượng. Nếu ít hơn 10, gửi thông báo qua email. Mẫu này sử dụng các bước Thời gian đã lên lịch, Lấy dữ liệu đơn hàng và Đếm. Xem mẫu
Gửi email tóm tắt tất cả đơn hàng trên Cửa hàng trực tuyến trong ngày qua
Mỗi ngày, lấy đơn hàng của ngày qua và gửi email tóm tắt những đơn đặt trên cửa hàng trực tuyến. Xem mẫu
Gửi email tóm tắt mọi đơn hàng chưa hoàn tất quá 2 ngày
Nhận tóm tắt hằng ngày về mọi đơn hàng chưa hoàn tất quá 2 ngày, bằng cách sử dụng tính năng lên lịch, lấy dữ liệu đơn hàng, đếm và tính tổng. Xem mẫu
Gắn thẻ và gửi tóm tắt hằng ngày về các đơn hoàn tất trễ
Mỗi ngày, gắn thẻ và gửi email tóm tắt hằng ngày để đếm tổng số lượng và giá trị bằng đô la của mọi đơn hàng không đáp ứng cam kết vận chuyển trong vòng 2 ngày. Xem mẫu
Gắn thẻ những khách hàng có khoản bồi hoàn
Mỗi giờ, dòng công việc này lấy những đơn hàng có khoản bồi hoàn và thêm thẻ vào khách hàng của đơn hàng đó. Có sử dụng yếu tố kích hoạt thời gian đã lên lịch, lấy dữ liệu đơn hàng và vòng lặp for each. Xem mẫu
Gắn thẻ đơn hàng chưa hoàn tất quá 2 ngày
Mỗi ngày, dòng công việc này sẽ lấy mọi đơn hàng chưa hoàn tất quá 2 ngày và thêm thẻ vào đơn hàng. Xem mẫu
Sử dụng thẻ để phân khúc khách hàng theo đơn hàng của họ trong 6 tháng qua
Khi có đơn hàng mới được tạo, lấy tổng tiền và số lượng đơn hàng của khách hàng trong 6 tháng qua, sau đó thêm thẻ cho khách hàng. Có sử dụng thao tác Lấy dữ liệu đơn hàng, Đếm, Tính tổng. Xem mẫu