meraproject/vendor/yoomoney/yookassa-sdk-php/docs/examples/07-self-employed.md
keboss-m 5c21d25d45 Initial commit: Merakomis portal, Docker stack and user-reader API.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-24 11:04:05 +03:00

4.2 KiB
Raw Blame History

Работа с самозанятыми

Самозанятые — это люди, которые не имеют работодателя и наемных работников и получают доход, оказывая услуги или продавая товары собственного производства. При выплатах самозанятым каждая выплата будет считаться доходом самозанятого, и ЮKassa будет автоматически регистрировать ее в сервисе Мой налог.

Информация о самозанятом нужна для проведения выплат самозанятым. Как делать выплаты самозанятым

SDK позволяет создавать самозанятого в ЮKassa, а также получать информацию о них.

Объект самозанятого SelfEmployed содержит всю информацию о самозанятом, актуальную на текущий момент времени. Он формируется при создании самозанятого и приходит в ответ на любой запрос, связанный с самозанятыми.

Набор возвращаемых параметров зависит от статуса объекта (значение параметра status) и того, какие параметры вы передали в запросе на создание самозанятого.


Запрос на создание самозанятого

Используйте этот запрос, чтобы создать в ЮKassa объект самозанятого. В запросе необходимо передать ИНН или телефон самозанятого для идентификации в сервисе Мой налог, сценарий подтверждения пользователем заявки ЮMoney на получение прав для регистрации чеков и описание самозанятого.

Идентификатор созданного объекта самозанятого необходимо использовать в запросе на проведение выплаты.

В ответ на запрос придет объект самозанятого - SelfEmployedResponse в актуальном статусе.

require_once 'vendor/autoload.php';

$client = new \YooKassa\Client();
$client->setAuth('xxxxxx', 'test_XXXXXXX');

$request = array(
    'itn' => '123456789012',
    'phone' => '79001002030',
    'confirmation' => array(
        'type' => 'redirect'
    ),
);
$idempotenceKey = uniqid('', true);
try {
    $result = $client->createSelfEmployed($request, $idempotenceKey);
} catch (\Exception $e) {
    $result = $e;
}

var_dump($result);

Получить информацию о самозанятом

С помощью этого запроса вы можете получить информацию о текущем статусе самозанятого по его уникальному идентификатору.

В ответ на запрос придет объект самозанятого - SelfEmployedResponse в актуальном статусе.

require_once 'vendor/autoload.php';

$client = new \YooKassa\Client();
$client->setAuth('xxxxxx', 'test_XXXXXXX');

$selfEmployedId = 'se-285c0ab7-0003-5000-9000-0e1166498fda';
try {
    $response = $client->getSelfEmployedInfo($selfEmployedId);
} catch (\Exception $e) {
    $response = $e;
}

var_dump($response);