Skip to content

Commit 83feb89

Browse files
myroslavmyroslav
committed
Added Tutorial section about Enquiries
1 parent 2a1257e commit 83feb89

6 files changed

Lines changed: 305 additions & 0 deletions

File tree

‎docs/source/tutorial.rst‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ Let's satisfy the Content-type requirement:
2727

2828
Error states that no `data` found in JSON body.
2929

30+
31+
.. index:: Tender
32+
3033
Creating tender
3134
---------------
3235

@@ -72,6 +75,7 @@ Let's check what tender registry contains:
7275

7376
And indeed we have 2 tenders now.
7477

78+
7579
Modifying tender
7680
----------------
7781

@@ -89,6 +93,9 @@ Checking the listing again reflects the new modification date:
8993
.. include:: tutorial/tender-listing-after-patch.http
9094
:code:
9195

96+
97+
.. index:: Document
98+
9299
Uploading documentation
93100
-----------------------
94101

@@ -126,9 +133,39 @@ And we can see that it is overriding the original version:
126133
:code:
127134

128135

136+
.. index:: Enquiries, Question, Answer
137+
138+
Enquiries
139+
---------
140+
141+
When tender is in `enquiry` status, interested parties can ask questions:
142+
143+
.. include:: tutorial/ask-question.http
144+
:code:
145+
146+
Bidder is answering them:
147+
148+
.. include:: tutorial/answer-question.http
149+
:code:
150+
151+
And one can retrieve the questions list:
152+
153+
.. include:: tutorial/list-question.http
154+
:code:
155+
156+
And individual answer:
157+
158+
.. include:: tutorial/get-answer.http
159+
:code:
160+
161+
162+
.. index:: Bidding
163+
129164
Registering bid
130165
---------------
131166

167+
When ``Tender.tenderingPeriod.startDate`` comes Tender switches to `tendering` status that allows registration of bids.
168+
132169
Bidder can register a bid:
133170

134171
.. include:: tutorial/register-bidder.http
@@ -144,6 +181,13 @@ It is possible to check documents uploaded:
144181
.. include:: tutorial/bidder-documents.http
145182
:code:
146183

184+
For best effect (biggest economy) Tender should have multiple bidders registered:
185+
186+
.. include:: tutorial/register-2nd-bidder.http
187+
:code:
188+
189+
190+
.. index:: Awarding, Qualification
147191

148192
Confirming qualification
149193
------------------------

‎docs/source/tutorial/answer-question.http‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
$ http -j PATCH http://api-sandbox.openprocurement.org/api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions/2356d267b21444368c0bd155f80b6b08 data:=@./answer.json
2+
PATCH /api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions/2356d267b21444368c0bd155f80b6b08 HTTP/1.1
3+
Content-Type: application/json; charset=utf-8
4+
5+
{
6+
"data": {
7+
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
8+
}
9+
}
10+
11+
HTTP/1.1 200 OK
12+
Content-Type: application/json; charset=UTF-8
13+
14+
{
15+
"data": {
16+
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
17+
"author": {
18+
"address": {
19+
"countryName": "Україна",
20+
"locality": "м. Вінниця",
21+
"postalCode": "21100",
22+
"region": "м. Вінниця",
23+
"streetAddress": "вул. Островського, 33"
24+
},
25+
"contactPoint": {
26+
"email": "soleksuk@gmail.com",
27+
"name": "Сергій Олексюк",
28+
"telephone": "+380 (432) 21-69-30"
29+
},
30+
"identifier": {
31+
"id": "13313462",
32+
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
33+
"scheme": "https://ns.openprocurement.org/ua/edrpou",
34+
"uri": "http://sch10.edu.vn.ua/"
35+
},
36+
"name": "ДКП «Школяр»"
37+
},
38+
"date": "2014-11-22T04:27:57.785461+02:00",
39+
"description": "Просимо додати таблицю потрібної калорійності харчування по місяцях",
40+
"id": "2356d267b21444368c0bd155f80b6b08",
41+
"title": "Калорійність по місяцях"
42+
}
43+
}

