ProductKennisDevelopers
Platform Control
4PS Business Central koppelen met eConnect

4PS Business Central koppelen via API met verbindingssleutels en subscription key.

IntegratiemethodeAPI (API31 + subscription key)RichtingVerzenden + OntvangenMinimaal abonnementProfessionalContract nodigJa (via sales)

4PS Business Central koppel je in 2026 met eConnect via een API-verbinding. Dit vereist een contract met API-rechten en een subscription key die je van de salesafdeling van eConnect ontvangt.

Voordat je begint
  • Een actief eConnect-account met minimaal een Professional-abonnement
  • Een contract met eConnect voor API-rechten, inclusief subscription key
  • Een geactiveerde organisatie op het eConnect-platform
  • Beheerderstoegang tot je 4PS Business Central-omgeving
Koppeling instellen
Stap 1: Verbindingssleutels aanmaken

Maak verbindingssleutels aan in het eConnect-platform. Volg hiervoor de stappen in Verbindingssleutels aanmaken.

Stap 2: Inrichting in 4PS Business Central
  1. Ga in 4PS Business Central naar de instelling eConnect document uitwisseling instellingen.
  2. Kies bij Type aansluiting voor API31.
  3. Voer de volgende gegevens in:
    • De verbindingssleutels (App Key en Secret)
    • Het Bedrijfs-ID eConnect (te vinden onder Organisaties op het platform, begint met "XC...")
    • De subscription key die je van sales hebt ontvangen
  4. Klik op Verbinding testen om te controleren of alles correct is ingesteld.
Als de test niet slaagt

Controleer of de "Generieke webservice naamruimten" correct zijn ingevuld:

  • Prefix: soapenv
  • Naamruimte: http://schemas.xmlsoap.org/soap/envelope/
Stap 3: Klantkaart inrichten voor verzending

Om verkoopfacturen te kunnen versturen is een identifier (KvK, GLN of BTW-nummer) verplicht op de klantkaart.

  1. Open de klantkaart in 4PS Business Central.
  2. Stel de e-facturatiegegevens in bij de sectie Verkoop.
Koppeling via de PSB (nieuw integratiepad)

Naast de hierboven beschreven API31-koppeling is er een nieuwer integratiepad beschikbaar via de eConnect PSB (Peppol Service Broker). Dit pad maakt gebruik van de eConnect-extensie in Business Central en Microsoft Entra ID voor authenticatie. Het legacy-pad (API31 + subscription key) blijft volledig ondersteund.

Voorbereiding

Voordat je begint, heb je het volgende nodig:

  • De gebruikersnaam van de persoon die de koppeling legt
  • Organisatienamen en KvK-nummer (of ander ondernemingsnummer)
  • Iemand met global admin of super admin rechten moet beschikbaar zijn
  • Controleer vooraf of de eConnect-extensie geinstalleerd mag worden (bij sommige organisaties is dit alleen buiten kantoortijden toegestaan)

Het is handig om de klant vooraf de instellingen al te laten doorlopen tot het scherm dat er geen partyIds zijn gekoppeld. Soms moet een Entra ID-admin eerst toestemming geven om bij eConnect in te loggen, en dat kan dan ook vooraf worden geregeld.

Stap 1: Extensie installeren
  1. Open Business Central en zoek via de zoekbalk naar Extensiebeheer.
  2. Zoek op "eConnect" en installeer de extensie via de drie puntjes.
Stap 2: Extensie instellen
  1. Klik op de eConnect Peppol-link en vink HttpClient aanvragen aan.
  2. Kies bij PSB Omgeving de juiste omgeving (acceptatie voor testen, productie voor live gebruik).
  3. Klik op Connect to the eConnect PSB.
  4. Log in met je Microsoft Entra ID-account. Dit account moet voldoende rechten hebben voor de BC API.
  5. Bij de eerste keer verschijnt een scherm dat de partyIds nog niet zijn gekoppeld. Schakel op dat moment met TechSupport, die de partyIds koppelt. Log daarna opnieuw in (bij voorkeur in een incognito-sessie).
  6. Selecteer de organisatienaam en controleer de instellingen. Verzending via Peppol moet aangevinkt staan.
Stap 3: Verzendprofiel configureren

Na het instellen van de extensie moet je het verzendprofiel configureren. Dit bepaalt hoe facturen worden verwerkt na het boeken.

InstellingOptiesToelichtingDefaultJa / NeeHet default profiel wordt gebruikt als er op de klantkaart geen verzendprofiel is ingesteld. Stel dit meestal niet als default in, omdat het problemen geeft bij klanten zonder Peppol-ondersteuning.Processing ModeManual / AutomaticBij Automatic wordt de factuur bij het boeken direct aangeboden en gevalideerd voor het boeken (fouten zijn nog aanpasbaar). Bij Manual is de factuur na het boeken niet meer aanpasbaar en heb je bij fouten een correctiefactuur nodig.XMLPorts(optioneel)Eigen mapping van BC-velden naar e-factuur XML. Standaard staat de eConnect-mapping ingesteld.
Stap 4: Klantenkaart inrichten

Op de klantenkaart stel je per klant de e-facturatie in:

  • Zet het verzendprofiel op eConnect. Bij 4PS is dit soms een verborgen veld; zoek het op via "personaliseren".
  • Zet "elektronische facturering" op Verzendprofiel van documenten (niet "eVerbinding", dat hoort bij de oude koppeling).
  • Vul het Endpoint-ID volledig in inclusief schemeID, bijvoorbeeld 0106:12345678.
  • Als er een ander ID op de factuur moet staan (zoals een GLN of BTW-nummer): vul bij Legal ID een identifieer in met een schemeID dat niet begint met een 9.
  • Zorg dat de velden "uw referentie" of "extern documentnummer" zijn ingevuld. Deze worden gebruikt als BuyerReference of ordernummer.
Inkomend via Autopilot

De koppeling voor inkomende facturen wordt gelegd via de Autopilot in het eConnect-platform. Hiervoor heb je een platformgebruiker nodig met toegang tot alle organisaties, en een gebruiker met admin-rechten in Business Central. Zie Autopilot: automatisch facturen inlezen voor de stappen.

Veelgestelde vragen
Wat is het verschil tussen de API31-koppeling en de PSB-koppeling?

De API31-koppeling werkt met verbindingssleutels en een subscription key, en is het oorspronkelijke integratiepad. De PSB-koppeling is nieuwer, maakt gebruik van de eConnect-extensie in Business Central en Microsoft Entra ID voor authenticatie. Beide paden worden volledig ondersteund.

Hoe ontvang ik inkoopfacturen in 4PS Business Central?

Inkomende facturen worden gekoppeld via de Autopilot in het eConnect-platform. Je hebt een platformgebruiker nodig met toegang tot alle organisaties en een gebruiker met admin-rechten in Business Central. De Autopilot stuurt facturen automatisch door naar je administratie.

Wat als de verbindingstest in 4PS Business Central niet slaagt?

Controleer of de generieke webservice naamruimten correct zijn ingevuld (prefix: soapenv, naamruimte: http://schemas.xmlsoap.org/soap/envelope/). Verifieer ook of de verbindingssleutels, het Bedrijfs-ID en de subscription key correct zijn ingevoerd.

Hulp nodig bij de koppeling? Neem contact op met support.

Verbind je administratie

Gerelateerd