Function: CreatePayeeInfoAutoIdap

The CreatePayeeInfoAutoIdap function creates a payee with basic information and returns an auto-generated payee ID (idap). The payee values that you input must match the details in the payee's bank records.

EAT Encryption Additional Terms parameter: street1
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=utf8

Content-Length: length

<?xml version="1.0" encoding="utf8"?>

<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/soapenvelope">

<soap12:Body>

<payerName>string</payerName>

<timestamp>double</timestamp>

<key>string</key>

<skipNulls>boolean</skipNulls>

<item>

<FirstName>string</FirstName>

<LastName>string</LastName>

<Street1>string</Street1>

<Street2>string</Street2>

<City>string</City>

<State>string</State>

<Zip>string</Zip>

<Country>string</Country>

<Email>string</Email>

<Alias>string</Alias>

<Company>string</Company>

<PreferredPayerEntity>string</PreferredPayerEntity>

<ApAccountNumber>string</ApAccountNumber>

<PayerEntityName>string</PayerEntityName>

<PaymentTermId>string</PaymentTermId>

<CountryName>string</CountryName>

<ErpCurrency>string</ErpCurrency>

<PayeeEntityType>string</PayeeEntityType>

<MiddleName>string</MiddleName>

<ApAccountExternalId>string</ApAccountExternalId>

<Language>string<Language>

<SendSupplierPortalInvite>boolean</SendSupplierPortalInvite>

</item>

</CreatePayeeInfoAutoIdap>

</soap12:Body>

</soap12:Envelope>

SOAP 1.2: Response

HTTP/1.1 200 OK

Content-Type: application/soap+xml; charset=utf8

Content-Length: length

<?xml version="1.0" encoding="utf8"?>

<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/soapenvelope">

<soap12:Body>

<errorMessage>string</errorMessage>

<errorCode>string</errorCode>

<b>boolean</b>

<i>integer</i>

<d>double</d>

<s>string</s>

<createdIdap>string</createdIdap>

</CreatePayeeInfoAutoIdapResult>

</CreatePayeeInfoAutoIdapResponse>

</soap12:Body>

</soap12:Envelope>

Request parameters

element	description	limitation	Mandatory?	data type
payerName	The name of the payer, as assigned by Tipalti	Max. length = 50 Value is case sensitive	Mandatory	string
timestamp	Current time (UTC) when the request is sent	Unix time	Mandatory	double
key	Encryption key		Mandatory	string
skipNulls	If skipNulls=TRUE, this service ignores parameters with a null value. If skipNulls=FALSE, the null values overwrite existing values.		Mandatory	boolean
item	List of payee details		Optional	PayeeDetailsItem

PayeeDetailsItem

Element	Description	limitation	Mandatory?	data type
FirstName	Payee first name	Max. length = 70 Valid characters: Latin and numeric (cannot be only numeric) Spaces, periods, dashes (cannot be the first character)—e.g., "Mary Jo", "Jr.", "Mary-Jo"	Mandatory (without a company name value) Optional (with a company name value)	string
LastName	Payee last name	Max. length = 70 Valid characters: Latin and numeric (cannot be only numeric) Spaces, periods, dashes (cannot be the first character)—e.g., "Mary Jo", "Jr.", "Mary-Jo"	Mandatory (without a company name value) Optional (with a company name value)	string
Street1	Payee street address line 1	Max. length = 35 Valid EBCDIC values: Letters, numbers and special characters ^[\w\d\/\-\?\:\.\,\'\+ ]+$"	Optional	string
Street2	Payee street address line 2	Max. length = 35 Valid EBCDIC values: Letters, numbers and special characters ^[\w\d\/\-\?\:\.\,\'\+ ]+$"	Optional	string
City	Payee city	Max. length = 30 Valid EBCDIC values: Letters, numbers and special characters ^[\w\d\/\-\?\:\.\,\'\+ ]+$"	Optional	string
State	Payee state/ province	For payees in the US, Canada, or Mexico Value can be null, 2 letters, or 3 letters (per ISO 3166)	Optional	string
Zip	Payee zip/ postal code	No spaces (e.g., N1W 8H5 is N1W8H5) Dashes allowed	Optional	string
Country	Payee country	Length = 2 (per ISO 3166)	Optional	string
Email	Payee email address	Max. length = 200 Valid email format (e.g., [email protected])	Optional	string
Alias	An alternate name for the payee, if applicable	Max. length = 250	Optional	string
Company	Payee company name	Max. length = 70 Valid characters: Latin and numeric (cannot be only numeric) Spaces, periods, dashes (cannot be the first character)—e.g., "Company 24", "Company Inc.", "12-up"	Mandatory (without payee first and last name values) Optional (with payee first and last name values)	string
PreferredPayerEntity	The payer entity linked to the payee The field name is the "Entity name" defined in Tipalti, or "Default" (to use the payer's default entity).	Max. length = 100 Alphanumeric characters only	Optional	string
ApAccountNumber	The default GL account number (credited with invoice amounts) to link to the payee	Max. length = 450	Mandatory, if multiple AP accounts have been defined in Tipalti	string
PayerEntityName	The payer's default entity	Max. length = 100 Alphanumeric characters only	Optional	string
PaymentTermId	The ID associated with the payment term	Max. length = 40	Mandatory	string
CountryName	The name of the payee country (as used in the Tipalti Hub and iFrame)		Optional	string
ErpCurrency	The payer's QuickBooks Online vendor currency	Once a value is set, it cannot be changed. Length = 3 (per ISO 4217)	Mandatory, if the payee is the payer's QuickBooks Online vendor.	string
PayeeEntityType	The type of payee: Individual Company	Valid values: Individual Company	Optional	string
MiddleName	Payee middle name	Max. length = 70 Valid characters: Latin and numeric (cannot be only numeric) Spaces, periods, dashes (cannot be the first character)—e.g., "Mary Jo", "Jr.", "Mary-Jo"	Optional	string
ApAccountExternalId	An ID that uniquely identifies the GL account (e.g., in NetSuite, it is the "Internal ID")	Max. length = 100	Mandatory	string
Language	The preferred language for the payee This language is used in email communication, including the Supplier Hub invite and will be the language used in the iFrame and Supplier Hub user interface Note: If you enter an unsupported language, English will be presented to the payee.	Supported languages and values: Arabic - ar (needs to be enabled by our Support Team) Bulgarian - bg Chinese - zh-CHS Czech - cs Danish - da Dutch - nl English - en English UK - en-gb Finnish - fi French - fr German - de Greek - el Hungarian - hu Italian - it Japanese - ja Korean - ko Norwegian - nb Polish - pl Portuguese - pt-BR Romanian - ro Russian - ru Slovak - sk Spanish - es Swedish - sv Thai - th Turkish - tr Vietnamese - vi	Optional	string
SendSupplierPortalInvite	Indicates whether to send the payee an invite to register in the Supplier Hub (only sent if the payee has never received an invitation)	Valid values: TRUE FALSE (default)	Optional	boolean

Response parameters

The result of the CreatePayeeInfoAutoIdap function is provided in the "b" parameter.

element	description	data type
CreatePayeeInfoAuto IdapResult	Contains the response parameters	TipaltiCreatePayeeInfoAuto IdapResponse (extension of type TipaltiResponse)

TipaltiCreatePayeeInfoAutoIdapResponse

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
createdIdap	Returns the auto-generated payee ID	Max. length = 64 Valid characters: Numbers Letters Commas Periods Underscores Dashes No spaces allowed	string