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

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

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

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

Отключен метод загрузки медиа /media/creative/{id}

Убран метод восстановления акта:  GET / invoices/{id}/restore

Тип/свойствоОписание
Platforms
urlВведена валидация: URL площадки должен содержать детализацию. Перечень площадок, по которым обязательно указывать детализацию, доступны по ссылке
Organization
kppДобавлено необязательное поле «КПП».Может быть передано только для ЮЛ.
filter[created_at]Крайние значения диапазона дат включены в выборку.
Creatives
campaignУбрано поле «Тип РК».  Временно выводится в GET запросах.
is_nativeУбрано поле «Нативная реклама».  Временно выводится в GET запросах.
is_social_quotaДобавлен булевый параметр «Признак социальной рекламы по квоте». Является необязательным. Если не передавать, по умолчанию проставляется как false
filter[created_at]Крайние значения диапазона дат включены в выборку.
Creative_items
descriptionУбрано поле «Описание изображения креатива»
Invoices
typeДобавлено обязательное поле «Тип акта»."Возможные значения: -"invoice"- Акт выполненных работ.  Указывается, если акт создается на договор с типом "Договор оказания услуг" ("contract") или его ДС ("additional-agreement", у которого parent_contract_id (РД) с типом "contract").  -"intermediary-report" - Отчет посредника. Указывается, если акт создается на договор с типом "Посреднический договор" ("intermediary-contract") или его ДС ("additional-agreement", у которого parent_contract_id (РД) с типом "intermediary-contract")"
client_roleДобавляется новое возможно значение: "psr" - Посредник. Указывается в том случае, если посредник не является рекламным агентом.
contractor_roleДобавляется новое возможно значение: "psr" - Посредник. Указывается в том случае, если посредник не является рекламным агентом.
amountПоле преобразовано в тип «объект». Количество полей меняется в зависимости от типа акта.
services.excluding_vatСумма акта/отчета без учета НДС, руб.
services.vat_rateСтавка НДС, %
services.vatСумма НДС, руб.
services.including_vatСумма акта/отчета, включая НДС, руб.
commission.numberНомер акта вознаграждения посредника
commission.dateДата акта вознаграждения посредника
commission.excluding_vatСумма вознаграждения посредника без учета НДС, руб.
commission.vat_rateСтавка НДС, %
commission.vatСумма НДС, руб.
commission.including_vatСумма вознаграждения посредника, включая НДС, руб.
filter[period], filter[date]Крайние значения диапазона дат включены в выборку.
filter[amount][services][excluding_vat]Поиск по полю "Сумма акта/отчета без учета НДС"
filter[amount][services][including_vat]Поиск по полю "Сумма акта/отчета, включая НДС"
InvoiceItems
amountПоле преобразовано в тип «объект».
excluding_vatСумма рекл. бюджета без учета НДС, руб.
vat_rateСтавка НДС, %
vatСумма НДС, руб.
including_vatСумма рекл. бюджета, включая НДС, руб.
Statistics
amountПоле преобразовано в тип «объект».
excluding_vatСтоимость оказанных услуг без учета НДС, руб.
vat_rateСтавка НДС, %
vatСумма НДС, руб.
including_vatСтоимость оказанных услуг, включая НДС, руб.
filter[period_fact], filter[period_plan]Крайние значения диапазона дат включены в выборку.
Contracts
filter[created_at], filter[date]Крайние значения диапазона дат включены в выборку.