# POS-Awesome-V15

**Repository Path**: cy0805851985/POS-Awesome-V15

## Basic Information

- **Project Name**: POS-Awesome-V15
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: 0rsq7g-mergify/update-variant-selection-rate-logic
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-20
- **Last Updated**: 2025-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
    <img src="https://frappecloud.com/files/pos.png" height="128">
    <h2>POS AWESOME</h2>
</div>

#### An open-source Point of Sale for [Erpnext](https://github.com/frappe/erpnext) using [Vue.js](https://github.com/vuejs/vue) and [Vuetify](https://github.com/vuetifyjs/vuetify) (VERSION 15 Support)

---

### Update Instructions

After switching branches or pulling latest changes:

1. cd apps/posawesome
2. git pull
3. yarn install
4. cd ../..
5. bench build --app posawesome
6. bench --site your.site migrate
   - If the build exits with code 143, verify that your system has enough RAM or swap space.
   - You can also try building the app in smaller parts to reduce memory usage.

### Main Features

1. Supports Erpnext Version 15
2. Supports Multi-Currency Transactions.
   Customers can be invoiced in different currencies.
   Exchange Rate is fetched automatically based on selected currency. When a price list has its own exchange rate set, POS Awesome uses that rate and falls back to the standard ERPNext rate otherwise.
   Invoices made with posawesome display Grand Total in both base and selected currency in erpnext.
3. Supports offline mode for creating invoices and customers, saves data locally with stock validation, and syncs automatically when reconnected. If **Allow Negative Stock** is enabled in Stock Settings, offline invoices can still be saved even when quantities are below zero.
4. User-friendly and provides a good user experience and speed of use
5. The cashier can either use list view or card view during sales transactions. Card view shows the images of the items
6. Supports enqueue invoice submission after printing the receipt for faster processing
7. Supports batch & serial numbering
8. Supports batch-based pricing
9. Supports UOM-specific barcode and pricing
10. Supports sales of scale (weighted) products
11. Ability to make returns from POS
12. Supports Making returns for either cash or customer credit
13. Supports using customer credit notes for payment
14. Supports credit sales
15. Allows the user to choose a due date for credit sales
16. Supports customer loyalty points
17. Shortcut keys
18. Supports Customer Discount
19. Supports POS Offers
20. Auto-apply batches for bundle items
21. Search and add items by Serial Number
22. Create Sales Orders from POS directly
23. Supports template items with variants
24. Supports multiple languages with language selection per POS Profile (English, Arabic, Portuguese and Spanish provided)
25. Supports Mpesa mobile payment
26. POS Coupons
27. Supports Referral Code
28. Supports Customer and Customer Group price list
29. Supports Sales Person
30. Supports Delivery Charges
31. Search and add items by Batch Number
32. Accept new payments from customers against existing invoices
33. Payments Reconciliation
34. A lot more bug fixes from the version 14
35. Offline invoices that fail to submit are saved as draft documents

### How to Install

#### Self Hosting:

1. `bench get-app --branch Version-15 https://github.com/defendicon/POS-Awesome-V15`
2. `bench setup requirements`
3. `bench build --app posawesome`
4. `bench restart`
5. `bench --site [your.site.name] install-app posawesome`
6. `bench --site [your.site.name] migrate`

---

### How To Use:

[POS Awesome Wiki](https://github.com/yrestom/POS-Awesome/wiki)

---

### Shortcuts:

- `CTRL or CMD + S` open payments
- `CTRL or CMD + X` submit payments
- `CTRL or CMD + D` remove the first item from the top
- `CTRL or CMD + A` expand the first item from the top
- `CTRL or CMD + E` focus on discount field

---

### Dependencies:

- [Frappe](https://github.com/frappe/frappe)
- [Erpnext](https://github.com/frappe/erpnext)
- [Vue.js](https://github.com/vuejs/vue)
- [Vuetify.js](https://github.com/vuetifyjs/vuetify)

---

### Contributing

1. [Issue Guidelines](https://github.com/frappe/erpnext/wiki/Issue-Guidelines)
2. [Pull Request Requirements](https://github.com/frappe/erpnext/wiki/Contribution-Guidelines)

---

### License

GNU/General Public License (see [license.txt](https://github.com/yrestom/POS-Awesome/blob/master/license.txt))

The POS Awesome code is licensed as GNU General Public License (v3)