Workflow
This
page
is
part
of
the
FHIR
Specification
(v5.0.0:
R5
-
STU
v6.0.0-ballot3:
Release
6
Ballot
(3rd
Draft)
(see
Ballot
Notes
).
This
is
the
The
current
published
version
in
it's
permanent
home
(it
will
always
be
available
at
this
URL).
is
5.0.0
.
For
a
full
list
of
available
versions,
see
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R2
|
Orders
and
Observations
Work
Group
|
Maturity Level : 3 | Trial Use | Security Category : Patient | Compartments : Encounter , Patient , Practitioner |
An authorization for the provision of glasses and/or contact lenses to a patient.
The
VisionPrescription
resource
is
intended
to
support
the
information
requirements
represents
an
authorization
for
corrective
optical
lenses
to
be
provided
to
a
prescription
for
patient.
Eye
glasses
and
contact
lenses
for
a
patient.
Corrective
optical
lenses
are
considered
a
controlled
substance
and
therefore
usually
require
a
prescription
is
typically
required
for
the
provision
of
patient-specific
lenses.
Details
about
the
fulfillment
of
the
authorization
are
handled
by
the
Task
resource.
For
further
information
about
this
separation
of
responsibilities,
refer
to
the
link
Fulfillment/Execution
section
of
the
Request
pattern.
Vision prescriptions may only be issued by providers who have optical diagnosis within their scope of practice, typically ophthalmologists and optometrists. The prescription is a time-limited, typically two years, authorization for the provision of an unlimited number of lenses, glasses or contacts, which conform to the authorized specification by providers which have lens provision within their scope of practice, typically ophthalmologists , optometrists and opticians.
Health insurers typically require a copy of the prescription to ensure that a vision professional has examined the patient and that the power of the lenses exceeds some minimum, such as +- 0.75 diopters, to qualify for reimbursement under the insurance coverage.
The VisionPrescription resource is an "request" resource from a FHIR workflow perspective - see Workflow Request.
Additional information regarding resources conveying electronic claims content and usage may be found at:
The VisionPrescription resource is used to provide the authorized specification of lenses for glasses and contacts which have well known and internationally consistent requirements, which is distinct from other types of health care authorizations detailed below.
The health care domain includes a number of related resources| VisionPrescription | The VisionPrescription resource is used to provide the authorized specification of lenses for glasses and contacts. |
| DeviceRequest | This resource is used to prescribe, authorize, and request provision of a health care device such as a halter monitor or a wheelchair services. |
| MedicationRequest | This resource is used to prescribe, authorize, and request provision of medications such a pharmaceuticals and vaccines. |
| ServiceRequest | This resource is used to prescribe, authorize, and request provision of health care services such as consultative or rehabilitative services. |
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
VisionPrescription
|
TU | DomainResource |
Prescription
for
vision
correction
products
for
a
patient
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
identifier
|
0..* | Identifier |
Business
Identifier
for
vision
prescription
|
|
basedOn
|
Σ | 0..* | Reference ( CarePlan | RequestOrchestration | NutritionOrder | ServiceRequest ) |
What
prescription
fulfills
|
status
| ?! Σ | 1..1 | code |
active
|
cancelled
|
draft
|
entered-in-error
Binding: Financial Resource Status Codes ( Required ) |
|
created
|
Σ | 1..1 | dateTime |
Response
creation
date
|
|
patient
|
Σ | 1..1 | Reference ( Patient ) |
Who
prescription
is
for
|
|
encounter
|
0..1 | Reference ( Encounter ) |
Created
during
encounter
/
admission
/
stay
|
|
|
dateWritten
|
Σ | 1..1 | dateTime |
When
prescription
was
authorized
|
|
prescriber
|
Σ | 1..1 | Reference ( Practitioner | PractitionerRole ) |
Who
authorized
the
vision
prescription
|
lensSpecification
|
Σ | 1..* | BackboneElement |
Vision
lens
authorization
|
product
|
Σ | 1..1 | CodeableConcept |
Product
to
be
supplied
Binding: Example Vision Prescription Product Codes ( Example ) |
|
eye
|
Σ | 1..1 | code |
right
|
left
Binding: Vision Eyes ( Required ) |
|
sphere
|
0..1 | decimal |
Power
of
the
lens
|
|
|
cylinder
|
0..1 | decimal |
Lens
power
for
astigmatism
|
|
|
axis
|
0..1 | integer |
Lens
meridian
which
contain
no
power
for
astigmatism
|
|
prism
|
0..* | BackboneElement |
Eye
alignment
compensation
|
|
amount
|
1..1 | decimal |
Amount
of
adjustment
|
|
base
|
1..1 | code |
up
|
down
|
in
|
out
Binding: Vision Base ( Required ) |
|
|
add
|
0..1 | decimal |
Added
power
for
multifocal
levels
|
|
|
power
|
0..1 | decimal |
Contact
lens
power
|
|
|
backCurve
|
0..1 | decimal |
Contact
lens
back
curvature
|
|
|
diameter
|
0..1 | decimal |
Contact
lens
diameter
|
|
|
duration
|
0..1 | SimpleQuantity |
Lens
wear
duration
|
|
|
color
|
0..1 | string |
Color
required
|
|
|
brand
|
0..1 | string |
Brand
required
|
|
|
note
|
0..* | Annotation |
Notes
for
coatings
|
|
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
UML Diagram ( Legend )
XML Template
<VisionPrescription xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Business Identifier for vision prescription --></identifier> <basedOn><!-- 0..* Reference(CarePlan|NutritionOrder|RequestOrchestration| ServiceRequest) What prescription fulfills --></basedOn> <status value="[code]"/><!-- 1..1 active | cancelled | draft | entered-in-error --> <created value="[dateTime]"/><!-- 1..1 Response creation date --> <patient><!-- 1..1 Reference(Patient) Who prescription is for --></patient> <encounter><!-- 0..1 Reference(Encounter) Created during encounter / admission / stay --></encounter> <dateWritten value="[dateTime]"/><!-- 1..1 When prescription was authorized --> <prescriber><!-- 1..1 Reference(Practitioner|PractitionerRole) Who authorized the vision prescription --></prescriber> <lensSpecification> <!-- 1..* Vision lens authorization --> <product><!-- 1..1 CodeableConcept Product to be supplied --></product> <eye value="[code]"/><!-- 1..1 right | left --> <sphere value="[decimal]"/><!-- 0..1 Power of the lens --> <cylinder value="[decimal]"/><!-- 0..1 Lens power for astigmatism --> <axis value="[integer]"/><!-- 0..1 Lens meridian which contain no power for astigmatism --> <prism> <!-- 0..* Eye alignment compensation --> <amount value="[decimal]"/><!-- 1..1 Amount of adjustment --> <base value="[code]"/><!-- 1..1 up | down | in | out --> </prism> <add value="[decimal]"/><!-- 0..1 Added power for multifocal levels --> <power value="[decimal]"/><!-- 0..1 Contact lens power --> <backCurve value="[decimal]"/><!-- 0..1 Contact lens back curvature --> <diameter value="[decimal]"/><!-- 0..1 Contact lens diameter --> <duration><!-- 0..1 Quantity(SimpleQuantity) Lens wear duration --></duration> <color value="[string]"/><!-- 0..1 Color required --> <brand value="[string]"/><!-- 0..1 Brand required --> <note><!-- 0..* Annotation Notes for coatings --></note> </lensSpecification> </VisionPrescription>
JSON Template
{
"resourceType" : "VisionPrescription",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Business Identifier for vision prescription
"basedOn" : [{ Reference(CarePlan|NutritionOrder|RequestOrchestration|
ServiceRequest) }], // What prescription fulfills
"status" : "<code>", // R! active | cancelled | draft | entered-in-error
"created" : "<dateTime>", // R! Response creation date
"patient" : { Reference(Patient) }, // R! Who prescription is for
"encounter" : { Reference(Encounter) }, // Created during encounter / admission / stay
"dateWritten" : "<dateTime>", // R! When prescription was authorized
"prescriber" : { Reference(Practitioner|PractitionerRole) }, // R! Who authorized the vision prescription
"lensSpecification" : [{ // R! Vision lens authorization
"product" : { CodeableConcept }, // R! Product to be supplied
"eye" : "<code>", // R! right | left
"sphere" : <decimal>, // Power of the lens
"cylinder" : <decimal>, // Lens power for astigmatism
"axis" : <integer>, // Lens meridian which contain no power for astigmatism
"prism" : [{ // Eye alignment compensation
"amount" : <decimal>, // R! Amount of adjustment
"base" : "<code>" // R! up | down | in | out
}],
"add" : <decimal>, // Added power for multifocal levels
"power" : <decimal>, // Contact lens power
"backCurve" : <decimal>, // Contact lens back curvature
"diameter" : <decimal>, // Contact lens diameter
"duration" : { Quantity(SimpleQuantity) }, // Lens wear duration
"color" : "<string>", // Color required
"brand" : "<string>", // Brand required
"note" : [{ Annotation }] // Notes for coatings
}]
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .
Changes from both R4 and R4B
| VisionPrescription | |
| VisionPrescription.basedOn |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
VisionPrescription
|
TU | DomainResource |
Prescription
for
vision
correction
products
for
a
patient
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
identifier
|
0..* | Identifier |
Business
Identifier
for
vision
prescription
|
|
|
basedOn
|
Σ | 0..* | Reference ( CarePlan | RequestOrchestration | NutritionOrder | ServiceRequest ) |
What
prescription
fulfills
|
|
status
| ?! Σ | 1..1 | code |
active
|
cancelled
|
draft
|
entered-in-error
Binding: Financial Resource Status Codes ( Required ) |
|
created
|
Σ | 1..1 | dateTime |
Response
creation
date
|
|
patient
|
Σ | 1..1 | Reference ( Patient ) |
Who
prescription
is
for
|
|
encounter
|
0..1 | Reference ( Encounter ) |
Created
during
encounter
/
admission
/
stay
|
|
|
dateWritten
|
Σ | 1..1 | dateTime |
When
prescription
was
authorized
|
|
prescriber
|
Σ | 1..1 | Reference ( Practitioner | PractitionerRole ) |
Who
authorized
the
vision
prescription
|
|
lensSpecification
|
Σ | 1..* | BackboneElement |
Vision
lens
authorization
|
|
product
|
Σ | 1..1 | CodeableConcept |
Product
to
be
supplied
Binding: Example Vision Prescription Product Codes ( Example ) |
|
eye
|
Σ | 1..1 | code |
right
|
left
Binding: Vision Eyes ( Required ) |
|
sphere
|
0..1 | decimal |
Power
of
the
lens
|
|
|
cylinder
|
0..1 | decimal |
Lens
power
for
astigmatism
|
|
|
axis
|
0..1 | integer |
Lens
meridian
which
contain
no
power
for
astigmatism
|
|
|
prism
|
0..* | BackboneElement |
Eye
alignment
compensation
|
|
|
amount
|
1..1 | decimal |
Amount
of
adjustment
|
|
|
base
|
1..1 | code |
up
|
down
|
in
|
out
Binding: Vision Base ( Required ) |
|
|
add
|
0..1 | decimal |
Added
power
for
multifocal
levels
|
|
|
power
|
0..1 | decimal |
Contact
lens
power
|
|
|
backCurve
|
0..1 | decimal |
Contact
lens
back
curvature
|
|
|
diameter
|
0..1 | decimal |
Contact
lens
diameter
|
|
|
duration
|
0..1 | SimpleQuantity |
Lens
wear
duration
|
|
|
color
|
0..1 | string |
Color
required
|
|
|
brand
|
0..1 | string |
Brand
required
|
|
|
note
|
0..* | Annotation |
Notes
for
coatings
|
|
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
XML Template
<VisionPrescription xmlns="http://hl7.org/fhir">
JSON Template
{
"resourceType" : "VisionPrescription",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Business Identifier for vision prescription
"basedOn" : [{ Reference(CarePlan|NutritionOrder|RequestOrchestration|
ServiceRequest) }], // What prescription fulfills
"status" : "<code>", // R! active | cancelled | draft | entered-in-error
"created" : "<dateTime>", // R! Response creation date
"patient" : { Reference(Patient) }, // R! Who prescription is for
"encounter" : { Reference(Encounter) }, // Created during encounter / admission / stay
"dateWritten" : "<dateTime>", // R! When prescription was authorized
"prescriber" : { Reference(Practitioner|PractitionerRole) }, // R! Who authorized the vision prescription
"lensSpecification" : [{ // R! Vision lens authorization
"product" : { CodeableConcept }, // R! Product to be supplied
"eye" : "<code>", // R! right | left
"sphere" : <decimal>, // Power of the lens
"cylinder" : <decimal>, // Lens power for astigmatism
"axis" : <integer>, // Lens meridian which contain no power for astigmatism
"prism" : [{ // Eye alignment compensation
"amount" : <decimal>, // R! Amount of adjustment
"base" : "<code>" // R! up | down | in | out
}],
"add" : <decimal>, // Added power for multifocal levels
"power" : <decimal>, // Contact lens power
"backCurve" : <decimal>, // Contact lens back curvature
"diameter" : <decimal>, // Contact lens diameter
"duration" : { Quantity(SimpleQuantity) }, // Lens wear duration
"color" : "<string>", // Color required
"brand" : "<string>", // Brand required
"note" : [{ Annotation }] // Notes for coatings
}]
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .
Changes from both R4 and R4B
| VisionPrescription | |
| VisionPrescription.basedOn |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
Additional definitions: Master Definition XML + JSON , XML Schema / Schematron + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis
| Path | ValueSet | Type | Documentation |
|---|---|---|---|
| VisionPrescription.status | FinancialResourceStatusCodes | Required |
This value set includes Status codes. |
| VisionPrescription.lensSpecification.product | ExampleVisionPrescriptionProductCodes | Example |
This value set includes a smattering of Prescription Product codes. |
| VisionPrescription.lensSpecification.eye | VisionEyes | Required |
A coded concept listing the eye codes. |
| VisionPrescription.lensSpecification.prism.base | VisionBase | Required |
A coded concept listing the base codes. |
Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| datewritten | date | Return prescriptions written on this date | VisionPrescription.dateWritten | |
| encounter | reference | Return prescriptions with this encounter identifier |
VisionPrescription.encounter
( Encounter ) |
|
| identifier | token | Return prescriptions with this external identifier | VisionPrescription.identifier |
|
| patient | reference | The identity of a patient to list dispenses for |
VisionPrescription.patient
( Patient ) |
|
| prescriber | reference | Who authorized the vision prescription |
VisionPrescription.prescriber
( Practitioner , PractitionerRole ) |
|
| status | token | The status of the vision prescription | VisionPrescription.status |
FHIR
®©
HL7.org
2011+.
FHIR
R5
hl7.fhir.core#5.0.0
R6
hl7.fhir.core#6.0.0-ballot3
generated
on
Sun,
Mar
26,
2023
15:26+1100.
Tue,
Apr
1,
2025
12:26+1100.
Links:
Search
|
Version
History
|
Contents
|
Glossary
|
QA
|
Compare
to
R4
|
Compare
to
R4B
R5
|
|
Propose
a
change