/goszakup/contracts

POST /api/goszakup/contracts

Price: 20 credits

Kazakhstan public procurement contract from zakup.gov.kz by id: customer and supplier, the tender it came from, prices with and without VAT, amounts paid, dates of signature and execution, the item list with plan items, acts of acceptance and the contract files.

How to use it

Takes the `id` of a goszakup/contracts/search row. An amendment points at the contract it changes in `parent_contract` and at the original in `root_contract`; `acts` are the signed acceptance acts with their amounts.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• id integer required — Contract id from goszakup/contracts/search (examples: 111838512; min: 0)

Response

• @type string (default: "GoszakupContract")
• id integer required
• external_id integer nullable
• number string nullable
• system_number string nullable
• system object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• status object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• contract_type object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• contract_form object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• year_type object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• purchase_method object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• actual_purchase_method object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• purchase_subject object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• budget_type object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• funding_source object nullable
  • @type string (default: "GoszakupRef")
  • id integer nullable
  • name string nullable
  • name_kk string nullable
• currency string nullable
• currency_rate number nullable
• year integer nullable
• description string nullable
• description_kk string nullable
• customer object nullable
  • @type string (default: "GoszakupOrgRef")
  • id integer nullable
  • external_id integer nullable
  • iin_bin string nullable
  • name string nullable
  • name_kk string nullable
  • full_name string nullable
  • full_name_kk string nullable
  • is_resident boolean nullable
  • organization_type object nullable
    • @type string (default: "GoszakupRef")
    • id integer nullable
    • name string nullable
    • name_kk string nullable
  • email string nullable
  • phone string nullable
• supplier object nullable
  • @type string (default: "GoszakupOrgRef")
  • id integer nullable
  • external_id integer nullable
  • iin_bin string nullable
  • name string nullable
  • name_kk string nullable
  • full_name string nullable
  • full_name_kk string nullable
  • is_resident boolean nullable
  • organization_type object nullable
    • @type string (default: "GoszakupRef")
    • id integer nullable
    • name string nullable
    • name_kk string nullable
  • email string nullable
  • phone string nullable
• tender object nullable
  • @type string (default: "GoszakupContractTender")
  • id integer nullable
  • external_id integer nullable
  • number string nullable
  • name string nullable
  • url string nullable
  • total_price number nullable
  • published_at integer nullable
  • offer_start_at integer nullable
  • offer_end_at integer nullable
  • repeated_offer_start_at integer nullable
  • repeated_offer_end_at integer nullable
  • discussion_start_at integer nullable
  • discussion_end_at integer nullable
  • results_published_at integer nullable
  • is_among_disabled boolean nullable
  • is_light_industry boolean nullable
  • updated_at integer nullable
• parent_contract object nullable
  • @type string (default: "GoszakupContractRef")
  • id integer nullable
  • number string nullable
  • system_number string nullable
• root_contract object nullable
  • @type string (default: "GoszakupContractRef")
  • id integer nullable
  • number string nullable
  • system_number string nullable
• price_with_vat number nullable
• price_without_vat number nullable
• paid_with_vat number nullable
• paid_without_vat number nullable
• plan_sum_with_vat number nullable
• plan_sum_without_vat number nullable
• purchase_total_with_vat number nullable
• purchase_total_without_vat number nullable
• local_content_share number nullable
• purchase_document_name string nullable
• purchase_document_number string nullable
• purchase_document_date string nullable
• signing_reason_document_name string nullable
• signing_reason_document_name_kk string nullable
• signing_reason_document_number string nullable
• signing_reason_document_at integer nullable
• signed_at integer nullable
• start_at integer nullable
• end_at integer nullable
• contract_end_at integer nullable
• validity_at integer nullable
• planned_execution_at integer nullable
• actual_execution_at integer nullable
• procurement_executed_at integer nullable
• is_approved_by_customer boolean nullable
• is_approved_by_supplier boolean nullable
• is_enforced boolean nullable
• is_state_institution boolean nullable
• is_supplier_vat_payer boolean nullable
• file object nullable
  • @type string (default: "GoszakupFile")
  • id string nullable
  • name string nullable
  • url string nullable
  • uuid string nullable
  • uploaded_by string nullable
  • uploaded_at integer nullable
  • organization_id integer nullable
• print_file object nullable
  • @type string (default: "GoszakupFile")
  • id string nullable
  • name string nullable
  • url string nullable
  • uuid string nullable
  • uploaded_by string nullable
  • uploaded_at integer nullable
  • organization_id integer nullable
