Danh sách báo giá

1. Thông tin API

• Endpoint: /api/v6.1/quotes
• Method: GET
• Authentication: Yêu cầu X-API-KEY
• Header:
  • X-API-KEY: <your_api_key>

---

2. Tham số Request

2.1. Filtering (Lọc dữ liệu)

Trường	Hỗ trợ	Kiểu dữ liệu	Mô tả
id	eq, in	integer	Định danh
quote_code	eq, contains	string	Mã báo giá
quote_date	gte, lte, eq, between	timestamp	Ngày tạo báo giá
status	eq	integer	Trạng thái

2.2. Sorting (Sắp xếp dữ liệu)

Trường	Hướng
id	asc, desc

2.3. Pagination (Phân trang)

Tham số	Kiểu dữ liệu	Mô tả
limit	integer	Số bản ghi cần lấy
offset	integer	Số bản ghi cần bỏ qua

---

3. Response Mẫu

{
  "data": [
    {
      "id": 66,
      "quote_code": "BG090720251",
      "quote_date": "2025-07-09",
      "end_date": "2025-07-10",
      "status": 1,
      "status_title": "Chờ duyệt",
      "account_id": 1595,
      "account_name": "Khách hàng ABC",
      "assigned_user": 1551,
      "assigned_user_name": "Nhân viên A",
      "amount": 30000,
      "custom_fields": {}
    }
  ],
  "has_more": false,
  "offset": 0,
  "limited": 20,
  "sorted": {
    "id": "DESC"
  }
}

---

4. Mô tả các Trường Dữ Liệu

4.1. Thông tin báo giá

Trường	Kiểu dữ liệu	Mô tả
id	integer	Định danh
quote_code	string	Mã báo giá
quote_date	string	Ngày tạo báo giá
end_date	string	Ngày kết thúc
quote_number	numeric	Lần báo giá
project_name	string	Dự án
project_address	string	Địa chỉ dự án
description	string	Mô tả
note	string	Nội dung báo giá
status	numeric	Trạng thái
status_title	string	Tên trạng thái
amount	numeric	Tổng tiền
created_at	string	Thời gian tạo
updated_at	string	Thời gian cập nhật
is_expired	numeric	Đánh dấu đã hết hạn hay chưa

4.2. Thông tin người dùng

Trường	Kiểu dữ liệu	Mô tả
user_id	numeric/null	Id người tạo
user_name	string	Tên người tạo
assigned_user	numeric	Id người thực hiện
assigned_user_name	string	Tên người thực hiện
assigned_user_email	string	Email người thực hiện
assigned_user_phone	string	Số điện thoại người thực hiện
approval_user	numeric/null	Id người duyệt
approval_user_name	string	Tên người duyệt

4.3. Thông tin khách hàng

Trường	Kiểu dữ liệu	Mô tả
account_id	numeric	Id khách hàng
account_code	string	Mã khách hàng
account_name	string	Tên khách hàng
account_manager	numeric/null	Id người phụ trách khách hàng
account_address	string	Địa chỉ khách hàng
account_phone	string	Số điện thoại khách hàng
contact_id	numeric	Id liên hệ khách hàng
contact_name	string	Tên liên hệ khách hàng
contact_email	string	Email liên hệ khách hàng

4.4. Thông tin sản phẩm (quote_details)

Trường	Kiểu dữ liệu	Mô tả
quote_details.*.product_id	integer	Định danh sản phẩm
quote_details.*.product_code	string	Mã sản phẩm
quote_details.*.product_name	string	Tên sản phẩm
quote_details.*.description	string	Mô tả sản phẩm
quote_details.*.unit_id	numeric/null	Id đơn vị tính
quote_details.*.unit_name	string	Tên đơn vị tính
quote_details.*.quantity	numeric	Số lượng
quote_details.*.price	numeric	Đơn giá
quote_details.*.discount	numeric	Chiết khấu sản phẩm (%)
quote_details.*.discount_amount	numeric	Chiết khấu sản phẩm ($)
quote_details.*.vat	numeric	VAT sản phẩm (%)
quote_details.*.vat_amount	numeric	VAT sản phẩm ($)
quote_details.*.amount	numeric	Thành tiền
quote_details.*.product_image	string	Ảnh sản phẩm
quote_details.*.variants	array	Biến thể của sản phẩm
quote_details.*.items	array	Danh sách phụ kiện đi kèm

4.5. Thông tin tài chính

Trường	Kiểu dữ liệu	Mô tả
after_vat	enum (0,1)	Chiết khấu trước/sau thuế
discount	numeric	Chiết khấu báo giá (%)
discount_amount	numeric	Chiết khấu báo giá ($)
vat	numeric	VAT báo giá (%)
vat_amount	numeric	VAT báo giá ($)
service_charge_after_vat	enum (0,1)	Phí dịch vụ trước/sau thuế
transport	numeric	Phí vận chuyển (%)
transport_amount	numeric	Phí vận chuyển ($)
installation_charge_after_discount	enum (0,1)	Phí lắp đặt trước/sau thuế
installation	numeric	Phí lắp đặt (%)
installation_amount	numeric	Phí lắp đặt ($)
payment_periods	array	Danh sách kỳ thanh toán của báo giá
custom_fields	object	Thông tin định nghĩa dữ liệu
attachments	array	Tài liệu đính kèm

---

5. Ghi chú

• Trường custom_fields chứa các dữ liệu tùy chỉnh của báo giá.
• Nếu cần lọc dữ liệu nâng cao, có thể kết hợp các tham số filtering, sorting, limit, offset.