Adfox и API v8 ЕРИР: новые правила маркировки — адрес контрагента и акт на вознаграждение посредника
Как заполнить карточки контрагентов и акты в Adfox после обновления 5 августа 2026 — без ошибок в отчётности ОРД
Получить предложениеКоротко: 5 августа 2026 года Adfox обновил интерфейс маркировки рекламы под API v8 Единого реестра интернет-рекламы (ЕРИР). Появилось поле «Адрес» у контрагентов и новый тип акта — «Акт на вознаграждение посредника» без статистики. Без заполненного адреса в ряде сценариев система блокирует регистрацию и обновление актов. Ниже — практический гайд для паблишеров рекламной сети Яндекса (РСЯ), владельцев площадок на Adfox и агентств с посредническими договорами.
С 1 июля 2026 года в силу вступили требования API v8 ЕРИР; 19 августа в продакшене ОРД Яндекса отключается предыдущая версия API. Если вы работаете с маркировкой рекламы через Adfox, сейчас — момент проверить карточки контрагентов, типы актов и цепочки посредников до первой отчётности за третий квартал 2026 года.
API v8 ЕРИР в Adfox
Поле «Адрес» контрагента, акт на вознаграждение посредника и дедлайн Q3 до 25 ноября 2026 — что проверить до отключения API v7 19 августа.
check address → I_226/I_227
type commission-invoice
deadline Q3 → 25.11.2026
Что изменилось в Adfox 5 августа 2026
Переход на API v8 ЕРИР — суть обновления
Определение: API v8 ЕРИР — актуальная версия протокола обмена данными между операторами рекламных данных (ОРД) и Единым реестром интернет-рекламы. ОРД Яндекса перешёл на неё с 1 июля 2026 года; Adfox синхронизировал интерфейс маркировки 5 августа.
Ключевые нововведения API v8, которые теперь отражены в Adfox:
| Изменение | Что это значит в Adfox |
|---|---|
Поле address в карточке организации | Новое поле «Адрес» при создании контрагента |
Тип акта commission-invoice | «Акт на вознаграждение посредника» — отдельный документ только на комиссию |
Признак amount.commission.isInvoice | Выбор: комиссия внутри отчёта посредника или в отдельном акте |
Проверки I_226, I_227 | Блокировка акта, если адрес обязателен, но не заполнен |
Удаление amount.commissionInfo | Старая структура комиссии в API v7 больше не работает |
Официальный релиз Яндекс Рекламы формулирует суть так: «В Adfox обновился интерфейс маркировки рекламы в связи с переходом на новую версию API v8 от ЕРИР. В интерфейсе появилось новое поле для данных контрагентов и новый тип акта.»
Календарь миграции — август–ноябрь 2026:
| Дата | Событие |
|---|---|
| 01.07.2026 | API v8 ЕРИР вступил в силу |
| 05.08.2026 | Обновление интерфейса маркировки в Adfox |
| 12.08.2026 | Отключение API v7 в тестовом контуре ОРД Яндекса |
| 19.08.2026 | Отключение API v7 в продакшен-контуре ОРД Яндекса |
| 01.09.2026 | В ОРД вознаграждение посредника можно вносить отдельным документом |
| до 25.11.2026 | Дедлайн корректировки данных за Q3 для расчёта рекламного сбора 3% |
Adfox · API v8 ЕРИР · август 2026
Три карты миграции: сроки, документы посредника и проверка адреса
Переключите режим — таймлайн дедлайнов, схема «отчёт → акт на вознаграждение» или decision tree: когда адрес блокирует акт и какой тип документа выбрать.
- 19.08.2026 — отключение API v7 в продакшене ОРД Яндекса
- Новый тип commission-invoice — комиссия без статистики
- Адрес контрагента — условно обязателен при актах (I_226 / I_227)
Таймлайн: кликните веху — подробности дедлайна и риска.
Дальше — когда поле «Адрес» становится обязательным и как заполнить карточки контрагентов.
Поле «Адрес» в карточке контрагента — когда обязательно
По умолчанию поле «Адрес» необязательное при создании контрагента. Но при регистрации или обновлении актов API v8 включает условные проверки: в ряде схем без адреса акт не пройдёт валидацию.
Технические требования к полю «Адрес»:
| Параметр | Требование |
|---|---|
| Длина | до 500 символов |
| Формат | не только спецсимволы; без пробелов в начале и конце |
| ФЛ, ИП, ЮЛ РФ | кириллица, цифры, символы - . , ' ( ) N № / I V X L C D M |
| Иностранные лица | кириллица + латиница, цифры, дополнительно # |
| Коды ошибок формата | O_79, O_80 |
Когда адрес блокирует акт (проверки I_226 и I_227):
| № | Условие | Чей адрес нужен | Код ошибки |
|---|---|---|---|
| 1 | Исполнитель — физлицо или ИП | Исполнителя | I_227 |
| 2 | Договор оказания услуг: исполнитель — иностранное лицо, заказчик — ФЛ/ИП | Заказчика | I_226 |
| 3 | Посреднический договор, агент — представитель рекламодателя, исполнитель — иностранное лицо, заказчик — ФЛ/ИП | Заказчика | I_226 |
| 4 | Посреднический договор, агент — представитель площадки, заказчик — ФЛ/ИП | Заказчика | I_226 |
| 5 | Дополнительное соглашение к посредническому договору | Проверки по родительскому договору | I_226 |
Итог: если в цепочке есть физлицо, ИП или иностранный контрагент при определённых типах договоров — заполните адрес до создания акта, а не после отказа системы.
Новый тип акта — вознаграждение посредника без статистики
Раньше комиссию посредника можно было указать только внутри «Отчёта посредника». С API v8 и обновлением Adfox появился отдельный документ — «Акт на вознаграждение посредника» (в API: commission-invoice).
Сравнение типов актов в Adfox:
| Тип в API | Название в Adfox | Статистика | Разаллокация | Назначение |
|---|---|---|---|---|
intermediary-report | Отчёт посредника | Да | Да | Основной отчёт с бюджетом и, опционально, комиссией |
commission-invoice | Акт на вознаграждение посредника | Нет | Нет | Только сумма комиссии со ссылками на отчёты |
invoice | Акт (стандартный) | Да | Да | Прямые договоры оказания услуг |
Акт на вознаграждение доступен только для посреднических договоров и дополнительных соглашений к ним. Он содержит ссылки на отчёты посредника (intermediaryReportIdList) и суммы вознаграждения — без статистики показов и без разаллокации бюджета.
Как пишет Яндекс в релизе: «Он может указать сумму вознаграждения в отчёте, а может вынести её в отдельный акт… При этом в таком типе акта не указывается статистика — он содержит только ссылки на отчёты посредника и суммы вознаграждения.»
Кому важны изменения: паблишеры РСЯ, агентства и рекламодатели
Владельцы сайтов на Adfox и монетизация через рекламную сеть Яндекса
Если вы монетизируете сайт через Adfox или напрямую через рекламную сеть Яндекса, цепочка маркировки выглядит так: креатив и контрагенты регистрируются в Adfox → получается токен маркировки рекламы → после показов подаются акты и статистика → данные уходят в ОРД Яндекса → ЕРИР.
Для паблишера критичны два момента после 5 августа:
- Карточки контрагентов — если вы выступаете исполнителем как ИП или физлицо, адрес обязателен при подаче актов.
- Посреднические схемы — если между вами и рекламодателем стоит агентство, уточните, кто подаёт акты и в каком ОРД. Дублирование одного акта двумя участниками — частая ошибка.
Паблишеры, которые получают токен от заказчика (а не регистрируют креатив сами в Adfox), отчитываются в любом ОРД или в кабинете ord.yandex.ru — но правила адреса и типов актов те же, потому что ЕРИР принимает данные только через API ОРД.
Рекламные агентства с посредническими договорами
Агентствам с посредническими договорами обновление затрагивает все звенья цепочки:
- выбор функции посредника (представитель рекламодателя или площадки);
- решение: комиссия в отчёте или отдельным актом;
- галочка «Посредник берёт на себя оплату сбора» — влияет на расчёт рекламного сбора 3%;
- корректная разаллокация по первичным договорам.
Роскомнадзор при расчёте сбора смотрит на раздел «Комиссия (вознаграждение) посредника» в акте ОРД и берёт сумму без НДС. Ошибка в типе акта или в поле комиссии напрямую влияет на квартальный платёж.
Если агентство ведёт и контекст в Директе, и медийку на сторонних площадках через Adfox — это гибридная схема с разными каналами отчётности (подробнее в следующем подразделе).
Прямые рекламодатели в Директе — связка Adfox ↔ ОРД Яндекса
Прямой рекламодатель в Яндекс Директе чаще работает через кабинет ОРД: креативы и статистика передаются автоматически, разаллокация черновиков доступна с 12-го числа месяца, следующего за отчётным.
Но если рекламодатель размещается и в Директе, и на площадках через Adfox (например, нативная реклама на партнёрских сайтах), цепочки расходятся:
| Роль | До показа | После показа | Канал |
|---|---|---|---|
| Паблишер Adfox/РСЯ | Креатив + контрагенты в Adfox → токен | Акты + статистика в Adfox | Adfox → ОРД → ЕРИР |
| Агентство + Директ | Креативы в Директе | Разаллокация в кабинете ОРД; статистика — автоматически | Директ + ОРД |
| Агентство + Adfox | Регистрация в Adfox или API ОРД | Акты в Adfox / API | Ручной или API-поток |
| РСЯ без Adfox | Реквизиты в интерфейсе РСЯ | Яндекс передаёт данные сам | РСЯ → ОРД |
Правило, которое стоит зафиксировать в регламенте: если креатив зарегистрирован в ОРД Яндекса через Adfox — отчёт о маркировке подаётся тоже в Adfox. Переключение между интерфейсами для одного и того же размещения приведёт к расхождениям.
Данные в ЕРИР поступают только от ОРД по API — промежуточные таблицы в Excel или CRM не заменяют подачу в операторе.
Адрес контрагента в ОРД: когда заполнять и что указывать
Юридический адрес vs фактический — требования API v8
API v8 не разделяет юридический и фактический адрес в отдельные поля — есть одно поле address. Практическая рекомендация:
- для юрлиц — указывайте юридический адрес из ЕГРЮЛ;
- для ИП — адрес регистрации из ЕГРИП;
- для физлиц — адрес регистрации по паспорту;
- для иностранных лиц — адрес из учредительных документов на языке оригинала (допустима латиница).
Важно: при существующих договорах API v8 запрещает менять идентификаторы иностранных лиц (mobilePhone, regNumber, alternativeInn) — коды ошибок O_81–O_84. Если нужно исправить данные — согласуйте с поддержкой ОРД до подачи новых актов.
Ошибки при регистрации и обновлении актов без адреса
Типичный сценарий: контрагент создан без адреса ещё до июля 2026 года, акты проходили. После перехода на v8 при попытке обновить акт за август система возвращает I_226 или I_227 и блокирует операцию.
Что происходит на практике:
| Симптом | Причина | Действие |
|---|---|---|
Акт не создаётся, ошибка I_227 | У исполнителя-ФЛ/ИП пустой адрес | Заполнить адрес в карточке контрагента, повторить |
Акт не обновляется, ошибка I_226 | У заказчика-ФЛ/ИП пустой адрес в посреднической или «иностранной» схеме | Заполнить адрес заказчика |
Ошибка O_79/O_80 | Недопустимые символы или только спецсимволы | Проверить формат по таблице требований |
| Акт создан, но данные не ушли в ЕРИР | Просрочен срок 30 дней | Подать статистику отдельно, акт — при готовности |
Штрафы за нарушение сроков подачи данных в ЕРИР (ч. 5 ст. 18.1 ФЗ «О рекламе») с 1 сентября 2023 года для юрлиц достигают 500 000 ₽. Пустой адрес — не штраф сам по себе, но блокирует легальную подачу в срок.
Чек-лист проверки карточек контрагентов перед подачей
Пройдите по списку до первого акта после 5 августа:
- Проверить тип каждого контрагента (ФЛ / ИП / ЮЛ / иностранное лицо)
- Заполнить поле «Адрес» у исполнителя, если он ФЛ или ИП
- Заполнить «Адрес» у заказчика-ФЛ/ИП в посреднических и «иностранных» схемах
- Убедиться, что адрес ≤ 500 символов, без лишних пробелов, допустимые символы
- Для иностранных лиц — не менять телефон, регистрационный номер и альтернативный ИНН при существующих договорах
- Сверить ИНН, ОГРН и роли (заказчик / исполнитель) с бумажными договорами
API v8 ЕРИР: проверим карточки контрагентов и акты в Adfox до дедлайна Q3
Monster Context проводит аудит маркировки для паблишеров РСЯ и агентств: адреса контрагентов, посреднические договоры, типы актов и цепочки Adfox → ОРД → ЕРИР. Вы увидите риски блокировки I_226/I_227 и ошибок в расчёте рекламного сбора 3% до подачи отчётности за третий квартал.
- Сверка карточек ФЛ/ИП/иностранных лиц с требованиями API v8
- Чек-лист: отчёт посредника vs акт на вознаграждение
- Рекомендации по связке Adfox, ОРД Яндекса и Директа
