Upgrade to Business Central integration v2


Overview


Installation


Connection


Configuration


Export an expense

Overview

This guide is intended for users who already use Pleo–Business Central integration. If you're new to the Pleo–Business Central integration, please refer to the set-up guide to get started with connecting Business Central to Pleo.


For a visual guide, you can watch the video below while following the written steps of this article:


Before you get started

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

  • Admin or Bookkeeper role on Pleo
  • User permissions on Business Central:
    • SUPER to install the integration
    • PLEOINTADMIN to configure and use the integration


If you don’t have the SUPER permission, ask a Business Central SUPER user to:

  1. Install the integration for you
  2. Assign PLEOINTADMIN to your user account 
    1. In Business Central, access Users name (User > User Name column) 
    2. In User Permission Sets, add PLEOINTADMIN 
    3. Leave the Company field empty to enable this permission set on all companies (recommended for multi-company setups)
  3. Grant PLEOINTADMIN to all other relevant users who will use the integration


 How to check user permissions 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



Good to know:

  • For multi-entity setups, you need to complete this upgrade once per entity.
  • During the upgrade, keep only one Business Central tab open to ensure it connects to the correct Pleo entity.


Installation

Download your accounting settings from Pleo

  1. In Pleo, click Get started
  2. Select Download
  3. Store this file securely for future use in Configuration step


Install the app

  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

    Note: Make sure this matches the environment used for your existing integration.

  5. Click Install

  6. Once installed, the Integration Setup page opens in the same tab


Connection

To avoid connecting the wrong entity, keep only one Business Central tab open


Connect Business Central to Pleo

  1. In Business Central, open Pleo integration setup
  2. Click on the pencil icon to edit
  3. Click Connect

Select Entity and Authorisation

  1. Select the correct Pleo entity
  2. Click Allow
  3. Follow the on-screen instructions 
  4. Once the connection is complete, click OK


Configuration

In this step, you’ll use the Assisted Setup in Business Central to configure the new integration. 


  • The integration will not work correctly without this reconfiguration
  • Use the Pleo account settings file downloaded in the Installation step
  • Complete any new configuration settings


  1. In Business Central, open Pleo integration setup
  2. Locate the Assisted Setup
  3. Click Next to proceed
  4. Follow the instructions
     Accounting setup 
    • Expense Journal
      • Assign the Expense Journal from the downloaded accounting settings file to the Expense Template and Batch
    • Pleo Wallet (Contra) Account
      • Assign Pleo Wallet (Contra) Account from downloaded accounting settings
      • Alternatively, if you want to have Pleo Wallet as a Bank Account:
        • Select Bank Account as Type
        • Create and map a new Bank Account directed in the Assisted Setup screen
    • Pleo Out-of-pocket & External Reimbursements Accounts
      • Assign accounts from downloaded accounting settings (if available)
    • Default Vendor Account
      • Create and map a new Vendor account directed in the Assisted Setup screen


     Dimensions, Pleo Teams and Chart of Accounts 
    1. Select the dimensions you want to synchronise 
    2. Click Sync With Pleo
    3. Link Pleo Teams to a Dimension (optional)
      • Select a Dimension you want to link to Pleo Teams
      • Follow the additional steps to complete the setup
    4. Click Sync With Pleo to synchronise Business Central Chart of Accounts with Pleo


     Contra Account, Tax Codes & Categories 
    1. In Pleo, navigate to Settings
    2. Click Accounting
    3. Access Contra Accounts
    4. Assign the Contra Account in Pleo following the instructions in Assisted Setup
    5. Once complete, access Categories 
    6. For each category
      • Select the account for each category
      • Choose a tax code from the dropdown
    Important: Previously created tax codes were archived, and you will need to link new tax codes to categories. Learn more about Tax Synchronisation.


  5. Close the Assisted Setup to finalise configuration


Once the mandatory configuration is complete, you can configure the optional advanced settings - learn more about advanced settingssuch as tag visibility, vendor and invoice management. 


Good to know: Ensure that PLEOINTADMIN permission set is assigned to every user in Business Central who will be using the integration. 

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.

How to trigger the exporting process instantly?
  1. In Business Central, open Pleo Integration Setup
  2. Under more option, access Actions
  3. Click Sync Export Queue Now

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