release-schema: Add finalStatus to tender, award and contract. Clarify tender.datePublished.

docs/history/changelog.md

@@ -184,6 +184,7 @@ Per the [normative and non-normative content and changes policy](../governance/n
   * [#1421](https://github.com/open-contracting/standard/pull/1421) `tender.standstillPeriod`
   * [#1492](https://github.com/open-contracting/standard/pull/1492) `awards.datePublished`
   * [#1165](https://github.com/open-contracting/standard/pull/1165) `statusDetails` to `Tender`, `Award` and `Contract`
+  * [#1648](https://github.com/open-contracting/standard/pull/1648) `finalStatus` to `Tender`, `Award` and `Contract`
   * [#1208](https://github.com/open-contracting/standard/pull/1326) The estimated and maximum values of framework agreeemnts:
     * `tender.maximumValue`. Previously, `tender.value` was used for the maximum value. However, this led to double-counting.
     * `awards.maximumValue`. Previously, `awards.value` was used for the maximum value. However, this led to double-counting.
@@ -225,6 +226,7 @@ Per the [normative and non-normative content and changes policy](../governance/n
   * [#1519](https://github.com/open-contracting/standard/pull/1519) `value.amount`, to clarify amount taken from system or document.
   * [#1618](https://github.com/open-contracting/standard/pull/1618) `tender.enquiryPeriod`, to remove the suggestion to use `tender.submissionMethodDetails` for information about how to submit enquiries.
   * [#1618](https://github.com/open-contracting/standard/pull/1618) Normalize field descriptions according to a style guide.
+  * [#1648](https://github.com/open-contracting/standard/pull/1648) `tender.datePublished`, to clarify its relation to procurement documents.
   * [#1509](https://github.com/open-contracting/standard/pull/1509) `planning`, `Planning`, `tender` and `Tender` to clarify relationships with the availability of documents.
 
 * Remove confusing terminology:

docs/schema/codelists.md

@@ -333,3 +333,33 @@ For enterprises without employees, use the 'micro' code.
 :header-rows: 1
 :file: ../../build/current_lang/codelists/partyScale.csv
 ```
+
+### Tender final status
+
+```{versionadded} 1.2
+```
+
+```{csv-table-no-translate}
+:header-rows: 1
+:file: ../../build/current_lang/codelists/tenderFinalStatus.csv
+```
+
+### Award final status
+
+```{versionadded} 1.2
+```
+
+```{csv-table-no-translate}
+:header-rows: 1
+:file: ../../build/current_lang/codelists/awardFinalStatus.csv
+```
+
+### Contract final status
+
+```{versionadded} 1.2
+```
+
+```{csv-table-no-translate}
+:header-rows: 1
+:file: ../../build/current_lang/codelists/contractFinalStatus.csv
+```

schema/codelists/awardFinalStatus.csv

@@ -0,0 +1,4 @@
+Code,Title,Description
+complete,Complete,"The award was made and the standstill period, if any, has ended."
+cancelled,Cancelled,"The award was cancelled by the buyer or the procuring entity (e.g. because of a change in needs, insufficient funds, or technical or procedural errors) after the bid submission deadline, but before the award was made or before the standstill period, if any, had ended."
+unsuccessful,Unsuccessful,"The award failed (e.g. a review body cancelled the process during the standstill period) after the bid submission deadline, but before the award was made or before the standstill period, if any, had ended."

schema/codelists/contractFinalStatus.csv

@@ -0,0 +1,5 @@
+Code,Title,Description
+terminatedSuccessfully,Terminated successfully,"The contract was concluded and in force, and is terminated due to its successful completion."
+terminatedEarly,Terminated early,"The contract was concluded and in force, and is terminated early due to some non-completion."
+cancelled,Cancelled,"The contracting process was cancelled by the buyer or the procuring entity (e.g. because of a change in needs, insufficient funds, or technical or procedural errors) after the award was made and the standstill period, if any, had ended."
+unsuccessful,Unsuccessful,"The contract failed (e.g. the winning bidder(s) refused to sign the contract) after the award was made and the standstill period, if any, had ended, but before the contract was concluded and in force."

schema/codelists/tenderFinalStatus.csv

@@ -0,0 +1,3 @@
+Code,Title,Description
+cancelled,Cancelled,"The contracting process was cancelled by the buyer or the procuring entity (for example, because of a change in needs, insufficient funds, or technical or procedural errors) after the contracting documents (for example, procurement documents) were available to potential supppliers, but not later than the bid submission deadline."
+unsuccessful,Unsuccessful,"The contracting process failed (for example, no bids were received, all bids were withdrawn by the bidders, all bids were rejected by the buyer or the procuring entity) after the contracting documents (for example, procurement documents) were available to potential suppliers, but not later than the bid submission deadline."

schema/dereferenced-release-schema.json

@@ -4730,7 +4730,7 @@
           ]
         },
         "datePublished": {
-          "description": "The date on which the tender was published.",
+          "description": "The date on which the contracting documents (for example, procurement documents) were published.",
           "format": "date-time",
           "title": "Date published",
           "type": [
@@ -6481,6 +6481,21 @@
             "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
             "deprecatedVersion": "1.1"
           }
+        },
+        "finalStatus": {
+          "title": "Tender final status",
+          "description": "The final status of the tender, from the closed [tenderFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#tender-final-status) codelist.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "codelist": "tenderFinalStatus.csv",
+          "openCodelist": false,
+          "enum": [
+            "cancelled",
+            "unsuccessful",
+            null
+          ]
         }
       },
       "patternProperties": {
@@ -9120,6 +9135,22 @@
               "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
               "deprecatedVersion": "1.1"
             }
+          },
+          "finalStatus": {
+            "title": "Award final status",
+            "description": "The final status of the award, from the closed [awardFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#award-final-status) codelist.",
+            "type": [
+              "string",
+              "null"
+            ],
+            "codelist": "awardFinalStatus.csv",
+            "openCodelist": false,
+            "enum": [
+              "complete",
+              "cancelled",
+              "unsuccessful",
+              null
+            ]
           }
         },
         "patternProperties": {
@@ -14588,6 +14619,23 @@
               "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
               "deprecatedVersion": "1.1"
             }
+          },
+          "finalStatus": {
+            "title": "Contract final status",
+            "description": "The final status of the contract, from the closed [contractFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#contract-final-status) codelist.",
+            "type": [
+              "string",
+              "null"
+            ],
+            "codelist": "contractFinalStatus.csv",
+            "openCodelist": false,
+            "enum": [
+              "terminatedSuccessfully",
+              "terminatedEarly",
+              "cancelled",
+              "unsuccessful",
+              null
+            ]
           }
         },
         "patternProperties": {
@@ -18258,7 +18306,7 @@
           ]
         },
         "datePublished": {
-          "description": "The date on which the tender was published.",
+          "description": "The date on which the contracting documents (for example, procurement documents) were published.",
           "format": "date-time",
           "title": "Date published",
           "type": [
@@ -20009,6 +20057,21 @@
             "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
             "deprecatedVersion": "1.1"
           }
+        },
+        "finalStatus": {
+          "title": "Tender final status",
+          "description": "The final status of the tender, from the closed [tenderFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#tender-final-status) codelist.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "codelist": "tenderFinalStatus.csv",
+          "openCodelist": false,
+          "enum": [
+            "cancelled",
+            "unsuccessful",
+            null
+          ]
         }
       },
       "patternProperties": {
@@ -22644,6 +22707,22 @@
             "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
             "deprecatedVersion": "1.1"
           }
+        },
+        "finalStatus": {
+          "title": "Award final status",
+          "description": "The final status of the award, from the closed [awardFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#award-final-status) codelist.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "codelist": "awardFinalStatus.csv",
+          "openCodelist": false,
+          "enum": [
+            "complete",
+            "cancelled",
+            "unsuccessful",
+            null
+          ]
         }
       },
       "patternProperties": {
@@ -28106,6 +28185,23 @@
             "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
             "deprecatedVersion": "1.1"
           }
+        },
+        "finalStatus": {
+          "title": "Contract final status",
+          "description": "The final status of the contract, from the closed [contractFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#contract-final-status) codelist.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "codelist": "contractFinalStatus.csv",
+          "openCodelist": false,
+          "enum": [
+            "terminatedSuccessfully",
+            "terminatedEarly",
+            "cancelled",
+            "unsuccessful",
+            null
+          ]
         }
       },
       "patternProperties": {

schema/release-schema.json

@@ -399,7 +399,7 @@
           ]
         },
         "datePublished": {
-          "description": "The date on which the tender was published.",
+          "description": "The date on which the contracting documents (for example, procurement documents) were published.",
           "format": "date-time",
           "title": "Date published",
           "type": [
@@ -517,6 +517,21 @@
             "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
             "deprecatedVersion": "1.1"
           }
+        },
+        "finalStatus": {
+          "title": "Tender final status",
+          "description": "The final status of the tender, from the closed [tenderFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#tender-final-status) codelist.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "codelist": "tenderFinalStatus.csv",
+          "openCodelist": false,
+          "enum": [
+            "cancelled",
+            "unsuccessful",
+            null
+          ]
         }
       },
       "patternProperties": {
@@ -708,6 +723,22 @@
             "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
             "deprecatedVersion": "1.1"
           }
+        },
+        "finalStatus": {
+          "title": "Award final status",
+          "description": "The final status of the award, from the closed [awardFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#award-final-status) codelist.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "codelist": "awardFinalStatus.csv",
+          "openCodelist": false,
+          "enum": [
+            "complete",
+            "cancelled",
+            "unsuccessful",
+            null
+          ]
         }
       },
       "patternProperties": {
@@ -893,6 +924,23 @@
             "description": "The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.",
             "deprecatedVersion": "1.1"
           }
+        },
+        "finalStatus": {
+          "title": "Contract final status",
+          "description": "The final status of the contract, from the closed [contractFinalStatus](https://standard.open-contracting.org/{{version}}/{{lang}}/schema/codelists/#contract-final-status) codelist.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "codelist": "contractFinalStatus.csv",
+          "openCodelist": false,
+          "enum": [
+            "terminatedSuccessfully",
+            "terminatedEarly",
+            "cancelled",
+            "unsuccessful",
+            null
+          ]
         }
       },
       "patternProperties": {