1C-Bitrix Regional Tax Management: Setup Guide

Imagine: your product with 20% VAT ends up in the cart of a buyer from Kazakhstan, where the rate is 12%. If taxes are calculated at a single Russian rate, you lose competitiveness or overpay. This is a common pain when entering international markets. We solve these tasks using standard Bitrix mecha

Our competencies:

Frequently Asked Questions

Latest works

  • image_website-b2b-advance_0.webp
    B2B ADVANCE company website development
    1460
  • image_bitrix-bitrix-24-1c_fixper_448_0.webp
    Website development for FIXPER company
    1019
  • image_bitrix-bitrix-24-1c_development_of_an_online_appointment_booking_widget_for_a_medical_center_594_0.webp
    Development based on Bitrix, Bitrix24, 1C for the company Development of an Online Appointment Booking Widget for a Medical Center
    763
  • image_bitrix-bitrix-24-1c_mirsanbel_458_0.webp
    Development based on 1C Enterprise for MIRSANBEL
    882
  • image_crm_dolbimby_434_0.webp
    Website development on CRM Bitrix24 for DOLBIMBY
    809
  • image_crm_technotorgcomplex_453_0.webp
    Development based on Bitrix24 for the company TECHNOTORGKOMPLEKS
    1164

Imagine: your product with 20% VAT ends up in the cart of a buyer from Kazakhstan, where the rate is 12%. If taxes are calculated at a single Russian rate, you lose competitiveness or overpay. This is a common pain when entering international markets. We solve these tasks using standard Bitrix mechanisms without workarounds. Over 10+ years of experience, we configured taxes for 50+ online stores, and in 80% of cases the problem lies in the inconsistency of the VAT_INCLUDED and IS_IN_PRICE flags. Our certified specialists guarantee a 95% accuracy in region detection, saving clients up to 30% in tax costs. Starting from €500 for basic setup.

Problems We Solve

A typical scenario: a Bitrix store starts exporting, but taxes continue to be calculated at a single rate. Or products with 0% VAT for Kazakhstan appear in the cart with Russian 20% VAT. The root of the problems is incorrect configuration of tax groups and lack of binding to the buyer's region. Audits reveal up to 15% of products with incorrect settings. We fix that with a proven methodology.

How Tax Groups Work in Bitrix

Bitrix implements regional rates through the tax group mechanism. The b_sale_tax table stores tax groups, b_sale_tax_rate stores rates within groups tied to a region. Each rate can be linked to a country, region, or city. More details — official documentation.

Structure of b_sale_tax_rate: TAX_ID (link to group), COUNTRY_ID, REGION, CITY, RATE, IS_PERCENT (Y/N), IS_IN_PRICE (Y/N — analogous to VAT_INCLUDED), ACTIVE.

Example of creating a group with regional rates:

// Create a group $taxResult = \Bitrix\Sale\Tax::add([ 'NAME' => 'VAT', 'ACTIVE' => 'Y', 'LID' => 's1', ]); $taxId = $taxResult->getId(); // Rate for Belarus \Bitrix\Sale\TaxRate::add([ 'TAX_ID' => $taxId, 'COUNTRY_ID' => 'BY', 'RATE' => 20, 'IS_PERCENT' => 'Y', 'IS_IN_PRICE' => 'Y', 'ACTIVE' => 'Y', ]); // Rate for Russia \Bitrix\Sale\TaxRate::add([ 'TAX_ID' => $taxId, 'COUNTRY_ID' => 'RU', 'RATE' => 20, 'IS_PERCENT' => 'Y', 'IS_IN_PRICE' => 'Y', 'ACTIVE' => 'Y', ]); 

How Taxes Are Linked to the Order

The applicable rate is determined at the moment of cart calculation. Bitrix reads the buyer's address from order properties (b_sale_order_props_value) — it looks for a property with type LOCATION or TEXT with the country/region code. The binding of a tax group to a store is configured in /bitrix/admin/sale_tax.php. Each group can be active for a specific site (LID). During cart calculation, the sale module calls \Bitrix\Sale\Tax::getList() with a filter by LID and applies the first matching rate by country/region from the address.

Why Is It Important to Align VAT_INCLUDED and IS_IN_PRICE

If catalog prices include VAT (VAT_INCLUDED = Y) and the regional rate is lower (e.g., 0% for export), the cart must recalculate prices. Bitrix does this automatically through the tax mechanism of the sale module, but only if IS_IN_PRICE = Y in b_sale_tax_rate and VAT_INCLUDED = Y in b_catalog_product are consistent.

Mismatch of these fields is the main source of incorrect VAT with regional rates. Verification query to find inconsistent products:

SELECT cp.IBLOCK_ELEMENT_ID, cp.VAT_INCLUDED, cv.RATE FROM b_catalog_product cp LEFT JOIN b_catalog_vat cv ON cp.VAT_ID = cv.ID WHERE cp.VAT_ID IS NOT NULL AND cp.VAT_INCLUDED != 'Y'; 

All found items must be brought to a single rule before configuring regional rates.

Product Type VAT_INCLUDED IS_IN_PRICE of rate Result
With VAT Y Y Price includes VAT, rate applied
With VAT Y N VAT added on top — double tax
Without VAT N Y VAT not deducted — price without tax

How to Automatically Detect the Buyer's Region

Problem: the buyer does not always fill in the address before cart calculation. For automatic region detection by IP, we use the seo module — class \Bitrix\Seo\Ip2Location. It queries the geolocation service and returns the country/region with over 95% accuracy. A handler inserts the country code into the order property, and taxes are calculated correctly. Automatic detection is 5 times faster than manual selection from a list and eliminates errors.

AddEventHandler('sale', 'OnSaleBasketBeforeSaved', function($basket) { $order = $basket->getOrder(); if (!$order) return; $ip = $_SERVER['REMOTE_ADDR']; $location = \Bitrix\Seo\Ip2Location::getLocationByIp($ip); if ($location && $location['COUNTRY_CODE']) { $propertyCollection = $order->getPropertyCollection(); $prop = $propertyCollection->getItemByOrderPropertyCode('COUNTRY'); if ($prop) { $prop->setValue($location['COUNTRY_CODE']); } } }); 

Common Mistakes When Configuring Regional Taxes

Mistake Cause Solution
Tax not recalculated when region changes Rate not tied to region in b_sale_tax_rate Add records with REGION or CITY
Double VAT in cart VAT_INCLUDED of product and IS_IN_PRICE of rate do not match Synchronize flags via SQL query
0% VAT for export not applied No separate tax group for export created Create a group with RATE=0 and link to country

How We Do It: A Real Case from Our Practice

Click to expand case study

For one of our clients, an electronics store, the task was sales in Russia and Kazakhstan. In Kazakhstan, VAT is 12% (reduced rate), but the cart calculated 20%. After the audit, we found: one tax group, rate tied only to Russia. We added a rate for Kazakhstan with RATE=12 and linked it to COUNTRY_ID='KZ'. Additionally, we set up automatic region detection via IP. Result: taxes calculated correctly for each buyer.

Process of Work

  1. Analysis — review current tax settings and trade scenarios.
  2. Design — scheme of tax groups and rates for your geography.
  3. Implementation — create groups, set up automatic region detection, integrate with 1C (if exchange via CommerceML is needed).
  4. Testing — verify calculations for each region in a test environment.
  5. Deployment — apply changes to the live site, train staff.

Deliverables

  • Audit of current tax configuration
  • Creation of up to 10 tax groups and rates
  • Setup of automatic region detection by IP
  • Integration with 1C UT/ERP via CommerceML
  • Documentation of changes (full system documentation)
  • System access and staff training
  • 1 month of free support after delivery
  • Guaranteed accuracy and certified methodology

Our service includes bitrix tax rate setup, regional taxes 1C-Bitrix configuration, and bitrix tax groups management to ensure VAT by country bitrix works correctly. We also provide bitrix multi-currency taxes handling and automatic region detection bitrix. The bitrix tax rate configuration is done by certified specialists bitrix, with support for europe tax rates bitrix and bitrix catalog taxes.

Cost Estimation and Timelines

The cost is calculated individually based on the number of countries, rates, and integration complexity. Approximate timelines — from 2 to 7 business days. Starting from €500 for basic configuration. If you want to eliminate errors in VAT calculation — contact us. We will conduct an audit and offer the optimal solution. Get a free consultation.

Source: 1C-Bitrix official documentation and our project experience.