This section enumerates the “System” menu’s immediate children. In some cases the functionality is too complex and is referred to a chapter of its own.
This is a Yes/No value which affects the actions which can be performed on posted financial transactions.
No means transactions can be altered or deleted, even after posting them. Note that if a transaction has been posted before the latest closing date, it can never be altered, not even when this value is in effect.
Yes means transactions can’t be altered after posting. This setting is highly preferred and considered the only correct approach to accounting as it assures visible audit trails and thereby supports fraud detection.
@@@ This item isn’t a system setting; shouldn’t it move to “Transaction approval”?? That way system settings (config) and processes are separated.
@@@ My preference is to remove the setting entirely and rely on year-end workflow. We might add an account checkpoint interface as well at some point –Chris T
It’s advisable to regularly close the books after review. This prevents user error changing reviewed numbers: after closing the books, it’s no longer possible to post in the closed period.
There are also performance benefits to closing the books, because LedgerSMB uses the fact that the figures are known-stable as a performance optimization when calculating account balances.
This is a Yes/No value which - when Yes - causes the system to install triggers to register user actions (creation/adjustments/reversals/etc…) executed on financial transactions.
@@@ Once activated, where can we see it the audit trail??
@@@ This setting should go. In 1.3 the audit trails are always enforced via triggers so this setting does nothing. –CT
This page lists all accounts which have the “Tax” account option enabled as discussed in Section 26.2.1 on page 26.2.1.
Each account is listed at least once, but can be listed many times, if it has had different settings applied over different time periods. E.g. if one of the current VAT rates is 19%, today but it used to be 17.5% until last month, there will be 2 rows for the applicable VAT account. See Chapter 27 starting at page 27 for further discussion of how taxes work in LedgerSMB and the choices involved when being required to handle changes in tax rates.
Each row lists the following fields:
The tax rate to be applied when calculating VAT to be posted on this account.
Account number
The ending date of the settings in this row. This can apply to the rate as well as the ordering or the tax rules (but usually applies to the rate).
This has to do with cumulative taxes. For example if two taxes exist and one has an ordering of 0 and one of 1, then the second tax will be calculated on a basis that includes the first. One place where this used to be used was in Quebec, where GST was taxable under PST.
This is used to store an arbitrary identification number for the business. It could be used to store a business license number or anything similar.
The unit of measurement for weights. @@@ why don’t we have a unit of measurement for distance as well??? And maybe a unit of measurement for content?
Separation of duties is a method to help reduce fraud where one employee can’t modify the accounting ledger without another employee’s approval.
Select ”Yes” if you want to activate separation of duties or ”No” if you don’t want to activate it.
In order for separation of duties to be enforced, user roles have to be set differently for each user. This is done by removing the draft_post role from the users that cannot post and making sure that the users that can post have the role enabled. See Section 24.3 on page 24.3 for more details about changing and setting User Roles.
This setting will be used to preselect an account in the listings of the three categories listed below:
Inventory
Income
Expense
When working with foreign currencies, the system needs two special purpose accounts. One to post the gains onto which are caused by foreign currencies increasing in value; the other to post the losses onto which are caused by foreign currencies decreasing in value.
This setting indicates which country needs to be pre-selected in country selection lists.
The language to be used when no other language has been selected. Several parts of the application require language selection, such as customer, vendor and employee entry screens.
This setting indicates which set of templates - stored in the templates/ directory - should be used. In a standard installation, the drop down lists two items:
which contains templates based on LATEX, which is more commonly installed but has issues dealing with accented characters
Enter a list of all currencies you want to use in your company, identified by their 3-letter codes separated by a colon; i.e. “USD:EUR:CHF”. To ensure correct operation of the application, at least one currency (the company default currency) must be listed. In case of multiple currencies the first is used as the company default currency.
The fields “Company Name”, “Company Address”, “Company Phone” and “Company Fax” will be used on printed/e-mailed invoices.
This is an integer value field measuring the validity period in days for passwords set through the user’s Preferences screen. If this field is empty, passwords set through that method won’t expire.
A user will receive password expiration reminders upon logging starting a week before password expiry. When not acted upon, starting two days before expiry an hourly popup will appear requesting the user to change the password.
The application behaves this way because users with expired passwords won’t be able to log in: their password will need to be reset by a user admin.
Note that passwords set by admins for other users expire within 24 hours after setting them. This value is hard coded and can’t be overruled. This is a security measure taken to make sure as few unused accounts as possible exist: Existence of such accounts could open up security holes.
These addresses will be used to send e-mails from the system. Note that the “Default Email From” address should be configured in order to make sure e-mail doesn’t look like it’s coming from your webserver. The format to be used is ‘‘Name’’ <e-mail address> where the e-mail address should be inserted between the “” and “”.
Some elements in the screens may present a drop down. However, drop downs are relatively unwieldy to work with when used to present a large number of values to choose from.
This configuration option sets an upper limit on the number of records to be presented as drop down. When the number is exceeded, no drop down is used. Instead, a multi-step selection procedure will be used.
Many items in the system have sequence numbers: invoices, parts, etc. These can be just a number (i.e. 1 or 37) or they can also be both prefixed and suffixed. For example, INV0001 for invoices and EMP001 for employees or YOU-0001TOO, in which case the next item will be YOU-0002TOO.
You can only issue every number in the sequence once, but you can issue Y21-001 and Y22-001 by changing the sequence number format at the beginning of the year.
The numbers shown in the input boxes will be used to generate the next number in the numbering sequence.
The default reference number for the next GL transaction.
This number is used to generate an invoice number when none is being filled out by the user.
Same as Sales invoice number, except that it’s used for sales orders @@@ layout issue: the label is too big to fit on the page
Same as Sales invoice, except that the number is used for accounts payable transactions. @@@ layout issue: the label is too big to fit on the page
Same as sales order number, except that it’s used for quotations.
Request for quotation number is like the sales quotation number, except that it is used to track which vendors have been asked for quotes.
All parts, services and assemblies are identified by a unique number. When an item is created and no number is entered by the user, a number is generated from this sequence.
Used when creating new projects.
Same as the sales invoice number, used by new employee entry.
@@@ is this the control code number? or is this meta_number?? – Meta-number (CT)
@@@ same question as customer number
The prefix to use when printing checks. There’s no check sequence number. That sequence number is requested from the check printing interface, because checks can be created outside the application as well, meaning the numbers can get out of sync.
@@@ Rename “Yearend” in menu interface to “Year end”.
@@@ IMO this section doesn’t belong here, because it’s a process, not config, but does it belong in this menu then? IMO it doesn’t…
@@@ Same as Year end; doesn’t belong here…
@@@ Chart of accounts isn’t exactly a “process”, but it doesn’t feel like being pure config either. At any rate it’s a fact that the CoA discussion is a full chapter in and of itself - so discussion here isn’t necessary anymore.
Warehouses are stocking locations. They don’t have any properties (in the system) other than that they have a name. Warehouses can be added, modified and deleted from the System Warehouses menu item.
Departments can be used to divide a company in smaller pieces. LedgerSMB distinguishes two types of departments:
which can be associated with any type of transaction, including AR transactions.
which can be associated with all types of transactions, except AR transactions.
Departments can be created (added), modified or deleted through the System Departments menu item.
Types of business are used in sales operations where customers can be assigned a type of business. Based on the type of business assignment, quotations, sales orders and invoices will automatically apply discount rates. For each type of business you enter a description and a discount rate to be applied.
The language table is the table users can select languages from, both to present the UI of the application as well as the setting for customers to be used to generate documents.
This listing should correspond to the actual translations of the application being available in the program installation directory.
Languages can be added, modified or deleted through the System Language menu item.
SI codes feature these three fields:
When creating a company you can assign that it an SIC code, irrespective of its role (i.e. customer, vendor, lead or anything else). An example of an SI code system is the US’s NAICS11 1 https://www.census.gov/naics/ code. Other countries have their own coding systems such as ANZSIC22 2 https://www.abs.gov.au/statistics/classifications/australian-and-new-zealand-standard-industrial-classification-anzsic/latest-release for Australia and New Zealand and NACE33 3 https://ec.europa.eu/competition/mergers/cases/index/nace_all.html for Europe
The SIC field currently doesn’t support a specific function in the application and is there merely for informational purposes. However in the future its role could be extended to include impact on reports, taxes or other functionalities where type of industry could matter.
Templates are available to control the output format of many LedgerSMB outputs including Balance Sheet, Sales Orders, etc.
There are 3 types of templates: LATEX, HTML, and CSV. Templates are accessed by navigating to System Templates. You should see the view shown in Figure 18.1 on page 18.1.
The template you want to change is selected in the ”Template” drop-down. The template format you want to change is selected in the ”Format” drop-down.
To change a LATEX template navigate to System Templates. Select, for example, Template ”Invoice” and Format ”tex”, you should see the view shown in Figure 18.2 on page 18.2
To add a file to the latex template, first upload the image file to the database. This can be accomplished by navigating to System Files.
To include this graphic file in your LATEX document, it needs to be retrieved from the database and temporarily stored in a location accessible to the PDF generator. Once the file is in the database, then the function dbfile_path handles that.
For example, If the graphic file is named ”FL_Logo_icon_250x250.png”, then add something like the following to the LATEX template using the Edit button.
\parbox[b]{.1\textwidth}{% \includegraphics[scale=0.7]{% <?lsmb dbfile_path("FL_Logo_icon_250x250.png")?>} }
After editing the template must be uploaded to the database using the Upload button.
@@@TODO Add HTML specific template info.
@@@TODO Add CSV specific template information here.