Sebastiaan Hoogeveen > Finance-Bank-NL-CLIEOP03-0.03 > Finance::Bank::NL::CLIEOP03

Download:
Finance-Bank-NL-CLIEOP03-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: 0.03   Source  

NAME ^

Finance::Bank::NL::CLIEOP03 - Generate CLIEOP03 files for Dutch banks.

SYNOPSIS ^

 use Finance::Bank::NL::CLIEOP03;

 $c = Finance::Bank::NL::CLIEOP03->new;

 $batch = $c->batch (
   account => '1234567',
   sender_name => 'My Company',
   type => Finance::Bank::NL::CLIEOP03::T_INCASSI
 );

 $batch->add (
   amount => 25,
   account_number => '1234567',
   account_name => 'Ms. Example',
   description => 'Taking your money'
 );

 $c->write ( 'CLIEOP03' );

DESCRIPTION ^

This module allows for easy creation of CLIEOP03 batch transaction files which can be processed by Dutch banks. CLIEOP03 files can be used for automatic debiting ("automatische incasso") or batch transfers ("verzamelgiro"). You must have a business bank account and (usually) an additional agreement with your bank for using this.

DISCLAIMER ^

This module is provided as-is. Due to the nature of this module you should check for yourself that it does its work correctly, e.g. by auditing the source code and checking the generated files.

METHODS ^

Finance::Bank::NL::CLIEOP03

new

 $c = Finance::Bank::NL::CLIEOP03->new (
  sender_id => 'CMPNY'
 );

Create a new CLIEOP03 file. The following parameter can be specified:

batch

 $b = $c->batch (
   account => '1234567',
   fixed_description => 'Costs for your hosting',
   sender_name => 'Hosting Corporation',
   type => Finance::Bank::NL::CLIEOP03::T_INCASSI
 )

Add a batch to the specified CLIEOP03 file. The batch is returned as a reference to a Finance::Bank::NL::CLIEOP03::Batch object. The following parameters can be specified:

as_string

 $s = $c->as_string;

Return the CLIEOP03 file as a single string, containing the records specified by a \r\n pair.

write

 $c->write ( 'CLIEOP03' );

Write the CLIEOP03 file to the filename specified.

head2 Finance::Bank::NL::CLIEOP03::Batch

add

Add a transaction to the current batch. This method is a frontend for add_betaling and add_incasso, and will select which method to be eventually executed based on the type of the current batch. Note that it is not possible to add transactions of a different type to a batch.

add_incasso

 $batch->add_incasso (
   account_number => '1234556789',
   amount => 10.00,
   description => 'Customer 1234',
   identifier => 6435893353335
 );

For payments in a batch of type T_INCASSI the following parameters can be specified:

CAVEATS ^

This module currently only supports the T_INCASSI transaction type.

Please note the version number; this module has not yet been extensively tested. However, since implementing CLIEOP03 is both tedious and boring, I thought I should make this module available ASAP.

AUTHOR ^

Sebastiaan Hoogeveen <pause-zebaz@nederhost.nl>

COPYRIGHT ^

Copyright (c) 2007 Sebastiaan Hoogeveen. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html

syntax highlighting: