dicr/yii2-fns-openapi

ФНС OpenAPI клиент для Yii2

1.0.3 2020-11-02 16:28 UTC

Requires

• php: ~7.2
• ext-simplexml: *
• dicr/yii2-helper: ~4.0
• dicr/yii2-validate: ~2.2
• yiisoft/yii2: ~2.0
• yiisoft/yii2-httpclient: ~2.0

Requires (Dev)

• phpunit/phpunit: ~9.4
• roave/security-advisories: dev-master

MIT

• Igor Tarasov

• yii2
• openapi
• fns
• dicr

README

• Проект ФНС
• Технические условия использования сервиса ФНС России «Открытое API проверки чека ККТ»

Конфигурация

Для работы с API компоненту необходимо указать ключ (masterKey). Также необходимо зарегистрировать IP-адрес, с которого будут отправляться запросы.

'components' => [
    'fnsClient' => [
        'class' => dicr\fns\openapi\FNSClient::class,
        'masterToken' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
    ]
];

Использование

use dicr\fns\openapi\FNSClient;
use dicr\fns\openapi\types\GetTicketInfo;
use dicr\fns\openapi\types\GetTicketResult;
use dicr\fns\openapi\types\TypeOperation;

/** @var FNSClient $fnsClient получаем клиент API */
$fnsClient = Yii::$app->get('fnsClient');

// данные чека
$ticketInfo = new GetTicketInfo([
   'Sum' => 99100,
   'Date' => '2020-10-03T15:27:00',
   'Fn' => '9280440300430432',
   'TypeOperation' => TypeOperation::INCOME,
   'FiscalDocumentId' => 29127,
   'FiscalSign' => 266252041
]);

/** @var GetTicketResult $result получаем данные по чеку */
$result = $fnsClient->getTicket($ticketInfo);

// проверяем код возвраща
if ($result->Code !== 200) {
    throw new \yii\base\Exception($result->Message);
}

// данные билета в $result->Ticket
print_r($result->Ticket);