Xero Accounting Endpoint: InvoicesExpandedTable
Overview
The Xero InvoicesExpandedTable endpoint provides the list of invoices (both sales and purchases) recorded within Xero.
This endpoints provides access to all fields and details. It is also optimised for larger data files.
In most situations, it is recommended to use this endpoint instead of the Invoices endpoint.
Note this endpoint is an alternate format of the InvoicesExpanded endpoint. It provides a format that can more easily integrate with Tableau, SSIS and Azure Data Factory.
Fields
The following fields are available for the InvoicesExpandedTable endpoint.
- DataFileID
- A guid field that provides the id of the xero data file as setup in OdataLink.
- DataFileName
- A text field provides the name of the xero data file as setup in OdataLink.
- DataFileCode
- A text field provides the code of the xero data file as setup in OdataLink.
- InvoiceID
- A guid field that provides the id of the invoice.
- Type
- A text field that indicates the type of invoice
- Possible values are:
- ACCPAY: Indicates the invoice is for accounts payable / supplier side.
- ACCREC: Indicates the invoice is for accounts receivable / customer side.
- InvoiceNumber
- A text field that provides the invoice number.
- Reference
- A text field that provides the reference of the invoice.
- Status
- A text field that indicates the status of the invoice.
- Possible values are:
- DRAFT: Indicates the invoice is a draft.
- SUBMITTED: Indicates the invoice is awaiting approval.
- AUTHORISED: Indicates the invoice is approved and awaiting payment or partially paid.
- PAID: Indicates the invoice is completely paid.
- VOIDED: Indicates the invoice is voided.
- DELETED: Indicates the invoice is deleted.
- Date
- A date field that provides the date on which the invoice occurred.
- DueDate
- A date field that provides the due date of the invoice.
- ExpectedPaymentDate
- A date field that provides the expected payment date of the invoice.
- Only applies to sales invoice.
- PlannedPaymentDate
- A date field that provides the planned payment date of the invoice.
- Only applies to bills invoice.
- FullyPaidOnDate
- A date field that provides the date the invoice was fully paid.
- ContactID
- A GUID field representing the internal id of a contact.
- ContactName
- A text field provides the name of the contact
- LineAmountTypes
- A text field that indicates the type of values on the lines.
- Possible values are:
- Exclusive: Indicates that line items are exclusive of tax.
- Inclusive: Indicates that line items are inclusive tax.
- NoTax: Indicates that line items have no tax.
- LineID
- A guid field that provides an ID for the line.
- This field can be linked with the LinkedTransactions endpoint to determine how billable expenses on purchase invoices are applied to sales invoices.
- LineDescription
- A text field that provides the description of the line.
- LineQuantity
- A decimal field that provides the quantity of the line.
- LineUnitAmount
- A decimal field that provides the unit amount of the line.
- LineAmount
- A decimal field that provides the amount of the line.
- LineTaxAmount
- A decimal field that provides the tax amount of the line.
- LineDiscountRate
- A decimal field that provides the discount rate applied to the line.
- LineAccountID
- A guid field that provides the account id of the line.
- LineAccountCode
- A text field that provides the account code of the line.
- LineItemID
- A guid field that provides the item id of the line.
- LineItemCode
- A text field that provides the item code of the line.
- LineItemName
- A text field that provides the item name of the line.
- LineTaxType
- A text field that provides the tax type of the line.
- LineTracking
- A table field that provides the tracking category options assigned to the line.
- TrackingCategory1ID
- A GUID field representing the internal id of a tracking category.
- TrackingCategory1Name
- A text field provides the name of the tracking category.
- TrackingOption1Name
- A text field provides the option of the tracking category.
- TrackingCategory2ID
- A GUID field representing the internal id of a tracking category.
- TrackingCategory2Name
- A text field provides the name of the tracking category.
- TrackingOption2Name
- A text field provides the option of the tracking category.
- Subtotal
- A decimal field that provides the tax exclusive amount of the transaction.
- TotalTax
- A decimal field that provides the tax amount of the transaction.
- Total
- A decimal field that provides the total amount of the transaction.
- AmountDue
- A decimal field that provides the total amount due.
- AmountPaid
- A decimal field that provides the total amount paid.
- AmountCredited
- A decimal field that provides the total amount credited.
- CurrencyCode
- A text field that indicates the currency of the transaction.
- CurrencyRate
- A decimal field that provides the exchange rate applied to the transaction.
- HasAttachments
- A true/false field that indicates if attachments were uploaded against the transaction.
- SentToContact
- A true/false field that indicates if the invoice has been sent to the contact.
- CISDeduction
- A decimal field that provides the CIS deduction amount (UK only).
- RepeatingInvoiceID
- A guid field that indicates the repeating invoice id of the invoice.
- BrandingThemeID
- A guid field that indicates the branding theme of the invoice.
- Url
- A text field that provides the url of the uploaded document.
- UpdatedDateUTC
- A date time field that indicates the date and time this invoice was created and/or updated.
Xero API
For a detailed run through of the endpoint, you can see the Xero API.
Related Fields
Related Endpoints
- Accounts
- BrandingThemes
- Contacts
- ContactsExpanded
- CreditNotes
- CreditNotesExpanded
- Currencies
- Items
- Invoices
- LinkedTransactions
- Overpayments
- OverpaymentsExpanded
- Payments
- Prepayments
- PrepaymentsExpanded
- Projects
- PurchaseOrders
- Quotes
- RepeatingInvoices
- TaxRates
- TrackingCategories