Skip to main content
Skip to main content

ProductVariantInventoryService

internal.internal.ProductVariantInventoryService

Properties​

__configModule__Record<string, unknown>
__container__anyRequired
__moduleDeclaration__Record<string, unknown>
cacheService_ICacheServiceRequired
eventBusService_IEventBusServiceRequired
getAvailabilityContextanyRequired
inventoryService_IInventoryServiceRequired
manager_EntityManagerRequired
productVariantService_ProductVariantServiceRequired
salesChannelInventoryService_SalesChannelInventoryServiceRequired
salesChannelLocationService_SalesChannelLocationServiceRequired
stockLocationService_IStockLocationServiceRequired
transactionManager_undefined | EntityManagerRequired

Accessors​

activeManager_​

Protected get activeManager_(): EntityManager

Returns​

EntityManager

EntityManagerEntityManagerRequired

Inherited from​

TransactionBaseService.activeManager_

Methods​

adjustInventory​

adjustInventory(variantId, locationId, quantity): Promise<void>

Adjusts inventory of a variant on a location

Parameters​

variantIdstringRequired
variant id
locationIdstringRequired
location id
quantitynumberRequired
quantity to adjust

Returns​

Promise<void>

PromisePromise<void>Required

adjustReservationsQuantityByLineItem​

adjustReservationsQuantityByLineItem(lineItemId, variantId, locationId, quantity): Promise<void>

Adjusts the quantity of reservations for a line item by a given amount.

Parameters​

lineItemIdstringRequired
The ID of the line item
variantIdstringRequired
The ID of the variant
locationIdstringRequired
The ID of the location to prefer adjusting quantities at
quantitynumberRequired
The amount to adjust the quantity by

Returns​

Promise<void>

PromisePromise<void>Required

atomicPhase_​

Protected atomicPhase_<TResult, TError>(work, isolationOrErrorHandler?, maybeErrorHandlerOrDontFail?): Promise<TResult>

Wraps some work within a transactional block. If the service already has a transaction manager attached this will be reused, otherwise a new transaction manager is created.

TResultobjectRequired
TErrorobjectRequired

Parameters​

work(transactionManager: EntityManager) => Promise<TResult>Required
the transactional work to be done
isolationOrErrorHandlerIsolationLevel | (error: TError) => Promise<void | TResult>
the isolation level to be used for the work.
maybeErrorHandlerOrDontFail(error: TError) => Promise<void | TResult>
Potential error handler

Returns​

Promise<TResult>

PromisePromise<TResult>Required
the result of the transactional work

Inherited from​

TransactionBaseService.atomicPhase_

attachInventoryItem​

attachInventoryItem(attachments): Promise<ProductVariantInventoryItem[]>

Attach a variant to an inventory item

Parameters​

attachments{ inventoryItemId: string ; requiredQuantity?: number ; variantId: string }[]Required

Returns​

Promise<ProductVariantInventoryItem[]>

PromisePromise<ProductVariantInventoryItem[]>Required
the variant inventory item

attachInventoryItem(variantId, inventoryItemId, requiredQuantity?): Promise<ProductVariantInventoryItem[]>

Parameters​

variantIdstringRequired
inventoryItemIdstringRequired
requiredQuantitynumber

Returns​

Promise<ProductVariantInventoryItem[]>

PromisePromise<ProductVariantInventoryItem[]>Required

confirmInventory​

confirmInventory(variantId, quantity, context?): Promise<Boolean>

confirms if requested inventory is available

Parameters​

variantIdstringRequired
id of the variant to confirm inventory for
quantitynumberRequired
quantity of inventory to confirm is available
contextobject
optionally include a sales channel if applicable
context.salesChannelIdnull | string

Returns​

Promise<Boolean>

PromisePromise<Boolean>Required
boolean indicating if inventory is available

deleteReservationsByLineItem​

deleteReservationsByLineItem(lineItemId, variantId, quantity): Promise<void>

delete a reservation of variant quantity

Parameters​

lineItemIdstring | string[]Required
line item id
variantIdstringRequired
variant id
quantitynumberRequired
quantity to release

Returns​

Promise<void>

PromisePromise<void>Required

detachInventoryItem​

detachInventoryItem(inventoryItemId, variantId?): Promise<void>

Remove a variant from an inventory item

Parameters​

inventoryItemIdstringRequired
inventory item id
variantIdstring
variant id or undefined if all the variants will be affected

Returns​

Promise<void>

PromisePromise<void>Required

getVariantQuantityFromVariantInventoryItems​

