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:
true (обов'язковий параметр)
приклад запиту
<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