ProductKnowledgeDevelopers
Platform Control
Connecting 4PS Business Central with eConnect

Connect 4PS Business Central via API with connection keys and subscription key.

Integration methodAPI (API31 + subscription key)DirectionSend + ReceiveMinimum subscriptionProfessionalContract requiredYes (via sales)

You connect 4PS Business Central in 2026 with eConnect via an API connection. This requires a contract with API rights and a subscription key that you receive from the eConnect sales team.

Before you start
  • An active eConnect account with at least a Professional subscription
  • A contract with eConnect for API rights, including subscription key
  • An activated organization on the eConnect platform
  • Administrator access to your 4PS Business Central environment
Setting up the integration
Step 1: Create connection keys

Create connection keys in the eConnect platform. Follow the steps in Creating connection keys.

Step 2: Configuration in 4PS Business Central
  1. In 4PS Business Central, go to the eConnect document uitwisseling instellingen setting.
  2. For Type aansluiting, select API31.
  3. Enter the following details:
    • The connection keys (App Key and Secret)
    • The Bedrijfs-ID eConnect (found under Organizations on the platform, starts with "XC...")
    • The subscription key you received from sales
  4. Click Verbinding testen to verify everything is configured correctly.
If the test fails

Check that the "Generieke webservice naamruimten" are filled in correctly:

  • Prefix: soapenv
  • Namespace: http://schemas.xmlsoap.org/soap/envelope/
Step 3: Set up customer card for sending

To send sales invoices, an identifier (Chamber of Commerce number, GLN or VAT number) is required on the customer card.

  1. Open the customer card in 4PS Business Central.
  2. Configure the e-invoicing details in the Sales section.
Integration via the PSB (new integration path)

In addition to the API31 integration described above, a newer integration path is available via the eConnect PSB (Peppol Service Broker). This path uses the eConnect extension in Business Central and Microsoft Entra ID for authentication. The legacy path (API31 + subscription key) remains fully supported.

Preparation

Before you start, you need the following:

  • The username of the person setting up the integration
  • Organization names and Chamber of Commerce number (or other business registration number)
  • Someone with global admin or super admin rights must be available
  • Check in advance whether the eConnect extension may be installed (some organizations only allow this outside business hours)

It is helpful to have the customer walk through the settings in advance until the screen showing that no partyIds are linked. Sometimes an Entra ID admin needs to grant permission to sign in to eConnect first, and this can then be arranged beforehand.

Step 1: Install the extension
  1. Open Business Central and search for Extensiebeheer using the search bar.
  2. Search for "eConnect" and install the extension via the three dots.
Step 2: Configure the extension
  1. Click the eConnect Peppol link and check HttpClient aanvragen.
  2. For PSB Omgeving, select the correct environment (acceptance for testing, production for live use).
  3. Click Connect to the eConnect PSB.
  4. Sign in with your Microsoft Entra ID account. This account must have sufficient rights for the BC API.
  5. The first time, a screen appears showing that partyIds are not yet linked. At that point, contact TechSupport, who will link the partyIds. Then sign in again (preferably in an incognito session).
  6. Select the organization name and review the settings. Sending via Peppol must be checked.
Step 3: Configure the sending profile

After setting up the extension, you need to configure the sending profile. This determines how invoices are processed after posting.

SettingOptionsExplanationDefaultYes / NoThe default profile is used when no sending profile is set on the customer card. Usually, do not set this as default, as it causes issues for customers without Peppol support.Processing ModeManual / AutomaticWith Automatic, the invoice is submitted and validated immediately upon posting (errors can still be corrected). With Manual, the invoice cannot be modified after posting, and you need a credit note for errors.XMLPorts(optional)Custom mapping of BC fields to e-invoice XML. The eConnect mapping is set by default.
Step 4: Set up the customer card

On the customer card, configure e-invoicing per customer:

  • Set the sending profile to eConnect. In 4PS, this is sometimes a hidden field; look it up via "personaliseren".
  • Set "elektronische facturering" to Verzendprofiel van documenten (not "eVerbinding", which belongs to the old integration).
  • Fill in the Endpoint-ID completely including schemeID, for example 0106:12345678.
  • If a different ID should appear on the invoice (such as a GLN or VAT number): enter an identifier at Legal ID with a schemeID that does not start with a 9.
  • Make sure the fields "uw referentie" or "extern documentnummer" are filled in. These are used as BuyerReference or order number.
Incoming via Autopilot

The integration for incoming invoices is set up via the Autopilot in the eConnect platform. You need a platform user with access to all organizations and a user with admin rights in Business Central. See Autopilot: automatically import invoices for the steps.

Need help with the integration? Contact support.

Connect your administration