PHPackages                             sushi-market/digitalkassa-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. sushi-market/digitalkassa-sdk

ActiveLibrary[API Development](/categories/api)

sushi-market/digitalkassa-sdk
=============================

PHP SDK for DigitalKassa API v2.1

v0.2.0(yesterday)01↑2900%MITPHPPHP ^8.4CI passing

Since Mar 24Pushed yesterdayCompare

[ Source](https://github.com/sushi-market/digitalkassa-sdk)[ Packagist](https://packagist.org/packages/sushi-market/digitalkassa-sdk)[ RSS](/packages/sushi-market-digitalkassa-sdk/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (8)Versions (4)Used By (0)

DigitalKassa SDK for PHP
========================

[](#digitalkassa-sdk-for-php)

[![PHP Version](https://camo.githubusercontent.com/bfb98d885e37493cddcc01059ebf02a8872de9da37c12691b8bb6d13fcdca735/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342532422d626c75652e737667)](https://php.net)[![Tests](https://github.com/sushi-market/digitalkassa-sdk/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/sushi-market/digitalkassa-sdk/actions/workflows/tests.yml)[![Latest Version](https://camo.githubusercontent.com/717efcd34b0fdb4315ae6aec9082ad2bd27c56ef4df3b20957d2a9f7b3567072/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f73757368692d6d61726b65742f6469676974616c6b617373612d73646b2e7376673f7374796c653d666c61742d737175617265)](https://github.com/sushi-market/digitalkassa-sdk/releases)[![Total Downloads](https://camo.githubusercontent.com/6b32abc80801c8d831796743b4b983e7d6cb1d800689bc4937188695b0949769/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73757368692d6d61726b65742f6469676974616c6b617373612d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sushi-market/digitalkassa-sdk)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)

SDK на основе версии документа **2.1.0**

Установка:

```
composer require sushi-market/digitalkassa-sdk
```

```
use DF\DigitalKassa\V2\DigitalKassaApi;
use DF\DigitalKassa\V2\ValueObjects\Credentials;

$digitalkassa = new DigitalKassaApi(
    credentials: new Credentials(
        actorId: '1234567',
        actorToken: 'secret-token',
        cGroupId: 1,
    ),
);
```

💰 Работа с НДС (VatType)
------------------------

[](#-работа-с-ндс-vattype)

В SDK доступен enum `VatType`, который инкапсулирует тип ставки НДС для чеков DigitalKassa и содержит хелперы для расчёта суммы с НДС, выделения НДС и получения суммы без НДС.

Поддерживаются:

- обычные ставки (0%, 5%, 7%, 10%, 20%, 22%)
- расчетные ставки (5/105, 7/107, 10/110, 20/120, 22/122)
- режим без НДС

### Начисление НДС (из цены без НДС в цену с НДС)

[](#начисление-ндс-из-цены-без-ндс-в-цену-с-ндс)

```
use DF\DigitalKassa\V2\Enums\VatType;

$vat = VatType::VAT_20;

$net = 1000.00;
$gross = $vat->applyVat($net);

// 1200.00
```

### Выделение НДС из суммы с НДС

[](#выделение-ндс-из-суммы-с-ндс)

```
use DF\DigitalKassa\V2\Enums\VatType;

$vat = VatType::VAT_20;

$gross = 1200.00;
$vatAmount = $vat->extractVat($gross);

// 200.00
```

### Получение суммы без НДС

[](#получение-суммы-без-ндс)

```
use DF\DigitalKassa\V2\Enums\VatType;

$vat = VatType::VAT_20;

$gross = 1200.00;
$net = $vat->removeVat($gross);

// 1000.00
```

Основные методы
---------------

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

- `getCGroupInfo()`
- `createReceipt()`
- `getReceiptInfo()`
- `createCorrectionReceipt()`
- `getCorrectionReceiptInfo()`
- `getShiftReport()`
- `openShift()`
- `closeShift()`
- `changeShiftMode()`

Быстрый пример создания чека
----------------------------

[](#быстрый-пример-создания-чека)

```
use DF\DigitalKassa\V2\DTO\Receipt\ItemDTO;
use DF\DigitalKassa\V2\DTO\Receipt\ReceiptDTO;
use DF\DigitalKassa\V2\DTO\Receipt\ReceiptRequestDTO;
use DF\DigitalKassa\V2\DTO\Shared\AmountDTO;
use DF\DigitalKassa\V2\DTO\Shared\LocationDTO;
use DF\DigitalKassa\V2\DTO\Shared\NotifyDTO;
use DF\DigitalKassa\V2\Enums\InternetMode;
use DF\DigitalKassa\V2\Enums\ItemType;
use DF\DigitalKassa\V2\Enums\PaymentMethod;
use DF\DigitalKassa\V2\Enums\ReceiptType1054;
use DF\DigitalKassa\V2\Enums\Taxation;
use DF\DigitalKassa\V2\Enums\Timezone;
use DF\DigitalKassa\V2\Enums\Unit;
use DF\DigitalKassa\V2\Enums\VatType;

$response = $digitalkassa->createReceipt(new ReceiptRequestDTO(
    receipt_id: 'receipt123',
    receipt: new ReceiptDTO(
        type: ReceiptType1054::SELL,
        items: [
            new ItemDTO(
                type: ItemType::PRODUCT,
                name: 'Coffee',
                price: 100.00,
                quantity: 1.0,
                amount: 100.00,
                payment_method: PaymentMethod::FULL_PAYMENT,
                unit: Unit::PIECE,
                vat: VatType::VAT_20,
            ),
        ],
        taxation: Taxation::OSN,
        is_internet: InternetMode::ON,
        timezone: Timezone::UTC_5,
        notify: new NotifyDTO(
            emails: ['customer@example.com'],
            phone: '+79990000000',
        ),
        amount: new AmountDTO(cashless: 100.00),
        loc: new LocationDTO(billing_place: 'site.example'),
    ),
));
```

Примеры вызова
--------------

[](#примеры-вызова)

### Получение информации о группе касс

[](#получение-информации-о-группе-касс)

```
$cGroupInfo = $digitalkassa->getCGroupInfo();
```

### Получение статуса чека

[](#получение-статуса-чека)

```
use DF\DigitalKassa\V2\DTO\Receipt\ReceiptInfoRequestDTO;

$receiptInfo = $digitalkassa->getReceiptInfo(
    new ReceiptInfoRequestDTO(receipt_id: 'receipt123'),
);
```

### Создание чека коррекции

[](#создание-чека-коррекции)

```
use DF\DigitalKassa\V2\DTO\CorrectionReceipt\CorrectionReceiptDTO;
use DF\DigitalKassa\V2\DTO\CorrectionReceipt\CorrectionReceiptRequestDTO;
use DF\DigitalKassa\V2\DTO\Shared\CorrectionNotifyDTO;

$correctionResponse = $digitalkassa->createCorrectionReceipt(new CorrectionReceiptRequestDTO(
    receipt_id: 'correction123',
    correction_receipt: new CorrectionReceiptDTO(
        type: ReceiptType1054::SELL_REFUND,
        items: [
            new ItemDTO(
                type: ItemType::PRODUCT,
                name: 'Coffee',
                price: 100.00,
                quantity: 1.0,
                amount: 100.00,
                payment_method: PaymentMethod::FULL_PAYMENT,
                unit: Unit::PIECE,
                vat: VatType::VAT_20,
            ),
        ],
        taxation: Taxation::OSN,
        corrected_date: '24.03.2026',
        amount: new AmountDTO(cashless: 100.00),
        is_internet: InternetMode::ON,
        timezone: Timezone::UTC_5,
        loc: new LocationDTO(billing_place: 'site.example'),
        notify: new CorrectionNotifyDTO(phone: '+79990000000'),
    ),
));
```

### Получение статуса чека коррекции

[](#получение-статуса-чека-коррекции)

```
use DF\DigitalKassa\V2\DTO\CorrectionReceipt\CorrectionReceiptInfoRequestDTO;

$correctionInfo = $digitalkassa->getCorrectionReceiptInfo(
    new CorrectionReceiptInfoRequestDTO(receipt_id: 'correction123'),
);
```

### Работа со сменой

[](#работа-со-сменой)

```
use DF\DigitalKassa\V2\DTO\Shift\ShiftModeRequestDTO;
use DF\DigitalKassa\V2\DTO\Shift\ShiftRequestDTO;
use DF\DigitalKassa\V2\Enums\ShiftMode;

$shiftReport = $digitalkassa->getShiftReport();

$digitalkassa->openShift(new ShiftRequestDTO(
    name: 'Cashier',
    tin: '123456789012',
));

$digitalkassa->changeShiftMode(new ShiftModeRequestDTO(
    mode: ShiftMode::MANUAL,
));

$digitalkassa->closeShift();
```

Документация
------------

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

- [DigitalKassa API v2.1](https://api.digitalkassa.ru/v2.1/doc)
- [OpenAPI 2.1.0](https://api.digitalkassa.ru/v2.1/APIv2.1.json?type=api&format=json&dereference=true)

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% 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 ~0 days

Total

2

Last Release

1d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1d03d06109b9abe3f343a67353d431ec04fdbce0578d720fd5a936fa2394ed76?d=identicon)[denis660](/maintainers/denis660)

---

Top Contributors

[![denis660](https://avatars.githubusercontent.com/u/53209140?v=4)](https://github.com/denis660 "denis660 (4 commits)")[![m0nclous](https://avatars.githubusercontent.com/u/18490365?v=4)](https://github.com/m0nclous "m0nclous (1 commits)")

---

Tags

phpapisdkreceiptdigitalkassa

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sushi-market-digitalkassa-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/sushi-market-digitalkassa-sdk/health.svg)](https://phpackages.com/packages/sushi-market-digitalkassa-sdk)
```

###  Alternatives

[yidas/line-pay-sdk

LINE Pay SDK for PHP

8527.8k](/packages/yidas-line-pay-sdk)[clever/clever-php

231.6k](/packages/clever-clever-php)

PHPackages © 2026

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