Download the PHP package viddyoze-engineering/vat-calculator without Composer

On this page you can find all versions of the php package viddyoze-engineering/vat-calculator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package vat-calculator

VatCalculator

Build Status Scrutinizer Code Quality codecov.io StyleCI SensioLabsInsight

Handle all the hard stuff related to EU MOSS tax/vat regulations, the way it should be. Can be used with Laravel 5 / Cashier — or standalone.

Contents

Installation

In order to install the VAT Calculator, just run

Standalone

You can also use this package without Laravel. Simply create a new instance of the VAT calculator and use it. All documentation examples use the Laravel 5 facade code, so make sure not to call the methods as if they were static methods.

Example:

Usage

Calculate the gross price

To calculate the gross price use the calculate method with a net price and a country code as paremeters.

The third parameter is the postal code of the customer.

As a fourth parameter, you can pass in a boolean indicating whether the customer is a company or a private person. If the customer is a company, which you should check by validating the VAT number, the net price gets returned.

Receive more information

After calculating the gross price you can extract more information from the VatCalculator.

Validate EU VAT numbers

Prior to validating your customers VAT numbers, you can use the shouldCollectVAT method to check if the country code requires you to collect VAT in the first place.

To validate your customers VAT numbers, you can use the isValidVATNumber method. The VAT number should be in a format specified by the VIES. The given VAT numbers will be truncated and non relevant characters / whitespace will automatically be removed.

This service relies on a third party SOAP API provided by the EU. If, for whatever reason, this API is unavailable a VATCheckUnavailableException will be thrown.

Get EU VAT number details

To get the details of a VAT number, you can use the getVATDetails method. The VAT number should be in a format specified by the VIES. The given VAT numbers will be truncated and non relevant characters / whitespace will automatically be removed.

This service relies on a third party SOAP API provided by the EU. If, for whatever reason, this API is unavailable a VATCheckUnavailableException will be thrown.

Laravel Validator Extension

If you want to include the VAT number validation directly in your existing Form Requests / Validations, use the vat_number validtion rule.

Example:

Important: The validator extension returns false when the VAT ID Check SOAP API is unavailable.

Cashier integration

If you want to use this package in combination with Laravel Cashier you can let your billable model use the BillableWithinTheEU trait. Because this trait overrides the getTaxPercent method of the Billable trait, we have to explicitly tell our model to do so.

By using the BillableWithinTheEU trait, your billable model has new methods to set the tax rate for the billable model.

Set everything in one command:

Or use the more readable, chainable approach:

So in order to set the correct tax percentage prior to subscribing your customer, consider the following workflow:

Get the IP based Country of your user(s)

Right now you'll need to show your users a way to select their country - probably a drop down - to use this country for the VAT calculation.

This package has a small helper function, that tries to lookup the Country of the user, based on the IP they have.

The $countryCode will either be false, if the service is unavailable, or the country couldn't be looked up. Otherwise the variable contains the two-letter country code, which can be used to prefill the user selection.

Frontend integration — vat_calculator.js

Phew - so you know how to use this class, built your fancy payment form and now...? Well - you want to display the correct prices to your users and want it to update dynamically. So go ahead, add some routes, write some Javascript and in no time you'll be up and running, right?

Or you use the built in routes and vat_calculator.js library.

The VAT Calculator JS library will automatically:

The Javascript library has no dependencies on third party frameworks.

In order to use the Javascript helper you need to publish the package files first. Go ahead and type:

Now you have a file called vat_calculator.js in your public/js folder.

Integrating it in your payment form

Add the published javascript file to your payment form.

By default, the VAT Calculator JS script is looking for a form with the ID payment-form. This form needs a data-amount attribute specifying the amount to use for the tax calculation in cents (just like Stripe uses it).

So your form should look like this, when you would calculate the taxes for 24.99 €

Next up, you need a dropdown to let your users select their billing country. This select field needs the data-vat="country" attribute, so that the VAT Calculator JS knows, where to look for country codes.

Since there are also quite a few VAT rate exceptions for specific regions or cities, it is highly recommended to add an input field to collect postal codes. This field needs a data-vat="postal-code" attribute.

And last but not least, to automatically validate VAT Numbers / VAT IDs you can have an input field with the data-vat="vat_number" attribute specified.

So your form will look like this:

Extra fields

To display the live tax calculation, you can use the classes vat-subtotal, vat-taxrate, vat-taxes and vat-total on any DOM element and VAT Calculator JS will automatically set the inner HTML content for you.

Example:

Form attributes

Attribute Description Required
data-amount Use this attribute on the form you want to use for live calculation. It's the price in cent used for the calculation. Yes

Form fields

In order to calculate the right taxes, you need to add some extra inputs to your payment form. All these fields need to have a data-vat attribute. You need to include at least the country.

Attribute Description Required
country Customer’s country (2-letter ISO code). Yes
postal-code Customer's postal code No Highly recommended
vat-number Billing VAT number No

Advanced usage

Use a different form selector

Use VATCalculator.init('#my-selector') to initialize the live calculation on a different form.

Use a custom formatter function to modify calculation result HTML

Use VATCalculator.setCurrencyFormatter to use a different method to format the calculated values for the HTML output. This function will receive the calculation result as a parameter.

Example:

Trigger calculation manually

Call VATCalculator.calculate() to trigger the calculation manually. For example when you change the data-amount attribute on your form.

Preconfigured routes

In order for VAT Calculator JS to work properly, these routes will be added to your application. If you don't want to use the Javascript library, you can of course disable the routes in the configuration file.

Method Route Usage
GET vatcalculator/tax-rate-for-location/{country}/{postal-code} Returns the VAT / tax rate for the given country (2-letter ISO code).
GET vatcalculator/country-code Returns the 2-letter ISO code based from the IP address.
GET vatcalculator/validate-vat-id/{vat_id} Validates the given VAT ID
GET vatcalculator/calculate Calculates the gross price based on the parameters: netPrice, country and vat_number

Configuration

By default, the VAT Calculator has all EU VAT rules predefined, so that it can easily be updated, if it changes for a specific country.

If you need to define other VAT rates, you can do so by publishing the configuration and add more rules.

The configuration file also determines wether you want to use the VAT Calculator JS routes or not.

Important: Be sure to set your business country code in the configuration file, to get correct VAT calculation when selling to business customers in your own country.

To publish the configuration files, run the vendor:publish command

This will create a vat_calculator.php in your config directory.

Changelog

Please see CHANGELOG for more information.

License

This library is licensed under the MIT license. Please see License file for more information.


All versions of vat-calculator with dependencies

PHP Build Version
Package Version
Requires php Version >=7.1
ext-soap Version *
ext-json Version *
illuminate/config Version ~5.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package viddyoze-engineering/vat-calculator contains the following files

Loading the files please wait ....