Vietnam Tender Intelligence

Monitor Vietnam's e-procurement portal (VNEPS) by keyword: upcoming plans, open tenders, and award results — full tender lifecycle in one Actor. Theo dõi đấu thầu công Việt Nam: kế hoạch, thông báo mời thầu, kết quả trúng thầu.

Monitors Vietnam's national e-procurement portal (VNEPS) by keyword and returns matching tenders as clean JSON: notice number, tender name, closing date, location, investment field.

Input: keywords (array of strings, required for "notices"/"plans"/"awards", max 20), recordType ("notices" default, "plans", "awards", or "awards_by_date"), maxResultsPerKeyword (integer, default 3, max 50), onlyOpenTenders (boolean, default true — only tenders still open for bidding; ignored when recordType is "plans"/"awards"/"awards_by_date"), province (required when recordType is "awards_by_date" — no keyword needed in this mode, results are scoped to one province instead), dateFrom/dateTo (optional, dd/mm/yyyy, only for "awards_by_date" — defaults to yesterday→today when omitted).

Pricing: Pay-per-event — $0.05 per run + $0.50 per keyword searched ("notices"/"plans"/"awards") or $0.50 per date-range search ("awards_by_date", charged once per run regardless of matches), plus $0.05 per package actually checked (only when it truly has a published award result) when recordType is "awards" or "awards_by_date" (see Pricing section below).

Output field reference (JSON keys are Vietnamese procurement terminology — real tender records never carry a trang_thai field; records that do are status/error notices, not tenders):

Full documentation below is in Vietnamese (the target user base for this Actor). The Input/Output schema tabs on this page are language-neutral and machine-readable.

Vietnam Tender Intelligence giám sát thông tin đấu thầu công theo từ khoá trên Hệ thống mạng đấu thầu quốc gia (VNEPS) — muasamcong.mpi.gov.vn, cổng đấu thầu chính thức của Bộ Tài chính Việt Nam. Actor trả về dữ liệu gói thầu dạng JSON sạch: tên gói thầu, mã thông báo, ngày đóng thầu, địa điểm, lĩnh vực đầu tư.

- Tự động hoá việc theo dõi gói thầu theo từ khoá, tính chi phí theo lượt dùng thực tế thay vì trả phí thuê bao cố định.

- Phù hợp cho: nhà thầu nhỏ muốn tự động dò gói thầu phù hợp ngành hàng, nhà cung cấp muốn theo dõi thị trường theo từ khoá cụ thể.

- Chạy trên Apify: có sẵn API, lịch chạy định kỳ (ví dụ chạy mỗi sáng để nhận gói thầu mới), tích hợp Zapier/Make/webhook.

- Mở tab Input.

- Nhập danh sách từ khoá cần theo dõi (ví dụ: "thiết bị y tế", "thi công sửa chữa").

- Bấm Start.

- Xem/tải kết quả ở tab Output.

Có thể tải dataset dạng JSON, CSV, Excel, HTML.

co_goi_chua_thong_bao: true nghĩa là kế hoạch này có ít nhất 1 gói thầu chưa được mời thầu chính thức — đây chính là tín hiệu "sắp có gói thầu" giá trị nhất của chế độ này. Các trường văn bản tự do (ten_ke_hoach, ten_du_an, chu_dau_tu, ten_goi_thau trong từng gói) được actor tự động che số điện thoại/email nếu bên mời thầu vô tình để lại thông tin liên hệ cá nhân trong đó (xem FAQ).

nha_thau_trung_thau chỉ chứa tên và mã số thuế của doanh nghiệp trúng thầu — không có tên người, số điện thoại hay bất kỳ thông tin cá nhân nào.

Lưu ý: actor luôn cố mở trang chi tiết để lấy đầy đủ cả thoi_gian_thuc_hien_goi_thau/thoi_gian_thuc_hien_hop_dong. Trong số ít trường hợp trang chi tiết tải chậm/lỗi tạm thời, actor tự động lấy thay tên nhà thầu + giá trúng thầu trực tiếp từ dữ liệu tìm kiếm (đã xác nhận chắc chắn có kết quả) — khi đó 2 trường thời gian này sẽ là null thay vì có giá trị, ghi_chu sẽ nói rõ trường hợp này.

Không có trường tu_khoa ở chế độ này (thay bằng tinh_thanh) vì không dùng từ khoá.

Ngoài các bản ghi bình thường ở trên, dataset có thể chứa các bản ghi đặc biệt — nhận diện qua field trang_thai (bản ghi bình thường KHÔNG có field này):

Lưu ý về giới hạn: mỗi lần chạy nhận tối đa 20 từ khoá, và lấy tối đa 50 gói thầu cho mỗi từ khoá (giới hạn kỹ thuật, không phân trang — cố ý đặt ở mức vừa phải để không gây tải nặng cho hệ thống nguồn). Nếu 1 từ khoá thực tế có nhiều hơn 50 kết quả phù hợp, bạn sẽ thấy bản ghi co_the_con_du_lieu — khi đó có thể thu hẹp từ khoá (cụ thể hơn) thay vì chạy lại toàn bộ với số lượng lớn hơn, để tránh tốn thêm chi phí không cần thiết.

