Подключение и работа по API ОРД-А v2

Подключение и работа по API ОРД-А v2

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

Последнее обновление от 21.01.26

Тип/свойствоОписание
Invoices, InvoiceItems
invoices.amount.services.vat_rate, invoices.amount.commission.vat_rate, invoice_items.amount.vat_rateДобавлено значение «22» (ставка НДС 22%).

Валидация в зависимости от дат акта (date, start_date, end_date): 

- Запрещается передавать ставку 22% при следующем условии: дата акта меньше 01.01.2026 (invoices.date < 01.01.2026).

- Запрещается передавать ставку 22% при следующих одновременно выполняющихся условиях:
• дата акта больше, либо равна 01.01.2026  (invoices.date ≥ 01.01.2026),
• дата начала периода и дата окончания периода меньше 01.01.2026 (invoices.start_date < 01.01.2026 и invoices.end_date < 01.01.2026).

- Запрещается передавать ставку 20% при следующих одновременно выполняющихся условий:
• дата акта больше, либо равна 01.01.2026 (invoices.date ≥ 2026-01-01),
• дата начала периода и дата окончания периода больше, либо равны 01.01.2026 (invoices.start_date ≥ 2026-01-01 и invoices.end_date ≥ 2026-01-01).

- Разрешается передавать любые ставки из списка значений, при следующих одновременно выполняющихся условий:
• дата акта больше, либо равна 01.01.2026 (invoices.date ≥ 01.01.2026),
• дата начала периода меньше 01.01.2026 (invoices.start_date < 01.01.2026),
• дата окончания периода больше, либо равна 01.01.2026 (invoices.end_date ≥ 01.01.2026).
invoices.amount.services.vat, invoice_items.amount.vatДля полей vat (Сумма НДС) в актах и детализации актов, если vat_rate (Ставка НДС) НЕ передано, максимальная ставка НДС для расчёта допустимых значений определяется на основе даты акта (invoice.date): 

- Если invoice.date < 2026-01-01 → максимальная ставка = 20%.
- Если invoice.date ≥ 2026-01-01 → максимальная ставка = 22%.

Напоминание: ставка НДС может быть НЕ передана только для «intermediary-report» - Отчет посредника с типом договора «Посреднический договор» и признаком agent_acting_for_publisher = false)

Подробно о правилах передачи поля «Сумма НДС» описано в разделах 3.8.7 и 3.9.8
Statistics
statistics.amount.vat_rateДобавлено значение «22» (ставка НДС 22%).

Валидация в зависимости от даты начала показов по акту (date_start_plan):

- Запрещается передавать ставку 22%, если дата начала показов по акту меньше 01.01.2026 (date_start_plan < 2026-01-01). 

- Запрещается передавать ставку 20%, если дата начала показов по акту больше либо равна 01.01.2026 (date_start_plan ≥ 01.01.2026).