POST /api/vneps/tenders
Price: 20 credits
Vietnam contractor selection notice from muasamcong.mpi.gov.vn by notice number or URL: the notice with lots, guarantees, locations and amendments, the procurement plan package, cancellation, shortlist, online price re-offer rounds, bid opening with every bidder's price, and the award result with winners, lot prices and awarded goods.
Takes the `id` of a vneps/tenders/search row. `bid_submissions` fills once bids are opened and `award` once the result is published; `reoffer` is set on shortened online quotations instead of `notice`. Shortened direct appointments, and other notices the portal publishes only as an award, carry `award` without `notice` or `package`.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)id string required — Notice number or notice URL (examples: "IB2600554528", "DC2600017791", "https://muasamcong.mpi.gov.vn/web/guest/contractor-selection?p_p_id=egpportalcontractorselectionv2_WAR_egpportalcontractorselectionv2&id=d46f8cd7-ed1a-4cd2-b70e-e63b41b996ec¬ifyNo=IB2600554528")@type string (default: "VnepsTender")id string requirednotice_id string nullablenotify_version string nullableurl string nullablename string nullableproject_name string nullablepackage_number string nullablepackage_id string nullableplan_number string nullableplan_type string nullablestage string nullablestatus string nullablenotify_status string nullableinvest_fields array (default: [])bid_field string nullableprocedure string nullableselection_method string nullablebid_mode string nullablework_type string nullableis_online boolean nullableis_domestic boolean nullableis_multi_lot boolean nullableis_medicine boolean nullablemedicine_count integer nullableprice number nullablereoffer_start_price number nullablereoffer_price_step number nullableinvestor object nullable@type string (default: "VnepsParty")code string nullablename string nullableprocuring_entity object nullable@type string (default: "VnepsParty")code string nullablename string nullablejoint_venture_name string nullablelocations array (default: [])@type string (default: "VnepsLocation")province_code string nullableprovince_name string nullabledistrict_code string nullabledistrict_name string nullableward_code string nullableward_name string nullablepublished_at integer nullableoriginal_published_at integer nullablebid_close_at integer nullablebid_open_at integer nullableactual_bid_open_at integer nullablebid_opening_published_at integer nullableaward_published_at integer nullableaward_decision_at integer nullableapproval_at integer nullablebidder_count integer nullabletechnical_bidder_count integer nullableclarification_count integer nullablepetition_count integer nullablepetition_documents_count integer nullablepetition_selection_count integer nullablepetition_result_count integer nullableis_passed boolean nullablewinners array (default: [])@type string (default: "VnepsWinner")code string nullablename string nullableprice number nullablelot_number string nullablelot_name string nullablelot_winning_prices array (default: [])notice object nullable@type string (default: "VnepsNotice")id string nullablenotify_number string nullablenotify_version string nullablenotify_type string nullablepackage_number string nullablepackage_name string nullableplan_number string nullableplan_name string nullableplan_type string nullableproject_name string nullableproject_code string nullableinvest_field string nullableprocedure string nullableselection_method string nullablebid_mode string nullablecontract_type string nullablecontract_period integer nullablecontract_period_unit string nullableprice number nullableestimate_price number nullablecurrency string nullablecapital_detail string nullablebid_validity_period integer nullablebid_validity_period_unit string nullableguarantee_value number nullableguarantee_form string nullableguarantee_form_en string nullablefee_type string nullablefee_value number nullableissue_location string nullablereceive_location string nullablereceive_location_en string nullablebid_open_location string nullablebid_open_location_en string nullableinvestor object nullable@type string (default: "VnepsParty")code string nullablename string nullableprocuring_entity object nullable@type string (default: "VnepsParty")code string nullablename string nullablestatus string nullablework_type string nullablesubordinate_unit string nullablemixed_fields string nullableis_domestic boolean nullableis_online boolean nullableis_prequalification boolean nullableis_medicine boolean nullablemedical_type integer nullablebase_medicine integer nullableis_rented boolean nullableis_sustainable boolean nullableis_framework_agreement boolean nullableis_early_selection boolean nullableis_eligible_29b boolean nullableis_priority_selection boolean nullableis_workday_count boolean nullableis_provisional_calculation boolean nullabledays_before_close integer nullabledelivery_capability integer nullableinvestor_type integer nullablemerged_at integer nullablemerged_investor_name string nullablemerged_province_name string nullablepublished_at integer nullableoriginal_published_at integer nullablebid_close_at integer nullablebid_open_at integer nullableplan_decision_date string nullablecreated_at integer nullableupdated_at integer nullablelots array (default: [])@type string (default: "VnepsLot")id string nullablelot_number string nullablename string nullableprice number nullableestimate_price number nullableguarantee_value number nullablecontract_period integer nullablecontract_period_unit string nullabledrug_name string nullablemedicine_code string nullableconcentration string nullableroute string nullabledosage_form string nullablemedicine_group string nullablequality_standards string nullableunit string nullablequantity number nullableplanned_unit_price number nullableadditional_quantity number nullableadditional_value number nullableadditional_percent number nullableversions array (default: [])@type string (default: "VnepsVersion")id string nullableversion string nullablenumber string nullablestatus string nullablepublished_by string nullablepublished_at integer nullabledelays array (default: [])@type string (default: "VnepsDelay")id string nullablebid_close_at integer nullablenew_bid_close_at integer nullablebid_open_at integer nullablenew_bid_open_at integer nullablereason string nullablecreated_at integer nullableoutcome_code string nullablepackage object nullable@type string (default: "VnepsPlanPackage")id string nullableplan_id string nullableplan_number string nullableplan_version string nullablepackage_number string nullablename string nullablebid_field string nullableprice number nullableprice_lines array (default: [])@type string (default: "VnepsPriceLine")amount number nullablecurrency string nullableexchange_rate number nullableestimate_price number nullablecurrency string nullablecapital_detail string nullablecapital_unit string nullablecontract_type string nullablecontract_period integer nullablecontract_period_unit string nullableselection_duration string nullablestart_year integer nullablestart_quarter string nullablestart_month integer nullablestart_unit string nullablegeneral_tasks string nullablesupervisor string nullableinvestor_name string nullablepurchasing_agency string nullablecounterpart_capital number nullableprice_ex number nullableadditional_choice integer nullableis_concentrated_purchase boolean nullableis_online_purchase boolean nullableis_prequalification boolean nullableis_multi_lot boolean nullableis_domestic boolean nullableis_online boolean nullableplan_decision_date string nullablelocations array (default: [])@type string (default: "VnepsLocation")province_code string nullableprovince_name string nullabledistrict_code string nullabledistrict_name string nullableward_code string nullableward_name string nullablebid_status object nullable@type string (default: "VnepsBidStatus")status string nullableprevious_status string nullablebid_close_at integer nullablebid_open_at integer nullableopened_at integer nullabletechnical_opened_at integer nullableis_published boolean nullabledocument_decision object nullable@type string (default: "VnepsDocumentDecision")decision_number string nullabledecision_number_en string nullabledecision_date string nullabledecision_agency string nullabledecision_agency_en string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullabledecision_file_en object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablebrief_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablebrief_file_en object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullabledocument_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullabledocument_file_en object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableother_files array (default: [])@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableother_files_en array (default: [])@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablecreated_at integer nullablecancellation object nullable@type string (default: "VnepsCancellation")cancel_type string nullablereason string nullabledecision_number string nullabledecision_date string nullabledecision_agency string nullablecancelled_at integer nullablecancelled_by string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablereport_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableappraisal_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablebid_status string nullablestatus string nullableshortlist object nullable@type string (default: "VnepsShortlist")id string nullableshortlist_number string nullableshortlist_version string nullablestatus string nullabledecision_number string nullabledecision_date string nullabledecision_agency string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablepublished_at integer nullablecontractors array (default: [])@type string (default: "VnepsShortlistedContractor")code string nullablename string nullabletax_code string nullabletax_country string nullableaddress string nullableversions array (default: [])@type string (default: "VnepsVersion")id string nullableversion string nullablenumber string nullablestatus string nullablepublished_by string nullablepublished_at integer nullablereoffer object nullable@type string (default: "VnepsReoffer")id string nullablereoffer_number string nullablereoffer_version string nullablereoffer_status string nullablestatus string nullableopen_at integer nullableclose_at integer nullablestart_price number nullableprice_step number nullablebid_validity_period integer nullablecontract_type string nullabledecision_number string nullabledecision_date string nullabledecision_agency string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablepass_decision_number string nullablepass_decision_date string nullablepass_decision_agency string nullablepass_decision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablepublished_at integer nullableoriginal_published_at integer nullablepassed array (default: [])@type string (default: "VnepsReofferPassed")id string nullablecontractor object nullable@type string (default: "VnepsParty")code string nullablename string nullablejoint_venture object nullable@type string (default: "VnepsParty")code string nullablename string nullablelot_number string nullablelot_name string nullableprice number nullablefinal_price number nullablestart_price number nullableprice_step number nullablerounds array (default: [])@type string (default: "VnepsReofferRound")id string nullablecontractor object nullable@type string (default: "VnepsParty")code string nullablename string nullablejoint_venture object nullable@type string (default: "VnepsParty")code string nullablename string nullablelot_number string nullablelot_name string nullableprice number nullablefinal_price number nullableround integer nullableis_latest boolean nullablesubmitted_at integer nullableplan object nullable@type string (default: "VnepsPlan")id string nullableplan_number string nullableplan_version string nullablename string nullableproject_name string nullableplan_type string nullabledescription string nullablestatus string nullableapproval_status string nullablepackage_count integer nullabletotal_investment number nullabletotal_investment_currency string nullableinvestor object nullable@type string (default: "VnepsParty")code string nullablename string nullabledecision_number string nullabledecision_date string nullabledecision_agency string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablepublished_at integer nullablepackage object nullable@type string (default: "VnepsPlanPackage")id string nullableplan_id string nullableplan_number string nullableplan_version string nullablepackage_number string nullablename string nullablebid_field string nullableprice number nullableprice_lines array (default: [])@type string (default: "VnepsPriceLine")amount number nullablecurrency string nullableexchange_rate number nullableestimate_price number nullablecurrency string nullablecapital_detail string nullablecapital_unit string nullablecontract_type string nullablecontract_period integer nullablecontract_period_unit string nullableselection_duration string nullablestart_year integer nullablestart_quarter string nullablestart_month integer nullablestart_unit string nullablegeneral_tasks string nullablesupervisor string nullableinvestor_name string nullablepurchasing_agency string nullablecounterpart_capital number nullableprice_ex number nullableadditional_choice integer nullableis_concentrated_purchase boolean nullableis_online_purchase boolean nullableis_prequalification boolean nullableis_multi_lot boolean nullableis_domestic boolean nullableis_online boolean nullableplan_decision_date string nullablelocations array (default: [])@type string (default: "VnepsLocation")province_code string nullableprovince_name string nullabledistrict_code string nullabledistrict_name string nullableward_code string nullableward_name string nullableversions array (default: [])@type string (default: "VnepsVersion")id string nullableversion string nullablenumber string nullablestatus string nullablepublished_by string nullablepublished_at integer nullablebid_submissions array (default: [])@type string (default: "VnepsBidSubmission")id string nullablecontractor object nullable@type string (default: "VnepsParty")code string nullablename string nullablejoint_venture object nullable@type string (default: "VnepsParty")code string nullablename string nullableprice number nullablefinal_price number nullablecurrency string nullablediscount_percent number nullableguarantee_value number nullabletotal_guarantee_value number nullableguarantee_validity_days integer nullablebid_validity_days integer nullablecontract_period integer nullablecontract_period_unit string nullablehas_alternative_offer boolean nullabletechnical_result integer nullabletechnical_score number nullableopened_at integer nullableaward object nullable@type string (default: "VnepsAward")id string nullableresult_version string nullablestatus string nullableresult_type integer nullableinput_method string nullabledecision_number string nullabledecision_number_en string nullabledecision_date string nullabledecision_agency string nullabledecision_agency_en string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullabledecision_file_en object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablereport_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablereport_file_en object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablebid_opening_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableevaluation_report_files array (default: [])@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableopened_at integer nullablepublished_at integer nullableoriginal_published_at integer nullablecreated_at integer nullableupdated_at integer nullableestimate_price number nullableestimate_price_currency string nullablelot_results array (default: [])@type string (default: "VnepsLotResult")id string nullablelot_number string nullablelot_name string nullableprice number nullableestimate_price number nullablecurrency string nullablecontract_period integer nullablecontract_period_unit string nullablestatus integer nullablewinning_code string nullableis_personal_contractor boolean nullablecontractors array (default: [])goods array (default: [])services array (default: [])related_services array (default: [])related_services_en string nullablegoods_en string nullablelot_openings array (default: [])@type string (default: "VnepsLotOpening")id string nullablecontractor object nullable@type string (default: "VnepsParty")code string nullablename string nullablejoint_venture object nullable@type string (default: "VnepsParty")code string nullablename string nullablelot_number string nullablelot_name string nullableprice number nullablefinal_price number nullableguarantee_value number nullableguarantee_validity_days integer nullableis_winner boolean nullablewinner_price number nullablenot_winner_reason string nullablelot_evaluations array (default: [])@type string (default: "VnepsLotEvaluation")id string nullablecontractor object nullable@type string (default: "VnepsParty")code string nullablename string nullablejoint_venture object nullable@type string (default: "VnepsParty")code string nullablename string nullablelot_number string nullablelot_name string nullableevaluation_type integer nullablecontent string nullableevaluation string nullableresult string nullablecontract_period string nullablecontract_period_unit string nullableestimate_prices array (default: [])winner_goods array (default: [])@type string (default: "VnepsGoodsItem")name string nullablecode string nullablebrand string nullablemanufacturer string nullableorigin string nullablemanufacture_year string nullablehs_code string nullableunit string nullablequantity number nullableunit_price number nullableamount number nullablespecification string nullabledelivery_place string nullabledelivery_period string nullablenote string nullablelot_number string nullablelot_name string nullablecontractor_code string nullableplan_lots array (default: [])@type string (default: "VnepsLot")id string nullablelot_number string nullablename string nullableprice number nullableestimate_price number nullableguarantee_value number nullablecontract_period integer nullablecontract_period_unit string nullabledrug_name string nullablemedicine_code string nullableconcentration string nullableroute string nullabledosage_form string nullablemedicine_group string nullablequality_standards string nullableunit string nullablequantity number nullableplanned_unit_price number nullableadditional_quantity number nullableadditional_value number nullableadditional_percent number nullablecancellation object nullable@type string (default: "VnepsCancellation")cancel_type string nullablereason string nullabledecision_number string nullabledecision_date string nullabledecision_agency string nullablecancelled_at integer nullablecancelled_by string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablereport_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableappraisal_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablebid_status string nullablestatus string nullablecancellation_history array (default: [])@type string (default: "VnepsCancellation")cancel_type string nullablereason string nullabledecision_number string nullabledecision_date string nullabledecision_agency string nullablecancelled_at integer nullablecancelled_by string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablereport_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableappraisal_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablebid_status string nullablestatus string nullableversions array (default: [])@type string (default: "VnepsVersion")id string nullableversion string nullablenumber string nullablestatus string nullablepublished_by string nullablepublished_at integer nullabledecision_versions array (default: [])@type string (default: "VnepsDecisionVersion")id string nullableresult_version string nullablestatus string nullabledecision_number string nullabledecision_number_en string nullabledecision_date string nullabledecision_agency string nullabledecision_agency_en string nullabledecision_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullabledecision_file_en object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullablereport_file object nullable@type string (default: "VnepsFile")id string nullablename string nullablekind string nullableevaluation_report_files array (default: [])reason string nullablecancellation object nullable@type string (default: "VnepsCancellation")cancel_type string nullablereason string nullabledecision_number string nullabledecision_date string nullabledecision_agency string nullablecancelled_at integer nullablecancelled_by string nullabledecision_file object nullable (see schema VnepsFile)report_file object nullable (see schema VnepsFile)appraisal_file object nullable (see schema VnepsFile)bid_status string nullablestatus string nullablepublished_at integer nullablecreated_at integer nullableupdated_at integer nullable422 — The value is not a notice number like IB2600554528 or DC2600017791, or a notice URL Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — No notice with that number Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.