VK ORD API News


Гео и язык канала: Россия, Русский
Категория: Технологии


Здесь публикуются изменения в API ВК ОРД. Актуальная документация всегда (ок, почти всегда) в https://ord.vk.com/help/api и https://ord.vk.com/help/api/swagger/. Поддержка по почте support@ord.vk.com.

Связанные каналы  |  Похожие каналы

Гео и язык канала
Россия, Русский
Категория
Технологии
Статистика
Фильтр публикаций


Уважаемые пользователи!
24 сентября с 11:00 до 12:00 сервис ОРД VK может быть недоступен в связи с проведением плановых технических работ. Приносим извинения за возможные неудобства.


Уважаемые пользователи!

Сообщаем, что 28 сентября 2026 года в ОРД VK прекратят работу устаревшие версии API invoice и statistics.

Это связано с отключением старой версии API ЕРИР, в связи с чем в ОРД VK также проводится плановое отключение.

Просим убедиться, что ваши интеграции переведены на последнюю версию API. Старые методы выделены серым цветом в Swagger: https://ord.vk.com/help/api/swagger/


Уважаемые пользователи!

В ОРД VK произошли изменения, связанные с новыми требованиями ЕРИР. Рассказываем, что изменилось:

1. В карточке контрагента появилось новое поле «Адрес». В ряде случаев его заполнение обязательно для передачи акта в ЕРИР, а именно:

Адрес нужно указать обязательно в карточке того контрагента, который соответствует условиям ниже:
— для контрагента-заказчика — если создается акт к договору оказания услуг, в котором исполнитель является иностранным лицом;
— для контрагента-заказчика — если создается акт к посредническому договору, в котором исполнитель является иностранным лицом и в договоре не установлен признак «Деньги поступают от исполнителя заказчику»;
— для контрагента-заказчика — если создается акт к посредническому договору, в котором установлен признак «Деньги поступают от исполнителя заказчику»;
— для контрагента-исполнителя — если контрагент является физическим лицом или ИП и выступает исполнителем по договору любого типа.

Заполните адрес максимально подробно — укажите адрес до номера дома, а при наличии — до номера квартиры.

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

2. Появились три типа для актов.

Теперь при создании акта можно выбрать один из трех типов:
— акт выполненных работ;
— отчет посредника;
— акт на вознаграждение посредника.

При создании акта по договору оказания услуг автоматически выбирается тип «Акт выполненных работ».
При создании акта по посредническому договору можно выбрать один из двух типов: «Отчет посредника» или «Акт на вознаграждение посредника». Выбор зависит от того, оформлено ли вознаграждение посредника в составе отчета или отдельным документом.

Как выбрать тип акта по договору посредничества:
1. Если сумма, полученная посредником, и его комиссия указаны в одном документе, создайте «Отчет посредника» и укажите сумму комиссии в соответствующем поле.
2. Если вознаграждение (комиссия) посредника оформлено отдельным документом, создайте отдельный акт с типом «Акт на вознаграждение посредника».

3. В одном акте можно указать несколько посреднических договоров, по поручению которых был заключен договор оказания услуг.

Это изменение позволяет указать в одном акте сразу несколько договоров, связанных с соответствующей услугой.

Что изменилось в API
- Добавили поле address в эндпоинты PUT/GET /v1/person/{external_id}. Адрес проверяется на корректность и может быть автоматически исправлен для унификации формата, без изменения смысла переданных данных. В таком случае в ответе вернем исправленное значение.
- Добавлены эндпоинты /v5/invoice... для работы с актами. Эндпоинты /v4/invoice... объявляются устаревшими и вскоре будут удалены. На данный момент возможна передача данных как по старым, так и по новым эндпоинтам. Эндпоинт /v1/statustucs/delete также объявляется устаревшим.
- В новых эндпоинтах /v5/invoice... добавлены валидации при создании актов на наличие адресов у некоторых персон в соответствии с описанием.
- В новых эндпоинтах /v5/invoice... добавлена возможность передавать массив договоров по поручению в поле order_contract_external_ids.
- В новых эндпоинтах /v5/invoice... необходимо указывать тип акта: invoice, mediator_report, commission_invoice. В зависимости от этого меняется структура акта и требования к полям.

Подробное описание изменений API доступно в Swagger ОРД VK: https://ord.vk.com/help/api/swagger/

3k 4 122 46 13

Уважаемые пользователи!

Чтобы у вас сохранялся доступ к ОРД непрерывно (это особенно важно для пользователей API), и вам не приходилось следить за окончанием тарифа и продлевать его вручную, мы добавили возможность автопродления.

Как работает автопродление тарифа:
Когда старый тариф закончится, система купит новый автоматически, если на вашем балансе достаточно средств.

Автопродление можно в любой момент отключить в настройках. Оно не блокирует смену тарифа вручную.

Для подключения через интерфейс:
• Перейдите в раздел Управление оплатой
• Нажмите «Выбрать» тариф
• Внизу модального окна нажмите «Подключить автопродление»

Для подключения через API добавили в API методы POST/GET /v1/billing/tariff_auto_buy, детали в swagger.


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


Уважаемые пользователи!

Обратите внимание на новый порядок верификации.

Если данные собственного контрагента и реквизиты плательщика совпадают, система верифицирует пользователя автоматически после пополнения баланса. Вам не потребуется предпринимать дополнительных действий.

Если данные собственного контрагента и плательщика отличаются, вам потребуется пройти верификацию через VK Бизнес ID самостоятельно.

Пожалуйста, учитывайте, что подключение тарифа станет возможным только после успешного завершения верификации (автоматической или через VK Бизнес ID).

Данные меры введены для обеспечения достоверности сведений, передаваемых в ЕРИР. Новый порядок позволит избежать передачи данных за постороннее лицо и поможет избежать штрафных санкций в отношении пользователей.


Уважаемые пользователи!

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

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

С уважением,
Команда VK ОРД!

2k 1 40 35 37

Уважаемые пользователи API!

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

Если вы желаете продолжать использовать VK ОРД, то, пожалуйста, войдите в свой личный кабинет ОРД, ознакомьтесь с условиями новой оферты и акцептуйте её.

С уважением,
команда VK ОРД!

2.1k 4 98 76 77

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


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


Отличные новости для пользователей, чьё количество записей измеряется десятками тысяч и более!

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

676 0 7 46 11

Для удобства использования 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 руб., то
Переданная Сумма НДС


В рамках поддержки нововведений и требований со стороны ЕРИР а нашем 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 руб., то
Переданная Сумма НДС


Всвязи с отключением в ЕРИР возможности передавать старые акты и статистики без детализаций в 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

Если вы используете какие-то из них, следует перейти на аналоги из более высоких версий.

837 0 13 27 4

Добавили словарь статусов ЕРИР.

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


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

Если кто-то считает, что это ему может помешать - расскажите, пожалуйста, чем.

828 1 11 111 6

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

Показано 20 последних публикаций.