Hướng dẫn bổ sung API lấy đơn hàng theo trạng thái và loại bỏ đơn hàng đã hủy
1. Bối cảnh
Trong quá trình tích hợp API để lấy dữ liệu đơn hàng từ hệ thống Getfly CRM, doanh nghiệp có thể cần lọc đơn hàng theo các trạng thái cụ thể, đồng thời loại bỏ những đơn hàng đã bị hủy để đảm bảo dữ liệu đồng bộ chính xác với hệ thống bên ngoài.
Để đáp ứng nhu cầu này, người dùng cần bổ sung điều kiện lọc trạng thái vào lệnh API lấy đơn hàng.
2. Hướng dẫn cấu hình API
Sử dụng lệnh API sau để lấy danh sách đơn hàng theo điều kiện lọc trạng thái và loại bỏ đơn hàng đã hủy:
Lệnh API:
{{domain}}/api/v6/sale_orders?filtering[status:ne]=5&fields=status,status_label
Trong đó:
- {{domain}}: Thay bằng domain hệ thống Getfly CRM của doanh nghiệp.
- filtering[status:ne]=5: Điều kiện lọc các đơn hàng có trạng thái khác 5 (không lấy đơn hàng đã hủy).
- fields=status,status_label: Các trường dữ liệu trả về gồm mã trạng thái (status) và tên trạng thái (status_label).
Danh sách mã trạng thái đơn hàng:
| Mã trạng thái | Tên trạng thái |
|---|---|
| 1 | Chờ duyệt |
| 2 | Đã duyệt |
| 3 | Đang xuất kho |
| 4 | Đã hoàn thành/Đã xuất kho |
| 5 | Đã hủy |
Lưu ý: Khi cần lọc theo nhiều trạng thái, hãy sử dụng các mã trạng thái tương ứng theo cú pháp API được hỗ trợ. Các mã trạng thái được phân biệt bằng ký tự số..
Cảm ơn bạn đã theo dõi bài viết. chúc các bạn thao tác thành công!
Tags
Thông tin tác giả
Nguyễn Khánh Linh
4 lượt xem