菜单
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.
用 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 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.
| name | lamhoadon |
| description | 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. |
Tạo hóa đơn hoặc file import hóa đơn từ yêu cầu người dùng.
Mặc định tra khách hàng, sản phẩm, bảng giá trực tiếp bằng reverse API trong kiotviet-client.
Luật chi tiết nằm trong references/invoice-rules.md. Phải đọc trước khi tạo file cuối cùng.
Hỏi TẤT CẢ trước khi bắt đầu quy trình:
Nếu thiếu phần nào, hỏi đúng phần thiếu.
| Dữ liệu | Hàm client |
|---|---|
| Khách hàng | export_customers hoặc endpoint khách hàng phù hợp |
| Sản phẩm | export_products |
| Bảng giá | export_pricebooks |
Không dùng cache file làm nguồn chính.
Dùng Giá Bán Buôn nếu user không chỉ định bảng giá khác.
Không tự đổi sang bảng giá khác nếu thiếu giá.
Tìm gần đúng theo:
Nếu có nhiều kết quả gần giống, hỏi user chọn.
Nếu không tìm thấy, hỏi thêm thông tin.
Ưu tiên:
Nếu không chắc, hỏi user chọn.
Không tự tạo mã hàng.
Ưu tiên giữ các mã, giá, khách hàng lấy từ dữ liệu KiotViet.
Tạo output trong:
data/processed/YYYYMMDD_HHMMSS/
data/reports/YYYYMMDD_HHMMSS/
data/import_ready/YYYYMMDD_HHMMSS/
Template import hóa đơn, nếu có, phải nằm trong templates/.
Mẫu hóa đơn hiện tại:
templates/MauFileDanhSachHoaDon.xlsx
Tên file gợi ý:
data/import_ready/YYYYMMDD_HHMMSS/don_hang_<ten_khach>_kiotviet.xlsx
Báo:
Hiện tại mặc định chỉ tạo file import.
Chỉ ghi trực tiếp lên KiotViet khi:
confirmed=True.Trước khi tạo hóa đơn hoặc import file lên KiotViet, báo rõ:
Không ghi nếu user chưa xác nhận đúng các tác động này.
Giá Bán Buôn.