История изменений

Версия 6.0

21.02.2025

Метод /organization:
- Добавление нового поля «КПП» (kpp). Поле не является обязательным, допускается его передача только для организаций с типом ЮЛ (type:ul). Коды ошибок данной проверки: O_74, O_75.
Метод /contract:
- Запрещается передавать атрибут contractId для всех типов договоров, отличных от дополнительных соглашений (type:additional-agreement). Код ошибки данной проверки: C_64.
Метод /creative:
- Исключение поля «Описание изображения креатива» (mediaData.description).
- Исключение поля «Тип рекламной кампании» (type).
- Исключение признака нативной рекламы (isNative).
- Добавление признака социальной рекламы по квоте (isSocialQuota). Поле является обязательным для креативов с типом «креатив» (creativeType:creative) и «контейнер» (creativeType:container). Поле запрещается передавать для креативов с типом «элемент фида» (creativeType:feed_element). Коды ошибок данной проверки: CR_100, CR_101.
Метод /invoice:
- Добавление нового поля «Тип акта» (type) с возможными значениями «Акт выполненных работ» (invoice) и «Отчет посредника» (intermediary-report). Коды ошибок данной проверки: I_124, I_125, I_126.
- Добавление нового значения «Посредник» (psr) в список возможных значений роли Заказчика (clientRole) и Исполнителя (contractorRole) в акте. Коды ошибок данной проверки: I_8, I_9, I_10, I_11, I_12, I_13, I_16, I_121.
- Замена поля «Сумма акта» (amount) на структуру amount.*, которая состоит из:
  - структуры «Детализация суммы акта для выделения НДС» (amount.services.*), которая состоит из:
    - суммы акта/отчета без учета НДС (excludingVat). Код ошибки данной проверки: I_127;
    - ставки НДС (vatRate). Код ошибки данной проверки: I_131;
    - суммы НДС в акте/отчете (vat). Коды ошибок данной проверки: I_132, I_133;
    - суммы акта/отчета, включая НДС (includingVat). Коды ошибок данной проверки: I_134, I_135.
  - структуры «Вознаграждение посредника» (amount.commission.*) в случае, если отчет включает вознаграждение посредника или составлен отдельный акт на вознаграждение посредника. «Вознаграждение посредника» необходимо передавать только, если данный объект является «Отчетом посредника» (type:intermediary-report). Коды ошибок данной проверки: I_136, I_137, I_138. Структура состоит из:
    - суммы акта/отчета без учета НДС (excludingVat). Код ошибки данной проверки: I_139;
    - ставки НДС (vatRate). Код ошибки данной проверки: I_140;
    - суммы НДС в акте/отчете (vat). Коды ошибок данной проверки: I_141, I_142;
    - суммы акта/отчета, включая НДС (includingVat). Коды ошибок данной проверки: I_143, I_151.
  - структуры «Информация о номере и дате акта вознаграждения посредника» (amount.commissionInfo.*). «Информацию о номере и дате акта вознаграждения посредника» возможно передавать только, если данный объект является «Отчетом посредника» (type:intermediary-report). Код ошибки данной проверки: I_138. Структура состоит из:
    - номера акта вознаграждения посредника (number). Поле не является обязательным. Код ошибки данной проверки: I_152;
    - даты акта вознаграждения посредника (date). Данное поле необходимо передавать, только если передан номер акта вознаграждения посредника (number). Коды ошибок данной проверки: I_153, I_154, I_155, I_156.
- Замена поля «Сумма в привязке к каждому изначальному договору» (items.amount) на структуру «Детализация суммы акта в привязке к каждому изначальному договору для выделения НДС» (items.amount.*), которая состоит из:
  - суммы детализации без учета НДС (excludingVat). Код ошибки данной проверки: I_145;
  - ставки НДС (vatRate). Код ошибки данной проверки: I_146;
  - суммы НДС в детализации (vat). Коды ошибок данной проверки: I_147, I_148;
  - суммы детализации, включая НДС (includingVat). Коды ошибок данной проверки: I_149, I_150.
- Ошибка I_90 заменена на I_128: cумма акта/отчета без учета НДС (amount.excludingVat) должна быть больше или равна сумме всех сумм без учета НДС (items.amount.excludingVat) в пунктах разаллокации.
- Ошибки I_119 и I_122 заменены на I_129 и I_130 соответственно: если договор не является безвозмездным (в договоре явным образом указана стоимость договора равная нулю), сумма акта/отчета, включая НДС (amount.includingVat), должна быть больше нуля.
- Добавление признака неактуальности записи (irrelevant). При передаче признака неактуальности записи (irrelevant:true) единственным обязательным для передачи является идентификатор объекта (id), остальные поля являются необязательными.
Метод /statistics:
- Замена поля «Стоимость оказанных услуг» (amount) на структуру «Сведения о стоимостях оказанных услуг для выделения НДС» (amount.*), которая состоит из:
  - суммы детализации без учета НДС (excludingVat). Код ошибки данной проверки: S_86;
  - ставки НДС (vatRate). Код ошибки данной проверки: S_89;
  - суммы НДС в детализации (vat). Коды ошибок данной проверки: S_90, S_91;
  - суммы детализации, включая НДС (includingVat). Коды ошибок данной проверки: S_92, S_93.
- В случае передачи информации об акте (invoiceId) и изначальном договоре (contractId) статистики, стоимость оказанных услуг без учета НДС (amount.excludingVat) всех статистик по этому акту и изначальному договору не должна быть больше суммы, указанной в акте для соответствующего изначального договора. Код ошибки данной проверки: S_88.
- Ошибка S_45 заменена на S_87: если креатив, к которому относится статистика, относится к саморекламе, то стоимость оказанных услуг без учета НДС (amount.excludingVat) должна равняться нулю.

Версия 5.1

12.12.2024

Метод /organization:
- Изменена обязательность поля name. Поле не является обязательным для Юридических лиц (type:ul) и ИП (type:ip). Изменена проверка с кодом ошибки O_14.
Метод /creative:
- Исключение проверки CR_93 — описание медиа данных креатива (mediaData.description) более не является обязательным.
- Внедрение Классификатора категорий товаров и услуг (ККТУ):
  - Добавление поля kktuCodes — Код справочника ККТУ. Необходимо передавать коды третьего уровня из справочника кодов ККТУ. Код ошибки форматной проверки: CR_95. Код ошибки проверки принадлежности указанного кода ККТУ справочнику: CR_96.
  - Если креатив является кобрендинговым (coBranding:true) или контейнером (creativeType:container), разрешается передача нескольких элементов в массиве кодов ККТУ (kktuCodes). Во всех остальных случаях разрешается передача только одного значения кода ККТУ. Код ошибки данной проверки: CR_94.
  Внимание
  
  Начиная с 10.01.2025 поле kktuCodes станет обязательным для заполнения.

Версия 5.0

27.08.2024

Метод /organization:
- Исключение площадок (platforms) из структуры запроса поля. Регистрация площадок будет осуществляться отдельно от контрагентов.
- Указанный ИНН (inn) организации для типов ЮЛ/ИП должен быть зарегистрирован в ЕГРЮЛ/ЕГРИП. Код ошибки данной проверки: O_72.
- Ошибка O_69 теперь распространяется на поле ИНН для ИФЛ и ИЮЛ.
- Ошибка O_10 разделена на две проверки: O_10 и O_13.
- Ошибка O_27 разделена на две проверки: O_27 и O_28.
- Изменены тексты описания следующих ошибок: O_18, O_22, O_24, O_26.
Метод /platforms:
- Исключение «Информационная система» (is) из допустимых типов площадки (type).
- Для площадок из перечня ЕРИР в поле URL необходимо будет передавать ссылку на конкретную страницу в случае прямого размещения рекламы. Перечень площадок может обновляться. Код ошибки данной проверки: P_33.
- Ошибка P_21 разделена на две проверки: P_21 и P_19.
Метод /contract:
- При регистрации дополнительных соглашений (type:additional-agreement) родительский договор (contractId) не может являться дополнительным соглашением. Коды ошибок данной проверки: C_57, C_58, C_59.
- Сумма договора (amount) не может быть равной 0 для посреднических договоров (type:intermediary-contract), а так же для доп. соглашений к договору такого типа. Коды ошибок данной проверки: C_60, C_63.
- Исключение признака «с НДС» (isVat) из структуры запроса, сумму договора необходимо передавать с учетом НДС, если применимо.
- Изменены тексты описания следующих ошибок: C_26.
Метод /creative
- Исключение кодов ОКВЭД (okveds) из структуры запроса.
- Исключение «Иное» (other) из допустимой формы распространения креатива (form).
- Изменение форматно-логического контроля геотаргетинга креативов (targeting:regions). Необходимо передавать коды из справочника кодов регионов. Если геотаргетинг направлен на всю Россию — необходимо передать параметр (targeting.isEntireRussiaRegion:true). Код ошибки данной проверки: CR_79.
- Добавление пола (sexes) в параметры таргетирования (targeting). Возможные значения: male, female. Код ошибки данной проверки: CR_92.
- Добавление возраста (ages) в параметры таргетирования (targeting). Параметры указываются в следующем виде: {минимальный возраст}:{максимальный возраст}, например, 25:45. Код ошибки данной проверки: CR_92.
- Обновление списка допустимых значений для формы распространения креатива (form):
  - text-block — текстовый блок;
  - text-video-block — текстовый блок с видео;
  - text-audio-block — текстовый блок с аудио;
  - text-audio-video-block — текстовый блок с аудио и видео;
  - text-graphic-block — текстово-графический блок;
  - text-graphic-video-block — текстово-графический блок с видео;
  - text-graphic-audio-block — текстово-графический блок с аудио;
  - text-graphic-audio-video-block — текстово-графический блок с аудио и видео;
  - banner — баннер;
  - banner-html5 — HTML5-баннер;
  - video — видеоролик;
  - audio-rec — аудиозапись;
  - live-video — видеотрансляция в прямом эфире;
  - live-audio — аудиотрансляция в прямом эфире.
- Обязательность заполнения текстовых данных креатива (textData) для форм распространения креатива из следующего списка: text-block, text-video-block, text-audio-block, text-audio-video-block, text-graphic-block, text-graphic-video-block, text-graphic-audio-block, text-graphic-audio-video-block. Код ошибки данной проверки: CR_85.
- Обязательность заполнения ссылки на медиаданные (mediaData.mediaUrl) для форм распространения креатива из следующего списка: text-video-block, text-audio-block, text-audio-video-block, text-graphic-block, text-graphic-video-block, text-graphic-audio-block, text-graphic-audio-video-block, banner, banner-html5, video, audio-rec, live-video, live-audio. Код ошибки данной проверки: CR_86.
- Добавление типа файла медиаданных (mediaData.mediaUrlFileType), указанных ссылке на медиаданные (mediaData.mediaUrl). Поле является обязательным для заполнения. Коды ошибок данной проверки: CR_81, CR_89, CR_91, CR_92. Возможные значение:
  - image — изображение;
  - video — видео;
  - audio — аудио;
  - zip — архив (может быть указано только для формы распространения креатива (form) HTML5-баннер (banner-html5). В архиве должны присылаться только HTML5-баннеры. Один баннер — один архив);
  - other.
- Обязательность заполнения описание изображения креатива (mediaData.description), для передавемых изображений (mediaData.mediaUrlFileType:image). Код ошибки данной проверки: CR_93.
- Ошибка CR_67 разделена на две проверки: CR_67 и CR_69.
- Изменены тексты описания следующих ошибок: CR_64, CR_47.
Метод /invoice:
- Сумма в актах должна быть больше нуля. Исключение: акт относится к безвозмездным договорам (subjectType:mediation), когда в договоре явным образом указана стоимость договора, равная 0. Посреднические договор (type:intermediary-contract) не могут быть безвозмездными. Коды ошибок данной проверки: I_119, I_122.
- Если регистрируется акт к посредническому договору (type:intermediary-contract), у которого признак agentActingForPublisher:true, то в ролях сторон акта нельзя передавать роль РД (rd). Коды ошибок данной проверки: I_120, I_121.
- Сумма акта (amount) и суммы в детализация акта (items.amount) должна быть не больше 10 000 000 000.00.
- Исключение признака «с НДС» (isVat) из структуры запроса, сумму акта необходимо передавать с учетом НДС, если применимо.
- Ошибка I_39 разделена на две проверки: I_39 и I_41.
- Изменены тексты описания следующих ошибок: I_32, I_42.
Метод /statistics:
- Стоимость оказанных услуг (amount) и стоимость единицы оказания услуг (amountPerUnit) быть не больше 10 000 000 000.00000.
- Исключение признака «с НДС» (isVat) из структуры запроса , стоимость оказанных услуг необходимо передавать с учетом НДС, если применимо.
- Обязательность заполнения типа рекламной кампании (type). Код ошибки данной проверки: E_S_4.
- Ошибка S_7 разделена на две проверки: S_7 и S_10.
- Ошибка S_11 разделена на две проверки: S_11 и S_13.
- Ошибка S_19 разделена на две проверки: S_19 и S_23.
- Ошибка S_24 разделена на две проверки: S_24 и S_28.
- Ошибка S_29 разделена на две проверки: S_29 и S_33.
- Ошибка S_34 разделена на две проверки: S_34 и S_36.
- Ошибка S_37 разделена на две проверки: S_37 и S_39.
Метод /status:
- Статус ErirSuccess разделен на ErirSyncSuccess (успешность прохождения форматного контроля в ЕРИР) и ErirAsyncSuccess (успешность прохождения логического контроля в ЕРИР). ErirAsyncSuccess — финальный статус прохождения проверок.
- Статус ErirError разделен на ErirSyncError (ошибка прохождения форматного контроля в ЕРИР) и ErirAsyncError (ошибка прохождения логического контроля в ЕРИР).

Версия 4.0

08.02.2024

Метод /organization:
- Поле platformId становится обязательным (в случае указания массива platforms).
- Добавление проверки на поле epayNumber (номер электронного средства платежа), поле может быть заполнено только для иностранного физ. лица.
- Добавление проверки на поле regNumber (регистрационный номер либо его аналог), поле может быть заполнено только для иностранного юр. лица.
- Добавление проверки на поле alternativeInn (номер налогоплательщика либо его аналог в стране регистрации), поле может быть заполнено только для иностранного юр. лица или иностранного физ. лица.
- Удаление поля okveds (по-прежнему требуется в методе /creative).
Метод /contract:
- Поле type становится обязательным.
Метод /creative:
- Скалярное значение идентификатора изначального договора/доп.соглашения изменено на массив.
- Поля isSocial, isNative становятся обязательными для типов креатива creative и container.
Метод /platforms
- Поле platformId становится обязательным.
Метод /statistics:
- Вместо кода ошибки S_31 будет отдаваться код ошибки S_26 (также изменится текстовое описание ошибки).
- Вместо кода ошибки S_21 будет отдаваться код ошибки S_16 (также изменится текстовое описание ошибки).
- Поле impsPlan становится обязательным.

Обратно совместимые изменения API Яндекс ОРД:

Метод /creative:
- Добавление поля coBranding.
- Корректировка валидаций на поле okveds: допускается указание 00.00 в случае отсутствия кода ОКВЭД.
Метод /statistics:
- Поле id в статистике становится необязательным. Если поле не указано, то будет использоваться составной ключ {creativeId}_{platformId}_{month} (month — год и месяц из поля dateStartPlan), если передается еще идентификатор акта и договора, то — {creativeId}_{platformId}_{month}_{invoiceId}_{contractId}.
- Ослабление валидации S_43: dateStartFact и dateEndFact обязаны быть в одном месяце, в случае если не указан идентификатор акта.
- Ослабление валидации S_44: dateStartPlan и dateEndPlan обязаны быть в одном месяце, в случае если не указан идентификатор акта.
- Добавление валидации S_75: Если dateEndFact > 30.09.2023 и invoiceId заполнено, то дата dateEndFact должна быть в том же месяце, что и dateStartFact.
- Добавление валидации S_76: Если dateEndPlan > 30.09.2023 и invoiceId заполнено, то дата dateEndPlan должна быть в том же месяце, что и dateStartPlan.
- Добавление необязательного поля type для указания типа рекламной кампании.
Метод /invoice:
- Ослабление ограничения на поле endDate: поле endDate не должно содержать дату позже 2100-12-31.
Корректировки валидаций
- Корректировки описаний валидаций на стороне API Яндекс ОРД в связи с объединением подмножества проверок на стороне API ЕРИР.

Версия 3.0

01.09.2023

Расширен состав валидаций.
Поддержана возможность передачи статистики отдельно от актов благодаря новым методам: /statistics, /invoice/creatives.
Изменился способ маркировки саморекламы: в метод /creative добавлено дополнительное поле selfPromotionOrganizationId — идентификатор организации, к которому относится саморекламный креатив.

Была ли статья полезна?

Подключение к API

Общие вопросы