Какие данные принимает ЕРИР - Состав передаваемых данных

№

Код поля

Описание поля

Тип (ограничения)

Обязательность

Описание

Атрибуты организации (Organization)

1

id

Идентификатор организации

строка (255)

Обязательно

Идентификатор организации

2

type

Тип организации

строка (3)

Обязательно

Возможные значения:

ffl - Иностранное физическое лицо; ful - Иностранное юридическое лицо;

ip - Индивидуальный предприниматель; fl - Физическое лицо;

ul - Юридическое лицо.

3

isOrs

Является ОРС

булево

Обязательно

Возможные значения: true / false

4

isRr

Является РР

булево

Обязательно

Возможные значения: true / false

5

inn

ИНН

строка (12)

Условно обязательно

Обязательно для заполнения для следующих типов организаций:

ip - Индивидуальный предприниматель; fl - Физическое лицо;

ul - Юридическое лицо.

6

name

ОПФ и полное наименование

строка (255)

Обязательно

ОПФ и наименование организации

7

mobilePhone

Абонентский номер мобильного телефона

строка (50)

Условно обязательно

Обязательно для заполнения для типа организации ffl - Иностранное физическое лицо.

Если не заполнено, то должно быть заполнено epayNumber

8

epayNumber

Номер электронного средства платежа

строка (255)

Условно обязательно

Обязательно для заполнения для типа организации ffl - Иностранное физическое лицо.

Если не заполнено, то должно быть заполнено mobilePhone

9

regNumber

Регистрационный номер либо его аналог

строка (255)

Условно обязательно

Обязательно для заполнения для типа организации ful - Иностранное юридическое лицо.

Если не заполнено, то должно быть заполнено alternativeInn

10

alternativeInn

Номер налогоплательщика либо его аналог в стране регистрации

строка (255)

Условно обязательно

Обязательно для заполнения для типов организации:

ful - Иностранное юридическое лицо. Если не заполнено, то должно быть заполнено regNumber;

ffl - Иностранное физическое лицо, если стоит признак isOrs=true

11

oksmNumber

Код страны регистрации юрлица в соответствии с ОКСМ

строка (3)

Условно обязательно

Обязательно для заполнения для следующих типов организаций:

1. ffl - Иностранное физическое лицо;
2. ful - Иностранное юридическое лицо.

12

rsUrl

Сведения об ИС и (или) программе для ЭВМ, которые предназначены и используются ОРС для организации распространения в сети «Интернет» рекламы

строка (2000)

Условно обязательно

Обязательно для всех типов организаций, если признак isOrs = true

Сведения о площадках контрагента (Platforms)

Условно обязательно

Обязателен для организаций, у которых признак isOrs=true или isRr=true

Если оба признака false, то площадки не будут зарегистрированы

13

platformId

Идентификатор площадки в ОРД

строка (255)

Обязательно

14

type

Тип площадки

строка (4)

Обязательно

Возможные значения:

is - Информационная система; apps - Приложение;

site - Сайт.

15

isOwned

Площадка принадлежит контрагенту

булево

Обязательно

Возможные значения: true / false

16

name

Название сайта (блога), приложения или иные способы адресации

строка (100)

Обязательно

17

url

URL площадки или приложения в сторе

строка (2000)

Условно обязательно

Необязательно, если тип площадки равен is - Информационная система

№

Код поля

Описание поля

Тип (ограничения)

Обязательность

Описание

Атрибуты площадки (Platforms)

1

organizationId

Идентификатор контрагента в ОРД

строка (255)

Необязательно

2

irrelevant

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

булево

Условно обязательно

В случае необходимости удаления площадок необходимо передать атрибут во входных параметрах со значением “true”. В остальных случаях атрибут исключить из входных

Сведения о площадках контрагента (Platforms)

Условно обязательно

Обязателен для организаций, у которых признак isOrs=true или isRr=true

3

platformId

Идентификатор площадки в ОРД

строка (255)

Обязательно

4

type

Тип площадки

строка (4)

Обязательно

Возможные значения:

is - Информационная система; apps - Приложение;

site - Сайт.

5

isOwned

Площадка принадлежит контрагенту

булево

Обязательно

Возможные значения: true / false

6

name

Название сайта (блога), приложения или иные способы адресации

строка (100)

Обязательно

7

url

URL площадки или приложения в сторе

строка (2000)

Условно обязательно

Необязательно, если тип площадки равен is - Информационная система

№

Код поля

Описание поля

Тип (ограничения)

Обязательность

Описание

Атрибуты договора и (или) дополнительного соглашения (Contracts)

1

id

Идентификатор договора/доп. соглашения в ОРД

строка (255)

Обязательно

2

type

Тип договора

строка (30)

Обязательно

Возможные значения:

