PUT /PurchaseOrders

Default value: "application/json"

Xero identifier for Tenant

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

If false return 200 OK and mix of successfully created objects and any with validation errors

Default value: false

Displays array of warning messages from the API

Validation error message

Total of discounts applied on the purchase order line items

The person that the delivery is going to

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

Last modified date UTC format

The currency rate for a multicurrency purchase order. If no rate is specified, the XE.com day rate is used.

A free text feild for instructions (500 characters max)

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

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"

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 purchase order was issued – YYYY-MM-DD. If the Date element is not specified then it will default to the current date based on the timezone setting of the organisation

Boolean to set whether the purchase order should be marked as “sent”. This can be set only on purchase orders that have been approved or billed

Displays array of warning messages from the API

Validation error message

A string to indicate if a invoice status

The date the goods are expected to arrive.

Additional reference number

Xero generated unique identifier for purchase order

Total tax on purchase order

See LineItems

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

Total of purchase order excluding taxes

See BrandingThemes

See Purchase Order Status Codes

Possible values:

• "DELETED"
• "AUTHORISED"
• "SUBMITTED"
• "DRAFT"
• "BILLED"

Displays array of validation error messages from the API

Validation error message

The phone number for the person accepting the delivery

boolean to indicate if a purchase order has an attachment

Default value: false

The address the goods are to be delivered to

Date the goods are to be delivered – YYYY-MM-DD

Unique alpha numeric code identifying purchase order (when missing will auto-generate from your Organisation Invoice Settings)