API - Warehouse - Точки продаж
Пример запроса на добавление данных
POST /warehouse/update
HTTP/1.1
HOST: api.zelenka.ru
{
"id": "341",
"name": "Аптека1",
"brand": "Бренд1",
"location_id": 78,
"address": "г. Санкт-Петербург, ул.Маршала Казакова, д.11",
"phone": "8 (812) 000-11-22",
"worktime": "Пн-Пт 8:00-20:00; Сб-Вс 10:00-18:00",
"notify_order_email": "email_for_notify@your_domain.ru",
"flag24hours": 1,
"organisation": {
"inn": "123456",
"name": "ООО Здоровья всем"
},
"on_request": 0,
"is_deleted": 0
}
HTTP/1.1
HOST: api.zelenka.ru
{
"id": "341",
"name": "Аптека1",
"brand": "Бренд1",
"location_id": 78,
"address": "г. Санкт-Петербург, ул.Маршала Казакова, д.11",
"phone": "8 (812) 000-11-22",
"worktime": "Пн-Пт 8:00-20:00; Сб-Вс 10:00-18:00",
"notify_order_email": "email_for_notify@your_domain.ru",
"flag24hours": 1,
"organisation": {
"inn": "123456",
"name": "ООО Здоровья всем"
},
"on_request": 0,
"is_deleted": 0
}
Параметры запроса
- id - идентификатор. При запросе производится проверка есть ли уже точка у этого контрагента с данным идентификатором, если нет то создается, если есть то данные обновляются.
- name - название точки продаж (должно быть уникально для контрагента)
- brand - бренд, торговое название аптечной сети/аптеки (название на вывеске)
- location_id - обязательный параметр - код города/региона (78 - Санкт-Петербург)
- address - адрес точки продаж
- phone - телефон точки продаж
- worktime - время работы. Если время работы имеет много вариантов, то предпочтителен следующий формат:
"Пн-Пт 8:00-20:00; Сб 10:00-18:00; Вс 12:00-18:00". В местах с ограниченной шириной будет производиться перенос по знаку ";" точка с запятой. - notify_order_email - email для уведомлений, если заполнен то будут приходить письма-уведомления о заказах. Можно указать несколько email, разделите запятая или точка с запятой. Например email_for_notify@your_domain.ru; second_notify@your_domain.ru.
- flag24hours - признак круглосуточной работы.
- organisation - информация о юридическом лице. Для объекта organisation поля inn и name обязательны. Необязательно для заполнения.
- on_request - точка продаж работает под запрос с главного склада. Значение 1 = точка «под заказ» со склада включена, Значение 0 = точка «под заказ» со склада выключена.
- is_deleted - флаг обозначающий что данная точка выключена для отображения на сайте. Значение = 1 точка выключена, по умолчанию или значение = 0 точка включена
Обязательные поля
- id
- location_id
Ответ сервера
При успешном добавлении ответ возвращается с кодом статуса 201, при обновлении 200.
В случае если передается точка продаж с флагом is_deleted и на стороне Зеленки ее нет, код ответа будет 208 Already Reported. Удаленные точки не создаются, но если точка существует, устанавливается флаг удаления.
В теле ответа массив параметров точки продаж.
{
"id": 44,
"name": "NewWarehouse",
"location_id": 78,
"address": "Невский, 1",
"phone": "88123121212",
"worktime": "8:00 - 22:00",
"flag24hours": 1,
"organisation": {
"inn": "123456",
"name": "ООО Здоровья всем"
},
"on_request": 0
}
"id": 44,
"name": "NewWarehouse",
"location_id": 78,
"address": "Невский, 1",
"phone": "88123121212",
"worktime": "8:00 - 22:00",
"flag24hours": 1,
"organisation": {
"inn": "123456",
"name": "ООО Здоровья всем"
},
"on_request": 0
}
Возможные коды ошибок
409: Duplicate entity with name: {name} (id: {id}) - в случае добавления точки продаж с дубликатом названия.