Updates and amendments

Information about a contracting process will often change over time.

Each time information changes, a new OCDS release ought to be published. The new release can contain information that was previously published, in addition to the new information.

There are three kinds of changes:

  • New information. For example, when information about the award of a contract is first released.

  • Updates to existing information. For example, to correct errors in earlier releases, or to make minor adjustments to titles, descriptions or date.

  • Amendments. For example, when the value or duration of a contract is changed. The term amendment often has a specific legal meaning for a publisher. Certain changes to a tender, award or contract might only be allowed as part of an amendment.

The nature of a change can be made explicit using:

  • The release tag (tag). For example, for a release with a new contract, use 'contract'. For an update to the contract, use 'contractUpdate', and for an amendment to the contract, use 'contractAmendment'.

  • The amendments building block. This can contain an array of amendment explanations, and clearly identify the releases that contain before and after values.

Worked examples

Example 1: Tender updates and amendments

This example goes through updates during the tender stage in a contracting process.

Tender

A publisher issues a tender for a "Data merge tool". A new release with the tag 'tender' is built, see the JSON example below.

{
    "ocid": "ocds-213czf-000-00002",
    "id": "ocds-213czf-000-00002-01-tender",
    "date": "2016-01-01T09:30:00Z",
    "language": "en",
    "tag": [
        "tender"
    ],
    "initiationType": "tender",
    "parties": [
        {
            "name": "Open Data Services",
            "identifier": {
                "scheme": "GB-COH",
                "id": "09506232",
                "legalName": "Open Data Services Co-operative",
                "uri": "https://opencorporates.com/companies/gb/09506232"
            },
            "roles": [
                "buyer"
            ],
            "id": "GB-COH-09506232"
        }
    ],
    "buyer": {
        "id": "GB-COH-09506232",
        "name": "Open Data Services"
    },
    "tender": {
        "id": "ocds-213czf-000-00002-01-tender",
        "title": "Data merging tool",
        "description": "Data merge tool.",
        "status": "active",
        "value": {
            "amount": 1000,
            "currency": "USD"
        },
        "procurementMethod": "open",
        "awardCriteria": "bestProposal",
        "submissionMethod": [
            "electronicSubmission"
        ],
        "tenderPeriod": {
            "startDate": "2016-01-31T09:00:00Z",
            "endDate": "2016-02-15T18:00:00Z"
        },
        "awardPeriod": {
            "startDate": "2016-04-01T00:00:00Z",
            "endDate": "2016-06-01T23:59:59Z"
        }
    }
}

Tender Update

Weeks later, the publisher expands the description of the tender to provide more details about the tool being procured. A new release with the tag 'tenderUpdate' is built. The publisher does not consider this to be a formal 'amendment' to the tender, so does not publish any amendment information. See the JSON release below.

{
    "ocid": "ocds-213czf-000-00002",
    "id": "ocds-213czf-000-00002-01-tender-update",
    "date": "2016-01-31T09:30:00Z",
    "language": "en",
    "tag": [
        "tenderUpdate"
    ],
    "initiationType": "tender",
    "parties": [
        {
            "name": "Open Data Services",
            "identifier": {
                "scheme": "GB-COH",
                "id": "09506232",
                "legalName": "Open Data Services Co-operative",
                "uri": "https://opencorporates.com/companies/gb/09506232"
            },
            "roles": [
                "buyer"
            ],
            "id": "GB-COH-09506232"
        }
    ],
    "buyer": {
        "id": "GB-COH-09506232",
        "name": "Open Data Services"
    },
    "tender": {
        "id": "ocds-213czf-000-00002-01-tender",
        "title": "Data merging tool",
        "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
        "status": "active",
        "value": {
            "amount": 1000,
            "currency": "USD"
        },
        "procurementMethod": "open",
        "awardCriteria": "bestProposal",
        "submissionMethod": [
            "electronicSubmission"
        ],
        "tenderPeriod": {
            "startDate": "2016-01-31T09:00:00Z",
            "endDate": "2016-02-15T18:00:00Z"
        },
        "awardPeriod": {
            "startDate": "2016-04-01T00:00:00Z",
            "endDate": "2016-06-01T23:59:59Z"
        }
    }
}

Tender Amendment

A few days later, the publisher increases the value of the tender and extends the deadline for bid submissions. These changes are considered as an 'amendment' by the publisher (depending on jurisdiction, certain changes can need to be disclosed as amendments), and so the new release has the tag 'tenderAmendment' and an amendments block under tender. The release reflects the updated value (USD 2000 instead of USD 1000) and the updated closing date for bid submissions (2012-02-20 instead of 2012-02-15). See the JSON example below.

{
    "ocid": "ocds-213czf-000-00002",
    "id": "ocds-213czf-000-00002-01-tender-amendment",
    "date": "2016-02-05T10:30:00Z",
    "language": "en",
    "tag": [
        "tenderAmendment"
    ],
    "initiationType": "tender",
    "parties": [
        {
            "name": "Open Data Services",
            "identifier": {
                "scheme": "GB-COH",
                "id": "09506232",
                "legalName": "Open Data Services Co-operative",
                "uri": "https://opencorporates.com/companies/gb/09506232"
            },
            "roles": [
                "buyer"
            ],
            "id": "GB-COH-09506232"
        }
    ],
    "buyer": {
        "id": "GB-COH-09506232",
        "name": "Open Data Services"
    },
    "tender": {
        "id": "ocds-213czf-000-00002-01-tender",
        "title": "Data merging tool",
        "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
        "status": "active",
        "value": {
            "amount": 2000,
            "currency": "USD"
        },
        "procurementMethod": "open",
        "awardCriteria": "bestProposal",
        "submissionMethod": [
            "electronicSubmission"
        ],
        "tenderPeriod": {
            "startDate": "2016-01-31T09:00:00Z",
            "endDate": "2016-02-20T18:00:00Z"
        },
        "awardPeriod": {
            "startDate": "2016-04-01T00:00:00Z",
            "endDate": "2016-06-01T23:59:59Z"
        },
        "amendments": [
            {
                "id": "amendment-1",
                "date": "2016-02-04T09:30:00Z",
                "rationale": "Based on feedback from potential bidders, the total budget was increased by $1000, and the deadline extended",
                "amendsReleaseID": "ocds-213czf-000-00002-01-tender",
                "releaseID": "ocds-213czf-000-00002-01-tender-amendment"
            }
        ]
    }
}

