メニュー
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.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/hoangvantuan/kiotviet-engine --skill import-san-phamコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
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.
SKILL.md を表示中
SOC 職業分類に基づく
| 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: