Nic: Created page with "== Overview == The Xero '''GetHistoryRepeatingInvoice''' endpoint provides a method to download the history and change logs for a single repeati..."

2024-08-15T01:58:33Z

Created page with "== Overview == The Xero '''GetHistoryRepeatingInvoice''' endpoint provides a method to download the history and change logs for a single repeati..."

New page

== Overview ==

The Xero '''GetHistoryRepeatingInvoice''' [[Xero Accounting Endpoints|endpoint]] provides a method to download the history and change logs for a single repeating invoice.

Two variations of this function exists.
* '''GetHistoryRepeatingInvoice''' works for a single data file.
* '''GetHistoryRepeatingInvoiceDataFile''' is recommended when using the consolidation OData Feed.

This function requires a single call to Xero for a single transaction. As such, it should only be used for a few transactions otherwise Xero will quickly impose the [[OdataLink Error Code 9004: Xero imposed a limit of 5000 calls per day on this data file|5000 calls daily limit]].

It is a [[Function Endpoints|function]] that accepts a series of parameters.

== Parameters ==

The GetHistoryRepeatingInvoice is a [[Function Endpoints|function]] that accepts the following parameters.

;DataFile ''(for GetHistoryRepeatingInvoiceDataFile only)''
:A [[Field Type: Text|text field]] that accepts the data file id, name or code.

;RepeatingInvoiceID
:A [[Field Type: GUID|GUID field]] that accepts the id of the repeating invoice.

== Fields ==

The following fields are available for the GetHistoryRepeatingInvoice endpoint.

;DataFileID
:A [[Field Type: GUID|GUID field]] representing the internal id of the data file within OdataLink. This field can be used to link to the [[Endpoint: DataFiles|data files endpoints]].

;DataFileName
:A [[Field Type: Text|text field]] used as the data file name.

;DataFileCode
:A [[Field Type: Text|text field]] used as the data file code.

;RepeatingInvoiceID
:A [[Field Type: GUID|guid field]] that provides the id of the repeating invoice.

;Changes
:A [[Field Type: Text|text field]] that provides the type of change.
:Possible values are:
:* '''Created'''
:* '''Edited'''
:* '''Approved'''
:* '''Reconciled'''
:* '''Deleted'''
:* '''Voided'''
:* '''(other values also possible)'''

;Details
:A [[Field Type: Text|text field]] that provides the details or note of the change.

;User
:A [[Field Type: Text|text field]] that provides the user name of the person that made the changes.

;DateUTC
:A [[Field Type: DateTimeOffset|date time field]] that indicates the date and time the changes were made.

== Xero API ==

For a detailed run through of the endpoint, you can see the [https://developer.xero.com/documentation/api/accounting/historyandnotes Xero API].

== Related Fields ==

:None

== Related Endpoints ==

:[[Xero Accounting Endpoint: RepeatingInvoices|RepeatingInvoices]]

== Related Topics ==

:[[Xero Accounting Models]]
:[[Xero Accounting Endpoints]]

Xero Accounting Endpoint: GetHistoryRepeatingInvoice - Revision history

Nic: Created page with "== Overview == The Xero '''GetHistoryRepeatingInvoice''' endpoint provides a method to download the history and change logs for a single repeati..."