Руководство по API ОРД v5.0

Что такое ОРД и зачем нужен этот API

ОРД (оператор рекламных данных) - организация, через которую участники рынка интернет-рекламы передают сведения о рекламе в ЕРИР (Единый реестр интернет-рекламы Роскомнадзора). Обязанность передавать такие сведения установлена ст. 18.1 Федерального закона "О рекламе" (№ 38-ФЗ).

Через API ОРД от SberAds вы:

• регистрируете контрагентов (рекламодателей, агентств, ОРС, рекламораспространителей) и их площадки;
• регистрируете договоры между контрагентами;
• получаете маркер (erid) для каждого рекламного креатива - без него креатив нельзя размещать;
• отчитываетесь актами и статистикой.

Каждый объект проходит два этапа: сначала он регистрируется в ОРД, затем ОРД передаёт его в ЕРИР. Текущее положение объекта видно в поле state (см. Статусная модель).

API Endpoints

Актуальная машиночитаемая спецификация: https://api.ord-lab.ru/swagger-api-v5.0/index.html.

Версия v5.0 работает с новым API ЕРИР (v8). Версии /api/v4 ... /api/v4.9 продолжают работать со старым API ЕРИР (v7) и будут выведены из эксплуатации с 1 октября 2026г. Всем интеграциям рекомендуется перейти на v5.0 - перечень отличий приведён в разделе Миграция с v4 на v5.

Протокол

Для реализации API используется протокол HTTP REST. Типы данных определяются в соответствии со спецификацией OpenAPI: спецификация публикуется в двух форматах - Swagger 2.0 и OpenAPI 3.0. Тело запроса и ответа - application/json в кодировке UTF-8 (исключение - пакетная загрузка файлов, см. раздел Пакетная загрузка).

Используются следующие методы HTTP:

Запросы PUT и POST могут выполняться частично асинхронно (то есть уже после возврата управления из запроса). При этом:

• регистрация объекта в ОРД выполняется всегда синхронно;
• загрузка медиафайлов в хранилище ОРД может выполняться синхронно или асинхронно;
• регистрация сущности в ЕРИР происходит после загрузки медиафайлов и также может выполняться синхронно или асинхронно.

Поэтому ответ 202 Accepted - нормальный результат: объект принят ОРД, но подтверждение от ЕРИР ещё не получено. Итоговый статус нужно опрашивать методом GET /{сущность}/{id}/status или HEAD. Подробнее о статусной модели сущностей в разделе Статусная модель сущностей. 

Коды ответов HTTP

Аутентификация

Поддерживается единственный метод аутентификации - Bearer (JWT). Токен передаётся в заголовке каждого запроса:

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

В случае ошибки аутентификации возвращается ответ с кодом 401 Unauthorized.

Полный запрос целиком:

curl -X POST 'https://api.ord-lab.ru/api/v5.0/organizations' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...' \
  -H 'Content-Type: application/json' \
  -d '{
        "type": "ul",
        "isOrs": false,
        "isRr": false,
        "inn": "7705008280",
        "kpp": "770501001",
        "name": "ООО \"Ромашка\"",
        "address": "г. Москва, ул. Примерная, д. 1, оф. 5"
      }'

Дальше в руководстве примеры приводятся в сокращённой записи - метод, путь и тело запроса.

Токены выпускаются и отзываются через API - см. раздел Токены. Рекомендации:

• выпускайте отдельный токен на каждую интеграцию, чтобы отозвать её можно было независимо от остальных;
• храните токен как секрет: он даёт полный доступ к данным вашего namespace;
• задавайте daysToLive исходя из регламента ротации - максимум 3650 дней (10 лет), минимум 1 день;
• при компрометации немедленно вызовите POST /tokens/revoke/{id}.

Ограничение частоты запросов (rate limiting)

Для защиты API от перегрузки и обеспечения стабильной работы для всех клиентов применяется механизм ограничения частоты запросов (rate limit).

Ограничение реализовано по принципу корзины токенов (token bucket):

1. У каждого клиента есть персональная корзина с токенами — она не влияет на корзины других клиентов.
2. Каждый запрос расходует один токен из корзины.
3. Корзина автоматически пополняется с заданной периодичностью.
4. Если токенов в корзине не хватает, API возвращает ошибку 429 Too Many Requests

Ручки с активным Rate Limit

Ограничение частоты запросов включено для следующих эндпоинтов:

Группа 1: Удаление
 

Эндпоинты:

Группа 2: Статистика в актах
 

Эндпоинты:

Сокращённый ответ (short)

По умолчанию методы создания и изменения возвращают объект целиком. Если вам нужен только статус, включите сокращённый ответ - это заметно уменьшает объём трафика при массовых загрузках.

Два равнозначных способа:

POST /api/v5.0/creatives?short=true

POST /api/v5.0/creatives
Accept: application/vnd.ord-lab.ru.api.entity.short+json

Отличие от v4. В версиях v4.x медиатип содержал номер версии: application/vnd.ord-lab.ru.api.v3.entity.short+json. В v5.0 используется медиатип без номера версии: application/vnd.ord-lab.ru.api.entity.short+json. Параметр ?short=true работает одинаково в обеих версиях.

Расширенный ответ статистики (extended)

Для группы /creative-statistics доступен расширенный формат ответа. Включается параметром ?extended=true либо заголовком:

Accept: application/vnd.ord-lab.ru.api.v2.creative-statistics.extended+json

Заголовки ответов (Custom HTTP Response Headers)

Данные заголовки могут присутствовать в ответах каждого из запросов API. Они дублируют поля объекта Status и удобны для метода HEAD, у которого нет тела ответа.

Статусная модель

Если объект "завис" в PENDING из-за временной ошибки, ОРД сам поставит его в очередь на повторную отправку с интервалом от одного часа. Не дожидаясь этого, повторную попытку можно запустить вручную методом POST /{сущность}/{id}.

Типовые сценарии жизненного цикла

Жизненный цикл сущности зависит от того, зарегистрированы ли вышестоящие объекты в ЕРИР на момент её создания. Ниже описаны два основных сценария.

Сценарий 1: 

Первичная регистрация всех вышестоящих объектов
Этот сценарий возникает, когда вы создаете полную цепочку сущностей "с нуля" — от организации до креатива или акта. Ни один из вышестоящих объектов еще не прошел проверку в ЕРИР.

Пример ситуации:

Вы регистрируете новую организацию, новую площадку, новый контракт и новый креатив.

Все объекты создаются последовательно, но ни один из них еще не проверен в ЕРИР.

Путь статусов

PENDING → ACCEPTED → APPROVED/DECLINED

Сценарий 2: 

Создание при наличии ранее утвержденных вышестоящих объектов
Этот сценарий возникает, когда вы создаете сущность в рамках уже существующей и проверенной цепочки объектов. Вышестоящие объекты уже имеют статус APPROVED на момент создания.

Пример ситуации:

У вас уже есть контракт, успешно прошедший проверку в ЕРИР (статус APPROVED).

Вы создаете новый креатив по этому контракту.

Путь статусов

ACCEPTED → APPROVED/DECLINED

Объект Status

Данный объект возвращается в ответ на запросы POST и PUT со статусом 200, 201, 202, а также методом GET /{сущность}/{id}/status. Часть полей объекта дублирует соответствующие заголовки ответов.

Пример:

{
  "id": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-08-01T13:20:50.052+03:00",
  "marker": "2Ranyn7YfuE"
}

Методы, принимающие массив объектов (POST /creative-statistics, POST /invoices/creatives), в сокращённом режиме возвращают массив статусов:

{
  "statuses": [
    { "id": "7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1", "state": "ACCEPTED" },
    { "id": "c1a6d4b8-2f37-4e55-9d0a-8b7c6e5f4a31", "state": "PENDING" }
  ]
}

Объект Error

Данный объект возвращается в ответ на запросы, имеющие статусные коды 4xx и, в ряде случаев, 5xx.

Пример ответа при непройденном контроле:

{
  "requestId": "0e29c0f6-6d5e-4a30-9f5a-2f4d2b2a1f77",
  "status": 400,
  "code": "parameter-error",
  "title": "invalid parameter value",
  "detail": "I_185: Не передан обязательный массив \"intermediaryReportIdList\" для актов типа \"Акт на вознаграждение посредника\""
}

Коды ошибок

Объект Pagination - постраничный вывод

Данный объект возвращается в составе ответа на списочные запросы (POST /{сущность}/search) в поле meta.

Все фильтры поиска дополнительно поддерживают поля page, limit, sorting (массив полей сортировки) и cursor (курсорная пагинация - начать выборку с указанного элемента; предпочтительна при обходе больших выборок).

{
  "data": [ { "...": "объекты запрошенной сущности" } ],
  "meta": { "page": 1, "limit": 100, "total": 3471 }
}

Общие принципы работы с идентификаторами

Все системные идентификаторы объектов в ОРД имеют формат UUID v4. Идентификаторы генерируются автоматически при создании сущности методом POST. Задать собственное значение системного идентификатора невозможно. Но есть исключения из правил:

1. feedId (товарный фид) - Идентификатор контейнера товарного фида генерируется клиентом и передается при создании.
2. externalId (площадки, медиаданные креатива) - Необязательный пользовательский идентификатор. Присваивается площадке или медиаданным креатива для внутренней идентификации объекта в системе клиента. Используется исключительно для удобства самого пользователя и не влияет на логику работы API.

Специальные идентификаторы

CID - используется, когда договор в ОРД не регистрировался в вашем ЛК ОРД, но на него нужно ссылаться. Например, вы получили cid от другого участника цепочки, который зарегистрировал договор в своем ЛК ОРД.

Поля cid и contractId являются взаимоисключающими — при создании или обновлении сущности можно передать только одно из них:

• contractId - если договор зарегистрирован в данном ЛК ОРД.
• cid- если договор был зарегистрирован в ОРД другим участником цепочки. 

Данные в примерах

Все примеры в этом руководстве построены на одном наборе вымышленных участников и объектов. Идентификаторы сквозные: договор, на который ссылается акт в разделе "Акты", - тот же самый, что зарегистрирован в разделе "Договоры". Реквизиты, ссылки и наименования вымышлены; совпадения с действующими организациями и сайтами случайны.

Домены *.example, example.com и подобные зарезервированы стандартом для документации и в сети не резолвятся - в рабочих запросах указывайте собственные адреса.

Порядок вызовов при первом подключении

Полный цикл от пустого аккаунта до сданной отчётности выглядит так. Каждый шаг разобран с примерами в соответствующем разделе.

Выдерживать паузы между шагами не нужно: достаточно соблюдать порядок вызовов, а очерёдностью отправки в ЕРИР ОРД управляет сам. Как именно - ниже.

Ожидание зависимостей

Объект, который ссылается на другие сущности, после регистрации в ОРД не уходит в ЕРИР немедленно. Сначала он попадает в очередь ожидания и остаётся в статусе PENDING, пока все объекты, на которые он ссылается, не будут зарегистрированы в ЕРИР. Только после этого ОРД отправляет его дальше.

Поэтому связанные объекты можно отправлять подряд, не дожидаясь APPROVED по каждому предыдущему. Договор допустимо зарегистрировать сразу вслед за контрагентами, акт - вслед за договором.

Кого ждёт каждая сущность:

Что из этого следует на практике:

• Порядок вызовов всё равно важен. Ожидание снимает требование ждать APPROVED, но не отменяет того, что ссылаться можно только на уже созданный в ОРД объект: его идентификатор нужно откуда-то взять.
• Ожидание не бесконечно. Попытки повторяются с интервалом порядка трёх часов и в какой-то момент прекращаются. Если объект надолго завис в PENDING, ищите причину среди тех, кого он ждёт.
• При отклонении сущности в ЕРИР (статус DECLINED) отказ распространяется по цепочке зависимостей вниз. Все нижестоящие сущности, которые ожидали подтверждения отклоненной сущности, также автоматически переводятся в статус DECLINED. Если ЕРИР отклоняет контракт, все креативы и акты, привязанные к нему, также получают статус DECLINED. 

Разбираться нужно с первопричиной, а не с последним объектом в цепочке. После внесения изменений в объект, отклоненный ЕРИР необходимо все последующие объекты переотправить через запрос POST /{сущность}/id с тем же содержимым. 

• Статус удобнее запрашивать методом HEAD - он отдаёт ORD-State в заголовках и не тратит трафик на тело ответа.

Доступ к API осуществляется по JWT-токену. Токены выпускаются и отзываются через API, причём сами эти методы тоже требуют авторизации: чтобы выпустить новый токен, нужен действующий. Самый первый токен выдаётся при подключении к сервису - через личный кабинет.

Практическое следствие: держите один долгоживущий токен для управления токенами и выпускайте им рабочие токены с коротким сроком жизни.

POST /tokens/issue - Создать токен

Тело запроса - TokenRequest

Ответ - TokenResponse

POST /api/v5.0/tokens/issue

{ "daysToLive": 365 }

201 Created

{
  "id": "36138e99-9c10-406c-a7a1-f15a098c269f",
  "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2027-08-07T00:00:00+03:00"
}

Отличие от v4. В v4.x успешный выпуск токена возвращался с кодом 200 OK. В v5.0 возвращается 201 Created. Если ваш код проверяет status === 200, его нужно поправить.

При ошибке (400, 401) возвращается тот же объект TokenResponse, но заполнено только поле error.

POST /tokens/revoke/{id} - Отозвать токен

Тела у запроса нет - идентификатор передаётся в пути.

POST /api/v5.0/tokens/revoke/36138e99-9c10-406c-a7a1-f15a098c269f

200 OK

{ "id": "36138e99-9c10-406c-a7a1-f15a098c269f" }

Отзыв действует немедленно: все последующие запросы с этим токеном получат 401 Unauthorized.

Субъекты рекламного рынка: рекламодатели (РД), агентства, операторы рекламных систем (ОРС), рекламораспространители (РР), посредники. Российские и иностранные юридические и физические лица.

Контрагент - базовая сущность: без него нельзя зарегистрировать ни договор, ни площадку. Регистрировать нужно обе стороны каждого договора.

Organization object - Контрагент

Значения type

OrganizationPlatform object - Площадка контрагента

ExternalId для площадки

Поле externalId необходимо для идентификации площадки пользователем в случае одновременной регистрации нескольких площадок.

Если в рамках одного запроса POST /organizations был направлен объект с множественными вложенными площадками, в ответном объекте порядок площадок может отличаться от порядка, в котором они были переданы в запросе. При необходимости externalId может быть использован для адресации на стороне клиента. Однако следует помнить, что для первичной адресации использовать externalId нельзя: например, при регистрации акта можно указывать только platformId, генерируемый на стороне ОРД.

POST /organizations - Регистрация контрагента в ОРД

Параметры запроса

Ответ

Пример запроса: рекламодатель

Рекламодателю площадки не нужны - достаточно реквизитов.

POST /api/v5.0/organizations

{
  "type": "ul",
  "isOrs": false,
  "isRr": false,
  "inn": "7705008280",
  "kpp": "770501001",
  "name": "ООО \"Ромашка\"",
  "address": "г. Москва, ул. Примерная, д. 1, оф. 5"
}

Пример ответа (short = true)

202 Accepted

{
  "id": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "state": "ACCEPTED",
  "erirRegisteredAt": "2026-08-01T13:20:50.052+03:00"
}

Пример запроса: рекламораспространитель с площадками

Площадки можно завести сразу вместе с контрагентом - отдельные вызовы POST /platforms тогда не нужны.

POST /api/v5.0/organizations

{
  "type": "ul",
  "isOrs": false,
  "isRr": true,
  "inn": "7732222893",
  "kpp": "773201001",
  "name": "ООО \"Вектор-Медиа\"",
  "address": "г. Москва, ул. Примерная, д. 14, стр. 2",
  "platforms": [
    {
      "externalId": "vector-news",
      "isOwned": true,
      "type": "site",
      "name": "Вектор Новости",
      "url": "https://news.vector.example"
    },
    {
      "externalId": "vector-mobile",
      "isOwned": true,
      "type": "apps",
      "name": "Вектор Мобайл",
      "url": "https://store.example/apps/vector-mobile"
    }
  ]
}

Пример ответа (short = false)

Возвращается объект целиком: у площадок появились выданные ОРД platformId, по которым на них можно ссылаться в статистике.

201 Created

{
  "id": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "type": "ul",
  "isOrs": false,
  "isRr": true,
  "inn": "7732222893",
  "kpp": "773201001",
  "name": "ООО \"Вектор-Медиа\"",
  "address": "г. Москва, ул. Примерная, д. 14, стр. 2",
  "mobilePhone": null,
  "epayNumber": null,
  "regNumber": null,
  "alternativeInn": null,
  "oksmNumber": null,
  "rsUrl": null,
  "platforms": [
    {
      "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
      "externalId": "vector-news",
      "isOwned": true,
      "type": "site",
      "name": "Вектор Новости",
      "url": "https://news.vector.example"
    },
    {
      "platformId": "b526db15-0219-4460-b568-d36544eeb6fe",
      "externalId": "vector-mobile",
      "isOwned": true,
      "type": "apps",
      "name": "Вектор Мобайл",
      "url": "https://store.example/apps/vector-mobile"
    }
  ]
}

Пример запроса: физическое лицо

Для физических лиц ИНН двенадцатизначный, наименование - ФИО. Поле address формально необязательно, но без него не пройдут акты, где такое лицо выступает исполнителем (контроль I_227).

POST /api/v5.0/organizations

{
  "type": "fl",
  "isOrs": false,
  "isRr": false,
  "inn": "501181421074",
  "name": "Иванов Иван Иванович",
  "address": "Московская область, г. Примерный, ул. Полевая, д. 7, кв. 12"
}

Пример запроса: иностранное физическое лицо

ИНН и КПП не передаются, вместо них - код страны по ОКСМ и как минимум одно из полей mobilePhone / epayNumber.

POST /api/v5.0/organizations

{
  "type": "ffl",
  "isOrs": false,
  "isRr": false,
  "name": "Marko Nikolic",
  "oksmNumber": "688",
  "mobilePhone": "+38111234567",
  "epayNumber": "RS-EPAY-004512",
  "address": "Beograd, Knez Mihailova 15"
}

Пример запроса: иностранное юридическое лицо, оператор рекламной системы

Для isOrs = true обязателен rsUrl - сведения о рекламной системе.

POST /api/v5.0/organizations

{
  "type": "ful",
  "isOrs": true,
  "isRr": false,
  "name": "Danube Media d.o.o.",
  "oksmNumber": "688",
  "regNumber": "RS-21458800",
  "alternativeInn": "RS-108245771",
  "rsUrl": "https://ads.danube-media.example"
}

PUT /organizations/{id} - Обновление информации о контрагенте

Параметры запроса

Ответ

Изменение ИНН, типа и ряда реквизитов ограничено, если контрагент уже участвует в договорах с другой стороной с такими же реквизитами (ошибки формато-логического контроля O_77, O_81—O_84).

PUT заменяет объект целиком, а не дополняет его, поэтому в теле передаются все поля - и изменившиеся, и оставшиеся прежними. Так же работают методы обновления остальных сущностей.

PUT /api/v5.0/organizations/62ebd730-7549-42b2-aeaf-578ee82bb0fb

{
  "type": "ul",
  "isOrs": false,
  "isRr": false,
  "inn": "7705008280",
  "kpp": "770501001",
  "name": "ООО \"Ромашка\"",
  "address": "г. Москва, Примерный проезд, д. 4, оф. 301"
}

200 OK

{
  "id": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-08-14T09:41:02.318+03:00"
}

GET /organizations/{id} - Получение информации о контрагенте

Ответ: 200 - объект Organization; 4xx - объект Error.

GET /api/v5.0/organizations/62ebd730-7549-42b2-aeaf-578ee82bb0fb

200 OK

{
  "id": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "type": "ul",
  "isOrs": false,
  "isRr": false,
  "inn": "7705008280",
  "kpp": "770501001",
  "name": "ООО \"Ромашка\"",
  "address": "г. Москва, ул. Примерная, д. 1, оф. 5",
  "platforms": []
}

Статус объекта приходит и здесь - в заголовках ответа:

ORD-State: APPROVED
ORD-ERIR-Registered-At: 2026-08-01T13:22:11.007+03:00

HEAD /organizations/{id} - Получение статуса контрагента

Тела ответа нет, статус приходит в заголовках ORD-State, ORD-ERIR-Registered-At, ORD-ERIR-Error. Это самый дешёвый способ опросить статус: тело не передаётся вовсе.

HEAD /api/v5.0/organizations/62ebd730-7549-42b2-aeaf-578ee82bb0fb
Authorization: Bearer <token>

200 OK
ORD-State: APPROVED
ORD-ERIR-Registered-At: 2026-08-01T13:22:11.007+03:00

Если ЕРИР отклонил объект, причина будет в ORD-ERIR-Error:

200 OK
ORD-State: DECLINED
ORD-ERIR-Error: O_10: Неверный формат данных для ИНН

GET /organizations/{id}/status - Статус контрагента

То же самое, но в виде объекта Status.

Ответ: 200 - объект Status; 4xx - объект Error.

GET /api/v5.0/organizations/62ebd730-7549-42b2-aeaf-578ee82bb0fb/status

200 OK

{
  "id": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-08-01T13:22:11.007+03:00"
}

POST /organizations/{id} - Возобновление регистрации

Если после первой попытки регистрации (или обновления) сущности в ЕРИР её статус остался в значении PENDING (то есть возникла неперманентная ошибка), она отправляется в очередь для повторной отправки. Интервалы в очереди составляют один час и более.

Ответ: 200 - объект Status; 4xx - объект Error.

Тела у запроса нет:

POST /api/v5.0/organizations/62ebd730-7549-42b2-aeaf-578ee82bb0fb

200 OK

{
  "id": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "state": "ACCEPTED"
}

Эти четыре метода - GET, HEAD, GET /status, POST - устроены одинаково у всех сущностей: меняются только путь и тип объекта в ответе. Дальше в руководстве они не расписываются повторно.

POST /organizations/search - Список контрагентов

OrganizationFilter object

OrganizationSearchResponse object

OrganizationSearchItem object - агрегат контрагента и статуса

Пример запроса

POST /api/v5.0/organizations/search

{
  "type": ["ul"],
  "status": ["APPROVED"],
  "page": 1,
  "limit": 100,
  "sorting": ["-created"]
}

Пример ответа

200 OK

{
  "data": [
    {
      "organization": {
        "id": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
        "type": "ul",
        "isOrs": false,
        "isRr": true,
        "inn": "7732222893",
        "kpp": "773201001",
        "name": "ООО \"Вектор-Медиа\"",
        "address": "г. Москва, ул. Примерная, д. 14, стр. 2",
        "platforms": [
          {
            "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
            "externalId": "vector-news",
            "isOwned": true,
            "type": "site",
            "name": "Вектор Новости",
            "url": "https://news.vector.example"
          }
        ]
      },
      "entity": {
        "id": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
        "state": "APPROVED",
        "erirRegisteredAt": "2026-07-14T11:02:35.401+03:00"
      }
    },
    {
      "organization": {
        "id": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
        "type": "ul",
        "isOrs": false,
        "isRr": false,
        "inn": "7705008280",
        "kpp": "770501001",
        "name": "ООО \"Ромашка\"",
        "address": "г. Москва, ул. Примерная, д. 1, оф. 5",
        "platforms": []
      },
      "entity": {
        "id": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
        "state": "APPROVED",
        "erirRegisteredAt": "2026-08-01T13:22:11.007+03:00"
      }
    }
  ],
  "meta": { "page": 1, "limit": 100, "total": 2 }
}

GET /self-organization - Поставщик данных

Возвращает объект Organization, соответствующий вашей собственной организации - поставщику данных (тому, от чьего имени вы работаете с ОРД).

GET /api/v5.0/self-organization

200 OK

{
  "id": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "type": "ul",
  "isOrs": false,
  "isRr": true,
  "inn": "7732222893",
  "kpp": "773201001",
  "name": "ООО \"Вектор-Медиа\"",
  "address": "г. Москва, ул. Примерная, д. 14, стр. 2"
}

Формато-логический контроль

