1 package FS::bill_batch;
4 use vars qw( @ISA $me $DEBUG );
7 use FS::Record qw( qsearch qsearchs dbh );
9 use FS::cust_bill_batch;
11 @ISA = qw( FS::Record );
12 $me = '[ FS::bill_batch ]';
15 sub table { 'bill_batch' }
17 sub nohistory_fields { 'pdf' }
21 FS::bill_batch - Object methods for bill_batch records
27 $open_batch = FS::bill_batch->get_open_batch;
29 my $pdf = $open_batch->print_pdf;
31 $error = $open_batch->close;
35 An FS::bill_batch object represents a batch of invoices. FS::bill_batch
36 inherits from FS::Record. The following fields are currently supported:
40 =item batchnum - primary key
42 =item agentnum - empty for global batches or agent (see L<FS::agent>)
44 =item status - either 'O' (open) or 'R' (resolved/closed).
46 =item pdf - blob field for temporarily storing the invoice as a PDF.
56 Typeset the entire batch as a PDF file. Returns the PDF as a string.
63 $job->update_statustext(0) if $job;
64 my @invoices = sort { $a->invnum <=> $b->invnum }
65 qsearch('cust_bill_batch', { batchnum => $self->batchnum });
66 return "No invoices in batch ".$self->batchnum.'.' if !@invoices;
68 my $duplex = FS::Conf->exists('invoice_print_pdf-duplex');
72 foreach my $invoice (@invoices) {
73 my $part = $invoice->cust_bill->print_pdf({$invoice->options});
74 die 'Failed creating PDF from invoice '.$invoice->invnum.'\n' if !$part;
77 $pdf_out->appendPDF(CAM::PDF->new($part));
80 $pdf_out = CAM::PDF->new($part);
83 my $n = $pdf_out->numPages;
85 # then insert a blank page so we end on an even number
86 $pdf_out->duplicatePage($n, 1);
92 my $error = $job->update_statustext(int(100 * $num/scalar(@invoices)));
96 $job->update_statustext(100, 'Combining invoices') if $job;
98 return $pdf_out->toPDF;
103 Set the status of the batch to 'R' (resolved).
110 return $self->replace;
117 $self->ut_numbern('batchnum')
118 || $self->ut_foreign_keyn('agentnum', 'agent', 'agentnum')
119 || $self->ut_enum('status', [ 'O', 'R' ] )
121 return $error if $error;
128 Returns the agent (see L<FS::agent>) for this invoice batch.
134 qsearchs( 'agent', { 'agentnum' => $self->agentnum } );
141 =item process_print_pdf
149 sub process_print_pdf {
151 my $param = thaw(decode_base64(shift));
152 warn Dumper($param) if $DEBUG;
153 die "no batchnum specified!\n" if ! exists($param->{batchnum});
154 my $batch = FS::bill_batch->by_key($param->{batchnum});
155 die "batch '$param->{batchnum}' not found!\n" if !$batch;
157 if ( $param->{'close'} ) {
158 my $error = $batch->close;
159 die $error if $error;
162 my $pdf = $batch->print_pdf($job);
164 my $error = $batch->replace;
165 die $error if $error;
174 L<FS::Record>, schema.html from the base documentation.