TGViewer
Channel Public Channel
VK ORD API News

VK ORD API News

@vkord_api_news

Здесь публикуются изменения в API ВК ОРД. Актуальная документация всегда (ок, почти всегда) в https://ord.vk.com/help/api и https://ord.vk.com/help/api/swagger/. Поддержка по почте support@ord.vk.com.
Subscribers
1.19K
Photos
1
Videos
0
Links
46
Recent Posts 20 shown
Post #105 930
Уважаемые пользователи!
24 сентября с 11:00 до 12:00 сервис ОРД VK может быть недоступен в связи с проведением плановых технических работ. Приносим извинения за возможные неудобства.
  • 👌 2
Post #104 570
Уважаемые пользователи!

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

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

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

В ОРД 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/
  • 🥴 3
  • 😨 3
  • 👍 2
  • 👎 2
  • 🎉 2
  • 🤔 1
  • 🤪 1
Post #102 1.86K
Уважаемые пользователи!

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

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

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

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

Для подключения через API добавили в API методы POST/GET /v1/billing/tariff_auto_buy, детали в swagger.
  • 🥴 3
  • 🤷‍♂ 1
Post #101 2.02K
Открыли публичное API для работы с биллингом, описание с сваггере обновлено.
API будет расширяться в дальнейшем.
  • 🤡 13
  • 🥱 4
  • 👍 1
  • 👎 1
Post #100 2.74K
Уважаемые пользователи!

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

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

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

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

Данные меры введены для обеспечения достоверности сведений, передаваемых в ЕРИР. Новый порядок позволит избежать передачи данных за постороннее лицо и поможет избежать штрафных санкций в отношении пользователей.
  • 👍 4
  • 🔥 3
  • 👎 1
  • 😢 1
Post #99 3.08K
Уважаемые пользователи!

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

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

С уважением,
Команда VK ОРД!
  • 💩 18
  • 🤝 5
  • 👎 4
  • 🖕 4
  • 🤬 3
  • 🤮 3
Post #98 3.39K
Уважаемые пользователи API!

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

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

С уважением,
команда VK ОРД!
  • 👎 32
  • 🤬 20
  • 🤮 16
  • 💩 12
  • 👌 3
Post #97 2.84K
Уважаемые пользователи, 26 февраля 2026 года будут отключены устаревшие версии API v3/invoice и v2/statistics. Вместо них нужно использовать группы эндпоинтов v4/invoice и v3/statistics соответственно.
  • 👌 4
  • ❤ 3
  • 😱 1
  • 👀 1
Post #96 3.54K
Сегодня (21 января) с 22:00 до 23:59 API будет недоступно в связи с проведением плановых технических работ.
  • 🤝 4
Post #95 3.2K
Отличные новости для пользователей, чьё количество записей измеряется десятками тысяч и более!

Мы оптимизировали работу системы под большие объёмы данных. Теперь вы сможете просматривать и управлять всеми своими записями не только через API, но и через интерфейс.
  • 🔥 4
  • 👏 4
  • ❤ 2
  • 👍 2
  • 🙈 1
Post #94 3.26K
Для удобства использования API теперь в последней версии группы методов содержатся все актуальные эндпоинты. Например, для актов это v4/invoice, теперь можно использовать v4/invoice/{external_id}/ready, который идентичен по своему функционалу v2/invoice/{external_id}/ready.
Такая политика будет сохраняться и в следующих версиях.
Post #93 2.73K
Добавлена группа методов для работы с внешними CID, а также, возможность использовать добавленные CID в креативах и актах.
Post #92 2.46K
Если расчетная Сумма НДС < 0.1 руб., то
Сумма НДС указывается с точностью от 2 до 5 знаков (i) после запятой. Если расчётная сумма НДС меньше 0,10 руб., допускается погрешность. Но итоговая сумма НДС должна находиться в диапазоне:
От: значения, округлённого вниз до i-го знака (включительно)
До: значения, округлённого математически до i-го знака, плюс 5 * 10⁻ⁱ руб. Указанная погрешность не может превышать 50% от суммы без НДС.

5) Если "Ставка НДС" = "without_vat" или "Ставка НДС" = "0", то "Сумма НДС для стоимости оказанных услуг" должна быть равна 0.
Post #91 1.7K
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% от Суммы без НДС.
Post #90 1.25K
В рамках поддержки нововведений и требований со стороны ЕРИР а нашем 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.
  • 🤝 1
Post #89 2.38K
Всвязи с отключением в ЕРИР возможности передавать старые акты и статистики без детализаций в 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

Если вы используете какие-то из них, следует перейти на аналоги из более высоких версий.
  • 👌 3
  • ❤ 1
Post #88 2.67K
Добавили словарь статусов ЕРИР.

Ручка /v1/erir_statuses возвращает в структуре поле messages с каким-то программистским описанием ошибки. Теперь сообщение из этого поля можно взять и передать в ручку /v1/dict/erir_message, чтобы получить человекочитаемое описание на выбранном языке, годное для отображения пользователю в интерфейсе. Есть также ручка POST, куда можно передать сразу несколько сообщений, для которых требуется перевод.
  • 🔥 6
Post #87 3.12K
Планируем ужесточить проверки подаваемых данных актов: в статистике в акте можно будет подать только такую пару «договор, креатив», где указанный креатив зарегистрирован на указанный договор. В веб-интерфейсе уберем галочку «показать все креативы» возле договора в статистике.

Если кто-то считает, что это ему может помешать - расскажите, пожалуйста, чем.
  • 👍 4
  • 👎 1
  • 🔥 1
  • 👀 1
Post #86 2.61K
Перевели метод словаря ОКВЭДов /v1/dict/okved в разряд устаревших и выключим на следующей неделе.
  • 👍 1
Older posts →

About this channel

How can I read @vkord_api_news without a Telegram account?
TGViewer shows the public web preview Telegram publishes for VK ORD API News: recent posts, photos, videos and the subscriber count, with no app, login or account.
How many subscribers does VK ORD API News have?
VK ORD API News (@vkord_api_news) has 1.19K subscribers on Telegram, refreshed roughly every 30 minutes.
Does VK ORD API News know I viewed it here?
No. Public channel previews carry no viewer identity, and TGViewer has no accounts or tracking of what you look up.
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →