Lấy dữ liệu đơn hàng cần hoàn tất

Bạn có thể sử dụng hành động Lấy dữ liệu đơn hàng cần hoàn tất để truy xuất thông tin đơn hàng cần hoàn tất từ cửa hàng.

Cấu hình

Trường

Hành động Lấy dữ liệu đơn hàng cần hoàn tất có các trường sau đây, dùng để tạo truy vấn:

Chuỗi truy vấn

Dưới đây là ví dụ về truy vấn để lấy các đơn hàng cần hoàn tất hiện đang bị tạm hoãn:

status:ON_HOLD

Biến status là bộ lọc có trong Truy vấn đơn hàng cần hoàn tất và có thể dùng nhiều lần hoặc kết hợp với các biến khác.

Khi truy vấn dữ liệu, bạn nên lưu ý những điều sau:

• Danh sách các bộ lọc đơn hàng cần hoàn tất có sẵn
• Truy vấn phải tuân theo một cú pháp nhất định
• Giá trị trường truy vấn không phải lúc nào cũng được ghi chú trong tài liệu. Trong một số trường hợp, có thể tìm thấy các giá trị này 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 thử nghiệm truy vấn trong cửa hàng của mình bằng ứng dụng Shopify GraphiQL.
• Hãy lưu ý điều xảy ra nếu truy vấn không thành công. Thông thường API sẽ trả về tất cả kết quả (thay vì không có kết quả nào).

Dữ liệu trả về

Tất cả 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ể dùng dữ liệu này theo nhiều cách:

• Nếu cần xử lý riêng từng mục trong danh sách, chẳng hạn như gắn thẻ cho từng mục, bạn có thể sử dụng thao tác Cho mỗi.
• 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 Đếm hoặc Tính tổng.
• Nếu cần xuất danh sách, chẳng hạn như gửi email chứa tất cả các mục, bạn có thể sử dụng trực tiếp dữ liệu trả về trong các thao tác tiếp theo.

Để truy cập dữ liệu trả về trong các bước tiếp 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 cần hoàn tất (danh sách đơn hàng cần hoàn tất). Bạn có thể sử dụng biến này trong cả điều kiện và thao tác. Ví dụ: bạn có thể gửi danh sách đơn hàng cần hoàn tất trong thao tác Gửi email nội bộ như sau:

{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.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 sẽ bắt đầu vào thời gian bạn chỉ định, thay vì do một sự kiện mang lại. Vì không có sự kiện cụ thể nào trong cửa hàng hoặc từ ứng dụng bắt đầu 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

• Tài nguyên đơn hàng cần hoàn tất
• Bộ lọc truy vấn đơn hàng cần hoàn tất

Mẫu

Gửi email tóm tắt hằng ngày kèm danh sách đơn hàng cần hoàn tất đang tạm dừng

Mỗi ngày, dòng công việc này sẽ truy vấn tất cả đơn hàng cần hoàn tất đang tạm dừng (tối đa 100 đơn hàng cùng lúc). Dòng công việc sẽ gửi một email tóm tắt kèm theo tên đơn hàng và địa điểm hoàn tất đơn hàng được chỉ định. Xem mẫu