Ограничения на изменение: нельзя изменить ИНН, если в одном из договоров противоположной стороной является контрагент с таким же ИНН (O_77). Аналогичные ограничения - для реквизитов иностранных контрагентов (ошибки формато-логического контроля O_77, O_81—O_84).

Полный справочник кодов для объекта Контрагенты - в разделе Формато-логический контроль.

Площадка - сайт, приложение или информационная система, на которой размещается реклама. Площадки регистрируются либо вложенно, в составе контрагента (Organization.platforms), либо отдельными вызовами группы /platforms.

Platform object

Значения type

\* Значение is нельзя использовать при создании и редактировании, но оно может приходить в ответах для объектов, которые были заведены до введения этого ограничения.

PlatformListResponseItem object - агрегат площадки и статуса

POST /platforms - Регистрация площадки

POST /api/v5.0/platforms

{
  "externalId": "vector-news",
  "isOwned": true,
  "name": "Вектор Новости",
  "organizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "type": "site",
  "url": "https://news.vector.example"
}

202 Accepted

{
  "organizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
  "externalId": "vector-news",
  "type": "site",
  "isOwned": true,
  "name": "Вектор Новости",
  "url": "https://news.vector.example"
}

Для приложения указывается ссылка на карточку в магазине приложений:

POST /api/v5.0/platforms

{
  "externalId": "vector-mobile",
  "isOwned": true,
  "name": "Вектор Мобайл",
  "organizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "type": "apps",
  "url": "https://store.example/apps/vector-mobile"
}

Для Smart TV и HbbTV поле url не требуется:

POST /api/v5.0/platforms

{
  "externalId": "vector-tv",
  "isOwned": true,
  "name": "Вектор ТВ",
  "organizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "type": "smarttv"
}

PUT /platforms/{id} - Обновление площадки

В теле передаётся объект Platform. Ответ - объект Platform либо Error.

PUT /api/v5.0/platforms/7358025f-5674-44ea-9ab1-f342a486e939

{
  "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
  "organizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "externalId": "vector-news",
  "isOwned": true,
  "type": "site",
  "name": "Вектор Новости",
  "url": "https://news.vector.example/moscow"
}

Типичный повод для такого запроса - требование уточнить URL: раздел вместо домена верхнего уровня. Список таких площадок отдаёт GET /platforms/urls_needs_extension.

GET /platforms/{id}, HEAD /platforms/{id}, GET /platforms/{id}/status

Получение площадки, её наличия и статуса - устроено так же, как у контрагентов. 

GET  /api/v5.0/platforms/7358025f-5674-44ea-9ab1-f342a486e939
HEAD /api/v5.0/platforms/7358025f-5674-44ea-9ab1-f342a486e939
GET  /api/v5.0/platforms/7358025f-5674-44ea-9ab1-f342a486e939/status

Ответы: объект Platform, заголовки ORD-* без тела, объект Status.

POST /platforms/search - Список площадок

PlatformFilter object

Ответ: PlatformListResponse - data: PlatformListResponseItem[], meta: Pagination.

POST /api/v5.0/platforms/search

{
  "organizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "type": "site",
  "page": 1,
  "limit": 50
}

200 OK

{
  "data": [
    {
      "platform": {
        "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
        "organizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
        "externalId": "vector-news",
        "isOwned": true,
        "type": "site",
        "name": "Вектор Новости",
        "url": "https://news.vector.example"
      },
      "entity": {
        "id": "7358025f-5674-44ea-9ab1-f342a486e939",
        "state": "APPROVED",
        "erirRegisteredAt": "2026-07-14T11:03:12.882+03:00"
      }
    }
  ],
  "meta": { "page": 1, "limit": 50, "total": 1 }
}

GET /platforms/urls_needs_extension - URL, требующие уточнения

Возвращает список URL площадок, которые ЕРИР требует уточнить (например, указан домен верхнего уровня вместо конкретного раздела). По каждому такому URL необходимо обновить площадку методом PUT /platforms/{id}.

GET /api/v5.0/platforms/urls_needs_extension

200 OK

{ "data": ["https://news.vector.example", "https://store.example/apps/vector-mobile"] }

Формато-логический контроль

Полный справочник кодов для объекта Площадки - в разделе Формато-логический контроль.

Договор связывает двух контрагентов и определяет, кто, кому и за что оказывает услуги. К договору привязываются креативы и акты.

Contract object

Обязательные поля. type, date и isRegReport проверяются при каждом запросе: без них вернётся 400. Поле subjectType помечено обязательным в спецификации, но фактической проверки нет - ни на стороне ОРД, ни в требованиях ЕРИР. Заполняйте его по смыслу договора: оно попадает в отчётность.

Значения type

Значения actionType

Значения subjectType

POST /contracts - Регистрация договора

Пример запроса

POST /api/v5.0/contracts

{
  "type": "contract",
  "name": "Договор на размещение, лето 2026",
  "clientId": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "contractorId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "isRegReport": true,
  "actionType": "distribution",
  "subjectType": "org-distribution",
  "number": "123/26-02",
  "date": "2026-05-23",
  "amount": 1500000.00
}

Пример ответа

202 Accepted

{
  "id": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "state": "ACCEPTED",
  "erirRegisteredAt": "2026-05-23T13:25:50.052+03:00"
}

Пример: посреднический договор

Для типа intermediary-contract обязательно указывается agentActingForPublisher - в чью сторону идут деньги. Здесь агентство работает в интересах рекламодателя, поэтому признак false.

POST /api/v5.0/contracts

{
  "type": "intermediary-contract",
  "name": "Агентский договор с ООО \"Альфа Медиа\"",
  "clientId": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "contractorId": "b51c9ab7-993f-4573-a5e0-20ff7dfd7b37",
  "isRegReport": true,
  "actionType": "conclude",
  "subjectType": "mediation",
  "agentActingForPublisher": false,
  "isChargePaidByAgent": true,
  "number": "45/26",
  "date": "2026-01-12",
  "endDate": "2026-12-31",
  "amount": 5000000.00
}

Пример: дополнительное соглашение

У доп. соглашения заполняется contractId - идентификатор родительского договора. Стороны должны совпадать со сторонами родительского договора (контроль C_31).

POST /api/v5.0/contracts

{
  "type": "additional-agreement",
  "name": "ДС №1 к договору 123/26-02",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "clientId": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "contractorId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "isRegReport": true,
  "subjectType": "distribution",
  "number": "123/26-02-1",
  "date": "2026-06-01",
  "endDate": "2026-12-31",
  "amount": 300000.00
}

Пример: договор по ИНН вместо идентификаторов

Если контрагенты уже зарегистрированы, вместо clientId и contractorId можно передать их ИНН. Способы адресации не смешиваются: либо идентификаторы, либо ИНН.

POST /api/v5.0/contracts

{
  "type": "contract",
  "clientInn": "7705008280",
  "contractorInn": "7732222893",
  "isRegReport": true,
  "subjectType": "distribution",
  "number": "124/26-02",
  "date": "2026-06-15"
}

PUT /contracts/{id} - Обновление договора

В теле передаётся объект Contract. Ответ - объект Contract (short = false) либо Status (short = true).

PUT /api/v5.0/contracts/18abd2e0-7a4b-49cf-a287-f401fe98e192

{
  "type": "contract",
  "name": "Договор на размещение, лето 2026",
  "clientId": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
  "contractorId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "isRegReport": true,
  "actionType": "distribution",
  "subjectType": "org-distribution",
  "number": "123/26-02",
  "date": "2026-05-23",
  "endDate": "2027-05-22",
  "amount": 1800000.00
}

200 OK

{
  "id": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-08-14T10:05:44.912+03:00"
}

GET /contracts/{id}, HEAD /contracts/{id}, GET /contracts/{id}/status

Получение договора, проверка наличия, статус и принудительная синхронизация - устроены так же, как у контрагентов.

GET  /api/v5.0/contracts/18abd2e0-7a4b-49cf-a287-f401fe98e192
HEAD /api/v5.0/contracts/18abd2e0-7a4b-49cf-a287-f401fe98e192
GET  /api/v5.0/contracts/18abd2e0-7a4b-49cf-a287-f401fe98e192/status

Ответы: объект Contract, заголовки ORD-* без тела, объект Status, объект Status.

POST /contracts/search - Список договоров

ContractFilter object

Ответ: ContractSearchResponse - data: Contract[], meta: Pagination.

POST /api/v5.0/contracts/search

{
  "clientId": ["62ebd730-7549-42b2-aeaf-578ee82bb0fb"],
  "type": ["contract"],
  "status": ["APPROVED"],
  "page": 1,
  "limit": 20,
  "sorting": ["-date"]
}

200 OK

{
  "data": [
    {
      "id": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "type": "contract",
      "name": "Договор на размещение, лето 2026",
      "clientId": "62ebd730-7549-42b2-aeaf-578ee82bb0fb",
      "contractorId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
      "isRegReport": true,
      "actionType": "distribution",
      "subjectType": "org-distribution",
      "number": "123/26-02",
      "date": "2026-05-23",
      "endDate": "2026-12-31",
      "amount": 1500000.00,
      "cid": null,
      "contractId": null
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 }
}

Поиск по названию удобен, когда номера договоров у вас не уникальны: "nameContains": "лето 2026" вернёт все договоры, в названии которых встречается эта строка.

Идентификатор изначального договора (CID)

cid используется, когда договор в ОРД не регистрировался в вашем ЛК ОРД, но на него нужно ссылаться. Например, вы получили cid от другого участника цепочки, который зарегистрировал договор в своем ЛК ОРД.

POST /contracts/cid - Создать CID

POST /api/v5.0/contracts/cid

{ "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192" }

GET /api/v5.0/contracts/cid/18abd2e0-7a4b-49cf-a287-f401fe98e192

200 OK

{ "cid": "4e5edf88-fdae-418b-9162-12c348fcca96" }

GET /contracts/cid/{id} - Получить CID договора

Ответ: 200 - { "cid": "..." }; 4xx - объект Error.

POST /contracts/check_cid - Проверить наличие CID в ЕРИР

Проверка до регистрации креатива или акта: существует ли переданный вам cid в ЕРИР.

POST /api/v5.0/contracts/check_cid

{ "cid": "4e5edf88-fdae-418b-9162-12c348fcca96" }

Формато-логический контроль

Полный справочник кодов для объекта Договоры - в разделе Формато-логический контроль.

Креатив - рекламный материал, который размещается на площадке. Каждый креатив должен быть зарегистрирован в ЕРИР до начала размещения, в ответ ОРД выдаёт маркер (erid) - идентификатор, который показывается пользователю вместе с рекламой.

Динамическая товарная реклама регистрируется по другой модели - см. раздел Товарные фиды.

Маркировка креативов

Перед началом открутки креатив должен быть обязательно зарегистрирован в ЕРИР через ОРД. Маркер (erid) для креатива выдаёт ОРД.

Маркер возвращается в поле marker объектов Creative и Status только для креативов, зарегистрированных в ЕРИР, а также в заголовке ORD-Marker.

При изменении медиаданных креатива (правки в тексте или изображении, добавление эмодзи в пост и т.д.) требуется получение нового маркера через ОРД.

Creative object

Кобрендинг

contractId и cid - массивы. Если в массиве больше одного элемента, креатив считается кобрендинговым: один рекламный материал продвигает товары нескольких рекламодателей по разным договорам. Для кобрендингового креатива массив ktu может содержать несколько кодов; для обычного - ровно один (контроль CR_94).

Значения form

\* Значение other нельзя использовать при создании и редактировании, но оно может приходить в ответах для объектов, заведённых до введения этого ограничения.

Значения erirIdType

При создании и изменении креатива допустимы только значения MED и LONG; поле обязательно.

TargetAudience object - параметры целевой аудитории

CreativeData object - медиаданные креатива

Что передавать в creativeData для разных форм распространения

Состав медиаданных определяется значением form. В одном элементе creativeData заполняется либо textData, либо mediaUrl - если нужны оба, передайте два элемента.

Значения mediaUrlFileType

POST /creatives - Регистрация креатива

Пример запроса

POST /api/v5.0/creatives

{
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "name": "Летняя РК - текстовое объявление",
  "description": "Летняя распродажа спортивных товаров в магазине Ромашка",
  "erirIdType": "MED",
  "form": "text-block",
  "isSocial": false,
  "isSocialQuota": false,
  "selfPromotionOrganizationId": null,
  "ktu": ["30.15.1"],
  "creativeData": [
    { "externalId": "asset-1", "textData": "Летняя распродажа: скидки до 40 % на спортивные товары" }
  ],
  "targetAudience": {
    "age": ["20:25"],
    "geo": ["16", "50"],
    "sex": ["male"]
  },
  "url": ["https://romashka.example/summer"]
}

Пример ответа (short = true)

202 Accepted

{
  "id": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-08-01T13:20:50.052+03:00",
  "marker": "2Ranyn7YfuE"
}

Пример: баннер с изображением

У форм banner, video, audio-rec текстовых данных нет - передаётся только mediaUrl. ОРД скачает файл по этой ссылке, поэтому она должна быть доступна без авторизации на момент запроса.

POST /api/v5.0/creatives

{
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "name": "Летняя РК - баннер 970x250",
  "description": "Кроссовки беговые, весенне-летняя коллекция",
  "erirIdType": "MED",
  "form": "banner",
  "isSocial": false,
  "isSocialQuota": false,
  "ktu": ["1.2.1"],
  "creativeData": [
    {
      "externalId": "banner-970x250",
      "mediaUrl": "https://cdn.example/creatives/summer-970x250.jpg",
      "mediaUrlFileType": "image"
    }
  ],
  "targetAudience": {
    "age": ["25:45"],
    "geo": ["77", "50"]
  },
  "url": ["https://romashka.example/summer"]
}

202 Accepted

{
  "id": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
  "state": "MEDIA LOADING"
}

Маркера в ответе пока нет: он появится, когда медиафайл загрузится и креатив зарегистрируется в ЕРИР. Опрашивайте GET /creatives/{id}/status, пока state не станет ACCEPTED или APPROVED.

GET /api/v5.0/creatives/e524575d-6fc6-48c9-a38c-2de2d0543dab/status

200 OK

{
  "id": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-06-24T18:03:29.114+03:00",
  "marker": "2RanynT4kQm"
}

Пример: кобрендинговый креатив

Один материал продвигает товары двух рекламодателей, поэтому в contractId - два договора с разными рекламодателями, а в ktu - по коду на каждую категорию (контроль CR_94 требует ровно один код только для некобрендинговых креативов).

POST /api/v5.0/creatives

{
  "contractId": [
    "18abd2e0-7a4b-49cf-a287-f401fe98e192",
    "c8d34a17-2f06-4b91-9ad5-71e0b2c4f8a3"
  ],
  "name": "Совместная акция - видеоролик",
  "description": "Совместная акция: верхняя одежда и спортивная обувь",
  "erirIdType": "MED",
  "form": "video",
  "isSocial": false,
  "isSocialQuota": false,
  "ktu": ["1.1.2", "1.2.1"],
  "creativeData": [
    {
      "externalId": "video-15s",
      "mediaUrl": "https://cdn.example/creatives/joint-promo-15s.mp4",
      "mediaUrlFileType": "video"
    }
  ],
  "url": ["https://romashka.example/joint-promo"]
}

Пример: саморекламный креатив

Реклама собственных товаров идёт без договора: вместо contractId указывается selfPromotionOrganizationId.

POST /api/v5.0/creatives

{
  "selfPromotionOrganizationId": "4fb32ac9-0eb0-418c-81b4-a9b2cd53009a",
  "name": "Промо подписки",
  "description": "Подписка на новостной сервис",
  "erirIdType": "MED",
  "form": "text-graphic-block",
  "isSocial": false,
  "isSocialQuota": false,
  "ktu": ["30.15.1"],
  "creativeData": [
    { "textData": "Подписка на Вектор Новости - первый месяц бесплатно" },
    {
      "mediaUrl": "https://cdn.example/creatives/subscription-banner.png",
      "mediaUrlFileType": "image"
    }
  ],
  "url": ["https://news.vector.example/subscribe"]
}

Форма text-graphic-block требует и текст, и изображение. В одном элементе creativeData заполняется что-то одно, поэтому элементов два.

PUT /creatives/{id} - Обновление креатива

В URI допускается указывать id либо маркер. В теле передаётся объект Creative.

PUT /api/v5.0/creatives/2RanynT4kQm

{
  "marker": "2RanynT4kQm",
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "name": "Летняя РК - баннер 970x250",
  "description": "Кроссовки беговые, весенне-летняя коллекция",
  "erirIdType": "MED",
  "form": "banner",
  "isSocial": false,
  "isSocialQuota": false,
  "ktu": ["1.2.1"],
  "creativeData": [
    {
      "externalId": "banner-970x250",
      "mediaUrl": "https://cdn.example/creatives/summer-970x250.jpg",
      "mediaUrlFileType": "image"
    }
  ],
  "url": [
    "https://romashka.example/summer",
    "https://romashka.example/summer/sneakers"
  ]
}

Новый маркер нужен только при изменении медиаданных. Для остальных правок - целевых ссылок, названия, описания, таргетинга - маркер остаётся прежним.

GET /creatives/{id}, HEAD /creatives/{id}, GET /creatives/{id}/status

Получение креатива, проверка наличия и статус. В пути допустим как id, так и маркер.

GET  /api/v5.0/creatives/e524575d-6fc6-48c9-a38c-2de2d0543dab
GET  /api/v5.0/creatives/2RanynT4kQm
HEAD /api/v5.0/creatives/e524575d-6fc6-48c9-a38c-2de2d0543dab
GET  /api/v5.0/creatives/e524575d-6fc6-48c9-a38c-2de2d0543dab/status

Ответы: объект Creative, он же, заголовки ORD-* без тела, объект Status.

POST /creatives/search - Список креативов

CreativeFilter object

Ответ: CreativeSearchResponse - data: Creative[], meta: Pagination.

POST /api/v5.0/creatives/search

{
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "status": ["APPROVED"],
  "page": 1,
  "limit": 20,
  "sorting": ["-created"]
}

200 OK

{
  "data": [
    {
      "id": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
      "marker": "2RanynT4kQm",
      "erirIdType": "MED",
      "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
      "cid": null,
      "selfPromotionOrganizationId": null,
      "name": "Летняя РК - баннер 970x250",
      "description": "Кроссовки беговые, весенне-летняя коллекция",
      "form": "banner",
      "isSocial": false,
      "isSocialQuota": false,
      "ktu": ["1.2.1"],
      "url": ["https://romashka.example/summer"],
      "targetAudience": { "age": ["25:45"], "geo": ["77", "50"], "sex": null },
      "creativeData": [
        {
          "externalId": "banner-970x250",
          "textData": null,
          "mediaUrl": "https://cdn.example/creatives/summer-970x250.jpg",
          "mediaUrlFileType": "image"
        }
      ]
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 }
}

Фильтр adsStatus помогает найти креативы, по которым пора подавать статистику: actual - откручиваются, stopped - сняты с публикации, expired - срок размещения истёк.

POST /creatives/stop_publication - Снятие креатива с публикации

Метод предназначен для управления статусом креатива в случаях, когда он был удалён из сети или зарегистрирован в Личном кабинете, но не был опубликован в сети. 

Важно: информация о снятии с публикации используется только в Личном кабинете ОРД и не передаётся в ЕРИР.

Признак neverPublished закрывает частый случай: маркер получен "про запас", но размещение не состоялось. Раньше такой креатив приходилось снимать датой, что искажало отчётность.

POST /api/v5.0/creatives/stop_publication

{
  "creativeId": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
  "neverPublished": true
}

Ответ: 200 OK с пустым телом; 400, 404, 500 - объект Error.

POST /creatives/resume_publication - Возобновление публикации креатива

Метод отменяет ранее выполненное снятие с публикации: креатив снова считается откручивающимся, и по нему снова можно подавать статистику.

POST /api/v5.0/creatives/resume_publication

{
  "creativeId": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
  "resumePublicationDate": "2026-09-01"
}

Ответ: 200 OK с пустым телом; 400, 404, 500 - объект Error.

Формато-логический контроль

Медиаданные креатива (CreativeData)

Полный справочник кодов для объекта Креативы - в разделе Формато-логический контроль.

Что такое товарный фид

Товарный фид - это способ маркировки динамической товарной рекламы, когда одно рекламное место показывает разные товары разным пользователям. Регистрировать каждую комбинацию как отдельный креатив невозможно, поэтому ЕРИР предусматривает двухуровневую модель.

Товарный фид представляет собой определённый тип креатива, который состоит из элементов фида и контейнера:

• Элемент фида - карточка одного товара: его описание, ссылка, изображение. Маркер элементам не выдаётся.
• Контейнер - техническая сущность, которая объединяет элементы и привязывает их к договору. Маркер (erid) выдаётся именно контейнеру и указывается в рекламном блоке.

Контейнер и элементы объединяются идентификатором feedId. Он генерируется на стороне клиента (UUID v4).

Порядок работы:

1. Сгенерировать feedId (UUID v4).
2. Зарегистрировать элементы фида: POST /creatives/feeds/element или пакетно POST /creatives/feeds/element/batch.
3. Зарегистрировать контейнер с тем же feedId: POST /creatives/feeds/container - в ответе придёт маркер.

Важно. Контейнер с определённым feedId не может быть зарегистрирован в ЕРИР, пока там нет ни одного элемента фида с тем же feedId (контроль CR_30). Отправлять контейнер сразу вслед за элементами при этом можно: он подождёт их в очереди (см. Ожидание зависимостей в общем разделе). Для каждого feedId может быть создано несколько контейнеров - например, если один и тот же набор товаров размещается по разным договорам.

Ограничение, вытекающее из модели:

• для элемента фида нельзя передавать в статистику (POST /creative-statistics, контроль S_47) и в связку акта с креативом (контроль IC_28) - там указывается контейнер.

FeedContainer object - Контейнер товарного фида

Значения form - те же, что у обычного креатива (см. раздел "Креативы").

FeedContainerTargetAudience object

FeedElement object - Элемент товарного фида

FeedElementData object

POST /creatives/feeds/element - Создать элемент товарного фида

Параметры запроса

Пример запроса

POST /api/v5.0/creatives/feeds/element

{
  "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
  "description": "Кроссовки беговые, модель X",
  "ktu": ["1.2.1"],
  "url": ["https://shop.example/catalog/sneakers-x"],
  "creativeData": [
    {
      "externalId": "sku-10045",
      "mediaUrl": "https://cdn.example/img/sneakers-x.jpg",
      "mediaUrlFileType": "image"
    }
  ]
}

Пример ответа

202 Accepted

{
  "id": "9e55eb19-8e53-439e-b312-f7d268b8aadb",
  "state": "PENDING"
}

POST /creatives/feeds/element/batch - Создать элементы товарного фида пакетом

Регистрирует до 100 элементов одним запросом. Ответ содержит результат по каждому элементу в том же порядке: либо созданный объект, либо ошибку по нему. Если элементов больше, разбейте их на несколько запросов.

Тело запроса - BatchFeedElements

Ответ - BatchFeedElementsResponse

BatchFeedElementsResponseItem

Пример запроса

POST /api/v5.0/creatives/feeds/element/batch

{
  "feedElements": [
    {
      "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
      "description": "Кроссовки беговые, модель X",
      "ktu": ["1.2.1"],
      "url": ["https://shop.example/catalog/sneakers-x"],
      "creativeData": [
        { "mediaUrl": "https://cdn.example/img/sneakers-x.jpg", "mediaUrlFileType": "image" }
      ]
    },
    {
      "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
      "description": "Куртка ветрозащитная, модель Y",
      "ktu": ["1.1.2"],
      "url": ["https://shop.example/catalog/jacket-y"],
      "creativeData": [
        { "textData": "Куртка ветрозащитная Y - новая коллекция" }
      ]
    }
  ]
}

Пример ответа с частичной ошибкой

201 Created

{
  "feedElements": [
    {
      "feedElement": {
        "id": "9e55eb19-8e53-439e-b312-f7d268b8aadb",
        "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
        "description": "Кроссовки беговые, модель X"
      }
    },
    {
      "error": {
        "requestId": "0e29c0f6-6d5e-4a30-9f5a-2f4d2b2a1f77",
        "status": 400,
        "code": "parameter-error",
        "title": "invalid parameter value",
        "detail": "CR_96: Не найден код в справочнике ККТУ"
      }
    }
  ]
}

Обрабатывайте ответ поэлементно: успешные элементы уже зарегистрированы, повторно отправлять нужно только те, по которым вернулась ошибка.

PUT /creatives/feeds/element/{id} - Изменить элемент товарного фида

Товар подорожал или сменилась картинка - элемент обновляется, feedId остаётся прежним. Маркер контейнера при этом не меняется.

PUT /api/v5.0/creatives/feeds/element/9e55eb19-8e53-439e-b312-f7d268b8aadb

{
  "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
  "description": "Кроссовки беговые, модель X, новая расцветка",
  "ktu": ["1.2.1"],
  "url": ["https://shop.example/catalog/sneakers-x"],
  "creativeData": [
    {
      "externalId": "sku-10045",
      "mediaUrl": "https://cdn.example/img/sneakers-x-blue.jpg",
      "mediaUrlFileType": "image"
    }
  ]
}

GET /creatives/feeds/element/{id}, HEAD /creatives/feeds/element/{id}, GET /creatives/feeds/element/{id}/status

Получение элемента, проверка наличия и статус.

GET  /api/v5.0/creatives/feeds/element/9e55eb19-8e53-439e-b312-f7d268b8aadb
HEAD /api/v5.0/creatives/feeds/element/9e55eb19-8e53-439e-b312-f7d268b8aadb
GET  /api/v5.0/creatives/feeds/element/9e55eb19-8e53-439e-b312-f7d268b8aadb/status

Ответы: объект FeedElement, заголовки ORD-* без тела, объект Status. Маркера у элемента нет - он есть только у контейнера.

POST /creatives/feeds/element/search - Список элементов товарных фидов

FeedElementFilter object

Ответ: FeedElementSearchResponse - data: FeedElement[], meta: Pagination.

POST /api/v5.0/creatives/feeds/element/search

{
  "feedId": ["78b1307a-b0ad-4cb6-a0bd-c7ddef242b12"],
  "status": ["APPROVED"],
  "page": 1,
  "limit": 100
}

200 OK

{
  "data": [
    {
      "id": "9e55eb19-8e53-439e-b312-f7d268b8aadb",
      "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
      "description": "Кроссовки беговые, модель X",
      "ktu": ["1.2.1"],
      "url": ["https://shop.example/catalog/sneakers-x"],
      "creativeData": [
        {
          "externalId": "sku-10045",
          "textData": null,
          "mediaUrl": "https://cdn.example/img/sneakers-x.jpg",
          "mediaUrlFileType": "image"
        }
      ]
    }
  ],
  "meta": { "page": 1, "limit": 100, "total": 1 }
}

POST /creatives/feeds/container - Создать контейнер товарного фида

Пример запроса

POST /api/v5.0/creatives/feeds/container

{
  "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "description": "Товарная витрина интернет-магазина",
  "form": "banner",
  "isSocial": false,
  "isSocialQuota": false,
  "ktu": ["1.1.2", "1.2.1"]
}

Пример ответа (short = false)

202 Accepted

{
  "id": "0e91c3fe-9056-4cbb-812c-e2b2e63dacdd",
  "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "description": "Товарная витрина интернет-магазина",
  "targetAudience": { "age": null, "geo": null, "sex": null },
  "isSocial": false,
  "isSocialQuota": false,
  "selfPromotionOrganizationId": null,
  "cid": null,
  "marker": "2RanyoGXu92",
  "form": "banner",
  "ktu": ["1.1.2"]
}

Пример ответа (short = true)

202 Accepted

{
  "id": "0e91c3fe-9056-4cbb-812c-e2b2e63dacdd",
  "state": "PENDING",
  "marker": "2RanyoGXu92"
}

PUT /creatives/feeds/container/{id} - Изменить контейнер товарного фида

PUT /api/v5.0/creatives/feeds/container/0e91c3fe-9056-4cbb-812c-e2b2e63dacdd

{
  "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "description": "Товарная витрина интернет-магазина, осенняя коллекция",
  "form": "banner",
  "isSocial": false,
  "isSocialQuota": false,
  "ktu": ["1.1.2", "1.2.1"],
  "targetAudience": {
    "age": ["25:45"],
    "geo": ["77"]
  }
}

GET /creatives/feeds/container/{id}, HEAD /creatives/feeds/container/{id}, GET /creatives/feeds/container/{id}/status

Получение контейнера, проверка наличия и статус.

GET  /api/v5.0/creatives/feeds/container/0e91c3fe-9056-4cbb-812c-e2b2e63dacdd
HEAD /api/v5.0/creatives/feeds/container/0e91c3fe-9056-4cbb-812c-e2b2e63dacdd
GET  /api/v5.0/creatives/feeds/container/0e91c3fe-9056-4cbb-812c-e2b2e63dacdd/status

Ответы: объект FeedContainer, заголовки ORD-* без тела (включая ORD-Marker), объект Status с маркером.

POST /creatives/feeds/container/search - Список контейнеров товарных фидов

FeedContainerFilter object

Ответ: FeedContainerSearchResponse - data: FeedContainer[], meta: Pagination.

POST /api/v5.0/creatives/feeds/container/search

{
  "feedId": ["78b1307a-b0ad-4cb6-a0bd-c7ddef242b12"],
  "page": 1,
  "limit": 20
}

200 OK

{
  "data": [
    {
      "id": "0e91c3fe-9056-4cbb-812c-e2b2e63dacdd",
      "feedId": "78b1307a-b0ad-4cb6-a0bd-c7ddef242b12",
      "marker": "2RanyoGXu92",
      "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
      "cid": null,
      "selfPromotionOrganizationId": null,
      "description": "Товарная витрина интернет-магазина",
      "form": "banner",
      "isSocial": false,
      "isSocialQuota": false,
      "ktu": ["1.1.2", "1.2.1"],
      "targetAudience": { "age": null, "geo": null, "sex": null }
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 }
}

Формато-логический контроль

Товарные фиды используют тот же набор контролей, что и обычные креативы (префикс CR_), с дополнительными правилами для двухуровневой модели.

Дополнительно за пределами группы /creatives/feeds:

• элемент фида запрещено передавать в статистику (контроль S_47);
• элемент фида запрещено передавать в связку акта с креативом (контроль IC_28).

Полный справочник кодов для объекта Креативы - в разделе Формато-логический контроль.

Акт - документ, которым закрывается период оказания рекламных услуг по договору за период. 

Данные по актам необходимо регистрировать в течение 30 дней после его получения.

Статистику можно передавать двумя способами: внутри акта (/invoices/with-statistic) либо отдельно (/creative-statistics, см. раздел "Статистика выполнения РК"). Какой способ выбрать - ниже.

Логика работы с актами и статистикой

Предполагается три сценария работы:

1. Акты раз в месяц. Если акты формируются раз в месяц, так же как и статистика, рекомендуется передавать статистику вместе с актом через POST /invoices/with-statistic.
2. Акты реже, чем раз в месяц (например, квартальный акт):
   • в течение 30 дней с момента окончания месяца направлять статистику по каждому креативу по каждой площадке за весь период через POST /creative-statistics;
   • по составлении акта в конце периода зарегистрировать его через POST /invoices;
   • зарегистрировать связку акта с креативом, указав каждый креатив по каждому изначальному договору, через POST /invoices/creatives. Дожидаться, пока акт получит APPROVED, не нужно: связка сама подождёт акт (см. "Ожидание зависимостей" в общем разделе).
3. Акты чаще, чем раз в месяц (например, раз в неделю):
   • по составлении каждого акта он регистрируется в ЕРИР через POST /invoices;
   • в течение 30 дней после окончания отчётного периода регистрируется статистика через POST /creative-statistics;
   • регистрируются связки каждого акта с креативом через POST /invoices/creatives.

Invoice object - Акт

Объект используется методами группы /invoices (акт без статистики). Объект InvoiceWithStatistic группы /invoices/with-statistic отличается только тем, что в items[].creatives[] дополнительно передаётся статистика открутки.

Значения type

Тип акта жёстко связан с типом договора:

• по договору contract и доп. соглашениям к нему подаётся акт invoice (контроль I_125);
• по договору intermediary-contract и доп. соглашениям к нему - intermediary-report либо commission-invoice (контроль I_126).

Подробный сценарий работы с commission-invoice - в разделе "Сценарии: посреднические акты".

Значения clientRole и contractorRole

InvoiceAmount object - Сведения о суммах акта

InvoiceAmountServices object

Для типа commission-invoice поля excludingVat, vatRate, vat, includingVat блока services не передаются - в этом акте есть только вознаграждение (контроли I_192, I_193, I_195, I_197).

InvoiceAmountCommission object

Логика isInvoice в отчёте посредника:

• isInvoice = false или не передан - вознаграждение включено в этот же отчёт, поэтому суммы excludingVat, vatRate, vat, includingVat обязательны (контроли I_199, I_201, I_203, I_205);
• isInvoice = true - вознаграждение будет подано отдельным актом commission-invoice, поэтому те же поля передавать запрещено (контроли I_200, I_202, I_204, I_206).

Отличие от v4. Поля amount.commission.number и amount.commission.date в v5.0 удалены: номер и дата акта на вознаграждение теперь берутся из полей number и date отдельного акта commission-invoice.

InvoiceItem object - Разаллокация акта

InvoiceItemAmount object

InvoiceItemWithStatistic object

Используется в /invoices/with-statistic. Дополняет InvoiceItem разаллокацией по креативам:

InvoiceItemCreative object

InvoiceItemCreativePlatform object

Значения campaignType

InvoiceItemCreativePlatformAmount object

POST /invoices - Регистрация акта

Пример запроса

POST /api/v5.0/invoices

{
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "number": "act-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "rr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    }
  },
  "items": [
    {
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 81967.21,
        "vatRate": 22.00,
        "vat": 18032.79,
        "includingVat": 100000.00
      }
    }
  ]
}

