Set up the Business Central integration v2

Updated 06 Oct 2026


Overview


Installation


Connection


Configuration


Export an expense

Overview

  • Integration Type - app installed inside Business Central
  • Cloud, On-Premises & Partner-Hosted Business Central is supported (version 24 and higher)
  • Export
    • Pleo expenses can be exported into Business Central as Journal entries and Purchase Invoices
    • Exporting of card expenses, invoices, out-of-pocket, mileage, reimbursements, personal spend and any other expense is supported
    • Expense attachments (receipts) are transferred together with the expense data
  • Tags Sync
    • Import and sync Dimensions from Business Central with Tags in Pleo 
    • Select which Dimension Values you want to see as Tags in their Pleo
  • Tax Sync
    • Import and sync VAT Setups from Business Central with Tax Codes in Pleo
    • Select VAT Setups you want to see as Tax Codes in Pleo
    • Import and sync Projects & Tasks from Business Central with Tags in Pleo
  • Chart of Accounts Sync
    • Import and synchronise GL & Bank Accounts from Business Central with Pleo 
  • Vendor Tagging
    • Synchronise Vendors between Pleo and Business Central
    • Book exported expenses on actual Vendors in Business Central
  • Other
    • Multi-Entity Support - easily connect each Pleo entity to a separate company in Business Central
    • Closed Accounts Period Bookkeeping- export expenses belonging to closed accounting periods
    • Multi-Currency - enable multi-currency in Pleo and export expenses paid in different currencies
    • Representation – export representation expenses with attendee data


Installation

To install and set up the integration app, ensure you have:

  • Admin or Bookkeeper role on Pleo
  • Required user permissions on Business Central:
    • Option 1:
      • SUPER - if this user permission set is assigned to you - you will be able to install and set up integration yourself
      • If SUPER is not assigned, see option 2
    • Option 2:
      • Ask a user with SUPERpermission set to install the app for you. 
      • After installing the app, ask your Business Central Super User to assign PLEOINTADMIN permission set to your User Account in Business Central, as well as to any other user accounts that will be using the integration (please refer to the ‘Good to know’ section below if needed).


 How to check user permission in Business Central?  
  1. In Business Central, access Users page
  2. Under the User Name column, click on your user name
  3. In the User Permission Sets section, you can see Permission Sets assigned to this User


For EXTEN. MGT. - ADMIN permission, it may not appear in the User Permission Sets table. To check for it: 

  1. Click on top of any permission set 
  2. Click the three-dotted icon
  3. Search for EXTEN. MGT. - ADMIN in the list


Installation for Cloud Business Central

  1. Go to the Pleo app in Microsoft AppSource
  2. Click Get it Now
  3. Use your Business Central credentials to sign in (if required)
  4. Select the Business Central environment into which you want to install the app
  5. Follow the on-screen instructions


Installation for On-premises or Partner-hosted Business Central

Pre-requisites

The integration supports Business Central version 24 and higher. If you’re using an earlier version, please contact your Pleo contact or Support to check whether it can be supported.


The integration uses object range 50170–50199 - follow the steps to check object range availability and request the integration package from Pleo:

  1. Access the All Objects page by tapping “all objects” in the search
  2. Apply Filter by Object ID and insert 50170..50199 into the filter field
  3. Check whether 50170_50199 object range is available in your Business Central
    • If you see “There is nothing to show in this view”, the object range is available - request the BC integration app package from your Pleo contact or Support, mentioning that the object range is fully available.
    • If any object within this range is already in use, reach out to your Pleo contact or Support and specify that all objects are already in use, so we can assign a new range and adjust your integration package.
  4. Install the package into your Business Central via Extension Management


