Hướng dẫn sử dụng API ListKQLCNT - vinades/api.dauthau.info GitHub Wiki

Tác dụng

Lấy các thông tin về KQLCNT của doanh nghiệp có MST nhập vào trúng thầu

LƯU Ý

Cần gọi 1 lần MST cần tìm với API ListBusinessReg để hệ thống đánh dấu lại

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 "ListKQLCNT" Required
page int Lấy dữ liệu của trang số mấy (Mỗi trang 20 KQLCNT) Optional 1
mst string MST của 01 doanh nghiệp Required
  • hashsecret: Mã bí mật mỗi lần resquest, thường có 2 cách băm:
  1. password_hash($apisecret . '_' . $timestamp, PASSWORD_DEFAULT) với phương thức xác thực là password_verify
  2. md5($apisecret . '_' . $timestamp) với phương thức xác thực là md5_verify

Ví dụ viết bằng PHP:

$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' => 'ListKQLCNT', // Tên API được list bên dưới
    'page' => 1,
    'mst' => '0102775207'
];
  • mst: MST của 01 doanh nghiệp
  • page: Lấy dữ liệu của trang số mấy (Mỗi trang 20 KQLCNT)

Dữ liệu trả về nếu API truy cập thành công

{
    "status": "success",
    "code": "0000",
    "message": "",
    "total_pages": 1,
    "page_size": 20,
    "current_page": 1,
    "total_elements": 4,
    "content": [
        {
        "131938": {
            "id": 131938,
            "bid_code": "20170101853",
            "investor": "Tạp chí Giáo dục",
            "title": "Mua phần mềm website của Tạp chí Giáo dục (Đăng tải trên báo đấu thầu số 03 ngày 05/01/2017)",
            "bid_price_number": 25000000,
            "win_price_number": 24770000,
            "ctype": "",
            "type_bid": "",
            "cat": "Đấu thầu trực tiếp",
            "date_approval": "",
            "finish_time": "2017-01-04T21:17:00-05:00",
            "number_document": null,
            "is_domestic": "Quốc tế",
            "bidfieid": "",
            "decision_agency": "",
            "bidder_name": "Công ty CP Phát triển nguồn mở Việt Nam",
            "arr_bidder": [
                {
                    "no_business_licence": "0104480086",
                    "bidder_name": "Công ty CP Phát triển nguồn mở Việt Nam"
                }
            ],
            "result": "Có nhà thầu trúng thầu",
            "total_goods": 0
        },
        "559001": {
            "id": 559001,
            "bid_code": "20200955145",
            "investor": "Trường Đại học Khoa học Xã hội và Nhân văn",
            "title": "Xây dựng hệ thống Website của Trường Đại học Khoa học Xã hội và Nhân văn",
            "bid_price_number": 33200000,
            "win_price_number": 31200000,
            "ctype": "",
            "type_bid": "Chào hàng cạnh tranh rút gọn",
            "cat": "Đấu thầu qua mạng",
            "date_approval": "",
            "finish_time": "2020-10-01T23:26:00-04:00",
            "number_document": null,
            "is_domestic": "Quốc tế",
            "bidfieid": "",
            "decision_agency": "",
            "bidder_name": "Công ty Cổ phần phát triển nguồn mở Việt Nam",
            "arr_bidder": [
                {
                    "no_business_licence": "0104480086",
                    "bidder_name": "Công ty Cổ phần phát triển nguồn mở Việt Nam"
                }
            ],
            "result": "Có nhà thầu trúng thầu",
            "total_goods": 0
        },
        "769140": {
            "id": 769140,
            "bid_code": "20211070313",
            "investor": "Viện kiểm sát nhân dân tỉnh Hà Nam",
            "title": "Nâng cấp trang tin điện tử Viện kiểm sát nhân dân tỉnh Hà Nam",
            "bid_price_number": 6000000,
            "win_price_number": 6000000,
            "ctype": "",
            "type_bid": "Chỉ định thầu rút gọn",
            "cat": "Đấu thầu trực tiếp",
            "date_approval": "2021-10-17T13:00:00-04:00",
            "finish_time": "2021-10-24T13:00:00-04:00",
            "number_document": "",
            "is_domestic": "Quốc tế",
            "bidfieid": "",
            "decision_agency": "",
            "bidder_name": "Công ty cổ phần phát triển nguồn mở Việt Nam",
            "arr_bidder": [
                {
                    "no_business_licence": "0104480086",
                    "bidder_name": "Công ty cổ phần phát triển nguồn mở Việt Nam"
                }
            ],
            "result": "Có nhà thầu trúng thầu",
            "total_goods": 0
        },
        "968623": {
            "id": 968623,
            "bid_code": "20220788129",
            "investor": "Trường đại học Bách khoa Hà Nội",
            "title": "Nâng cấp cổng thông tin điện tử (website, giao diện và các module) cho Trường Đại học Bách khoa Hà Nội",
            "bid_price_number": 29800000,
            "win_price_number": 28100000,
            "ctype": "",
            "type_bid": "Chỉ định thầu rút gọn",
            "cat": "Đấu thầu trực tiếp",
            "date_approval": "2022-07-26T13:00:00-04:00",
            "finish_time": "2022-07-26T13:00:00-04:00",
            "number_document": "",
            "is_domestic": "Quốc tế",
            "bidfieid": "",
            "decision_agency": "",
            "bidder_name": "Công ty Cổ phần phát triển nguồn mở Việt Nam",
            "arr_bidder": [
                {
                    "no_business_licence": "0104480086",
                    "bidder_name": "Công ty Cổ phần phát triển nguồn mở Việt Nam"
                }
            ],
            "result": "Có nhà thầu trúng thầu",
            "total_goods": 0
        }
    }]
}
  • total_pages: Tổng số trang
  • page_size: Số dữ liệu trên 1 trang (hiện tại để 20)
  • current_page: Trang hiện tại
  • total_elements: Tổng số dữ liệu
  • is_pay: Request có tính phí không

