/ 
Business-CA-GST-1.03
River stage zero No dependents
/ Business::CA::GST

NAME

Business::CA::GST - Look up Canadian Federal Sales Tax rates

VERSION

version 1.03

SYNOPSIS

use Business::CA::GST
my $tax = Business::CA::GST->new;
$tax->buyer_region('ON');

print $tax->rate, "\n";     # gives 0.13
print $tax->tax_type, "\n"; # gives 'HST'

DESCRIPTION

A tax table for Canadian GST/HST payments. Actual tax calculations are left as an exercise for the reader. Please see http://en.wikipedia.org/wiki/Sales_taxes_in_Canada for a more detailed explanation of how GST and HST works (it's not as simple as one might hope).

CONSTRUCTOR AND STARTUP

new( buyer_region => $region )

Creates and returns a new Business::CA::GST object.

my $tax = Business::CA::GST->new();
buyer_region => $region_code

You may pass this parameter to new(), and/or you may use the buyer_region() method after having created the object. See the buyer_region() documentation below for a list of allowable region codes.

my $tax = Business::CA::GST->new( buyer_region => $region_code );

SUBROUTINES/METHODS

buyer_region( $region )

The only required parameter. Must be one of:

AB, BC, MB, NB, NL, NS, NT, ON, PE, SK, QC, YT, NU

rate

Returns the GST/HST as a floating point number. eg 13% is returned as 0.13

tax_type

Returns either 'GST' or 'HST'

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Business::CA::GST

You can also look for information at:

Source code

http://github.com/oalders/business-ca-gst

Search CPAN

https://metacpan.org/module/Business::CA::GST

ACKNOWLEDGEMENTS

Thanks to Raybec Communications http://www.raybec.com for funding my work on this module and for releasing it to the world.

AUTHOR

Olaf Alders <olaf@wundercounter.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Olaf Alders.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.