NAME

Finance::Bank::Norisbank - Automated account interaction for customers of Norisbank GMBH.

new

Finance::Bank::Norisbank->new('1234567890', '12345');

Connects to the given account number, using the given PIN.

Norisbank account numbers are ten digits, and PINs are five digits. Remember that even though account numbers and PINs look like numbers, they aren't numbers. Quote them as strings when they appear as literals in code, or the account number will become a float and lose precesion on the right, or lose insignificant zeros on the left.

FIXME: More idiomatic interface.

Automatically logs in to check if the account information is valid.

Returns the object on success, or dies on failure.

get_transactions

$account->get_transactions($datefrom, $dateto);

Gets all transactions that occoured (bank_date) between datefrom and dateto, which should be time_ts (that is, standard unix-ish timestamps). For your convience, 0 is defined as the current date when used as dateto, and 100 days prior to dateto when used as datefrom.

Note that both ends are rounded to day resolution -- the from date is rounded down to midnight at the beginning of the day, and to to midnight at the end of the day. This means that the range used will always completely enclose, but may exceed, the range asked for.

(This means that $account-get_transactions()> gets transactions from 100 days ago through today.)

FIXME: Make the next paragraph true.

The return in list context is a list of Finance::Bank::Transactions::DE objects, least recent first. If there is an error fetching the information, the method will signal an exception (die). Return in scalar context is not defined, and subject to change without notice.

blz

$account->blz
Finance::Bank::Norisbank::->blz
$account->BLZ
Finance::Bank::Norisbank::->BLZ

Returns the Bankleihtzahl (sort code) of the bank.

iban

$account->iban
$account->IBAN

Returns the IBAN (International Bank Account Number) for this account.

swift

$account->swift
Finance::Bank::Norisbank::->swift

Returns the SWIFT-BIC (Society for Worldwide Interbank Financial Telecommunications - Bank Identification Code) of Norisbank. This is aliased to SWIFT as well. (This returns the part of the SWIFT code that is the same for all Norisbank branches.)

AUTHOR

James Mastros, <james@mastros.biz>. theorbtwo on perlmonks.org.

BUGS

Known bugs: we aren't always able to get the verwindungszweck from the bank. This is because Norisbank's online banking is highly obnixious. Working code to fix this is very much welcome.

The grok_* routines are based on guesswork. If you think you have them figured out, or you think there is an error in my interpretation of them, please let me know. If you find a standard for them, please, please, please let me know.

The best place to tell me about bugs or feature requests is probably on rt.cpan.org.