OpenBravo Documentation

Software Requirements
MySQL Backend (Can install Xampp server for it) JRE (Java Runtime Environment)

Installation Instructions
This installation has been performed in Windows XP environment. So for different operating system you need to get your own Xampp server and JRE installation files compatible with your OS.

Installation of Xampp server
Double click the Xampp server installation file to launch the installer. I am using the xampp-win32-1.6.7-installer.exe version for this documentation. It will open up a wizard with the installation instructions. Follow the installation instruction.

Figure 1: Xampp installer wizard

After the installation you will end up with a Desktop shortcut for the Xampp control panel. Double click the icon to launch the Xampp control panel. Then start the MySQL server from the panel.

It will result in a wizard with the installation instructions. Installation of JRE (Java Runtime Environment) Double click the executable to launch the JRE installer. I am using openbravo for this case. However I am following the default installation.Figure 2: Launching the MySQL server from the Xampp control panel Now we need to create a database for our OpenBravo application. Follow the instructions on your screen to complete the installation . You can customize the installation process if you desire. Create a database with any name of your choice.

.bat Double click the openbravo.bat file to lauch the OpenBravo software. It will end up with two files 1) openbravo folder 2) openbravo.zip file at your suitable location.Figure 3: JRE installer wizard Installation of Openbravo Unzip the openbravo.

So click the No option for now. So we need to configure it first. By default OpenBravo uses derby database. . However in our case we are using MySQL.Figure 4: After launching OpenBravo application first time We haven't configured the database yet. It will lauch the configuration window for the OpenBravo application given below.

. It is available in the openbravo/lib folder obtained after extracting the zip previously. I am using mysqlconnector-java-5.7-bin. Browse to the path to select the driver.1.Figure 5: OpenBravo configuration screen First we have to give the path to our MySQL driver for JDBC.jar in my case.

.jdbc. Set Driver class as com.Figure 6: Configuring MySQL driver for JDBC path Further fix the driver class and url path.mysql.Driver Set url to jdbc:mysql://localhost:3306/openbravo (jdbc:mysql://server:port/databasename) Set the username and password for the database connection Click on Save button to save the configuration. We are using it now. Remember we have created the openbravo database in MySQL previously.

Figure 8: After restarting the openbravo application .Figure 7: After full MySQL configuration Restart the OpenBravo application.

Click on Yes button to create the database schema. After it has successfully installed the database tables it will launch the OpenBravo application as shown below Figure 9: OpenBravo This ends the installation of OpenBravo application at the server side. . Note: For the client side we don't need to create any database. Just set the MySQL configuration with proper database parameters and driver path and launch the application.

In case you set the database parameters incorrectly then it may result in an error given below which means that the application couldn't connect to the database given. Figure 10: Database connection problem Also make sure that the server allows MySQL connection from a remote computer in the LAN. .

Login in to the Administrator dashboard. Figure 11: Default Four Users of OpenBravo Creating a new user Only administrator is allowed to create a new user.Usage Manual By default there are four user roles in OpenBravo with proper access control for each role ● ● ● ● Administrator Manager Employee Guest Four users are created by default with the corresponding four roles. .

Go to Administration >> Maintenance Figure 12: Administrator Dashboard Click Users option Click on New Button Fill in the user data Click on Save Button .

Figure 13: Creating a new user Counter1 with Employee role Creating a new Role Go to the Administration >> Maintenance option Click the Roles option and then add a role with proper permissions Save the new role created .

Figure 14: Creating a new user role Creating a new Warehouse By default OpenBravo has just one warehouse. General Go to the Administrator Dashboard Go to Administration >> Maintenance option Click on New Button Click the Warehouse option and then add a warehouse Save the new warehouse created .

Click on new button and fill up the required fields for the new product. Go to Administration >> Stock option Click on Products option.Figure 14: Creating a new warehouse Creating a new Product Go to the Administrator Dashboard. Note that some fields are mandatory. Save the new product .

buying price. size. color and location . selling price. category. It allows to filter products by barcode. name.Figure 14: Creating a new product Searching for a specific product OpenBravo provides a Search or filter feature that will help you to locate the product of your choice.

Figure 15: Before search Suppose we have three products initially as shown in the figure above. Choose the filter options and you will get the filtered results. Lets filter the products by name. . Consider a particular condition that we want products with name equal to shirt. Now we can filter the products.

Figure 16: After filter Adding a new category Go to Administrator panel Go to Administration >> Stock option Click on Categories option Click on New Button Fill in the new category data and Save it .

Save the stock data by using the Number keys utility .Figure 17: Adding a new category Stock Maintenance Go to Administrator Panel Go to Administration >> Stock option Click on Stock Maintenance option Choose the products that you want to add stock of. Add the stock amount by using the Number keys utility Choose other options like the warehouse where you want to add the stock.

Click on Tax categories. Click on New button.Figure 18: Stock maintenance form Adding a new Tax Category Go to Administration >> Stock option. Give the new tax category name Click on Save button .

Figure 19: Adding a new tax category Setting the new tax category rate Go to Administration >> Stock option Click on Tax option Click on New button Fill in the required form data Click on Save button .

Figure 20: Setting new tax category rate Adding a new customer Go to Administration >> Customers option Click on Customers button Click on New button Fill in the customer data Click on Save Button .

Figure 21: Customer Addition form Adding new Sales data Go to Main >> Sales Select the products that you want to sell Use the Number keys utility to add the number of products to be sold Then click on the = button on the Number keys utility to generate the payment option Choose the preferable payment option Press the OK button to finish the sale process. .

Figure 22: Sales form Adding external payment information OpenBravo allows you to add in or out payments not related to purchasing products. For this: Go to Main >> Payments Fill the payment data Save the data .

Go to Main >> Close Cash Click on Close Cash A message box will appear and will ask you if you are sure.Figure 23: Payments Close cash Closing cash allows you to see the sales of the day and print a report for the day's sales. Click yes. .

Figure 24: Closing Cash .

Figure 25: Choosing payment option Generating reports Openbravo allows you to generate reports regarding sales. inventory. products. For example lets generate the report of the products. . Go to Administration >> Stock options.customers etc.

openbravo.com/wiki/Category:User_Documentation_POS for further details .Click on Products option under the Reports Select the filter parameters you want Click on Execute Report and it will display the products report Figure 26: Products report Visit http://wiki.