Finance::AMEX::Transaction::GRRCN::TaxRecord - Parse AMEX Global Reconciliation (GRRCN) TaxRecord Rows
version 0.002
use Finance::AMEX::Transaction; my $epraw = Finance::AMEX::Transaction->new(file_type => 'GRRCN'); open my $fh, '<', '/path to GRRCN file' or die "cannot open GRRCN file: $!"; while (my $record = $epraw->getline($fh)) { if ($record->type eq 'SUMMARY') { print $record->PAYMENT_DATE . "\n"; } } # to parse a single line my $record = $epraw->parse_line('line from an GRRCN file'); if ($record->type eq 'SUMMARY') { ... }
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.
Returns a new Finance::AMEX::Transaction::GRRCN::TaxRecord object.
my $record = Finance::AMEX::Transaction::GRRCN::TaxRecord->new(line => $line);
This will always return the string SUMMARY.
print $record->type; # SUMMARY
Returns the full line that is represented by this object.
print $record->line;
This field contains the Record identifier, which will always be “TAXRECORD” for the Tax Record(s).
Note: This record is only applicable to the Argentina market.
This field contains the American Express-assigned Service Establishment (SE) Number of the Merchant receiving the payment/settlement.
This field contains the Settlement Account Type.
Valid values include the following:
If unused, this field will be space filled (fixed format) or blank (delimited formats).
This field contains the American Express-assigned Payment/Settlement Number. This reference number may be used by the American Express Payee for reconciliation purposes.
This field contains the Payment Date scheduled in American Express systems. The date that funds are actually available to the payee's depository institution may differ from the date reported in this field.
The format is: YYYYMMDD
This field contains the Alphanumeric ISO Code for the Payment (Settlement) currency.
This field contains a numerical value between 01 and 99 according to the description of tax.
This field contains a description of the tax applied, which corresponds to the Tax Type Code field.
Note: there may be multiple descriptions for a single tax code.
This field contains the amount on which tax is applied.
The format of the Tax Base Amount field value is: leading sign (1), whole numbers (13) and decimal places (10).
This field contains the date when American Express pays the tax to the tax collector.
This field contains the Tax Rate Percentage, which corresponds to the calculation of the tax Amount.
This field is expressed as an actual percentage. The format of the Tax Rate field value is: leading sign (1), whole numbers (13) and decimal places (6). Right aligned with leading zeros.
For example: Rate Displayed in File +21% ~0000000000021000000 +21.123446% ~0000000000021123446 -5.05% -0000000000005050000
This field contains the amount of the tax.
The Tax Amount is calculated as follows;
Tax Base Amount * Tax Rate = Tax Amount.
“Tax Rate” used in above calculation is a decimal value (i.e., Tax Base Amount = 1000, Tax Rate = 20%, Tax Amount = 200; 1000 * 0.2 = 200).
The format of the Tax Amount field value is: leading sign (1), whole numbers (13) and decimal places (10).
Finance::AMEX::Transaction::GRRCN::TaxRecord - Object methods for AMEX Global Reconciliation (GRRCN) Tax records.
Note: This record is only applicable for Argentina.
=for: list = YYYY = Year = MM = Month = DD = Day
Tom Heady <theady@ziprecruiter.com>
This software is copyright (c) 2018 by ZipRecruiter.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Finance::AMEX::Transaction, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Finance::AMEX::Transaction
CPAN shell
perl -MCPAN -e shell install Finance::AMEX::Transaction
For more information on module installation, please visit the detailed CPAN module installation guide.