Подключение и работа по API ОРД-А v2

Подключение и работа по API ОРД-А v2

Документация доступна только в виде файла по ссылке ниже.

Последнее обновление от 19.11.25

Тип/свойствоОписание
Platforms
typeДобавлены новые дополнительные значения:

- smarttv - SmartTV. Указывается, если трансляция рекламной информации осуществлялось средствами приложения, установленного на Смарт ТВ.

- hbbtv - HbbTV (Hybrid Broadcast Broadband TV). Технология, которая объединяет традиционное вещание ТВ с контентом, доставляемым через интернет или цифровое вещание. Если рекламный контент доставляется посредством Интернет с помощью технологии HbbTV, то информация должна быть зарегистрирована в ЕРИР. 

Поле «url» для данных типов необязательно. 
Organizations
innНе может быть изменен ИНН контрагента, так как в одном из договоров противоположной стороной является контрагент с таким же ИНН.
Contracts
actionИзменена обязательность с «Условно обязательно» на «Необязательно».
subjectИзменена обязательность с «Обязательно» на «Необязательно».
is_charge_paid_by_agentНе может быть указано как true, если исполнитель по договору является иностранным лицом.
Invoices
rr_order_contract_idНе может быть передан посреднический договор, в котором заказчик является иностранным лицом.
Invoices, InvoiceItems
is_socialДобавлен булевый признак «Социальная реклама».
Является необязательным. 
Если поле не передано, то в ответе вернется как null.
Если передано поле is_social, то также должно быть передано значение в поле is_social_quota.

Если переданы признаки is_social и is_social_quota со значением true (либо один, либо другой, либо оба сразу), то все суммы, указанные в акте, либо в детализации акта относятся к распространению социальной рекламы.

При этом неважно какие значения в признаках is_social в детализации акта (invoice_items.is_social) и is_social_quota в детализации акта (invoice_items.is_social_quota).
is_social_quotaДобавлен булевый признак «Социальная реклама по квоте».
Является необязательным. 
Если поле не передано, то в ответе вернется как null.
Если передано поле is_social_quota, то также должно быть передано значение в поле is_social.

Если переданы признаки is_social и is_social_quota со значением true (либо один, либо другой, либо оба сразу), то все суммы, указанные в акте, либо в детализации акта относятся к распространению социальной рекламы.

При этом неважно какие значения в признаках is_social в детализации акта (invoice_items.is_social) и is_social_quota в детализации акта (invoice_items.is_social_quota).
invoice_items.amount.vat_rate, invoices.amount.services.vat_rate Ставка НДС принимает фиксированные значения, определенные Налоговым Кодексом РФ.

Возможные значения:
100 – «Без НДС»,
0 – «0%»,
5 – «5%»,
7 – «7%»,
10 – «10%»,
20 – «20%».

Если тип акта «Отчет посредника», а договор акта имеет тип «Посреднический договор» и признак agent_acting_for_publisher = false (либо дополнительное соглашение к такому договору), то поля invoices.amount.services.vat_rate и invoice_items.amount.vat_rate (ставка НДС в актах и детализации по ИД) не обязательны для заполнения.
invoice_items.amount.vat, invoices.amount.services.vatЕсли vat_rate = 0 или vat_rate = 100, то vat = 0
(Если «Ставка НДС» = «0%» или «Ставка НДС» = «Без НДС», то «Сумма НДС» должна быть равна 0)

Если «Ставка НДС» передана, "Сумма НДС" должна быть равна произведению "Суммы без НДС" на "Ставку НДС" с учетом предусмотренной погрешности.

Описание расчета:
Расчетная Сумма НДС = "Сумма без учета НДС" * "Ставка НДС"

Если расчетная Сумма НДС >= 0.5 руб., тоn <= Переданная Сумма НДС <= m, гдеn - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой,m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб.

Если расчетная Сумма НДС < 0.5 руб., тоn <= Переданная Сумма НДС <= m, гдеn - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой,m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС.
Если «Ставка НДС» НЕ передана, то «Сумма НДС» должна быть больше 0 и не должна быть больше произведения максимальной ставки НДС в РФ (20%) на «Сумму НДС» с учетом предусмотренной погрешности.
Допускается Сумма НДС равной 0 только при выполнении последнего условия из описания расчета.

Описание расчета:
"Расчетная Сумма НДС" = "Сумма акта/отчета без учета НДС" * 20%

Если расчетная Сумма НДС >= 0.50 руб., то
0 < Переданная Сумма НДС <= m,
где m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб.

Если расчетная Сумма НДС < 0.50 руб., то
0 < Переданная Сумма НДС <= m,
где m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС.

Если расчетная Сумма НДС < 0,10 руб., то
0 <= Переданная Сумма НДС <= m,
где m - 50% от Суммы без НДС, с учетом математического округления до 2-го знака.
invoices.amount.commission.vat_rateСтавка НДС принимает фиксированные значения, определенные Налоговым Кодексом РФ. Возможные значения:
100 – «Без НДС»,
0 – «0%»,
5 – «5%»,
7 – «7%»,
10 – «10%»,
20 – «20%».
invoices.amount.commission.vatЕсли vat_rate = 0 или vat_rate = 100, то vat = 0
(Если «Ставка НДС» = «0%» или «Ставка НДС» = «Без НДС», то «Сумма НДС вознаграждения посредника» должна быть равна 0)

"Сумма НДС вознаграждения посредника" должна быть равна произведению "Суммы без НДС вознаграждения посредника" на "Ставку НДС" с учетом предусмотренной погрешности.

Описание расчета:
"Расчетная Сумма НДС" = "Сумма вознаграждения посредника без учета НДС" * "Ставка НДС"

Если расчетная Сумма НДС >= 0.5 руб., то

n <= Переданная Сумма НДС <= m, где

n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой,

m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб.

Если расчетная Сумма НДС < 0.5 руб., то

n <= Переданная Сумма НДС <= m, где

n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой,

m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС.
Statistics
vat_rateСтавка НДС принимает фиксированные значения, определенные Налоговым Кодексом РФ. Возможные значения:
100 – «Без НДС»,
0 – «0%»,
5 – «5%»,
7 – «7%»,
10 – «10%»,
20 – «20%».
vatЕсли vat_rate = 0 или vat_rate = 100, то vat = 0
(Если «Ставка НДС» = «0%» или «Ставка НДС» = «Без НДС», то «Сумма НДС для стоимости оказанных услуг» должна быть равна 0)
Изменена допустимая погрешность.
Правила расчета  зависят от расчетной суммы НДС:
Расчетная Сумма НДС = "Ставка НДС" * "Стоимость оказанных услуг без учета НДС"
(amount.vat_rate = amount.vat * amount.excluding_vat)

Если расчетная Сумма НДС >= 0.5 руб., то

n <= Переданная Сумма НДС <= m, где

n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой,

m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб.

Если 0.1 руб. <= Сумма НДС < 0.5 руб., то

n <= Переданная Сумма НДС <= m, где

n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой,

m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС.

Если расчетная Сумма НДС < 0.1 руб., то

n <= Переданная Сумма НДС <= m, где

i - Переданное количество знаков после запятой в Сумме без НДС (все нули справа отбрасываются), соответствующая неравенству 2 <= i <= 5,

n - Округленная вниз расчетная Сумма НДС до i-го знака после запятой,

m - Округленная расчетная Сумма НДС по математическим правилам до i-го знака после запятой + 5 * 10^-i руб., но не больше 50% от Суммы без НДС (символ ^ обозначает степень).
platform_idЕсли регистрируется статистика по креативу, который относится к саморекламе, то площадка, которая указывается в статистике должна быть зарегистрирована у контрагента, указанного в креативе с признаком is_owned=true.