- Home
- /
- Value added services
- /
- Request Action Date
Request Action Date
Overview
RequestActionDate is a web service method that allows a remote system to confirm the next available action date for a given service instruction.
This service relates to the Debit order, Salary -and Creditor payments services only.
Programmers Guide
To start, refer our Programmers guide for more detail on how to apply the required methodology in this document.
Please ensure that the settings for Developers are correctly set before you proceed with the implementation below specification.
Technical Information
From your application call:
- Web service: https://ws.netcash.co.za/NIWS/NIWS_NIF.svc
- Method: RequestActionDate
- Service key: Salary/Creditor/Debit Order service key
Input
Submit the following parameters.
Field | Description |
---|---|
Service key | Salary/Creditor/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 |
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)
Testing
See Testing section for more details. If you require any integration assistance contact our technical support team
Version 2020.1
Copyright © 2022 Netcash (PTY) Ltd