/api/dlv/tariffs
Расчет тарифов (/api/dlv/tariffs)
/api/dlv/tariffs
(метод требует авторизации по домену)
Выполняет расчет доставки от пункта сбора заказов до указанного в виджете адреса доставки (в виде fias кодов) по указанным параметрам. Если sourceRegionFias, sourceAreaFias, sourceCityFias и sourcePostalCode не заданы - адрес отправления берётся из настроек точки сбора
fromTempoline - Заказ будет отправлен с нашего склада.
Для тарификации по России - нужны Фиас коды адреса получателя, для тарификации зарубежных адресов доставки - компоненты адреса Код страны, регион, город, населенный пункт.
При поиске тарифов для зарубежного города обязательно передавать поля country, region, city (также area, settlement, если есть).
Пример
xxxxxxxxxx{ "fromTempoline": false, "sourceRegionFias": null, "sourceAreaFias": null, "sourceCityFias": null, "sourceSettlementFias": null, "sourcePostalCode": null, "regionFias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "areaFias": null, "cityFias": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "settlementFias": null, "postalCode": "123456", "weight": 1450, "insuranceSum": 500, // оценочная стоимость товара для расчета суммы страховки (чаще всего передают 100% от стоимости товара) "codSum": 500, // сумма наложенного платежа, которую курьерская компания возьмёт с покупателя, следует передавать стоимость доставки+ стоимость товаров в случае если оплата при получении. "dimensions": { "height": 10, "width": 8, "depth": 8 }, "deliveryServices": [ "PARTIAL_DELIVERY", "TRYING" ], //опциональный список требующихся допуслуг: Частичный выкуп, Примерка, Погрузо-разгрузочные работы на руках (ПРР). "floor": 15 //Этаж подъёма для ПРР. В случае, если указан "LIFT_TO_DOOR_MANUAL" в deliveryServices, этаж нужно указывать обязательно}
Успех:
xxxxxxxxxx{ "success": true, "tariffs": [ { "minDeliveryTime": 5, // минимальный срок доставки после передачи заказа курьерской службе (в днях) "maxDeliveryTime": 6, // максимальный срок доставки после передачи заказа курьерской службе (в днях) "courier": "PickPoint", // наименование курьерской службы для покупателя "deliveryCode": "123456", // код тарифа "courierCode": "PICKPOINT", // код курьерской службы (из справочника) "contractNumber": "443-12", // доп. код тарифа "type": "PVZ", // тип доставки (курьером или в ПВЗ) // COURIER, RUSSIAN_POST, SELF_PICKUP "price": 817.1, // суммарная стоимость доставки для отправителя "codPrice": 0, //стоимость агентского вознаграждения курьерской службы за перевод денежных средств за наложенный платёж "deliveryPrice": 742.1, // тариф за доставку в место назначение с учётом веса/габаритов "deliveryServices": [ { "price": 956.64, "service": "BOX_NEEDED" }, { "price": 0, "service": "TRYING" }, { "price": 0, "service": "REVERSE" }, { "price": 0, "service": "LIFT_TO_DOOR" }, { "price": 0, "service": "LIFT_TO_DOOR_MANUAL" }, { "price": 40, "service": "CHECK_CONTENT" } ], //доп.услуги доставки, если есть // могут включать PERSONALLY_IN_HANDS, REVERSE, CONTACTLESS_DELIVERY, DELIVERY_DATE_APPROVE, DANGEROUS_CARGO, WAITING_ON_ADDRESS, TEMPERATURE_REGIME, VERIFY, DAY_OFF_DELIVERY, PARTIAL_DELIVERY, LIFT_TO_DOOR, TRYING, CHECK_CONTENT, LIFT_TO_DOOR_MANUAL "insurancePrice": 75, // стоимость страховки для заказа у курьерской службы "paymentMethods": ["COD_CARD", "ONLINE"] // доступные способы оплаты }, { "minDeliveryTime": 1, "maxDeliveryTime": 1, "courier": "Почта России", "courierCode": "RUSSIAN_POST_TEMPOLINE", "deliveryCode": "RUSSIAN_POST_TEMPOLINE", "contractNumber": "s-2333", "type": "RUSSIAN_POST", "price": 1736.6, "codPrice": 0, "deliveryPrice": 1733.6, "deliveryServices": [], "insurancePrice": 3, "paymentMethods": ["COD_CARD"] } ]}
Ошибка:
xxxxxxxxxx{"success": false,"errors": [ { "code": 0, "message": "Текст ошибки" }]}