Публичный API позволяет быстро и просто воспользоваться функцией калькулятора и рассчитать стоимость перевозки, а также дополнительных услуг. Публичный API не требует регистрации в личном кабинете «ПЭК». Не нужно получать API-ключ и проходить авторизацию. Достаточно только передать все необходимые параметры (откуда, куда, параметры груза) через GET-запрос и получить стоимость.
Если необходимо рассчитать не только стоимость перевозки, но и использовать другие функции (проверить статус груза, запросить данные по всем грузам и др.), воспользуйтесь API личного кабинета.
Получение списка городов доставки
Ссылка для запроса списка городов: http://www.pecom.ru/ru/calc/towns.php. Формат возвращаемого результата:
{ ‘название региона1’: { id Города1: ‘Название Города1’, id Города2: ‘Название Города2’, id Города3: ‘Название Города3’ ............... }, ‘название региона2’: { id Города1: ‘Название Города1’, id Города2: ‘Название Города2’, id Города3: ‘Название Города3’ ............... } ............... }
Расчет стоимости перевозки/доставки
Ссылка для формирования запроса на расчет: http://calc.pecom.ru/bitrix/components/pecom/calc/ajax.php. Параметры передаются через GET-запрос.
Возвращаемый результат
Параметр Описание, пример использования places[0][] places[1][] ... Параметры груза
places[0][]: 1 places[0][]: 2 places[0][]: 3 places[0][]: 4 places[0][]: 5 places[0][]: 1 places[0][]: 1
по очереди
Ширина, Длина, Высота, Объем, Вес, Признак негабаритности груза, Признак ЗУ
places[1][]: 3 places[1][]: 3 places[1][]: 3 places[1][]: 3 places[1][]: 3 places[1][]: 1 places[1][]: 1
аналогично для следующего груза.take[town]: -457 ID города забора take[tent]: 1 требуется растентровка при заборе take[gidro]: 1 требуется гидролифт при заборе take[manip]: 1 требуется манипулятор при заборе take[speed]: 1 Срочный забор (только для Москвы) take[moscow]: 1 Без въезда, МОЖД, ТТК, Садовое.
значения соответственно: 0,1,2,3deliver[town]: 64883 ID города доставки deliver[tent]: 1 Требуется растентровка при доставке deliver[gidro]: 1 Требуется гидролифт при доставке deliver[manip]: 1 Требуется манипулятор при доставке deliver[speed]: 0 Срочная доставка (только для Москвы) deliver[moscow]: 0 Без въезда, МОЖД, ТТК, Садовое.
значения соответственно: 0,1,2,3plombir: 12 Количество пломб strah: 33 Величина страховки ashan: 1 Доставка в Ашан night: 1 Забор в ночное время pal: 3 Требуется запаллечивание груза (0 - не требуется, значение больше нуля - количество паллет) pallets: 4 Кол-во паллет для расчет услуги паллетной перевозки (только там, где эта услуга предоставляется)
{ ‘take’: [a,b,c], ‘auto’: [a,b,c], ‘alma_auto’: [a,b,c], ‘avia’: [a,b,c], ‘autonegabarit’: [a,b,c], ‘ADD’: [a,b,c], ‘ADD_1’: [a,b,c], ‘ADD_2’: [a,b,c], ‘ADD_3’: [a,b,c], ‘ADD_4’: [a,b,c], ‘deliver’: [a,b,c] ‘periods: ‘Строка’, 'aperiods: ‘Строка’, ‘error’: [‘err1’,’err2’] } где take - данные по забору auto - данные по автоперевозке без учета наценки за негабаритalma_auto - только, если филиал-отправитель или филиал-получатель город Алматы, перевозка идет через Екатеринбург, при этом в auto передаются данные по автоперевозке от места отправки до Екатеринбурга, в alma_auto - от Ектеринбурга до места названчения autonegabarit - данные по автоперевозке с учетом наценки за негабарит, если указан "Признак негабаритности" хотя бы для одного из мест (иначе совпадает со значением auto)avia - данные по авиаперевозке ADD - дополнительные услуги (например, изготовление защитной транспортировочной упаковки) ADD_1 - услуга пломбирования груза ADD_2 - услуга запаллечивания груза ADD_3 - услуга страхования груза ADD_4 - услуга доставки в ночное время deliver - данные по доставке periods - сообщение о сроках и днях отправки груза при автоперевозке aperiods - сообщение о сроках при авиаперевозке a - Название услуги b - Пояснение к услуге c - Стоимость Error - список ошибок выводимых пользователю. Если ключей auto или avia нет - значит услуга НЕ предоставляется Общий результат Автоперевозка: take + auto + deliver + ADD + ADD_1 + ADD_2 + ADD_3 + ADD_4 Автоперевозка для Алматы: take + auto + alma_auto + deliver + ADD + ADD_1 + ADD_2 + ADD_3 + ADD_4 Авиаперевозка: take + avia + deliver + ADD + ADD_1 + ADD_2 + ADD_3 + ADD_4 при наличии полей (auto или avia) соответственно.
Расчет паллетной перевозки
Ссылка для формирования запроса на расчет паллетной перевозки: http://pecom.ru/api/pallet.php. Параметры передаются через GET-запрос.
Возвращаемый результат
Параметр Описание, пример использования from: 446 ID города отправки. Доступна только Москва (446). to: 448 ID города получателя type: 1 Тип паллеты: евро-стандарт (1), финская (2), американская (3) amount: 1 Количество паллет в штуках
{ ‘cost’: ‘число’, ‘message’: ‘Строка’ } где cost - стоимость перевозки за 1 паллету message - дополнительное сообщение или сообщение об ошибке