Invoice_Search Schema
Documentation {..} JSON XML
Mandatory field
Optional field
Returns a list of invoices based on your search parameters
Header
Document header container
MessageType
string
Enumerated value: Request
Enumerated value: Response
DeviceID
ID of the calling device where applicable. Use for mobile devices such as I-Phones and Android units
string
Minimum length: 0
Maximum length: 100
SubmissionNumber
string
A unique reference used for each API request. The Submission Number is seeded within the Authentication MD5 Value to prevent cloning.
Authentication
Account number, and an MD5 hash "Account number, API Key and Submission Number"
AccNumber
MD5Value
ApplicationID
Unique identiifier for the application making the request. Mandoatory from 10th Dec 2013
string
Minimum length: 1
Maximum length: 100
Body
SearchParameters
ReturnCount
How many records would you like the API to return.
int
Minimum inclusive value: 1
Maximum inclusive value: 200
Offset
int
Page offset. Zero (0) would show results from the begining of the record set. Offset can be used for paging functions.
OrderResultsBy
Which columns should be used for ordering the record set.
string
Enumerated value: InvoiceNumber
Enumerated value: IssueDate
Enumerated value: ClientName
Enumerated value: Total
OrderDirection
Order direction. Ascending (ASC) or Descending (DESC).
string
Enumerated value: ASC
Enumerated value: DESC
InvoiceType
Type of document to return. E.g. invoice, estimate or recurring invoice profile.
string
Enumerated value: INVOICE
Enumerated value: ESTIMATE
Enumerated value: RECURRING
TagName
string
Project tag name associated with the invoice
ShowDeleted
boolean
Show previously deleted invoices. Default is false.
ClientDetails
ClientID
int
Client ID can be used to return all invoices for a given client.
ClientName
string
Whole or part of client company name.
RecurringProfileParent
int
Search by recurring profile ID
InvoiceNumber
string
Search by invoice number
ItemName
string
Search by item name
ItemDescription
string
Search by item description
IssueDateFrom
date
Issued date range from
IssueDateTo
date
Issued date range to
AmountFrom
double
Amount range from
AmountTo
double
Amount range to
Currency
Currency ISO code
string
Maximum length: 3
Status
Invoice status
string
Enumerated value: DRAFT
Enumerated value: SENT
Enumerated value: DISPUTED
Enumerated value: PAIDPART
Enumerated value: PAIDFULL
Enumerated value: ACTIVE
Enumerated value: UNPAID
Enumerated value: DELETED
Enumerated value: AGED
Enumerated value: PAUSED
Enumerated value: AGREED
Enumerated value: DECLINED
PurchaseReference
string
Maximum length: 25
Minimum length: 0
AdditionalParameters
ShowPurchaseRef
boolean
set this to know Purchase Reference for each invoice in the return list
ShowNetAmount
boolean
set this to know Net Amount for each invoice in the return list
ShowVatAmount
boolean
set this to know Vat Amount for each invoice in the return list
Endpoint: https://api.quickfile.co.uk/1_2/invoice/search
Example Request:
We had a problem retrieving a JSON sample for this method, please retry later
Example Response:
Example Request:
We had a problem retrieving an XML sample for this method, please retry later
Example Response:
Other Invoice Methods
Create a new invoice, estimate or recurring invoice template
Delete an invoice, estimate or recurring invoice template
Retrieve a single invoice, estimate or recurring invoice template
Retrieve a URL to for an invoice or estimate PDF document
Search for invoices and estimates using a specific set of search parameters
Send an invoice or estimate by email or snail mail
Accepts or declines an estimate
Creates an invoice from a given estimate
Quick File Limited - Copyright © 2024
QuickFile Accounting | Community | Knowledgebase