PHPackages                             mchervenkov/sameday - 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. mchervenkov/sameday

ActiveLibrary[API Development](/categories/api)

mchervenkov/sameday
===================

Laravel Sameday API Wrapper

v1.0.4(2mo ago)02.6k↓41.5%1MITPHPPHP ^7.4|^8.0|^8.1|^8.2|^8.3

Since Jun 13Pushed 1y ago1 watchersCompare

[ Source](https://github.com/gdinko/sameday)[ Packagist](https://packagist.org/packages/mchervenkov/sameday)[ Docs](https://github.com/gdinko/sameday)[ RSS](/packages/mchervenkov-sameday/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (10)Versions (5)Used By (0)

Laravel Sameday API Wrapper
===========================

[](#laravel-sameday-api-wrapper)

[![Latest Version on Packagist](https://camo.githubusercontent.com/64a80cae853b9f15a1bb5562c8b82ece923ba400a2186edfe515b7f88317dab4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6368657276656e6b6f762f73616d656461792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mchervenkov/sameday)[![Total Downloads](https://camo.githubusercontent.com/e4168582317b23960ce2bd394ada14565f11fb27ae331db9c3daa4cd55dbcfd3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6368657276656e6b6f762f73616d656461792e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mchervenkov/sameday)

[Sameday JSON API Documentation](https://sameday.bg/)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require mchervenkov/sameday
```

If you plan to use database for storing nomenclatures:

```
php artisan migrate
```

If you need to export configuration file:

```
php artisan vendor:publish --tag=sameday-config
```

If you need to export migrations:

```
php artisan vendor:publish --tag=sameday-migrations
```

If you need to export models:

```
php artisan vendor:publish --tag=sameday-models
```

If you need to export commands:

```
php artisan vendor:publish --tag=sameday-commands
```

Configuration
-------------

[](#configuration)

```
SAMEDAY_ENV=test|production #default=test
SAMEDAY_AUTH_USERNAME= #default=test-sameday-username
SAMEDAY_AUTH_PASSWORD= #default=test-sameday-password
SAMEDAY_API_TEST_BASE_URI= #default=https://sameday-api-bg.demo.zitec.com
SAMEDAY_API_PRODUCTION_BASE_URI= #default=https://sameday-api.demo.zitec.com
SAMEDAY_API_TIMEOUT= #default=5
```

Usage
-----

[](#usage)

Methods

```
// Init Sameday Client
$sameday = new Sameday();

// Client endpoints
$sameday->getServices();
$sameday->getPickupPoints();
$sameday->getAwbStatus();
$sameday->syncStatus();

// Geolocation endpoints
$sameday->getCounties();
$sameday->getCities();

// Lockers endpoints
$sameday->getLockers();
```

Commands

```
#get counties with database (use -h to view options)
php artisan sameday:get-counties

#get cities with database (use -h to view options)
php artisan sameday:get-cities

#create cities map with other carriers in database  (use -h to view options)
php artisan sameday:map-cities

#get lockers with database (use -h to view options)
php artisan sameday:get-lockers

#get sameday api status (use -h to view options)
php artisan sameday:api-status
```

Models

```
SamedayCity
SamedayCounty
SamedayApiStatus
SamedayLocker
CarrierCityMap
```

Examples
--------

[](#examples)

Without Params

```
$sameday = new Sameday();
$response = $sameday->getCities();
dd($response);
```

With Hydrator

```
$sameday = new Sameday();
$cityHydrator = new City(['countyCode' => 'BG']);
$response = $sameday->getCities($cityHydrator);
dd($response);
```

With Hydrator and Paginator

```
$sameday = new Sameday();
$cityHydrator = new City(['countyCode' => 'BG']);
$paginator = new Paginator(1, 50);
$response = $sameday->getCities($cityHydrator, $paginator);
dd($response);
```

### Testing

[](#testing)

Before running tests set your api credentials in sameday.php config file

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Mario Chervenkov](https://github.com/mariochervenkov)
- [silabg.com](https://www.silabg.com/) ❤️
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance57

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.6% 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 ~214 days

Total

4

Last Release

61d ago

PHP version history (2 changes)1.0.0PHP ^8.0|^8.1|^8.2

v1.0.4PHP ^7.4|^8.0|^8.1|^8.2|^8.3

### Community

Maintainers

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

---

Top Contributors

[![mariochervenkov](https://avatars.githubusercontent.com/u/48062373?v=4)](https://github.com/mariochervenkov "mariochervenkov (12 commits)")[![gdinko](https://avatars.githubusercontent.com/u/2735905?v=4)](https://github.com/gdinko "gdinko (5 commits)")

---

Tags

laravelsamedaymchervenkovsameday laravel

###  Code Quality

TestsPest

Static AnalysisPHPStan

### Embed Badge

![Health badge](/badges/mchervenkov-sameday/health.svg)

```
[![Health](https://phpackages.com/badges/mchervenkov-sameday/health.svg)](https://phpackages.com/packages/mchervenkov-sameday)
```

###  Alternatives

[irazasyed/telegram-bot-sdk

The Unofficial Telegram Bot API PHP SDK

3.3k4.5M84](/packages/irazasyed-telegram-bot-sdk)[dcblogdev/laravel-microsoft-graph

A Laravel Microsoft Graph API (Office365) package

168285.5k1](/packages/dcblogdev-laravel-microsoft-graph)[vluzrmos/slack-api

Wrapper for Slack.com WEB API.

102589.1k3](/packages/vluzrmos-slack-api)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[dcblogdev/laravel-xero

A Laravel Xero package

53129.1k1](/packages/dcblogdev-laravel-xero)[simplestats-io/laravel-client

Client for SimpleStats!

4515.5k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

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