/enabavki/tenders

POST /api/enabavki/tenders

Price: 5 credits

North Macedonia public procurement tender dossier from e-nabavki.gov.mk by id: buyer with contacts, subject, CPV codes, lots, award criteria, qualification requirements, deadlines and opening, the tender documents and notifications, and the contracts awarded under it with their values.

How to use it

Takes the `id` of an enabavki/tenders/search row, current or archived. `awarded.contracts` lists the signed contracts with vendor and value; `call_for_tender_id` matches an enabavki/awards/search row.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• id string required — Tender id from enabavki/tenders/search (examples: "1a3be6b8-ee1e-4f58-ada7-66f9bbda4fa4"; pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$)

Response

• @type string (default: "EnabavkiTender")
• id string required
• call_for_tender_id string nullable
• process_number string nullable
• url string nullable
• notice_type string nullable
• subject string nullable
• description string nullable
• buyer object nullable
  • @type string (default: "EnabavkiBuyer")
  • name string nullable
  • address string nullable
  • city string nullable
  • postal_code string nullable
  • category string nullable
  • main_activity string nullable
  • email string nullable
  • phone string nullable
  • website string nullable
  • contact_person string nullable
  • contact_phone string nullable
  • contact_email string nullable
  • contact_fax string nullable
  • contact_page string nullable
  • authorized_person string nullable
  • authorized_person_email string nullable
  • authorized_person_phone string nullable
• contract_type string nullable
• procurement_item string nullable
• procurement_item_number integer nullable
• procedure_type string nullable
• procedure_type_id string nullable
• procedure_contract_type string nullable
• offer_type string nullable
• offer_type_id string nullable
• sector string nullable
• delivery_location string nullable
• estimated_value number nullable
• is_estimated_value_published boolean nullable
• cpvs array (default: [])
  • @type string (default: "EnabavkiCpv")
  • code string nullable
  • description string nullable
  • role string nullable
• has_referent_nomenclature boolean nullable
• buyer_categories array (default: [])
• is_divided boolean nullable
• lots array (default: [])
  • @type string (default: "EnabavkiTenderLot")
  • number integer nullable
  • subject string nullable
  • description string nullable
• lot_submission object nullable
  • @type string (default: "EnabavkiLotSubmission")
  • segments_submission integer nullable
  • segments_submission_label string nullable
  • max_lots_per_bid integer nullable
  • has_max_lots_awarded_per_operator boolean nullable
  • max_lots_awarded_per_operator integer nullable
• is_framework_agreement boolean nullable
• framework object nullable
  • @type string (default: "EnabavkiFrameworkTerms")
  • agreement_type string nullable
  • is_between_several_buyers boolean nullable
  • years integer nullable
  • months integer nullable
  • additional_information string nullable
• dynamic_purchase object nullable
  • @type string (default: "EnabavkiDynamicPurchase")
  • is_dynamic_purchase_system boolean nullable
  • duration_years integer nullable
  • duration_months integer nullable
• duration_years integer nullable
• duration_months integer nullable
• duration_days integer nullable
• starts_at integer nullable
• ends_at integer nullable
• allows_alternative_offers boolean nullable
• criteria array (default: [])
  • @type string (default: "EnabavkiCriterion")
  • name string nullable
  • points number nullable
  • points_distribution string nullable
  • is_price boolean nullable
• uses_electronic_tools boolean nullable
• has_electronic_auction boolean nullable
• auction_information string nullable
• electronic_tools_information string nullable
• uses_shortened_deadline boolean nullable
• min_candidates integer nullable
• max_candidates integer nullable
• agreement_count string nullable
• has_technical_dialog boolean nullable
• has_electronic_catalog boolean nullable
• is_consultant boolean nullable
• is_central_body_procurement boolean nullable
• is_group_procurement boolean nullable
• is_group_of_bodies boolean nullable
• is_small_procurement boolean nullable
• is_public_private_partnership boolean nullable
• is_archived boolean nullable
• law_version integer nullable
• qualification object nullable
  • @type string (default: "EnabavkiQualification")
  • requires_independent_offer_statement boolean nullable
  • requires_importance_statement boolean nullable
  • requires_bid_guarantee boolean nullable
  • bid_guarantee_percentage number nullable
  • requires_performance_guarantee boolean nullable
  • performance_guarantee_percentage number nullable
  • has_advance_payment boolean nullable
  • allows_consortium boolean nullable
  • is_reserved_contract boolean nullable
  • requires_site_visit boolean nullable
  • has_other_guarantees boolean nullable
  • other_guarantees string nullable
  • registered_activity string nullable
  • economic_financial_state string nullable
  • economic_financial_criteria string nullable
  • technical_professional_state string nullable
  • technical_professional_criteria string nullable
  • quality_standards string nullable
  • environmental_standards string nullable
  • qualification_system_conditions string nullable
  • qualification_system_methods string nullable
  • competition_part_of_qualification string nullable
  • required_documents array (default: [])
    • @type string (default: "EnabavkiRequiredDocument")
    • category string nullable
    • category_id string nullable
    • document_type string nullable
    • document_type_id string nullable
    • additional_info string nullable
• published_at integer nullable
• deadline_at integer nullable
• deadline_text string nullable
• questions_deadline_at integer nullable
• answers_deadline_at integer nullable
• opening_at integer nullable
• opening_place string nullable
• submission_days integer nullable
• delivered_at integer nullable
• additional_information string nullable
• has_documentation_fee boolean nullable
• documentation_fee number nullable
• documentation_fee_explanation string nullable
• official_gazette_number string nullable
• official_gazette_date string nullable
• annual_plan_id string nullable
• annual_plan_year integer nullable
• annual_plan_version integer nullable
• documents array (default: [])
  • @type string (default: "EnabavkiDocument")
  • name string nullable
  • url string nullable
  • category string nullable
  • document_type string nullable
  • file_id string nullable
  • contract_id string nullable
  • related_id string nullable
  • created_at integer nullable
  • is_generated boolean nullable
• awarded object nullable
  • @type string (default: "EnabavkiAwardedTotals")
  • estimated_value number nullable
  • changed_estimated_value number nullable
  • total_assigned_value number nullable
  • is_divided boolean nullable
  • contracts array (default: [])
    • @type string (default: "EnabavkiAwardedContract")
    • subject string nullable
    • vendor_name string nullable
    • buyer_name string nullable
    • procedure_type string nullable
    • procedure_type_id string nullable
    • procedure_type_label string nullable
    • notice_type string nullable
    • notice_type_label string nullable
    • lot_numbers string nullable
    • estimated_value number nullable
    • changed_estimated_value number nullable
    • assigned_value number nullable
    • realized_value number nullable
    • has_price_change boolean nullable
    • is_terminated boolean nullable
    • has_prior_notice boolean nullable
    • is_assigned_value_public boolean nullable
• quarterly_evidence object nullable
  • @type string (default: "EnabavkiAwardedTotals")
  • estimated_value number nullable
  • changed_estimated_value number nullable
  • total_assigned_value number nullable
  • is_divided boolean nullable
  • contracts array (default: [])
    • @type string (default: "EnabavkiAwardedContract")
    • subject string nullable
    • vendor_name string nullable
    • buyer_name string nullable
    • procedure_type string nullable
    • procedure_type_id string nullable
    • procedure_type_label string nullable
    • notice_type string nullable
    • notice_type_label string nullable
    • lot_numbers string nullable
    • estimated_value number nullable
    • changed_estimated_value number nullable
    • assigned_value number nullable
    • realized_value number nullable
    • has_price_change boolean nullable
    • is_terminated boolean nullable
    • has_prior_notice boolean nullable
    • is_assigned_value_public boolean nullable

Errors

• 422 — The id is not a GUID 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 tender notice with that id 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.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-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.