refreshCartItemsWorkflow - Medusa Core Workflows Reference

This documentation provides a reference to the refreshCartItemsWorkflow. It belongs to the @medusajs/medusa/core-flows package.

This workflow refreshes a cart to ensure its prices, promotion codes, taxes, and other details are applied correctly. It's useful after making a chnge to a cart, such as after adding an item to the cart or adding a promotion code.

This workflow is used by other cart-related workflows, such as the addToCartWorkflow after an item is added to the cart.

You can use this workflow within your own customizations or custom workflows, allowing you to refresh the cart after making updates to it in your custom flows.

Source Code

Examples#

Steps#

Input#

RefreshCartItemsWorkflowInputRefreshCartItemsWorkflowInput
The details of the cart to refresh.
cart_idstring
The cart's ID.
promo_codesstring[]Optional
The promotion codes applied on the cart. These promotion codes will replace previously applied codes.

Hooks#

Hooks allow you to inject custom functionalities into the workflow. You'll receive data from the workflow, as well as additional data sent through an HTTP request.

Learn more about Hooks and Additional Data.

validate#

This hook is executed before all operations. You can consume this hook to perform any custom validation. If validation fails, you can throw an error to stop the workflow execution.

Example

Code
1import { addShippingMethodToCartWorkflow } from "@medusajs/medusa/core-flows"2
3addShippingMethodToCartWorkflow.hooks.validate(4  (async ({ input, cart }, { container }) => {5    //TODO6  })7)

Input

Handlers consuming this hook accept the following input.

inputobject
The input data for the hook.
The data to add a shipping method to a cart.
cartany
Was this page helpful?