+
+ Vouchers and Coupons
+..Manage Gift Vouchers and Coupon Codes in Point of Sale..
+Cybrosys Technologies
+
+
+Features:
+
+ ☑ Create gift vouchers for products.
+ ☑ Create gift vouchers for point of sale category.
+ ☑ Create global gift vouchers.
+ ☑ Create and configure coupon codes.
+ ☑ Apply coupon codes from point of sale.
+ ☑ Coupon usage tracking.
+
+ + ☑ Create gift vouchers for point of sale category.
+ ☑ Create global gift vouchers.
+ ☑ Create and configure coupon codes.
+ ☑ Apply coupon codes from point of sale.
+ ☑ Coupon usage tracking.
+
+
+
+
+ Overview
++ Gift vouchers and coupon codes can be used to provide a certain amount of discount to our customers + using a secret code. +
+
+
+
+
+
+
+
+
+ 
+
+
+ +
After installing this module, three menus will be created under + point of sale. We can use these menus to create, configure and track vouchers, coupons and their usage.
+
+
+Vouchers
+
+
+
+
+
+ 
+
+
+ This is the form for creating vouchers. We can create vouchers for a single product, pos category and + for all the products.
+
+
+
+Coupons
+
+
+
+ 
+
+
+ +
+
+
+
+ + After creating the voucher, we need to create the coupons related to each voucher. From + the coupons menu, we can create new coupons and link it to the corresponding vouchers. The fixed type coupon will + include a fixed amount discount to the order and percentage type coupon will set the coupon amount based on + the total order amount and the percentage provided in the back end. +
+
+
+
+Apply Coupons
++
The 'Coupons' button in point of sale can be used to enter the coupon code. +
+
+
+
+ 
+
+
+
+
+
+ 
+
+
+
+
+
+ 
+
+
+
+
+Coupon Tracking
+
+
+
+ 
+
+
+ Go to the 'Coupon History' menu under 'Vouchers and Coupons' for coupon tracking.
+Need Any Help?
+ +
+ ')); + var order = self.pos.get_order(); + order.set_coupon_value(coupon_res[0]); + } + self.flag = flag; + if(flag){ + $(".confirm-coupon").css("display", "block"); + } + else{ + var ob = $(".coupon_status_p").text("Invalid code or no coupons left. \nPlease check coupon validity.\n" + + "or check whether the coupon usage is limited to a particular customer."); + ob.html(ob.html().replace(/\n/g,'
')); + } + } + else{ + $(".coupon_status_p").text("Please select a customer !!"); + } + } + }); + this.$(".confirm-coupon").click(function () { + // verifying and applying coupon + if(self.flag){ + var order = self.pos.get_order(); + var lines = order ? order.orderlines : false; + if(order.coupon){ + self.gui.close_popup(); + self.gui.show_popup('error',{ + 'title': _t('Unable to apply coupon !'), + 'body': _t('Either coupon is already applied or you have not selected any products.'), + }); + } + else{ + if(lines.models.length > 0 && order.check_voucher_validy()) { + var product = self.pos.db.get_product_by_id(self.coupon_product); + var price = -1; + if (order.coupon_status['type'] == 'fixed') { + price *= order.coupon_status['voucher_val']; + } + if (order.coupon_status['type'] == 'percentage') { + price *= order.get_total_with_tax() * order.coupon_status['voucher_val'] / 100; + } + if ((order.get_total_with_tax - price) <= 0) { + self.gui.close_popup(); + self.gui.show_popup('error', { + 'title': _t('Unable to apply coupon !'), + 'body': _t('Coupon amount is too large to apply. The total amount cannot be negative'), + }); + } + else{ + order.add_product(product, {quantity: 1, price: price}); + order.coupon_applied(); + // updating coupon balance after applying coupon + var client = self.pos.get_client(); + var temp = { + 'partner_id': client['id'], + 'coupon_pos': order.coupon_status['code'], + }; + new Model('partner.coupon.pos').call('update_history', ['', temp]).done(function (result) { + // alert("result") + var applied = self.pos.applied_coupon; + var already_used = false; + for (var j in applied) { + if (applied[j]['partner_id'][0] == client['id'] && + applied[j]['coupon_pos'] == order.coupon_status['code']) { + applied[j]['number_pos'] += 1; + already_used = true; + break; + } + } + if (!already_used) { + var temp = { + 'partner_id': [client['id'], client['name']], + 'number_pos': 1, + 'coupon_pos': order.coupon_status['code'] + }; + self.pos.applied_coupon.push(temp); + } + }); + self.gui.close_popup(); + } + } + else{ + self.gui.close_popup(); + self.gui.show_popup('error',{ + 'title': _t('Unable to apply coupon !'), + 'body': _t('This coupon is not applicable on the products or category you have selected !'), + }); + } + } + } + else{ + self.gui.close_popup(); + self.gui.show_popup('error',{ + 'title': _t('Unable to apply coupon !'), + 'body': _t('Invalid Code or no Coupons left !'), + }); + } + }); + }, + }); + gui.define_popup({name:'coupon', widget: CouponPopupWidget}); + + // PosModel is extended to store vouchers, & coupon details + pos_model.PosModel = pos_model.PosModel.extend({ + initialize: function(session, attributes) { + PosModelSuper.prototype.initialize.call(this, session, attributes) + this.vouchers = ['']; + this.coupons = []; + this.applied_coupon = []; + }, + }); + + pos_model.Order = pos_model.Order.extend({ + initialize: function(attributes,options){ + this.coupon = false; + this.coupon_status = []; + return OrderSuper.prototype.initialize.call(this, attributes,options);; + }, + set_coupon_value: function (coupon) { + this.coupon_status = coupon; + return; + }, + coupon_applied: function () { + this.coupon = true; + this.export_as_JSON(); + return; + }, + check_voucher_validy: function () { + var self = this; + var order = self.pos.get_order(); + var vouchers = self.pos.vouchers; + var voucher = null; + for (var i in vouchers){ + if(vouchers[i]['id'] == self.coupon_status.voucher[0]){ + voucher = vouchers[i]; + break; + } + } + var flag ; + if(voucher){ + switch(voucher.voucher_type){ + case 'product': { + var lines = order.orderlines.models; + var products = {}; + for (var p in lines){ + products[lines[p].product.id] = null; + } + if(voucher.product_id[0] in products){ + flag = true; + } + else + flag = false; + break; + } + case 'category':{ + var lines = order.orderlines.models; + var category = {}; + for (var p in lines){ + if(lines[p].product.pos_categ_id){ + category[lines[p].product.pos_categ_id[0]] = null; + } + } + if(voucher.product_categ[0] in category){ + flag = true; + } + else + flag = false; + break; + } + case 'all': flag = true; break; + default: break; + } + } + return flag; + }, + export_as_JSON: function () { + var self = OrderSuper.prototype.export_as_JSON.call(this); + self.coupon = this.coupon; + self.coupon_status = this.coupon_status; + return self; + }, + init_from_JSON: function(json) { + this.coupon = json.coupon; + this.coupon_status = json.coupon_status; + OrderSuper.prototype.init_from_JSON.call(this, json); + }, + get_total_without_tax: function() { + var res = OrderSuper.prototype.get_total_without_tax.call(this); + var final_res = round_pr(this.orderlines.reduce((function(sum, orderLine) { + return sum + (orderLine.get_unit_price() * orderLine.get_quantity()); + }), 0), this.pos.currency.rounding); + return final_res; + }, + }); +}); \ No newline at end of file diff --git a/vouchers_pos/static/src/xml/coupons.xml b/vouchers_pos/static/src/xml/coupons.xml new file mode 100644 index 000000000..9f0d9638c --- /dev/null +++ b/vouchers_pos/static/src/xml/coupons.xml @@ -0,0 +1,95 @@ + +
+
+
+
+
+
+
+
+