createOrderChangeWorkflow - Medusa Core Workflows Reference

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

This workflow creates an order change.

You can use this workflow within your customizations or your own custom workflows, allowing you to wrap custom logic around creating an order change.

Source Code

Examples#

Steps#

Workflow hook

Step conditioned by when

View step details

Input#

CreateOrderChangeDTOCreateOrderChangeDTO
The data of the order change to be created.
order_idstring
The associated order's ID.
return_idstringOptional
The associated return's ID.
claim_idstringOptional
The associated claim's ID.
exchange_idstringOptional
The associated exchange's ID.
change_typeOrderChangeTypeOptional
The type of the order change.
descriptionstringOptional
The description of the order change.
internal_notenull | stringOptional
The internal note of the order change.
requested_bystringOptional
The user or customer that requested the order change.
requested_atDateOptional
The date that the order change was requested.
created_bynull | stringOptional
The user that created the order change.
metadatanull | Record<string, unknown>Optional
Holds custom data in key-value pairs.
The actions of the order change.

Output#

OrderChangeDTOOrderChangeDTO
The order change details.
idstring
The ID of the order change
versionnumber
The version of the order change
order_idstring
The ID of the associated order
return_idstring
The ID of the associated return order
exchange_idstring
The ID of the associated exchange order
claim_idstring
The ID of the associated claim order
The associated order
return_orderReturnDTO
The associated return order
The associated exchange order
The associated claim order
The actions of the order change
The status of the order change
requested_bynull | string
The requested by of the order change
requested_atnull | string | Date
When the order change was requested
confirmed_bynull | string
The confirmed by of the order change
confirmed_atnull | string | Date
When the order change was confirmed
declined_bynull | string
The declined by of the order change
declined_reasonnull | string
The declined reason of the order change
metadatanull | Record<string, unknown>
The metadata of the order change
declined_atnull | string | Date
When the order change was declined
canceled_bynull | string
The canceled by of the order change
canceled_atnull | string | Date
When the order change was canceled
created_atstring | Date
When the order change was created
updated_atstring | Date
When the order change was updated
change_type"return" | "exchange" | "claim" | "edit" | "transfer"Optional
The type of the order change
Was this page helpful?
Ask Anything
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break