Open Extension management in Business Central
Install the eConnect extension from AppSource
Create web services in Business Central
Start the Assisted Setup for eConnect
Select environment and connect with eConnect
Configure Autopilot for Dynamics 365 Business Central
Manually send invoice via eConnect in Business Central
Set sending profile to ECONNECT
Customer card with E-Invoice ID for Peppol sending
View the Activity Log for a sent invoice
Connect Dynamics 365 Business Central with eConnect

Connect D365 BC via the Autopilot and AppSource extension for automatic invoice processing.

Integration methodAutopilot + AppSource extensionDirectionSend + ReceiveMinimum subscriptionBasicContract requiredNo

Connect Dynamics 365 Business Central (D365 BC) with eConnect via the Autopilot and the official AppSource extension "eConnect Peppol e-invoicing & OCR+". Invoices are automatically sent and received, including posting suggestions for purchase invoices.

Before you begin
  • An active eConnect account with at least a Basic subscription
  • Global admin rights in Business Central
  • Sufficient transaction credit on your eConnect account
Setting up the integration
Step 1: Install the extension
  1. Search for Extension management in Business Central.
  2. Search for eConnect and select eConnect Peppol e-invoicing & OCR+.

  1. Click Install and accept the terms.
  2. Select a language and click Install.

Step 2: Create web services
  1. Search for Web Services in Business Central (top right search bar).
  2. Click New to create the required web services as per the eConnect documentation.
  3. Enable the Published checkbox.

Step 3: Assisted setup
  1. Search for Assisted Setup and select eConnect.
  2. Make sure the user has global admin rights.

  1. Select the environment and click Connect.
  2. Log in with a user with BC Office 365 admin rights.

  1. Make sure the user has permissions for the desired partyId.
  2. Follow the on-screen steps.
Step 4: Configure Autopilot (for purchase invoices)

If you want to automatically post purchase invoices, configure the Autopilot from the eConnect platform:

  1. Go to the Autopilot app on the eConnect platform.
  2. Select the organisation and choose Microsoft Dynamics 365 Business Central.
  3. Log in with your Microsoft account and select the environment and organisation.
  4. Configure the Autopilot settings as desired.

Sending invoices

There are two options for sending sales invoices:

Option 1: Send manually
  1. Go to Posted Sales Invoices and select an invoice.
  2. Click Print/Send > Send.
  3. Enable eConnect for the Peppol option and click OK.

Option 2: Automatically send after posting
  1. Search for Document Sending Profiles.
  2. Make sure the ECONNECT profile is set to Automatic for Processing Mode.
  3. Open the Customer Card and set the Document Sending Profile to ECONNECT.
  4. Fill in the E-Invoice ID (Chamber of Commerce or OIN number).
  5. When posting an invoice, it will automatically be submitted.

Receiving invoices

Purchase invoices received via eConnect are automatically placed in your Business Central administration via the Digital Mailbox or the Autopilot.

Tip: The Activity Log of an invoice provides detailed information about communication with the PSB. Go to Posted Sales Invoices > Invoice > Activity Log.

Vendor matching on receipt

When a purchase invoice arrives in Business Central via eConnect, the vendor is automatically looked up using the identifiers in the invoice. The lookup order is:

PriorityIdentifierBC field1VAT numberVAT_Registration_No2Chamber of Commerce numberRegistration_Number3IBANBank accounts → No

The extension first searches by VAT number. If no match is found, it tries the Chamber of Commerce number, then the IBAN. If none of the identifiers yield a match, the invoice is not posted.

Note: If the vendor does not exist in Business Central, it will not be created automatically. The invoice will fail with an error message. Create the vendor manually in Business Central first.

When a vendor is found, the extension also checks whether the bank accounts provided (including any G-accounts) are registered with that vendor's linked bank accounts.

Advanced configuration
Entra ID authentication

When setting up the BC extension, you are redirected to the Autopilot Connect web page, where logging in with a Microsoft Entra ID account is required. This account is also used to call the BC environment via the API, and therefore needs sufficient rights and a BC licence.

After logging in, a user is automatically created in the eConnect identity server with login type "Business Central Azure Active Directory". TechSupport then manually assigns the tenantId and partyIds. Multiple partyIds can be linked to a user. The customer then chooses during setup which partyId is linked to which BC environment.

