---
schema_version: "1"
id: 9d57f56413065b2f8d31b815760c1909f8ee45e3aa2f7d35df81c69cf1df86ab
title: FHIR Dosage Input
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/connect_requests_fhir_dosage.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_fhir_dosage.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e4352f6647adda23a176d0a75336652f0f713efb03c4e622815dd39df49b2e03
description: The input representation of dosage information for a patient’s medication.
---
# FHIR Dosage Input

The input representation of dosage information for a patient’s medication.

The Dosage FHIR resource maps to the [PatientMedicationDosage](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_PatientMedicationDosage.htm "Represents dosage information for medication. This object is primarily used to add dosage information in MedicationStatement, MedicationRequest, or MedicationDispense records. This object is available in API version 51.0 and later.") object in Salesforce.

## Root XML tag

<FhirDosageInput>

## JSON example

{
   "sequence":"10.0",
   "text":"commentsText",
   "additionalInstruction":"Additioanl Instructions",
   "patientInstruction":"Patient Instructions",
   "asNeeded":"true",
   "site":{
   "salesforceId":"0iPxx00000000MbEAI" },
   "route":{
   "codeableConcept":{
   "text":"Burn of Ear route",
   "coding":\[
   {
   "display":"Burn of ear route",
   "code":"123456700",
   "system":"http://sfdc.co",
   "version":"2.16.840.1.113883.6.96",
   "isActive":true,
   "isPrimary":true,
   "use":"Clinical",
   "userSelected":true,
   "startDate":"1993-11-09T15:40:30.000Z",
   "endDate":"2021-08-24T17:00:00.000Z",
   } \]
   }
   },
   "method":{
   "codeableConcept":{
   "text":"Burn of Ear Method",
   "coding":\[
   {
   "display":"Burn of ear",
   "code":"1234567777",
   "system":"http://sfdc.co",
   "version":"2.16.840.1.113883.6.96",
   "isActive":true,
   "isPrimary":true,
   "use":"Clinical",
   "userSelected":true,
   "startDate":"1993-11-09T15:40:30.000Z",
   "endDate":"2021-08-24T17:00:00.000Z",
   } \]
   }
   },
   "doseAndRate":{
   "type":"Ordered",
   "dose":{
   "dosageQuantityType":"Dose",
   "dosageQuantityNumerator":"10",
   "dosageQuantityDenominator":"20",
   "dosageUnit":{
   "unitOfMeasure":{
   "unitCode":"MGTest",
   "description":"MG description",
   "type":"Custom" }
   }
   },
   "rate":{
   "dosageRateType":"Frequency Ratio",
   "dosageRateNumerator":"2",
   "dosageRateDenominator":"3",
   "dosageRateUnit":{
   "salesforceId":"0hExx0000000001EAA" }
   }
   },
   "sourceSystem":"http://sfdc.co",
   "sourceSystemId":"567890",
   "sourceSystemModified":"2012-07-26T15:40:30.000Z" 
}

## Properties

| Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| additionalInformation | [Custom Field Value Input](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_custom_field_value.htm "Adds additional information to any fields not mapped by the medication statement API.")\[\] | The additional information associated with the medication for the patient. | Optional | 54.0 |
| additionalInstruction | String | The supplemental instructions or warnings associated with the medication for the patient. | Optional | 54.0 |
| asNeeded | Boolean | Indicates whether the medication is taken on an as-needed basis. | Optional | 54.0 |
| doseAndRate | [FHIR Dose And Rate Input](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_fhir_dose_and_rate.htm "Input representation of the specified dose and rate.") | The amount of dosage administration. | Optional | 54.0 |
| method | [FHIR Codeable Concept Or ID Input](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_fhir_codeable_concept_or_id.htm "Input representation for FHIR Codeable Concept or ID.") | The method of dosage administration. | Optional | 54.0 |
| patientInstruction | String | The patient or consumer instructions associated with this medication. | Optional | 54.0 |
| route | [FHIR Codeable Concept Or ID Input](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_fhir_codeable_concept_or_id.htm "Input representation for FHIR Codeable Concept or ID.") | The route of dosage adminisitration. | Optional | 54.0 |
| sequence | Double | The position of this medication in the sequence of medications prescribed to a patient. | Optional | 54.0 |
| site | [FHIR Codeable Concept Or ID Input](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/connect_requests_fhir_codeable_concept_or_id.htm "Input representation for FHIR Codeable Concept or ID.") | The site of dosage adminisitration. | Optional | 54.0 |
| sourceSystem | String | The source system from where the dosage record was brought into Salesforce. | Optional | 54.0 |
| sourceSystemId | String | The identifier of the dosage record in its source system. | Optional | 54.0 |
| sourceSystemModified | String | The date and time when the dosage record was last modified in its source system. | Optional | 54.0 |
| text | String | The free text dosage instructions associated with the medication for the patient. | Optional | 54.0 |