Маркировка erid

API маркировки рекламы: erid, отчёты в ЕРИР

API маркировки рекламы: erid, публикации, отчёты в ЕРИР

API позволяет автоматически выпускать erid-токены для рекламы в MAX, регистрировать публикации и сдавать отчёты в ЕРИР (включая корректировки уже сданных отчётов) из вашего кода — без личного кабинета.

Все запросы идут на единый адрес:

https://htmlweb.ru/api.php?api_key=ВАШ_API_KEY&obj=ord_vk&m=МЕТОД&параметры

Параметры можно передавать как GET, так и POST запросом, можно комбинировать. Рекомендуем POST — он не сохраняется в кеше браузера и в логах прокси-серверов. Поддерживается и JSON-тело запроса (Content-Type: application/json — тогда api_key, obj, m и параметры передаются в JSON).

api_key — ключ из вашего профиля htmlweb.ru: htmlweb.ru/user/api.php (32 символа). Ключ даёт полный доступ к данным вашего аккаунта — не публикуйте его в открытом коде. Через API видны и доступны только ваши макеты, публикации и отчёты.

Не требуется автоматизация? Простой выпуск erid — на странице «erid за 20 ₽».

Формат ответа — добавьте параметр &json для машинного JSON; без него ответ приходит читаемой HTML-таблицей (удобно смотреть в браузере). При успехе {"status":200, ...}, при ошибке {"status":400, "error":"текст"}. Коды: 400 — ошибка в данных, 403 — нет доступа (неверный api_key), 404 — не найдено, 429 — превышен лимит попыток входа.

Статус маркировки и баланс

Перед выпуском токенов проверьте, что маркировка доступна и на балансе достаточно средств:

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=status

Ответ:

{"status":200,"ready":true,"balance_ord_vk":2990,"price_token":20,
 "gate":null,"mode":"our"}

ready=true — можно выпускать erid. price_token — стоимость выпуска одного токена в рублях (списывается с баланса htmlweb или привязанной карты). gate не пустой — маркировка временно заблокирована, в gate.reason причина (например low_balance — пополните баланс платформы, пополнение: кабинет).

Как получить erid для саморекламы через API?

Самореклама — вы рекламируете собственный ресурс в собственном канале: и рекламодатель, и рекламораспространитель — вы сами. Договор с самим собой не заключается, отчёт сдаётся как обычно.

Шаг 1. Выпустите erid-токен методом creative, указав свой ИНН в advertiser_inn:

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=creative
    &text=Продажа автомобиля Lada Vesta, 2022 года
    &advertiser_inn=ВАШ_ИНН
    &urls=https://max.ru/id123456_biz

В ответе придёт {"status":200,"creative_id":123,"erid":"Xk2…","publications":[]} — erid выпущен, с баланса списана стоимость токена (20 ₽). Токен ещё ни к чему не привязан — публикуйте пост.

Шаг 2. После публикации добавьте карточку публикации методом pub, указав свой же ИНН как рекламораспространителя (совпадение ИНН = самореклама, договор не создаётся):

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=pub
    &creative_id=123
    &inn=ВАШ_ИНН
    &url=https://max.ru/id123456_biz4/AaEAqhyNXl8
    &date_start=2026-10-04&date_end=2026-10-04
    &pay_type=cpm&shows=172&amount=500

Отчёт автоматически уйдёт в ЕРИР на следующий день после date_end. Если точное число показов на момент публикации неизвестно — поставьте приблизительное и скорректируйте отчёт позже (см. «Как исправить уже сданный отчёт»).

Как сдать отчёт за рекламу, размещённую на чужом канале?

Если пост выходит в канале, который вам не принадлежит, — между вами и владельцем канала возникают отношения «рекламодатель ↔ рекламораспространитель», и по закону нужен договор. Платформа делает это автоматически:

