Обновление данных
Если данные бенефициара изменились — компания сменила КПП, человек сменил фамилию — обновите их через API. Метод зависит от типа бенефициара.
Для юрлица используйте update_beneficiary_ul. Для ИП и физлиц раньше были отдельные методы update_beneficiary_ip и update_beneficiary_fl — они ещё работают, но будут отключены. Дату отключения уточняйте в поддержке сервиса.
Обновление данных — ЮЛ
Метод update_beneficiary_ul обновляет данные бенефициара-юрлица: наименование, КПП, ОГРН и признак активной деятельности. Поля метода — в разделе Обновить данные бенефициара ЮЛ.
Признак is_active_activity работает так же, как при создании: true — больше половины доходов от активной деятельности, false — от пассивной. По умолчанию true.
Возможные ошибки:
| Код | Текст |
|---|---|
4404 | When updating data of the beneficiary you specified the wrong type of client |
4409 | Not found beneficiary |
Обновление данных — ИП
Метод update_beneficiary_ip обновляет ФИО и налоговое резидентство бенефициара-ИП. Поля метода — в автогенерируемом описании Обновить данные бенефициара ИП.
Признак tax_resident показывает, платит ли бенефициар налоги в РФ. Статус налогового резидента определяет страну уплаты налогов и не зависит от гражданства. По умолчанию true; при значении false мы попросим предоставить паспорт и адрес регистрации в другой стране.
Возможные ошибки:
| Код | Текст |
|---|---|
4404 | When updating data of the beneficiary you specified the wrong type of client |
4409 | Not found beneficiary |
Обновление данных — ФЛ
Метод update_beneficiary_fl обновляет данные бенефициара-физлица: ФИО, паспорт, дату и место рождения, адрес регистрации, налоговое резидентство. Поля метода — в разделе Обновить данные бенефициара ФЛ.
Возможные ошибки:
| Код | Текст |
|---|---|
4404 | When updating data of the beneficiary you specified the wrong type of client |
4409 | Not found beneficiary |
4421 | Incorrect addresses |