Discounts
Discounts
Sales in Lightspeed Retail (X-Series) can be discounted in one of 2 ways, at the sale or line-item level. We'll present both ways below.
Sale-level discounts
Adding a "total" discount at the sale level is done by adding a special vend-discount
product line item.
Discount product
In Lightspeed Retail (X-Series), we have the notion of system-wide internal products. These products are static and exist in every retailer account so you can be assured they are available to use. To find the discount_product_id
of the vend-discount
product, you can call the /api/2.0/retailer
endpoint like:
https://<<domain_prefix>>.retail.lightspeed.app/api/2.0/retailer.
The discount_product_id
will be used as the product_id
of a register_sale_product
. The quantity
will have to be negative (-1) with the price
being the discount amount on the sale.
The discount_product_id
of that product is account specific and will not change throughout the lifetime of that account. It can be retrieved once and stored for later use on all discounted sales.
Discount line item
To add a discount to the sale a line item, using the discount product's id
needs to be added to the register_sale_products
array like below. In this example, we have a sale with a product worth $13.80
($12.00
price + $1.80
tax) discounted by 50%
:
{
//...
"register_sale_products": [{
"product_id": "b1d87b58-f019-11e3-a0f5-b8ca3a64f8f4",
"quantity": 1,
"price": 12,
"cost": 8.73,
"price_set": 0,
"discount": 0,
"loyalty_value": 1.38,
"tax": 1.8,
"tax_id": "b1d192bc-f019-11e3-a0f5-b8ca3a64f8f4"
},
{
"product_id": "9a84e9e1-f038-11e3-a0f5-b8ca3a64f8f4",
"quantity": -1,
"price": 6,
"cost": 0,
"price_set": 1,
"discount": 0,
"loyalty_value": 0,
"tax": 0.9,
"tax_id": "b1d192bc-f019-11e3-a0f5-b8ca3a64f8f4"
}
]
...
}
Even if the discount is expressed as a %
value to the customer, the value of the discount line item's price and tax should be calculated as the proportion of the total value of the sale and expressed in direct currency value.
NOTE: When adding the discount product to the sale, it's price should be the positive value of the discount and the quantity should be
-1
.
Line item discounts
Discounting specific line items is done by modifying the price of the line item
In the example below, a product worth $115
was discounted by 50%
.
The original, tax-exclusive price of that product was $100
and the tax was $15
, both of which were reduced by 50%
.
{
//...
"register_sale_products": [{
"product_id": "06bf537b-c783-11e7-ff13-2ae5d02c65f5",
"quantity": 1,
"price": 50,
"cost": 40,
"price_set": 1,
"discount": 57.5,
"loyalty_value": 5.75,
"tax": 7.5,
"tax_id": "b1d192bc-f019-11e3-a0f5-b8ca3a64f8f4"
}]
...
}
WARNING: When using that kind of discount, it's important to also set the
price_set
attribute to1
. This indicates that the value of this product was intentionally modified and should not be recalculated for pending sales which may be brought to the sell screen for further processing.
Which To Use?
Use the vend-discount
product when you just want to apply a discount to the entire total of the sale. This will be easily viewable on the receipt as it’s own subtotal.
Apply a discount to an explicit line item if you have a number of product lines on a sale, but only certain products should receive a discount. This will ensure that each discounted line item has the amount of the discount displayed on the receipt.
Of course, there is nothing to stop you from posting a sale without a discount product line item or no discount value assigned against each of your product line items. But by using the vend-discount
product or assigning discount values, you can be assured that your client can report on the discount values applied.
Updated about 1 month ago