Отгрузка заказов в ПВЗ (parcel/send)

Отгрузить заказы в ПВЗ (parcel/send)

Метод позволяет произвести отгрузку отправлений в ПВЗ. Метод возвращает список идентификаторов необходимых для получения акта приёма-передачи (см. печать акта-приёма передачи в разделе отчёты и документы). Акт приёма передачи формируется отдельно для каждого отделения.

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

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

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

В запросе необходимо передавать массив с идентификаторами отправлений (parcel_id) которые были выгружены в систему но ещё не были отгружены в ПВЗ.

    $parcels = array(166, 167, 168, 169, 170); // Массив с идентификаторами отправлений
    
    $ch = curl_init();
    	
    curl_setopt_array($ch, array(
        CURLOPT_URL => 'https://api.multi-point.net/index.php?route=parcel/send&api_key=XXX',
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_0,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query($parcels),
        CURLOPT_HTTPHEADER => array('Content-Type: application/x-www-form-urlencoded')
    ));
    
    $response = curl_exec($ch);
    
    curl_close($ch);
    	
    $result = json_decode($response, true);	
		
    return $result;

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

    Array
     (
        [shipments] => Array    
(
            [0] => 64 // Идентификатор акта-приёма передачи
[1] => 65 // Идентификатор акта-приёма передачи

[2] => 66 // Идентификатор акта-приёма передачи
         )          [success] => Успешно! // Подтверждение что запрос успешно выполнен      )

Выполнено с ошибкой (не удалось отгрузить отправления).

Если какие либо из отправлений были отгружены ранее, вернётся многомерный массив exists c ключами parcel_id и shipment_id и значениями соответствующими идентификатору отправления и идентификатору реестра отгрузки.

В случае передачи не корректных идентификаторов отправлений, вернётся массив undefined_parcels_ids с идентификаторами отправлений, которые не удалось распознать.

    Array
     (
        [error] => Array
            (
                [exists] => Array // Отправления были отгружены ранее, возвращаются массивы с идентификаторами отправлений и актами приёма передачи
                    (
                        [0] => Array
                            (
                                [parcel_id] => 166 // Идентификатор отправления
                                [shipment_id] => 1800 // Идентификатор акта-приёма передачи
                            )
                        [1] => Array
                            (
                                [parcel_id] => 167 // Идентификатор отправления
                                [shipment_id] => 2008 // Идентификатор акта-приёма передачи
                            )
                        [2] => Array
                            (
                                [parcel_id] => 168 // Идентификатор отправления
                                [shipment_id] => 2010 // Идентификатор акта-приёма передачи
                            )
                    )
                [undefined_parcels_ids] => Array
                    (
                        [0] => 169 // Не удалось найти отправление с таким идентификатором
                        [1] => 170 // Не удалось найти отправление с таким идентификатором
                    )
                [warning] => Внимательно проверьте данные на ошибки!
            )
     )