Delivery cost by zones

What this solution does

The module calculates delivery costs using Yandex Maps data, based on the district (zone) and distance from the warehouse. To configure, create shipping points, define delivery zones, set rates for each zone, and activate the module.

Delivery Zones

The core feature of the module is delivery zone management. Users define geographic areas within which the store accepts orders; delivery outside these boundaries is not supported.

Creation and Editing

Zone boundaries are defined on Yandex Maps using polygon shapes.

Data Import

To simplify zone setup, the system supports importing data from GEO JSON files. Users can import multiple zones at once or load data for a specific zone. The import algorithm scans the file for all geometry objects with the property type = "Polygon". During the import process, users can select which specific areas to add.

Pricing Configuration

The module supports flexible pricing models:

- Fixed delivery fee for the entire zone (minimum price);

- Per-kilometer pricing, where distance is calculated based on the actual route;

- Minimum order value threshold required to activate the zone;

- Threshold setting for free delivery based on order value.

Additional Features

- Linking delivery zones to specific warehouses: cost calculation is performed only from selected warehouse locations;

- Custom color assignment for each zone;

- Ability to temporarily deactivate zones that are not currently in use.

Warehouse Modes

The module supports two warehouse operation modes, the first being the store's own warehouses.

2. Custom Warehouses

Modes differ only in where warehouse data is stored: custom warehouses are kept in the module's database table. This data is required to calculate the nearest warehouse relative to the location specified by the user.

Display Templates

The map is rendered using the ctweb:yandexdelivery component.

Two templates are available by default:

1. .default — can be placed on any page. Multiple component instances may coexist on a single page.

2. order — automatically added to the checkout page of the sale.order.ajax component. To configure parameters for the order template, use the parameters.php file within the component's template directory.

Customization

You may copy a template and modify its markup and styles as needed. The only requirement is to preserve specific IDs assigned to tags; these are documented in component.php and at the top of the template. Standard templates include examples of events to which you can attach custom functions. Additionally, you can extend the BX.Ctweb.YandexDelivery.Controller class in the template's script.js file (an example is provided in the order template).

Price Calculation

The module exposes the OnYandexDeliveryCalculatePrice($distance, $regionID, $storageID) event to allow modification of the calculation result.

In the module settings, you can specify an order property to store information about the point selected by the user. Create a text-type order property where the warehouse name, point address, and point coordinates will be saved.

To customize the delivery calculation logic, copy the file /bitrix/modules/ctweb.yandexdelivery/tools/delivery_ctwebyandexdelivery.php to the directory /bitrix/php_interface/include/sale_delivery/.

If “Delivery cost by zones” fits the task, General iT can install the module, configure it and verify the result in the project.