Overview
Request Action date is a web service which allows a remote system to confirm the next available action date for a given service instruction.
This service relates to the Debit order and Creditor payments services only.
Alternatively, 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.
Technical Information
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_NIF.svc
- Method: RequestActionDate
- Service key: Debit Order service key
Input
Submit the following parameters.
| Field | Description |
|---|---|
| Service key | Debit Order service key issued by Netcash |
| 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 |
| Service | Instruction |
|---|---|
| Debit orders | TwoDay Sameday CompactTwoDay CompactSameday |
Output
The service responds with a valid Action date in the format CCYYMMDD.
Any errors are reported as error codes:
| Numeric Response | Description |
|---|---|
| 100 | Authentication failed |
| 200 | Action date or input parameters invalid |
Examples
The current date is 20190521.
The following parameters are submitted:
Debit order service key, 20190521, TwoDay, 1
20190524
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
200
Response; 200 (20190521 is no longer a valid action date for two day debit batches)