VK ORD API News

Уважаемые пользователи! Чтобы у вас сохранялся доступ к ОРД непрерывно (это особенно важно для пользователей API), и вам не приходилось следить за окончанием тарифа и продлевать его вручную, мы добавили возможность автопродления. Как работает автопродление тарифа: Когда старый тариф закончится, система купит новый автоматически, если на вашем балансе достаточно средств. Автопродление можно в любой момент отключить в настройках. Оно не блокирует смену тарифа вручную. Для подключения через интерфейс: • Перейдите в раздел Управление оплатой • Нажмите «Выбрать» тариф • Внизу модального окна нажмите «Подключить автопродление» Для подключения через API добавили в API методы POST/GET /v1/billing/tariff_auto_buy, детали в swagger.

Открыли публичное API для работы с биллингом, описание с сваггере обновлено. API будет расширяться в дальнейшем.

Уважаемые пользователи! Обратите внимание на новый порядок верификации. Если данные собственного контрагента и реквизиты плательщика совпадают, система верифицирует пользователя автоматически после пополнения баланса. Вам не потребуется предпринимать дополнительных действий. Если данные собственного контрагента и плательщика отличаются, вам потребуется пройти верификацию через VK Бизнес ID самостоятельно. Пожалуйста, учитывайте, что подключение тарифа станет возможным только после успешного завершения верификации (автоматической или через VK Бизнес ID). Данные меры введены для обеспечения достоверности сведений, передаваемых в ЕРИР. Новый порядок позволит избежать передачи данных за постороннее лицо и поможет избежать штрафных санкций в отношении пользователей.

Уважаемые пользователи! Тестовый период в ОРД VK завершится 5 мая. Чтобы ваша работа не прерывалась, нужно будет подключить тариф. Кнопка «Подключить тариф» станет доступна 4 мая. Если вы пополните баланс заранее, то 4 мая вам останется только нажать одну кнопку. С уважением, Команда VK ОРД!

Уважаемые пользователи API! Информируем вас, что сегодня была опубликована новая оферта: https://ord.vk.com/offer. Обращаем ваше внимание на сжатые сроки для её акцепта. Если вы не акцептуете оферту до 1 апреля 2026 г. (включительно), то доступ к передаче данных в ЕРИР для пользователей API будет недоступен. Если вы желаете продолжать использовать VK ОРД, то, пожалуйста, войдите в свой личный кабинет ОРД, ознакомьтесь с условиями новой оферты и акцептуйте её. С уважением, команда VK ОРД!

Уважаемые пользователи, 26 февраля 2026 года будут отключены устаревшие версии API v3/invoice и v2/statistics. Вместо них нужно использовать группы эндпоинтов v4/invoice и v3/statistics соответственно.

Сегодня (21 января) с 22:00 до 23:59 API будет недоступно в связи с проведением плановых технических работ.

Отличные новости для пользователей, чьё количество записей измеряется десятками тысяч и более! Мы оптимизировали работу системы под большие объёмы данных. Теперь вы сможете просматривать и управлять всеми своими записями не только через API, но и через интерфейс.

Для удобства использования API теперь в последней версии группы методов содержатся все актуальные эндпоинты. Например, для актов это v4/invoice, теперь можно использовать v4/invoice/{external_id}/ready, который идентичен по своему функционалу v2/invoice/{external_id}/ready. Такая политика будет сохраняться и в следующих версиях.

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

Если расчетная Сумма НДС < 0.1 руб., то Сумма НДС указывается с точностью от 2 до 5 знаков (i) после запятой. Если расчётная сумма НДС меньше 0,10 руб., допускается погрешность. Но итоговая сумма НДС должна находиться в диапазоне: От: значения, округлённого вниз до i-го знака (включительно) До: значения, округлённого математически до i-го знака, плюс 5 * 10⁻ⁱ руб. Указанная погрешность не может превышать 50% от суммы без НДС. 5) Если "Ставка НДС" = "without_vat" или "Ставка НДС" = "0", то "Сумма НДС для стоимости оказанных услуг" должна быть равна 0.