Шаг 1. Узнайте ИНН владельца канала (рекламораспространителя) — запросите у владельца. Проверить корректность ИНН можно методом inncheck (см. ниже): он вернёт наименование организации/ИП из реестра — вы убедитесь, что ИНН принадлежит именно контрагенту.

Шаг 2. Выпустите erid, указав ИНН рекламодателя (ваш — если рекламируете свой товар):

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=creative
    &text=Скидка 20% на весь месяц в фитнес-клубе
    &advertiser_inn=614704334828
    &urls=https://your-site.ru

Шаг 3. Добавьте публикацию с ИНН владельца канала в параметре inn. ИНН разные — платформа автоматически зарегистрирует договор «рекламодатель ↔ рекламораспространитель» в ЕРИР и привяжет к нему отчёт:

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=pub
    &creative_id=123
    &inn=615016514444
    &url=https://max.ru/id615016514444_biz4/AaEAqhyNXl8
    &date_start=2026-10-04&date_end=2026-10-31
    &pay_type=cpm&shows=136&amount=3000

По итогам месяца по каждой паре «рекламодатель ↔ рекламораспространитель» автоматически формируется и сдаётся акт.

Как отчитаться за рекламу, которую я оплатил на бирже?

Если вы оплатили размещение на бирже htmlweb (например, 13 493 ₽ за сетку каналов) — маркировка входит в заказ: после публикации боты сами регистрируют публикации и сдают отчёты в ЕРИР, вам ничего делать не нужно. Проверить состояние можно методом pubs:

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=pubs&limit=50

В ответе по каждой публикации: publisher_inn (владелец канала), период, показы, сумма и статус отчёта: wait — период не закончился, sent — сдан в ЕРИР, error — отказ (текст в поле error).

Как узнать реальные показы поста?

Метод autofill по ссылке на пост возвращает фактические просмотры поста (не подписчиков канала) и дату публикации — готовые значения для отчёта:

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=autofill
    &url=https://max.ru/id615016514444_biz4/AaEAqhyNXl8

Ответ:

{"status":200,"chat":-78581626255460,
 "name":"Москва. Мероприятия. Я местный!",
 "shows":172,"shows_real":1,"shows_upd":"просмотры поста",
 "date_start":"2026-10-04","date_end":"2026-10-04"}

shows_real=1 — это просмотры конкретного поста (счётчик MAX, растёт по мере досмотра). shows_real=0 — пост недоступен, возвращены подписчики канала: используйте их как оценку или подставьте фактические показы вручную. Помните: счётчик просмотров «живёт» недолго — снимайте показания и сдавайте отчёт в течение суток после окончания публикации, потом скорректируйте.

Как исправить уже сданный отчёт?

Показы поста растут и после сдачи отчёта, или вы ошиблись в сумме. Метод report_update: если отчёт ещё не сдан — обновляются его данные; если уже сдан — в ЕРИР отправляется корректировка: ОРД перезаписывает отчёт по прежнему идентификатору, дублей не создаётся. Корректировать можно сколько угодно раз.

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=report_update
    &pub=7
    &date_start=2026-10-04&date_end=2026-10-31
    &shows=1951&amount=1000

pub — идентификатор публикации из метода pubs. Сумма обязательна — отчёты без стоимости в ЕРИР не принимаются. Рекомендуемая практика: сдайте предварительный отчёт сразу после публикации, а финальную корректировку сделайте по окончании периода, когда счётчик просмотров остановился.

Как проверить ИНН контрагента?

Метод inncheck проверяет контрольную сумму ИНН и возвращает реквизиты из ЕГРЮЛ/ЕГРИП — вы убедитесь, что ИНН принадлежит именно вашему контрагенту:

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=inncheck&inn=615016514444

Ответ:

{"status":200,"item":{"inn":"615016514444",
 "name":"ИП Маркина Анна Александровна","status":"ACTIVE","npd":0,"phys":0}}

