- Get Started
- Product
- Resources
- Tools & SDKs
- Framework
- Reference
- Get Started
- Product
- Resources
- Tools & SDKs
- Framework
- Reference
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 CodeExamples#
Steps#
Workflow Hook
Step conditioned by when
Input#
RefreshCartItemsWorkflowInput
RefreshCartItemsWorkflowInputThe details of the cart to refresh.
RefreshCartItemsWorkflowInput
RefreshCartItemsWorkflowInputcart_id
stringThe cart's ID.
cart_id
stringpromo_codes
string[]OptionalThe promotion codes applied on the cart.
These promotion codes will replace previously applied codes.
promo_codes
string[]OptionalHooks#
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
Input
Handlers consuming this hook accept the following input.
input
objectThe input data for the hook.
input
objectThe data to add a shipping method to a cart.
cart
any
cart
any