‎docs/source/tutorial/ask-question.http‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
$ http -j POST http://api-sandbox.openprocurement.org/api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions data:=@./question.json
2+
POST /api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions HTTP/1.1
3+
Content-Type: application/json; charset=utf-8
4+
5+
{
6+
"data": {
7+
"author": {
8+
"address": {
9+
"countryName": "Україна",
10+
"locality": "м. Вінниця",
11+
"postalCode": "21100",
12+
"region": "м. Вінниця",
13+
"streetAddress": "вул. Островського, 33"
14+
},
15+
"contactPoint": {
16+
"email": "soleksuk@gmail.com",
17+
"name": "Сергій Олексюк",
18+
"telephone": "+380 (432) 21-69-30"
19+
},
20+
"identifier": {
21+
"id": "13313462",
22+
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
23+
"scheme": "https://ns.openprocurement.org/ua/edrpou",
24+
"uri": "http://sch10.edu.vn.ua/"
25+
},
26+
"name": "ДКП «Школяр»"
27+
},
28+
"description": "Просимо додати таблицю потрібної калорійності харчування по місяцях",
29+
"title": "Калорійність по місяцях"
30+
}
31+
}
32+
33+
HTTP/1.1 201 Created
34+
Content-Type: application/json; charset=UTF-8
35+
Location: http://api-sandbox.openprocurement.org/api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/bids/2356d267b21444368c0bd155f80b6b08
36+
37+
{
38+
"data": {
39+
"author": {
40+
"address": {
41+
"countryName": "Україна",
42+
"locality": "м. Вінниця",
43+
"postalCode": "21100",
44+
"region": "м. Вінниця",
45+
"streetAddress": "вул. Островського, 33"
46+
},
47+
"contactPoint": {
48+
"email": "soleksuk@gmail.com",
49+
"name": "Сергій Олексюк",
50+
"telephone": "+380 (432) 21-69-30"
51+
},
52+
"identifier": {
53+
"id": "13313462",
54+
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
55+
"scheme": "https://ns.openprocurement.org/ua/edrpou",
56+
"uri": "http://sch10.edu.vn.ua/"
57+
},
58+
"name": "ДКП «Школяр»"
59+
},
60+
"date": "2014-11-22T04:27:57.785461+02:00",
61+
"description": "Просимо додати таблицю потрібної калорійності харчування по місяцях",
62+
"id": "2356d267b21444368c0bd155f80b6b08",
63+
"title": "Калорійність по місяцях"
64+
}
65+
}

‎docs/source/tutorial/get-answer.http‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
$ http -j http://api-sandbox.openprocurement.org/api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions/2356d267b21444368c0bd155f80b6b08
2+
GET /api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions/2356d267b21444368c0bd155f80b6b08 HTTP/1.1
3+
Content-Type: application/json; charset=utf-8
4+
5+
6+
7+
HTTP/1.1 200 OK
8+
Content-Type: application/json; charset=UTF-8
9+
10+
{
11+
"data": {
12+
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
13+
"author": {
14+
"address": {
15+
"countryName": "Україна",
16+
"locality": "м. Вінниця",
17+
"postalCode": "21100",
18+
"region": "м. Вінниця",
19+
"streetAddress": "вул. Островського, 33"
20+
},
21+
"contactPoint": {
22+
"email": "soleksuk@gmail.com",
23+
"name": "Сергій Олексюк",
24+
"telephone": "+380 (432) 21-69-30"
25+
},
26+
"identifier": {
27+
"id": "13313462",
28+
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
29+
"scheme": "https://ns.openprocurement.org/ua/edrpou",
30+
"uri": "http://sch10.edu.vn.ua/"
31+
},
32+
"name": "ДКП «Школяр»"
33+
},
34+
"date": "2014-11-22T04:27:57.785461+02:00",
35+
"description": "Просимо додати таблицю потрібної калорійності харчування по місяцях",
36+
"id": "2356d267b21444368c0bd155f80b6b08",
37+
"title": "Калорійність по місяцях"
38+
}
39+
}

