Request Presentation Date is a web service that allows a remote system to confirm the presentation date for a given Action date and service instruction.
The remote system submits the Action date on which the payment or debit is to be applied to the beneficiary or debtor, and the service returns the last possible date on which the batch needs to be authorised to meet the required Action date.
This service relates to the Debit order and Creditor payments services only (Salary and Creditor batches have the same cut-off times).
RequestPresentationDate is an online, synchronous web service that returns the presentation date (the final date for authorisation) for a given action date according to the service instruction parameters.
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_NIF.svc
- Method: RequestPresentationDate
- Service key: Debit Order/Creditor Payments service key
Submit the following parameters.
|Service key||Debit order service key for TwoDay, Sameday, etc.
Creditors service key for Realtime, DatedPayments, etc.
|Date||The proposed action date. Format CCYYMMDD|
|Instruction||The type of batch to be loaded EG: TwoDay – see instructions below|
|ForwardActionDate||0 – Check only the date supplied
1 – Return the next valid action date
The service responds with a valid Action date in the format CCYYMMDD.
Any errors are reported as error codes:
|200||Action date or input parameters invalid|
The current date is 20190521.
The following parameters are submitted:
Debit order service key, 20190521, TwoDay, 1
Response; 20190524 (the next available valid action date for two day debit batches)
If ForwardActionDate is not requested:
Debit order service key, 20190521, TwoDay, 0
Response; 200 (20190521 is no longer a valid action date for two day debit batches)
Netcash brand guidelines
Please refer to the Netcash brand guidelines here when using any logos, images, icons, labels, descriptions, and references to Netcash in your software.