API Orders

Обзор

Данный документ описывает методы для работы поставщика/дистрибьютора по получению полного или отсортированного по статусу списка заказов, а также изменению и корректировке заказа поставщиком в системе Smart Satu.

Версия

Version: 1.0.0

Контактная информация

Contact: info@smartsatu.com

URI схема

Host : //smartsatu.com/api/ Schemes : HTTPS

Методы

Получение списка заказов

GET /orders

Получение списка заказов в зависимости от статуса заказа

GET /orders?status=

Изменение и корректировка заказа поставщиком

PUT /orders/{id}

Описание

Получение списка заказов

Для того чтобы получить список всех заказов необходимо отправить GET-запрос c пустым телом по URL: https://food.smartsatu.com/api/orders. В headers запроса обязательно должна передаваться страна пользователя, а также уникальный токен авторизации, который был получен при входе в систему. Ответом от сервера будет являться массив данных со списком всех ваших заказов в системе Smart Satu с их данными. Во всех заказах передается тип оплаты "payment_type", где:

• 0 = оплата заказа наличными;
• 1 = оплата заказа оборотными средствами;
• 2 = оплата заказа по QR;
• 3 = оплата заказа по безналичному расчету.

Получение списка заказов в зависимости от статуса заказа

Для того чтобы получить список заказов имеющих определенный статус необходимо отправить GET-запрос c пустым телом по URL: https://food.smartsatu.com/api/orders. В строке запроса необходимо добавить параметр статуса и его значение (?status=1). В итоге получаем запрос вида: https://food.smartsatu.com/api/orders?status=3. В headers запроса обязательно должна передаваться страна пользователя, а также уникальный токен авторизации, который был получен при входе в систему. Ответом от сервера будет являться массив данных со списком всех ваших заказов в указанном статусе, а также их данными. Также возможно получение списка заказов, начиная от определенной даты, указав дату и время:

Пример: https://food.smartsatu.com/api/orders?status=7&updated_from=2019-11-27T07:03:01

Перечень статусов заказа:

Status	Description
status=1	Новый
status=2	Принят
status=3	Отклонен поставщиком
status=4	Принят с корректировкой
status=5	Подтвержден
status=6	Отменен магазином
status=7	Выполнен
status=8	Не доставлен
status=9	Не выполнен
status=10	Выполнен с корректировкой

Изменение и корректировка заказа поставщиком

Для того чтобы изменить статус заказа, количество товаров или набор продуктов в заказе необходимо отправить PUT-запрос c JSON-телом по URL: https://food.smartsatu.com/api/orders/{id}, где id - это уникальный идентификатор заказа, который необходимо изменить. Поставщик может изменять новые заказы (status=1) на статусы, которые представлены в таблице ниже:

Status	Description
status=2	Принят: заказы, принятые поставщиком.
status=3	Отказ: заказы, отмененные поставщиком.
status=4	Принят с корректировкой: заказы, измененные поставщиком (наличие, количество, дата доставки).
status=9	Не выполнен - заказ, который был принят поставщиком, но не будет доставлен в торговую точку

Если заказ принят или отклонен, то запрос должен содержать обязательный параметр status и значение 2 (принят) или 3 (отклонен).

Если у заказа меняется status на 3 (отклонен), то, помимо обязательного параметра status, запрос должен содержать параметр comment.

Order_items в случае отклонения заказа передавать в запросе не нужно.

Если заказ должен быть изменен, то запрос должен содержать параметры offer_id и quantity.

Внимание: offer_id на самом деле id в order_items, а не offer_id - идентификатор предложения.

Если были переданы не все товарные позиции из order_items, то отсутствующие позиции будут удалены системой из заказа.

Безопасность

В headers запроса обязательно должна передаваться страна пользователя, а также уникальный токен авторизации, который был получен при входе в систему. Ответом от сервера будет являться массив данных с измененными данными заказа.

Type	In	Name	Description
Authorization	header	required	Для создания HTTP Basic Auth заголовка нужно преобразовать access_token следующим образом: $auth= "Basic " . base64encode(access_token . ":"); Данный токен должен использоваться в каждом запросе в системе.
country	header	required	Параметр страны должен использоваться в каждом запросе в системе.

Параметры

Type	Name	Description	Schema
Body	body required	Запрос на изменение заказа

Ответы

Response Orders Items:

HTTP Code	Description	Schema
200	Ok	Response Counterparties
401	Unauthorized	401
403	Forbidden	403

Orders Status Change Response:

