FlexiBee Connector

An Orchesty connector for FlexiBee (ABRA Flexi), a modern economic system designed for small companies.

Application Type

Basic

This connector authenticates against a self-hosted FlexiBee instance using either HTTP Basic auth (username + password) or a JSON session token obtained via the /login-logout/login.json endpoint. The session token is cached for up to 30 minutes.

| Field | Description | |---|---| | flexibeeUrl | Full URL of your FlexiBee instance (e.g. https://demo.flexibee.eu) | | user | Your FlexiBee username | | password | Your FlexiBee password | | auth | Authentication method: json (session token) or http (Basic auth) |

Components

| Class | Type | Description | |---|---|---| | FlexiBeeCreateFakturaPrijataConnector | Connector | Creates a received invoice (faktura-prijata) | | FlexiBeeCreateFakturaPrijataPrilohaConnector | Connector | Uploads a PDF attachment to a received invoice | | FlexiBeeCreateNewContactConnector | Connector | Creates a new company/contact via the admin endpoint | | FlexiBeeCreateObjednavkaVydanaConnector | Connector | Creates an issued purchase order (objednavka-vydana) | | FlexiBeeCreateSkladovyPohybConnector | Connector | Creates a warehouse stock movement (skladovy-pohyb) | | FlexiBeeCreateZavazekConnector | Connector | Creates a liability record (zavazek) | | FlexiBeeCreateZavazekPrilohaConnector | Connector | Uploads a PDF attachment to a liability record | | FlexiBeeGetCenikKartyConnector | Connector | Fetches pricelist card details by reference URL | | FlexiBeeGetCompaniesConnector | Connector | Lists all companies on the FlexiBee instance | | FlexiBeeGetContactsArrayConnector | Connector | Retrieves an array of contacts (kontakt.json) | | FlexiBeeGetFakturaPrijataConnector | Connector | Fetches a single received invoice by ID | | FlexiBeeGetObjednavkaVydanaConnector | Connector | Fetches a single issued order by ID | | FlexiBeeGetSarzeExpiraceKartyConnector | Connector | Fetches batch/expiry records for a stock card | | FlexiBeeGetZavazekConnector | Connector | Fetches a single liability record by ID | | FlexiBeeUpdateObjednavkaPrijataConnector | Connector | Updates a received purchase order | | FlexiBeeUpdateSkladovyPohybConnector | Connector | Updates a warehouse stock movement | | FlexiBeeCleneniDphBatch | Batch | Paginated list of VAT membership classification records | | FlexiBeeCleneniKontrolniHlaseniBatch | Batch | Paginated list of VAT control statement classification records | | FlexiBeeFormaDopravyBatch | Batch | Paginated list of delivery/transport method codelist entries | | FlexiBeeFormaUhradyBatch | Batch | Paginated list of payment method codelist entries | | FlexiBeeGetSkladovyPohybBatch | Batch | Paginated list of warehouse stock movement records | | FlexiBeeObjednavkaPrijataBatch | Batch | Paginated list of received orders | | FlexiBeeObjednavkaVydanaBatch | Batch | Paginated list of issued orders | | FlexiBeePredpisZauctovaniBatch | Batch | Paginated list of accounting posting templates | | FlexiBeeSkladoveKartyBatch | Batch | Paginated list of warehouse stock cards | | FlexiBeeStitkyBatch | Batch | Paginated list of labels/tags | | FlexiBeeStrediskoBatch | Batch | Paginated list of cost centre records | | FlexiBeeTypFakturyPrijateBatch | Batch | Paginated list of received invoice types | | FlexiBeeUcetBatch | Batch | Paginated list of chart of accounts entries | | FlexiBeeZakazkaBatch | Batch | Paginated list of job/project (zakázka) records |

Setup

Credentials

FlexiBee is a self-hosted application. You need your own FlexiBee instance to use this connector. Contact your system administrator or ABRA Software for a developer licence and API access.

In Orchesty, fill in:

• flexibeeUrl — the full URL of your FlexiBee installation
• user / password — your FlexiBee login credentials
• auth — set to json for session token auth (recommended) or http for Basic auth

API Documentation

FlexiBee REST API: https://www.flexibee.eu/api/

Installation & Usage

Install the package:

npm install @orchesty/connector-flexi-bee @orchesty/nodejs-sdk
# or
pnpm add @orchesty/connector-flexi-bee @orchesty/nodejs-sdk

The FlexiBeeApplication requires CurlSender and DatabaseClient from the SDK:

import { container } from '@orchesty/nodejs-sdk';
import CurlSender from '@orchesty/nodejs-sdk/dist/lib/Transport/Curl/CurlSender';
import DatabaseClient from '@orchesty/nodejs-sdk/dist/lib/Storage/Database/Client';
import FlexiBeeApplication from '@orchesty/connector-flexi-bee/dist/FexiBeeApplication';
import FlexiBeeCreateFakturaPrijataConnector from '@orchesty/connector-flexi-bee/dist/Connector/FlexiBeeCreateFakturaPrijataConnector';
import FlexiBeeGetCompaniesConnector from '@orchesty/connector-flexi-bee/dist/Connector/FlexiBeeGetCompaniesConnector';
import FlexiBeeObjednavkaPrijataBatch from '@orchesty/connector-flexi-bee/dist/Batch/FlexiBeeObjednavkaPrijataBatch';

const app = new FlexiBeeApplication(container.get(CurlSender), container.get(DatabaseClient));
container.setApplication(app);
container.setNode(new FlexiBeeCreateFakturaPrijataConnector(), app);
container.setNode(new FlexiBeeGetCompaniesConnector(), app);
container.setNode(new FlexiBeeObjednavkaPrijataBatch(), app);
// ... register additional connectors and batches as needed

License

This connector is released under the Apache License 2.0. See the LICENSE file for the full license text.

Contributing

Contributions are welcome! This connector is part of the open-source Orchesty Node.js Connectors monorepo.

For guidelines on how to create or update connectors — including project setup, coding conventions, and how to write tests — please refer to the Contributing to Connectors guide.

All contributions should include:

• Source code in src/ following the existing connector structure
• Tests in src/**/__tests__/ with input.json, mock.json, and output.json fixtures
• An updated CHANGELOG.md entry