Xero - Create invoice with one line item action

The Create invoice with one line item action allows you to create a new invoice in Xero with a single line item entry. This action is typically used with the Upsert line item to bill or invoice action to create invoices with multiple line items.

Create invoice with one line item actionXero - Create invoice with one line item action

Input

Input fieldDescription
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.
ReferenceProvide an additional reference for the invoice.
DescriptionEnter a description for the line item. Ensure it is at least one character and a maximum of four thousand characters.
Item nameSpecify the name of the line item. Click Products and services to retrieve the item name. If you provide both the item name and code, the item code takes precedence.
QuantityEnter the quantity of the line item. Provide at least two fields out of Quantity, Unit price or Line amount.
Unit priceSet the unit price for the line item. Provide at least two fields out of Quantity, Unit price or Line amount.
Line amountEnter the total amount for the line item. Provide at least two fields out of Quantity, Unit price or Line amount.
Discount rateApply a discount rate to the line item if applicable.
Account codeAssign an account code from your Chart of accounts to the line item.
Tax type nameSpecify the tax type. Click Settings > General settings > Tax rates to find the tax type name.
Tax amountEnter the tax amount for the line item. This field is auto-calculated as a percentage of the line amount based on the tax rate.
Item codeProvide 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: