Tích hợp - Đồng bộ Openbravo ERP và Openbravo POS - Phần 2

   Trong bài viết ở phần 1 tôi đã giới thiệu tổng quan về hướng đồng bộ dữ liệu giữa openbravo erp và openbravo pos. Từ phần này tôi sẽ bắt đầu đi vào chi tiết , từng bước để thực hiện. 
   Cụ thể trong phần 2 này tôi sẽ hướng dẫn cách cài đặt và sử dụng module POS Synchronization Webservice cho Openbravo ERP đồng thời hướng dẫn cách tạo, khai báo vào cấu hình các điểm bán lẻ (Sử dụng Openbravo POS) trên Openbravo ERP.


I. Cài đặt Openbravo POS Synchronization Webservice . 
    POS Synchronization Webservice cũng là một module của Openbravo ERP như nhiều module khác. Bạn có thể tham khảo cách cài đặt 1 module cho Openbravo ERP tại link sau: How to Install a Module

Bây giờ bạn cài module POS Synchronization WebService bằng một trong 2 cách sau:
Cách 1:
  • Login vào Openbravo ERP bằng quyền System Administrator .
  • Vào General Setup > Application > Module Management.
  • Chuyển tới tab Add modules .
Chọn trong danh sách các module: POS Synchronization WebService sau đó nhấn nút Install now
  • Nếu bạn đang sử dụng phiên bản Professional Edition của Openbravo ERP thì việc cài đặt sẽ tiếp tục diễn ra như các bước sau , còn bạn đang sử dụng phiên bản free bạn sẽ gặp thông báo “Your license does not allow you to complete this action.”  Vì Module này từ phiên bản 3.0 đã trở thành module thương mại áp dụng cho phiên bản Professional Edition. Tại thời điểm viết bài này bạn có thể đăng ký dùng thử 30 ngày phiên bản Professional Edition tại đây . Sau khi đăng ký dùng thử bạn có thể tiến hành download và cài đặt Module POS Synchronization WebService bình thường. Trong trường hợp không được bạn có thể áp dụng cách 2 để có thể cài đặt Module này.

  • Trong cửa sổ tiếp theo cho biết thông tin chi tiết về module đã hợp lệ. Để tiếp tục nhấn nút Continue.
  • Bước tiếp theo chọn vào tùy chọn I accept all license agreements và nhấn nút  Continue.
  • Chuyển qua tab Installed Modules . Tại đây xuất hiện tất cả các module đã được cài đặt và tình trạng hiện tại của các module này. Sau khi cài đặt, để một module có hiệu lực cần phải rebuild để hoàn thành quá trình cài đặt. Vì vậy bạn click vào rebuild now ở module POS Synchronization WebService.
  • Trong cửa sổ tiếp theo bạn nhấn nút Yes để xác nhận là bạn muốn rebuild openbravo ERP.
  • Quá trình rebuild sẽ tự động bắt đầu và hiển thị trên cửa sổ log. Quá trình này có thể mất một khoảng thời gian tùy theo cấu hình máy tính của bạn.
  • Cuối cùng, tiến trình rebuild kết thúc thành công. Chọn vào tùy chọn Reload the Openbravo application now và nhấn nút Continue..


Cách 2: Cách này áp dụng trong trường hợp bạn không thể cài đặt trực tiếp POS Synchronization WebService  theo cách 1.
- Bạn vào link sau download module POS Synchronization Webservice về: http://www.mediafire.com/?byccfz45zk361r8
- Giải nén với password giải nén là minhbangchu.info
- Sau khi giải nén bạn chép thư mục thu được (org.openbravo.pos.sync) vào thư mục modules trên thư mục gốc source code của Openbravo ERP (Ví dụ : Openbravo-3.0MP5.1)
- Sau đó bạn mở cửa sổ cmd và chuyển đến thư mục gốc Openbravo ERP và thực hiện dòng lệnh :
  ant smartbuild -Dlocal=no

 
 
- Việc cài đặt thành công sẽ hiện thị kết quả tương tự như sau:

 

- Đến đây bạn đã cài đặt thành công Module POS Synchronization Webservice .

II. Kiểm tra Module cài đặt thành công hay chưa.

Để kiểm tra bạn đã cài đặt module chính xác hay chưa, bạn gõ link tương tự sau vào trình duyệt để kiểm tra:
http://localhost:8080/openbravoerp/ws/org.openbravo.pos.sync.ws
(Lưu ý là đường dẫn của bạn có thể khác nếu bạn sử dụng tomcat ở cổng khác hoặc bạn cài đặt Openbravo ERP ở thư mục khác.)
Trước khi gọi web service, người dùng phải đăng nhập, vì vậy một cửa sổ đăng nhập sẽ xuất hiện nếu như bạn chưa đăng nhập vào Openbravo ERP.
Kết quả sẽ xuất hiện mọt trang welcome với một mô tả ngắn gọn về việc sử dụng web service:

 


Nếu bạn nhận được  <error><message>No registration for name org.openbravo.pos.sync.ws</message></error> , hãy thử restart Tomcat.

III. Sử dụng Openbravo POS Synchronization WebService.
 

Web Service này có thể được chia thành 3 nhiệm vụ chính sau:
  • Lấy thông tin về các Business Objects (BO) của Openbravo ERP sử dụng DAL.
  • Chuyển đổi từ BO của Openbravo ERP sang BO của Openbravo POS.
  • Hiện thị các đoạn XML diễn tả của các Openbravo POS BO.

Sử dụng:

