Public API
  1. Расчет стоимости
Public API
  • Public API
    • Главная
    • Клиенты
      • Добавить клиента
    • Услуги
      • Добавить услугу
      • Удалить услугу
      • Список услуг
      • Обновить услугу
    • Расчет стоимости
      • Расчет стоимости
        POST
    • Заказы
      • Cписок заказов
      • Заказ по ID
      • Разместить заказ
    • Schemas
      • Client
      • Order
      • OrderStatus
      • PriceCalc
      • RoutePoint
      • Service
      • SuccessApiResponse
      • SuccessApiResponseList
      • ErrorApiResponse
  1. Расчет стоимости

Расчет стоимости

POST
/price/calc

Рассчитать стоимость услуги#

Метод возвращает список расчетов стоимости на основании тарифов для услуги, действующих в точке А.

Привязка к клиенту#

Если не передается параметр clientId (идентификатор клиента), тогда необходимо передать параметры clientName и clientPhone.
Если в системе есть клиент с логином, который совпадает со зачением clientPhone, тогда к расчету стоимости будет привязан этот клиент, иначе будет создан новый клиент с логином clientPhone.

Маршрутные точки#

В параметре routePoints передается массив с точками маршрута. Для корректного расчета необходима хотя бы одна точка.
Маршрутные точки будут использоваться при выполнении заказа в том порядке, в котором они передаются в массиве.

Способ оплаты#

Способ оплаты передается в параметре paymentType и будет использован в процессе исполнения заказа. Сейчас поддерживается эти способы оплаты:
cash - Оплата наличными исполнителю
aссount - Оплата с баланса внутреннего счета

Стоимость по умолчанию#

Если указано знаение в параметре defaultPrice - это значение используется как расчетная стоимость без фактических расчетов тарифа.
Если для услуги не определен ни один активный тариф - возвращается один расчет, в котором значение атрибута price = 0.

Request

Authorization
API Key
Add parameter in header
x-apis-key
Example:
x-apis-key: ********************
or
Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

🟠400BadRequest
🟠404NotFound
🟠403Forbidden
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.masterdru.ru/price/calc' \
--header 'x-apis-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "serviceId": "504f3ab9-6145-42f9-ae64-2638f836af38",
    "routePoints": [
        {
            "lat": -46.3245,
            "lng": -55.0056,
            "address": "28932 Commercial Street",
            "no": 1
        }
    ],
    "paymentType": "cash",
    "deviceId": "Lb0y3cFNoy",
    "clientId": "ba71d5fe-36d8-4211-ae42-ed24f40009dc"
}'
Response Response Example
200 - Example 1
{
    "code": "APIS-200",
    "success": true,
    "data": {
        "items": [
            {
                "id": "0653839b-86f2-4908-b8ba-9816770bcf2c",
                "requestId": "cfba26f2-9dd5-488f-8d00-657727f266d1",
                "tariffId": "e888f86a-817f-4ccc-9552-0aa05ba4469f",
                "price": 599.6,
                "currencyСode": "RUB",
                "caption": "aestas",
                "descr": "adduco-combibo-aedificium",
                "supplierTime": 42
            },
            {
                "id": "4a71b15f-81eb-4722-8afb-6a7606b9569f",
                "requestId": "cfba26f2-9dd5-488f-8d00-657727f266d1",
                "tariffId": "ad8ace9c-e7dc-4862-b2e0-7916b69391c1",
                "price": 7.79,
                "currencyСode": "RUB",
                "caption": "verbum",
                "descr": "arbustum-conicio-copiose",
                "supplierTime": 18
            }
        ]
    }
}
Modified at 2025-11-05 17:40:06
Previous
Обновить услугу
Next
Cписок заказов
Built with