Пример ответа

202 Accepted

{
  "id": "7a459159-c38e-4f9a-a726-d209031111cb",
  "state": "ACCEPTED",
  "erirRegisteredAt": "2026-08-05T21:26:18+03:00"
}

PUT /invoices/{id} - Обновление акта

В теле передаётся объект Invoice. Ответ - объект Invoice (short = false) либо Status (short = true).

PUT /api/v5.0/invoices/7a459159-c38e-4f9a-a726-d209031111cb

{
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "number": "act-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "rr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 90163.93,
      "vatRate": 22.00,
      "vat": 19836.07,
      "includingVat": 110000.00
    }
  },
  "items": [
    {
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 90163.93,
        "vatRate": 22.00,
        "vat": 19836.07,
        "includingVat": 110000.00
      }
    }
  ]
}

Ошибочно поданный акт не удаляется, а помечается неактуальным - для этого достаточно передать irRelevant:

PUT /api/v5.0/invoices/7a459159-c38e-4f9a-a726-d209031111cb

{
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "number": "act-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "irRelevant": true,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    }
  }
}

При irRelevant = true роли сторон не требуются - это единственный случай, когда clientRole и contractorRole можно не передавать.

PUT /invoices/upsert - Создать или изменить акт

Идемпотентный метод: если акт с переданным идентификатором уже существует, он будет обновлён, иначе - создан. Удобен для повторной выгрузки без предварительной проверки существования.

Ответ: 200 (обновлён), 201 (создан) либо 202 (принят, ответ ЕРИР не получен).

Поле id здесь обязательно и должно быть корректным UUID v4 - без него метод вернёт 400. Именно по нему принимается решение: акт с таким идентификатором есть - обновляем, нет - создаём с этим же идентификатором. Это единственная группа методов, где идентификатор задаёт клиент; сгенерируйте его на своей стороне и сохраните, чтобы повторная выгрузка того же акта не создала дубликат.

PUT /api/v5.0/invoices/upsert

{
  "id": "7a459159-c38e-4f9a-a726-d209031111cb",
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "number": "act-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "rr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    }
  },
  "items": [
    {
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 81967.21,
        "vatRate": 22.00,
        "vat": 18032.79,
        "includingVat": 100000.00
      }
    }
  ]
}

200 OK

{
  "id": "7a459159-c38e-4f9a-a726-d209031111cb",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-08-06T12:11:03.560+03:00"
}

