Статусы заказов
Статусы заказов используются для организации оформленных заказов, рассылки уведомлений и выполнения различных действий при изменении статусов заказов. Каждый магазин должен иметь определённый набор статусов, которые нельзя удалить, а так же неограниченное количество пользовательских статусов.
Используемые структуры
Статус заказа
{
"id": "8ffdea87-775f-47e9-89f0-bbb974dae43f",
"name": "Новый",
"progress_bar_name": "Новый",
"kind": {
"id": "submitted",
"name": "Новый"
},
"background_color": "#d78ca4",
"sorting": 1,
"visible": true,
"visible_to_cashier": true,
"roles": null,
"created_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2020-03-03 06:47:22",
"datetime": "2020-03-03 14:47:22",
"datetime_at": "03.03.2020 в 14:47",
"date": "03.03.2020",
"diff": "2 года назад",
"timestamp": 1583218042,
"iso_utc": "2020-03-03T06:47:22+00:00",
"iso": "2020-03-03T14:47:22+08:00"
},
"updated_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2020-03-03 06:47:22",
"datetime": "2020-03-03 14:47:22",
"datetime_at": "03.03.2020 в 14:47",
"date": "03.03.2020",
"diff": "2 года назад",
"timestamp": 1583218042,
"iso_utc": "2020-03-03T06:47:22+00:00",
"iso": "2020-03-03T14:47:22+08:00"
}
}
Описание полей
Системные статусы
У каждого статуса должно быть указано назначение. В зависимости от типа назначения будут выполняться те или иные действия, после того, как статус заказа меняется на статус с указанным типом назначения.
К примеру, при изменении статуса на статус с назначением confirmed
, покупателю будут отправлены уведомления
о том, что заказ был выполнен. В случае с cancelled
-- уведомление об отмене заказа.
Есть несколько назначений, которые являются системными и обязаны присутсвовать у каждого магазина. Такие статусы нельзя удалить и у них не может быть изменён тип назначения. Следующие типы являются системными:
pending
- заказ формируется покупателем;submitted
- заказ был отправлен покупателем;exported
- заказ был экспортирован во внешнюю систему учёта;delivering
- заказ находится в процессе доставки;rejected
- заказ был отклонён сотрудниками магазина;cancelled
- заказ был отменён покупателем;completed
- заказ был выполнен.
Видимость статусов
Мобильные приложения и сайты Zenky позволяют покупателем отслеживать статус заказов. Интерфейс отслеживания может отличаться в различных шаблонах/приложениях, но общий приницип остаётся одинаковым: покупатель видит список статусов заказов в виде шкалы прогресса, на которой отмечено, выполнился статус или нет.
Так как у магазина могут быть статусы заказов, которые не следует отображать в таких списках,
поле visible
поможет скрыть лишние статусы от покупателей.
Методы
Список поддерживаемых методов для работы со статусами заказов.
Список статусов
Возвращает список статусов заказов магазина.