asyavee/medusa-store
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

fix(core-flows, dashboard, types): improve allocation flows on Admin (#12572)

Browse Source 
**What**
- handle single inventory items with `required_quantity > 1` correctly in the allocate UI flow
- display correct availability amount in the create fulullment form for inventory kit items
- fix check in the create fulfillment flow that would allow negative reservation because `required_quantity` wasn't included in the check
- show the most recent reservations first in the reservations table
- display an error in the allocation form if a reservation is not created for some inventory items 
- display inventory kit in the order summary if the product has multiple same inventory items

---

CLOSES SUP-1655
This commit is contained in:
Frane Polić
2025-08-19 18:48:24 +00:00
committed by GitHub
parent 67d3660abf
commit 2f594291ad
15 changed files with 295 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/admin/dashboard/src/i18n/translations/$schema.json
+41 -7
View File
@@ -3816,16 +3816,31 @@
"credit": {
"type": "string"
},
"creditDescription": {
"type": "string"
},
"debit": {
"type": "string"
},
"debitDescription": {
"type": "string"
},
"creditDescription": {
"type": "string"
}
}
},
"required": [
"title",
"total",
"creditOrDebit",
"createCreditLine",
"createCreditLineSuccess",
"createCreditLineError",
"createCreditLineDescription",
"operation",
"credit",
"creditDescription",
"debit",
"debitDescription"
],
"additionalProperties": false
},
"balanceSettlement": {
"type": "object",
@@ -3851,9 +3866,18 @@
"creditLineDescription": {
"type": "string"
}
}
},
"required": [
"paymentMethod",
"paymentMethodDescription",
"creditLine",
"creditLineDescription"
],
"additionalProperties": false
}
}
},
"required": ["title", "settlementType", "settlementTypes"],
"additionalProperties": false
},
"domain": {
"type": "string"
@@ -4876,9 +4900,12 @@
"properties": {
"created": {
"type": "string"
},
"error": {
"type": "string"
}
},
"required": ["created"],
"required": ["created", "error"],
"additionalProperties": false
},
"error": {
@@ -5539,6 +5566,9 @@
}
},
"required": [
"giftCardsStoreCreditLines",
"creditLines",
"balanceSettlement",
"domain",
"claim",
"exchange",
@@ -11229,6 +11259,8 @@
},
"required": [
"amount",
"reference",
"reference_id",
"refundAmount",
"name",
"default",
@@ -11315,6 +11347,7 @@
"account",
"total",
"paidTotal",
"creditTotal",
"totalExclTax",
"subtotal",
"shipping",
@@ -11497,6 +11530,7 @@
"invite",
"resetPassword",
"workflowExecutions",
"shippingOptionTypes",
"productTypes",
"productTags",
"notifications",
packages/admin/dashboard/src/i18n/translations/en.json
+2 -1
View File
@@ -1305,7 +1305,8 @@
"consistsOf": "Consists of {{num}}x inventory items",
"requires": "Requires {{num}} per variant",
"toast": {
"created": "Items successfully allocated"
"created": "Items successfully allocated",
"error": "Failed to allocate following items: {{items}}"
},
"error": {
"quantityNotAllocated": "There are unallocated items."
packages/admin/dashboard/src/routes/locations/location-sales-channels/components/edit-sales-channels-form/edit-sales-channels-form.tsx
+1 -1
View File
@@ -31,7 +31,7 @@ const EditSalesChannelsSchema = zod.object({
sales_channels: zod.array(zod.string()).optional(),
})
const PAGE_SIZE = 50
const PAGE_SIZE = 20
const PREFIX = "sc"
export const LocationEditSalesChannelsForm = ({
packages/admin/dashboard/src/routes/orders/order-allocate-items/components/order-create-fulfillment-form/order-allocate-items-form.tsx
+21 -9
View File
@@ -19,6 +19,7 @@ import { useStockLocations } from "../../../../../hooks/api/stock-locations"
import { queryClient } from "../../../../../lib/query-client"
import { AllocateItemsSchema } from "./constants"
import { OrderAllocateItemsItem } from "./order-allocate-items-item"
import { checkInventoryKit } from "./utils"
type OrderAllocateItemsFormProps = {
order: AdminOrder
@@ -84,16 +85,18 @@ export function OrderAllocateItemsForm({ order }: OrderAllocateItemsFormProps) {
const promises = payload.map(([itemId, inventoryId, quantity]) =>
allocateItems({
location_id: data.location_id,
inventory_item_id: inventoryId,
line_item_id: itemId,
quantity,
inventory_item_id: inventoryId as string,
line_item_id: itemId as string,
quantity: Number(quantity),
})
.then(() => ({ success: true, inventory_item_id: inventoryId }))
.catch(() => ({ success: false, inventory_item_id: inventoryId }))
)
/**
* TODO: we should have bulk endpoint for this so this is executed in a workflow and can be reverted
*/
await Promise.all(promises)
const results = await Promise.all(promises)
// invalidate order details so we get new item.variant.inventory items
await queryClient.invalidateQueries({
@@ -102,10 +105,19 @@ export function OrderAllocateItemsForm({ order }: OrderAllocateItemsFormProps) {
handleSuccess(`/orders/${order.id}`)
toast.success(t("general.success"), {
description: t("orders.allocateItems.toast.created"),
dismissLabel: t("actions.close"),
})
if (results.some((r) => !r.success)) {
const failedItems = results
.filter((r) => !r.success)
.map((r) => r.inventory_item_id)
.join(", ")
toast.error(t("general.error"), {
description: t("orders.allocateItems.toast.error", {
items: failedItems,
}),
dismissLabel: t("actions.close"),
})
}
} catch (e) {
toast.error(t("general.error"), {
description: e.message,
@@ -313,7 +325,7 @@ function defaultAllocations(items: OrderLineItemDTO) {
const ret = {}
items.forEach((item) => {
const hasInventoryKit = item.variant?.inventory_items.length > 1
const hasInventoryKit = checkInventoryKit(item)
ret[
hasInventoryKit
packages/admin/dashboard/src/routes/orders/order-allocate-items/components/order-create-fulfillment-form/order-allocate-items-item.tsx
+2 -2
View File
@@ -14,6 +14,7 @@ import { Thumbnail } from "../../../../../components/common/thumbnail"
import { getFulfillableQuantity } from "../../../../../lib/order-item"
import { Form } from "../../../../../components/common/form"
import { AllocateItemsSchema } from "./constants"
import { checkInventoryKit } from "./utils"
type OrderEditItemProps = {
item: OrderLineItemDTO
@@ -46,8 +47,7 @@ export function OrderAllocateItemsItem({
name: "quantity",
})
const hasInventoryKit =
!!variant?.inventory_items.length && variant?.inventory_items.length > 1
const hasInventoryKit = checkInventoryKit(item)
const { availableQuantity, inStockQuantity } = useMemo(() => {
if (!variant || !locationId) {
packages/admin/dashboard/src/routes/orders/order-allocate-items/components/order-create-fulfillment-form/utils.ts
+28
View File
@@ -0,0 +1,28 @@
import {
AdminProductVariant,
AdminProductVariantInventoryItemLink,
OrderLineItemDTO,
} from "@medusajs/types"
/**
* Check if the line item has inventory kit.
*/
export function checkInventoryKit(
item: OrderLineItemDTO & {
variant?: AdminProductVariant & {
inventory_items: AdminProductVariantInventoryItemLink[]
}
}
) {
const variant = item.variant
if (!variant) {
return false
}
return (
(!!variant.inventory_items.length && variant.inventory_items.length > 1) ||
(variant.inventory_items.length === 1 &&
variant.inventory_items[0].required_quantity! > 1)
)
}
packages/admin/dashboard/src/routes/orders/order-create-fulfillment/components/order-create-fulfillment-form/order-create-fulfillment-form.tsx
+1 -9
View File
@@ -57,12 +57,6 @@ export function OrderCreateFulfillmentForm({
})),
})
const itemReservedQuantitiesMap = useMemo(
() =>
new Map((reservations || []).map((r) => [r.line_item_id, r.quantity])),
[reservations]
)
const [fulfillableItems, setFulfillableItems] = useState(() =>
(order.items || []).filter(
(item) =>
@@ -364,9 +358,7 @@ export function OrderCreateFulfillmentForm({
disabled={
requiresShipping && !isShippingProfileMatching
}
itemReservedQuantitiesMap={
itemReservedQuantitiesMap
}
reservations={reservations}
/>
)
})}
packages/admin/dashboard/src/routes/orders/order-create-fulfillment/components/order-create-fulfillment-form/order-create-fulfillment-item.tsx
+71 -16
View File
@@ -17,7 +17,7 @@ type OrderEditItemProps = {
currencyCode: string
locationId?: string
onItemRemove: (itemId: string) => void
itemReservedQuantitiesMap: Map<string, number>
reservations: HttpTypes.AdminReservation[]
form: UseFormReturn<zod.infer<typeof CreateFulfillmentSchema>>
disabled: boolean
}
@@ -26,7 +26,7 @@ export function OrderCreateFulfillmentItem({
item,
form,
locationId,
itemReservedQuantitiesMap,
reservations,
disabled,
}: OrderEditItemProps) {
const { t } = useTranslation()
@@ -35,7 +35,7 @@ export function OrderCreateFulfillmentItem({
item.product_id,
item.variant_id,
{
fields: "*inventory,*inventory.location_levels",
fields: "*inventory,*inventory.location_levels,*inventory_items",
},
{
enabled: !!item.variant,
@@ -43,28 +43,83 @@ export function OrderCreateFulfillmentItem({
)
const { availableQuantity, inStockQuantity } = useMemo(() => {
if (!variant || !locationId) {
if (
!variant?.inventory_items?.length ||
!variant?.inventory?.length ||
!locationId
) {
return {}
}
const { inventory } = variant
const { inventory, inventory_items } = variant
const locationInventory = inventory[0]?.location_levels?.find(
(inv) => inv.location_id === locationId
const locationHasEveryInventoryItem = inventory.every((i) =>
i.location_levels?.find((inv) => inv.location_id === locationId)
)
if (!locationInventory) {
if (!locationHasEveryInventoryItem) {
return {}
}
const reservedQuantityForItem = itemReservedQuantitiesMap.get(item.id) ?? 0
const inventoryItemRequiredQuantityMap = new Map(
inventory_items.map((i) => [i.inventory_item_id, i.required_quantity])
)
// since we don't allow split fulifllments only one reservation from inventory kit is enough to calculate avalabel product quantity
const reservation = reservations?.find((r) => r.line_item_id === item.id)
const iitemRequiredQuantity = inventory_items.find(
(i) => i.inventory_item_id === reservation?.inventory_item_id
)?.required_quantity
const reservedQuantityForItem = !reservation
? 0
: reservation?.quantity / (iitemRequiredQuantity || 1)
const locationInventoryLevels = inventory.map((i) => {
const level = i.location_levels?.find(
(inv) => inv.location_id === locationId
)
const requiredQuantity = inventoryItemRequiredQuantityMap.get(i.id)
if (!level || !requiredQuantity) {
return {
availableQuantity: Number.MAX_SAFE_INTEGER,
stockedQuantity: Number.MAX_SAFE_INTEGER,
}
}
const availableQuantity = level.available_quantity / requiredQuantity
const stockedQuantity = level.stocked_quantity / requiredQuantity
return {
availableQuantity,
stockedQuantity,
}
})
const maxAvailableQuantity = Math.min(
...locationInventoryLevels.map((i) => i.availableQuantity)
)
const maxStockedQuantity = Math.min(
...locationInventoryLevels.map((i) => i.stockedQuantity)
)
if (
maxAvailableQuantity === Number.MAX_SAFE_INTEGER ||
maxStockedQuantity === Number.MAX_SAFE_INTEGER
) {
return {}
}
return {
availableQuantity:
locationInventory.available_quantity + reservedQuantityForItem,
inStockQuantity: locationInventory.stocked_quantity,
availableQuantity: Math.floor(
maxAvailableQuantity + reservedQuantityForItem
),
inStockQuantity: Math.floor(maxStockedQuantity),
}
}, [variant, locationId, itemReservedQuantitiesMap])
}, [variant, locationId, reservations])
const minValue = 0
const maxValue = Math.min(
@@ -76,7 +131,7 @@ export function OrderCreateFulfillmentItem({
<div className="bg-ui-bg-subtle shadow-elevation-card-rest my-2 rounded-xl">
<div className="flex flex-row items-center">
{disabled && (
<div className="inline-flex items-center ml-4">
<div className="ml-4 inline-flex items-center">
<Tooltip
content={t("orders.fulfillment.disabledItemTooltip")}
side="top"
@@ -88,8 +143,8 @@ export function OrderCreateFulfillmentItem({
<div
className={clx(
"flex flex-col flex-1 gap-x-2 gap-y-2 border-b p-3 text-sm sm:flex-row",
disabled && "opacity-50 pointer-events-none"
"flex flex-1 flex-col gap-x-2 gap-y-2 border-b p-3 text-sm sm:flex-row",
disabled && "pointer-events-none opacity-50"
)}
>
<div className="flex flex-1 items-center gap-x-3">
packages/admin/dashboard/src/routes/orders/order-detail/components/order-summary-section/order-summary-section.tsx
+3 -1
View File
@@ -397,7 +397,9 @@ const Item = ({
const isInventoryManaged = item.variant?.manage_inventory
const hasInventoryKit =
isInventoryManaged && (item.variant?.inventory_items?.length || 0) > 1
isInventoryManaged &&
((item.variant?.inventory_items?.length || 0) > 1 ||
item.variant?.inventory_items?.some((i) => i.required_quantity > 1))
const hasUnfulfilledItems = item.quantity - item.detail.fulfilled_quantity > 0
return (
packages/admin/dashboard/src/routes/reservations/reservation-list/components/reservation-list-table/use-reservation-table-query.tsx
+2 -1
View File
@@ -13,7 +13,7 @@ export const useReservationTableQuery = ({
prefix
)
const { location_id, created_at, updated_at, quantity, offset, ...rest } = raw
const { location_id, created_at, updated_at, order, offset, ...rest } = raw
const searchParams: HttpTypes.AdminGetReservationsParams = {
limit: pageSize,
@@ -21,6 +21,7 @@ export const useReservationTableQuery = ({
location_id: location_id,
created_at: created_at ? JSON.parse(created_at) : undefined,
updated_at: updated_at ? JSON.parse(updated_at) : undefined,
order: order ?? "-created_at",
...rest,
}