Skip to content

Commit c1eed65

Browse files
committed
reference.md: add contracting and processing definitions
1 parent 0871878 commit c1eed65

File tree

1 file changed

+26
-6
lines changed

1 file changed

+26
-6
lines changed

docs/schema/reference.md

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
The [Release Schema](release) provides a detailed specification of the fields and data structures to use when publishing contracting data. Supplementary schemas show how to combine releases into release packages and how to compile releases into records.
44

5-
Releases are immutable – presenting information about a particular event in the lifetime of a contracting (or planning) process. Publishers must not edit a release after publication; a new release can be created by changing the release's `id` and `date`.
5+
Releases are immutable – presenting information about a particular event in the lifetime of a [contracting (or planning) process](#contracting-and-planning-processes). Publishers must not edit a release after publication; a new release can be created by changing the release's `id` and `date`.
66

77
Releases must be published within a [release package](packaging/release_package).
88

@@ -14,9 +14,29 @@ Releases must be published within a [release package](packaging/release_package)
1414
This page presents the release schema in tables, with additional information in paragraphs. You can also download the canonical version of the release schema as [JSON Schema](../../build/current_lang/release-schema.json), download it as a [CSV spreadsheet](../../build/current_lang/release-schema.csv), view it in an [interactive browser](release), or access it through the [Field-Level Mapping Template](https://www.open-contracting.org/resources/ocds-field-level-mapping-template/).
1515
```
1616

17+
## Contracting and planning processes
18+
19+
OCDS recognizes two types of processes: contracting processes and planning processes. In OCDS, a given process is uniquely identified by an [open contracting process identifier](identifiers.md#open-contracting-process-identifier-ocid) (`ocid`).
20+
21+
OCDS defines a contracting process as:
22+
23+
% Align the two blockquotes with the top-level `description` field of the `release-schema.json` file.
24+
25+
> All the actions aimed at implementing one or more contracts. This covers tendering, awarding, contracting and implementation. It does not include actions linked to planning, as these are often less structured and may be linked to multiple contracting processes. In multi-stage procedures (for example, framework agreements with reopening of competition), each round of competition is treated as a separate contracting process.
26+
>
27+
> Procedures that failed and were restarted are considered new processes.
28+
>
29+
> Boundaries between processes (for example, whether two contracts result from a single process or from two processes) are set by buyers depending on their needs (for example, efficient division of labor, clear communication with the market) and legislation (for example, rules on using procedures and lots).
30+
31+
OCDS defines a planning process as:
32+
33+
> All the actions aimed at planning one or more contracting processes. This covers, for example, need identification, budget planning, and market research.
34+
>
35+
> Planning processes are often less structured than contracting processes, so one or more planning processes may lead to one or more contracting processes.
36+
1737
## Release handling
1838

19-
The full OCDS data model is based on the idea of publishing a new release every time information about a contracting (or planning) process changes. This way, users can gain a full view of change over time, and third-parties can understand what needs to be updated in any system that is tracking the progress of a contracting (or planning) process.
39+
The full OCDS data model is based on the idea of publishing a new release every time information about a [contracting (or planning) process](#contracting-and-planning-processes) changes. This way, users can gain a full view of change over time, and third-parties can understand what needs to be updated in any system that is tracking the progress of a contracting (or planning) process.
2040

2141
Publishers will need to choose how to generate new releases, and whether to repeat information in each release, or just to provide changes. This choice ought to be based on an understanding of the [merging process](merging) that is used to generate a snapshot record of a full contracting (or planning) process.
2242

@@ -56,7 +76,7 @@ For example, a publisher announcing the signing of a contract with a 'contract'
5676

5777
### Release
5878

59-
All new information about a contracting (or planning) process is described within a release.
79+
All new information about a [contracting (or planning) process](#contracting-and-planning-processes) is described within a release.
6080

6181
````{admonition} Example
6282
:class: hint
@@ -148,7 +168,7 @@ The planning section is used in a planning process. This includes information ab
148168

149169
#### Budget
150170

151-
Apart from documents, the majority of planning information is held within the budget block. This is designed to allow both machine-readable linkable data about budgets, cross-referencing to data held in other standards such as the [Fiscal Data Package](https://specs.frictionlessdata.io/fiscal-data-package/) or [International Aid Transparency Initiative Standard](https://iatistandard.org/en/), and human readable description of the related budgets and projects, supporting users to understand the relationship of the contracting (or planning) process to existing projects and budgets even where linked data is not available.
171+
Apart from documents, the majority of planning information is held within the budget block. This is designed to allow both machine-readable linkable data about budgets, cross-referencing to data held in other standards such as the [Fiscal Data Package](https://specs.frictionlessdata.io/fiscal-data-package/) or [International Aid Transparency Initiative Standard](https://iatistandard.org/en/), and human readable description of the related budgets and projects, supporting users to understand the relationship of the [contracting (or planning) process](#contracting-and-planning-processes) to existing projects and budgets even where linked data is not available.
152172

153173
````{admonition} Example
154174
:class: hint
@@ -409,7 +429,7 @@ See the [parties](#parties) section.
409429

410430
#### Identifier
411431

412-
The identifier block provides a way to [identify the legal entities](identifiers.md#organization-identifiers) involved in a contracting (or planning) process.
432+
The identifier block provides a way to [identify the legal entities](identifiers.md#organization-identifiers) involved in a [contracting (or planning) process](#contracting-and-planning-processes).
413433

414434
When describing an organizational unit (for example, a department or branch of an organization), the `identifier` field should identify the main organization. The other fields should describe the organizational unit. For more information, see [organizational units](../guidance/map/organizational_units.md).
415435

@@ -463,7 +483,7 @@ When describing an organizational unit (for example, a department or branch of a
463483

464484
Documents can be attached at a number of points within the standard: to planning, tenders, awards, contracts and implementation. Each document block can consist of multiple documents, classified using the [documentType](codelists.md#document-type) codelist.
465485

466-
Documents related to contracting (or planning) processes should be public by default. For more information, see the Open Contracting Partnership's report [Mythbusting Confidentiality in Public Contracting](https://www.open-contracting.org/resources/mythbusting-confidentiality-public-contracting/) and the Center for Global Development's [Principles on Commercial Transparency in Public Contracts](https://www.cgdev.org/publication/principles-commercial-transparency-public-contracts).
486+
Documents related to [contracting (or planning) process](#contracting-and-planning-processes) should be public by default. For more information, see the Open Contracting Partnership's report [Mythbusting Confidentiality in Public Contracting](https://www.open-contracting.org/resources/mythbusting-confidentiality-public-contracting/) and the Center for Global Development's [Principles on Commercial Transparency in Public Contracts](https://www.cgdev.org/publication/principles-commercial-transparency-public-contracts).
467487

468488
Documents should be published at their own stable URLs, accessible for free and without the need to search or login, and available at the time of publication of the OCDS release that refers to them.
469489

0 commit comments

Comments
 (0)