‎docs/source/tutorial/list-question.http‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
$ http -j http://api-sandbox.openprocurement.org/api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions
2+
GET /api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/questions HTTP/1.1
3+
Content-Type: application/json; charset=utf-8
4+
5+
6+
7+
HTTP/1.1 200 OK
8+
Content-Type: application/json; charset=UTF-8
9+
10+
{
11+
"data": [
12+
{
13+
"answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
14+
"author": {
15+
"address": {
16+
"countryName": "Україна",
17+
"locality": "м. Вінниця",
18+
"postalCode": "21100",
19+
"region": "м. Вінниця",
20+
"streetAddress": "вул. Островського, 33"
21+
},
22+
"contactPoint": {
23+
"email": "soleksuk@gmail.com",
24+
"name": "Сергій Олексюк",
25+
"telephone": "+380 (432) 21-69-30"
26+
},
27+
"identifier": {
28+
"id": "13313462",
29+
"legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
30+
"scheme": "https://ns.openprocurement.org/ua/edrpou",
31+
"uri": "http://sch10.edu.vn.ua/"
32+
},
33+
"name": "ДКП «Школяр»"
34+
},
35+
"date": "2014-11-22T04:27:57.785461+02:00",
36+
"description": "Просимо додати таблицю потрібної калорійності харчування по місяцях",
37+
"id": "2356d267b21444368c0bd155f80b6b08",
38+
"title": "Калорійність по місяцях"
39+
}
40+
]
41+
}

‎docs/source/tutorial/register-2nd-bidder.http‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
$ http -j POST http://api-sandbox.openprocurement.org/api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/bids data:=@./catering2-bid.json
2+
POST /api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/bids HTTP/1.1
3+
Content-Type: application/json; charset=utf-8
4+
5+
{
6+
"data": {
7+
"tenderers": [
8+
{
9+
"address": {
10+
"countryName": "Україна",
11+
"locality": "м. Вінниця",
12+
"postalCode": "21018",
13+
"region": "м. Вінниця",
14+
"streetAddress": "вул. Юності, 30"
15+
},
16+
"contactPoint": {
17+
"email": "alla.myhailova@i.ua",
18+
"name": "Алла Михайлова",
19+
"telephone": "+380 (432) 460-665"
20+
},
21+
"identifier": {
22+
"id": "13306232",
23+
"legalName": "Державне комунальне підприємство громадського харчування «Меридіан»",
24+
"scheme": "https://ns.openprocurement.org/ua/edrpou",
25+
"uri": "http://sch10.edu.vn.ua/"
26+
},
27+
"name": "ДКП «Меридіан»"
28+
}
29+
],
30+
"value": {
31+
"amount": 480000
32+
}
33+
}
34+
}
35+
36+
HTTP/1.1 201 Created
37+
Content-Type: application/json; charset=UTF-8
38+
Location: http://api-sandbox.openprocurement.org/api/0/tenders/e1c4e54be2314868bab3ecfcf6241cba/bids/7e17d18c192846efbba1b61ee72d96a8
39+
40+
{
41+
"data": {
42+
"date": "2014-11-22T04:28:01.993786+02:00",
43+
"id": "7e17d18c192846efbba1b61ee72d96a8",
44+
"tenderers": [
45+
{
46+
"address": {
47+
"countryName": "Україна",
48+
"locality": "м. Вінниця",
49+
"postalCode": "21018",
50+
"region": "м. Вінниця",
51+
"streetAddress": "вул. Юності, 30"
52+
},
53+
"contactPoint": {
54+
"email": "alla.myhailova@i.ua",
55+
"name": "Алла Михайлова",
56+
"telephone": "+380 (432) 460-665"
57+
},
58+
"identifier": {
59+
"id": "13306232",
60+
"legalName": "Державне комунальне підприємство громадського харчування «Меридіан»",
61+
"scheme": "https://ns.openprocurement.org/ua/edrpou",
62+
"uri": "http://sch10.edu.vn.ua/"
63+
},
64+
"name": "ДКП «Меридіан»"
65+
}
66+
],
67+
"value": {
68+
"amount": 480000.0,
69+
"currency": "UAH",
70+
"valueAddedTaxIncluded": true
71+
}
72+
}
73+
}

0 commit comments

Comments
 (0)