Hướng dẫn sử dụng API GetDetailKqmt - vinades/api.dauthau.info GitHub Wiki
Tác dụng
Lấy các thông tin chi tiết của Kqmt
Tham số có thể truyền vào:
Request Parameters
| Parameter | Type | Description | Required | Default |
|---|---|---|---|---|
| apikey | string | Khóa truy cập | Required | |
| timestamp | int | Thời gian hiện tại dạng 11 số | Required | |
| hashsecret | string | Mã bí mật đã được băm | Required | |
| language | varchar(02) | Ngôn ngữ trả về (Chấp nhận giá trị 'vi' hoặc 'en') | Required | |
| action | string | "GetDetailKqmt" | Required | |
| id | int | ID của Kqmt bên DauThau.info | Optional* | |
| so_tbmt | string | Số TBMT | Optional* |
(*) Lưu ý: Cần truyền ít nhất một trong hai tham số id hoặc so_tbmt
- hashsecret: Mã bí mật mỗi lần resquest, thường có 2 cách băm:
- password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT) với phương thức xác thực là password_verify
- md5($apisecret . '_' . $timestamp) với phương thức xác thực là md5_verify
Ví dụ sử dụng:
Cách 1: Truy vấn theo ID
$request = [
'apikey' => '...', // Khóa được cung cấp
'timestamp' => '...', // Thời gian resquest sai lệch với giờ máy chủ không quá 5 giây
'hashsecret' => '...', // Mã bí mật mỗi lần resquest = password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT);
'action' => 'GetDetailKqmt', // Tên API được list bên dưới
'id' => 1, // ID của Kqmt bên DauThau.info
];
Cách 2: Truy vấn theo số TBMT
$request = [
'apikey' => '...', // Khóa được cung cấp
'timestamp' => '...', // Thời gian resquest sai lệch với giờ máy chủ không quá 5 giây
'hashsecret' => '...', // Mã bí mật mỗi lần resquest = password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT);
'action' => 'GetDetailKqmt', // Tên API được list bên dưới
'so_tbmt' => 'IB2300130122-00', // Số TBMT
];
Mô tả tham số:
id: ID của Kqmt bên DauThau.infoso_tbmt: Số TBMT (Mã thông báo mời thầu)
Dữ liệu trả về nếu API truy cập thành công
{
"status": "success",
"code": "0000",
"message": "",
"content": {
"goi_thau": "Gói thầu số 06: Thi công xây dựng công trình Chống thấm mặt đường Đường tỉnh 915 (Km29+700-Km31+300; Km35+637-Km40+937), huyện Trà Cú",
"so_tbmt": "IB2300130122-00",
"chu_dau_tu": "CÔNG TY CP TƯ VẤN & XÂY DỰNG HẠ TẦNG KỸ THUẬT BỀN VỮNG CỬU LONG",
"ben_moi_thau": "CÔNG TY CP TƯ VẤN & XÂY DỰNG HẠ TẦNG KỸ THUẬT BỀN VỮNG CỬU LONG",
"id_loai": "Xây lắp",
"phuongthuc": "Một giai đoạn một túi hồ sơ",
"id_khlcnt": "PL2300090840",
"contract_period": 90,
"hinh_thuc_lc": "Đấu thầu rộng rãi",
"hinh_thuc_hd": "Trọn gói",
"thoi_diem_mo_thau": "2023-06-26T16:00:00",
"thoi_diem_hoan_thanh": "2023-06-26T16:03:40",
"gia_goi_thau": 5134494655,
"so_luong_nha_thau": 4,
"danhgia_gia": "",
"danhgia_kt": "Chấm điểm",
"ly_do_huy": "",
"bid_estimate_price": 0,
"nguon_von": "Ngân sách tỉnh năm 2023 (nguồn sự nghiệp thường xuyên)",
"trang_thai_title": "Hoàn thành mở thầu",
"gia_goi_thau_format": "5.134.494.655 VND",
"hinh_thuc_nhan_hs": "Đấu thầu qua mạng",
"title_khlcnt": "",
"dia_diem_mo_thau": "Website: http://muasamcong.mpi.gov.vn",
"update_time": "09:40 2025-09-21",
"business": {
"3": {
"id": 3,
"ten_nha_thau": "CÔNG TY TNHH XÂY DỰNG THƯƠNG MẠI DỊCH VỤ THUẬN THIÊN THÀNH",
"so_dkkd": "vn1801439270",
"ten_lien_danh": "Liên danh Công ty Thuận Thiên Thành và Công ty số 2-715",
"partnership": 2,
"gia_du_thau": 4739405854,
"gia_sau_giam": 4206222695.425,
"tyle_giamgia": "11",
"hieu_luc_hsdxtc": 90,
"hieu_luc_bao_dam": 120,
"thoi_gian_thuc_hien": "90 Ngày",
"bao_dam": 77000000,
"step_fail": "",
"reason_fail": "",
"ghichu": "Đạt kỹ thuật"
},
"4": {
"id": 4,
"ten_nha_thau": "CÔNG TY SỐ 2-715",
"so_dkkd": "",
"ten_lien_danh": "Liên danh Công ty Thuận Thiên Thành và Công ty số 2-715",
"partnership": 3,
"gia_du_thau": 4739405854,
"gia_sau_giam": 4206222695.425,
"tyle_giamgia": "11",
"hieu_luc_hsdxtc": 90,
"hieu_luc_bao_dam": 120,
"thoi_gian_thuc_hien": "90 Ngày",
"bao_dam": 77000000,
"step_fail": "",
"reason_fail": "",
"ghichu": "Đạt kỹ thuật"
},
"5": {
"id": 5,
"ten_nha_thau": "CÔNG TY TNHH MỘT THÀNH VIÊN XÂY DỰNG AN TRƯỜNG",
"so_dkkd": "vn1801473264",
"ten_lien_danh": "",
"partnership": 1,
"gia_du_thau": 4853478858,
"gia_sau_giam": 4853478858,
"tyle_giamgia": "0",
"hieu_luc_hsdxtc": 90,
"hieu_luc_bao_dam": 120,
"thoi_gian_thuc_hien": "90 Ngày",
"bao_dam": 77000000,
"step_fail": "",
"reason_fail": "",
"ghichu": "Đạt kỹ thuật"
},
"6": {
"id": 6,
"ten_nha_thau": "CÔNG TY TNHH MỘT THÀNH VIÊN THỊNH HƯNG PHÁT",
"so_dkkd": "vn1400694354",
"ten_lien_danh": "",
"partnership": 1,
"gia_du_thau": 4351243914,
"gia_sau_giam": 4351243914,
"tyle_giamgia": "0",
"hieu_luc_hsdxtc": 90,
"hieu_luc_bao_dam": 120,
"thoi_gian_thuc_hien": "90 Ngày",
"bao_dam": 77000000,
"step_fail": "",
"reason_fail": "",
"ghichu": "Đạt kỹ thuật"
},
"7": {
"id": 7,
"ten_nha_thau": "CÔNG TY TNHH XÂY DỰNG HỒNG HÀ",
"so_dkkd": "vn0305213725",
"ten_lien_danh": "",
"partnership": 1,
"gia_du_thau": 5129446085,
"gia_sau_giam": 5026857163.3,
"tyle_giamgia": "2",
"hieu_luc_hsdxtc": 90,
"hieu_luc_bao_dam": 120,
"thoi_gian_thuc_hien": "90 Ngày",
"bao_dam": 77000000,
"step_fail": "",
"reason_fail": "",
"ghichu": "Đạt kỹ thuật"
}
}
},
"is_pay": 1
}
content (mảng dữ liệu cần quan tâm)
goi_thau: Tên gói thầuso_tbmt: Số tbmtchu_dau_tu: Chủ đầu tưben_moi_thau: Bên mời thầuid_loai: Loạiphuongthuc: Phương thứcid_khlcnt: Mã KHLCNTcontract_period: Thời gian thực hiện hợp đồnghinh_thuc_lc: Hình thức LCNThinh_thuc_hd: Hình thức HĐthoi_diem_mo_thau: Thời điểm mở thầuthoi_diem_hoan_thanh: Thời điểm hoàn thànhgia_goi_thau: Giá gói thầuso_luong_nha_thau: Số lượng nhà thầudanhgia_gia: Đánh giá giádanhgia_kt: Đánh giá kỹ thuậtly_do_huy: Lý do huỷbid_estimate_price: Dự toán gói thầutitle_khlcnt: Tên kế hoạch LCNTgia_goi_thau_format: giá gói thầu formatupdate_time: Thời gian cập nhậtbusiness: Mảng chứa danh sách nhà thầu tham dự
- id: Số thứ tự
- ten_nha_thau: Tên nhà thầu
- so_dkkd: Số đăng ký kinh doanh
- ten_lien_danh: Tên liên danh
- partnership: vị trí trong liên danh
- gia_du_thau: Giá dự thầu
- gia_sau_giam: Giá dự thầu sau khi giảm
- tyle_giamgia: Tỷ lệ giảm giá dự thầu (%)
- hieu_luc_hsdxtc: Hiệu lực HSĐXKT
- hieu_luc_bao_dam: Hiệu lực BĐDT
- thoi_gian_thuc_hien: Thời gian thực hiện
- bao_dam: Bảo đảm dự thầu
- step_fail: Bước trượt đánh giá NTDKT
- reason_fail: Lý do không đạt
- ghichu: Ghi chú
Lưu ý về tham số truy vấn:
- Có thể truy vấn theo
id(ID số) hoặcso_tbmt(mã chuỗi) - Cần truyền ít nhất một trong hai tham số này
- Nếu truyền cả hai, hệ thống sẽ ưu tiên sử dụng
so_tbmt
Các mã lỗi
1002: No data!!! - Không có dữ liệu trả về1003: No data input!!! - Không có tham sốidhoặcso_tbmt1008: Invalid code format - Định dạngso_tbmtkhông hợp lệ1009: Error, Contact Admin - Lỗi hệ thống chưa xác định