一键导入
import-san-pham
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Dùng khi người dùng yêu cầu tải, lấy, cập nhật, đồng bộ dữ liệu KiotViet khách hàng, sản phẩm, bảng giá, hóa đơn, hoặc dữ liệu nền để làm hóa đơn.
Dùng khi người dùng yêu cầu import, cập nhật, đồng bộ, điều chỉnh, so sánh, hoặc kiểm tra bảng giá KiotViet từ file.
Dùng khi cần client reverse API KiotViet, token, gian hàng, chi nhánh, sản phẩm, khách hàng, bảng giá, hóa đơn, đơn hàng, tồn kho, công nợ, báo cáo, nhà cung cấp, danh mục, job import, hoặc script API.
Dùng khi cần tổ chức output KiotViet thư mục data, raw export, dữ liệu xử lý, file import, báo cáo, backup, hoặc manifest.
Dùng khi người dùng yêu cầu làm việc với dữ liệu, sản phẩm, bảng giá, hóa đơn, đơn hàng, khách hàng, nhà cung cấp, danh mục, tồn kho, kiểm kho, thu chi, công nợ, báo cáo doanh thu, import, export, bảo trì reverse API, hoặc cập nhật KiotViet.
Dùng khi người dùng yêu cầu làm hóa đơn KiotViet, tạo đơn hàng, tạo file import hóa đơn, hoặc đối chiếu khách hàng và sản phẩm để bán hàng.
| 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. |
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 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/.
references/product-import-rules.md.templates/.data/import_ready/YYYYMMDD_HHMMSS/.data/reports/YYYYMMDD_HHMMSS/.check_session.py.KiotVietClient.import_products.wait_for_import_job.data/reports/YYYYMMDD_HHMMSS/.scripts/product_import_audit.py verify.data/import_errors/YYYYMMDD_HHMMSS/ nếu có.| Nhóm | Cột thường gặp |
|---|---|
| Định danh | Mã hàng, Mã sản phẩm, SKU, Mã vạch |
| Tên | Tên hàng, Tên sản phẩm |
| Phân loại | Nhóm hàng, Loại hàng |
| Đơn vị | Đơn vị tính |
| Giá | Giá bán, Giá vốn |
| Tồn kho | Tồn kho, Số lượng |
Nếu thiếu mã định danh hoặc tên hàng, dừng và hỏi.
Chỉ gọi API sau xác nhận:
from api_client import KiotVietClient
client = KiotVietClient()
job = client.import_products(
"data/import_ready/YYYYMMDD_HHMMSS/import_san_pham.xlsx",
is_replace_existing_by_code=True,
confirmed=True,
)
result = client.wait_for_import_job(job)
Sau khi job import trả về thành công, chưa nên kết luận xong. Trạng thái job không đảm bảo dữ liệu đã đúng.
Nên đọc lại dữ liệu thật từ KiotViet, rồi chạy:
~/.venv/claude/bin/python .agents/skills/import-san-pham/scripts/product_import_audit.py verify \
--file data/import_ready/YYYYMMDD_HHMMSS/import_san_pham.xlsx \
--products-json data/raw/YYYYMMDD_HHMMSS/products.json \
--report-dir data/reports/YYYYMMDD_HHMMSS
Báo cáo cuối nên tách rõ:
Nếu Giá vốn hoặc Tồn kho lệch sau import, báo là rủi ro cao.
Không tự sửa hai trường này nếu chưa xác định đúng cờ API hoặc nghiệp vụ kho.
Trước khi gọi API và truyền confirmed=True, báo rõ:
Không import nếu user chưa xác nhận đúng các tác động này.
Báo: