contract

Добавить новый договор для маркировки рекламы.

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

https://adfox.yandex.ru/api/v1
  ? object=account
  & action=add
  & actionObject=contract
  & type=<integer>
  & [agentActingForPublisher=<integer>]
  & [chargePaidByAgent=<integer>]
  & [intermediaryContractID=<integer>]
  & customerID=<integer>
  & executorID=<integer>
  & [subjectType=<integer>]
  & [number=<string>]
  & [dateConclusion=<string>]
  & [amountType=<string>]
  & [amountRub=<string>]
  & [actionType=<integer>]
  & [isRegReport=<integer>]
  & [socialType=<integer>]
  & contractRole=<integer>

type*

Тип контракта.

Допустимые значения:

  • 0 — Договор оказания услуг.

  • 1 — Посреднический договор. Доступны параметры:

    • agentActingForPublisher— функция посредника;
    • chargePaidByAgent — опция «Сбор по этому договору оплачивает посредник, поверенный, комиссионер или агент».
  • 2 — Дополнительное соглашение. Обязательно заполнить поле intermediaryContractID.

customerID*

ID заказчика. Как получить список ID контрагентов, см. в разделе contractor.

executorID*

ID исполнителя. Как получить список ID контрагентов, см. в разделе contractor.

contractRole*

Роль договора. Допустимые значения:

  • 0 — первичный;
  • 1 — конечный;
  • 2 — прямой.

intermediaryContractID

ID родительского договора. Передается, только если type=2.

subjectType

Сведения о предмете договора.

Допустимые значения:

  • 0 — Иное.
  • 1 — Договор на распространение рекламы.
  • 2 — Договор на организацию распространения рекламы.
  • 3 — Посредничество.
  • 4 — Представительство.

Значение по умолчанию: 0. Чтобы значение перешло в состояние «Не задано», можно передать null или пустое значение ''. При редактировании перевести в состояние «Не задано» можно так: subjectType=&.

actionType

Описание действий посредника-представителя.

Допустимые значения:

  • 0 — Иное.
  • 1 — Действия в целях распространения рекламы.
  • 2 — Заключение договоров.
  • 3 — Коммерческое представительство.

Значение по умолчанию: 0. Чтобы значение перешло в состояние «Не задано», можно передать null или пустое значение ''. При редактировании перевести в состояние «Не задано» можно так: actionType=&.

number

Номер договора/дополнительного соглашения. В начале и в конце строки не должно быть пробелов и символов перевода строки.

amountRub

Цена договора. Передается, только если amountType=0 (возмездный).

amountType

Цена договора. Допустимые значения:

  • 0 — Возмездный (при этом значении обязательным становится amountRub).
  • 1 — Безвозмездный.
  • 2 — В договоре нет цены.

Значение по умолчанию: 1.

dateConclusion

Дата договора/дополнительного соглашения. Формат: ГГГГ-ММ-ДД. Дата не может быть больше текущей.

isRegReport

На контрагенте-исполнителе лежит обязанность регистрировать и отправлять креативы.

Допустимые значения:

  • 0 — нет;
  • 1 — да.

Значение по умолчанию: 1.

socialType

Вид договора. Допустимые значения:

  • 0 — Коммерческий.
  • 1 — Договор социальной рекламы с оплатой.
  • 2 — Договор социальной рекламы по квоте.

Значение по умолчанию: 1.

Примечание

Значение параметра не получится изменить после создания договора.

agentActingForPublisher

Функция посредника, признак направления денежного потока в сторону принципала. Обязателен, если выбран тип договора type=1, в противном случае указывать нельзя.

Допустимые значения:

  • 0 — агент действует в интересах РД в этом агентском договоре (является представителем рекламодателя).
  • 1 — агент действует в интересах РР в этом агентском договоре (является представителем рекламной площадки).

chargePaidByAgent

Признак «Сбор по этому договору оплачивает посредник, поверенный, комиссионер или агент». Поле может передаваться только в посредническом договоре type=1 и признаке направления денежного потока в сторону принципала agentActingForPublisher=0.

Допустимые значения:

  • 0 — выключено;
  • 1 — включено (сбор по этому договору оплачивает посредник, поверенный, комиссионер или агент).

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

<response>
  <status>
    <code>{integer}</code>
    <ID>{integer}</ID>
  </status>
</response>

Параметры ответа

code

Статус обработки запроса. Значение 0 — запрос выполнен успешно. Расшифровку смотрите в разделе Обработка ошибок.

ID

ID объекта.

Пример запроса и ответа

Запрос:

https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=contract&type=2&customerID=108&executorID=109&isRegReport=1&subjectType=0&actionType=3&number=number&amountRub=77&intermediaryContractID=43792&dateConclusion=2022-08-24

Ответ:

<response>
<status>
  <code>0</code>
  <ID>1111</ID>
</status>
</response>

Другие действия с объектом

Читайте также о других действиях с объектом contract:

Тип контракта.

Допустимые значения:

  • 0 — Договор оказания услуг.

  • 1 — Посреднический договор. Доступны параметры:

    • agentActingForPublisher— функция посредника;
    • chargePaidByAgent — опция «Сбор по этому договору оплачивает посредник, поверенный, комиссионер или агент».
  • 2 — Дополнительное соглашение. Обязательно заполнить поле intermediaryContractID.

ID заказчика. Как получить список ID контрагентов, см. в разделе contractor.

ID исполнителя. Как получить список ID контрагентов, см. в разделе contractor.

ID родительского договора. Передается, только если type=2.

Сведения о предмете договора.

Допустимые значения:

  • 0 — Иное.
  • 1 — Договор на распространение рекламы.
  • 2 — Договор на организацию распространения рекламы.
  • 3 — Посредничество.
  • 4 — Представительство.

Значение по умолчанию: 0. Чтобы значение перешло в состояние «Не задано», можно передать null или пустое значение ''. При редактировании перевести в состояние «Не задано» можно так: subjectType=&.

Описание действий посредника-представителя.

Допустимые значения:

  • 0 — Иное.
  • 1 — Действия в целях распространения рекламы.
  • 2 — Заключение договоров.
  • 3 — Коммерческое представительство.

Значение по умолчанию: 0. Чтобы значение перешло в состояние «Не задано», можно передать null или пустое значение ''. При редактировании перевести в состояние «Не задано» можно так: actionType=&.

Номер договора/дополнительного соглашения. В начале и в конце строки не должно быть пробелов и символов перевода строки.

Цена договора. Передается, только если amountType=0 (возмездный).

Цена договора. Допустимые значения:

  • 0 — Возмездный (при этом значении обязательным становится amountRub).
  • 1 — Безвозмездный.
  • 2 — В договоре нет цены.

Значение по умолчанию: 1.

Роль договора. Допустимые значения:

  • 0 — первичный;
  • 1 — конечный;
  • 2 — прямой.

Вид договора. Допустимые значения:

  • 0 — Коммерческий.
  • 1 — Договор социальной рекламы с оплатой.
  • 2 — Договор социальной рекламы по квоте.

Значение по умолчанию: 0.

Примечание

Значение параметра не получится изменить после создания договора.

Функция посредника, признак направления денежного потока в сторону принципала. Обязателен, если выбран тип договора type=1, в противном случае указывать нельзя.

Допустимые значения:

  • 0 — агент действует в интересах РД в этом агентском договоре (является представителем рекламодателя).
  • 1 — агент действует в интересах РР в этом агентском договоре (является представителем рекламной площадки).

Признак «Сбор по этому договору оплачивает посредник, поверенный, комиссионер или агент». Поле может передаваться только в посредническом договоре type=1 и признаке направления денежного потока в сторону принципала agentActingForPublisher=0.

Допустимые значения:

  • 0 — выключено;
  • 1 — включено (сбор по этому договору оплачивает посредник, поверенный, комиссионер или агент).

Дата договора/дополнительного соглашения. Формат: ГГГГ-ММ-ДД. Дата не может быть больше текущей.

На контрагенте-исполнителе лежит обязанность регистрировать и отправлять креативы.

Допустимые значения:

  • 0 — нет;
  • 1 — да.

Значение по умолчанию: 0.

Обязательный параметр.

Предыдущая
Следующая