List Order Status MP Adapter:

  • UNPAID: Unpaid order status from Marketplace. This state will not be pulled in SWIFT OMS.

  • PENDING: Order status that has been paid and waiting for confirmation from the seller. 

  • ACCEPTED: Order status that has been received and will be processed by the seller. (Not all Marketplaces have
    this status. Ex: Lazada, Blibli). 

  • CANCELED: Order status that has been canceled via the SWIFT OMS dashboard, customer, or seller center.

  • PACKED: Order status that is ready to be sent to the customer, usually this status will be automatically generated
    AWB from MP, or manually filled in SWIFT OMS if the courier is not supported by the marketplace. If it is not supported
    by the marketplace, it can produce using the booking feature with OMS or Logistix (LGX) which is
    owned by Sirclo. You can see the reference documentation for action orders on         MP Adapter Capabilities.

  • SHIPPED: Order status that has been in the process of being sent to the customer, usually this status definitely has an
    AWB Number:

  • COMPLETED: Order status whose order has been received by the customer.

  • OTHER: Order status that the MP Adapter has not been able to map from the statuses listed above.


Pull Order (Create New Order)

Pull Order will retrieve data from the Pub-Sub that comes from the MP Adapter in the form of messages. Cron will run every 15 minutes. When going to Pull Order, MP Adapter will pull order data from the marketplace starting only for new data orders or recent data changes.

Pull Order / Create New Order on the MP adapter is only performed in the following states: (pending, other, accepted, packed, shipped, completed).


Pull Exception

With this exception the Message Order will not be stored in the OMS and will be immediately ACK (acknowledged) in the Pubsub because it is considered an invalid order.

  • cutoff date

  • empty line_items

  • status unpaid

  • mp code sirclo: marketplace store sirclo


Order status that can be pulled orders to OMS:

  1. Create New

All orders from the marketplace that have not yet entered the OMS. Orders that have entered the OMS will be pulled orders and the status will be Create New Accepted. 

  1. Update

Status of orders that have entered the OMS.

  1. Canceled

Withdraw orders for canceled order status. For this action, it is possible to perform for each status on an order in Marketplace or OMS. But the channel can also specify the specific status of the order can be canceled.

Accept / Confirm Order

  • The previous order status was Pending to Accepted.

Not all marketplace support accepts orders. Marketplaces that support accepting orders must confirm orders manually.


Pack Order

  • Changing Order Accepted status to Packed.

  • If it is not supported by the marketplace, it can produce using the booking feature with OMS or Logistix (LGX) which owned
    by Sirclo. 

Complete Order

  • COMPLETE ORDER : ['pending','other','accepted','packed','shipped']

  • All order statuses can change or updates can be from Pubsub or manual Triggers. Manual triggering is done by
    completing orders via OMS by admin or user.


Cancel Order


  • Cancel Order can be done if the order status is Pending and Accepted. However, there is a possibility that Cancel
    Order can be done on all order statuses. You can see the documentation reference for the action commands at
    MP Adapter Capabilities.

  • Cancel Order allows you to cancel one of the items in one order. So there is no need to cancel the entire order if
    one item is out of stock. This can happen if one of the items ordered is out of stock.


Cutoff Order Date


The Limit Date Configuration is used if SWIFT OMS only accepts orders formed on the MP Adapter that have a date later than the date stated in the configuration. This Cut Off Date treatment Swiftoms will acknowledge the message in pubsub if it doesn't meet the Cut Off Order Date criteria.

Edit Order

Limitation in Pack and Cancel, because remote_order_item_id is required.

Cron Setup

List of Cron MP Adapter (Description and recommended schedule):

  1. MP Adapter Weaver Publish: Used to export MP Adapter data from Weaver to Woodo. These exports include
    Export Order, Export AWB, Export Cancel Order, Debugging, and Publish Returns.

name: mpadapter-weaver-publish

   suspend: false

   schedule: "* * * * *"

   command:

     - bash

     - -c

   args:

     - "php bin/magento swiftoms:mpadapter:weaver-publish export_order ; php bin/magento swiftoms:mpadapter:weaver-publish export_awb ; php bin/magento swiftoms:mpadapter:weaver-publish cancel_order ; php bin/magento swiftoms:weaver:publish-retur ; php bin/magento swiftoms:mpadapter:weaver-publish-debug"


  1. Pull Product: Used to pull data from pubsub and save in CSV file format.

