Extended Location Data

What this solution does

The tidx.location module provides extended location data and is a revised version of the previously released hooli.location module. It supplements the standard 1C-Bitrix location database with information required for integration with delivery services, address processing, and e-commerce business logic. The module does not create a separate directory or duplicate locations; instead, all data is written directly to the standard entities of the 'Online Store' (sale) module.

The package includes mappings for 12,219 location codes across the following systems: FIAS, KLADR, OKATO, OKTMO, and time zones. Additional data includes geographic coordinates (11,226 records), short Russian names (10,941), postal codes (10,067), CDEK identifiers (6,907), DPD identifiers (3,281), and Boxberry identifiers (789). The actual number of imported values depends on the composition and version of the location database installed on the site.

All data is included within the module, eliminating the need for external service connections or automatic directory downloads. Import is performed in small batches, the size of which can be configured in the administrative interface.

Existing values are not overwritten, allowing the import to be safely restarted; already populated records are skipped.

During execution, the system displays statistics including the total number of locations in the Bitrix database, the number of rows in each batch, counts of already filled and existing values, current import progress, the number of processed rows, skipped values due to missing locations, and rows with incorrect formatting.

The import can be stopped after the current batch completes without losing saved data.

External identifiers are preserved using standard 1C-Bitrix tools. Coordinates are written to standard latitude and longitude fields, while short names are stored in the Russian location representation.

The module does not create custom tables for storing imported data.

This new version continues the functionality of the previous hooli.location module but employs an updated architecture and administrative interface featuring batch import with progress tracking, safe re-runs without data overwrites, and detailed statistics for each batch.

The module provides separate access rights for viewing and importing location data. It relies on standard Bitrix components, including the Engine Controller, CSRF protection, and the authorization system. The solution includes automatic logging of unexpected errors and validation of the format of imported data.

Values previously imported by the hooli.location module into standard sale tables are preserved. When the import is run again, the new version recognizes existing entries and skips them to prevent duplication.

Requirements:

- PHP 8.1 or higher;

- The 'Online Store' (sale) module must be installed;

- The standard 1C-Bitrix location database must be preloaded.

When needed, General iT can implement “Extended Location Data”, configure the module and verify it against the current website setup.