feat(medusa, admin-ui): Improve gift card application (#4944)

Fix for the problems identified in issue #4892 

Bugfix: admin-ui order summary no longer uses gift card total from order when displaying how much has been withdrawn from each giftcard.

Bugfix(?): no longer keep applying gift cards (at 0 value) when sufficient balance has been reached

Feature: multiple giftcards are now applied in ordered fashion. First by end_date (supports null), then by remaining balance. In order to ensure that customers ends up with as long lasting and few remaining gift cards as possible after the transaction.
This commit is contained in:
mortenengel
2023-09-07 18:56:36 +02:00
committed by GitHub
parent 9f16c90f99
commit 11fb523051
4 changed files with 199 additions and 6 deletions

View File

@@ -1,9 +1,15 @@
const path = require("path")
const { Region, GiftCard } = require("@medusajs/medusa")
const { Region, GiftCard, GiftCardTransaction } = require("@medusajs/medusa")
const setupServer = require("../../../environment-helpers/setup-server")
const { useApi } = require("../../../environment-helpers/use-api")
const { initDb, useDb } = require("../../../environment-helpers/use-db")
const {
simpleProductFactory,
simpleCartFactory,
simpleRegionFactory,
simpleGiftCardFactory,
} = require("../../../factories")
jest.setTimeout(30000)
@@ -60,4 +66,180 @@ describe("/store/gift-cards", () => {
})
})
})
describe("gift card transactions", () => {
afterEach(async () => {
const db = useDb()
await db.teardown()
})
it("only creates transactions for gift cards used", async () => {
const api = useApi()
const region = await simpleRegionFactory(dbConnection, {
currency_code: "usd",
})
const cart = await simpleCartFactory(dbConnection, {
region: region.id,
})
const product = await simpleProductFactory(dbConnection)
const giftCard1 = await simpleGiftCardFactory(dbConnection, {
code: "GC_1",
region_id: region.id,
balance: 50000,
value: 50000,
})
const giftCard2 = await simpleGiftCardFactory(dbConnection, {
code: "GC_2",
region_id: region.id,
balance: 50000,
value: 50000,
})
await api.post(`/store/carts/${cart.id}/line-items`, {
variant_id: product.variants[0].id,
quantity: 1,
})
await api.post(`/store/carts/${cart.id}`, {
email: "some@customer.com",
gift_cards: [{ code: "GC_1" }, { code: "GC_2" }],
})
const response = await api.post(`/store/carts/${cart.id}/complete`)
expect(response.status).toEqual(200)
const orderId = response.data.data.id
const transaction1 = await dbConnection.manager.find(
GiftCardTransaction,
{
order_id: orderId,
}
)
expect(transaction1.length).toEqual(1)
expect(transaction1[0].amount).toEqual(100)
})
})
describe("gift card transaction ordering", () => {
afterEach(async () => {
const db = useDb()
await db.teardown()
})
it("choose the gift card with shortest expiry", async () => {
const api = useApi()
const region = await simpleRegionFactory(dbConnection, {
currency_code: "usd",
})
const cart = await simpleCartFactory(dbConnection, {
region: region.id,
})
const product = await simpleProductFactory(dbConnection)
const ends_first = new Date(2050, 1, 1)
const ends_later = new Date(2050, 1, 2)
const giftCard1 = await simpleGiftCardFactory(dbConnection, {
id: "GC_1",
code: "GC_1",
region_id: region.id,
balance: 50000,
value: 50000,
ends_at: ends_later
})
const giftCard2 = await simpleGiftCardFactory(dbConnection, {
id: "GC_2",
code: "GC_2",
region_id: region.id,
balance: 50000,
value: 50000,
ends_at: ends_first
})
await api.post(`/store/carts/${cart.id}/line-items`, {
variant_id: product.variants[0].id,
quantity: 1,
})
await api.post(`/store/carts/${cart.id}`, {
email: "some@customer.com",
gift_cards: [{ code: "GC_1" }, { code: "GC_2" }],
})
const response = await api.post(`/store/carts/${cart.id}/complete`)
expect(response.status).toEqual(200)
const orderId = response.data.data.id
const transaction1 = await dbConnection.manager.find(
GiftCardTransaction,
{
order_id: orderId,
}
)
expect(transaction1.length).toEqual(1)
expect(transaction1[0].gift_card_id).toEqual(giftCard2.id)
})
})
it("choose the gift card with lowest balance if same expiry", async () => {
const api = useApi()
const region = await simpleRegionFactory(dbConnection, {
currency_code: "usd",
})
const cart = await simpleCartFactory(dbConnection, {
region: region.id,
})
const product = await simpleProductFactory(dbConnection)
const same_end = new Date(2050, 1, 1)
const giftCard1 = await simpleGiftCardFactory(dbConnection, {
id: "GC_1",
code: "GC_1",
region_id: region.id,
balance: 50000,
value: 50000,
ends_at: same_end
})
const giftCard2 = await simpleGiftCardFactory(dbConnection, {
id: "GC_2",
code: "GC_2",
region_id: region.id,
balance: 30000,
value: 50000,
ends_at: same_end
})
const giftCard3 = await simpleGiftCardFactory(dbConnection, {
id: "GC_3",
code: "GC_3",
region_id: region.id,
balance: 20000,
value: 50000
})
await api.post(`/store/carts/${cart.id}/line-items`, {
variant_id: product.variants[0].id,
quantity: 1,
})
await api.post(`/store/carts/${cart.id}`, {
email: "some@customer.com",
gift_cards: [{ code: "GC_1" }, { code: "GC_2" }, { code: "GC_3" }],
})
const response = await api.post(`/store/carts/${cart.id}/complete`)
expect(response.status).toEqual(200)
const orderId = response.data.data.id
const transaction1 = await dbConnection.manager.find(
GiftCardTransaction,
{
order_id: orderId,
}
)
expect(transaction1.length).toEqual(1)
expect(transaction1[0].gift_card_id).toEqual(giftCard2.id)
})
})

View File

@@ -9,6 +9,7 @@ export type GiftCardFactoryData = {
value: number
balance: number
tax_rate?: number
ends_at?: Date
}
export const simpleGiftCardFactory = async (
@@ -29,6 +30,7 @@ export const simpleGiftCardFactory = async (
value: data.value,
balance: data.balance,
tax_rate: data.tax_rate,
ends_at: data.ends_at
})
return await manager.save(toSave)

View File

@@ -221,20 +221,20 @@ const SummaryCard: React.FC<SummaryCardProps> = ({ order, reservations }) => {
}
/>
))}
{order?.gift_cards?.map((giftCard, index) => (
{order?.gift_card_transactions?.map((gcTransaction, index) => (
<DisplayTotal
key={index}
currency={order.currency_code}
totalAmount={-1 * order.gift_card_total}
totalAmount={-1 * gcTransaction.amount}
totalTitle={
<div className="inter-small-regular text-grey-90 flex items-center">
Gift card:
<Badge className="ml-3" variant="default">
{giftCard.code}
{gcTransaction.gift_card.code}
</Badge>
<div className="ml-2">
<CopyToClipboard
value={giftCard.code}
value={gcTransaction.gift_card.code}
showValue={false}
iconSize={16}
/>

View File

@@ -733,7 +733,13 @@ class OrderService extends TransactionBaseService {
let giftCardableAmountBalance = giftCardableAmount
const giftCardService = this.giftCardService_.withTransaction(manager)
for (const giftCard of cart.gift_cards) {
//Order the gift cards by first ends_at date, then remaining amount. To ensure largest possible amount left, for longest possible time.
const orderedGiftCards = cart.gift_cards.sort((a, b) => {
let aEnd = a.ends_at ?? new Date(2100, 1, 1)
let bEnd = b.ends_at ?? new Date(2100, 1, 1)
return aEnd.getTime() - bEnd.getTime() || a.balance - b.balance
})
for (const giftCard of orderedGiftCards) {
const newGiftCardBalance = Math.max(
0,
giftCard.balance - giftCardableAmountBalance
@@ -755,6 +761,9 @@ class OrderService extends TransactionBaseService {
giftCardableAmountBalance =
giftCardableAmountBalance - giftCardBalanceUsed
if (giftCardableAmountBalance == 0)
break;
}
const shippingOptionServiceTx =