| name | import-san-pham |
| description | Dùng khi người dùng yêu cầu import, upload, thêm mới, cập nhật, hoặc kiểm tra sản phẩm KiotViet từ Excel, CSV, template, hoặc danh sách hàng hóa. |
Import Sản Phẩm
Mục tiêu
Kiểm tra file sản phẩm, tạo file import sạch, rồi import bằng reverse API nếu user xác nhận.
Template
Template import KiotViet lấy từ templates/.
Mẫu sản phẩm hiện tại:
templates/MauFileSanPham.xlsx
Không lưu template import trong .agents/skills hoặc data/.
File đã điền dữ liệu mới ghi vào data/import_ready/YYYYMMDD_HHMMSS/.
Luồng an toàn
- Xác định file nguồn.
- Đọc
references/product-import-rules.md.
- Lấy template phù hợp trong
templates/.
- Kiểm tra cột, dòng, mã hàng, tên hàng, nhóm hàng, giá, tồn kho.
- Tạo file sạch trong
data/import_ready/YYYYMMDD_HHMMSS/.
- Tạo báo cáo trong
data/reports/YYYYMMDD_HHMMSS/.
- Chạy
check_session.py.
- Hỏi xác nhận.
- Gọi
KiotVietClient.import_products.
- Chờ job bằng
wait_for_import_job.
- Lưu response job vào
data/reports/YYYYMMDD_HHMMSS/.
- Export lại sản phẩm từ KiotViet.
- Chạy
scripts/product_import_audit.py verify.
- Báo trường đúng, trường lệch, và mã chưa tìm thấy.
- Lưu lỗi vào
data/import_errors/YYYYMMDD_HHMMSS/ nếu có.
Cột cần kiểm tra
