Appeal

Note

This section contains available actions for next roles:
no Monitoring owner
yes Tender owner

We have already seen how to get acc_token in Credentials section

After publication conclusion by SAS (monitoring in status addressed or declined ), the tender owner may point out that the conclusion has been appealed in court. In this case the object of legislation is automatically filled by CDB:

PUT /api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal?acc_token=7df700c867f34f4babc8f5cacfad1d5a HTTP/1.0
Authorization: Basic YnJva2VyOmJyb2tlcg==
Content-Length: 381
Content-Type: application/json
Host: audit-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "Appeal description",
    "documents": [
      {
        "title": "letter.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/37df4b6da2c24b6a97a6c35bb69fcccf?Signature=p00JBLkUFLMh9NVj1Gb07X4O6hsoqfRY89d4oG0gmHTm77S5zAV0pAZ%2BeMG%2BPe78bccrBkp%2FCymfzh31eHVyCQ%3D%3D&KeyID=a8968c46",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword"
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json
Set-Cookie: SESSION=eyJvcGVyYXRpb25fdGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODgsICJpIjogMTR9fSwgImNsdXN0ZXJfdGltZSI6IHsiY2x1c3RlclRpbWUiOiB7IiR0aW1lc3RhbXAiOiB7InQiOiAxNzYyMjUzOTg4LCAiaSI6IDE0fX0sICJzaWduYXR1cmUiOiB7Imhhc2giOiB7IiRiaW5hcnkiOiB7ImJhc2U2NCI6ICIxdXpha3ZIaTN4dk00UFBDT0JZd1ZXSmg5MTg9IiwgInN1YlR5cGUiOiAiMDAifX0sICJrZXlJZCI6IDc1NjY2Mjk2Njg0Njg1NTU3ODN9fX0=; Path=/
X-Content-Type-Options: nosniff
{
  "data": {
    "description": "Appeal description",
    "documents": [
      {
        "id": "d4c3b9a0b9734f4f8432a424d16df4d0",
        "hash": "md5:00000000000000000000000000000000",
        "title": "letter.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/37df4b6da2c24b6a97a6c35bb69fcccf?Signature=X%2Ff0ajCeap0OHcwyz1XO0dLSTED0fK3VUByfMLazlN6qfuMigrYsbcVTMH645ldiGRT%2FFULQP5SUs6m%252BP%2FT1Dg%253D%253D&KeyID=a8968c46",
        "datePublished": "2018-01-06T09:00:00+02:00",
        "dateModified": "2018-01-06T09:00:00+02:00",
        "author": "tender_owner"
      }
    ],
    "dateCreated": "2018-01-06T09:00:00+02:00",
    "datePublished": "2018-01-06T09:00:00+02:00",
    "legislation": {
      "version": "2020-04-19",
      "type": "NATIONAL_LEGISLATION",
      "article": [
        "8.10"
      ],
      "identifier": {
        "id": "922-VIII",
        "legalName": "Закон України \"Про публічні закупівлі\"",
        "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
      }
    }
  }
}

This action can be performed only once:

PUT /api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal?acc_token=7df700c867f34f4babc8f5cacfad1d5a HTTP/1.0
Authorization: Basic YnJva2VyOmJyb2tlcg==
Content-Length: 403
Content-Type: application/json
Host: audit-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "Addition to the appeal description",
    "documents": [
      {
        "title": "another-letter.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/59ec68b1b09a425a8fca371a3b12b4cf?Signature=3bdJ0S3cDcYJVl1Yu5HDEXfJAVs5wdIjpCkKUEVyZUmUgOov1EUQK23Q%2BT0PteDUjIEkkGeX%2FRUEeh0GOqIBBg%3D%3D&KeyID=a8968c46",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword"
      }
    ]
  }
}

Response: 403 Forbidden
Content-Type: application/json
Set-Cookie: SESSION=eyJvcGVyYXRpb25fdGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODgsICJpIjogMTR9fSwgImNsdXN0ZXJfdGltZSI6IHsiY2x1c3RlclRpbWUiOiB7IiR0aW1lc3RhbXAiOiB7InQiOiAxNzYyMjUzOTg4LCAiaSI6IDE0fX0sICJzaWduYXR1cmUiOiB7Imhhc2giOiB7IiRiaW5hcnkiOiB7ImJhc2U2NCI6ICIxdXpha3ZIaTN4dk00UFBDT0JZd1ZXSmg5MTg9IiwgInN1YlR5cGUiOiAiMDAifX0sICJrZXlJZCI6IDc1NjY2Mjk2Njg0Njg1NTU3ODN9fX0=; Path=/
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can't post another appeal."
    }
  ]
}

After adding the appeal (monitoring in status: addressed/complete/declined/closed/stopped), to appeal can be added proceeding:

PATCH /api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal?acc_token=7df700c867f34f4babc8f5cacfad1d5a HTTP/1.0
Authorization: Basic YnJva2VyOmJyb2tlcg==
Content-Length: 108
Content-Type: application/json
Host: audit-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "proceeding": {
      "dateProceedings": "2019-04-01T00:00:00+02:00",
      "proceedingNumber": "0123456789"
    }
  }
}

