POST /Receipts/{ReceiptID}

Unique identifier for a Receipt

Default value: "application/json"

Xero identifier for Tenant

This allows you to safely retry requests without the risk of duplicate processing. 128 character max.

e.g. unitdp=4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts

Line amounts are exclusive of tax by default if you don’t specify this element. See Line Amount Types

Possible values:

• "Inclusive"
• "Exclusive"
• "NoTax"

Date of receipt – YYYY-MM-DD

URL link to a source document – shown as “Go to [appName]” in the Xero app

Displays array of warning messages from the API

Validation error message

Boolean to indicate if user is the subscriber

Xero identifier

Email address of user

User role that defines permissions in Xero and via API (READONLY, INVOICEONLY, STANDARD, FINANCIALADVISER, etc)

Possible values:

• "INVOICEONLY"
• "FINANCIALADVISER"
• "CASHBOOKCLIENT"
• "READONLY"
• "UNKNOWN"
• "STANDARD"
• "MANAGEDCLIENT"
• "REMOVED"

Last name of user

First name of user

Timestamp of last change to user

Xero generated unique identifier for receipt

Xero generated sequence number for receipt in current claim for a given user

Total of receipt tax inclusive (i.e. SubTotal + TotalTax)

Additional reference number

Total tax on receipt

LineItem Quantity

LineItem Unit Amount

The tax amount is auto calculated as a percentage of the line amount (see below) based on the tax rate. This value can be overriden if the calculated is not correct.

See Accounts

The Xero identifier for a Repeating Invoice

LineItem unique ID

Description needs to be at least 1 char long. A line item with just a description (i.e no unit amount or quantity) can be created by specifying just a element that contains at least 1 character

The tax type from TaxRates

The type of taxability

Possible values:

• "NOT_APPLICABLE"
• "EXEMPT"
• "PART_TAXABLE"
• "TAXABLE"
• "NON_TAXABLE"

An array of tax components defined for this line item

The unique ID number of this component

The name of the jurisdiction

The type of the jurisdiction

Possible values:

• "SYSGST/USSPECIAL"
• "SYSGST/USCOUNTRY"
• "SYSGST/USCOUNTY"
• "SYSGST/USSTATE"
• "SYSGST/USCITY"

The amount of the tax

The amount that is taxable

The amount that is not taxable

The percentage of the tax

The amount that is exempt

The state assigned number of the jurisdiction

Name identifying the region within the country

If you wish to omit either the Quantity or UnitAmount you can provide a LineAmount and Xero will calculate the missing amount for you. The line amount reflects the discounted price if either a DiscountRate or DiscountAmount has been used i.e. LineAmount = Quantity * Unit Amount * ((100 - DiscountRate)/100) or LineAmount = (Quantity * UnitAmount) - DiscountAmount

The associated account ID related to this line item

The ID of the sales tax code

See Items

Optional Tracking Category – see Tracking. Any LineItem can have a maximum of 2 elements.

The Xero identifier for a tracking category

The name of the tracking category

See Tracking Options

The Xero identifier for a tracking category option

Discount amount being applied to a line item. Only supported on ACCREC invoices and quotes. ACCPAY invoices and credit notes in Xero do not support discounts.

