NAME
Business::CA::GST - Look up Canadian Federal Sales Tax rates
VERSION
version 1.01
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>
Bugs and Requests
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=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.