Go to Configurations > Marketplace Adapter menu to set configuration:

A. General

  • Enable Lock Process: Lock process is related to Cron and CLI MP Adapter. This enable setting is used for non-GCP servers. For GCP servers there is no need to enable the locking process.

  • Slack Notification: Status notifications are sent to Slack associated with the MP Adapter.



B. Marketplace

  • Variant Attribute Setting: Set the minimum and maximum variant attribute that is required for product push.
    To add a new marketplace, click     ADD button then add values for Marketplace Code, Minimum Variant Attribute, and Maximum Variant Attribute.
    For example:

          To delete specific input, click on the icon.

  • Max. Retry On Update Order Status: Set max retry on update order status that applies once a day. Each marketplace has different limits.
    To add a new marketplace, click     ADD button then add values for Marketplace Code and Max Retry.
    For example:


          To delete specific input, click on the icon.

  • Shipping Method List: You can add more shipping methods to this list by clicking on the ADD button and adding Marketplace Code and Shipping Method. To delete specific input, click on the icon.


C. API Config


  • Production Mode: Used to set whether the MP Adapter is in Production or Staging mode.
    You need to coordinate with the MP Adapter Developer to get the Config API. By default, the Developer has set up the Config API to be used. The Config API can also be obtained from Team Zeus Squad.

  • The other configurations are optional. It can be set depending on project requirements such as enable/disable Pull Order (for fetching order), enable/disable Update Stock, etc. To save the configuration, click Submit button at the bottom of the page.
D. Export Config
  • Set file path format that is used to export product data using Rapidflow.


E. Product 


  • Enable Pull Product: Select Yes to enable pull products from the marketplace. To disable this option, select No.

  • Enable Push Product: Select Yes to enable push products to the marketplace. To disable this option, select No.

  • Enable Feedback Push Product: Select Yes to enable feedback when pushing products to the marketplace. To disable this option, select No.

  • Enable Feedback Push Promotion: Select Yes to enable feedback when pushing promotion to the marketplace. To disable this option, select No.

  • Enable Fetch API History: Select Yes to enable fetch API history. To disable this option, select No.

  • Uppercase SKU: Select Yes to allow uppercase in SKU and select No to not allow it.

  • Check Suffix SKU from Order: Select Yes to enable suffix checking on SKU from order. To disable this option, select No.

  • Enable Fetch Category API History: Select Yes to enable fetch category API history. To disable this option, select No.

  • Enable Pull Save CSV: Select Yes to enable pull save CSV. To disable this option, select No.

  • Split Bulk Push Product Data: Select Yes to split bulk when pushing product data. To disable this option, select No.

  • Split Bulk Push Product Promo Data: Select Yes to split bulk when pushing product promo data. To disable this option, select No.

  • Split Bulk Push Product Price Data: Select Yes to split bulk when pushing product price data. To disable this option, select No.



F. Inventory
  • Enable Update Stock: Select Yes to enable update stock or select No to disable it. If set to No, there will be no data updates from SWIFT OMS resulting in order data in Marketplace and SWIFT OMS being out of sync.

  • Enable Feedback Update Stock: Select Yes to enable feedback when updating stock or select No to disable it.

  • Enable Auto Update Override Stock: By default, this option is disabled. If enabled, the stock override will be pushed continuously.

  • Enable Feedback Update API History: Select Yes to enable feedback when updating API history or select No to disable it.

  • Global Buffer: The default option is No. This is used for Stock pull buffers.

  • Global Buffer Value: Set value for global buffer in this field.

  • Split Bulk Update Stock Data: Select Yes to split bulk when updating stock data. To disable this option, select No.

  • Update Stock Active Product Only: Select Yes to enable stock update only on the active products. To disable this option, select No.


G. Order

Available configurations for marketplace order:

  • Enable Pull Order: Select Yes to enable pull order or select No to disable it.

  • Enable Update Order: Select Yes to enable update order or select No to disable it.

  • Enable Feedback Update Status: Used to update order data. If it is set to No, the data is not updated from SWIFT OMS resulting in the order data in Marketplace and SWIFT OMS being out of sync. Feedbacks include Accept Order, Pack Order, Complete Order, and Cancel Order.

  • Enable Order Fetch API History: Used for debugging, checking incoming data to SWIFT OMS. The default is No, except for investigating the issue.

  • Order Migrate From Connexi: Converting for incoming data from Connexi. Select "Yes" to migrate the existing order from Connexi to MP Adapter.

  • Enable Retry Update Order Status: It will help to automatically repeat data updates using Cron if the previous data update failed. This will reduce the status update action to the marketplace. Select Yes to enable retry on updating order status or select No to disable it.

  • Only Retry Pack Order With AWB Source TRUE: Select Yes to enable retry pack order only on AWB source “True”. Set to "No" for retrying pack on all AWB source values (true, false, null).

  • Default Shipping Method: Set the default shipping method if no option is selected. To add a new shipping method, click ADD button then add values for Marketplace Code and Shipping Method.
    For example:

    To delete specific input, click on the icon.

  • Courier Options for Custom Logistik: Set options for custom logistics. 
    To add a new shipping method, click     ADD button then add values for Title and Code.
    For example:

    To delete specific input, click on the icon.

  • Default Courier for Custom Logistik: Select the default courier for custom logistics.

  • Item Discount Mapping To: On pull product, set item discount amount mapping to your desired param. The default value is "voucher", please refer to this doc https://mp-adapter.srcli.xyz/#order-fetched for more options.
    To change the value, uncheck the Use system value then enter a new value.

TOPICS (PUB/SUB)

  • Enable Automatically Update Null Value: By default, this option is enabled. Columns to be updated are Channel Order Increment ID, Channel Code, Channel Name, and Marketplace Order Number. If you want to disable it, uncheck the Use system value and select No.

  • Cron Type: By default, the system uses the Magento Cron type. To select another option, uncheck the Use system value and select a new option.


H. Weaver Integration
Used for integration between Winner and Woody.
  1. Enable Weaver and Debug Mode
    To enable weaver service in SWIFT OMS, uncheck Use system value and select Yes in Enable field. If you want to enable Debug Mode, set the option to Yes. Otherwise, set those values to No to disable it.
  2. General information
    - Project ID    : ID of the project.
    - Service Account: Full path for the service account in JSON file.
    - Limit: The default value for the limit is 100. To change the value, uncheck the Use system value and add the new value as needed.
  3. Topics (PUB/SUB)
    In this section you can set topics (pub/sub) for each field (Export Order, Cancel Order, Export AWB, Export Return, and Rename Cancel Order).
  4. Delivery Order
    For delivery order, set value in Topic and Subscription field then select the channel that allowed to be updated in Update Status to Delivered field.
  5. Good received
    For received good (ordered items), set values on Topic and Subscription fields.