http://localhost:8080/openbravo/ws/org.openbravo.pos.sync.ws/ BusinessObject ? Parameters
Ví dụ:  Lấy thuế:
http://localhost:8080/openbravo/ws/org.openbravo.pos.sync.ws/Tax?erp.id=1000000&erp.org=1000000&erp.pos=1234

Các thông số (Parameters):

  • erp.id: Mã khách hàng trong Openbravo ERP để xác định các điểm bán lẻ bên ngoài.
  • erp.org: Tổ chức- Cơ quan bên trong Openbravo ERP xác định các điểm bán lẻ bên ngoài.
  • erp.pos: Search key của điểm bán lẻ được định nghĩa trong Openbravo ERP dùng để xác định các hệ thống Openbravo POS bên trong Openbravo ERP.
  • erp.user: Người dùng Openbravo ERP để gọi chức năng tích hợp.
  • erp.password: Mật khẩu ngươi dùng Openbravo ERP.

Các Business Object:

POS Business Object POS Table ERP Table
AttributeATTRIBUTEm_attribute
AttributeSetATTRIBUTESETm_attributeset
AttributeValueATTRIBUTEVALUEm_attributevalue
AttributeUseATTRIBUTEUSEm_attributeuse
AttributeInstanceATTRIBUTEINSTANCEm_attributeisntance
AttributeSetInstanceATTRIBUTESETINSTANCEm_attributesetinstance
WarehouseLOCATIONSm_warehouse
BusinessPartnerTaxCategoryTAXCUSTCATEGORIESc_bp_taxcategory
TaxCategoryTAXCATEGORYc_taxcategory
TaxTAXESc_tax
ProductCategoryCATEGORIESm_product_category
ProductPRODUCTSm_product
InventorySTOCKCURRENT, STOCKDIARY, STOCKLEVELm_storage_detail
BusinessPartnerCUSTOMERSc_bpartner


Giới hạn:

  • Products
    • Product type phải là Item
    • Product UOM (Đơn vị tính sản phẩm ) phải là Unit
    • Các sản phẩm phải thuộc phiên bản Price List gần đây (Cao hơn ngày trong validfrom) và Price List này phải trùng khớp với Price List được chọn lúc thiết lập điểm bán lẻ trong Openbravo ERP.
  • Inventory

Mô hình lưu trữ trong Openbravo ERP và Openbravo POS có những điểm khác nhau:
Openbravo ERP                 #     Openbravo POS
 |                                        #       |
 |--- Warehouse                 #       |--- Warehouse
 |-----|                                #             |
       |--- Storage Bin           #             |---Products
            |                             #
            |--- Products          # 

 
Trong điểm bán lẻ một kho được lựa chọn. Các sản phẩm giống nhau có thể được lưu trữ trong 2 Storage Bin bên trong cùng một kho.
Khi kho chứa sản phẩm được đồng bộ, tổng số sản phẩm được lưu trữ trong các Storage Bin của kho được chọn sẽ được thực hiện.

 
Ví dụ:
Main Warehouse
 |
 |--- First Storage Bin
 |     |
 |     |--- Hat = 50 Units
 |
 |--- Second Storage Bin
       |
       |--- Hat = 150 Units

 
Và trong Openbravo POS số lượng  mặt hàng "hat " sẽ là 200 unit được lưu trong bảng STOCKCURRENT.



IV. Tạo và cấu hình các điểm bán lẻ (external point of sales) 
  
   Trong Openbravo ERP cần phải tạo và cấu hình các điểm bán lẻ mà bạn muốn quản lý để xác định các sản phẩm tương ứng cho từng điểm bán lẻ. Với việc này, khi một điểm bán hàng (POS) muốn lấy danh mục sản phẩm từ Openrbavo POS, các sản phẩm được xác định trong cửa sổ này cho điểm bán lẻ tương ứng sẽ được gửi đi. Và các tùy chọn được xác định sẽ được sử dụng trong quá trình import các hóa đơn.
 Để cấu hình các điểm bán lẻ, bạn phải thay đổi vai trò người dùng của bạn thành AQ Testing Admin, sau đó mở menu tùy chọn Sales management > Setup > External Point of Sales

 Trong cửa sổ này, bạn xác định điểm bán lẻ của bạn (Trong trường hợp bạn chưa có điểm bán lẻ nào bạn cần nhấn vào nút "Create a new record in a form") và include/ exclude các sản phẩm và loại sản phẩm tương ứng cho điểm bán lẻ của bạn:


  
  Bạn có thể chọn sản phẩm để thiết lập đồng bộ hóa theo loại hoặc theo từng sản phẩm. Để chọn sản phẩm theo loại , bạn chọn: Only those defined bên trong danh sách xổ xuống Included Product Categories và thêm Loại sản phẩm mà bạn muốn trong Tab Product Categories phía bên dưới. Để chọn danh sách sản phẩm theo sản phẩm, bạn chọn Only those defined ở danh sách xổ xuống Included Products và thêm sản phẩm bạn muốn.

  Cuối cùng bạn nhấn nút lưu để lưu lại. Bạn có thể tạo ra nhiều điểm bán lẻ khác nhau để quản lý , mỗi điểm bán lẻ ứng với một nhà hàng , một cửa hàng, ... của bạn . 
  
  Phần tiếp theo (Phần 3) tôi sẽ hướng dẫn chi tiết cách sử dụng Pentaho đồng bộ hóa database giữa Openbravo POS và ERP.

0 Nhận xét:

Đăng nhận xét

Rất mong các ý kiến của các bạn khi đọc bài viết này !