Company Settings
| Key | Default Value | Notes | Inheritable | Since Version |
|---|---|---|---|---|
| admin_view_dir | default | The view directory for the admin interface | YES | 4.9 |
| apply_inv_late_fees | 7 | The number of days after an invoice has gone unpaid before adding a late fee. | YES | 4.10 |
| auto_apply_credits | true | Enables available client credits to be applied to open invoices automatically | YES | |
| auto_paid_pending_services | true | Enables available paid pending services to be provisioned automatically | YES | |
| autodebit | true | Enables autodebiting of a client when payment is due | YES | |
| autodebit_attempts | 3 | The number of attempts and failures to process a payment account before that payment account is disabled from being automatically debited. | YES | |
| autodebit_days_before_due | 1 | The number of days before a payment is due when an attempt will be made to autodebit the account for said payment | YES | |
| autosuspend | true | Enables auto suspension of a client for non-payment | YES | |
| calendar_begins | sunday | The first day of the week for the calendar | YES | |
| cancel_service_changes_days | 7 | The number of days after a queued service change (e.g. upgrade) has been unpaid at which time it will be canceled and the associated invoice voided | YES | 3.5 |
| cancelation_fee_tax | false | Enables cancelation fees to be taxable | YES | |
| cascade_tax | false | Enables tax on tax | YES | |
| client_change_service_package | false | Offers clients the choice to change their service to a different package belonging to the same package group and module | YES | 3.3 |
| client_change_service_term | false | Offers clients the choice to change the pricing term of their services | YES | 3.3 |
| client_create_addons | true | Offers clients the ability to create addons for existing services | YES | 3.2 |
| client_prorate_credits | false | Enables prorated credits for services, or service configurable options, that are downgraded | YES | 3.5 |
| client_set_currency | false | Offers clients the choice to set their own default currency | YES | |
| client_set_invoice | true | Offers clients the choice to set their preferred invoice method | YES | |
| client_set_lang | true | Offers clients the choice to set their preferred language | YES | |
| client_view_dir | bootstrap | The view directory for the client interface | YES | |
| clients_cancel_services | false | Offers clients the choice to cancel their services | YES | |
| clients_format | {num} | The format of client IDs | YES | |
| clients_increment | 1 | YES | ||
| clients_pad_size | 0 | YES | ||
| clients_pad_str | 0 | YES | ||
| clients_start | 1500 | The first client ID number to begin with | YES | |
| country | US | The 2-character country code | YES | |
| date_format | M d, Y | The format for dates | YES | |
| datetime_format | M d, Y g:i:s A | The format for date and time | YES | |
| default_currency | USD | The 3-character currency code to use as default | YES | |
| delivery_methods | The delivery methods enabled for this company | YES | ||
| email_verification | false | Whether to send an email verification email when a new login is created or a client changes their email address. A notice will appear on the clients profile until they are verified. | YES | 4.12 |
| enable_tax | false | Enables tax to be calculated in the system | YES | |
| exchange_rates_auto_update | false | Enables currency exchange rates to automatically update periodically | YES | |
| exchange_rates_padding | 3 | The percentage value to pad exchange rate calculations with | YES | |
| exchange_rates_processor | The exchange rate processor to use to retrieve exchange rates | YES | ||
| exchange_rates_processor_key | The exchange rate processor API key to use when retrieving exchange rates | YES | 4.2 | |
| html_email | true | Enables email to be delivered in HTML | YES | |
| interfax_password | The password for the Interfax account | YES | ||
| interfax_username | The username for the Interfax account | YES | ||
| inv_background | The full path to the invoice background image | YES | ||
| inv_days_before_renewal | 5 | The number of days before a service renews when a new invoice is to be generated | YES | |
| inv_display_companyinfo | true | Enables company address info to be displayed on invoices | YES | |
| inv_display_due_date_draft | true | Enables due dates to be displayed on draft invoices | YES | 3.5 |
| inv_display_due_date_proforma | true | Enables due dates to be displayed on pro forma invoices | YES | 3.5 |
| inv_display_due_date_inv | true | Enables due dates to be displayed on standard invoices | YES | 3.5 |
| inv_display_logo | true | Enables company logo to be displayed on invoices | YES | |
| inv_display_paid_watermark | true | Enables a paid watermark to be display on invoices | YES | |
| inv_display_payments | true | Enables payments and credits to be displayed in a new table on invoices | YES | 3.4 |
| inv_draft_format | DRAFT-{num} | The format of draft invoice IDs | YES | |
| inv_format | {num} | The format of invoice IDs | YES | |
| inv_group_services | true | Creates a single invoice for services that renew on the same day for a client, or (if false) a separate invoice for each service. | YES | 3.6 |
| inv_increment | 1 | The increment step for the number set for invoice IDs | YES | |
| inv_logo | The full path to the invoice logo image | YES | ||
| inv_method | The primary method to use to deliver invoices | YES | ||
| inv_mimetype | application/pdf | The Mime-Type of the file that the invoice is created for | YES | |
| inv_pad_size | 0 | The padding character-length to use for invoice ID numbers | YES | |
| inv_pad_str | 0 | The string to pad the auto-incrementing invoice ID numbers with | YES | |
| inv_paper_size | letter | The paper size of the invoice | YES | |
| inv_proforma_start | 1 | The first proforma invoice ID number to begin with | YES | 3.3 |
| inv_proforma_format | PROFORMA-{num} | The format of proforma invoice IDs | YES | 3.3 |
| inv_start | 1 | The first invoice ID number to begin with | YES | |
| inv_suspended_services | true | Enables suspendend services to continue to be invoiced | YES | |
| inv_template | default_invoice | The template to use for generating invoices | YES | 3.3 |
| inv_terms_* | info inv_terms have changed In v4.5.0, the inv_terms key no longer exists. It is replaced by inv_terms_ followed by the language code, e.g. inv_terms_en_usThe Terms to display on the invoice.The inv_terms key has been replaced by additional keys including the language code, e.g. inv_terms_en_us or inv_terms_de_de for English and German languages, respectively, based on the available installed languages. | YES | ||
| inv_type | standard | The invoice type (standard or proforma) | YES | 3.3 |
| language | en_us | The default language | YES | |
| late_fee_total_amount | true | Whether or not if the late fee is applied to the total amount of the invoice or only to the unpaid balance. | YES | 4.10 |
| late_fees | The late fees enabled for this company. | YES | 4.10 | |
| mail_delivery | php | The method with which to send email | YES | |
| multi_currency_pricing | package | The pricing scheme to use when evaluating multi-currency prices | YES | |
| notice_pending_autodebit | 1 | The number of days before an invoice is scheduled to be autodebited that the Auto-Debit Pending notice should be sent. | YES | |
| notice1 | -1 | The number of days after an invoice has gone unpaid before sending the first late notice | YES | |
| notice2 | 3 | The number of days after an invoice has gone unpaid before sending the second late notice | YES | |
| notice3 | 7 | The number of days after an invoice has gone unpaid before sending the third late notice | YES | |
| packages_increment | 1 | The package id increment value | YES | |
| packages_pad_size | 0 | The packages padding size | YES | |
| packages_pad_str | 0 | The packages padding character | YES | |
| packages_start | 1 | The package start id | YES | |
| payments_allowed_ach | true | Enables ACH payments to be processed through gateways and be added to payment accounts | YES | |
| payments_allowed_cc | true | Enables credit card payments to be processed through gateways and be added to payment accounts | YES | |
| postalmethods_apikey | The API Key required to make requests with PostalMethods | YES | ||
| postalmethods_replyenvelope | false | Whether or not to include a reply envelope with the mailed letter | YES | |
| postalmethods_testmode | true | Enables test mode for the PostalMethods account | YES | |
| prevent_unverified_payments | false | Whether to allow payments from clients with an unverified email address | YES | 4.12 |
| private_key | The private key used for decryption | YES | ||
| private_key_passphrase | The private key passphrase to set in order to decrypt | YES | ||
| process_paid_service_changes | false | Whether or not service changes (e.g. upgrades) should be queued and processed only after the associated invoice has been paid | YES | 3.5 |
| public_key | The public key used for encryption | YES | ||
| receive_email_marketing | false | Whether or not clients may receive marketing emails | YES | 4.3 |
| required_contact_fields | The optional contact fields that are required for creating/updating contacts | YES | 4.1 | |
| send_payment_notices | true | Whether or not clients can be sent any of the Payment Due Notices | YES | 3.4 |
| services_format | {num} | The format of service IDs | YES | |
| services_increment | 1 | The increment step for the number set for service IDs | YES | |
| services_pad_size | 0 | The padding character-length to use for service ID numbers | YES | |
| services_pad_str | 0 | The string to pad the auto-incrementing service ID numbers with | YES | |
| services_start | 1 | The first service ID number to begin with | YES | |
| setup_fee_tax | false | Enables setup fees to be taxable | YES | |
| show_client_tax_id | true | Whether or not the Tax ID field is shown in the client interface | YES | 3.4 |
| show_currency_code | false | Enables currency codes to be shown next to currency values | YES | |
| show_receive_email_marketing | true | Whether or not the 'receive_email_marketing' setting is shown in the client interface | YES | 4.3 |
| smtp_host | The SMTP hostname to a mail server | YES | ||
| smtp_password | The SMTP password to a mail server | YES | ||
| smtp_port | 465 | The SMTP port to connect to a mail server on | YES | |
| smtp_security | ssl | The SMTP protocol to use. | YES | |
| smtp_user | The SMTP username to a mail server | YES | ||
| suspend_services_days_after_due | 7 | The number of days after a service is overdue and unpaid when it will be suspended. | YES | |
| synchronize_addons | true | Whether or not addon/child services should be set to the same renew date as their parent when they are created. In such cases, the price of the addon would be prorated based on the new renew date. | YES | 4.3 |
| tax_exempt | false | Enables a client to be tax-exempt | YES | |
| tax_id | The Tax ID/VATIN number | NO | ||
| theme_admin | 1 | The ID of the theme to use for the admin interface | YES | |
| theme_client | 12 | The ID of the theme to use for the client interface | YES | |
| timezone | America/Los_Angeles | The timezone to use for the system | YES | |
| unique_contact_emails | Sets a restriction on whether email addresses of contacts must be unique. Values may be primary or all. A value of all will require all contacts have unique email addresses, while a value of primary will require that only primary contacts (i.e. clients) have unique email addresses. No email restriction is imposed otherwise. | YES | 4.6 | |
| void_invoice_canceled_service | true | Whether to void invoices for a service when it is cancelled | YES | 4.0 |
| void_inv_canceled_service_days | any | Select the number of days after the invoice is due that it can be automatically voided. | YES | 4.6 |