Перейти к содержимому
Omninet

Обновление локации

POST /v1/location/update

Тело запроса

Заголовок раздела «Тело запроса»
merchant_location_id string
Идентификатор локации продавца (опционально).
location_id string
Идентификатор локации.
location_types array
Типы локации; элементы — WAREHOUSE (склад), PICKUP_POINT (пункт выдачи) или CLICK_AND_COLLECT (пункт самовывоза). При обновлении набор может менять допустимую схему данных и валидацию полей локации.
Тип локации в массиве location_types.

- WAREHOUSE: склад.
- PICKUP_POINT: пункт выдачи.
- CLICK_AND_COLLECT: пункт самовывоза (Click & Collect).
name string
Новое название.
address_tail string
Адрес в текстовом формате. Обязателен при delivery_type = COURIER (опционально).
comment string
Комментарий к доставке или адресу (опционально).
latitude number
Широта (опционально).
longitude number
Долгота (опционально).
provider_id string
Идентификатор провайдера доставки (опционально).
values
CDEKBOXBERRY5POSTRUSSIAN_POSTYANDEXSBLMVIDEO
provider_location_id string
Идентификатор локации у провайдера доставки (опционально).
pickup_point_type string
Тип пункта выдачи.

- PICKUP_POINT: пункт выдачи.
- POSTAMAT: постамат.
values
PICKUP_POINTPOSTAMAT
payment_methods array
Доступные способы оплаты на точке (опционально).
Способ оплаты на точке.

- ALREADY_PAID: предоплаченные заказы.
- CARD: оплата картой.
- CASH: оплата наличными.
storage_period_days integer
Число дней хранения заказа на точке (опционально).
limits object
Предельные габариты и вес заказа для точки (ВГХ, см и кг).
Показать Скрыть
length number
Максимальная длина заказа, см.
width number
Максимальная ширина заказа, см.
height number
Максимальная высота заказа, см.
weight number
Максимальный вес заказа, кг.
instruction string
Инструкция как добраться для отображения на витрине (опционально).
pickup_services array
Дополнительные услуги пункта выдачи (опционально).
Дополнительная услуга ПВЗ.

- FITTING: возможна примерка.
working_schedule array
Расписание работы.
Показать Скрыть
day string
День недели.
values
MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY
schedule object
Расписание на день.
Показать Скрыть
time_start string
Время начала, формат «00:00».
time_end string
Время окончания, формат «00:00».
break string
Перерыв, формат «13:00–14:00».
shipping_cutoff string
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
individual_schedule array
Индивидуальное расписание на определённые даты. К примеру, праздничные дни (опционально при отличии от working_schedule).
Показать Скрыть
date string
Дата, формат «YYYY-MM-DD».
schedule object
Расписание на дату.
Показать Скрыть
time_start string
Время начала, формат «00:00».
time_end string
Время окончания, формат «00:00».
break string
Перерыв, формат «13:00–14:00».
shipping_cutoff string
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
is_works boolean
Признак работы в дату.
is_accepts_returns boolean
Признак приёма возвратов.

Успешный ответ

200 A successful response.
application/json
object
locations array
Результат операции update; обычно один элемент. В отличие от ответа create, в элементе дополнительно может быть поле issue.
Итог по одной локации из update: location_id — id в системе витрины (пустая строка, если не обновлено); name — название из запроса; errors — ошибки валидации по полям, при успехе [].
Показать Скрыть
location_id string
Идентификатор локации в системе витрины; пустая строка, если операция для этой позиции не выполнена.
merchant_location_id string
Идентификатор локации продавца (опционально).
name string
Название локации из запроса.
status string
Статус локации после операции update.
values
DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED
issue object
Проблема по локации; пустой объект или не передаётся при статусах DRAFT и ACTIVE.
Показать Скрыть
code string
Код проблемы.
message string
Детальное описание проблемы.
changed_at string
Момент изменения (RFC3339, например 2026-04-16T08:00:00Z).
errors array
Ошибки валидации по полям; пустой массив при успехе.
Ошибка валидации поля в элементе ответа по локации.
Показать Скрыть
field string
Имя поля в запросе (например address_tail).
code string
Код ошибки валидации (например REQUIRED).
message string
Текст ошибки для клиента.

Ошибки

400 Некорректный запрос
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
401 Ошибка авторизации
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
429 Превышен лимит запросов
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
500 Внутренняя ошибка сервера
application/json
object
error_type string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
values
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code string
код ошибки
message string
сообщение
details object
Показать Скрыть
No properties defined
POST /v1/location/update 

              1
              curl https://api.omninet.ru/v1/location/update \
            
              2
                --request POST \
            
              3
                --header 'Content-Type: application/json' \
            
              4
                --data '{
            
              5
                "merchant_location_id": "string",
            
              6
                "location_id": "string",
            
              7
                "location_types": [
            
              8
                  "string"
            
              9
                ],
            
              10
                "name": "string",
            
              11
                "address_tail": "string",
            
              12
                "comment": "string",
            
              13
                "latitude": 0,
            
              14
                "longitude": 0,
            
              15
                "provider_id": "string",
            
              16
                "provider_location_id": "string",
            
              17
                "pickup_point_type": "string",
            
              18
                "payment_methods": [
            
              19
                  "string"
            
              20
                ],
            
              21
                "storage_period_days": 0,
            
              22
                "limits": {
            
              23
                  "length": 0,
            
              24
                  "width": 0,
            
              25
                  "height": 0,
            
              26
                  "weight": 0
            
              27
                },
            
              28
                "instruction": "string",
            
              29
                "pickup_services": [
            
              30
                  "string"
            
              31
                ],
            
              32
                "working_schedule": [
            
              33
                  {
            
              34
                    "day": "MONDAY",
            
              35
                    "schedule": {
            
              36
                      "time_start": "string",
            
              37
                      "time_end": "string",
            
              38
                      "break": "string",
            
              39
                      "shipping_cutoff": "string"
            
              40
                    }
            
              41
                  }
            
              42
                ],
            
              43
                "individual_schedule": [
            
              44
                  {
            
              45
                    "date": "string",
            
              46
                    "schedule": {
            
              47
                      "time_start": "string",
            
              48
                      "time_end": "string",
            
              49
                      "break": "string",
            
              50
                      "shipping_cutoff": "string"
            
              51
                    },
            
              52
                    "is_works": true
            
              53
                  }
            
              54
                ],
            
              55
                "is_accepts_returns": true
            
              56
              }'
            
{
  "locations": [
    {
      "location_id": "string",
      "merchant_location_id": "string",
      "name": "string",
      "status": "string",
      "issue": {
        "code": "string",
        "message": "string",
        "changed_at": "string"
      },
      "errors": [
        {
          "field": "string",
          "code": "string",
          "message": "string"
        }
      ]
    }
  ]
}

A successful response.

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Некорректный запрос

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Ошибка авторизации

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Превышен лимит запросов

{
  "error_type": "string",
  "code": "string",
  "message": "string",
  "details": {}
}

Внутренняя ошибка сервера