Response: 200 OK
Content-Type: application/json
Set-Cookie: SESSION=eyJvcGVyYXRpb25fdGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODgsICJpIjogMTZ9fSwgImNsdXN0ZXJfdGltZSI6IHsiY2x1c3RlclRpbWUiOiB7IiR0aW1lc3RhbXAiOiB7InQiOiAxNzYyMjUzOTg4LCAiaSI6IDE2fX0sICJzaWduYXR1cmUiOiB7Imhhc2giOiB7IiRiaW5hcnkiOiB7ImJhc2U2NCI6ICIxdXpha3ZIaTN4dk00UFBDT0JZd1ZXSmg5MTg9IiwgInN1YlR5cGUiOiAiMDAifX0sICJrZXlJZCI6IDc1NjY2Mjk2Njg0Njg1NTU3ODN9fX0=; Path=/
X-Content-Type-Options: nosniff
{
  "data": {
    "description": "Appeal description",
    "documents": [
      {
        "id": "d4c3b9a0b9734f4f8432a424d16df4d0",
        "hash": "md5:00000000000000000000000000000000",
        "title": "letter.doc",
        "format": "application/msword",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/37df4b6da2c24b6a97a6c35bb69fcccf?Signature=X%2Ff0ajCeap0OHcwyz1XO0dLSTED0fK3VUByfMLazlN6qfuMigrYsbcVTMH645ldiGRT%2FFULQP5SUs6m%252BP%2FT1Dg%253D%253D&KeyID=a8968c46",
        "datePublished": "2018-01-06T09:00:00+02:00",
        "dateModified": "2018-01-06T09:00:00+02:00",
        "author": "tender_owner"
      }
    ],
    "dateCreated": "2018-01-06T09:00:00+02:00",
    "datePublished": "2018-01-06T09:00:00+02:00",
    "proceeding": {
      "dateProceedings": "2019-04-01T00:00:00+02:00",
      "proceedingNumber": "0123456789"
    },
    "legislation": {
      "version": "2020-04-19",
      "type": "NATIONAL_LEGISLATION",
      "article": [
        "8.10"
      ],
      "identifier": {
        "id": "922-VIII",
        "legalName": "Закон України \"Про публічні закупівлі\"",
        "uri": "https://zakon.rada.gov.ua/laws/show/922-19"
      }
    }
  }
}

This action also can be performed only once:

PATCH /api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal?acc_token=7df700c867f34f4babc8f5cacfad1d5a HTTP/1.0
Authorization: Basic YnJva2VyOmJyb2tlcg==
Content-Length: 108
Content-Type: application/json
Host: audit-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "proceeding": {
      "dateProceedings": "2019-04-01T00:00:00+02:00",
      "proceedingNumber": "0123456789"
    }
  }
}

Response: 403 Forbidden
Content-Type: application/json
Set-Cookie: SESSION=eyJvcGVyYXRpb25fdGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODgsICJpIjogMTZ9fSwgImNsdXN0ZXJfdGltZSI6IHsiY2x1c3RlclRpbWUiOiB7IiR0aW1lc3RhbXAiOiB7InQiOiAxNzYyMjUzOTg4LCAiaSI6IDE2fX0sICJzaWduYXR1cmUiOiB7Imhhc2giOiB7IiRiaW5hcnkiOiB7ImJhc2U2NCI6ICIxdXpha3ZIaTN4dk00UFBDT0JZd1ZXSmg5MTg9IiwgInN1YlR5cGUiOiAiMDAifX0sICJrZXlJZCI6IDc1NjY2Mjk2Njg0Njg1NTU3ODN9fX0=; Path=/
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can't post another proceeding."
    }
  ]
}

Documents can be added/changed/replaced any time:

POST /api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal/documents?acc_token=7df700c867f34f4babc8f5cacfad1d5a HTTP/1.0
Authorization: Basic YnJva2VyOmJyb2tlcg==
Content-Length: 333
Content-Type: application/json
Host: audit-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "another-letter.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/59ec68b1b09a425a8fca371a3b12b4cf?Signature=3bdJ0S3cDcYJVl1Yu5HDEXfJAVs5wdIjpCkKUEVyZUmUgOov1EUQK23Q%2BT0PteDUjIEkkGeX%2FRUEeh0GOqIBBg%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://audit-api-sandbox.prozorro.gov.ua/api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal/documents/49eedcd76f814e7b85a2c7302931ed26
Set-Cookie: SESSION=eyJvcGVyYXRpb25fdGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODksICJpIjogMn19LCAiY2x1c3Rlcl90aW1lIjogeyJjbHVzdGVyVGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODksICJpIjogMn19LCAic2lnbmF0dXJlIjogeyJoYXNoIjogeyIkYmluYXJ5IjogeyJiYXNlNjQiOiAiVTVHaDJDcUVVek5VVkEyTEQrNFBrcHhnM1pRPSIsICJzdWJUeXBlIjogIjAwIn19LCAia2V5SWQiOiA3NTY2NjI5NjY4NDY4NTU1NzgzfX19; Path=/
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "49eedcd76f814e7b85a2c7302931ed26",
    "hash": "md5:00000000000000000000000000000000",
    "title": "another-letter.doc",
    "format": "application/msword",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/59ec68b1b09a425a8fca371a3b12b4cf?Signature=sRNJw%2FbCYENI%2F9xBkCK67MwDV2sFmjLJYR%2FrD04uxg81W8gJDneA%252B%2FxUhcqQOBfErBhS7JFK1VpTVlRgV6tUAQ%253D%253D&KeyID=a8968c46",
    "datePublished": "2018-01-06T10:00:00+02:00",
    "dateModified": "2018-01-06T10:00:00+02:00",
    "author": "tender_owner"
  }
}

