|
The Self-Service Investor Data and Foreign Tax Status Advice Tool is provided to the Issuer (Registries) to act as a Participant via upload of a configurable CSV file, which will be consumed and validated by the CSP.
By updating the field details of an Investor Data and Foreign Tax Status Details (acct_012) message in the CSV file, developers are able to perform different account management test scenarios.
This service allows developers to submit a fixed CSV file containing the account management information using a cURL command to a REST endpoint.
The REST endpoint translates the CSV file to a ISO XML message (Investor Data and Foreign Tax Status Details (acct_012)) which is then submitted to the CSP.
The Self-Service Tool will be provided to the Issuer (Registries) to act as a Participant to receive an Investor Data and Foreign Tax Status Advice (acct_012) for a TFN that was added.
On success the related Issuer (Registry) will receive an Investor Data and Foreign Tax Status Advice (acct_012) for a TFN that was added.
If the CSV submitted by the Issuer (Registry) acting as a Participant is invalid due to errors in the business validity, an Invalid Transaction (comm_808) is received.
If the CSV submitted by the Issuer (Registry) acting as a 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 Investor Data functional specification.
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:
Self-Service Investor Data and Foreign Tax Status Advice.zip |
Prior to establishing connection to the ITE1, the Issuer (Registry) acting as a 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 Issuer (Registry) acting as a Participant is also required to populate the CSV sample file above.
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:
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/acct012" // 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:
This section contains a horizontal line break, any text you put here will be below that break