NAME

Finance::FINRA::File::PostBranchIndividualReport - Parse the Branch CRD Report

DESCRIPTION

Finance::FINRA::File::PostBranchIndividualReport is a set of tools designed for interacting with the FINRA CRD BatchFiling and Data Download transfer individual branch file.

SYNOPSIS

use Finance::FINRA::File::PostBranchIndividualReport;
my $report = Finance::FINRA::File::PostBranchIndividualReport->new(
  file => 'report.xml'
);
$report->firm_crd_number;
$report->posting_date;
for my $branch ( @{ $report->records } ) {
   ...
}

ATTRIBUTES

file

A required, read-only, coercing Path::Class::File object. This should be either a Path::Class:File instance or a string pointing to the XML file.

dom

A private, read-only, lazy-building XML::LibXML::Node representing the root Node of the file.

records

A read-only, lazy-building array reference with holding the branch records. Refer to the record description below.

firm_crd_number

A read-only, lazy-building string. The unique CRD number of the requesting firm.

posting_date

A read-only, lazy-building DateTime object of the date the file was posted.

METHODS

new file => $file_name

Create a new instance.

meta

See Moose::Meta::Class

RECORD DESCRIPTION

branch

An hash reference representing the branch and it's members.

crd_number: The Branch's unique CRD Number Required.
operational_status_code: Required.
address: Required, see address record description
individuals: Required, Array ref of "individual" records see "individual" record description.
names: Required, An array reference of the different names the branch is known as.
nyse_branch_code_number: Optional
billing_code: Optional
district_code: Optional

address

street1: Optional.
street2: Optional.
city: Optional.
state: Optional.
postal_code: Optional.
country: Optional.

individual

crd_number: Required
supervisor_flag: Required, zero or one.
independent_contactor_flag: Optional, zero or one.
first: Optional.
last: Optional.
middle: Optional.
suffic: Optional.

AUTHOR

Guillermo Roditi (groditi) <groditi@cpan.org>

COMMERCIAL SUPPORT AND FEATURE / ENHANCEMENT REQUESTS

This software is developed as free software and is distributed free of charge, but if you or your organization would like to contribute to the further development, maintenance and QA of this project we ask that you sponsor the development of one ore more of these areas. Please contact groditi@cantella.com for more information.

Commercial support and sponsored development are available for this project through Cantella & Co., Inc. If you or your organization would like to use this package and need help customising it or new functionality added please contact groditi@cantella.com or jlanstein@cantella.com for rates.

BUGS AND CONTRIBUTIONS

Google Code Project Page - http://code.google.com/p/finance-finra-files/

COPYRIGHT AND LICENSE

Copyright 2009 by Cantella & Co., Inc. ( http://www.cantella.com/ )

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