Codelists

The Open Contracting Data Standard schema references a number of codelists in order to enable the interoperability of data. There are two kinds of codelist, open and closed.

An open codelist provides suggested codes, but publishers can extend these lists with new codes on the basis of consensus with other publishers, or by using a codes prefixed with ‘x_‘ to indicate that it is a local ‘eXtensions’ to the codelist.

For example, OCDS provide a list of the types of documents which may be attached to tenders, awards, contracts and milestones. However, a group of publishers may discover they have need to identify another kind of document. These publishers would not need to wait for a future version of the standard to agree upon and add a new code to an open codelist, although they should consult with the community through the mailing list and GitHub platform, and should suggest the code for formal incorporation into the codelists.

A closed codelist provides mandatory codes and publishers should only use values provided in the official list. Changes to closed codelists should take place through the governance and revision process for the schema.

Codes are case sensitive, and are generally provided as english language camelCase. Codes values should not be translated, through the OCDS team will work with publishers to provide alternative translations of code titles and definitions.

Open Codelists

Party Role

The organisations, economic operators or other participants in a contracting process are listed in the parties section. A single party may have one or more roles in the contracting process.

Code Title Description
buyer Buyer The buyer is the entity whose budget will be used to purchase the goods.
procuringEntity Procuring Entity The entity managing the procurement, which may be different from the buyer who is paying / using the items being procured.
supplier Supplier The entity awarded or contracted to provide supplies, works or services.
tenderer Tenderer All entities who submit a tender
funder Funder The funder is an entity providing money or finance for this contracting process.
enquirer Enquirer A party who has made an enquiry during the enquiry phase of a contracting process.
payer Payer A party making a payment from a transaction
payee Payee A party in receipt of a payment from a transaction
reviewBody Review Body A party responsible for the review of this procurement process. This party often has a role in any challenges made to the contract award.

Item Classification Scheme

Items should be classified using existing gazetteers and codelists, such as the EC Common Procurement Vocabulary (CPV). Open codelists are strongly preferred.

Category Code Title Description Source
  CPV EC Common Procurement Vocabulary The Common Procurement Vocabulary is a standard adopted by the Commission of the European Community, and consisting of a main vocabulary for defining the subject of a contract, and a supplementary vocabulary for adding further qualitative information. The main vocabulary, identified in OCDS by the code CPV, is based on a tree structure comprising codes of up to 9 digits (an 8 digit code plus a check digit) associated with a wording that describes the type of supplies, works or services forming the subject of the contract. Codes may be provided with or without the check digit, and consuming applications should be aware of this when processing data with CPV codes. http://simap.europa.eu/codes-and-nomenclatures/codes-cpv/codes-cpv_en.htm
  CPVS EC Common Procurement Vocabulary - Supplementary Codelists The Common Procurement Vocabulary is a standard adopted by the Commission of the European Community, and consisting of a main vocabulary for defining the subject of a contract, and a supplementary vocabulary for adding further qualitative information. The supplementary vocabulary, identified in OCDS by the code CPVS, is made up of an alphanumeric code with a corresponding wording allowing further details to be added regarding the specific nature or destination of the goods to be purchased. http://simap.europa.eu/codes-and-nomenclatures/codes-cpv/codes-cpv_en.htm
  GSIN Goods and Services Identification Number The Canadia federal government uses Goods and Services Identification Number (GSIN) codes to identify generic product descriptions for its procurement activities. The full list is published and maintained at buyandsell.gc.ca https://buyandsell.gc.ca/procurement-data/goods-and-services-identification-number
  UNSPSC United Nations Standard Products and Services Code The United Nations Standard Products and Services Code (UNSPSC) is a hierarchical convention that is used to classify all products and services. Machine readable meta-data for UNSPSC is not provided as open data: and so publishers should consider alternative classification shemes that do provide open data lookup tables wherever possible. http://www.unspsc.org/codeset-downloads
  CPC Central Product Classification The Central Product Classification (CPC) is a product classification for goods and services promulgated by the United Nations Statistical Commission. It is intended to be an international standard for organizing and analyzing data on industrial production, national accounts, trade and prices http://unstats.un.org/unsd/cr/registry/cpc-21.asp
  OKDP Russian National Classification of Products by Economic Activity (1994) Part of the unified system of classification and coding of technical, economic and social information of the Russian Federation, in use for Russian Procurement information until January 1, 2016. Superseded by OKPD http://base.consultant.ru/cons/cgi/online.cgi?req=doc;base=LAW;n=143095;fld=134;from=14052-7;rnd=0.33374630799517035
  OKPD Russian National Classification of Products by Economic Activity (2014) Part of the national standardisation system of the Russian Federation and based on harmonisation with the Statistical Classification of Products by Activity in the European Economic Community, 2008. In use from January 1 2014 http://base.consultant.ru/cons/cgi/online.cgi?req=doc;base=LAW;n=163703;fld=134;from=170864-15;rnd=0.39699640963226557