Record

A full record is provided below, with all the releases for the process and a compiledRelease and versionedRelease. The versionedRelease block reflects all the changes made in the tender.

{
    "uri": "https://standard.open-contracting.org/examples/records/ocds-213czf-000-00002.json",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "https://standard.open-contracting.org/examples/"
    },
    "publishedDate": "2016-02-05T10:30:00Z",
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "packages": [
        "https://standard.open-contracting.org/examples/releases/ocds-213czf-000-00002-01-tender.json",
        "https://standard.open-contracting.org/examples/releases/ocds-213czf-000-00002-01-tender-update.json",
        "https://standard.open-contracting.org/examples/releases/ocds-213czf-000-00002-01-tender-amendment.json"
    ],
    "records": [
        {
            "ocid": "ocds-213czf-000-00002",
            "releases": [
                {
                    "ocid": "ocds-213czf-000-00002",
                    "id": "ocds-213czf-000-00002-01-tender",
                    "date": "2016-01-01T09:30:00Z",
                    "language": "en",
                    "tag": [
                        "tender"
                    ],
                    "initiationType": "tender",
                    "parties": [
                        {
                            "name": "Open Data Services",
                            "identifier": {
                                "scheme": "GB-COH",
                                "id": "09506232",
                                "legalName": "Open Data Services Co-operative",
                                "uri": "https://opencorporates.com/companies/gb/09506232"
                            },
                            "roles": [
                                "buyer"
                            ],
                            "id": "GB-COH-09506232"
                        }
                    ],
                    "buyer": {
                        "id": "GB-COH-09506232",
                        "name": "Open Data Services"
                    },
                    "tender": {
                        "id": "ocds-213czf-000-00002-01-tender",
                        "title": "Data merging tool",
                        "description": "Data merge tool.",
                        "status": "active",
                        "value": {
                            "amount": 1000,
                            "currency": "USD"
                        },
                        "procurementMethod": "open",
                        "awardCriteria": "bestProposal",
                        "submissionMethod": [
                            "electronicSubmission"
                        ],
                        "tenderPeriod": {
                            "startDate": "2016-01-31T09:00:00Z",
                            "endDate": "2016-02-15T18:00:00Z"
                        },
                        "awardPeriod": {
                            "startDate": "2016-04-01T00:00:00Z",
                            "endDate": "2016-06-01T23:59:59Z"
                        }
                    }
                },
                {
                    "ocid": "ocds-213czf-000-00002",
                    "id": "ocds-213czf-000-00002-01-tender-update",
                    "date": "2016-01-31T09:30:00Z",
                    "language": "en",
                    "tag": [
                        "tenderUpdate"
                    ],
                    "initiationType": "tender",
                    "parties": [
                        {
                            "name": "Open Data Services",
                            "identifier": {
                                "scheme": "GB-COH",
                                "id": "09506232",
                                "legalName": "Open Data Services Co-operative",
                                "uri": "https://opencorporates.com/companies/gb/09506232"
                            },
                            "roles": [
                                "buyer"
                            ],
                            "id": "GB-COH-09506232"
                        }
                    ],
                    "buyer": {
                        "id": "GB-COH-09506232",
                        "name": "Open Data Services"
                    },
                    "tender": {
                        "id": "ocds-213czf-000-00002-01-tender",
                        "title": "Data merging tool",
                        "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
                        "status": "active",
                        "value": {
                            "amount": 1000,
                            "currency": "USD"
                        },
                        "procurementMethod": "open",
                        "awardCriteria": "bestProposal",
                        "submissionMethod": [
                            "electronicSubmission"
                        ],
                        "tenderPeriod": {
                            "startDate": "2016-01-31T09:00:00Z",
                            "endDate": "2016-02-15T18:00:00Z"
                        },
                        "awardPeriod": {
                            "startDate": "2016-04-01T00:00:00Z",
                            "endDate": "2016-06-01T23:59:59Z"
                        }
                    }
                },
                {
                    "ocid": "ocds-213czf-000-00002",
                    "id": "ocds-213czf-000-00002-01-tender-amendment",
                    "date": "2016-02-05T10:30:00Z",
                    "language": "en",
                    "tag": [
                        "tenderAmendment"
                    ],
                    "initiationType": "tender",
                    "parties": [
                        {
                            "name": "Open Data Services",
                            "identifier": {
                                "scheme": "GB-COH",
                                "id": "09506232",
                                "legalName": "Open Data Services Co-operative",
                                "uri": "https://opencorporates.com/companies/gb/09506232"
                            },
                            "roles": [
                                "buyer"
                            ],
                            "id": "GB-COH-09506232"
                        }
                    ],
                    "buyer": {
                        "id": "GB-COH-09506232",
                        "name": "Open Data Services"
                    },
                    "tender": {
                        "id": "ocds-213czf-000-00002-01-tender",
                        "title": "Data merging tool",
                        "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
                        "status": "active",
                        "value": {
                            "amount": 2000,
                            "currency": "USD"
                        },
                        "procurementMethod": "open",
                        "awardCriteria": "bestProposal",
                        "submissionMethod": [
                            "electronicSubmission"
                        ],
                        "tenderPeriod": {
                            "startDate": "2016-01-31T09:00:00Z",
                            "endDate": "2016-02-20T18:00:00Z"
                        },
                        "awardPeriod": {
                            "startDate": "2016-04-01T00:00:00Z",
                            "endDate": "2016-06-01T23:59:59Z"
                        },
                        "amendments": [
                            {
                                "id": "amendment-1",
                                "date": "2016-02-04T09:30:00Z",
                                "rationale": "Based on feedback from potential bidders, the total budget was increased by $1000, and the deadline extended",
                                "amendsReleaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseID": "ocds-213czf-000-00002-01-tender-amendment"
                            }
                        ]
                    }
                }
            ],
            "compiledRelease": {
                "tag": [
                    "compiled"
                ],
                "id": "ocds-213czf-000-00002-2016-02-05T10:30:00Z",
                "date": "2016-02-05T10:30:00Z",
                "ocid": "ocds-213czf-000-00002",
                "language": "en",
                "initiationType": "tender",
                "parties": [
                    {
                        "id": "GB-COH-09506232",
                        "name": "Open Data Services",
                        "identifier": {
                            "scheme": "GB-COH",
                            "id": "09506232",
                            "legalName": "Open Data Services Co-operative",
                            "uri": "https://opencorporates.com/companies/gb/09506232"
                        },
                        "roles": [
                            "buyer"
                        ]
                    }
                ],
                "buyer": {
                    "id": "GB-COH-09506232",
                    "name": "Open Data Services"
                },
                "tender": {
                    "id": "ocds-213czf-000-00002-01-tender",
                    "title": "Data merging tool",
                    "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
                    "status": "active",
                    "value": {
                        "amount": 2000,
                        "currency": "USD"
                    },
                    "procurementMethod": "open",
                    "awardCriteria": "bestProposal",
                    "submissionMethod": [
                        "electronicSubmission"
                    ],
                    "tenderPeriod": {
                        "startDate": "2016-01-31T09:00:00Z",
                        "endDate": "2016-02-20T18:00:00Z"
                    },
                    "awardPeriod": {
                        "startDate": "2016-04-01T00:00:00Z",
                        "endDate": "2016-06-01T23:59:59Z"
                    },
                    "amendments": [
                        {
                            "id": "amendment-1",
                            "date": "2016-02-04T09:30:00Z",
                            "rationale": "Based on feedback from potential bidders, the total budget was increased by $1000, and the deadline extended",
                            "amendsReleaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseID": "ocds-213czf-000-00002-01-tender-amendment"
                        }
                    ]
                }
            },
            "versionedRelease": {
                "ocid": "ocds-213czf-000-00002",
                "language": [
                    {
                        "releaseID": "ocds-213czf-000-00002-01-tender",
                        "releaseDate": "2016-01-01T09:30:00Z",
                        "releaseTag": [
                            "tender"
                        ],
                        "value": "en"
                    }
                ],
                "initiationType": [
                    {
                        "releaseID": "ocds-213czf-000-00002-01-tender",
                        "releaseDate": "2016-01-01T09:30:00Z",
                        "releaseTag": [
                            "tender"
                        ],
                        "value": "tender"
                    }
                ],
                "parties": [
                    {
                        "id": "GB-COH-09506232",
                        "name": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "Open Data Services"
                            }
                        ],
                        "identifier": {
                            "scheme": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "GB-COH"
                                }
                            ],
                            "id": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "09506232"
                                }
                            ],
                            "legalName": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "Open Data Services Co-operative"
                                }
                            ],
                            "uri": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "https://opencorporates.com/companies/gb/09506232"
                                }
                            ]
                        },
                        "roles": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": [
                                    "buyer"
                                ]
                            }
                        ]
                    }
                ],
                "buyer": {
                    "id": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "GB-COH-09506232"
                        }
                    ],
                    "name": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "Open Data Services"
                        }
                    ]
                },
                "tender": {
                    "id": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "ocds-213czf-000-00002-01-tender"
                        }
                    ],
                    "title": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "Data merging tool"
                        }
                    ],
                    "description": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "Data merge tool."
                        },
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender-update",
                            "releaseDate": "2016-01-31T09:30:00Z",
                            "releaseTag": [
                                "tenderUpdate"
                            ],
                            "value": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail."
                        }
                    ],
                    "status": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "active"
                        }
                    ],
                    "value": {
                        "amount": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": 1000
                            },
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                "releaseDate": "2016-02-05T10:30:00Z",
                                "releaseTag": [
                                    "tenderAmendment"
                                ],
                                "value": 2000
                            }
                        ],
                        "currency": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "USD"
                            }
                        ]
                    },
                    "procurementMethod": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "open"
                        }
                    ],
                    "awardCriteria": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "bestProposal"
                        }
                    ],
                    "submissionMethod": [
                        {
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": [
                                "electronicSubmission"
                            ]
                        }
                    ],
                    "tenderPeriod": {
                        "startDate": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-01-31T09:00:00Z"
                            }
                        ],
                        "endDate": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-02-15T18:00:00Z"
                            },
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                "releaseDate": "2016-02-05T10:30:00Z",
                                "releaseTag": [
                                    "tenderAmendment"
                                ],
                                "value": "2016-02-20T18:00:00Z"
                            }
                        ]
                    },
                    "awardPeriod": {
                        "startDate": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-04-01T00:00:00Z"
                            }
                        ],
                        "endDate": [
                            {
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-06-01T23:59:59Z"
                            }
                        ]
                    },
                    "amendments": [
                        {
                            "id": "amendment-1",
                            "date": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "2016-02-04T09:30:00Z"
                                }
                            ],
                            "rationale": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "Based on feedback from potential bidders, the total budget was increased by $1000, and the deadline extended"
                                }
                            ],
                            "amendsReleaseID": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "ocds-213czf-000-00002-01-tender"
                                }
                            ],
                            "releaseID": [
                                {
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "ocds-213czf-000-00002-01-tender-amendment"
                                }
                            ]
                        }
                    ]
                }
            }
        }
    ]
}

