Request Action Date - Netcash

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.

Web Service Methods

The list of Netcash web service methods can be found here

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

Service	Instruction	Service deadline
Debit orders	TwoDay Sameday CompactTwoDay CompactSameday	See Deadline
Payments	Realtime DatedPayments CompactRealtime	See Deadline

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

Netcash may provide example/sample/demo ‘code snippets’ and/or external links in this Technical Document. Such are for guidance purposes only and may not function on every developer’s system/s. Netcash disclaims any and all liability for the usage of guidance resources provided -and you as the Developer; must accept full responsibility for the usage of such. While every possible effort has been taken to ensure compatibility across multiple system configurations, the contents of this document cannot be guaranteed to work on all systems, with all operating systems -and/or with all system configuration/s.

Version 2020.1