Set up the Business Central integration v2


Overview


Installation


Connection


Configuration


Export an expense

Overview

This guide is intended for users who use Pleo–Business Central integration. If you already use Pleo–Business Central integration, please refer to the upgrade guide.

The Business Central integration v2 is currently in the testing (Beta) phase and available to a limited number of Pleo customers only. Reach out to your Pleo CSM if you would like to get early access to the integration.


Key features of the new integration

  • Integration Type - app installed inside Business Central
  • Cloud & On-Premises Business Central is supported
  • 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 
    • Can 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
    • Can select VAT Setups you want to see as Tax Codes in Pleo
  • Other
    • Multi-Entity Support - easily connect each entity to a separate company in Business Central
    • Closed Accounts Period Bookkeeping- export expenses belonging to closed accounting periods


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:
      • EXTEN. MGT. - ADMIN - if assigned to your user account, you will be able to install the app yourself
      • After installing the app, ask your Business Central Admin or Super User to assign PLEOINTADMIN permission set to your User Account in Business Central. This permission set is installed automatically with the integration app and will let you set up the integration using your user account
      • You can also ask your Business Central Admin / Super User to install the integration app for you

 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. Hover on top of any permission set 
  2. Click the three-dotted icon
  3. Search for EXTEN. MGT. - ADMIN in the list


Check available object range

In Business Central, access All Objects (search function), and filter by Object ID 50170...50199 

  • No objects listed - the range is available, and you can continue to install the app
  • Objects listed - you will not be able to install the Beta app. Consult your Pleo CSM on the possibility of customising the Beta app for you


Reach out to your CSM

To continue with the integration, there are a few things you'll need from your CSM:

  • The app file for Business Central
  • If the object range already has object - your CSM can help customise the integration to use another object range 
  • If you use On-premises Business Central, your Pleo company ID


Install the app

  1. In Business Central, access Extension management
  2. Click Manage
  3. Select Upload extension 
  4. Access Select .app file to upload the extension
    Note: ensure you have unarchived the file if you received it as a ZIP file
  5. Ensure Deploy to current version is selected
  6. Accept the privacy policy disclaimer
  7. Click Deploy


Once successfully installed, the status will be completed, and you'll find the Pleo app in your Extension Management (the uploading and deployment may take a few minutes).


Allow HttpClient Requests

  1. In Business Central, access Extension Management
  2. Click on the app's name (Pleo Beta or Pleo)
  3. Switch HttpsClient Request toggle




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

1. Journals & Accounts configuration

In the Journals Setup section, set up several Journals in Business Central which will be used by the integration:

  • Expense Journal - all Pleo expenses will be recorded in this journal (except Invoices and expenses booked on a Vendor).

    Template: General template is recommended.

  • Optional Invoice Journal - To record invoices, to book card and out-of-pocket expenses on a vendor.

    Template: Purchase Template is recommended. 

    You can use the same Journal as in Expense journal.

  • Optional Invoice Payment Journal - To record invoices, to book card and out-of-pocket expenses on a vendor.

    Template: Payments Template is recommended.

    Note: You can use the same Journal as in Expense journal.


How to create a new Journal in Business Central?


Journal Template - select the Journal Template and use any existing Journal template.

Note: Do not create a new Template for any journal


Journal Batch - create a new Journal Batch or map an existing one. To create a new Batch: 

  1. Click on the Expense Batch field 
  2. Click + New
  3. Add Name, Description, and, if needed, No. Series


In the Accounts Setup section, set up several accounts which will be used by the integration:

  • Pleo Wallet Account - to track expenses made with your Pleo cards. Map the existing Account for Pleo expenses.

    Note: If you want to have Pleo Wallet Account as a Bank Account in Business Central, set Pleo Wallet Account Type to Bank Account and create a new account

  • Pleo Out-of-pocket Account - to track employee out-of-pocket expenses. Map the existing Balancing account for out-of-pocket expenses.

    Note: If you want to book out-of-pocket expenses on a Vendor or Employee in Business Central, set the Out-of-pocket Account Type to Vendor or Employee, and create a new account the pocket Account type as Vendor or Employee, you will need to create a new account.

  • Pleo Contra Account - to track reimbursements made outside of Pleo. Map the existing Contra account for reimbursements.


How to create new Accounts in Business Central?

Pleo Wallet Account

  1. Choose Pleo Wallet Account type
  2. You can use either a G/L Account or a Bank Account type
  3. Create a new account by clicking on the account field and then clicking + New
  4. Add account No. and Name
  5. If you are creating a Bank Account, ensure that Bank Acc. Posting Group is assigned to the Account


Pleo Out-of-Pocket Account

Choose an Account Type for Pleo Out-of-pocket Account and map Pleo Out-of-Pocket Account No. 


G/L Account is a standard default choice, but you can also choose Vendor or Employee.

  • If Vendor is chosen:
    • All pocket expenses will be booked on a single generic Vendor account
    • Choose Vendor to record pocket expenses as Purchase Invoices in Business Central
  •  If Employee is chosen:
    • All pocket expenses will be booked on Employees from Business Central
    • You will need to manually link Pleo Users to Employees from Business Central


2. Accounting configurations

If needed, adjust the accounting configurations of the integration.


Record Vendor on Card Expenses

  • If disabled (default) - card expenses will be recorded as a single journal entry in the Expense journal
  • If enabled - Pleo card expenses will be booked on a Vendor in Business Central

Good to know

  • If you enable this configuration, make sure you have the Default Vendor Account set up
  • If Purchase Invoices is also enabled, card expenses will be booked as Purchase Invoices as Business Central


Purchase Invoices

  • If enabled (default), invoices and all other expenses booked on a Vendor will be recorded as Purchase Invoices in Business Central
  • If disabled, all expenses (inc. invoices) will be recorded in Business Central as Journal entries


Description

This configuration determines the contents of the Description and Comment fields on exported expenses in Business Central. To add a datapoint into the Description:

  1. Press the three-dotted sign
  2. Select the desired datapoint 
  3. Click OK

Good to know: You can write any text in the field - it will appear in the Description and Comment fields for all exported expenses (do not use [ ] around your text)


3. Tax Codes & tags

Synchronise your VAT Setups to Pleo Tax Codes

The new integration will archive Tax Codes from the legacy Business Central integration and create new ones in Pleo, due to updated Tax Sync logic that fixes issues with how the old integration handled Tax Codes
  1. In Business Central, go to Pleo Integration Setup
  2. Access Tax Codes Setup
  3. Click Sync With Pleo


Good to know

  • To not import certain VAT Setups as Tax Codes in Pleo, un-click the Show in Pleo checkbox and click Sync With Pleo 
  • VAT Setups that are blocked or are Sales & Full Tax Type will not be synced. To import one, first uncheck the Block box, then select Show in Pleo


Synchronise your Dimensions to Pleo Tags

  • 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
      Note: 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

  • Dimensions are linked to Tag Groups
  • Dimension values are linked to tags
  • Blocked or non-standard Dimension Values can’t be made visible in Pleo


4. Categories

  1. In Pleo, go to Settings 
  2. Click Accounting 
  3. Select Categories 
  4. Create categories
  5. For every category
    • Add the account numbers (no names or other details needed, just the Account numbers)
    • Choose a tax code from the dropdown


Good to know: To find accounts in Business Central, type Chart of Accounts in the search and click on Chart of Accounts


Export an expense

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

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