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.


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 
    • Write PLEOINTADMIN in the User Permission Sets section 
    • Keep the Company field empty to enable this permission set on all companies in Business Central (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


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


  1. In Business Central, open Pleo integration setup
  2. Click on the pencil icon to edit
  3. Click Connect
  4. Select the Pleo entity
  5. Click Allow
  6. Follow the on-screen instructions 
  7. Once the connection is complete, click OK


Configuration

In this step, you’ll use the Assisted Setup in Business Central to configure your accounts. The settings file you downloaded earlier contains your existing data, and any new settings needed for the upgrade will be completed during this step.


The integration will not work correctly without this reconfiguration


  1. In Business Central, open Pleo integration setup
  2. Locate the Pleo integration Assisted Setup
  3. Click Next to proceed


1. 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


2. 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


Good to know: The Dimension you link to Pleo Teams cannot be synced with Tags.


3. 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
  7. In Business Central, close the Assisted Setup 
  8. Complete the configuration


Good to know: Previously created tax codes were archived, and you will need to link new tax codes to categories. Learn more about Tax Synchronisation.


4. Advanced settings

Learn more about advanced settings for the integration, such as tag visibility, vendor and invoice management.


Good to know: These steps are optional, but PLEOINTADMIN permission set is required.

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