This is an open codelist, and new values may be suggested outside of the main revision process for the standard, or local codes (prefixed by x_) added by a publisher. Publishers should include details of any additional codes they use, and their definitions in their publication policy.

Unit Classification Scheme

Item quantities may be provided using an established codelist for units of measurement. Codelists may provide human-readable descriptions of units, or symbols for use in input and display interfaces.

Code Title Description
UNCEFACT UN/CEFACT Recommendation 20 Use the commmon code from the latest version of the UN/CEFACT Recommendation 20 list of ‘Codes for Units of Measure Used in International Trade’
QUDT Quantities, Units, Dimensions and Data Types Ontologies Use the [QUDT Code](http://www.qudt.org/qudt/owl/1.0.0/unit/Instances.html) value.

Organization Identifier Scheme

The Organization Identifier Scheme currently uses the codes from the International Aid Transparency Initiative ‘Organisation Registration Agency’ codelist. See the identifiers section for more information on organization identifiers

code name description category url public-database
AF-CBR Afghanistan Central Business Registry Website not yet searchable AF http://acbr.gov.af/  
AF-MOE Ministry of Economy   AF http://moec.gov.af/en  
AU-ABN Australian Business Register   AU http://abr.business.gov.au/  
AU-ACNC Australian Charities and Not-for-profits Commission   AU http://www.acnc.gov.au/ACNC/  
BD-NAB Bangladesh NGO Affairs Bureau   BD http://114.129.9.31/welcome/ngo_profile  
BE-BCE_KBO Banque Carrefour des entreprises / Kruispuntbank van ondernemingen   BE economie.fgov.be/fr/entreprises/BCE  
CA-CRA_ACR Canadian Revenue Agency / Agence du revenu du Canada CRA_ACR is legal requirement for bilingual use CA http://www.cra-arc.gc.ca/  
ES-DIR3 Common Directory of Organizational Units and Offices - DIR3 EXCEL Tables: http://administracionelectronica.gob.es/ctt/resources/Soluciones/238/Area%20descargas/Listado%20Oficinas%20AGE.xlsx?idIniciativa=238&idElemento=2745 ES http://administracionelectronica.gob.es/ctt/dir3/descargas  
ET-MFA Ministry of Foreign Affairs Charities are registered but no openly searchable database yet available. ET http://www.mfa.gov.et/  
FI-PRO Finnish Patent and Registration office   FI http://www.prh.fi/en/index.html  
FR-RCS Registre de Commerce et des Societies /Trade and Companies Register - Commercial Court Registry   FR http://www.infogreffe.fr  
GB-CHC Charity Commission   GB http://www.charity-commission.gov.uk/  
GB-COH Companies House   GB http://www.companieshouse.gov.uk/  
GB-GOV UK Government Departments Reference Numbers Codes for use by IATI for UK Government Departments. GB http://data.gov.uk/dataset/iati-organisation-identifier-for-uk-government-bodies  
GB-GOVUK UK Government Departments, Agencies & Public Bodies Use the final segment of the url (below /organisations) as the “registration number”, converting all “-” to “_”. Keep “registration number” portion all lowercase. GB https://www.gov.uk/government/organisations  
GB-NIC The Charity Commission for Northern Ireland   GB http://www.charitycommissionni.org.uk/  
GB-REV HM Revenue and Customs   GB http://www.hmrc.gov.uk/  
GB-SC Scottish Charity Register   GB http://www.oscr.org.uk/  
GB-UKPRN UK Register of Learning Providers   GB https://www.ukrlp.co.uk/  
GH-DSW Department of Social Welfare   GH    
ID-KDN Ministry Home affairs/ Kementerian Dalam Negeri NGO registration can also be done through Ministry Home affairs/ Kementerian Dalam Negeri ID http://www.kemendagri.go.id/media/filemanager/2011/02/22/d/a/daf.ormas___lsm_2010.pdf  
ID-KHH Ministry of Justice & Human Rights/ Kementerian Hukum Dan Hak Company registration is done through Ministry of Justice & Human Rights/ Kementerian Hukum Dan Hak ID http://www.kemenkumham.go.id/  
ID-KLN Ministry of Foreign affairs/ Kementerian Luar Negeri International NGO registration is done through Ministry of Foreign affairs/ Kementerian Luar Negeri ID http://www.kemlu.go.id/  
ID-PRO NGOs registered at Provinicial Level Registration for NGO in Indonesia can be done at the provincial level. Because there is regional autonomy, each provincial has different requirements. Website is just one example ID http://www.satulayanan.net/layanan/pendaftaran-lsm-atau-ormas/perizinan-lsm-atau-ormas-baru  
IE-CHY Irish Register of Charities   IE    
IE-CRO Irish CompaniesRegistration Office   IE http://www.cro.ie/  
IM-CR Isle of Man Companies Registry   IM http://www.gov.im/ded/companies/companiesregistry.xml?menuid=21615  
IM-GR Isle of Man Index of Registered Charities   IM http://www.gov.im/registries/courts/charities/  
IN-MCA Government of India, Minstry of Corporate Affairs MCA regulates corporate affairs in India through the Companies Act, 1956, 2013 and other allied Acts, Bills and Rules. IN http://www.mca.gov.in/  
KE-NCB NGO’s Coordination Board   KE http://www.ngobureau.or.ke/  
KE-RCO Registar of Companies   KE http://www.attorney-general.go.ke/  
KE-RSO Registrar of Societies   KE http://www.attorney-general.go.ke/  
LS-LCN Lesotho Council of Non Governmental Organisations   LS http://www.lcn.org.ls/  
MM-MHA Ministry of Home Affairs - Central Committee for the Registration and Supervision of Organisations The MHA assigns a registration number to each NGO - this number is time limited, for example 4 years, after which the registration is reviewed. MM No url for the ministry (as at 2/10/2013)  
MW-CNM The Council for Non Governmental Organisations in Malawi   MW http://www.congoma.mw/index.html  
MW-MRA Malawi Revenue Authority   MW http://www.mra.mw/  
MW-NBM NGO Board of Malawi There is a pdf file with a list of registered NGOs, but these do not appear to be registration numbers. New database is planned MW http://ngoboardmalawi.mw/directory.php  
MW-RG Registrar General, Department of Justice   MW    
MZ-MOJ Mozambique Ministry of Justice   MZ    
NL-KVK Kamer van Koophandel   NL http://www.kvk.nl/  
NO-BRC Brønnøysundregistrene   NO http://www.brreg.no/  
NP-CRO Company Registrar Office   NP http://www.cro.gov.np/  
NP-SWC NGO registration   NP http://www.swc.org.np/  
PK-PCP Pakistan Centre for Philanthropy The PCP Certification Programme seeks to bring transparency, accountability and good governance in the nonprofit sector in Pakistan. The first initiative of its kind in South Asia; it involves the evaluation of a nonprofit organisation on standardised parameters of internal governance, financial management and programme delivery. PK https://drive.google.com/file/d/0B67B7u-xqLazZFhHTkUtUVVRWXc/view  
SE-BLV Bolagsverket / Swedish Companies Registration Office   SE http://www.bolagsverket.se/  
SK-ZRSR Slovakia Ministry Of Interior Trade Register Most organisations (including NGOs) have to be registered with the Ministry of Interior for the Trade Register Of The Slovak Republic (Živnostensky Register Slovenskej Republiky) and are allocated a unique registration number SK http://www.zrsr.sk/default.aspx?LANG=en  
UA-EDR United State Register, Ukraine   UA http://irc.gov.ua/ua/Poshuk-v-YeDR.html  
UG-NGB NGO Board, Ministry of Internal Affairs   UG http://www.mia.go.ug/?page_id=62  
UG-RSB Registration Services Bureau   UG http://www.ursb.go.ug/  
US-DOS Corporation registration is the responsibility of each state (see link)   US http://www.companieshouse.gov.uk/links/usaLink.shtml  
US-EIN Internal Revenue Service / Employer Identification Number   US http://www.irs.gov/businesses/small/article/0,,id=98350,00.html  
US-USAGOV Index of U.S. Government Departments and Agencies Use the final segment of the url (below /federal and excluding the extension) as the “registration number”, converting all “-” to “_”. Keep “registration number” portion all lowercase. US http://www.usa.gov/directory/federal/index.shtml  
XI-IATI International Aid Transparency Initiative Organisation Identifier XI-IATI is a list of organisation identifiers that is maintained by the IATI Secretariat. Any publisher may apply to the IATI Technical Team for an identifier to be generated. XI http://iatistandard.org/codelists/IATIOrganisationIdentifier/  
XM-DAC OECD Development Assistance Committee See Donor, Agency, and Delivery Channel codes XM http://www.oecd.org/dac/stats/dacandcrscodelists.htm  
XM-OCHA United Nations Office for the Coordination of Humanitarian Affairs OCHA is the part of the United Nations Secretariat responsible for bringing together humanitarian actors to ensure a coherent response to emergencies. XM http://www.unocha.org  
ZA-CIP Companies and Intellectual Property Commission (CIPC)   ZA http://www.cipro.gov.za/  
ZA-NPO Association for Non-Profit Organisations   ZA http://www.npo.gov.za/  
ZA-PBO SA Revenue Service Tax Exemption Unit / Public Benefit Organisations   ZA http://www.sars.gov.za/home.asp?pid=170  
ZM-NRB Non Governmental Organisation Registration Board   ZM    
ZM-PCR Patents and Companies Registration Agency   ZM http://www.pacra.org.zm/  
ZW-PVO Private Voluntary Organisations Council   ZW    
ZW-ROD Registrar of Deeds   ZW    

This list can be extended in consultation with IATI.

Document Type

The following list describes documents and documentation recommended for publication as part of an open contracting implementation. The codelist indicates whether documents are considered ‘basic’, ‘intermediate’ or ‘advanced’, and the section of an OCDS release they are most likely to be applicable within.

The code descriptions are neccessarily broad, to cover their usage in a range of contracting processes, including for goods, works and services, and in other contexts, such as public private partnerships, infrastructure or concession contracts.

Implementers may wish to map their existing document codes to this list, or, if using this list within a user-interface, to re-write the codelist titles and descriptions apporiately for the context they are being used in.

This is an open codelist, and additional entries can be included with a x_ prefix.

Category Section Code Title Description
basic tender tenderNotice Tender Notice The formal notice that gives details of a tender. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.
basic award awardNotice Award Notice The formal notice that gives details of the contract award. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.
basic contract contractNotice Contract Notice The formal notice that gives details of a contract being signed and valid to start implementation. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.
basic implementation completionCertificate Completion certificate A completion certificate issued by a relevant authority providing evidence that works were completed to a certain level of quality. Completion certificates may only be relevant for particular kinds of contracting processes.
basic planning procurementPlan Procurement Plan Documentation that sets out the basis for this particular contracting process.
basic tender biddingDocuments Bidding Documents Documentation for potential suppliers, describing the goals of the contract (e.g. goods and services to be procured), and the bidding process.
basic tender technicalSpecifications Technical Specifications Detailed technical information about goods or services to be provided.
basic tender evaluationCriteria Evaluation Criteria Documentation on how bids will be evaluated.
intermediate tender evaluationReports Evaluation report Documentation on the evaluation of the bids and the application of the evaluation criteria, including the justification fo the award
intermediate tender, award contractDraft Contract draft A draft or pro-forma copy of the contract.
intermediate contract contractSigned Signed Contract A copy of the signed contract. Consider providing both machine-readable (e.g. original PDF, Word or Open Document format files), and a separate document entry for scanned-signed pages where this is required.
intermediate tender, award, contract contractArrangements Arrangements for ending contract Documentation of the arrangements for ending the contract(s).
intermediate tender, award, contract contractSchedule Schedules and milestones Documentation setting out key milestones and schedules. Structured versions of this information may be modelled using the milestones block.
intermediate implementation physicalProgressReport Physical progress reports Documentation on the status of implementation, usually against key milestones.
intermediate implementation financialProgressReport Financial progress reports Documentation providing dates and amounts of stage payments made (against total amount) and the source of those payments, including cost overruns, if any. Structured versions of this information can be provided through contract implementation transactions.
intermediate implementation finalAudit Final Audit Documentation of a final audit carried out at the end of contract implementation.
intermediate tender hearingNotice Public Hearing Notice Documentation of any public hearings that took place as part of the planning for this contracting process.
intermediate planning marketStudies Market Studies Documentation of any market studies that took place as part of the planning for this contracting process.
intermediate tender eligibilityCriteria Eligibility Criteria Detailed documents about the eligibility of bidders.
intermediate tender clarifications Clarifications to bidders questions Documentation that provides replies to issues raised in pre-bid conferences or an enquiry processes.
intermediate tender shortlistedFirms Shortlisted Firms Documentation providing information on shortlisted firms. Structured versions of this information can be provided using the bids extension.
advanced planning, implementation environmentalImpact Environmental Impact Documentation of environmental impact assessments carried out before, during or after the contracting process.
advanced planning assetAndLiabilityAssessment Assesment of government’s assets and liabilities Documentation covering assessments of the government’s assets and liabilities related to this contracting process.
advanced planning riskProvisions Provisions for management of risks and liabilities Documentation covering how risks will be managed as part of this contracting process.
advanced award winningBid Winning Bid Documentation of the winning bid, including, wherever applicable, a full copy of the proposal receieved.
advanced tender, award complaints Complaints and decisions Documentation of any complaints received, or decisions in response to complaints.
advanced contract contractAnnexe Annexes to the Contract Copies of annexes and other supporting documentation related to the contract.
advanced tender, contract contractGuarantees Guarantees Documentation of guarantees relating to a contracting process or contract.
advanced contract subContract Subcontracts Documentation detailing subcontracts and/or providing a copy of subcontracts themselves. Where OCDS data on the subcontracts exists, this can be declared using the relatedProcess block.
advanced planning needsAssessment Needs Assessment Documentation of the needs assessments carried out for this contracting process addressing demand for the project or investment from the affected communities or users.
advanced planning feasibilityStudy Feasibility study Documentation of feasibility studies carried out for this contracting process, providing information on net benefits or costs of the proposed goods, works or services.
advanced planning projectPlan Project plan Documentation of project planning for this contracting process, and, where applicable, a copy of the project plan document.
advanced tender billOfQuantity Bill Of Quantity Documentation that provides itemised information on materials, parts and labour, and the terms and conditions for their provision, providing information that would enable bidders to price work effectively. Structured versions of item and quantity information at each of tender, award and contract stage can be provided using units within the items building block.
advanced tender, bidder bidders Information on bidders Documentation on bidders or participants, their validation documents and any procedural exemptions for which they qualify
advanced tender, award, contract, implementation conflictOfInterest Conflict of Interest Documentation of conflicts of interest declared or uncovered.
advanced implementation debarments Debarments Documentation of any debarments issued.
advanced tender, bid, contract, implementation illlustration Illustrations Images intended to provide supporting information. The url for images should generally be directly to an image file which applications can display as part of a gallery of images. At the tender stage, images may be illustrations of goods, works or services required or for sale. At the implementation stage, images may be illlustrations or visual evidence of physical progress.
advanced bid, award, contract submissionDocuments Bid Submission Documents Documentation submitted by a bidder as part of their proposal.
advanced contract contractSummary Contract Summary Documentation providing an overview of the key terms and sections of the contract. Commonly used for large and complex contracts.
advanced tender, award, contract, implementation cancellationDetails Cancellation Details Documentation the arrangements, or reasons, for cancellation of a contracting process, award or specific contract.

Award Criteria

The award criteria code list describes the basis on which contract awards will be made.

Note

This codelist was revised in OCDS 1.1, deprecating earlier codes and introducing a new set of codelist entries. Publishes may need to review the mapping from their internal systems to this updated list of award criteria.

Code Title Description Deprecated
priceOnly Price only The award will be made to the qualified bid with the lowest price.  
costOnly costOnly The award will be made to the qualified bid demonstrating the lowest overall cost. A cost assessment could cover the entire monetary implications of the proposal, including the price paid to the supplier and the running costs, switching costs or other non-price costs of choosing a particular option.  
qualityOnly Quality Only The award will be made to the qualified bid demonstrating the highest quality against some assessment method. The price is either fixed, or with a maximum set and price factors not included in the evaluation.  
ratedCriteria Rated Criteria The award will be made to the qualified bid demonstrating the highest score against a set of weighted criteria such as price, cost and quality (including, for example, the environmental and social impact of the procurement). Structured information on individual qualifying criteria can be provided with the requirements extension.  
lowestCost Lowest Cost This code has been deprecated. Please choose from one of the other codes. 1.1
bestProposal Best Proposal This code has been deprecated. Please choose from one of the other codes. 1.1
bestValueToGovernment Best Value to Government This code has been deprecated. ‘Rated criteria’ is a likely alternatives for most procedures formerly mapped to this code. 1.1
singleBidOnly Single Bid Only This code has been deprecated. Please choose from one of the other codes. 1.1

This is an open codelist, and new values may be suggested outside of the main revision process for the standard, or local codes (prefixed by x_) added by a publisher. Publishers should include details of any additional codes they use, and their definitions in their publication policy.

Submission Method

The submission method codelist is used to identify the mechanism through which a submission may be made.

Code Title Description
electronicSubmission Electronic Submission Bids will be recieved through an electronic procurement platform.
electronicAuction Electronic Auction Bids will be recieved through an electronic auction platform.
written Written Bids will be recieved via written documents, delivered as hard copies, via generic e-mail systems, or some similar mechanism.
inPerson In Person Bids will only be recieved if they are hand delivered at the time and place specified in submissionMethodDetails or attached documentation.

This is an open codelist, and new values may be suggested outside of the main revision process for the standard, or local codes (prefixed by x_) added by a publisher. Publishers should include details of any additional codes they use, and their definitions in their publication policy.

Milestone Type

The milestone block can be used to represent a wide variety of events in the lifetime of a contracting process. The milestone type codelist is used to indicate the nature of each milestone.

Code Title Description
planning Planning milesones For events during the planning phase of a process.
engagement Engagement milestones For engagement milestones, such as a public hearing.
adjudication Adjudication milestones For adjudication milestones, such as the meeting date of a committee.
delivery Delivery milestones For delivery milestones, such as the date when a good or service should be provided.
reporting Reporting milestones For reporting milestones, such as when key reports should be provided.

Extended Procurement Category

The extended procurement category codelist is used to provide additional detail about the focus of a contracting process.

Code Title Description
goods Goods and supplies This contracting process involves physical or electronic goods or supplies
works Works This contracting process involves construction, repair, rehabilitation, demolition, restoration or maintenance of some asset or infrastructure.
services Services This contracting process involves professional services of some form, generally contracted for on the basis of measurable outputs or deliverables. When the consultingServices code is also available or in use for data from a particular dataset, the service code must only be used for non-consulting services.
consultingServices Consulting Services This contracting process involves professional services provided on a consultancy basis.

Closed Codelists

Release Tag

A contracting process may result in a number of releases of information over time. These should be tagged to indicate the stage of the contracting process they relate to.

Code Title Description
planning Planning A contracting process is proposed or planned. Information in the tender section describes the proposed process. The tender.status field should be used to identify whether the planning is at an early pipeline stage, or whether there are detailed plans for a tender developed.
planningUpdate Planning Update Details of a proposed or planned contracting process are being updated. This may include addition of information and documents from consultation engagement activities, revised details or timelines for a proposed contracting process, or a tender.status update to indicate that a pipeline proposal has been withdrawn.
tender Tender Providing information about a new tender (call for proposals) process. Tender release should contain details of the goods or services being sought.
tenderAmendment Tender Amendment An amendment to an existing tender release. There should be at least one tender release with the same ocid, but an earlier releaseDate, before a tenderAmendment is published. The term amendment has legal meaning in many jurisdictions.
tenderUpdate Tender Update An update to an existing tender release. There should be at least one tender release with the same ocid, but an earlier releaseDate, before a tenderUpdate is published. An update may add new information or make corrections to prior published information. It should not be used for formal legal amendments to a tender, for which the tenderAmendment tag should be used.
tenderCancellation Tender Cancellation The cancellation of an existing tender. There should be at least one release with the same ocid, but an earlier releaseDate, which provides details of the tender being cancelled.
award Award Providing information about the award of a contract. The tender section may be populated with details of the process leading up to the award, and one or more award sections will be present.
awardUpdate Award Update An update to an existing award release. There should be at least one award release with the same ocid, but an earlier releaseDate before an awardUpdate is published. An update may add new information or make corrections.
awardCancellation Award Cancellation Providing information about the cancellation of an award.
contract Contract Providing information about the details of a contract that has been, or will be, entered into. The tender section may be populated with details of the process leading up to the contract, and the award section may contain details of the award on the basis of which this contract will be signed.
contractUpdate Contract Update Providing information about updates to a contract. There should be at least one contract release with the same ocid, but an earlier releaseDate, before a contractUpdate is published. An update may add new information or make corrections to prior published information. It should not be used for formal legal amendments to a contract, for which the contractAmendment tag should be used.
contractAmendment Contract Amendment An amendment to an existing contract release. There should be at least one contract release with the same ocid, but an earlier releaseDate, before a contractAmendment is published. The term amendment has legal meaning in many jurisdictions.
implementation Implementation Providing new information on the implementation of a contracting process.
implementationUpdate Implementation Update Updating existing information provided about the implementation of a contracting process.
contractTermination Contract Termination Providing information at the end of a contracting process.
compiled Compiled record This tag is used only in compiled records, which have merged together multiple releases to provide a snapshot view of the contract, and a version history.

Initiation Type

Contracting processes may be formed under a number of different processes. Currently, only ‘tender’ is supported in this codelist. Future versions of the standard may support other Initiation Types. The initiation type may be provide information to consuming applications on the different blocks of data and releases they should expect from a contracting process.

Category Code Title Description Source
  tender Tender An open competitive bidding or tendering to form contracts. The process generally involves publicly inviting prospective contractors to submit bids for evaluation and selecting a winner or winners.  

Tender Status

The tender.status field is used to indicate the current status of a tender process. The following options are available:

Code Title Description
planning planning A future contracting process is being considered. Early information about the process may be provided in the tender section. A process with this status may provide information on early engagement or consultation opportunities, during which the details of a subsequent tender can be shaped.
planned Planned A contracting process is scheduled, but is not yet taking place. Details of the anticipated dates may be provided in the tender block.
active Active A tender process is currently taking place.
cancelled Cancelled The tender process has been cancelled.
unsuccessful Unsuccessful The tender process was unsucessful.
complete Complete The tender process is complete.
withdrawn Withdrawn No further information on this process is available under this ocid.

Note

The ‘planning’ status was introduced in version 1.1.

Method

A contracting process aims to fulfil the requirements identified at the planning stage. The procurement method is the procedure used to purchase the relevant works, goods or services. The method codelist draws upon the definitions of open, selective and limited provided by the WTO Government Procurement Agreement, and adds an additional ‘direct’ code for awards without competition.

Code Title Description
open Open All interested suppliers may submit a tender.
selective Selective Only qualified suppliers are invited to submit a tender.
limited Limited The procuring entity contacts a number of suppliers of its choice.
direct Direct The contract is awarded to a single supplier without competition.

Note: The ‘direct’ code was introduced in Version 1.1. Publishers who completed a codelist mapping prior to 1.1 may have included direct procurement within limited, and may need to review their mappings.

Procurement Category

The procurement category codelist is used to indicate the primary focus of a contracting process. Where a contracting process covers more than one of the options below, publishers can use the additionalProcurementCategories field with an array of entries from the open extendedProcurementCateory codelist.

Code Title Description
goods Goods and supplies The primary object of this contracting process involves physical or electronic goods or supplies.
works Works The primary object of this contracting process involves construction, repair, rehabilitation, demolition, restoration or maintenance of some asset or infrastructure.
services Services The primary object of this contracting process involves professional services of some form, generally contracted for on the basis of measurable outputs or deliverables.

Award Status

An award move through multiple states. Releases over time may update the status of an award.

Category Code Title Description Source
  pending Pending This award has been proposed, but is not yet in force. This may be due to a cooling off period, or some other process.  
  active Active This award has been made, and is currently in force.  
  cancelled Cancelled This award has been cancelled.  
  unsuccessful Unsuccessful This award could not be successfully made. If items or supplier details are included within the award section, then these narrow the scope of the unsuccessful award (i.e. the award of noted items, or an award to the noted supplier, was unsuccessful, but there may be other successful awards for different items listed in the tender, or to different suppliers).  

The awardStatus field and code-list is used to indicate when a tender did not result in an award (through the "awardStatus":"unsuccessful" value)

Contract Status

Contracts can move through multiple states. Releases over time may update the status of a contract.

Category Code Title Description Source
  pending Pending This contract has been proposed, but is not yet in force. It may be awaiting signature.  
  active Active This contract has been signed by all the parties, and is now legally in force.  
  cancelled Cancelled This contract has been cancelled prior to being signed.  
  terminated Terminated This contract was signed and in force, and has now come to a close. This may be due to successful completion of the contract, or may be early termination due to some non-completion.  

Currency

The currency for each amount should always be specified using the uppercase 3-letter currency code from ISO4217.

A full list is available from the ISO.

Milestone Status

Code Title Description
scheduled Scheduled This milestone has been scheduled for the date in milestone.dueDate. Progress towards the milestone has not yet been evaluated as of milestone.dateModified
met Met This milestone has been achieved. The data on which it was met should be placed in the milestone.dateMet field
notMet Not Met This milestone had not been met at the date it was last reviewed (see milestone.dateModified).
partiallyMet Partially Met This milestone was judged to have been partially met at the date it was last reviewed (see milestone.dateModified)