Các loại node - KiotViet

KiotViet

Mục đích

Nhóm KiotViet dùng để lấy dữ liệu vận hành bán lẻ từ KiotViet, gồm:

1. Nhóm hàng
2. Hàng hóa và tồn kho
3. Đặt hàng
4. Hóa đơn
5. Khách hàng và nhóm khách hàng
6. Phiếu nhập hàng
7. Chi nhánh
8. Người dùng
9. Tài khoản ngân hàng

Theo ảnh bạn gửi, trong Thư viện Giai đoạn có 11 node:

1. Lấy danh sách nhóm hàng
2. Lấy danh sách hàng hóa
3. Lấy danh sách tồn kho hàng hóa
4. Lấy danh sách đặt hàng
5. Lấy danh sách hóa đơn
6. Lấy danh sách khách hàng
7. Lấy danh sách nhóm khách hàng
8. Lấy danh sách phiếu nhập hàng
9. Lấy danh sách chi nhánh
10. Lấy danh sách người dùng
11. Lấy danh sách tài khoản ngân hàng

Thao tác tại màn hình Thư viện Giai đoạn

Cách mở nhanh

1. Vào workflow bất kỳ của quy trình vừa đã được tạo của workflow.

2. Nhấn Thêm giai đoạn trên canvas hoặc nút + ở nhánh node.

3. Panel Thư viện Giai đoạn mở ở cạnh phải.

4. Chọn nhóm KiotViet.

Cách tìm node nhanh

1. Dùng ô Tìm kiếm giai đoạn....

2. Nếu đang đứng ở danh sách nhóm, ô tìm kiếm lọc theo tên/mô tả nhóm.

3. Khi đã vào nhóm KiotViet, ô tìm kiếm lọc các node trong nhóm này.

4. Nhấn mũi tên quay lại để trở về danh sách nhóm.

Truyền biến trong nhóm KiotViet

1. Tất cả node đều cần Thông tin xác thực kiểu KIOTVIET_RETAIL.
2. Các trường lọc như Mã khách hàng, ID chi nhánh, Trạng thái, Sửa đổi từ, Từ ngày/Đến ngày có thể nhập tay hoặc map biến từ node trước.
3. Đa số node trả về:
   • data: danh sách dữ liệu
   • total: tổng số bản ghi
   • error, message: trạng thái lỗi/thông báo
4. Node sau có thể dùng trực tiếp output của node trước để lọc sâu hơn, ví dụ:
   • Lấy danh sách khách hàng -> lấy id khách -> truyền sang node đơn hàng/hóa đơn.

Mẫu thao tác chung (áp dụng cho đa số node KiotViet)

1. Thêm node KiotViet cần dùng.
2. Chọn Thông tin xác thực.
3. Chọn chế độ lấy dữ liệu:
   • Bật Lấy tất cả bản ghi: hệ thống tự quét nhiều trang.
   • Tắt Lấy tất cả bản ghi: nhập Kích thước trang và Chỉ mục hiện tại.
4. Điền các bộ lọc cần thiết (thời gian, trạng thái, chi nhánh, khách hàng...).
5. Nhấn Lưu.
6. Chạy Thực thi giai đoạn để kiểm tra dữ liệu trả về.

Hướng dẫn từng node

Chi tiết từng node

• Lấy danh sách nhóm hàng
• Lấy danh sách hàng hóa
• Lấy danh sách tồn kho hàng hóa
• Lấy danh sách đặt hàng
• Lấy danh sách hóa đơn
• Lấy danh sách khách hàng
• Lấy danh sách nhóm khách hàng
• Lấy danh sách phiếu nhập hàng
• Lấy danh sách chi nhánh
• Lấy danh sách người dùng
• Lấy danh sách tài khoản ngân hàng

Kiểm tra trước khi chạy

1. Kiểm tra kết nối KiotViet còn hiệu lực và đúng loại KIOTVIET_RETAIL.
2. Nếu dùng lọc theo ngày, đảm bảo khoảng ngày hợp lệ (Từ <= Đến).
3. Nếu tắt Lấy tất cả bản ghi, nhập Kích thước trang đúng ngưỡng cho node đó.
4. Nếu dùng danh sách ID (branchIds, customerIds, taxIds), kiểm tra đúng kiểu mảng.
5. Chạy thử từng node trước khi chạy toàn workflow để kiểm tra data, total, error, message.