NAME

Business::BR::PIS - Perl module to test for correct PIS numbers

SYNOPSIS

use Business::BR::PIS; 

print "ok " if test_pis('121.51144.13-7'); # prints 'ok '
print "bad " unless test_pis('121.51144.13-0'); # prints 'bad '

DESCRIPTION

This module handles PIS numbers, testing, formatting, etc.

EXPORT

test_pis is exported by default. canon_pis, format_pis, parse_pis and random_pis can be exported on demand.

THE CHECK EQUATIONS

A correct PIS number has a check digit which is computed from the base 10 first digits. Consider the PIS number written as 11 digits

c[1] c[2] c[3] c[4] c[5] c[6] c[7] c[8] c[9] c[10] dv[1]

To check whether a PIS is correct or not, it has to satisfy the check equation:

c[1]*3+c[2]*2+c[3]*9+c[4]*8+c[5]*7+
        c[6]*6+c[7]*5+c[8]*4+c[9]*3+c[10]*2+dv[1] = 0 (mod 11) or
                                                 = 1 (mod 11) (if dv[1]=0)

BUGS

Absolute lack of documentation by now.

SEE ALSO

Please reports bugs via CPAN RT, http://rt.cpan.org/NoAuth/Bugs.html?Dist=Business-BR-Ids By doing so, the author will receive your reports and patches, as well as the problem and solutions will be documented.

AUTHOR

A. R. Ferreira, <ferreira@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2005 by A. R. Ferreira

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.