Hint

It is encouraged to download the record example and use the Data Review Tool to explore the changes in the contracting process.

Note in this example that:

  • The amendments block does not contain data on what was changed. Changes are recorded by updating the fields of the tender block a new release.

  • The publisher chooses in the 'tenderAmendment' release to repeat a fragment of the original 'tender' release. This is not necessary when a full archive of releases is made accessible, but a publisher might want to provide the latest data available in each release.

  • In the record, the releaseID and amendsReleaseID fields from the amendments array can be used to look up information in the versionedRelease object or releases array, to see where changes are explained by an amendment rationale.

Example 2: Contract amendment

This example shows an update to the value and scope of a contract.

Contract

A contract notice is published for the purchase of domestic appliances. The publisher builds a release and uses the 'contract' tag.

See the JSON release below.

{
    "id": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
    "ocid": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
    "initiationType": "tender",
    "date": "2019-02-15T01:00:58Z",
    "tag": [
        "contract"
    ],
    "language": "en",
    "contracts": [
        {
            "status": "active",
            "description": "Appliances for Tuvalu PPB Residence",
            "title": "4501062723",
            "items": [
                {
                    "id": "1",
                    "description": "Domestic coffee maker",
                    "quantity": 2,
                    "classification": {
                        "scheme": "UNSPSC",
                        "id": "52141526"
                    }
                },
                {
                    "id": "2",
                    "description": "Domestic electrical kettle",
                    "quantity": 2,
                    "classification": {
                        "scheme": "UNSPSC",
                        "id": "52141523"
                    }
                }
            ],
            "period": {
                "startDate": "2018-11-30T01:00:00Z",
                "endDate": "2019-12-30T01:00:00Z"
            },
            "value": {
                "currency": "AUD",
                "amount": 750.0
            },
            "dateSigned": "2018-12-21T02:49:50Z",
            "awardID": "CN3562241-12b0ab89ef79180a7289cb6c40c33c1f",
            "id": "CN3562241"
        }
    ],
    "parties": [
        {
            "identifier": {
                "scheme": "AU-ABN",
                "id": "60010555549"
            },
            "name": "NORSHIP MARINE",
            "roles": [
                "supplier"
            ],
            "address": {
                "postalCode": "4870",
                "countryName": "AUSTRALIA",
                "region": "QLD",
                "locality": "PORTSMITH"
            },
            "contactPoint": {
                "email": "BMI.FINANCIALREPORTING@DEFENCE.GOV.AU",
                "telephone": "00",
                "name": "SP&I - International Policy"
            },
            "id": "fb9c43bb01f873c72c730bdac5b0858f"
        },
        {
            "identifier": {
                "scheme": "AU-ABN",
                "id": "62950639680"
            },
            "name": "Department of Defence",
            "roles": [
                "buyer"
            ],
            "contactPoint": {
                "email": "tenders@finance.gov.au"
            },
            "id": "0ec9911c9e99d1b7bb1b77f4abffc583"
        }
    ]
}

