====== Single Sided Subtraction ======

===== Overview =====
This operation is used to decrease the balance in an instrument for a particular account.

It can be accessed as follows:
  * Select Subtraction from the Insert section of the Transactions menu
==== Related Topics ====
You may also want to refer to:
  * [[OffMarketTransactions]]
  * [[SingleSidedAddition]]
  * [[TwinSidedTransfer]]
  * [[InstrumentSelector]]
  * [[AccountSelector]]
  * [[AccountConfirmation]]
==== Configuration ====
The following configuration options affect the behaviour of this operation:
  * [[ConfigTransactionType]] - the list of transaction types configured for subtractions
===== Operation =====
The screen below is used for entering the parameters for a new subtraction:

{{dependsubtraction.png|Subtraction Insert screen}}
===== Parameters =====
The parameters to be entered for a subtraction are shown in the table below; **mandatory fields** are shown in bold text on the screen.


Use the ~~test~~ directive
☛P_SINGLESIDED_SUBSTRACTION
^Parameter ^Description ^
|ISIN Code\\ PARAM_SUB_ISIN_CODE |Select the instrument to be updated from the pulldown list provided, enter its ISIN Code, or press the [...] button at the right of the field to invoke an instrument search screen\\  The status of the selected instrument must allow transaction entry |
|Debit Account\\ PARAM_SUB_AC_REF |Enter the reference of the account to be updated or press the [...] button at the right of the field to invoke an account search screen\\  The status of the selected account must allow transaction entry |
|Broker Code\\ PARAM_SUB_BROKER |Select the broker that handled the transaction from the pulldown list provided |
|Bargain Reference\\ PARAM_SUB_BARG |The broker's bargain reference for the transaction |
|Quantity\\ PARAM_SUB_QTY |The number of securities to be subtracted\\ This can be up to 8 decimal places depending on the selected instrument's configuration |
|Certificate List\\ PARAM_SUB_CERTS |The list of certificate numbers being used to support the subtraction\\ Enter the list of numbers separated by commas or press the [...] button at the right of the field to invoke a certificate selector screen |
|Balance Amount\\ PARAM_SUB_BAL |The number of securities to be accounted for on a balance certificate\\ Leave this empty to let the [[ApplicationServer]] calculate it automatically |
|Record Date\\ PARAM_SUB_DATE |The record date of the transaction\\ Leave this empty to allow the [[ApplicationServer]] to use the current date and time |
|Transaction Reference\\ PARAM_SUB_REF |The reference code to be applied to the transaction\\ Leave this empty to allow the [[ApplicationServer]] to generate a reference automatically |
|Remarks\\ PARAM_SUB_REM |Comments or remarks in respect of the subtraction transaction |
|Transaction Type\\ PARAM_SUB_TYPE |Select the transaction type from the pulldown list provided |
|Unit Price\\ PARAM_SUB_PRICE |The price of the subtraction transaction |
|Consideration\\ PARAM_SUB_CONSID |The consideration of the subtraction transaction\\ Usually calculated as Quantity*Price |
|Currency Code\\ PARAM_SUB_CCY |Select the currency of the price and consideration from the pulldown list provided |
===== Update =====
Key the information into the fields provided and press the Save button.  You will be required to confirm the selection of instrument and account in the standard [[AccountConfirmation]] screen.

The following should happen if there are no errors in the information you entered:
  * The [[ApplicationServer]] will create a new subtraction transaction with the information you entered on the screen
  * The balance of the account in the selected instrument will be decreased by the quantity entered
  * The total number of securities in issue for the selected instrument will be decreased by the quantity entered
  * If the transaction was physical, the list of certificates supplied will be cancelled and if necessary, a balance certificate will be created to hold any residual balance; if the instrumemt is physical, but the account balance is dematerialised, the balance of securities will be subtracted from the open item for that account and instrument