modify

Edit contract parameters. Submit only those contract parameters that you want to change.

Note

Changing the parameter values resubmits the contract to the state register for a review.

Request format

https://adfox.yandex.com/api/v1
  ? object=contract
  & action=modify
  & objectID=<integer>
  & [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>]
  & [contractRole=<integer>]

objectID*

Contract ID.

type

Contract type.

Acceptable values:

  • 0: Service contract.
  • 1: Intermediary contract. Available parameters:
    • agentActingForPublisher: Intermediary function.
    • chargePaidByAgent: “Fee under this contract is paid by the intermediary, attorney, commission agent, or agent” option.
  • 2: Additional agreement. Ensure to fill in the intermediaryContractID field.

contractRole

Contract role. Acceptable values:

  • 0: Primary.
  • 1: Final.
  • 2: Direct.

customerID

Client ID. To learn how to get a list of counterparty IDs, see contractor.

executorID

Contractor ID. To learn how to get a list of counterparty IDs, see contractor.

intermediaryContractID

Parent contract ID. Passed only if type = 2.

subjectType

Subject matter of the contract.

Acceptable values:

  • 0: Other.
  • 1: Ad distribution contract.
  • 2: Contract to organize ad distribution.
  • 3: Mediation.
  • 4: Representation.

actionType

Description of actions performed by the intermediary representative.

Acceptable values:

  • 0: Other.
  • 1: Actions related to ad distribution.
  • 2: Conclusion of contracts.
  • 3: Commercial representation.

number

Contract / additional agreement number. There should be no spaces or line breaks at the beginning and end of the line.

amountRub

Contract amount. Passed only if amountType = 0 (paid).

amountType

Contract price. Acceptable values:

  • 0: Paid (if this value is selected, amountRub becomes mandatory).
  • 1: Unpaid.
  • 2: There is no price in the contract.

dateConclusion

Date of the contract or additional agreement. Format: YYYY-MM-DD. The contract/additional agreement date cannot be in the future.

isRegReport

The contractor is responsible for registering and submitting ad creatives.

Acceptable values:

  • 0: No
  • 1: Yes.

agentActingForPublisher

Intermediary function, attribute of the monetary flow direction towards the principal. Required if the contract type type = 1. Otherwise, must be omitted. Acceptable values:

  • 0: The agent acts in the interests of the advertiser under this agent agreement (is an advertiser's representative).
  • 1: The agent acts in the interests of the advertising distributor under this agent agreement (is an advertising platform's representative).

chargePaidByAgent

Attribute “Fee under this contract is paid by the intermediary, attorney, commission agent, or agent”. The field can be passed only in the intermediary contract type = 1 and if the attribute of the monetary flow direction towards the principal is agentActingForPublisher = 0. Acceptable values:

  • 0: Disabled.
  • 1: Enabled (fee under this contract is paid by the intermediary, attorney, commission agent, or agent).

* Required parameter

Response format

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

Response parameters

code

Request processing status. A value of 0 means the request was completed successfully. For the key, see Error handling.

Sample request and response

Request:

https://adfox.yandex.com/api/v1?object=contract&action=modify&objectID=777&type=2&customerID=108&executorID=109&isRegReport=1&subjectType=0&actionType=3&number=number&amountRub=77&intermediaryContractID=43792

Response:

<response>
<status>
  <code>0</code>
</status>
</response>

Other actions with the object

See also other actions with the contract object:

Contract ID.

Contract type.

Acceptable values:

  • 0: Service contract.
  • 1: Intermediary contract. Available parameters:
    • agentActingForPublisher: Intermediary function.
    • chargePaidByAgent: “Fee under this contract is paid by the intermediary, attorney, commission agent, or agent” option.
  • 2: Additional agreement. Ensure to fill in the intermediaryContractID field.

Customer ID. To learn how to get a list of counterparty IDs, see contractor.

Contractor ID. To learn how to get a list of counterparty IDs, see contractor.

Parent contract ID. Passed only if type = 2.

Subject matter of the contract.

Acceptable values:

  • 0: Other.

  • 1: Ad distribution contract.

  • 2: Contract to organize ad distribution.

  • 3: Mediation.

  • 4: Representation.

Description of actions performed by the intermediary representative.

Acceptable values:

  • 0: Other.

  • 1: Actions related to ad distribution.

  • 2: Conclusion of contracts.

  • 3: Commercial representation.

Contract / additional agreement number. There should be no spaces or line breaks at the beginning and end of the line.

Contract amount. Passed only if amountType = 0 (paid).

Contract price. Acceptable values:

  • 0: Paid (if this value is selected, amountRub becomes mandatory).
  • 1: Unpaid.
  • 2: There is no price in the contract.

Contract role. Acceptable values:

  • 0: Primary.
  • 1: Final.
  • 2: Direct.

Intermediary function, attribute of the monetary flow direction towards the principal. Required if the contract type type = 1. Otherwise, must be omitted. Acceptable values:

  • 0: The agent acts in the interests of the advertiser under this agent agreement (is an advertiser's representative).
  • 1: The agent acts in the interests of the advertising distributor under this agent agreement (is an advertising platform's representative).

Attribute “Fee under this contract is paid by the intermediary, attorney, commission agent, or agent”. The field can be passed only in the intermediary contract type = 1 and if the attribute of the monetary flow direction towards the principal is agentActingForPublisher = 0. Acceptable values:

  • 0: Disabled.
  • 1: Enabled (fee under this contract is paid by the intermediary, attorney, commission agent, or agent).

Date of the contract / additional agreement. Format: YYYY-MM-DD. The contract/additional agreement date cannot be in the future.

The contractor is responsible for registering and submitting ad creatives.

Acceptable values:

  • 0: No

  • 1: Yes.

Required parameter.

Previous