Contract Amendment

A few days after the contract release, its scope is increased to include the purchase of one additional appliance. A new 'contractAmendment' release is built, where a single item is added in the contracts/items block and the value of the contract is increased. A amendments block is included to explain the rationale of the changes.

See the example release below.

{
    "id": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
    "ocid": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
    "initiationType": "tender",
    "date": "2019-02-17T00:00:00Z",
    "tag": [
        "contractAmendment"
    ],
    "language": "en",
    "contracts": [
        {
            "status": "active",
            "amendments": [
                {
                    "id": "1",
                    "amendsReleaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                    "rationale": "After negociations with the supplier, the scope of the contract has been increased to purchase an additional item.",
                    "date": "2019-02-16T12:00:00Z"
                }
            ],
            "description": "Appliances for Tuvalu PPB Residence",
            "title": "4501062723",
            "items": [
                {
                    "id": "3",
                    "description": "Domestic microwave oven",
                    "quantity": 1,
                    "classification": {
                        "scheme": "UNSPSC",
                        "id": "52141502"
                    }
                }
            ],
            "period": {
                "startDate": "2018-11-30T01:00:00Z",
                "endDate": "2019-12-30T01:00:00Z"
            },
            "value": {
                "currency": "AUD",
                "amount": 1250.0
            },
            "dateSigned": "2018-12-21T02:49:50Z",
            "awardID": "CN3562241-12b0ab89ef79180a7289cb6c40c33c1f",
            "id": "CN3562241"
        }
    ],
    "parties": [
        {
            "identifier": {
                "scheme": "AU-ABN",
                "id": "60010555549"
            },
            "name": "NORSHIP MARINE",
            "roles": [
                "supplier"
            ],
            "address": {
                "postalCode": "4870",
                "countryName": "AUSTRALIA",
                "region": "QLD",
                "locality": "PORTSMITH"
            },
            "contactPoint": {
                "email": "BMI.FINANCIALREPORTING@DEFENCE.GOV.AU",
                "telephone": "00",
                "name": "SP&I - International Policy"
            },
            "id": "fb9c43bb01f873c72c730bdac5b0858f"
        },
        {
            "identifier": {
                "scheme": "AU-ABN",
                "id": "62950639680"
            },
            "name": "Department of Defence",
            "roles": [
                "buyer"
            ],
            "contactPoint": {
                "email": "tenders@finance.gov.au"
            },
            "id": "0ec9911c9e99d1b7bb1b77f4abffc583"
        }
    ]
}

