8 (800) 23456-50 - единая справочная служба
Отправьте заявку и мы сами вам перезвоним:
Ваши город/страна:
Россия, Екатеринбург

Разработчикам

Адрес техподдержки kit_it@tk-kit.ru


KIT.API

Содержание

Введение

Для повышения удобства технического взаимодействия клиентов и партнёров транспортной компании «КИТ» был реализован простой и доступный программный интерфейс — KIT.API, работающий поверх протокола HTTP. Мы думаем, что использование KIT.API делает наше техническое взаимодействие с партнёрами более эффективным.

Данное руководство описывает интерфейс доступа к KIT.API первой версии, и предназначено для программистов, автоматизирующих взаимодействие с нашей компанией ТК «КИТ».

Предполагается, что читатель знаком с основами HTTP и имеет навыки программирования. Технические вопросы не отражённые в данном документе можно задать по адресу kit_it@tk-kit.ru.


Общий принцип взаимодействия

Транспортным протоколом для вызова функций KIT.API является HTTP. В KIT.API поддерживаются как GET, так и POST запросы. Однако рекомендуемым является метод POST, т.к. он не имеет ограничений на длину запроса.

Каждый вызов является атомарным и синхронным, то есть все запросы независимы друг от друга. Также все операции являются синхронными: результат операции возвращается сразу же, нет промежуточных состояний при выполнении операции. Выбор в пользу такого способа взаимодействия был сделан для удобства подключения к KIT.API со стороны клиентов.


Формат запроса

URL для вызова функций выглядит следующим образом:
http://tk-kit.ru/API.1/?f=<имя_функции>&<HTTP_параметры_для_запросов_GET>]


Таким образом, все функции имеют единый URL, а вызываемая функция идентифицировалась с помощью параметра f.

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


Передача входных параметров

Все дополнительные параметры, если они есть, можно передавать в виде стандартных HTTP-параметров GET или POST. Если параметр отмечен символом *, то он является обязательным.

Пример передачи параметров через GET запрос:
http://tk-kit.ru/API.1/?f=get_city_list


Формат ответа

Все функции возвращают ответы в формате JSON.


Список функций

Здесь приведен перечень доступных функций с кратким описанием. Полное, детальное описание каждой функции с примерами использования см. ниже.

Функция Краткое описание
checkstat Статус заявки
get_insurance_agents Список страховых компаний
get_im_services Список дополнительных услуг для Интернет Магазинов
get_services Список дополнительных услуг общий
get_city_list Список городов
is_city Осуществляется ли доставка в указанный город
price_order Стоимость и срок перевозки по заданному маршруту
create_order Запрос на создание новой заявки на перевозку
get_rp Список складов в городах, через которые осуществляется междугородняя перевозка
get_hash Зашифрованный вид пароля. Используется в других функциях API
get_avr Получение актов выполненных работ
get_order_info Подробная информация о заказе


Функция checkstat

Назначение:
Получение статуса заявки по номеру Экспедиторской Расписки

Поля запроса:
Поле Описание
N * Номер Экспедиторской Расписки


Поля ответа:
Поле Описание
date Дата присвоения статуса
time Время присвоения статуса
timestamp Unix Time Stamp даты и времени присвоения статуса
status_code Код статуса
status_text Текстовая расшифровка статуса


Пример запроса:
http://tk-kit.ru/API.1/?f=checkstat&N=МСКЕК40010818306


Пример ответа:
[ { "DATE":"2013-10-12", "TIME":"13:04:20", "TIMESTAMP":1381568660, "STATUS_CODE":"04", "STATUS_TEXT":"ГРУЗ ВЫДАН" }, { "DATE":"2013-10-11", "TIME":"08:42:28", "TIMESTAMP":1381466548, "STATUS_CODE":"03", "STATUS_TEXT":"ГРУЗ ПРИБЫЛ" }, { "DATE":"2013-10-09", "TIME":"10:07:09", "TIMESTAMP":1381298829, "STATUS_CODE":"02", "STATUS_TEXT":"ГРУЗ ОТПРАВЛЕН" }, { "DATE":"2013-10-08", "TIME":"04:52:11", "TIMESTAMP":1381193531, "STATUS_CODE":"01", "STATUS_TEXT":"ГРУЗ ПРИНЯТ" }, { "DATE":"2013-10-04","TIME":"08:24:35", "TIMESTAMP":1380860675, "STATUS_CODE":"00", "STATUS_TEXT":"НОВЫЙ ЗАКАЗ" } ]


Функция get_insurance_agents

Назначение:
Возвращает список страховых компаний с которыми сотрудничает ТК КИТ

Поля запроса:
нет

Поля ответа:
Поле Описание
AGENT Массив страховых компаний
AGENT -> IN Код страховой компании
AGENT -> NM Название страховой компании
E_CH Массив типов груза
E_CH -> CH Код типа груза
E_CH -> CT Название типа груза
E_MN Массив минимальных значений ставки страхования
E_MN -> IN Код страховой компании
E_MN -> VL Значение минимальной ставки
E_MN -> TP Валюта минимальной ставки
E_PR Массив ставок
E_PR -> IN Код страховой компании
E_PR -> CH Код типа груза
E_PR -> VL Ставка страхования
E_PR -> TP Тип страхования (фиксированная сумма или процент от стоимости перевозки)


Пример запроса:
http://tk-kit.ru/API.1/?f=get_insurance_agents


Пример ответа:
{ "AGENT":{ "ITEM":[ { "IN":"0210000330", "NM":"ОАО Страховая компания \"Пари\"" } ] }, "E_CH":{ "ITEM":[ { "CH":"001", "CT":"Груз без особых условий", "TR":"", "LL":"0001", "LP":"0000" }, { "CH":"002", "CT":"Стекло,в тч. в стеклянной таре", "TR":"", "LL":"0002", "LP":"0000" } ] }, "E_MN":{ "ITEM":[ { "IN":"0210000330", "VL":"150.0", "TP":"RUB" } ] }, "E_PR":{ "ITEM":[ { "IN":"0210000330", "CH":"0001", "VL":"0.15", "TP":"%" }, { "IN":"0210000330", "CH":"0002", "VL":"0.3", "TP":"%" } ] } }


Функция get_im_services

Назначение:
Список дополнительных услуг для Интернет Магазинов

Поля запроса:
нет

Поля ответа:
Поле Описание
ZA Код услуги
NM Текстовое название услуги


Пример запроса:
http://tk-kit.ru/API.1/?f=get_im_services


Пример ответа:
{ "SRV":{ "ITEM":[ { "ZA":"S026", "NM":"Пломбирование" }, { "ZA":"T001", "NM":"Жесткая доупаковка груза" }, { "ZA":"T004", "NM":"Упаковка сопроводительных документов" }, { "ZA":"T005", "NM":"Упаковка в картонные коробки" } ] } }


Функция get_services

Назначение:
Общий список дополнительных услуг

Поля запроса:
нет

Поля ответа:
Поле Описание
ZA Код услуги
NM Текстовое название услуги


Пример запроса:
http://tk-kit.ru/API.1/?f=get_services


Пример ответа:
{ "SRV":{ "ITEM":[ { "ZA":"S026", "NM":"Пломбирование" }, { "ZA":"T001", "NM":"Жесткая доупаковка груза" }, { "ZA":"T002", "NM":"Паллетирование (прозр. пленка)" }, { "ZA":"T003", "NM":"Паллетирование (черн. пленка)" } ] } }


Функция get_city_list

Назначение:
Возвращает список населённых пунктов с которыми работает ТК КИТ

Поля запроса:
нет

Поля ответа:
Поле Описание
ID Код населённого пункта
NAME Название населённого пункта
COUNTRY Код страны
REGION Код региона
TZONEID Транспортная зона
SR Если пусто, то услуга забора или доставки в данном населённом пункте обязательны
OC Если не пусто, то данный населённый пункт считается областным центром
TP Тип населённого пункта


Пример запроса:
http://tk-kit.ru/API.1/?f=get_city_list


Пример ответа:
{ "CITY":[ { "ID":"565500100000", "NAME":"Абдулино", "COUNTRY":"RU", "TZONEID":"0000000212", "REGION":"02", "TZONE":"N", "SR":"N", "OC":"", "TP":"гор.", "SP":"" } ] }


Функция is_city

Назначение:
Проверяет осуществляется ли доставка в переданный город. Если доставка в переданный город не осуществляется то возвращает массив с единственным значением 0

Поля запроса:
Поле Описание
city * Название города


Поля ответа:
Поле Описание
Полный код города вида COUNTRY:REGION:TZONEID:ID:SR (для описания полей см. описание функции get_city_list)


Пример запроса:
http://tk-kit.ru/API.1/?f=is_city&city=Екатеринбург


Пример ответа:
[ "RU:66:0000006600:660000100000:Y" ]


Функция price_order

Назначение:
Возвращает стоимость и срок перевозки по указанному маршруту

Поля запроса:
Поле Описание
DELIVERY Нужна доставка груза по адресу получателя (не обязательно)
PICKUP Нужен забор груза по адресу отправителя (не обязательно)
WEIGHT * Вес груза в кг
VOLUME * Объём груза в метрах кубических. Если переданы размеры (длина, ширины и высота), то объём считается исходя из размеров и данный параметр не учитывается.
LENGTH * Длина груза в сантиметрах (не обязательно)
WIDTH * Ширина груза в сантиметрах (не обязательно)
HEIGHT * Высота груза в сантиметрах (не обязательно)
SLAND Отправка из - Код страны (см. описание функции get_city_list)
SZONE * Отправка из - Транспортная зона (см. описание функции get_city_list поле TZONEID)
SCODE Отправка из - Код населённого пункта (см. описание функции get_city_list поле ID)
SREGIO Отправка из - Код региона (см. описание функции get_city_list)
RLAND Доставка в - Код страны (см. описание функции get_city_list)
RZONE * Доставка в - Транспортная зона (см. описание функции get_city_list поле TZONEID)
RCODE Доставка в - Код населённого пункта (см. описание функции get_city_list поле ID)
RREGIO Доставка в - Код региона (см. описание функции get_city_list)
GR_TYPE Характер груза (не обязательно) (см. описание функции get_insurance_agents)
LIFNR Номер страховой компании (не обязательно) (см. описание функции get_insurance_agents)
PRICE * Объявленная стоимость груза
I_SRV Массив кодов дополнительных услуг (см. описание функции get_services)
KUNNR Номер дебитора (если есть)


Поля ответа:
Поле Описание
PRICE Массив стоимости перевозки
PRICE -> PICKUP Стоимость забора груза по адресу отправителя
PRICE -> TRANSFER Стоимость перевозки груза
PRICE -> DELIVERY Стоимость доставки груза по адресу получателя
PRICE -> TOTAL Суммарная стоимость перевозки груза (включая забор, перевозку, доставку и дополнительные услуги)
EXTRA Массив стоимости дополнительных услуг (если переданы)
EXTRA -> price Стоимость дополнительной услуги
EXTRA -> name Название дополнительной услуги
DAYS Срок перевозки в днях
E_WAERS Валюта цены
E_RATE Массив ставок для расчёта цены в других валютах (кроме рубля)
E_RATE -> KZT Ставка обмена валюты в Казахских тенге относительно рубля
E_RATE -> RUB Ставка обмена валюты в Российских рублях относительно рубля (равно 1)


Пример запроса:
http://tk-kit.ru/API.1/?f=price_order&I_DELIVER=0&I_PICK_UP=1&WEIGHT=30&VOLUME=0.6&SLAND=RU&SZONE=0000008610&SCODE=860001000000&SREGIO=86&RLAND=RU&RZONE=0000008910&RCODE=890000700000&RREGIO=89&KWMENG=1&LENGTH=84.34&WIDTH=84.34&HEIGHT=84.34&GR_TYPE=&LIFNR=&PRICE=&WAERS=RUB


Пример ответа:
{ "PRICE":{ "PICKUP":"0.0", "TRANSFER":"0.0", "DELIVERY":"0.0", "TOTAL":"0.0" }, "DAYS":1, "E_WAERS":"RUB", "E_RATE":{ "KZT":"5.0", "RUB":1 } }


Функция create_order

Назначение:
Запрос на создание новой заявки на перевозку. Ввиду большого числа параметров данный запрос рекомендуется отправлять методом POST.

ВНИМАНИЕ! Данная функция доступна только для запросов с доверенным и авторизованным ключём. Если у вас ещё нет ключа, запросить его вы можете тут

Поля запроса:
Поле Описание
DELIVERY Нужна доставка груза по адресу получателя (не обязательно)
PICKUP Нужен забор груза по адресу отправителя (не обязательно)
WEIGHT * Вес груза в кг
LENGTH * Длина груза в сантиметрах (не обязательно)
WIDTH * Ширина груза в сантиметрах (не обязательно)
HEIGHT * Высота груза в сантиметрах (не обязательно)
VOLUME * Объём груза в метрах кубических. Если переданы размеры (длина, ширины и высота), то объём считается исходя из размеров и данный параметр не учитывается.
SLAND Отправка из - Код страны (см. описание функции get_city_list)
SZONE * Отправка из - Транспортная зона (см. описание функции get_city_list поле TZONEID)
SCODE Отправка из - Код населённого пункта (см. описание функции get_city_list поле ID)
SREGIO Отправка из - Код региона (см. описание функции get_city_list)
RLAND Доставка в - Код страны (см. описание функции get_city_list)
RZONE * Доставка в - Транспортная зона (см. описание функции get_city_list поле TZONEID)
RCODE Доставка в - Код населённого пункта (см. описание функции get_city_list поле ID)
RREGIO Доставка в - Код региона (см. описание функции get_city_list)
GR_TYPE Характер груза (не обязательно) (см. описание функции get_insurance_agents)
LIFNR Номер страховой компании (не обязательно) (см. описание функции get_insurance_agents)
PRICE Страховая сумма (не обязательно)
I_SRV Массив кодов дополнительных услуг (см. описание функции get_services)
KWMENG * Количество мест (по-умолчанию 1, не обязательное поле)
EKIT_PARTNER Номер дебитора - интернет-магазина. Если заказ от интернет-магазина, то это обязательный параметр
S_STREET Откуда: Наименование улицы (если в справочнике не нашли)
S_STREET_ID Откуда: Номер улицы из справочника
S_HOUSE Откуда: Номер дома
S_HSN_SUPP Откуда: Доп. номер дома (корпус, строение и т.п.)
S_HOUSE2 Откуда: Квартира / Офис
S_DATA Откуда: дата забора груза
R_STREET Куда: Наименование улицы (если в справочнике не нашли)
R_STREET_ID Куда: Номер улицы из справочника
R_HOUSE Куда: Номер дома
R_HSN_SUPP Куда: Доп. номер дома (корпус, строение и т.п.)
R_HOUSE2 Куда: Квартира / Офис
CUS Массив данных клиента
CUS -> KUNNR Номер дебитора (если известно). Если это поле заполнено, то поле CUS -> STATUS обязательно, астальные поля этого массива заполнять не нужно.
CUS -> STATUS * Статус: 1 - юр. лицо, 2 - физ. лицо, 3 - ИП
CUS -> NAME * Наименование юр. лица или ИП
CUS -> FIO * ФИО контактного лица
CUS -> PHONE * Телефон контактного лица
CUS -> EMAIL E-mail контактного лица
CUS -> INN * ИНН
CUS -> KPP * КПП
CUS -> U_LAND * Юридический адрес: Код страны (Россия - RU, Казахстан - KZ)
CUS -> U_CITY * Юридический адрес: Наименование города (если в справочнике не нашли)
CUS -> U_CITY_ID Юридический адрес: Номер города из справочника
CUS -> U_REGIO * Юридический адрес: Код области
CUS -> U_STREET * Юридический адрес: Наименование улицы (если в справочнике не нашли)
CUS -> U_STREET_ID Юридический адрес: Номер улицы из справочника
CUS -> U_HOUSE * Юридический адрес: Номер дома
CUS -> U_HSN_SUPP Юридический адрес: Доп. номер дома (корпус, строение и т.п.)
CUS -> U_HOUSE2 Юридический адрес: Квартира / Офис
CUS -> F_LAND * Фактический адрес: Код страны (Россия - RU, Казахстан - KZ)
CUS -> F_CITY * Фактический адрес: Наименование города (если в справочнике не нашли)
CUS -> F_CITY_ID Фактический адрес: Номер города из справочника
CUS -> F_REGIO * Фактический адрес: Код области
CUS -> F_STREET * Фактический адрес: Наименование улицы (если в справочнике не нашли)
CUS -> F_STREET_ID Фактический адрес: Номер улицы из справочника
CUS -> F_HOUSE * Фактический адрес: Номер дома
CUS -> F_HSN_SUPP Фактический адрес: Доп. номер дома (корпус, строение и т.п.)
CUS -> F_HOUSE2 Фактический адрес: Квартира / Офис
SEN Массив данных отправителя
SEN -> LIKE_CUS X если данные отправителя полностью совпадают с данными клиента. Заполнение массива данных отправителя не требуется
SEN -> KUNNR Номер дебитора (если известно). Если это поле заполнено, то поле SEN -> STATUS обязательно, астальные поля этого массива заполнять не нужно.
SEN -> STATUS * Статус: 1 - юр. лицо, 2 - физ. лицо, 3 - ИП
SEN -> NAME * Наименование юр. лица или ИП
SEN -> FIO * ФИО контактного лица
SEN -> PHONE * Телефон контактного лица
SEN -> EMAIL E-mail контактного лица
SEN -> INN * ИНН
SEN -> KPP * КПП ()
SEN -> U_LAND * Юридический адрес: Код страны (Россия - RU, Казахстан - KZ)
SEN -> U_CITY * Юридический адрес: Наименование города (если в справочнике не нашли)
SEN -> U_CITY_ID Юридический адрес: Номер города из справочника
SEN -> U_REGIO * Юридический адрес: Код области
SEN -> U_STREET * Юридический адрес: Наименование улицы (если в справочнике не нашли)
SEN -> U_STREET_ID Юридический адрес: Номер улицы из справочника
SEN -> U_HOUSE * Юридический адрес: Номер дома
SEN -> U_HSN_SUPP Юридический адрес: Доп. номер дома (корпус, строение и т.п.)
SEN -> U_HOUSE2 Юридический адрес: Квартира / Офис
SEN -> F_LAND * Фактический адрес: Код страны (Россия - RU, Казахстан - KZ)
SEN -> F_CITY * Фактический адрес: Наименование города (если в справочнике не нашли)
SEN -> F_CITY_ID Фактический адрес: Номер города из справочника
SEN -> F_REGIO * Фактический адрес: Код области
SEN -> F_STREET * Фактический адрес: Наименование улицы (если в справочнике не нашли)
SEN -> F_STREET_ID Фактический адрес: Номер улицы из справочника
SEN -> F_HOUSE * Фактический адрес: Номер дома
SEN -> F_HSN_SUPP Фактический адрес: Доп. номер дома (корпус, строение и т.п.)
SEN -> F_HOUSE2 Фактический адрес: Квартира / Офис
SEN -> TIME_WORK Время работы
REC Массив данных получателя
REC -> LIKE_CUS X если данные получателя полностью совпадают с данными клиента. Заполнение массива данных получателя не требуется
REC -> KUNNR Номер дебитора (если известно). Если это поле заполнено, то поле RES -> STATUS обязательно, астальные поля этого массива заполнять не нужно.
REC -> STATUS * Статус: 1 - юр. лицо, 2 - физ. лицо, 3 - ИП
REC -> NAME * Наименование юр. лица или ИП
REC -> FIO * ФИО контактного лица
REC -> PHONE * Телефон контактного лица
REC -> EMAIL E-mail контактного лица
REC -> INN * ИНН
REC -> KPP * КПП
REC -> U_LAND * Юридический адрес: Код страны (Россия - RU, Казахстан - KZ)
REC -> U_CITY * Юридический адрес: Наименование города (если в справочнике не нашли)
REC -> U_CITY_ID Юридический адрес: Номер города из справочника
REC -> U_REGIO * Юридический адрес: Код области
REC -> U_STREET * Юридический адрес: Наименование улицы (если в справочнике не нашли)
REC -> U_STREET_ID Юридический адрес: Номер улицы из справочника
REC -> U_HOUSE * Юридический адрес: Номер дома
REC -> U_HSN_SUPP Юридический адрес: Доп. номер дома (корпус, строение и т.п.)
REC -> U_HOUSE2 Юридический адрес: Квартира / Офис
REC -> F_LAND * Фактический адрес: Код страны (Россия - RU, Казахстан - KZ)
REC -> F_CITY * Фактический адрес: Наименование города (если в справочнике не нашли)
REC -> F_CITY_ID Фактический адрес: Номер города из справочника
REC -> F_REGIO * Фактический адрес: Код области
REC -> F_STREET * Фактический адрес: Наименование улицы (если в справочнике не нашли)
REC -> F_STREET_ID Фактический адрес: Номер улицы из справочника
REC -> F_HOUSE * Фактический адрес: Номер дома
REC -> F_HSN_SUPP Фактический адрес: Доп. номер дома (корпус, строение и т.п.)
REC -> F_HOUSE2 Фактический адрес: Квартира / Офис
REC -> TIME_WORK Время работы
PAY Массив данных о плательщике
PAY -> PICK_UP Забор груза оплачивает: 1 - заказчик, 2 - отправитель, 3 – получатель
PAY -> TRANSP Транспортировку оплачивает: 1 - заказчик, 2 - отправитель, 3 – получатель
PAY -> DELIVER Доставку груза оплачивает: 1 - заказчик, 2 - отправитель, 3 - получатель
EXT Массив дополнительных параметров
EXT -> COMM Дополнительные сведения экспедитору (свободный текст до 255 символов)
NOT Массив данных об уведомлениях
NOT -> NEED X если нужны уведомления о движении груза
NOT -> EMAIL E-mail для уведомлений
NOT -> SMS Номер сотового телефона для SMS уведомлений


Поля ответа:
Поле Описание
ET_LOG -
E_VBELN Номер заказа
E_XBLNR Номер экспедиторской расписки


Пример запроса:
http://tk-kit.ru/API.1/?f=create_order&I_DELIVER=&I_PICK_UP=X&WEIGHT=16&VOLUME=0.15&SLAND=RU&SZONE=0000007700&SCODE=770000000000&SREGIO=77&RLAND=RU&RZONE=0000008601&RCODE=860000100000&RREGIO=86&KWMENG=2&LENGTH=53.13&WIDTH=53.13&HEIGHT=53.13&GR_TYPE=001&LIFNR=&PRICE=0000&WAERS=RUB&S_DATA=22.01.2014&EXT[COMM]=&NOT[NEED]=&NOT[EMAIL]=&NOT[SMS]=&PARTNERNUM=&HD_PRS=&HD_CMT=&S_STREET=%D0%A1%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%BE%D1%85%D0%BE%D0%B7%D1%8F%D0%B9%D1%81%D1%82%D0%B2%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F%20&S_STREET_ID=&S_HOUSE=36&S_HSN_SUPP=&S_HOUSE2=&CUS[STATUS]=1&CUS[NAME]=%D0%9E%D0%9E%D0%9E%22%D0%91%D1%83%D1%80%D1%82%D0%BE%D1%80%D0%B3%22&CUS[KUNNR]=0001032031&CUS[FIO]=%D0%90%D0%BD%D0%B4%D1%80%D0%B5%D0%B9&CUS[PHONE]=%2B7925895-91-91&CUS[INN]=7733786444&CUS[KPP]=773301001&CUS[U_LAND]=RU&CUS[U_CITY]=&CUS[U_CITY_ID]=&CUS[U_REGIO]=&CUS[U_STREET]=&CUS[U_STREET_ID]=&CUS[U_HOUSE]=0&CUS[U_HSN_SUPP]=&CUS[U_HOUSE2]=&CUS[F_LAND]=RU&CUS[F_CITY]=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0&CUS[F_CITY_ID]=770000000000&CUS[F_REGIO]=77&CUS[F_STREET]=%D0%A1%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%BE%D1%85%D0%BE%D0%B7%D1%8F%D0%B9%D1%81%D1%82%D0%B2%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F%20&CUS[F_STREET_ID]=&CUS[F_HOUSE]=36&CUS[F_HSN_SUPP]=&CUS[F_HOUSE2]=&SEN[LIKE_CUS]=X&SEN[STATUS]=1&SEN[NAME]=%D0%9E%D0%9E%D0%9E%22%D0%91%D1%83%D1%80%D1%82%D0%BE%D1%80%D0%B3%22&SEN[KUNNR]=0001032031&SEN[FIO]=%D0%90%D0%BD%D0%B4%D1%80%D0%B5%D0%B9&SEN[PHONE]=%2B7925895-91-91&SEN[INN]=7733786444&SEN[KPP]=773301001&SEN[U_LAND]=RU&SEN[U_CITY]=&SEN[U_CITY_ID]=&SEN[U_REGIO]=&SEN[U_STREET]=&SEN[U_STREET_ID]=&SEN[U_HOUSE]=0&SEN[U_HSN_SUPP]=&SEN[U_HOUSE2]=&SEN[F_LAND]=RU&SEN[F_CITY]=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0&SEN[F_CITY_ID]=770000000000&SEN[F_REGIO]=77&SEN[F_STREET]=%D0%A1%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%BE%D1%85%D0%BE%D0%B7%D1%8F%D0%B9%D1%81%D1%82%D0%B2%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F%20&SEN[F_STREET_ID]=&SEN[F_HOUSE]=36&SEN[F_HSN_SUPP]=&SEN[F_HOUSE2]=&SEN[TIME_WORK]=%D1%81%2010%20%D0%B4%D0%BE%2018&REC[STATUS]=3&REC[NAME]=%D0%92%D0%BB%D0%B0%D0%B4%D0%B8%D0%BC%D0%B8%D1%80%20%D0%9D%D0%B8%D0%BA%D0%BE%D0%BB%D0%B0%D0%B5%D0%B2%D0%B8%D1%87%20%D0%A0%D0%B5%D0%B2%D0%B0%D0%BA%D1%88%D0%B8%D0%BD&REC[KUNNR]=&REC[FIO]=%D0%92%D0%BB%D0%B0%D0%B4%D0%B8%D0%BC%D0%B8%D1%80%20%D0%9D%D0%B8%D0%BA%D0%BE%D0%BB%D0%B0%D0%B5%D0%B2%D0%B8%D1%87%20%D0%A0%D0%B5%D0%B2%D0%B0%D0%BA%D1%88%D0%B8%D0%BD&REC[PHONE]=%2B79028140810&REC[INN]=&REC[KPP]=&REC[U_LAND]=RU&REC[U_CITY]=&REC[U_CITY_ID]=&REC[U_REGIO]=&REC[U_STREET]=&REC[U_STREET_ID]=&REC[U_HOUSE]=0&REC[U_HSN_SUPP]=&REC[U_HOUSE2]=&REC[F_LAND]=RU&REC[F_CITY]=%D0%A5%D0%B0%D0%BD%D1%82%D1%8B-%D0%9C%D0%B0%D0%BD%D1%81%D0%B8%D0%B9%D1%81%D0%BA&REC[F_CITY_ID]=860000100000&REC[F_REGIO]=86&REC[F_STREET]=%20%D0%9A%D1%80%D1%83%D0%BF%D1%81%D0%BA%D0%BE%D0%B9&REC[F_STREET_ID]=&REC[F_HOUSE]=16&REC[F_HSN_SUPP]=&REC[F_HOUSE2]=&REC[TIME_WORK]=%D1%81%20%20%D0%B4%D0%BE%20&PAY[PICK_UP]=1&PAY[TRANSP]=2&PAY[DELIVER]=2


Пример ответа:
{ "ET_LOG":{}, "E_VBELN":"1101173377", "E_XBLNR":"МСКХМС0011172344" }


Функция get_rp

Назначение:
Возвращает список складов в городах, через которые осуществляется междугородняя перевозка.
Ключ массива - это ID населенного пункта (см. описание функции get_city_list)

Поля запроса:
нет

Поля ответа:
Поле Описание
WERKS РП (завод)
LAND1 Код страны
PSTLZ Почтовый индекс
REGIO Код области
ORT01 Наименование города
STRAS Улица и номер дома
ZSCHWORK Время работы
ZALTAD Примечание к адресу
STREETCODE Код улицы
TRANSPZONE Транспортная зона
TEL_NUMBER Номер телефона
TEL_EXTENS Дополнительный номер телефона
REMARK Примечание
EKIT Наличие кассы Е-КИТ (если не пусто значит касса есть)


Пример запроса:
http://tk-kit.ru/API.1/?f=get_rp


Пример ответа:
{ "020000100000":[ { "WERKS":"0200", "LAND1":"RU", "PSTLZ":"450103", "REGIO":"02", "ORT01":"Уфа", "STRAS":"Пугачева 300\/1", "ZSCHWORK":"ПН-ПТ 9.00-19.00, СБ 9.00-17.00", "ZALTAD":"", "STREETCODE":"000000005836", "TRANSPZONE":"0000000201", "TEL_NUMBER":"(347)27-33-063", "TEL_EXTENS":"", "REMARK":"", "EKIT":"" }, { "WERKS":"0201", "LAND1":"RU", "PSTLZ":"450103", "REGIO":"02", "ORT01":"Уфа", "STRAS":"Пугачева 300\/1", "ZSCHWORK":"ПН-ПТ 9.00-19.00, СБ 9.00-17.00", "ZALTAD":"", "STREETCODE":"000000005836", "TRANSPZONE":"0000000200", "TEL_NUMBER":"(347)22-42-684", "TEL_EXTENS":"", "REMARK":"", "EKIT":"X" } ] }


Функция get_hash

Назначение:
Возвращает хеш пароля(специальную криптографическую форму контрольной суммы). Хэш используется для некоторых других методов API.

Поля запроса:
Поле Описание
ILOGIN Логин пользователя
IPASSWORD Пароль пользователя


Поля ответа:
Поле Описание
KUNNR Номер дебитора (если есть)
MAILS Почты, привязанные к аккаунту
IsParnter Является ли клиент партнером Кита
HASH Хэш, который можно использовать в других функциях API


Пример запроса:
http://tk-kit.ru/API.1/?f=get_hash&ILOGIN=i0000000000&IPASSWORD=i0000000000


Пример ответа:
{ "USER":{ "KUNNR":"0001100857", "NAME":"ОАО НАУЧНО-ПРОИЗВОДСТВЕННОЕ ПРЕДПРИЯТИЕ НАУЧНО-ИССЛЕДОВАТЕЛЬСКИЙ И ПРОЕКТНО-КОНСТРУКТОРСКИЙ ИНСТИТУТ ГЕОФИЗИЧЕСКИХ ИССЛЕДОВАНИЙ ГЕОЛ" "MAILS":{ "ITEM":"123QWER@ERTERT.RU" }, "ISPARNTER":"", "HASH":"45963B8BD0F913D29B6D17676F6414F8424D72BE" } }


Функция get_avr

Назначение:
Возвращает список актов выполненных работ.

Поля запроса:
Поле Описание
ILOGIN Логин пользователя
IHASH Хэш паролья пользователя. См get_hash
IXblnr Номер экспедиторской расписки
KUNNR Номер дебитора
DATE_FROM Дата с(необязательный)
DATE_TO Дата по(необязательный)
MAX Максимальное количество ответов(необязательный)


Поля ответа:
Поле Описание
XBLNR Номер АВР
NETWR Сумма без НДС
MWSBP НДС
FKDAT Дата АВР
WAERS Валюта
ERDAT Дата ЭР
VbelvNetwr Сумма ЭР


Пример запроса:
http://tk-kit.ru/API.1/?f=get_avr&ILogin=i0000000000&IHash=45963b8bd0f913d29b6d17676f6414f8424d72be&IKunnr=0000000000&nocache&date_from=07.02.2015&date_to=15.04.2015&max=1


Пример ответа:
{ "EINV":{ "ITEM":[{ "XBLNR":"0000000070", "NETWR":"1600.72", "MWSBP":"17.28", "FKDAT":"2015-04-14", "GROUP":"", "WAERS":"RUB", "FKSTO":"" }] }, "EINVMULTI":{ "ITEM":[{ "XBLNR":"0000000070", "FKDAT":"2015-04-14", "VBELVXBLNR":"ЕКБМСК0010867206", "ERDAT":"2015-04-14", "VBELVNETWR":"1618.0", "GROUP":"", "WAERS":"RUB", "FKSTO":"" }] } }


Функция get_order_info

Назначение:
Возвращает подробную информацию о заказе

Поля запроса:
Поле Описание
ILOGIN Логин пользователя
IHASH Хэш пароля пользователя. См get_hash
KUNNR Номер дебитора
XBLNR Номер груза


Поля ответа:
Поле Описание
SUMMA Полная сумма заказа с НДС
CHARACT характер груза
KWMENG кол-во для позиции
VRKME единица измерения кол-ва
BRGEW общий вес груза в заказе
GEWEI единица измерения веса
VOLUM общий объем груза в заказе
VOLEH единица измерения объема
TEMP_MKWMENG температурный режим
POSNR номер позиции в заказе
ARKTX наименование позиции
NETWR цена с ндс для позиции
NETWS сумма с ндс для позиции
MWSBP сумма налога для позиции
WAERK валюта
KUNNR номер дебитора-плательщика по позиции
PAYTX наименование дебитора-плательщика по позиции
NDS размер ндс


Пример запроса:
http://tk-kit.ru/API.1/?f=get_order_info&ILogin=i0000000000&IHash=45963b8bd0f913d29b6d17676f6414f8424d72be&Kunnr=0000000000&XBLNR=1101173377


Пример ответа:
{ "E_GINF":{ "ITEM":[{ "CHARACT" => "", "KWMENG"=> "1.0", "VRKME"=> "PL", "BRGEW"=> "10.0", "GEWEI"=> "KG", "VOLUM"=> "0.001", "VOLEH"=> "M3", "TEMPM"=> "НЕ ТРЕБУЕТСЯ", }] }, "E_SER":{ "ITEM":[{ "POSNR"=> "000001", "ARKTX"=> "ПЕРЕВОЗКА ГРУЗА: ЕКАТЕРИНБУРГ-ПЕРМЬ", "KWMENG"=> "1.0", "VRKME"=> "PL", "NETWR"=> "170.0", "NETWS"=> "170.0", "MWSBP"=> "25.93", "WAERK"=> "RUB", "KUNNR"=> "0001000000", "PAYTX"=> "ООО ООО", "NDS"=> "18.00", }] }, "SUMM" => "170.0" }


Получение ключа доступа

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

Регистрация нового ключа

ФИО контактного лица


контактный e-mail


контактный телефон


адрес сайта на котором предполагается использование АПИ


Адрес техподдержки kit_it@tk-kit.ru
Регистрация
Ваш статус*:
Наименование организации*:
Контактное лицо (ФИО)*:
Телефон:
E-mail*:
Карточка клиента*:
Выбрать

Документы DOC. Вы можете воспользоваться шаблоном с примером заполнения

Пароль*:
Повторить пароль*:
Выберите город:
Отслеживание груза

Пожалуйста, введите номер отправления вида ЕКБПРМ0123456789 или трек номер и нажмите кнопку Отследить груз.

Номер экспедиторской расписки или трек номер*:
Отслеживание груза -
Заказ принят:
...
Груз принят:
...
Отправлен:
..

Прибыл:

..
Выдан:
...

Воспользуйтесь Личным кабинетом

Это удобный способ ни прибегая к звонкам своему менеджеру, оперативно посмотреть все свои перевозки за период, статус по ним, получить счета, Акты сверки и Ведомости взаиморасчетов.
Закрыть
Создание дебитора
БЕ *
ИНН БИН УНП  *
КПП *
ФИО ИП (полностью) Наименование юридического лица  *
ФИО контактного лица *
Телефон *
Юридический адрес
Город *
Улица
 
№ дома
 
корпус
 
офис/квартира
Фактический адрес