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

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

Содержание

• Получение кода калькулятора
• Установка калькулятора на сайт
  • Установка кода 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 со следующим кодом: 
   https://im.tk-kit.ru/calc/?".$_SERVER['QUERY_STRING']);?>
   
   Этот файл необходим для обеспечения кросс-доменной передачи данных от калькулятора вашему сайту.

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

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 с уведомлением. 
Технические вопросы не отражённые в данном документе можно задать в техподдержку.