status — состояние из реестра (ACTIVE — действующая). npd=1 — самозанятый, phys=1 — физлицо вне ЕГРЮЛ/ЕГРИП: для договора в обоих случаях дополнительно укажите его ФИО в параметре fio карточки публикации. Неверная контрольная сумма ИНН — ошибка возвращается сразу, запросы к реестрам не тратятся.

Список макетов и выпущенных erid

https://htmlweb.ru/api.php?api_key=API_KEY&obj=ord_vk&json&m=creatives&limit=50

Ответ:

{"status":200,"items":[{"id":23,"erid":"2VtzqvpZDrC","advertiser_inn":"614704334828",
 "status":"registered","erir_status":"processing","time":"2026-10-02 10:26:43"},…]}

erir_status — статус обработки токена реестром: processing — принят, ожидает обработки (до двух суток — норма), verified/ok — подтверждён.

Параметры макета и публикации

textТекст рекламного макета (или медиа + краткий текст)
media_urlСсылка на фото/видео макета (jpg, png, mp4…)
urlsСсылки перехода (кнопки под постом), до 10; в публикации в них подставляется erid
advertiser_innИНН рекламодателя — чей товар/услуга рекламируются. Сохраняется в профиле
publisher_inn / innИНН рекламораспространителя — владельца канала, где выйдет пост. Совпадает с рекламодателем — самореклама
name, category, descriptionНазвание/бренд, категория, описание — для ОРД (по умолчанию из текста)
kktuКод ККТУ — категория рекламируемых товаров/услуг, по умолчанию 30.15.1
targetingЦелевая аудитория рекламы
noteПримечание для себя (до 500 символов) — никуда не отправляется, видно только вам в кабинете
social, social_quotaСоциальная реклама / социальная реклама по квоте
url (публикация)Ссылка на опубликованный пост
date_start, date_endФактический период публикации, ГГГГ-ММ-ДД; в пределах одного месяца, не в будущем
pay_typeТип платного события: cpm — за 1000 показов, cpv, cpa, fixed и др.
showsФактическое количество показов (просмотров поста)
shows_paidОплаченное количество показов, если отличается
amountСумма размещения, ₽ (обязательна для сдачи отчёта; взаимная реклама — 0)
cpmСтоимость 1000 показов/события — если не указана, рассчитается из суммы и показов
vat_rateСтавка НДС: without_vat (по умолчанию), 0, 10, 20
fioФИО физлица-контрагента (если inncheck вернул npd=1 или phys=1) — обязательны реквизиты

Оплата

Выпуск erid — 20 ₽ (параметр price_token в m=status). Списание — с баланса htmlweb.ru, при нехватке — с привязанной карты (привязывается при первой оплате в кабинете). Методы pub, report, report_update — бесплатно: отчётность в ЕРИР входит в стоимость токена. Неудачный выпуск (ОРД не принял макет) — списания нет, erid не выпускается.

Типовые ошибки

Неверный api_keyКлюч из профиля htmlweb.ru, 32 символа. Не подтверждена почта — подтвердите
Отчёт без суммы не сдаётсяУкажите amount в публикации или корректировке
Неверная контрольная сумма ИННОпечатка в ИНН контрагента — исправьте; запросы к реестрам не тратились
Организация с таким ИНН не найденаЮрлицо нет в ЕГРЮЛ. Физлицу (12 знаков) реестры не нужны — укажите его ФИО в параметре fio
Маркировка временно недоступнаСмотрите m=status: пополните баланс платформы или дождитесь снятия сбоя
Период должен быть в пределах одного месяцаТребование ЕРИР: разбейте длинный период на месячные отчёты
MAX сообщает: чат по этой ссылке не найденВзята устаревшая ссылка на пост — «Копировать ссылку» заново

Остались вопросы — напишите в поддержку @kdg22.

Другие API htmlweb.ru — каталог API: гео, телефон, ИНН/ЕГРЮЛ, почта, банки, QR, СМС. Проверка реквизитов контрагента — API проверки ИНН, КПП, ОГРН, р/с.