• line_items array (default: [])
  • @type string (default: "GoszakupContractItem")
  • id integer nullable
  • external_id integer nullable
  • quantity number nullable
  • item_price_with_vat number nullable
  • item_price_without_vat number nullable
  • price_with_vat number nullable
  • price_without_vat number nullable
  • purchase_total_with_vat number nullable
  • purchase_total_without_vat number nullable
  • paid_with_vat number nullable
  • paid_without_vat number nullable
  • prepayment_paid number nullable
  • vat_sum number nullable
  • local_content_share number nullable
  • local_content_sum number nullable
  • supplier_type string nullable
  • planned_execution_at integer nullable
  • actual_execution_at integer nullable
  • lot object nullable
    • @type string (default: "GoszakupLotRef")
    • id integer nullable
    • external_id integer nullable
    • number string nullable
    • name string nullable
    • total_price number nullable
  • plan_item object nullable
    • @type string (default: "GoszakupPlanItem")
    • id integer required
    • external_id integer nullable
    • name string nullable
    • name_kk string nullable
    • description string nullable
    • description_kk string nullable
    • extra_description string nullable
    • extra_description_kk string nullable
    • system object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • status object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • purchase_method object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • purchase_method_justification object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • purchase_subject object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • item_type object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • budget_type object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • budget_administrator object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • funding_source object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • enstru object nullable
      • @type string (default: "GoszakupEnstru")
      • id integer nullable
      • code string nullable
      • name string nullable
      • name_kk string nullable
      • short_description string nullable
      • short_description_kk string nullable
      • item_type object nullable (see schema GoszakupCode)
      • is_for_disabled_people boolean nullable
      • is_construction_work boolean nullable
      • is_score_based_tender boolean nullable
    • year integer nullable
    • month string nullable
    • plan_id integer nullable
    • plan_act_number string nullable
    • plan_act_date string nullable
    • organization object nullable
      • @type string (default: "GoszakupOrgRef")
      • id integer nullable
      • external_id integer nullable
      • iin_bin string nullable
      • name string nullable
      • name_kk string nullable
      • full_name string nullable
      • full_name_kk string nullable
      • is_resident boolean nullable
      • organization_type object nullable (see schema GoszakupRef)
      • email string nullable
      • phone string nullable
    • state_institution object nullable
      • @type string (default: "GoszakupRef")
      • id integer nullable
      • name string nullable
      • name_kk string nullable
    • quantity number nullable
    • unit string nullable
    • unit_price number nullable
    • total_price number nullable
    • total_price_year_1 number nullable
    • total_price_year_2 number nullable
    • total_price_year_3 number nullable
    • total_price_year_4 number nullable
    • total_price_year_5 number nullable
    • prepayment_percent number nullable
    • delivery_deadline string nullable
    • delivery_deadline_kk string nullable
    • delivery_address object nullable
      • @type string (default: "GoszakupKato")
      • id integer nullable
      • code string nullable
      • name string nullable
      • full_name string nullable
      • full_name_kk string nullable
      • level integer nullable
    • deliveries array (default: [])
    • financing array (default: [])
    • attributes array (default: [])
    • is_quasi_sector boolean nullable
    • is_externally_active boolean nullable
    • is_externally_deleted boolean nullable
    • purchase_limitation_sign integer nullable
    • updated_at integer nullable
  • updated_at integer nullable
• acts array (default: [])
  • @type string (default: "GoszakupAct")
  • id integer nullable
  • external_id integer nullable
  • number string nullable
  • status object nullable
    • @type string (default: "GoszakupRef")
    • id integer nullable
    • name string nullable
    • name_kk string nullable
  • act_at integer nullable
  • sent_at integer nullable
  • approved_at integer nullable
  • revoked_at integer nullable
  • sum number nullable
  • sum_without_prepayment number nullable
  • signers array (default: [])
    • @type string (default: "GoszakupActSigner")
    • role string nullable
    • signed_at integer nullable
  • lines array (default: [])
    • @type string (default: "GoszakupActLine")
    • id integer nullable
    • external_id integer nullable
    • number string nullable
    • quantity number nullable
    • sum number nullable
    • sum_without_prepayment number nullable
  • updated_at integer nullable
• updated_at integer nullable

Errors

• 422 — The request body did not validate 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 contract 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.