Difference between revisions of "Freeside:1.9:Documentation:Developer/FS/cust main invoice"
From Freeside
(import from POD) |
(import from POD) |
||
Line 25: | Line 25: | ||
==METHODS== | ==METHODS== | ||
; new HASHREF | ; new HASHREF | ||
− | :Creates a new invoice destination. To add the invoice destination to the database, see [[ | + | :Creates a new invoice destination. To add the invoice destination to the database, see [[#insert|"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. | :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. |
Revision as of 17:24, 3 October 2007
Contents
NAME
FS::cust_main_invoice - Object methods for cust_main_invoice records
SYNOPSIS
use FS::cust_main_invoice; $record = new FS::cust_main_invoice \%hash; $record = new FS::cust_main_invoice { 'column' => 'value' }; $error = $record->insert; $error = $new_record->replace($old_record); $error = $record->delete; $error = $record->check; $email_address = $record->address;
DESCRIPTION
An FS::cust_main_invoice object represents an invoice destination. FS::cust_main_invoice inherits from FS::Record. The following fields are currently supported:
- destnum - primary key; custnum - customer (see FS::cust_main); dest - Invoice destination: If numeric, a svcnum (see FS::svc_acct), if string, a literal email address, `POST' to enable mailing (the default if no cust_main_invoice records exist), or `FAX' to enable faxing via a HylaFAX server.
METHODS
- new HASHREF
- Creates a new invoice destination. To add the invoice destination 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 invoice destination. If there is an error, returns the error, otherwise returns false. Called by the insert and replace methods.
- checkdest
- Checks the dest field only.
- If it finds that the account ends in the #same domain configured as the domain configuration file, it will change the #invoice destination from an email address to a service number (see #FS::svc_acct).
- address
- Returns the literal email address for this record (or `POST' or `FAX').