Milestones

Milestones can be included within the planning, tender, contract and contract implementation sections.

Planning

The planning milestones block is used for two types of milestones:

  • Key events in the planning process, for example, the preparation of an environmental impact assessment, the approval to proceed with a project, or the date of a public consultation.

  • Anticipated milestones during the contract implementation stage, for example, the date by which goods delivery of the goods is required.

If during the planning process you have information about tender process milestones, then you populate the tender milestones block instead.

Tender

The tender milestones block is used to describe two types of milestone:

  • Key dates in the tender and award stages which are not covered by other fields, for example, the date by which procuring entity will respond to enquiries.

  • Anticipated milestones during the contract implementation stage, for example, the date by which goods need to be delivered.

Contract

The contract milestones block is used to describe:

  • Events related to the signing of the contract, for example, the date of commercial close in a PPP contract.

Contract Implementation

The contract implementation milestones block is used to describe:

  • Any events related to the delivery of the contract, for example, the agreed date by which goods will be delivered.

The nature of the milestone is indicated by the milestone type codelist, for example, to distinguish between milestones in the planning section which relate to events in the pre-procurement phase and those which relate to contract implementation.

At the point of contract signature, a comparison between tender/milestones and contract/implementation/milestones with a milestone/type of 'delivery' or 'reporting' should reveal how the negotiated contract differs from what was set out at tender time.

The dueDate, dateMet, dateModified and status fields are used to track the lifecycle of the milestone.

Worked examples

The following worked examples show how to use milestones in different scenarios.

Planning milestones

The example below includes a planning release with details of a planned procurement, including the date the budget plan is expected to be ready.

The date the budget plan is expected to be ready is represented using a milestone in planning/milestones with .type is set to 'preProcurement' because the milestone relates to the planning process. .dueDate is set to the date and .status is set to 'scheduled'.

{
    "uri": "https://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-04-planning.json",
    "publishedDate": "2016-09-10T09:30:00Z",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "https://standard.open-contracting.org/examples/"
    },
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "releases": [
        {
            "ocid": "ocds-213czf-000-00001",
            "id": "ocds-213czf-000-00001-04-planning",
            "date": "2016-09-10T09:30:00Z",
            "language": "en",
            "tag": [
                "planning"
            ],
            "initiationType": "tender",
            "planning": {
                "budget": {
                    "id": "1.02.1.02.01.01.25.24.5.2.3.49.06",
                    "amount": {
                        "amount": 30000000,
                        "currency": "IDR"
                    },
                    "project": "Konsultan Pengawas",
                    "description": "APBD"
                },
                "milestones": [
                    {
                        "id": "1",
                        "type": "preProcurement",
                        "title": "Budget Plan",
                        "status": "scheduled",
                        "dueDate": "2016-09-19T23:29:03Z",
                        "description": "Rencana Pengadaan Road Map"
                    }
                ]
            }
        }
    ]
}

Contract implementation milestones

The following worked examples show how to use milestones in contract implementation releases

Project data

This worked example shows how to use milestones to model the planned and actual start and finish dates for a construction project.

The example below includes three OCDS releases:

  • An implementation release which includes the scheduled start and end dates for the project.

  • An implementation update release with the actual start date of the project

  • An implementation update release with the actual end date of the project

In the award release:

  • The scheduled start and end dates for the project are represented using milestones in contracts/implementation/milestones with .type set to 'delivery' because they relate to the delivery of the contract. The dates are provided in .dueDate and .status is set to 'scheduled'.

  • The publisher has defined their own values for the .code field so they can filter and compare start and end date milestones across different contracts.

In the first implementation update release, which is published after the project starts but before it completes:

  • In the project commencement milestone, .dateMet is set to the actual start date and .status is set to 'met'. .dateModified is set to the date the milestone was updated.

  • In the project completion milestone, .status is set to 'notMet' since the project is not yet complete and .dateModified is set to the date the milestone was updated.