Note that amendments can cover more than values or duration. Also, note that the publisher chose to not repeat the contract items, but add a new one with a new ID value.

In certain scenarios there might not be a valid amendsReleaseID and so it can be omitted, e.g. when historical data is being published in a single release.

Record

An example record for the whole process is shown below. Consider downloading the record example and use the Data Review Tool to explore the changes in the contracting process.

Note that the compiledRelease contains all the items, included the latest one added in the contract amendment.

{
    "uri": "https://standard.open-contracting.org/examples/records/ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
    "publisher": {
        "name": "Department of Finance"
    },
    "publishedDate": "2019-02-17T00:00:00Z",
    "license": "https://creativecommons.org/licenses/by/3.0/au/",
    "version": "1.1",
    "packages": [
        "https://standard.open-contracting.org/examples/releases/ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
        "https://standard.open-contracting.org/examples/releases/ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5"
    ],
    "records": [
        {
            "ocid": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
            "releases": [
                {
                    "id": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                    "ocid": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
                    "initiationType": "tender",
                    "date": "2019-02-15T01:00:58Z",
                    "tag": [
                        "contract"
                    ],
                    "language": "en",
                    "contracts": [
                        {
                            "status": "active",
                            "description": "Appliances for Tuvalu PPB Residence",
                            "title": "4501062723",
                            "items": [
                                {
                                    "id": "1",
                                    "description": "Domestic coffee maker",
                                    "quantity": 2,
                                    "classification": {
                                        "scheme": "UNSPSC",
                                        "id": "52141526"
                                    }
                                },
                                {
                                    "id": "2",
                                    "description": "Domestic electrical kettle",
                                    "quantity": 2,
                                    "classification": {
                                        "scheme": "UNSPSC",
                                        "id": "52141523"
                                    }
                                }
                            ],
                            "period": {
                                "startDate": "2018-11-30T01:00:00Z",
                                "endDate": "2019-12-30T01:00:00Z"
                            },
                            "value": {
                                "currency": "AUD",
                                "amount": 750.0
                            },
                            "dateSigned": "2018-12-21T02:49:50Z",
                            "awardID": "CN3562241-12b0ab89ef79180a7289cb6c40c33c1f",
                            "id": "CN3562241"
                        }
                    ],
                    "parties": [
                        {
                            "identifier": {
                                "scheme": "AU-ABN",
                                "id": "60010555549"
                            },
                            "name": "NORSHIP MARINE",
                            "roles": [
                                "supplier"
                            ],
                            "address": {
                                "postalCode": "4870",
                                "countryName": "AUSTRALIA",
                                "region": "QLD",
                                "locality": "PORTSMITH"
                            },
                            "contactPoint": {
                                "email": "BMI.FINANCIALREPORTING@DEFENCE.GOV.AU",
                                "telephone": "00",
                                "name": "SP&I - International Policy"
                            },
                            "id": "fb9c43bb01f873c72c730bdac5b0858f"
                        },
                        {
                            "identifier": {
                                "scheme": "AU-ABN",
                                "id": "62950639680"
                            },
                            "name": "Department of Defence",
                            "roles": [
                                "buyer"
                            ],
                            "contactPoint": {
                                "email": "tenders@finance.gov.au"
                            },
                            "id": "0ec9911c9e99d1b7bb1b77f4abffc583"
                        }
                    ]
                },
                {
                    "id": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                    "ocid": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
                    "initiationType": "tender",
                    "date": "2019-02-17T00:00:00Z",
                    "tag": [
                        "contractAmendment"
                    ],
                    "language": "en",
                    "contracts": [
                        {
                            "status": "active",
                            "amendments": [
                                {
                                    "id": "1",
                                    "amendsReleaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                    "rationale": "After negociations with the supplier, the scope of the contract has been increased to purchase an additional item.",
                                    "date": "2019-02-16T12:00:00Z"
                                }
                            ],
                            "description": "Appliances for Tuvalu PPB Residence",
                            "title": "4501062723",
                            "items": [
                                {
                                    "id": "3",
                                    "description": "Domestic microwave oven",
                                    "quantity": 1,
                                    "classification": {
                                        "scheme": "UNSPSC",
                                        "id": "52141502"
                                    }
                                }
                            ],
                            "period": {
                                "startDate": "2018-11-30T01:00:00Z",
                                "endDate": "2019-12-30T01:00:00Z"
                            },
                            "value": {
                                "currency": "AUD",
                                "amount": 1250.0
                            },
                            "dateSigned": "2018-12-21T02:49:50Z",
                            "awardID": "CN3562241-12b0ab89ef79180a7289cb6c40c33c1f",
                            "id": "CN3562241"
                        }
                    ],
                    "parties": [
                        {
                            "identifier": {
                                "scheme": "AU-ABN",
                                "id": "60010555549"
                            },
                            "name": "NORSHIP MARINE",
                            "roles": [
                                "supplier"
                            ],
                            "address": {
                                "postalCode": "4870",
                                "countryName": "AUSTRALIA",
                                "region": "QLD",
                                "locality": "PORTSMITH"
                            },
                            "contactPoint": {
                                "email": "BMI.FINANCIALREPORTING@DEFENCE.GOV.AU",
                                "telephone": "00",
                                "name": "SP&I - International Policy"
                            },
                            "id": "fb9c43bb01f873c72c730bdac5b0858f"
                        },
                        {
                            "identifier": {
                                "scheme": "AU-ABN",
                                "id": "62950639680"
                            },
                            "name": "Department of Defence",
                            "roles": [
                                "buyer"
                            ],
                            "contactPoint": {
                                "email": "tenders@finance.gov.au"
                            },
                            "id": "0ec9911c9e99d1b7bb1b77f4abffc583"
                        }
                    ]
                }
            ],
            "compiledRelease": {
                "tag": [
                    "compiled"
                ],
                "id": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2019-02-17T00:00:00Z",
                "date": "2019-02-17T00:00:00Z",
                "ocid": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
                "initiationType": "tender",
                "language": "en",
                "contracts": [
                    {
                        "id": "CN3562241",
                        "status": "active",
                        "description": "Appliances for Tuvalu PPB Residence",
                        "title": "4501062723",
                        "items": [
                            {
                                "id": "1",
                                "description": "Domestic coffee maker",
                                "quantity": 2,
                                "classification": {
                                    "scheme": "UNSPSC",
                                    "id": "52141526"
                                }
                            },
                            {
                                "id": "2",
                                "description": "Domestic electrical kettle",
                                "quantity": 2,
                                "classification": {
                                    "scheme": "UNSPSC",
                                    "id": "52141523"
                                }
                            },
                            {
                                "id": "3",
                                "description": "Domestic microwave oven",
                                "quantity": 1,
                                "classification": {
                                    "scheme": "UNSPSC",
                                    "id": "52141502"
                                }
                            }
                        ],
                        "period": {
                            "startDate": "2018-11-30T01:00:00Z",
                            "endDate": "2019-12-30T01:00:00Z"
                        },
                        "value": {
                            "currency": "AUD",
                            "amount": 1250.0
                        },
                        "dateSigned": "2018-12-21T02:49:50Z",
                        "awardID": "CN3562241-12b0ab89ef79180a7289cb6c40c33c1f",
                        "amendments": [
                            {
                                "id": "1",
                                "amendsReleaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                "rationale": "Increased scope of goods required.",
                                "date": "2019-02-16T12:00:00Z"
                            }
                        ]
                    }
                ],
                "parties": [
                    {
                        "id": "fb9c43bb01f873c72c730bdac5b0858f",
                        "identifier": {
                            "scheme": "AU-ABN",
                            "id": "60010555549"
                        },
                        "name": "NORSHIP MARINE",
                        "roles": [
                            "supplier"
                        ],
                        "address": {
                            "postalCode": "4870",
                            "countryName": "AUSTRALIA",
                            "region": "QLD",
                            "locality": "PORTSMITH"
                        },
                        "contactPoint": {
                            "email": "BMI.FINANCIALREPORTING@DEFENCE.GOV.AU",
                            "telephone": "00",
                            "name": "SP&I - International Policy"
                        }
                    },
                    {
                        "id": "0ec9911c9e99d1b7bb1b77f4abffc583",
                        "identifier": {
                            "scheme": "AU-ABN",
                            "id": "62950639680"
                        },
                        "name": "Department of Defence",
                        "roles": [
                            "buyer"
                        ],
                        "contactPoint": {
                            "email": "tenders@finance.gov.au"
                        }
                    }
                ]
            },
            "versionedRelease": {
                "ocid": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856",
                "initiationType": [
                    {
                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                        "releaseDate": "2019-02-15T01:00:58Z",
                        "releaseTag": [
                            "contract"
                        ],
                        "value": "tender"
                    }
                ],
                "language": [
                    {
                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                        "releaseDate": "2019-02-15T01:00:58Z",
                        "releaseTag": [
                            "contract"
                        ],
                        "value": "en"
                    }
                ],
                "contracts": [
                    {
                        "id": "CN3562241",
                        "status": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": "active"
                            }
                        ],
                        "description": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": "Appliances for Tuvalu PPB Residence"
                            }
                        ],
                        "title": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": "4501062723"
                            }
                        ],
                        "items": [
                            {
                                "id": "1",
                                "description": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                        "releaseDate": "2019-02-15T01:00:58Z",
                                        "releaseTag": [
                                            "contract"
                                        ],
                                        "value": "Domestic coffee maker"
                                    }
                                ],
                                "quantity": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                        "releaseDate": "2019-02-15T01:00:58Z",
                                        "releaseTag": [
                                            "contract"
                                        ],
                                        "value": 2
                                    }
                                ],
                                "classification": {
                                    "scheme": [
                                        {
                                            "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                            "releaseDate": "2019-02-15T01:00:58Z",
                                            "releaseTag": [
                                                "contract"
                                            ],
                                            "value": "UNSPSC"
                                        }
                                    ],
                                    "id": [
                                        {
                                            "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                            "releaseDate": "2019-02-15T01:00:58Z",
                                            "releaseTag": [
                                                "contract"
                                            ],
                                            "value": "52141526"
                                        }
                                    ]
                                }
                            },
                            {
                                "id": "2",
                                "description": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                        "releaseDate": "2019-02-15T01:00:58Z",
                                        "releaseTag": [
                                            "contract"
                                        ],
                                        "value": "Domestic electrical kettle"
                                    }
                                ],
                                "quantity": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                        "releaseDate": "2019-02-15T01:00:58Z",
                                        "releaseTag": [
                                            "contract"
                                        ],
                                        "value": 2
                                    }
                                ],
                                "classification": {
                                    "scheme": [
                                        {
                                            "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                            "releaseDate": "2019-02-15T01:00:58Z",
                                            "releaseTag": [
                                                "contract"
                                            ],
                                            "value": "UNSPSC"
                                        }
                                    ],
                                    "id": [
                                        {
                                            "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                            "releaseDate": "2019-02-15T01:00:58Z",
                                            "releaseTag": [
                                                "contract"
                                            ],
                                            "value": "52141523"
                                        }
                                    ]
                                }
                            },
                            {
                                "id": "3",
                                "description": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                        "releaseDate": "2019-02-17T00:00:00Z",
                                        "releaseTag": [
                                            "contractAmendment"
                                        ],
                                        "value": "Domestic microwave oven"
                                    }
                                ],
                                "quantity": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                        "releaseDate": "2019-02-17T00:00:00Z",
                                        "releaseTag": [
                                            "contractAmendment"
                                        ],
                                        "value": 1
                                    }
                                ],
                                "classification": {
                                    "scheme": [
                                        {
                                            "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                            "releaseDate": "2019-02-17T00:00:00Z",
                                            "releaseTag": [
                                                "contractAmendment"
                                            ],
                                            "value": "UNSPSC"
                                        }
                                    ],
                                    "id": [
                                        {
                                            "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                            "releaseDate": "2019-02-17T00:00:00Z",
                                            "releaseTag": [
                                                "contractAmendment"
                                            ],
                                            "value": "52141502"
                                        }
                                    ]
                                }
                            }
                        ],
                        "period": {
                            "startDate": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "2018-11-30T01:00:00Z"
                                }
                            ],
                            "endDate": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "2019-12-30T01:00:00Z"
                                }
                            ]
                        },
                        "value": {
                            "currency": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "AUD"
                                }
                            ],
                            "amount": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": 750.0
                                },
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                    "releaseDate": "2019-02-17T00:00:00Z",
                                    "releaseTag": [
                                        "contractAmendment"
                                    ],
                                    "value": 1250.0
                                }
                            ]
                        },
                        "dateSigned": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": "2018-12-21T02:49:50Z"
                            }
                        ],
                        "awardID": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": "CN3562241-12b0ab89ef79180a7289cb6c40c33c1f"
                            }
                        ],
                        "amendments": [
                            {
                                "id": "1",
                                "amendsReleaseID": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                        "releaseDate": "2019-02-17T00:00:00Z",
                                        "releaseTag": [
                                            "contractAmendment"
                                        ],
                                        "value": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24"
                                    }
                                ],
                                "releaseID": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                        "releaseDate": "2019-02-17T00:00:00Z",
                                        "releaseTag": [
                                            "contractAmendment"
                                        ],
                                        "value": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5"
                                    }
                                ],
                                "rationale": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                        "releaseDate": "2019-02-17T00:00:00Z",
                                        "releaseTag": [
                                            "contractAmendment"
                                        ],
                                        "value": "Increased scope of goods required."
                                    }
                                ],
                                "date": [
                                    {
                                        "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-2000b475e7c23fcda74fcae13275e6c5",
                                        "releaseDate": "2019-02-17T00:00:00Z",
                                        "releaseTag": [
                                            "contractAmendment"
                                        ],
                                        "value": "2019-02-16T12:00:00Z"
                                    }
                                ]
                            }
                        ]
                    }
                ],
                "parties": [
                    {
                        "id": "fb9c43bb01f873c72c730bdac5b0858f",
                        "identifier": {
                            "scheme": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "AU-ABN"
                                }
                            ],
                            "id": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "60010555549"
                                }
                            ]
                        },
                        "name": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": "NORSHIP MARINE"
                            }
                        ],
                        "roles": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": [
                                    "supplier"
                                ]
                            }
                        ],
                        "address": {
                            "postalCode": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "4870"
                                }
                            ],
                            "countryName": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "AUSTRALIA"
                                }
                            ],
                            "region": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "QLD"
                                }
                            ],
                            "locality": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "PORTSMITH"
                                }
                            ]
                        },
                        "contactPoint": {
                            "email": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "BMI.FINANCIALREPORTING@DEFENCE.GOV.AU"
                                }
                            ],
                            "telephone": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "00"
                                }
                            ],
                            "name": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "SP&I - International Policy"
                                }
                            ]
                        }
                    },
                    {
                        "id": "0ec9911c9e99d1b7bb1b77f4abffc583",
                        "identifier": {
                            "scheme": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "AU-ABN"
                                }
                            ],
                            "id": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "62950639680"
                                }
                            ]
                        },
                        "name": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": "Department of Defence"
                            }
                        ],
                        "roles": [
                            {
                                "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                "releaseDate": "2019-02-15T01:00:58Z",
                                "releaseTag": [
                                    "contract"
                                ],
                                "value": [
                                    "buyer"
                                ]
                            }
                        ],
                        "contactPoint": {
                            "email": [
                                {
                                    "releaseID": "ocds-d2phr6-12b0ab8ac4c28d322a82062e99918856-9887f9ebe7043172ab2abe4db2a5aa24",
                                    "releaseDate": "2019-02-15T01:00:58Z",
                                    "releaseTag": [
                                        "contract"
                                    ],
                                    "value": "tenders@finance.gov.au"
                                }
                            ]
                        }
                    }
                ]
            }
        }
    ]
}

Example 3: Amendments in a Easy Releases scenario

The Easy releases guidance explains how to publish releases without storing or publishing a full change history. Depending on the source system, it might still be possible to publish a history of amendments when using this model.

Where the source system stores a history of contract amendments, either as separate notices or as properties of the original contract notice, contract amendments can be published as separate releases in OCDS. For example, Australia's AusTender platform stores contract amendments as separate notices, related to the original contract notice.

The table below shows an example of a contract notices table from a procurement system, with an original contract in the first row and an amendment of the same contract in the second. The amendment increases the value of the original contract and changes the contract period.

id

amendmentId

agencyId

supplierId

date

startDate

endDate

description

value

CN3437424

61970632495

54201218474

2015-06-01 02:00:00

2015-06-01 02:00:00

2017-06-22 02:00:00

Drupal websites in govCMS Platform Solution.

623386.00

CN3437424

A1

61970632495

54201218474

2018-06-21 00:00:00

2015-06-01 00:00:00

2019-06-30 00:00:00

Drupal websites in govCMS Platform Solution. Contract was previosly reported 1-Jun-2015 to 22-Jun-2017 therefore using amendement start date and variation value to original value

755969.71

This can be modelled as the separate releases in OCDS as shown below. The original contract release includes all the fields from the first entry in the contract notices table. A contractAmendment release is built for each contract amendment identified in the table (by verifying that the amendmentId column in the contract notices table is not empty).

