Đưa đơn và tồn kho Nhanh.vn vào Google Sheets

Bài toán: vì sao số đơn và tồn kho Nhanh.vn trên Sheets hay lệch?

Lệch vì báo cáo xuất tay của Nhanh.vn là bản chụp, còn đơn và tồn thay đổi từng phút ở nhiều cửa hàng. Người lọc tay còn phải tự quyết đơn nào thuộc Facebook, đơn nào thuộc Website, mỗi người một cách.

Tình huống quen thuộc: chủ shop hỏi "tuần này Facebook bán được bao nhiêu, kho Hà Nội còn bao nhiêu áo size M". Nhân viên mất nửa buổi để xuất hai file, lọc, dán vào Sheets. Đến khi gửi thì tồn kho đã khác.

Hai việc cần tách bạch: bảng đơn theo kênh bán, và bảng tồn theo từng kho. Cả hai đều nên lấy thẳng từ API Nhanh.vn.

Tư duy dẫn đường: cần dữ liệu nào, đọc thế nào cho đúng?

Đơn và tồn của Nhanh.vn đến từ các API khác nhau, và mỗi API có một vài trường dễ đọc nhầm. Bảng dưới ghép câu hỏi với nguồn.

Câu hỏi	API Nhanh v3	Đọc trường nào
Kênh nào bán được bao nhiêu?	`order/list`	`saleChannel`, nguồn đơn, trạng thái
Còn bao nhiêu hàng ở từng kho?	`product/list`	object `inventory` theo kho của mỗi sản phẩm
Mã kho trong tồn là cửa hàng nào?	`business/depot`	tên và địa chỉ kho
Cửa hàng bán lẻ thu bao nhiêu?	`bill/list`	hóa đơn bán lẻ, xuất nhập kho

Ba bẫy đã làm sai báo cáo thật:

saleChannel = 1 là "Admin", không phải Facebook. Đó là đơn nhân viên tạo tay trên Nhanh. Đơn này có thể đến từ Facebook, chat Shopee, CSKH hay Website, phân biệt bằng nguồn đơn. Coi mọi đơn Admin là Facebook sẽ thổi phồng kênh Facebook. Bảng đã xử lý của 360 có cột channel phân loại theo cấu hình kênh của brand; đơn không phân được để trống, không đoán.
Phí ship là phí báo giá cho tới khi bàn giao. carrier.shipFee được tính lúc tạo vận đơn. Nó chỉ thành chi phí thật khi đơn đã bàn giao đơn vị vận chuyển (sendCarrierAt > 0). Một đơn "Thành công" có mã vận đơn vẫn có thể chưa từng giao cho hãng.
Nhanh.vn không có "đơn hoàn" theo nghĩa của sàn. Các trạng thái Xác nhận hoàn, Đang chuyển hoàn, Đã chuyển hoàn, Thất bại đều là hàng quay về người bán. Bảng của 360 ghi chung là delivery_failed. Đừng cộng chúng vào tỉ lệ hoàn khi so với Shopee hay TikTok Shop.

AI bứt tốc: thiết lập trong bao lâu, gồm những bước nào?

Bảng đơn mất khoảng 15 phút và không cần code. Bảng tồn kho cần một workflow nhỏ, khoảng 30 phút nếu dùng n8n.

Bảng đơn theo lịch

Đăng ký ở Partner Quantri360, bật xác thực hai lớp.
Vào nền tảng Nhanh.vn và ủy quyền business Nhanh của bạn.
Đích nhận → Google Sheets → đăng nhập Google; để trống ô bảng tính thì hệ thống tự tạo bảng mới.
Kết nối: Nhanh.vn → "Đơn hàng Nhanh.vn (đã xử lý)" → đích Sheets → lịch mỗi giờ, hằng ngày hoặc hằng tuần. Có thể lọc theo trạng thái.

Mỗi dòng là một sản phẩm trong đơn, gồm channel, status, tỉnh, đơn vị vận chuyển, mã vận đơn, giá, chiết khấu. Lịch tự động là phần mua thêm, xem bảng giá.

Bảng tồn theo kho

Loại "Tồn kho Nhanh.vn" dạng kết nối sẵn đang ở trạng thái "Sắp có". Hiện tại lấy tồn bằng API Nhanh qua 360:

curl -s -X POST "https://partner.quantri360.com/v1/nhanh/v3.0/product/list" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"paginator":{"size":50}}'

Mỗi sản phẩm trả kèm object inventory có tồn theo từng kho. Trong n8n: lịch 07:00 → HTTP Request gọi product/list, lặp theo paginator.next → tách sản phẩm và kho → ghi Google Sheets (xóa tab cũ rồi ghi lại để luôn là số mới nhất). Gọi business/depot một lần để đổi mã kho thành tên cửa hàng. Mẫu workflow đơn Nhanh có sẵn trong mục Tài liệu sau khi đăng nhập; phần tồn kho sửa node HTTP sang product/list.

Dùng AI đọc bảng. Đặt hai tab cạnh nhau rồi hỏi ChatGPT hoặc Claude:

"Tab Đơn là đơn Nhanh 14 ngày qua, tab Tồn là tồn hiện tại theo kho. Với mỗi mã sản phẩm và kho, tính số ngày bán còn đủ = tồn ÷ (số lượng bán 14 ngày ÷ 14). Liệt kê mã dưới 7 ngày. Bỏ qua dòng status = delivery_failed hoặc cancelled."

Định nghĩa "bán" do bạn chốt trong câu hỏi. AI chỉ làm phép tính nhanh và nhất quán.

Kết quả đo được

Ghi lại ba chỉ số dưới đây trong hai tuần đầu, so với cách làm cũ. Không cần công cụ ngoài, chỉ cần bảng và nhật ký chạy.

Giờ công: thời gian xuất, lọc, dán hai file mỗi tuần trước và sau khi có bảng tự động.
Độ trễ tồn kho: thời điểm workflow chạy gần nhất so với lúc bạn đọc bảng. Chạy hằng ngày lúc 07:00 thì số trễ tối đa một ngày; cần sát hơn thì chạy mỗi giờ.
Sai lệch phát hiện: số đơn Admin trước đây bị tính vào Facebook, số đơn có phí ship báo giá nhưng chưa bàn giao, và số dòng giao thất bại từng bị gọi là hoàn.

Bán thêm trên sàn thì xem đơn Shopee vào Google Sheets. Muốn gửi tin Zalo khi đơn Nhanh đổi trạng thái, xem ZNS theo trạng thái đơn hàng.

API liên quan

order/list: danh sách đơn lọc theo ngày tạo, ngày cập nhật hoặc mã đơn.
product/list: danh sách sản phẩm kèm tồn theo từng kho.
product/detail: chi tiết một sản phẩm khi cần tra riêng.
business/depot: danh sách kho và cửa hàng.
bill/list: hóa đơn bán lẻ và phiếu xuất nhập kho.

Đọc thêm: tự động hóa quy trình kinh doanh — bài tổng quan của chủ đề này.