PHPackages                             ecomailcz/flexibee-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ecomailcz/flexibee-client

ActiveLibrary[API Development](/categories/api)

ecomailcz/flexibee-client
=========================

ECOMAIL.CZ - Simple client for communication with FlexiBee API

1.4(4y ago)10830.7k↑18.7%2[3 issues](https://github.com/Ecomailcz/flexibee-client/issues)MITPHPPHP ^8.0

Since Jun 26Pushed 1y ago2 watchersCompare

[ Source](https://github.com/Ecomailcz/flexibee-client)[ Packagist](https://packagist.org/packages/ecomailcz/flexibee-client)[ RSS](/packages/ecomailcz-flexibee-client/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (17)Versions (20)Used By (0)

FlexiBee - PHP HTTP client
==========================

[](#flexibee---php-http-client)

Jednoduchý cURL client, který se stará o správné složení requestu do systému Flexibee a následné vrácení výsledků.

[![License](https://camo.githubusercontent.com/6536e527f212fa8420a7cf83eb17a9879baaed7d40cee970edf11433a1b1555e/68747470733a2f2f706f7365722e707567782e6f72672f65636f6d61696c637a2f666c6578696265652d636c69656e742f6c6963656e73653f666f726d61743d666c6174)](https://packagist.org/packages/ecomailcz/flexibee-client)[![Latest version](https://camo.githubusercontent.com/d826c0d05240e434e57ce14763bc5d1868e01b91ec8eff7fcd49a304e8400a38/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65636f6d61696c637a2f666c6578696265652d636c69656e742e7376673f636f6c6f72423d303037454336)](https://packagist.org/packages/ecomailcz/flexibee-client)[![Downloads](https://camo.githubusercontent.com/2ca9754cffc6380c8cc4577579a615099108af555cf8fcc55d4800181369d8b8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f65636f6d61696c637a2f666c6578696265652d636c69656e742e7376673f636f6c6f72423d303037454336)](https://packagist.org/packages/ecomailcz/flexibee-client)[![PHPStan](https://camo.githubusercontent.com/7502cadb433f75121bf841d00afe464568e203fe32514fc5d13e152e65379229/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374796c652d6c6576656c253230372d627269676874677265656e2e7376673f266c6162656c3d7068707374616e)](https://camo.githubusercontent.com/7502cadb433f75121bf841d00afe464568e203fe32514fc5d13e152e65379229/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374796c652d6c6576656c253230372d627269676874677265656e2e7376673f266c6162656c3d7068707374616e)

Sponsored by
------------

[](#sponsored-by)

[![Downloads](https://camo.githubusercontent.com/0e9b2c1ada7ffebb20bc0a97bccfb00d4ede22cf9e97cd12842ba0cca29b1c7b/68747470733a2f2f65636f6d61696c2e637a2f696d616765732f6c6f676f40322e706e67)](https://ecomail.cz)

Instalace přes composer
-----------------------

[](#instalace-přes-composer)

`composer require ecomailcz/flexibee-client`

Implementace
------------

[](#implementace)

```
$client = new Client(
$accountUrl,
$companyCode,
$restApiUserName,
$restApiPassword,
$evidenceName,
$disableSelfSignedCertificate,
$authSessionId,
);

```

`$disableSelfSignedCertificate - Vypnutí self signed certifikátu`

`$authSessionId - Hodnota authentikačního id pro Flexibee`

Vygenerování autorizačního tokenu
---------------------------------

[](#vygenerování-autorizačního-tokenu)

```
$client = new Client('https://demo.flexibee.eu', 'demo', 'winstrom', 'winstrom', 'adresar', false, null);
$tokens = $client->getAuthAndRefreshToken();

```

Informace o firmách či firmě
----------------------------

[](#informace-o-firmách-či-firmě)

```
$client = new Client('https://demo.flexibee.eu', 'demo', 'winstrom', 'winstrom', 'adresar', false, null);
$companies = $client->getCompanies();
$company = $client->getCompany();

```

Vytvoření či editace záznamu
----------------------------

[](#vytvoření-či-editace-záznamu)

```
$client = new Client('https://demo.flexibee.eu', 'demo', 'winstrom', 'winstrom', 'adresar', false, null);
$evidenceData['kod'] = 'prvnizaznam'
$evidenceData['nazev'] = 'První kontaktní adresa'
$evidenceItemId = $client->save($evidenceData, null, $dryRun, $uriParameters);

```

Pokud vše proběhne v pořádku, vratí se třída `\EcomailFlexibee\Http\Response\Response:class` s daty ze systému Flexibee. Nastane-li chyba, vyhodí se výjimka `EcomailFlexibeeRequestFail::class`. Pro editaci záznamu stačí vyplnit druhý parametr `$id`.

Vrácení záznamu dle parametrů
-----------------------------

[](#vrácení-záznamu-dle-parametrů)

Nalezení záznamu dle id s vyhozením výjimky, pokud záznam neexistuje

```
$evidenceItem = $client->getById($evidenceItemId, $uriParameters);
$evidenceItem = $client->getByCode($evidenceItemCode, $uriParameters);

```

Vrácení prázného záznamu, pokud neexistuje ve Flexibee (bez vyhození výjimky)

```
$evidenceItem = $client->findById($evidenceItemId, $uriParameters);
$evidenceItem = $client->findByCode($evidenceItemCode, $uriParameters);
$evidenceItem = $client->findLastInEvidence($evidenceItemCode, $uriParameters);

```

Sumace
------

[](#sumace)

```
$client->sumInEvidence();

```

Smazání záznamu
---------------

[](#smazání-záznamu)

```
$client->deleteById($id, $dryRun);
$client->deleteByCode($code, $dryRun);

```

Generování PDF
--------------

[](#generování-pdf)

Systém Flexibee umožňuje vrátit vygenerované faktury.

```
$client->getPdfById($id, $uriParameters);

```

Vyhledávání v evidenci
----------------------

[](#vyhledávání-v-evidenci)

Systém Flexibee umožňuje vyhledávat nad evidencí. ()

```
$client->searchInEvidence($query, $uriParameters);

```

Vyhledávání v evidenci se stránkováním
--------------------------------------

[](#vyhledávání-v-evidenci-se-stránkováním)

Systém Flexibee umožňuje vyhledávat nad evidencí. () K uri parametrům je automaticky přiřazený parameter `'add-row-count' => 'true'`. Vrací array s daty a celkovým počtem záznámů.

```
$client->searchInEvidencePaginated($query, $uriParameters);

```

Seznam položek v evidenci
-------------------------

[](#seznam-položek-v-evidenci)

Seznam všech dostupných prvků pro konkrétní evidenci

```
$client->getPropertiesForEvidence();

```

Vytváření vlastních requestů
----------------------------

[](#vytváření-vlastních-requestů)

Client nabízí možnost vytváření vlastních requestů. Stačí zavolat:

```
$responseData = $client->callRequest(Method $httpMethod, string $section, array $queryParameters);

```

Následně máte k dispozici data vrácená z Flexibee. Chyby jsou ošetřeny vyhozením kontrétních výjimek.

Oficiální API dokumentace
-------------------------

[](#oficiální-api-dokumentace)

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance24

Infrequent updates — may be unmaintained

Popularity46

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 92.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~95 days

Recently: every ~79 days

Total

15

Last Release

1553d ago

Major Versions

0.2.3 → 1.02019-06-18

PHP version history (6 changes)0.1PHP ~7.1

1.0PHP ^7.2

1.1PHP ^7.3

1.2PHP ^7.4

1.3.1PHP ^7.4|^8.0

1.4PHP ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2815391?v=4)[Tlapi](/maintainers/Tlapi)[@Tlapi](https://github.com/Tlapi)

---

Top Contributors

[![pekral](https://avatars.githubusercontent.com/u/9308589?v=4)](https://github.com/pekral "pekral (164 commits)")[![Tlapi](https://avatars.githubusercontent.com/u/2815391?v=4)](https://github.com/Tlapi "Tlapi (6 commits)")[![ecomail-cz](https://avatars.githubusercontent.com/u/64891310?v=4)](https://github.com/ecomail-cz "ecomail-cz (5 commits)")[![gausejakub](https://avatars.githubusercontent.com/u/19504292?v=4)](https://github.com/gausejakub "gausejakub (3 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ecomailcz-flexibee-client/health.svg)

```
[![Health](https://phpackages.com/badges/ecomailcz-flexibee-client/health.svg)](https://phpackages.com/packages/ecomailcz-flexibee-client)
```

###  Alternatives

[knuckleswtf/scribe

Generate API documentation for humans from your Laravel codebase.✍

2.3k12.2M45](/packages/knuckleswtf-scribe)[phpdocumentor/phpdocumentor

Documentation Generator for PHP

4.4k3.1M878](/packages/phpdocumentor-phpdocumentor)[mpociot/laravel-apidoc-generator

Generate beautiful API documentation from your Laravel application

3.5k3.1M12](/packages/mpociot-laravel-apidoc-generator)[wheelpros/fitment-platform-api

Magento 2 (Open Source)

12.1k1.2k](/packages/wheelpros-fitment-platform-api)[badaso/core

The API & platform builder, build your apps 10x faster even more, it's open source & 100% free !

1.3k16.2k10](/packages/badaso-core)[flat3/lodata

OData v4.01 Producer for Laravel

96320.9k](/packages/flat3-lodata)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)