Business-BR-Ids version 0.00_21
===============================

The intention of this distribution is to provide facilities
to deal with Brazilian identification numbers and codes.
It is part of a set of distributions to approach programming
on Brazilian business-related subjects.
The distribution is starting up with support to CPF and CNPJ
(tests for correctness, canonicalization, formatting, parsing,
random generation for mass tests). More is to come.

The actually supported codes follow along with a brief explanation
of what they are good for and who emits them.

  * CPF  - to identify citizens as taxpayers in nation-wide context, 
           emitted by the Brazilian Ministry of Revenue
  * CNPJ - to identify companies as taxpayers in nation-wide context, 
           emitted by the Brazilian Ministry of Revenue
  * PIS  - to identify citizens as users of the public health services
  * IE/AC
    IE/AL
    IE/AP
    IE/AM
    IE/BA
    IE/MA
    IE/MG
    IE/PR
    IE/RO
    IE/RR
    IE/SP
         - to identify companies as taxpayers in state-wide context,
           emitted by Revenue Secretariats of Brazilian States
           (by now supporting only the states of Acre, Alagoas,
           Amapá, Maranhão, Minas Gerais, Rondônia, Roraima, São Paulo 
           and Paraná)

Some of the next ones to be supported are:

  * IE   - to identify companies as taxpayers in state-wide contexts,
           emitted by the Secretariat of Revenue of each state
  * TE   - to identify citizens as allowed voters, emitted by
           Regional Electoral Courts under the control 
           of the Superior Electoral Court

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

  Scalar::Util 1.11
  Test::More

TO DO

* write tests for module Business::BR::CNPJ
* introduce Business::BR::TE
* write article 'br-docs.pod'
* get rid of Business::BR::Biz
* random_cnpj() calls for a better pseudo-random
  distribution when selecting variation in Business::BR::CNPJ
* introduce the $canon argument to test_*(),
  format_*(), parse_*() methods
* write tests for module Business::BR::Ids
* what about Business::BR::Passport?
* complete Business::BR::IE
* enhance Business::BR::Ids docs
* parse_ie_sp() is missing
* document Business::BR::PIS

* 0.01 milestone: complete code for IE of each Brazilian state

COPYRIGHT AND LICENCE

Copyright (C) 2005-2007 by A. R. Ferreira

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


