updated as of: March 30, 2015
last author: Andy Theuninck
The latest documentation can be found on the Project Wiki. The information below may be out of date.
The install process creates a skeleton database. This guide will take you through the minimaly required data population. In the process, you'll walk through a few basic tools.


IS4C and Fannie are designed around co-ops, so the idea of membership is integral. Every transaction must be associated with a member. To start, we're going to create a new membership type and at least one member.
  1. Choose Admin => Member Management from fannie's left-hand menu, then Manage Member Types
    1. Click create a new member type. Assign a different ID number if you'd like, then click Create New Type
    2. Optionally, you can now edit the type your just created.
      • Description is used primarily for reporting purposes
      • The member check box denotes whether this type of member should receive member-related benefits. If you sell to non-members, it's useful to have a default account number to associate with those sales (again, every transaction must be associated with a "member").
      • Discount is a percentage discount applied to an entire transaction. Use integer numbers - i.e., 10% = 10, not 0.10.
      • Staff denotes an employee. Mostly for reporting currently.
      • SSI is historically for senior citizens. I don't think it does anything any more
  2. Return to Admin => Member Management and this time choose Create New Members.


The other people involved in a transaction are cashiers. You need at least one cashier to login and run a live transaction (a testing cashier, 9999, is built in if you're only doing test transactions).
  1. Select Admin => Cashier Management from fannie's left hand menu, then Add a new cashier.
  2. Specify a first and/or last name (note: this shows up on screen at the checkouts, so using full names is a bad idea from a staff privacy standpoint).
  3. Select privileges. The only current difference is a Manager can override anyone's login (including another manager's). If someone leaves a screen locked, forgets to sign out, or otherwise puts a lane in a weird, unworkable state, manager-level accounts will still work.
  4. If you want to change the automatically-generated password, return to Admin => Cashier Management and choose the other option, View/edit cashiers.


Tenders are the various forms of payments your store accepts. The simplest option is to load up the defaults provided. You can remove ones you don't want later.
  1. Go to the fannie configuration page (http://your-server/fannie/install/) and click the Sample Data link at the top.
  2. Click the Load default tenders
  3. button.
To make adjustments to your tenders, select Admin => Tenders from fannie's left hand menu. Options are as follows: Options to add and remove tenders are at the bottom of the page.

Tax Rates

This doesn't have a menu entry yet, but the tools if found at http://your-server/fannie/admin/TaxRates/. A "NoTax" rate is included automatically. Add rates as decimal numbers, not percentages - e.g., 5% sales tax is 0.05.