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

# Exporter for Bloomerang

> With PEX it's easier than ever to reconcile your company expenses with your accounting platform of choice. Set-up typically takes 10-15 minutes and you can schedule automatic exports on a daily, weekly or monthly basis.

[Watch a demo](https://pex.navattic.com/h1c40bh7) to see how you can set-up the integration. Or, keep reading to this article and we'll walk you through the set-up process:

1. [Upload your Chart of Accounts](#1-upload-your-chart-of-accounts)
   * [Configure format and dates](#configure-format-timezone-and-dates)
2. [Configure purchases](#2-configure-purchases)
   * [Add a new field](#add-a-new-field)
3. [Configure transfers/bill payments](#3-configure-transfers/bill-payments)
   * [Add a new field](#add-a-new-field-2)
4. [Configure fees](#4-configure-fees)
   * [Add a new field](#add-a-new-field-3)
5. [Export transactions](#5-export-transactions)
   * [View history](#view-history)
     * [Download export file](#download-export-file)
6. [Import to Bloomerang](#6-import-to-bloomerang)
   * [Export receipts](#export-receipts)
7. [FAQ](#faq)

## 1. Upload Your Chart of Accounts

Begin by uploading your Bloomerang Chart of Accounts into the Tag Manager in PEX. More details [here](/administrator-guide/create-tags-for-exporter-app).

Once your Chart of Accounts is in PEX, let's access the app:

* Log in to [http://dashboard.pexcard.com/](http://dashboard.pexcard.com/?utm_source=support)
* Navigate to [Apps > Available](https://dashboard.pexcard.com/apps/available?utm_source=support)
* Locate **Exporter for Bloomerang**.
* Click **More info** > **Install** > **Launch**.

<Note>
  **Note:**

  To install the exporter, you need to enable the following permissions: *Edit business settings & apps*, *Manage cardholder*, *View card transactions*. You can enable them in [My Profile -> Permissions](https://dashboard.pexcard.com/account/permissions?utm_source=support).
</Note>

## Configure format, timezone and dates

After the app launches:

<Steps>
  <Step>
    Select your report format: CSV or XLSX.
  </Step>

  <Step>
    Select your preferred timezone.
  </Step>

  <Step>
    Select the earliest transaction date you want to export to Bloomerang using the date picker (up to 1 year ago).

    * You can leave it empty to default 1 year ago.
  </Step>

  <Step>
    Enter an end date or leave it blank.

    <Frame>
      <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-456.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=f633b1bfd5950495779af68ee1cf95b0" alt="" width="931" height="233" data-path="images/administrator-guide/image-456.avif" />
    </Frame>
  </Step>
</Steps>

## 2. Configure Purchases

You can export purchases to Bloomerang.

* Enable "Export purchases?" to successfully export PEX purchases, which will update the toggle from grey to green.
* You can choose to sync all PEX purchases (regardless of approval status) or just approved (recommended).

Now map purchase data to Bloomerang fields.

* There is a set of standard fields: Account, Amount, Date, Notes, Merchant.
  * The PEX source and PEX value are prepopulated for you but you can update them if needed.
  * We recommend mapping the Account field to the PEX source Tag. This enables the expense account to be dynamic for each purchase. In the PEX value column, select a tag that you previously created by following the instructions in the [Create Tags for Exporter app](/administrator-guide/create-tags-for-exporter-app) article.
* Rename fields to make them have the same names as in Bloomerang.
  * As soon as you rename a field in one section, it is auto renamed in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).
* Add a new field(s).
  * As soon as you add a new field (e.g., Class), it (Class) appears in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-457.png?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=a2a4b84ed6ce0bfede9cbc309d6f6b1a" alt="" width="1494" height="563" data-path="images/administrator-guide/image-457.png" />
</Frame>

## Add a new field

To add a field that you have in Bloomerang:

* Click **Add a new field**.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-458.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=739c30972edf3aa8aad474995798f179" alt="" width="1479" height="180" data-path="images/administrator-guide/image-458.avif" />
</Frame>

* Add a field name.
* Add a **PEX source**.
  * It can be Text, Tag, or Transaction.
* Add a **PEX value** for a new field.
  * The **PEX value** will change based on the **PEX source** selected.

Also, you can:

* Remove any field that you don't need.
  * As soon as you remove a field in one section, it is auto removed in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).
* Reorder fields.
  * As soon as you reorder fields in one section, they are reordered in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).

## 3. Configure Transfers/Bill Payments

You can export transfers (if your business is prepaid) or bill payments (if your business is credit) to Bloomerang.

* Enable "Export transfers?/Export bill payments?" to successfully export PEX transfers/bill payments, which will update the toggle from grey to green.

Now map transfer/bill payment data to Bloomerang fields.

* There is a set of standard fields: Account, Amount, Date, Notes, Merchant.
  * The PEX source and PEX value are prepopulated for you but you can update them if needed.
* Rename fields to make them have the same names as in Bloomerang.
  * As soon as you rename a field in one section, it is auto renamed in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).
* Add a new field(s).
  * As soon as you add a new field (e.g., Class), it (Class) appears in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-459.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=50880344e5328ccb2d2d1128cdf073fe" alt="" width="1482" height="505" data-path="images/administrator-guide/image-459.avif" />
</Frame>

## Add a new field

To add a field that you have in Bloomerang:

* Click **Add a new field.**

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-460.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=f6b221af07dc49f6931a60b41da54d8c" alt="" width="1481" height="172" data-path="images/administrator-guide/image-460.avif" />
</Frame>

* Add a field name.
* Add a **PEX source**.
  * It can be Text, Tag, or Transaction.
* Add a **PEX value** for a new field.
  * The **PEX value** will change based on the **PEX source** selected.

Also, you can:

* Remove any field that you don't need.
  * As soon as you remove a field in one section, it is auto removed in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).
* Reorder fields.
  * As soon as you reorder fields in one section, they are reordered in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).

## 4. Configure Fees

You can export fees to Bloomerang.

* Enable "Export fees?" to successfully export PEX fees, which will update the toggle from grey to green.

Now map fee data to Bloomerang fields.

* There is a set of standard fields: Account, Amount, Date, Notes, Merchant.
  * The PEX source and PEX value are prepopulated for you but you can update them if needed.
* Rename fields to make them have the same names as in Bloomerang.
  * As soon as you rename a field in one section, it is auto renamed in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).
* Add a new field(s).
  * As soon as you add a new field (e.g., Class), it (Class) appears in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-461.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=b65a0d25defc0e6780a70ff7ca91b4ee" alt="" width="1485" height="496" data-path="images/administrator-guide/image-461.avif" />
</Frame>

## Add a new field

To add a field that you have in Bloomerang:

* Click **Add a new field**.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-462.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=82fd8707b77a739901af8ea51e6cb90a" alt="" width="1473" height="107" data-path="images/administrator-guide/image-462.avif" />
</Frame>

* Add a field name.
* Add a **PEX source**.
  * It can be Text, Tag, or Transaction.
* Add a **PEX value** for a new field.
  * The **PEX value** will change based on the **PEX source** selected.

Also, you can:

* Remove any field that you don't need.
  * As soon as you remove a field in one section, it is auto removed in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).
* Reorder fields.
  * As soon as you reorder fields in one section, they are reordered in **all** sections (Export purchases?, Export transfers?, Export bill payments?, Export fees?).

## Save configuration

When you configured everything, click **Save** to save your configuration.

## 5. Export transactions

To export transactions, click on the **Schedule** tab. There are three options:

* *Run Now:* To run the export now, click **Run now**.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-463.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=9af97a2cc1965fc956b23323eee3abf5" alt="" width="522" height="313" data-path="images/administrator-guide/image-463.avif" />
</Frame>

* *One time scheduled export:* To schedule a one time export, select a date and time and click **Save**.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-464.png?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=e716a828b8dc1256fade1cd0a91f9f7f" alt="" width="525" height="343" data-path="images/administrator-guide/image-464.png" />
</Frame>

* *Recurring export:* To run this export on a recurring basis:
  * Select a date and time.
  * Enable the Repeat toggle.
  * Select the frequency.
  * Select end date for the schedule.
  * Click **Save**.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-465.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=4d0357092eb3ddd39dcc464d2c483ba7" alt="" width="592" height="346" data-path="images/administrator-guide/image-465.avif" />
</Frame>

## View History

The History tab shows you a list of prior exports including the date range selected, status, # transactions found, # transactions eligible, and # transactions exported.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-466.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=c343f39f7a5f994f752a036ee91d566a" alt="" width="1514" height="271" data-path="images/administrator-guide/image-466.avif" />
</Frame>

If you configured the app to export only approved transactions, # transactions eligible can differ from # transactions found. For example, you have 60 transactions found, but only 45 of them are approved and therefore only 45 are eligible for export.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-467.png?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=2a103cc2c6233d459fc9428dc01fe6cc" alt="" width="1500" height="106" data-path="images/administrator-guide/image-467.png" />
</Frame>

## Download Export File

You will see a **Download** button in the Action column on the History tab once the export file can be downloaded. Click **Download** to download the file.

* If you selected a small date range with a low number of transactions, the export file should be ready for download in less than a minute. If the date range contains a large number of transactions, it may take a few minutes. Simply **refresh** the screen to get the latest update.

<Frame>
  <img src="https://mintcdn.com/pextest/AsOtgC68beYkZbrU/images/administrator-guide/image-468.avif?fit=max&auto=format&n=AsOtgC68beYkZbrU&q=85&s=0f1c9c319a3e2c6447b6141c839f51ba" alt="" width="1502" height="219" data-path="images/administrator-guide/image-468.avif" />
</Frame>

## 6. Import to Bloomerang

Log in to your Bloomerang account and follow the steps to import the downloaded export file into your system.

## Export Receipts

The Exporter for Bloomerang cannot export receipts to Bloomerang. But you can export receipts from PEX using the following apps:

* [Google Drive](https://dashboard.pexcard.com/apps/available?utm_source=support). More details [here](/administrator-guide/connector-for-google-drive).
* [Microsoft OneDrive](https://dashboard.pexcard.com/apps/available?utm_source=support). More details [here](/administrator-guide/pex-connector-for-onedrive).
* [Envelope PDF](https://dashboard.pexcard.com/apps/available?utm_source=support). More details [here](/administrator-guide/expense-envelopes-for-admin).

## FAQ

<AccordionGroup>
  <Accordion title="Are split tags supported for the export?">
    At this time, split tags are not supported.
  </Accordion>

  <Accordion title="Can I re-export a purchase?">
    Every exported purchase has a "Synced to PEX Connector for Bloomerang" note. If you remove this note, the purchase will be re-exported.
  </Accordion>
</AccordionGroup>

For any questions, please email [appsupport+bloomerang@pexcard.com](mailto:appsupport+bloomerang@pexcard.com)