Permalink
Switch branches/tags
2pc a105191787427142_transfer_token a143330483135015_added_cause a143330483135017_add_award_qualified_validation a143330483135017_add_award_qualified a143330483135019_subcontractingDetails a147460966605399_set_date_on_status a147507835786738_normal_days a147507835786741_complaint_document_upload_condition a157335104845450_next_check a158515627059482_stopping2invalid a158916227407145_Administrator_award_complaintPeriod a158916227407156_Complaint_active_role a158972595146231_parallel_testing a161856277361027_complaints_active_award_only a164800652922449_complains_mistaken a164805504288069_switchoff_award_qualified_validation a165337421066728_create_accreditations a168176911242184_bug_relatedLot a168785925999200_create_tender_and_awards a183705985788614_contract_item_unit_value a206699207014288_multilots_contracts_sign a207264421644588_award_related_lot_validation a209144554957524_fix_award_cancellation a211430089103757_award_complaints a211430089103758_lot_cancellation a211430089103760_deny_award_items_modification a224682041144054_complaint_leave_unsatisfied a246404800934002_special_items a253095563838185_remove_address_validation a258001251842882_refactoring_sandbox_23 a258001251842882_refactoring a276880397601913_set_lot_date_on_creation a282953159619251_tests_refactoring a312620117236937_block_cpv a312905574509110_docs_generator_fix a411044358876389_docs a433718495997911_satisfy_stopping_complaint a448207762065014_funders a563879808284502_disable_999999-9_additional_classification_required backup_master_19-03-2018 dev document_service documentation fix_lot_creation_validation master_bce master multi_lots negotiation-tendering-stand-still negotiation.quick no-dateSigned-validation production_bce production pylint_tests sandbox travis_cfg_update
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
310 lines (182 sloc) 8.81 KB

Tutorial

Tender creation

You can create three procedures:
  • reporting - reporting with no stand-still period
  • negotiation - negotiation procedure with 10 day stand-still before contract registration
  • negotiation.quick - quick negotiation procedure with 5 day stand-still before contract registration

Creating tender for reporting procedure

To create tender for reporting procedure you should set reporting value for procurementMethodType.

Let’s create a tender:

We have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.

Let's check what tender registry contains:

We do see the internal id of a tender (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.

Creating tender for negotiation procedure

To create tender for negotiation procedure you should set negotiation value for procurementMethodType.

Creating tender for negotiation.quick procedure

To create tender for negotiation.quick procedure you should set negotiation.quick value for procurementMethodType.

Modifying tender

Let's update tender by supplementing it with all other essential properties:

We see the added properies have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.

Checking the listing again reflects the new modification date:

.. index:: Document

Uploading documentation

Procuring entity can upload documents and files into the created tender. Uploading should follow the :ref:`upload` rules.

201 Created response code and Location header confirm document creation.

In case we made an error, we can reupload the document over the older version:

Awarding

Adding supplier information

Addition of supplier information is the same for all procedures.

Procuring entity registers supplier information for reporting procedure:

Procuring entity registers supplier information for negotiation procedure:

You can notice that there is complaintPeriod record with startDate value generated.

Procuring entity registers supplier information for negotiation.quick procedure:

Award for negotiation.quick procedure also has complaintPeriod record with startDate value.

Uploading award documentation

You can upload award documents only before awarding decision is confirmed. Let's add award document:

201 Created response code and Location header confirm that document has been added.

Let's see the list of award documents:

We can add another award document:

201 Created response code and Location header confirm second document has been added.

Let's see the list of all uploaded award documents:

Award confirmation

Procuring entity can confirm awarding decision:

Award confirmation for negotiation procedure:

The difference between startDate and endDate in complaintPeriod record for negotiation is 10 days.

Award confirmation for negotiation.quick procedure:

The difference between startDate and endDate in complaintPeriod record for negotiation.quick is 5 days.

Setting contract value

By default contract value is set based on the award, but there is a possibility to set custom contract value.

If you want to lower contract value, you can insert new one into the amount field.

200 OK response was returned. The value was modified successfully.

Setting value per item's unit

200 OK response was returned with successfully set item.unit.value structure.

Setting contract signature date

There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.

If this date is not set, it will be auto-generated on the date of contract registration.

Setting contract validity period

Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.

Uploading contract documentation

Contract documents can be uploaded only up until conclusion of the agreement. Let's add contract document:

201 Created response code and Location header confirm that document has been added.

Let's see the list of contract documents:

We can add another contract document:

201 Created response code and Location header confirm second document has been added.

Let's see the list of all uploaded contract documents:

Contract registration

Reporting tender contract can be registered immediately after award confirmation:

Negotiation tender contract can be registered only after the stand-still (10 day period after the award confirmation):

Negotiation.quick tender contract can be registered after the stand-still (5 day period after the award confirmation):

Cancelling tender

Procuring entity can cancel tender anytime. The following steps should be applied:

  1. Prepare cancellation request
  2. Fill it with the protocol describing the cancellation reasons
  3. Cancel the tender with the reasons prepared.

Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.

See :ref:`cancellation` data structure for details.

Preparing the cancellation request

You should pass reason, status defaults to pending.

id is autogenerated and passed in the Location header of response.

There are two possible types of cancellation reason - tender was cancelled or unsuccessful. By default reasonType value is cancelled.

You can change reasonType value to unsuccessful.

Filling cancellation with protocol and supplementary documentation

Upload the file contents

Change the document description and other properties

Upload new version of the document

Activating the request and cancelling tender