De verbinding met het platform instellen

Business Central verbinden met het e-factureringsplatform kost drie stappen: uitgaande oproepen toelaten voor de extensie, de API-sleutel-id en het secret invoeren, en de verbinding testen. Zodra de test meldt hoeveel bedrijven uw sleutel bereikt, werkt de verbinding en kunt u verder met het koppelen van uw bedrijven.

Dit doet u één keer per Business Central-database. De gegevens worden door elk bedrijf in die database gedeeld.

Vereisten

Een account bij het e-factureringsplatform, met een API-sleutel-id en een API-secret.
De machtigingenset E-Invoice Platform-beheerder. De dagelijkse gebruikersset heeft bewust alleen leesrechten op de instellingen.

Laat eerst uitgaande oproepen toe

Zonder dit werkt niets, en bij een verse installatie staat het altijd uit.

Kies het Zoeken-pictogram, voer Extensiebeheer in en kies de bijbehorende koppeling.
Selecteer E-Invoice Platform.
Kies de actie Configureren.
Zet op de pagina Extensie-instellingen de schakelaar Allow HttpClient Requests aan.

Note

Configureren is niet dezelfde actie als Instellen. Instellen opent de instellingenpagina van de app zelf; de schakelaar voor uitgaande oproepen staat alleen op Extensie-instellingen, achter Configureren.

Bij een herinstallatie gaat dit opnieuw uit, dus controleer het na elke herinstallatie. Zolang het uit staat mislukken oproepen zonder statuscode en zonder enige melding van het platform.

Voer de gegevens in

Kies het Zoeken-pictogram, voer Instellingen E-Invoice Platform in en kies de bijbehorende koppeling. De pagina staat ook in Handmatige instellingen, onder de trefwoorden Peppol, E-Invoice, Electronic Invoice, Recommand en E-Document.
Vul op het tabblad Verbinding de velden in zoals hieronder beschreven.
Kies de actie Verbinding testen.

Veld	Wat u invult
Basis-URL	De basis-URL van de platform-API. Die staat al ingevuld met het standaardadres van de leverancier, dus laat ze staan tenzij u anders is gemeld. Een afsluitende slash wordt automatisch toegevoegd.
API-sleutel-id	De Basic API-sleutel-id — het stuk vóór de dubbele punt. De sleutel hoort bij uw team en bereikt elk bedrijf daarin.
API-secret	Het secret dat bij de sleutel hoort. Typ het één keer; het wordt versleuteld bewaard en nooit meer getoond.

Het secret staat buiten de databasetabellen en wordt door geen enkele pagina of API teruggegeven. Eens bewaard kunt u het dus niet meer uitlezen — alleen vervangen of wissen. Het veld Secret geconfigureerd zegt of er een bewaard is.

Wijzigt u de basis-URL naar een adres dat niet met https:// begint, dan waarschuwt de pagina dat de gegevens onversleuteld verstuurd zouden worden. Kies Basis-URL terugzetten op standaard om het standaardadres terug te zetten.

Controleer of het werkt

Kies Verbinding testen. Bij succes krijgt u:

Verbinding OK. Deze API-sleutel kan n bedrijf/bedrijven bereiken.

Dat getal zegt hoeveel bedrijven er op het platform onder deze sleutel bestaan, niet hoeveel Business Central-bedrijven gekoppeld zijn. Verbindingsstatus springt op OK, en Laatst getest en Laatste testresultaat houden bij wat er gebeurd is.

Is de sleutel geldig maar bereikt hij niets, dan krijgt u Deze API-sleutel kan geen enkel bedrijf op het e-factureringsplatform bereiken. — de sleutel werkt, maar er is aan de platformkant nog geen bedrijf aangemaakt. Neem contact op met de leverancier van het platform.

Het secret vervangen of wissen

Wilt u het secret vervangen, typ dan het nieuwe over de gemaskeerde plaatshouder en de pagina bewaart het. Laat u de plaatshouder staan, dan blijft het huidige secret behouden.

Wissen doet u met de actie Secret wissen. U wordt om bevestiging gevraagd, want het secret is gedeeld:

Het opgeslagen API-secret verwijderen? Elk bedrijf in deze database stopt met verzenden tot er een nieuw secret is ingevoerd.

Wat er daarna gebeurt

Met een werkende verbinding koppelt u elk Business Central-bedrijf aan de entiteit waaronder het verzendt. Zolang die koppeling er niet is en haar identiteitscontrole niet doorstaan heeft, kan er niets verstuurd worden. Ga naar Uw bedrijven koppelen aan het platform.