Export Financial Invoices to Xero (CSV)

Export Financial Invoices to Xero (CSV)

Overview

Use this guide to export Financial invoices from MachShip in a CSV format compatible with Xero. The export includes the minimum fields Xero requires for invoice import: Contact name, Invoice Number, Invoice Date, Due Date, Description, Qty, Unit Amount, AccountCode, TaxType.

Tip: Xero will generally create a new Contact during import if the name doesn't already exist. To avoid duplicates, keep contact names consistent with your Xero records — these will match the company name from MachShip.

Important: If your MachShip company names are configured as trading names (e.g., "Acme Anvil SPARES (BNE)") but your Xero contacts use entity names (e.g., "Acme Anvil Spares Pty Ltd"), the names will not match during import. This will result in duplicate contacts being created in Xero. Before importing, you have two options:

  1. Update MachShip company names to match your Xero entity names exactly (recommended for long-term consistency)
  2. Update Xero contact names to match your MachShip trading names (if you don't need the entity names in Xero for legal/accounting purposes)

Best Practice: Before running a full invoice import, test with a small batch first to confirm names are matching correctly and no duplicate contacts are being created in Xero.


Step 1 — Generate the Xero CSV from MachShip

  1. Go to Reports → Financial Reports.

  2. Choose your date filters (this should be the posted date of the invoices).

  3. Click Get Xero Report.

  4. Download the generated .csv file to your computer (this will come in a xip file).

What’s in the export

The CSV contains the minimum required columns for Xero invoice import:

  • Contact name — Customer name as it should appear in Xero - taken from company name

  • Invoice Number — Your unique invoice reference (Xero will use this as the invoice number).

  • Invoice Date — Invoice issue date.

  • Due Date — Invoice due date.

  • Description — Line item description.

  • Qty — Quantity for the line item.

  • Unit Amount — Unit price for the line item.

  • AccountCode — Xero revenue (sales) account code (numeric). (set to 200)

  • TaxType — Xero tax treatment for the line (e.g., GST on Income).


Need help?

If you have questions or run into issues, contact support@machship.com with:

  • The CSV you attempted to import

  • A screenshot of any Xero error messages

  • Your MachShip report filters and date range

We’ll help you resolve it quickly.

    • Related Articles

    • Export Financial Invoices to MYOB (CSV)

      Overview Use this guide to export Financial invoices from MachShip in a CSV format compatible with MYOB. The export includes the minimum fields MYOB requires for invoice import: Co./Last Name, Invoice #, Date, Already Printed, Description, Account #, ...
    • How to Export a Ratecard Version as a Freight Reseller

      There are a number of different methods in which to export a Ratecard Version in MachShip. Video Guide: Step by Step Guide To start, navigate to the View Ratecards page. Select the Admin drop-down and click on Ratecards. How to export multiple ...
    • How to manually create Consignments with unmatched invoices as a Freight Reseller

      Unmatched invoice entries are invoice entries which MachShip is unable to automatically assign to a consignment. Users have options to reject these entries, manually accept the charge and create a consignment, use the entries details to create a new ...
    • How to create a Company (All Fields)

      Companies in MachShip are the basis by which accounts, permission, and access are separated and maintained. Below you will find instructions and explanation on how to create and edit a company if you are a freight reseller. Should any of the fields ...
    • How to put a Consignment on hold for Reconciliation or Invoicing

      After the manifesting process, consignment details are set and a consignment cannot be edited in MachShip. We understand that changes may take place to the physical goods after manifesting and that this could potentially affect the price. In order to ...