Claim Submission

If tender conditions are favoriting particular supplier, or in any other viable case, any registered user can submit Tender Conditions Claim.

Tender Conditions Claim Submission (with documents)

At first create a claim:

POST /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 880
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "title": "complaint title",
    "description": "complaint description",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083

{
  "access": {
    "token": "4b412ae081b74a928ad1c01526619375"
  },
  "data": {
    "status": "draft",
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "complaintID": "UA-2016-03-18-000001.1",
    "date": "2016-03-18T18:47:48.772297+02:00",
    "type": "claim",
    "id": "d3bdc18a7e884e33b73c91a46cc34083"
  }
}

Then upload necessary documents:

POST /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents?acc_token=4b412ae081b74a928ad1c01526619375 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 201
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy895748315721$
Host: api-sandbox.openprocurement.org


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents/750eab0acd3640768d48325e7abd09b2

{
  "data": {
    "author": "complaint_owner",
    "title": "Complaint_Attachement.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents/750eab0acd3640768d48325e7abd09b2?download=c508efc6b5954a9e8da98eee7d84e770",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2016-03-18T18:47:49.046139+02:00",
    "id": "750eab0acd3640768d48325e7abd09b2",
    "dateModified": "2016-03-18T18:47:49.046176+02:00"
  }
}

Submit tender conditions claim:

PATCH /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083?acc_token=4b412ae081b74a928ad1c01526619375 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 29
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "claim"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "claim",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents/750eab0acd3640768d48325e7abd09b2?download=c508efc6b5954a9e8da98eee7d84e770",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2016-03-18T18:47:49.046139+02:00",
        "id": "750eab0acd3640768d48325e7abd09b2",
        "dateModified": "2016-03-18T18:47:49.046176+02:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "dateSubmitted": "2016-03-18T18:47:49.163783+02:00",
    "complaintID": "UA-2016-03-18-000001.1",
    "date": "2016-03-18T18:47:48.772297+02:00",
    "type": "claim",
    "id": "d3bdc18a7e884e33b73c91a46cc34083"
  }
}

Tender Conditions Claim Submission (without documents)

Create claim that does not need additional documents:

POST /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 899
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "claim",
    "title": "complaint title",
    "description": "complaint description",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    }
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/f48a5ed39ffd4c91b03d59ebbb1dcc29

{
  "access": {
    "token": "b53ffa7505e54ea4a4bb6d45b5128dc7"
  },
  "data": {
    "status": "claim",
    "description": "complaint description",
    "title": "complaint title",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSubmitted": "2016-03-18T18:47:49.275773+02:00",
    "complaintID": "UA-2016-03-18-000001.2",
    "date": "2016-03-18T18:47:49.274436+02:00",
    "type": "claim",
    "id": "f48a5ed39ffd4c91b03d59ebbb1dcc29"
  }
}

Tender Conditions Claim/Complaint Retrieval

You can list all Tender Conditions Claims/Complaints:

GET /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints HTTP/1.0
Host: api-sandbox.openprocurement.org


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": [
    {
      "status": "claim",
      "documents": [
        {
          "author": "complaint_owner",
          "title": "Complaint_Attachement.pdf",
          "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents/750eab0acd3640768d48325e7abd09b2?download=c508efc6b5954a9e8da98eee7d84e770",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2016-03-18T18:47:49.046139+02:00",
          "id": "750eab0acd3640768d48325e7abd09b2",
          "dateModified": "2016-03-18T18:47:49.046176+02:00"
        }
      ],
      "description": "complaint description",
      "title": "complaint title",
      "dateSubmitted": "2016-03-18T18:47:49.163783+02:00",
      "complaintID": "UA-2016-03-18-000001.1",
      "date": "2016-03-18T18:47:48.772297+02:00",
      "type": "claim",
      "id": "d3bdc18a7e884e33b73c91a46cc34083"
    },
    {
      "status": "claim",
      "description": "complaint description",
      "title": "complaint title",
      "dateSubmitted": "2016-03-18T18:47:49.275773+02:00",
      "complaintID": "UA-2016-03-18-000001.2",
      "date": "2016-03-18T18:47:49.274436+02:00",
      "type": "claim",
      "id": "f48a5ed39ffd4c91b03d59ebbb1dcc29"
    }
  ]
}

And check individual complaint or claim:

GET /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083 HTTP/1.0
Host: api-sandbox.openprocurement.org


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "claim",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents/750eab0acd3640768d48325e7abd09b2?download=c508efc6b5954a9e8da98eee7d84e770",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2016-03-18T18:47:49.046139+02:00",
        "id": "750eab0acd3640768d48325e7abd09b2",
        "dateModified": "2016-03-18T18:47:49.046176+02:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "dateSubmitted": "2016-03-18T18:47:49.163783+02:00",
    "complaintID": "UA-2016-03-18-000001.1",
    "date": "2016-03-18T18:47:48.772297+02:00",
    "type": "claim",
    "id": "d3bdc18a7e884e33b73c91a46cc34083"
  }
}

Claim’s Answer

Answer to resolved claim

PATCH /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083?acc_token=156967f2c18c4783ae1d34e4a20929a1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 442
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "answered",
    "resolutionType": "resolved",
    "tendererAction": "Виправлено неконкурентні умови",
    "resolution": "Виправлено неконкурентні умови"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "answered",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents/750eab0acd3640768d48325e7abd09b2?download=c508efc6b5954a9e8da98eee7d84e770",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2016-03-18T18:47:49.046139+02:00",
        "id": "750eab0acd3640768d48325e7abd09b2",
        "dateModified": "2016-03-18T18:47:49.046176+02:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "resolutionType": "resolved",
    "type": "claim",
    "tendererAction": "Виправлено неконкурентні умови",
    "dateAnswered": "2016-03-18T18:47:49.459859+02:00",
    "tendererActionDate": "2016-03-18T18:47:49.459888+02:00",
    "dateSubmitted": "2016-03-18T18:47:49.163783+02:00",
    "complaintID": "UA-2016-03-18-000001.1",
    "date": "2016-03-18T18:47:48.772297+02:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "d3bdc18a7e884e33b73c91a46cc34083"
  }
}

Satisfied Claim

Satisfying resolution

PATCH /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083?acc_token=4b412ae081b74a928ad1c01526619375 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 51
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "resolved",
    "satisfied": true
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "resolved",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/d3bdc18a7e884e33b73c91a46cc34083/documents/750eab0acd3640768d48325e7abd09b2?download=c508efc6b5954a9e8da98eee7d84e770",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2016-03-18T18:47:49.046139+02:00",
        "id": "750eab0acd3640768d48325e7abd09b2",
        "dateModified": "2016-03-18T18:47:49.046176+02:00"
      }
    ],
    "description": "complaint description",
    "title": "complaint title",
    "resolutionType": "resolved",
    "type": "claim",
    "satisfied": true,
    "tendererAction": "Виправлено неконкурентні умови",
    "dateAnswered": "2016-03-18T18:47:49.459859+02:00",
    "tendererActionDate": "2016-03-18T18:47:49.459888+02:00",
    "dateSubmitted": "2016-03-18T18:47:49.163783+02:00",
    "complaintID": "UA-2016-03-18-000001.1",
    "date": "2016-03-18T18:47:48.772297+02:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "d3bdc18a7e884e33b73c91a46cc34083"
  }
}

Escalate claim to complaint

PATCH /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/f48a5ed39ffd4c91b03d59ebbb1dcc29?acc_token=b53ffa7505e54ea4a4bb6d45b5128dc7 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 51
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "pending",
    "satisfied": false
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "pending",
    "description": "complaint description",
    "title": "complaint title",
    "resolutionType": "resolved",
    "type": "complaint",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "satisfied": false,
    "dateEscalated": "2016-03-18T18:47:49.890891+02:00",
    "dateAnswered": "2016-03-18T18:47:49.720511+02:00",
    "dateSubmitted": "2016-03-18T18:47:49.275773+02:00",
    "complaintID": "UA-2016-03-18-000001.2",
    "date": "2016-03-18T18:47:49.274436+02:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "f48a5ed39ffd4c91b03d59ebbb1dcc29"
  }
}

