Skip to content

Latest commit

 

History

History
73 lines (52 loc) · 2.29 KB

UPGRADE.md

File metadata and controls

73 lines (52 loc) · 2.29 KB
Raw

Upgrade Guide

Upgrading from v2 to v3

Minimum Versions

PR: #131

All support for PHP 7.2 and below has been dropped as well as support for Laravel 5.8 and below.

Removed Countries

PR: #130

Previously, VatCalculator calculated VAT taxes for GB, NO and TR. Since these countries do not belong to the EU, these have been removed. If you were relying on the previous behavior and want to keep it, you should re-add them to your config.php file:

return [
    'rules' => [
         'GB' => [ // United Kingdom
             'rate' => 0.20,
             'exceptions' => [
                 // UK RAF Bases in Cyprus are taxed at Cyprus rate
                 'Akrotiri' => 0.19,
                 'Dhekelia' => 0.19,
             ],
         ],
         'TR' => [ // Turkey
             'rate' => 0.18,
         ],
         'NO' => [ // Norway
             'rate' => 0.25,
         ],
    ],
],

Refactored Validation Rule

PR: #133

The internal validation rule for a VAT number has been refactored to a new rule object. You may use it as follows:

// Before...
$validator = Validator::make(
    ['vat_number' => $vatNumber],
    ['vat_number' => ['required', 'vat_number']]
);

// After...
use Mpociot\VatCalculator\Rules\ValidVatNumber;

$validator = Validator::make(
    ['vat_number' => $vatNumber],
    ['vat_number' => ['required', new ValidVatNumber]]
);

Removed Functionality

All functionality for the front-end capabilities, as well as the IP lookup functionality have been removed. Additionally, all shipped translations of the VatNumber validation rule have been removed. No migration path is offered for these so if you rely on these you can either remain on v2 of the package or you can recreate the functionality in your app.

Upgrading from v1 to v2

Version 2 of VatCalculator provides a new method to get a more precise VAT rate result. It's recommended to use the new getTaxRateForLocation method instead of getTaxRateForCountry.

This method expects 3 arguments:

  • country code - The country code of the customer
  • postal code - The postal code of the customer
  • company - Flag to indicate if the customer is a company