Royal Cyber Inc. Mirakl Connectors

Pre-built connections for Mirakl to commercetools that eliminate tedious custom platform integrations

Product Description

It’s challenging to take care of multiple factors for launching new products like building your own marketplaces, technical glitches, costings issues etc.

It can be addressed by leveraging the capabilities of Commercetools and Mirakl marketplace by using various connectors.

These Connectors help to build a Marketplace utilizing the best of the features of both commerce tools and Mirakl.

These Connector Apps for commercetools and Mirakl use SDK’s of both the platforms to provide a smart, pre-built connection that eliminates tedious custom platform integrations.

·        Mirakl to Commercetools Product Sync Connector – Sync the products, categories, product-types, Channels in Mirakl with the commercetools. All those products will be available on PLP in Storefront application.

·        Commercetools to Mirakl Order Sync Connector - Once an order is placed in commerce tools, order details are sent to Mirakl as well. Business can use those details for their specific business needs like analysis of customer behavior, auditing etc.

·        Mirakl Products Price Connector - Fetches Prices/offers of products from various sellers from Mirakl while can then be displayed on PDP in Storefront application.

Integration Description

These connectors work in between Commercetools and Mirakl.

High Level Overview of process from Mirakl’s side:

·        Sellers will create new products from the seller portal of Mirakl.

·        If it’s a new product, it will then go through various phases like Mirakl Catalog Integrator and Mirakl Catalog Manager wherein validation and transformation of provided product data takes place and finally it goes to Operators, who will login with Operator portal and then validate the details and then approve it in system.

·        It will then be picked by synchronization service and then it will be launched on Mirakl Marketplace.

·        Post than various sellers can search for this product in Mirakl Marketplace (or even any existing product as well) and provide their respective offers for the product.

Connectors acting as a Bridge between commercetools and Mirakl:

·       Sync the products in Mirakl with Commercetools

o   Sync the products in Mirakl with Commercetools when seller adds new product in Mirakl.

o   “Mirakl-ct-product-sync-connector” service syncs all the Product, product types, channels and Category data from Mirakl to Commercetools.

o   These products can then be displayed to user on store front App on product Landing page.

o   Sync will happen in regular intervals of time by scheduler service. It will also configure Commercetools project settings for creating Zones, language, taxes, and Shipping method. All of them are configured in properties.

o   The default Tax category is configured for zero tax as all tax related aspects will be taken care of in Mirakl system only. It is assumed that final price that has been offered by seller considers the taxation as well in that price only.

o   Fields which gets Sync in Commerce tools

§  Category

·        Name (EN)

·        Slug

·        Key

·        Parent

·        Custom à to add category_image

§  Product-type

·        Name

·        Description

·        Key


§  Product

·        product Type à CT-Mirakl-product-type

·        name

·        slug

·        variant List

·        key

·        categories

§  Channel

·        Key

·        Name

·        Description

·        Roles

·       Fetch Price of product and seller information from Mirakl

o   This is Rest API service which is responsible for fetching all the price and seller details for the given product when user lands on product details page.

o   Once user selects and product, respective SKU will be used to fetch the price from Mirakl using the “Mirakl-product-price-api” service which will fetch all available offer from various sellers for given product, which can then be displayed to user on product details page.

o   Users can select any of those offers from various sellers and place an order. And this will trigger another connector “Mirakl-order-sync-subscription” to sync the order details from commercetools to Mirakl.

o   product_ids are comma separated.

o   Sample Request:

POST /product-prices HTTP/1.1

authorization: secure

Content-Type: application/json

{"product_ids": "sku_abiraterone,diningtable-sku"} 

·       Commercetools Orders sync with Mirakl

o   This service which will work as Commercetools pub/sub subscription to sync order Commercetools to Mirakl

o   Users can select any of those offers from various sellers and place an order. And this will trigger another connector “Mirakl-order-sync-subscription” to sync the order details from commercetools to Mirakl.

o   Fields in Mirakl getting populated from Commercetools.

§  Customer à from commercetools

·        Id

·        FirstName

·        Last Name

·        Email

·        Locale

·        Civility

·        Shipping Address

o   FirstName

o   Last Name

o   Country

o   CountryIsoCode à USA

o   street Name

o   street Number

o   civility

o   company

o   zip code

o   state

o   city

·        billingAddress à same as shipping address

·        CommercialId

§  commercialId à CT OrderId

§  offers à Quantity and offerId from CT lineItem

§  OrderTaxMode -> TAX_EXCLUDED

§  PaymentsWorkFlow à PAY_ON_ACCEPTANCE

§  Scored à TRUE

§  ShippingZoneCode à USA

CustomerDirectlyPaysSeller à FALSE