Data Description
Optical Headquarters HQ (Contractor) - An Optical Contractor will hold one or more General Ophthalmic Services (GOS) contract(s) for the provision of primary ophthalmic services or could be a non-contract supplier who accepts vouchers towards the cost of glasses. Every optical supplier needs an ODS code, whether they have a GOS contract or not.
ODS Optical Headquarters and Optical Site codes are required/issued for:-
- General Ophthalmic Services (premises based and domiciliary)
- Special Schools Eye Care Services
- Community Eye Care Services
- Private Optometrists
- Isle of Man primary care optical services
- Optical sites in Scotland (with an England based HQ)
- Optical sites in Wales (with an England based HQ)
Note: Laser Eye Surgery Clinics are coded as Independent Sector Healthcare Providers and Sites, not optical providers. Hospital Eye Services are coded as NHS Trust sites.
Optical codes are used to support contract and payment processes as well as within key systems such as Electronic Referrals (eRS), NHSmail, Patient Administration Systems, Data Protection & Security Toolkit (DSPT) access etc.
How Data is Maintained
General Ophthalmic Services and Special Schools Eye Care Services
NHS England commissions all General Ophthalmic Services (GOS) in England using the General Ophthalmic Mandatory Services Model Contract. An ODS Optical Site record represents a contractor's provision of services at a location. Optical Sites are related to Optical HQs to identify the organisations that own them.
Contractual changes in the optical sector are reflected through the closure and opening of Optical Site records and their relationships to Optical HQs. GOS Contracts are issued and managed either by the NHS Business Services Authority across England. The NHS BSA Optical Contract Team feed information about contract changes to ODS, for application to the Optical data.
Special Schools Eye Care providers can be identified via the RO316 non primary role (see Key Information section below).
Community Eye Care Services
High Street Dispensing Only / Online Retailer
Can be requested and amended by NHS England Regions, NHS BSA or by the provider.
Minor Eye Conditions Services (MECS), Specialist Eye Care Services and Secondary Care Service Providers
Can be requested and amended by the relevant Integrated Care Board for that area or by the provider.
Optical Site codes are only allocated for Secondary Care Hospital Eye Services where the provider is a community eye care provider rather than an NHS Trust (where NHS Trust codes are used).
Private Optometrists
Private Optometrists will provide eye care services (sight tests and optical appliances) to private patients only (not NHS). Codes for Private Optometrists can be requested NHS England Regions or by the providers. It is possible for a provider to have previously held an NHS GOS contract and then change to be a private optometrist only, but retain their same ODS code. ODS are investigating the further use of non primary roles to identify GOS contract holders.
Data Quality Assessment
For further information re the: ODS Data Quality Assessment Framework
| Data Quality Dimension | |||||||||||
| Last updated: |
| 1 | 2 | 3 | 4 | 5 | ODS mastered or 3rd party data | 6 | 7 | 8 | 9 |
| OVERALL | Frequency of Update | Data Collection Method | Fit for Purpose | Coverage / Completeness | Reliability / Accuracy | Data Agreement | 3rd Party Escalation Routes | System Application / Downstream System Feedback | Future Refinement / Improvement Plan | ||
| Optical HQs and Optical Sites | AMBER | Green | Amber | Amber | Amber | Amber | ODS | n/a | n/a | Green | Amber |
| Ad Hoc | All requests come via the helpdesk on an ad hoc basis. Mixed - NHS BSA advise of GOS contract holders, there are multiple sources for other optical service types. | Codes created and maintained on a needs basis, but are often contract driven rather than true organisation data. | Good coverage for GOS contracts as that data is sourced from the NHS BSA but cannot be guaranteed for the remainder of the data. | The fact that data is contract driven can impact reliability of this as true 'org' data. | n/a | n/a | No known issues | Plan in place to improve data flow, including code closures and non primary roles. | |||
Optical Headquarters
Key Information - Roles, Code Formats and Data Source
| Key Information | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Geographic coverage |
| ||||||||||||||||||||||||||||
| Primary Role ID | RO166 | Primary Role Name | OPTICAL HEADQUARTERS | ||||||||||||||||||||||||||
| Non Primary Role ID | RO316 | Non Primary Role Name | SPECIAL SCHOOLS EYE CARE SERVICE PROVIDER | ||||||||||||||||||||||||||
| Raw Data Source | NHS Business Services Authority | Update Frequency | Ad-hoc | ||||||||||||||||||||||||||
| Code Format |
| ||||||||||||||||||||||||||||
Permitted Relationships
Permitted Relationships - Optical HQs can be linked to (upward): | ||||
Source Primary Role ID | Relationship Type Id | Relationship Type Name | Target Primary Role ID | Target Primary Role Name |
| RO166 | N/A | N/A | N/A | N/A |
Legacy .csv File Mapping
Click here for an explanation of the baseline data differences between legacy csv files and ODS Data Search and Export and the ODS APIs.
eopthq.csv
Primary Role / OrgTypeID – RO166
Col | Data Item | Report Alias (legacy csv) | Max Length | Mandatory | Notes |
1 | [OrganisationCode] | Organisation Code | 12 | Yes | |
2 | [OrgName] | Name | 100 | Yes | |
3 | NULL | Column 3 | |||
4 | NULL | Column 4 | |||
5 | [Address1] | Address Line 1 | 75 | Yes | |
6 | [Address2] | Address Line 2 | 75 | No | |
7 | [Address3] | Address Line 3 | 75 | No | |
8 | [Town] | Address Line 4 | 75 | Yes | |
9 | [County] | Address Line 5 | 75 |
| Change from legacy csv: As this is a legacy field, not populated for new addresses since 2018, this field within the ODS Data Search & Export tool (including pre defined reports) will not be populated. Note that the value (where populated) is available via the FHIR Organization Resource in the address.district property. |
10 | [Postcode] | Postcode | 15 | Yes | |
11 | [LegalStartDate] | Open Date | 8 | Yes | |
12 | [LegalEndDate] | Close Date | 8 | No | |
13 | NULL | Column 13 | |||
14 | NULL | Column 14 | |||
15 | NULL | Column 15 | |||
16 | NULL | Column 16 | |||
17 | NULL | Column 17 | |||
18 | NULL | Contact Telephone Number | 20 | No | Change from legacy csv: No longer populated as very limited data held, and this is not maintained. |
19 | NULL | Contact Name |
|
| Change from legacy csv: No longer populated as very limited data held, and this is not maintained. |
20 | NULL | Column 20 | |||
21 | NULL | Column 21 | |||
22 | ‘1’ | Amended Record Indicator | 1 | Yes | Set to 1 for Report |
23 | NULL | Column 23 | |||
24 | NULL | Column 24 | |||
25 | NULL | Column 25 | |||
26 | NULL | Column 26 | |||
27 | NULL | Column 27 |
Optical Sites
Key Information - Roles, Code Formats and Data Source
| Key Information | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Geographic coverage |
| ||||||||||||||||||||||||||||
| Primary Role ID | RO167 | Primary Role Name | OPTICAL SITE | ||||||||||||||||||||||||||
| Non Primary Role ID | RO316 | Non Primary Role Name | SPECIAL SCHOOLS EYE CARE SERVICE PROVIDER | ||||||||||||||||||||||||||
| Raw Data Source | Ad hoc requests from:
| Update Frequency | Ad-hoc | ||||||||||||||||||||||||||
| Code Format |
| ||||||||||||||||||||||||||||
Permitted Relationships
Permitted Relationships - Optical Sites can be linked to (upward): | ||||
Source Primary Role ID | Relationship Type Id | Relationship Type Name | Target Primary Role ID | Target Primary Role Name |
RO167 | RE3 | IS DIRECTED BY | RO179 | PRIMARY CARE TRUST |
| RE4 | IS COMMISSIONED BY | RO107 | CARE TRUST | |
| RE4 | IS COMMISSIONED BY | RO210 | NHS ENGLAND (REGION, LOCAL OFFICE) | |
| RE4 | IS COMMISSIONED BY | RO261 | STRATEGIC PARTNERSHIP | |
| RE5 | IS LOCATED IN THE GEOGRAPHY OF | RO132 | HEALTH AUTHORITY (HA) | |
| RE5 | IS LOCATED IN THE GEOGRAPHY OF | RO142 | LOCAL HEALTH BOARD | |
| RE5 | IS LOCATED IN THE GEOGRAPHY OF | RO144 | WELSH LOCAL HEALTH BOARD | |
| RE6 | IS OPERATED BY | RO166 | OPTICAL HEADQUARTERS | |
Legacy 'Parent' Mapping
Traditionally, some systems have referred to a 'parent' relationship between organisation/site records. Although 'parent' is not one of the named relationship types that ODS publish, there has previously been mappings that indicate which relationship types between specific organisation types, could be interpreted as 'parent' relationships.
The legacy parent mapping (for active org types) is shared below for information but should be used with caution.
Route: If you cannot obtain a Parent code from 'Route 1' follow subsequent routes in sequential order.
| CIM Organisation Type Code | ODS Primary Role ID | ODS Primary Role Name | Country | Country Legacy Code | Relationship Type ID | Relationship Type Name | Parent Org Type Code | Parent Primary Role ID | Parent Primary Role Name |
| OP | RO167 | OPTICAL SITE | ENGLAND | E | RE6 | IS OPERATED BY | OH | RO166 | OPTICAL HEADQUARTERS |
| OP | RO167 | OPTICAL SITE | ISLE OF MAN | M | RE6 | IS OPERATED BY | OH | RO166 | OPTICAL HEADQUARTERS |
| OP | RO167 | OPTICAL SITE | NORTHERN IRELAND | N | RE6 | IS OPERATED BY | OH | RO166 | OPTICAL HEADQUARTERS |
| OP | RO167 | OPTICAL SITE | SCOTLAND | S | RE6 | IS OPERATED BY | OH | RO166 | OPTICAL HEADQUARTERS |
| OP | RO167 | OPTICAL SITE | WALES | W | RE6 | IS OPERATED BY | OH | RO166 | OPTICAL HEADQUARTERS |
Legacy .csv File Mapping
Click here for an explanation of the baseline data differences between legacy csv files and ODS Data Search and Export and the ODS APIs.
eoptsite.csv
Primary Role / OrgTypeID – RO167
Change from legacy csv: Note that the new pre defined report for eoptsite includes records for Isle of Man, Channel Islands, Northern Ireland and Scotland, as well as England and Wales as per the legacy csv.
Col | Data Item | Report Alias (legacy csv) | Max Length | Mandatory | Notes |
1 | [OrganisationCode] | Organisation Code | 12 | Yes | |
2 | [OrgName] | Name | 100 | Yes | |
3 | [NHSER_code] | National Grouping | 12 | No | Change from legacy csv: Geographic extension of the postcode. No longer using default values for home countries, these fields will be null. |
4 | [ICB_code] | High Level Health Geography | 12 | No | Change from legacy csv: Geographic extension of the postcode. No longer using default values for home countries, these fields will be null. |
5 | [Address1] | Address Line 1 | 75 | Yes | |
6 | [Address2] | Address Line 2 | 75 | No | |
7 | [Address3] | Address Line 3 | 75 | No | |
8 | [Town] | Address Line 4 | 75 | Yes | |
9 | [County] | Address Line 5 | 75 | No | Change from legacy csv: As this is a legacy field, not populated for new addresses since 2018, this field within the ODS Data Search & Export tool (including pre defined reports) will not be populated. Note that the value (where populated) is available via the FHIR Organization Resource in the address.district property. |
10 | [Postcode] | Postcode | 15 | Yes | |
11 | [LegalStartDate] | Open Date | 8 | Yes | |
12 | [LegalEndDate] | Close Date | 8 | No | |
13 | NULL | Column 13 | |||
14 | NULL | Column 14 | |||
15 | [TargetOrgCode] | Parent Organisation Code | 12 | No | RE6 relationship – Where LegalEndDate is null, or where the relationship LegalEndDate is equal to the organisation LegalEndDate |
16 | [LegalStartDate] | Join Parent Date | 8 | No | RE6 relationship date |
17 | [LegalEndDate] | Left Parent Date | 8 | No | RE6 relationship date |
18 | NULL | Contact Telephone Number |
|
| No longer populated as very limited data held, and this is not maintained. |
19 | NULL | Contact Name |
|
| No longer populated as very limited data held, and this is not maintained. |
20 | NULL | Column 20 | |||
21 | NULL | Column 21 | |||
22 | ‘1’ | Amended Record Indicator | 1 | Yes | Set to 1 for Report |
23 | NULL | Column 23 | |||
24 | [PCO_code] | Current Care Organisation | 12 | No | Change from legacy csv: Geographic extension of the postcode |
25 | NULL | Column 25 | |||
26 | NULL | Column 26 | |||
27 | NULL | Column 27 |