Тарифный калькуляторbeta 2

Rest API

Введение

С помошью API тарифного калькулятора вы сможете производить расчет доставки по тарифной сетке Exline на любом вашем сайте или во внутренней корпоративной системе. Удобный и простой способ передачи данных для расчета по HTTP и легкий прием результата в форматах XML и JSON.

Работа с калькулятором

Калькулятор предоставляет две функции по HTTP запросу. Во первых вы сможете получить список всех городов, по которым производится расчет тарифа. Во вторых, по другому HTTP запросу можно получить тариф, расчитанный на основе данных переданных в запросе. В обоих случаях, возвращаемый результат можно получить в формате XML или JSON.

Запрос на получение списка городов

Возвращаемые значения содеражат следующую информацию по городам: Наименование на русском, Код для отправки в HTTP запросе.

Запрос на получение списка пунктов отправки

Для получения списка городов, в формате xml, необходимо сформировать запрос следущего вида: http://calc.exline.kz/cities_origin.xml

То же самое и для формата JSON. Запрос списка будет выглядеть следующим образом: http://calc.exline.kz/cities_origin.json

Для работы с калькулятором, перед каждым запросом на калькуляцию, используйте актуальный список городов, так как он может меняться.

Запрос на получение списка пунктов доставки

http://calc.exline.kz/cities_destination.xml http://calc.exline.kz/cities_destination.json

Запрос на тарификацию

Для рассчета тарифа, калькулятору требуется следующая информация: пункт отправления, пункт назначения, вес(кг), срочность (стандарт или экспресс), тип отправления (посылка или пакет) и объявленная ценность (опционально). Ниже приведен пример HTTP запроса на рассчет тарифа в XML формате. Город отправления Алматы (origin), город получения Астана (destination), вес (weight), срочность (express) тип отправления (type). http://calc.exline.kz/calculate.xml?origin=Almaty&destination=Astana&weight=13.6&urgency=express&type=parcel

Опционально можно также передать сумму объявленной ценности declared_value для расчета сбора.

Через origin и destination должны быть переданы коды городов. Их можно получить по запросу (см. выше) или используя таблицу в самом низу данной документациию

Через weight должен быть передан вес (float или integer)

urgency принимает только два значения: express или standart

type принимает только два значения: parcel или packet

Обработка ошибок

В случае передачи неверных данных, будет возвращен массив обнаруженных ошибок. Массив будет передан в JSON или в XML в зависимости от формата первичного запроса.

Список региональных центров (0)

Компания Exline осуществляет отправки только из региональных центров Республики Казахстан. При передачи HTTP запроса origin должен иметь код одного из городов этой таблицы. В ином случае будет возвращена ошибка.

Название города Код для запроса
Алматы 050000

Список городов второй категории (0)

Все города в этой таблице тарифицируются по второй категории (Зона 2 для стандартных отправлений и Зона 4 для экспресс отправлений). Данные города не могут быть пунктами отправления.

Название города Код для запроса