PATCH /api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal/documents/d4c3b9a0b9734f4f8432a424d16df4d0?acc_token=7df700c867f34f4babc8f5cacfad1d5a HTTP/1.0
Authorization: Basic YnJva2VyOmJyb2tlcg==
Content-Length: 328
Content-Type: application/json
Host: audit-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "letter(0).doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1842e75552a144b08452dd7d823c5c0c?Signature=NXlgITOzT4%2FzZe2Kmyw%2B1w78bwzsziyV5VKmD3MRhj81VWEpEw0wGROZEBaVP93St8e1%2FhXoipsO1sats2JpAA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/json"
  }
}

Response: 200 OK
Content-Type: application/json
Set-Cookie: SESSION=eyJvcGVyYXRpb25fdGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODksICJpIjogNH19LCAiY2x1c3Rlcl90aW1lIjogeyJjbHVzdGVyVGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODksICJpIjogNH19LCAic2lnbmF0dXJlIjogeyJoYXNoIjogeyIkYmluYXJ5IjogeyJiYXNlNjQiOiAiVTVHaDJDcUVVek5VVkEyTEQrNFBrcHhnM1pRPSIsICJzdWJUeXBlIjogIjAwIn19LCAia2V5SWQiOiA3NTY2NjI5NjY4NDY4NTU1NzgzfX19; Path=/
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "d4c3b9a0b9734f4f8432a424d16df4d0",
    "hash": "md5:00000000000000000000000000000000",
    "title": "letter(0).doc",
    "format": "application/json",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/37df4b6da2c24b6a97a6c35bb69fcccf?Signature=X%2Ff0ajCeap0OHcwyz1XO0dLSTED0fK3VUByfMLazlN6qfuMigrYsbcVTMH645ldiGRT%2FFULQP5SUs6m%252BP%2FT1Dg%253D%253D&KeyID=a8968c46",
    "datePublished": "2018-01-06T09:00:00+02:00",
    "dateModified": "2018-01-06T10:15:00+02:00",
    "author": "tender_owner"
  }
}

PUT /api/2.5/monitorings/05c8521747ee4ed096200197b78b5990/appeal/documents/d4c3b9a0b9734f4f8432a424d16df4d0?acc_token=7df700c867f34f4babc8f5cacfad1d5a HTTP/1.0
Authorization: Basic YnJva2VyOmJyb2tlcg==
Content-Length: 331
Content-Type: application/json
Host: audit-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "letter_put.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8156e7122c6e497cb271478f924cc846?Signature=WDKZ%2BOn40wFfeTsbfAT%2FjE7E1SAR5XQKJNK%2FjciHJyhCRFTHDKHuhf4FPL6pIKvEIcujg%2BgKIHtOacjuDIKrCA%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/json"
  }
}

Response: 200 OK
Content-Type: application/json
Set-Cookie: SESSION=eyJvcGVyYXRpb25fdGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODksICJpIjogNn19LCAiY2x1c3Rlcl90aW1lIjogeyJjbHVzdGVyVGltZSI6IHsiJHRpbWVzdGFtcCI6IHsidCI6IDE3NjIyNTM5ODksICJpIjogNn19LCAic2lnbmF0dXJlIjogeyJoYXNoIjogeyIkYmluYXJ5IjogeyJiYXNlNjQiOiAiVTVHaDJDcUVVek5VVkEyTEQrNFBrcHhnM1pRPSIsICJzdWJUeXBlIjogIjAwIn19LCAia2V5SWQiOiA3NTY2NjI5NjY4NDY4NTU1NzgzfX19; Path=/
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "d4c3b9a0b9734f4f8432a424d16df4d0",
    "hash": "md5:00000000000000000000000000000000",
    "title": "letter_put.doc",
    "format": "application/json",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8156e7122c6e497cb271478f924cc846?Signature=gxWcVkXilNhJisonuLONqVW4S%252BEQiFNyNTuPtwTQQbmRdEinhKXYHO7BAZlzGCKtTS3aZvIimRSq%252B2AO3tpxCQ%253D%253D&KeyID=a8968c46",
    "datePublished": "2018-01-06T10:15:00+02:00",
    "dateModified": "2018-01-06T10:15:00+02:00",
    "author": "tender_owner"
  }
}