> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Xero

> Learn how to push your invoicing data in your accounting tool

[Xero](https://www.xero.com) is a New Zealand–based technology company that provides cloud-based accounting software for small businesses.

## Prerequisites

You need to have a valid [Xero account](https://www.xero.com) and admin rights on Hyperline.

## Setup

<Steps>
  <Step title="In Hyperline, navigate to the Settings > Integrations page" />

  <Step title="Click Connect on the Xero card" />

  <Step title="Authenticate on Xero">
    If you are not already logged into Xero, enter your Xero credentials to proceed.
  </Step>

  <Step title="Select the organisation you wish to connect">
    Choose the organisation you want to link to Hyperline, then click Allow
    access.

    <Note>
      By default, **your default invoicing entity** will be linked to this
      organisation. If you want to link a different entity, please contact our
      support team.
    </Note>
  </Step>

  <Step title="That's it!">
    Your Hyperline account is ready to send invoices and credit notes.
  </Step>
</Steps>

## Reconcile Hyperline and Xero customers

If you already have existing customers in Xero, we'll need to link them with the corresponding customers in Hyperline. Our support team is available to assist you with this process during onboarding.

## Synchronization

When you connect your Xero account, Hyperline **automatically sends invoices** with their complete details (including line items and PDF file).

<Note>
  By default, only invoices and customers created after the connection date will sync. If you need to push older data to Xero, please contact our support team.
</Note>

### Invoice PDF synchronization

Invoice PDFs are automatically attached to invoices in Xero when they are first synced. If you need to re-attach or update PDFs for existing invoices (for example, if the initial attachment failed), please contact our support team.

### Customer synchronization

Hyperline supports 2 modes of synchronization for customers:

* **no synchronization**: customers are not synchronized with Xero.
* **from Hyperline to Xero**: customers created in Hyperline are automatically created in Xero with their details. When a customer is updated in Hyperline, the changes are automatically synced to Xero in real-time.

### Payment synchronization

Hyperline supports 3 modes of synchronization for payments:

* **no synchronization**: payments are not synchronized with Xero.
* **from Hyperline to Xero**: payments created in Hyperline are automatically created in Xero and associated to the corresponding invoice.
* **from Xero to Hyperline**: payments created in Xero are automatically created in Hyperline, and the status of the invoice is updated accordingly.

The synchronization delay is 5 minutes maximum.

## Settings

Please contact our support team if you wish to change these settings.

* **Invoice account code**: by default, invoices are created in Xero using the account code *200*.
* **Credit note account code**: by default, credit notes are created in Xero using the account code *200*.
* **Payment account code**: by default, payments are created in Xero using the account code *001*.

## Product and account codes

Xero supports associating a product code and an account code to every invoice line item. You will need to configure the product code and the General Ledger account code for every product that you intend to invoice in Xero, in the **Products > Advanced settings** section.

If no account code is defined, the default invoice or credit note account code will be used.