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

POST /v1/merchant/location/create

POST/v1/merchant/location/create

Тело запроса

locations
array
required
Список складов продавца для создания.
MerchantLocationCreateItem
Показать свойства
MerchantLocationCreateItem
merchant_location_id
string
Идентификатор локации продавца (опционально).
location_types
string
required
Тип локации. - WAREHOUSE: склад.
Допустимые значения
WAREHOUSE
name
string
required
Название склада.
address_tail
string
required
Адрес локации в текстовом формате.
latitude
number
required
Широта точки (WGS 84).
longitude
number
required
Долгота точки (WGS 84).
working_schedule
array
required
Расписание работы.
LocationWorkingSchedule
Показать свойства
LocationWorkingSchedule
day
string
required
День недели.
Допустимые значения
MONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAYSUNDAY
schedule
object
required
Расписание на день.
Показать свойства
time_start
string
required
Время начала, формат «00:00».
time_end
string
required
Время окончания, формат «00:00».
break
string
required
Перерыв, формат «13:00–14:00».
shipping_cutoff
string
required
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
individual_schedule
array
Индивидуальное расписание на определённые даты. К примеру, праздничные дни (опционально при отличии от working_schedule).
LocationIndividualSchedule
Показать свойства
LocationIndividualSchedule
date
string
required
Дата, формат «31.12.2020».
schedule
object
required
Расписание на дату.
Показать свойства
time_start
string
required
Время начала, формат «00:00».
time_end
string
required
Время окончания, формат «00:00».
break
string
required
Перерыв, формат «13:00–14:00».
shipping_cutoff
string
required
Время, после которого отсчёт слота доставки начнётся со следующего дня. Формат «16:30». Если пустое — не применяется.
is_works
boolean
required
Признак работы в дату.
market_location_id
array
required
Идентификаторы складов маркетплейса, к которым подключается склад продавца.

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

200A successful response.
application/json
object
locations
array
required
Результаты по каждому складу из тела запроса create (порядок соответствует массиву locations в запросе).
Итог по одному складу из batch create: location_id — id в системе витрины (пустая строка, если не создано); name — название из запроса; errors — ошибки валидации по полям, при успехе [].
Показать свойства
location_id
string
required
Идентификатор склада в системе витрины; пустая строка, если операция для этой позиции не выполнена.
merchant_location_id
string
Идентификатор локации продавца (опционально).
name
string
required
Название склада из запроса.
status
string
required
Статус склада после операции create.
Допустимые значения
DRAFTPENDINGACTIVEQUARANTINEFAILEDARCHIVED
errors
array
required
Ошибки валидации по полям; пустой массив при успехе.
Унифицированная ошибка валидации поля. Для бизнес-правил витрины использовать code = STOREFRONT_RULE_VIOLATION.
Показать свойства
field
string
required
Имя поля в запросе (например address_tail). Вложенность через точку/индекс: delivery.address_tail, packages[0].type.
code
string
required
Каталог кодов валидации. Коды schema-валидации; для бизнес-правил витрины использовать следующий код STOREFRONT_RULE_VIOLATION. Коды геометрии полигонов (INVALID_COORDINATES, RING_*) не применяются. - REQUIRED: Поле отсутствует или пустое, но обязательно. - REQUIRED_ONE_OF: Нужен хотя бы один из набора полей. - CONDITIONALLY_REQUIRED: Поле обязательно при выполнении условия. - INVALID_TYPE: Неверный JSON-тип значения. - INVALID_ENUM: Значение не из допустимого enum. - INVALID_FORMAT: Общий сбой формата значения. - INVALID_DATE_TIME: Дата/время не RFC3339 или без timezone. - INVALID_DATE: Дата не в формате YYYY-MM-DD. - INVALID_TIME: Время не в формате ЧЧ:ММ. - INVALID_TIME_RANGE: Диапазон времени (перерыв) некорректен. - INVALID_URL: Невалидный URL. - TOO_MANY_ITEMS: Превышен maxItems / лимит элементов в запросе. - MIN_VALUE: Значение ниже допустимого минимума. - MAX_VALUE: Значение выше допустимого максимума. - NEGATIVE_VALUE: Отрицательное значение там, где недопустимо. - INVALID_RANGE: Некорректный диапазон (from > to и т.п.). - NOT_FOUND: Сущность не найдена. - CONFLICT: Конфликт состояния объекта. - INVALID_STATUS_TRANSITION: Недопустимый переход статуса. - STATUS_NOT_ALLOWED: Статус недоступен в текущем контексте. - INVALID_ADDRESS_FORMAT: address_tail / адрес не по шаблону. - INVALID_LATITUDE: Широта вне диапазона [-90, 90]. - INVALID_LONGITUDE: Долгота вне диапазона [-180, 180]. - SCHEMA_MISMATCH: Набор полей не соответствует location_types / схеме. - STOREFRONT_RULE_VIOLATION: Нарушение бизнес-правила витрины.
Допустимые значения
REQUIREDREQUIRED_ONE_OFCONDITIONALLY_REQUIREDINVALID_TYPEINVALID_ENUMINVALID_FORMATINVALID_DATE_TIMEINVALID_DATEINVALID_TIMEINVALID_TIME_RANGEINVALID_URLTOO_MANY_ITEMSMIN_VALUEMAX_VALUENEGATIVE_VALUEINVALID_RANGENOT_FOUNDCONFLICTINVALID_STATUS_TRANSITIONSTATUS_NOT_ALLOWEDINVALID_ADDRESS_FORMATINVALID_LATITUDEINVALID_LONGITUDESCHEMA_MISMATCHSTOREFRONT_RULE_VIOLATION
message
string
required
Текст ошибки для клиента. Для STOREFRONT_RULE_VIOLATION — описание конкретного правила витрины.

Ошибки

400Некорректный запрос
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
401Ошибка авторизации
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
429Превышен лимит запросов
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
500Внутренняя ошибка сервера
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
defaultОшибка (неожиданная или прочие)
application/json
object
error_type
string
ERROR_TYPE_UNAUTHORIZED — 401, ERROR_TYPE_RATE_LIMIT — 429, ERROR_TYPE_INTERNAL — 500
Допустимые значения
ERROR_TYPE_UNSPECIFIEDERROR_TYPE_UNAUTHORIZEDERROR_TYPE_RATE_LIMITERROR_TYPE_INTERNAL
code
string
код ошибки
message
string
сообщение
details
object
POST/v1/merchant/location/create
1curl 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": true34        }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": "address_tail",
          "code": "REQUIRED",
          "message": "Поле address_tail обязательно"
        }
      ]
    }
  ]
}

A successful response.