GET /invoices/{id}, HEAD /invoices/{id}, GET /invoices/{id}/status

Получение акта, проверка наличия, статус и принудительная синхронизация.

GET  /api/v5.0/invoices/7a459159-c38e-4f9a-a726-d209031111cb
HEAD /api/v5.0/invoices/7a459159-c38e-4f9a-a726-d209031111cb
GET  /api/v5.0/invoices/7a459159-c38e-4f9a-a726-d209031111cb/status

Ответы: объект Invoice, заголовки ORD-* без тела, объект Status, объект Status.

Те же четыре запроса по пути /invoices/with-statistic/{id} вернут акт вместе со статистикой:

GET  /api/v5.0/invoices/with-statistic/7a459159-c38e-4f9a-a726-d209031111cb
HEAD /api/v5.0/invoices/with-statistic/7a459159-c38e-4f9a-a726-d209031111cb
GET  /api/v5.0/invoices/with-statistic/7a459159-c38e-4f9a-a726-d209031111cb/status

POST /invoices/search - Список актов

InvoiceFilter object

Ответ: InvoiceSearchResponse - data: Invoice[], meta: Pagination.

POST /api/v5.0/invoices/search

{
  "contractId": ["18abd2e0-7a4b-49cf-a287-f401fe98e192"],
  "type": "invoice",
  "status": ["APPROVED"],
  "page": 1,
  "limit": 50,
  "sorting": ["-date"]
}

200 OK

{
  "data": [
    {
      "id": "7a459159-c38e-4f9a-a726-d209031111cb",
      "type": "invoice",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "number": "act-2026-07",
      "date": "2026-08-05",
      "startDate": "2026-07-01",
      "endDate": "2026-07-31",
      "clientRole": "rd",
      "contractorRole": "rr",
      "isSocial": false,
      "isSocialQuota": false,
      "irRelevant": false,
      "rrOrderContractIdList": null,
      "amount": {
        "services": {
          "excludingVat": 81967.21,
          "vatRate": 22.00,
          "vat": 18032.79,
          "includingVat": 100000.00,
          "intermediaryReportIdList": null
        },
        "commission": null
      },
      "items": [
        {
          "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
          "cid": null,
          "isSocial": false,
          "isSocialQuota": false,
          "amount": {
            "excludingVat": 81967.21,
            "vatRate": 22.00,
            "vat": 18032.79,
            "includingVat": 100000.00
          }
        }
      ]
    }
  ],
  "meta": { "page": 1, "limit": 50, "total": 1 }
}

Чтобы найти акты на вознаграждение, укажите "type": "commission-invoice".

Акты со статистикой

Группа /invoices/with-statistic работает с объектом InvoiceWithStatistic - актом, внутри которого сразу передана вся статистика открутки.

Метод upsert этой группы, как и PUT /invoices/upsert, требует, чтобы id акта передал клиент.

Пример запроса

POST /api/v5.0/invoices/with-statistic

{
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "number": "act-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "rr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    }
  },
  "items": [
    {
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 81967.21,
        "vatRate": 22.00,
        "vat": 18032.79,
        "includingVat": 100000.00
      },
      "creatives": [
        {
          "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
          "platforms": [
            {
              "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
              "campaignType": "cpm",
              "impsPlan": 100000,
              "impsFact": 98450,
              "dateStartPlan": "2026-07-01",
              "dateEndPlan": "2026-07-31",
              "dateStartFact": "2026-07-01",
              "dateEndFact": "2026-07-31",
              "amountPerShow": 0.83258,
              "amount": {
                "excludingVat": 81967.21311,
                "vatRate": 22.00,
                "vat": 18032.78689,
                "includingVat": 100000.00000
              }
            }
          ]
        }
      ]
    }
  ]
}

Пример ответа

202 Accepted

{
  "id": "7a459159-c38e-4f9a-a726-d209031111cb",
  "state": "ACCEPTED",
  "erirRegisteredAt": "2026-08-05T21:26:18+03:00"
}

Отдельных идентификаторов у статистики здесь не появляется: она хранится внутри акта. Если статистику нужно адресовать самостоятельно - подавайте её через /creative-statistics.

Изменение акта со статистикой

PUT заменяет акт целиком вместе со статистикой: массив creatives передаётся полностью, а не только изменившиеся строки. Ниже уточнён фактический объём показов.

PUT /api/v5.0/invoices/with-statistic/7a459159-c38e-4f9a-a726-d209031111cb

{
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "number": "act-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "rr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    }
  },
  "items": [
    {
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 81967.21,
        "vatRate": 22.00,
        "vat": 18032.79,
        "includingVat": 100000.00
      },
      "creatives": [
        {
          "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
          "platforms": [
            {
              "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
              "campaignType": "cpm",
              "impsPlan": 100000,
              "impsFact": 99870,
              "dateStartPlan": "2026-07-01",
              "dateEndPlan": "2026-07-31",
              "dateStartFact": "2026-07-01",
              "dateEndFact": "2026-07-31",
              "amountPerShow": 0.82074,
              "amount": {
                "excludingVat": 81967.21311,
                "vatRate": 22.00,
                "vat": 18032.78689,
                "includingVat": 100000.00000
              }
            }
          ]
        }
      ]
    }
  ]
}

Создание или изменение акта со статистикой

PUT /invoices/with-statistic/upsert принимает тот же объект, но с обязательным id, который задаёт клиент, - правило то же, что у PUT /invoices/upsert.

PUT /api/v5.0/invoices/with-statistic/upsert

{
  "id": "7a459159-c38e-4f9a-a726-d209031111cb",
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "number": "act-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "rr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    }
  },
  "items": [
    {
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 81967.21,
        "vatRate": 22.00,
        "vat": 18032.79,
        "includingVat": 100000.00
      },
      "creatives": [
        {
          "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
          "platforms": [
            {
              "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
              "campaignType": "cpm",
              "impsPlan": 100000,
              "impsFact": 99870,
              "dateStartPlan": "2026-07-01",
              "dateEndPlan": "2026-07-31",
              "dateStartFact": "2026-07-01",
              "dateEndFact": "2026-07-31",
              "amountPerShow": 0.82074,
              "amount": {
                "excludingVat": 81967.21311,
                "vatRate": 22.00,
                "vat": 18032.78689,
                "includingVat": 100000.00000
              }
            }
          ]
        }
      ]
    }
  ]
}

200 OK

{
  "id": "7a459159-c38e-4f9a-a726-d209031111cb",
  "state": "APPROVED",
  "erirRegisteredAt": "2026-08-06T12:14:52.318+03:00"
}

Суммы в акте и в статистике связаны: amount по всем площадкам и креативам одного элемента items должна сходиться с суммой самого элемента. В примере amountPerShow рассчитана как сумма без НДС, делённая на число фактических показов: 81 967,21311 / 98 450 = 0,83258 руб. с округлением до пяти знаков.

Формато-логический контроль

Ставки НДС в переходный период

Полный справочник кодов для объекта Акты - в разделе Формато-логический контроль.

Статистика — данные о количестве показов рекламного креатива, зафиксированные в результате его демонстрации на рекламных площадках за отчетный период. Статистика подлежит регистрации в ЕРИР в течение 30 календарных дней, следующих за месяцем показа креатива.

Если статистика подаётся отдельно от акта, используется группа /creative-statistics.

CreativeStatistic object

Отличие от v4. Поле irRelevant в объекте статистики удалено. Для исключения ошибочно поданной статистики используйте DELETE /creative-statistics/{id}.

CreativeStatisticAmount object

POST /creative-statistics - Передача статистики

В теле передаётся объект CreativeStatistics - обёртка с массивом statistics.

POST /api/v5.0/creative-statistics

{
  "statistics": [
    {
      "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
      "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
      "campaignType": "cpa",
      "impsPlan": 101,
      "impsFact": 100,
      "dateStartPlan": "2026-07-12",
      "dateEndPlan": "2026-07-26",
      "dateStartFact": "2026-07-10",
      "dateEndFact": "2026-07-25",
      "amountPerShow": 0.81967,
      "amount": {
        "excludingVat": 81.96721,
        "vatRate": 22.00,
        "vat": 18.03279,
        "includingVat": 100.00000
      }
    }
  ]
}

202 Accepted

{
  "statuses": [
    {
      "id": "7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1",
      "state": "ACCEPTED",
      "erirRegisteredAt": "2026-08-05T20:15:12+03:00"
    }
  ]
}

В этом примере статистика подана без привязки к акту: акт ещё не зарегистрирован, связь будет установлена позже через POST /invoices/creatives. Если акт уже есть, укажите его сразу - тогда отдельная связка не понадобится:

POST /api/v5.0/creative-statistics

{
  "statistics": [
    {
      "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
      "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "campaignType": "cpm",
      "impsPlan": 100000,
      "impsFact": 98450,
      "dateStartPlan": "2026-07-01",
      "dateEndPlan": "2026-07-31",
      "dateStartFact": "2026-07-01",
      "dateEndFact": "2026-07-31",
      "amountPerShow": 0.83258,
      "amount": {
        "excludingVat": 81967.21311,
        "vatRate": 22.00,
        "vat": 18032.78689,
        "includingVat": 100000.00000
      }
    }
  ]
}

Одним запросом можно передать статистику сразу по нескольким креативам и площадкам - массив statistics не ограничен одним элементом. Учтите ограничение частоты вызовов: метод относится к "тяжёлым".

PUT /creative-statistics/upsert - Создать или изменить статистику

Принимает тот же объект CreativeStatistics. Элементы, уже существующие в ОРД, обновляются, остальные создаются.

Поле id обязательно для каждого элемента массива и должно быть корректным UUID v4 - как и в PUT /invoices/upsert, его задаёт клиент. Есть элемент с таким идентификатором - он обновляется, нет - создаётся. Удобно, когда открутка продолжается и цифры за период уточняются: тот же запрос отправляется повторно с новыми значениями.

PUT /api/v5.0/creative-statistics/upsert

{
  "statistics": [
    {
      "id": "7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1",
      "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
      "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "campaignType": "cpm",
      "impsPlan": 100000,
      "impsFact": 99870,
      "dateStartPlan": "2026-07-01",
      "dateEndPlan": "2026-07-31",
      "dateStartFact": "2026-07-01",
      "dateEndFact": "2026-07-31",
      "amountPerShow": 0.82074,
      "amount": {
        "excludingVat": 81967.21311,
        "vatRate": 22.00,
        "vat": 18032.78689,
        "includingVat": 100000.00000
      }
    }
  ]
}

200 OK

{
  "statuses": [
    {
      "id": "7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1",
      "state": "APPROVED",
      "erirRegisteredAt": "2026-08-06T09:30:41+03:00"
    }
  ]
}

PUT /creative-statistics/{id} - Обновление одного элемента статистики

В теле передаётся объект CreativeStatistic - без обёртки statistics.

PUT /api/v5.0/creative-statistics/7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1

{
  "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
  "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
  "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "campaignType": "cpm",
  "impsPlan": 100000,
  "impsFact": 99870,
  "dateStartPlan": "2026-07-01",
  "dateEndPlan": "2026-07-31",
  "dateStartFact": "2026-07-01",
  "dateEndFact": "2026-07-31",
  "amountPerShow": 0.82074,
  "amount": {
    "excludingVat": 81967.21311,
    "vatRate": 22.00,
    "vat": 18032.78689,
    "includingVat": 100000.00000
  }
}

DELETE /creative-statistics/{id} - Удаление статистики

Удаляет ошибочно поданный элемент статистики. Метод ограничен по частоте вызовов (429 при превышении).

Ответ: 200 - объект Status; 400, 401, 429, 500 - объект Error.

DELETE /api/v5.0/creative-statistics/7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1

200 OK

{
  "id": "7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1",
  "state": "DELETING"
}

GET /creative-statistics/{id}, HEAD /creative-statistics/{id}, GET /creative-statistics/{id}/status

Получение элемента статистики, проверка наличия и статус. Метода sync у статистики нет.

GET  /api/v5.0/creative-statistics/7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1
HEAD /api/v5.0/creative-statistics/7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1
GET  /api/v5.0/creative-statistics/7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1/status

Ответы: объект CreativeStatistic, заголовки ORD-* без тела, объект Status. Расширенный набор полей включается параметром ?extended=true.