9) В новой версии API актов v4/invoice поле items.amount.vat_rate может принимать значения: • "without_vat" (Без НДС), • "0", • "5", • "7", • "10", • "20". 10) Если акт создан к договору оказания услуг (либо дополнительное соглашение к такому договору), то поле items.amount.vat_rate должно быть обязательно заполненно 11) Если договор, к которому создан акт, имеет тип Посреднический договор (либо дополнительное соглашение к такому договору), договор в детализации является посредническим с признаком agent_acting_for_publisher (либо дополнительным соглашением к такому договору), то поле items.amount.vat_rate должно быть обязательно заполненно * Для поля items.amount.vat (Сумма НДС в детализации): 12) добавлен форматный контроль: Если поле items.amount.vat_rate (Ставка НДС в детализации) НЕ передана, то поле items.amount.vat (Сумма НДС в детализации) должно быть больше 0 и не должно быть больше произведения максимальной ставки НДС в РФ (20%) items.amount.excluding_vat (Сумма детализации без учета НДС) с учетом предусмотренной погрешности. Описание расчета: 0 < Если расчетная Сумма НДС >= 0.5 руб., то Переданная Сумма НДС <= m, где m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб. Если расчетная Сумма НДС < 0.5 руб., то 0 < Переданная Сумма НДС <= m, где m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС. Если расчетная Сумма НДС < 0,10 руб., то 0 <= Переданная Сумма НДС <= m, где m - 50% от Суммы без НДС, с учетом математического округления до 2-го знака." 13) Если "Ставка НДС в детализации" передана, то "Сумма НДС в детализации" должна быть равна произведению "Суммы детализации без учета НДС" на "Ставку НДС в детализации" с учетом предусмотренной погрешности. Описание расчета: Если расчетная Сумма НДС >= 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб. Если расчетная Сумма НДС < 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС. 14) Если "Ставка НДС в детализации" = "without_vat" или "Ставка НДС в детализации" = "0", то "Сумма НДС в детализации" должна быть равна 0. 15) Запрещается передавать order_contract_external_id (Идентификатор посреднического договора, по поручению которого был заключен договор), если в переданном посредническом договоре (по поручению) Заказчик является иностранным лицом СТАТИСТИКА 1) Если регистрируется статистика по креативу, который относится к саморекламе, то площадка с признаком is_owner=true должна быть зарегистрирована у контрагента, указанного в креативе. 2) Поле amount.excluding_vat (Стоимость оказанных услуг без учета НДС) не может быть больше нуля, если поле amount_per_event (Стоимость единицы оказания услуг) равна нулю. 3) В новой версии API статистик v3/statistics поле amount.vat_rate может принимать значения: • "without_vat" (Без НДС), • "0", • "5", • "7", • "10", • "20". 4) Поле amount.vat (Сумма НДС для стоимости оказанных услуг) должно быть равно произведению amount.excluding_vat (Сумма без НДС) на amount.vat_rate (Ставка НДС) с учетом предусмотренной погрешности. Описание расчета: Если расчетная Сумма НДС >= 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб. Если 0.1 руб. <= Сумма НДС < 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС.