intermediary-contract - Посреднический договор;

contract - Договор оказания услуг; additional-agreement - Дополнительное соглашение;

self-promotion - Самореклама

3

clientId

Идентификатор Контрагента- заказчика в ОРД

строка (255)

Обязательно

4

contractorId

Идентификатор Контрагента- исполнителя в ОРД

строка (255)

Обязательно

5

isRegReport

На исполнителе лежит обязанность регистрировать и репортить креативы

булево

Обязательно

Возможные значения: true / false

6

actionType

Описание осуществляемых посредником-представителем действий

строка (20)

Условно обязательно

Возможные значения:

other - Иное;

distribution - Действия в целях распространения рекламы; conclude - Заключение договоров; commercial - Коммерческое представительство.

7

subjectType

Сведения о предмете договора

строка (20)

Обязательно

Возможные значения:

other - Иное;

org-distribution - Договор на организацию распространения рекламы;

mediation - Посредничество;

distribution - Договор на распространение рекламы.

8

number

Номер договора / доп.соглашения

строка (255)

Необязательно

9

date

Дата договора / доп.соглашения

дата в формате yyyy-mm-dd

Обязательно

10

amount

Сумма договора / доп.соглашения

число с плавающей запятой

Необязательно

11

isVat

Признак "с НДС"

булево

Обязательно

Возможные значения: true / false

12

contractId

Идентификатор родительского договора, если регистрируется доп.соглашение

строка (255)

Условно обязательно

Если тип договора равен "additional- agreement" - Дополнительное соглашение, то указывается. В других случаях атрибут исключается

№

Код поля

Описание поля

Тип (ограничения)

Обязательность

Описание

Атрибуты креатива (Сreative)

1

id

Идентификатор креатива в ОРД

строка (255)

Обязательно

2

contractId

Изначальный договор/доп.соглашение (id)

строка (255)

Обязательно

3

description

Общее описание объекта рекламирования

строка (1000)

Обязательно

4

type

Тип РК

строка (5)

Обязательно

Возможные значения: other - Иное;

cpm - CPM; cpc - CPC; cpa - CPA.

5

form

Форма распространения рекламы

строка (30)

Обязательно

Возможные значения:

video - Видеоролик;

text-graphic-block - Текстово-графический блок; text-block - Текстовый блок;

other - Иное;

live-video - Видеотрансляция в прямом эфире;

live-audio - Аудиотрансляция в прямом эфире;

banner - Баннер;

audio-rec - Аудиозапись.

6

isSocial

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

булево

Обязательно

Возможные значения: true / false

7

isNative

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

булево

Обязательно

Возможные значения: true / false

8

targetAudience

Параметры целевой аудитории рекламы

строка (255)

Условно обязательно

Параметры целевой аудитории рекламы (Может быть заполнен в случае отсутствия targetAudienceList, но не может быть заполнен при наличие targetAudienceList))

ОКВЭД (creativeOkveds)

Условно обязательно

В случае отсутствия кода ОКВЭД допускается передача пустого массива данных, только если тип организации владельца креатива:

ip - Индивидуальный предприниматель; ul - Юридическое лицо.

9

creativeOkveds

Коды ОКВЭД для объекта рекламирования

строка (255)

Условно обязательно

Целевая ссылка (url)

Необязательно

Если у креатива отсутствует целевая ссылка, то передавать данный массив не нужно.

10

creativeUrl

Целевая ссылка (URL)

строка (2000)

Обязательно

Параметры целевой аудитории рекламы (targetAudienceList)

Условно обязательно

Параметры целевой аудитории рекламы (Может быть заполнен в случае отсутствия targetAudience, но не может быть заполнен при наличие targetAudience)

11

type

Тип

строка (20)

Обязательно

Возможные значения: geo - город, регион

12

values

Значение

строка (2000)

Обязательно

В элементах массива передаются UUID городов и регионов из справочника ГАР ФИАС. Если массив пустой, то геотаргетинг направлен на всю Россию

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

13

textData

Текстовые данные креатива

строка (65000)

Условно обязательно

Должно быть заполнено, только если пустое mediaUrl

14

description

Описание изображения креатива

строка (1000)

Необязательно

15

mediaUrl

Ссылка на образец

строка (2000)

Условно обязательно

Должно быть заполнено, только если пустое textData

16

hash

Хеш каждого из медиаданных креатива

строка (64)

Обязательно

№

Код поля

Описание поля

Тип (ограничения)

Обязательность

Описание

Атрибуты акта (invoices)

1

id

Идентификатор акта в ОРД

строка (255)

Обязательно

2

contractId

Идентификатор договора в ОРД

строка (255)

Обязательно

3

clientRole

Роль заказчика в акте

строка (3)

Обязательно