HTTP Code	Description	Schema
200	Ok	Response Counterparties
401	Unauthorized	401
403	Forbidden	403

Принимаемые ресурсом типы MIME

• application/json

Возвращаемые ресурсом типы MIME

• application/json

Определения

Request Order Items

Name	Description	Schema	Example
offer_id	Идентификатор предложения	integer($int64)	3463374
quantity	Количество	integer($int64)	4

Пример запроса:

{
   "offer_id": 3463374,
   "quantity": 4
 }

Request Order Status Change

Name	Description	Schema	Example
comment	Комментарий	string	В наличии есть только 4 бутылки
items	Массив	< items> array	4
status	Статус заказа	string	Принят с корректировкой: заказы измененные поставщиком (наличие, количество)

Items

Name	Description	Schema	Example
quantity	Количество	integer($int64)	4
delivery_days	Дни доставки	string	null
offer_id	Уникальный номер предложения	integer($int64)	3463374

Пример запроса:

{
 "comment": "Вот такой комментарий ",
 "items":
   [
       {
   "quantity": 50,
   "delivery_days": "",
   "offer_id": 4166524
   }
   ],
 "status": 4
}

Response Orders Items

Items

Name	Description	Schema	Example
id	Уникальный идентификатор заказа	integer	258941
store_user_id	Идентификатор пользователя торговой точки	integer	656
store_company_id	Идентификатор торговой точки	integer	80
supplier_company_id	Идентификатор поставщика	integer	84
delivery_date	Дата доставки	string	1,2,4,6
initial_delivery_date	Первоначальная дата доставки	string	1,2,4,6
supplier_company_id	Идентификатор поставщика	string	84
supplierCompanyName	Идентификатор названия поставщика	integer	ТОО "Поставщиk-"
status	Статус заказа	integer	1
created_at	Дата создания заказа	integer	1532517982
updated_at	Дата обновления заказа	integer	1532517982
with_documents	Наличие документов	boolean	0
sum	Общая сумма заказа	integer	11340
comments	Комментарий к заказу	string	Ок
replacement_id	Идентификатор заказа на обмен	string	null
replacement_status	Статус заказа на обмен	string	null
alcohol_license	Алкогольная лицензия	object
number	Номер алкогольной лицензии	string	213
expire_at	Начало действия алкогольной лицензии	string	1522022400
expire_at_date	Конец действия алкогольной лицензии	string	26.03.2018
payment_type	Тип оплаты заказа	integer	0
order_items	Массив	< order_items > array
Supplier_company_name	Название поставщика	string	ТОО "Поставщиk-"
store_company	Массив	< store_company > array

Order Items

Name	Description	Schema	Example
id	Идентификатор наименования товара	integer($int32)	1631118
order_id	Идентификатор заказа	integer($int32)	204533
offer_id	Идентификатор предложения	integer($int32)	4134408
product_id	Идентификатор товара	integer($int32)	85067
quantity	Количество продукта	integer	1
initial_quantity	Начальное количество продукта	integer	1
quantity_decimal	Дробное значение продукта	string	1
initial_quantity_decimal	Начальное дробное значение продукта	string	1
amount	Общая сумма	string	2000
deleted	Удален	boolean	0
offer	Предложение	object
id	Идентификатор предложения	string	4345054
name	Название предложения	string	Воздух чистый, Алматинский ПЭТ 5л
sku	Штрих-код предложения	string	cash12039823407121
unit	Единица измерения предложения	string	шт
manufacturer	Производитель	string	null
quantity	Количество	string	1
expires_at	Годен до	string	null
price_1	Цена 1 (для магазинов)	string	1260
price_2	Цена 2 (для HoReCa)	string	1386
price_3	Цена 3 (для рынков)	string	1134
price_4	Цена 4	string	null
price_5	Цена 5	string	null
unique_code	Уникальный код	string	null
product_id	Идентификатор продукта	string	28952
step	Шаг	string	null
minQuantity	Минимальное количество товара для заказа	string	1.000
price	Цена для текущей ТТ	string	1260
product	Товар	object
id	Идентификатор товара	string	28952
name	Название продукта	string	Воздух чистый, Алматинский ПЭТ 5л
sku	Штрих-код предложения	string	cash12039823407121
unit	Единица измерения предложения	string	шт
manufacturer	Производитель	string	null
category_id	Идентификатор категории товара	string	360
images	Массив	< images > array
status	Статус товара	string	1
user_id	Идентификатор пользователя	string	132
is_weighted	Весовой товар	boolean	0
promotion_type		string	0

Images

