API V1.0 - 2. Расчет стоимости
Выполняет расчет стоимости перевозки по переданным параметрам:
- отделение или город отправления
- отделение или город получения
- вес и объем груза
- тип груза
- дополнительные услуги и условия
Допускает передачу для расчета до 10 наборов данных
URL-Адрес запроса:
https://api.sat.ua/study/hs/api/v1.0/calc/{format}Параметры запроса:
Текст запроса (доступные поля):
-
ID:
свой идентификатор набора параметров. Возвращается после расчета
-
rspSender:
идентификатор отделения отправления
-
townSender:
идентификатор города отправления
-
rspRecipient:
идентификатор отделения получения
-
townRecipient:
идентификатор города получения
-
declaredCost:
заявленная стоимость
-
seatsAmount:
количество мест
-
cargoType:
идентификатор типа груза
-
weight:
вес груза
-
length:
общая длина всех мест отправления
-
width:
общая ширина всех мест отправления
-
height:
общая высота всех мест отправления
-
volumeGeneral:
объем груза м3
-
departure:
выезд за грузом к двери отправителя
-
delivery:
доставка груза до дверей получателя
-
departureCondition:
дополнительное условие выезда за грузом
-
deliveryCondition:
дополнительное условие доставки груза
-
addServices:
дополнительная услуга
-
service:
идентификатор дополнительной услуги
-
count:
количество
-
units:
таблица мест груза
rows: массив мест груза в таблице
weight: вес места
height: высота места
length: длина места
width: ширина места
declaredCost: задекларированная стоимость места
description: идентификатор описания груза
cargoType: идентификатор типа груза -
isDetailingByUnits:
истинный (обязательный параметр)
пример запроса
<request>
<item>
<ID>123</ID>
<rspSender>602a78ed-813d-4cc6-add6-6f81357ba85c</rspSender>
<rspRecipient>bbf8e4a1-33a7-11dd-a17a-001a4d3b885e</rspRecipient>
<weight>5</weight>
<cargoType>Стандарт</cargoType>
<addServices>
<service>4293056e-4cb1-406d-a2cd-e8f6d2ae6721</service>
<count>2</count>
</addServices>
<units>
<rows>
<declaredCost>300</declaredCost>
<description>80ca645c-51d4-11e8-9403-00505601031c</description>
<weight>2</weight>
<width>1</width>
<length>1</length>
<height>1</height>
<volume>1</volume>
<cargoType>Базовый</cargoType>
</rows>
<rows>
<declaredCost>300</declaredCost>
<description>80ca645c-51d4-11e8-9403-00505601031c</description>
<weight>24</weight>
<width>1</width>
<length>11</length>
<height>1</height>
<volume>1</volume>
<cargoType>Базовый</cargoType>
</rows>
</units>
</item>
</request>
Ответ 200
-
ID:
идентификатор, переданный в запросе
-
departureCost:
рассчитанная стоимость выезда
-
deliveryCost:
рассчитанная стоимость доставки
-
cost:
рассчитанная стоимость перевозки
-
creationCost:
стоимость оформления накладной на груз (ННГ)
-
insuranceCost:
стоимость оплаты ценности груза
-
addServices:
список дополнительных услуг
-
service:
идентификатор дополнительной услуги
-
cost:
рассчитана стоимость дополнительной услуги
пример ответа
<response>
<success>true</success>
<data>
<item>
<ID>123</ID>
<departureCost>20</departureCost>
<deliveryCost>30</deliveryCost>
<cost>120</cost>
<creationCost>15</creationCost>
<insuranceCost>4</insuranceCost>
<addServices>
<service>4293056e-4cb1-406d-a2cd-e8f6d2ae6721</service>
<cost>50</cost>
</addServices>
</item>
</data>
</response>
интерфейсы API