Регистрация

Главная » Помощь » API интеграции магазинов

API интеграции "Калькулино"

 

Протокол реализован поверх протокола HTTP. Принимаются запросы POST и GET. Предусмотрен механизм авторизации запросов при помощи подписи закрытым ключом доступным в профиле пользователя.

Вызовы API

На данный момент доступны следующие вызовы:

Адрес метода Краткое описание

http://calculino.info/api/list_services

Получить список служб, делающих доставку по заданному маршруту

Входные параметры:

  • Откуда: obj[data][from][region] - область
  • obj[data][from][district] - район
  • obj[data][from][town] - город
  • Куда: obj[data][to][region] - область
  • obj[data][to][district] - район
  • obj[data][to][town] - город
  • obj[all_subtypes] - если не указан или 0 будут возвращены только службы поддерживающие онлайн заказы. Если 1 - все службы и услуги доступные на данном маршурте.
  • Формат ответа: obj[return_as] (может принимать значения:xml,json,urlencode)

 

Возвращаемые данные (json):

{

"status":

{

"ok":"Ok"//статус ответа

},

"services":

{ //список доступных служб

"внутренний номер службы (целое >0)":

{

"id":"внутренний номер службы",

"name":"название",

"subtypes":

{

"service":

[

{

"id":"номер услуги (целое или 0)",

"name":"название услуги"

},

],

"cargo":

[

{

"id":"номер типа груза (целое или 0)",

"name":"название типа"

},

],

"packages":

[

{

"id":"номер типа упаковки (целое или 0)",

"name":"название упаковки"

}

]

}

}

}

}

 

http://calculino.info/api/calculate

Рассчитать стоимость доставки

Входные параметры:
 

  • Откуда: obj[data][from][region] - область
  • obj[data][from][district] - район
  • obj[data][from][town] - город
  • obj[data][from][address] - улица, дом
  • Куда: obj[data][to][region] - область
  • obj[data][to][district] - район
  • obj[data][to][town] - город
  • obj[data][from][address] - улица, дом
  • obj[data][service_id] - номер службы
  • Параметры: obj[data][mass] - вес посылки (грамм)
  • obj[data][dims][width] - ширина (см)
  • obj[data][dims][height] - высота
  • obj[data][dims][length] - длина
  • obj[data][invoice] - декларированная стоимость груза (грн)
  • obj[data][subtypes][services] - номер услуги доставки
  • obj[data][subtypes][cargo] - номер типа груза
  • obj[data][subtypes][packages] - номер типа упаковки
  • Формат ответа: obj[return_as] (может принимать значения:xml,json,urlencode)

 

Возвращаемые данные (json):

{

"total":"полная стоимость доставки",

"payments":

{

//список платежей

"номер по порядку":

{

"costs":

{

"id":"идентификатор тарифа",

"name":"название тарифной зоны или тарифной статьи",

"size":"стоимость, рассчитанная по размерам",

"mass":"стоимость по весу",

"volume":"стоимость по объему",

"total":"полная стоимость"

}

"description":"описание платежа"

}

}

"status":

{

"ok":"Ok" //статус ответа

}

}

 

 Стандартные сообщения об ошибках:

Сообщение об ошибке возвращается в контейнере status
Пример (json):
"status":{"error":"сообщение об ошибке"}