API - О статусах заказа

В системе применяются пять статусов.

  1. Новый заказ - заказ добавлен, но еще не оформлен. Наши менеджеры его не видят. Заказ может содержать ошибки (например не польностью указанный адрес).
  2. В обработке - заказ оформлен (переведен в работу), но наши менеджеры еще не назначили курьера для этого заказа. На данный статус можно первести только заказы, которые не содержат ошибок.
  3. В доставке - заказу назначен курьер, который будет выполнять доставку.
  4. Возврат - заказ доставлен по месту назначения, но от него отказались. Заказ будет возвращен.
  5. Доставлено - заказ доставлен по месту назначения.

Для получения списка статусов в API есть метод getStatuses. Метод возвращает список всех возможных статусов, на которых может находиться заказ. В ответе можно найти название статуса и его уникальный идентификатор. Данный идентификатор статуса может использоваться в запросе списка заказов, для фильтрации заказов по статусу.

Параметры запроса
Параметр Тип Описание
key string Ваш API-ключ
method string getStatuses
Пример запроса
$url = 'https://www.algocom.ru/personal/api/v1.0/json/index.php';
$data = array(
	'key' => 'ВАШ API-КЛЮЧ',
	'method' => 'getStatuses',
);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$json = curl_exec($ch);
print $json;
Пример успешного ответа
{
	"statuses":[
		{"id":52,"name":"Новый заказ"},
		{"id":55,"name":"В обработке"},
		{"id":62,"name":"В доставке"},
		{"id":63,"name":"Возврат"},
		{"id":64,"name":"Доставлено"}
	]
}
Пример ответа с ошибкой авторизации
{"error":"Wrong API key"}


Вернуться назад