В рамках поддержки нововведений и требований со стороны ЕРИР а нашем API проведены доработки: ПЕРСОНЫ Контрагент не может быть изменен, если после обновления в одном из договоров противоположной стороной является контрагент с таким же ИНН/foreign_registration_number/foreign_inn. ПЛОЩАДКИ Добавлены новые типы площадок: smarttv и hbbtv. Для этих новых типов поле "url" не обязательно. ДОГОВОРЫ Признак is_charge_paid_by_agent не может быть передан, если в договоре НЕ указан признак agent_acting_for_publisher и исполнитель в договоре иностранное лицо. АКТЫ 1) В новой версии API актов v4/invoice поле amount.services.vat_rate (Ставка НДС) может принимать значения: • "without_vat" (Без НДС), • "0", • "5", • "7", • "10", • "20" В версии v3/invoice можно по-прежнему передавать другие значения, в том числе дробные, но в скором времени эта возможность будет закрыта. 2) Поле amount.services.vat_rate (Ставка НДС) обязательно к заполнению, если: - акт создан к договору оказания услуг (либо дополнительное соглашение к такому договору) - акт создан к посредническому договору с признаком agent_acting_for_publisher (либо дополнительному соглашению к такому договору) 3) Если поле amount.services.vat_rate (Ставка НДС) НЕ передано, то amount.services.vat (Сумма НДС) должна быть больше 0 и не должна быть больше произведения максимальной ставки НДС в РФ (20%) на amount.services.excluding_vat (Сумму акта/отчета по услугам без НДС) с учетом предусмотренной погрешности. Описание расчета: Если расчетная Сумма НДС >= 0.50 руб., то Переданная Сумма НДС <= m, где m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб. Если расчетная Сумма НДС < 0.50 руб., то 0 < Переданная Сумма НДС <= m, где m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС. Если расчетная Сумма НДС < 0,10 руб., то 0 <= Переданная Сумма НДС <= m, где m - 50% от Суммы без НДС, с учетом математического округления до 2-го знака. 4) Если "Ставка НДС" передана, "Сумма НДС" должна быть равна произведению "Суммы акта/отчета по услугам без НДС" на "Ставку НДС" с учетом предусмотренной погрешности. Описание расчета: Если расчетная Сумма НДС >= 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб. Если расчетная Сумма НДС < 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС." 5) Если "Ставка НДС" = "without_vat" или "Ставка НДС" = "0", то "Сумма НДС" должна быть равна 0. 6) В новой версии API актов v4/invoice поле amount.commission.vat_rate может принимать значения: • "without_vat" (Без НДС), • "0", • "5", • "7", • "10", • "20" 7) Поле amount.commission.vat (Сумма НДС вознаграждения посредника) должна быть равна произведению amount.commission.excluding_vat (Сумма вознаграждения посредника без НДС) на amount.commission.vat_rate (Ставку НДС) с учетом предусмотренной погрешности. Описание расчета: Если расчетная Сумма НДС >= 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб. Если расчетная Сумма НДС < 0.5 руб., то n <= Переданная Сумма НДС <= m, где n - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой, m - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС." 8) Если "Ставка НДС" = "without_vat" или "Ставка НДС" = "0", то "Сумма НДС вознаграждения посредника" должна быть равна 0.

Всвязи с отключением в ЕРИР возможности передавать старые акты и статистики без детализаций в amount полях, в скором времени будут отключены следующие эндпоинты в нашем API: PUT /v1/invoice/{external_id} GET /v1/invoice/{external_id} PUT /v2/invoice/{external_id}/header PATCH /v2/invoice/{external_id}/items POST /v1/statistics GET /v1/statistics/list Если вы используете какие-то из них, следует перейти на аналоги из более высоких версий.

Добавили словарь статусов ЕРИР. Ручка /v1/erir_statuses возвращает в структуре поле messages с каким-то программистским описанием ошибки. Теперь сообщение из этого поля можно взять и передать в ручку /v1/dict/erir_message, чтобы получить человекочитаемое описание на выбранном языке, годное для отображения пользователю в интерфейсе. Есть также ручка POST, куда можно передать сразу несколько сообщений, для которых требуется перевод.

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

Перевели метод словаря ОКВЭДов /v1/dict/okved в разряд устаревших и выключим на следующей неделе.

Устаревшие методы GET и PUT /v1/creative/{external_id} перестанут работать с 29-го апреля.

Добрый день. В API GET /v3/invoice/{external_id} добавили в ответ поле status, которое для черновиков актов принимает значение 'draft' (а для не черновиков может вообще не отдаваться). Что такое черновик акта: это то, во что превращается акт при использовании следующих методов: - /v2/invoice/{external_id}/header - /v2/invoice/{external_id}/delete - /v2/invoice/{external_id}/items - /v3/invoice/{external_id}/header - /v3/invoice/{external_id}/items После использования одного или серии таких запросов требуется вызвать метод /v2/invoice/{external_id}/ready, чтобы акт пометился как готовый к отправке и ушел в ЕРИР. В интерфейсе данное изменение никак не отражено, т.к. интерфейс не пользуется этими методами.

Выкатили интерфейс с новыми полями.