Changelog API

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

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

v1.22.0

Actual20 ноября 2026

Добавлено

  • FBS: значение EXPRESS в deliveryType
  • FBS: необязательный delivery.courier в POST /v1/order/fbs/list: имя, телефон, транспорт и ориентировочное время прибытия в точку забора
  • FBS: POST /v1/order/fbs/courier-handover-code/get — получение кодов передачи заказов курьеру
  • FBS: статус UNDELIVERED для чтения заказа
  • FBS: необязательный объект payment в POST /v1/order/fbs/list
  • FBS: payment_methods в POST /v1/market/location/list: ALREADY_PAID, CARD, CASH

Изменено

  • FBS: для EXPRESS SHIPPED означает фактическую передачу товара курьеру маркетплейса
  • FBS: UNDELIVERED устанавливает маркетплейс; мерчант завершает такой заказ через POST /v1/order/fbs/cancel после возврата товара или урегулирования
  • FBS: статус заказа и состояние оплаты независимы и не зависят от delivery_type

v1.22.0

Actual20 ноября 2026

Изменено

  • FBS: заголовок авторизации — Authorization: Bearer вместо Client-Id и Api-Key
  • Banking API: заголовок авторизации — Authorization: Bearer вместо Client-Id и Api-Key
  • Product API: описание Bearer-схемы приведено к формату Bearer

v1.21.0

Supported19 ноября 2026

Добавлено

  • FBO: Пути с моделью: /v1/shipment/fbo/* (16 методов), /v1/label/fbo/items/get, /v1/label/fbo/packages/get, /v1/product/fbo/stock/info

v1.20.0

Supported19 ноября 2026

Добавлено

  • Cross-border: POST /v1/cross-border/product/price/calculate — пересчёт валютной цены в валюту продажи, витрина → КБ
  • Cross-border: POST /v1/product/price/info/by-date — сохранённая цена на момент времени, мерчант → витрина → КБ
  • Cross-border: POST /v1/cross-border/customs/calculate — сумма таможенных платежей при оформлении
  • Cross-border: POST /v1/cross-border/order/create и POST /v1/cross-border/order/update — создание заказа с пустыми экземплярами и последующее обновление
  • Cross-border: POST /v1/cross-border/order/labels/get, POST /v1/cross-border/order/tracking/get, POST /v1/cross-border/order/cancel
  • Cross-border: POST /v1/cross-border/personal-data/checkstatus/get — статус проверки покупателя
  • Cross-border: POST /v1/cross-border/report/export/create и POST /v1/cross-border/report/export/info — задание ACCOUNT_REPORT
  • Cross-border: POST /v1/merchant/info/get — справочник мерчантов; исполняет сторонняя витрина, вызывает КБ
  • FBS: статус заказа PENDING_KYC

Изменено

  • FBS: из PENDING_KYC мерчант не выполняет переходы; в NEW после успешного KYC и в CANCELLED из этого состояния заказ переводит только витрина
  • FBS: /v1/order/fbs/exemplar/set вызывается после успешного CONFIRMED; ответ мерчанту не зависит от последующего /v1/cross-border/order/update
  • FBS: у экземпляра необязательные tnved, net_weight, length, width, height; обязательность этих полей в КБ на FBS не переносится
  • FBS: в трансграничном сценарии SHIPPED ставит мерчант после передачи товара логисту в дроп-поинте; ACCEPTED_AT_WAREHOUSE ставит витрина по приёмке на складе МП, а не по растаможке
  • FBS: поставку трансграничного заказа создаёт КБ, мерчант отдельную FBS-поставку для него не создаёт
  • FBS: уточнены значения четырёх типов цены заказа; currency_code остаётся необязательным, как в текущем контракте
  • Cross-border: в customer нет поля name; merchant_location_id и inn необязательны; при создании заказа пустые last_name, first_name, middle_name, phone или email дают бизнес-ошибку REQUIRED
  • FBS: в /v1/order/fbs/list нет блока customer; покупатель передаётся только в создание заказа КБ. PENDING_KYC входит в enum статуса заказа и не входит в статусы status/update
  • Cross-border: срок KYC, частоту опроса и длительность проверки задаёт витрина; отказ проверки возвращается как REJECTED с кодом STOREFRONT_RULE_VIOLATION и message
  • Cross-border: /v1/cross-border/order/cancel вызывает витрина после /v1/order/fbs/cancel и при своей отмене FBS-заказа, если заказ уже создан в КБ
  • Cross-border: повтор order/update с тем же телом возвращает прежний успех; изменённое тело заменяет заказ целиком; неизвестная пара идентификаторов даёт HTTP 200 и NOT_FOUND без создания заказа
  • Cross-border: labels/get принимает не больше 100 заказов; статус трека — открытая строка; неизвестный tracking_number возвращается как HTTP 200 и NOT_FOUND
  • Cross-border: tracking/get без номера трека и без посылок возвращает HTTP 200, пустой parcels и пустой errors
  • Cross-border: в order/cancel добавлен необязательный reason_code строкой без enum; отмена возможна, пока товар не передан логисту, без фиксированного статуса FBS
  • Cross-border: price/info/by-date требует непустой product_id или offer_id; при обоих используется product_id; отсутствие записей — HTTP 200, пустой prices и total 0
  • Cross-border: ACCOUNT_REPORT описывает группы данных без перечня колонок; имена колонок и формат файла определяет КБ

v1.19.0

Supported12 ноября 2026

Добавлено

  • DBS: Добавлены поля order_value_from и order_value_to для минимальной и максимальной цены корзины в методах: /v1/polygon/create, /v1/polygon/delivery-options/update и /v1/polygon/list

v1.18.0

Supported6 ноября 2026

Добавлено

  • FBO: Новый общий справочник складов для всех моделей работы /v1/location/market/list
  • FBO: Подбор склада по товарам и способу упаковки без создания отгрузки /v1/shipment/location/check
  • FBO: Запись на склад (слот, способ упаковки, план мест) и её замена /v1/shipment/slot/reserve, отмена записи /v1/shipment/slot/cancel
  • FBO: Реквизиты пропуска водителя и машины /v1/shipment/pass/update
  • FBO: Добавление и удаление отдельных грузомест /v1/shipment/package/add, /v1/shipment/package/remove
  • FBO: Грузоместа: вложенность «короб на палете», код места продавца external_code, срок годности expiration_date в позиции
  • FBO: Многоместный товар: номер части part в позиции грузоместа и этикетки на каждую часть
  • FBO: Документы отгрузки: пропуск (PASS), накладная (WAYBILL), УПД с данными ЭДО, статус FAILED

v1.17.0

Supported5 ноября 2026

Изменено

  • Product: Обновлены большинство методов, какие-то методы добавлены, какие-то методы удалены

v1.16.0

Supported23 октября 2026

Добавлено

  • DBS: Добавлен метод получения справочника провайдеров /v1/provider/list
  • DBS: Добавлен метод подачи заявки на добавление провайдера /v1/provider/apply
  • DBS: Добавлен метод получения списка и статусов заявок на добавление провайдера /v1/provider/application/list
  • DBS: В enum locationProviderId (provider_id) добавлено значение ELDORADO (Эльдорадо)

v1.15.0

Supported22 октября 2026

Добавлено

  • DBS: В запрос POST /v1/polygon/delivery-options/calculate добавлены polygon_id, idempotency_key, weight, volume_weight, order_total и currency
  • DBS: В ответ POST /v1/polygon/delivery-options/calculate добавлены idempotency_key и errors с кодами ошибок полей
  • DBS: В ответ POST /v1/order/dbs/delivery-cost/get добавлены необязательные delivery_type и calculation_mode
  • DBS: В запрос POST /v1/dbs/tracking/get добавлен client_order_id
  • DBS: В элемент трекинга добавлен client_order_id, в status_id добавлен CANCELLED
  • DBS: В коды ошибок трекинга добавлены REQUIRED_ONE_OF и TOO_MANY_ITEMS

Изменено

  • DBS: Статус заявки на отмену APPROVED_CANCEL переименован в APPROVED_CANCELLED

v1.14.0

Supported20 октября 2026

Изменено

  • DBS: POST /v1/dbs/tracking/get — запрос изменён с merchant_order_id на merchant_order_ids[]; ответ возвращает couriers[] с результатом tracking по каждому заказу

Удалено

  • DBS: из запроса POST /v1/polygon/delivery-options/calculate удалено поле delivery_type

v1.13.0

Supported14 октября 2026

Удалено

  • Product: Удалены методы /v1/product-cards/physical/set-sample,/v1/product-cards/physical/set-sample/results,/v1/product-cards/physical/set-variations,/v1/product-cards/physical/set-variations/results,/v1/attributes/custom/update,/v1/attributes/custom/toggle,/v1/attributes/custom/add,/v1/attributes/custom/list

v1.12.0

Supported7 октября 2026

Добавлено

  • Onboarding: Добавлен новый статус заявки REJECTED в /v1/partner/request/status/list, /v1/partner/onboarding/create и /v1/partner/cabinet/create

v1.11.0

Supported2 октября 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.