receiveAndCompleteReturnOrderWorkflow - Medusa Core Workflows Reference

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

This workflow marks a return as received and completes it.

You can use this workflow within your customizations or your own custom workflows, allowing you to receive and complete a return.

Source Code

Examples#

src/api/workflow/route.ts
1import type {2  MedusaRequest,3  MedusaResponse,4} from "@medusajs/framework/http"5import { receiveAndCompleteReturnOrderWorkflow } from "@medusajs/medusa/core-flows"6
7export async function POST(8  req: MedusaRequest,9  res: MedusaResponse10) {11  const { result } = await receiveAndCompleteReturnOrderWorkflow(req.scope)12    .run({13      input: {14        return_id: "return_123",15        items: [{16          id: "orli_123",17          quantity: 1,18        }]19      }20    })21
22  res.send(result)23}

Steps#

Workflow hook

Step conditioned by when

View step details

Input#

ReceiveCompleteOrderReturnWorkflowInputReceiveCompleteOrderReturnWorkflowInput
return_idstring
The ID of the return to receive and complete.
The received items.
created_bystringOptional
The ID of the user that's receiving and completing the return.
descriptionstringOptional
Description of the return receival.
internal_notestringOptional
A note viewed by admins only related to the return receival.
metadatanull | Record<string, any>Optional
Custom key-value pairs of data to store in the return receival.

Output#

undefined | ReturnDTOundefined | ReturnDTO
undefined | ReturnDTOundefined | ReturnDTO
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