Hotfixes for Kentico 11 and breaking changes affecting custom tax calculation scenarios
Applying hotfix 11.0.39 or newer introduced a change in the E-commerce API, which could cause undetected broken functionality for sites with a customized tax calculation process. This article describes the way it is fixed in 11.0.47 hotfix and lists other related information sources on rectifying the issue.
Although our standard hotfixing policy is not to include any breaking changes into hotfix releases, the hotfix 11.0.39 (specifically its fix for an issue with our PayPal provider) introduced a breaking change that could prevent already implemented custom tax calculation process scenarios from working correctly, while not causing any direct compilation or runtime error. This was not wanted nor intended result, but a side effect.
In order to rectify this issue, we have released hotfix 11.0.47 that will make sure such breaking change in custom code is now identified. The fixed bugs list (for Kentico 11) explains the issue titled:
E-commerce - Undetected breaking change for custom tax calculation implementations
as follows:
Applying hotfix 11.0.39 or newer introduced a change in the e-commerce API, which could cause undetected broken functionality for sites with a customized tax calculation process. After applying hotfix 11.0.47, such cases now clearly result in a runtime and compilation error. Any custom code that prepares 'TaxCalculationResult' objects can no longer use the setter of the 'TotalTax' property, and must instead set the new 'ItemsTax' and 'ShippingTax' properties.
Hotfix instructions for 11.0.47 use similar description, including a link to the documentation of the affected scenario:
Applying hotfix 11.0.39 or newer introduced a change in the e-commerce API, which could cause undetected broken functionality for sites with a customized tax calculation process. After applying hotfix 11.0.47, a runtime and compilation error now occurs for projects with custom code that attempts to set the TotalTax property of TaxCalculationResult objects. In these cases, you need to update your code to set the new ItemsTax and ShippingTax properties instead.
The linked documentation of the tax customization scenario (customized tax calculation process) was updated accordingly.
If your site used customized tax calculation process, then in addition to applying the hotfix 11.0.47, we also recommend reviewing the tax data of orders created after deploying hotfix 11.0.39 (or any other between .39 and .47).
In case you run into further questions or issues related to this change and hotfix releases, please don’t hesitate to contact us.