Complaint Resolution

Rejecting Tender Conditions Complaint

PATCH /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/f48a5ed39ffd4c91b03d59ebbb1dcc29 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "invalid"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "invalid",
    "dateDecision": "2016-03-18T18:47:50.039539+02:00",
    "description": "complaint description",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "resolutionType": "resolved",
    "type": "complaint",
    "title": "complaint title",
    "satisfied": false,
    "dateEscalated": "2016-03-18T18:47:49.890891+02:00",
    "dateAnswered": "2016-03-18T18:47:49.720511+02:00",
    "dateSubmitted": "2016-03-18T18:47:49.275773+02:00",
    "complaintID": "UA-2016-03-18-000001.2",
    "date": "2016-03-18T18:47:49.274436+02:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "f48a5ed39ffd4c91b03d59ebbb1dcc29"
  }
}

Submitting Tender Conditions Complaint Resolution

The Complaint Review Body uploads the resolution document:

POST /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/400e80f57a4b4f56a8ff0683593a9240/documents HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 199
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy164123015577$
Host: api-sandbox.openprocurement.org


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/400e80f57a4b4f56a8ff0683593a9240/documents/ae48aae8d17c476ca86f7497af128668

{
  "data": {
    "author": "reviewers",
    "title": "ComplaintResolution.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/400e80f57a4b4f56a8ff0683593a9240/documents/ae48aae8d17c476ca86f7497af128668?download=04be831e48494ee4a495763df447da8e",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2016-03-18T18:47:51.112997+02:00",
    "id": "ae48aae8d17c476ca86f7497af128668",
    "dateModified": "2016-03-18T18:47:51.113035+02:00"
  }
}

And either resolves complaint:

PATCH /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/400e80f57a4b4f56a8ff0683593a9240 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 32
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "resolved"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "resolved",
    "dateDecision": "2016-03-18T18:47:51.276247+02:00",
    "documents": [
      {
        "author": "reviewers",
        "title": "ComplaintResolution.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/400e80f57a4b4f56a8ff0683593a9240/documents/ae48aae8d17c476ca86f7497af128668?download=04be831e48494ee4a495763df447da8e",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2016-03-18T18:47:51.112997+02:00",
        "id": "ae48aae8d17c476ca86f7497af128668",
        "dateModified": "2016-03-18T18:47:51.113035+02:00"
      }
    ],
    "description": "complaint description",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "resolutionType": "resolved",
    "type": "complaint",
    "title": "complaint title",
    "satisfied": false,
    "dateEscalated": "2016-03-18T18:47:50.503129+02:00",
    "dateAnswered": "2016-03-18T18:47:50.344360+02:00",
    "dateSubmitted": "2016-03-18T18:47:50.166226+02:00",
    "complaintID": "UA-2016-03-18-000001.3",
    "date": "2016-03-18T18:47:50.164440+02:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "400e80f57a4b4f56a8ff0683593a9240"
  }
}

Or declines it:

PATCH /api/0.12/tenders/9f65ed38c8f446fcab0b6709b76f38b0/complaints/f6685efd93594299bf11ec2abf703c49 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 32
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "declined"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "declined",
    "dateDecision": "2016-03-18T18:47:51.438987+02:00",
    "description": "complaint description",
    "author": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "resolutionType": "resolved",
    "type": "complaint",
    "title": "complaint title",
    "satisfied": false,
    "dateEscalated": "2016-03-18T18:47:50.941494+02:00",
    "dateAnswered": "2016-03-18T18:47:50.792711+02:00",
    "dateSubmitted": "2016-03-18T18:47:50.644150+02:00",
    "complaintID": "UA-2016-03-18-000001.4",
    "date": "2016-03-18T18:47:50.642524+02:00",
    "resolution": "Виправлено неконкурентні умови",
    "id": "f6685efd93594299bf11ec2abf703c49"
  }
}