Function: GetPayeeInvoiceList

The GetPayeeInvoiceList function returns a list of unpaid invoices/ bills for a specific payee. Use the IncludePaidInvoices parameter to include or exclude paid invoices/ bills.

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

<GetPayeeInvoiceList xmlns="http://Tipalti.org/">

<payerName>string</payerName>

<idap>string</idap>

<timestamp>double</timestamp>

<key>string</key>

<includePaidInvoices>boolean</includePaidInvoices>

</GetPayeeInvoiceList>

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

<GetPayeeInvoiceListResponse xmlns="http://Tipalti.org/">

<GetPayeeInvoiceListResult>

<errorMessage>string</errorMessage>

<errorCode>string</errorCode>

<PayeeInvoices>

<PayeeInvoiceStatus>

<RefCode>string</RefCode>

<ApprovalStatus>string</ApprovalStatus>

<PaymentStatus>string</PaymentStatus>

<TotalAmount>double</TotalAmount>

<PaidAmount>double</PaidAmount>

<UnpaidAmount>double</UnpaidAmount>

<InvoiceNumber>integer</InvoiceNumber>

</PayeeInvoiceStatus>

<PayeeInvoiceStatus>

<RefCode>string</RefCode>

<ApprovalStatus>string</ApprovalStatus>

<PaymentStatus>string</PaymentStatus>

<TotalAmount>double</TotalAmount>

<PaidAmount>double</PaidAmount>

<UnpaidAmount>double</UnpaidAmount>

<InvoiceNumber>integer</InvoiceNumber>

</PayeeInvoiceStatus>

</PayeeInvoices>

</GetPayeeInvoiceListResult>

</GetPayeeInvoiceListResponse>

</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
idap Unique payee identifier (the payee ID)
  • Max. length = 64
  • Valid characters:
    • Numbers
    • Letters
    • Commas
    • Periods
    • Underscores
    • Dashes
  • No spaces allowed
 Mandatory string
timestamp

Current time (UTC) when the request is sent

 Unix time Mandatory double
key Encryption key   Mandatory string
includePaidInvoices If TRUE, paid invoices/ bills are included on the returned list   Mandatory boolean

Response parameters

element

description

data type
GetPayeeInvoiceListResult Contains the response parameters TipaltiPayeeInvoiceStatusResponse

TipaltiPayeeInvoiceStatusResponse

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
PayeeInvoices
  • List of payee invoices/ bills
  • Each invoice/ bill is of type PayeeInvoiceStatus
 Only displays after invoices/ bills have been reviewed Array of PayeeInvoiceStatus
PayeeInvoiceStatus

element

description

limitation

data type
RefCode The reference code for the invoice
  • ASCII: max. length = 16 (Account Direction model: max. length = 15)
  • Valid special characters: hyphens, underscores
 string
ApprovalStatus
  • Invoice approval status
  • Approved—if bill status is "Pending payment", "Paid" or "Submitted for payment"
  • Declined— if bill status is "Deleted" or "Disputed"

Valid values:

  • None
  • Approved
  • Declined
string
PaymentStatus Payment status of the invoice

Valid values:

  • Unpaid
  • Paid
  • PartiallyPaid
string
TotalAmount Total amount of the invoice   double
PaidAmount Amount already paid for the invoice   double
UnpaidAmount Unpaid amount of the invoice   double
InvoiceNumber The number of the invoice Max. length = 256 integer