История заказов (parcel/statuses)

Метод позволяет получить список всех изменения статусов заказов за определённе время . Используется для обновления статусов заказов.

URL запроса: https://api.multi-point.net/index.php?route=parcel/statuses&api_key=XXX 

(где XXX, ключ API сгенерированный в панели управления поставщика ПВЗ). 

Тип запроса: GET

Параметры URL запроса

Параметр	Описание	Формат	Обязательно
api_key	Ключ API сгенерированный в панели управления поставщика ПВЗ	строка	Да
point_id	Идентификатор отделения	целое число	Нет
parcel_id	Идентификатор заказа в базе Multi Point	целое число	Нет
external_order_id	Внешний идентификатор отправления зарегистрированный в базе поставщика	cтрока	Нет
minutes	Время в минутах, за которое требуется получить историю заказов. Например: minutes=60, позволит получить историю заказов за последние 60 минут. По умолчанию 60 минут, если параметр не указан. Максимум 1440 минут (сутки).	целое число	Нет

 Пример реализации запроса на PHP с помощью CURL

    $url = 'https://api.multi-point.net/index.php?route=parcel/statuses&api_key=XXX&minutes=60';
    	
    $ch = curl_init();
    
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    
    $response = curl_exec($ch);
    
    curl_close($ch);
    
    $result = json_decode($response, true);
		
    return $result;

Успешный результат выполнения примера

Array
(
    [0] => Array
        (
            [parcel_id] => 1408447 // Идентификатор отправления
            [external_order_id] => // Внешний идентификатор отправления зарегистрированный в базе поставщика
            [parcel_number] => 79497777777 // Номер отправления
            [barcode] => ww153741 // Штрих-код отправления
            [telephone] => 79497777777 // Телефон получателя
            [status] => Готов к выдаче // Статус отправления
            [state] => awaiting_issued // Состояние
            [price] => 45.00 // Стоимость к оплате
            [date_added] => 2023-11-13 12:35:37 // Дата изменения статуса
        )

    [1] => Array
        (
            [parcel_id] => 1404448
            [external_order_id] => 
            [parcel_number] => 79998888888
            [barcode] => ww150756
            [telephone] => 79998888888
            [status] => Выдана
            [state] => issued
            [price] => 200.00
            [date_added] => 2023-11-13 12:35:47
        )

    [2] => Array
        (
            [parcel_id] => 1401232
            [external_order_id] => 
            [parcel_number] => 0132844906-0035
            [barcode] => ii4991275239
            [telephone] => 79999999999
            [status] => Выдана
            [state] => issued
            [price] => 40.00
            [date_added] => 2023-11-13 12:35:53
        )
)

Результат примера выполненный с ошибкой авторизации

    Array
    (
        [error] => Array // Массив ошибок
         (
            [warning] => У Вас нет прав для просмотра списка отправлений! // Ключ = строковый код ошибки, значение = текст ошибки
         )
    )