sima-land/delivery-calculator

Delivery calculator for sima-land.ru

Расчет стоимости доставки www.sima-land.ru

, _(*1)

Основным способом расчета стоимости доставки является использование API https://www.sima-land.ru/api/v3/help/#Стоимость-доставки, _(*2)

Однако в ряду случаев предпочтительно рассчитывать стоимость доставки без использования API. Например:, _(*3)

• Количество запросов к API не укладывается в установленные лимиты.
• Требуемая скорость работы не позволяет ожидать ответа от API.

В описанных выше случаях рекомендуется использовать данный компонент, который позволяет вычислять стоимость доставки "на лету"., _(*4)

Для расчета стоимости доставки товара необходимо три сущности:, _(*5)

• Точка доставки - объект, реализующий PointInterface
• Товар - объект, реализующий ItemInterface
• Источник данных о коэффициентах упаковки - объект, реализующий VolumeFactorSourceInterface

Для того, чтобы произвести расчёт стоимости доставки товара, необходимо создать объект класса калькулятора с указанием точки доставки и коэффициентов упаковки., _(*6)

$calc = new Calculator($defaultVolumeFactor, $point, false)

Третий аргумент обозначает признак "локальности" точки по отношению к складу. Если true, то доставка будет считаться бесплатной для всех товаров кроме тех, у которых метод isPaidDeliveryLocal() возвращает true, _(*7)

Для добавления товара к расчёту стоимости доставки используется функция addItem($item, $qty), для получения результатов - getResult(). Для того, чтобы обнулить результат, используйте reset(). В случае ошибки метод addItem($item, $qty) вернет false. Информацию об ошибках после этого можно посмотреть с помощью метода getErrors()., _(*8)

Пример:, _(*9)

$calc->addItem($item1, 10)
$calc->addItem($item2, 1000)
echo $calc->getResult();  // вывод стоимости доставки item1 10 шт. и item2 1000 шт.

$calc->reset();
$calc->addItem($item3, 1)
echo $calc->getResult(); // вывод стоимости доставки item3 1 шт. 

// $item4->getWeight() = 0
if (!$calc->addItem($item4, 1000)) {
    return $calc->getErrors() // ['Weight must be positive, weight=0']
}

Точка доставки

Точку доставки представляет объект, реализующий PointInterface, данные по большинству городов доставки можно получить по API https://www.sima-land.ru/api/v3/help/#Города-доставки, _(*10)

Особые случаи: - Расчёт стоимости доставки до пункта самовывоза в г. Москва осуществляется с помощью класса MoscowPointAbstract. Нужно расширить этот класс, переопределив метод hasDiscount - При расчёте доставки в г. Екатеринбург признак "локальности" должен быть true, _(*11)

Товар

Все данные для реализации ItemInterface можно получить по API https://www.sima-land.ru/api/v3/help/#Товар, _(*12)

Данные о коэффициентах упаковки

Данные о коэффициентах упаковки представляет объект, реализующий VolumeFactorSourceInterface. Можно воспользоваться готовой реализацией модели DefaultVolumeFactorSource, _(*13)