Customers, leads, contacts and addresses
Retrieve, search, create and update customers and leads, including contacts, addresses and conversion of a lead into a customer.
Integrations
Connect Erpena with other business systems through a standard REST API.
Alongside the ready-made integrations available directly in Erpena, the API lets you connect your own applications or existing business systems and automate data exchange.
Custom integrations
The API is intended for situations where you need to connect Erpena to a system without a ready-made standard integration. This may be an ERP or accounting system, e-commerce platform, data warehouse, internal application or another business service.
The integration can work with supported Erpena data and connect it to other business processes without manually transferring information between systems.
Current scope
The current API exposes selected core areas of Erpena. The exact and always up-to-date list of supported methods, parameters and data models is available in the OpenAPI documentation.
Retrieve, search, create and update customers and leads, including contacts, addresses and conversion of a lead into a customer.
Create and retrieve orders and work with order lines, comments, assignments and state changes.
Retrieve, search, create and update tasks, including states, assignments and comments.
Work with customer-support tickets, their states, comments, assignments, resolution and reopening.
Create and search bills, work with billing items and related invoicing operations.
We continuously extend the API according to customer needs and specific integrations. The OpenAPI documentation is therefore the source of truth for the current list of supported methods.
Technical
The API communicates using JSON and token-based authentication. The examples below are illustrative only
The login method returns a token that you then use to authorize subsequent requests.
POST {login-endpoint}
Content-Type: application/json
{
"profile": "your-profile",
"password": "your-password"
}
Send the token in the Authorization header and call the required method, for example to retrieve customer details.
GET {customer-detail-endpoint}
Authorization: Bearer {token}
Accept: application/json
{
"customerRefId": "CUST-001",
"customerName": "Example s.r.o.",
"companyIdentification": "12345678",
"defaultEmail": "info@example.com"
}
The interactive documentation is the single place where we maintain the current technical description of the API – available methods, parameters, required fields, data models, response codes and the option to try individual calls.