Integrations

Erpena API

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.

REST API JSON JWT OpenAPI

Custom integrations

An open interface to Erpena

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

What is currently available through the API

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.

Customers, leads, contacts and addresses

Retrieve, search, create and update customers and leads, including contacts, addresses and conversion of a lead into a customer.

Orders

Create and retrieve orders and work with order lines, comments, assignments and state changes.

Tasks

Retrieve, search, create and update tasks, including states, assignments and comments.

Tickets

Work with customer-support tickets, their states, comments, assignments, resolution and reopening.

Billing

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

How to connect to the API

The API communicates using JSON and token-based authentication. The examples below are illustrative only

1. Obtain an access token

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"
}

2. Call an API method

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"
}

Detailed methods are documented in OpenAPI

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.

Open API documentation