The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Finance-AMEX-Transaction-0.005
River stage zero No dependents
++
/ Finance::AMEX::Transaction::EPTRN::Trailer

NAME

Finance::AMEX::Transaction::EPTRN::Trailer - Parse AMEX Transaction/Invoice Level Reconciliation (EPTRN) Trailer Rows

VERSION

version 0.005

SYNOPSIS

 use Finance::AMEX::Transaction;

 my $epraw = Finance::AMEX::Transaction->new(file_type => 'EPTRN');
 open my $fh, '<', '/path to EPTRN file' or die "cannot open EPTRN file: $!";

 while (my $record = $epraw->getline($fh)) {

  if ($record->type eq 'FOOTER') {
    print $record->DF_TRL_DATE . "\n";
  }
 }

 # to parse a single line

 my $record = $epraw->parse_line('line from an EPTRN  file');
 if ($record->type eq 'TRAILER') {
   ...
 }

DESCRIPTION

You would not normally be calling this module directly, it is one of the possible return objects from a call to Finance::AMEX::Transaction's getline method.

METHODS

new

Returns a new Finance::AMEX::Transaction::EPTRN::Trailer object.

 my $record = Finance::AMEX::Transaction::EPTRN::Trailer->new(line => $line);

type

This will always return the string TRAILER.

 print $record->type; # TRAILER

line

Returns the full line that is represented by this object.

 print $record->line;

field_map

Returns a hashref where the name is the record name and the value is an arrayref of the start position and length of that field.

 # print the start position of the DF_TRL_DATE field
 print $record->field_map->{DF_TRL_DATE}->[0]; # 6

DF_TRL_RECORD_TYPE

This field contains the constant literal "DFTRL", a Record Type code that indicates that this is a Data File Trailer Record.

DF_TRL_DATE

This field contains the File Creation Date.

The format is: MMDDYYYY

MM = Month
DD = Day
YYYY = Year

DF_TRL_TIME

This field contains the File Creation Time (24-hour format), when the file was created.

The format is: HHMM

HH = Hours
MM = Minutes

DF_TRL_FILE_ID

This field contains an American Express, system-generated, File ID number that uniquely identifies this data file.

DF_TRL_FILE_NAME

This field contains the File Name (as entered in the American Express data distribution database) that corresponds to DF_TRL_FILE_ID.

DF_TRL_RECIPIENT_KEY

This field contains the Recipient Key, a unique, American Express, system-generated number that identifies this data file.

Note: This number is unique to each individual file.

DF_TRL_RECORD_COUNT

This field contains the Record Count for all items in this data file, including the header and trailer records.

NAME

Finance::AMEX::Transaction::EPTRN::Trailer - Object methods for AMEX Transaction/Invoice Level Reconciliation (EPTRN) Trailer Rows

AUTHOR

Tom Heady <cpan@punch.net>

COPYRIGHT AND LICENSE

This software is copyright (c) 2022 by ZipRecruiter/Tom Heady.

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