1. Расчет тарифа на перевозку груза

Описание

Данный запрос формируется к системе ТК когда необходимо рассчитать тарифы на перевозку конкретного груза клиента.

В ответ система АТИ ожидает получить код 200 и ответ с ценами с учетом разных дополнительных условий. Если у ТК нет предложений, то необходимо вернуть код 200 и структуру с пустым массивом offers и пустым url. Если система ТК присылает код ответа отличный от 200, то считается, что предложений нет. Если система ТК не успевает ответить за определенное время (10 секунд), то считается, что предложений нет. Если система ТК долгое время возвращает код отличный от 200 либо не успевает ответить за определенное время, то система АТИ вправе отключить отправку запросов в систему ТК.

Структура URL

HTTP метод: POST, ресурс: <partner_url>/get_offers

Список параметров

Упрощенная версия структуры "Груз" [1.2]

НазваниеТип параметраОписаниеОбязательный
load_idguidID груза. Далее этот же ID будет отправлен, если пользователь нажмет кнопку "Подробнее" и перейдет на сайт ТК+
first_datedatetimeДата, начиная с которой груз актуален, UTC+
last_datedatetimeДата, после которой груз не актуален, в формате UTC+
date_typeintВыбор типа готовности груза к перевозке+
distancedecimalРасстояние для груза, при расчете учитываются дополнительные пункты разгрузки+
krugoreisboolПараметр, который определяет, включен ли кругорейс для перевозки груза+
periodicity_idintПериодичность загрузки+
zimnikboolПараметр, который определяет, включен ли зимник для перевозки груза+
ferriesboolПараметр, который определяет, учитывать ли паромные переправы для перевозки груза+
loadingСтруктура LoadingОписание точки загрузки+
unloadingСтруктура UnloadingОписание точки разгрузки+
extra_pointsМассив структур ExtraPointСписок дополнительных пунктов маршрута+
cargoСтруктура CargoОписание груза+
transportСтруктура TransportОписание необходимого транспорта+
user_infoСтруктура UserInfoИнформация о грузовладельце+
paymentУрезанная структура PaymentИнформация об оплате-

Вложенные структуры

Урезанная структура "Payment"

money_type
intИдентификатор оплаты

Значение из словаря. По умолчанию - 22.

+
currency_id intИдентификатор валютыЗначение из словаря. По умолчанию - 1.+
rate_sumfloatСтавка для груза +
sum_with_ndsfloatСтавка б/нал с НДС для груза +
sum_without_ndsfloatСтавка б/нал без НДС для груза +


Результат

Ожидается структура вида. Если предложений нет, то необходимо присылать данную структуру с пустым списком offers и пустой строкой url

НазваниеТип параметраОписаниеОбязательный
offersМассив структур "Offer"Цены, которые будут показаны клиенту. Если массив пустой, значит предложения нет.+
urlstringАдрес сайта на который будет отправлен с POST-запросом, содержащим структуру "OrderContacts", клиент после нажатия на кнопку "Оформить"
(в случае минимальной интеграции)
+
conditionsstringДополнительные важные условия (до 1000 символов). Запрещено использование html тегов. Допускается использование управляющего символа перевода строки \n-

Структура "Offer"

НазваниеТип параметраОписаниеОбязательный
ratedecimalБазовая стоимость за перевозку
typeintТип оплаты, где 0 - с ндс, 1 - без ндс, 2 - наличный рассчет 
prepaymentintРазмер предоплаты в % от 0 до 100+
prepayment_typeint

Значение по умолчанию: 0; Валидные значения: 0,1,2.

  • 0 - отсутствие параметра типа предоплаты;
  • 1 - предоплата до загрузки;
  • 2 - предоплата до выгрузки.
-
optionsмассив структур "Option"Список опций, которые необходимо отобразить клиенту на всю перевозку-
loading_optionsмассив структур "Option"Список опций, которые необходимо отобразить клиенту для погрузки-
unloading_optionsмассив структур "Option"Список опций, которые необходимо отобразить клиенту для разгрузки-

Структура "Option"

НазваниеТип параметраОписаниеОбязательный
option_idstringID включенной опции+
namestringИмя опции, которое будет выведено клиенту+
descriptionstringОписание, которое будет выведено в тултипе при наведении-
ratedecimalЦена, которую необходимо добавить к базовой цене при включении этой опции+

Структура "OrderContacts"

НазваниеТип параметраОписаниеОбязательный

load_id

stringID просмотра +
accountstringJSON-сериализованная структура "Краткая информация о фирме"+
contact1 stringJSON-сериализованная структура "ContactInfo"+
contact2stringJSON-сериализованная структура "ContactInfo"-

Структура "ContactInfo"

НазваниеТипОписание
idintID контакта
namestringИмя контакта
telephonestringТелефон
emailstringЭлектронная почта
icqstringICQ
mobilestringМобильный телефон

skype_name

stringSkype
faxstringФакс
locationstringНазвание города


Структура "UserInfo"

НазваниеТип параметраОписаниеОбязательный
firm_type_idintID типа фирмы. Основные:

1: Перевозчик
2: Экспедитор
3: Грузовладелец
4: Диспетчер
5: Экспедитор-перевозчик
6: Грузовладелец-перевозчик

+
firm_typestringТип фирмы+
total_scoredecimalСумма баллов пользователя АТИ+
negative_points_sumintКоличество "красных баллов" фирмы+
claims_countintКоличество претензий к данной фирме+
recommendation_countintКоличество рекомендаций, данных фирме+
bad_partner_firms_countint

Количество фирм, которые написали

сообщение о данной фирме на форуме

"Недобросовестные партнеры"

+