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

# Xero

> Export General Ledger Detail from Xero as Excel and upload it to Fyvel

### Overview

This page describes the import from **Xero**: you export the **General Ledger Detail** report as an Excel file and upload it to Fyvel.

An overview of every import path is on [Uploads](/en/documentation/getting-started/uploads).

<Note>
  Each upload fully replaces the previous Xero state of this company. The export must therefore cover the entire period you want to keep in Fyvel — not only the latest month. Categories you already assigned are kept, as long as the booking is in the export again.
</Note>

### Open the report

1. In Xero, open **Reporting**.
2. Under **Taxes and balances**, choose **General Ledger Detail**.

<Frame caption="General Ledger Detail under Taxes and balances">
  <img src="https://mintcdn.com/fynancegmbh/HyvKy4XKcnammuKp/images/getting-started/Xero/step-1.png?fit=max&auto=format&n=HyvKy4XKcnammuKp&q=85&s=63a4496a72d7f2f4e35afd0eaf639ecc" alt="Xero Reports: General Ledger Detail under Taxes and balances" width="2048" height="1524" data-path="images/getting-started/Xero/step-1.png" />
</Frame>

### Select all accounts

Under **Accounts**, click **Select all**. Every account must be in the export. If an account is missing, the bookings do not balance and Fyvel rejects the file.

<Frame caption="Select all accounts">
  <img src="https://mintcdn.com/fynancegmbh/HyvKy4XKcnammuKp/images/getting-started/Xero/step-2.png?fit=max&auto=format&n=HyvKy4XKcnammuKp&q=85&s=101773b1673d44677f2173d926f52e7a" alt="Account selection in Xero with Select all" width="2257" height="1663" data-path="images/getting-started/Xero/step-2.png" />
</Frame>

### Set the date range

Under **Date range**, choose the start and the end. Take the first month you want to report in Fyvel through the current month.

After the change, click **Update** so the report shows the new range.

<Frame caption="Date range from the start through today">
  <img src="https://mintcdn.com/fynancegmbh/HyvKy4XKcnammuKp/images/getting-started/Xero/step-3.png?fit=max&auto=format&n=HyvKy4XKcnammuKp&q=85&s=25876eaf4ed9e77b3b213b689f9d1012" alt="Date selection in the Xero General Ledger Detail report" width="2048" height="1508" data-path="images/getting-started/Xero/step-3.png" />
</Frame>

### Columns

Under **Columns**, tick every column shown in the screenshot:

* Account, Account Code, Account Type
* Credit, Debit, Gross, Net
* Date, Description, Reference, Source
* Department
* Invoice Number, Journal ID, Related account
* Running Balance
* Tax, Tax Rate, Tax Rate Name

If one of these columns is missing, Fyvel cannot read the file. You need **Department** if you want to bring cost centers over from Xero.

<Frame caption="Select all columns">
  <img src="https://mintcdn.com/fynancegmbh/HyvKy4XKcnammuKp/images/getting-started/Xero/step-4.png?fit=max&auto=format&n=HyvKy4XKcnammuKp&q=85&s=d5192e81a527a502e59cde5c137a8abc" alt="Column selection in the Xero report with every box ticked" width="2259" height="1660" data-path="images/getting-started/Xero/step-4.png" />
</Frame>

### Do not group

Under **Grouping/Summarizing**, **Group by** must be **None**. Not **Account** or **Account Code & Name**, and not **Summarize by**. Otherwise the file contains total rows instead of the individual bookings.

<Frame caption="Group by set to None">
  <img src="https://mintcdn.com/fynancegmbh/HyvKy4XKcnammuKp/images/getting-started/Xero/step-5.png?fit=max&auto=format&n=HyvKy4XKcnammuKp&q=85&s=c743ee8bc2f03d71f6ae55354d79d0bd" alt="Grouping in Xero: Group by None" width="2048" height="1515" data-path="images/getting-started/Xero/step-5.png" />
</Frame>

### Save as a custom report

At the bottom right, click **Save as custom**. Next time you open this report, set only the date range again. You do not have to configure accounts, columns, and grouping once more.

<Frame caption="Save the report as a custom report">
  <img src="https://mintcdn.com/fynancegmbh/HyvKy4XKcnammuKp/images/getting-started/Xero/step-6.png?fit=max&auto=format&n=HyvKy4XKcnammuKp&q=85&s=375b3b436f8ec030433b8abbd7a53977" alt="Save as custom in the Xero report" width="2254" height="1659" data-path="images/getting-started/Xero/step-6.png" />
</Frame>

### Download as Excel

1. Check that **Update** shows the correct date range on the report.
2. **Export** → **Excel**. Not PDF, and not Google Sheets.

The file extension is `.xlsx`. It is always exactly one file per upload.

<Frame caption="Export as Excel">
  <img src="https://mintcdn.com/fynancegmbh/HyvKy4XKcnammuKp/images/getting-started/Xero/step-7.png?fit=max&auto=format&n=HyvKy4XKcnammuKp&q=85&s=fade270d87998fc12128bc1092776cdc" alt="Export menu in Xero with Excel" width="646" height="412" data-path="images/getting-started/Xero/step-7.png" />
</Frame>

### Upload in Fyvel

1. In Fyvel, open the **Uploads** page.
2. Drag the Excel file into the upload area.
3. Fyvel processes the file in the background. You see the status in the upload table.

The new upload replaces all previous Xero bookings of this company. Anything that is no longer in the file is gone from Fyvel afterwards.

### Cost centers

If the export contains a column with departments or tracking categories (in the screenshot, **Department**):

1. Upload the file once. Fyvel remembers the labels from that column.
2. Open **Company settings** → **Xero integration**.
3. Enter the column name as the **source column**, for example `Department`.
4. Map each label to a Fyvel cost center and save.
5. Upload the same file again. Only this second upload writes the cost centers onto the bookings.

Labels without a mapping come in without a cost center. The column must stay in the Excel export, otherwise the upload fails.

### If the upload fails

| What you see | What to check |
| - | - |
| The file is rejected because columns are missing | Under **Columns**, tick every column from the screenshot and export again. |
| Bookings do not balance | **Select all** for the accounts, and **Group by** set to **None**. |
| An account number is rejected | Account numbers in Xero may contain digits only. |
| Older months are missing in Fyvel | The export covers only a slice. Widen the date range and upload the file again. |
| Cost centers stay empty | Save the source column and the mapping, then upload the file once more. |

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.