TotalMedicalAmount Property

Sum total of all medical item amounts.

Syntax

 tsyshealthcare.getTotalMedicalAmount([callback])
 tsyshealthcare.setTotalMedicalAmount( totalMedicalAmount, [callback])

Default Value

""

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getTotalMedicalAmount([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setTotalMedicalAmount([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This property is required when submitting a Healthcare Auto-substantiation transaction, and should indicate the sum total of all VisionAmounts, PrescriptionAmounts, ClinicAmounts, and DentalAmounts, plus any additional healthcare-related charges that do not fall under those categories. The category-specific amounts are optional, but at the minimum the TotalMedicalAmount must be present for Healthcare auto-substantiation.

If other amounts are present, the TotalMedicalAmount must be greater than or equal to the total of all other amounts. If the TotalMedicalAmount is left blank, the transaction will be sent as a regular Retail transaction, without the healthcare indicator. If you wish to send a transaction with the healthcare indicator, but no TotalMedicalAmount, set TotalMedicalAmount to "0".

If the transaction is only for healthcare related costs, the TotalMedicalAmount should be equal to the TransactionAmount. However, it is possible to authorize a transaction that includes non-healthcare items, where the TransactionAmount is higher than the TotalMedicalAmount. It may be required that you set PartialAuthorization to True in order to support this functionality.

This must be formatted as a dollar amount with a real decimal point, excluding the dollar sign. For instance "12.00"

Data Type

String