The ClientConnector is eConnect's Windows CLI tool for exchanging invoices via local folders. When to use it and how to set it up.
The ClientConnector is the only CLI tool eConnect offers for invoice exchange. It is not a REST API client: the tool runs on Windows, monitors local folders and exchanges files with the eConnect platform.
Note: this is different from the PHP or .NET SDKs. The SDKs talk directly to the PSB REST API. The ClientConnector is intended for software that can only read and write files in a folder.
Use the ClientConnector when:
For new integrations in PHP, .NET or other languages with API support, an SDK or OpenAPI client is usually the better choice.
The ClientConnector runs as a background process on your Windows server:
The tool polls periodically for new files. Your software only needs to write and read files; authentication and transport are handled by the ClientConnector.
[Your software] → send folder → [ClientConnector] → eConnect PSB
[Your software] ← receive folder ← [ClientConnector] ← eConnect PSB
See Connection keys for more context on key management.
Configure your software to export invoices to the send folder and import from the receive folder. The exact steps depend on your package.
The ClientConnector is used with Syntess among others (send and receive). Other packages that can read/write files to a local folder are suitable in principle.
Scripts and workflows can communicate with eConnect via the folder structure without making HTTP calls themselves. This is useful for automated processing on Windows servers, but it does not replace a PSB API integration on other platforms.
For API automation in CI/CD (validation, test sends) use the REST API with curl, an SDK or a generated client — see OpenAPI codegen.
Step-by-step instructions, FAQ and troubleshooting are in the full article: