PHPackages merinsky/balikobot - 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. merinsky/balikobot ActiveLibrary[API Development](/categories/api) merinsky/balikobot ================== Balikobot API 1.0.2(9y ago)53.2k↓29.4%7[2 issues](https://github.com/MiroslavMerinsky/Balikobot/issues)GPL-3.0PHPPHP >=7.0.0 Since Mar 23Pushed 7y ago3 watchersCompare [ Source](https://github.com/MiroslavMerinsky/Balikobot)[ Packagist](https://packagist.org/packages/merinsky/balikobot)[ Docs](https://github.com/MiroslavMerinsky/Balikobot)[ RSS](/packages/merinsky-balikobot/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (7)Used By (0) Balikobot ========= [](#balikobot) Balikobot API It offers implementation of Balikobot API described in the [documentation, ver.1.79](http://www.balikobot.cz/dokumentace/Balikobot-dokumentace-API.pdf). Installation ------------ [](#installation) ``` composer require merinsky/balikobot ``` Usage ----- [](#usage) To **order shipment** you should done these steps: 1. add packages to the front 2. order packages collection (for each shipper) ``` use Merinsky\Balikobot\Balikobot; define('API_USER', '...'); define('API_KEY', '...'); define('SHOP', 100); // create instance of the class $balikobot = new Balikobot(API_USER, API_KEY, SHOP); // add package $package = $balikobot->service(Balikobot::SHIPPER_PPL, 4, [ Balikobot::OPTION_ORDER => '2017000001', ]) ->customer('Jan Novak', 'Jankovcova 2', 'Praha', '17000', '+420773145254', 'jan.novak@email.cz') ->add(); /* dump($package); [ carrier_id => 40458564564, package_id => 7338, label_url => http://pdf.balikobot.cz/ppl/eNorpelvMdA1trS0NAJcMA_plao., status => 200, ] */ // order packages collection $response = $balikobot->order(Balikobot::SHIPPER_PPL, [$package['package_id'], ...]); /* dump($response); [ order_id => 788, handover_url => http://pdf.balikobot.cz/ppl/eNrpelMTIyMaA1r6elNANcMA_xAn4., labels_url => http://pdf.balikobot.cz/ppl/eNrpelIyMdAgfrSrpelVcMA_wAn0., status => 200, ] */ ``` Use the **getServices** method to get available services for a given shipper. It returns associative array, serviceId => description. Use the **serviceId** as a service method parameter. ``` $response = $balikobot->getServices(Balikobot::SHIPPER_PPL); /* dump($response); [ 2 => PPL Parcel Connect, 3 => PPL Parcel CZ Dopolední balík, 4 => PPL Parcel CZ Private, 8 => PPL Parcel CZ Business, 9 => PPL Parcel CZ Private - Večerní doručení, 15 => PPL Firemní paleta, 19 => PPL Soukromá paleta, ] */ ``` Use the **getOptions** method to get available options for a given shipper. It returns list of options. ``` $response = $balikobot->getOptions(Balikobot::SHIPPER_DPD); /* dump($response); [ 0 => price, 1 => real_order_id, 2 => sms_notification, 3 => branch_id, 4 => del_insurance, 5 => note, 6 => weight, ] */ ``` The **getBranches** method is useful for pickup services. You can get list of pickup places (branches). This method is available only for some services. ``` $response = $balikobot->getBranches(Balikobot::SHIPPER_CP, 'NP'); /* dump($response); [ 67152 => [ name => Hluboké Mašůvky, city => Hluboké Mašůvky, street => 230, zip => 67152, country => CZ, type => branch ], 74282 => [ ] ... ] */ ``` Use the **getZipCodes** method to get available zip codes for given shipper and service. This method is not available for pickup services, of course. ``` $response = $balikobot->getZipCodes(Balikobot::SHIPPER_ULOZENKA, 2); /* dump($response); [ 0 => 97401, 1 => 97405, 2 => 97411, ... ] */ ``` You can create labels only for given packages by calling **getLabels** method. ``` $response = $balikobot->getLabels(Balikobot::SHIPPER_PPL, [1258, 544, 5454, ...]); /* dump($response); http://pdf.balikobot.cz/ppl/eNsrMadfMdA1trS0NffcMA_vAnw. */ ``` Call **overview** method to get list of packages in the front (added by add method). ``` $response = $balikobot->overview(Balikobot::SHIPPER_PPL); /* dump($response); [ 0 => [ eshop_id => 20170000071490299455, carrier_id => 13805004931509, package_id => 5732, label_url => http://pdf.balikobot.cz/dpd/eNfaMTIyMdAtwrt1BFwzDWECQA.., ], ... ] */ ``` Call **trackPackage** method to get list of tracking information. ``` $response = $balikobot->trackPackage(Balikobot::SHIPPER_PPL, '40425465434'); /* dump($response); [ 0 => 01.07.2014 11:11 1383 Hradec Kralove - Pouchov (CZ) 6211385 doručeno : BALIKOBOT CZ •50311 • 1383 351 327, 1 => 01.07.2014 06:37 1383 Hradec Kralove - Pouchov (CZ)rozvoz CZ •50311 • 1383 351 327, 2 => 01.07.2014 06:32 1383 Hradec Kralove - Pouchov (CZ)příjem na depo CZ •50311 • 1383 64 327, 3 => 30.06.2014 16:56 1381 Ricany (CZ)vyzvednutí CZ •50311 • 1383 686 327, ] */ ``` Call **trackPackageLast** method to get status id and message of the last tracking information. It is useful to summarize status of several packages. ``` $response = $balikobot->trackPackageLast(Balikobot::SHIPPER_PPL, '40425465434'); /* dump($response); [ status_id => 2, status_text => Zásilka je doručována příjemci., ] */ ``` The methods you use very rarely: - **getCountryCodes()** - **getCurrencies()** - **getCountriesForService($shipper)** - **getOptionServices()** - **getManipulationUnits($shipper)** - **dropPackage($shipper, $packageId)** ### Health Score 32 — LowBetter than 69% of packages Maintenance12 Infrequent updates — may be unmaintained Popularity28 Limited adoption so far Community11 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% 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 ~2 days Total 6 Last Release 3379d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3139bd19de155cd474091e2e72224d8d4a34e4cde52ca7d8fad9bb7371cc0980?d=identicon)[miroslav.merinsky](/maintainers/miroslav.merinsky) --- Top Contributors [![MiroslavMerinsky](https://avatars.githubusercontent.com/u/7864641?v=4)](https://github.com/MiroslavMerinsky "MiroslavMerinsky (3 commits)") --- Tags apiBalikobotdelivery serviceShipper ### Embed Badge ![Health badge](/badges/merinsky-balikobot/health.svg) ``` [![Health](https://phpackages.com/badges/merinsky-balikobot/health.svg)](https://phpackages.com/packages/merinsky-balikobot) ``` ### Alternatives [m165437/laravel-blueprint-docs API Blueprint Renderer for Laravel 22879.8k](/packages/m165437-laravel-blueprint-docs) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)