modify
Редактировать параметры контрагента. Передавайте только те параметры контрагента, которые хотите изменить.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=contractor
& action=modify
& objectID=<integer>
& [name=<string>]
& [inn=<string>]
& [type=<integer>]
& [countryOKSM=<string>]
& [mobilePhone=<string>]
& [epayNumber=<string>]
& [regNumber=<string>]
& [roles[]=<integer>]
& [isOrs=<integer>]
& [isRr=<integer>]
& [rsUrl=<string>]
|
ID объекта, над которым производится действие. |
|
Название контрагента. Вы можете использовать только русские буквы. Также можно использовать пробел и тире (не более одного пробела и/или тире между словами). Тире нельзя использовать в начале и в конце предложения. |
|
ИНН контрагента. |
|
Тип контрагента. Допустимые значения:
|
|
ОКСМ код страны регистрации. |
|
Номер телефона контрагента. Указывается в формате |
|
Номер электронного средства платежа. |
|
Регистрационный номер. |
|
Роли в которых может выступать контрагент при заключении договора. Допустимые значения:
|
|
Является оператором рекламной системы. Допустимые значения:
|
|
Является распространителем рекламы. Допустимые значения:
|
|
URL рекламной системы или другая информация. |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=contractor&action=modify&objectID=543&name=NewContractorName
Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом contractor
:
ID объекта, над которым производится действие.
Название контрагента. Вы можете использовать только русские буквы. Также можно использовать пробел и тире (не более одного пробела и/или тире между словами). Тире нельзя использовать в начале и в конце предложения.
ИНН контрагента.
Тип контрагента.
Допустимые значения:
-
0
— Юридическое лицо (РФ). Обязательно указать значениеinn
(10 цифр). -
1
— Физическое лицо (РФ). Обязательно указать значениеinn
(12 цифр). -
2
— Индивидуальный предприниматель (РФ). Обязательно указать значениеinn
(12 цифр). -
3
— Юридическое лицо (Нерезидент). Обязательно заполнить полеcountryOKSM
, а также одно из полей:mobilePhone
илиepayNumber
. -
4
— Физическое лицо (Нерезидент). Обязательно заполнить полеcountryOKSM
, а также одно из полей:inn
илиregNumber
.
ОКСМ код страны регистрации.
Номер телефона контрагента. Указывается в формате+[кодстраны]{номертелефона}
. В номере телефона можно указать только цифры (от 1 до 50 цифр) без пробелов, тире и других знаков.
Номер электронного средства платежа.
Регистрационный номер.
Роли в которых может выступать контрагент при заключении договора.
Допустимые значения:
-
0
— Исполнитель. -
1
— Заказчик.
Является оператором рекламной системы.
Допустимые значения:
-
0
— не является оператором рекламной системы; -
1
— является оператором рекламной системы.
Является распространителем рекламы.
Допустимые значения:
-
0
— не является распространителем рекламы; -
1
— является распространителем рекламы.
URL рекламной системы или другая информация.
Обязательный параметр