Pipeline notice fields
The downloads and tables below describe the requirements for data providers when sending pipeline notices to Find a Tender.
Edits and withdrawals
- To edit a notice, include previousNotice and tender/status "planning"
- To withdraw a notice (where the buyer will not proceed with the procurement), include previousNotice and tender/status "withdrawn"
- Do not include previousNotice in new, standalone notices
Reception XML schema downloads
Sample XML
| Field name | Description | XML tag | Example value | Min:Max occurrences | Pattern | Max length |
|---|---|---|---|---|---|---|
| Previous notice | ID of notice to edit/withdraw | previousNotice | 0:1 | .*[^\s].* | 200 | |
| Parties | See Parties | parties | 1:10000 | |||
| Buyer ID | Party ID of the main buyer | buyer/id | GB-CHC-123456 | 1:1 | [A-Za-z0-9()-_=+\[\];:,./]*[A-Za-z0-9]+[A-Za-z0-9()-_=+\[\];:,./]* | 250 |
| Funder ID | Party ID of the funder | planning/budget/finance/financingParty/id | GB-CHC-123456 | 0:1 | [A-Za-z0-9()-_=+\[\];:,./]*[A-Za-z0-9]+[A-Za-z0-9()-_=+\[\];:,./]* | 250 |
| Funding arrangement description | planning/budget/finance/description | Funded under section 1 of project XYZ. | 0:1 | ([.\s]*\S+[.\s]*)+ | 4000 | |
| Tender | See Tender | tender | 1:1 | |||
| Related processes | See Related processes | relatedProcesses | 0:2 |
| Field name | Description | XML tag | Example value | Min:Max occurrences | Pattern | Max length |
|---|---|---|---|---|---|---|
| Name | Organisation name | name | Cabinet Office | 1:1 | .*[^\s].* | 300 |
| ID | Used to refer to party from elsewhere in XML | id | GB-CHC-123456 | 1:1 | [A-Za-z0-9()-_=+\[\];:,./]*[A-Za-z0-9]+[A-Za-z0-9()-_=+\[\];:,./]* | 250 |
| Register ID | Code from org-id.guide | identifier/scheme | GB-CHC | 0:1 | (GB-COH|GB-CHC|GB-SC|GB-NIC|GB-NHS|GB-UKPRN|GB-MPR|GG-RCE|JE-FSC|IM-CR) | |
| Register name | Can be provided where a register ID is not allowed by the schema | identifier/schemeEntered | New Register | 0:1 | .*[^\s].* | 200 |
| Identifier | Identifier for the organisation on the specified register | identifier/id | 001234 | 0:1 | [A-Za-z0-9()-_=+\[\];:,./]*[A-Za-z0-9]+[A-Za-z0-9()-_=+\[\];:,./]* | 200 |
| Justification | Mandatory justification for not providing an identifier | identifier/noIdentifierRationale | soleTrader | 0:1 | (partnership|soleTrader|notOnAnyRegister) | |
| Street address | Mandatory for main buyer | address/streetAddress | Trade Centre, 1 High Street | 0:1 | .*[^\s].* | 400 |
| Town/city | address/locality | Newport, Isle of Wight | 1:1 | .*[a-zA-Z].* | 100 | |
| NUTS code | address/region | UKI32 | 1:1 | See nuts_codes_2021.xsd | ||
| Postcode | Mandatory for main buyer | address/postalCode | W1A 1AA | 0:1 | .*[^\s].* | 20 |
| Country | ISO 3166-1 alpha-2 code for country - use GB for United Kingdom | address/countryCode | GB | 1:1 | See countries.xsd | |
| Contact name | contactPoint/name | John Johnson | 0:1 | .*[^\s].* | 300 | |
| contactPoint/email | JohnJohnson@example.com | 0:1 | [A-Za-z0-9!#$%&''*+/=?_-]+(\.[A-Za-z0-9!#$%&''*+/=?_-]+)*@([A-Za-z0-9]([A-Za-z0-9_-]*[A-Za-z0-9])?\.)+([A-Za-z]{2,}) | 250 | ||
| Telephone | contactPoint/telephone | (020) 1234 5678 | 0:1 | ((\+[1-9]([\d \.()-]*\d+)?)|([\d \.()-]*\d+)) | 100 | |
| Roles | Role of party in this procurement | roles | buyer | 1:10 | (buyer|funder|procuringEntity|supplier) | |
| Business area | Part of the organisation involved in this procurement | details/businessArea | Procurement Operations | 0:1 | .*[^\s].* | 300 |
| Website | Organisation's main website - mandatory for main buyer | details/url | https://www.gov.uk/government/organisations/cabinet-office | 0:1 | (((http|HTTP|https|HTTPS|ftp|FTP|ftps|FTPS|sftp|SFTP)://)|((w|W){3}(\d)?\.))[\w\?!\./:;,\-_=#+*%@"\(\)&]+ | 250 |
| Field name | Description | XML tag | Example value | Min:Max occurrences | Pattern | Max length |
|---|---|---|---|---|---|---|
| Reference | Buyer's reference for the procurement | id | DN123456 | 1:1 | [A-Za-z0-9()-_=+\[\];:,./]*[A-Za-z0-9]+[A-Za-z0-9()-_=+\[\];:,./]* | 250 |
| Title | title | Sample title | 1:1 | .*[^\s].* | 400 | |
| Description | description | Example description. | 1:1 | ([.\s]*\S+[.\s]*)+ | 10000 | |
| Status | status | planning | 1:1 | (planning|withdrawn) | ||
| Suitable for SMEs? | Whether this procurement is suitable for small and medium-sized enterprises | suitability/sme | true | 1:1 | (true|false) | |
| Suitable for VCSEs? | Whether this procurement is suitable for voluntary, community and social enterprises | suitability/vcse | true | 1:1 | (true|false) | |
| Contract location | items/deliveryAddresses/region | UKI32 | 1:1 | See nuts_codes_2021.xsd | ||
| Maximum contract value excluding VAT | value/amount | 200000 | 1:1 | \d{1,13}(\.\d{2})? | ||
| Currency | value/currency | GBP | 1:1 | See currencies.xsd | ||
| Procurement method | Classification as defined by the WTO GPA | procurementMethod | open | 0:1 | (open|selective|limited|direct) | |
| Procurement method details | Name of the procedure | procurementMethodDetails | Open procedure | 0:1 | (Open procedure|Call-off from a framework agreement|Call-off from a dynamic purchasing agreement|Restricted procedure|Competitive procedure with negotiation|Competitive dialogue|Innovation partnership|Procedure involving negotiations|Negotiated procedure with prior call for competition|Negotiated) | |
| Contract type | mainProcurementCategory | works | 1:1 | (goods|works|services) | ||
| Procurement start date | tenderPeriod/startDate | 2022-05-01T00:00:00+01:00 | 1:1 | YYYY-MM-DDThh:mm:ssTZD | ||
| Contract start date | contractPeriod/startDate | 2023-01-01T00:00:00Z | 1:1 | YYYY-MM-DDThh:mm:ssTZD | ||
| Contract end date | contractPeriod/endDate | 2023-01-01T00:00:00Z | 1:1 | YYYY-MM-DDThh:mm:ssTZD | ||
| Includes options? | Whether the buyer has the option to make additional purchases | hasOptions | true | 0:1 | (true|false) | |
| Options description | options/description | Option to buy additional 100 items. | 0:1 | ([.\s]*\S+[.\s]*)+ | 5000 | |
| Subject to renewal? | Whether the contract can be renewed | hasRenewal | true | 0:1 | (true|false) | |
| Renewal description | renewal/description | Maximum 2 renewals of 6 months each. | 0:1 | ([.\s]*\S+[.\s]*)+ | 5000 | |
| Main CPV scheme | Fixed value "CPV" for classification scheme | classification/scheme | CPV | 1:1 | (CPV) | |
| Main CPV code | Main classification of this procurement | classification/id | 45000000 | 1:1 | See cpv_codes.xsd | |
| Additional CPV scheme | "CPV" for 8-digit CPV code, "CPVS" for 8+4 CPV and supplementary code combination | additionalClassifications/scheme | CPVS | 1:1 | (CPV|CPVS) | |
| Additional CPV code | Additional classifications of this procurement | additionalClassifications/id | 37530000 or 45000000-EA01 | 1:1 | [0-9]{8}(-[A-Z]{2}[0-9]{2})? | |
| Covered by GPA? | If true then set to "GPA", if false then leave out | coveredBy | GPA | 0:1 | (GPA) | |
| Sets up framework agreement? | Whether this procurement sets up a framework agreement (not a call-off) | techniques/hasFrameworkAgreement | true | 1:1 | (true|false) | |
| Sets up DPS? | Whether this procurement sets up a dynamic purchasing system (not a call-off) | techniques/hasDynamicPurchasingSystem | true | 1:1 | (true|false) |
| Field name | Description | XML tag | Example value | Min:Max occurrences | Pattern | Max length |
|---|---|---|---|---|---|---|
| Relationship | How the related process relates to the new procurement - use framework for framework and DPS call-offs, use prior and reprocurementX for previous awards | relationship | framework | 1:2 | (framework|prior|reprocurementSameScope|reprocurementDifferentScope) | |
| Title | title | Sample title | 1:1 | .*[^\s].* | 400 | |
| Related scheme | Fixed value "ocid" | scheme | ocid | 0:1 | (ocid) | |
| Related identifier | ocid of the related procurement | identifier | ocds-ba1345-Eabc4 | 0:1 | ocds-[A-Za-z0-9]{6}-[A-Za-z0-9-]*[A-Za-z0-9]+ | 200 |
| Related URI | Link to data on the related procurement in OCDS JSON format | uri | https://www.example.com/ocds-1T345-12E4 | 0:1 | (((http|HTTP|https|HTTPS|ftp|FTP|ftps|FTPS|sftp|SFTP)://)|((w|W){3}(\d)?\.))[\w\?!\./:;,\-_=#+*%@"\(\)&]+ | 250 |
| Parties | Include parties to previous procurements in relatedProcesses instead of at the top level - with roles "supplier" for awards, or "procuringEntity" for framework/DPS provider. See Parties | parties | 0:10000 | |||
| Reference used for the related procurement | ID of related tender | tender/id | 101010 | 0:1 | .*[^\s].* | 100 |
| Previous contract end date | Only for previous awards | tender/contractPeriod/endDate | 2022-06-01T00:00:00+01:00 | 0:1 | YYYY-MM-DDThh:mm:ssTZD | |
| Lot | Only for framework/DPS call-offs - the framework/DPS lot that is being used | lot | Lot 1. Internal audit and assurance | 0:1 | .*[^\s].* | 100 |
| Document ID | An official notice about the previous procurement, framework or DPS, or the framework/DPS provider's web page about it | documents/id | notice | 1:1 | (notice|procuringEntity) | |
| Documents URL | documents/url | https://www.find-tender.service.gov.uk/Notice/000000-2022 | 1:1 | (((http|HTTP|https|HTTPS|ftp|FTP|ftps|FTPS|sftp|SFTP)://)|((w|W){3}(\d)?\.))[\w\?!\./:;,\-_=#+*%@"\(\)&]+ | 250 | |
| Framework stage | Procurement stage of the linked notice about the setting up of the related framework or DPS | frameworkStage | planning | 0:1 | (planning|tender|award) |