Skip to content

Latest commit

 

History

History
60 lines (46 loc) · 4.23 KB

README.md

File metadata and controls

60 lines (46 loc) · 4.23 KB

Point Of Sale app

Overview

This project introduces a custom Point of Sale (POS) page built for ERPNext, specifically designed to work in offline mode. The default ERPNext POS system lacks robust offline support, so this custom solution allows sales transactions to continue smoothly even without internet connectivity.

The custom POS page comes pre-installed when you install the app, requiring no manual setup.


the way it works :

I'm working with a custom POS implementation in ERPNext, using offline storage by managing variables in memory (RAM) to simulate POS operations. I'm fetching necessary data (like customers, items, item prices, and warehouse lists) at the start, storing them in arrays and maps, and then operating offline with this data. My approach aligns well with handling offline functionality, especially in POS systems that need to operate without continuous server interaction.

POS PAGE overview :

Tab photo
POS Screen screen1
Select ItemGroup (Old version style) screen2
Get All Item (Filtred by name,code bar or group) screen3
Selecting items screen4
select client and price list to detect item price screen5
Item Details Cart : quantity Rate (can change it) , Discount persentage or amount calculated based on each other. price list rate just to show the base rate that came from price list. and we have the calculated field discount amount. screen6
When Checkout : enter the paid amount , detect if the pos is Paid or Unpaid and calculate To change amount screen7
Submit the pos invoice (if the pos is unpaid it will push it diractly to the server so the internet conection is required otherwise it will save on the local db) screen8
after submit create new tab && make sync button orange showing unsynced pos screen9
Sync with progress bar screen10
after sync the button return green screen11
menu options screen12

Features

  • Offline Mode Support: Perform sales and manage transactions even without an internet connection. Data will automatically sync once the connection is restored.
  • User-Friendly Interface: A simple, responsive, and efficient POS interface that works seamlessly in both online and offline modes.
  • Local Inventory Caching: Product and inventory data is cached locally, allowing users to search and add items without needing an active connection.
  • Auto-Sync: Offline transactions are synced with the ERPNext backend as soon as the internet is available, ensuring smooth reconciliation of offline sales data.
  • Integrated into ERPNext:No manual page setup is required. The POS page is automatically installed with the app.

Installation

To install the Halfware App on your Frappe or ERPNext instance:

  1. Clone the repository :
$ bench get-app https://github.com/RAYANaouf/ERPNEXT-POS
  1. Install the app:

Go to the directory where your ERPNext instance is set up:

cd /path/to/frappe-bench

Then install the app into your ERPNext site:

bench get-app  
bench --site [your-site-name] install-app ERPNEXT-POS