API

Функция /1.0/order/create-post

Назначение: Оформление заказа на посылку.

Поля запроса:

Параметр	Описание	Тип	Обязательный	Пример
city_pickup_code	Код города откуда	string	Да	660000100000
city_delivery_code	Код города куда	string	Да	000000000001
customer	Заказчик	debitor	Да
sender	Отправитель	debitor	Да
receiver	Получатель	debitor	Да
type	Вид перевозки	integer( 1 - Стандарт 3 - Экспресс )	да	01
cargo_type_code	Код характера груза	string	Нет (по умолчанию 03)	01
declared_price	Объявленная стоимость груза (руб)	integer	Да	1000
confirmation_price	Наличие документов подтверждающих стоимость	boolean	Да (если declared_price более 50 000), по умолчанию 0	1
service	массив кодов услуг	string	Нет	[service][0] = S089
type_post	тип посылки	string (01 - XS 02 - S 03 - M 04 - L)	Да	post_type = 02
additional_payment_shipping	Плательщик перевозки	string( AG - заказчик, SE - отправитель, WE - получатель)	Нет (по умолчанию AG)	SE
additional_payment_pickup	Плательщик забора груза	string( AG - заказчик, SE - отправитель, WE - получатель)	Нет (по умолчанию AG)	SE
additional_payment_delivery	Плательщик доставки груза	string( AG - заказчик, SE - отправитель, WE - получатель)	Нет (по умолчанию AG)	SE
insurance	Услуга страхования груза	integer( 1 - да 0 - нет )	Да (если стоимость груза равна или более 10 000 руб.)	1
insurance_agent_code	Код страхового агента	string	Да (если insurance = 1 )	8000152423
have_doc	Есть документы подтверждающие стоимость груза	integer( 1 - да 0 - нет )	Да (если стоимость груза равна или более 50 000 руб. )	1
currency_code	Валюта результата расчета	массив строка	Нет (по умолчанию RUB)	currency_code[0] = KZT currency_code[1] = RUB

Описание типа debitor

