1. Category and Attributes

The first thing to do for pushing/uploading OMS products to the marketplace is to pull the marketplace categories and attributes. Pulling product categories is retrieving product categories from all registered marketplaces. This action will require Marketplace (MP) Adapter to do action. Here is the flow for pulling product category:



To pull category from the marketplace, here is the guide:

  1. Click on the Pull Category button and please wait for the process to finish. You can check the current progress on the
    Tools > CLI Tools menu.

  2. Another option for pulling categories is to use CLI in the terminal, just type this command:
    php bin/magento swiftoms:mpadapter:pull-product-category

  3. After marketplace categories are pulled. Enable the categories that you want to use by clicking on the Update Status
    button.


  1. The template CSV for updating category status can be downloaded by clicking on the Download the Sample CSV.


  1. Open the sample CSV file on any supported application and edit data as needed. Please note that the file to upload is
    using comma-separated values. The first row is the column name and below it are category data. For example:

Marketplace Code,"Marketplace Category Name",Status

SHPE,"Books & Magazines > Books > Business & Investment",0

SHPE,"Books & Magazines > E-Books",0

For Status column, “0” is to disable the category while values “1” is to enable product category.

  1. To upload a CSV file, click Choose File button and select the file you have edited earlier. Click on the Submit button to
    upload the file and please wait until the update process is complete. 



  1. Attributes Mapping

After pulling & enabling product categories, the next step for pushing products to the marketplace is mapping marketplace category attributes to SWIFT OMS attributes.

  1. On the Marketplace > Product Attribute Mapping menu, click Add New Mapping button.


  1. Select the marketplace that you want to add a mapping, then select the category that you have updated status to
    active. After that, the Product Attributes will reload its options.


  1. Click Show mandatory attributes to show the attributes list below the form.


  • Mandatory attributes are the main attribute that you need to map to SWIFT OMS attributes. If you miss one
    of these attributes, the process of pushing the product to the marketplace will be failed.

  • Other attributes besides the mandatory attributes are optional, it depends on your need or requirements.

  1. Select Product Attribute on Marketplace Data and select Product Attribute on Mapping To (SWIFT OMS).

  2. Click Submit and repeat all the processes you need.


  1. Set Attribute Value

After attribute mapping, the next step for pushing the product to the marketplace is select the product you want to push and set the attribute value that you have set the mapping.

  1. Go to Catalog > Products menu, click View on the product that you want to push to the marketplace in the Action
    column.


  1. On product detail page, set the value of the attribute that you have mapped.


  1. Besides that, you need to select marketplace channel where you want to push this product.


  1. After all mandatory fields are filled, click submit to save product data. Repeat all processes for all products that
    you want to push.

  2. Lastly, run CLI on terminal to push product to marketplace:

php bin/magento swiftoms:mpadapter:push-product


  1. To get the response you need to run this CLI on terminal:

php bin/magento swiftoms:mpadapter:pull-feedback --feedback-type bulk_create_product