How-To: Upgrade Spryker instance to the Marketplace

Edit on GitHub

This article provides details on how to upgrade the existing instance of Spryker Shop to the Marketplace.

1) Add core features

Implement the features and functionality of the Marketplace by following the integration guides from the table below.

FEATURE DESCRIPTION
Marketplace Merchant The Marketplace Merchant feature allows you to create, read, and update a merchant in the Spryker Marketplace project.
Merchant Opening Hours Merchant Opening Hours is a feature that allows a merchant to store their working hours in the system where they can be retrieved for customers. Every merchant has a Weekday Schedule, meaning a daily schedule for every day of the week, as well as date-based exceptions for specific dates, such as during the holiday season.
Merchant Category The Merchant Category feature allows splitting merchants into various categories in order to extend business logic of the project.
Marketplace Product Adds merchant information to the product that a merchant sells. Such products are called marketplace products.
Marketplace Product Offer Merchant offers are new entities that allow a Merchant to sell their products on the Marketplace. A merchant who wants to sell an existing product creates a Merchant Offer for it if it already exists in the system. An offer from a merchant relates to a specific product and may contain details such as price, stock, status, etc.
Marketplace Product Offer Prices Marketplace merchants can define custom prices for product offers with Marketplace Product Offer Prices.
Marketplace Product Options This feature allows merchants to create their own product option groups and values.
Marketplace Inventory Management The Marketplace Inventory Management implies Stock & Availability Management as well as Multiple Warehouse Stock Management for product offers and merchant products.
Marketplace Wishlist With the Marketplace Wishlist feature, the customers can track and save merchant offers and products they wish to purchase through the wishlist. The customers can create multiple wishlists and customize their names.
Marketplace Cart The Marketplace Cart feature allows you to include a “Notes” field on the cart page. Buyers can add notes to a particular item or the whole cart, for example, some special instructions about how to prepare and deliver an order.
Marketplace Promotions & Discounts With the Marketplace Promotions and Discounts feature, the discounts are correctly applied to the merchant orders.
Marketplace Order Management With the Marketplace Order Management, default orders that contain additional information about the merchants are called Marketplace orders. In turn, every merchant can view and manage only the orders that are related to their items. Such orders are called merchant orders.
Marketplace Shipment The Marketplace orders are split into several shipments based on the merchants from which the items were bought. Merchants can see their shipments only.
Marketplace Return Management Order returns management enhancement for OMS.

2) Add MerchantPortal features

Follow feature integration guides from the table that provides functionality for MerchantPortal Application.

FEATURE DESCRIPTION
Marketplace Merchant Portal Core Marketplace MerchantPortal Core enables server configuration and the basic functionality of the Merchant Portal such as security login.
Marketplace Merchant Portal Product Management Merchants can manage their products in the Merchant Portal.
Marketplace Merchant Portal Product Offer Management Merchants can manage their product offers in the Merchant Portal.
Marketplace Merchant Portal Product Option Management Extends the order items with related product options in the Merchant Portal.
Marketplace Merchant Portal Order Management Allows merchants to manage their orders in the Merchant Portal.
ACL Allows managing access to HTTP endpoints and Persistence entities.

3) Build app

Please rebuild your app in order to apply all the changes regarding database entities, data imports, search engine indexes, UI assets, etc. Depending on the virtualization solution you use, follow the recommendations below.