Проведение выплат самозанятым
Выплаты самозанятым проходят так же, как и выплаты физическим лицам. Отличается только набор передаваемых и возвращаемых параметров: для выплат самозанятым нужно дополнительно передавать данные для регистрации чеков.
Выберите ваш способ интеграции:
 
Выплаты по протоколу
Здесь описаны параметры, специфичные для выплат самозанятым. Остальные параметры — общие для всех типов запросов на зачисление перевода (
makeDeposition
).
 
Формат запроса
Чтобы сделать выплату самозанятому, в стандартном запросе makeDeposition дополнительно передайте ИНН для регистрации чека:
ПараметрТипОписание
itnxs:string,
12 символов
ИНН самозанятого. Формат: 12 цифр без пробелов
Обязательный параметр
В параметре
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 зарегистрирует чеки в сервисе Мой налог и переведет деньги получателям выплат с вашего баланса. Состояние выплат и успешность зачисления отображаются в личном кабинете в истории выплат.
Если выплата прошла успешно, дополнительно к стандартным параметрам в ответе вернется идентификатор зарегистрированного чека и ссылка на него.
ПараметрТипОписание
incomeReceiptIdxs:string
Идентификатор чека в сервисе. Пример:
208jd98zqe
Обязательный параметр, если выплата успешна
incomeReceiptLinkxs: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. Здесь описаны параметры, специфичные для выплат самозанятым. Остальные параметры — как в стандартных выплатах по спискам.
 
Описание дополнительных полей
ПолеОписаниеОбязательность заполнения
ИННИНН получателя выплаты. Формат: 12 цифр без пробеловДля всех видов выплат
Описание услугиОписание услуги, оказанной получателем выплаты, для печати в чеке. Для всех видов выплат
 
Шаблоны списков для выплат самозанятым
 
Особенности заполнения файла формата 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 зарегистрирует чеки в сервисе Мой налог и переведет деньги получателям выплат с вашего баланса. Состояние выплат и успешность зачисления отображаются в личном кабинете в истории выплат.
 
Ошибки при регистрации чеков
Если ЮKassa не сможет зарегистрировать чек в сервисе Мой налог, выплата не пройдет. В личном кабинете в истории выплат будет указана возникшая ошибка. Возможные причины возврата выплаты:
  • У получателя выплаты нет статуса самозанятого. Сообщите пользователю, что ему нужно получить статус самозанятого, или сделайте ему выплату как физическому лицу без регистрации чека (нужен отдельный шлюз, обратитесь к менеджеру за подробностями).
  • Самозанятый не выдал или отозвал разрешение регистрировать чеки. Запросите права и убедитесь, что получатель выплаты выдал разрешение в сервисе Мой налог.
  • Слишком большая выплата. Если перевести указанную сумму, получатель потеряет статус самозанятого. Уменьшите размер выплаты.
 
Что почитать еще
Выплаты по протоколуВыплаты по спискамПроцесс выплатВиды и лимиты выплат