Overview
The Self-Service Holding Adjustments Tool is provided to the Participants to act as the Issuer (Registry) via upload of a configurable CSV file, which will be consumed and validated by the CSP.
By updating the field details of a hold_226 message in the CSV file, developers are able to perform different holding adjustment test scenarios.
This service allows developers to submit a fixed CSV file containing the holding adjustment information using a cURL command to a REST endpoint.
The REST endpoint translates the CSV file to a ISO XML message (Holding Adjustment Notification (hold_226)), which is then submitted to the CSP.
On success, in parallel to the Issuer (Registry) receiving a Transaction Acknowledgement Advice (comm_809), a Holding Adjustment Notification (hold_226) and, where applicable, a Security Balance Report (hold_228) will be sent by the CSP to the controlling participant.
If the CSV submitted by the Participant is invalid due to errors in the business validity, an Invalid Transaction (comm_808) is received.
If the CSV submitted by the Participant is invalid due to errors in the file format or schema validity, a rejection from the Self-Service Tool is received.
These responses are delivered to the REST endpoint, where it is converted to a JSON response.
The sample below is provided as a reference; additional information on the column names and elements present in the CSV can be found on the /wiki/spaces/CSP/pages/112427568. It is important to also observe and utilise codes from the ISO 20022 Messaging - TM - ASX Proprietary Code List (43-HoldingAdjustmentReason).
Sample Template
The file below contains a Excel file template which is used to build the CSV submitting to the cURL.
When populating the CSV, the developer is required to ensure:
- The message includes the appropriate Mandatory Fields, Optional Fields and Default Values; and
- Supplied dates are valid business dates.
Connection details
Prior to establishing connection to the ITE1, the Participant will need to generate and submit a Certificate Signing Request and acquire the ASX root / issuing CA public key (instructions are available on the FTP). The Participant is also required to populate the above CSV sample file.
Note |
---|
CSV files submitted to the CSP must be encoded in UTF-8 not UTF-8-BOM. For further details refer here. |
The below code snippet demonstrates how to establish connection to the Self-Service Tool:
Code Block |
---|
language | java |
---|
title | Self Service Tool |
---|
|
curl
// Verbose output
-v
// Informs recipients that the client is about to send a message body in this request and wishes to receive a 100 (continue) interim response
-H "Expect: 100-continue"
// ASX’s CA’s public keys in pem format
--cacert /c/path/to/file.pem
// File containing the certificate of the client machine
--cert /c/path/to/file.cer
// Private key of the client certificate provided in cert option
--key /c/path/to/file.key
// The URL of the Self-Service Tool
"https://ite1-test-tool.asx.com.au:5000/xmlIngest/hold226"
// Header option to accept json format (not the same as the CSV file)
-H "accept: application/json"
// Header option to tell curl command that it will be form-data in other words file as input
-H "Content-Type: multipart/form-data"
// The input CSV file to be sent as part of the request
-F "file=@/c/path/to/file.csv" |
In the above code fragment:
- URL: The URL for the Self-Service Tool is ite1-test-tool.asx.com.au. The local host DNS needs to be reconfigured to 203.4.179.146 to ensure correct routing.
- Port: The port number exposed for the Self-Service Tool.