content (mảng dữ liệu cần quan tâm)

  • id: ID của KQLCNT trên hệ thống dauthau.info
  • bid_code: mã TBMT của gói thầu
  • title: tên gói thầu
  • bid_price_number: giá gói thầu
  • win_price_number: giá trúng thầu
  • ctype: Loại hợp đồng
  • type_bid: Hình thức đấu thầu
  • cat: Hình thức dự thầu
  • finish_time: Thời điểm kết thúc, Theo chuẩn ISO 8601 date, ví dụ: 2004-02-12T15:19:21+00:00
  • date_approval: Thời điểm đăng tải, Theo chuẩn ISO 8601 date, ví dụ: 2004-02-12T15:19:21+00:00 (nếu không có giá trị này bằng rỗng)
  • number_document: Số quyết định phê duyệt
  • is_domestic: Trong nước/Quốc tế
  • bidfieid: Lĩnh vực
  • decision_agency: Cơ quan phê duyệt
  • result: Kết quả lựa chọn nhà thầu dạng chữ
  • total_goods : Số hàng hoá của gói thầu. Để lấy danh sách hàng hóa, nếu total_goods > 0 hãy gọi tiếp API ResultGoods để lấy chi tiết hàng hóa
  • bidder_name: Tên doanh nghiệp trúng thầu (Có thể là liên danh)
  • arr_bidder : Danh sách nhà thầu trúng (có thể nhiều hơn 1):
  1. no_business_licence : MST của doanh nghiệp
  2. bidder_name : Tên doanh nghiệp

Các mã lỗi

  • 1002: No data!!! - Không có dữ liệu trả về
  • 1003: No data input - Không có dữ liệu đầu vào
  • 1004: Error mst not regulations: Mã số thuế không đúng định dạng
  • 1005: Error mst not register: chưa đăng ký MST
  • 1009: Error, Contact Admin - Lỗi hệ thống chưa xác định