Invoice Service Date Extension¶
| Canonical | https://fhir.apps.health/StructureDefinition/nexus-invoice-service-date |
|---|---|
| Status | draft · 1.33.0 |
| Base | Extension (constraint) |
| Context | Invoice.lineItem (element) |
| Source | FSH · JSON |
The date a billed service was delivered, carried on the Invoice line item that bills it.
Invoice.date is the billing date, not the date of service, and R4 Invoice has no element for the
latter. A claim may bill several services on different dates, one per line.
FSH
The authored source of truth: extensions/InvoiceServiceDateExtension.fsh (edit on GitHub). One FSH file may define several related artifacts.
// InvoiceServiceDateExtension.fsh
// The date a billed service was delivered, on one Invoice line item.
//
// WHY AN EXTENSION. R4 Invoice has no element for the date of service: `Invoice.date` is the
// invoice (billing) date, and the core elements that do carry a service date are on other
// resources (`Claim.item.serviced[x]`, `ChargeItem.occurrence[x]`). An OHIP claim carries one
// date per service line, so the date belongs on the line item, and while the billing model is
// Invoice it has nowhere else to go.
Extension: NexusInvoiceServiceDate
Id: nexus-invoice-service-date
Title: "Invoice Service Date Extension"
Description: """
The date a billed service was delivered, carried on the Invoice line item that bills it.
`Invoice.date` is the billing date, not the date of service, and R4 Invoice has no element for the
latter. A claim may bill several services on different dates, one per line.
**MIGRATION.** The billing conversion writes this today at
`https://apps.health/InvoiceLineItem/service-date`. Write the canonical declared here; when reading,
expect both addresses until stored invoices are migrated.
"""
* ^url = "https://fhir.apps.health/StructureDefinition/nexus-invoice-service-date"
* ^status = #draft
* ^context[0].type = #element
* ^context[0].expression = "Invoice.lineItem"
* value[x] 1..1
* value[x] only date
* valueDate ^short = "The date the service was delivered"