How to install the integration package via Extension Management
  1. Unarchive the package file if you received it in the zip format
  2. Access Extension Management in Business Central
  3. Click Manage and Upload Extension
  4. Use Select .app file to upload the extension
  5. Ensure Deploy to Current version is selected
  6. Accept the privacy policy disclaimer toggle
  7. Click Deploy
  8. If successfully installed, the status will be Completed
    Note: It may take a few minutes - to check the status of the installation, click Manage > Installation Status
  9. The extension will appear on the Extension Management page by searching Pleo
  10. Click Pleo
  11. Ensure that the Allow HttpClient Requests toggle is ON (green)


Good to know

Add PLEOINTADMIN permission set to every user account that will be using the integration by:

  • Writing PLEOINTADMIN in the User Permission Sets section (Users> User Name column> User name)
  • Keeping the Company field empty to enable this permission set on all companies in Business Central (recommended)


Connection

For Cloud Business Central

  1. In Business Central, open Pleo integration setup
  2. Click on the pencil icon to edit
  3. Click Connect
  4. Follow the steps of the authorisation process


Once the integration is connected, the Installation status will be ACTIVATED


For On-premises Business Central

  1. In Pleo, go to Settings
  2. Click Accounting
  3. Select Business Central On-Premises
  4. Allow the connection
  5. Copy and save the API Key
  6. In Business Central, open Pleo integration setup
  7. Click on the pencil icon to edit
  8. Enter the API key 
  9. Click Connect


Once the integration is connected, the Installation status will be ACTIVATED

Configuration

Assisted Setup

  1. After connecting the integration, the Pleo Assisted Setup pop up will open automatically in Business Central.
  2. Follow the guided setup to configure:
    • Journals
    • Accounts
    • Tags sync
    • Contra accounts in Pleo
    • Categories in Pleo
  3. Complete every step in the Assisted Setup.


Good to know

The Assisted Setup covers the standard configuration suitable for most businesses. 

You can configure additional options later from Pleo Integration Setup in Business Central following the advanced settings guide.


Tax Codes & tags

Set up tax codes (optional)

  1. In Business Central, go to Pleo Integration Setup

  2. Access Tax Codes Setup
  3. To not import certain VAT Setups as Tax Codes in Pleo, un-click the Show in Pleo checkbox and click Sync With Pleo 


Good to know

VAT Setups that are blocked or are of Sales Type will not be synced.


Set up Tags (optional)

  • To link Dimension to existing Tag Groups
    1. In Business Central, go to Pleo Integration Setup
    2. Click Tags Setup
    3. Add the Dimensions from Business Central you want to sync with Pleo
      • The Dimensions which already exist as active Tag Groups are automatically pre-selected
    4. Select a Dimension 
    5. Click OK
    6. Click Sync With Pleo


  • To edit the Dimension values synced to Pleo
    1. Next to the dimension field, click on the three dots icon
    2. Uncheck Show in Pleo for Dimension Values you do NOT want to have in Pleo as Tags
    3. Click Sync With Pleo 


Good to know


Synchronise BC Projects with Pleo (optional)

  • You can sync Projects and Project Tasks into Pleo as Tags. 
  • This means you and your employees can assign project data to expenses in Pleo and have the matching Project, Task, and optional Project Line Type recorded automatically in Business Central during export.
  • Follow Projects sync for Business Central V2 to get set up. 

Vendor Tagging

Learn how to activate Vendor tagging in Pleo.

Categories

Learn how to create your categories, and once created, you can follow these steps:

  1. In Pleo, go to Settings 
  2. Click Accounting 
  3. Select Categories 
  4. For each category
    • Select the relevant Account Number
    • Choose a tax code from the dropdown


Export an expense

After setting up the integration, it's important to export an expense to see if the integration is configured correctly.

Good to know:
  • By default, the integration checks with Pleo every 5 minutes to see if any expenses are ready to export. Trigger the exporting faster by clicking Sync Export Queue Now in Business Central (Pleo Integration Setup>Actions).
  • Configure advanced settings, like disabling attachment exports or using the posting date as the export date for your Pleo expenses (see more on the page).



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article