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

Создание склада продавца

POST /v1/merchant/location/create

Тело запроса

Заголовок раздела «Тело запроса»
locations array
Список складов продавца для создания.
Показать Скрыть
merchant_location_id string
Идентификатор локации продавца (опционально).
location_types string
Тип локации.

- WAREHOUSE: склад.
values
WAREHOUSE
name string
Название склада.
address_tail string
Адрес локации в текстовом формате.
latitude number
Широта точки (WGS 84).
longitude number
Долгота точки (WGS 84).
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
Дата, формат «31.12.2020».
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
Признак работы в дату.
market_location_id array
Идентификаторы складов маркетплейса, к которым подключается склад продавца.

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

200 A successful response.
application/json
object
locations array
Результаты по каждому складу из тела запроса create (порядок соответствует массиву locations в запросе).
Итог по одному складу из batch create: location_id — id в системе витрины (пустая строка, если не создано); name — название из запроса; errors — ошибки валидации по полям, при успехе [].
Показать Скрыть
location_id string
Идентификатор склада в системе витрины; пустая строка, если операция для этой позиции не выполнена.
merchant_location_id string
Идентификатор локации продавца (опционально).
name string
Название склада из запроса.
status string
Статус склада после операции create.
values
DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED
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/merchant/location/create 

              1
              curl https://api.omninet.ru/v1/merchant/location/create \
            
              2
                --request POST \
            
              3
                --header 'Content-Type: application/json' \
            
              4
                --data '{
            
              5
                "locations": [
            
              6
                  {
            
              7
                    "merchant_location_id": "string",
            
              8
                    "location_types": "string",
            
              9
                    "name": "string",
            
              10
                    "address_tail": "string",
            
              11
                    "latitude": 0,
            
              12
                    "longitude": 0,
            
              13
                    "working_schedule": [
            
              14
                      {
            
              15
                        "day": "MONDAY",
            
              16
                        "schedule": {
            
              17
                          "time_start": "string",
            
              18
                          "time_end": "string",
            
              19
                          "break": "string",
            
              20
                          "shipping_cutoff": "string"
            
              21
                        }
            
              22
                      }
            
              23
                    ],
            
              24
                    "individual_schedule": [
            
              25
                      {
            
              26
                        "date": "string",
            
              27
                        "schedule": {
            
              28
                          "time_start": "string",
            
              29
                          "time_end": "string",
            
              30
                          "break": "string",
            
              31
                          "shipping_cutoff": "string"
            
              32
                        },
            
              33
                        "is_works": true
            
              34
                      }
            
              35
                    ],
            
              36
                    "market_location_id": [
            
              37
                      "string"
            
              38
                    ]
            
              39
                  }
            
              40
                ]
            
              41
              }'
            
{
  "locations": [
    {
      "location_id": "string",
      "merchant_location_id": "string",
      "name": "string",
      "status": "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": {}
}

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