Users can compare the project commencement milestone's .dueDate and .dateMet fields to determine if the project started on time. Users can also compare the project completion milestone's .dueDate and .dateModified fields to determine whether the .status has been updated since the scheduled completion date.

In the second implementation update release, which is published after the project completes:

  • In the project completion milestone, .dateMet is set to the actual completion date for the project and .status is set to 'met'.

{
    "uri": "https://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-05-contract.json",
    "publishedDate": "2011-01-10T09:30:00Z",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "https://standard.open-contracting.org/examples/"
    },
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "releases": [
        {
            "ocid": "ocds-213czf-000-00001",
            "id": "ocds-213czf-000-00001-06-implementation-milestones-1",
            "date": "2018-01-05T09:30:00Z",
            "language": "en",
            "tag": [
                "implementation"
            ],
            "initiationType": "tender",
            "parties": [
                {
                    "identifier": {
                        "scheme": "GB-LAC",
                        "id": "E09000003",
                        "legalName": "London Borough of Barnet"
                    },
                    "name": "London Borough of Barnet",
                    "roles": [
                        "buyer"
                    ],
                    "id": "GB-LAC-E09000003"
                }
            ],
            "buyer": {
                "id": "GB-LAC-E09000003",
                "name": "London Borough of Barnet"
            },
            "contracts": [
                {
                    "id": "ocds-213czf-000-00001-contract-01",
                    "awardID": "ocds-213czf-000-00001-award-01",
                    "title": "Contract to build new cycle lanes in the centre of town.",
                    "implementation": {
                        "milestones": [
                            {
                                "id": "1",
                                "title": "project started",
                                "type": "delivery",
                                "code": "commencement",
                                "dueDate": "2018-03-19T00:00:00Z",
                                "status": "scheduled"
                            },
                            {
                                "id": "2",
                                "title": "project completed",
                                "type": "delivery",
                                "code": "completion",
                                "dueDate": "2018-12-31T00:00:00Z",
                                "status": "scheduled"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
{
    "uri": "https://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-05-contract.json",
    "publishedDate": "2011-01-10T09:30:00Z",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "https://standard.open-contracting.org/examples/"
    },
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "releases": [
        {
            "ocid": "ocds-213czf-000-00001",
            "id": "ocds-213czf-000-00001-06-implementation-milestones-2",
            "date": "2018-03-31T09:30:00Z",
            "language": "en",
            "tag": [
                "implementationUpdate"
            ],
            "initiationType": "tender",
            "parties": [
                {
                    "identifier": {
                        "scheme": "GB-LAC",
                        "id": "E09000003",
                        "legalName": "London Borough of Barnet"
                    },
                    "name": "London Borough of Barnet",
                    "roles": [
                        "buyer"
                    ],
                    "id": "GB-LAC-E09000003"
                }
            ],
            "buyer": {
                "id": "GB-LAC-E09000003",
                "name": "London Borough of Barnet"
            },
            "contracts": [
                {
                    "id": "ocds-213czf-000-00001-contract-01",
                    "awardID": "ocds-213czf-000-00001-award-01",
                    "title": "Contract to build new cycle lanes in the centre of town.",
                    "implementation": {
                        "milestones": [
                            {
                                "id": "1",
                                "title": "project started",
                                "type": "delivery",
                                "code": "commencement",
                                "dueDate": "2018-03-19T00:00:00Z",
                                "status": "met",
                                "dateMet": "2018-03-31T00:00:00Z",
                                "dateModified": "2018-03-31T00:00:00Z"
                            },
                            {
                                "id": "2",
                                "title": "project completed",
                                "type": "delivery",
                                "code": "completion",
                                "dueDate": "2018-12-31T00:00:00Z",
                                "status": "notMet",
                                "dateModified": "2018-03-31T00:00:00Z"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
{
    "uri": "https://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-05-contract.json",
    "publishedDate": "2011-01-10T09:30:00Z",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "https://standard.open-contracting.org/examples/"
    },
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "extensions": [],
    "releases": [
        {
            "ocid": "ocds-213czf-000-00001",
            "id": "ocds-213czf-000-00001-06-implementation-milestones-3",
            "date": "2018-12-24T09:30:00Z",
            "language": "en",
            "tag": [
                "implementationUpdate"
            ],
            "initiationType": "tender",
            "parties": [
                {
                    "identifier": {
                        "scheme": "GB-LAC",
                        "id": "E09000003",
                        "legalName": "London Borough of Barnet"
                    },
                    "name": "London Borough of Barnet",
                    "roles": [
                        "buyer"
                    ],
                    "id": "GB-LAC-E09000003"
                }
            ],
            "buyer": {
                "id": "GB-LAC-E09000003",
                "name": "London Borough of Barnet"
            },
            "contracts": [
                {
                    "id": "ocds-213czf-000-00001-contract-01",
                    "awardID": "ocds-213czf-000-00001-award-01",
                    "title": "Contract to build new cycle lanes in the centre of town.",
                    "implementation": {
                        "milestones": [
                            {
                                "id": "1",
                                "title": "project started",
                                "type": "delivery",
                                "code": "commencement",
                                "dueDate": "2018-03-19T00:00:00Z",
                                "status": "met",
                                "dateMet": "2018-03-31T00:00:00Z",
                                "dateModified": "2018-03-31T00:00:00Z"
                            },
                            {
                                "id": "2",
                                "title": "project completed",
                                "type": "delivery",
                                "code": "completion",
                                "dueDate": "2018-12-31T00:00:00Z",
                                "status": "met",
                                "dateMet": "2018-12-24T00:00:00Z",
                                "dateModified": "2018-12-24T00:00:00Z"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Delivery and financing data

This example shows how milestones can be used to keep track of delivery and financing (payment) data in a contracting process.

The example below includes three OCDS releases:

  • An implementation release with contract information including scheduled implementation milestones.

  • An implementation update release with the actual date the milestone was reached.

  • An implementation update release with payment information

In the implementation release:

  • Milestones have been set for the delivery and payment of goods and services related to the project. Contract information is released along with the implementation milestones.

In the first implementation update release:

  • The milestone ("Finish the exterior and interior walls") has been met, so the status field is set to 'met' and the relevant dates are added to the dateMet and dateModified fields.

In the second implementation update release:

  • The construction company has received payment for the work done so far, so the milestone for the wall restoration with type 'financing' is updated. A new transaction is disclosed, with the amount paid to the company.

{
    "uri": "https://standard.open-contracting.org/examples/release/ocds-afalqw-001-5c10b8c57e0a947f6b212f58-001",
    "publisher": {
        "name": "National Procurement Authority, Afghanistan"
    },
    "publishedDate": "2018-09-21T08:00:00+04:30",
    "version": "1.1",
    "releases": [
        {
            "language": "prs-AF",
            "contracts": [
                {
                    "status": "active",
                    "title": "School repairs and mantainance projects, Rahman Baba & Khushal Khan Khattak",
                    "implementation": {
                        "milestones": [
                            {
                                "status": "notMet",
                                "title": "Payment for finish the exterior and interior walls",
                                "dueDate": "2018-10-10T00:00:00+04:30",
                                "type": "financing",
                                "id": "20653Financing"
                            },
                            {
                                "status": "notMet",
                                "title": "Finish the exterior and interior walls",
                                "dueDate": "2018-10-05T00:00:00+04:30",
                                "type": "delivery",
                                "id": "20653Delivery"
                            },
                            {
                                "status": "notMet",
                                "title": "Payment for repair of the electric system",
                                "dueDate": "2018-10-31T00:00:00+04:30",
                                "type": "financing",
                                "id": "20654Financing"
                            },
                            {
                                "status": "notMet",
                                "title": "Repair of the electric system",
                                "dueDate": "2018-10-28T00:00:00+04:30",
                                "type": "delivery",
                                "id": "20654Delivery"
                            }
                        ]
                    },
                    "period": {
                        "startDate": "2018-09-21T00:00:00+04:30",
                        "endDate": "2018-12-21T00:00:00+04:30"
                    },
                    "value": {
                        "currency": "AFN",
                        "amount": 230865
                    },
                    "dateSigned": "2018-09-16T00:00:00+04:30",
                    "awardID": "MOBTA/1397/NCB/OPT/W.003",
                    "id": "MOBTA/1397/NCB/OPT/W.003"
                }
            ],
            "ocid": "ocds-afalqw-001",
            "id": "5c10b8c57e0a947f6b212f58-001",
            "initiationType": "tender",
            "date": "2018-09-21T08:00:00+04:30",
            "tag": [
                "contract",
                "implementation"
            ]
        }
    ]
}
{
    "uri": "https://standard.open-contracting.org/examples/release/ocds-afalqw-001-5c10b8c57e0a947f6b212f58-002",
    "publisher": {
        "name": "National Procurement Authority, Afghanistan"
    },
    "publishedDate": "2018-10-06T11:59:09+04:30",
    "version": "1.1",
    "releases": [
        {
            "language": "prs-AF",
            "contracts": [
                {
                    "status": "active",
                    "title": "School repairs and mantainance projects, Rahman Baba & Khushal Khan Khattak",
                    "implementation": {
                        "milestones": [
                            {
                                "status": "notMet",
                                "title": "Payment for finish the exterior and interior walls",
                                "dueDate": "2018-10-10T00:00:00+04:30",
                                "dateModified": "2018-10-06T11:59:09+04:30",
                                "type": "financing",
                                "id": "20653Financing"
                            },
                            {
                                "status": "met",
                                "title": "Finish the exterior and interior walls",
                                "dueDate": "2018-10-05T00:00:00+04:30",
                                "dateMet": "2018-10-05T00:00:00+04:30",
                                "dateModified": "2018-10-06T11:59:09+04:30",
                                "type": "delivery",
                                "id": "20653Delivery"
                            },
                            {
                                "status": "notMet",
                                "title": "Payment for repair of the electric system",
                                "dueDate": "2018-10-31T00:00:00+04:30",
                                "dateModified": "2018-10-06T11:59:09+04:30",
                                "type": "financing",
                                "id": "20654Financing"
                            },
                            {
                                "status": "notMet",
                                "title": "Repair of the electric system",
                                "dueDate": "2018-10-28T00:00:00+04:30",
                                "dateModified": "2018-10-06T11:59:09+04:30",
                                "type": "delivery",
                                "id": "20654Delivery"
                            }
                        ]
                    },
                    "period": {
                        "startDate": "2018-09-21T00:00:00+04:30",
                        "endDate": "2018-12-21T00:00:00+04:30"
                    },
                    "value": {
                        "currency": "AFN",
                        "amount": 230865
                    },
                    "dateSigned": "2018-09-16T00:00:00+04:30",
                    "awardID": "MOBTA/1397/NCB/OPT/W.003",
                    "id": "MOBTA/1397/NCB/OPT/W.003"
                }
            ],
            "ocid": "ocds-afalqw-001",
            "id": "5c10b8c57e0a947f6b212f58-002",
            "initiationType": "tender",
            "date": "2018-10-06T11:59:09+04:30",
            "tag": [
                "implementationUpdate"
            ]
        }
    ]
}
{
    "uri": "https://standard.open-contracting.org/examples/release/ocds-afalqw-001-5c10b8c57e0a947f6b212f58-003",
    "publisher": {
        "name": "National Procurement Authority, Afghanistan"
    },
    "publishedDate": "2018-10-10T16:48:09+04:30",
    "version": "1.1",
    "releases": [
        {
            "language": "prs-AF",
            "contracts": [
                {
                    "status": "active",
                    "title": "School repairs and mantainance projects, Rahman Baba & Khushal Khan Khattak",
                    "implementation": {
                        "milestones": [
                            {
                                "status": "met",
                                "title": "Payment for finish the exterior and interior walls",
                                "dueDate": "2018-10-10T00:00:00+04:30",
                                "dateMet": "2018-10-09T09:15:00+04:30",
                                "dateModified": "2018-10-10T16:48:09+04:30",
                                "type": "financing",
                                "id": "20653Financing"
                            },
                            {
                                "status": "met",
                                "title": "Finish the exterior and interior walls",
                                "dueDate": "2018-10-05T00:00:00+04:30",
                                "dateMet": "2018-10-05T17:30:00+04:30",
                                "dateModified": "2018-10-10T16:48:09+04:30",
                                "type": "delivery",
                                "id": "20653Delivery"
                            },
                            {
                                "status": "notMet",
                                "title": "Payment for repair of the electric system",
                                "dueDate": "2018-10-31T00:00:00+04:30",
                                "dateModified": "2018-10-10T16:48:09+04:30",
                                "type": "financing",
                                "id": "20654Financing"
                            },
                            {
                                "status": "notMet",
                                "title": "Repair of the electric system",
                                "dueDate": "2018-10-28T00:00:00+04:30",
                                "dateModified": "2018-10-10T16:48:09+04:30",
                                "type": "delivery",
                                "id": "20654Delivery"
                            }
                        ],
                        "transactions": [
                            {
                                "id": "20653",
                                "date": "2018-10-09T09:15:00+04:30",
                                "value": {
                                    "amount": 76955,
                                    "currency": "AFN"
                                },
                                "payer": {
                                    "id": "AF-COA-20",
                                    "name": "Ministry of Finance"
                                },
                                "payee": {
                                    "id": "AF-TIN-9000321217",
                                    "name": "Primus Construction Company"
                                }
                            }
                        ]
                    },
                    "period": {
                        "startDate": "2018-09-21T00:00:00+04:30",
                        "endDate": "2018-12-21T00:00:00+04:30"
                    },
                    "value": {
                        "currency": "AFN",
                        "amount": 230865
                    },
                    "dateSigned": "2018-09-16T00:00:00+04:30",
                    "awardID": "MOBTA/1397/NCB/OPT/W.003",
                    "id": "MOBTA/1397/NCB/OPT/W.003"
                }
            ],
            "ocid": "ocds-afalqw-001",
            "id": "5c10b8c57e0a947f6b212f58-003",
            "initiationType": "tender",
            "date": "2018-10-10T16:48:09+04:30",
            "tag": [
                "implementationUpdate"
            ],
            "parties": [
                {
                    "identifier": {
                        "scheme": "AF-TIN",
                        "id": "9000321217",
                        "legalName": "\u0634\u0631\u06a9\u062a \u0633\u0627\u062e\u062a\u0645\u0627\u0646\u06cc \u067e\u0631\u06cc\u0645\u0648\u0633"
                    },
                    "id": "AF-TIN-9000321217",
                    "roles": [
                        "payee",
                        "supplier"
                    ],
                    "name": "Primus Construction Company"
                },
                {
                    "name": "Ministry of Finance",
                    "roles": [
                        "payer"
                    ],
                    "address": {
                        "countryName": "\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646",
                        "region": "\u0645\u0631\u06a9\u0632"
                    },
                    "identifier": {
                        "scheme": "AF-COA",
                        "id": "20",
                        "legalName": "\u0648\u0632\u0627\u0631\u062a \u0645\u0627\u0644\u06cc\u0647"
                    },
                    "id": "AF-COA-20"
                }
            ]
        }
    ]
}