Роль заказчика в акте. Возможные значения:

ra - Рекламное агентство;

rr - Рекламораспространитель;

ors - Оператор рекламной системы; rd - Рекламодатель

4

contractorRole

Роль исполнителя в акте

строка (3)

Обязательно

Роль исполнителя в акте. Возможные значения:

ra - Рекламное агентство;

rr - Рекламораспространитель;

ors - Оператор рекламной системы; rd - Рекламодатель

5

date

Дата акта

дата в формате yyyy-mm-dd

Обязательно

6

startDate

Дата начала периода

дата в формате yyyy-mm-dd

Обязательно

7

endDate

Дата окончания периода

дата в формате yyyy-mm-dd

Обязательно

8

amount

Сумма акта

число с плавающей запятой

Обязательно

9

isVat

Признак "с НДС"

булево

Обязательно

Возможные значения: true / false

10

number

Номер акта

строка (255)

Необязательно

Детализация акта по атрибутам изначального договора (items)

11

invoiceItemId

Идентификатор детализации акта по изначальному договору

строка (255)

Обязательно

12

contractId

Идентификатор изначального договора / доп.соглашения в ОРД

строка (255)

Обязательно

13

amount

Сумма в привязке к каждому изначальному договору

число с плавающей запятой

Обязательно

14

isVat

Признак "с НДС"

булево

Обязательно

Возможные значения: true / false

Детализация по креативам за период акта (creatives)

Условно обязательно

15

creativeId

Идентификатор креатива

строка (255)

Обязательно

Данные по креативу в разрезе по площадкам (platforms)

Условно обязательно

16

platformId

Идентификатор площадки

строка (255)

Обязательно

17

impsFact

Количество показов фактическое

число

Обязательно

18

impsPlan

Количество показов по акту

число

Обязательно

19

dateStartFact

Дата начала показов фактическая

дата в формате yyyy-mm-dd

Обязательно

20

dateEndFact

Дата окончания показов фактическая

дата в формате yyyy-mm-dd

Обязательно

21

dateStartPlan

Дата начала показов по акту

дата в формате yyyy-mm-dd

Обязательно

22

dateEndPlan

Дата окончания показов по акту

дата в формате yyyy-mm-dd

Обязательно

23

amount

Стоимость оказанных услуг

число с плавающей запятой

Обязательно

24

amountPerShow

Стоимость единицы оказания услуг

число с плавающей запятой

Обязательно

Если деньги списываются за клик, то указывается стоимость клика.

Если деньги списываются за показы, то стоимость указывается за 1000 показов. Если деньги списываются за действие, то стоимость указывается за какое-то действие.

25

isVat

Признак "с НДС"

булево

Обязательно

Возможные значения: true / false

Сведения о выявленных несоответствиях в предоставленной РД/РР/ОРС в ОРД информации о распространенной в сети «Интернет» рекламе

(violations)

26

description

Сведения о выявленных несоответствиях в предоставленной РД/РР/ОРС в ОРД информации о распространенной в сети

«Интернет» рекламе

строка (2000)

Необязательно

№

Код поля

Описание поля

Тип (ограничения)

Обязательность

Описание

Атрибуты акта (invoices-statistics)

1

id

Идентификатор акта в ОРД

строка (255)

Обязательно

Детализация акта по атрибутам изначального договора (items)

Условно обязательно

2

invoiceItemId

Идентификатор детализации акта по изначальному договору

строка (255)

Обязательно

Детализация по креативам за период акта (creatives)

Условно обязательно

3

creativeId

Идентификатор креатива

строка (255)

Обязательно

Данные по креативу в разрезе по площадкам (platforms)

Условно обязательно

4

platformId

Идентификатор площадки

строка (255)

Обязательно

5

impsFact

Количество показов фактическое

число

Обязательно

6

impsPlan

Количество показов по акту

число

Обязательно

7

dateStartFact

Дата начала показов фактическая

дата в формате yyyy-mm-dd

Обязательно

8

dateEndFact

Дата окончания показов фактическая

дата в формате yyyy-mm-dd

Обязательно

9

dateStartPlan

Дата начала показов по акту

дата в формате yyyy-mm-dd

Обязательно

10

dateEndPlan

Дата окончания показов по акту

дата в формате yyyy-mm-dd

Обязательно

11

amount

Стоимость оказанных услуг

число с плавающей запятой

Обязательно

12

amountPerSho

Стоимость единицы оказания услуг

число с плавающей запятой

Обязательно

Если деньги списываются за клик, то указывается стоимость клика.

Если деньги списываются за показы, то стоимость указывается за 1000 показов. Если деньги списываются за действие, то стоимость указывается за какое-то действие.

13

isVat

Признак "с НДС"

булево

Обязательно

Возможные значения: true / false