190 lines
6.9 KiB
Plaintext
190 lines
6.9 KiB
Plaintext
import { AcademicCapSolid, BoltSolid } from "@medusajs/icons"
|
|
import { LearningPath } from "docs-ui"
|
|
|
|
export const metadata = {
|
|
title: `Order Management System (OMS) Recipe`,
|
|
}
|
|
|
|
# {metadata.title}
|
|
|
|
This recipe provides an overview of Medusa's features and how to use it as an Order Management System (OMS).
|
|
|
|
## Overview
|
|
|
|
Building or integrating an OMS brings certain challenges: accepting orders from different sales channels, tracking inventory across the sales channels, integrating third-party fulfillment and payment providers with the OMS, and more.
|
|
|
|
Medusa's commerce modules and customization toolkit lets you integrate it within a larger ecosystem. The commerce modules provide features to allow businesses to accept orders from any sales channel, benefit from multi-warehouse inventory features, and integrate third-party services for fulfillment, payment, and more.
|
|
|
|
<Note title="Related use-case">
|
|
|
|
[How Siam Makro used Medusa an OMS](https://medusajs.com/blog/makro-pro/).
|
|
|
|
</Note>
|
|
|
|
---
|
|
|
|
## Source Orders into Medusa
|
|
|
|
Sales channels in your commerce ecosystem must route their orders into the OMS.
|
|
|
|
|
|
|
|
Medusa's [Store REST APIs](!api!/store) let you integrate a checkout experience in any storefront. Alternatively, you can use Medusa's [Draft Order APIs](!api!/admin#draft-orders) to place an order without direct involvement from the customer, such as when placing an order through a POS.
|
|
|
|
In addition, you can customize the Medusa application to accept orders through a third-party checkout system. This gives you more flexibility over adding orders to Medusa.
|
|
|
|
For example, you can support importing orders into Medusa through a custom API Route that allows batch-inserting orders. Another example is creating a scheduled job that runs at a specified interval and imports orders from a third-party service.
|
|
|
|
<CardList items={[
|
|
{
|
|
href: "!api!/store#carts",
|
|
title: "Store REST APIs",
|
|
text: "Learn how to use the Store REST APIs to create an order.",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
{
|
|
href: "!docs!/learn/fundamentals/api-routes",
|
|
title: "Create API Route",
|
|
text: "Learn how to create a custom API Route.",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
]} />
|
|
|
|
<Card
|
|
href="!docs!/learn/fundamentals/scheduled-jobs"
|
|
title="Create Scheduled Jobs"
|
|
text="Learn how to create a scheduled job."
|
|
icon={AcademicCapSolid}
|
|
className="mt-1"
|
|
/>
|
|
|
|
---
|
|
|
|
## Route Orders to Third-party Fulfillment Services
|
|
|
|
To integrate third-party fulfillment providers with the Medusa application, create a fulfillment module provider.
|
|
|
|
Medusa uses the Fulfillment Module whenever a fulfillment action is performed, such as when a fulfillment is created for items in an order. The module's main service's methods use the associated fulfillment module provider to handle the desired fulfillment actions.
|
|
|
|
|
|
|
|
In addition, create a subscriber that listen to fulfillment-related events, such as the `order.fulfillment_created` event, to perform actions with the third-party fulfillment provider.
|
|
|
|
<CardList itemsPerRow={2} items={[
|
|
{
|
|
href: "/references/fulfillment/provider",
|
|
title: "Create a Fulfillment Module Provider",
|
|
text: "Learn how to create a fulfillment provider in Medusa.",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
{
|
|
href: "/commerce-modules/order/events",
|
|
title: "Order Events",
|
|
text: "Learn about the events emitted related to the Order Module",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
]} />
|
|
|
|
<Card
|
|
href="!docs!/learn/fundamentals/events-and-subscribers"
|
|
title="Create a Subscriber"
|
|
text="Learn about create a subscriber"
|
|
icon={AcademicCapSolid}
|
|
className="mt-1"
|
|
/>
|
|
|
|
---
|
|
|
|
## Process Payment with Third-Party Providers
|
|
|
|
To integrate third-party payment providers with the Medusa application, create a payment module provider.
|
|
|
|
In addition, create a subscriber that listen to payment-related events, such as the `payment.captured` event, to perform actions in the third-party payment provider.
|
|
|
|
<CardList itemsPerRow={2} items={[
|
|
{
|
|
href: "/references/payment/provider",
|
|
title: "Create a Payment Module Provider",
|
|
text: "Learn how to create a payment module provider.",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
{
|
|
href: "/commerce-modules/payment/events",
|
|
title: "Payment Events",
|
|
text: "Learn about the events emitted related to the Payment Module",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
]} />
|
|
|
|
<Card
|
|
href="!docs!/learn/fundamentals/events-and-subscribers"
|
|
title="Create a Subscriber"
|
|
text="Learn about create a subscriber"
|
|
icon={AcademicCapSolid}
|
|
className="mt-1"
|
|
/>
|
|
|
|
---
|
|
|
|
## Track Inventory Across Sales Channels
|
|
|
|
Medusa's Inventory, Stock Location, and Sales Channel modules allow merchants to track inventory levels tied to sales channels across stock locations.
|
|
|
|
When an order is placed, the item's quantity is reserved from the stock location associated with the order's sales channel. Once the item is fulfilled, the reserved quantity is deducted from the item's inventory quantity.
|
|
|
|
<CardList items={[
|
|
{
|
|
href: "/commerce-modules/inventory",
|
|
title: "Inventory Module",
|
|
text: "Learn about the Inventory Module's concepts and features.",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
{
|
|
href: "/commerce-modules/stock-location",
|
|
title: "Stock Location Module",
|
|
text: "Learn about the Stock Location Module's concepts and features.",
|
|
icon: AcademicCapSolid,
|
|
}
|
|
]} />
|
|
|
|
<Card
|
|
href="/commerce-modules/sales-channel"
|
|
title="Sales Channel Module"
|
|
text="Learn about the Sales Channel Module's concepts and features."
|
|
icon={AcademicCapSolid}
|
|
className="mt-1"
|
|
/>
|
|
|
|
---
|
|
|
|
## Handle Returns, Exchanges, and Changes
|
|
|
|
In Medusa, items in an order can be returned or exchanged. A merchant can also edit an order to add, update, or delete items.
|
|
|
|
When changes are made to an order by any of the mentioned actions, the changes are reflected on the order's totals and associated inventory. The integrated fulfillment and payment module providers are used if fulfillment or payment actions are required, such as fulfilling exchanged items.
|
|
|
|
Medusa also emits events related to these actions, such as `order.return_requested`. So, you can create a subscriber that listens to these events and perform asynchronous actions, such as communicating with third-party services.
|
|
|
|
<CardList items={[
|
|
{
|
|
href: "/commerce-modules/order/order-change",
|
|
title: "Order Changes",
|
|
text: "Learn about how to use order changes.",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
{
|
|
href: "/commerce-modules/order/events",
|
|
title: "Order Events",
|
|
text: "Learn about the events emitted related to the Order Module",
|
|
icon: AcademicCapSolid,
|
|
},
|
|
]} />
|
|
|
|
<Card
|
|
href="!docs!/learn/fundamentals/events-and-subscribers"
|
|
title="Create a Subscriber"
|
|
text="Learn about create a subscriber"
|
|
icon={AcademicCapSolid}
|
|
className="mt-1"
|
|
/>
|