| 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. |
Làm Hóa Đơn KiotViet
Mục tiêu
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.
Đầu vào tối thiểu
Hỏi TẤT CẢ trước khi bắt đầu quy trình:
- Tên khách hàng hoặc số điện thoại.
- Danh sách mặt hàng.
- Số lượng từng mặt hàng.
- Tồn kho âm: Gian hàng cho phép bán khi tồn kho ≤ 0 không? Mặc định hỏi user. Nếu không cho phép, cảnh báo SP hết hàng và hỏi thay thế.
- Thanh toán: Ghi nhận thanh toán không? Tiền mặt hay chuyển khoản? Mặc định để trống (chưa thanh toán). Nếu user chọn, điền tổng tiền vào cột tương ứng ở dòng đầu.
Nếu thiếu phần nào, hỏi đúng phần thiếu.
Nguồn tra cứu API
| 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.
Bảng giá mặc đị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á.
Tra khách hàng
Tìm gần đúng theo:
