Changelog API
История изменений Omninet API. Отслеживайте новые функции, исправления и breaking changes.
Текущая версия: v1.22.0v1.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; в FBOmarket_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, defaultSTATIC) в 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.