HL7 OSP Occurrence Span Code and Date
HL7 datatype components OSP components from HL7 v2.5.1 Hide components
These are the generated components for the version selected at the top of the page. The article stays practical, and this panel follows the chosen HL7 version.
Components
OSP combines an occurrence span code with dates. It is used in billing-style workflows where a coded span and a date range have to travel together.
In this guide, OSP appears in UB2.8. That used-by list is a good reality check: the datatype is only half the story, and the field that uses it tells you the workflow.
The component panel above is expanded by default because most datatype pages are used as quick lookup pages. Start there for the exact HL7 v2.5.1 shape, then use the notes below for the practical gotchas.
OSP-1 to OSP-3: Component Quick Read
The generated component panel above is the formal quick lookup. The short version is below so you can scan the shape without counting carets by eye.
The table-backed components here are OSP-1. Keep those values to the table or value set your implementation guide names, especially when the field is crossing organization boundaries.
- OSP-1 Occurrence Span Code - Occurrence Span Code. Type CNE. Table 0351.
- OSP-2 Occurrence Span Start Date - Occurrence Span Start Date. Type DT.
- OSP-3 Occurrence Span Stop Date - Occurrence Span Stop Date. Type DT.
Practical Notes
Date and time precision matters. If you only know the date, send the date. If you know the time and timezone, agree how that timezone should be represented. In Integration Soup, date helpers such as GetHL7Date and GetDateFromHL7Date are useful because they keep date formatting and parsing explicit instead of hand-built string slicing.
In HL7 Soup Web, click a field that uses OSP and the interpretation view will show which component you are sitting in and where that value lives in the raw message. That is especially handy with compact datatypes because one missing caret can move every value after it.
Official and Reference Notes
For formal reference, compare the generated HL7 v2.5.1 panel above with the HL7 v2.5.1 datatype list and the HL7 Terminology data type code system. Local implementation guides can narrow allowed values, tables, and component usage.