Name	Description	Schema	Example
id	Идентификатор изображения	integer($int32)	1631118
product_id	Идентификатор продукта	string	28952
scr	Ссылка на изображение	string	https://cdn.smartsatu.com/food/images/products/7238_14752205982FZWw.jpg
thumb	Ссылка на изображение	string	https://cdn.smartsatu.com/food/images/products/7238_14752205982FZWw.jpg

Store company

Name	Description	Schema	Example
route_list	Идентификатор наименования товара	string	null
name	Идентификатор заказа	string	маг. "Рокфор"
min_order_price	Минимальная сумма заказа	integer	0
email	Адрес электронной почты	string	shop@me.kz
description	Описание	string	Магазин для тестирования\r\n
address	Адрес торговой точки	string	Алматы, Байзакова, 125/185
conact	Контактные данные	string	Телефон: +78000000001, Вн.: 123, Контактное лицо: Гайка
type	Тип торговой точки	string	store
tin	ИНН торговой точки	string	0123456789
phone	Номер телефона	string	+78000000001
supplier_rule	Правила поставщика	string	null
logo	Логотип	string	https://food.smartsatu.com/images/no_image_130x130.png
has_replacement_products	Обмен товаров	string	1
cashback_percent	Кэшбэк включен	string	true
has_cashback	Кэшбэк включен и активен	string	false
position	Позиция для сортировки	integer	999
supplier_store_id	UCS-код торговой точки	string	3214567

Пример ответа:

{
 "items": [
   {
     "id": "258941",
     "store_user_id": 656,
     "store_company_id": 656,
     "delivery_date": "1,2,4,6",
     "initial_delivery_date": "1,2,4,6",
     "supplier_company_id": "84",
     "supplierCompanyName": "ТОО \"Поставщиk-",
     "status": "1",
     "created_at": 1532517982,
     "updated_at": 1532517982,
     "with_documents": 0,
     "sum": 11340,
     "comments": "Ок",
     "replacement_id": " ",
     "replacement_status": " ",
     "alcohol_license": {
       "number": "213",
       "expire_at": "1522022400",
       "expire_at_date": "26.03.2018"
     },
     "payment_type": 0,
     "order_items": [
       {
         "id": 1631118,
         "order_id": 204533,
         "offer_id": 4134408,
         "product_id": 85067,
         "quantity": 1,
         "initial_quantity": 1,
         "quantity_decimal": 1,
         "initial_quantity_decimal": 1,
         "amount": 2000,
         "deleted": 0,
         "offer": {
           "id": "4345054",
           "name": "Воздух чистый, Алматинский ПЭТ 5л",
           "sku": "cash12039823407121",
           "unit": "шт",
           "manufacturer": " ",
           "quantity": "1",
           "expires_at": " ",
           "price_1": "1260",
           "price_2": "1386",
           "price_3": "1134",
           "price_4": " ",
           "price_5": " ",
           "unique_code": "",
           "product_id": "28952",
           "step": "",
           "minQuantity": "1.000",
           "price": "1260"
         },
         "product": {
           "id": "28952",
           "name": "Воздух чистый, Алматинский ПЭТ 5л",
           "sku": "9890000033839",
           "unit": "шт.",
           "quantity": "1",
           "manufacturer": " ",
           "category_id": "360",
           "images": [
             {
               "id": "39236",
               "product_id": "28952",
               "scr": "https://cdn.smartsatu.com/food/images/products/7238_14752205982FZWw.jpg",
               "thumb": "https://cdn.smartsatu.com/food/images/products/7238_14752205982FZWw.jpg"
             }
           ],
           "status": "1",
           "user_id": "132",
           "is_weighted": 0
         },
         "promotion_type": "0"
       }
     ],
     "Supplier_company_name": "ТОО \"Поставщиk-",
     "store_company": {
       "address": "Алматы, Байзакова, 125/185",
       "min_order_price": 0,
       "description": "Магазин для тестирования\\r\\n",
       "cashback_percent": "true",
       "supplier_rule": "NULL",
       "type": 1,
       "has_replacement_products": "1",
       "has_cashback": "false",
       "phone": "+78000000001",
       "route_list": "",
       "contact": "Телефон: +78000000001, Вн.: 123, Контактное лицо: Гайка",
       "name": "маг. \"Рокфор",
       "tin": "0123456789",
       "logo": "https://food.smartsatu.com/images/no_image_130x130.png",
       "id": "80",
       "position": 999,
       "email": "shop@me.kz"
       "supplier_store_id": "3214567"
     }
   }
 ]
}

Orders Status Change Response