Function: GetTipaltiPayeeID
The GetTipaltiPayeeID function returns the unique payee identifier in Tipalti.
The GetTipaltiPayeeID function does not support a one-way sync direction from Tipalti to the ERP.
- EAT Encryption Additional Terms parameter:None
- API version: V9
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 /v9/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>
<GetTipaltiPayeeID xmlns="http://Tipalti.org/">
<payerName>string</payerName>
<payeeExternalId>string</payeeExternalId>
<timestamp>double</timestamp>
<key>string</key>
</GetTipaltiPayeeID>
</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>
<<GetTipaltiPayeeIDResponse xmlns="http://Tipalti.org/">
<GetTipaltiPayeeIDResult>
<errorMessage>string</errorMessage>
<errorCode>string</errorCode>
<b>boolean</b>
<i>integer</i>
<d>double</d>
<s>string</s>
<idap>string</idap>
</GetTipaltiPayeeIDResult>
</GetTipaltiPayeeIDResponse>
</soap12:Body>
</soap12:Envelope>
Request parameters
|
Element |
description |
limitation |
Mandatory? |
data type |
|---|---|---|---|---|
| payerName | The name of the payer, as assigned by Tipalti |
|
Mandatory | string |
| payeeExternalId | The payee ID in the ERP (e.g., in NetSuite it is the vendor ID) | Max. length = 200 | Mandatory | string |
| timestamp |
Current time (UTC) when the request is sent |
Unix time | Mandatory | double |
| key | Encryption key | Mandatory | string |
Response parameters
|
Element |
Description |
Data Type |
|---|---|---|
| GetTipaltiPayeeIDResult | Contains the response parameters | GetTipaltiPayeeIdResult (extension of type TipaltiResponse) |
GetTipaltiPayeeIdResult
|
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 | |
| idap | The Tipalti payee ID |
|
string |