lamhoadon

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:

• tên có dấu và không dấu.