import-san-pham

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

1. Xác định file nguồn.
2. Đọc references/product-import-rules.md.
3. Lấy template phù hợp trong templates/.
4. Kiểm tra cột, dòng, mã hàng, tên hàng, nhóm hàng, giá, tồn kho.
5. Tạo file sạch trong data/import_ready/YYYYMMDD_HHMMSS/.
6. Tạo báo cáo trong data/reports/YYYYMMDD_HHMMSS/.
7. Chạy check_session.py.
8. Hỏi xác nhận.
9. Gọi KiotVietClient.import_products.
10. Chờ job bằng wait_for_import_job.
11. Lưu response job vào data/reports/YYYYMMDD_HHMMSS/.
12. Export lại sản phẩm từ KiotViet.
13. Chạy scripts/product_import_audit.py verify.
14. Báo trường đúng, trường lệch, và mã chưa tìm thấy.
15. Lưu lỗi vào data/import_errors/YYYYMMDD_HHMMSS/ nếu có.

Cột cần kiểm tra