ORD_API-v70.3.docx
1.3 MB
✅ Еще одно обновление – Технические сообщения ЕРИР.
На этой странице отображаются только сообщения от ЕРИР, например, о начисленном сборе, который нужно оплатить.
👉 Также в рамках обновления набора передаваемых в ЕРИР данных поля Номер и Дата акта вознаграждения посредника из раздела Комиссия посредника вскоре перестанут отправляться в ЕРИР. Если вы заполните эти данные в интерфейсе или по api, мы их сохраним у себя в базе ОРД, но ЕРИРом они приняты не будут. В следующем году будет реализован отдельный тип документа – Акт на вознаграждение посредника.
Сейчас ничего переделывать не нужно, можете заполнять данные как и раньше, ошибок не будет, а все требуемые данные будут отправлены и обработаны ЕРИРом в соответствии с текущим ФЛК (форматно-логическим контролем).
Все обновления отражены в нашей API спецификации. Тех.сообщения ЕРИР доступны только в интерфейсе.
На этой странице отображаются только сообщения от ЕРИР, например, о начисленном сборе, который нужно оплатить.
👉 Также в рамках обновления набора передаваемых в ЕРИР данных поля Номер и Дата акта вознаграждения посредника из раздела Комиссия посредника вскоре перестанут отправляться в ЕРИР. Если вы заполните эти данные в интерфейсе или по 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) нельзя использовать, если исполнитель в договоре - иностранное лицо.
В новом релизе нюансы API v7 ЕРИР:
✅ НДС 22%
С 2026 года появляется новая процентная ставка: 22%. В актах с датой от 01.01.2026 можно будет указывать 22% НДС.
✅ Список значений НДС
В качестве ставки НДС можно указать только одно из следующих значений: 0, 5, 7, 10, 20, 22
✅ Новые типы площадок
Добавлены SmartTv и HbbTv.
Для них URL является необязательным.
✅ Признаки социальной рекламы для актов и разаллокации
Добавили признаки "Социальная реклама" и "Социальная реклама по квоте" к акту и пунктам разаллокации. Они несут тот же смысл, что и в креативах - если проставлен признак, сбор не начисляется. Но не забывайте проставлять признак и в креативах – для достоверности данных.
✅ Необязательность параметров "Предмет договора" и "Действия посредника"
Параметры subjectType и actionType теперь необязательны.
✅ Валидация признака "Платит агент"
Признак «Платит агент» (isChargePaidByAgent) нельзя использовать, если исполнитель в договоре - иностранное лицо.
⚡2👍2🔥2❤1
Дорогие партнеры!
Уходящий год был насыщен изменениями и новыми проектами. Надеемся, что наша забота и поддержка помогли Вам пройти их максимально гладко и успешно.
🎄В Новом году хотим пожелать Вам финансовой стабильности, прогнозируемого роста и уверенности в начинаниях!
Пусть новогодние праздники пройдут в атмосфере тепла, доброты и любви!
Поздравляем Вас с наступающим 2026 годом и Рождеством! 🎅
Ваша команда Первого ОРД
❤️ 🎄 🥂
Уходящий год был насыщен изменениями и новыми проектами. Надеемся, что наша забота и поддержка помогли Вам пройти их максимально гладко и успешно.
🎄В Новом году хотим пожелать Вам финансовой стабильности, прогнозируемого роста и уверенности в начинаниях!
Пусть новогодние праздники пройдут в атмосфере тепла, доброты и любви!
Поздравляем Вас с наступающим 2026 годом и Рождеством! 🎅
Ваша команда Первого ОРД
❤️ 🎄 🥂
🎉8❤5☃4👍4
👋 В преддверии уик-энда мы с новостями о продукте!
С начала года много работали над техническими моментами, которые не видны глазу, но важны для работы системы. Однако не забыли и об ощутимых для Вас вещах.
✅ Добавили проверку на дубли для статистик актов. Теперь нельзя будет создать дубликат или отредактировать так, что получится дубликат статистики. Это поможет не залить случайно лишнее.
✅ Добавлена возможность подтверждения телефона на уровне организации. Администраторам в личные кабинеты выведены поп-апы, чтобы подтвердить номер.
✅ Реализовали возможность скрытия ошибок в Центре Уведомлений. Данный функционал будет очень актуален, например, для актов, получивших ошибку блокировки от ЕРИР, но исправить их уже нельзя. Зато можно скрыть.
✅Доработали файл массовой загрузки акта - добавили поле «Описание».
✅ И самое важное - Расширили возможности редактирования ФИО для Физических лиц.
В ЕРИР нужно отправлять всю достоверную информацию. Для Физ лиц был период, когда можно было не указывать ФИО. С введением сбора в 3%, эта информация стала критически важна.
👉 Вскоре сделаем адресную рассылку всем создателям договоров, где фигурировало Физ лицо без ФИО. И их нужно будет обновить.
С начала года много работали над техническими моментами, которые не видны глазу, но важны для работы системы. Однако не забыли и об ощутимых для Вас вещах.
✅ Добавили проверку на дубли для статистик актов. Теперь нельзя будет создать дубликат или отредактировать так, что получится дубликат статистики. Это поможет не залить случайно лишнее.
✅ Добавлена возможность подтверждения телефона на уровне организации. Администраторам в личные кабинеты выведены поп-апы, чтобы подтвердить номер.
✅ Реализовали возможность скрытия ошибок в Центре Уведомлений. Данный функционал будет очень актуален, например, для актов, получивших ошибку блокировки от ЕРИР, но исправить их уже нельзя. Зато можно скрыть.
✅Доработали файл массовой загрузки акта - добавили поле «Описание».
✅ И самое важное - Расширили возможности редактирования ФИО для Физических лиц.
В ЕРИР нужно отправлять всю достоверную информацию. Для Физ лиц был период, когда можно было не указывать ФИО. С введением сбора в 3%, эта информация стала критически важна.
👉 Вскоре сделаем адресную рассылку всем создателям договоров, где фигурировало Физ лицо без ФИО. И их нужно будет обновить.
👍6🙏2🔥1
Коллеги, привет!
Начало весны приносит обновление и в наш продукт 🌷
✅ Поддержали новые округления НДС от ЕРИР. Сделано послабление по сравнению сумм.
Проще говоря, если раньше мешала лишняя копейка, теперь уже не должна.
✅ Каждую сущность из таблиц теперь можно открыть в отдельной вкладке: при помощи колесика мыши или нажатием правой кнопкой мыши "Открыть ссылку в новой вкладке". Вроде небольшая, но очень важная с т.з. интерфейса доработка – позволит одновременно держать открытыми несколько вкладок с разными актами/договорами/креативами и т.д.
☝️Также напоминаем Вам, что пора оплачивать счет по обязательным отчислениям – срок до 5 марта. Для этого нужно зайти в ЕРИР в раздел «Мои отчисления». Если вдруг забыли, как зайти в ЕРИР, на нашей вики есть инструкция.
Начало весны приносит обновление и в наш продукт 🌷
✅ Поддержали новые округления НДС от ЕРИР. Сделано послабление по сравнению сумм.
Проще говоря, если раньше мешала лишняя копейка, теперь уже не должна.
✅ Каждую сущность из таблиц теперь можно открыть в отдельной вкладке: при помощи колесика мыши или нажатием правой кнопкой мыши "Открыть ссылку в новой вкладке". Вроде небольшая, но очень важная с т.з. интерфейса доработка – позволит одновременно держать открытыми несколько вкладок с разными актами/договорами/креативами и т.д.
☝️Также напоминаем Вам, что пора оплачивать счет по обязательным отчислениям – срок до 5 марта. Для этого нужно зайти в ЕРИР в раздел «Мои отчисления». Если вдруг забыли, как зайти в ЕРИР, на нашей вики есть инструкция.
🔥8👍4👌1
Первый ОРД // Информ канал pinned «Коллеги, привет! Начало весны приносит обновление и в наш продукт 🌷 ✅ Поддержали новые округления НДС от ЕРИР. Сделано послабление по сравнению сумм. Проще говоря, если раньше мешала лишняя копейка, теперь уже не должна. ✅ Каждую сущность из таблиц теперь…»
Мы снова с доработкой!
С тех пор, как тип договора стал очень критичен при регистрации отчетного документа, часто слышали от клиентов, что не всегда ясно, какой именно тип договора подтягивается при выборе. Особенно это важно, когда существует одновременно Услуговый и Посреднический договоры с идентичными атрибутами.
Услышали, доделали.
✅ Добавлено отображение типа договора внутри акта и детализации.
При создании/редактировании отчетного документа в выпадающем списке тип отображается сокращениями, а на форме просмотра акта целиком. Примеры на скриншотах.
Список сокращений:
У - Услуговый договор
П - Посреднический договор
ДС - У - Доп соглашение к услуговому
ДС - П - Доп соглашение к посредническому
С тех пор, как тип договора стал очень критичен при регистрации отчетного документа, часто слышали от клиентов, что не всегда ясно, какой именно тип договора подтягивается при выборе. Особенно это важно, когда существует одновременно Услуговый и Посреднический договоры с идентичными атрибутами.
Услышали, доделали.
✅ Добавлено отображение типа договора внутри акта и детализации.
При создании/редактировании отчетного документа в выпадающем списке тип отображается сокращениями, а на форме просмотра акта целиком. Примеры на скриншотах.
Список сокращений:
У - Услуговый договор
П - Посреднический договор
ДС - У - Доп соглашение к услуговому
ДС - П - Доп соглашение к посредническому
👍4🔥4❤2⚡1🤔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
Все изменения подробно описаны в документации и выложены на Хвики.
При возникновении любых вопросов будем рады помочь!
Мы планируем изменить несколько методов. Изменения указали в новой 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
Все изменения подробно описаны в документации и выложены на Хвики.
При возникновении любых вопросов будем рады помочь!
👍3❤1👌1🤝1
Первый ОРД // Информ канал
Коллеги, рады представить, пожалуй, самое значимое обновление года: бета-версию Центра уведомлений об ошибках. 🚦 ✅ На первом этапе в новом разделе будут отображаться все ошибки по актам, их разаллокациям и статистике. Если ошибка по самому акту, то из раздела…
Памятка_по_работе_с_некоторыми_типами_ошибок_в_ЦУ.docx
194.3 KB
С важными новостями!⚡️
Как и обещали, мы доработали функционал Центра Уведомлений, выведя туда ошибки по всем оставшимся сущностям: креативам, договорам и площадкам.
Теперь никакая ошибка не должна ускользнуть от вашего внимания.
Какие-то ошибки – свежие и актуальные, другие – старые. В каждом случае стоит внимательно разобраться в причине появления ошибки и возможных действиях с ней.
Функционал скрытия ошибок (если вы решили не предпринимать никаких действий) пока есть только в разделе Акты, но обязательно скоро появится и в других разделах.
В помощь вам в работе с некоторыми сложными и непонятными видами ошибок подготовили памятку.👆
Как и обещали, мы доработали функционал Центра Уведомлений, выведя туда ошибки по всем оставшимся сущностям: креативам, договорам и площадкам.
Теперь никакая ошибка не должна ускользнуть от вашего внимания.
Какие-то ошибки – свежие и актуальные, другие – старые. В каждом случае стоит внимательно разобраться в причине появления ошибки и возможных действиях с ней.
Функционал скрытия ошибок (если вы решили не предпринимать никаких действий) пока есть только в разделе Акты, но обязательно скоро появится и в других разделах.
В помощь вам в работе с некоторыми сложными и непонятными видами ошибок подготовили памятку.👆
👍5⚡1🕊1
Первый ОРД // Информ канал
❗️Внимание API-пользователей! 🤖 Мы планируем изменить несколько методов. Изменения указали в новой API доке, а также сделали сопроводительное описание. ❗️Все изменения будут выведены в прод в период 12-14 мая 2026 г. На подготовку ваших систем будет полтора…
Мы готовы с постепенному выводу на продуктив всех изменений!
Завтра 13 мая в 12:00 будут выведены изменения п.2 и п.3. (новый метод для айтемов и отключение старого + вывод 2 новых параметров по дублям договоров )
Послезавтра 14 мая в 12:00 выведем Кобрендинг из п.1
Завтра 13 мая в 12:00 будут выведены изменения п.2 и п.3. (новый метод для айтемов и отключение старого + вывод 2 новых параметров по дублям договоров )
Послезавтра 14 мая в 12:00 выведем Кобрендинг из п.1
👍3❤1
Коллеги,
на продуктив выведены изменения:
✅Отключение метода PATCH /data/invoiceItem/all и переход на PATCH /data/invoiceItem/v2/all. В новом методе изменен ответ и теперь при пересоздании айтема API пользователи получают id созданного айтема. Актуально при замене изн.договора в айтеме
✅В метод GET/data/duplicate/ByInn добавлена проверка по типу организации (2 новых параметра), теперь дополнительно к текущим параметрам необходимо передавать customerType, executorType
на продуктив выведены изменения:
✅Отключение метода PATCH /data/invoiceItem/all и переход на PATCH /data/invoiceItem/v2/all. В новом методе изменен ответ и теперь при пересоздании айтема API пользователи получают id созданного айтема. Актуально при замене изн.договора в айтеме
✅В метод GET/data/duplicate/ByInn добавлена проверка по типу организации (2 новых параметра), теперь дополнительно к текущим параметрам необходимо передавать customerType, executorType
👍2⚡1🔥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
✅ Добавлена возможность создания креатива-кобрендинга с помощью нового параметра 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
❗️Уважаемые клиенты,
В этом месяце мы доработали схему регистрации актов и статистики. Теперь для того, чтобы данные успешно отправлялись в ЕРИР, требуется, чтобы у креативов, договоров и площадок был статус «Принято». Это сделано для того, чтобы все ваши передаваемые данные успешно регистрировались в ЕРИР и нигде не застревали из-за ошибок связанных сущностей.
Перед подачей актов и статистики мы рекомендуем убедиться в том, что все используемые договоры, креативы и площадки приняты ЕРИРом. Если что-то не принято, то нужно либо исправить ошибки, либо дождаться принятия ЕРИРом данных, если они были только что переданы (обычно – в течение суток).
В этом месяце мы доработали схему регистрации актов и статистики. Теперь для того, чтобы данные успешно отправлялись в ЕРИР, требуется, чтобы у креативов, договоров и площадок был статус «Принято». Это сделано для того, чтобы все ваши передаваемые данные успешно регистрировались в ЕРИР и нигде не застревали из-за ошибок связанных сущностей.
Перед подачей актов и статистики мы рекомендуем убедиться в том, что все используемые договоры, креативы и площадки приняты ЕРИРом. Если что-то не принято, то нужно либо исправить ошибки, либо дождаться принятия ЕРИРом данных, если они были только что переданы (обычно – в течение суток).
👍4✍2👌2👀2
☝️Обновление правил дедупликации договоров.
Мы расширили список атрибутов, участвующих в дедупликации договоров на стороне ОРД. Теперь можно без проблем создать «копию» договора, отличающегося лишь незначительным атрибутом, например, Действия посредника, или Сведения о предмете договора.
ЕРИР по-прежнему будет смотреть на 5 ключевых параметров при сравнении договоров (ИНН заказчика, ИНН исполнителя, номер, дата и тип), а при отличиях в необязательных атрибутах будет «склеивать» их в один на своей стороне.
Мы расширили список атрибутов, участвующих в дедупликации договоров на стороне ОРД. Теперь можно без проблем создать «копию» договора, отличающегося лишь незначительным атрибутом, например, Действия посредника, или Сведения о предмете договора.
Это полезно в тех случаях, когда в системе уже заведен договор, но клиенты просят указать именно те необязательные атрибуты, которые у них есть или им передали.
ЕРИР по-прежнему будет смотреть на 5 ключевых параметров при сравнении договоров (ИНН заказчика, ИНН исполнителя, номер, дата и тип), а при отличиях в необязательных атрибутах будет «склеивать» их в один на своей стороне.
👍4❤1🔥1
🏠 Адреса для ИП и Физ лиц
Выводим новый функционал и систематизируем слухи о необходимости ввода адресов для ИП и ФЛ.
Сегодня в Первом ОРД стал доступен ввод адреса проживания/регистрации для ИП и ФЛ.
Для наших текущих клиентов – ввод своего адреса является обязательным (чтобы за вас никто другой не ввел неправильный адрес).
При регистрации договоров с ИП и ФЛ – поле ввода адреса опциональное.
Почему лучшего его заполнять?
Когда могут начать приходить ошибки по актам?
Что делать сейчас?
Выводим новый функционал и систематизируем слухи о необходимости ввода адресов для ИП и ФЛ.
Сегодня в Первом ОРД стал доступен ввод адреса проживания/регистрации для ИП и ФЛ.
Для наших текущих клиентов – ввод своего адреса является обязательным (чтобы за вас никто другой не ввел неправильный адрес).
При регистрации договоров с ИП и ФЛ – поле ввода адреса опциональное.
Почему лучшего его заполнять?
Чтобы при подаче акта впоследствии не было ошибки
Когда могут начать приходить ошибки по актам?
Не раньше августа. Именно к началу августа мы планируем перейти на новую api ЕРИР, в которой включится проверка наличия адреса у ИП/ФЛ, участвующих в договоре. Если адреса нет – при подаче акта вернется ошибка.
Что делать сейчас?
- Заполнить свой собственный адрес в ЛК. Всем ИП и ФЛ с сегодняшнего дня будет показан поп-ап для ввода адреса.
- По возможности заполнять адрес при регистрации договора.
- Если вы автор или сторона уже имеющегося в ОРД договора – дозаполнить адрес через редактирование договора.
- Если вы работаете по API – доработать за ближайший месяц методы отправки адреса в нас. Новая api-спека уже есть, подробное описание на стр. 141-142.
👍5✍1🔥1🤝1
ORD_API-v73.1.docx
1.4 MB
Свежая api спецификация с описанием Адресов