Xero - Create invoice with multiple line items action

The Create invoice with multiple line items action allows you to create an invoice in Xero with multiple line items. This action is typically used with the Upsert line item to bill or invoice action to add additional lines to the invoice.

Create invoice with multiple line items actionXero - Create invoice with multiple line items action

Input

Input fieldDescription
ReferenceProvide an additional reference for the invoice.
Contact nameEnter the exact name of the contact you plan to invoice.
First nameSpecify the contact's first name.
Last nameSpecify the contact's last name.
EmailProvide the contact's email address.
Invoice numberEnter a unique invoice number. Xero automatically generates this field if left blank.
DateSet the issue date for the invoice.
Due dateDefine the due date for the invoice. This field is required if the invoice status is set to AUTHORISED or SUBMITTED.
Currency codeEnter the currency code for the invoice amounts.
StatusSelect the initial status of the invoice. This field defaults to DRAFT if left blank.
Branding themeChoose a branding theme to apply to the invoice.
Amounts areIndicate whether the amounts are tax inclusive, exclusive, or no tax. This field defaults to Tax exclusive if left blank.
URLInclude a link to an external document related to the invoice.
Line itemsDetails of the line items for the invoice.
Line items source listInput a list datapill representing the line items for the invoice. Learn more about list input.
Description (line items)Enter a description for the line items. Ensure it is at least one character and a maximum of four thousand characters.
Item name (line items)Specify the name of the line items. Click Products and services to retrieve the item name. If you provide both the item name and code, the item code takes precedence.
Quantity (line items)Enter the quantity of the line items. Provide at least two fields out of Quantity, Unit price or Line amount.
Unit price (line items)Set the unit price for the line items. Provide at least two fields out of Quantity, Unit price or Line amount.
Line amount (line items)Enter the total amount for the line items. Provide at least two fields out of Quantity, Unit price or Line amount.
Discount rate (line items)Apply a discount rate to the line items if applicable.
Account code (line items)Assign an account code from your Chart of accounts to the line items.
Tax type name (line items)Specify the tax type. Click Settings > General settings > Tax rates to find the tax type name.
Tax amount (line items)Enter the tax amount for the line items. This field is auto-calculated as a percentage of the line amount based on the tax rate.
Skip (line items)Use this field to omit a particular line in the invoice.
Item code (line items)Provide the item code. Click Products and services to retrieve the item code. If you provide both the item name and code, the item code takes precedence.

Output

Output fieldDescription
TypeThe type of the document (invoice).
Invoice IDThe unique identifier for the invoice.
Invoice numberThe number of the invoice.
PaymentsDetails of payments associated with the invoice.
Credit notesDetails of credit notes applied to the invoice.
Amount dueThe total amount due on the invoice.
Amount paidThe total amount paid on the invoice.
Amount creditedThe total amount credited to the invoice.
URLThe link to the invoice or associated online resource.
Currency codeThe currency code for the invoice.
Currency rateThe exchange rate for the currency used.
Has errorsIndicates if there are errors related to the invoice.
Is discountedIndicates if a discount has been applied to the invoice.
Has attachmentsIndicates if there are attachments included with the invoice.
ContactContact information for the invoice.
DateThe issue date of the invoice.
Due dateThe due date for payment of the invoice.
StatusThe current status of the invoice.
Branding theme IDThe identifier for the branding theme used in the invoice.
Line amount typesThe type of line amounts on the invoice.
Line itemsDetailed information about each line item on the invoice.
Sub totalThe subtotal amount of the invoice before tax.
Total taxThe total tax amount for the invoice.
TotalThe total amount for the invoice, including tax.
Updated dateThe date when the invoice details were last updated.
Paid dateThe date when the invoice was paid, if applicable.
ReferenceA reference number or note associated with the invoice.

Last updated: