download-du-lieu-kiotviet

name	download-du-lieu-kiotviet
description	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.

Download Dữ Liệu KiotViet

Mục tiêu

Tải dữ liệu KiotViet bằng reverse API từ kiotviet-client.

Không thao tác export thủ công trên UI, trừ khi endpoint hỏng.

Dữ liệu hỗ trợ

Loại	Hàm client	File output
Khách hàng	export_customers	customers.json
Sản phẩm	export_products	products.json
Bảng giá	export_pricebooks	pricebooks.json
Hóa đơn	export_invoices	invoices.json

Nếu user nói “tải dữ liệu KiotViet”, mặc định tải khách hàng, sản phẩm, bảng giá.

Luồng chạy

1. Dùng skill kiotviet-client.
2. Dùng skill kiotviet-data-manager.
3. Đọc references/export-contract.md.
4. Chạy check_session.py.
5. Chạy kiotviet_export.py.
6. Ghi output vào data/raw/YYYYMMDD_HHMMSS/.
7. Báo run id và danh sách file.

Lệnh mặc định

test -d ~/.venv/claude || uv venv ~/.venv/claude
uv pip install --python ~/.venv/claude/bin/python requests urllib3
~/.venv/claude/bin/python .agents/skills/kiotviet-client/scripts/check_session.py
~/.venv/claude/bin/python .agents/skills/kiotviet-client/scripts/kiotviet_export.py \
  --output-root data \
  --types customers products pricebooks