contract

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.

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.

contractRole*

Contract role. Acceptable values:

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

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.

Default value: 0. To set the value to the “Not specified” state, pass either null or an empty value ''. When editing, you can set the value to the “Not specified” state the following way: actionType=&.

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.

Default value: 0. To set the value to the “Not specified” state, pass either null or an empty value ''. When editing, you can set the value to the “Not specified” state the following way: actionType=&.

number

Contract / additional agreement number. There should be no spaces or line break characters 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.

Default value: 1 (unpaid).

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.

Default value: 0.

socialType

Contract type. You can't change the parameter value after the contract is created. Acceptable values:

• 0: Commercial.
• 1 : Social advertising contract with payment.
• 2: Social advertising contract by quota.

Default value: 0 (commercial).

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).

code

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

ID

The ID of the created object.