POST /creative-statistics/search - Список статистики

CreativeStatisticFilter object

POST /api/v5.0/creative-statistics/search

{
  "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
  "status": ["APPROVED"],
  "page": 1,
  "limit": 100
}

200 OK

{
  "data": [
    {
      "id": "7d04bccb-1a0e-4ce1-9b30-ae06ca51cbf1",
      "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab",
      "marker": "2RanynT4kQm",
      "platformId": "7358025f-5674-44ea-9ab1-f342a486e939",
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "cid": null,
      "campaignType": "cpm",
      "impsPlan": 100000,
      "impsFact": 99870,
      "dateStartPlan": "2026-07-01",
      "dateEndPlan": "2026-07-31",
      "dateStartFact": "2026-07-01",
      "dateEndFact": "2026-07-31",
      "amountPerShow": 0.82074,
      "amount": {
        "excludingVat": 81967.21311,
        "vatRate": 22.00,
        "vat": 18032.78689,
        "includingVat": 100000.00000
      }
    }
  ],
  "meta": { "page": 1, "limit": 100, "total": 1 }
}

При обходе больших выборок вместо page используйте cursor: страничная пагинация на десятках тысяч записей заметно медленнее.

Формато-логический контроль

Полный справочник кодов для объекта Статистика показов - в разделе Формато-логический контроль.

Если акт и статистика поданы раздельно, их необходимо связать: указать, какие креативы по какому изначальному договору относятся к акту.

InvoiceCreatives object

InvoiceCreativesItem object

Creatives object

POST /invoices/creatives - Создание связок

POST /api/v5.0/invoices/creatives

{
  "creatives": [
    {
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "cid": "4e5edf88-fdae-418b-9162-12c348fcca96",
      "creatives": [
        { "creativeId": "bff52b20-a7a3-4cea-a516-2618b5e1e960" },
        { "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab" }
      ]
    }
  ]
}

202 Accepted

{
  "statuses": [
    { "id": "0c6b02d6-5056-487a-9928-79810678f67d", "state": "PENDING" }
  ]
}

Если изначальный договор зарегистрирован в ОРД, вместо cid указывается contractId - так связка выглядит в типичном случае:

POST /api/v5.0/invoices/creatives

{
  "creatives": [
    {
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "creatives": [
        { "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab" },
        { "creativeId": "bff52b20-a7a3-4cea-a516-2618b5e1e960" }
      ]
    }
  ]
}

Креативы можно адресовать маркерами - это удобно, когда в своей системе вы храните именно их:

POST /api/v5.0/invoices/creatives

{
  "creatives": [
    {
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "creatives": [
        { "marker": "2RanynT4kQm" },
        { "marker": "2Ranyn7YfuE" }
      ]
    }
  ]
}

PUT /invoices/creatives - Изменение связок

Принимает тот же объект InvoiceCreatives. Существующая связка опознаётся по полю id.

PUT /api/v5.0/invoices/creatives

{
  "creatives": [
    {
      "id": "0c6b02d6-5056-487a-9928-79810678f67d",
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "creatives": [
        { "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab" }
      ]
    }
  ]
}

DELETE /invoices/creatives/{id} - Удаление связки

Метод ограничен по частоте вызовов (429 при превышении).

DELETE /api/v5.0/invoices/creatives/0c6b02d6-5056-487a-9928-79810678f67d

200 OK

{
  "id": "0c6b02d6-5056-487a-9928-79810678f67d",
  "state": "DELETING"
}

POST /invoices/creatives/invoice_items - Список связок

InvoiceCreativesItemsFilter object

POST /api/v5.0/invoices/creatives/invoice_items

{
  "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
  "page": 1,
  "limit": 50
}

200 OK

{
  "data": [
    {
      "id": "0c6b02d6-5056-487a-9928-79810678f67d",
      "invoiceId": "7a459159-c38e-4f9a-a726-d209031111cb",
      "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
      "cid": null,
      "creatives": [
        { "creativeId": "e524575d-6fc6-48c9-a38c-2de2d0543dab", "marker": "2RanynT4kQm" },
        { "creativeId": "bff52b20-a7a3-4cea-a516-2618b5e1e960", "marker": "2Ranyn7YfuE" }
      ]
    }
  ],
  "meta": { "page": 1, "limit": 50, "total": 1 }
}

GET /invoices/creatives/{id}, HEAD /invoices/creatives/{id}, GET /invoices/creatives/{id}/status

Получение связки, проверка наличия и статус. В пути указывается идентификатор связки - тот, что пришёл в statuses[].id при создании.

GET  /api/v5.0/invoices/creatives/0c6b02d6-5056-487a-9928-79810678f67d
HEAD /api/v5.0/invoices/creatives/0c6b02d6-5056-487a-9928-79810678f67d
GET  /api/v5.0/invoices/creatives/0c6b02d6-5056-487a-9928-79810678f67d/status

Ответы: объект InvoiceCreatives с одной связкой в массиве creatives, заголовки ORD-* без тела, объект Status.

Связку можно отправлять сразу после акта, не дожидаясь его регистрации в ЕРИР: пока акт, договор и креативы не получат APPROVED, связка полежит в очереди ожидания. Элементы товарного фида в связках передавать запрещено (контроль IC_28) - вместо них указывается контейнер фида.

Формато-логический контроль

Полный справочник кодов для связки акта и креатива - в разделе Формато-логический контроль.

Раздел описывает механизмы удаления сущностей из системы ОРД. В зависимости от типа сущности, удаление выполняется одним из двух способов:

• Через создание заявки на удаление (для организаций, площадок, договоров, креативов).
• Напрямую (для актов и статистики).

Общие принципы:

• Статус сущности: Заявка может быть создана только для сущности, находящейся в статусе APPROVED.
• Зависимости: Невозможно удалить сущность, от которой зависят другие объекты (например, контракт, по которому уже зарегистрированы креативы или акты). При попытке удаления возвращается ошибка со списком зависимых объектов. Удаление возможно только после последовательного удаления всех зависимых сущностей по цепочке снизу вверх.
• Блокировки на время согласования: Пока заявка находится на согласовании (статус PENDING), целевая сущность и все объекты, ссылающиеся на неё, блокируются на изменение. Любая попытка регистрации или обновления заблокированной сущности возвращает ошибку с соответствующим кодом.
• Ограничение частоты запросов: Метод создания заявки имеет ограничение по частоте вызовов. При превышении допустимого количества запросов API возвращает HTTP-статус 429 Too Many Requests .

Способы удаления сущностей:

POST /deleting-requests - Создать заявку

Тело запроса - CreateDeleteRequestRequest

Ответ - CreateDeleteRequestResponse

POST /api/v5.0/deleting-requests

{
  "id": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
  "cause": "Креатив зарегистрирован по ошибке, размещение не состоялось"
}

201 Created

{
  "id": "1042",
  "entityId": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
  "entityType": "CRE",
  "status": "NEW",
  "cause": "Креатив зарегистрирован по ошибке, размещение не состоялось",
  "created": "2026-08-07T10:15:00+03:00"
}

Пример ошибки при наличии зависимых объектов:

400 Bad Request

{
  "requestId": "7c1e0b2a-3f45-4d9c-8a71-0b5e6f2d4c33",
  "status": 400,
  "code": "precondition-failed",
  "title": "failed precondition (e.g. referenced entity not found)",
  "detail": "CON: entity have dependents: INV 7a459159-c38e-4f9a-a726-d209031111cb"
}

Типы сущностей (entityType)

GET /deleting-requests/{id} - Получить заявку

Ответ: объект GetDeleteRequestResponse - те же поля, что и у CreateDeleteRequestResponse.

GET /api/v5.0/deleting-requests/1042

200 OK

{
  "id": "1042",
  "entityId": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
  "entityType": "CRE",
  "status": "APPROVED",
  "cause": "Креатив зарегистрирован по ошибке, размещение не состоялось",
  "created": "2026-08-07T10:15:00+03:00",
  "updated": "2026-08-08T14:22:37+03:00",
  "errorMessage": null
}

Обратите внимание: идентификатор заявки - не UUID, а число. Он приходит в ответе на создание заявки и в списке.

POST /deleting-requests/list - Список заявок

Тело запроса - GetDeleteRequestsRequest

Ответ - GetDeleteRequestsResponse

Обратите внимание на формат полей. В элементах списка используется snake_case: entity_id, entity_type, error_message. В ответах POST /deleting-requests и GET /deleting-requests/{id} те же поля приходят в camelCase.

POST /api/v5.0/deleting-requests/list

{ "page": 1, "limit": 50, "sorting": ["-created"] }

200 OK

{
  "data": [
    {
      "id": "1042",
      "entity_id": "bff52b20-a7a3-4cea-a516-2618b5e1e960",
      "entity_type": "CRE",
      "status": "NEW",
      "cause": "Креатив зарегистрирован по ошибке",
      "created": "2026-08-07T10:15:00+03:00",
      "updated": null,
      "error_message": null
    }
  ],
  "meta": { "total": 1 }
}

ККТУ - классификатор категорий товаров и услуг. С 1 декабря 2024 года код ККТУ обязателен при регистрации креатива: он заменил использовавшиеся ранее коды ОКВЭД и указывает, к какой группе товаров или услуг относится объект рекламирования.

Справочник иерархический, коды имеют вид 1, 1.1, 1.1.2 - от широкой категории к узкой. В креативе указывается код конечного уровня.

Правила заполнения поля ktu:

• массив не может быть пустым (контроль CR_98);
• код может содержать только цифры и точку (контроль CR_95);
• код должен существовать в справочнике (контроль CR_96);
• для обычного (некобрендингового) креатива и элемента фида передаётся ровно один код; несколько кодов допустимы только для кобрендинга и контейнеров фида (контроль CR_94);
• если передан единственный код 30.15.1, поле description становится обязательным (контроль CR_99).

GET /ktu - Получить справочник ККТУ

Возвращает справочник целиком, в виде дерева. Рекомендуется кешировать результат на своей стороне и обновлять периодически, а не запрашивать перед каждой регистрацией креатива.

Ответ - KtuListResponse

KtuNode

GET /api/v5.0/ktu

200 OK

{
  "data": [
    {
      "value": "1",
      "title": "Одежда, обувь и аксессуары",
      "children": [
        {
          "value": "1.1",
          "title": "Одежда",
          "children": [
            { "value": "1.1.2", "title": "Верхняя одежда" }
          ]
        },
        {
          "value": "1.2",
          "title": "Обувь",
          "children": [
            { "value": "1.2.1", "title": "Спортивная обувь" }
          ]
        }
      ]
    }
  ]
}

Назначение

Пакетная загрузка (или Массовые загрузки в ЛК) принимает большой объём данных одним файлом, без поштучных вызовов API. Формат - та же таблица, которую вы загружаете через личный кабинет: CSV, XLSX или XLS.

Типовые случаи применения:

• первичная миграция данных при подключении к ОРД;
• ежемесячная загрузка статистики, когда её удобнее выгрузить из своей системы в таблицу, чем передавать через REST;
• загрузка справочных сущностей (контрагентов, площадок) силами бухгалтерии без участия разработчиков.

Обработка асинхронная: загрузка файла возвращает идентификатор задания, дальше нужно опрашивать статус и, по завершении, скачать отчёт с результатами построчной обработки.

Эти методы не описаны в Swagger-спецификации, но доступны в API v5.0 по базовому пути /api/v5.0/batch.

POST /batch/registration - Загрузить файл

Content-Type: multipart/form-data

Значения entityType

Поддерживаются те же типы сущностей, для которых в личном кабинете публикуются шаблоны файлов:

Значение entityType проверяется сервисом пакетной обработки, а не самим API. Актуальный перечень и структура колонок для каждого типа приведены в шаблонах файлов в личном кабинете ОРД.

Пример запроса

curl -X POST 'https://api.ord-lab.ru/api/v5.0/batch/registration' \
  -H 'Authorization: Bearer <token>' \
  -F 'entityType=creative' \
  -F 'batch=@creatives-2026-07.xlsx'

Пример ответа

200 OK

{ "id": "b5f1d20c-9a3e-4f77-8c21-7e6a1d5b9033" }

