Комментарии к использованию методов Тарификации
1. Получение тарифов доставки (от Кактуса), для показа в процессе чекаута
Для получения тарифов на доставку, необходимо передать данные:
- Связка ФИАС guid-ов (для РФ): регион, район, город, населенный пункт
- Вес
- Объемный вес
У нас также есть возможность отправки за границу (в любую страну) с автоматической растаможкой, для этого надо передать код страны, адрес на латинице (кроме СНГ), а также передать к товарам код тнвэд и описание на английском.
Для первого этапа, можно ограничиться доставкой по России, но заложить последующую международную доставку.
Для получения ФИАС кодов, можно воспользоваться сервисом Dadata, либо вашим внутренним решением, либо нашим подсказчиком:
/api/prompter/location
Запрос позволяет получить подсказки по городу, в ответ возвращаются данные по ФИАС, которые необходимо сохранить и использовать в дальнейшем для получения тарифов.
Для определения габаритов коробки (объемного веса), можно использовать метод:
/api/lite/pub/dimensions-by-package
Для этого необходимо передать вес и габариты каждого товара в заказе.
Запрос на получения тарифов /api/dlv/tariffs
в запросе необходимо указать:
- данные по локации доставки (фиас коды в первую очередь, остальные данные второстепенны при наличии фиас кодов),
- данные по размеру и весу,
- данные о оценочной стоимости заказа и сумму наложенного платежа (если требуется включить их в расчет) - это на усмотрение пользователя
Следует делать перерасчёт стоимости доставки в случае изменения состава заказа, изменении места доставки, изменении способа оплаты.
Для выбора точек ПВЗ на карте следует использовать скрипт вызова карты
Если при получении тарифов пришли тарифы в которых указан
type: "PVZ"
нужно дать возможность выбрать ПВЗ на карте.
Полученный результат выбора ПВЗ (код ПВЗ), стоимость доставки, и данные о локации сохранить в заказе, для передачи в сервис “Кактус” для Фулфилмент обработки.
Некоторые ПВЗ не поддерживают оплату при получении, для таких ПВЗ следует ограничить возможность выбора способа оплаты в заказе только предоплатой. В случае если paymentMethods возвращает хотя бы 1 способ оплаты - значит в этом пункте выдачи можно оплатить при получении, если список в paymentMethods вернулся пустой, значит в этот ПВЗ можно отправить только предоплаченный заказ.
По всем методам апи этого раздела - авторизация работает по параметру Domain в header запросов.
Домен для всех аккаунтов генерируется автоматически при регистрации и его можно узнать в личном кабинете
https://lk2-test.kak2c.ru/settings в поле ID аккаунта. Нужно в запросах передавать Domain = {"shop" + ID аккаунта}