Connecting multiple BC environments

It is possible to connect multiple Business Central environments, but there are some important rules. Each environment needs a unique partyId. If multiple environments need to send invoices on behalf of the same Chamber of Commerce number, each connection must be made with a different Entra ID account. Each "Business Central Azure Active Directory" user in the identity server must also have a different tenantId.

There are two pitfalls to watch out for:

  • If you use the same partyId and the same Entra ID account, the new connection overwrites the existing one. You will lose the previous integration.
  • If you use the same partyId with multiple Entra ID accounts in the same tenant, the InvoiceSent hook will only go to one of the BC environments.
Client Credentials / App Registration

As an alternative to Entra ID authentication, you can also authenticate via Client Credentials from an App Registration. This is particularly suitable for posting purchase invoices. There is currently no UI for this flow; TechSupport sets this up via the API.

The steps are as follows:

  1. Create a new connection via the Autopilot UI in the platform.
  2. If the BC environment does not use the default Microsoft cloud URL: have TechSupport adjust the baseUrl via the Management API (Update Attributes). If necessary, additionalQueryParameters may also need to be set.
  3. TechSupport calls the activate endpoint with the Client Credential details and BC environment information. The referenceKey parameter is a Base64-encoded string with the format businesscentral_{contextId}_{tenantId}_{connectionId}.

Contact support if you want to use this authentication method.

Common error messages

::e-accordion-item{value="item-1" header=""API400 Could not retrieve vendor ids""} The vendor was not found in Business Central based on the identifiers in the invoice (VAT number, Chamber of Commerce number or IBAN). Check that the vendor is correctly set up and that the VAT number, Chamber of Commerce number or IBAN matches the details in the invoice. ::

::e-accordion-item{value="item-2" header=""BCNotFound: Internal_InvalidTableRelation ... G-Account Code""} The invoice contains a G-account number that is not registered as a bank account with the relevant vendor. This occurs with organisations using the Idyn extension for G-accounts. Register the G-account number as a bank account with the vendor in Business Central. ::

::e-accordion-item{value="item-3" header=""BCBadRequest: ... Transaction Type ... ECONNECT""} The value "ECONNECT" does not exist in the Transaction Type table. When installing the eConnect extension, this transaction type is normally created automatically. For older versions, you need to add it manually: search for Transaction Types in Business Central and add the code "ECONNECT". ::

::e-accordion-item{value="item-4" header=""BCBadRequest: ... VAT Prod. Posting Group""} The VAT product posting group from the invoice does not exist in Business Central. Check that the VAT mapping is correctly configured. During setup, an Excel file (BusinessCentral VAT Mapping) is used to map VAT codes. Add the missing group to the VAT Product Posting Group table. ::

::e-accordion-item{value="item-5" header="Autopilot connection shows "Page is currently unavailable""} A BC licence is likely missing for the user trying to make the connection. Refer the customer to their BC partner (e.g. Databalk) to check the licence assignment. ::

BCTooManyRequests: API rate limit reached

This error comes from Microsoft Business Central, not from eConnect. The document has usually already been processed. Check in Business Central whether the invoice has been posted. If the problem persists, contact your BC partner to increase the API limits.

BCNotFound: PSBWebhookReceiver_ReceiveHook

The integration has become corrupted, usually due to a previous installation or uninstallation of the eConnect app. Contact eConnect support to remove the old connection and create a new one.

API400: The given action 'booking' is not supported

The connection configuration has the action set to "booking" instead of "autobooking". Contact eConnect support to correct this via the Management API.


Want to know more about the Autopilot? Read how the Autopilot works.

Start the integration

Frequently asked questions
Which subscription do I need for the D365 BC integration?

You need a Basic subscription with eConnect. You also need the eConnect app (free) from the BC AppSource. The integration works via the Autopilot.

Can I connect multiple BC environments?

Yes, you can connect multiple Business Central environments. For each environment, you create a separate Autopilot connection in the eConnect platform. Use unique credentials for each environment.

How does eConnect find the vendor on receipt?

eConnect tries to match the vendor in Business Central via a fixed lookup order: first the VAT number, then the Chamber of Commerce number, and finally the IBAN. If none of these identifiers yields a match, the invoice is not automatically posted but fails with an error message. You can then create the vendor manually in Business Central, after which the document can be resubmitted.