# Изменение статуса заказа

Адрес: **https://service.leadhit.ru/api/v1/orders**  
Метод: **set_order_status**
#### Описание

Изменение статусов заказов можно использовать для настройки триггерных рассылок.

#### Параметры

Метод: **POST**  
Заголовки: **api-key**  
Параметры:  
- **JSON** с полями **"order_id"**, **"status"**;  
- Версия JSON-RPC: **2.0**;  
- ID запроса: **0**.

Статус должен быть одним из списка: **"submitted", "paid", "delivered", "cancelled"**.  
После получения нами заказа, ему выставляется статус "submitted" - оформлен.  

API-key запросите у нас.


#### Пример использования

```js
POST https://service.leadhit.ru/api/v1/orders
```

**Headers (application/json)**:  
```js
api-key: <api-key>
```

**Body (application/json)**:  
```json
{
  "method": "set_order_status",
  "params": {
    "order_id": "f168148717",
    "status": "paid"
  },
  "jsonrpc": "2.0",
  "id": 0
}
```

**Response 200 (application/json)**:
```json
{
  "jsonrpc": "2.0",
  "result": {
	"status": "ok",
	"message": "Order status changed"
  },
  "id": 0
}
```
---
##### Возможные ошибки
- Если номер заказа не найден:  
**Response 200 (application/json)**:  
```json
{
  "message": "Order with this id doesn't exist"
}
```

- Если неправильно указан статус заказа:  
**Response 200 (application/json)**:  
```json
{
  "message": "Possible statuses: cancelled, delivered, paid, submitted"
}
```

- (Скоро добавим) Если передаваемый статус заказа совпадает с текущим:  
**Response 200 (application/json)**:  
```json
{
  "message": "Order status already set"
}
```

#### Пример запроса с помощью CURL:
```
Curl:
```sh
$ curl -i \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "API-KEY: 4f8425fc77796b0266000009:TKW0i5FP5vkIrgMlnpoZbfOEagA" \
    -X POST -d '{"method":"set_order_status","params":{"order_id":"f168148717","status":"paid"},"jsonrpc":"2.0","id":0}' \
    https://service.leadhit.ru/api/v1/orders/

>>> {"jsonrpc": "2.0", "result": {"status": "ok", "order_status": "paid"}, "id": 0}
```