Percentage discount being applied to a line item (only supported on ACCREC invoices – ACC PAY invoices and credit notes in Xero do not support discounts

Last modified date UTC format

Total of receipt excluding taxes

Current status of receipt – see status types

Possible values:

• "AUTHORISED"
• "SUBMITTED"
• "DECLINED"
• "DRAFT"
• "VOIDED"

Displays array of validation error messages from the API

Validation error message

Displays array of attachments from the API

Length of the file content

Include the file with the online invoice

Unique ID for the file

Type of file

URL to the file on xero.com

Name of the file

Bank account number of contact

Website address for contact (read only)

Full name of contact/organisation (max length = 255)

The default sales tracking categories for contacts

The default purchase tracking category name for contacts

The default sales tracking category name for contacts

The default sales line amount type for a contact. Only available when summaryOnly parameter or paging is used, or when fetch by ContactId or ContactNumber.

Possible values:

• "INCLUSIVE"
• "NONE"
• "EXCLUSIVE"

The name of the Tracking Option assigned to the contact under SalesTrackingCategories and PurchasesTrackingCategories

Tax number of contact – this is also known as the ABN (Australia), GST Number (New Zealand), VAT Number (UK) or Tax ID Number (US and global) in the Xero UI depending on which regionalized version of Xero you are using (max length = 50)

The name of the Tracking Category assigned to the contact under SalesTrackingCategories and PurchasesTrackingCategories

Last name of contact person (max length = 255)

true or false – Boolean that describes if a contact that has any AP invoices entered against them. Cannot be set via PUT or POST – it is automatically set when an accounts payable invoice is generated against this contact.

The default purchases tracking categories for contacts

The default purchase tracking category name for contacts

The default sales tracking category name for contacts

UTC timestamp of last update to contact

Name of branding theme

Xero identifier

Always INVOICE

Possible values:

• "INVOICE"

The location of the image file used as the logo on this branding theme

Integer – ranked order of branding theme. The default branding theme has a value of 0

UTC timestamp of creation date of branding theme

true or false – Boolean that describes if a contact has any AR invoices entered against them. Cannot be set via PUT or POST – it is automatically set when an accounts receivable invoice is generated against this contact.

The default purchases line amount type for a contact Only available when summaryOnly parameter or paging is used, or when fetch by ContactId or ContactNumber.

Possible values:

• "INCLUSIVE"
• "NONE"
• "EXCLUSIVE"

Displays array of attachments from the API

Length of the file content

Include the file with the online invoice

Unique ID for the file

Type of file

URL to the file on xero.com

Name of the file

The default purchases account code for contacts

Xero identifier

The tax type from TaxRates

Current status of a contact – see contact status types

Possible values:

• "ARCHIVED"
• "ACTIVE"
• "GDPRREQUEST"

Store certain address types for a contact – see address types

max length = 255

define the type of address

Possible values:

• "STREET"
• "POBOX"

max length = 255

max length = 500

max length = 255

max length = 50, [A-Z], [a-z] only

max length = 500

max length = 500

max length = 500

max length = 50

Status of object

Company registration number (max length = 50)

Store certain phone types for a contact – see phone types

Possible values:

• "DEFAULT"
• "OFFICE"
• "DDI"
• "MOBILE"
• "FAX"

max length = 50

max length = 10

max length = 20

Bank details for use on a batch payment stored with each contact

First name of contact person (max length = 255)

The default sales account code for contacts

This can be updated via the API only i.e. This field is read only on the Xero contact screen, used to identify contacts in external systems (max length = 50). If the Contact Number is used, this is displayed as Contact Code in the Contacts UI in Xero.

The tax type from TaxRates

3 letter alpha code for the currency – see list of currency codes

Possible values:

• "ISK"
• "JMD"
• "LTL"
• "SVC"
• "SAR"
• "EEK"
• "TTD"
• "SBD"
• "SHP"
• "GBP"
• "TRY"
• "MOP"
• "INR"
• "MAD"
• "CUP"
• "CLF"
• "SRD"
• "SZL"
• "IRR"
• "CHF"
• "EUR"
• "KZT"
• "ALL"
• "MZN"
• "CDF"
• "BZD"
• "KES"
• "AOA"
• "NGN"
• "SEK"
• "BND"
• "UYU"
• "BRL"
• "YER"
• "ANG"
• "BYR"
• "MRO"
• "DJF"
• "LSL"
• "BBD"
• "MGA"
• "VND"
• "DOP"
• "TJS"
• "FJD"
• "BGN"
• "TWD"
• "QAR"
• "VES"
• "CNY"
• "AUD"
• "ZMW"
• "WST"
• "MDL"
• "KHR"
• "NZD"
• "AMD"
• "AZN"
• "TZS"
• "GIP"
• "AED"
• "AFN"
• "DZD"
• "PKR"
• "KYD"
• "AWG"
• "BSD"
• "PEN"
• "XAF"
• "NAD"
• "ZWD"
• "BTN"
• "KRW"
• "NPR"
• "FKP"
• "TND"
• "LVL"
• "MWK"
• "JOD"
• "LRD"
• "RSD"
• "SCR"
• "HUF"
• "IDR"
• "LAK"
• "UAH"
• "ZAR"
• "OMR"
• "PGK"
• "SLL"
• "MVR"
• "USD"
• "MXV"
• "MKD"
• "COP"
• "CAD"
• "KMF"
• "MXN"
• "PYG"
• "XCD"
• "STD"
• "IQD"
• "TOP"
• "VEF"
• "VUV"
• "SOS"
• "CVE"
• "CUC"
• "KGS"
• "TMT"
• "THB"
• "BOB"
• "UZS"
• "BYN"
• "SKK"
• "ILS"
• "PLN"
• "RON"
• "BHD"
• "BIF"
• "SLE"
• "XPF"
• "ARS"
• "GTQ"
• "RUB"
• "HKD"
• "ZMK"
• "RWF"
• "BDT"
• "ETB"
• "LYD"
• "JPY"
• "SGD"
• "STN"
• "MNT"
• "NIO"
• "GEL"
• "MUR"
• "NOK"
• "ERN"
• "SYP"
• "MYR"
• "DKK"
• "HRK"
• "CLP"
• "GNF"
• "GMD"
• "BAM"
• "HTG"
• "LBP"
• "PHP"
• "EGP"
• "SDG"
• "CRC"
• "CZK"
• "KWD"
• "KPW"
• "GHS"
• "GYD"
• "LKR"
• "BMD"
• "BWP"
• "MRU"
• "PAB"
• "UGX"
• "MMK"
• "XOF"
• "HNL"

A boolean to indicate if a contact has an validation errors

Default value: false

A user defined account number. This can be updated via the API and the Xero UI (max length = 50)

The raw AccountsReceivable(sales invoices) and AccountsPayable(bills) outstanding and overdue amounts, not converted to base currency (read only)

Store XeroNetworkKey for contacts.

The default discount rate for the contact (read only)

ID for the destination of a merged contact. Only returned when using paging or when fetching a contact by ContactId or ContactNumber.

Displays validation errors returned from the API

Validation error message

Email address of contact person (umlauts not supported) (max length = 255)

A boolean to indicate if a contact has an attachment

Default value: false

Day of Month (0-31)

Possible values:

• "DAYSAFTERBILLMONTH"
• "OFCURRENTMONTH"
• "DAYSAFTERBILLDATE"
• "OFFOLLOWINGMONTH"

Day of Month (0-31)

Possible values:

• "DAYSAFTERBILLMONTH"
• "OFCURRENTMONTH"
• "DAYSAFTERBILLDATE"
• "OFFOLLOWINGMONTH"

Displays which contact groups a contact is included in

The Name of the contact group. Required when creating a new contact group

The Status of a contact group. To delete a contact group update the status to DELETED. Only contact groups with a status of ACTIVE are returned on GETs.

Possible values:

• "DELETED"
• "ACTIVE"

The Xero identifier for an contact group – specified as a string following the endpoint name. e.g. /297c2dc5-cc47-4afd-8ec8-74990b8761e9

The ContactID and Name of Contacts in a contact group. Returned on GETs when the ContactGroupID is supplied in the URL.

See contact persons

boolean to indicate whether contact should be included on emails with invoices etc.

Email address of person

Last name of person

First name of person

boolean to indicate if a receipt has an attachment

Default value: false