{
    "language": "en",
    "contracts": [
        {
            "status": "active",
            "description": "Drupal websites in govCMS Platform Solution.",
            "title": "4400027941",
            "items": [
                {
                    "id": "81112200-6dcfcc43c5cf7a3e30ae7561f054e523",
                    "classification": {
                        "scheme": "UNSPSC",
                        "id": "81112200"
                    }
                }
            ],
            "period": {
                "startDate": "2015-06-01T02:00:00Z",
                "endDate": "2017-06-22T02:00:00Z"
            },
            "value": {
                "currency": "AUD",
                "amount": "623386.00"
            },
            "dateSigned": "2015-06-01T02:00:00Z",
            "awardID": "CN3437424-6dcfcc43c5cf7a3e30ae7561f054e523",
            "id": "CN3437424"
        }
    ],
    "ocid": "ocds-d2phr6-1000035663",
    "initiationType": "tender",
    "date": "2015-05-04T00:00:00Z",
    "tag": [
        "award",
        "contract"
    ],
    "awards": [
        {
            "date": "2015-04-15T00:00:00Z",
            "suppliers": [
                {
                    "id": "ac3545c6a1e90c4074832acb210b4963",
                    "name": "DEPARTMENT OF FINANCE AND DEREGULATION"
                }
            ],
            "id": "CN3437424-6dcfcc43c5cf7a3e30ae7561f054e523"
        }
    ],
    "parties": [
        {
            "identifiers": {
                "scheme": "AU-ABN",
                "id": "61970632495"
            },
            "name": "DEPARTMENT OF FINANCE AND DEREGULATION",
            "roles": [
                "supplier"
            ],
            "address": {
                "postalCode": "2600",
                "countryName": "AUSTRALIA",
                "region": "ACT",
                "streetAddress": "JOHN GORTON BUILDING, KING EDWARD TERRACE, PARKES",
                "locality": "CANBERRA"
            },
            "contactPoint": {
                "name": "Group Admin Officer",
                "telephone": "02 6240 7421"
            },
            "id": "ac3545c6a1e90c4074832acb210b4963"
        },
        {
            "identifiers": {
                "scheme": "AU-ABN",
                "id": "54201218474"
            },
            "name": "Department of Jobs and Small Business",
            "roles": [
                "procuringEntity"
            ],
            "contactPoint": {
                "email": "tenders@finance.gov.au"
            },
            "id": "4547d5fbfb37bfc81fc70b15dd3fe4a5"
        }
    ],
    "id": "ocds-d2phr6-1000035663-contract-2015-05-04T00:00:00Z"
}
{
    "ocid": "ocds-d2phr6-1000035663",
    "id": "ocds-d2phr6-1000035663-contract-2018-06-21T00:00:00Z",
    "date": "2018-06-21T00:00:00Z",
    "tag": [
        "contract",
        "contractAmendment"
    ],
    "contracts": [
        {
            "id": "CN3437424",
            "value": {
                "amount": "755969.71",
                "currency": "AUD"
            },
            "period": {
                "startDate": "2015-06-01T00:00:00Z",
                "endDate": "2019-06-30T00:00:00Z"
            },
            "amendments": [
                {
                    "id": "CN3437424-A1",
                    "date": "2018-06-20T00:00:00Z",
                    "description": "Drupal websites in govCMS Platform Solution. Contract was previosly reported 1-Jun-2015 to 22-Jun-2017 therefore using amendement start date and variation value to original value",
                    "amendsReleaseID": "ocds-d2phr6-1000035663-contract-2015-05-04T00:00:00Z",
                    "releaseID": "ocds-d2phr6-1000035663-contract-2018-06-21T00:00:00Z"
                }
            ]
        }
    ]
}

Note that the mapping of the fields remains the same for the contract amendments, except for the description column. When a row in the contract notices table is identified as an original contract, the description is included in the contracts/description field, and when the row represents a contract amendment, it is mapped to the contracts/amendments/description field. This aligns with the use of the description column, because for contract amendments it is used to include an explanation of the change.

The advantage of this approach, in contrast with the Easy releases proposal, is that the users have access to the details of each amendment instead of the latest values only without any additional effort of their end.

As in the previous examples, you can download a record file for the example and use the Data Review Tool to explore the changes in the contracting process.