Function: GetPayeesChangedSinceTimestamp
The GetPayeesChangedSinceTimestamp function returns the IDs of all payees whose information has changed after a given date.
- EAT Encryption Additional Terms parameter: timestamp from when to start the system check (in UTC Coordinated Universal Time)
- API version: V8
The following is a sample SOAP 1.2 request and response. In the request, you need to replace the data types in yellow with actual values.
SOAP 1.2: Request
POST /v8/payeefunctions.asmx HTTP/1.1
Host: api.tipalti.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetPayeesChangedSinceTimestamp xmlns="http://Tipalti.org/">
<payerName>string</payerName>
<timestamp>double</timestamp>
<key>string</key>
<changedSince>double</changedSince>
</GetPayeesChangedSinceTimestamp>
</soap12:Body>
</soap12:Envelope>
SOAP 1.2: Response
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetPayeesChangedSinceTimestampResponse
xmlns="http://Tipalti.org/">
<GetPayeesChangedSinceTimestampResult>
<errorMessage>string</errorMessage>
<errorCode>string</errorCode>
<b>boolean</b>
<i>integer</i>
<d>double</d>
<s>string</s>
<changedIds>
<string>string</string>
<string>string</string>
</changedIds>
</GetPayeesChangedSinceTimestampResult>
</GetPayeesChangedSinceTimestampResponse>
</soap12:Body>
</soap12:Envelope>
Request parameters
|
field |
description |
limitation |
Mandatory? |
data type |
|---|---|---|---|---|
| payerName | The name of the payer, as assigned by Tipalti |
|
Mandatory | string |
| timestamp |
Current time (UTC) when the request is sent |
Unix time | Mandatory | double |
| key | Encryption key | Mandatory | string | |
| changedSince | The starting date to return all changed payees | Unix time | Mandatory | double |
Response parameters
|
Element |
Description |
Data Type |
|---|---|---|
| GetPayeesChangedSince TimestampResult |
Contains the response parameters | TipaltiChangedPayeeIdsResponse (extension of type TipaltiResponse) |
TipaltiChangedPayeeIdsResponse
|
element |
description |
limitation |
data type |
|---|---|---|---|
| errorMessage | A description of the error | See API error codes. | string |
| errorCode | The status of the error | See API error codes. | string |
| b | If the return code is Boolean, this parameter will carry the value. | boolean | |
| i | If the return code is integer, this parameter will carry the value. | integer | |
| d | If the return code is double, this parameter will carry the value. | double | |
| s | If the return code is string, this parameter will carry the value. | string | |
| changedIDs | List of payee IDs | Array of string |
string
|
Element |
description |
limitation |
data type |
|---|---|---|---|
| string | Unique payee identifier (the payee ID) |
|
string |