⚠️ Lưu ý dữ liệu: Actor chỉ trích xuất các trường cấp gói thầu/hợp đồng ở trên — không có trường

riêng nào cho tên người, số điện thoại hay thông tin cá nhân. Tuy nhiên ten_goi_thau là văn bản tự

do do bên mời thầu tự nhập trên hệ thống nguồn, nên đôi khi có thể vô tình chứa thông tin liên hệ

(ví dụ email/số điện thoại của người phụ trách gói thầu) do chính bên mời thầu để lại — actor không

thể đảm bảo 100% trường này luôn sạch hoàn toàn, vì đây là dữ liệu do bên thứ ba nhập, không phải do

actor tự thêm vào.

Actor tính phí theo mô hình Pay-Per-Event — chỉ trả cho đúng phần đã dùng, không có phí thuê bao cố định:

Ví dụ (chế độ Thông báo mời thầu hoặc KHLCNT): chạy 1 lần với 5 từ khoá = $0.05 + 5 × $0.50 = $2.55. Ví dụ (chế độ Kết quả trúng thầu theo ngày): chạy 1 lần, tìm được 8 gói đã có kết quả = $0.05 + $0.50 + 8 × $0.05 = $0.95.

Mẹo tối ưu chi phí/mục dữ liệu: giá tính theo lượt tìm kiếm, không theo từng mục — đặt maxResultsPerKeyword cao hơn (ví dụ 20 thay vì 3) giúp chi phí/gói thầu giảm đáng kể (20 kết quả/từ khoá ≈ $0.025/gói, so với 3 kết quả/từ khoá ≈ $0.17/gói) mà không tốn thêm phí Keyword/Plan Searched.

- Nên giữ nguyên cấu hình Proxy mặc định (Residential, Việt Nam) — đây là cấu hình đã được kiểm chứng ổn định. Đổi sang cấu hình khác có thể làm lượt chạy thất bại. Nếu không truyền field proxyConfigurationkhi gọi actor (qua API/AI Agent), giá trị mặc định đúng sẽ tự động được áp dụng.

- Mỗi lần chạy có chi phí thời gian khởi động cố định (~20-30 giây) cộng thêm thời gian xử lý từng từ khoá (thường 40 giây - 2 phút/từ khoá). Nếu cần kết quả nhanh (ví dụ tích hợp với AI Agent, ứng dụng thời gian thực), nên gọi 1-3 từ khoá/lần thay vì nhồi nhiều từ khoá vào 1 lần chạy — thời gian tăng tuyến tính theo số từ khoá.

Dữ liệu lấy từ đâu? Từ các trang công khai của Hệ thống mạng đấu thầu quốc gia, không cần đăng nhập. Theo Luật Đấu thầu số 22/2023/QH15 (Điều 51 khoản 1), Hệ thống mạng đấu thầu quốc gia phải bảo đảm công khai, không hạn chế truy cập, tiếp cận đối với thông tin được đăng tải công khai trên hệ thống. Actor chỉ trả về thông tin cấp gói thầu đã công bố, không trích xuất trường thông tin liên hệ hay thông tin cá nhân nào. Bạn tự chịu trách nhiệm sử dụng dữ liệu phù hợp với quy định hiện hành.

Chế độ KHLCNT có lộ thông tin cá nhân không?

Actor tự động quét và che (thay bằng [ĐÃ CHE SĐT]/[ĐÃ CHE EMAIL]) các số điện thoại/email tìm thấy trong những trường văn bản tự do (ten_ke_hoach, ten_du_an, chu_dau_tu, ten_goi_thau của từng gói) — vì đây là dữ liệu do bên mời thầu tự nhập trên hệ thống nguồn, đôi khi vô tình để lại thông tin liên hệ cá nhân. Việc che chỉ dựa trên nhận diện mẫu (regex số điện thoại/email VN phổ biến) nên không đảm bảo bắt được 100% mọi trường hợp — nếu bạn phát hiện thông tin cá nhân lọt qua, vui lòng báo qua tab Issues.

Kết quả không đầy đủ 100% có được hoàn tiền không?

Do phụ thuộc vào tình trạng kết nối của hệ thống nguồn, thỉnh thoảng 1 từ khoá có thể gặp lỗi kỹ thuật tạm thời (xem bản ghi trang_thai: loi_ky_thuat trong Output). Nếu gặp tỷ lệ lỗi cao bất thường, vui lòng liên hệ qua tab Issues.

Chính sách dữ liệu & điều khoản sử dụng / Data & terms policy: https://donerightlabs.tviettuan01.workers.dev/chinh-sach