POST

/BizTransaction/SetQuantity

Usage Notes

When

  • Set exact balance for reconciliation
  • Correct positions during data migration
  • Execute absolute quantity corrections

Requirements

  • Account and Investment must exist
  • Quantity value representing target balance
  • TransactionDate required

Notes

  • Sets absolute balance regardless of current holdings
  • Comment field required for audit trail
  • Use sparingly - AdjustQuantity preferred for normal corrections

Description

Creates a set quantity transaction that establishes an absolute balance. System calculates the implicit adjustment. Use for data migration and reconciliation scenarios.

Required Headers - See Authentication

HeaderValueDescription
Content-Typeapplication/jsonRequest content type
Authorization{accessToken}Bearer token for API access
Version2.0API version identifier

Request Body

Parameter Type Required Description
quantity >
number (double)
Absolute target quantity value replacing current holdings completely (ignores current balance, use 0 for account closures).
comment
 string
Optional
Optional field to document the reason for setting the absolute quantity. Useful for internal record-keeping and appears on account statements.
accountID >
integer (int32)
Account identifier for setting absolute quantity. Account must exist in the system.
externalAccountId >
string
External account identifier for dual-ID integration. Used to match with records in external systems.
externalBizTransactionId
 string
Optional
External system reference for dual-ID integration. Optional field to match transactions with records in external systems.
investmentID >
integer (int32)
Investment identifier for setting absolute quantity. Investment must exist and be active.
externalInvestmentId >
string
External investment identifier for cross-platform integration using security codes, ISIN, or APIR codes.
productID >
integer (int32)
Native product identifier validating investment and account belong to correct fund structure.
externalProductId >
string
External product identifier for cross-system product correlation (resolves to internal productID for validation).
transactionDate >
string (date)
Date of the SetQuantity transaction. Format: YYYY-MM-DD. Cannot be empty or default value.
quantity
number (double)
Absolute target quantity value replacing current holdings completely (ignores current balance, use 0 for account closures).
comment
string
Optional
Optional field to document the reason for setting the absolute quantity. Useful for internal record-keeping and appears on account statements.
accountID
integer (int32)
Account identifier for setting absolute quantity. Account must exist in the system.
externalAccountId
string
External account identifier for dual-ID integration. Used to match with records in external systems.
externalBizTransactionId
string
Optional
External system reference for dual-ID integration. Optional field to match transactions with records in external systems.
investmentID
integer (int32)
Investment identifier for setting absolute quantity. Investment must exist and be active.
externalInvestmentId
string
External investment identifier for cross-platform integration using security codes, ISIN, or APIR codes.
productID
integer (int32)
Native product identifier validating investment and account belong to correct fund structure.
externalProductId
string
External product identifier for cross-system product correlation (resolves to internal productID for validation).
transactionDate
string (date)
Date of the SetQuantity transaction. Format: YYYY-MM-DD. Cannot be empty or default value.

Example Requests

bash
curl -X POST 'https://api.7g.com.au/BizTransaction/SetQuantity' \
  -H 'Authorization: {accessToken}' \
  -H 'Version: 2.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 75000.00,
    "comment": "Portfolio restructure - target allocation",
    "accountID": 12345,
    "externalBizTransactionId": "SET-2024-001",
    "investmentID": 25,
    "productID": 10,
    "transactionDate": "2025-08-14"
  }'

Response Examples

json
{
  "result": true,
  "message": "Quantity set successfully",
  "recordCount": 1,
  "data": {
    "bizTransactionID": 5001,
    "externalBizTransactionId": "SET-2024-001",
    "bizTransactionTypeID": 7,
    "typeName": "Set Quantity",
    "movementReasonCode": "ABSOLUTE_SET",
    "parentBizTransactionID": null,
    "transactionDate": "2025-08-14T00:00:00Z",
    "productID": 10,
    "externalProductId": "FUND-001",
    "accountID": 12345,
    "externalAccountId": "ACC-12345",
    "accountNumber": "ACC001234",
    "bizEntityName": "Smith Family Trust",
    "investmentID": 25,
    "externalInvestmentId": "INV-GROWTH",
    "securityCode": "GRW001",
    "investmentName": "Growth Investment Class A",
    "investmentPrice": 1.2500,
    "comment": "Opening balance - system migration",
    "corporateActionID": null,
    "externalCorporateActionId": null,
    "corporateActionName": null,
    "amount": null,
    "quantity": 50000.00,
    "transactionClosingAmount": null,
    "transactionClosingQuantity": null,
    "accountClosingAmount": null,
    "accountClosingQuantity": null,
    "createdDate": "2025-08-14T10:30:15Z",
    "updatedDate": null,
    "bizTransactionStatusID": 1,
    "statusName": "Complete"
  }
}
GET Get BizTransactions POST AdjustQuantity POST Deposit GET Get Account Holdings