Skip to main content
Miinto order sync manual
Updated over a week ago

Update your Koongo plan

You might need to update your Koongo plan to be able to activate the Miinto order connection. For more information please check: Update your plan to activate an order connection

Order sync setup

To activate the Miinto order synchronization, please follow the steps below:

Add connection

Click Add Connection button.

addconnection.png

Select the Miinto connection

Select the Miinto connection from the grid

Screenshot_2023-03-10_at_20.23.17.png

Fill user details

Fill in your Miinto account username and password and click on Get Available Stores button.

Screenshot_2023-03-10_at_20.30.41.png

Select store

Select Shop Location and set Activate Order Synchronization to ACTIVE from the Order Configuration and Save the settings.

Screenshot_2023-03-10_at_20.31.19.png

Sync your orders

Click Synchronize Orders button

sync.orders.png

Orders configuration

You can modify various parameters in the Orders Configuration section

Screenshot_2023-03-10_at_20.33.08.png


โ€‹Activate Order Synchronization

  • You can set the connection to Active or Disabled.

Order Synchronization Level

  • The Order Synchronization Level option can be set to Orders & Stock or Stock only.

Accept Orders Automatically

  • The Accept Orders Automatically option can be set to Yes.

Koongo can automatically decide whether a Miinto order should be accepted or not. Acceptance is based on the merchant stock and price of certain order items.

The order is accepted automatically if the product is in stock and the order price equals or is higher than the reference Price Attribute - Price final include tax or Price original include tax can be used.

  • By default, the Accept Orders Automatically option is set to No. Each order needs to be accepted manually in your Miinto or Koongo account.

Screenshot_2023-03-13_at_19.58.29.png

Auto Accept Orders - Price Attribute

  • The auto accept order functionality price reference can be set either to Price final include tax or Price original include tax. By default, Price final include tax attribute is used.

Auto Accept Orders - Price Attribute Threshold

  • The threshold is applied to the price attribute before comparison with the order item's price (the price attribute is multiplied by the threshold). The recommended value is 0.97, which means that the order is accepted if the order item price is equal to or higher than 97% of the product price.

Auto Accept Orders - Price Attribute Currency

  • Currency information is needed for the comparison of the ordered item and product price. Please, use the default 'Store Base Currency' value for standard Miinto feed settings. Only when the store includes additional price attributes, different from the store base currency, and the Koongo currency conversion is not used, please set it to 'Marketplace Base Currency'

Default Shipping Service - Store Shipment

  • You can define the shipping service default value. The default value will be used in case the order shipping service defined in the store doesn't match Miinto's allowed providers.

Use Billing Address For Shipping

  • Insert billing address instead of shipping address during order syncing from Miinto to Koongo.

Product Identification Attribute

  • You can select attributes for product identification on Miinto. By default, id attribute is used.

Sync Orders Created From Date

  • Only orders and RMAs created from the specified date will be synced. Format YYYY-MM-DD e.g. 2021-03-20

Order details

You can check each order details.

Miinto Labels Transfer

In the Miinto order Comment tab, there is a link to the order labels in PDF. The file is stored on our server, but only users who know the link can access it.

Screenshot_2023-03-13_at_19.44.13.png

Miinto Return merchandise authorization (RMA)

Miinto Return merchandise authorization (RMA) is currently available for all order sync supported e-commerce platforms. The Miinto order synchronization needs to be activated to process RMA.

The refund synchronization is available only for Shopify and Magento 2 users. The other e-commerce platforms will be added later this year.

Return merchandise authorization (RMA) is a part of the process of returning a product to receive a refund, replacement, or repair during the product's warranty period.

Koongo supports Miinto RMA functionality (Return merchandise authorization) as part of the Miinto order management. This functionality allows merchants to process Miinto RMA in Koongo.

Note: Miinto RMA is available for all Miinto locations except Miinto China. Miinto China returns are not possible to process automatically. You need to contact Miinto Partner Support Team, they can process the return manually.

Koongo RMA supported feature

  • RMA management at Koongo

    • Check RMAs at particular orders

    • Accept RMA

    • Reject RMA with the definition of rejection reason

  • Once RMA is accepted at Koongo or Miinto, then a relevant refund action is translated from Miinto to the store.

  • Refund syncing - Once the merchant refunds order items at the store, then it will be transferred into Miinto and a new RMA Request is created. (Available only for Shopify and Magento 2 platform)

Miinto RMA and RMA request processing

Scenario 1 - Buyer returns the product, no RMA created in Miinto

  • The buyer sends back the product to the merchant without creating RMA in Miinto

  • The merchant check the returned product

  • The merchant creates an RMA Request in Miinto

    • The Shopify users can create a product refund in the Shopify store. Then, the RMA Request is created in Miinto automatically

    • The Magento 2 users can create a credit memo (=refund) in their Magento 2 store. Then, the RMA Request is created in Miinto automatically

  • The refund itself will be performed by Miinto marketplace

Scenario 2 - Buyer creates RMA, merchant accepts RMA

  • The buyer creates an RMA in Miinto and sends the product back to the merchant

  • The merchant check the returned product

  • The merchant accepts the RMA in Miinto or in Koongo. (RMA is accepted also in case that refund comes from the store (Shopify, Magento 2) - the refund and RMA must contain the same order items)

  • The refund itself will be performed by Miinto marketplace. For Shopify and Magento 2 platforms, the refund is sent to the merchant store automatically.

  • Other than Shopify and Magento 2 platform users need to insert the return manually.

  • Email notification is sent to the buyer - 'Your return has been accepted'

Scenario 3 - Buyer creates RMA, merchant declines RMA

  • The buyer creates an RMA in Miinto and sends back the product to the merchant

  • The merchant check the returned product

  • The merchant declines the RMA in Miinto or in Koongo. And provide RMA with declined reason to Miinto

  • The RMA is declined in the Miinto system

  • The merchant sends the product back to the customer

  • Email notification is sent to the buyer - 'Your return has been declined'

Miinto RMA processing flow - diagram

RMA_API_flow__1_.png

Miinto RMA processing in Koongo

Pending RMA

An RMA is created in Miinto and imported to Koongo.

You can accept or decline the RMA. You should fill in the accept or decline reason description. RMA is accepted also in case that refund comes from the store (Shopify, Magento 2) - the refund and RMA must contain the same order items.

Screenshot_2023-03-13_at_20.06.17.png

Accepted/Declined RMA

The RMA is marked as Accepted/Declined.

Screenshot_2023-03-13_at_20.08.16.png

Refund (Shopify and Magento 2 supported only)

The refund is transferred to the store automatically. This functionality is available only for Shopify and Magento 2 platforms.

Screenshot_2023-03-13_at_20.13.03.png

Screenshot_2023-03-13_at_20.18.52.png
Did this answer your question?