Search

    Дата последнего обновления:

    Актуальная информация об обновлениях – здесь.

    Подключение и работа по 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.