Professional Documents
Culture Documents
Important: This integration architecture is not maintained in Openbravo POS 2.30 and Openbravo ERP 2.50 . This integration architecture needs Openbravo ERP 2.20 and Openbravo POS 2.40
Contents
[hide]
1 Summary 2 Integration overview o 2.1 The Synchronize POS process o 2.2 The Synchronize Orders process 3 Openbravo ERP configuration o 3.1 Install Openbravo webservices o 3.2 Edit the external point of sales o 3.3 Add permissions to invoke the external point of sale web service 4 Openbravo POS configuration o 4.1 Configure the Openbravo webservices 5 Execute the integration actions o 5.1 Products synchronization and Orders synchronization in Openbravo POS o 5.2 Import orders in Openbravo
Summary
In an organization, more than one software application often exists to support a particular aspect of operational requirements. The result is an heterogeneous set of software applications requiring data sharing and integration. An ERP system like Openbravo ERP tries to solve this problem by offering one solution for every operational requirement. Openbravo ERP maintains one shared database for all data, integrated processes among different departments, a consistent interface for every user, and homogeneous reports/score cards that display operational data of the whole organization. However there are specific corners of an organization that an ERP system cannot solve. For example, POS systems like Openbravo POS where special user types and hardware devices support are required. The POS system user is a salesman who uses an ERP in a different manner. The interface has to be very easy to use and provide only the specific information the salesman needs. This salesman needs to operate the POS as fast as possible as his job is to sell, not to operate the POS. For example he does not want to deal with a mouse and a keyboard, rather he prefers a touch screen. In addition, the POS system needs to support a lot of POS hardware available for the real solution: receipt printers, barcode scanners, customer displays, cash drawers, scales, etc. Openbravo POS is a point of sales application designed for touch screens. And can be downloaded from Openbravo POS Downloads. This document describes the integration effort done between Openbravo ERP and Openbravo POS to integrate and work with the same set of data. This integration is based on web services and using the integration released in the Melinux Linux distribution and developed by Opentrends.
Integration overview
The focus of this integration is to create a system where Openbravo ERP is the central repository of data. Products, categories and orders are maintained and Openbravo POS has the ability to operate
with the products catalog downloaded from Openbravo ERP and to upload orders created by the sales activity of Openbravo POS. This integration has been developed with webservices. Openbravo ERP has two webservice endpoints called ExternalSales and WebService. The methods of these endpoints are called on by Openbravo POS whenever the integration is required.
getProductsPlusCatalog from ExternalSales, when invoked, downloads the product catalog from Openbravo ERP to Openbravo POS as well as the product categories taxes records and warehouse information for these products. The set of products downloaded is defined in the External Point of Sales window of Openbravo ERP. After downloading the products list, Openbravo POS checks all the products downloaded as available in the sales panel catalog. getCustomers from WebService, downloads all the customers from Openbravo ERP.
uploadOrders from ExternalSales when invoked uploads to Openbravo ERP all the sales closed in Openbravo POS that has not been previously updated. After uploaded an user of Openbravo ERP must process the imported orders in the Imp ort Orders window of Openbravo ERP. The options of the External Point of Sales window are used when processing the orders uploaded.
# ant installWebService
After installing the webservices you can see if it is properly installed opening in your web browser the page http://localhost:8000/openbravo/services /ExternalSales?wsdl and
http://localhost:8000/openbravo/services/Web Service?wsdl where localhost:8000 is the host you installed Openbravo ERP. Y ou should see an XML file that describes the services Openbravo POS uses.
Organization: selected organization in External Point of Sale window must have a location/address set. BusinessPartner: selected BusinessPartner in External Point of Sale window must have a location/address set. This Business Partner is a customer of the Openbravo ERP entity you are working with. This Business Partner will be used as the default Business partners for the orders created in Openbravo POS and for example it cannot be the Openbravo ERP entity you are working with. Products: the included products must have a price set in the selected Price List in External Point of Sale window.
Use Organization, Business Partner and Price List links in External Point of Sale window to check easier this points.
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> <properties> <comment>Openbravo Websevice configuration</comment> <entry key="url"> http://localhost:8000/openbravo/services </entry> <entry key="id">1000000</entry> <entry key="org">1000000</entry> <entry key="pos">1234</entry> <entry key="user">Openbravo</entry> <entry key="password">openbravo</entry> </properties>
The configuration values are as follows:
url: The base URL location where the Openbravo webservice endpoints are installed.
y y y y
user: The Openbravo ERP user used to invoke the integration functionality. This user must have access permissions to the class name org.openbravo.erpCommon.ws.externalSales.Externa lSales. password: The password of the Openbravo ERP user. id: The Openbravo ERP internal client identifier of the external point of sale. org: The Openbravo ERP internal organization identifier of the external point of sale. pos: The search key of the external point of sale defined in Openbravo ERP used to identify the Openbravo POS system inside Openbravo ERP.
Find out the correct values of id and org in Openbravo.properties: Login to Openbravo ERP as System Administrator and go to Application Dictionary > Maintenance > SQL Query and execute (button with search icon):
SELECT AD_CLIENT_ID, VALUE, NAME FROM AD_CLIENT SELECT AD_ORG_ID, VALUE, NAME FROM AD_ORG
Check in the query result the value of AD_CLI ENT_ID and AD_ORG_ID for selected Client and Organization in External Point of Sale window and use them to configure Openbravo.prop erties.
Login as administrator an go to the menu panel Maintenance. Here you have the two available options: Synchronize POS to download from Openbravo ERP the products list defined for this Point of Sale and the customers list, and Synchronize Orders to upload to Openbravo ERP the pending orders generated in this Point of Sale.