Проведение выплат самозанятым

The mass payouts protocol is now outdated. If you want to make payouts via the API, use the YooMoney API.

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

Выберите ваш способ интеграции:

Выплаты по протоколу
Выплаты по спискам

Выплаты по протоколу

Здесь описаны параметры, специфичные для выплат самозанятым. Остальные параметры — общие для всех типов запросов на зачисление перевода (makeDeposition).

Формат запроса

Чтобы сделать выплату самозанятому, в стандартном запросе makeDeposition дополнительно передайте ИНН для регистрации чека:

Parameter	Type	Description
itn	xs:string, 12 символов	ИНН самозанятого. Формат: 12 цифр без пробелов Required parameter

В параметре contract стандартного запроса makeDeposition необходимо передать описание услуги, оказанной получателем выплаты, — для печати в чеке.

Пример запроса для выплаты на банковскую карту

XML
<makeDepositionRequest
    requestDT="2021-07-14T15:29:19.905Z"
    contract="Доставка документов"
    amount="150.00"
    agentId="123"
    itn="<ИНН самозанятого>"
    clientOrderId="payouts-305_1626276559375"
    dstAccount="25700130535186"
    currency="643">
    <paymentParams>
        <skr_destinationCardSynonim>z5FM_BiJQnerQifL6ousGidF.SC.000.202107</skr_destinationCardSynonim>
        <cps_ymAccount>4100322815079</cps_ymAccount>
        <pof_offerAccepted>1</pof_offerAccepted>
    </paymentParams>
</makeDepositionRequest>

Формат ответа

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

Если выплата прошла успешно, дополнительно к стандартным параметрам в ответе вернется идентификатор зарегистрированного чека и ссылка на него.

Parameter	Type	Description
incomeReceiptId	xs:string	Идентификатор чека в сервисе. Пример: `208jd98zqe` Обязательный параметр, если выплата успешна
incomeReceiptLink	xs:string	Ссылка на зарегистрированный чек. Пример: `https://www.nalog.gov.ru/api/v1/receipt/{Идентификатор чека}/print` Обязательный параметр, если выплата успешна

Пример ответа при успехе

XML
<makeDepositionResponse
  clientOrderId="payouts-305_1626276559375"
  status="0"
  processedDT="2021-07-22T15:35:13.787+03:00"
  balance="30541301.78"
  incomeReceiptId="208jd98zqe"
  incomeReceiptLink="https://www.nalog.gov.ru/api/v1/receipt/208jd98zqe/print"
/>

Ошибки при регистрации чеков

Если выплата неуспешна, в параметре error ответа будет указан код ошибки. Кроме стандартных ошибок, при выплатах самозанятым могут быть такие причины неуспеха:

у получателя выплаты нет статуса самозанятого — 152;
самозанятый не выдал или отозвал разрешение регистрировать чеки — 151, 153, 154;
если сделать эту выплату, получатель потеряет статус самозанятого — 150;
некорректный формат ИНН — 158, 159.

Подробное описание ошибок

Пример ответа при неуспехе (ЮKassa не смогла зарегистрировать чек)

XML
<makeDepositionResponse
  clientOrderId="payouts-305_1626276559375"
  status="3"
  error="150"
  processedDT="2021-07-22T15:35:13.787+03:00"
/>

Выплаты по спискам

Для выплат по спискам можно использовать файлы формата XLSX и CSV. Здесь описаны параметры, специфичные для выплат самозанятым. Остальные параметры — как в стандартных выплатах по спискам.

Описание дополнительных полей

Поле	Description	Обязательность заполнения
ИНН получателя	ИНН самозанятого. Формат: 12 цифр без пробелов	For all types of payouts
Основание для выплаты	Описание услуги, оказанной получателем выплаты, для печати в чеке.	For all types of payouts

Шаблоны списков для выплат самозанятым

Шаблон в формате XLSX

Шаблон в формате CSV

Особенности заполнения файла формата CSV

Чтобы сформировать список в формате CSV:

Шаг 1. Скачайте шаблон для выплат в формате CSV.

Шаг 2. Добавьте в файл заголовок — HD-строку.

HD-строка

HD;№;Тип;Уникальный номер выплаты;Сумма;Валюта;Основание для выплаты;Номер банковской карты (или синоним);Номер кошелька;Расчётный счёт;БИК;Наименование;Город отделения;Корр. счёт;Телефон;Фамилия;Имя;Отчество;ИНН получателя;ОМС получателя(не обязательно);СНИЛС получателя(не обязательно);Серия и номер паспорта;Дата выдачи паспорта;Дата рождения;Гражданство получателя;Город;Улица;Дом;Квартира;Индекс;Идентификатор пользователя(не обязательно)

Шаг 3. Добавьте в файл информацию о выплатах и их получателях — D-строки. Количество строк может быть любым. В одном файле могут быть выплаты разных видов (на кошелек, карту, счет и телефон). Порядок может быть любым, но рекомендуется группировать выплаты по видам, например сначала перечислить в файле все выплаты на банковские карты, затем все выплаты на кошелек и так далее. Так вам будет проще ориентироваться в данных.

Пример D-строки (выплата на банковскую карту)

D;1;card;example_payout_20190101_1;100.00;643;"Доставка документов";ХХХХХХХХХХХХХХХХ;;;;;;;8ХХХХХХХХХХ;Иванов;Иван;Иванович;ХХХХХХХХХХХХ;;;ХХХХХХХХХХ;24.11.2010;24.11.2010;Да;РФ;;;;;;

Шаг 4. Сохраните файл. Название файла может быть любым.

Шаг 5. Проверьте себя:

Выполняются все общие требования.
В каждой D-строке есть ИНН получателя выплаты и описание услуги.
Получатели выплат — самозанятые.
Все получатели выплат разрешали ЮKassa регистрировать за них чеки.
Общая сумма всех выплат по каждому самозанятому меньше 2,4 млн рублей в год.

Готово! Можно загружать файл в личный кабинет. Если в данных будет ошибка, ЮKassa укажет порядковый номер выплаты и расскажет, что нужно поправить. Если всё корректно, ЮKassa сформирует хеш загруженного файла по алгоритму SHA-256, отобразит хеш и общую сумму выплат. Вам останется только проверить по хешу и сумме, что загружена актуальная версия файла, и подтвердить по смс проведение выплат.

Ошибки при регистрации чеков

Если ЮKassa не сможет зарегистрировать чек в сервисе Мой налог, выплата не пройдет. В личном кабинете в истории выплат будет указана возникшая ошибка. Возможные причины возврата выплаты:

У получателя выплаты нет статуса самозанятого. Сообщите пользователю, что ему нужно получить статус самозанятого, или сделайте ему выплату как физическому лицу без регистрации чека (нужен отдельный шлюз, обратитесь к менеджеру за подробностями).
Самозанятый не выдал или отозвал разрешение регистрировать чеки. Запросите права и убедитесь, что получатель выплаты выдал разрешение в сервисе Мой налог.
Слишком большая выплата. Если перевести указанную сумму, получатель потеряет статус самозанятого. Уменьшите размер выплаты.