Экономные перевозки тяжеловесного груза из Москвы в Екатеринбург от 8.5 5 руб/кг

Инструкция по установке и эксплуатации калькулятора стоимости доставки груза Транспортной Компаниии КИТ для Интернет магазинов

Техническая поддержка

Инструкция по установке и эксплуатации калькулятора стоимости доставки груза Транспортной Компанией КИТ для Интернет магазинов

Содержание

  • Получение кода калькулятора
  • Установка калькулятора на сайт
    • Установка кода iFrame
    • Создание проксирующего php-файла
  • Вызов калькулятора с предустановленными значениями
  • Получение ответа с результатами от калькулятора

 

1. Получение кода калькулятора

Чтобы получить код калькулятора нужно:

  1. 1 Перейти на страницу https://tk-kit.ru/get_im_calc/ 
  2. 2 Настроить внешний вид калькулятора используя поля ввода слева 
  3. 3 Ввести контактные данные и адрес сайта на котором будет размещён калькулятор и нажать кнопку “Получить код для вставки на сайт” 
  4. 4 В результате вы получите сообщение с кодом для вставки на сайт 

 

2. Установка калькулятора на сайт

Установка калькулятора на сайт производится в два шага:

  1. 1Вставьте код
    <iframe src=”/im.tk-kit.ru.proxy.php?c=…” …></iframe>
    в том месте HTML кода вашего сайта где вы хотите, чтобы был показан калькулятор.
  2. 2 В корневой директории сайта создайте новый PHP файл с именем im.tk-kit.ru.proxy.php со следующим кодом: 
    Этот файл необходим для обеспечения кросс-доменной передачи данных от калькулятора вашему сайту.

 

3. Вызов калькулятора с предустановленными значениями

Если вы хотите, чтобы при загрузке калькулятора на вашем сайте поля калькулятора были предварительно заполнены необходимыми вам данными, вам нужно дополнить код вставки
<iframe>
дополнительными параметрами, например
<iframe src=”/im.tk-kit.ru.proxy.php?c=…&w=150&v=1.5” …></iframe>

Перечень, формат и описание допустимых параметров:

from – код города откуда осуществляется доставка*.
to – код города куда осуществляется доставка*.
delivery – 1 или 0. Если 1 – отмечен пункт ”Доставить до квартиры”. Если 0 – отмечен пункт ”Самовывоз со склада ТК КИТ”. По умолчанию, если параметр не передан, то отмечен пункт ”Доставить до квартиры”.
sh – высота груза в сантиметрах.
sw – ширина груза в сантиметрах.
sl – длина груза в сантиметрах.
v – объём груза в кубических метрах **.
w – вес груза в килограммах.
p – объявленная стоимость груза в рублях.
e[] – коды дополнительных услуг***.
autocalc – может принимать любое значение, даже пустое. Если передан этот параметр калькулятор произведёт расчёт стоимости доставки автоматически при загрузке без необходимости нажатия кнопки «рассчитать». Внимание! Расчёт будет выполнен автоматически при загрузке калькулятора только в том случае, если переданы все необходимые параметры: откуда, куда, вес, объём (или три размера).
------------------------------------------------------------------------------------------------------------------
* - Код города – это общепринятый код используемый в системе ТК КИТ. Список городов в которые и из которых осуществляется доставка вы можете найти на странице https://im.tk-kit.ru/cities.php , если нужного вам города нет в списке, значит доставка в этот город или из этого города не осуществляется и стоимость доставки посчитана быть не может.
** - Если заданы параметры длины, ширины и высоты, но не задан параметр объёма, то объём будет посчитан автоматически как произведение длины, высоты и ширины. И наоборот, если задан объём, но не указаны размеры груза, каждый из размеров будет рассчитан автоматически как кубический корень из объёма.
*** - дополнительных услуг может быть несколько в одном запросе. Код дополнительной услуги – это общепринятый код используемый в системе ТК КИТ. Список дополнительных услуг и их кодов вы можете найти на странице https://im.tk-kit.ru/extras.php . Если вы хотите передать несколько дополнительных услуг в одном запросе сделайте это в таком виде, например …&e[]=S026&e[]=T001…

 

4. Получение ответа с результатами от калькулятора

  1. 1Если вы хотите средствами JavaScript со странице вашего сайта, где установлен калькулятор, инициировать расчёт cтоимости доставки в калькуляторе вам необходимо сделать следующее:
    • 1Присвоить тэгу
      <iframe…>
      параметр Id с уникальным значением, например «tkkitcalc». Тогда код примет следующий вид
      <iframe src=”/im.tk-kit.ru.proxy.php?c=…” … id=”tkkitcalc”></iframe>
    • 2Вызвать функцию запуска расчёта:
      document.getElementById('tkkitcalc').contentWindow.gocalc();
  2. 2Если вы хотите, по завершении расчёта в калькуляторе выполнить какое-либо действие на странице вашего сайта, где установлен код калькулятора, вам необходимо определить функцию function tkkit_calc_result(input, result){} Данная функция принимает два параметра от калькулятора input и result. Оба параметра являются массивами данных в формате JSON.
    • 1input - массив входных данных, которые были введены в поля калькулятора и по которым производился расчёт.
      Поля:
      from – полный код города отправки стандарта ТК КИТ
      to - полный код города доставки стандарта ТК КИТ
      from_text – русскоязычное название города отправки
      to_text – русскоязычное название города доставки
      delivery – доставка до квартиры (1) или самовывоз со склада ТК КИТ (0)
      size_width – ширина груза в сантиметрах
      size_length – длина груза в сантиметрах
      size_height – высота груза в сантиметрах
      volume – объём груза в кубических метрах
      weight – вес груза в килограммах
      extras – массив дополнительных услуг: код и русскоязычное название.
    • 2result – многомерный массив результатов расчёта. Каждый элемент массива – значения результатов расчёта. Каждый ключ массив – код страны (RU, KZ). Если результат расчёта был получен только в рублях, то элемент (массив) только один с ключом RU, если результат расчёта получен только в казахских тенге, то элемент (массив) также только один с ключом KZ. Если результат получен как в тенге так и в рублях, то элемента (массивов) два.
      Поля:
      term – Срок доставки в днях.
      transfer – Стоимость перевозки в определённой валюте (RU – рубли, KZ - тенге).
      delivery – Стоимость доставки до квартиры в определённой валюте. Если выбран «самовывоз со склада ТК КИТ» то принимает значение 0.
      extras – Стоимость всех дополнительных услуг в определённой валюте.
      total – Итоговая сумма перевозки и доставки в определённой валюте.

Внимание

Прежде чем посетители вашего сайта смогут воспользоваться калькулятором для расчёта стоимости перевозки калькулятор должен пройти одобрение нашим администратором. 
Когда ваш сайт будет одобрен администратором вы получите e-mail с уведомлением. 
Технические вопросы не отражённые в данном документе можно задать в техподдержку.