Skip to Content

DynamicFeesApi

All URIs are relative to https://business.apis.kesk.app/v1 

MethodHTTP requestDescription
calculateDynamicFeesPOST /dynamic-fees/calculateCalculate dynamic fees for an order
getWeatherConditionsGET /dynamic-fees/weather-conditionsGet current weather conditions

calculateDynamicFees

FeeCalculationResponse calculateDynamicFees(FeeCalculationRequest)

Calculate dynamic fees for an order

Evaluates all active dynamic fee rules against the provided order context and returns applicable surcharges. Considers factors like weather conditions, time of day, zone restrictions, and demand levels to compute percentage or fixed-amount fees.

Parameters

NameTypeDescriptionNotes
FeeCalculationRequestFeeCalculationRequestFee calculation request with order details including location, type, and base amount

Return type

FeeCalculationResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

getWeatherConditions

WeatherConditionsResponse getWeatherConditions(latitude, longitude)

Get current weather conditions

Retrieves real-time weather information for a specific location to help users understand potential weather-based fee surcharges. Returns temperature, precipitation, visibility, and weather condition type which may affect dynamic pricing.

Parameters

NameTypeDescriptionNotes
latitudeDoubleLatitude coordinate for weather data retrieval[default to null]
longitudeDoubleLongitude coordinate for weather data retrieval[default to null]

Return type

WeatherConditionsResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json; charset=utf-8