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)
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.
Testing
See the Testing section for more details. If you require any integration assistance contact our technical support team