name: mpadapter-pull-product

   suspend: false

   schedule: "* * * * *"

   command:

     - bash

     - -c

   args:

"php bin/magento swiftoms:mpadapter:pull-product ; php bin/magento swiftoms:productimport:product-master-pim ; php bin/magento swiftoms:allocation:mapping ; php bin/magento swiftoms:mpadapter:product-channel-mapping ; php bin/magento indexer:reindex cataloginventory_stock"


  • swiftoms:mpadapter:pull-product: used for CSV files to Magento.

  • swiftoms:productimport:product-master-pim: 2nd cron.

  • swiftoms:allocation:mapping: mapping allocation. Newly imported products need to be set to
    the marketplace for allocation mapping anywhere.

  1. Pull Order: Used to pull order data, insert, and update to SWIFT OMS.

name: mpadapter-pull-order

   suspend: false

   schedule: "* * * * *"

   command:

     - bash

     - -c

   args:

   "php bin/magento swiftoms:mpadapter:pull-order"

 

  1. Push Stock: Used to send and update stock via MP Adapter to the marketplace.

 

name: mpadapter-push-stock

   suspend: false

   schedule: "*/5 * * * *"

   command:

     - bash

     - -c

   args:

   "php bin/magento swiftoms:mpadapter:push-stock --time=30"

You can add a parameter to run cron in the --time=.. . These parameters are optional, you can set it or
not. If you use these parameters, the stock that will be sent is the last stock of the parameters entered.

  1. MP Adapter Feedback: Used for pulling feedback data when there is a bug published to pubsub. For
    example: comments about stock updates, feedback bugs for taking orders, feedback about bulk bug updates.

name: mpadapter-feedback

   suspend: false

   schedule: "* * * * *"

   command:

     - bash

     - -c

   args:

name: mpadapter-feedback

   suspend: false

   schedule: "* * * * *"

   command:

     - bash

     - -c

   args:

     - "php bin/magento swiftoms:mpadapter:pull-feedback --feedback-type update_stock ; php bin/magento swiftoms:mpadapter:pull-feedback --feedback-type bulk_accept_order ; php bin/magento swiftoms:mpadapter:pull-feedback --feedback-type bulk_pack_order ; php bin/magento swiftoms:mpadapter:pull-feedback --feedback-type bulk_complete_order ; php bin/magento swiftoms:mpadapter:pull-feedback --feedback-type bulk_cancel_order"

  1. MP Adapter Retry: It will help to automatically repeat data updates using Cron if the previous data update
    has failed. This will reduce the status update action to the marketplace.

name: mpadapter-retry

   suspend: false

   schedule: "* * * * *"

   command:

     - bash

     - -c

   args:

     - "php bin/magento swiftoms:mpadapter:retry-update-order-status accept ; php bin/magento swiftoms:mpadapter:retry-update-order-status cancel ; php bin/magento swiftoms:mpadapter:retry-update-order-status pack"

  1. Update Null Value: Used to update data that contains a null value. This will update Marketplace Order Number
    Grid fields and Marketplace Order status when the value is empty or NULL.

name: mpadapter-update-null-value

   suspend: false

   schedule: "*/2 * * * *"

   command:

     - bash

     - -c

   args:

     - "php bin/magento swiftoms:mpadapter:update-null-value"

 

  1. Weaver Pull Delivery Order and Good Received: The Weaver-related Cron is used in the Apollo project.

name: weaver-do-gr

   suspend: false

   schedule: "* * * * *"

   command:

     - bash

     - -c

   args:

     - "php bin/magento swiftoms:mpadapter:weaver-pull-deliveryorder ; php bin/magento swiftoms:mpadapter:weaver-pull-goodreceived"

  1. Pull Product Category: Used for pulling category and attribute data from each marketplace. Cron can be run once
    a day and can be executed manually.

swiftoms:mpadapter:pull-product-category        Pull product category from MP Adapter

  1. Push Product Price: Used to send product price data from SWIFT OMS to the marketplace. This Cron can be
    executed manually as needed.

swiftoms:mpadapter:push-product-price           Upsert product price to MP

  1. Push Product Promo: Used to send changes to product promo data from SWIFT OMS to the marketplace.

swiftoms:mpadapter:push-product-promo           Upsert product to MP