Первый ОРД // Информ канал
866 subscribers
72 photos
2 videos
37 files
29 links
Канал новостей Первого ОРД (оператор рекламных данных)

Документация, договор, подключение https://adtech.beeline.ru/xwiki/bin/view/ОРД/
Download Telegram
Коллеги,

На неделе успешно вывели обновление - блокировку актов.

🧐 Как это работает?
Сразу после окончания квартала мы будем ежедневно «стучаться» в ЕРИР и получать список актов, которые планируют войти в расчет. Расчет отчислений в ЕРИР динамический - при изменении данных акта или цепочек акт может как попасть, так и исчезнуть из плана. Если акт на конкретный момент планирует попасть в расчет, мы покажем синюю плашку с соответствующим предупреждением. 🟦
26 числа второго месяца после окончания квартала происходит финальная блокировка актов. С этого момента акты нельзя редактировать или удалять. Об этом будет информировать уже желтая плашка внутри акта. 🟨

Для API пользователей признак называется isBlocked, он имеет 3 состояния:
-null (сущность не попала в блокировку)
-false (попала, но пока не заблокирована, будет заблокирована 26 числа в 00:00 второго месяца после квартала)
-true (сущность заблокирована, действия с ней невозможны, кроме просмотра)

Этот параметр можно получить в GET data/invoice/{id}.
🤝5🙏1👌1
Коллеги,

рады представить, пожалуй, самое значимое обновление года: бета-версию Центра уведомлений об ошибках. 🚦

На первом этапе в новом разделе будут отображаться все ошибки по актам, их разаллокациям и статистике. Если ошибка по самому акту, то из раздела можно перейти в этот акт и исправить данные. Если ошибка по статистике, то исправлять можно непосредственно внутри Центра уведомлений в окне редактирования. Раздел доступен пользователям с уровнем "Администратор".

Для api пользователей работает специальный метод вызова ошибочных данных.

Центр уведомлений поможет не упустить ни одной ошибки и исправить данные в рамках отчетного периода.

➡️ В дальнейшем планируем добавить в раздел ошибки и по другим сущностям: договорам, креативам и платформам.
🔥542
ORD_API-v70.3.docx
1.3 MB
Еще одно обновление – Технические сообщения ЕРИР.

На этой странице отображаются только сообщения от ЕРИР, например, о начисленном сборе, который нужно оплатить.

👉 Также в рамках обновления набора передаваемых в ЕРИР данных поля Номер и Дата акта вознаграждения посредника из раздела Комиссия посредника вскоре перестанут отправляться в ЕРИР. Если вы заполните эти данные в интерфейсе или по api, мы их сохраним у себя в базе ОРД, но ЕРИРом они приняты не будут. В следующем году будет реализован отдельный тип документа – Акт на вознаграждение посредника.

Сейчас ничего переделывать не нужно, можете заполнять данные как и раньше, ошибок не будет, а все требуемые данные будут отправлены и обработаны ЕРИРом в соответствии с текущим ФЛК (форматно-логическим контролем).


Все обновления отражены в нашей API спецификации. Тех.сообщения ЕРИР доступны только в интерфейсе.
👌4👍2🔥1👀1
ORD_API-v70.4.docx
1.3 MB
🌲Перед праздниками стараемся успеть как можно больше.
В новом релизе нюансы API v7 ЕРИР:

НДС 22%
С 2026 года появляется новая процентная ставка: 22%. В актах с датой от 01.01.2026 можно будет указывать 22% НДС.

Список значений НДС
В качестве ставки НДС можно указать только одно из следующих значений: 0, 5, 7, 10, 20, 22

Новые типы площадок
Добавлены SmartTv и HbbTv.
Для них URL является необязательным.

Признаки социальной рекламы для актов и разаллокации
Добавили признаки "Социальная реклама" и "Социальная реклама по квоте" к акту и пунктам разаллокации. Они несут тот же смысл, что и в креативах - если проставлен признак, сбор не начисляется. Но не забывайте проставлять признак и в креативах – для достоверности данных.

Необязательность параметров "Предмет договора" и "Действия посредника"
Параметры subjectType и actionType теперь необязательны.

Валидация признака "Платит агент"
Признак «Платит агент» (isChargePaidByAgent) нельзя использовать, если исполнитель в договоре - иностранное лицо.
2👍2🔥21
Дорогие партнеры!

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

🎄В Новом году хотим пожелать Вам финансовой стабильности, прогнозируемого роста и уверенности в начинаниях!
Пусть новогодние праздники пройдут в атмосфере тепла, доброты и любви!

Поздравляем Вас с наступающим 2026 годом и Рождеством! 🎅

Ваша команда Первого ОРД
❤️ 🎄 🥂
🎉854👍4
👋 В преддверии уик-энда мы с новостями о продукте!

С начала года много работали над техническими моментами, которые не видны глазу, но важны для работы системы. Однако не забыли и об ощутимых для Вас вещах.

Добавили проверку на дубли для статистик актов. Теперь нельзя будет создать дубликат или отредактировать так, что получится дубликат статистики. Это поможет не залить случайно лишнее.

Добавлена возможность подтверждения телефона на уровне организации. Администраторам в личные кабинеты выведены поп-апы, чтобы подтвердить номер.

Реализовали возможность скрытия ошибок в Центре Уведомлений. Данный функционал будет очень актуален, например, для актов, получивших ошибку блокировки от ЕРИР, но исправить их уже нельзя. Зато можно скрыть.

Доработали файл массовой загрузки акта - добавили поле «Описание».

И самое важное - Расширили возможности редактирования ФИО для Физических лиц.
В ЕРИР нужно отправлять всю достоверную информацию. Для Физ лиц был период, когда можно было не указывать ФИО. С введением сбора в 3%, эта информация стала критически важна.
👉 Вскоре сделаем адресную рассылку всем создателям договоров, где фигурировало Физ лицо без ФИО. И их нужно будет обновить.
👍6🙏2🔥1
Коллеги, привет!

Начало весны приносит обновление и в наш продукт 🌷

Поддержали новые округления НДС от ЕРИР. Сделано послабление по сравнению сумм.
Проще говоря, если раньше мешала лишняя копейка, теперь уже не должна.

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

☝️Также напоминаем Вам, что пора оплачивать счет по обязательным отчислениям – срок до 5 марта. Для этого нужно зайти в ЕРИР в раздел «Мои отчисления». Если вдруг забыли, как зайти в ЕРИР, на нашей вики есть инструкция.
🔥8👍4👌1
Первый ОРД // Информ канал pinned «Коллеги, привет! Начало весны приносит обновление и в наш продукт 🌷 Поддержали новые округления НДС от ЕРИР. Сделано послабление по сравнению сумм. Проще говоря, если раньше мешала лишняя копейка, теперь уже не должна. Каждую сущность из таблиц теперь…»
Мы снова с доработкой!

С тех пор, как тип договора стал очень критичен при регистрации отчетного документа, часто слышали от клиентов, что не всегда ясно, какой именно тип договора подтягивается при выборе. Особенно это важно, когда существует одновременно Услуговый и Посреднический договоры с идентичными атрибутами.
Услышали, доделали.

Добавлено отображение типа договора внутри акта и детализации.

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

Список сокращений:
У - Услуговый договор
П - Посреднический договор
ДС - У - Доп соглашение к услуговому
ДС - П - Доп соглашение к посредническому
👍4🔥421🤔1
❗️Внимание API-пользователей! 🤖

Мы планируем изменить несколько методов. Изменения указали в новой API доке, а также сделали сопроводительное описание.
❗️Все изменения будут выведены в прод в период 12-14 мая 2026 г.
На подготовку ваших систем будет полтора месяца. Переходить на новые методы в ваших системах нужно именно после релиза на нашей стороне. Перед релизом мы еще раз вернемся с напоминанием.

Что меняется:

1️⃣ Самое важное – метод регистрации креативов.
Вводим возможность регистрации кобрендинга по методологии ЕРИР с возможностью указать сразу несколько рекламодателей для креатива. Однако метод изменится для создания любого креатива: как обычного, так и кобрендингового.
Список изменений:
1.1 Новый параметр Кобрендинг
1.2 Изменение методов PATCH /data/creative/v2/all, PATCH /data/creative/{id}
1.3 Изменение метода GET /data/creative/{id}
1.4 Изменение метода GET /data/creative/list/byUser
1.5 Изменение валидации ККТУ


2️⃣ Сможем возвращать id измененного Изначального договора в айтеме разаллокации:
Замена метода PATCH /data/invoiceItem/all на PATCH /data/invoiceItem/v2/all

