菜单
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.
用 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, 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.
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 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 | kiotviet-data-manager |
| description | 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. |
Skill này giữ output KiotViet dễ quản lý, dễ audit, dễ rollback.
Chi tiết schema nằm trong references/data-contracts.md.
data/
├── raw/YYYYMMDD_HHMMSS/
├── processed/YYYYMMDD_HHMMSS/
├── import_ready/YYYYMMDD_HHMMSS/
├── import_errors/YYYYMMDD_HHMMSS/
├── reports/YYYYMMDD_HHMMSS/
└── _backup/YYYYMMDD_HHMMSS/
Template import gốc không nằm trong data/.
Template import KiotViet để trong:
templates/
| Thư mục | Dùng cho |
|---|---|
raw | JSON hoặc file tải trực tiếp từ KiotViet |
processed | dữ liệu đã chuẩn hóa để tra cứu |
import_ready | file chuẩn bị upload hoặc import bằng API |
import_errors | file lỗi, response lỗi, log import lỗi |
reports | báo cáo kiểm tra, đối chiếu, thay đổi |
_backup | bản cũ trước khi thay thế |
Mỗi lần chạy tạo:
data/<nhóm>/YYYYMMDD_HHMMSS/manifest.json
Manifest tối thiểu:
{
"run_id": "YYYYMMDD_HHMMSS",
"created_at": "2026-05-16T10:30:00",
"operation": "export",
"inputs": [],
"outputs": [],
"status": "success"
}
Không ghi token, cookie, mật khẩu, hoặc header auth vào manifest.
Trước khi ghi đè file Excel output, tạo backup:
data/_backup/YYYYMMDD_HHMMSS/
Chỉ backup file bị thay.
Không backup token hoặc file nhạy cảm.
Báo cáo ngắn:
Không liệt kê dữ liệu nhạy cảm.