Внимание! Новый этап развития транспортной компании “КИТ”

KIT.API

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


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

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


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

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

Пример передачи параметров через GET запрос:
https://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 Текстовая расшифровка статуса

Пример запроса:
https://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 Тип страхования (фиксированная сумма или процент от стоимости перевозки)

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


Пример ответа:
{ "AGENT":{ "item":[ { "IN":"0210000330", "NM":"\u041e\u0410\u041e \u0421\u0442\u0440\u0430\u0445\u043e\u0432\u0430\u044f \u043a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \"\u041f\u0430\u0440\u0438\"" } ] }, "E_CH":{ "item":[ { "CH":"001", "CT":"\u0413\u0440\u0443\u0437 \u0431\u0435\u0437 \u043e\u0441\u043e\u0431\u044b\u0445 \u0443\u0441\u043b\u043e\u0432\u0438\u0439", "TR":"", "LL":"0001", "LP":"0000" }, { "CH":"002", "CT":"\u0421\u0442\u0435\u043a\u043b\u043e,\u0432 \u0442\u0447. \u0432 \u0441\u0442\u0435\u043a\u043b\u044f\u043d\u043d\u043e\u0439 \u0442\u0430\u0440\u0435", "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 Текстовое название услуги

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


Пример ответа:
{ "SRV":{ "item":[ { "ZA":"S026", "NM":"\u041f\u043b\u043e\u043c\u0431\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435" }, { "ZA":"T001", "NM":"\u0416\u0435\u0441\u0442\u043a\u0430\u044f \u0434\u043e\u0443\u043f\u0430\u043a\u043e\u0432\u043a\u0430 \u0433\u0440\u0443\u0437\u0430" }, { "ZA":"T004", "NM":"\u0423\u043f\u0430\u043a\u043e\u0432\u043a\u0430 \u0441\u043e\u043f\u0440\u043e\u0432\u043e\u0434\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0445 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u043e\u0432" }, { "ZA":"T005", "NM":"\u0423\u043f\u0430\u043a\u043e\u0432\u043a\u0430 \u0432 \u043a\u0430\u0440\u0442\u043e\u043d\u043d\u044b\u0435 \u043a\u043e\u0440\u043e\u0431\u043a\u0438" } ] } }


Функция get_services

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

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

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


Пример ответа:
{ "SRV":{ "item":[ { "ZA":"S026", "NM":"\u041f\u043b\u043e\u043c\u0431\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435" }, { "ZA":"T001", "NM":"\u0416\u0435\u0441\u0442\u043a\u0430\u044f \u0434\u043e\u0443\u043f\u0430\u043a\u043e\u0432\u043a\u0430 \u0433\u0440\u0443\u0437\u0430" }, { "ZA":"T002", "NM":"\u041f\u0430\u043b\u043b\u0435\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 (\u043f\u0440\u043e\u0437\u0440. \u043f\u043b\u0435\u043d\u043a\u0430)" }, { "ZA":"T003", "NM":"\u041f\u0430\u043b\u043b\u0435\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 (\u0447\u0435\u0440\u043d. \u043f\u043b\u0435\u043d\u043a\u0430)" } ] } }


Функция get_city_list

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

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

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


Пример ответа:
{ "CITY":[ { "ID":"565500100000", "NAME":"\u0410\u0431\u0434\u0443\u043b\u0438\u043d\u043e", "COUNTRY":"RU", "TZONEID":"0000000212", "REGION":"02", "TZONE":"N", "SR":"N", "OC":"", "TP":"\u0433\u043e\u0440.", "SP":"" } ] }


Функция is_city

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

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

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

Пример запроса:
https://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)

Пример запроса:
https://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_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 Номер экспедиторской расписки

Пример запроса:
https://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 Наличие кассы Е-КИТ (если не пусто значит касса есть)

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


Пример ответа:
{ "020000100000":[ { "WERKS":"0200", "LAND1":"RU", "PSTLZ":"450103", "REGIO":"02", "ORT01":"\u0423\u0444\u0430", "STRAS":"\u041f\u0443\u0433\u0430\u0447\u0435\u0432\u0430 300\/1", "ZSCHWORK":"\u041f\u041d-\u041f\u0422 9.00-19.00, \u0421\u0411 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":"\u0423\u0444\u0430", "STRAS":"\u041f\u0443\u0433\u0430\u0447\u0435\u0432\u0430 300\/1", "ZSCHWORK":"\u041f\u041d-\u041f\u0422 9.00-19.00, \u0421\u0411 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

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


Пример ответа:
{ "USER":{ "Kunnr":"0001100857", "Name":"\u041e\u0410\u041e \u041d\u0410\u0423\u0427\u041d\u041e-\u041f\u0420\u041e\u0418\u0417\u0412\u041e\u0414\u0421\u0422\u0412\u0415\u041d\u041d\u041e\u0415 \u041f\u0420\u0415\u0414\u041f\u0420\u0418\u042f\u0422\u0418\u0415 \u041d\u0410\u0423\u0427\u041d\u041e-\u0418\u0421\u0421\u041b\u0415\u0414\u041e\u0412\u0410\u0422\u0415\u041b\u042c\u0421\u041a\u0418\u0419 \u0418 \u041f\u0420\u041e\u0415\u041a\u0422\u041d\u041e-\u041a\u041e\u041d\u0421\u0422\u0420\u0423\u041a\u0422\u041e\u0420\u0421\u041a\u0418\u0419 \u0418\u041d\u0421\u0422\u0418\u0422\u0423\u0422 \u0413\u0415\u041e\u0424\u0418\u0417\u0418\u0427\u0415\u0421\u041a\u0418\u0425 \u0418\u0421\u0421\u041b\u0415\u0414\u041e\u0412\u0410\u041d\u0418\u0419 \u0413\u0415\u041e\u041b" "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 Сумма ЭР

Пример запроса:
https://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":"\u0415\u041a\u0411\u041c\u0421\u041a0010867206", "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 размер ндс

Пример запроса:
https://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" }


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

Для получения ключа доступа перейдите по ссылке и зполните форму.

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