Skip to main content

ME Expense Implementation Guide

Module Overview

This guide explains the configuration required to enable and manage the MESuite Expense Claims module within Microsoft Dynamics 365 Business Central.

The Expense Claims module provides employees with a controlled method of capturing, submitting, approving, and reimbursing business expenses. Once configured, the module integrates with Business Central to create Purchase Orders or Purchase Invoices, allocate expenses to the appropriate General Ledger accounts, apply financial dimensions, and route claims through the configured approval workflow.

This guide covers the Business Central configuration required before users can begin submitting expense claims through MESuite.

 

Configuration Overview

Expense Claims rely on several Business Central records working together. The recommended configuration order is shown below.

Completing the setup in this order ensures that each configuration is available for subsequent steps and reduces the likelihood of configuration errors.

 

1. API User Setup

Overview

The API User is responsible for creating Purchase Orders or Purchase Invoices in Business Central when approved expense claims are submitted from MESuite.

Before the Expense Claims module can be used, the API User must be configured with the required permissions and default purchasing values. Incorrect configuration will prevent expense claims from synchronizing successfully between MESuite and Business Central.

Configuring the API User

  1. Navigate to API Users.
  2. Open the API User used by MESuite.
  3. Verify that the following fields have been configured:
Field Description
Authorize Exp. Purch. Orders Enables the API User to create authorised Expense Purchase Orders in Business Central.
Sundry Order Specifies the default Sundry Purchase Order used during expense processing.
  1. Save the changes.

 

Both fields must be configured before Expense Claims can be successfully submitted. If either field is missing or incorrectly configured , MESuite will be unable to create the Purchase Order and an error will be returned during submission.

 

How the API User is Used

When an employee submits an approved Expense Claim, MESuite communicates with Business Central using the configured API User.

The API User performs the following functions:

  • Creates the Expense Purchase Order.
  • Applies Vendor information.
  • Applies the configured G/L Account Allocations.
  • Creates the financial transaction.
  • Returns the Purchase Order Number to MESuite.

Because every submitted expense claim passes through the API User, it is recommended that this account be dedicated exclusively to MESuite integrations and not used for daily operational activities.

 

Best Practice

Use a dedicated API User account for MESuite integrations rather than assigning these permissions to an individual employee account. This simplifies auditing, improves security, and prevents integration failures if employee accounts are disabled or modified.

 

Resource Configuration

Overview

Resources represent employees within Microsoft Dynamics 365 Business Central and form the foundation of the MESuite Expense Claims module.

Every employee who submits expense claims must have an associated Resource record. The Resource stores employee information used throughout the Expense Claims process, including workflow notifications, vendor linking, approval routing, and financial processing.

Before an employee can submit an Expense Claim, the following must be configured:

  • A Resource record
  • A Staff Vendor
  • A linked Vendor Number
  • User security within MESuite

Without a Resource record, the employee cannot be recognized by the Expense Claims module.

Creating a Resource

Create a Resource for each employee who will submit Expense Claims.

To create a Resource

  1. Navigate to Resources.
  2. Select New.
  3. Complete the required fields on the Resource Card.
  4. Save the Resource.

Personal Data

Under the Personal Data Fast Tab, populate the employee's email address.

 

Field Description
Email Address Stores the employee's email address used for workflow notifications and system communications.

 

The email address is used by MESuite when sending:

  • Expense Claim submission confirmations
  • Approval notifications
  • Rejection notifications
  • Workflow updates
  • Other automated system communications

 

Employees without a valid email address may not receive workflow notifications generated by MESuite. It is recommended that every Resource has a unique business email address.

Resource Behaviors

Once created, the Resource becomes the primary employee record used by MESuite.

During Expense Claim processing, MESuite retrieves information from the Resource to:

  • Identify the submitting employee
  • Determine the linked Staff Vendor
  • Route approvals
  • Apply user permissions
  • Generate reimbursement transactions

The Resource itself does not receive payments.

Instead, it provides the link between the employee and the Staff Vendor that will ultimately receive the reimbursement.

Relationship Between Resources and Staff Vendors

Each Resource should be linked to a single Staff Vendor.

The relationship is illustrated below.

Employee Card

Resource Card

Vendor No.

Staff Vendor

Purchase Orders

Vendor Ledger Entry

This relationship allows approved Expense Claims to be posted against the correct Vendor while still identifying the employee who incurred the expense.

Best Practice

Create Resources using your organization’s standard naming convention.

For example:

Resource No Employee
EMP00015 Naledi Mofokeng
EMP00016 Tenille Leukis

 

Common Mistakes

The following issues commonly prevent employees from submitting Expense Claims.

Issue Result
No Resource created Employee cannot access Expense Claims
Email Address missing Workflow notifications are not delivered
Resource not linked to a Staff Vendor Purchase Orders cannot be created
Resource inactive Employee cannot submit claims

Creating a Resource does not automatically enable the employee to use MESuite.

Additional configuration is required, including:

  • Creating a Staff Vendor
  • Linking the Vendor to the Resource
  • Assigning Vendor G/L Account Allocations
  • Configuring Company Security
  • Granting MESuite module access

These configurations are covered in the following sections.

 

Creating a Staff Vendor

Overview

Every employee who submits Expense Claims must also have a corresponding Staff Vendor within Business Central.

The Staff Vendor represents the employee as a payable Vendor and is used during reimbursement. When an Expense Claim is approved, MESuite creates the financial transaction against the linked Staff Vendor, allowing the employee to be reimbursed through the standard Business Central purchasing process.

A Staff Vendor is not used for procurement or supplier purchasing. Instead, it exists solely to support employee reimbursements generated from approved Expense Claims.

Before You Begin

Before creating a Staff Vendor, ensure that:

  • A Resource has already been created for the employee.
  • General Posting Groups have been configured.
  • Vendor Posting Groups have been configured.
  • G/L Account Allocations have been created (recommended).
  • The employee exists as a Resource in Business Central.

 

Creating a Staff Vendor

To create a Staff Vendor

  1. Navigate to Vendors.
  2. Select New from the ribbon.
  3. Choose the appropriate Vendor Template (if applicable).
  4. Complete the required fields on the Vendor Card.
  5. Save the Vendor.

Completing the Vendor Card

The Vendor Card stores the financial information required to reimburse employees.

The following Fast Tabs should be completed before linking the Vendor to a Resource.