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