Skip to content

Appointment Invoiced Extension

Canonical../StructureDefinition/appointment-invoiced
Statusdraft · 1.26.0
BaseExtension (constraint)
ContextAppointment (element)
SourceFSH · JSON

That an invoice covering this appointment's visit has been observed at the billing vendor, and the instant it was observed.

Elements / Details

Every element this profile touches, with its full definition. Element names in the tables link here.

Extension

Short Appointment Invoiced Extension
Definition That an invoice covering this appointment's visit has been observed at the billing vendor, and the instant it was observed. An observation, not a workflow state. Appointment.status carries the states a clinic sets by hand; this carries only what a read-back of the vendor confirmed. Neither can be derived from the other, and a status that reads as billed is not evidence that this extension would be present. Absence means the observation has not been made -- NOT that the visit was not invoiced. The extension is written only when an invoice was seen. It is absent while a read-back has not run, while it has run without finding one, and wherever no read-back exists. Rendering absence as "not invoiced" in a user interface is a defensible choice; counting it as "no invoice exists" is not, and a report built that way under-states billing coverage. Treat absence as unknown. The instant is when the invoice was observed, not when it was raised and not when the service was delivered. The observation is not rewritten once stored, so the instant names the first confirmation rather than the most recent check. Written at most once per appointment. A reader encountering more than one copy should take the first rather than merge them. MIGRATION. Nexus EMR writes this extension today at http://services.well.com/fhir/StructureDefinition/appointment-invoiced (FHIR-378). That address is live in stored appointments and in code, and is under migration to the canonical declared here. Write the canonical; when reading, match on the URL suffix appointment-invoiced so that appointments filed under either address are seen.
Cardinality 0..*
Invariants ele-1, ext-1

Extension.id

Short Unique id for inter-element referencing
Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality 0..1
Type http://hl7.org/fhirpath/System.String

Extension.extension

Short Additional content defined by implementations
Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Cardinality 2..*
Type Extension
Invariants ele-1, ext-1
Also called extensions, user content

Extension.extension:invoiced

Short The observed fact: an invoice for this visit exists
Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Cardinality 1..1
Type Extension
Must Support yes
Invariants ele-1, ext-1
Also called extensions, user content

Extension.extension:invoiced.id

Short Unique id for inter-element referencing
Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality 0..1
Type http://hl7.org/fhirpath/System.String

Extension.extension:invoiced.extension

Short Additional content defined by implementations
Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Cardinality 0..0
Type Extension
Invariants ele-1, ext-1
Also called extensions, user content

Extension.extension:invoiced.url

Short identifies the meaning of the extension
Definition Source of the definition for the extension code - a logical name or a URL.
Comments The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Cardinality 1..1
Type http://hl7.org/fhirpath/System.String
Fixed value invoiced

Extension.extension:invoiced.value[x]

Short Value of extension
Definition The observed fact. Only true is written: the extension records a positive observation and is absent otherwise. A reader MUST require true and treat any other value, or a missing child, as no observation at all rather than as a statement that no invoice exists.
Cardinality 1..1
Type boolean
Must Support yes
Invariants ele-1

Extension.extension:observedAt

Short When the invoice was observed at the vendor
Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Cardinality 1..1
Type Extension
Must Support yes
Invariants ele-1, ext-1
Also called extensions, user content

Extension.extension:observedAt.id

Short Unique id for inter-element referencing
Definition Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Cardinality 0..1
Type http://hl7.org/fhirpath/System.String

Extension.extension:observedAt.extension

Short Additional content defined by implementations
Definition May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Comments There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Cardinality 0..0
Type Extension
Invariants ele-1, ext-1
Also called extensions, user content

Extension.extension:observedAt.url

Short identifies the meaning of the extension
Definition Source of the definition for the extension code - a logical name or a URL.
Comments The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Cardinality 1..1
Type http://hl7.org/fhirpath/System.String
Fixed value observedAt

Extension.extension:observedAt.value[x]

Short Value of extension
Definition When the read-back observed the invoice. NOT when the invoice was raised, when the service was delivered, or when the appointment was marked billed. Required: an observation with no instant cannot be aged, and a reader should treat one lacking a usable instant as no observation.
Cardinality 1..1
Type instant
Must Support yes
Invariants ele-1

Extension.url

Short identifies the meaning of the extension
Definition Source of the definition for the extension code - a logical name or a URL.
Comments The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.
Cardinality 1..1
Type http://hl7.org/fhirpath/System.String
Fixed value ../StructureDefinition/appointment-invoiced

Extension.value[x]

Short Value of extension
Definition Value of extension - must be one of a constrained set of the data types (see Extensibility for a list).
Cardinality 0..0
Type base64Binary, boolean, canonical, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, url, uuid, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference, SampledData, Signature, Timing, ContactDetail, Contributor, DataRequirement, Expression, ParameterDefinition, RelatedArtifact, TriggerDefinition, UsageContext, Dosage, Meta
Invariants ele-1