PHPackages                             khoroshun/checkbox-in-ua-php-sdk - 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. khoroshun/checkbox-in-ua-php-sdk

ActiveLibrary[API Development](/categories/api)

khoroshun/checkbox-in-ua-php-sdk
================================

PHP SDK for integration with checkbox.in.ua api

v1.0.2(11mo ago)011MITPHPPHP >=8.0

Since Aug 9Pushed 11mo agoCompare

[ Source](https://github.com/Khoroshun/checkbox-in-ua-php-sdk)[ Packagist](https://packagist.org/packages/khoroshun/checkbox-in-ua-php-sdk)[ RSS](/packages/khoroshun-checkbox-in-ua-php-sdk/feed)WikiDiscussions master Synced 1mo ago

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

[![GitHub CI](https://github.com/khoroshun/checkbox-in-ua-php-sdk/workflows/CI/badge.svg)](https://github.com/khoroshun/checkbox-in-ua-php-sdk/workflows/CI/badge.svg)[![Packagist](https://camo.githubusercontent.com/35d3886e8f14a337e2ac1e39875f5c10ad9b0f8d2be3074ebc21adf02bcc1634/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b6167652d6b686f726f7368756e2f636865636b626f782d2d696e2d2d75612d2d7068702d2d73646b2d626c75652e7376673f7374796c653d666c61742d737175617265)](https://github.com/khoroshun/checkbox-in-ua-php-sdk)[![Latest Version on Packagist](https://camo.githubusercontent.com/71df40779b58cf61bc4861b180539515417204977e432349c4aa513c9e0917f4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b686f726f7368756e2f636865636b626f782d696e2d75612d7068702d73646b2e7376673f7374796c653d666c61742d737175617265)](https://github.com/khoroshun/checkbox-in-ua-php-sdk)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![PHP >=8.0](https://camo.githubusercontent.com/441cc188e3c606e67d0eef3150b7db3ec83b10dd005284d80c88694d63d60d84/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d2533453d5f382e302d6f72616e67652e7376673f7374796c653d666c61742d737175617265)](https://github.com/khoroshun/checkbox-in-ua-php-sdk)[![Total Downloads](https://camo.githubusercontent.com/5a1e98c4d2e0ceff554afab6912d3a9f85ae542c4b32559e0920ae7f468136b0/68747470733a2f2f706f7365722e707567782e6f72672f6b686f726f7368756e2f636865636b626f782d696e2d75612d7068702d73646b2f646f776e6c6f616473)](https://github.com/khoroshun/checkbox-in-ua-php-sdk)

checkbox-in-ua-php-sdk
======================

[](#checkbox-in-ua-php-sdk)

### PHP SDK для работы с Checkbox (Украина)

[](#php-sdk-для-работы-с-checkbox-украина)

##### Примечание:

[](#примечание)

> В данном sdk реализованы только функции онлайн режима (оффлайн не реализован)

#### Официальная документация:

[](#официальная-документация)

[https://docs.google.com/document/d/1Zhkc4OljKjea\_235YafVvZunkWSp6TCAKeckhgl8t2w/edit](https://docs.google.com/document/d/1Zhkc4OljKjea_235YafVvZunkWSp6TCAKeckhgl8t2w/edit)

#### Установка:

[](#установка)

```
composer require khoroshun/checkbox-in-ua-php-sdk
```

#### Настройка:

[](#настройка)

```
require_once 'vendor/autoload.php';
```

##### Настройка конфига:

[](#настройка-конфига)

> адрес продакшен сервера
> адрес тестового сервера
> текущая версия API - v1

```
$config = new \khoroshun\Checkbox\Config([
    \khoroshun\Checkbox\Config::API_URL => 'https://dev-api.checkbox.in.ua/api/v1',
    \khoroshun\Checkbox\Config::LOGIN => 'логин кассира',
    \khoroshun\Checkbox\Config::PASSWORD => 'пароль кассира', //or
    \khoroshun\Checkbox\Config::PINCODE => 02301230440,
    \khoroshun\Checkbox\Config::LICENSE_KEY => 'ключ лицензии кассы',
    \khoroshun\Checkbox\Config::HEADER_CLIENT_NAME => 'Khoroshun Custom SDK',
    \khoroshun\Checkbox\Config::HEADER_CLIENT_VERSION => '1.0.2',
]);
```

##### Логин кассира:

[](#логин-кассира)

```
$api = new \khoroshun\Checkbox\CheckboxJsonApi($config);
$api->signInCashier();
```

##### Логаут кассира:

[](#логаут-кассира)

```
$api->signOutCashier();
```

##### Ошибки (Exceptions):

[](#ошибки-exceptions)

```
\khoroshun\Checkbox\Errors\InvalidCredentials - не верные данные логина или пароля
```

```
\khoroshun\Checkbox\Errors\EmptyResponse - пустой ответ
```

```
\khoroshun\Checkbox\Errors\Validation - ошибка валидации (есть детальные. данные $err->getDetail())
```

```
\khoroshun\Checkbox\Errors\NoActiveShift - нет активной смены
```

```
\khoroshun\Checkbox\Errors\AlreadyOpenedShift - смена уже открыта
```

```
\Exception  - стандартная ошибка
```

#### Основные методы:

[](#основные-методы)

##### profile (касир):

[](#profile-касир)

```
$api->getCashierProfile() : \khoroshun\Checkbox\Models\Cashier\Cashier // возвращает профиль кассира
```

##### shifts (смены):

[](#shifts-смены)

```
$api->getCashierShift() : \khoroshun\Checkbox\Models\Shifts\Shift // возвращает текущую смену кассира
```

```
$api->getShift('ид смены') : \khoroshun\Checkbox\Models\Shifts\Shift // возвращает смену по ид
```

```
$api->getShifts() : \khoroshun\Checkbox\Models\Shifts\Shifts // возвращает смены
```

или

```
$api->getShifts(
    new \khoroshun\Checkbox\Models\Shifts\ShiftsQueryParams(
        [
            \khoroshun\Checkbox\Models\Shifts\ShiftsQueryParams::STATUS_CLOSED,
            \khoroshun\Checkbox\Models\Shifts\ShiftsQueryParams::STATUS_OPENED
        ], // статусы смен
        false, // desc - сортировка (false or true)
        2, // limit
        0 // offset
    )
): \khoroshun\Checkbox\Models\Shifts\Shifts // возвращает смены с учетом фильтра
```

```
$api->createShift() : \khoroshun\Checkbox\Models\Shifts\CreateShift // создает смену
```

```
$api->closeShift() : \khoroshun\Checkbox\Models\Shifts\CloseShift // закрывает смену
```

##### cash registers (пРРО):

[](#cash-registers-прро)

```
$api->getCashRegisters() : \khoroshun\Checkbox\Models\CashRegisters\CashRegisters // возвращает кассовые регистраторы
```

или

```
$api->getCashRegisters(
    new \khoroshun\Checkbox\Models\CashRegisters\CashRegistersQueryParams(
        true, // inUse - используется или нет (true or false)
        3, // limit
        0 // offset
    )
) : \khoroshun\Checkbox\Models\CashRegisters\CashRegisters // возвращает кассовые регистраторы по фильтру
```

```
$api->getCashRegister('ид кассы') : \khoroshun\Checkbox\Models\CashRegisters\CashRegister // возвращает кассу по айди
```

```
$api->getCashRegisterInfo() : \khoroshun\Checkbox\Models\CashRegisters\CashRegisterInfo // возвращает информацию текущей кассы
```

##### taxes (налоги):

[](#taxes-налоги)

```
$api->getAllTaxes() : \khoroshun\Checkbox\Models\Receipts\Taxes\GoodTaxes // возвращает все налоги
```

##### transactions (транзакции):

[](#transactions-транзакции)

```
$api->getTransactions(
    new \khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams(
        [
            \khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams::STATUS_CREATED,
            \khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams::STATUS_DONE,
            \khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams::STATUS_SIGNED
        ], // статусы транзакции
        [
            \khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams::TYPE_RECEIPT,
            \khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams::TYPE_SHIFT_OPEN,
            \khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams::TYPE_Z_REPORT
        ], // типы транзакций
        2, // limit
        0 // offset
    )
) : \khoroshun\Checkbox\Models\Transactions\Transactions // возвращает транзакции по фильтру
```

```
$api->getTransaction('ид транзакции') : \khoroshun\Checkbox\Models\Transactions\Transaction // возвращает транзакцию по айди
```

```
$api->updateTransaction(
    'ид транзакции',
    base64_encode('request_signature')
) : \khoroshun\Checkbox\Models\Transactions\Transaction // меняет request_signature у транзакции, работает только если у транзакции статус PENDING
```

##### reports (отчеты):

[](#reports-отчеты)

```
$api->createXReport() : \khoroshun\Checkbox\Models\Shifts\ZReport // создает х отчет
```

```
$api->getReport('ид отчета') : \khoroshun\Checkbox\Models\Shifts\ZReport // возвращает данные отчета по айди
```

```
$api->getReportText('ид отчета') : string // возвращает данные отчета по айди в виде текста
```

или

```
$api->getReportText('ид отчета', 60) : string // возвращает данные отчета по айди в виде текста, с указанием ширины текста
```

```
$api->getPeriodicalReport(
    new \khoroshun\Checkbox\Models\Reports\PeriodicalReportQueryParams(
        '2020-10-27 00:00:00', // дата с
        '2020-11-04 13:15:00', // дата по
        60 // ширина текста
    )
) : string // возвращает данные отчета за период по фильру
```

```
$api->getReports(
    new \khoroshun\Checkbox\Models\Reports\ReportsQueryParams(
        '2020-10-27 00:00:00', // дата с
        '2020-11-04 13:15:00', // дата по
        [], // массив ид смен
        false, // is_z_report (true or false)
        true, // desc - сортировка (false or true)
        3, // limit
        0 // offset
    )
) : \khoroshun\Checkbox\Models\Reports\Reports // возвращает отчеты по фильтру
```

##### receipts (чеки):

[](#receipts-чеки)

```
$api->getReceipts() : \khoroshun\Checkbox\Models\Receipts\Receipts // возвращает чеки
```

```
$api->getReceipts(
    new \khoroshun\Checkbox\Models\Receipts\ReceiptsQueryParams(
        '', // fiscal code
        '', // serial
        false, // desc - сортировка (false or true)
        2, // limit
        0 // offset
    )
) : \khoroshun\Checkbox\Models\Receipts\Receipts // возвращает чеки по фильтру
```

```
$api->getReceipt('ид чека') : \khoroshun\Checkbox\Models\Receipts\Receipt // возвращает чек по айди
```

```
$api->getReceiptPdf('ид чека') : pdf // возвращает чек по айди в виде пдф
```

```
$api->getReceiptHtml('ид чека') : string // возвращает чек по айди в виде html
```

```
$api->getReceiptText('ид чека') : string // возвращает чек по айди в виде текста
```

```
$api->getReceiptQrCodeImage('ид чека') : string // возвращает чек по айди в виде qr-кода
```

или

```
// пример с отображением qr-кода
$rawImageContent = $api->getReceiptQrCodeImage('ид чека');
echo '';
```

###### чек продажи:

[](#чек-продажи)

```
$receipt = new \khoroshun\Checkbox\Models\Receipts\SellReceipt(
    'Вася Пупкин', // кассир
    'Отдел продаж', // отдел
    new \khoroshun\Checkbox\Models\Receipts\Goods\Goods(
        [
            new \khoroshun\Checkbox\Models\Receipts\Goods\GoodItemModel( // товар 1
                new \khoroshun\Checkbox\Models\Receipts\Goods\GoodModel(
                    'vm-123', // good_id
                    50 * 100, // 50 грн
                    'Биовак' // название товара
                ),
                1 * 1000 // кол-во товара  1 шт
            ),
            new \khoroshun\Checkbox\Models\Receipts\Goods\GoodItemModel( // товар 2
                new \khoroshun\Checkbox\Models\Receipts\Goods\GoodModel(
                    'vm-124', // good_id
                    20 * 100, // 20 грн
                    'Биовак 2' // название товара
                ),
                2 * 1000 // кол-во товара 2 шт
            )
        ]
    ),
    'admin@gmail.com', // кому отправлять чек по почте
    new \khoroshun\Checkbox\Models\Receipts\Payments\Payments([
        new \khoroshun\Checkbox\Models\Receipts\Payments\CardPaymentPayload( // безналичная оплата
            40 * 100 // 40 грн
        ),
        new \khoroshun\Checkbox\Models\Receipts\Payments\CashPaymentPayload( // наличная оплата
            50 * 100 // 50 грн
        )
    ])
);

$api->createSellReceipt($receipt): \khoroshun\Checkbox\Models\Receipts\Receipt; // выполняем оплату
```

более сложная оплата:

```
$allTaxes = $api->getAllTaxes(); // получили все налоги
$tax = $allTaxes->getTaxByLabel('Акцизний збір'); // получили один налог по лейбл
$goodTaxes = $allTaxes->getTaxesByLabel('ПДВ'); // получили массив налогов по лейбл
$taxCodes = [];

// подготавливаем массив кодов налогов
foreach ($goodTaxes->results as $goodTax) {
    $taxCodes[] = $goodTax->code;
}

$receipt = new \khoroshun\Checkbox\Models\Receipts\SellReceipt(
    'Вася Пупкин', // имя кассира
    'Отдел продаж', // отдел
    new \khoroshun\Checkbox\Models\Receipts\Goods\Goods( // товары
        [
            new \khoroshun\Checkbox\Models\Receipts\Goods\GoodItemModel(
                new \khoroshun\Checkbox\Models\Receipts\Goods\GoodModel(
                    'vm-123', // good_id айди товара
                    5000, // 50 грн  цена 100 = 1 грн
                    'Биовак', // название
                    '5р47ле78675е3', // баркод
                    'хидер', // хидер
                    'футер', // футер
                    '', // ktzed
                    $goodTaxes // налоги товара
                ),
                1000, // кол-во 1000 = 1 шт
                new \khoroshun\Checkbox\Models\Receipts\Discounts\Discounts( // скидки или надбавки
                    [
                        new \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel(
                            \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::TYPE_DISCOUNT, // скидка или надбавка
                            \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::MODE_VALUE, // по значению или по проценту
                            100, // 1 грн  сумма скидки/надбавки  100 = 1 грн
                            0, // сумма (не используется в данном sdk)
                            $tax->code, // код налога (подготовили выше)
                            $taxCodes, // массив кодов налога (подготовили выше)
                            'one good discount' // название
                        )
                    ]
                ),
                $allTaxes->getTaxesByLabel('Акцизний збір'), // налоги товара
                false, // возврат товара (false or true)
                0, // сумма (не используется в данном sdk)
                '' // айди товара (только если вы загружали список товарв (не используется в данном sdk))
            )
        ]
    ),
    'admin@gmail.com', // кому отправлять чек по почте
    new \khoroshun\Checkbox\Models\Receipts\Payments\Payments([ // оплаты
        new \khoroshun\Checkbox\Models\Receipts\Payments\CardPaymentPayload( // безналичная оплата
            400, // сумма оплаты 400 = 4 грн
            'beznalichka', // текст оплаты
            0, // code - не знаю для чего (видимо пин код карты)
            '0000 0000 0000 0000' // номер карты
        ),
        new \khoroshun\Checkbox\Models\Receipts\Payments\CashPaymentPayload( // наличная оплата
            4300, // сумма оплаты 4300 = 43 грн
            'nalichka' // текст оплаты
        )
    ]),
    new \khoroshun\Checkbox\Models\Receipts\Discounts\Discounts( // скидки/надбавки на весь чек
        [
            new \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel(
                \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::TYPE_DISCOUNT, // скидка или надбавка
                \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::MODE_VALUE, // по значению или по проценту
                200, // 2 грн  сумма скидки/надбавки  200 = 2 грн
                0, // сумма (не используется в данном sdk)
                $tax->code, // код налога (подготовили выше)
                $taxCodes, // массив кодов налога (подготовили выше)
                'total discount' // название
            )
        ]
    ),
    'check header', // чек хидер
    'check footer', // чек футер
    '45435h543twrege' // баркод
);

$saleReceiptResult = $api->createSellReceipt($receipt): \khoroshun\Checkbox\Models\Receipts\Receipt; // выполняем оплату
```

еще пример

```
$allTaxes = $api->getAllTaxes();
$tax = $allTaxes->getTaxByLabel('Акцизний збір');
$goodTaxes = $allTaxes->getTaxesByLabel('ПДВ');
$taxCodes = [];

foreach ($goodTaxes->results as $goodTax) {
    $taxCodes[] = $goodTax->code;
}

$receipt = new \khoroshun\Checkbox\Models\Receipts\SellReceipt(
    'Вася Пупкин',
    'Отдел продаж',
    new \khoroshun\Checkbox\Models\Receipts\Goods\Goods(
        [
            new \khoroshun\Checkbox\Models\Receipts\Goods\GoodItemModel(
                new \khoroshun\Checkbox\Models\Receipts\Goods\GoodModel(
                    'vm-123', // good_id
                    5000, // 50 грн
                    'Биовак',
                    '',
                    '',
                    '',
                    '',
                    $goodTaxes
                ),
                1000,
                new \khoroshun\Checkbox\Models\Receipts\Discounts\Discounts(
                    [
                        new \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel(
                            \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::TYPE_DISCOUNT,
                            \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::MODE_VALUE,
                            100, // 1 грн
                            0,
                            $tax->code,
                            $taxCodes,
                            'моя скидка'
                        )
                    ]
                ),
                $allTaxes->getTaxesByLabel('Акцизний збір'),
                false,
                0,
                ''
            ),
            new \khoroshun\Checkbox\Models\Receipts\Goods\GoodItemModel(
                new \khoroshun\Checkbox\Models\Receipts\Goods\GoodModel(
                    'vm-124', // good_id
                    2000, // 20 грн
                    'Биовак 2',
                    '',
                    '',
                    '',
                    '',
                    $goodTaxes
                ),
                2000, // 2 шт
                new \khoroshun\Checkbox\Models\Receipts\Discounts\Discounts(
                    [
                        new \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel(
                            \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::TYPE_EXTRA_CHARGE,
                            \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::MODE_VALUE,
                            200, // 2 грн
                            0,
                            $tax->code,
                            $taxCodes,
                            'моя надбавка'
                        )
                    ]
                ),
                $allTaxes->getTaxesByLabel('Акцизний збір'),
                false,
                0,
                ''
            )
        ]
    ),
    'admin@gmail.com',
    new \khoroshun\Checkbox\Models\Receipts\Payments\Payments([
        new \khoroshun\Checkbox\Models\Receipts\Payments\CardPaymentPayload(
            4700
        ),
        new \khoroshun\Checkbox\Models\Receipts\Payments\CashPaymentPayload(
            4700
        )
    ]),
    new \khoroshun\Checkbox\Models\Receipts\Discounts\Discounts(
        [
            new \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel(
                \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::TYPE_EXTRA_CHARGE,
                \khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel::MODE_VALUE,
                200, // 2 грн
                0,
                $tax->code,
                $taxCodes,
                'общая надбавка'
            )
        ]
    )
);

$api->createSellReceipt($receipt): \khoroshun\Checkbox\Models\Receipts\Receipt;
```

```
$api->createServiceReceipt(
    new \khoroshun\Checkbox\Models\Receipts\ServiceReceipt(
        new \khoroshun\Checkbox\Models\Receipts\Payments\CashPaymentPayload(5100)
    )
): \khoroshun\Checkbox\Models\Receipts\Receipt // создаем чек сервисного внесения денег (наличкой)
```

```
$api->createServiceReceipt(
    new \khoroshun\Checkbox\Models\Receipts\ServiceReceipt(
        new \khoroshun\Checkbox\Models\Receipts\Payments\CardPaymentPayload(1000)
    )
): \khoroshun\Checkbox\Models\Receipts\Receipt // создаем чек сервисного внесения денег (картой)
```

```
$api->createServiceReceipt(
    new \khoroshun\Checkbox\Models\Receipts\ServiceReceipt(
        new new \khoroshun\Checkbox\Models\Receipts\Payments\CashPaymentPayload(-5100)
    )
): \khoroshun\Checkbox\Models\Receipts\Receipt // создаем чек сервисного вынесения денег (наличкой) (знак минус)
```

```
$api->createServiceReceipt(
    new \khoroshun\Checkbox\Models\Receipts\ServiceReceipt(
        new new \khoroshun\Checkbox\Models\Receipts\Payments\CardPaymentPayload(-1000)
    )
): \khoroshun\Checkbox\Models\Receipts\Receipt // создаем чек сервисного вынесения денег (картой) (знак минус)
```

##### Рекомендации:

[](#рекомендации)

> все операции оборачивать в try cache

```
try {

    // тут все делаем

} catch (\khoroshun\Checkbox\Errors\InvalidCredentials $err) {
    var_dump('creds err', $err->getMessage());
}  catch (\khoroshun\Checkbox\Errors\EmptyResponse $err) {
    var_dump('empty response', $err->getMessage(), $err->getTraceAsString());
} catch (\khoroshun\Checkbox\Errors\Validation $err) {
    var_dump('valid err', $err->getMessage());
    var_dump('error detail', $err->getDetail());
} catch (\khoroshun\Checkbox\Errors\NoActiveShift $err) {
    var_dump('no shift', $err->getMessage());
} catch (\khoroshun\Checkbox\Errors\AlreadyOpenedShift $err) {
    var_dump('opened shift', $err->getMessage());
} catch (\Exception $err) {
    var_dump('default err', $err->getMessage());
}
```

##### подключение всех неймспейсов из примеров:

[](#подключение-всех-неймспейсов-из-примеров)

```
use khoroshun\Checkbox\CheckboxJsonApi;
use khoroshun\Checkbox\Config;
use khoroshun\Checkbox\Errors\InvalidCredentials;
use khoroshun\Checkbox\Errors\Validation;
use khoroshun\Checkbox\Errors\NoActiveShift;
use khoroshun\Checkbox\Errors\AlreadyOpenedShift;
use khoroshun\Checkbox\Errors\EmptyResponse;
use khoroshun\Checkbox\Models\CashRegisters\CashRegistersQueryParams;
use khoroshun\Checkbox\Models\Shifts\ShiftsQueryParams;
use khoroshun\Checkbox\Models\Receipts\ReceiptsQueryParams;
use khoroshun\Checkbox\Models\Receipts\Discounts\Discounts;
use khoroshun\Checkbox\Models\Receipts\Discounts\DiscountModel;
use khoroshun\Checkbox\Models\Receipts\SellReceipt;
use khoroshun\Checkbox\Models\Receipts\Payments\Payments;
use khoroshun\Checkbox\Models\Receipts\Payments\CardPaymentPayload;
use khoroshun\Checkbox\Models\Receipts\Payments\CashPaymentPayload;
use khoroshun\Checkbox\Models\Receipts\ServiceReceipt;
use khoroshun\Checkbox\Models\Reports\PeriodicalReportQueryParams;
use khoroshun\Checkbox\Models\Reports\ReportsQueryParams;
use khoroshun\Checkbox\Models\Transactions\TransactionsQueryParams;
use khoroshun\Checkbox\Models\Receipts\Goods\Goods;
use khoroshun\Checkbox\Models\Receipts\Goods\GoodItemModel;
use khoroshun\Checkbox\Models\Receipts\Goods\GoodModel;
```

Для котрибьюторов
=================

[](#для-котрибьюторов)

For run all tests

```
make all
```

or connect to terminal

```
make exec
```

or use built in php server

```
# start server on 8080 port
make serve
# custom port 8081
make serve PORT=8081
```

*Dafault php version is 8.0*. Use PHP\_VERSION= for using custom version.

```
make all PHP_VERSION=8.0
```

all commands

```
# security check
make security
# composer install
make install
# composer install with --no-dev
make install-no-dev
# check code style
make style
# run static analyze tools
make static-analyze
# run unit tests
make unit
#  check coverage
make coverage
```

Without Docker

```
#validate composer json
composer check-composer

#static analyzes and codestyle
composer static

#run unit tests
composer unit-tests

#run all tests

composer all-tests

```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance50

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69.9% 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 ~145 days

Total

3

Last Release

350d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/75ac626f6ba6f988d0a7591cc39d7088560b13757b47ca35c9d1961c66aed61f?d=identicon)[Khoroshun](/maintainers/Khoroshun)

---

Top Contributors

[![igorbunov](https://avatars.githubusercontent.com/u/472284?v=4)](https://github.com/igorbunov "igorbunov (72 commits)")[![MakarovIgor](https://avatars.githubusercontent.com/u/28019844?v=4)](https://github.com/MakarovIgor "MakarovIgor (11 commits)")[![otis22](https://avatars.githubusercontent.com/u/378373?v=4)](https://github.com/otis22 "otis22 (8 commits)")[![vldmr-k](https://avatars.githubusercontent.com/u/2142055?v=4)](https://github.com/vldmr-k "vldmr-k (4 commits)")[![weirdan](https://avatars.githubusercontent.com/u/57403?v=4)](https://github.com/weirdan "weirdan (3 commits)")[![Khoroshun](https://avatars.githubusercontent.com/u/6726035?v=4)](https://github.com/Khoroshun "Khoroshun (2 commits)")[![ezoterik](https://avatars.githubusercontent.com/u/1498377?v=4)](https://github.com/ezoterik "ezoterik (2 commits)")[![danilyer228](https://avatars.githubusercontent.com/u/33658320?v=4)](https://github.com/danilyer228 "danilyer228 (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/khoroshun-checkbox-in-ua-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/khoroshun-checkbox-in-ua-php-sdk/health.svg)](https://phpackages.com/packages/khoroshun-checkbox-in-ua-php-sdk)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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