Assets & Services

Medusa Assets & Services Plugin

A Medusa.js plugin for managing customer-linked product instances and service subscriptions.

Overview

The assets-services plugin extends Medusa with the ability to manage physical product instances (assets) and related service subscriptions (service instances) linked to individual customers. It supports a wide range of after-sales and post-purchase use cases, such as:

• Assigning products (with serial numbers) to customers
• Attaching services to assets (e.g. maintenance plans, insurance, calibration)
• Selling standalone services (e.g. rentals, diagnostics)
• Managing product relationships (e.g. compatible services, spare parts)

The plugin enhances the Medusa admin interface with new panels for managing assets, services, and product references, enabling rich linking and management flows.

This plugin is used in Open Self Service, a composable customer portal for viewing and managing owned products, warranties, and activating additional services. You can also use the plugin independently.

Installation

1. Install plugin package

   yarn add @o2s/medusa-plugin-assets-services

2. Register plugin in medusa-config.js

   1...
   2 plugins: [
   3     {
   4         resolve: "@o2s/medusa-plugin-assets-services",
   5         options: {}
   6     }
   7 ]
   8 ...

3. Run DB migrations - This plugin introduces new models in database so you need to execute db migration

   npx medusa db:migrate

Features

Asset Management

• Register purchased product instances per customer
• Track serial numbers, warranty dates, and installation addresses
• Link to product variants and optionally store thumbnails

Service Instance Management

• Create/manage service subscriptions (linked to assets or standalone)
• Supports various billing models: one-time, weekly, monthly, yearly
• Statuses: Active / Inactive / Retired

Product References

• Define references such as:
  • SPARE_PART
  • COMPATIBLE_SERVICE
• Easily attach compatible services or accessories

Admin Interface Extensions

• Adds new admin menu entries:
  • Assets
  • Services
• Adds a new component on the product variant page to manage product references
• "Deep-linking" between assets, services, and products

Compatibility

• Medusa version >= 2.4.0

Known Issues

• Unlinking the last asset from a service instance currently fails.

Used In: Open Self Service

Although this plugin is generic and can be used independently, it was developed to power one of core backend functionalities of Open Self Service, a frontend portal that allows customers to:

• Browse and manage their purchased assets
• Check product status and warranty
• View and activate compatible service plans

Explore the Open Self Service project to see how this plugin supports real-world industrial self-service scenarios.

Docs

You can find admin API definition in repo files.

Models schema

Services & Assets

1---
2  config:
3    class:
4      hideEmptyMembersBox: true
5---
6classDiagram
7    ServiceInstance --> PaymentTypeEnum : has
8    ServiceInstance --> ServiceItemStatusEnum : has
9
10    ServiceInstance "0..*" <--> "0..*" Asset
11
12    ServiceInstance "1" --> "1" ProductVariant
13
14    Asset "1" --> "1" Address
15
16    Asset "1" --> "1" Customer
17
18    ServiceInstance "1" --> "1" Customer
19
20    Asset "1" --> "1" ProductVariant
21
22    ProductVariant "1" --> "0..*" ProductReference
23
24    ProductReference --> ProductVariant_
25
26    class ServiceInstance{
27        String name
28        Date startDate
29        Date endDate
30        Date purchaseDate
31        Price price
32    }
33
34    class PaymentTypeEnum{
35        ONE_TIME
36        WEEKLY
37        MONTHLY
38        YEARLY
39    }
40
41    class ServiceItemStatusEnum{
42        ACTIVE
43        INACTIVE
44        RETIRED
45    }
46
47    class Asset{
48        String name
49        String serialNumber
50        String thumbnail
51        Date endOfWarranty
52    }
53
54    class Address{
55    }
56
57    class ProductVariant{
58
59    }
60
61    class Customer{
62
63    }
64
65    class ProductReference{
66        SPARE_PART
67        COMPATIBLE_SERVICE
68    }