| 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
- Dùng skill
kiotviet-client.
- Dùng skill
kiotviet-data-manager.
- Đọc
references/export-contract.md.
- Chạy
check_session.py.
- Chạy
kiotviet_export.py.
- Ghi output vào
data/raw/YYYYMMDD_HHMMSS/.
- 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
Khi cần hóa đơn
Yêu cầu ngày bắt đầu và ngày kết thúc nếu user chưa nêu.
Script kiotviet_export.py sẽ dừng nếu tải hóa đơn mà thiếu một trong hai ngày.
~/.venv/claude/bin/python .agents/skills/kiotviet-client/scripts/kiotviet_export.py \
--output-root data \
--types invoices \
--from-date 2026-05-01 \
--to-date 2026-05-16
Không làm
- Không dùng Public API Business.
- Không dùng Save As thủ công trừ khi reverse API hỏng.
- Không lưu token hoặc HAR thô vào
data.
- Không ghi đè file gốc nếu chưa backup.
- Không tải hóa đơn không giới hạn ngày khi user chưa xác nhận phạm vi.
Báo cáo
Báo ngắn:
- Loại dữ liệu đã tải.
- Run id.
- File trong
data/raw.
- Lỗi nếu có.
