Changelog API

История изменений Omninet API. Отслеживайте новые функции, исправления и breaking changes.

Текущая версия: v1.11.0

v1.11.0

Actual2 октября 2026

Добавлено

  • Onboarding: Добавлен метод POST /v1/partner/credentials/create. Ключ нужно сохранить при получении
  • Onboarding: В статусы заявки добавлен FAILED
  • DBS: У покупателя и получателя заказа добавлено поле email

Изменено

  • Onboarding: В POST /v1/partner/onboarding/create поле cabinet стало необязательным
  • Onboarding: POST /v1/partner/request/status/list возвращает постраничный список заявок. Токен из этого ответа убран и создаётся отдельно по request_id при статусе ACTIVE

Исправлено

  • DBS: Статус возврата CANCELED исправлен на CANCELLED

v1.10.4

Supported25 сентября 2026

Изменено

  • FBS: Уточнена обязательность полей в запросах и ответах API

v1.10.3

Supported22 сентября 2026

Добавлено

  • DBS: Выделены mvp методы.

v1.10.2

Supported16 сентября 2026

Исправлено

  • DBS: В POST /v1/order/dbs/timeslot/set название метода (summary) скорректировано на «Изменить слот доставки».

v1.10.1

Supported15 сентября 2026

Исправлено

  • DBS: В ответе POST /v1/order/dbs/list (Delivery.delivery_type) описание значения EXPRESS приведено к общему формату со всеми типами доставки.
  • DBS: В POST /v1/return/dbs/status/set название метода приведено к единому стандарту спецификации: «Обновление статуса заявки на возврат».

v1.10.0

Supported3 сентября 2026

Добавлено

  • DBS: В тарифах полигонов (delivery_options[] create / update / list) опциональный массив additional_options (option_name + value, вложенные options[]). POST /v1/polygon/delivery-options/calculate не затронут.
  • DBS: POST /v1/return/dbs/status/set — обязательное changed_at (дата и время изменения статуса, RFC3339).
  • DBS: POST /v1/return/dbs/timeslot/set — обязательное changed_at (дата и время изменения слота, RFC3339).

Изменено

  • FBS / FBO: Product-методы (price/update, price/info, mapping/list, archive/update, stock/info; FBS также stock/update) приведены к контракту DBS: приоритет product_id над offer_id; ослаблена обязательность (price / is_archived / location_id+count; в FBO market_location_id+count); cursor / next_cursor / total и failed в части схем больше не required.

Устарело

  • DBS: Из ответа POST /v1/polygon/list удалён errors[] у элемента полигона.

v1.9.0

Supported31 августа 2026

Добавлено

  • Billing: POST /v1/billing/accrual/types — у типа начисления direction и полная история rules[] (период действия, calculation, applicability).
  • Billing: Нормативные методы расчёта AccrualRule.calculation: PERCENT, FIXED, MIXED, TIERED, MANUAL.
  • Billing: applicability.category_ids — разные ставки одного типа начисления по категориям товаров.
  • Billing: Опциональный фактический snapshot AccrualEntry.calculation в POST /v1/billing/accrual/list.

Изменено

  • Billing: Публичное название API — Banking API; технические paths остаются /v1/billing/....
  • Billing: POST /v1/billing/order/get — amount → merchant_price, gross_amount → merchant_final_price, net_amount → merchant_net_amount; метод возвращает продажу по идентификатору независимо от отчёта.
  • Billing: POST /v1/billing/return/get — amount → merchant_net_amount; метод возвращает возврат по идентификатору независимо от отчёта.
  • Billing: POST /v1/billing/order/get и POST /v1/billing/return/get — детализация начислений только через POST /v1/billing/accrual/list.
  • Billing: AccrualScope: ORDER заменён на MERCHANT_ORDER и CLIENT_ORDER; добавлен PERIOD.
  • Billing: POST /v1/billing/report/get — auto_approve_at: если к этому моменту отчёт всё ещё в IN_REVIEW_BY_MERCHANT, платформа автоматически переводит его в APPROVED_BY_MERCHANT.
  • Billing: Правила состава отчёта: продажа входит в период по терминальному статусу и status_changed_at; отмены и невыкупы не включаются как продажи; accrual/list по report_id в OPEN — текущий срез, в CLOSED — зафиксированный состав.

Устарело

  • Billing: Удалены fees[] из ответов POST /v1/billing/order/get (MerchantOrder, DeliveryEnvelope) и POST /v1/billing/return/get (ReturnItem).

v1.8.0

Supported31 августа 2026

Добавлено

  • DBS: POST /v1/polygon/delivery-options/calculate — runtime-расчёт вариантов Express-доставки (Dynamic Express, merchant-hosted).
  • DBS: POST /v1/dbs/tracking/get — данные Express-tracking: статусы, курьер, координаты, deadline поиска курьера.
  • DBS: Тип доставки EXPRESS в locationDeliveryType, deliveryType и полигонах.
  • DBS: Опциональное поле calculation_mode (STATIC | DYNAMIC, default STATIC) в polygon delivery option — Static Express vs Dynamic Express; при DYNAMIC стоимость и сроки заказа определяются через POST /v1/polygon/delivery-options/calculate.
  • DBS: Поля SLA в тарифах полигонов: delivery_time_minutes_max, order_cutoff.
  • DBS: В exemplar/set — merchant_price, currency_code, vat для весовых товаров.
  • DBS: Код ошибки STATUS_NOT_ALLOWED в OrderExemplarValidationErrorCode и DbsTrackingValidationErrorCode.

Изменено

  • DBS: address_tail обязателен при delivery_type = COURIER или EXPRESS.
  • DBS: POST /v1/order/dbs/exemplar/set — для весовых товаров обязательны exemplar.weight, merchant_price, currency_code, vat; метод до статуса DELIVERING.
  • DBS: Ответ exemplar/set — status только при успехе; при ошибках errors[] без status.

v1.7.0

Supported25 августа 2026

Добавлено

  • DBS: POST /v1/return/get — карточка одной заявки на возврат.
  • DBS: POST /v1/return/dbs/timeslot/set — перенос слота забора курьера.
  • DBS: В локациях флаг is_accepts_returns (ПВЗ сдачи возврата).
  • DBS: В полигонах бакет delivery_options[].is_return (тариф обратной доставки).

Изменено

  • DBS: POST /v1/return/list — фильтры (причина, тип доставки, заказ, периоды) и состав карточки: reason, money, вложения, status_history, delivery.payer / cost.
  • DBS: POST /v1/return/dbs/status/set — успех: return_id + status + карточка; ошибка HTTP 200: return_id + errors[] (без failed).
  • DBS: Одна заявка на один merchant_order_id; сдача COURIER / PICKUP_POINT / RUSSIAN_POST (без C&C).

Устарело

  • DBS: Удалён POST /v1/return/dbs/exemplar/update.

v1.6.0

Supported21 августа 2026

Добавлено

  • Billing: Единый POST /v1/billing/report/operation/list для операций отчёта (SALE и RETURN).
  • Billing: POST /v1/billing/report/balance — агрегированный отчёт о балансе за отчётный период.
  • Billing: POST /v1/billing/accrual/types — справочник типов начислений.
  • Billing: POST /v1/billing/accrual/list — реестр начислений по report_id.
  • Billing: Асинхронные POST /v1/billing/report/export/create, /info и /list для файловых отчётов.
  • Billing: В report/get добавлены auto_approve_at и payments[] для нескольких выплат по отчёту.

Изменено

  • Billing: Объединены topology-specific order/get и return/get в POST /v1/billing/order/get и POST /v1/billing/return/get.
  • Billing: Финансовая детализация продаж и возвратов: sales[] / returns[], опциональный deliveries[].
  • Billing: fee_type переименован в accrual_type; fee/types → accrual/types.
  • Billing: Новая группировка разделов API: Reports, Sales & Returns, Accruals, Report Exports.

Устарело

  • Billing: Удалены topology-specific paths order/get и return/get (DBS/FBS/FBO).
  • Billing: Удалены report/order/list и report/return/list.
  • Billing: Удалено одиночное поле payment_order_number в report/get (заменено на payments[]).

v1.5.0

Supported20 августа 2026

Добавлено

  • DBS: В ответе POST /v1/order/dbs/list в orders[].delivery добавлено необязательное поле provider_id (locationProviderId).
  • DBS: В enum locationProviderId добавлены значения: DPD, HERMES, IML, TOP_DELIVERY, OZON, KSE, STRIZH, DL, PEK (сохранены SBL, MVIDEO).
  • DBS: В ответе POST /v1/order/dbs/list в orders[] добавлен необязательный объект recipient с полями name и phone.
  • DBS: В ответе POST /v1/order/dbs/status/list добавлены обязательные поля changed_at (date-time, RFC3339) и changed_by (MERCHANT, CLIENT, MARKET).

Изменено

  • DBS: Уточнена обязательность полей в запросах и ответах.

v1.4.0

Supported10 августа 2026

Добавлено

  • Product: Добавлены методы получения категорий товаров и их характеристик.
  • Product: Добавлены методы создания и обновления карточек товаров.
  • Product: Добавлена передача характеристик и медиаконтента товаров.
  • Product: Добавлено получение результатов обработки карточек товаров.

v1.3.0

Supported07 августа 2026

Добавлено

  • FBS: В ответ метода POST /v1/product/stock/update добавлено поле processed по аналогии с DBS.

Изменено

  • DBS: В запросе метода POST /v1/product/stock/update поле stocks переименовано в items.
  • Common Methods: Метод POST /v1/product/stock/update приведён к контракту DBS.

v1.2.0

Supported07 августа 2026

Добавлено

  • FBS: В запрос метода POST /v1/shipment/update добавлено необязательное поле shipment_date.
  • FBS: В ответ метода POST /v1/shipment/package/add добавлено необязательное поле package_number.

v1.1.0

Supported04 августа 2026

Добавлено

  • DBS: Индивидуальные перечни кодов ошибок по группам методов (polygon, location, order, return, prices/stocks).
  • DBS: В схеме ApiError добавлен тип ERROR_TYPE_BAD_REQUEST для ответов с HTTP-статусом 400.
  • DBS: В ответе метода POST /v1/order/dbs/status/update добавлено поле failed при ошибке обработки.

Изменено

  • DBS: Ошибки валидации полей и бизнес-логики возвращаются с HTTP-статусом 200 в полях errors/failed; HTTP 400 используется только при структурно некорректном запросе.
  • DBS: В методе POST /v1/order/dbs/handover-code/set структура объекта failed изменена: поля merchant_order_id и errors[].
  • DBS: Для методов обновления слота, адреса и трек-номера введены отдельные схемы ошибок вместо общей.

Устарело

  • DBS: Общая схема FieldValidationError с единым полным перечнем кодов ошибок для всех методов.

v1.0.1

Supported31 июля 2026

Добавлено

  • Billing API: Добавлена новая спецификация Billing API для сверки и биллинга.

v1.0.0

Supported20 июля 2026

Добавлено

  • DBS: Подключение базовой спецификации методов DBS.
  • FBS: Подключение базовой спецификации методов FBS.
  • FBO: Подключение базовой спецификации методов FBO.