Параметр	Описание	Тип	Обязательный	Пример
debitor	Номер дебитора	integer(10)	Да (если не указаны другие данные дебитора) Если совсем не указан customer[debitor] или другие параметры customer, то заказчиком автоматически будет указан владелец личного кабинета.	customer[debitor] = 0001011311 sender[debitor] = 0001011311 receiver[debitor] = 0001011311
debitor_type	Код города откуда	integer (1 - физик 2 - ип 3 - юрик)	Да (если не указан debitor)	customer[debitor_type] = 1 sender[debitor_type] = 1 receiver[debitor_type] = 1
country_code	Код страны	string	Да (если не указан debitor и debitor_type = 1)	customer[country_code] = RU sender[country_code] = RU receiver[country_code] = RU
real_country	Страна (Физическое лицо)	string	Да (если не указан debitor и debitor_type = 1)	customer[real_country] = RU sender[real_country] = KZ receiver[real_country] = AM
real_city	Город (Физическое лицо)	string	Да (если не указан debitor и debitor_type = 1)	customer[real_city] = Екатеринбург sender[real_city] = Екатеринбург receiver[real_city] = Екатеринбург
real_street	Улица (Физическое лицо)	string	Да (если не указан debitor и debitor_type = 1)	customer[real_street] = Екатеринбург sender[real_street] = Екатеринбург receiver[real_street] = Екатеринбург
real_house	Дом (Физическое лицо)	string	Да (если не указан debitor и debitor_type = 1)	customer[real_house] = 12 sender[real_house] = 12 receiver[real_house] = 12
real_supp	Корпус (Физическое лицо)	string	Нет	customer[real_supp] = Б sender[real_supp] = Б receiver[real_supp] = Б
real_room	Кв\Офис (Физическое лицо)	string	Нет	customer[real_room] = 147 sender[real_room] = 147 receiver[real_room] = 147
real_contact_name	ФИО (Физическое лицо)	string	Да (если не указан debitor и debitor_type = 1)	customer[real_contact_name] = Иванов Иван Иванович sender[real_contact_name] = Иванов Иван Иванович receiver[real_contact_name] = Иванов Иван Иванович
real_contact_phone	Номер телефона (Физическое лицо)	number	Да (если не указан debitor и debitor_type = 1)	customer[real_contact_phone] = 88002345650 sender[real_contact_phone] = 88002345650 receiver[real_contact_phone] = 88002345650
name_ip	ФИО контактного лица (ИП)	string	Да (если не указан debitor и debitor_type = 2)	customer[name_ip] = Иванов Иван Иванович sender[name_ip] = Иванов Иван Иванович receiver[name_ip] = Иванов Иван Иванович
organization_name_ip	ФИО (ИП)	string	Да (если не указан debitor и debitor_type = 2)	customer[organization_name_ip] = Иванов Иван Иванович sender[organization_name_ip] = Иванов Иван Иванович receiver[organization_name_ip] = Иванов Иван Иванович
organization_phone_ip	Номер телефона (ИП)	number	Да (если не указан debitor и debitor_type = 2)	customer[organization_phone_ip] = 88002345650 sender[organization_phone_ip] = 88002345650 receiver[organization_phone_ip] = 88002345650
phone_ip	Телефон контактного лица (ИП)	number	Да (если не указан debitor и debitor_type = 2)	customer[phone_ip] = 88002345650 sender[phone_ip] = 88002345650 receiver[phone_ip] = 88002345650
inn_ip	ИНН (ИП)	integer	Да (если не указан debitor и debitor_type = 2)	customer[inn_ip] = 123456789123 sender[inn_ip] = 123456789123 receiver[inn_ip] = 123456789123
unp_ip	УНП (ИП)	integer	Да (если не указан debitor и debitor_type = 2 и country_code = BY)	customer[unp_ip] = 123456789 sender[unp_ip] = 123456789 receiver[unp_ip] = 123456789
legal_country	Страна (ИП или Юр.лицо)	string	Да (если не указан debitor и debitor_type = 2 или debitor_type = 3)	customer[legal_country] = RU sender[legal_country] = KZ receiver[legal_country] = AM
legal_city	Город (ИП или Юр.лицо)	string	Да (если не указан debitor и debitor_type = 2 или debitor_type = 3)	customer[legal_city] = Екатеринбург sender[legal_city] = Екатеринбург receiver[legal_city] = Екатеринбург
legal_street	Улица (ИП или Юр.лицо)	string	Да (если не указан debitor и debitor_type = 2 или debitor_type = 3)	customer[legal_street] = Высоцкого sender[legal_street] = Уральских рабочих receiver[legal_street] = Фестивальная
legal_house	Дом (ИП или Юр.лицо)	string	Да (если не указан debitor и debitor_type = 2 или debitor_type = 3)	customer[legal_house] = 147 sender[legal_house] = 147 receiver[legal_house] = 147
legal_supp	Корпус (ИП или Юр.лицо)	string	Нет	customer[legal_supp] = Б sender[legal_supp] = Б receiver[legal_supp] = Б
legal_room	Кв\Офис (ИП или Юр.лицо)	string	Нет	customer[legal_room] = 12 sender[legal_room] = 12 receiver[legal_room] = 12
iin	ИИН	integer(12)	Да (если не указан debitor и debitor_type = 2 и country_code = KZ)	customer[iin] = 123456789123 sender[iin] = 123456789123 receiver[iin] = 123456789123
kpp	КПП	integer(9)	Да (если не указан debitor и debitor_type = 3 и country_code = RU)	customer[kpp] = 123456789 sender[kpp] = 123456789 receiver[kpp] = 123456789
name_ur	ФИО контактного лица (Юридическое лицо)	string	Да (если не указан debitor и debitor_type = 3)	customer[name_ur] = Иванов Иван Иванович sender[name_ur] = Иванов Иван Иванович receiver[name_ur] = Иванов Иван Иванович
organization_name_ur	Наименование организации	string	Да (если не указан debitor и debitor_type = 3)	customer[organization_name_ur] = ООО "Кашалот" sender[organization_name_ur] = ООО "Кашалот" receiver[organization_name_ur] = ООО "Кашалот"
organization_phone_ur	Телефон организации	number	Да (если не указан debitor и debitor_type = 3)	customer[organization_phone_ur] = 88002345650 sender[organization_phone_ur] = 88002345650 receiver[organization_phone_ur] = 88002345650
phone_ur	ФИО контактного лица (Юридическое лицо)	number	Да (если не указан debitor и debitor_type = 3)	customer[phone_ur] = 88002345650 sender[phone_ur] = 88002345650 receiver[phone_ur] = 88002345650
unp_ur	УНП (Юридическое лицо)	integer	Да (если не указан debitor и debitor_type = 3 и country_code = BY)	customer[unp_ur] = 123456789 sender[unp_ur] = 123456789 receiver[unp_ur] = 123456789
inn_ur	ИНН (Юридический лицо)	integer	Да (если не указан debitor и debitor_type = 3)	customer[inn_ur] = 123456789 sender[inn_ur] = 123456789 receiver[inn_ur] = 123456789
bin	БИН	integer(12)	Да (если не указан debitor и debitor_type = 3 и country_code = KZ)	customer[bin] = 123456789112 sender[bin] = 123456789112 receiver[bin] = 123456789112

Поля ответа:

Параметр	Описание	Тип	Пример
status	Статус операции (1 успешно завершена, 0 - произошла ошибка)	integer	1
result	Результат	result
message	Сообщение	string	Спасибо. Скоро с Вами свяжется наш оператор.

Описание типа result

Параметр	Описание	Тип	Пример
sale_number	Номер заказа	integer(10)	1105887652
cargo_number	Номер груза	string	ЕКБМСК0100007251

Пример запроса:

https ://capi.tk-kit.com{ "city_pickup_code": "660000100000", "city_delivery_code": "000000000001", "declared_price": 100, "currency_code[0]": "KZT", "currency_code[1]": "RUB", "post_type": "02", "insurance": 1, "insurance_agent_code": 8000152423, "customer": { "debitor": 0001011311 } "sender": { "debitor_type": 1, "country_code": "RU", "real_country": "RU", "real_city": "Екатеринбург", "real_street": "Малышева", "real_house": "12", "real_contact_name": "Иванов Иван Иванович", "real_contact_phone": "+79990000000" } "receiver": { "debitor_type": 3, "country_code": "RU", "legal_country": "RU", "legal_city": "Москва", "legal_street": "Волхонка", "legal_house": "12", "inn_ur": "123456789123", "kpp": "123456789", "name_ur": "Иванов Иван Иванович", "organization_name_ur": "ООО 'Кашалот'", "organization_phone_ur": 88002345650, "phone_ur": 89001111111, } }

Пример ответа:

{
    "result": {
        "sale_number": 1105887652,
        "cargo_number": "ЕКБМСК0100007251"
    },
    "status": 1,
    "message": "Спасибо. Скоро с Вами свяжется наш оператор."
}

API-интеграция