PHPackages                             slevomat/zbozi-api-library - 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. slevomat/zbozi-api-library

ActiveLibrary

slevomat/zbozi-api-library
==========================

Slevomat Zboží API PHP library

2.0.0(5y ago)32.9k2[1 PRs](https://github.com/slevomat/zbozi-api-php-library/pulls)MITPHPPHP ^7.4 || ^8.0

Since Sep 1Pushed 5y ago16 watchersCompare

[ Source](https://github.com/slevomat/zbozi-api-php-library)[ Packagist](https://packagist.org/packages/slevomat/zbozi-api-library)[ RSS](/packages/slevomat-zbozi-api-library/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (9)Versions (4)Used By (0)

Slevomat Zboží API PHP Library
==============================

[](#slevomat-zboží-api-php-library)

[![Build status](https://github.com/slevomat/zbozi-api-php-library/workflows/Build/badge.svg?branch=master)](https://github.com/slevomat/zbozi-api-php-library/actions?query=workflow%3ABuild+branch%3Amaster)[![Latest Stable Version](https://camo.githubusercontent.com/50ca779241451df967ae578cf8103ad97fa36713b5eaef42afd11a806f32af24/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736c65766f6d61742f7a626f7a692d6170692d6c6962726172792e737667)](https://packagist.org/packages/slevomat/zbozi-api-library)[![Code coverage](https://camo.githubusercontent.com/d1e258b8eaa0112e25eccf654d8e245b74838ed4d6740626dd9a333009b7c6d1/68747470733a2f2f636f6465636f762e696f2f67682f736c65766f6d61742f7a626f7a692d6170692d7068702d6c6962726172792f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/slevomat/zbozi-api-php-library)

[Dokumentace Zboží API](https://www.slevomat.cz/partner/zbozi-api)

Tato knihovna slouží pro implementaci komunikace Partner -> Slevomat.

Knihovna vyžaduje verzi PHP 7.4 nebo vyšší a předpokládá využití nástroje [Composer](https://getcomposer.org/).

Instalace knihovny
------------------

[](#instalace-knihovny)

```
composer require slevomat/zbozi-api-library

```

Použití knihovny
----------------

[](#použití-knihovny)

V repozitáři se nachází soubor `examples.php` s ukázkovým použitím. API se volá skrze metody na objektu `\SlevomatZboziApi\ZboziApiClient`.

Objekt se vytvoří nejsnáze pomocí továrničky:

```
$client = \SlevomatZboziApi\ZboziApiClientFactory::create($partnerToken, $apiSecret, $apiUrl, $timeout, $logger); // logger a timeout jsou nepovinné

```

Při volání metod klienta se volá API Slevomatu. Např.:

```
$expectedDeliveryDate = $client->markGettingReadyForPickup($orderId);

```

Chybové stavy
-------------

[](#chybové-stavy)

Při volání API může dojít k řadě chyb. Vyhazují se následující výjimky:

- `\SlevomatZboziApi\Request\ConnectionErrorException` - nepodařilo se připojit na API, požadavek zopakujte

V případě, že se na API podaří připojit, může knihovna vyhodit následující chyby (všechny jsou typu `\SlevomatZboziApi\Request\InvalidRequestException`):

- `\SlevomatZboziApi\Request\InvalidCredentialsException` - neplatné přihlašovací údaje
- `\SlevomatZboziApi\Request\OrderNotFoundException` - neexistující objednávka
- `\SlevomatZboziApi\Request\OrderItemNotFoundException` - neexistující položka objednávky
- `\SlevomatZboziApi\Request\InvalidStatusChangeException` - přechod objednávky do nepovoleného stavu
- `\SlevomatZboziApi\Request\InvalidCancelException` - neplatné storno - stornování většího počtu položek, než existuje
- `\SlevomatZboziApi\Request\OtherRequestErrorException` - jiná chyba
- `\SlevomatZboziApi\Request\OrderNotExportedException` - objednávka nebyla ještě exportována do partnerského API - nelze s ní skrze API manipulovat

Všechny výjimky `InvalidRequestException` mají metodu `getMessages()`, která slouží k získání chybových zpráv, které vrátil server.

U těchto chyb je potřeba před opakovaný pokusem opravit odesílaný požadavek. V případě odesílání stejného požadavku dojde pravděpodobně ke stejné chybě.

Všechny výjimky v knihovně implementují interface `SlevomatZboziApi\ZboziApiException`, pokud nepotřebujete reagovat na každý chybový stav zvláštním způsobem, lze chytat tento typ.

Logování požadavků
------------------

[](#logování-požadavků)

Knihovna podporuje volitelně logování požadavků. Pro implementaci logování použite interface `\SlevomatZboziApi\ZboziApiLogger`.

Ukázkový logger, který informace o požadavcích rovnou vypisuje, je v repozitáři v souboru `ExampleLogger.php`.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~991 days

Total

3

Last Release

1931d ago

Major Versions

1.1 → 2.0.02021-02-02

PHP version history (2 changes)1.0PHP >=5.4.0

2.0.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/acc323747135bdd72731aafc0052a920b5e67c6cb8ffac74bf4b9eb44e9c0c90?d=identicon)[slevomat](/maintainers/slevomat)

---

Top Contributors

[![ondrejmirtes](https://avatars.githubusercontent.com/u/104888?v=4)](https://github.com/ondrejmirtes "ondrejmirtes (9 commits)")[![raoul](https://avatars.githubusercontent.com/u/237164?v=4)](https://github.com/raoul "raoul (8 commits)")[![janlanger](https://avatars.githubusercontent.com/u/415695?v=4)](https://github.com/janlanger "janlanger (4 commits)")[![pepakriz](https://avatars.githubusercontent.com/u/383294?v=4)](https://github.com/pepakriz "pepakriz (2 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/slevomat-zbozi-api-library/health.svg)

```
[![Health](https://phpackages.com/badges/slevomat-zbozi-api-library/health.svg)](https://phpackages.com/packages/slevomat-zbozi-api-library)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k21](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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