Возвращённый id - идентификатор задания. По нему отслеживается ход обработки.

Ошибки

POST /batch/list - Список заданий и их статусы

Тело запроса - фильтр

Ответ

Элемент списка

POST /api/v5.0/batch/list

{ "type": "creative", "page": 1, "limit": 20, "sorting": ["-createDate"] }

200 OK

{
  "data": [
    {
      "id": "b5f1d20c-9a3e-4f77-8c21-7e6a1d5b9033",
      "url": "https://storage.ord-lab.ru/reports/b5f1d20c.xlsx",
      "status": "DONE",
      "type": "creative",
      "createDate": "2026-08-07T10:00:00+03:00",
      "estimateDate": "2026-08-07T10:12:00+03:00",
      "endDate": "2026-08-07T10:09:41+03:00",
      "total": 1500,
      "processed": 1500
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 }
}

Пара total / processed позволяет показывать прогресс обработки.

GET /batch/download_report/{id} - Ссылка на отчёт

Возвращает подписанную ссылку на файл отчёта. Отчёт повторяет структуру исходного файла и дополняет каждую строку результатом: идентификатором созданной сущности либо текстом ошибки.

200 OK

{ "data": "https://storage.ord-lab.ru/reports/b5f1d20c.xlsx?signature=..." }

Рекомендуемый порядок работы

1. POST /batch/registration - загрузить файл, получить id.
2. Периодически (например, раз в минуту) вызывать POST /batch/list с фильтром по этому id и смотреть status, total, processed.
3. По завершении - GET /batch/download_report/{id}, скачать отчёт по полученной ссылке.
4. Разобрать отчёт: строки с ошибками исправить и загрузить повторно отдельным файлом.

Шаблоны файлов для каждого типа сущности доступны в личном кабинете ОРД - они содержат корректные заголовки колонок и примеры заполнения.

Кто такой посредник и почему для него отдельные акты

Посредник (агент, комиссионер, поверенный) - участник цепочки, который заключает договоры и покупает размещение не от своего имени и не за свой счёт, а по поручению принципала. Его собственный доход - не вся сумма договора, а только вознаграждение.

Из этого следует, что в отчётности нужно разделять два денежных потока:

• суммы за услуги - деньги, которые прошли через посредника к рекламораспространителю;
• вознаграждение посредника - то, что посредник оставил себе.

Договор посредника регистрируется с типом intermediary-contract. По такому договору можно подавать акты только двух типов: intermediary-report (отчёт посредника) и commission-invoice (акт на вознаграждение) - контроль I_126.

Две схемы отчётности по вознаграждению

Схема А: вознаграждение внутри отчёта посредника

Классический вариант, работавший и в v4. Отчёт посредника содержит и суммы за услуги, и вознаграждение.

POST /api/v5.0/invoices

{
  "type": "intermediary-report",
  "contractId": "bd1a457f-8005-47f4-9659-ed4ada3a507f",
  "number": "IR-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "psr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    },
    "commission": {
      "isInvoice": false,
      "excludingVat": 8196.72,
      "vatRate": 22.00,
      "vat": 1803.28,
      "includingVat": 10000.00
    }
  },
  "items": [
    {
      "contractId": "bd1a457f-8005-47f4-9659-ed4ada3a507f",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 81967.21,
        "vatRate": 22.00,
        "vat": 18032.79,
        "includingVat": 100000.00
      }
    }
  ]
}

Здесь amount.commission.isInvoice = false (или поле не передано вовсе) - значит суммы вознаграждения обязаны быть заполнены в этом же акте (контроли I_199, I_201, I_203, I_205).

Схема Б: вознаграждение отдельным актом - новое в v5.0

Если посредник выставляет на вознаграждение отдельный первичный документ, в v5.0 это отражается двумя связанными актами.

Шаг 1. Отчёт посредника с признаком isInvoice = true. Суммы вознаграждения в нём не передаются - они будут в отдельном акте (контроли I_200, I_202, I_204, I_206).

POST /api/v5.0/invoices

{
  "type": "intermediary-report",
  "contractId": "bd1a457f-8005-47f4-9659-ed4ada3a507f",
  "number": "IR-2026-07",
  "date": "2026-08-05",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "psr",
  "isSocial": false,
  "isSocialQuota": false,
  "amount": {
    "services": {
      "excludingVat": 81967.21,
      "vatRate": 22.00,
      "vat": 18032.79,
      "includingVat": 100000.00
    },
    "commission": {
      "isInvoice": true
    }
  },
  "items": [
    {
      "contractId": "bd1a457f-8005-47f4-9659-ed4ada3a507f",
      "isSocial": false,
      "isSocialQuota": false,
      "amount": {
        "excludingVat": 81967.21,
        "vatRate": 22.00,
        "vat": 18032.79,
        "includingVat": 100000.00
      }
    }
  ]
}

202 Accepted

{
  "id": "b5df28a6-c5da-4474-9e38-166ffb4e3f2c",
  "state": "ACCEPTED"
}

Шаг 2. Акт на вознаграждение commission-invoice. Он ссылается на один или несколько отчётов посредника через amount.services.intermediaryReportIdList.

POST /api/v5.0/invoices

{
  "type": "commission-invoice",
  "contractId": "bd1a457f-8005-47f4-9659-ed4ada3a507f",
  "number": "CI-2026-07",
  "date": "2026-08-06",
  "startDate": "2026-07-01",
  "endDate": "2026-07-31",
  "clientRole": "rd",
  "contractorRole": "psr",
  "amount": {
    "services": {
      "intermediaryReportIdList": [
        "b5df28a6-c5da-4474-9e38-166ffb4e3f2c"
      ]
    },
    "commission": {
      "excludingVat": 8196.72,
      "vatRate": 22.00,
      "vat": 1803.28,
      "includingVat": 10000.00
    }
  }
}

202 Accepted

{
  "id": "500fa05e-a62f-4e85-895f-ea976fbccf3f",
  "state": "ACCEPTED"
}

Один акт на вознаграждение может закрывать несколько отчётов сразу - например, помесячные отчёты за квартал:

POST /api/v5.0/invoices

{
  "type": "commission-invoice",
  "contractId": "bd1a457f-8005-47f4-9659-ed4ada3a507f",
  "number": "CI-2026-Q3",
  "date": "2026-10-05",
  "startDate": "2026-07-01",
  "endDate": "2026-09-30",
  "clientRole": "rd",
  "contractorRole": "psr",
  "amount": {
    "services": {
      "intermediaryReportIdList": [
        "b5df28a6-c5da-4474-9e38-166ffb4e3f2c",
        "d2b47e91-8c05-4a63-b7f1-3e6905ca2b84",
        "a7f39d02-64b1-4c8e-8f52-9b0d1e2c3a44"
      ]
    },
    "commission": {
      "excludingVat": 24590.16,
      "vatRate": 22.00,
      "vat": 5409.84,
      "includingVat": 30000.00
    }
  }
}

Что вернётся, если отчёт ещё не зарегистрирован в ЕРИР

400 Bad Request

{
  "requestId": "3a91c74e-5b02-4f8d-9c16-7d4e2b8a0f53",
  "status": 400,
  "code": "parameter-error",
  "title": "invalid parameter value",
  "detail": "I_190: Идентификатор акта с типом \"Отчет посредника\" (intermediaryReportIdList) не зарегистрирован в ЕРИР"
}

Что запрещено в акте commission-invoice

При этом amount.commission.excludingVat, vatRate, vat, includingVat - обязательны, а amount.services.intermediaryReportIdList не может быть пустым или отсутствовать (контроли I_185, I_186).

Проверки списка intermediaryReportIdList

Отправлять акт на вознаграждение сразу вслед за отчётом можно: пока отчёты из intermediaryReportIdList не зарегистрированы в ЕРИР, акт полежит в очереди ожидания и уйдёт следом за ними. Ошибку I_190 вы увидите, только если сослались на отчёт, которого в ОРД нет вовсе, либо если он был отклонён.

Как выбрать схему

Схема Б выбирается один раз для конкретного отчёта: изменить isInvoice после того, как на отчёт уже сослался акт на вознаграждение, не получится - сработает контроль I_231.

Цепочка договоров: rrOrderContractIdList

Отдельный механизм - поле rrOrderContractIdList в акте. Оно нужно, когда договор оказания услуг был заключён по поручению посредника, действующего в интересах рекламораспространителя.

Смысл: ЕРИР должен видеть, что этот акт - часть цепочки, начинающейся с посреднического договора. Поле содержит идентификаторы посреднических договоров.

Где допустимо (контроль I_212):

• в акте типа invoice;
• в акте типа intermediary-report, если договор акта имеет признак agentActingForPublisher = true.

Проверки элементов списка:

Отличие от v4. До версии v4.5 передавался единственный идентификатор в поле rrOrderContractId (строка). Начиная с v4.5 и в v5.0 используется массив rrOrderContractIdList. Старое поле удалено.

{
  "type": "invoice",
  "contractId": "18abd2e0-7a4b-49cf-a287-f401fe98e192",
  "rrOrderContractIdList": [
    "bd1a457f-8005-47f4-9659-ed4ada3a507f"
  ],
  "...": "остальные поля акта"
}

Социальная реклама в актах

Признаки isSocial и isSocialQuota передаются только парой - и на уровне акта, и на уровне каждого элемента items (контроли I_181-I_184). Передача одного без другого приводит к ошибке.

Ставки НДС на стыке 2025 и 2026 годов

С 1 января 2026 года основная ставка НДС в России повышена с 20 % до 22 % (Федеральный закон № 425-ФЗ). Поскольку акты за декабрь 2025 года подаются в январе 2026-го, ОРД проверяет соответствие ставки не только дате акта, но и периоду оказания услуг.

Допустимые значения vatRate: 0, 5, 7, 10, 20, 22, 100 (значение 100 означает "Без НДС").

Аналогичное правило действует для статистики: ставка привязана к дате начала показов по акту dateStartPlan (контроли S_102, S_103).

Проверки применяются независимо к трём блокам сумм: amount.services, amount.commission и items[].amount. Дополнительно контроли I_228 и I_229 требуют, чтобы ставка НДС в детализации совпадала со ставкой в сумме акта - для типа invoice всегда, для intermediary-report при agentActingForPublisher = true.

Как работают проверки

Данные проходят два рубежа контроля.

На стороне ОРД. Часть проверок выполняется до отправки в ЕРИР - при обработке вашего запроса. Такой запрос отклоняется сразу, с кодом 400 и текстом контроля в поле detail:

{
  "requestId": "0e29c0f6-6d5e-4a30-9f5a-2f4d2b2a1f77",
  "status": 400,
  "code": "parameter-error",
  "title": "invalid parameter value",
  "detail": "C_60: Сумма договора не может быть равна 0, так как тип договора равен intermediary-contract (посреднический договор)"
}

На стороне ЕРИР. Остальные проверки выполняются уже после того, как ОРД принял объект. Запрос при этом завершается успешно (201 или 202), но объект переходит в статус DECLINED, а текст нарушения приходит в поле erirError объекта Status и в заголовке ORD-ERIR-Error. Именно поэтому недостаточно проверить код ответа - нужно дождаться финального статуса.

По характеру проверки делятся на форматные (длина, шаблон, формат даты, число знаков после запятой, допустимые значения перечислений) и логические (согласованность с уже зарегистрированными данными: существует ли договор, совпадают ли стороны, не отправлена ли сущность на удаление).

Префикс кода указывает на сущность:

Правила по атрибутам конкретной сущности приведены в конце её раздела. Здесь - сводный справочник всех кодов.

Фигурные скобки в текстах ошибок ({id}, {contractId}) - подстановка конкретного значения из вашего запроса.

Все тексты приведены к полям и методам API ОРД: сверяться с формулировками ЕРИР не нужно. Проверки по служебным атрибутам, которые ОРД добавляет к объекту сам, в справочник не включены - своим запросом такую ошибку вызвать нельзя.

Коды, действовавшие в прежних версиях и отменённые (I_152-I_156, I_158, I_160, I_161, I_178-I_180, C_35), перечислены в разделе "Миграция с v4 на v5" - на том шаге, где они были удалены.

Справочник кодов

Общие проверки

Контрагенты

Площадки

Договоры

Креативы

Акты

Статистика