getVariantQuantityFromVariantInventoryItems(variantInventoryItems, channelId): Promise<number>

Get the quantity of a variant from a list of variantInventoryItems The inventory quantity of the variant should be equal to the inventory item with the smallest stock, adjusted for quantity required to fulfill the given variant.

Parameters​

variantInventoryItemsProductVariantInventoryItem[]Required
List of inventoryItems for a given variant, These must all be for the same variant
channelIdstringRequired
Sales channel id to fetch availability for

Returns​

Promise<number>

PromisePromise<number>Required
The available quantity of the variant from the inventoryItems

listByItem​

listByItem(itemIds): Promise<ProductVariantInventoryItem[]>

list registered inventory items

Parameters​

itemIdsstring[]Required
list inventory item ids

Returns​

Promise<ProductVariantInventoryItem[]>

PromisePromise<ProductVariantInventoryItem[]>Required
list of inventory items

listByVariant​

listByVariant(variantId): Promise<ProductVariantInventoryItem[]>

List inventory items for a specific variant

Parameters​

variantIdstring | string[]Required
variant id

Returns​

Promise<ProductVariantInventoryItem[]>

PromisePromise<ProductVariantInventoryItem[]>Required
variant inventory items for the variant id

listInventoryItemsByVariant​

listInventoryItemsByVariant(variantId): Promise<InventoryItemDTO[]>

lists inventory items for a given variant

Parameters​

variantIdstringRequired
variant id

Returns​

Promise<InventoryItemDTO[]>

PromisePromise<InventoryItemDTO[]>Required
lidt of inventory items for the variant

listVariantsByItem​

listVariantsByItem(itemId): Promise<ProductVariant[]>

lists variant by inventory item id

Parameters​

itemIdstringRequired
item id

Returns​

Promise<ProductVariant[]>

PromisePromise<ProductVariant[]>Required
a list of product variants that are associated with the item id

reserveQuantity​

reserveQuantity(variantId, quantity, context?): Promise<void | ReservationItemDTO[]>

Reserves a quantity of a variant

Parameters​

variantIdstringRequired
variant id
quantitynumberRequired
quantity to reserve
contextReserveQuantityContext
optional parameters

Returns​

Promise<void | ReservationItemDTO[]>

PromisePromise<void | ReservationItemDTO[]>Required

retrieve​

retrieve(inventoryItemId, variantId): Promise<ProductVariantInventoryItem>

Retrieves a product variant inventory item by its inventory item ID and variant ID.

Parameters​

inventoryItemIdstringRequired
The ID of the inventory item to retrieve.
variantIdstringRequired
The ID of the variant to retrieve.

Returns​

Promise<ProductVariantInventoryItem>

PromisePromise<ProductVariantInventoryItem>Required
A promise that resolves with the product variant inventory item.

setProductAvailability​

setProductAvailability(products, salesChannelId): Promise<(Product | PricedProduct)[]>

Parameters​

products(Product | PricedProduct)[]Required
salesChannelIdundefined | string | string[]Required

Returns​

Promise<(Product | PricedProduct)[]>

PromisePromise<(Product | PricedProduct)[]>Required

setVariantAvailability​

setVariantAvailability(variants, salesChannelId, availabilityContext?): Promise<ProductVariant[] | PricedVariant[]>

Parameters​

variantsProductVariant[] | PricedVariant[]Required
salesChannelIdundefined | string | string[]Required
availabilityContextAvailabilityContext

Returns​

Promise<ProductVariant[] | PricedVariant[]>

PromisePromise<ProductVariant[] | PricedVariant[]>Required

shouldRetryTransaction_​

Protected shouldRetryTransaction_(err): boolean

Parameters​

errRecord<string, unknown> | { code: string }Required

Returns​

boolean

booleanboolean

Inherited from​

TransactionBaseService.shouldRetryTransaction_

validateInventoryAtLocation​

validateInventoryAtLocation(items, locationId): Promise<void>

Validate stock at a location for fulfillment items

Parameters​

itemsOmit<LineItem, "beforeInsert">[]Required
Fulfillment Line items to validate quantities for
locationIdstringRequired
Location to validate stock at

Returns​

Promise<void>

PromisePromise<void>Required
nothing if successful, throws error if not

withTransaction​

withTransaction(transactionManager?): ProductVariantInventoryService

Parameters​

transactionManagerEntityManager

Returns​

ProductVariantInventoryService

ProductVariantInventoryServiceProductVariantInventoryServiceRequired

Inherited from​

TransactionBaseService.withTransaction

Was this section helpful?
© 2023 Medusa, Inc. All rights reserved.