Create a modified charge item
post
/ChargeItem/{ID}/$modify
Creates a new charge item from modifying an existing charge item.
Note: Only the body fields mentioned below are supported. Unsupported fields are ignored.
Authorization Types
This operation supports the following authorization types:
Request
Supported Media Types
- application/fhir+json
Path Parameters
-
ID(required): string
The logical resource ID associated with the resource.
Header Parameters
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. The credentials should be the OAuth2 Bearer Token.
-
accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
Root Schema : ChargeItemModifyBody
Type:
Show Source
object
-
chargeItem(required):
string
The charge item to be modified.
Note:- The Resource field is required and must be of type
ChargeItem
. - Only one
chargeItem
parameter may be provided.
{ "parameter": [ "name": "chargeItem", "resource": { "resourceType": "ChargeItem" } ] }
- The Resource field is required and must be of type
-
code(required):
object code
The primary billing code that identifies the charge.
Note:- The coding field must contain only one coding from the CDM_SCHED, CPT, HCPCS, or PROCCODE proprietary Bill Codes Types systems.
- The Bill Code Type provided in
code
must be the highest tier of all of the Bill Code Types associated with the charge item. - Tiering logic from highest to lowest: CDM_SCHED, CPT, HCPCS, or PROCCODE.
{ "code": { "coding": [ { "extension": [ { "valueCoding": { "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002", "code": "667687" }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule" } ], "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-CDM_SCHED", "code": "64897" } ] } }
-
context(required):
object context
The encounter associated with the charge.
Note: Must be an Encounter reference.
Example:{ "context": { "reference": "Encounter/97965088" } }
-
custom-attribute:
A client-defined custom attribute for the charge.
Note:custom-attribute-name
andcustom-attribute-value
are both required.id
andvalueString
forcustom-attribute-name
are required.custom-attribute-value
can be of type integer, string, decimal, or dateTime.
{ "extension": [ { "id": "2572130093", "valueString": "Special Authority", "url": "custom-attribute-name" }, { "valueInteger": 1, "url": "custom-attribute-value" } ], "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute" }
-
description:
A description providing additional details about the charge item.
Example:{ "valueString": "Acetaminophen Level", "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/description" }
-
modifier-code:
object modifier-code
A code providing additional details about a product or service.
Note:- The coding field must contain only one coding from the MODIFIER proprietary Bill Codes Types system.
- Both code and priority subextensions are required.
{ "extension": [ { "valueCodeableConcept": { "coding": [ { "extension": [ { "valueCoding": { "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002", "code": "3692" }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule" } ], "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-MODIFIER", "code": "66" } ] }, "url": "code" }, { "valueUnsignedInt": 1, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority" } ], "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/modifier-code" }
-
occurrenceDateTime:
string
The date and time when the charged service was applied.
Example:{ "occurrenceDateTime": "2021-01-08T10:38:00Z" }
-
parameter(required):
The parameters defined by the operation.
-
performer:
Who performed or participated in the charge.
Note:- The value must be in the form of
CodeableConcept
. - Must contain both the actor and function subfields.
- The value of actor must be in the form of
valueReference
. - Only the following system and code combinations may be used in the performer function
coding
: - http://terminology.hl7.org/CodeSystem/v2-0912 - OP
- http://terminology.hl7.org/CodeSystem/v3 - PRF
- http://terminology.hl7.org/CodeSystem/v3 - VRF
{ "performer": [ { "function": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/v2-0912", "code": "OP", "display": "Ordering Provider" } ], "text": "Ordering Provider" }, "actor": { "reference": "Practitioner/11817978" } } ] }
- The value must be in the form of
-
performing-location:
A location where the charge was performed.
Note: Must be a Location reference.
Example:{ "valueReference": { "reference": "Location/21304903", "display": "NM" }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/performing-location" }
-
procedure-code:
A code providing information about the procedure performed on the patient associated with the resource.
Note:- The coding field must contain only one coding from the CPT, HCPCS, or PROCCODE proprietary Bill Codes Types systems.
- Must be of a lower bill code tier than the ChargeItem.code field if provided.
- Both code and priority subextensions are required.
{ "extension": [ { "valueCodeableConcept": { "coding": [ { "extension": [ { "valueCoding": { "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002", "code": "615214" }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule" } ], "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-CPT", "code": "10081" } ] }, "url": "code" }, { "valueUnsignedInt": 1, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority" } ], "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/procedure-code" }
-
quantity:
object quantity
The quantity of which the charge item has been serviced.
Example:{ "quantity": { "value": 31 } }
-
reason:
object reason
The diagnosis codes for why the charge was rendered.
Note: The coding field must contain only one coding from the ICD proprietary Bill Codes Types systems.
Example:{ "reason": [ { "extension": [ { "valueUnsignedInt": 1, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority" } ], "coding": [ { "extension": [ { "valueCoding": { "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002", "code": "3693" }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule" } ], "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-ICD", "code": "R51" } ] } ] }
-
replacing(required):
The resource that this charge item is replacing.
Note:- Can only provide one replacing extension.
- The item-version subextension is required.
{ "extension": [ { "valueId": "1", "url": "item-version" } ], "valueReference": { "reference": "ChargeItem/317370800" }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/replacing" }
-
resourceType(required):
string
The type of the FHIR resource.Example:
Parameters
-
revenue-code:
The type of revenue or cost center providing the product, service, or both.
Note: The coding field must contain only one coding from the REVENUE proprietary Bill Codes Types system.
Example:{ "valueCodeableConcept": { "coding": [ { "extension": [ { "valueCoding": { "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002", "code": "615217" }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule" } ], "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-REVENUE", "code": "0024" } ] }, "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/revenue-code" }
-
status(required):
string
The current state of the charge.
Note: The status must be set tounknown
.
Example:{ "status": "unknown" }
-
subject(required):
object subject
The patient associated with the charge.
Note: Must be a Patient reference.
Example:{ "subject": { "reference": "Patient/12768550" } }
-
transactionId(required):
string
A UUID to uniquely identify the modify operation.
Note:- The value must be in the form of
valueUuid
. - Only one
transactionId
parameter may be provided.
{ "parameter": [ { "name": "transactionId", "valueUuid": "urn:uuid:aa7623a0-0c7b-11ec-82a8-0242ac130003" } ] }
- The value must be in the form of
Example:
{
"resourceType": "Parameters",
"parameter": [
{
"name": "chargeItem",
"resource": {
"resourceType": "ChargeItem",
"status": "unknown",
"subject": {
"reference": "Patient/12768550"
},
"context": {
"reference": "Encounter/97965088"
},
"occurrenceDateTime": "2021-01-08T10:38:00Z",
"quantity": {
"value": 31
},
"code": {
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "667687"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-CDM_SCHED",
"code": "64897"
}
]
},
"performer": [
{
"function": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0912",
"code": "OP",
"display": "Ordering Provider"
}
],
"text": "Ordering Provider"
},
"actor": {
"reference": "Practitioner/11817978"
}
}
],
"reason": [
{
"extension": [
{
"valueUnsignedInt": 1,
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority"
}
],
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "3693"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-ICD",
"code": "0023"
}
]
}
],
"extension": [
{
"extension": [
{
"valueId": "1",
"url": "item-version"
}
],
"valueReference": {
"reference": "ChargeItem/317370800"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/replacing"
},
{
"valueReference": {
"reference": "Location/2170691494",
"display": "RCR Analytics"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/performing-location"
},
{
"valueString": "Acetaminophen Level",
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/description"
},
{
"extension": [
{
"id": "17433932",
"valueString": "Line Note Text",
"url": "custom-attribute-name"
},
{
"valueString": "Raghu, P",
"url": "custom-attribute-value"
}
],
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
},
{
"extension": [
{
"valueCodeableConcept": {
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "3692"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-MODIFIER",
"code": "66"
}
]
},
"url": "code"
},
{
"valueUnsignedInt": 1,
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority"
}
],
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/modifier-code"
},
{
"extension": [
{
"valueCodeableConcept": {
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "615214"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-CPT",
"code": "10081"
}
]
},
"url": "code"
},
{
"valueUnsignedInt": 1,
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority"
}
],
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/procedure-code"
},
{
"valueCodeableConcept": {
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "615217"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-REVENUE",
"code": "0024"
}
]
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/revenue-code"
}
]
}
},
{
"name": "transactionId",
"valueUuid": "urn:uuid:5825e8ea-3b47-11ec-8d3d-0242ac130003"
}
]
}
Nested Schema : code
Type:
object
The primary billing code that identifies the charge.
Note:
Show Source
Note:
- The coding field must contain only one coding from the CDM_SCHED, CPT, HCPCS, or PROCCODE proprietary Bill Codes Types systems.
- The Bill Code Type provided in
code
must be the highest tier of all of the Bill Code Types associated with the charge item. - Tiering logic from highest to lowest: CDM_SCHED, CPT, HCPCS, or PROCCODE.
{
"code": {
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "667687"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-CDM_SCHED",
"code": "64897"
}
]
}
}
Nested Schema : context
Type:
object
The encounter associated with the charge.
Note: Must be an Encounter reference.
Example:
Show Source
Note: Must be an Encounter reference.
Example:
{
"context": {
"reference": "Encounter/97965088"
}
}
Nested Schema : modifier-code
Type:
object
A code providing additional details about a product or service.
Note:
Note:
- The coding field must contain only one coding from the MODIFIER proprietary Bill Codes Types system.
- Both code and priority subextensions are required.
{
"extension": [
{
"valueCodeableConcept": {
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "3692"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-MODIFIER",
"code": "66"
}
]
},
"url": "code"
},
{
"valueUnsignedInt": 1,
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority"
}
],
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/modifier-code"
}
Nested Schema : quantity
Type:
object
The quantity of which the charge item has been serviced.
Example:
Show Source
Example:
{
"quantity": {
"value": 31
}
}
Nested Schema : reason
Type:
object
The diagnosis codes for why the charge was rendered.
Note: The coding field must contain only one coding from the ICD proprietary Bill Codes Types systems.
Example:
Show Source
Note: The coding field must contain only one coding from the ICD proprietary Bill Codes Types systems.
Example:
{
"reason": [
{
"extension": [
{
"valueUnsignedInt": 1,
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/priority"
}
],
"coding": [
{
"extension": [
{
"valueCoding": {
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/14002",
"code": "3693"
},
"url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/bill-code-schedule"
}
],
"system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/CodeSystem/BillCodes-ICD",
"code": "R51"
}
]
}
]
}
Nested Schema : subject
Type:
object
The patient associated with the charge.
Note: Must be a Patient reference.
Example:
Show Source
Note: Must be a Patient reference.
Example:
{
"subject": {
"reference": "Patient/12768550"
}
}
Response
Supported Media Types
- application/fhir+json
201 Response
Modified
Headers
-
ETag: string
The identifier for a specific version of a resource. This identifier is formatted as
W/"
and is used to specify the" If-Match
header value on subsequent updates. -
Location: string
The URL location of the created entity.
Example:Location: https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/ChargeItem/2180632343
-
X-Request-Id: string
The Oracle troubleshooting identifier.
-
opc-request-id: string
The Oracle troubleshooting identifier.
Default Response
Example Request:
POST https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/ChargeItem/$modify
Example Response:
no-cache
Content-Length: 0
Content-Type: text/html
Date: Fri, 16 Jul 2021 17:23:14 GMT
Etag: W/"0"
Location: https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/ChargeItem/2180632343
Last-Modified: Fri, 16 Jul 2021 17:23:13 GMT
Vary: Origin
X-Request-Id: 11111111111111111111111111111111
The ETag response header indicates the current If-Match version to use on a subsequent update.