De ClientConnector is de enige door eConnect aangeboden CLI-tool voor factuuruitwisseling. Het is geen REST API-client: de tool draait op Windows, monitort lokale mappen en wisselt bestanden uit met het eConnect-platform.

Let op: dit is iets anders dan de PHP- of .NET-SDK's. De SDK's praten direct met de PSB REST API. De ClientConnector is bedoeld voor software die alleen bestanden kan lezen en schrijven naar een map.

Gebruik de ClientConnector als:

• je bronsysteem geen HTTP/API-integratie ondersteunt (legacy on-premise software)
• de Email Receiver of een directe API-koppeling geen optie is
• scripts of automatisering facturen via bestanden willen aanleveren of ophalen

Voor nieuwe integraties in PHP, .NET of andere talen met API-ondersteuning is een SDK of OpenAPI-client doorgaans de betere keuze.

De ClientConnector draait als achtergrondproces op je Windows-server:

• Verzendmap — bestanden die je software hier plaatst, worden naar eConnect verstuurd
• Ontvangstmap — inkomende facturen van eConnect worden hier neergezet

De tool pollt periodiek op nieuwe bestanden. Je software hoeft alleen bestanden te schrijven en lezen; authenticatie en transport regelt de ClientConnector.

[Jouw software] → verzendmap → [ClientConnector] → eConnect PSB
[Jouw software] ← ontvangstmap ← [ClientConnector] ← eConnect PSB

1. Log in op platform.econnect.eu.
2. Ga naar Verbindingen in je organisatie.
3. Klik op de oranje bol (+) → Nieuwe algemene verbinding.
4. Selecteer Lokale map / CLI-tool.
5. Genereer verbindingssleutels en kopieer ze.

Zie Verbindingssleutels voor meer context over sleutelbeheer.

1. Download de ClientConnector via het eConnect-platform of vraag deze aan bij support.
2. Installeer op de Windows-server waar je bronsysteem draait.
3. Configureer verbindingssleutels en paden voor verzend- en ontvangstmap.

Configureer je software om facturen te exporteren naar de verzendmap en te importeren uit de ontvangstmap. De exacte stappen hangen af van je pakket.

De ClientConnector wordt onder meer gebruikt met Syntess (verzenden en ontvangen). Andere pakketten die bestanden kunnen lezen/schrijven naar een lokale map zijn in principe geschikt.

Scripts en workflows kunnen via de mappenstructuur met eConnect communiceren zonder zelf HTTP-calls te doen. Dit is handig voor geautomatiseerde verwerking op Windows-servers, maar vervangt geen PSB API-integratie op andere platformen.

Voor API-automation in CI/CD (validatie, testverzendingen) gebruik je de REST API met curl, een SDK of een gegenereerde client — zie OpenAPI codegen.

• Windows-server
• Professional-abonnement bij eConnect
• Subscription key (via sales)
• Verbindingssleutels uit het platform
• Schijfruimte voor verzend- en ontvangstmap

Stap-voor-stap instructies, FAQ en troubleshooting staan in het volledige artikel:

→ ClientConnector: koppelen via een lokale map