Freeside:1.9:Documentation:Developer/FS/cust credit

From Freeside
< Freeside:1.9:Documentation:Developer‎ | FS
Revision as of 17:23, 3 October 2007 by Ivan (talk | contribs) (import from POD)

Jump to: navigation, search

NAME

FS::cust_credit - Object methods for cust_credit records

SYNOPSIS

 use FS::cust_credit;

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

 $error = $record->insert;

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

 $error = $record->delete;

 $error = $record->check;

DESCRIPTION

An FS::cust_credit object represents a credit; the equivalent of a negative cust_bill record (see FS::cust_bill). FS::cust_credit inherits from FS::Record. The following fields are currently supported:

crednum - primary key (assigned automatically for new credits); custnum - customer (see FS::cust_main); amount - amount of the credit; _date - specified as a UNIX timestamp; see "time" in perlfunc|perlfunc#time|"time" in perlfunc. Also see Time::Local and Date::Parse for conversion functions.; otaker - order taker (assigned automatically, see FS::UID); reason - text; closed - books closed flag, empty or `Y'

METHODS

new HASHREF
Creates a new credit. To add the credit to the database, see "insert".
insert
Adds this credit to the database ("Posts" the credit). If there is an error, returns the error, otherwise returns false.
delete
Unless the closed flag is set, deletes this credit and all associated applications (see FS::cust_credit_bill). In most cases, you want to use the void method instead to leave a record of the deleted credit.
replace OLD_RECORD
You can, but probably shouldn't modify credits...
check
Checks all fields to make sure this is a valid credit. If there is an error, returns the error, otherwise returns false. Called by the insert and replace methods.
cust_refund
Depreciated. See the cust_credit_refund method.
  1. Returns all refunds (see FS::cust_refund) for this credit.
cust_credit_refund
Returns all refund applications (see FS::cust_credit_refund) for this credit.
cust_credit_bill
Returns all application to invoices (see FS::cust_credit_bill) for this credit.
credited
Returns the amount of this credit that is still outstanding; which is amount minus all refund applications (see FS::cust_credit_refund) and applications to invoices (see FS::cust_credit_bill).
cust_main
Returns the customer (see FS::cust_main) for this credit.

CLASS METHODS

credited_sql
Returns an SQL fragment to retreive the unapplied amount.

BUGS

The delete method. The replace method.

credited and credited_sql should probably be called unapplied and unapplied_sql.

SEE ALSO

FS::Record, FS::cust_credit_refund, FS::cust_refund, FS::cust_credit_bill FS::cust_bill, schema.html from the base documentation.