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

71 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## Работа с самозанятыми
Самозанятые — это люди, которые не имеют работодателя и наемных работников и получают доход, оказывая услуги или продавая товары собственного производства. При выплатах самозанятым каждая выплата будет считаться доходом самозанятого, и ЮKassa будет автоматически регистрировать ее в сервисе [Мой налог](https://lknpd.nalog.ru/).
Информация о самозанятом нужна для проведения выплат самозанятым. [Как делать выплаты самозанятым](https://yookassa.ru/developers/payouts/scenario-extensions/self-employed)
SDK позволяет создавать самозанятого в ЮKassa, а также получать информацию о них.
Объект самозанятого `SelfEmployed` содержит всю информацию о самозанятом, актуальную на текущий момент времени. Он формируется при создании самозанятого и приходит в ответ на любой запрос, связанный с самозанятыми.
Набор возвращаемых параметров зависит от статуса объекта (значение параметра `status`) и того, какие параметры вы передали в запросе на создание самозанятого.
* [Запрос на создание самозанятого](#Запрос-на-создание-самозанятого)
* [Получить информацию о самозанятом](#Получить-информацию-о-самозанятом)
---
### Запрос на создание самозанятого <a name="Запрос-на-создание-самозанятого"></a>
Используйте этот запрос, чтобы создать в ЮKassa объект самозанятого. В запросе необходимо передать ИНН или телефон самозанятого для идентификации в сервисе Мой налог, сценарий подтверждения пользователем заявки ЮMoney на получение прав для регистрации чеков и описание самозанятого.
Идентификатор созданного объекта самозанятого необходимо использовать в запросе на проведение выплаты.
В ответ на запрос придет объект самозанятого - `SelfEmployedResponse` в актуальном статусе.
```php
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);
```
---
### Получить информацию о самозанятом <a name="Получить-информацию-о-самозанятом"></a>
С помощью этого запроса вы можете получить информацию о текущем статусе самозанятого по его уникальному идентификатору.
В ответ на запрос придет объект самозанятого - `SelfEmployedResponse` в актуальном статусе.
```php
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);
```