Lấy dữ liệu mặt hàng tồn kho

Trong dòng công việc yêu cầu dữ liệu mặt hàng tồn kho, có thể sử dụng hành động Lấy dữ liệu mặt hàng tồn kho để lấy thông tin mặt hàng tồn kho từ cửa hàng. Mặt hàng tồn kho là các đơn vị hàng sẵn có thực tế được theo dõi cho các biến thể sản phẩm.

Cấu hình

Trường

Hành động Lấy dữ liệu mặt hàng tồn kho chứa các trường sau:

Trường được sử dụng trong hành động Lấy dữ liệu.
TrườngMô tả
Sắp xếp dữ liệu theoBắt buộc. Tham số dùng để sắp xếp dữ liệu trả về bởi truy vấn tìm kiếm.
Số kết quả tối đaBắt buộc. Số lượng kết quả tối đa có thể trả về bởi truy vấn tìm kiếm đã chọn. Có thể trả về tối đa 100 kết quả mỗi lần.
Truy vấnBắt buộc. Chọn trong số 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 mặt hàng tồn kho được theo dõi:

tracked:true

Biến tracked là một bộ lọc có sẵn trên truy vấn Mặt hàng tồn kho và có thể sử 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, cần lưu ý:

  • Danh sách các bộ lọc mặt hàng tồn kho hiện có

  • Các 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ị trường truy vấn cũng có 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, 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 áp dụng bộ 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.

  • Có thể chạy hoặc kiểm tra truy vấn trong cửa hàng bằng ứng dụng Shopify GraphiQL.

  • Cần lưu ý về điều sẽ xảy ra nếu truy vấn bị lỗi. Thường thì API sẽ trả về toàn bộ kết quả (thay vì không có kết quả nào).

Dữ liệu trả về

Mọi hành động Lấy dữ liệu đều trả về danh sách có từ 0 đến 100 tài nguyên. Tùy thuộc vào trường hợp sử dụng, có thể tậ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ư gắn thẻ cho từng mục, có thể sử dụng hành động 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ề, có thể sử dụng hành động Đếm hoặc Tính tổng.
  • Nếu cần xuất danh sách, chẳng hạn như gửi email kèm tất cả mặt hàng, 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 theo sau thao tác này, hãy sử dụng biến có tên Lấy dữ liệu mặt hàng tồn kho, đây là một danh sách các mặt hàng tồn kho. 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 mặt hàng tồn kho trong thao tác Gửi email nội bộ tương tự như sau:

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% 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 điểm bạn chỉ định thay vì do 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 để bắt đầu dòng công việc nên sẽ không có dữ liệu nào được tự động đưa vào.

Tài liệu tham khảo API

Để biết thêm thông tin về API được sử dụng trong thao tác này, hãy xem Truy vấn mặt hàng tồn kho.