Importing Invoices to Xero

This task will insert or update invoices in Xero from a Xero Invoice XML file.

Settings

Connection

Required
The Xero connection to use. See Connecting to Xero if you require more information on how to create/manage connections.

Auto Create Contacts

Required
Optionally automatically create contacts in Xero based on the provided data.

Alphabetic Length

Required
The length of the alpha part of the contact number.

Contact Numbers Convention

Required
The format to use when generating a contact number. For example, if you select the 'LastNameFirstName' option and in your data the contact name is 'Joe Bloggs', the contact number will be 'JOEB0001'.

Enabled

Required
Enable this task setting to automatically generate contact numbers in Xero based on the given criteria.

Mask

Optional
The content of this setting will be used to prefix all of your account references.

Numeric Length

Required
The length of the numeric part of the contact number.

To Purge

Optional
You can optionally list a series of characters to remove from the contact number.

Contact Number Field

Required
Optionally select to use either the contact number or account number to match contacts. Please note, if you select the AccountNumber option that the contact number will be updated with the account number.

Auto Create Items

Required
Optionally automatically create items in Xero based on the provided data.

Fail File

Required
The file to save failed record imports to.

Input File

Required
The file containing the bank transactions to upload to Xero.

Success File

Required
The file to save successful record imports to.

Prevent Reprocessing

Required
Set to true to prevent the same record being processed more than once, based on the ExternalId provided in the input XML file.

Zynk Settings

See Common Task Settings

Examples

A sample input file with the minimum amount of information required to create an invoice in Xero is shown below. More detailed information about each field can be found in our Xero Invoice XML.

<?xml version="1.0"?>
<ArrayOfXeroInvoice>
  <XeroInvoice>
    <ExternalId>1880</ExternalId>
    <Number>TEST2</Number>
    <Contact>
      <ContactNumber>ZYNK001</ContactNumber>
    </Contact>
    <Type>AccountsReceivable</Type>
    <LineAmountTypes>Exclusive</LineAmountTypes>
    <Date>2014-08-22T00:00:00</Date>
    <DueDate>2014-09-01T00:00:00</DueDate>
    <CurrencyCode>GBP</CurrencyCode>
    <LineItems>
      <LineItem>
        <Description>Product</Description>
        <Quantity>1.0000</Quantity>
        <UnitAmount>25.0000</UnitAmount>
        <AccountCode>200</AccountCode>
      </LineItem>
    </LineItems>
  </XeroInvoice>
</ArrayOfXeroInvoice>