NAME

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

VERSION

version 0.005

SYNOPSIS

use Finance::AMEX::Transaction;

my $epraw = Finance::AMEX::Transaction->new(file_type => 'EPPRC');
open my $fh, '<', '/path to EPPRC file' or die "cannot open EPPRC 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 EPPRC  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::EPPRC::Trailer object.

my $record = Finance::AMEX::Transaction::EPPRC::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::EPPRC::Trailer - Object methods for AMEX Reconciliation file footer records.

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.