3️⃣ Меняем метод проверки наличия договора в системе и предоставления к нему доступа с 5 до 7 параметров:
Изменения метода GET /data/contract/duplicate/ByInn

Все изменения подробно описаны в документации и выложены на Хвики.
При возникновении любых вопросов будем рады помочь!
👍31👌1🤝1
Первый ОРД // Информ канал
Коллеги, рады представить, пожалуй, самое значимое обновление года: бета-версию Центра уведомлений об ошибках. 🚦 На первом этапе в новом разделе будут отображаться все ошибки по актам, их разаллокациям и статистике. Если ошибка по самому акту, то из раздела…
Памятка_по_работе_с_некоторыми_типами_ошибок_в_ЦУ.docx
194.3 KB
С важными новостями!⚡️

Как и обещали, мы доработали функционал Центра Уведомлений, выведя туда ошибки по всем оставшимся сущностям: креативам, договорам и площадкам.

Теперь никакая ошибка не должна ускользнуть от вашего внимания.

Какие-то ошибки – свежие и актуальные, другие – старые. В каждом случае стоит внимательно разобраться в причине появления ошибки и возможных действиях с ней.

Функционал скрытия ошибок (если вы решили не предпринимать никаких действий) пока есть только в разделе Акты, но обязательно скоро появится и в других разделах.

В помощь вам в работе с некоторыми сложными и непонятными видами ошибок подготовили памятку.👆
👍51🕊1
Первый ОРД // Информ канал
❗️Внимание API-пользователей! 🤖 Мы планируем изменить несколько методов. Изменения указали в новой API доке, а также сделали сопроводительное описание. ❗️Все изменения будут выведены в прод в период 12-14 мая 2026 г. На подготовку ваших систем будет полтора…
Мы готовы с постепенному выводу на продуктив всех изменений!

Завтра 13 мая в 12:00 будут выведены изменения п.2 и п.3. (новый метод для айтемов и отключение старого + вывод 2 новых параметров по дублям договоров )

Послезавтра 14 мая в 12:00 выведем Кобрендинг из п.1
👍31
Коллеги,

на продуктив выведены изменения:

Отключение метода PATCH /data/invoiceItem/all и переход на PATCH /data/invoiceItem/v2/all. В новом методе изменен ответ и теперь при пересоздании айтема API пользователи получают id созданного айтема. Актуально при замене изн.договора в айтеме

В метод GET/data/duplicate/ByInn добавлена проверка по типу организации (2 новых параметра), теперь дополнительно к текущим параметрам необходимо передавать customerType, executorType
👍21🔥1
Сделали финальный релиз api изменений:

Добавлена возможность создания креатива-кобрендинга с помощью нового параметра isCobranding

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

Добавлена возможность указания более 1 ККТУ (для креатива-кобрендинга)
Все указанные изменения относятся к следующим методам:
PATCH /data/creative/v2/all , PATCH /data/creative/{id}, GET /data/creative/{id}, GET /data/creative/all/byParametes, GET /data/creative/list/byUser
🎉2
❗️Уважаемые клиенты,

В этом месяце мы доработали схему регистрации актов и статистики. Теперь для того, чтобы данные успешно отправлялись в ЕРИР, требуется, чтобы у креативов, договоров и площадок был статус «Принято». Это сделано для того, чтобы все ваши передаваемые данные успешно регистрировались в ЕРИР и нигде не застревали из-за ошибок связанных сущностей.

Перед подачей актов и статистики мы рекомендуем убедиться в том, что все используемые договоры, креативы и площадки приняты ЕРИРом. Если что-то не принято, то нужно либо исправить ошибки, либо дождаться принятия ЕРИРом данных, если они были только что переданы (обычно – в течение суток).
👍42👌2👀2
☝️Обновление правил дедупликации договоров.

Мы расширили список атрибутов, участвующих в дедупликации договоров на стороне ОРД. Теперь можно без проблем создать «копию» договора, отличающегося лишь незначительным атрибутом, например, Действия посредника, или Сведения о предмете договора.

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


ЕРИР по-прежнему будет смотреть на 5 ключевых параметров при сравнении договоров (ИНН заказчика, ИНН исполнителя, номер, дата и тип), а при отличиях в необязательных атрибутах будет «склеивать» их в один на своей стороне.
👍41🔥1