القائمة
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.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/hoangvantuan/kiotviet-engine --skill import-update-bang-giaيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى 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, 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 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.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | import-update-bang-gia |
| description | 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. |
Cập nhật giá an toàn bằng dữ liệu API hiện tại và báo cáo chênh lệch trước khi ghi.
KiotVietClient.export_pricebooks.KiotVietClient.export_products.templates/.data/reports, data/import_ready, data/import_errors.Mẫu bảng giá hiện tại:
templates/MauFileBangGia.xlsx
references/price-update-rules.md.KiotVietClient.export_pricebooks.KiotVietClient.export_products.Báo rõ khi:
Ngưỡng có thể đổi nếu user chỉ định.
Ưu tiên import bằng file nếu templates/ có template KiotViet phù hợp.
Không lưu template import trong .agents/skills hoặc data/.
Nếu tạo hoặc cập nhật bảng giá trực tiếp:
create_pricebook(..., confirmed=True) nếu bảng giá chưa có.add_products_to_pricebook(..., confirmed=True).calc_price_for_all_items(..., confirmed=True).get_pricebook_items để verify giá sau ghi.Chỉ dùng build_update_product_payload và update_product khi mục tiêu là sửa trực tiếp hàng hóa.
Trước khi gọi API và truyền confirmed=True, báo rõ:
Không update nếu user chưa xác nhận đúng các tác động này.
Báo:
qa_report.json.Trước khi apply, tạo qa_report.json cùng thư mục report.
Sau đó kiểm bằng kiotviet_write_gate.validate_apply_gate.
Nếu thiếu QA report, có blocker, hoặc xác nhận không khớp thì dừng.