Danh sách hóa đơn

Lấy danh sách hóa đơn đã đồng bộ của một tài khoản. Hỗ trợ lọc và phân trang.

GET /invoices

Query params

Param	Kiểu	Ý nghĩa
accountId	UUID	Bắt buộc — tài khoản cần tra
direction	string	purchase (mặc định lọc)
sellerTaxCode	string	Lọc theo MST người bán
dateFrom / dateTo	date	Lọc theo ngày lập
page / limit	int	Phân trang (mặc định 1 / 20)
sort	string	issueDate:desc | syncedAt:desc

Ví dụ response

{
  "data": [
    {
      "id": "0de33a81-fd05-4a1b-9c94-116f62c56057",
      "sellerTaxCode": "0101234567",
      "sellerName": "CÔNG TY TNHH THƯƠNG MẠI ABC",
      "buyerTaxCode": "0319074775",
      "invoiceSymbol": "K25TAA",
      "invoiceNumber": "88",
      "issueDate": "2025-03-15",
      "totalBeforeTax": 5000000,
      "totalTax": 400000,
      "totalAmount": 5400000,
      "currency": "VND"
    }
  ],
  "total": 12, "page": 1, "limit": 20, "totalPage": 1
}

ghi chú

Chỉ các trường định danh (MST bên bán/mua, số/ký hiệu hóa đơn, ngày lập) được lưu ở dạng cho phép lọc. Tên và số tiền được giải mã khi trả về. Sắp xếp theo số tiền không được hỗ trợ (dữ liệu tiền được mã hóa).