Overview
Installation
Connection
Configuration
Export an expense
Overview
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
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
- In Business Central, access Extension management
- Click Manage
- Select Upload extension
- Access Select .app file to upload the extension
Note: ensure you have unarchived the file if you received it as a ZIP file - Ensure Deploy to current version is selected
- Accept the privacy policy disclaimer
- 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
- In Business Central, access Extension Management
- Click on the app's name (Pleo Beta or Pleo)
- Switch HttpsClient Request toggle
Connection
For Cloud Business Central
- In Business Central, open Pleo integration setup
- Click on the pencil icon to edit
- Click Connect
- Follow the steps of the authorisation process
Once the integration is connected, the Installation status will be ACTIVATED
For On-premises Business Central
- In Pleo, go to Settings
- Click Accounting
- Select Business Central On-Premises
- Allow the connection
- Copy and save the API Key
- In Business Central, open Pleo integration setup
- Click on the pencil icon to edit
- Enter the API key
- 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:
- Click on the Expense Batch field
- Click + New
- 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
- Choose Pleo Wallet Account type
- You can use either a G/L Account or a Bank Account type
- Create a new account by clicking on the account field and then clicking + New
- Add account No. and Name
- 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:
- Press the three-dotted sign
- Select the desired datapoint
- 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
- In Business Central, go to Pleo Integration Setup
- Access Tax Codes Setup
- 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
- In Business Central, go to Pleo Integration Setup
- Click Tags Setup
- 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 - Select a Dimension
- Click OK
- Click Sync With Pleo
- To edit the Dimension values synced to Pleo
- Next to the dimension field, click on the three dots icon
- Uncheck Show in Pleo for Dimension Values you do NOT want to have in Pleo as Tags
- Click Sync With Pleo
- Next to the dimension field, click on the three dots icon
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
- In Pleo, go to Settings
- Click Accounting
- Select Categories
- Create categories
- 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
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article