Публичный API
Публичный 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 - дополнительное сообщение или сообщение об ошибке
