Difference between revisions of "Freeside:1.9:Documentation:Developer/FS/cust bill event"

Revision as of 18:09, 3 October 2007

NAME

FS::cust_bill_event - Object methods for cust_bill_event records

SYNOPSIS

 use FS::cust_bill_event;

 $record = new FS::cust_bill_event \%hash;
 $record = new FS::cust_bill_event { 'column' => 'value' };

 $error = $record->insert;

 $error = $new_record->replace($old_record);

 $error = $record->delete;

 $error = $record->check;

DESCRIPTION

An FS::cust_bill_event object represents an complete invoice event. FS::cust_bill_event inherits from FS::Record. The following fields are currently supported:

eventnum - primary key; invnum - invoice (see FS::cust_bill); eventpart - event definition (see FS::part_bill_event); _date - specified as a UNIX timestamp; see "time" in perlfunc. Also see Time::Local and Date::Parse for conversion functions.; status - event status: done or failed; statustext - additional status detail (i.e. error message)

METHODS

new HASHREF

Creates a new completed invoice event. To add the compelted invoice event to the database, see "insert".

Note that this stores the hash reference, not a distinct copy of the hash it points to. You can ask the object for a copy with the hash method.

insert

Adds this record to the database. If there is an error, returns the error, otherwise returns false.

delete

Delete this record from the database.

replace OLD_RECORD

Replaces the OLD_RECORD with this one in the database. If there is an error, returns the error, otherwise returns false.

check

Checks all fields to make sure this is a valid completed invoice event. If there is an error, returns the error, otherwise returns false. Called by the insert and replace methods.

part_bill_event

Returns the invoice event definition (see FS::part_bill_event) for this completed invoice event.

cust_bill

Returns the invoice (see FS::cust_bill) for this completed invoice event.

retry

Changes the status of this event from done to failed, allowing it to be retried.

retryable

Changes the statustext of this event to retriable, rendering it retriable (should retry be called).

SUBROUTINES

reprint; reemail; refax

BUGS

Far too early in the morning.

SEE ALSO

FS::part_bill_event, FS::cust_bill, FS::Record, schema.html from the base documentation.