InvoiceSe(version 1) [Deprecated]

Introduction

Please note that this version of the Invoice profile is deprecated and the recommended profile to use is InvoiceSe(version 2).

The Invoice resource contains the payment details related to a single patient visit. The profile is based on the Invoice in FHIR STU4 edition.

Intended Use

The Invoice resource returns relevant cost for the patient visit. It contains three extensions to include additional details about the payments.

Specific Rules and Limitations

Type Description
Rule N/A

Profile Overview

InvoiceSe

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
id0..1string
extensionI0..*Extension
url1..1uriFixed Value
valueCodeableConceptCodeableConcept
id0..1string
extensionI0..*Extension
url1..1uriFixed Value
valueCodingCoding
paymentMethodOptionI0..*Extension(Coding)
modifierExtension?! I0..*Extension
identifierΣ0..0Identifier
statusΣ ?!1..1codeBinding
cancelledReason0..0string
typeΣ0..0CodeableConcept
subjectΣ I1..1Reference(Patient)
recipientΣ I0..0Reference(Organization)
dateΣ0..1dateTime
issuerI0..1Reference(OrganizationInvoiceSe)
accountI0..0Reference(https://fhir.cambio.se/StructureDefinition/AccountSe)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
sequence0..0positiveInt
chargeItemReferenceReference(ChargeItemSe)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
type1..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..1string
codeΣ0..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
factor0..1decimal
id0..1string
extensionI0..*Extension
valueΣ0..1decimal
currencyΣ0..1codeBindingFixed Value
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
type1..1codeBindingFixed Value
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..1string
codeΣ0..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
factor0..1decimal
id0..1string
extensionI0..*Extension
valueΣ0..1decimal
currencyΣ0..1codeBindingFixed Value
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
type1..1codeBindingFixed Value
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..1string
codeΣ0..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
factor0..1decimal
id0..1string
extensionI0..*Extension
valueΣ0..1decimal
currencyΣ0..1codeBindingFixed Value
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
type1..1codeBindingFixed Value
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..1string
codeΣ0..1code
displayΣ0..1string
userSelectedΣ0..1boolean
textΣ0..1string
factor0..1decimal
id0..1string
extensionI0..*Extension
valueΣ0..1decimal
currencyΣ0..1codeBindingFixed Value
totalPriceComponent0..0see (priceComponent)
totalNetΣ1..1Money
paymentTerms0..0markdown
note0..0Annotation

Versions

COS version Profile version Required COSMIC version Date Description
N/A 1.0.0 N/A Nov 2021 Deprecated version, latest verison is Invoice(version 2).

Extensions

Extension Data type ValueSet Description
Common-businessStatus Fixedvalues InvoiceBusinessStatus Optional extension element to indicate the status of the payment status of the contact.
Invoice-paymentMethodOption Fixedvalues PaymentMethodOptions Extension to pass the list of supported payment methods for the visit. Please note that this extension is deprecated, see InvoiceSe(version 2) for current extension.
Invoice-registeredPaymentMethod Fixedvalues Registered_Payment_Method Extension to indicate the payment method used for making the payment for the visit.

Mapping for Payment Types

FHIR status Status in COSMIC
base patient
surcharge invoice
discount reduction
surcharge other(amount >0)
discount other(amount <0)

Supported Operations

HTTP Methods

Method Description
GET Search for invoice using patient id and encounter id.

Query Operations

Search Parameters

Parameter Format Comment
Subject string The subject that the inovice is about (patient)
encounter string Contact id of the visit

Supported Queries

  1. GET [baseURL]/invoice_search?subject={}&encounter={} (search)

Supported SearchInclude Operations

N/A

Supported RevInclude Operations

N/A

Error Codes

Specific error messages for InvoiceSe are listed below.

Code Description Comment
400 Occur due to invalid request parameters E.g.Invalid parameters, mismatch between patientId and the contactId, contact does not exist & contact is not in registered or booked state
404 Invoice is not found for the given patient and encounter